3.2. 에이전트 기반 설치 프로그램을 사용하여 OpenShift 컨테이너 플랫폼 설치

프로세스

1. 로그인 자격 증명을 사용하여 Red Hat Hybrid Cloud Console에 로그인합니다.
2. 데이터 센터 로 이동합니다.
3. 로컬에서 에이전트 기반 설치 프로그램 실행을 클릭합니다.
4. OpenShift 설치 프로그램 과 명령줄 인터페이스에 대한 운영 체제와 아키텍처를 선택하세요.
5. 설치 프로그램 다운로드를 클릭하여 설치 프로그램을 다운로드하고 추출하세요.
6. '풀 시크릿 다운로드' 또는 '풀 시크릿 복사'를 클릭하여 풀 시크릿을 다운로드하거나 복사합니다.
7. 명령줄 도구 다운로드를 클릭하고 PATH 에 있는 디렉토리에 openshift-install 바이너리를 넣습니다.

프로세스

1. PATH에 있는 디렉토리에 openshift-install 바이너리를 넣으세요.

2. 다음 명령을 실행하여 설치 구성을 저장할 디렉토리를 만듭니다.

   $ mkdir ~/<directory_name>

3. 다음 명령을 실행하여 install-config.yaml 파일을 만듭니다.

   $ cat << EOF > ./my-cluster/install-config.yaml
   apiVersion: v1
   baseDomain: test.example.com
   compute:
   - architecture: amd64 

   1

   
     hyperthreading: Enabled
     name: worker
     replicas: 0
   controlPlane:
     architecture: amd64
     hyperthreading: Enabled
     name: master
     replicas: 1
   metadata:
     name: sno-cluster 

   2

   
   networking:
     clusterNetwork:
     - cidr: fd01::/48
       hostPrefix: 64
     machineNetwork:
     - cidr: fd2e:6f44:5dd8:c956::/120
     networkType: OVNKubernetes 

   3

   
     serviceNetwork:
     - fd02::/112
   platform: 

   4

   
     none: {}
   pullSecret: '<pull_secret>' 

   5

   
   sshKey: '<ssh_pub_key>' 

   6

   
   additionalTrustBundle: | 

   7

   
     -----BEGIN CERTIFICATE-----
     ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
     -----END CERTIFICATE-----
   imageContentSources: 

   8

   
   - mirrors:
     - <local_registry>/<local_repository_name>/release
     source: quay.io/openshift-release-dev/ocp-release
   - mirrors:
     - <local_registry>/<local_repository_name>/release
     source: quay.io/openshift-release-dev/ocp-v4.0-art-dev
   EOF

   1

   시스템 아키텍처를 지정하세요. 유효한 값은 amd64 , arm64 , ppc64le 및 s390x 입니다.

   멀티 페이로드가 있는 릴리스 이미지를 사용하는 경우 arm64 , amd64 , s390x , ppc64le 등 다양한 아키텍처에 클러스터를 설치할 수 있습니다. 그렇지 않으면 openshift-install version 명령의 출력에 표시된 릴리스 아키텍처 에만 클러스터를 설치할 수 있습니다. 자세한 내용은 "에이전트 기반 설치 프로그램 클러스터 설치를 위한 지원되는 아키텍처 확인"을 참조하세요.

   2

   필수 항목입니다. 클러스터 이름을 지정하세요.

   3

   설치할 클러스터 네트워크 플러그인입니다. 기본값인 OVNKubernetes 만 지원됩니다.

   4

   플랫폼을 지정하세요.

   참고

   베어 메탈 플랫폼의 경우 install-config.yaml 파일의 플랫폼 섹션에서 지정한 호스트 설정이 기본적으로 사용됩니다. 단, agent-config.yaml 파일에서 지정한 구성으로 이 설정이 재정의되는 경우는 예외입니다.

   5

   풀 시크릿을 지정하세요.

   6

   SSH 공개 키를 지정하세요.

   7

   미러 레지스트리에 사용한 인증서 파일의 내용을 제공하십시오. 인증서 파일은 기존의 신뢰할 수 있는 인증 기관이거나 미러 레지스트리에 대해 생성한 자체 서명 인증서일 수 있습니다. 연결이 끊긴 미러 레지스트리를 사용하는 경우 이 매개변수를 지정해야 합니다.

   8

   저장소를 미러링하는 데 사용한 명령의 출력에 따라 imageContentSources 섹션을 제공합니다. 연결이 끊긴 미러 레지스트리를 사용하는 경우 이 매개변수를 지정해야 합니다.

   중요

   • oc adm release mirror 명령을 사용할 때 imageContentSources 섹션의 출력을 사용하세요.
   • oc mirror 명령을 사용할 때, 명령을 실행한 결과로 생성되는 ImageContentSourcePolicy 파일의 repositoryDigestMirrors 섹션을 사용합니다.
   • ImageContentSourcePolicy 리소스는 더 이상 사용되지 않습니다.

4. 다음 명령을 실행하여 agent-config.yaml 파일을 만듭니다.

   $ cat > agent-config.yaml << EOF
   apiVersion: v1beta1
   kind: AgentConfig
   metadata:
     name: sno-cluster
   rendezvousIP: fd2e:6f44:5dd8:c956::50 

   1

   
   EOF

   1

   이 IP 주소는 부트스트래핑 프로세스를 수행하고 지원 서비스 구성 요소를 실행하는 노드를 결정하는 데 사용됩니다. networkConfig 매개변수에 호스트 IP 주소를 하나라도 지정하지 않은 경우 랑데부 IP 주소를 제공해야 합니다. 이 주소가 제공되지 않으면 제공된 호스트 networkConfig 매개변수에서 하나의 IP 주소가 선택됩니다.

프로세스

1. 다음 명령을 실행하여 에이전트 이미지를 만듭니다.

   $ openshift-install --dir <install_directory> agent create image

   참고

   RHCOS(Red Hat Enterprise Linux CoreOS)는 기본 디스크에서 다중 경로를 지원하므로 하드웨어 장애에 대한 탄력성이 강화된 호스트 가용성을 높일 수 있습니다. 에이전트 ISO 이미지에서는 기본적으로 다중 경로가 활성화되어 있으며 기본 /etc/multipath.conf 구성이 적용됩니다.

2. 베어 메탈 머신에서 agent.x86_64.iso , agent.aarch64.iso 또는 agent.s390x.iso 이미지를 부팅합니다.

프로세스

1. 에이전트 콘솔 애플리케이션이 구성된 릴리스 이미지를 레지스트리에서 가져올 수 있는지 확인할 때까지 기다립니다.

2. 에이전트 콘솔 애플리케이션에서 설치 프로그램 연결 검사를 통과했다고 표시하는 경우 설치를 계속하려면 메시지 표시 시간이 초과될 때까지 기다리세요.

   참고

   연결 검사를 통과한 경우에도 네트워크 구성 설정을 보거나 변경할 수 있습니다.

   그러나 시간 초과가 발생하지 않도록 에이전트 콘솔 애플리케이션과 상호 작용하도록 선택한 경우 설치를 계속하려면 TUI를 수동으로 종료해야 합니다.

3. 에이전트 콘솔 애플리케이션 검사가 실패한 경우( 릴리스 이미지 URL 풀 검사 옆에 빨간색 아이콘이 표시됨) 다음 단계에 따라 호스트의 네트워크 설정을 재구성하세요.

   1. TUI의 오류 확인 섹션을 읽어보세요. 이 섹션에서는 실패한 검사와 관련된 오류 메시지를 표시합니다.

      
   2. 네트워크 구성을 선택하여 NetworkManager TUI를 시작합니다.
   3. 연결 편집을 선택하고 재구성하려는 연결을 선택합니다.
   4. 구성을 편집하고 확인을 선택하여 변경 사항을 저장합니다.
   5. NetworkManager TUI의 메인 화면으로 돌아가려면 뒤로를 선택하세요.
   6. 연결 활성화를 선택합니다.
   7. 재구성된 네트워크를 선택하여 비활성화합니다.
   8. 재구성된 네트워크를 다시 선택하여 다시 활성화하세요.
   9. 뒤로를 선택한 다음 종료를 선택하면 에이전트 콘솔 애플리케이션으로 돌아갑니다.
   10. 새로운 네트워크 구성을 사용하여 지속적인 네트워크 검사를 다시 시작할 때까지 최소 5초 동안 기다리세요.
   11. 릴리스 이미지 URL 풀 검사가 성공하고 URL 옆에 녹색 아이콘이 표시되면 종료를 선택하여 에이전트 콘솔 애플리케이션을 종료하고 설치를 계속합니다.

프로세스

1. 선택 사항: 부트스트랩 호스트(랑데부 호스트)가 재부팅되는 시점을 알아보려면 다음 명령을 실행하세요.

   $ ./openshift-install --dir <install_directory> agent wait-for bootstrap-complete \

   1

   
       --log-level=info 

   2

   1

   <install_directory> 에 에이전트 ISO가 생성된 디렉토리 경로를 지정합니다.

   2

   다른 설치 세부 사항을 보려면 info 대신 warn, debug 또는 error를 지정합니다.

   출력 예

   ...................................................................
   ...................................................................
   INFO Bootstrap configMap status is complete
   INFO cluster bootstrap is complete

   이 명령은 Kubernetes API 서버가 컨트롤 플레인 시스템에서 부트스트랩되었다는 신호를 보낼 때 성공합니다.

2. 진행 상황을 추적하고 설치가 성공적으로 완료되었는지 확인하려면 다음 명령을 실행하세요.

   $ openshift-install --dir <install_directory> agent wait-for install-complete 

   1

   1

   <install_directory> 디렉토리에는 에이전트 ISO가 생성된 디렉토리 경로를 지정합니다.

   출력 예

   ...................................................................
   ...................................................................
   INFO Cluster is installed
   INFO Install complete!
   INFO To access the cluster as the system:admin user when using 'oc', run
   INFO     export KUBECONFIG=/home/core/installer/auth/kubeconfig
   INFO Access the OpenShift web-console here: https://console-openshift-console.apps.sno-cluster.test.example.com