2.11. RHCOS 설치 및 OpenShift Container Platform 부트스트랩 프로세스 시작

프로세스

1. 각 Ignition 구성 파일에 대해 SHA512 다이제스트를 가져옵니다. 예를 들어 Linux를 실행하는 시스템에서 다음을 사용하여 bootstrap.ign Ignition 구성 파일의 SHA512 다이제스트를 가져올 수 있습니다.

   $ sha512sum <installation_directory>/bootstrap.ign

   다이제스트는 클러스터 노드에서 Ignition 구성 파일의 신뢰성을 검증하기 위해 이후 단계에서 coreos-installer에 제공됩니다.

2. 설치 프로그램에서 생성한 부트스트랩, 컨트롤 플레인, 컴퓨팅 노드 Ignition 구성 파일을 HTTP 서버에 업로드합니다. 해당 파일의 URL을 기록해 둡니다.

   중요

   HTTP 서버에 저장하기 전에 Ignition 구성에서 구성 설정을 추가하거나 변경할 수 있습니다. 설치를 마친 후 클러스터에 컴퓨팅 시스템을 더 추가하려면 Ignition 구성 파일을 삭제하지 마십시오.

3. 설치 호스트에서 Ignition 구성 파일을 URL에서 사용할 수 있는지 확인합니다. 다음 예에서는 부트스트랩 노드에 대한 Ignition 구성 파일을 가져옵니다.

   $ curl -k http://<HTTP_server>/bootstrap.ign 1

   출력 예

     % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                    Dload  Upload   Total   Spent    Left  Speed
     0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0{"ignition":{"version":"3.2.0"},"passwd":{"users":[{"name":"core","sshAuthorizedKeys":["ssh-rsa...

   명령에서 bootstrap.ign을 master.ign 또는 worker.ign으로 교체하여 컨트롤 플레인 및 컴퓨팅 노드의 Ignition 구성 파일도 사용할 수 있는지 확인합니다.

4. RHCOS 이미지 미러 페이지에서 운영 체제 인스턴스 설치 방법에 필요한 RHCOS 이미지를 가져올 수 있지만 올바른 RHCOS 이미지 버전을 가져오는 데 권장되는 방법은 openshift-install 명령 출력에서 가져옵니다.

   $ openshift-install coreos print-stream-json | grep '\.iso[^.]'

   출력 예

   "location": "<url>/art/storage/releases/rhcos-4.14-aarch64/<release>/aarch64/rhcos-<release>-live.aarch64.iso",
   "location": "<url>/art/storage/releases/rhcos-4.14-ppc64le/<release>/ppc64le/rhcos-<release>-live.ppc64le.iso",
   "location": "<url>/art/storage/releases/rhcos-4.14-s390x/<release>/s390x/rhcos-<release>-live.s390x.iso",
   "location": "<url>/art/storage/releases/rhcos-4.14/<release>/x86_64/rhcos-<release>-live.x86_64.iso",

   중요

   RHCOS 이미지는 OpenShift Container Platform 릴리스에 따라 변경되지 않을 수 있습니다. 설치하는 OpenShift Container Platform 버전과 같거나 그 이하의 버전 중 가장 최신 버전의 이미지를 다운로드해야 합니다. 사용 가능한 경우 OpenShift Container Platform 버전과 일치하는 이미지 버전을 사용합니다. 이 프로세스에는 ISO 이미지만 사용하십시오. 이 설치 유형에서는 RHCOS qcow2 이미지가 지원되지 않습니다.

   ISO 파일 이름은 다음 예와 유사합니다.

   rhcos-<version>-live.<architecture>.iso

5. ISO를 사용하여 RHCOS 설치를 시작합니다. 다음 설치 옵션 중 하나를 사용합니다.

   • ISO 이미지를 디스크에 굽고 직접 부팅합니다.
   • LOM(Lightweight-out Management) 인터페이스를 사용하여 ISO 리디렉션을 사용합니다.

6. 옵션을 지정하거나 라이브 부팅 시퀀스를 중단하지 않고 RHCOS ISO 이미지를 부팅합니다. 설치 프로그램이 RHCOS 라이브 환경에서 쉘 프롬프트로 부팅될 때까지 기다립니다.

   참고

   커널 인수를 추가하기 위해 RHCOS 설치 부팅 프로세스를 중단할 수 있습니다. 하지만 이 ISO 프로세스에서는 커널 인수를 추가하지 않고 다음 단계에 설명된 대로 coreos-installer 명령을 사용해야 합니다.

7. coreos-installer 명령을 실행하고 설치 요구 사항을 충족하는 옵션을 지정합니다. 최소한 노드 유형에 대한 Ignition 구성 파일과 설치할 장치를 가리키는 URL을 지정해야 합니다.

   $ sudo coreos-installer install --ignition-url=http://<HTTP_server>/<node_type>.ign <device> --ignition-hash=sha512-<digest> 12

   1 1

   core 사용자에게 설치를 수행하는 데 필요한 root 권한이 없으므로 sudo를 사용하여 coreos-installer 명령을 실행해야 합니다.

   2

   클러스터 노드에서 Ignition 구성 파일을 HTTP URL을 통해 가져오려면 --ignition-hash 옵션이 필요합니다. <digest>는 이전 단계에서 얻은 Ignition 구성 파일 SHA512 다이제스트입니다.

   참고

   TLS를 사용하는 HTTPS 서버를 통해 Ignition 구성 파일을 제공하려는 경우 coreos-installer를 실행하기 전에 내부 인증 기관(CA)을 시스템 신뢰 저장소에 추가할 수 있습니다.

   다음 예제에서는 /dev/sda 장치에 부트스트랩 노드 설치를 초기화합니다. 부트스트랩 노드의 Ignition 구성 파일은 IP 주소 192.168.1.2가 있는 HTTP 웹 서버에서 가져옵니다.

   $ sudo coreos-installer install --ignition-url=http://192.168.1.2:80/installation_directory/bootstrap.ign /dev/sda --ignition-hash=sha512-a5a2d43879223273c9b60af66b44202a1d1248fc01cf156c46d4a79f552b6bad47bc8cc78ddf0116e80c59d2ea9e32ba53bc807afbca581aa059311def2c3e3b

8. 머신 콘솔에서 RHCOS 설치 진행률을 모니터링합니다.

   중요

   OpenShift Container Platform 설치를 시작하기 전에 각 노드에서 성공적으로 설치되었는지 확인합니다. 설치 프로세스를 관찰하면 발생할 수 있는 RHCOS 설치 문제의 원인을 파악하는 데 도움이 될 수 있습니다.

9. RHCOS를 설치한 후 시스템을 재부팅해야 합니다. 시스템이 재부팅되는 동안 지정한 Ignition 구성 파일이 적용됩니다.

10. 콘솔 출력을 확인하여 Ignition이 실행되었는지 확인합니다.

    명령 예

    Ignition: ran on 2022/03/14 14:48:33 UTC (this boot)
    Ignition: user-provided config was applied

11. 계속해서 클러스터에 대한 나머지 시스템을 모두 생성합니다.

    중요

    이때 부트스트랩 및 컨트롤 플레인 시스템을 생성해야 합니다. 컨트롤 플레인 시스템이 예약 가능하지 않은 경우 OpenShift Container Platform을 설치하기 전에 두 개 이상의 컴퓨팅 시스템도 생성합니다.

    적합한 네트워킹, DNS 및 로드 밸런싱 인프라가 있는 경우 RHCOS 노드가 재부팅된 후 OpenShift Container Platform 부트스트랩 프로세스가 자동으로 시작됩니다.

    참고

    RHCOS 노드에는 core 사용자의 기본 암호가 포함되지어 있지 않습니다. install_config.yaml 파일에 지정한 공개 키에 대한 액세스 권한이 있는 사용자로 ssh core@<node>.<cluster_name>.<base_domain>을 실행하여 노드에 액세스할 수 있습니다. RHCOS를 실행하는 OpenShift Container Platform 4 클러스터 노드는 변경할 수 없으며 Operator를 통해 클러스터 변경 사항을 적용합니다. SSH를 사용하여 클러스터 노드에 액세스하는 것은 권장되지 않습니다. 그러나 설치 문제를 조사할 때 OpenShift Container Platform API를 사용할 수 없거나 kubelet이 대상 노드에서 제대로 작동하지 않는 경우 디버깅 또는 재해 복구에 SSH 액세스가 필요할 수 있습니다.

프로세스

1. 설치 프로그램에서 생성한 부트스트랩, 컨트롤 플레인, 컴퓨팅 노드 Ignition 구성 파일을 HTTP 서버에 업로드합니다. 해당 파일의 URL을 기록해 둡니다.

   중요

   HTTP 서버에 저장하기 전에 Ignition 구성에서 구성 설정을 추가하거나 변경할 수 있습니다. 설치를 마친 후 클러스터에 컴퓨팅 시스템을 더 추가하려면 Ignition 구성 파일을 삭제하지 마십시오.

2. 설치 호스트에서 Ignition 구성 파일을 URL에서 사용할 수 있는지 확인합니다. 다음 예에서는 부트스트랩 노드에 대한 Ignition 구성 파일을 가져옵니다.

   $ curl -k http://<HTTP_server>/bootstrap.ign 1

   출력 예

     % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                    Dload  Upload   Total   Spent    Left  Speed
     0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0{"ignition":{"version":"3.2.0"},"passwd":{"users":[{"name":"core","sshAuthorizedKeys":["ssh-rsa...

   명령에서 bootstrap.ign을 master.ign 또는 worker.ign으로 교체하여 컨트롤 플레인 및 컴퓨팅 노드의 Ignition 구성 파일도 사용할 수 있는지 확인합니다.

3. RHCOS 이미지 미러 페이지에서 운영 체제 인스턴스 설치 방법에 필요한 RHCOS 커널,initramfs 및 rootfs 파일을 가져올 수 있지만 올바른 RHCOS 파일의 버전을 얻는 것이 좋습니다. openshift-install 명령 출력에서 다음과 같습니다.

   $ openshift-install coreos print-stream-json | grep -Eo '"https.*(kernel-|initramfs.|rootfs.)\w+(\.img)?"'

   출력 예

   "<url>/art/storage/releases/rhcos-4.14-aarch64/<release>/aarch64/rhcos-<release>-live-kernel-aarch64"
   "<url>/art/storage/releases/rhcos-4.14-aarch64/<release>/aarch64/rhcos-<release>-live-initramfs.aarch64.img"
   "<url>/art/storage/releases/rhcos-4.14-aarch64/<release>/aarch64/rhcos-<release>-live-rootfs.aarch64.img"
   "<url>/art/storage/releases/rhcos-4.14-ppc64le/49.84.202110081256-0/ppc64le/rhcos-<release>-live-kernel-ppc64le"
   "<url>/art/storage/releases/rhcos-4.14-ppc64le/<release>/ppc64le/rhcos-<release>-live-initramfs.ppc64le.img"
   "<url>/art/storage/releases/rhcos-4.14-ppc64le/<release>/ppc64le/rhcos-<release>-live-rootfs.ppc64le.img"
   "<url>/art/storage/releases/rhcos-4.14-s390x/<release>/s390x/rhcos-<release>-live-kernel-s390x"
   "<url>/art/storage/releases/rhcos-4.14-s390x/<release>/s390x/rhcos-<release>-live-initramfs.s390x.img"
   "<url>/art/storage/releases/rhcos-4.14-s390x/<release>/s390x/rhcos-<release>-live-rootfs.s390x.img"
   "<url>/art/storage/releases/rhcos-4.14/<release>/x86_64/rhcos-<release>-live-kernel-x86_64"
   "<url>/art/storage/releases/rhcos-4.14/<release>/x86_64/rhcos-<release>-live-initramfs.x86_64.img"
   "<url>/art/storage/releases/rhcos-4.14/<release>/x86_64/rhcos-<release>-live-rootfs.x86_64.img"

   중요

   OpenShift Container Platform의 모든 릴리스에서 RHCOS 아티팩트가 변경되지 않을 수도 있습니다. 설치하는 OpenShift Container Platform 버전과 같거나 그 이하의 버전 중 가장 최신 버전의 이미지를 다운로드해야 합니다. 이 프로시저에는 아래 설명된 적절한 kernel, initramfs 및 rootfs 아티팩트만 사용하십시오. 이 설치 유형에서는 RHCOS QCOW2 이미지가 지원되지 않습니다.

   OpenShift Container Platform 버전 번호가 파일 이름에 포함됩니다. 다음 예와 유사합니다.

   • kernel: rhcos-<version>-live-kernel-<architecture>
   • initramfs: rhcos-<version>-live-initramfs.<architecture>.img
   • rootfs: rhcos-<version>-live-rootfs.<architecture>.img

4. rootfs, kernel 및 initramfs 파일을 HTTP 서버에 업로드합니다.

   중요

   설치를 마친 후 클러스터에 컴퓨팅 시스템을 더 추가하려면 Ignition 구성 파일을 삭제하지 마십시오.

5. RHCOS가 설치된 후 시스템이 로컬 디스크에서 부팅되도록 네트워크 부팅 인프라를 구성하십시오.

6. RHCOS 이미지에 대한 PXE 또는 iPXE 설치를 구성하고 설치를 시작하십시오.

   사용 환경에 대한 다음 예시 메뉴 항목 중 하나를 수정하고, 이미지 및 Ignition 파일에 적절히 접근할 수 있는지 확인하십시오.

   • PXE (x86_64)의 경우:

     DEFAULT pxeboot
     TIMEOUT 20
     PROMPT 0
     LABEL pxeboot
         KERNEL http://<HTTP_server>/rhcos-<version>-live-kernel-<architecture> 1
         APPEND initrd=http://<HTTP_server>/rhcos-<version>-live-initramfs.<architecture>.img coreos.live.rootfs_url=http://<HTTP_server>/rhcos-<version>-live-rootfs.<architecture>.img coreos.inst.install_dev=/dev/sda coreos.inst.ignition_url=http://<HTTP_server>/bootstrap.ign 2 3

     1 1

     HTTP 서버에 업로드한 라이브 kernel 파일의 위치를 지정합니다. URL은 HTTP, TFTP 또는 FTP여야 합니다. HTTPS와 NFS는 지원되지 않습니다.

     2

     NIC를 여러 개 사용하는 경우 ip 옵션에 단일 인터페이스를 지정합니다. 예를 들어, eno1라는 NIC에서 DHCP를 사용하려면 ip=eno1:dhcp를 설정하십시오.

     3

     HTTP 서버에 업로드한 RHCOS 파일의 위치를 지정합니다. initrd 매개변수 값은 initramfs 파일의 위치, coreos.live.rootfs_url 매개변수 값은 rootfs 파일의 위치, coreos.inst.ignition_url 매개변수 값은 부트스트랩 Ignition 구성 파일의 위치입니다. APPEND 줄에 커널 인수를 더 추가하여 네트워킹 또는 기타 부팅 옵션도 구성할 수 있습니다.

     참고

     이 구성은 그래픽 콘솔이 있는 머신에서 직렬 콘솔 액세스를 활성화하지 않습니다. 다른 콘솔을 구성하려면 APPEND 행에 하나 이상의 console= 인수를 추가합니다. 예를 들어 console=tty0 console=ttyS0을 추가하여 첫 번째 PC 직렬 포트를 기본 콘솔로 설정하고 그래픽 콘솔을 보조 콘솔로 설정합니다. 자세한 내용은 How does one set up a serial terminal and/or console in Red Hat Enterprise Linux? 및 "Enabling the serial console for PXE and ISO installation" 섹션을 참조하십시오.

   • iPXE (x86_64 + aarch64 )의 경우:

     kernel http://<HTTP_server>/rhcos-<version>-live-kernel-<architecture> initrd=main coreos.live.rootfs_url=http://<HTTP_server>/rhcos-<version>-live-rootfs.<architecture>.img coreos.inst.install_dev=/dev/sda coreos.inst.ignition_url=http://<HTTP_server>/bootstrap.ign 1 2
     initrd --name main http://<HTTP_server>/rhcos-<version>-live-initramfs.<architecture>.img 3
     boot

     1

     HTTP 서버에 업로드한 RHCOS 파일의 위치를 지정합니다. kernel 매개변수 값은 kernel 파일의 위치이고 initrd=main 인수는 UEFI 시스템에서 부팅하는 데 필요하며 coreos.live.rootfs_url 매개 변수 값은 rootfs 파일의 위치이며, coreos.inst.ignition_url 매개 변수 값은 부트스트랩 Ignition 설정 파일의 위치입니다.

     2

     NIC를 여러 개 사용하는 경우 ip 옵션에 단일 인터페이스를 지정합니다. 예를 들어, eno1라는 NIC에서 DHCP를 사용하려면 ip=eno1:dhcp를 설정하십시오.

     3

     HTTP 서버에 업로드한 initramfs 파일의 위치를 지정합니다.

     참고

     이 구성은 그래픽 콘솔이 있는 머신에서 직렬 콘솔 액세스를 활성화하지 않습니다. 다른 콘솔을 구성하려면 kernel 행에 하나 이상의 console= 인수를 추가합니다. 예를 들어 console=tty0 console=ttyS0을 추가하여 첫 번째 PC 직렬 포트를 기본 콘솔로 설정하고 그래픽 콘솔을 보조 콘솔로 설정합니다. 자세한 내용은 How does one set up a serial terminal and/or console in Red Hat Enterprise Linux? 및 "Enabling the serial console for PXE and ISO installation" 섹션을 참조하십시오.

     참고

     aarch64 아키텍처에서 CoreOS kernel 을 부팅하려면 IMAGE_GZIP 옵션이 활성화된 iPXE 빌드 버전을 사용해야 합니다. iPXE의IMAGE_GZIP 옵션을 참조하십시오.

   • aarch64 에서 PXE ( UEFI 및 Grub를 두 번째 단계로 사용)의 경우 :

     menuentry 'Install CoreOS' {
         linux rhcos-<version>-live-kernel-<architecture>  coreos.live.rootfs_url=http://<HTTP_server>/rhcos-<version>-live-rootfs.<architecture>.img coreos.inst.install_dev=/dev/sda coreos.inst.ignition_url=http://<HTTP_server>/bootstrap.ign 1 2
         initrd rhcos-<version>-live-initramfs.<architecture>.img 3
     }

     1

     HTTP/TFTP 서버에 업로드한 RHCOS 파일의 위치를 지정합니다. kernel 매개변수 값은 TFTP 서버의 파일의 위치입니다. coreos.live.rootfs_url 매개변수 값은 rootfs 파일의 위치이며 coreos.inst.ignition_url 매개변수 값은 HTTP Server의 부트스트랩 Ignition 구성 파일의 위치입니다.

     2

     NIC를 여러 개 사용하는 경우 ip 옵션에 단일 인터페이스를 지정합니다. 예를 들어, eno1라는 NIC에서 DHCP를 사용하려면 ip=eno1:dhcp를 설정하십시오.

     3

     TFTP 서버에 업로드한 initramfs 파일의 위치를 지정합니다.

7. 머신 콘솔에서 RHCOS 설치 진행률을 모니터링합니다.

   중요

   OpenShift Container Platform 설치를 시작하기 전에 각 노드에서 성공적으로 설치되었는지 확인합니다. 설치 프로세스를 관찰하면 발생할 수 있는 RHCOS 설치 문제의 원인을 파악하는 데 도움이 될 수 있습니다.

8. RHCOS가 설치되면 시스템을 재부팅합니다. 시스템이 재부팅되는 동안 지정한 Ignition 구성 파일이 적용됩니다.

9. 콘솔 출력을 확인하여 Ignition이 실행되었는지 확인합니다.

   명령 예

   Ignition: ran on 2022/03/14 14:48:33 UTC (this boot)
   Ignition: user-provided config was applied

10. 클러스터용 시스템 생성을 계속합니다.

    중요

    이때 부트스트랩 및 컨트롤 플레인 시스템을 생성해야 합니다. 컨트롤 플레인 시스템이 예약 가능하지 않은 경우 클러스터를 설치하기 전에 두 개 이상의 컴퓨팅 시스템도 생성합니다.

    적합한 네트워킹, DNS 및 로드 밸런싱 인프라가 있는 경우 RHCOS 노드가 재부팅된 후 OpenShift Container Platform 부트스트랩 프로세스가 자동으로 시작됩니다.

    참고

    RHCOS 노드에는 core 사용자의 기본 암호가 포함되지어 있지 않습니다. install_config.yaml 파일에 지정한 공개 키에 대한 액세스 권한이 있는 사용자로 ssh core@<node>.<cluster_name>.<base_domain>을 실행하여 노드에 액세스할 수 있습니다. RHCOS를 실행하는 OpenShift Container Platform 4 클러스터 노드는 변경할 수 없으며 Operator를 통해 클러스터 변경 사항을 적용합니다. SSH를 사용하여 클러스터 노드에 액세스하는 것은 권장되지 않습니다. 그러나 설치 문제를 조사할 때 OpenShift Container Platform API를 사용할 수 없거나 kubelet이 대상 노드에서 제대로 작동하지 않는 경우 디버깅 또는 재해 복구에 SSH 액세스가 필요할 수 있습니다.

프로세스

1. 다중 경로를 활성화하고 multipathd 데몬을 시작하려면 설치 호스트에서 다음 명령을 실행합니다.

   $ mpathconf --enable && systemctl start multipathd.service

   • 선택 사항: PXE 또는 ISO를 부팅하는 경우 커널 명령줄에서 rd.multipath=default를 추가하여 멀티패스를 활성화할 수 있습니다.

2. coreos-installer 프로그램을 호출하여 커널 인수를 추가합니다.

   • 시스템에 연결된 멀티패스 장치가 하나뿐인 경우 경로 /dev/mapper/mpatha에서 사용할 수 있어야 합니다. 예를 들면 다음과 같습니다.

     $ coreos-installer install /dev/mapper/mpatha \1
     --ignition-url=http://host/worker.ign \
     --append-karg rd.multipath=default \
     --append-karg root=/dev/disk/by-label/dm-mpath-root \
     --append-karg rw

     1

     단일 멀티패스 장치의 경로를 나타냅니다.

   • 시스템에 연결된 멀티패스 장치가 여러 개 있는 경우 보다 명확하게 하려면 /dev/mapper/mpatha를 사용하는 대신 /dev/disk/by-id에서 사용할 수 있는 WWN(World Wide Name) 심볼릭 링크를 사용하는 것이 좋습니다. 예를 들면 다음과 같습니다.

     $ coreos-installer install /dev/disk/by-id/wwn-<wwn_ID> \1
     --ignition-url=http://host/worker.ign \
     --append-karg rd.multipath=default \
     --append-karg root=/dev/disk/by-label/dm-mpath-root \
     --append-karg rw

     1

     멀티패스 대상 장치의 WWN ID를 나타냅니다. 예를 들면 0xx194e957fcedb4841입니다.

     이 심볼릭 링크는 라이브 설치 프로그램을 지시하기 위해 특수 coreos.inst.** 인수를 사용할 때coreos.inst.install_dev 커널 인수로 사용될 수도 있습니다. 자세한 내용은 "RHCOS 설치 및 OpenShift Container Platform 부트스트랩 프로세스 시작"을 참조하십시오.

3. 설치된 시스템으로 재부팅하십시오.

4. 작업자 노드 중 하나로 이동하고 커널 명령줄 인수 (호스트의 /proc/cmdline)를 나열하여 커널 인수가 작동하는지 확인합니다.

   $ oc debug node/ip-10-0-141-105.ec2.internal

   출력 예

   Starting pod/ip-10-0-141-105ec2internal-debug ...
   To use host binaries, run `chroot /host`
   
   sh-4.2# cat /host/proc/cmdline
   ...
   rd.multipath=default root=/dev/disk/by-label/dm-mpath-root
   ...
   
   sh-4.2# exit

   추가된 커널 인수가 표시되어야 합니다.