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

에이전트 기반 설치 관리자를 사용하여 부팅 가능한 ISO 이미지를 생성할 수 있도록 install-config.yaml 및 agent-config.yaml 구성 파일을 생성해야 합니다. 에이전트 기반 설치는 지원 검색 에이전트와 지원 서비스가 있는 부팅 가능한 ISO로 구성됩니다. 이러한 두 구성 요소는 클러스터 설치를 수행하는 데 필요하지만 후자의 구성 요소는 호스트 중 하나에서만 실행됩니다.

이후 단계에서는 생성된 에이전트 ISO 이미지를 Oracle의 기본 Object Storage 버킷에 업로드하는 Oracle 문서의 단계를 수행해야 합니다. 이 버킷은 OCI(Oracle® Cloud Infrastructure)에 OpenShift Container Platform 클러스터를 통합하는 초기 단계입니다.

참고

에이전트 기반 설치 관리자를 사용하여 ZTP(Zero Touch Provisioning) 사용자 지정 리소스를 생성하거나 허용할 수도 있습니다.

사전 요구 사항

OpenShift Container Platform 설치 및 업데이트 프로세스에 대한 세부 사항을 검토했습니다.
클러스터 설치 방법 선택 및 사용자 방법에 대한 문서를 읽습니다.
"인터 기반 설치 관리자와 함께 설치할 준비" 문서를 읽었습니다.
Red Hat Hybrid Cloud Console에서 에이전트 기반 설치 프로그램과 CLI(명령줄 인터페이스)를 다운로드했습니다.
관리자 권한으로 OpenShift Container Platform에 로그인했습니다.

프로세스

연결이 끊긴 환경의 경우 Red Hat OpenShift의 미러 레지스트리를 로컬 컨테이너 이미지 레지스트리에 미러링합니다.
중요
openshift-install 바이너리 버전이 Red Hat Quay와 같은 공유 레지스트리가 아닌 로컬 이미지 컨테이너 레지스트리와 관련이 있는지 확인합니다.
```
$ ./openshift-install version
```
공유 레지스트리 바이너리의 출력 예
```
./openshift-install 4.17.0
built from commit ae7977b7d1ca908674a0d45c5c243c766fa4b2ca
release image registry.ci.openshift.org/origin/release:4.17ocp-release@sha256:0da6316466d60a3a4535d5fed3589feb0391989982fba59d47d4c729912d6363
release architecture amd64
```
조직의 요구 사항을 충족하도록 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
인프라에 따라 x86_64 또는 amd64 를 선택할 수 있습니다.
5
OpenShift Container Platform이 OCI 와 통합할 수 있도록 OCI를 외부 플랫폼으로 설정합니다.
6
SSH 공개 키를 지정합니다.
7
OpenShift Container Platform 구성 요소 및 서비스의 컨테이너 이미지를 다운로드할 때 인증에 필요한 풀 시크릿(예: Quay.io)입니다. Red Hat Hybrid Cloud Console에서 OpenShift Container Platform 4 설치를 참조하십시오.
로컬 시스템에 openshift 라는 디렉터리를 만듭니다.
중요
install-config.yaml 및 agent-config.yaml 구성 파일을 openshift 디렉터리로 이동하지 마십시오.
Oracle 문서의 "구성 파일" 섹션에 있는 단계를 완료하여 Oracle CCO(Cloud Controller Manager) 및 CSI(Container Storage Interface) 매니페스트를 아카이브 파일로 다운로드하고 openshift 디렉터리에 아카이브 파일을 저장합니다. OpenShift Container Platform이 외부 OCI 플랫폼에 연결할 수 있도록 클러스터 설치 중에 Oracle CCM을 배포하려면 Oracle CCM 매니페스트가 필요합니다. OpenShift Container Platform에서 OCI에서 필요한 오브젝트를 요청할 수 있도록 클러스터 설치 중에 Oracle CSI 드라이버를 배포하려면 Oracle CSI 사용자 정의 매니페스트가 필요합니다.
Oracle 문서의 "구성 파일" 섹션에 제공된 사용자 정의 매니페스트 파일에 액세스합니다.
1. oci-ccm.yml 구성 파일에 정의된 oci-cloud-controller-manager 시크릿을 변경하여 로드 밸런서에서 조직 리전, OCID, VCN OCID 서브넷과 일치시킵니다.
에이전트 기반 설치 관리자를 사용하여 OpenShift Container Platform CLI에 다음 명령을 입력하여 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 이미지는 운영 체제를 부팅, 복구 및 복구하는 데 필요합니다.
조직의 요구 사항을 충족하도록 agent-config.yaml 구성 파일을 구성합니다.
IPv4 형식의 네트워크의 값을 설정하는 agent-config.yaml 구성 파일의 예.
```
apiVersion: v1alpha1
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입니다.
agent-config.yaml 구성 파일에 다음 두 업데이트 중 하나를 적용합니다.
- 연결이 끊긴 네트워크의 경우: 명령을 실행하여 최소 ISO 이미지를 생성한 후 에이전트 기반 설치 프로그램은 rootfs 이미지를 로컬 시스템의 ./<installation_directory>/boot-artifacts 디렉터리에 저장합니다. 모든httpd(Hypertext Transfer Protocol daemon)와 같은 선호하는 웹 서버를 사용하여 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 이미지 구성에 추가하여 Operator가 클러스터 노드를 부팅할 때 에이전트 기반 설치 프로그램이 rootfs 이미지를 시스템 메모리에 다운로드합니다.
- 연결된 네트워크의 경우: agent-config.yaml 구성 파일에 bootArtifactsBaseURL 매개변수를 지정할 필요가 없습니다. 에이전트 기반 설치 프로그램의 기본 동작은 https://rhcos.mirror.openshift.com 에서 rootfs URL 위치를 읽습니다. 에이전트 기반 설치 프로그램이 외부 플랫폼의 최소 ISO를 부팅하면 에이전트 기반 설치 프로그램이 기본 RHCOS URL에서 rootfs 파일을 시스템의 메모리에 다운로드합니다.
  중요
  1 GB를 초과하는 전체 ISO 이미지에 rootfs 이미지가 포함되어 있습니다. 이미지는 최소 ISO 이미지보다 크며 일반적으로 150 MB 미만입니다.

추가 리소스

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

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Red Hat legal and privacy links

Red Hat legal and privacy links