Oracle Edge Cloud에 설치

1. Oracle® Edge Cloud bastion 서버 준비.
2. Home 리전을 통해 Terraform 스크립트 실행.
3. Oracle Edge Cloud용 OpenShift Container Platform 이미지 준비.
4. Oracle® Edge Cloud 리전을 통해 Terraform 스크립트 실행.
5. 지원 설치 프로그램 웹 콘솔을 사용하여 클러스터 설치.

프로세스

1. bastion 서버를 설치합니다. 자세한 내용은 Oracle 문서의 "사용 설치" 섹션을 참조하십시오.
2. Terraform 스크립트를 실행하는 데 사용되는 Terraform 애플리케이션을 설치합니다. 자세한 내용은 Oracle 문서의 "Terraform Installation" 섹션을 참조하십시오.
3. OCI CLI(명령줄 인터페이스)를 설치하고 구성합니다. 자세한 내용은 Oracle 문서의 " OCI CLI 설치 및 구성" 섹션을 참조하십시오.

프로세스

1. SSH를 통해 bastion 서버에 연결합니다.
2. OpenShift\createResourceOnhomeRegion 폴더 를 만듭니다.
3. C3_PCA GitHub 리포지토리에서 createInfraResources.tf 및 terraform.tfvars 파일을 createResourceOnHomeRegion 폴더에 복사합니다.
4. 소스 환경에 액세스할 수 있고 C3 인증서를 내보내야 합니다.
5. createInfraResources.tf Terraform 스크립트를 실행합니다.

프로세스

1. SSH를 통해 bastion 서버에 연결합니다.
2. C3 인증서 위치를 설정하고 인증서를 내보냅니다.
3. terraform.tfvars 스크립트를 실행하여 컨트롤 플레인 노드 3개와 컴퓨팅 노드 3개를 생성합니다.
4. 컨트롤 플레인 및 컴퓨팅 노드의 레이블을 업데이트합니다.
5. Oracle® Edge Cloud 포털에서 인스턴스를 하나씩 중지하고 다시 시작합니다.

1. OCI(Oracle Cloud Infrastructure) 리소스 및 서비스(Oracle)를 생성합니다.
2. 에이전트 기반 설치 관리자(Red Hat)에 대한 구성 파일을 준비합니다.
3. 에이전트 ISO 이미지(Red Hat)를 생성합니다.
4. ISO 이미지를 OCI 이미지로 변환하고 OCI 홈 리전 Bucket에 업로드한 다음 업로드된 이미지를 Oracle Edge Cloud 시스템(Oracle)으로 가져옵니다.
5. 연결이 끊긴 환경: Oracle Edge Cloud 인스턴스(Red Hat)에서 액세스할 수 있는 웹 서버를 준비합니다.
6. 연결이 끊긴 환경: rootfs 이미지를 웹 서버(Red Hat)에 업로드합니다.
7. Red Hat(OpenShift Container Platform)에 대한 방화벽을 구성합니다.
8. 컨트롤 플레인 노드를 생성하고 로드 밸런서(Oracle)를 구성합니다.
9. 컴퓨팅 노드를 생성하고 로드 밸런서(Oracle)를 구성합니다.
10. 클러스터가 Oracle Edge Cloud (Oracle)에서 실행되는지 확인합니다.

프로세스

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

   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. Oracle 사용자 지정 매니페스트 파일을 구성합니다.

   1. Compute Cloud@Customer(Oracle 문서)의 에이전트 기반 설치 관리자를 사용하여 OpenShift 클러스터 설정 의 "OpenShift 마스터 이미지 사전 설정"으로 이동합니다.
   2. oci-ccm.yml,oci-csi.yml, machineconfig-ccm.yml 파일을 복사하여 openshift 디렉터리에 붙여넣습니다.
   3. oci-ccm.yml 및 oci-csi.yml 파일을 편집하여 compartment Oracle® Cloud Identifier (OCID), VCN OCID, 로드 밸런서의 OCID 서브넷, 보안 목록 OCID, c3-cert.pem 섹션을 지정합니다.

5. 조직의 요구 사항을 충족하도록 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

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

   4

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

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

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

   Copy to Clipboard Toggle word wrap

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

   • ./<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 이미지는 운영 체제를 부팅, 복구 및 복구하는 데 필요합니다.

7. 연결이 끊긴 환경만 해당: 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을 설정합니다.

   Expand

   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의 인증을 사용합니다.
   icr.io	443	IBM Cloud Pak 컨테이너 이미지를 제공합니다. 이 도메인은 IBM Cloud Paks를 사용하는 경우에만 필요합니다.
   cp.icr.io	443	IBM Cloud Pak 컨테이너 이미지를 제공합니다. 이 도메인은 IBM Cloud Paks를 사용하는 경우에만 필요합니다.

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

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

   Expand

   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 필수

   Show more

4. Alibaba Cloud, AWS(Amazon Web Services), Microsoft Azure 또는 Google Cloud를 사용하여 클러스터를 호스팅하는 경우 클라우드 공급자 API 및 DNS를 제공하는 URL에 대한 액세스 권한을 부여해야 합니다.

   Expand

   클라우드	URL	포트	함수
   Alibaba	*.aliyuncs.com	443	Alibaba Cloud 서비스 및 리소스에 액세스하는 데 필요합니다. Alibaba endpoints_config.go 파일을 검토하여 사용하는 리전에서 허용할 정확한 끝점을 찾습니다.
   AWS	aws.amazon.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	*.amazonaws.com 또는 AWS API에 와일드카드를 사용하지 않도록 선택하는 경우 허용 목록에 다음 URL을 포함해야 합니다.	443	AWS 서비스 및 리소스에 액세스하는데 필요합니다. AWS 문서에서 AWS Service Endpoints 를 검토하여 사용하는 리전에서 허용할 정확한 끝점을 찾습니다.
   	ec2.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	events.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	iam.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	route53.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	*.s3.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	*.s3.<aws_region>.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	*.s3.dualstack.<aws_region>.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	sts.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	sts.<aws_region>.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	tagging.us-east-1.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다. 이 끝점은 클러스터가 배포된 리전에 관계없이 항상 us-east-1 입니다.
   	ec2.<aws_region>.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	elasticloadbalancing.<aws_region>.amazonaws.com	443	AWS 환경에서 클러스터를 설치하고 관리하는 데 사용됩니다.
   	servicequotas.<aws_region>.amazonaws.com	443	필수 항목입니다. 서비스 배포 할당량을 확인하는 데 사용됩니다.
   	tagging.<aws_region>.amazonaws.com	443	태그 형식으로 AWS 리소스에 대한 메타데이터를 할당할 수 있습니다.
   	*.cloudfront.net	443	CloudFront에 대한 액세스를 제공하는 데 사용됩니다. AWS STS(Security Token Service) 및 프라이빗 S3 버킷을 사용하는 경우 CloudFront에 대한 액세스를 제공해야 합니다.
   GCP	*.googleapis.com	443	Google Cloud 서비스 및 리소스에 액세스하는 데 필요합니다. API에서 허용할 엔드포인트를 찾으려면 Google Cloud 설명서에서 Cloud Endpoints 를 검토하십시오.
   	accounts.google.com	443	Google Cloud 계정에 액세스하는 데 필요합니다.
   Microsoft Azure	management.azure.com	443	Microsoft Azure 서비스 및 리소스에 액세스하는 데 필요합니다. Microsoft Azure 설명서에서 API를 허용할 끝점을 찾으려면 Microsoft Azure REST API 참조를 확인하십시오.
   	*.blob.core.windows.net	443	Ignition 파일을 다운로드하는 데 필요합니다.
   	login.microsoftonline.com	443	Microsoft Azure 서비스 및 리소스에 액세스하는 데 필요합니다. Microsoft Azure 설명서에서 Azure REST API 참조를 검토하여 API에서 허용할 끝점을 찾습니다.

   Show more

5. 다음 URL을 허용 목록에 추가하십시오.

   Expand

   URL	포트	함수
   *.apps.<cluster_name>.<base_domain>	443	설치 중에 ingress 와일드 카드를 설정하지 않으면 기본 클러스터 라우트에 액세스하는데 필요합니다.
   api.openshift.com	443	클러스터 토큰과 클러스터에 업데이트를 사용할 수 있는지 확인하는 데 필요합니다.
   console.redhat.com	443	클러스터 토큰에 필요합니다.
   mirror.openshift.com	443	미러링된 설치 콘텐츠 및 이미지에 액세스하는 데 필요합니다. Cluster Version Operator에는 단일 기능 소스만 필요하지만 이 사이트는 릴리스 이미지 서명의 소스이기도합니다.
   quayio-production-s3.s3.amazonaws.com	443	AWS에서 Quay 이미지 콘텐츠에 액세스하는데 필요합니다.
   rhcos.mirror.openshift.com	443	RHCOS(Red Hat Enterprise Linux CoreOS) 이미지를 다운로드하는 데 필요합니다.
   sso.redhat.com	443	https://console.redhat.com 사이트에서 sso.redhat.com의 인증을 사용합니다.
   storage.googleapis.com/openshift-release	443	릴리스 이미지 서명 소스입니다 (Cluster Version Operator에는 단일 기능 소스만 필요)

   Show more

   Operator는 상태 확인을 수행하기 위해 경로 액세스가 필요합니다. 특히 인증 및 웹 콘솔 Operator는 두 경로에 연결하여 경로가 작동하는지 확인합니다. 클러스터 관리자이고 * .apps. <cluster_name>.<base_domain>을 허용하지 않으려면 다음 경로를 허용하십시오.

   • oauth-openshift.apps.<cluster_name>.<base_domain>
   • canary-openshift-ingress-canary.apps.<cluster_name>.<base_domain>
   • console-openshift-console.apps. <cluster_name>.<base_domain> 또는 필드가 비어 있지 않은 경우 consoles.operator/cluster 객체의 spec.route.hostname 필드에 지정된 호스트 이름입니다.

6. 선택적 타사 콘텐츠에 대해 다음 URL을 허용 목록에 추가합니다.

   Expand

   URL	포트	함수
   registry.connect.redhat.com	443	모든 타사 이미지 및 인증된 Operator에 필요합니다.

   Show more

7. 기본 NTP(Red Hat Network Time Protocol) 서버를 사용하는 경우 다음 URL을 허용합니다.

   • 1.rhel.pool.ntp.org
   • 2.rhel.pool.ntp.org
   • 3.rhel.pool.ntp.org

프로세스

1. 에이전트 ISO 이미지를 OCI 이미지로 변환하고 OCI 홈 리전 Bucket에 업로드한 다음 업로드된 이미지를 Oracle Edge Cloud 시스템으로 가져옵니다. 자세한 내용은 Compute Cloud@Customer(Oracle 문서)의 에이전트 기반 설치 관리자를 사용하여 OpenShift 클러스터 설정 의 "OpenShift 마스터 이미지 사전 설정"을 참조하십시오.
2. Oracle Edge Cloud에서 컨트롤 플레인 인스턴스를 생성합니다. 자세한 내용은 Compute Cloud@Customer(Oracle 문서)의 에이전트 기반 설치 관리자를 사용하여 OpenShift 클러스터 설정의 "C3에서 컨트롤 플레인 인스턴스 생성 및 마스터 노드 LB 백엔드 세트"를 참조하십시오.

3. 클러스터 토폴로지에 대해 제공된 기본 이미지에서 컴퓨팅 인스턴스를 생성합니다. 자세한 내용은 Compute Cloud@Customer(Oracle 문서)의 에이전트 기반 설치 관리자를 사용하여 OpenShift 클러스터 설정 의 "작업 노드 추가"를 참조하십시오.

   중요

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