OCI에 설치

프로세스

1. 관리자 권한으로 Oracle Cloud Infrastructure(OCI) 계정에 로그인합니다.

2. 클라우드 계정 및 리소스(Oracle 문서)를 정의하여 계정을 구성합니다. 다음 리소스를 생성해야 합니다.

   1. OCI 리소스에 대한 사용 제한을 구성하고, 액세스를 제한하며, 사용 제한을 설정하기 위한 하위 항목을 생성합니다. 전체 절차는 Compartment(Oracle 문서) 생성 을 참조하십시오.
   2. 검색 ISO 이미지를 업로드할 새 오브젝트 스토리지 버킷을 생성합니다. 전체 프로시저는 Creating an Object Storage Bucket (Oracle 문서) 을 참조하십시오.

3. oracle -quickstart/oci-openshift 리포지토리에서 create-cluster-vX.X.zip 구성 파일의 최신 버전을 다운로드합니다. 이 파일은 클러스터에 대한 인프라를 제공하고 다음과 같은 구성을 포함합니다.

   • Terraform Stacks: OCI 리소스를 프로비저닝하여 OCI에서 OpenShift Container Platform 클러스터를 생성하고 관리하는 Terraform 스택 코드입니다.
   • 사용자 정의 매니페스트: OCI에 OpenShift Container Platform 클러스터를 설치하는 데 필요한 매니페스트 파일입니다.
   참고

   매니페스트를 변경하려면 전체 Oracle GitHub 리포지토리를 복제하고 custom_manifests 및 terraform-stacks 디렉터리에 직접 액세스할 수 있습니다.

   자세한 내용은 구성 파일(Oracle 문서) 을 참조하십시오.

프로세스

1. Oracle Cloud Infrastructure (OCI) 계정에 로그인합니다.
2. 로컬 드라이브에서 검색 ISO 이미지를 생성한 새 오브젝트 스토리지 버킷에 업로드합니다. 전체 절차는 Bucket(Oracle 문서)에 오브젝트 스토리지 오브젝트 업로드를 참조하십시오.

3. 업로드된 검색 ISO를 찾고 다음 단계를 완료합니다.

   1. 인접한 옵션 메뉴에서 ISO에 대한 PAR(Pre-Authenticated Request)을 생성합니다.
   2. 생성된 URL을 복사하여 다음 단계에서 OpenShift 이미지 소스 URI로 사용합니다.

   전체 프로시저는 Creating a Pre-Authenticated Requests in Object Storage (Oracle documentation) 를 참조하십시오.

4. Terraform 스택을 생성하고 적용합니다.

   중요

   Terraform 스택에는 클러스터 리소스 및 사용자 정의 매니페스트를 생성하기 위한 파일이 포함되어 있습니다. 스택에는 스크립트도 포함되어 있으며 스택을 적용할 때 스크립트는 DNS 레코드, 인스턴스 등과 같은 OCI 리소스를 생성합니다. 리소스 목록은 OCI README 파일에서 OpenShift의 Terraform 정의 리소스를 참조하십시오.

   1. Terraform 스택 템플릿 create-cluster-vX.X.X.zip 을 새 오브젝트 스토리지 버킷에 업로드합니다.

   2. 스택 정보를 작성하고 다음을 클릭합니다.

      중요
      • 클러스터 이름이 지원 설치 관리자의 클러스터 이름과 일치하는지 확인하고 Zone DNS 가 지원 설치 관리자의 기본 도메인 과 일치하는지 확인합니다.
      • OpenShift 이미지 소스 URI 필드에 이전 단계에서 생성한 사전 인증 요청 URL 링크를 붙여넣습니다.
      • 베어 메탈 또는 가상 머신에 설치하는지 여부에 따라 올바른 Compute Shape 필드 값이 정의되었는지 확인합니다. 그렇지 않은 경우 목록에서 다른 모양을 선택합니다. 자세한 내용은 Compute Shapes (Oracle documentation) 를 참조하십시오.
   3. 적용을 클릭하여 스택을 적용합니다.

   전체 절차는 Creating OpenShift Container Platform Infrastructure Using Resource Manager (Oracle documentation) 를 참조하십시오.

5. Terraform 스택의 출력 페이지에서 dynamic_custom_manifest.yml 파일을 복사합니다.

   참고

   YAML 파일에는 구성 값과 연결된 모든 매니페스트가 포함되어 있습니다. 자세한 내용은 Custom Manifests README 파일을 참조하십시오.

   전체 절차는 설치를 위한 OpenShift Container Platform 사용자 정의 매니페스트 가져오기(Oracle 문서)를 참조하십시오.

프로세스

1. Red Hat Hybrid Cloud Console 에서 Clusters > Assisted Clusters 로 이동하여 클러스터 이름을 선택합니다.
2. 설치 진행률 페이지에서 설치 진행률 표시줄이 100%이고 설치가 성공적으로 완료되었음을 나타내는 메시지가 표시되는지 확인합니다.

3. 호스트 인벤토리 에서 모든 컨트롤 플레인 및 컴퓨팅 노드의 상태가 설치되어 있는지 확인합니다.

   참고

   OpenShift Container Platform은 컨트롤 플레인 노드 중 하나를 부트스트랩 가상 머신으로 지정하여 별도의 부트스트랩 시스템이 필요하지 않습니다.

4. 웹 콘솔 URL을 클릭하여 OpenShift Container Platform 웹 콘솔에 액세스합니다.
5. 메뉴에서 Compute > Nodes 를 선택합니다.
6. 노드 테이블에서 노드를 찾습니다.
7. 터미널 탭에서 iSCSI가 일련 번호 옆에 표시되는지 확인합니다.
8. 개요 탭에서 노드의 상태가 Ready 인지 확인합니다.
9. YAML 탭을 선택합니다.
10. labels 매개변수를 확인하고 나열된 라벨이 구성에 적용되는지 확인합니다. 예를 들어 topology.kubernetes.io/region=us-sanjose-1 레이블은 노드가 배포된 OCI 리전에서 나타냅니다.

1. OCI 리소스 및 서비스(Oracle)를 생성합니다.
2. 연결이 끊긴 환경: OCI 인스턴스(Red Hat)에서 액세스할 수 있는 웹 서버를 준비합니다.
3. 에이전트 기반 설치 관리자(Red Hat)에 대한 구성 파일을 준비합니다.
4. 에이전트 ISO 이미지(Red Hat)를 생성합니다.
5. 연결이 끊긴 환경: rootfs 이미지를 웹 서버(Red Hat)에 업로드합니다.
6. Red Hat(OpenShift Container Platform)에 대한 방화벽을 구성합니다.
7. 에이전트 ISO 이미지를 스토리지 버킷(Oracle)에 업로드합니다.
8. 업로드된 에이전트 ISO 이미지(Oracle)에서 사용자 지정 이미지를 생성합니다.
9. OCI(Oracle)에서 컴퓨팅 인스턴스를 생성합니다.
10. 클러스터가 OCI(Oracle)에서 실행되는지 확인합니다.

프로세스

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

   $ mkdir ~/<directory_name>

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
   # ...

   1

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

   2

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

   3 4

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

   5

   OpenShift Container Platform이 OCI 와 통합할 수 있도록 OCI를 외부 플랫폼으로 설정합니다.

   6

   SSH 공개 키를 지정합니다.

   7

   OpenShift Container Platform 구성 요소 및 서비스의 컨테이너 이미지를 다운로드할 때 인증에 필요한 풀 시크릿(예: Quay.io)입니다. 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 로 표시된 섹션을 업데이트하여 OCID(Oracle® Cloud Identifier), 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
   # ...

   1

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

   2

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

   3

   IPv4를 네트워크 IP 주소 형식으로 사용하는 경우 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

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

   • ./<installation_directory>/auth 디렉터리: ./<installation_directory >/auth 디렉터리를 생성하여 kubeadmin-password 및 kubeconfig 파일을 하위 디렉터리에 배치합니다.
   • agent-config.yaml 구성 파일에서 지정한 IP 주소를 기반으로 rendezvousIP 파일을 생성합니다.

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

     중요

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

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

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

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

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

      참고

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

      중요

      1 GB를 초과하는 전체 ISO 이미지에 rootfs 이미지가 포함되어 있습니다. 이미지는 최소 ISO 이미지보다 크며 일반적으로 150 MB 미만입니다.

프로세스

1. 방화벽 허용 목록에 대해 다음 레지스트리 URL을 설정합니다.

   URL	포트	함수
   registry.redhat.io	443	코어 컨테이너 이미지를 제공합니다.
   access.redhat.com	443	컨테이너 클라이언트에서 registry.access.redhat.com 에서 가져온 이미지를 확인하는 데 필요한 서명 저장소를 호스팅합니다. 방화벽 환경에서 이 리소스가 허용 목록에 있는지 확인합니다.
   registry.access.redhat.com	443	코어 컨테이너 이미지를 포함하여 Red Hat Ecosystem Catalog에 저장된 모든 컨테이너 이미지를 호스팅합니다.
   quay.io	443	코어 컨테이너 이미지를 제공합니다.
   cdn.quay.io	443	코어 컨테이너 이미지를 제공합니다.
   cdn01.quay.io	443	코어 컨테이너 이미지를 제공합니다.
   cdn02.quay.io	443	코어 컨테이너 이미지를 제공합니다.
   cdn03.quay.io	443	코어 컨테이너 이미지를 제공합니다.
   cdn04.quay.io	443	코어 컨테이너 이미지를 제공합니다.
   cdn05.quay.io	443	코어 컨테이너 이미지를 제공합니다.
   cdn06.quay.io	443	코어 컨테이너 이미지를 제공합니다.
   sso.redhat.com	443	https://console.redhat.com 사이트에서 sso.redhat.com의 인증을 사용합니다.

   • 허용 목록에 cdn.quay.io 및 cdn0[1-6].quay.io 대신 와일드카드 *.quay.io 및 *.openshiftapps.com 을 사용할 수 있습니다.
   • 와일드카드 *.access.redhat.com 을 사용하여 구성을 단순화하고 registry.access.redhat.com 을 포함한 모든 하위 도메인이 허용되는지 확인할 수 있습니다.
   • 허용 목록에 quay.io와 같은 사이트를 추가할 때 *.quay.io와 같은 와일드카드 항목을 거부 목록에 추가하지 마십시오. 대부분의 경우 이미지 레지스트리는 CDN(Content deliver network)을 사용하여 이미지를 제공합니다. 방화벽 블록에 액세스하면 초기 다운로드 요청이 cdn01.quay.io 와 같은 호스트 이름으로 리디렉션될 때 이미지 다운로드가 거부됩니다.
2. 방화벽의 허용 목록에 빌드에 필요한 언어 또는 프레임워크에 대한 리소스를 제공하는 모든 사이트를 포함하도록 설정합니다.

3. Telemetry를 비활성화하지 않은 경우 Red Hat Insights에 액세스하려면 다음 URL에 대한 액세스 권한을 부여해야합니다

   URL	포트	함수
   cert-api.access.redhat.com	443	Telemetry 필수
   api.access.redhat.com	443	Telemetry 필수
   infogw.api.openshift.com	443	Telemetry 필수
   console.redhat.com	443	Telemetry 및 insights-operator 필수

4. 방화벽의 허용 목록에 다음 레지스트리 URL을 포함하도록 설정합니다.

   URL	포트	함수
   api.openshift.com	443	클러스터 토큰과 클러스터에 업데이트를 사용할 수 있는지 확인하는 데 필요합니다.
   rhcos.mirror.openshift.com	443	RHCOS (Red Hat Enterprise Linux CoreOS) 이미지를 다운로드하는 데 필요합니다.

5. 방화벽의 허용 목록에 다음 외부 URL을 포함하도록 설정합니다. 각 리포지토리 URL은 OCI 컨테이너를 호스팅합니다. 성능 문제를 줄이기 위해 이미지를 가능한 한 적은 수의 저장소로 미러링하는 것이 좋습니다.

   URL	포트	함수
   k8s.gcr.io	port	커뮤니티 기반 이미지 레지스트리의 컨테이너 이미지를 호스팅하는 Kubernetes 레지스트리입니다. 이 이미지 레지스트리는 사용자 정의 GCR(Google Container Registry) 도메인에서 호스팅됩니다.
   ghcr.io	port	Open Container Initiative 이미지를 저장하고 관리할 수 있는 GitHub 이미지 레지스트리입니다. 개인, 내부 및 공용 패키지를 게시, 설치 및 삭제하려면 액세스 토큰이 필요합니다.
   storage.googleapis.com	443	릴리스 이미지 서명 소스입니다 (Cluster Version Operator에는 단일 기능 소스만 필요)
   registry.k8s.io	port	k8s.gcr.io 이미지 레지스트리가 다른 플랫폼 및 공급 업체를 지원하지 않기 때문에 k8s.gcr.io 이미지 레지스트리를 대체합니다.

프로세스

1. 에이전트 ISO 이미지를 Oracle의 기본 Object Storage 버킷에 업로드하고 에이전트 ISO 이미지를 이 버킷에 사용자 지정 이미지로 가져옵니다. UEFI(Unified Extensible Firmware Interface) 모드로 부팅되도록 사용자 지정 이미지를 구성해야 합니다. 자세한 내용은 Creating the OpenShift Container Platform ISO Image (Oracle documentation) 를 참조하십시오.

2. 클러스터 토폴로지에 대해 제공된 기본 이미지에서 컴퓨팅 인스턴스를 생성합니다. OCI(Oracle 문서)에서 OpenShift Container Platform 클러스터 생성 을 참조하십시오.

   중요

   컴퓨팅 인스턴스를 생성하기 전에 클러스터에 충분한 메모리 및 디스크 리소스가 있는지 확인합니다. 또한 agent-config.yaml 파일의 rendezvousIP 에 명시된 주소와 하나 이상의 컴퓨팅 인스턴스의 IP 주소가 동일한지 확인합니다.