4.5. IBM Z에 호스팅된 컨트롤 플레인 배포

프로세스

1. 다음 명령을 입력하여 네임스페이스를 생성합니다.

   $ oc create ns <hosted_cluster_namespace>

   Copy to Clipboard Toggle word wrap

   & lt;hosted_cluster_namespace&gt;를 호스팅된 클러스터 네임스페이스의 식별자로 바꿉니다. HyperShift Operator는 네임스페이스를 생성합니다. 베어 메탈 인프라에서 호스팅된 클러스터 생성 프로세스 중에 생성된 Cluster API 공급자 역할에 네임스페이스가 이미 있어야 합니다.

2. 다음 명령을 입력하여 호스팅된 클러스터에 대한 구성 파일을 생성합니다.

   $ hcp create cluster agent \
     --name=<hosted_cluster_name> \

   1

   
     --pull-secret=<path_to_pull_secret> \

   2

   
     --agent-namespace=<hosted_control_plane_namespace> \

   3

   
     --base-domain=<base_domain> \

   4

   
     --api-server-address=api.<hosted_cluster_name>.<base_domain> \

   5

   
     --etcd-storage-class=<etcd_storage_class> \

   6

   
     --ssh-key=<path_to_ssh_key> \

   7

   
     --namespace=<hosted_cluster_namespace> \

   8

   
     --control-plane-availability-policy=HighlyAvailable \

   9

   
     --release-image=quay.io/openshift-release-dev/ocp-release:<ocp_release_image>-multi \

   10

   
     --node-pool-replicas=<node_pool_replica_count> \

   11

   
     --render \
     --render-sensitive \
     --ssh-key <home_directory>/<path_to_ssh_key>/<ssh_key> > hosted-cluster-config.yaml 

   12

   Copy to Clipboard Toggle word wrap

   1

   호스트된 클러스터의 이름을 지정합니다( 예: ).

   2

   풀 시크릿의 경로를 지정합니다(예: /user/name/pullsecret ).

   3

   호스트된 컨트롤 플레인 네임스페이스를 지정합니다(예: clusters-example ). oc get agent -n <hosted_control_plane_namespace> 명령을 사용하여 이 네임스페이스 에서 에이전트를 사용할 수 있는지 확인합니다.

   4

   krnl.es 와 같은 기본 도메인을 지정합니다.

   5

   --api-server-address 플래그는 호스팅된 클러스터의 Kubernetes API 통신에 사용할 IP 주소를 정의합니다. --api-server-address 플래그를 설정하지 않으면 관리 클러스터에 연결하려면 로그인해야 합니다.

   6

   lvm-storageclass 와 같은 etcd 스토리지 클래스 이름을 지정합니다.

   7

   SSH 공개 키의 경로를 지정합니다. 기본 파일 경로는 ~/.ssh/id_rsa.pub 입니다.

   8

   호스팅된 클러스터 네임스페이스를 지정합니다.

   9

   호스팅된 컨트롤 플레인 구성 요소의 가용성 정책을 지정합니다. 지원되는 옵션은 SingleReplica 및 HighlyAvailable 입니다. 기본값은 HighlyAvailable 입니다.

   10

   사용하려는 지원되는 OpenShift Container Platform 버전 (예: 4.19.0-multi )을 지정합니다. 연결이 끊긴 환경을 사용하는 경우 < ocp_release_image >를 다이제스트 이미지로 교체합니다. OpenShift Container Platform 릴리스 이미지 다이제스트를 추출하려면 OpenShift Container Platform 릴리스 이미지 다이제스트 추출을 참조하십시오.

   11

   3 과 같은 노드 풀 복제본 수를 지정합니다. 동일한 수의 복제본을 생성하려면 복제본 수를 0 이상으로 지정해야 합니다. 그렇지 않으면 노드 풀을 생성하지 않습니다.

   12

   --ssh-key 플래그 후 user/.ssh/id_rsa 와 같은 SSH 키의 경로를 지정합니다.

3. 다음 명령을 입력하여 호스팅 클러스터 구성 파일에 변경 사항을 적용합니다.

   $ oc apply -f hosted_cluster_config.yaml

   Copy to Clipboard Toggle word wrap

4. 다음 명령을 입력하여 호스팅된 클러스터, 노드 풀 및 Pod 생성을 확인합니다.

   $ oc get hostedcluster \
     <hosted_cluster_name> -n \
     <hosted_cluster_namespace> -o \
     jsonpath='{.status.conditions[?(@.status=="False")]}' | jq .

   Copy to Clipboard Toggle word wrap

   $ oc get hostedcluster \
     <nodepool_name> -n \
     <hosted_cluster_namespace> -o \
     jsonpath='{.status.conditions[?(@.status=="False")]}' | jq .

   Copy to Clipboard Toggle word wrap

   $ oc get pods -n <hosted_control_plane_namespace>

   Copy to Clipboard Toggle word wrap
5. 호스트 클러스터가 준비되었는지 확인합니다. Available: True 는 컨트롤 플레인의 준비 상태를 나타냅니다.

프로세스

1. 다음 명령을 실행합니다.

   virt-install \
      --name "<vm_name>" \ 

   1

   
      --autostart \
      --ram=16384 \
      --cpu host \
      --vcpus=4 \
      --location "<path_to_kernel_initrd_image>,kernel=kernel.img,initrd=initrd.img" \ 

   2

   
      --disk <qcow_image_path> \ 

   3

   
      --network network:macvtap-net,mac=<mac_address> \ 

   4

   
      --graphics none \
      --noautoconsole \
      --wait=-1
      --extra-args "rd.neednet=1 nameserver=<nameserver>   coreos.live.rootfs_url=http://<http_server>/rootfs.img random.trust_cpu=on rd.luks.options=discard ignition.firstboot ignition.platform.id=metal console=tty1 console=ttyS1,115200n8 coreos.inst.persistent-kargs=console=tty1 console=ttyS1,115200n8" 

   5

   Copy to Clipboard Toggle word wrap

   1

   가상 머신의 이름을 지정합니다.

   2

   kernel_initrd_image 파일의 위치를 지정합니다.

   3

   디스크 이미지 경로를 지정합니다.

   4

   Mac 주소를 지정합니다.

   5

   에이전트의 서버 이름을 지정합니다.

2. ISO 부팅의 경우 InfraEnv 리소스에서 ISO를 다운로드하고 다음 명령을 실행하여 노드를 부팅합니다.

   virt-install \
     --name "<vm_name>" \ 

   1

   
     --autostart \
     --memory=16384 \
     --cpu host \
     --vcpus=4 \
     --network network:macvtap-net,mac=<mac_address> \ 

   2

   
     --cdrom "<path_to_image.iso>" \ 

   3

   
     --disk <qcow_image_path> \
     --graphics none \
     --noautoconsole \
     --os-variant <os_version> \ 

   4

   
     --wait=-1

   Copy to Clipboard Toggle word wrap

   1

   가상 머신의 이름을 지정합니다.

   2

   Mac 주소를 지정합니다.

   3

   image.iso 파일의 위치를 지정합니다.

   4

   사용 중인 운영 체제 버전을 지정합니다.

프로세스

1. 에이전트를 위한 부팅 매개변수 파일을 생성합니다.

   매개변수 파일 예

   rd.neednet=1 cio_ignore=all,!condev \
   console=ttysclp0 \
   ignition.firstboot ignition.platform.id=metal
   coreos.live.rootfs_url=http://<http_server>/rhcos-<version>-live-rootfs.<architecture>.img \

   1

   
   coreos.inst.persistent-kargs=console=ttysclp0
   ip=<ip>::<gateway>:<netmask>::<interface>:none nameserver=<dns> \

   2

   
   rd.znet=qeth,<network_adaptor_range>,layer2=1
   rd.<disk_type>=<adapter> \

   3

   
   zfcp.allow_lun_scan=0
   ai.ip_cfg_override=1 \

   4

   
   random.trust_cpu=on rd.luks.options=discard

   Copy to Clipboard Toggle word wrap

   1

   coreos.live.rootfs_url 아티팩트의 경우 시작 중인 커널 및 initramfs 와 일치하는 rootfs 아티팩트를 지정합니다. HTTP 및 HTTPS 프로토콜만 지원됩니다.

   2

   ip 매개변수의 경우 IBM Z 및 IBM LinuxONE에 z/VM으로 클러스터 설치에 설명된 대로 IP 주소를 수동으로 할당합니다.

   3

   DASD 유형 디스크에 설치하는 경우 rd.dasd 를 사용하여 RHCOS(Red Hat Enterprise Linux CoreOS)를 설치할 DASD를 지정합니다. FCP 유형 디스크에 설치하려면 rd.zfcp=<adapter>,<wwpn>,<lun >을 사용하여 RHCOS를 설치할 FCP 디스크를 지정합니다.

   4

   OSA(Open Systems Adapter) 또는 HiperSockets를 사용할 때 이 매개변수를 지정합니다.

2. InfraEnv 리소스에서 .ins 및 initrd.img.addrsize 파일을 다운로드합니다.

   기본적으로 .ins 및 initrd.img.addrsize 파일의 URL은 InfraEnv 리소스에서 사용할 수 없습니다. 해당 아티팩트를 가져오려면 URL을 편집해야 합니다.

   1. followign 명령을 실행하여 ins-file 을 포함하도록 커널 URL 끝점을 업데이트합니다.

      $ curl -k -L -o generic.ins "< url for ins-file >"

      Copy to Clipboard Toggle word wrap

      예제 URL

      https://…/boot-artifacts/ins-file?arch=s390x&version=4.17.0

      Copy to Clipboard Toggle word wrap

   2. s390x- initrd -addrsize:을 포함하도록 initrd URL 끝점을 업데이트합니다.

      예제 URL

      https://…./s390x-initrd-addrsize?api_key=<api-key>&arch=s390x&version=4.17.0

      Copy to Clipboard Toggle word wrap

3. initrd,kernel,generic.ins 및 initrd.img.addrsize 매개변수 파일을 파일 서버로 전송합니다. FTP를 사용하여 파일을 전송하고 부팅하는 방법에 대한 자세한 내용은 "LPAR에 설치"를 참조하십시오.
4. 머신을 시작합니다.
5. 클러스터의 다른 모든 시스템에 대해 절차를 반복합니다.

프로세스

1. 매개 변수 파일을 업데이트하여 rootfs_url,network_adaptor 및 disk_type 값을 추가합니다.

   매개변수 파일 예

   rd.neednet=1 cio_ignore=all,!condev \
   console=ttysclp0  \
   ignition.firstboot ignition.platform.id=metal \
   coreos.live.rootfs_url=http://<http_server>/rhcos-<version>-live-rootfs.<architecture>.img \

   1

   
   coreos.inst.persistent-kargs=console=ttysclp0
   ip=<ip>::<gateway>:<netmask>::<interface>:none nameserver=<dns> \

   2

   
   rd.znet=qeth,<network_adaptor_range>,layer2=1
   rd.<disk_type>=<adapter> \

   3

   
   zfcp.allow_lun_scan=0
   ai.ip_cfg_override=1 \

   4

   Copy to Clipboard Toggle word wrap

   1

   coreos.live.rootfs_url 아티팩트의 경우 시작 중인 커널 및 initramfs 와 일치하는 rootfs 아티팩트를 지정합니다. HTTP 및 HTTPS 프로토콜만 지원됩니다.

   2

   ip 매개변수의 경우 IBM Z 및 IBM LinuxONE에 z/VM으로 클러스터 설치에 설명된 대로 IP 주소를 수동으로 할당합니다.

   3

   DASD 유형 디스크에 설치하는 경우 rd.dasd 를 사용하여 RHCOS(Red Hat Enterprise Linux CoreOS)를 설치할 DASD를 지정합니다. FCP 유형 디스크에 설치하려면 rd.zfcp=<adapter>,<wwpn>,<lun >을 사용하여 RHCOS를 설치할 FCP 디스크를 지정합니다.

   참고

   FCP 다중 경로 구성의 경우 대신 두 개의 디스크를 제공합니다.

   예

   rd.zfcp=<adapter1>,<wwpn1>,<lun1> \
   rd.zfcp=<adapter2>,<wwpn2>,<lun2>

   Copy to Clipboard Toggle word wrap

   4

   OSA(Open Systems Adapter) 또는 HiperSockets를 사용할 때 이 매개변수를 지정합니다.

2. 다음 명령을 실행하여 initrd, 커널 이미지 및 매개변수 파일을 게스트 VM으로 이동합니다.

   vmur pun -r -u -N kernel.img $INSTALLERKERNELLOCATION/<image name>

   Copy to Clipboard Toggle word wrap

   vmur pun -r -u -N generic.parm $PARMFILELOCATION/paramfilename

   Copy to Clipboard Toggle word wrap

   vmur pun -r -u -N initrd.img $INSTALLERINITRAMFSLOCATION/<image name>

   Copy to Clipboard Toggle word wrap

3. 게스트 VM 콘솔에서 다음 명령을 실행합니다.

   cp ipl c

   Copy to Clipboard Toggle word wrap

4. 에이전트 및 해당 속성을 나열하려면 다음 명령을 입력합니다.

   $ oc -n <hosted_control_plane_namespace> get agents

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME    CLUSTER APPROVED    ROLE    STAGE
   50c23cda-cedc-9bbd-bcf1-9b3a5c75804d    auto-assign
   5e498cd3-542c-e54f-0c58-ed43e28b568a    auto-assign

   Copy to Clipboard Toggle word wrap

5. 다음 명령을 실행하여 에이전트를 승인합니다.

   $ oc -n <hosted_control_plane_namespace> patch agent \
     50c23cda-cedc-9bbd-bcf1-9b3a5c75804d -p \
     '{"spec":{"installation_disk_id":"/dev/sda","approved":true,"hostname":"worker-zvm-0.hostedn.example.com"}}' \

   1

   
     --type merge

   Copy to Clipboard Toggle word wrap

   1

   선택적으로 사양에 에이전트 ID < installation_disk_id > 및 < hostname >을 설정할 수 있습니다.

6. 다음 명령을 실행하여 에이전트가 승인되었는지 확인합니다.

   $ oc -n <hosted_control_plane_namespace> get agents

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                                            CLUSTER     APPROVED   ROLE          STAGE
   50c23cda-cedc-9bbd-bcf1-9b3a5c75804d             true       auto-assign
   5e498cd3-542c-e54f-0c58-ed43e28b568a             true       auto-assign

   Copy to Clipboard Toggle word wrap