This documentation is for a release that is no longer maintained
See documentation for the latest supported version.OpenShift Container Platform에 Red Hat Developer Hub 설치
초록
머리말
다음 설치 프로그램 중 하나를 사용하여 OpenShift Container Platform에 Red Hat Developer Hub를 설치할 수 있습니다.
- Red Hat Developer Hub Operator
- 관리자가 OperatorHub와 함께 설치한 후 OpenShift Container Platform에서 즉시 사용할 준비가 되었습니다
- OLM(Operator Lifecycle Management)을 사용하여 OpenShift Container Platform에서 자동화된 서브스크립션 업데이트 관리
- Kubernetes에서 자동화된 서브스크립션 업데이트를 관리하려면 OLM(Operator Lifecycle Management)을 사전 설치해야 합니다.
- Red Hat Developer Hub Helm 차트
- OpenShift Container Platform 및 Kubernetes 모두에서 즉시 사용 가능
- 수동 설치 및 관리 필요
요구 사항 및 기본 설정에 가장 적합한 설치 방법을 사용합니다.
추가 리소스
- 설치 방법 선택에 대한 자세한 내용은 Helm Charts vs. Operator
- Operator 방법에 대한 자세한 내용은 Operator 이해를 참조하십시오.
- Helm 차트 방법에 대한 자세한 내용은 Helm 이해 를 참조하십시오.
1장. Operator를 사용하여 OpenShift Container Platform에 Red Hat Developer Hub 설치
OpenShift Container Platform 콘솔에서 Red Hat Developer Hub Operator를 사용하여 OpenShift Container Platform에 Red Hat Developer Hub를 설치할 수 있습니다.
1.1. Red Hat Developer Hub Operator 설치
관리자는 Red Hat Developer Hub Operator를 설치할 수 있습니다. 권한이 있는 사용자는 Operator를 사용하여 다음 플랫폼에 Red Hat Developer Hub를 설치할 수 있습니다.
- Red Hat OpenShift Container Platform (OpenShift Container Platform)
- Amazon Elastic Kubernetes Service(EKS)
- Microsoft Azure Kubernetes Service(AKS)
OpenShift Container Platform 지원 버전에 대한 자세한 내용은 Red Hat Developer Hub 라이프 사이클 을 참조하십시오.
컨테이너는 다음 CPU 아키텍처에서 사용할 수 있습니다.
-
AMD64 및 Intel 64 (
x86_64
)
사전 요구 사항
- OpenShift Container Platform 웹 콘솔에서 관리자로 로그인되어 있습니다.
- 애플리케이션을 생성하거나 액세스할 수 있도록 프로젝트 내에서 적절한 역할 및 권한을 구성했습니다. 자세한 내용은 애플리케이션 빌드에 대한 Red Hat OpenShift Container Platform 설명서를 참조하십시오.
보안을 강화하여 Operator 라이프사이클을 보다 효과적으로 제어하고 잠재적인 권한 에스컬레이션을 방지하려면 전용 기본 rhdh-operator
네임스페이스에 Red Hat Developer Hub Operator를 설치합니다. 역할 바인딩 또는 클러스터 역할 바인딩을 통해 Operator 리소스에 대한 다른 사용자의 액세스를 제한할 수 있습니다.
Operator group과 같은 필요한 리소스를 생성하여 다른 네임스페이스에 Operator를 설치할 수도 있습니다. 자세한 내용은 사용자 정의 네임스페이스에서 글로벌 Operator 설치를 참조하십시오.
그러나 Red Hat Developer Hub Operator가 다른 Operator와 네임스페이스를 공유하는 경우 동일한 업데이트 정책도 공유하므로 업데이트 정책을 사용자 정의할 수 없습니다. 예를 들어 하나의 Operator가 수동 업데이트로 설정된 경우 Red Hat Developer Hub Operator 업데이트 정책도 manual로 설정됩니다. 자세한 내용은 네임스페이스에서 Operator Colocation을 참조하십시오.
프로세스
- OpenShift Container Platform 웹 콘솔의 관리자 화면에서 Operator > OperatorHub를 클릭합니다.
- 키워드로 필터링 상자에 Developer Hub를 입력하고 Red Hat Developer Hub Operator 카드를 클릭합니다.
- Red Hat Developer Hub Operator 페이지에서 설치를 클릭합니다.
Operator 설치 페이지에서 업데이트 채널 드롭다운 메뉴를 사용하여 사용할 업데이트 채널을 선택합니다.
fast 채널은 y-stream(x.y) 및 z-stream(x.y.z) 업데이트를 제공합니다(예: 버전 1.1에서 1.2로 업데이트 또는 1.1.0에서 1.1.1로 업데이트).
중요fast
채널에는 특정 버전에 사용할 수 있는 모든 업데이트가 포함되어 있습니다. 업데이트로 인해 Red Hat Developer Hub 배포에 예기치 않은 변경 사항이 발생할 수 있습니다. 잠재적인 변경 사항에 대한 자세한 내용은 릴리스 노트를 확인하십시오.- fast-1.1 채널은 z-stream 업데이트만 제공합니다(예: 버전 1.1.1에서 1.1.2로 업데이트). 향후 Red Hat Developer Hub y-version을 업데이트하려면 예를 들어 1.1에서 1.2로 업데이트하려면 fast 채널로 수동으로 전환해야 합니다.
Operator 설치 페이지에서 Operator 의 업데이트 승인 전략을 선택합니다.
- 자동 옵션을 선택하면 수동 확인 없이도 Operator가 업데이트됩니다.
- 수동 옵션을 선택하면 업데이트 채널에서 새 업데이트가 릴리스될 때 알림이 열립니다. 업데이트를 시작하기 전에 관리자가 수동으로 승인해야 합니다.
- 설치를 클릭합니다.
검증
- 설치된 Red Hat Developer Hub Operator를 보려면 View Operator 를 클릭합니다.
1.2. Operator를 사용하여 OpenShift Container Platform에 Red Hat Developer Hub 배포
개발자는 Red Hat OpenShift Container Platform 웹 콘솔의 개발자 카탈로그를 사용하여 OpenShift Container Platform에 Red Hat Developer Hub 인스턴스를 배포할 수 있습니다. 이 배포 방법은 Red Hat Developer Hub Operator를 사용합니다.
사전 요구 사항
프로세스
-
OpenShift Container Platform 웹 콘솔에서 <
my-rhdh-project> 프로젝트를
선택합니다. - OpenShift Container Platform 웹 콘솔의 개발자 화면에서 +추가 를 클릭합니다.
- 개발자 카탈로그 패널에서 Operator Backed 를 클릭합니다.
- 키워드로 필터링 상자에 개발자 허브 를 입력하고 Red Hat Developer Hub 카드를 클릭합니다.
- 생성을 클릭합니다.
- Backstage 사용자 지정 리소스 콘텐츠를 추가합니다.
- 뒤로 만들기 페이지에서 만들기를 클릭합니다.On the Create Backstage page, click Create.
검증
Pod가 준비되면 URL을 열어 Red Hat Developer Hub 플랫폼에 액세스할 수 있습니다.
- 토폴로지 보기에서 Pod를 클릭하고 세부 정보 패널에서 상태를 확인하여 Pod 가 준비되었는지 확인합니다. Pod 상태가 활성 이면 Pod가 준비됩니다.
토폴로지 보기에서 개발자 허브 Pod에서 Open URL 아이콘을 클릭합니다.
2장. Helm 차트를 사용하여 OpenShift Container Platform에 Red Hat Developer Hub 설치
다음 방법 중 하나로 Helm 차트를 사용하여 OpenShift Container Platform에 Red Hat Developer Hub를 설치할 수 있습니다.
- OpenShift Container Platform 콘솔
- Helm CLI
2.1. Helm 차트를 사용하여 OpenShift Container Platform 웹 콘솔에서 개발자 허브 배포
Helm 차트를 사용하여 Red Hat OpenShift Container Platform 웹 콘솔에 개발자 허브를 설치할 수 있습니다.
Helm은 다음 기능을 제공하는 OpenShift Container Platform의 패키지 관리자입니다.
- 사용자 정의 후크를 사용하여 일반 애플리케이션 업데이트 적용
- 복잡한 애플리케이션의 설치 관리
- 퍼블릭 및 프라이빗 서버에서 호스팅할 수 있는 차트 제공
- 이전 애플리케이션 버전으로의 롤백 지원
Red Hat Developer Hub Helm 차트는 OpenShift Dedicated 및 OpenShift Container Platform의 Helm 카탈로그에서 사용할 수 있습니다.
사전 요구 사항
- OpenShift Container Platform 계정에 로그인되어 있습니다.
-
OpenShift Container Platform
admin
역할의 사용자는 애플리케이션을 생성하기 위해 프로젝트 내에서 적절한 역할 및 권한을 구성했습니다. OpenShift Container Platform 역할에 대한 자세한 내용은 RBAC를 사용하여 권한 정의 및 적용을 참조하십시오. - OpenShift Container Platform에서 프로젝트를 생성했습니다. OpenShift Container Platform에서 프로젝트를 생성하는 방법에 대한 자세한 내용은 Red Hat OpenShift Container Platform 설명서를 참조하십시오.
프로세스
- 개발자 허브 웹 콘솔의 개발자 화면에서 +추가 를 클릭합니다.
- 개발자 카탈로그 패널에서 Helm 차트 를 클릭합니다.
- 키워드로 필터링 상자에 개발자 허브 를 입력하고 Red Hat Developer Hub 카드를 클릭합니다.
- Red Hat Developer Hub 페이지에서 생성 을 클릭합니다.
-
클러스터에서 OpenShift Container Platform 라우터 호스트(예:
apps.<clusterName>.com )를 복사합니다.
라디오 버튼을 선택하여 양식 보기 또는 YAML 보기로 Developer Hub 인스턴스를 구성합니다. 양식 보기는 기본적으로 선택됩니다.
양식 보기사용
- 양식 보기를 사용하여 인스턴스를 구성하려면 Backstage 인스턴스 내에서 루트 스키마 → 글로벌 → 서비스 인증 활성화 로 이동하여 OpenShift Container Platform 라우터 호스트를 양식의 필드에 붙여넣습니다.
YAML 보기사용
YAML 보기를 사용하여 인스턴스를 구성하려면 다음 예와 같이 OpenShift Container Platform 라우터 호스트 이름을
global.clusterRouterBase
매개변수 값에 붙여넣습니다.global: auth: backend: enabled: true clusterRouterBase: apps.<clusterName>.com # other Red Hat Developer Hub Helm Chart configurations
global: auth: backend: enabled: true clusterRouterBase: apps.<clusterName>.com # other Red Hat Developer Hub Helm Chart configurations
Copy to Clipboard Copied!
필요한 경우 다른 값을 편집합니다.
참고호스트에 대한 정보는 복사되며 Developer Hub 백엔드에서 액세스할 수 있습니다.
OpenShift Container Platform 경로가 자동으로 생성되면 경로의 호스트 값이 유추되고 동일한 호스트 정보가 개발자 허브로 전송됩니다. 또한 값을 사용하여 호스트를 수동으로 설정하여 개발자 허브가 사용자 정의 도메인에 있는 경우 사용자 지정 호스트가 우선합니다.
- 생성 을 클릭하고 데이터베이스와 개발자 허브가 시작될 때까지 기다립니다.
Open URL 아이콘을 클릭하여 Developer Hub 플랫폼 사용을 시작합니다.
Developer Hub 컨테이너가 구성 파일에 액세스할 수 없는 경우 developer-hub
Pod가 CrashLoopBackOff
상태에 있을 수 있습니다. 이 오류는 다음 로그로 표시됩니다.
Loaded config from app-config-from-configmap.yaml, env ... 2023-07-24T19:44:46.223Z auth info Configuring "database" as KeyStore provider type=plugin Backend failed to start up Error: Missing required config value at 'backend.database.client'
Loaded config from app-config-from-configmap.yaml, env
...
2023-07-24T19:44:46.223Z auth info Configuring "database" as KeyStore provider type=plugin
Backend failed to start up Error: Missing required config value at 'backend.database.client'
오류를 해결하려면 구성 파일을 확인합니다.
2.2. Helm CLI를 사용하여 OpenShift Container Platform에 Developer Hub 배포
Helm CLI를 사용하여 Red Hat OpenShift Container Platform에 Red Hat Developer Hub를 설치할 수 있습니다.
사전 요구 사항
-
워크스테이션에 OpenShift CLI(
oc
)를 설치했습니다. - OpenShift Container Platform 계정에 로그인되어 있습니다.
- OpenShift Container Platform admin 역할의 사용자는 애플리케이션을 생성하기 위해 프로젝트 내에서 적절한 역할 및 권한을 구성했습니다. OpenShift Container Platform 역할에 대한 자세한 내용은 RBAC를 사용하여 권한 정의 및 적용을 참조하십시오.
- OpenShift Container Platform에서 프로젝트를 생성했습니다. OpenShift Container Platform에서 프로젝트를 생성하는 방법에 대한 자세한 내용은 Red Hat OpenShift Container Platform 설명서를 참조하십시오.
- Helm CLI 툴을 설치했습니다.
프로세스
< my-rhdh-project> OpenShift Container Platform 프로젝트를 생성하고 활성화합니다.
NAMESPACE=<emphasis><rhdh></emphasis> oc new-project ${NAMESPACE} || oc project ${NAMESPACE}
NAMESPACE=<emphasis><rhdh></emphasis> oc new-project ${NAMESPACE} || oc project ${NAMESPACE}
Copy to Clipboard Copied! Red Hat Developer Hub Helm 차트를 설치합니다.
helm upgrade redhat-developer-hub -i https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.4.3/redhat-developer-hub-1.4.3.tgz
helm upgrade redhat-developer-hub -i https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.4.3/redhat-developer-hub-1.4.3.tgz
Copy to Clipboard Copied! OpenShift Container Platform 클러스터의 Developer Hub 데이터베이스 암호 및 라우터 기본 URL 값을 사용하여 Developer Hub Helm 차트 인스턴스를 구성합니다.
PASSWORD=$(oc get secret redhat-developer-hub-postgresql -o jsonpath="{.data.password}" | base64 -d) CLUSTER_ROUTER_BASE=$(oc get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/^[^.]*\.//') helm upgrade redhat-developer-hub -i "https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.4.3/redhat-developer-hub-1.4.3.tgz" \ --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE" \ --set global.postgresql.auth.password="$PASSWORD"
PASSWORD=$(oc get secret redhat-developer-hub-postgresql -o jsonpath="{.data.password}" | base64 -d) CLUSTER_ROUTER_BASE=$(oc get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/^[^.]*\.//') helm upgrade redhat-developer-hub -i "https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.4.3/redhat-developer-hub-1.4.3.tgz" \ --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE" \ --set global.postgresql.auth.password="$PASSWORD"
Copy to Clipboard Copied! 실행중인 Developer Hub 인스턴스 URL을 표시합니다.
echo "https://redhat-developer-hub-$NAMESPACE.$CLUSTER_ROUTER_BASE"
echo "https://redhat-developer-hub-$NAMESPACE.$CLUSTER_ROUTER_BASE"
Copy to Clipboard Copied!
검증
- 브라우저에서 실행 중인 Developer Hub 인스턴스 URL을 열어 개발자 허브를 사용합니다.
추가 리소스