16.2. 단일 노드 OpenShift 클러스터에 대한 이미지 기반 설치 준비
단일 노드 OpenShift 클러스터에 대한 이미지 기반 설치를 준비하려면 다음 작업을 완료해야 합니다.
- Lifecycle Agent를 사용하여 시드 이미지를 만듭니다.
- 모든 소프트웨어 구성 요소가 필수 버전을 충족하는지 확인합니다. 자세한 내용은 "이미지 기반 설치 및 배포를 위한 소프트웨어 필수 구성 요소"를 참조하세요.
16.2.1. Lifecycle Agent 설치 링크 복사링크가 클립보드에 복사되었습니다!
Lifecycle Agent를 사용하여 시드 클러스터에서 시드 이미지를 생성합니다. OpenShift CLI( oc
) 또는 웹 콘솔을 사용하여 Lifecycle Agent를 설치할 수 있습니다.
16.2.1.1. CLI를 사용하여 Lifecycle Agent 설치 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift CLI( oc
)를 사용하여 Lifecycle Agent를 설치할 수 있습니다.
사전 요구 사항
-
OpenShift CLI(
oc
)가 설치되어 있습니다. -
클러스터 관리자
권한이 있는 사용자로 로그인했습니다.
프로세스
Lifecycle Agent에 대한
네임스페이스
개체 YAML 파일을 만듭니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여
네임스페이스
CR을 만듭니다.oc create -f <namespace_filename>.yaml
$ oc create -f <namespace_filename>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Lifecycle Agent에 대한
OperatorGroup
개체 YAML 파일을 만듭니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여
OperatorGroup
CR을 생성합니다.oc create -f <operatorgroup_filename>.yaml
$ oc create -f <operatorgroup_filename>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Lifecycle Agent에 대한
구독
CR을 만듭니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여
구독
CR을 만듭니다.oc create -f <subscription_filename>.yaml
$ oc create -f <subscription_filename>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
설치가 성공했는지 확인하려면 다음 명령을 실행하여 CSV 리소스를 검사하세요.
oc get csv -n openshift-lifecycle-agent
$ oc get csv -n openshift-lifecycle-agent
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME DISPLAY VERSION REPLACES PHASE lifecycle-agent.v4.19.0 Openshift Lifecycle Agent 4.19.0 Succeeded
NAME DISPLAY VERSION REPLACES PHASE lifecycle-agent.v4.19.0 Openshift Lifecycle Agent 4.19.0 Succeeded
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 Lifecycle Agent가 실행 중인지 확인하세요.
oc get deploy -n openshift-lifecycle-agent
$ oc get deploy -n openshift-lifecycle-agent
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME READY UP-TO-DATE AVAILABLE AGE lifecycle-agent-controller-manager 1/1 1 1 14s
NAME READY UP-TO-DATE AVAILABLE AGE lifecycle-agent-controller-manager 1/1 1 1 14s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
16.2.1.2. 웹 콘솔을 사용하여 라이프사이클 에이전트 설치 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 웹 콘솔을 사용하여 Lifecycle Agent를 설치할 수 있습니다.
사전 요구 사항
-
cluster-admin
권한이 있는 사용자로 로그인했습니다.
프로세스
-
OpenShift Container Platform 웹 콘솔에서 Operator
OperatorHub로 이동합니다. - 사용 가능한 Operator 목록에서 Lifecycle Agent 를 검색한 다음 설치를 클릭합니다.
- Operator 설치 페이지의 클러스터의 특정 네임스페이스에서 openshift-ptp를 선택합니다.
- 설치를 클릭합니다.
검증
설치에 성공했는지 확인하려면 다음을 수행하십시오.
-
Operators
설치된 Operators를 클릭합니다. Lifecycle Agent가 openshift-lifecycle-agent 프로젝트에 InstallSucceeded Status 로 나열되어 있는지 확인하세요.
참고설치 중에 Operator는 실패 상태를 표시할 수 있습니다. 나중에 InstallSucceeded 메시지와 함께 설치에 성공하면 이 실패 메시지를 무시할 수 있습니다.
-
Operators
Operator가 성공적으로 설치되지 않은 경우 다음을 수행하십시오.
-
운영자
설치된 운영자를 클릭하고 운영자 구독 및 설치 계획 탭을 검사하여 상태 아래에 오류나 실패가 있는지 확인하세요. -
워크로드
Pod를 클릭하고 openshift-lifecycle-agent 프로젝트의 Pod에 대한 로그를 확인합니다.
16.2.3. 시드 이미지 구성 링크 복사링크가 클립보드에 복사되었습니다!
베어 메탈 호스트와 동일한 하드웨어, 유사한 대상 클러스터 구성을 사용하여 단일 노드 OpenShift 클러스터에서 시드 이미지를 만들 수 있습니다. 하지만 시드 클러스터에서 생성된 시드 이미지에는 클러스터별 구성이 포함될 수 없습니다.
다음 표는 시드 이미지에 포함해야 하는 구성 요소, 리소스 및 구성과 포함하지 않아야 하는 구성 요소, 리소스 및 구성을 나열합니다.
클러스터 구성 | 시드 이미지에 포함 |
---|---|
성과 프로필 | 제공됨 |
대상 클러스터에 대한 | 제공됨 |
IP 버전 [1] | 제공됨 |
Lifecycle Agent 및 OADP Operator를 포함한 Day 2 Operator 세트 | 제공됨 |
연결이 끊긴 레지스트리 구성 [2] | 제공됨 |
유효한 프록시 구성 [3] | 제공됨 |
FIPS 구성 | 제공됨 |
대상 클러스터의 크기와 일치하는 컨테이너 스토리지를 위한 기본 디스크의 전용 파티션 | 제공됨 |
로컬 볼륨
| 없음 |
- 이 릴리스에서는 듀얼 스택 네트워킹이 지원되지 않습니다.
- 시드 클러스터가 연결이 끊긴 환경에 설치된 경우 대상 클러스터도 연결이 끊긴 환경에 설치해야 합니다.
- 프록시 구성은 시드 클러스터와 대상 클러스터 모두에서 활성화하거나 비활성화해야 합니다. 하지만 클러스터에 구성된 프록시 서버는 일치할 필요가 없습니다.
16.2.3.1. RAN DU 프로필을 사용한 시드 이미지 구성 링크 복사링크가 클립보드에 복사되었습니다!
다음 표는 RAN DU 프로필을 사용할 때 시드 이미지에 포함해야 하는 구성 요소, 리소스 및 구성과 포함하지 않아야 하는 구성 요소, 리소스 및 구성을 나열합니다.
리소스 | 시드 이미지에 포함 |
---|---|
Day 0 설치의 일부로 적용되는 모든 추가 매니페스트 | 제공됨 |
모든 Day 2 Operator 서브스크립션 | 제공됨 |
| 제공됨 |
| 제공됨 |
| 제공됨 |
| 제공됨 |
| 제공됨 |
|
아니요, |
| 없음 |
| 없음 |
다음 리소스 및 구성 목록은 추가 매니페스트로 적용하거나 RHACM 정책을 사용하여 적용할 수 있습니다.
-
ClusterLogForwarder.yaml
-
ReduceMonitoringFootprint.yaml
-
SriovFecClusterConfig.yaml
-
PtpOperatorConfigForEvent.yaml
-
DefaultCatsrc.yaml
-
PtpConfig.yaml
-
SriovNetwork.yaml
GitOps ZTP를 사용하는 경우 RHACM 정책을 사용하여 이러한 리소스를 활성화하면 클러스터 수명 주기 전체에서 구성 변경 사항을 적용할 수 있습니다.
16.2.4. Lifecycle Agent를 사용하여 시드 이미지 생성 링크 복사링크가 클립보드에 복사되었습니다!
Lifecycle Agent를 사용하여 관리되는 클러스터에서 시드 이미지를 생성합니다. 운영자는 필요한 시스템 구성을 확인하고, 시드 이미지를 생성하기 전에 필요한 시스템 정리를 수행하고, 이미지 생성을 시작합니다. 시드 이미지 생성에는 다음 작업이 포함됩니다.
- 클러스터 운영자 중지
- 시드 이미지 구성 준비
-
SeedGenerator
CR에 지정된 이미지 저장소에 시드 이미지를 생성하고 푸시합니다. - 클러스터 운영자 복원
- 만료되는 시드 클러스터 인증서
- 시드 클러스터에 대한 새 인증서 생성
-
시드 클러스터에서
SeedGenerator
CR 복원 및 업데이트
사전 요구 사항
- Kubernetes Operator용 RHACM 및 멀티클러스터 엔진이 시드 클러스터에 설치되지 않았습니다.
- 시드 클러스터에 공유 컨테이너 디렉토리를 구성했습니다.
- 시드 클러스터에 OADP Operator와 Lifecycle Agent의 최소 버전을 설치했습니다.
- 시드 클러스터에 영구 볼륨이 구성되지 않았는지 확인하세요.
-
Local Storage Operator를 사용하는 경우 시드 클러스터에
LocalVolume
CR이 존재하지 않는지 확인하세요. -
LVM 스토리지를 사용하는 경우 시드 클러스터에
LVMCluster
CR이 없는지 확인하세요. -
OADP를 사용하는 경우 시드 클러스터에
DataProtectionApplication
CR이 존재하지 않는지 확인하세요.
프로세스
시드 이미지에 포함되어서는 안 되는 시드 클러스터의 RHACM 관련 리소스를 삭제하려면 허브에서 관리되는 클러스터를 분리합니다.
다음 명령을 실행하여 시드 클러스터를 수동으로 분리합니다.
oc delete managedcluster sno-worker-example
$ oc delete managedcluster sno-worker-example
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
관리되는 클러스터가 제거될 때까지 기다리세요. 클러스터를 제거한 후 적절한
SeedGenerator
CR을 생성합니다. Lifecycle Agent는 RHACM 아티팩트를 정리합니다.
-
관리되는 클러스터가 제거될 때까지 기다리세요. 클러스터를 제거한 후 적절한
GitOps ZTP를 사용하는 경우
kustomization.yaml
에서 시드 클러스터의SiteConfig
CR을 제거하여 클러스터를 분리합니다.여러
SiteConfig
CR을 참조하는kustomization.yaml
파일이 있는 경우kustomization.yaml
에서 시드 클러스터의SiteConfig
CR을 제거하세요.Copy to Clipboard Copied! Toggle word wrap Toggle overflow SiteConfig
CR 하나를 참조하는kustomization.yaml
이 있는 경우kustomization.yaml
에서 시드 클러스터의SiteConfig
CR을 제거하고generators: {}
줄을 추가합니다.apiVersion: kustomize.config.k8s.io/v1beta1 kind: Kustomization generators: {}
apiVersion: kustomize.config.k8s.io/v1beta1 kind: Kustomization generators: {}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Git 저장소에
kustomization.yaml
변경 사항을 커밋하고 저장소에 변경 사항을 푸시합니다.ArgoCD 파이프라인은 변경 사항을 감지하고 관리되는 클러스터를 제거합니다.
레지스트리에 시드 이미지를 푸시할 수 있도록
Secret
객체를 만듭니다.다음 명령을 실행하여 인증 파일을 만듭니다.
MY_USER=myuserid AUTHFILE=/tmp/my-auth.json podman login --authfile ${AUTHFILE} -u ${MY_USER} quay.io/${MY_USER}
$ MY_USER=myuserid $ AUTHFILE=/tmp/my-auth.json $ podman login --authfile ${AUTHFILE} -u ${MY_USER} quay.io/${MY_USER}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow base64 -w 0 ${AUTHFILE} ; echo
$ base64 -w 0 ${AUTHFILE} ; echo
Copy to Clipboard Copied! Toggle word wrap Toggle overflow openshift-lifecycle-agent
네임스페이스의seedgen
이라는Secret
YAML 파일에 있는seedAuth
필드에 출력을 복사합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여
Secret
을 적용합니다.oc apply -f secretseedgenerator.yaml
$ oc apply -f secretseedgenerator.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
SeedGenerator
CR을 생성합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 시드 이미지를 생성합니다.
oc apply -f seedgenerator.yaml
$ oc apply -f seedgenerator.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 중요Lifecycle Agent가 시드 이미지를 생성하는 동안 클러스터가 재부팅되고 API 기능이 손실됩니다.
SeedGenerator
CR을 적용하면kubelet
과 CRI-O 작업이 중지되고 이미지 생성이 시작됩니다.
더 많은 시드 이미지를 생성하려면 시드 이미지를 생성하려는 버전으로 새로운 시드 클러스터를 프로비저닝해야 합니다.
검증
클러스터가 복구되어 사용 가능해지면 다음 명령을 실행하여
SeedGenerator
CR의 상태를 확인할 수 있습니다.oc get seedgenerator -o yaml
$ oc get seedgenerator -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 시드 이미지 생성이 완료되었습니다.