11.7. GCP용 설치 파일 생성

프로세스

1. 필요한 설치 자산을 저장할 설치 디렉터리를 만듭니다.

   $ mkdir <installation_directory>

   중요

   디렉터리를 만들어야 합니다. 부트스트랩 X.509 인증서와 같은 일부 설치 자산은 단기간에 만료되므로 설치 디렉터리를 재사용해서는 안 됩니다. 다른 클러스터 설치의 개별 파일을 재사용하려면 해당 파일을 사용자 디렉터리에 복사하면 됩니다. 그러나 설치 자산의 파일 이름은 릴리스간에 변경될 수 있습니다. 따라서 이전 OpenShift Container Platform 버전에서 설치 파일을 복사할 때는 주의하십시오.

2. 샘플 install-config.yaml 파일 템플릿을 사용자 지정하여 <installation_directory>에 저장합니다.

   참고

   이 설정 파일의 이름을 install-config.yaml로 지정해야 합니다.

3. 여러 클러스터를 설치하는 데 사용할 수 있도록 install-config.yaml 파일을 백업합니다.

   중요

   install-config.yaml 파일은 설치 과정의 다음 단계에서 사용됩니다. 이 시점에서 이를 백업해야 합니다.

프로세스

1. install-config.yaml 파일을 편집하고 프록시 설정을 추가합니다. 예를 들면 다음과 같습니다.

   apiVersion: v1
   baseDomain: my.domain.com
   proxy:
     httpProxy: http://<username>:<pswd>@<ip>:<port> 1
     httpsProxy: https://<username>:<pswd>@<ip>:<port> 2
     noProxy: example.com 3
   additionalTrustBundle: | 4
       -----BEGIN CERTIFICATE-----
       <MY_TRUSTED_CA_CERT>
       -----END CERTIFICATE-----
   additionalTrustBundlePolicy: <policy_to_add_additionalTrustBundle> 5

   1

   클러스터 외부에서 HTTP 연결을 구축하는 데 사용할 프록시 URL입니다. URL 스키마는 http여야 합니다.

   2

   클러스터 외부에서 HTTPS 연결을 구축하는 데 사용할 프록시 URL입니다.

   3

   대상 도메인 이름, IP 주소 또는 프록시에서 제외할 기타 네트워크 CIDR로 이루어진 쉼표로 구분된 목록입니다. 하위 도메인과 일치하려면 도메인 앞에 .을 입력합니다. 예를 들어, .y.com은 x.y.com과 일치하지만 y.com은 일치하지 않습니다. *를 사용하여 모든 대상에 대해 프록시를 바이패스합니다.

   4

   이 값을 제공하면 설치 프로그램에서 HTTPS 연결을 프록시하는 데 필요한 추가 CA 인증서가 하나 이상 포함된 openshift-config 네임스페이스에 user-ca-bundle이라는 이름으로 구성 맵을 생성합니다. 그러면 CNO(Cluster Network Operator)에서 이러한 콘텐츠를 RHCOS(Red Hat Enterprise Linux CoreOS) 신뢰 번들과 병합하는 trusted-ca-bundle 구성 맵을 생성합니다. 이 구성 맵은 Proxy 오브젝트의 trustedCA 필드에서 참조됩니다. 프록시의 ID 인증서를 RHCOS 트러스트 번들에 있는 기관에서 서명하지 않은 경우 additionalTrustBundle 필드가 있어야 합니다.

   5

   선택 사항: trustedCA 필드에서 user-ca-bundle 구성 맵을 참조할 프록시 오브젝트의 구성을 결정하는 정책입니다. 허용되는 값은 Proxyonly 및 Always 입니다. http/https 프록시가 구성된 경우에만 user-ca-bundle 구성 맵을 참조하려면 Proxyonly 를 사용합니다. Always 를 사용하여 user-ca-bundle 구성 맵을 항상 참조합니다. 기본값은 Proxyonly 입니다.

   참고

   설치 프로그램에서 프록시 adinessEndpoints 필드를 지원하지 않습니다.

   참고

   설치 프로그램이 시간 초과되면 설치 프로그램의 wait-for 명령을 사용하여 배포를 다시 시작한 다음 완료합니다. 예를 들면 다음과 같습니다.

   $ ./openshift-install wait-for install-complete --log-level debug

2. 파일을 저장해 놓고 OpenShift Container Platform을 설치할 때 참조하십시오.

프로세스

1. OpenShift Container Platform 설치 프로그램이 포함된 디렉터리로 변경하고 클러스터에 대한 Kubernetes 매니페스트를 생성합니다.

   $ ./openshift-install create manifests --dir <installation_directory> 1

   1

   <installation_directory>는 사용자가 만든 install-config.yaml 파일이 포함된 설치 디렉터리를 지정합니다.

2. 컨트롤 플레인 시스템을 정의하는 Kubernetes 매니페스트 파일을 제거합니다.

   $ rm -f <installation_directory>/openshift/99_openshift-cluster-api_master-machines-*.yaml

   이러한 파일을 제거하면 클러스터가 컨트롤 플레인 시스템을 자동으로 생성하지 못합니다.

3. 컨트롤 플레인 머신 세트를 정의하는 Kubernetes 매니페스트 파일을 제거합니다.

   $ rm -f <installation_directory>/openshift/99_openshift-machine-api_master-control-plane-machine-set.yaml

4. 작업자 시스템을 정의하는 Kubernetes 매니페스트 파일을 제거합니다.

   $ rm -f <installation_directory>/openshift/99_openshift-cluster-api_worker-machineset-*.yaml

   작업자 시스템은 사용자가 직접 생성하고 관리하기 때문에 초기화할 필요가 없습니다.

5. <installation_directory>/manifests/cluster-scheduler-02-config.yml Kubernetes 매니페스트 파일의 mastersSchedulable 매개변수가 false로 설정되어 있는지 확인합니다. 이 설정으로 인해 컨트롤 플레인 머신에서 포드가 예약되지 않습니다.

   1. <installation_directory>/manifests/cluster-scheduler-02-config.yml 파일을 엽니다.
   2. mastersSchedulable 매개변수를 찾아서 값을 False로 설정되어 있는지 확인합니다.
   3. 파일을 저장하고 종료합니다.

6. <installation_directory>/manifests/cluster-dns-02-config.yml DNS 구성 파일에서 privateZone 섹션을 제거합니다.

   apiVersion: config.openshift.io/v1
   kind: DNS
   metadata:
     creationTimestamp: null
     name: cluster
   spec:
     baseDomain: example.openshift.com
     privateZone: 1
       id: mycluster-100419-private-zone
   status: {}

   1

   이 섹션을 완전히 제거합니다.

7. VPC에 대한 클라우드 공급자를 구성합니다.

   1. <installation_directory>/manifests/cloud-provider-config.yaml 파일을 엽니다.
   2. network-project-id 매개변수를 추가하고 공유 VPC 네트워크를 호스팅하는 프로젝트의 ID를 매개변수 값으로 설정합니다.
   3. network-name 매개변수를 추가하고 OpenShift Container Platform 클러스터를 호스팅하는 공유 VPC 네트워크의 이름을 매개변수 값으로 설정합니다.
   4. subnetwork-name 매개변수의 값을 컴퓨팅 시스템을 호스팅하는 공유 VPC 서브넷의 값으로 변경합니다.

   <installation_directory>/manifests/cloud-provider-config.yaml의 내용은 다음 예와 유사합니다.

   config: |+
     [global]
     project-id      = example-project
     regional        = true
     multizone       = true
     node-tags       = opensh-ptzzx-master
     node-tags       = opensh-ptzzx-worker
     node-instance-prefix = opensh-ptzzx
     external-instance-groups-prefix = opensh-ptzzx
     network-project-id = example-shared-vpc
     network-name    = example-network
     subnetwork-name = example-worker-subnet

8. 프라이빗 네트워크에 없는 클러스터를 배포하는 경우 <installation_directory>/manifests/cluster-ingress-default-ingresscontroller.yaml 파일을 열고 scope 매개변수 값을 External로 변경합니다. 파일의 내용은 다음 예와 유사합니다.

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     creationTimestamp: null
     name: default
     namespace: openshift-ingress-operator
   spec:
     endpointPublishingStrategy:
       loadBalancer:
         scope: External
       type: LoadBalancerService
   status:
     availableReplicas: 0
     domain: ''
     selector: ''

9. Ignition 구성 파일을 생성하려면 설치 프로그램이 포함된 디렉터리에서 다음 명령을 실행합니다.

   $ ./openshift-install create ignition-configs --dir <installation_directory> 1

   1

   <installation_directory>는 동일한 설치 디렉터리를 지정합니다.

   설치 디렉터리의 부트스트랩, 컨트롤 플레인 및 컴퓨팅 노드에 대한 Ignition 구성 파일이 생성됩니다. kubeadmin-password 및 kubeconfig 파일은 ./<installation_directory>/auth 디렉터리에 생성됩니다.

   .
   ├── auth
   │   ├── kubeadmin-password
   │   └── kubeconfig
   ├── bootstrap.ign
   ├── master.ign
   ├── metadata.json
   └── worker.ign