홈
제품
OpenShift Container Platform
4.19
호스팅된 컨트롤 플레인
4.4. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면 배포

4.4. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면 배포

클러스터를 호스팅 클러스터로 구성하여 호스팅된 제어 평면을 배포할 수 있습니다. 호스팅 클러스터는 제어 평면이 호스팅되는 OpenShift Container Platform 클러스터입니다. 호스팅 클러스터는 관리 클러스터라고도 합니다.

중요

베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면은 Technology Preview 기능에만 해당됩니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

참고

관리 클러스터는 관리되는 클러스터와 다릅니다. 관리형 클러스터는 허브 클러스터가 관리하는 클러스터입니다.

호스트된 컨트롤 플레인 기능은 기본적으로 활성화되어 있습니다.

멀티클러스터 엔진 Operator는 기본 로컬 클러스터 관리 허브 클러스터만 지원합니다. Red Hat Advanced Cluster Management(RHACM) 2.10에서는 로컬 클러스터 관리 허브 클러스터를 호스팅 클러스터로 사용할 수 있습니다.

호스팅 클러스터 는 API 엔드포인트와 제어 평면이 호스팅 클러스터에 호스팅되는 OpenShift Container Platform 클러스터입니다. 호스트된 클러스터에는 컨트롤 플레인과 해당 데이터 플레인이 포함됩니다. 멀티클러스터 엔진 운영자 콘솔이나 hcp 명령줄 인터페이스(CLI)를 사용하여 호스팅 클러스터를 만들 수 있습니다.

호스팅된 클러스터는 자동으로 관리형 클러스터로 가져옵니다. 이 자동 가져오기 기능을 비활성화하려면 "호스팅된 클러스터를 멀티클러스터 엔진 Operator로 자동 가져오기 비활성화"를 참조하세요.

4.4.1. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면을 배포할 준비 중
링크 복사

베어 메탈에 호스팅된 제어 평면을 배포할 준비를 할 때 다음 정보를 고려하세요.

Agent 플랫폼을 사용하면 호스팅된 클러스터에 에이전트 머신을 워커 노드로 추가할 수 있습니다. 에이전트 머신은 Discovery Image로 부팅되어 OpenShift Container Platform 노드로 프로비저닝될 준비가 된 호스트를 나타냅니다. Agent 플랫폼은 중앙 인프라 관리 서비스의 일부입니다. 자세한 내용은 중앙 인프라 관리 서비스 활성화를 참조하세요.
베어 메탈이 아닌 모든 호스트는 중앙 인프라 관리에서 제공하는 Discovery Image ISO를 사용하여 수동 부팅해야 합니다.
노드 풀을 확장하면 모든 복제본에 대해 머신이 생성됩니다. 각 머신에 대해 클러스터 API 공급자는 승인되고, 검증을 통과하고, 현재 사용 중이 아니며, 노드 풀 사양에 지정된 요구 사항을 충족하는 에이전트를 찾아 설치합니다. 에이전트의 상태와 조건을 확인하여 에이전트의 설치를 모니터링할 수 있습니다.
노드 풀을 축소하면 에이전트가 해당 클러스터에서 바인딩 해제됩니다. 에이전트를 재사용하려면 먼저 Discovery 이미지를 사용하여 에이전트를 다시 시작해야 합니다.
호스팅된 제어 평면에 대한 스토리지를 구성할 때 권장되는 etcd 사례를 고려하세요. 대기 시간 요구 사항을 충족하려면 각 제어 평면 노드에서 실행되는 모든 호스팅 제어 평면 etcd 인스턴스에 빠른 스토리지 장치를 전용으로 지정하세요. LVM 스토리지를 사용하여 호스팅된 etcd 포드에 대한 로컬 스토리지 클래스를 구성할 수 있습니다. 자세한 내용은 OpenShift Container Platform 설명서의 "권장되는 etcd 사례" 및 "논리적 볼륨 관리자 스토리지를 사용한 영구 스토리지"를 참조하세요.

4.4.1.1. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면을 배포하기 위한 전제 조건
링크 복사

베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면을 배포하기 전에 다음 필수 구성 요소를 충족하는지 확인하세요.

OpenShift Container Platform 클러스터에 Kubernetes Operator 2.5 이상용 멀티클러스터 엔진이 설치되어 있어야 합니다. OpenShift Container Platform OperatorHub에서 Operator로 멀티클러스터 엔진 Operator를 설치할 수 있습니다.
멀티클러스터 엔진 운영자의 경우 관리되는 OpenShift Container Platform 클러스터가 하나 이상 있어야 합니다. 로컬 클러스터 관리 클러스터가 자동으로 가져옵니다. local-cluster 에 대한 자세한 내용은 Red Hat Advanced Cluster Management 문서의 고급 구성을 참조하세요. 다음 명령을 실행하여 관리 클러스터의 상태를 확인할 수 있습니다.
```
oc get managedclusters local-cluster
```
```
$ oc get managedclusters local-cluster
```
Copy to Clipboard Toggle word wrap
중앙 인프라 관리를 활성화했습니다. 자세한 내용은 Red Hat Advanced Cluster Management 문서에서 중앙 인프라 관리 서비스 활성화를 참조하세요.
hcp 명령줄 인터페이스를 설치했습니다.
호스팅된 클러스터에는 클러스터 전체에서 고유한 이름이 있습니다.
동일한 인프라에서 관리 클러스터와 작업자를 실행하고 있습니다.

4.4.1.2. 베어메탈이 아닌 에이전트 머신에 대한 방화벽, 포트 및 서비스 요구 사항
링크 복사

관리 클러스터, 제어 평면 및 호스팅 클러스터 간에 포트가 통신할 수 있도록 방화벽 및 포트 요구 사항을 충족해야 합니다.

참고

서비스는 기본 포트에서 실행됩니다. 하지만 NodePort 게시 전략을 사용하면 서비스는 NodePort 서비스에서 할당한 포트에서 실행됩니다.

방화벽 규칙, 보안 그룹 또는 기타 액세스 제어를 사용하여 필요한 소스에만 액세스를 제한합니다. 필요하지 않은 이상 포트를 공개적으로 노출하지 마십시오. 실제 운영 환경에 배포하는 경우, 로드 밸런서를 사용하여 단일 IP 주소를 통해 액세스를 간소화합니다.

호스팅된 제어 평면은 베어메탈이 아닌 에이전트 머신에서 다음 서비스를 제공합니다.

APIServer
- APIServer 서비스는 기본적으로 포트 6443에서 실행되며 제어 평면 구성 요소 간 통신을 위해 인그레스 액세스가 필요합니다.
- MetalLB 부하 분산을 사용하는 경우 부하 분산 장치 IP 주소에 사용되는 IP 범위에 대한 수신 액세스를 허용합니다.
OAuthServer
- 라우트와 인그레스를 사용하여 서비스를 노출하는 경우 OAuthServer 서비스는 기본적으로 포트 443에서 실행됩니다.
- NodePort 게시 전략을 사용하는 경우 OAuthServer 서비스에 대한 방화벽 규칙을 사용하세요.
연결성
- 경로와 인그레스를 사용하여 서비스를 노출하는 경우 Konnectivity 서비스는 기본적으로 포트 443에서 실행됩니다.
- Konnectivity 에이전트는 제어 평면이 호스팅된 클러스터의 네트워크에 액세스할 수 있도록 역방향 터널을 설정합니다. 에이전트는 출구를 통해 Konnectivity 서버에 연결합니다. 서버는 포트 443의 경로나 수동으로 할당된 NodePort를 사용하여 노출됩니다.
- 클러스터 API 서버 주소가 내부 IP 주소인 경우 포트 6443의 IP 주소로 워크로드 서브넷에서 액세스를 허용합니다.
- 해당 주소가 외부 IP 주소인 경우 노드에서 해당 외부 IP 주소로 포트 6443을 통해 유출을 허용합니다.
Ignition
- 라우트와 인그레스를 사용하여 서비스를 노출하는 경우 Ignition 서비스는 기본적으로 포트 443에서 실행됩니다.
- NodePort 게시 전략을 사용하는 경우 Ignition 서비스에 대한 방화벽 규칙을 사용하세요.

베어메탈이 아닌 에이전트 머신에서는 다음 서비스가 필요하지 않습니다.

OVNSbDb
OIDC

4.4.1.3. 베어메탈이 아닌 에이전트 머신에 대한 인프라 요구 사항
링크 복사

Agent 플랫폼은 어떠한 인프라도 생성하지 않지만, 다음과 같은 인프라 요구 사항을 갖추고 있습니다.

에이전트: 에이전트는 검색 이미지로 부팅되고 OpenShift Container Platform 노드로 프로비저닝될 준비가 된 호스트를 나타냅니다.
DNS: API 및 수신 엔드포인트는 라우팅 가능해야 합니다.

4.4.2. 베어메탈이 아닌 에이전트 머신에서 DNS 구성
링크 복사

호스팅된 클러스터의 API 서버는 NodePort 서비스로 노출됩니다. API 서버에 도달할 수 있는 대상을 가리키는 api.<hosted_cluster_name>.<basedomain> 에 대한 DNS 항목이 있어야 합니다.

DNS 항목은 호스팅된 제어 평면을 실행하는 관리되는 클러스터의 노드 중 하나를 가리키는 레코드만큼 간단할 수 있습니다. 또한, 진입점은 유입 트래픽을 인그레스 포드로 리디렉션하기 위해 배포된 로드 밸런서를 가리킬 수도 있습니다.

IPv4 네트워크에서 연결된 환경에 대한 DNS를 구성하는 경우 다음 DNS 구성 예를 참조하세요.

api.example.krnl.es.        IN A 192.168.122.20
api.example.krnl.es.        IN A 192.168.122.21
api.example.krnl.es.        IN A 192.168.122.22
api-int.example.krnl.es.    IN A 192.168.122.20
api-int.example.krnl.es.    IN A 192.168.122.21
api-int.example.krnl.es.    IN A 192.168.122.22
`*`.apps.example.krnl.es.   IN A 192.168.122.23

api.example.krnl.es.        IN A 192.168.122.20
api.example.krnl.es.        IN A 192.168.122.21
api.example.krnl.es.        IN A 192.168.122.22
api-int.example.krnl.es.    IN A 192.168.122.20
api-int.example.krnl.es.    IN A 192.168.122.21
api-int.example.krnl.es.    IN A 192.168.122.22
`*`.apps.example.krnl.es.   IN A 192.168.122.23

Copy to Clipboard

Toggle word wrap

IPv6 네트워크에서 연결이 끊긴 환경에 대한 DNS를 구성하는 경우 다음 DNS 구성 예를 참조하세요.

api.example.krnl.es.        IN A 2620:52:0:1306::5
api.example.krnl.es.        IN A 2620:52:0:1306::6
api.example.krnl.es.        IN A 2620:52:0:1306::7
api-int.example.krnl.es.    IN A 2620:52:0:1306::5
api-int.example.krnl.es.    IN A 2620:52:0:1306::6
api-int.example.krnl.es.    IN A 2620:52:0:1306::7
`*`.apps.example.krnl.es.   IN A 2620:52:0:1306::10

api.example.krnl.es.        IN A 2620:52:0:1306::5
api.example.krnl.es.        IN A 2620:52:0:1306::6
api.example.krnl.es.        IN A 2620:52:0:1306::7
api-int.example.krnl.es.    IN A 2620:52:0:1306::5
api-int.example.krnl.es.    IN A 2620:52:0:1306::6
api-int.example.krnl.es.    IN A 2620:52:0:1306::7
`*`.apps.example.krnl.es.   IN A 2620:52:0:1306::10

Copy to Clipboard

Toggle word wrap

듀얼 스택 네트워크에서 연결이 끊긴 환경에 대한 DNS를 구성하는 경우 IPv4와 IPv6에 대한 DNS 항목을 모두 포함해야 합니다. 다음 DNS 구성 예를 참조하세요.

host-record=api-int.hub-dual.dns.base.domain.name,192.168.126.10
host-record=api.hub-dual.dns.base.domain.name,192.168.126.10
address=/apps.hub-dual.dns.base.domain.name/192.168.126.11
dhcp-host=aa:aa:aa:aa:10:01,ocp-master-0,192.168.126.20
dhcp-host=aa:aa:aa:aa:10:02,ocp-master-1,192.168.126.21
dhcp-host=aa:aa:aa:aa:10:03,ocp-master-2,192.168.126.22
dhcp-host=aa:aa:aa:aa:10:06,ocp-installer,192.168.126.25
dhcp-host=aa:aa:aa:aa:10:07,ocp-bootstrap,192.168.126.26

host-record=api-int.hub-dual.dns.base.domain.name,2620:52:0:1306::2
host-record=api.hub-dual.dns.base.domain.name,2620:52:0:1306::2
address=/apps.hub-dual.dns.base.domain.name/2620:52:0:1306::3
dhcp-host=aa:aa:aa:aa:10:01,ocp-master-0,[2620:52:0:1306::5]
dhcp-host=aa:aa:aa:aa:10:02,ocp-master-1,[2620:52:0:1306::6]
dhcp-host=aa:aa:aa:aa:10:03,ocp-master-2,[2620:52:0:1306::7]
dhcp-host=aa:aa:aa:aa:10:06,ocp-installer,[2620:52:0:1306::8]
dhcp-host=aa:aa:aa:aa:10:07,ocp-bootstrap,[2620:52:0:1306::9]

host-record=api-int.hub-dual.dns.base.domain.name,192.168.126.10
host-record=api.hub-dual.dns.base.domain.name,192.168.126.10
address=/apps.hub-dual.dns.base.domain.name/192.168.126.11
dhcp-host=aa:aa:aa:aa:10:01,ocp-master-0,192.168.126.20
dhcp-host=aa:aa:aa:aa:10:02,ocp-master-1,192.168.126.21
dhcp-host=aa:aa:aa:aa:10:03,ocp-master-2,192.168.126.22
dhcp-host=aa:aa:aa:aa:10:06,ocp-installer,192.168.126.25
dhcp-host=aa:aa:aa:aa:10:07,ocp-bootstrap,192.168.126.26

host-record=api-int.hub-dual.dns.base.domain.name,2620:52:0:1306::2
host-record=api.hub-dual.dns.base.domain.name,2620:52:0:1306::2
address=/apps.hub-dual.dns.base.domain.name/2620:52:0:1306::3
dhcp-host=aa:aa:aa:aa:10:01,ocp-master-0,[2620:52:0:1306::5]
dhcp-host=aa:aa:aa:aa:10:02,ocp-master-1,[2620:52:0:1306::6]
dhcp-host=aa:aa:aa:aa:10:03,ocp-master-2,[2620:52:0:1306::7]
dhcp-host=aa:aa:aa:aa:10:06,ocp-installer,[2620:52:0:1306::8]
dhcp-host=aa:aa:aa:aa:10:07,ocp-bootstrap,[2620:52:0:1306::9]

Copy to Clipboard

Toggle word wrap

4.4.2.1. 사용자 정의 DNS 이름 정의
링크 복사

클러스터 관리자는 노드 부트스트랩 및 제어 평면 통신에 사용되는 내부 엔드포인트와 다른 외부 API DNS 이름을 사용하여 호스팅된 클러스터를 만들 수 있습니다. 다음과 같은 이유로 다른 DNS 이름을 정의할 수 있습니다.

내부 루트 CA에 바인딩된 제어 평면 기능을 손상시키지 않고 사용자용 TLS 인증서를 공개 CA의 인증서로 교체하려면
분할 수평 DNS 및 NAT 시나리오를 지원하려면
올바른 kubeconfig 및 DNS 구성을 사용하여 "로그인 명령 표시" 기능과 같은 기능을 사용할 수 있는 독립 실행형 제어 평면과 유사한 경험을 보장하려면

HostedCluster 객체의 kubeAPIServerDNSName 필드에 도메인 이름을 입력하여 초기 설정이나 2일차 작업 중에 DNS 이름을 정의할 수 있습니다.

사전 요구 사항

kubeAPIServerDNSName 필드에 설정할 DNS 이름을 포함하는 유효한 TLS 인증서가 있습니다.
DNS 이름은 접근 가능하고 올바른 주소를 가리키는 확인 가능한 URI입니다.

프로세스

HostedCluster 개체의 사양에서 kubeAPIServerDNSName 필드와 도메인 주소를 추가하고 다음 예와 같이 사용할 인증서를 지정합니다.

#...
spec:
  configuration:
    apiServer:
      servingCerts:
        namedCertificates:
        - names:
          - xxx.example.com
          - yyy.example.com
          servingCertificate:
            name: <my_serving_certificate>
  kubeAPIServerDNSName: <your_custom_address>

#...
spec:
  configuration:
    apiServer:
      servingCerts:
        namedCertificates:
        - names:
          - xxx.example.com
          - yyy.example.com
          servingCertificate:
            name: <my_serving_certificate>
  kubeAPIServerDNSName: <your_custom_address>

Copy to Clipboard

Toggle word wrap

1: kubeAPIServerDNSName 필드의 값은 유효하고 주소 지정이 가능한 도메인이어야 합니다.

kubeAPIServerDNSName 필드를 정의하고 인증서를 지정하면 Control Plane Operator 컨트롤러가 custom-admin-kubeconfig 라는 kubeconfig 파일을 생성하고 이 파일은 HostedControlPlane 네임스페이스에 저장됩니다. 인증서는 루트 CA에서 생성되고, HostedControlPlane 네임스페이스는 인증서의 만료 및 갱신을 관리합니다.

Control Plane Operator는 HostedControlPlane 네임스페이스에 CustomKubeconfig 라는 새로운 kubeconfig 파일을 보고합니다. 해당 파일은 kubeAPIServerDNSName 필드에 정의된 새 서버를 사용합니다.

사용자 정의 kubeconfig 파일은 HostedCluster 개체의 상태 필드에서 CustomKubeconfig 로 참조됩니다. CustomKubeConfig 필드는 선택 사항이며 kubeAPIServerDNSName 필드가 비어 있지 않은 경우에만 추가할 수 있습니다. CustomKubeConfig 필드가 설정되면 HostedCluster 네임스페이스에 <hosted_cluster_name>-custom-admin-kubeconfig 라는 이름의 비밀이 생성됩니다. 이 비밀을 사용하여 HostedCluster API 서버에 액세스할 수 있습니다. 2일차 작업 중에 CustomKubeConfig 필드를 제거하면 관련된 모든 비밀과 상태 참조가 삭제됩니다.

참고

이 프로세스는 데이터 플레인에 직접적인 영향을 미치지 않으므로 롤아웃이 발생하지 않을 것으로 예상됩니다. HostedControlPlane 네임스페이스는 HyperShift Operator로부터 변경 사항을 수신하고 해당 필드를 삭제합니다.

HostedCluster 개체의 사양에서 kubeAPIServerDNSName 필드를 제거하면 새로 생성된 모든 비밀과 CustomKubeconfig 참조가 클러스터와 상태 필드에서 제거됩니다.

4.4.3. CLI를 사용하여 베어메탈이 아닌 에이전트 머신에 호스팅된 클러스터 만들기
링크 복사

Agent 플랫폼을 사용하여 호스팅 클러스터를 생성하면 HyperShift Operator가 호스팅 제어 평면 네임스페이스에 Agent Cluster API 공급자를 설치합니다. 베어 메탈에서 호스팅 클러스터를 만들거나 가져올 수 있습니다.

호스팅 클러스터를 생성할 때 다음 지침을 검토하세요.

호스팅된 각 클러스터에는 클러스터 전체에서 고유한 이름이 있어야 합니다. 멀티클러스터 엔진 운영자가 관리할 수 있도록 호스팅된 클러스터 이름은 기존 관리형 클러스터와 동일할 수 없습니다.
호스팅된 클러스터 이름으로 클러스터를 사용하지 마세요.
멀티클러스터 엔진 운영자가 관리하는 클러스터의 네임스페이스에는 호스팅된 클러스터를 만들 수 없습니다.

프로세스

다음 명령을 입력하여 호스팅된 제어 평면 네임스페이스를 만듭니다.
```
oc create ns <hosted_cluster_namespace>-<hosted_cluster_name>
```
```
$ oc create ns <hosted_cluster_namespace>-<hosted_cluster_name> 
```
1
Copy to Clipboard Toggle word wrap
1
<hosted_cluster_namespace>를 호스팅된 클러스터 네임스페이스 이름(예: clusters ) 으로 바꾸세요. <hosted_cluster_name>을 호스팅 클러스터 이름으로 바꾸세요.
다음 명령을 입력하여 호스팅 클러스터를 만듭니다.
```
hcp create cluster agent \
  --name=<hosted_cluster_name> \
  --pull-secret=<path_to_pull_secret> \
  --agent-namespace=<hosted_control_plane_namespace> \
  --base-domain=<basedomain> \
  --api-server-address=api.<hosted_cluster_name>.<basedomain> \
  --etcd-storage-class=<etcd_storage_class> \
  --ssh-key  <path_to_ssh_key> \
  --namespace <hosted_cluster_namespace> \
  --control-plane-availability-policy HighlyAvailable \
  --release-image=quay.io/openshift-release-dev/ocp-release:<ocp_release> \
  --node-pool-replicas <node_pool_replica_count>
```
```
$ 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=<basedomain> \
```
4
```
  --api-server-address=api.<hosted_cluster_name>.<basedomain> \
```
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> \
```
10
```
  --node-pool-replicas <node_pool_replica_count> 
```
11
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
클러스터에 기본 스토리지 클래스가 구성되어 있는지 확인하세요. 그렇지 않으면 보류 중인 PVC가 생길 수 있습니다. 예를 들어 lvm-storageclass 와 같이 etcd 스토리지 클래스 이름을 지정합니다.
7
SSH 공개 키의 경로를 지정합니다. 기본 파일 경로는 ~/.ssh/id_rsa.pub 입니다.
8
호스팅된 클러스터 네임스페이스를 지정합니다.
9
호스팅된 제어 평면 구성 요소에 대한 가용성 정책을 지정합니다. 지원되는 옵션은 SingleReplica 및 HighlyAvailable 입니다. 기본값은 HighlyAvailable 입니다.
10
사용하려는 지원되는 OpenShift Container Platform 버전을 지정합니다(예: 4.19.0-multi ).
11
노드 풀 복제본 수를 지정합니다(예: 3 ). 동일한 수의 복제본을 생성하려면 복제본 수를 0 이상으로 지정해야 합니다. 그렇지 않으면 노드 풀이 생성되지 않습니다.

검증

잠시 후 다음 명령을 입력하여 호스팅된 제어 평면 포드가 작동 중인지 확인하세요.

oc -n <hosted_cluster_namespace>-<hosted_cluster_name> get pods

$ oc -n <hosted_cluster_namespace>-<hosted_cluster_name> get pods

Copy to Clipboard

Toggle word wrap

출력 예

NAME                                             READY   STATUS    RESTARTS   AGE
catalog-operator-6cd867cc7-phb2q                 2/2     Running   0          2m50s
control-plane-operator-f6b4c8465-4k5dh           1/1     Running   0          4m32s

NAME                                             READY   STATUS    RESTARTS   AGE
catalog-operator-6cd867cc7-phb2q                 2/2     Running   0          2m50s
control-plane-operator-f6b4c8465-4k5dh           1/1     Running   0          4m32s

Copy to Clipboard

Toggle word wrap

4.4.3.1. 웹 콘솔을 사용하여 베어메탈이 아닌 에이전트 머신에 호스팅된 클러스터 만들기
링크 복사

OpenShift Container Platform 웹 콘솔을 사용하여 베어메탈이 아닌 에이전트 머신에 호스팅된 클러스터를 만들 수 있습니다.

사전 요구 사항

cluster-admin 권한이 있는 클러스터에 액세스할 수 있습니다.
OpenShift Container Platform 웹 콘솔에 액세스할 수 있습니다.

프로세스

OpenShift Container Platform 웹 콘솔을 열고 관리자 자격 증명을 입력하여 로그인합니다.
콘솔 헤더에서 모든 클러스터를 선택합니다.
인프라 클러스터를 클릭합니다.
클러스터 호스트 인벤토리 만들기 호스팅된 제어 평면을 클릭합니다.
클러스터 만들기 페이지가 표시됩니다.
클러스터 만들기 페이지에서 프롬프트에 따라 클러스터, 노드 풀, 네트워킹 및 자동화에 대한 세부 정보를 입력합니다.

클러스터에 대한 세부 정보를 입력할 때 다음 팁이 유용할 수 있습니다.

미리 정의된 값을 사용하여 콘솔의 필드를 자동으로 채우려면 호스트 인벤토리 자격 증명을 만들 수 있습니다. 자세한 내용은 온-프레미스 환경에 대한 인증 정보 만들기 를 참조하십시오.
클러스터 세부 정보 페이지에서 풀 시크릿은 OpenShift Container Platform 리소스에 액세스하는 데 사용하는 OpenShift Container Platform 풀 시크릿입니다. 호스트 인벤토리 인증 정보를 선택한 경우 가져오기 보안이 자동으로 채워집니다.
노드 풀 페이지에서 네임스페이스에는 노드 풀의 호스트가 포함되어 있습니다. 콘솔을 사용하여 호스트 인벤토리를 생성한 경우 콘솔은 전용 네임스페이스를 생성합니다.
네트워킹 페이지에서 API 서버 게시 전략을 선택합니다. 호스팅된 클러스터의 API 서버는 기존 로드 밸런서를 사용하거나 NodePort 유형의 서비스로 노출될 수 있습니다. API 서버에 연결할 수 있는 대상을 가리키는 api.<hosted_cluster_name>.<basedomain > 설정에 대한 DNS 항목이 있어야 합니다. 이 항목은 관리 클러스터의 노드 중 하나를 가리키는 레코드이거나 수신 트래픽을 Ingress pod로 리디렉션하는 로드 밸런서를 가리키는 레코드일 수 있습니다.
1. 항목을 검토하고 생성 을 클릭합니다.
호스팅된 클러스터 보기가 표시됩니다.
1. Hosted 클러스터 보기에서 호스팅된 클러스터의 배포를 모니터링합니다. 호스팅된 클러스터에 대한 정보가 표시되지 않는 경우 모든 클러스터가 선택되어 있는지 확인하고 클러스터 이름을 클릭합니다. 컨트롤 플레인 구성 요소가 준비될 때까지 기다립니다. 이 프로세스는 몇 분 정도 걸릴 수 있습니다.
2. 노드 풀 상태를 보려면 NodePool 섹션으로 스크롤합니다. 노드를 설치하는 프로세스에는 약 10분이 걸립니다. 노드를 클릭하여 노드가 호스팅된 클러스터에 참여하고 있는지 확인할 수도 있습니다.

다음 단계

웹 콘솔에 액세스하려면 웹 콘솔 액세스를 참조하십시오.

4.4.3.2. 미러 레지스트리를 사용하여 베어 메탈에서 호스팅 클러스터 생성
링크 복사

미러 레지스트리를 사용하여 hcp create cluster 명령에 --image-content-sources 플래그를 지정하여 베어 메탈에 호스팅 클러스터를 생성할 수 있습니다.

프로세스

YAML 파일을 생성하여 ICSP(Image Content Source Policies)를 정의합니다. 다음 예제를 참조하십시오.

- mirrors:
  - brew.registry.redhat.io
  source: registry.redhat.io
- mirrors:
  - brew.registry.redhat.io
  source: registry.stage.redhat.io
- mirrors:
  - brew.registry.redhat.io
  source: registry-proxy.engineering.redhat.com

- mirrors:
  - brew.registry.redhat.io
  source: registry.redhat.io
- mirrors:
  - brew.registry.redhat.io
  source: registry.stage.redhat.io
- mirrors:
  - brew.registry.redhat.io
  source: registry-proxy.engineering.redhat.com

Copy to Clipboard

Toggle word wrap

파일을 icsp.yaml 로 저장합니다. 이 파일에는 미러 레지스트리가 포함되어 있습니다.
미러 레지스트리를 사용하여 호스팅된 클러스터를 생성하려면 다음 명령을 실행합니다.
```
hcp create cluster agent \
    --name=<hosted_cluster_name> \
    --pull-secret=<path_to_pull_secret> \
    --agent-namespace=<hosted_control_plane_namespace> \
    --base-domain=<basedomain> \
    --api-server-address=api.<hosted_cluster_name>.<basedomain> \
    --image-content-sources icsp.yaml  \
    --ssh-key  <path_to_ssh_key> \
    --namespace <hosted_cluster_namespace> \
    --release-image=quay.io/openshift-release-dev/ocp-release:<ocp_release_image>
```
```
$ 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=<basedomain> \
```
4
```
    --api-server-address=api.<hosted_cluster_name>.<basedomain> \
```
5
```
    --image-content-sources icsp.yaml  \
```
6
```
    --ssh-key  <path_to_ssh_key> \
```
7
```
    --namespace <hosted_cluster_namespace> \
```
8
```
    --release-image=quay.io/openshift-release-dev/ocp-release:<ocp_release_image> 
```
9
Copy to Clipboard Toggle word wrap
1
호스팅된 클러스터의 이름을 지정합니다( 예: ).
2
풀 시크릿의 경로를 지정합니다(예: /user/name/pullsecret ).
3
호스팅된 컨트롤 플레인 네임스페이스를 지정합니다(예: cluster -example ). oc get agent -n <hosted-control-plane-namespace> 명령을 사용하여 이 네임스페이스 에서 에이전트를 사용할 수 있는지 확인합니다.
4
기본 도메인을 지정합니다(예: krnl.es ).
5
--api-server-address 플래그는 호스팅된 클러스터의 Kubernetes API 통신에 사용되는 IP 주소를 정의합니다. --api-server-address 플래그를 설정하지 않으면 관리 클러스터에 연결하려면 로그인해야 합니다.
6
ICSP 및 미러 레지스트리를 정의하는 icsp.yaml 파일을 지정합니다.
7
SSH 공개 키의 경로를 지정합니다. 기본 파일 경로는 ~/.ssh/id_rsa.pub 입니다.
8
호스팅된 클러스터 네임스페이스를 지정합니다.
9
사용하려는 지원되는 OpenShift Container Platform 버전을 지정합니다(예: 4.19.0-multi ). 연결이 끊긴 환경을 사용하는 경우 < ocp_release_image >를 다이제스트 이미지로 교체합니다. OpenShift Container Platform 릴리스 이미지 다이제스트를 추출하려면 "OpenShift Container Platform 릴리스 이미지 다이제스트 추출"을 참조하십시오.

다음 단계

콘솔을 사용하여 호스팅된 클러스터를 생성할 때 재사용할 수 있는 자격 증명을 만들려면 온-프레미스 환경에 대한 자격 증명 만들기를 참조하세요.
호스트된 클러스터에 액세스하려면 호스팅 된 클러스터 액세스를 참조하십시오.
Discovery Image를 사용하여 호스트 인벤토리에 호스트를 추가하려면 Discovery Image를 사용하여 호스트 인벤토리에 호스트 추가를 참조하세요.
OpenShift 컨테이너 플랫폼 릴리스 이미지 다이제스트를 추출하려면 OpenShift 컨테이너 플랫폼 릴리스 이미지 다이제스트 추출을 참조하세요.

4.4.4. 베어 메탈이 아닌 에이전트 시스템에서 호스트 클러스터 생성 확인
링크 복사

배포 프로세스가 완료되면 호스트 클러스터가 성공적으로 생성되었는지 확인할 수 있습니다. 호스팅된 클러스터를 생성한 후 몇 분 후에 다음 단계를 수행합니다.

프로세스

다음 명령을 입력하여 새 호스팅 클러스터의 kubeconfig 파일을 가져옵니다.

oc extract -n <hosted_cluster_namespace> \
  secret/<hosted_cluster_name>-admin-kubeconfig --to=- \
  > kubeconfig-<hosted_cluster_name>

$ oc extract -n <hosted_cluster_namespace> \
  secret/<hosted_cluster_name>-admin-kubeconfig --to=- \
  > kubeconfig-<hosted_cluster_name>

Copy to Clipboard

Toggle word wrap

kubeconfig 파일을 사용하여 호스팅된 클러스터의 클러스터 Operator를 확인합니다. 다음 명령을 실행합니다.

oc get co --kubeconfig=kubeconfig-<hosted_cluster_name>

$ oc get co --kubeconfig=kubeconfig-<hosted_cluster_name>

Copy to Clipboard

Toggle word wrap

출력 예

NAME                                       VERSION   AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
console                                    4.10.26   True        False         False      2m38s
csi-snapshot-controller                    4.10.26   True        False         False      4m3s
dns                                        4.10.26   True        False         False      2m52s

NAME                                       VERSION   AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
console                                    4.10.26   True        False         False      2m38s
csi-snapshot-controller                    4.10.26   True        False         False      4m3s
dns                                        4.10.26   True        False         False      2m52s

Copy to Clipboard

Toggle word wrap

다음 명령을 입력하여 호스팅 클러스터에서 실행 중인 Pod를 확인합니다.

oc get pods -A --kubeconfig=kubeconfig-<hosted_cluster_name>

$ oc get pods -A --kubeconfig=kubeconfig-<hosted_cluster_name>

Copy to Clipboard

Toggle word wrap

출력 예

NAMESPACE                                          NAME                                                      READY   STATUS             RESTARTS        AGE
kube-system                                        konnectivity-agent-khlqv                                  0/1     Running            0               3m52s
openshift-cluster-samples-operator                 cluster-samples-operator-6b5bcb9dff-kpnbc                 2/2     Running            0               20m
openshift-monitoring                               alertmanager-main-0                                       6/6     Running            0               100s
openshift-monitoring                               openshift-state-metrics-677b9fb74f-qqp6g                  3/3     Running            0               104s

NAMESPACE                                          NAME                                                      READY   STATUS             RESTARTS        AGE
kube-system                                        konnectivity-agent-khlqv                                  0/1     Running            0               3m52s
openshift-cluster-samples-operator                 cluster-samples-operator-6b5bcb9dff-kpnbc                 2/2     Running            0               20m
openshift-monitoring                               alertmanager-main-0                                       6/6     Running            0               100s
openshift-monitoring                               openshift-state-metrics-677b9fb74f-qqp6g                  3/3     Running            0               104s

Copy to Clipboard

Toggle word wrap

4.4.5. 호스팅된 클러스터에서 사용자 정의 API 서버 인증서 구성
링크 복사

API 서버에 대한 사용자 정의 인증서를 구성하려면 HostedCluster 구성의 spec.configuration.apiServer 섹션에서 인증서 세부 정보를 지정하세요.

1일차 또는 2일차 작업 중에 사용자 정의 인증서를 구성할 수 있습니다. 그러나 서비스 게시 전략은 호스팅 클러스터를 생성하는 동안 설정한 후에는 변경할 수 없으므로 구성하려는 Kubernetes API 서버의 호스트 이름을 알아야 합니다.

사전 요구 사항

관리 클러스터에 사용자 정의 인증서가 포함된 Kubernetes 비밀을 생성했습니다. 비밀에는 다음과 같은 키가 포함되어 있습니다.
- tls.crt : 인증서
- tls.key : 개인 키
HostedCluster 구성에 부하 분산 장치를 사용하는 서비스 게시 전략이 포함된 경우 인증서의 SAN(주체 대체 이름)이 내부 API 엔드포인트( api-int )와 충돌하지 않는지 확인하세요. 내부 API 엔드포인트는 플랫폼에서 자동으로 생성되고 관리됩니다. 사용자 정의 인증서와 내부 API 엔드포인트 모두에서 동일한 호스트 이름을 사용하면 라우팅 충돌이 발생할 수 있습니다. 이 규칙의 유일한 예외는 AWS를 Private 또는 PublicAndPrivate 구성으로 공급자로 사용하는 경우입니다. 이런 경우 SAN 충돌은 플랫폼에 의해 관리됩니다.
인증서는 외부 API 엔드포인트에 대해 유효해야 합니다.
인증서의 유효 기간은 클러스터의 예상 수명 주기와 일치합니다.

프로세스

다음 명령을 입력하여 사용자 지정 인증서로 비밀을 만듭니다.

oc create secret tls sample-hosted-kas-custom-cert \
  --cert=path/to/cert.crt \
  --key=path/to/key.key \
  -n <hosted_cluster_namespace>

$ oc create secret tls sample-hosted-kas-custom-cert \
  --cert=path/to/cert.crt \
  --key=path/to/key.key \
  -n <hosted_cluster_namespace>

Copy to Clipboard

Toggle word wrap

다음 예와 같이 사용자 지정 인증서 세부 정보로 HostedCluster 구성을 업데이트합니다.

spec:
  configuration:
    apiServer:
      servingCerts:
        namedCertificates:
        - names: 
          - api-custom-cert-sample-hosted.sample-hosted.example.com
          servingCertificate: 
            name: sample-hosted-kas-custom-cert

spec:
  configuration:
    apiServer:
      servingCerts:
        namedCertificates:
        - names:


          - api-custom-cert-sample-hosted.sample-hosted.example.com
          servingCertificate:


            name: sample-hosted-kas-custom-cert

Copy to Clipboard

Toggle word wrap

1: 인증서가 유효한 DNS 이름 목록입니다.
2: 사용자 지정 인증서가 포함된 비밀의 이름입니다.

다음 명령을 입력하여 HostedCluster 구성에 변경 사항을 적용합니다.
```
oc apply -f <hosted_cluster_config>.yaml
```
```
$ oc apply -f <hosted_cluster_config>.yaml
```
Copy to Clipboard Toggle word wrap

검증

API 서버 포드를 확인하여 새 인증서가 마운트되었는지 확인하세요.
사용자 지정 도메인 이름을 사용하여 API 서버에 대한 연결을 테스트합니다.
브라우저나 openssl 과 같은 도구를 사용하여 인증서 세부 정보를 확인하세요.

맨 위로 이동

4.4. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면 배포

4.4.1. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면을 배포할 준비 중
링크 복사

4.4.1.1. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면을 배포하기 위한 전제 조건
링크 복사

4.4.1.2. 베어메탈이 아닌 에이전트 머신에 대한 방화벽, 포트 및 서비스 요구 사항
링크 복사

4.4.1.3. 베어메탈이 아닌 에이전트 머신에 대한 인프라 요구 사항
링크 복사

4.4.2. 베어메탈이 아닌 에이전트 머신에서 DNS 구성
링크 복사

4.4.2.1. 사용자 정의 DNS 이름 정의
링크 복사

4.4.3. CLI를 사용하여 베어메탈이 아닌 에이전트 머신에 호스팅된 클러스터 만들기
링크 복사

4.4.3.1. 웹 콘솔을 사용하여 베어메탈이 아닌 에이전트 머신에 호스팅된 클러스터 만들기
링크 복사

4.4.3.2. 미러 레지스트리를 사용하여 베어 메탈에서 호스팅 클러스터 생성
링크 복사

4.4.4. 베어 메탈이 아닌 에이전트 시스템에서 호스트 클러스터 생성 확인
링크 복사

4.4.5. 호스팅된 클러스터에서 사용자 정의 API 서버 인증서 구성
링크 복사

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

4.4. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면 배포

4.4.1. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면을 배포할 준비 중링크 복사링크가 클립보드에 복사되었습니다!

4.4.1.1. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면을 배포하기 위한 전제 조건링크 복사링크가 클립보드에 복사되었습니다!

4.4.1.2. 베어메탈이 아닌 에이전트 머신에 대한 방화벽, 포트 및 서비스 요구 사항링크 복사링크가 클립보드에 복사되었습니다!

4.4.1.3. 베어메탈이 아닌 에이전트 머신에 대한 인프라 요구 사항링크 복사링크가 클립보드에 복사되었습니다!

4.4.2. 베어메탈이 아닌 에이전트 머신에서 DNS 구성링크 복사링크가 클립보드에 복사되었습니다!

4.4.2.1. 사용자 정의 DNS 이름 정의링크 복사링크가 클립보드에 복사되었습니다!

4.4.3. CLI를 사용하여 베어메탈이 아닌 에이전트 머신에 호스팅된 클러스터 만들기링크 복사링크가 클립보드에 복사되었습니다!

4.4.3.1. 웹 콘솔을 사용하여 베어메탈이 아닌 에이전트 머신에 호스팅된 클러스터 만들기링크 복사링크가 클립보드에 복사되었습니다!

4.4.3.2. 미러 레지스트리를 사용하여 베어 메탈에서 호스팅 클러스터 생성링크 복사링크가 클립보드에 복사되었습니다!

4.4.4. 베어 메탈이 아닌 에이전트 시스템에서 호스트 클러스터 생성 확인링크 복사링크가 클립보드에 복사되었습니다!

4.4.5. 호스팅된 클러스터에서 사용자 정의 API 서버 인증서 구성링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

4.4.1. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면을 배포할 준비 중
링크 복사

4.4.1.1. 베어메탈이 아닌 에이전트 머신에 호스팅된 제어 평면을 배포하기 위한 전제 조건
링크 복사

4.4.1.2. 베어메탈이 아닌 에이전트 머신에 대한 방화벽, 포트 및 서비스 요구 사항
링크 복사

4.4.1.3. 베어메탈이 아닌 에이전트 머신에 대한 인프라 요구 사항
링크 복사

4.4.2. 베어메탈이 아닌 에이전트 머신에서 DNS 구성
링크 복사

4.4.2.1. 사용자 정의 DNS 이름 정의
링크 복사

4.4.3. CLI를 사용하여 베어메탈이 아닌 에이전트 머신에 호스팅된 클러스터 만들기
링크 복사

4.4.3.1. 웹 콘솔을 사용하여 베어메탈이 아닌 에이전트 머신에 호스팅된 클러스터 만들기
링크 복사

4.4.3.2. 미러 레지스트리를 사용하여 베어 메탈에서 호스팅 클러스터 생성
링크 복사

4.4.4. 베어 메탈이 아닌 에이전트 시스템에서 호스트 클러스터 생성 확인
링크 복사

4.4.5. 호스팅된 클러스터에서 사용자 정의 API 서버 인증서 구성
링크 복사