프로세스

1. 클러스터에 대한 Kubernetes 매니페스트를 생성합니다.

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

2. 커널 매개 변수를 작업자 또는 마스터 노드에 추가할지 여부를 결정합니다.

3. openshift 디렉토리에서 파일 (예: 99-openshift-machineconfig-master-kargs.yaml)을 작성하여 커널 설정을 추가할 MachineConfig 객체를 정의합니다. 다음 예제에서는 loglevel=7 커널 매개 변수를 마스터 노드에 추가합니다.

   $ cat << EOF > 99-openshift-machineconfig-master-kargs.yaml
   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfig
   metadata:
     labels:
       machineconfiguration.openshift.io/role: master
     name: 99-openshift-machineconfig-master-kargs
   spec:
     kernelArguments:
       - 'loglevel=7'
   EOF

   커널 매개 변수를 작업자 노드에 추가하는 경우 master를 worker로 변경할 수 있습니다. 마스터 및 작업자 노드 모두에 추가할 별도의 YAML 파일을 생성합니다.

프로세스

1. chrony.conf 파일의 내용을 작성하고 base64로 인코딩하십시오. 예를 들면 다음과 같습니다.

   $ cat << EOF | base64
       server clock.redhat.com iburst
       driftfile /var/lib/chrony/drift
       makestep 1.0 3
       rtcsync
       logdir /var/log/chrony
       EOF
   
   ICAgIHNlcnZlciBjbG9jay5yZWRoYXQuY29tIGlidXJzdAogICAgZHJpZnRmaWxlIC92YXIvbGli
   L2Nocm9ueS9kcmlmdAogICAgbWFrZXN0ZXAgMS4wIDMKICAgIHJ0Y3N5bmMKICAgIGxvZ2RpciAv
   dmFyL2xvZy9jaHJvbnkK

2. base64 문자열을 작성한 문자열로 바꾸어 MachineConfig 파일을 만듭니다. 이 예제에서는 파일을 master 노드에 추가합니다. 이를 worker로 변경하거나 worker 역할의 추가 MachineConfig을 만들 수 있습니다.

   $ cat << EOF > ./99-masters-chrony-configuration.yaml
   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfig
   metadata:
     labels:
       machineconfiguration.openshift.io/role: master
     name: masters-chrony-configuration
   spec:
     config:
       ignition:
         config: {}
         security:
           tls: {}
         timeouts: {}
         version: 2.2.0
       networkd: {}
       passwd: {}
       storage:
         files:
         - contents:
             source: data:text/plain;charset=utf-8;base64,c2VydmVyIGNsb2NrLnJlZGhhdC5jb20gaWJ1cnN0CmRyaWZ0ZmlsZSAvdmFyL2xpYi9jaHJvbnkvZHJpZnQKbWFrZXN0ZXAgMS4wIDMKcnRjc3luYwpsb2dkaXIgL3Zhci9sb2cvY2hyb255Cg==
             verification: {}
           filesystem: root
           mode: 420
           path: /etc/chrony.conf
     osImageURL: ""
   EOF

3. 설정 파일의 백업 사본을 만듭니다.
4. 클러스터가 아직 시작하지 않은 경우 매니페스트 파일을 생성하고 해당 파일을 openshift 디렉토리에 추가한 후 계속 클러스터를 작성합니다.

5. 클러스터가 이미 실행중인 경우 다음과 같이 파일을 적용합니다.

    $ oc apply -f ./masters-chrony-configuration.yaml

1. Red Hat OpenShift Cluster Manager 사이트의 Pull Secret 페이지에서 registry.redhat.io pull secret을 다운로드하여 .json 파일에 저장하십시오.

2. 다음 명령을 사용하여 레지스트리에 로그인하십시오.

   $ oc registry login --to ./pull-secret.json --registry "<registry_host_and_port>"

   레지스트리의 사용자 이름 및 비밀번호를 입력합니다.

1. OpenShift Container Platform 다운로드 페이지를 확인하여 설치할 OpenShift Container Platform 버전을 확인하고 Repository Tags 페이지에서 해당 태그를 지정합니다.

2. 필요한 환경 변수를 설정합니다.

   $ export OCP_RELEASE=<release_version> 1
   $ export LOCAL_REGISTRY='<local_registry_host_name>:<local_registry_host_port>' 2
   $ export LOCAL_REPOSITORY='<local_repository_name>' 3
   $ export PRODUCT_REPO='openshift-release-dev' 4
   $ export LOCAL_SECRET_JSON='<path_to_pull_secret>' 5
   $ export RELEASE_NAME="ocp-release" 6
   $ export ARCHITECTURE=<server_architecture> 7
   $ REMOVABLE_MEDIA_PATH=<path> 8

   1

   <release_version>에 대해 설치할 OpenShift Container Platform 버전에 해당하는 태그를 지정합니다 (예: 4.5.0).

   2

   <local_registry_host_name>의 경우 미러 저장소의 레지스트리 도메인 이름을 지정하고 <local_registry_host_port>의 경우 컨텐츠를 제공하는데 사용되는 포트를 지정합니다.

   3

   <local_repository_name>의 경우 레지스트리에 작성할 저장소 이름 (예: ocp4 / openshift4)을 지정합니다.

   4

   미러링할 저장소입니다. 프로덕션 환경의 릴리스에 대해 openshift-release-dev를 지정해야합니다.

   5

   <path_to_pull_secret>에 대해 생성한 미러 레지스트리에 대한 풀 시크릿의 절대 경로 및 파일 이름을 지정합니다.

   6

   릴리스 미러입니다. 프로덕션 환경의 릴리스에 대해 ocp-release를 지정해야합니다.

   7

   server_architecture에 대해 x86_64와 같은 서버 아키텍처를 지정합니다.

   8

   <path>에 대해 미러링된 이미지를 호스트할 디렉토리의 경로를 지정합니다.

3. 버전 이미지를 내부 컨테이너 레지스트리에 미러링합니다.

   • 미러 호스트가 인터넷에 액세스할 수 없는 경우 다음 작업을 수행하십시오.

     1. 이동식 미디어를 인터넷에 연결된 시스템에 연결합니다.

     2. 미러링할 이미지 및 설정 매니페스트를 확인합니다.

        $ oc adm -a ${LOCAL_SECRET_JSON} release mirror
        --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE}
        --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}
        --to-release-image=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} --run-dry

     3. 이전 명령의 출력에서 전체 imageContentSources 섹션을 기록합니다. 미러에 대한 정보는 미러링된 저장소에 고유하며 설치 중에 imageContentSources 섹션을 install-config.yaml 파일에 추가해야합니다.

     4. 이동식 미디어의 디렉토리에 이미지를 미러링합니다.

        $ oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE}

     5. 미디어를 네트워크가 제한된 환경으로 가져와서 이미지를 로컬 컨테이너 레지스트리에 업로드합니다.

        $ oc image mirror -a ${LOCAL_SECRET_JSON} --from-dir=${REMOVABLE_MEDIA_PATH}/mirror 'file://openshift/release:${OCP_RELEASE}*' ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}

   • 로컬 컨테이너 레지스트리가 미러 호스트에 연결된 경우 다음 작업을 수행합니다.

     1. 다음 명령을 사용하여 릴리스 이미지를 로컬 레지스트리에 직접 푸시합니다.

        $ oc adm -a ${LOCAL_SECRET_JSON} release mirror \
             --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \
             --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} \
             --to-release-image=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}

        이 명령은 클러스터를 설치할 때 필요한 imageContentSources 데이터를 포함하여 릴리스 정보 요약을 출력합니다.

     2. 이전 명령의 출력에서 imageContentSources 섹션 전체를 기록합니다. 미러에 대한 정보는 미러링된 저장소에 고유하며 설치 중에 imageContentSources 섹션을 install-config.yaml 파일에 추가해야합니다.

4. 미러링된 컨텐츠를 기반으로 설치 프로그램을 만들려면 컨텐츠를 추출하여 릴리스 배포에 고정합니다.

   $ oc adm -a ${LOCAL_SECRET_JSON} release extract --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}"

   중요

   선택한 OpenShift Container Platform 버전에 올바른 이미지를 사용하려면 미러링된 컨텐츠에서 설치 프로그램을 배포해야합니다.

   인터넷이 연결된 컴퓨터에서이 단계를 수행해야합니다.

프로세스

1. 미러링할 특정 이미지 스트림의 이미지에 액세스합니다. 예를 들면 다음과 같습니다.

   $ oc get is <imagestream> -n openshift -o json | jq .spec.tags[].from.name | grep registry.redhat.io

2. 제한된 네트워크 환경에서 필요한 모든 이미지 스트림과 관련된 registry.redhat.io의 이미지를 지정된 미러 중 하나로 미러링합니다.

   $ oc image mirror registry.redhat.io/rhscl/ruby-25-rhel7:latest ${MIRROR_ADDR}/rhscl/ruby-25-rhel7:latest

3. 클러스터의 이미지 설정 개체에서 미러에 필요한 신뢰할 수 있는 CA를 추가합니다.

   $ oc create configmap registry-config --from-file=${MIRROR_ADDR_HOSTNAME}..5000=$path/ca.crt -n openshift-config
   $ oc patch image.config.openshift.io/cluster --patch '{"spec":{"additionalTrustedCA":{"name":"registry-config"}}}' --type=merge

4. 미러 설정에 정의된 미러 위치의 hostname 부분을 포함하도록 Samples Operator 설정 개체에서 samplesRegistry 필드를 업데이트합니다.

   $ oc get configs.samples.operator.openshift.io -n openshift-cluster-samples-operator

   참고

   현재 이미지 스트림 가져 오기 프로세스에서 미러 또는 검색 메커니즘이 사용되지 않기 때문에 이 작업이 필요합니다.

5. Samples Operator 설정 개체의 skippedImagestreams 필드에 미러링되지 않은 이미지 스트림을 추가합니다. 또는 샘플 이미지 스트림을 모두 지원할 필요가 없는 경우 Samples Operator 설정 개체에서 Samples Operator를 Removed로 설정합니다.

   참고

   건너 뛰지 않고 미러링되지 않은 이미지 스트림 또는 Samples Operator가 Removed로 변경되지 않는 경우 Samples Operator는 이미지 스트림 가져 오기를 실패한 후 2 시간 후에 Degraded 상태를 보고합니다.

   OpenShift 네임 스페이스의 여러 템플릿은 이미지 스트림을 참조합니다. 따라서 Removed를 사용하여 이미지 스트림과 템플릿을 모두 제거하면 누락된 이미지 스트림으로 인해 기능이 제대로 작동하지 않을 경우 템플릿을 사용할 가능성이 없어집니다.

프로세스

1. 다음 레지스트리 URL을 허용 목록에 추가합니다.

   URL	함수
   registry.redhat.io	코어 컨테이너 이미지를 제공합니다.
   quay.io	코어 컨테이너 이미지를 제공합니다.
   sso.redhat.com	https://cloud.redhat.com/openshift 사이트에서 sso.redhat.com의 인증을 사용합니다.

2. 빌드에 필요한 언어 또는 프레임 워크에 대한 리소스를 제공하는 사이트를 허용 목록에 추가합니다.

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

   URL	함수
   cert-api.access.redhat.com	Telemetry 필수
   api.access.redhat.com	Telemetry 필수
   infogw.api.openshift.com	Telemetry 필수
   https://cloud.redhat.com/api/ingress	Telemetry 및 insights-operator 필수

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

   클라우드	URL	함수
   AWS	*.amazonaws.com	AWS 서비스 및 리소스에 액세스하는데 필요합니다. 사용하는 리전에서 허용되는 특정 엔드 포인트를 확인하려면 AWS 설명서에서 AWS 서비스 엔드 포인트를 참조하십시오.
   GCP	*.googleapis.com	GCP 서비스 및 리소스에 액세스하는 데 필요합니다. API에서 허용하는 엔드 포인트를 확인하려면 GCP 설명서에서 Cloud Endpoints를 참조하십시오.
   	accounts.google.com	GCP 계정에 액세스하는 데 필요합니다.
   Azure	management.azure.com	Azure 서비스 및 리소스에 액세스하는데 필요합니다. API에서 허용할 끝점을 확인하려면 Azure 설명서에서 Azure REST API Referenc를 참조하십시오.

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

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

프로세스

1. 클러스터의 DNS 사용자 정의 리소스를 확인합니다.

   $ oc get dnses.config.openshift.io/cluster -o yaml
   apiVersion: config.openshift.io/v1
   kind: DNS
   metadata:
     creationTimestamp: "2019-10-25T18:27:09Z"
     generation: 2
     name: cluster
     resourceVersion: "37966"
     selfLink: /apis/config.openshift.io/v1/dnses/cluster
     uid: 0e714746-f755-11f9-9cb1-02ff55d8f976
   spec:
     baseDomain: <base_domain>
     privateZone:
       tags:
         Name: <infrastructureID>-int
         kubernetes.io/cluster/<infrastructureID>: owned
     publicZone:
       id: Z2XXXXXXXXXXA4
   status: {}

   spec 섹션에는 프라이빗 영역과 퍼블릭 영역이 모두 포함되어 있습니다.

2. DNS 사용자 지정 리소스를 패치하여 퍼블릭 영역을 제거합니다.

   $ oc patch dnses.config.openshift.io/cluster --type=merge --patch='{"spec": {"publicZone": null}}'
   dns.config.openshift.io/cluster patched

   Ingress 컨트롤러는 Ingress 개체를 만들 때 DNS 정의를 참조하기 때문에 Ingress 개체를 만들거나 수정할 때 프라이빗 레코드만 생성됩니다.

   중요

   퍼블릭 영역을 제거해도 기존 Ingress 개체의 DNS 레코드는 변경되지 않습니다.

3. 선택 사항: 클러스터의 DNS 사용자 정의 리소스를 확인하고 퍼블릭 영역이 제거되었는지 확인하십시오.

   $ oc get dnses.config.openshift.io/cluster -o yaml
   apiVersion: config.openshift.io/v1
   kind: DNS
   metadata:
     creationTimestamp: "2019-10-25T18:27:09Z"
     generation: 2
     name: cluster
     resourceVersion: "37966"
     selfLink: /apis/config.openshift.io/v1/dnses/cluster
     uid: 0e714746-f755-11f9-9cb1-02ff55d8f976
   spec:
     baseDomain: <base_domain>
     privateZone:
       tags:
         Name: <infrastructureID>-int
         kubernetes.io/cluster/<infrastructureID>-wfpg4: owned
   status: {}

프로세스

1. 내부 엔드 포인트만 사용하도록 기본 Ingress 컨트롤러를 변경합니다.

   $ oc replace --force --wait --filename - <<EOF
   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     namespace: openshift-ingress-operator
     name: default
   spec:
     endpointPublishingStrategy:
       type: LoadBalancerService
       loadBalancer:
         scope: Internal
   EOF
   ingresscontroller.operator.openshift.io "default" deleted
   ingresscontroller.operator.openshift.io/default replaced

   퍼블릭 DNS 항목이 제거되고 프라이빗 영역 항목이 업데이트됩니다.

프로세스

1. AWS 또는 Azure의 웹 포털 또는 콘솔에서 다음 작업을 수행합니다.

   1. 적절한 로드 밸런서 구성 요소를 찾아 삭제합니다.

      • AWS의 경우 외부 로드 밸런서를 삭제합니다. 프라이빗 영역의 API DNS 항목은 동일한 설정을 사용하는 내부 로드 밸런서를 가리키므로 내부 로드 밸런서를 변경할 필요가 없습니다.
      • Azure의 경우 로드 밸런서의 api-internal 규칙을 삭제합니다.
   2. 퍼블릭 영역의 api.$clustername.$yourdomain DNS 항목을 삭제합니다.

2. 터미널에서 클러스터 시스템을 나열합니다.

   $ oc get machine -n openshift-machine-api
   NAME                            STATE     TYPE        REGION      ZONE         AGE
   lk4pj-master-0                  running   m4.xlarge   us-east-1   us-east-1a   17m
   lk4pj-master-1                  running   m4.xlarge   us-east-1   us-east-1b   17m
   lk4pj-master-2                  running   m4.xlarge   us-east-1   us-east-1a   17m
   lk4pj-worker-us-east-1a-5fzfj   running   m4.xlarge   us-east-1   us-east-1a   15m
   lk4pj-worker-us-east-1a-vbghs   running   m4.xlarge   us-east-1   us-east-1a   15m
   lk4pj-worker-us-east-1b-zgpzg   running   m4.xlarge   us-east-1   us-east-1b   15m

   다음 단계에서 이름에 master가 포함된 컨트롤 플레인 시스템을 변경합니다.

3. 각 컨트롤 플레인 시스템에서 외부 로드 밸런서를 제거합니다.

   1. master 시스템 개체를 편집하여 외부 로드 밸런서에 대한 참조를 제거합니다.

      $ oc edit machines -n openshift-machine-api <master_name> 1

      1

      변경할 컨트롤 플레인 또는 마스터 시스템의 이름을 지정합니다.

   2. 다음 예에 표시된 외부 로드 밸런서를 설명하는 행을 제거하고 개체 사양을 저장한 후 종료합니다.

      ...
      spec:
        providerSpec:
          value:
          ...
            loadBalancers:
            - name: lk4pj-ext 1
              type: network 2
            - name: lk4pj-int
              type: network

      1 2

      이 줄을 삭제합니다.

   3. 이름에 master가 포함된 각 시스템에 대해 이 프로세스를 반복합니다.