워커 풀에 수동으로 호스트 할당하기

호스트를 Satellite 위치에 연결한 후 이를 클러스터 또는 Satellite 사용 IBM Cloud 서비스와 같은 Satellite 리소스에 지정하여 컴퓨팅 용량을 제공할 수 있습니다.

Satellite 클러스터의 작업자 풀에 대해 호스트 자동 지정을 사용할 수도 있습니다. 그러나 Satellite 위치 제어 플레인에는 호스트를 수동으로 지정해야 합니다.

호스트를 지정하면 호스트 vCPU당 Satellite 관리 요금이 청구됩니다. 자세히 알아보십시오.

시작하기 전에

IBM Cloud에 대한 Satellite IAM 운영자 플랫폼 역할을 갖고 있는지 확인하십시오. 자세한 정보는 사용자 권한 확인을 참조하십시오.
호스트를 Satellite 위치에 연결하고, 호스트가 정상이며 지정되지 않음 상태인지 확인하십시오.

콘솔에서 호스트 지정

Satellite 콘솔에서 위치를 클릭하십시오.
Satellite 리소스에 지정할 호스트 시스템을 연결한 위치를 선택하십시오.
호스트 탭에 있는, 리소스에 추가할 각 호스트 시스템의 조치 메뉴에서 호스트 지정을 클릭하십시오.
작성한 클러스터를 선택하고 사용 가능한 구역 중 하나를 선택하십시오. 호스트를 클러스터에 지정하면 IBM에서 시스템을 부트스트랩합니다. 이 프로세스는 완료하는 데 몇 분 정도 소요될 수 있습니다. 부트스트랩 프로세스 중에, 시스템의 상태는 준비에서 프로비저닝으로 변경됩니다.
호스트가 클러스터에 지정되었는지 확인하십시오. 호스트에 IP 주소가 추가되었으며 상태가 정상으로 변경되면 지정이 성공한 것입니다.
이러한 단계를 반복하여 호스트가 클러스터에 있는 기본 작업자 풀의 각 구역에 작업자 노드로 지정되었는지 확인하십시오.

호스트가 제어 플레인에 지정되고 나면 위치에 대해 IBM 모니터링이 올바르게 설정될 때까지 20 - 30분이 소요됩니다. 또한 위치에 대한 DNS 레코드가 작성되고, 위치에 대한 로드 밸런싱 및 상태 확인을 가능하게 하기 위해 호스트의 IP 주소가 DNS 레코드에 자동으로 등록되고 추가됩니다. 이 프로세스는 완료하는 데 최대 30분이 소요될 수 있습니다. 이 프로세스 중에 위치 상태는 계속해서 조치 필요 상태로 표시되며, Satellite is attempting to recover 또는 Verify that the Satellite location has a DNS record for load balancing requests to the location control plane과 같은 간헐적 오류가 표시될 수 있습니다.

CLI에서 호스트 지정

위치에 있는 호스트를 나열하여 지정되지 않음 상태인 호스트를 찾으십시오.
```
ibmcloud sat host ls --location <location_name_or_ID>
```

위치에 있는 3개 이상의 컴퓨팅 호스트를 Satellite 제어 플레인 또는 기존 Red Hat OpenShift on IBM Cloud 클러스터에 작업자 노드로 지정하십시오. 호스트를 지정하면 IBM에서 시스템을 부트스트랩합니다. 이 프로세스는 완료하는 데 몇 분 정도 소요될 수 있습니다. 호스트 ID를 사용하여 호스트를 지정하도록 선택할 수 있으며, 호스트가 위치에 지정되기 위해 호스트에 있어야 하는 레이블을 정의할 수도 있습니다.

다음 예는 호스트 ID를 사용하여 호스트를 지정합니다.

ibmcloud sat host assign --location <location_name_or_ID>  --cluster <cluster_name_or_ID> --host <host_ID> --worker-pool default --zone <zone>

다음 예는 use:satcluster 레이블을 사용하여 호스트를 지정합니다.

ibmcloud sat host assign --location <location_name_or_ID> --cluster <location_ID> --host-label "use:satcluster" --worker-pool default --zone us-east-1

이 명령의 구성요소 이해하기
컴포넌트	설명
`--location <location_name_or_ID>`	클러스터를 작성한 위치의 이름 또는 ID를 입력하십시오. 위치 이름 또는 ID를 검색하려면 `ibmcloud sat location ls`를 실행하십시오.
`--cluster <cluster_name_or_ID>`	이전에 작성한 Red Hat OpenShift on IBM Cloud 클러스터의 이름 또는 ID를 입력하십시오. 클러스터 이름 또는 ID를 검색하려면 `ibmcloud ks cluster ls`를 실행하십시오. 호스트를 Satellite 제어 플레인에 지정하려는 경우에는 위치 ID를 클러스터 ID로 입력해야 합니다. 위치 ID를 검색하려면 `ibmcloud sat location ls`를 실행하십시오.
`--host <host_name_or_ID>`	Satellite 리소스에 작업자 노드로 지정할 호스트 ID를 입력하십시오. 호스트 ID를 보려면 `ibmcloud sat host ls --location <location_name>`을 실행하십시오. `--host-label` 옵션을 사용하여 클러스터에 지정할 호스트를 식별할 수도 있습니다.
`--host-label <label>`	지정할 호스트를 식별하는 데 사용할 레이블을 입력하십시오. 이 레이블은 키-값 쌍이어야 하며 호스트 시스템에 있어야 합니다. 이 명령을 `label` 옵션과 함께 실행하면 `unassigned` 상태이며 해당 레이블과 일치하는 첫 번째 호스트가 Satellite 리소스에 지정됩니다.
`--worker-pool <worker-pool>`	컴퓨팅 호스트를 연결할 작업자 풀의 이름을 입력하십시오. 클러스터에서 사용 가능한 작업자 풀을 찾으려면 `ibmcloud oc worker-pool ls --cluster <cluster_name_or_ID>`를 실행하십시오. 이 옵션을 지정하지 않으면 컴퓨팅 호스트가 자동으로 기본 작업자 풀에 추가됩니다.
`--zone <zone>`	컴퓨팅 호스트를 지정할 구역의 이름입니다. 사용자 위치의 구역 이름을 보려면 `ibmcloud sat location get --location`를 실행하고 `Host Zones` 필드를 찾으십시오.

다음 예는 os=RHCOS 호스트 레이블을 사용하여 호스트를 지정합니다.

ibmcloud sat host assign --location <location_name_or_ID>  --cluster <cluster_name_or_ID> --host-label os=RHCOS --zone <zone>

Satellite 리소스에 작업자 노드로 지정할 모든 컴퓨팅 호스트에 대해 이전 단계를 반복하십시오.

모든 컴퓨팅 호스트에 대한 부트스트랩 프로세스가 완료되고 호스트가 Satellite 리소스에 성공적으로 지정될 때까지 몇 분 동안 기다리십시오. 모든 호스트에는 클러스터, 작업자 노드 ID 및 IP 주소가 지정됩니다.

ibmcloud ks worker get --cluster <cluster_name_or_ID> --worker <worker_ID>를 실행하여 컴퓨팅 호스트의 부트스트랩 프로세스를 모니터할 수 있습니다.

ibmcloud sat host ls --location <location_name_or_ID>

출력 예

Retrieving hosts...
OK
Name              ID                     State      Status   Cluster             Worker ID                                                 Worker IP   
satcluster        brkijjq20r3nd89b1sog   assigned   Ready    satcluster          sat-satc-dd629ca11947c4aaec1a0208e0a37ca790475ee0   169.62.196.24   
satcluster2       brkiku2202thnmhb1sp0   assigned   Ready    satcluster          sat-satc-69f2410d3ecfea9127aeec07f01475f241728a16   169.62.196.22   
satcluster3       brkiltb20m0oqr29mo2g   assigned   Ready    satcluster          sat-satc-9985014f499827ddde3ce3e5bedad26af5a73263   169.62.196.29   
controlplane01    brjrgp920bg4u254brr0   assigned   Ready    infrastructure      sat-virtualser-4d7fa07cd3446b1f9d8131420f7011e60d372ca2   169.62.196.30   
controlplane02    brjrdmd20dfjgaai4vc0   assigned   Ready    infrastructure      sat-virtualser-9826f0927254b12b4018a95327bd0b45d0513f59   169.62.196.23   
controlplane03    brjs18u20ohqh54svnog   assigned   Ready    infrastructure      sat-virtualser-948b454ea091bd9aeb8f0542c2e8c19b82c5bf7a   169.62.196.20