설치
1장. 빌드 설치
클러스터 관리자는 OpenShift Container Platform 클러스터에 빌드를 설치할 수 있습니다.
1.1. 사전 요구 사항
- OpenShift Container Platform 웹 콘솔에 액세스할 수 있습니다.
-
oc
CLI를 설치했습니다. - OpenShift Container Platform 클러스터에 관리자로 로그인되어 있습니다.
- 클러스터에 Marketplace 기능이 활성화되어 있거나 Red Hat Operator 카탈로그 소스가 수동으로 구성되어 있습니다.
종속성 구성 요소로 Red Hat OpenShift Pipelines Operator는 설치 중에 Red Hat OpenShift Operator 빌드와 함께 자동으로 설치됩니다. Red Hat OpenShift Pipelines Operator를 이미 설치한 경우 Builds는 해당 Operator를 사용하여 작동합니다.
1.2. 웹 콘솔을 사용하여 빌드 설치
Red Hat OpenShift 웹 콘솔용 빌드를 사용하여 OperatorHub에서 Red Hat OpenShift Operator 빌드를 설치할 수 있습니다. 이 Operator를 설치하면 빌드 구성 요소를 설치하고 사용할 수 있습니다.
프로세스
- 웹 콘솔의 관리자 화면에서 Operator → OperatorHub 페이지로 이동합니다.
- 키워드로 필터링 상자를 사용하여 카탈로그에서 Red Hat OpenShift Operator 빌드를 검색합니다.
- Red Hat OpenShift Operator 타일 빌드를 클릭합니다.
- Operator에 대한 간략한 설명을 읽고 설치를 클릭합니다.
Operator 설치 페이지에서 다음을 수행합니다.
-
설치 모드가 클러스터의 모든 네임스페이스(기본값) 로 설정되어 있는지 확인합니다. 이 모드는 기본
openshift-builds
네임스페이스에 Operator를 설치하여 클러스터의 모든 네임스페이스를 감시하고 사용할 수 있도록 합니다. -
설치된 네임스페이스 가 기본적으로
openshift-builds
로 설정되어 있는지 확인합니다. - Approval Strategy으로 Automatic을 선택합니다. 그러면 Operator에 향후 지원되는 업그레이드가 OLM(Operator Lifecycle Manager)에 의해 자동으로 처리됩니다. Manual 승인 전략을 선택하면 OLM에서 업데이트 요청을 생성합니다. 클러스터 관리자는 Operator를 새 버전으로 업데이트하려면 OLM 업데이트 요청을 수동으로 승인해야 합니다.
채널 업데이트 선택:
- 업데이트 채널은 기본적으로 latest 로 설정됩니다. 최신 채널을 사용하면 Red Hat OpenShift Operator용 최신 버전의 빌드 버전을 설치할 수 있습니다.
-
Red Hat OpenShift Operator의 특정 빌드 버전을 설치하기 위해 클러스터 관리자는 해당
builds-<version
> 채널을 사용할 수 있습니다. 예를 들어 Red Hat OpenShift Operator 버전1.3
의 빌드를 설치하려면builds-1.3
채널을 사용할 수 있습니다.
-
설치 모드가 클러스터의 모든 네임스페이스(기본값) 로 설정되어 있는지 확인합니다. 이 모드는 기본
- 설치를 클릭합니다.
검증
Red Hat OpenShift Operator 빌드를 설치한 후 컨트롤러가 올바르게 작동하도록 필요한 리소스가 생성되었는지 확인해야 합니다.
프로세스
- 웹 콘솔의 관리자 화면에서 프로젝트를 openshift-builds로 선택합니다.
- Operator → 설치된 Operator 페이지로 이동합니다.
- 모든 인스턴스 탭을 클릭합니다.
-
All instances 탭에서
OpenShiftBuild
및shipwrightBuild
인스턴스가 나열되어 있는지 확인합니다. - 이제 워크로드 → Pod 페이지로 이동합니다.
Pods 페이지에서 다음 Pod가 나열되어 있는지 확인합니다.
-
openshift-builds
Operator Pod - 빌드 컨트롤러 및 Webhook Pod 빌드
-
SharedResource
daemonset 및SharedResource
Webhook Pod
-
1.3. CLI를 사용하여 빌드 설치
CLI(명령줄 인터페이스)를 사용하여 빌드를 설치할 수도 있습니다.
프로세스
다음 예와 같이
sub.yaml
서브스크립션 오브젝트 파일을 생성하여 Red Hat OpenShift Operator 빌드에 네임스페이스를 등록합니다.apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: openshift-builds-operator namespace: openshift-builds spec: channel: <channel-name> 1 name: openshift-builds-operator 2 source: redhat-operators 3 sourceNamespace: openshift-marketplace 4
다음 명령을 실행하여 서브스크립션 오브젝트를 적용합니다.
$ oc apply -f sub.yml
이제 Red Hat OpenShift Operator 빌드가 기본 대상 네임스페이스
openshift-builds
에 설치됩니다.
검증
Red Hat OpenShift Operator 빌드를 설치한 후 Operator가 제대로 작동하려면 다음 리소스가 생성되었는지 확인해야 합니다.
다음 명령을 실행하여
OpenshiftBuild
리소스가 생성되었는지 확인합니다.$ oc get openshiftbuilds
다음 명령을 실행하여
shipwrightBuilds
리소스가 생성되었는지 확인합니다.$ oc get shipwrightbuilds
다음 명령을 실행하여
openshift-builds
네임스페이스에 다음 Pod가 생성되었는지 확인합니다.-
openshift-builds
Operator Pod - 빌드 컨트롤러 및 Webhook Pod 빌드
SharedResource daemonset 및 SharedResource Webhook Pod
$ oc get pods -n openshift-builds
다음 예에 표시된 대로 Pod 목록이 표시됩니다.
$ oc get pods -n openshift-builds NAME READY STATUS RESTARTS AGE openshift-builds-operator-6f5c48c6b5-cvp2w 2/2 Running 0 13d openshift-pipelines-operator-64d8c4969c-952cc 2/2 Running 0 3d13h shared-resource-csi-driver-node-gbkqs 2/2 Running 0 13d shared-resource-csi-driver-node-kcqxc 2/2 Running 0 13d shared-resource-csi-driver-node-sbsvg 2/2 Running 0 13d shared-resource-csi-driver-webhook-9d9bd48f4-d5ln6 1/1 Running 0 13d shipwright-build-controller-5454475b85-mmm6w 1/1 Running 0 13d shipwright-build-webhook-7fbd49c6bb-2n77s 1/1 Running 0 13d tekton-operator-webhook-756f5dfdc7-c99mc 1/1 Running 0 3d13h
-
1.4. shipwrightBuilds 빌드 컨트롤러 및 Webhook Pod 비활성화
CSI(Share-resources Container Storage Interface) 드라이버 구성 요소 및 ShipwrightBuilds
CRD(Custom Resource Definition)를 비활성화하지 않고 ShipwrightBuilds
CR(사용자 정의 리소스)을 비활성화할 수 있습니다.
CR을 비활성화하면 ShipwrightBuilds
openshift-builds
네임스페이스에서 ShipwrightBuilds
빌드 컨트롤러 및 shipwrightBuilds 빌드 Webhook Pod가 제거됩니다.
프로세스
다음 명령을 실행하여
shipwrightBuilds
컨트롤러 및 Webhook를 비활성화합니다.$ oc patch openshiftbuild cluster --type=merge -p '{"spec":{"shipwright":{"build":{"state":"Disabled"}}}}'
이 명령은 빌드 컨트롤러 및 Webhook를 비활성화하지만
shipwrightBuilds
CRD에는 영향을 미치지 않습니다.
1.5. 추가 리소스
Legal Notice
Copyright © 2024 Red Hat, Inc.
OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).
Modified versions must remove all Red Hat trademarks.
Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.
Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.