2.4. OCI에 클러스터를 설치하기 위한 구성 파일 생성

프로세스

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

   $ mkdir ~/<directory_name>

   Copy to Clipboard Toggle word wrap

2. 조직의 요구 사항에 맞게 install-config.yaml 구성 파일을 구성하고 생성한 디렉토리에 파일을 저장합니다.

   외부 플랫폼을 설정하는 install-config.yaml 파일

   # install-config.yaml
   apiVersion: v1
   baseDomain: <base_domain> 

   1

   
   networking:
     clusterNetwork:
     - cidr: 10.128.0.0/14
       hostPrefix: 23
     network type: OVNKubernetes
     machineNetwork:
     - cidr: <ip_address_from_cidr> 

   2

   
     serviceNetwork:
     - 172.30.0.0/16
   compute:
     - architecture: amd64 

   3

   
     hyperthreading: Enabled
     name: worker
     replicas: 0
   controlPlane:
     architecture: amd64 

   4

   
     hyperthreading: Enabled
     name: master
     replicas: 3
   platform:
      external:
       platformName: oci 

   5

   
       cloudControllerManager: External
   sshKey: <public_ssh_key> 

   6

   
   pullSecret: '<pull_secret>' 

   7

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   클라우드 공급자의 기본 도메인입니다.

   2

   CIDR이 네트워크에서 작동하는 리소스와 구성 요소에 할당하는 가상 클라우드 네트워크(VCN)의 IP 주소입니다.

   3 4

   인프라에 따라 arm64 또는 amd64를 선택할 수 있습니다.

   5

   OCI를 외부 플랫폼으로 설정하면 OpenShift Container Platform이 OCI와 통합될 수 있습니다.

   6

   SSH 공개 키를 지정하세요.

   7

   Quay.io와 같은 OpenShift Container Platform 구성 요소 및 서비스에 대한 컨테이너 이미지를 다운로드할 때 인증 목적으로 필요한 풀 시크릿입니다. Red Hat Hybrid Cloud Console에서 OpenShift Container Platform 4 설치를 참조하세요.

3. 로컬 시스템에 openshift 라는 이름의 디렉토리를 만듭니다. 이는 설치 디렉토리의 하위 디렉토리여야 합니다.

   중요

   install-config.yaml 또는 agent-config.yaml 구성 파일을 openshift 디렉토리로 이동하지 마세요.

4. 스택을 사용하여 OCI 인프라 리소스를 프로비저닝한 경우: OCI 스택의 dynamic_custom_manifest 출력을 복사하여 manifest.yaml 이라는 파일에 붙여넣고 해당 파일을 openshift 디렉터리에 저장합니다.

5. OCI 인프라 리소스를 프로비저닝하기 위해 스택을 사용하지 않은 경우: 사용자 지정 매니페스트를 다운로드하고 준비하여 에이전트 ISO 이미지를 만듭니다.

   1. 구성 파일 (Oracle 문서)로 이동한 후 GitHub의 사용자 정의 매니페스트 디렉토리 링크를 따르세요.
   2. condensed-manifest.yml 파일의 내용을 복사하여 openshift 디렉토리의 파일에 로컬로 저장합니다.
   3. condensed-manifest.yml 파일에서 TODO 로 표시된 섹션을 업데이트하여 구획 Oracle® Cloud Identifier(OCID), VCN OCID, 로드 밸런서의 서브넷 OCID, 보안 목록 OCID를 지정합니다.

6. 조직의 요구 사항에 맞게 agent-config.yaml 구성 파일을 구성하세요.

   IPv4 네트워크에 대한 agent-config.yaml 파일 샘플입니다.

   apiVersion: v1beta1
   metadata:
     name: <cluster_name> 

   1

   
     namespace: <cluster_namespace> 

   2

   
   rendezvousIP: <ip_address_from_CIDR> 

   3

   
   bootArtifactsBaseURL: <server_URL> 

   4

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   DNS 레코드에 지정한 클러스터 이름입니다.

   2

   OpenShift Container Platform의 클러스터 네임스페이스입니다.

   3

   네트워크 IP 주소 형식으로 IPv4를 사용하는 경우 rendezvousIP 매개변수를 VCN의 CIDR(Classless Inter-Domain Routing) 방식이 네트워크에 할당하는 IPv4 주소로 설정해야 합니다. 또한 ISO로 부팅한 인스턴스 풀에서 최소한 하나의 인스턴스가 rendezvousIP 매개변수에 설정한 IP 주소 값과 일치하는지 확인하세요.

   4

   rootfs 이미지를 업로드할 서버의 URL입니다. 이 매개변수는 연결이 끊긴 환경에만 필요합니다.

7. 설치 디렉토리에 다음 명령을 입력하여 rootfs 이미지를 제외한 최소 ISO 이미지를 생성합니다.

   $ ./openshift-install agent create image --log-level debug

   Copy to Clipboard Toggle word wrap

   이 명령은 다음 작업도 완료합니다.

   • 하위 디렉토리인 ./<installation_directory>/auth 디렉토리를 만들고, 해당 하위 디렉토리에 kubeadmin-password 및 kubeconfig 파일을 넣습니다.
   • agent-config.yaml 구성 파일에 지정한 IP 주소를 기반으로 rendezvousIP 파일을 생성합니다.

   • 선택 사항: agent-config.yaml 및 install-config.yaml 구성 파일에 대한 모든 수정 사항은 ZTP(Zero Touch Provisioning) 사용자 정의 리소스로 가져옵니다.

     중요

     에이전트 기반 설치 프로그램은 Red Hat Enterprise Linux CoreOS(RHCOS)를 사용합니다. 이후 단계에서 언급할 rootfs 이미지는 운영 체제를 부팅, 복구, 수리하는 데 필요합니다.

8. 연결이 끊긴 환경에만 해당: rootfs 이미지를 웹 서버에 업로드합니다.

   1. 최소 ISO 이미지를 생성할 때 생성된 ./<installation_directory>/boot-artifacts 디렉토리로 이동합니다.

   2. HTTP (Hypertext Transfer Protocol) 데몬과 같은 선호하는 웹 서버를 사용하여 agent-config.yaml 파일의 bootArtifactsBaseURL 매개변수에 지정된 위치에 rootfs 이미지를 업로드합니다.

      예를 들어, bootArtifactsBaseURL 매개변수가 http://192.168.122.20 을 나타내는 경우 생성된 rootfs 이미지를 이 위치에 업로드하면 에이전트 기반 설치 프로그램이 http://192.168.122.20/agent.x86_64-rootfs.img 에서 이미지에 액세스할 수 있습니다. 에이전트 기반 설치 프로그램이 외부 플랫폼용 최소 ISO를 부팅한 후, 에이전트 기반 설치 프로그램은 http://192.168.122.20/agent.x86_64-rootfs.img 위치에서 rootfs 이미지를 시스템 메모리로 다운로드합니다.

      참고

      에이전트 기반 설치 프로그램은 bootArtifactsBaseURL 의 값을 최소 ISO 이미지 구성에 추가하므로 운영자가 클러스터의 노드를 부팅할 때 에이전트 기반 설치 프로그램은 rootfs 이미지를 시스템 메모리에 다운로드합니다.

      중요

      1GB 가 넘는 전체 ISO 이미지에는 rootfs 이미지가 포함되어 있다는 점을 고려하세요. 이미지는 일반적으로 150MB 미만인 최소 ISO 이미지보다 큽니다.