1.9. 호스트 인벤토리 소개

1.9.1. 호스트 인벤토리 개요
링크 복사

주요 인프라 관리 기능은 라이프사이클 동안 베어 메탈 호스트를 관리하는 데 중점을 둔 멀티 클러스터 엔진 Operator의 Red Hat OpenShift Container Platform 설치 경험입니다.

지원 설치 프로그램은 에이전트를 사용하여 대상 호스트에서 사전 설치 검증을 실행하는 OpenShift Container Platform 설치 방법과 설치 진행 상황을 평가하고 추적하는 중앙 서비스입니다.

Red Hat OpenShift용 인프라 Operator는 지원 설치 관리자 서비스를 실행하는 워크로드를 관리하고 설치하는 다중 클러스터 엔진 운영자 구성 요소입니다.

콘솔을 사용하여 온프레미스 OpenShift Container Platform 클러스터를 생성하는 데 사용할 수 있는 베어 메탈 또는 가상 머신 풀인 호스트 인벤토리를 생성할 수 있습니다. 이러한 클러스터는 컨트롤 플레인 전용 머신 또는 컨트롤 플레인의 전용 머신이 있는 독립 실행형 클러스터일 수 있습니다. 여기서 컨트롤 플레인은 허브 클러스터에서 Pod로 실행됩니다. ../../html-single/clusters#hosted-control-planes-intro

ZTP(ZTP)를 사용하여 콘솔, API 또는 GitOps를 사용하여 독립 실행형 클러스터를 설치할 수 있습니다. ZTP에 대한 자세한 내용은 Red Hat OpenShift Container Platform 설명서의 연결이 끊긴 환경에 GitOps ZTP 설치를 참조하십시오.

시스템은 Discovery Image로 부팅한 후 호스트 인벤토리를 결합합니다. Discovery Image는 다음이 포함된 Red Hat CoreOS 라이브 이미지입니다.

검색, 검증 및 설치 작업을 수행하는 에이전트입니다.
해당하는 경우 엔드포인트, 토큰, 정적 네트워크 구성을 포함하여 허브 클러스터에서 서비스에 연결하는 데 필요한 구성입니다.

공통 속성 세트를 공유하는 호스트 세트인 각 인프라 환경에 대해 하나의 Discovery Image가 있습니다. InfraEnv 사용자 정의 리소스 정의는 이 인프라 환경 및 관련 Discovery Image를 나타냅니다. InfraEnv 사용자 정의 리소스에서 osImageVersion 필드를 설정하여 검색 이미지에 사용되는 Red Hat Core OS 버전을 지정할 수 있습니다. 값을 지정하지 않으면 최신 Red Hat Core OS 버전이 사용됩니다.

호스트가 부팅되고 에이전트가 서비스에 연결되면 서비스는 해당 호스트를 나타내는 허브 클러스터에 새 Agent 사용자 정의 리소스를 생성합니다. 에이전트 리소스는 호스트 인벤토리를 구성합니다.

나중에 OpenShift 노드로 인벤토리에 호스트를 설치할 수 있습니다. 에이전트는 필요한 구성과 함께 운영 체제를 디스크에 쓰고 호스트를 재부팅합니다.

참고: Red Hat Advanced Cluster Management 및 중앙 인프라 관리는 Nutanix 가상 머신을 생성하여 추가 구성이 필요한 AgentClusterInstall 리소스를 사용하여 Nutanix 플랫폼을 지원합니다. 자세한 내용은 지원 설치 관리자 설명서의 선택적: Nutanix에 설치를 참조하십시오.

1.9.2. 중앙 인프라 관리 서비스 활성화
링크 복사

중앙 인프라 관리 서비스는 다중 클러스터 엔진 Operator와 함께 제공되며 OpenShift Container Platform 클러스터를 배포합니다. Red Hat Advanced Cluster Management를 설치하고 hub 클러스터에서 MultiClusterHub Operator를 활성화했지만 이 경우 서비스를 수동으로 활성화해야 하는 경우 중앙 인프라 관리 서비스가 자동으로 배포됩니다.

다음 섹션을 참조하십시오.

1.9.2.1. 사전 요구 사항
링크 복사

중앙 인프라 관리 서비스를 활성화하기 전에 다음 사전 요구 사항을 참조하십시오.

지원되는 OpenShift Container Platform 버전과 지원되는 Red Hat Advanced Cluster Management for Kubernetes 버전에 배포된 허브 클러스터가 있어야 합니다.
허브 클러스터에 대한 인터넷 액세스가 필요합니다.
연결이 끊긴 환경에서 작업하는 경우 환경을 생성하는 데 필요한 이미지를 검색하기 위해 인터넷에 연결되어 있는 내부 또는 미러 레지스트리에 대한 연결이 필요합니다.
베어 메탈 프로비저닝에 필요한 포트를 열어야 합니다. OpenShift Container Platform 설명서에서 필요한 포트 활성화를 참조하십시오.
베어 메탈 호스트 사용자 정의 리소스 정의가 필요합니다.
OpenShift Container Platform 풀 시크릿 이 필요합니다. 자세한 내용은 이미지 풀 시크릿 사용을 참조하십시오.
구성된 기본 스토리지 클래스가 필요합니다.
연결이 끊긴 환경의 경우 OpenShift Container Platform 설명서에서 네트워크 맨 엣지에서 클러스터에 대한 절차를 완료합니다.

1.9.2.2. 베어 메탈 호스트 사용자 정의 리소스 정의 생성
링크 복사

중앙 인프라 관리 서비스를 활성화하기 전에 베어 메탈 호스트 사용자 정의 리소스 정의가 필요합니다.

다음 명령을 실행하여 베어 메탈 호스트 사용자 정의 리소스 정의가 있는지 확인합니다.
```
oc get crd baremetalhosts.metal3.io
```
```
oc get crd baremetalhosts.metal3.io
```
Copy to Clipboard Toggle word wrap
- 베어 메탈 호스트 사용자 정의 리소스 정의가 있는 경우 출력에 리소스가 생성된 날짜가 표시됩니다.
- 리소스가 없는 경우 다음과 유사한 오류가 표시됩니다.
```
Error from server (NotFound): customresourcedefinitions.apiextensions.k8s.io "baremetalhosts.metal3.io" not found
```
```
Error from server (NotFound): customresourcedefinitions.apiextensions.k8s.io "baremetalhosts.metal3.io" not found
```
Copy to Clipboard Toggle word wrap
베어 메탈 호스트 사용자 정의 리소스 정의가 없는 경우 metal3.io_baremetalhosts.yaml 파일을 다운로드하고 다음 명령을 실행하여 리소스를 생성하여 콘텐츠를 적용합니다.
```
oc apply -f
```
```
oc apply -f
```
Copy to Clipboard Toggle word wrap

1.9.2.3. 프로비저닝 리소스 생성 또는 수정
링크 복사

중앙 인프라 관리 서비스를 활성화하려면 프로비저닝 리소스가 필요합니다.

다음 명령을 실행하여 프로비저닝 리소스가 있는지 확인합니다.
```
oc get provisioning
```
```
oc get provisioning
```
Copy to Clipboard Toggle word wrap
- 프로비저닝 리소스가 이미 있는 경우 프로비저닝 리소스를 수정합니다.
- 프로비저닝 리소스가 없는 경우 리소스를 찾을 수 없음 오류가 표시됩니다. 계속해서 프로비저닝 리소스를 생성합니다.
프로비저닝 리소스를 수정합니다.
프로비저닝 리소스가 이미 있는 경우 hub 클러스터가 다음 플랫폼 중 하나에 설치된 경우 리소스를 수정해야 합니다.
- 베어 메탈
- Red Hat OpenStack Platform
- VMware vSphere
- 사용자 프로비저닝 인프라(UPI) 방법 및 플랫폼은 None입니다.
  허브 클러스터가 다른 플랫폼에 설치된 경우 연결이 끊긴 환경에서 중앙 인프라 관리 활성화 또는 연결된 환경에서 중앙 인프라 관리 활성화에서 계속 진행하십시오.
  다음 명령을 실행하여 Bare Metal Operator가 모든 네임스페이스를 조사할 수 있도록 프로비저닝 리소스를 수정합니다.
```
oc patch provisioning provisioning-configuration --type merge -p '{"spec":{"watchAllNamespaces": true }}'
```
```
oc patch provisioning provisioning-configuration --type merge -p '{"spec":{"watchAllNamespaces": true }}'
```
Copy to Clipboard Toggle word wrap

프로비저닝 리소스가 없는 경우 프로비저닝 리소스를 생성합니다.

다음 프로비저닝 리소스 YAML 파일을 생성합니다.

apiVersion: metal3.io/v1alpha1
kind: Provisioning
metadata:
  name: provisioning-configuration
spec:
  provisioningNetwork: "Disabled"
  watchAllNamespaces: true

apiVersion: metal3.io/v1alpha1
kind: Provisioning
metadata:
  name: provisioning-configuration
spec:
  provisioningNetwork: "Disabled"
  watchAllNamespaces: true

Copy to Clipboard

Toggle word wrap

다음 명령을 실행하여 콘텐츠를 적용합니다.

oc apply -f

oc apply -f

Copy to Clipboard

Toggle word wrap

1.9.2.4. 연결이 끊긴 환경에서 중앙 인프라 관리 활성화
링크 복사

연결이 끊긴 환경에서 중앙 인프라 관리를 활성화하려면 다음 단계를 완료합니다.

인프라 Operator와 동일한 네임스페이스에 ConfigMap 을 생성하여 미러 레지스트리의 ca-bundle.crt 및 registries.conf 값을 지정합니다. 파일 ConfigMap 은 다음 예와 유사할 수 있습니다.

apiVersion: v1
kind: ConfigMap
metadata:
  name: <mirror-config>
  namespace: multicluster-engine
  labels:
    app: assisted-service
data:
  ca-bundle.crt: |
    <certificate-content>
  registries.conf: |
    unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
    [[registry]]
       prefix = ""
       location = "registry.redhat.io/multicluster-engine"
       mirror-by-digest-only = true
       [[registry.mirror]]
       location = "mirror.registry.com:5000/multicluster-engine"

apiVersion: v1
kind: ConfigMap
metadata:
  name: <mirror-config>
  namespace: multicluster-engine
  labels:
    app: assisted-service
data:
  ca-bundle.crt: |
    <certificate-content>
  registries.conf: |
    unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
    [[registry]]
       prefix = ""
       location = "registry.redhat.io/multicluster-engine"
       mirror-by-digest-only = true
       [[registry.mirror]]
       location = "mirror.registry.com:5000/multicluster-engine"

Copy to Clipboard

Toggle word wrap

참고: 다이제스트를 사용하여 릴리스 이미지가 지정되므로 mirror-by-digest-only 를 true 로 설정해야 합니다.

unqualified-search-registries 목록의 레지스트리는 PUBLIC_CONTAINER_REGISTRIES 환경 변수의 인증 무시 목록에 자동으로 추가됩니다. 관리 클러스터의 풀 시크릿을 검증할 때 지정된 레지스트리는 인증이 필요하지 않습니다.

모든 osImage 요청과 함께 보낼 헤더 및 쿼리 매개변수를 나타내는 키 쌍을 작성합니다. 두 매개변수가 모두 필요하지 않은 경우 헤더 또는 쿼리 매개변수에만 대한 키 쌍을 작성합니다.

중요: 헤더 및 쿼리 매개변수는 HTTPS를 사용하는 경우에만 암호화됩니다. 보안 문제를 방지하려면 HTTPS를 사용해야 합니다.

headers 라는 파일을 생성하고 다음 예제와 유사한 콘텐츠를 추가합니다.
```
{
  "Authorization": "Basic xyz"
}
```
```
{
  "Authorization": "Basic xyz"
}
```
Copy to Clipboard Toggle word wrap

query_params 라는 파일을 생성하고 다음 예와 유사한 콘텐츠를 추가합니다.

{
  "api_key": "myexampleapikey",
}

{
  "api_key": "myexampleapikey",
}

Copy to Clipboard

Toggle word wrap

다음 명령을 실행하여 생성한 매개변수 파일에서 시크릿을 생성합니다. 하나의 매개변수 파일만 생성한 경우 생성하지 않은 파일의 인수를 제거합니다.
```
oc create secret generic -n multicluster-engine os-images-http-auth --from-file=./query_params --from-file=./headers
```
```
oc create secret generic -n multicluster-engine os-images-http-auth --from-file=./query_params --from-file=./headers
```
Copy to Clipboard Toggle word wrap
자체 서명 또는 타사 CA 인증서와 함께 HTTPS osImages 를 사용하려면 image-service-additional-ca ConfigMap 에 인증서를 추가합니다. 인증서를 생성하려면 다음 명령을 실행합니다.
```
oc -n multicluster-engine create configmap image-service-additional-ca --from-file=<file-name>
```
```
oc -n multicluster-engine create configmap image-service-additional-ca --from-file=<file-name>
```
Copy to Clipboard Toggle word wrap

agent_service_config.yaml 파일에 다음 YAML 콘텐츠를 저장하여 AgentServiceConfig 사용자 지정 리소스를 생성합니다.

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
 name: agent
spec:
  databaseStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <db_volume_size>
  filesystemStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <fs_volume_size>
  mirrorRegistryRef:
    name: <mirror_config> 
  unauthenticatedRegistries:
    - <unauthenticated_registry> 
  imageStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <img_volume_size> 
  OSImageAdditionalParamsRef:
	    name: os-images-http-auth
  OSImageCACertRef:
    name: image-service-additional-ca
  osImages:
    - openshiftVersion: "<ocp_version>" 
      version: "<ocp_release_version>" 
      url: "<iso_url>" 
      cpuArchitecture: "x86_64"

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
 name: agent
spec:
  databaseStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <db_volume_size>
  filesystemStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <fs_volume_size>
  mirrorRegistryRef:
    name: <mirror_config>

1


  unauthenticatedRegistries:
    - <unauthenticated_registry>

2


  imageStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <img_volume_size>

3


  OSImageAdditionalParamsRef:
	    name: os-images-http-auth
  OSImageCACertRef:
    name: image-service-additional-ca
  osImages:
    - openshiftVersion: "<ocp_version>"

4


      version: "<ocp_release_version>"

5


      url: "<iso_url>"

6


      cpuArchitecture: "x86_64"

Copy to Clipboard

Toggle word wrap

1: mirror_config 를 미러 레지스트리 구성 세부 정보가 포함된 ConfigMap 의 이름으로 교체합니다.
2: 인증이 필요하지 않은 미러 레지스트리를 사용하는 경우 선택적 unauthenticated_registry 매개변수를 포함합니다. 이 목록의 항목은 검증되지 않았거나 풀 시크릿에 항목이 있어야 합니다.
3: img_volume_size 를 imageStorage 필드의 볼륨 크기로 바꿉니다. 이 값은 기본 Red Hat Enterprise Linux CoreOS 이미지를 저장하기 위해 할당된 스토리지 양을 지정합니다. 최소 값은 10Gi 이지만 모범 사례에 대한 값은 특히 osImages 를 사용하여 제한된 세트를 정의하는 대신 기본 이미지 세트를 선택하는 경우 최소 50Gi 입니다. osImages 에 구성된 Red Hat Enterprise Linux CoreOS의 각 인스턴스에 대해 최소 2Gi 의 이미지 스토리지를 허용해야 합니다.
4: ocp_version 을 설치할 지원되는 OpenShift Container Platform 버전으로 교체합니다.
5: ocp_release_version 을 특정 설치 버전 (예: 49.83.202103251640-0 )으로 바꿉니다.
6: iso_url 을 ISO URL로 바꿉니다. rhoc 에서 ISO url 값을 찾을 수 있습니다.

자체 서명 또는 타사 CA 인증서가 있는 HTTPS osImages 를 사용하는 경우 OSImageCACertRef 사양의 인증서를 참조하십시오.

중요: 늦은 바인딩 기능을 사용하는 경우 클러스터를 생성할 때 사용하는 OpenShift Container Platform 릴리스 이미지가 동일해야 합니다.

assisted-service 및 assisted-image-service 배포를 확인하고 Pod가 준비되어 실행 중인지 확인하여 중앙 인프라 관리 서비스가 정상인지 확인할 수 있습니다.

1.9.2.5. 연결된 환경에서 중앙 인프라 관리 활성화
링크 복사

연결된 환경에서 중앙 인프라 관리를 활성화하려면 agent_service_config.yaml 파일에 다음 YAML 콘텐츠를 저장하여 AgentServiceConfig 사용자 지정 리소스를 생성합니다.

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
 name: agent
spec:
  databaseStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <db_volume_size> 
  filesystemStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <fs_volume_size> 
  imageStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <img_volume_size>

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
 name: agent
spec:
  databaseStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <db_volume_size>

1


  filesystemStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <fs_volume_size>

2


  imageStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <img_volume_size>

3

Copy to Clipboard

Toggle word wrap

1: db_volume_size 를 databaseStorage 필드의 볼륨 크기(예: 10Gi )로 바꿉니다. 이 값은 클러스터의 데이터베이스 테이블 및 데이터베이스 뷰와 같은 파일을 저장하기 위해 할당된 스토리지 양을 지정합니다. 필요한 최소 값은 1Gi 입니다. 클러스터가 여러 개인 경우 더 높은 값을 사용해야 할 수 있습니다.
2: fs_volume_size 를 filesystemStorage 필드의 볼륨 크기로 바꿉니다(예: 지원되는 각 클러스터의 경우 200M, 지원되는 각 OpenShift Container Platform 버전에 대해 2-3Gi ). 필요한 최소 값은 1Gi 이지만 권장 값은 100Gi 이상이어야 합니다. 이 값은 클러스터의 로그, 매니페스트 및 kubeconfig 파일을 저장하기 위해 할당된 스토리지 양을 지정합니다. 클러스터가 여러 개인 경우 더 높은 값을 사용해야 할 수 있습니다.
3: img_volume_size 를 imageStorage 필드의 볼륨 크기로 바꿉니다. 이 값은 기본 Red Hat Enterprise Linux CoreOS 이미지를 저장하기 위해 할당된 스토리지 양을 지정합니다. 최소 값은 10Gi 이지만 모범 사례에 대한 값은 특히 osImages 를 사용하여 제한된 세트를 정의하는 대신 기본 이미지 세트를 선택하는 경우 최소 50Gi 입니다. osImages 에 구성된 Red Hat Enterprise Linux CoreOS의 각 인스턴스에 대해 최소 2Gi 의 이미지 스토리지를 허용해야 합니다.

osImages 에서 사용자 지정 이미지 세트를 정의하는 방법에 대한 자세한 내용은 연결이 끊긴 환경에서 중앙 인프라 관리 활성화를 참조하십시오.

중앙 인프라 관리 서비스가 구성되어 있습니다. assisted-service 및 assisted-image-service 배포를 확인하고 Pod가 준비되고 실행 중인지 확인하여 정상 상태인지 확인할 수 있습니다.

1.9.2.6. 지원 설치 관리자를 사용하여 FIPS 지원 클러스터 설치
링크 복사

FIPS 모드에 있는 지원되는 OpenShift Container Platform 클러스터를 설치할 때 설치 프로그램에 대해 Red Hat Enterprise Linux 버전을 지정하지 마십시오.

필수 액세스: AgentServiceConfig 및 AgentClusterInstall 리소스를 편집할 수 있는 권한이 있어야 합니다.

1.9.2.6.1. OpenShift Container Platform 클러스터 버전 4.15 및 이전 버전 설치
링크 복사

If you install a {ocp-short} cluster version 4.15 and earlier, complete the following steps to update the `AgentServiceConfig` resource:

If you install a {ocp-short} cluster version 4.15 and earlier, complete the following steps to update the `AgentServiceConfig` resource:

Copy to Clipboard

Toggle word wrap

다음 명령을 사용하여 관리 클러스터에 로그인합니다.
```
oc login
```
```
oc login
```
Copy to Clipboard Toggle word wrap

AgentServiceConfig 리소스에 agent-install.openshift.io/service-image-base: el8 주석을 추가합니다.

AgentServiceConfig 리소스는 다음 YAML과 유사할 수 있습니다.

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
  annotations:
    agent-install.openshift.io/service-image-base: el8
...

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
  annotations:
    agent-install.openshift.io/service-image-base: el8
...

Copy to Clipboard

Toggle word wrap

1.9.2.6.2. OpenShift Container Platform 클러스터 버전 4.16 이상 설치
링크 복사

OpenShift Container Platform 클러스터 버전 4.16 이상을 설치하는 경우 다음 단계를 완료하여 AgentServiceConfig 리소스를 업데이트합니다.

다음 명령을 사용하여 관리 클러스터에 로그인합니다.
```
oc login
```
```
oc login
```
Copy to Clipboard Toggle word wrap
agent-install.openshift.io/service-image-base: el8 주석이 AgentServiceConfig 리소스에 있는 경우 주석을 제거합니다.

1.9.2.7. 추가 리소스
링크 복사

제로 터치 프로비저닝에 대한 자세한 내용은 OpenShift Container Platform 설명서 의 네트워크 맨 위까지의 챌린지 를 참조하십시오.
이미지 풀 시크릿 사용

1.9.3. Amazon Web Services에서 중앙 인프라 관리 활성화
링크 복사

Amazon Web Services에서 Hub 클러스터를 실행하고 중앙 인프라 관리 서비스를 활성화하려면 중앙 인프라 관리 서비스를 활성화한 후 다음 단계를 완료합니다.

hub 클러스터에 로그인했는지 확인하고 다음 명령을 실행하여 assisted-image-service 에 구성된 고유한 도메인을 찾습니다.
```
oc get routes --all-namespaces | grep assisted-image-service
```
```
oc get routes --all-namespaces | grep assisted-image-service
```
Copy to Clipboard Toggle word wrap
도메인은 다음 예와 유사할 수 있습니다. assisted-image-service-multicluster-engine.apps.<yourdomain>.com

hub 클러스터에 로그인했는지 확인하고 NLB type 매개변수를 사용하여 고유한 도메인으로 새 IngressController 를 생성합니다. 다음 예제를 참조하십시오.

apiVersion: operator.openshift.io/v1
kind: IngressController
metadata:
  name: ingress-controller-with-nlb
  namespace: openshift-ingress-operator
spec:
  domain: nlb-apps.<domain>.com
  routeSelector:
      matchLabels:
        router-type: nlb
  endpointPublishingStrategy:
    type: LoadBalancerService
    loadBalancer:
      scope: External
      providerParameters:
        type: AWS
        aws:
          type: NLB

apiVersion: operator.openshift.io/v1
kind: IngressController
metadata:
  name: ingress-controller-with-nlb
  namespace: openshift-ingress-operator
spec:
  domain: nlb-apps.<domain>.com
  routeSelector:
      matchLabels:
        router-type: nlb
  endpointPublishingStrategy:
    type: LoadBalancerService
    loadBalancer:
      scope: External
      providerParameters:
        type: AWS
        aws:
          type: NLB

Copy to Clipboard

Toggle word wrap

nlb-apps.< domain >.com에서 <your domain >을 <yourdomain>으로 교체하여 IngressController 의 domain 매개변수에 < yourdomain >을 추가합니다.
다음 명령을 실행하여 새 IngressController 를 적용합니다.
```
oc apply -f ingresscontroller.yaml
```
```
oc apply -f ingresscontroller.yaml
```
Copy to Clipboard Toggle word wrap
다음 단계를 완료하여 새 IngressController 의 spec.domain 매개변수 값이 기존 IngressController 와 충돌하지 않는지 확인합니다.
1. 다음 명령을 실행하여 모든 IngressController 를 나열합니다.
  oc get ingresscontroller -n openshift-ingress-operator
  Copy to Clipboard Toggle word wrap
2. 방금 생성한 ingress-controller-with-nlb 를 제외하고 각 IngressController 에서 다음 명령을 실행합니다.
  oc edit ingresscontroller <name> -n openshift-ingress-operator
  Copy to Clipboard Toggle word wrap
  spec.domain 보고서가 없는 경우 nlb-apps.<domain>.com을 제외한 클러스터에 노출된 모든 경로와 일치하는 기본 도메인 을 추가합니다.
  spec.domain 보고서가 제공된 경우 nlb-apps.<domain>.com 경로가 지정된 범위에서 제외되었는지 확인합니다.
다음 명령을 실행하여 nlb-apps 위치를 사용하도록 assisted-image-service 경로를 편집합니다.
```
oc edit route assisted-image-service -n <namespace>
```
```
oc edit route assisted-image-service -n <namespace>
```
Copy to Clipboard Toggle word wrap
기본 네임스페이스는 다중 클러스터 엔진 Operator를 설치한 위치입니다.

assisted-image-service 경로에 다음 행을 추가합니다.

metadata:
  labels:
    router-type: nlb
  name: assisted-image-service

metadata:
  labels:
    router-type: nlb
  name: assisted-image-service

Copy to Clipboard

Toggle word wrap

assisted-image-service 경로에서 spec.host 의 URL 값을 찾습니다. URL은 다음 예와 유사할 수 있습니다.
```
assisted-image-service-multicluster-engine.apps.<yourdomain>.com
```
```
assisted-image-service-multicluster-engine.apps.<yourdomain>.com
```
Copy to Clipboard Toggle word wrap
새 IngressController 에 구성된 도메인과 일치하도록 URL의 앱을 nlb- apps 로 교체합니다.
Amazon Web Services에서 중앙 인프라 관리 서비스가 활성화되어 있는지 확인하려면 다음 명령을 실행하여 Pod가 정상 상태인지 확인합니다.
```
oc get pods -n multicluster-engine | grep assist
```
```
oc get pods -n multicluster-engine | grep assist
```
Copy to Clipboard Toggle word wrap
새 호스트 인벤토리를 생성하고 다운로드 URL이 새 nlb-apps URL을 사용하는지 확인합니다.

1.9.4. 콘솔을 사용하여 호스트 인벤토리 생성
링크 복사

호스트 인벤토리(인프라 환경)를 생성하여 OpenShift Container Platform 클러스터를 설치할 수 있는 물리적 또는 가상 머신을 검색할 수 있습니다.

1.9.4.1. 사전 요구 사항
링크 복사

중앙 인프라 관리 서비스를 활성화해야 합니다. 자세한 내용은 중앙 인프라 관리 서비스 활성화를 참조하십시오.

1.9.4.2. 호스트 인벤토리 생성
링크 복사

콘솔을 사용하여 호스트 인벤토리를 생성하려면 다음 단계를 완료합니다.

콘솔에서 인프라 > 호스트 인벤토리 로 이동하여 인프라 환경 생성 을 클릭합니다.
호스트 인벤토리 설정에 다음 정보를 추가합니다.
이름
인프라 환경의 고유 이름입니다. 콘솔을 사용하여 인프라 환경을 생성하면 선택한 이름으로 InfraEnv 리소스의 새 네임스페이스도 생성됩니다. 명령줄 인터페이스를 사용하여 InfraEnv 리소스를 생성하고 콘솔에서 리소스를 모니터링하려면 네임스페이스와 InfraEnv 에 동일한 이름을 사용합니다.
네트워크 유형
인프라 환경에 추가하는 호스트가 DHCP 또는 정적 네트워킹을 사용하는지 여부를 지정합니다. 정적 네트워킹 구성에는 추가 단계가 필요합니다.
위치
호스트의 지리적 위치를 지정합니다. 지리적 위치는 호스트가 있는 데이터 센터를 정의하는 데 사용할 수 있습니다.
라벨
이 인프라 환경에서 검색된 호스트에 레이블을 추가할 수 있는 선택적 필드입니다. 지정된 위치가 레이블 목록에 자동으로 추가됩니다.
인프라 공급자 인증 정보
인프라 공급자 인증 정보를 선택하면 풀 시크릿 및 SSH 공개 키 필드에 인증 정보 정보가 자동으로 채워집니다. 자세한 내용은 온-프레미스 환경에 대한 인증 정보 만들기 를 참조하십시오.
풀 시크릿
OpenShift Container Platform 풀 시크릿을 사용하여 OpenShift Container Platform 리소스에 액세스할 수 있습니다. 인프라 공급자 인증 정보를 선택한 경우 이 필드가 자동으로 채워집니다.
SSH 공개 키
호스트와의 보안 통신을 활성화하는 SSH 키입니다. 문제 해결을 위해 호스트에 연결하는 데 사용할 수 있습니다. 클러스터를 설치한 후에는 더 이상 SSH 키를 사용하여 호스트에 연결할 수 없습니다. 키는 일반적으로 id_rsa.pub 파일에 있습니다. 기본 파일 경로는 ~/.ssh/id_rsa.pub 입니다. SSH 공개 키 값이 포함된 인프라 공급자 인증 정보를 선택한 경우 이 필드가 자동으로 채워집니다.
호스트에 프록시 설정을 활성화하려면 활성화할 설정을 선택하고 다음 정보를 입력합니다.
HTTP 프록시 URL
HTTP 요청에 대한 프록시의 URL입니다.
HTTPS 프록시 URL
HTTP 요청에 대한 프록시의 URL입니다. URL은 HTTP로 시작해야 합니다. HTTPS는 지원되지 않습니다. 값을 지정하지 않으면 HTTP 프록시 URL이 기본적으로 HTTP 및 HTTPS 연결에 사용됩니다.
프록시 도메인 없음
프록시를 사용하지 않으려는 쉼표로 구분된 도메인 목록입니다. 마침표(.)로 도메인 이름을 시작하여 해당 도메인에 있는 모든 하위 도메인을 포함합니다. 모든 대상에 대해 프록시를 바이패스하려면 별표(*)를 추가합니다. 선택적으로 NTP 풀 또는 서버의 쉼표로 구분된 IP 또는 도메인 이름 목록을 제공하여 고유한 NTP(Network Time Protocol) 소스를 추가합니다.

콘솔에서 사용할 수 없는 고급 구성 옵션이 필요한 경우 명령줄 인터페이스를 사용하여 호스트 인벤토리 생성을 계속합니다.

고급 구성 옵션이 필요하지 않은 경우 정적 네트워킹을 구성하여 계속해서 인프라 환경에 호스트를 추가할 수 있습니다.

1.9.4.3. 호스트 인벤토리에 액세스
링크 복사

호스트 인벤토리에 액세스하려면 콘솔에서 인프라 > 호스트 인벤토리 를 선택합니다. 목록에서 인프라 환경을 선택하여 세부 정보 및 호스트를 확인합니다.

1.9.4.4. 추가 리소스
링크 복사

베어 메탈에서 호스팅된 컨트롤 플레인을 구성하는 프로세스의 일부로 호스트 인벤토리를 생성한 경우 다음 절차를 완료합니다.

1.9.5. 명령줄 인터페이스를 사용하여 호스트 인벤토리 생성
링크 복사

호스트 인벤토리(인프라 환경)를 생성하여 OpenShift Container Platform 클러스터를 설치할 수 있는 물리적 또는 가상 머신을 검색할 수 있습니다. 자동화된 배포를 위해 콘솔 대신 명령행 인터페이스를 사용하거나 다음 고급 구성 옵션에 사용합니다.

검색된 호스트를 기존 클러스터 정의에 자동으로 바인딩
Discovery Image의 ignition 구성 덮어쓰기
iPXE 동작 제어
Discovery Image의 커널 인수 수정
검색 단계에서 호스트가 신뢰할 수 있는 추가 인증서 전달
최신 버전의 기본 옵션이 아닌 테스트를 위해 부팅할 Red Hat CoreOS 버전을 선택합니다.

1.9.5.1. 사전 요구 사항
링크 복사

중앙 인프라 관리 서비스를 활성화해야 합니다. 자세한 내용은 중앙 인프라 관리 서비스 활성화를 참조하십시오.

1.9.5.2. 호스트 인벤토리 생성
링크 복사

명령줄 인터페이스를 사용하여 호스트 인벤토리(인프라 환경)를 생성하려면 다음 단계를 완료합니다.

다음 명령을 실행하여 허브 클러스터에 로그인합니다.
```
oc login
```
```
oc login
```
Copy to Clipboard Toggle word wrap
리소스의 네임스페이스를 생성합니다.
1. namespace.yaml 이라는 파일을 생성하고 다음 콘텐츠를 추가합니다.
  apiVersion: v1 kind: Namespace metadata: name: <your_namespace>
  1
  Copy to Clipboard Toggle word wrap
  1
  네임스페이스에서 동일한 이름을 사용하여 콘솔에서 인벤토리를 모니터링합니다.
2. 다음 명령을 실행하여 YAML 콘텐츠를 적용합니다.
  oc apply -f namespace.yaml
  Copy to Clipboard Toggle word wrap

OpenShift Container Platform 풀 보안이 포함된 Secret 사용자 정의 리소스를 생성합니다.

pull-secret.yaml 파일을 생성하고 다음 콘텐츠를 추가합니다.

apiVersion: v1
kind: Secret
type: kubernetes.io/dockerconfigjson
metadata:
  name: pull-secret 
  namespace: <your_namespace>
stringData:
  .dockerconfigjson: <your_pull_secret>

apiVersion: v1
kind: Secret
type: kubernetes.io/dockerconfigjson
metadata:
  name: pull-secret

1


  namespace: <your_namespace>
stringData:
  .dockerconfigjson: <your_pull_secret>

2

Copy to Clipboard

Toggle word wrap

1: 이름을 추가하십시오.
2: 풀 시크릿을 추가합니다.

다음 명령을 실행하여 YAML 콘텐츠를 적용합니다.
```
oc apply -f pull-secret.yaml
```
```
oc apply -f pull-secret.yaml
```
Copy to Clipboard Toggle word wrap

인프라 환경을 생성합니다.

infra-env.yaml 파일을 생성하고 다음 콘텐츠를 추가합니다. 필요한 경우 값을 바꿉니다.

apiVersion: agent-install.openshift.io/v1beta1
kind: InfraEnv
metadata:
  name: myinfraenv
  namespace: <your_namespace>
spec:
  proxy:
    httpProxy: <http://user:password@ipaddr:port>
    httpsProxy: <http://user:password@ipaddr:port>
    noProxy:
  additionalNTPSources:
  sshAuthorizedKey:
  pullSecretRef:
    name: <name>
  agentLabels:
    <key>: <value>
  nmStateConfigLabelSelector:
    matchLabels:
      <key>: <value>
  clusterRef:
    name: <cluster_name>
    namespace: <project_name>
  ignitionConfigOverride: '{"ignition": {"version": "3.1.0"}, …}'
  cpuArchitecture: x86_64
  ipxeScriptType: DiscoveryImageAlways
  kernelArguments:
    - operation: append
      value: audit=0
  additionalTrustBundle: <bundle>
  osImageVersion: <version>
  ImageType: <type>

apiVersion: agent-install.openshift.io/v1beta1
kind: InfraEnv
metadata:
  name: myinfraenv
  namespace: <your_namespace>
spec:
  proxy:
    httpProxy: <http://user:password@ipaddr:port>
    httpsProxy: <http://user:password@ipaddr:port>
    noProxy:
  additionalNTPSources:
  sshAuthorizedKey:
  pullSecretRef:
    name: <name>
  agentLabels:
    <key>: <value>
  nmStateConfigLabelSelector:
    matchLabels:
      <key>: <value>
  clusterRef:
    name: <cluster_name>
    namespace: <project_name>
  ignitionConfigOverride: '{"ignition": {"version": "3.1.0"}, …}'
  cpuArchitecture: x86_64
  ipxeScriptType: DiscoveryImageAlways
  kernelArguments:
    - operation: append
      value: audit=0
  additionalTrustBundle: <bundle>
  osImageVersion: <version>
  ImageType: <type>

Copy to Clipboard

Toggle word wrap

InfraEnv 표에서 다음 필드 설명을 참조하십시오.

Expand

표 1.11. InfraEnv 필드 테이블
필드	선택 사항 또는 필수	설명
`proxy`	선택 사항	`InfraEnv` 리소스를 사용하는 에이전트 및 클러스터의 프록시 설정을 정의합니다. `프록시 값을 설정하지 않으면 에이전트가 프록시` 를 사용하도록 구성되지 않습니다.
`httpProxy`	선택 사항	HTTP 요청에 대한 프록시의 URL입니다. URL은 `http` 로 시작해야 합니다. HTTPS는 지원되지 않습니다.
`httpsProxy`	선택 사항	HTTP 요청에 대한 프록시의 URL입니다. URL은 `http` 로 시작해야 합니다. HTTPS는 지원되지 않습니다.
`noProxy`	선택 사항	프록시를 사용하지 않으려는 쉼표로 구분된 도메인 및 CIDR 목록입니다.
`추가 NTPSources`	선택 사항	모든 호스트에 추가할 NTP(Network Time Protocol) 소스(hostname 또는 IP) 목록입니다. DHCP와 같은 다른 옵션을 사용하여 구성된 NTP 소스에 추가됩니다.
`sshAuthorizedKey`	선택 사항	검색 단계에서 디버깅에 사용할 수 있도록 모든 호스트에 추가된 SSH 공개 키입니다. 검색 단계는 호스트가 검색 이미지를 부팅하는 단계입니다.
`name`	필수 항목	풀 보안이 포함된 Kubernetes 시크릿의 이름입니다.
`agentLabels`	선택 사항	`InfraEnv` 로 검색되는 호스트를 나타내는 `에이전트` 리소스에 자동으로 추가되는 라벨입니다. 키와 값을 추가해야 합니다.
`nmStateConfigLabelSelector`	선택 사항	호스트의 고정 IP, 브리지 및 본딩과 같은 고급 네트워크 구성을 통합합니다. 호스트 네트워크 구성은 선택한 라벨을 사용하여 하나 이상의 `NMStateConfig` 리소스에 지정됩니다. `nmStateConfigLabelSelector` 속성은 선택한 라벨과 일치하는 Kubernetes 라벨 선택기입니다. 이 라벨 선택기와 일치하는 모든 `NMStateConfig` 라벨의 네트워크 구성은 Discovery Image에 포함됩니다. 부팅 시 각 호스트를 네트워크 인터페이스와 비교하고 적절한 구성을 적용합니다. 고급 네트워크 구성에 대한 자세한 내용은 인프라 환경에 대한 고급 네트워킹 구성을 참조하십시오.
`clusterRef`	선택 사항	독립 실행형 온-프레미스 클러스터를 설명하는 기존 `ClusterDeployment` 리소스를 참조합니다. 기본적으로 설정되지 않습니다. `clusterRef` 가 설정되지 않은 경우 호스트는 나중에 하나 이상의 클러스터에 바인딩될 수 있습니다. 한 클러스터에서 호스트를 제거하고 다른 클러스터에 추가할 수 있습니다. `clusterRef` 가 설정되면 `InfraEnv` 로 검색된 모든 호스트가 지정된 클러스터에 자동으로 바인딩됩니다. 클러스터가 아직 설치되지 않은 경우 검색된 모든 호스트가 설치에 포함됩니다. 클러스터가 이미 설치되어 있으면 검색된 모든 호스트가 추가됩니다.
`ignitionConfigOverride`	선택 사항	Red Hat CoreOS 라이브 이미지의 ignition 구성(예: 파일 추가)을 수정합니다. 필요한 경우에만 `ignitionConfigOverride` 를 사용하십시오. 클러스터 버전에 관계없이 ignition 버전 3.1.0을 사용해야 합니다.
`cpuArchitecture`	선택 사항	지원되는 CPU 아키텍처(x86_64, aarch64, ppc64le 또는 s390x) 중 하나를 선택합니다. 기본값은 x86_64입니다.
`ipxeScriptType`	선택 사항	`DiscoveryImageAlways` 의 기본값으로 설정되고 iPXE를 사용하여 부팅할 때 이미지 서비스가 항상 iPXE 스크립트를 제공하도록 합니다. 결과적으로 호스트는 네트워크 검색 이미지에서 부팅됩니다. 값을 `BootOrderControl` 으로 설정하면 이미지 서비스에서 호스트 상태에 따라 iPXE 스크립트를 반환할 시기를 결정하므로 호스트가 프로비저닝되고 클러스터의 일부인 경우 호스트에서 부팅됩니다.
`kernelArguments`	선택 사항	Discovery Image가 부팅될 때 에 대한 커널 인수를 수정할 수 있습니다. `작업에` 사용 가능한 값은 `추가`,`교체` 또는 `삭제` 입니다.
`additionalTrustBundle`	선택 사항	PEM 인코딩 X.509 인증서 번들, 일반적으로 호스트가 다시 암호화하는 MITTM(man-in-the-middle) 프록시가 있는 네트워크에 있거나 호스트가 컨테이너 이미지 레지스트리와 같은 다른 목적으로 인증서를 신뢰해야 하는 경우 필요합니다. `InfraEnv` 에서 검색된 호스트는 이 번들에서 인증서를 신뢰합니다. `InfraEnv` 에서 검색된 호스트에서 생성된 클러스터도 이 번들의 인증서를 신뢰합니다.
`osImageVersion`	선택 사항	`InfraEnv` 에 사용할 Red Hat CoreOS 이미지 버전입니다. 버전이 `AgentServiceConfig.spec.osImages` 또는 기본 OS 이미지 목록에 지정된 OS 이미지를 참조하는지 확인합니다. 각 릴리스에는 특정 Red Hat CoreOS 이미지 버전 세트가 있습니다. `OSImageVersion` 은 OS 이미지 목록의 OpenShift Container Platform 버전과 일치해야 합니다. `OSImageVersion` 및 `ClusterRef` 를 동시에 지정할 수 없습니다. 기본적으로 존재하지 않는 다른 버전의 Red Hat CoreOS 이미지를 사용하려면 `AgentServiceConfig.spec.osImages` 에서 지정하여 버전을 수동으로 추가해야 합니다. 버전 추가에 대한 자세한 내용은 중앙 인프라 관리 서비스 활성화를 참조하십시오.
`ImageType`	선택 사항	다운로드할 ISO 파일 유형을 선택합니다. 가능한 옵션은 `최소-iso` 또는 `full-iso` 입니다. ISO 유형을 지정하지 않으면 기본적으로 최소 ISO가 사용됩니다. 최소 ISO에는 루트 파일 시스템인 `RootFS` 가 포함되어 있지 않습니다. 최소 ISO를 선택하면 나중에 `RootFS` 가 다운로드됩니다.

다음 명령을 실행하여 YAML 콘텐츠를 적용합니다.
```
oc apply -f infra-env.yaml
```
```
oc apply -f infra-env.yaml
```
Copy to Clipboard Toggle word wrap
호스트 인벤토리가 생성되었는지 확인하려면 다음 명령을 사용하여 상태를 확인합니다.
```
oc describe infraenv myinfraenv -n <your_namespace>
```
```
oc describe infraenv myinfraenv -n <your_namespace>
```
Copy to Clipboard Toggle word wrap

다음 주요 속성 목록을 참조하십시오.

conditions: 이미지가 성공적으로 생성되었는지를 나타내는 표준 Kubernetes 상태입니다.
isoDownloadURL: Discovery Image를 다운로드할 URL입니다.
createdTime: 이미지가 마지막으로 생성된 시간입니다. InfraEnv 를 수정하는 경우 새 이미지를 다운로드하기 전에 타임스탬프가 업데이트되었는지 확인합니다.

참고: InfraEnv 리소스를 수정하는 경우, createdTime 속성을 확인하여 InfraEnv 에서 새 Discovery Image를 생성했는지 확인합니다. 이미 호스트를 부팅한 경우 최신 Discovery Image를 사용하여 다시 부팅합니다.

필요한 경우 정적 네트워킹을 구성하고 인프라 환경에 호스트를 추가할 수 있습니다.

1.9.5.3. 추가 리소스
링크 복사

1.9.6. 인프라 환경에 대한 고급 네트워킹 구성
링크 복사

단일 인터페이스에서 DHCP 이외의 네트워킹이 필요한 호스트의 경우 고급 네트워킹을 구성해야 합니다. 필수 구성에는 하나 이상의 호스트에 대한 네트워킹을 설명하는 NMStateConfig 리소스의 인스턴스 생성이 포함됩니다.

각 NMStateConfig 리소스에는 InfraEnv 리소스의 nmStateConfigLabelSelector 와 일치하는 레이블이 포함되어야 합니다. nmStateConfigLabelSelector 에 대한 자세한 내용은 명령줄 인터페이스를 사용하여 호스트 인벤토리 생성 을 참조하십시오.

Discovery Image에는 참조된 모든 NMStateConfig 리소스에 정의된 네트워크 구성이 포함되어 있습니다. 부팅 후 각 호스트는 각 구성을 네트워크 인터페이스와 비교하고 적절한 구성을 적용합니다.

1.9.6.1. 사전 요구 사항
링크 복사

중앙 인프라 관리 서비스를 활성화해야 합니다. 자세한 내용은 중앙 인프라 관리 서비스 활성화를 참조하십시오.
호스트 인벤토리를 생성해야 합니다. 자세한 내용은 콘솔을 사용하여 호스트 인벤토리 생성 을 참조하십시오.

1.9.6.2. 명령줄 인터페이스를 사용하여 고급 네트워킹 구성
링크 복사

명령줄 인터페이스를 사용하여 인프라 환경에 대한 고급 네트워킹을 구성하려면 다음 단계를 완료합니다.

nmstateconfig.yaml 이라는 파일을 생성하고 다음 템플릿과 유사한 콘텐츠를 추가합니다. 필요한 경우 값을 바꿉니다.

apiVersion: agent-install.openshift.io/v1beta1
kind: NMStateConfig
metadata:
  name: mynmstateconfig
  namespace: <your-infraenv-namespace>
  labels:
    some-key: <some-value>
spec:
  config:
    interfaces:
      - name: eth0
        type: ethernet
        state: up
        mac-address: 02:00:00:80:12:14
        ipv4:
          enabled: true
          address:
            - ip: 192.168.111.30
              prefix-length: 24
          dhcp: false
      - name: eth1
        type: ethernet
        state: up
        mac-address: 02:00:00:80:12:15
        ipv4:
          enabled: true
          address:
            - ip: 192.168.140.30
              prefix-length: 24
          dhcp: false
    dns-resolver:
      config:
        server:
          - 192.168.126.1
    routes:
      config:
        - destination: 0.0.0.0/0
          next-hop-address: 192.168.111.1
          next-hop-interface: eth1
          table-id: 254
        - destination: 0.0.0.0/0
          next-hop-address: 192.168.140.1
          next-hop-interface: eth1
          table-id: 254
  interfaces:
    - name: "eth0"
      macAddress: "02:00:00:80:12:14"
    - name: "eth1"
      macAddress: "02:00:00:80:12:15"

apiVersion: agent-install.openshift.io/v1beta1
kind: NMStateConfig
metadata:
  name: mynmstateconfig
  namespace: <your-infraenv-namespace>
  labels:
    some-key: <some-value>
spec:
  config:
    interfaces:
      - name: eth0
        type: ethernet
        state: up
        mac-address: 02:00:00:80:12:14
        ipv4:
          enabled: true
          address:
            - ip: 192.168.111.30
              prefix-length: 24
          dhcp: false
      - name: eth1
        type: ethernet
        state: up
        mac-address: 02:00:00:80:12:15
        ipv4:
          enabled: true
          address:
            - ip: 192.168.140.30
              prefix-length: 24
          dhcp: false
    dns-resolver:
      config:
        server:
          - 192.168.126.1
    routes:
      config:
        - destination: 0.0.0.0/0
          next-hop-address: 192.168.111.1
          next-hop-interface: eth1
          table-id: 254
        - destination: 0.0.0.0/0
          next-hop-address: 192.168.140.1
          next-hop-interface: eth1
          table-id: 254
  interfaces:
    - name: "eth0"
      macAddress: "02:00:00:80:12:14"
    - name: "eth1"
      macAddress: "02:00:00:80:12:15"

Copy to Clipboard

Toggle word wrap

Expand

표 1.12. NMStateConfig 필드 테이블
필드	선택 사항 또는 필수	설명
`name`	필수 항목	구성 중인 호스트 또는 호스트와 관련된 이름을 사용합니다.
`네임스페이스`	필수 항목	네임스페이스는 `InfraEnv` 리소스의 네임스페이스와 일치해야 합니다.
`some-key`	필수 항목	`InfraEnv` 리소스에서 `nmStateConfigLabelSelector` 와 일치하는 하나 이상의 레이블을 추가합니다.
`config`	선택 사항	`NMstate` 형식의 네트워크 설정을 설명합니다. 형식 사양 및 추가 예제는 선언 네트워크 API 를 참조하십시오. 구성은 호스트당 하나의 `NMStateConfig` 리소스가 있거나 단일 `NMStateConfig` 리소스에서 여러 호스트의 인터페이스를 설명할 수 있는 단일 호스트에도 적용할 수 있습니다.
`인터페이스`	선택 사항	지정된 `NMstate` 구성 및 호스트에 있는 MAC 주소에 있는 인터페이스 이름 간 매핑에 대해 설명합니다. 매핑에서 호스트에 있는 물리적 인터페이스를 사용하는지 확인합니다. 예를 들어 `NMState` 구성이 본딩 또는 VLAN을 정의하는 경우 매핑에는 상위 인터페이스에 대한 항목만 포함됩니다. 매핑의 용도는 다음과 같습니다. * 호스트의 인터페이스 이름과 일치하지 않는 구성에서 인터페이스 이름을 사용할 수 있습니다. 운영 체제가 인터페이스 이름을 선택하고 예측할 수 없는 인터페이스 이름을 선택하기 때문에 이 유용할 수 있습니다. * 부팅 후 어떤 MAC 주소를 찾고 올바른 `NMstate` 설정을 적용합니다.

참고: 이미지 서비스는 InfraEnv 속성을 업데이트하거나 레이블 선택기와 일치하는 NMStateConfig 리소스를 변경할 때 새 이미지를 자동으로 생성합니다. InfraEnv 리소스를 생성한 후 NMStateConfig 리소스를 추가하는 경우 InfraEnv에서 InfraEnv 에서 createdTime 속성을 확인하여 새 Discovery Image를 생성해야 합니다. 이미 호스트를 부팅한 경우 최신 Discovery Image를 사용하여 다시 부팅합니다.

다음 명령을 실행하여 YAML 콘텐츠를 적용합니다.
```
oc apply -f nmstateconfig.yaml
```
```
oc apply -f nmstateconfig.yaml
```
Copy to Clipboard Toggle word wrap

1.9.6.3. 추가 리소스
링크 복사

1.9.7. Discovery Image를 사용하여 호스트 인벤토리에 호스트 추가
링크 복사

호스트 인벤토리(인프라 환경)를 생성한 후 호스트를 검색하여 인벤토리에 추가할 수 있습니다.

인벤토리에 호스트를 추가하려면 ISO 파일을 다운로드하여 각 서버에 연결할 방법을 선택합니다. 예를 들어 가상 미디어를 사용하거나 ISO 파일을 USB 드라이브에 작성하여 ISO 파일을 다운로드할 수 있습니다.

중요: 설치가 실패하지 않도록 하려면 설치 프로세스 중에 장치에 Discovery ISO 미디어를 계속 연결하고 각 호스트를 한 번에 부팅하도록 설정합니다.

1.9.7.1. 사전 요구 사항
링크 복사

중앙 인프라 관리 서비스를 활성화해야 합니다. 자세한 내용은 중앙 인프라 관리 서비스 활성화를 참조하십시오.
호스트 인벤토리를 생성해야 합니다. 자세한 내용은 콘솔을 사용하여 호스트 인벤토리 생성 을 참조하십시오.

1.9.7.2. 콘솔을 사용하여 호스트 추가
링크 복사

다음 단계를 완료하여 ISO 파일을 다운로드합니다.

콘솔에서 Infrastructure > Host inventory 를 선택합니다.
목록에서 인프라 환경을 선택합니다.
호스트 추가를 클릭하고 Discovery ISO 사용을 선택합니다.
최소 이미지 파일 또는 전체 이미지 파일을 선택합니다.
Discovery ISO 생성을 클릭합니다.
참고: 부팅된 호스트가 호스트 인벤토리 테이블에 나타납니다. 호스트가 표시되는 데 몇 분이 걸릴 수 있습니다.
사용할 수 있도록 각 호스트를 승인합니다. 작업을 클릭하고 승인을 선택하여 인벤토리 테이블에서 호스트를 선택할 수 있습니다.

1.9.7.3. 명령줄 인터페이스를 사용하여 호스트 추가
링크 복사

isoDownloadURL 속성에서 ISO 파일을 다운로드할 URL은 InfraEnv 리소스의 상태에 있습니다. InfraEnv 리소스에 대한 자세한 내용은 명령줄 인터페이스를 사용하여 호스트 인벤토리 생성 을 참조하십시오.

부팅된 각 호스트는 동일한 네임스페이스에 에이전트 리소스를 생성합니다.

다음 명령을 실행하여 InfraEnv 사용자 정의 리소스에서 다운로드 URL을 확인합니다.

oc get infraenv -n <infra env namespace> <infra env name> -o jsonpath='{.status.isoDownloadURL}'

oc get infraenv -n <infra env namespace> <infra env name> -o jsonpath='{.status.isoDownloadURL}'

Copy to Clipboard

Toggle word wrap

다음 출력을 참조하십시오.

https://assisted-image-service-assisted-installer.apps.example-acm-hub.com/byapikey/eyJhbGciOiJFUzI1NiIsInC93XVCJ9.eyJpbmZyYV9lbnZfaWQcTA0Y38sWVjYi02MTA0LTQ4NDMtODasdkOGIxYTZkZGM5ZTUifQ.3ydTpHaXJmTasd7uDp2NvGUFRKin3Z9Qct3lvDky1N-5zj3KsRePhAM48aUccBqmucGt3g/4.17/x86_64/minimal.iso

https://assisted-image-service-assisted-installer.apps.example-acm-hub.com/byapikey/eyJhbGciOiJFUzI1NiIsInC93XVCJ9.eyJpbmZyYV9lbnZfaWQcTA0Y38sWVjYi02MTA0LTQ4NDMtODasdkOGIxYTZkZGM5ZTUifQ.3ydTpHaXJmTasd7uDp2NvGUFRKin3Z9Qct3lvDky1N-5zj3KsRePhAM48aUccBqmucGt3g/4.17/x86_64/minimal.iso

Copy to Clipboard

Toggle word wrap

참고: 기본적으로 최소 ISO가 제공됩니다. InfraEnv 리소스에서 ImageType 을 full-iso 로 설정하여 전체 ISO를 지정할 수 있습니다. 자세한 내용은 추가 리소스 섹션에서 명령줄 인터페이스를 사용하여 호스트 인벤토리 생성 을 참조하십시오.

URL을 사용하여 ISO 파일을 다운로드하고 ISO 파일로 호스트를 부팅합니다.
다음으로 각 호스트를 승인해야 합니다. 다음 절차를 참조하십시오.

다음 명령을 실행하여 모든 에이전트 를 나열합니다.

oc get agent -n <infra env namespace>

oc get agent -n <infra env namespace>

Copy to Clipboard

Toggle word wrap

다음 출력과 유사한 출력이 표시됩니다.

NAME                                   CLUSTER   APPROVED   ROLE          STAGE
24a92a6f-ea35-4d6f-9579-8f04c0d3591e             false      auto-assign

NAME                                   CLUSTER   APPROVED   ROLE          STAGE
24a92a6f-ea35-4d6f-9579-8f04c0d3591e             false      auto-assign

Copy to Clipboard

Toggle word wrap

목록에서 모든 에이전트 를 승인하고 잘못된 승인 상태로 승인합니다. 다음 명령을 실행합니다.

oc patch agent -n <infra env namespace> <agent name> -p '{"spec":{"approved":true}}' --type merge

oc patch agent -n <infra env namespace> <agent name> -p '{"spec":{"approved":true}}' --type merge

Copy to Clipboard

Toggle word wrap

다음 명령을 실행하여 승인 상태를 확인합니다.

oc get agent -n <infra env namespace>

oc get agent -n <infra env namespace>

Copy to Clipboard

Toggle word wrap

true 값을 사용하여 다음 출력과 유사한 출력이 표시됩니다.

NAME                                   CLUSTER   APPROVED   ROLE          STAGE
173e3a84-88e2-4fe1-967f-1a9242503bec             true       auto-assign

NAME                                   CLUSTER   APPROVED   ROLE          STAGE
173e3a84-88e2-4fe1-967f-1a9242503bec             true       auto-assign

Copy to Clipboard

Toggle word wrap

1.9.7.4. HTTP 또는 HTTPS로 iPXE 아티팩트 호스팅
링크 복사

AgentServiceConfig 사용자 정의 리소스에서 spec.iPXEHTTPRoute 필드를 편집하여 iPXE 아티팩트를 호스팅하는 방법을 변경할 수 있습니다.

iPXE 아티팩트에 HTTP를 사용하도록 활성화된 필드를 설정합니다.

iPXE 아티팩트에 HTTPS를 사용하도록 필드를 disabled 로 설정합니다.

기본값은 disabled 입니다. spec.iPXEHTTPRoute 필드가 enabled 로 설정된 다음 예제를 참조하십시오.

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
  name: agent
spec:
  iPXEHTTPRoute: enabled

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
  name: agent
spec:
  iPXEHTTPRoute: enabled

Copy to Clipboard

Toggle word wrap

값을 enabled 로 설정하면 다음 끝점이 HTTP를 통해 노출됩니다.

assisted-service 의 API/assisted-installer/v2/infra-envs/<id>/downloads/files?file_name=ipxe-script
assisted-image-service의 boot -artifacts/ 및 이미지/<infra-env-id>/pxe-initrd

1.9.7.5. 추가 리소스
링크 복사

InfraEnv 리소스에 대한 자세한 내용은 명령줄 인터페이스를 사용하여 호스트 인벤토리 생성을 참조하십시오.

1.9.8. 호스트 인벤토리에 베어 메탈 호스트 자동 추가
링크 복사

인프라 환경을 생성한 후 호스트를 검색하여 호스트 인벤토리에 추가할 수 있습니다. 베어 메탈 Operator가 각 베어 메탈 호스트의 BMC(Baseboard Management Controller)와 통신하도록 하여 인프라 환경의 검색 이미지 부팅을 자동화할 수 있습니다. 각 호스트에 대한 BareMetalHost 리소스 및 관련 BMC 시크릿을 생성합니다. 자동화는 인프라 환경을 참조하는 BareMetalHost 의 레이블로 설정됩니다.

자동화는 다음 작업을 수행합니다.

인프라 환경에서 표시하는 Discovery Image를 사용하여 각 베어 메탈 호스트 부팅
인프라 환경 또는 관련 네트워크 구성이 업데이트되는 경우 각 호스트를 최신 검색 이미지로 재부팅
검색 시 각 에이전트 리소스를 해당 BareMetalHost 리소스와 연결합니다.
호스트 이름, 역할 및 설치 디스크와 같은 BareMetalHost 의 정보를 기반으로 에이전트 리소스 속성 업데이트
클러스터 노드로 사용할 에이전트 승인

1.9.8.1. 사전 요구 사항
링크 복사

중앙 인프라 관리 서비스를 활성화해야 합니다. 자세한 내용은 중앙 인프라 관리 서비스 활성화를 참조하십시오.
호스트 인벤토리를 생성해야 합니다. 자세한 내용은 콘솔을 사용하여 호스트 인벤토리 생성 을 참조하십시오.

1.9.8.2. 콘솔을 사용하여 베어 메탈 호스트 추가
링크 복사

콘솔을 사용하여 호스트 인벤토리에 베어 메탈 호스트를 자동으로 추가하려면 다음 단계를 완료합니다.

콘솔에서 Infrastructure > Host inventory 를 선택합니다.
목록에서 인프라 환경을 선택합니다.
호스트 추가를 클릭하고 BMC 양식으로 를 선택합니다.
필요한 정보를 추가하고 생성 을 클릭합니다.

BMC 주소 지정에 대한 자세한 내용은 추가 리소스 섹션의 BMC 주소 지정을 참조하십시오.

1.9.8.3. 명령줄 인터페이스를 사용하여 베어 메탈 호스트 추가
링크 복사

명령줄 인터페이스를 사용하여 호스트 인벤토리에 베어 메탈 호스트를 자동으로 추가하려면 다음 단계를 완료합니다.

다음 YAML 콘텐츠를 적용하고 필요한 경우 값을 교체하여 BMC 시크릿을 생성합니다.

apiVersion: v1
kind: Secret
metadata:
  name: <bmc-secret-name>
  namespace: <your_infraenv_namespace> 
type: Opaque
data:
  username: <username>
  password: <password>

apiVersion: v1
kind: Secret
metadata:
  name: <bmc-secret-name>
  namespace: <your_infraenv_namespace>

1


type: Opaque
data:
  username: <username>
  password: <password>

Copy to Clipboard

Toggle word wrap

1: 네임스페이스는 InfraEnv 의 네임스페이스와 동일해야 합니다.

다음 YAML 콘텐츠를 적용하고 필요한 경우 값을 교체하여 베어 메탈 호스트를 생성합니다.

apiVersion: metal3.io/v1alpha1
kind: BareMetalHost
metadata:
  name: <bmh-name>
  namespace: <your-infraenv-namespace> 
  annotations:
    inspect.metal3.io: disabled
    bmac.agent-install.openshift.io/hostname: <hostname> 
    bmac.agent-install.openshift.io/role: <role> 
  labels:
    infraenvs.agent-install.openshift.io: <your-infraenv> 
spec:
  online: true
  automatedCleaningMode: disabled 
  bootMACAddress: <your-mac-address>  
  bmc:
    address: <machine-address> 
    credentialsName: <bmc-secret-name> 
  rootDeviceHints:
    deviceName: /dev/sda

apiVersion: metal3.io/v1alpha1
kind: BareMetalHost
metadata:
  name: <bmh-name>
  namespace: <your-infraenv-namespace>

1


  annotations:
    inspect.metal3.io: disabled
    bmac.agent-install.openshift.io/hostname: <hostname>

2


    bmac.agent-install.openshift.io/role: <role>

3


  labels:
    infraenvs.agent-install.openshift.io: <your-infraenv>

4


spec:
  online: true
  automatedCleaningMode: disabled

5


  bootMACAddress: <your-mac-address>

6


  bmc:
    address: <machine-address>

7


    credentialsName: <bmc-secret-name>

8


  rootDeviceHints:
    deviceName: /dev/sda

9

Copy to Clipboard

Toggle word wrap

1: 네임스페이스는 InfraEnv 의 네임스페이스와 동일해야 합니다.
2: 선택 사항: 호스트 이름으로 바꿉니다.
3: 선택 사항: 가능한 값은 master 또는 worker 입니다.
4: 이름은 InfrEnv 의 이름과 일치해야 하며 동일한 네임스페이스에 있어야 합니다.
5: 값을 설정하지 않으면 메타데이터 값이 자동으로 사용됩니다.
6: MAC 주소가 호스트 인터페이스 중 하나의 MAC 주소와 일치하는지 확인합니다.
7: BMC 주소를 사용합니다. 자세한 내용은 추가 리소스 섹션의 대역 외 관리 IP 주소에 대한 포트 액세스 및 BMC 주소 지정을 참조하십시오.
8: credentialsName 값이 생성한 BMC 시크릿의 이름과 일치하는지 확인합니다.
9: 선택 사항: 설치 디스크를 선택합니다. 사용 가능한 루트 장치 팁은 BareMetalHost 사양 을 참조하십시오. 호스트를 검색 이미지로 부팅하고 해당 에이전트 리소스가 생성되면 이 팁에 따라 설치 디스크가 설정됩니다.

호스트를 켜면 이미지가 다운로드되기 시작합니다. 이 작업은 몇 분 정도 걸릴 수 있습니다. 호스트가 검색되면 에이전트 사용자 지정 리소스가 자동으로 생성됩니다.

1.9.8.4. 명령줄 인터페이스를 사용하여 관리형 클러스터 노드 제거
링크 복사

관리형 클러스터에서 관리형 클러스터 노드를 제거하려면 지원되는 OpenShift Container Platform 버전에서 실행 중인 허브 클러스터가 필요합니다. 노드를 부팅하는 데 필요한 정적 네트워킹 구성을 사용할 수 있어야 합니다. 에이전트 및 베어 메탈 호스트를 삭제할 때 NMStateConfig 리소스를 삭제하지 마십시오.

1.9.8.4.1. 베어 메탈 호스트를 사용하여 관리형 클러스터 노드 제거
링크 복사

허브 클러스터에 베어 메탈 호스트가 있고 관리 클러스터에서 관리 클러스터 노드를 제거하려면 다음 단계를 완료합니다.

삭제하려는 노드의 BareMetalHost 리소스에 다음 주석을 추가합니다.
```
bmac.agent-install.openshift.io/remove-agent-and-node-on-delete: true
```
```
bmac.agent-install.openshift.io/remove-agent-and-node-on-delete: true
```
Copy to Clipboard Toggle word wrap
다음 명령을 실행하여 BareMetalHost 리소스를 삭제합니다. & lt;bmh-name& gt;을 BareMetalHost 의 이름으로 바꿉니다.
```
oc delete bmh <bmh-name>
```
```
oc delete bmh <bmh-name>
```
Copy to Clipboard Toggle word wrap

1.9.8.4.2. 베어 메탈 호스트 없이 관리형 클러스터 노드 제거
링크 복사

허브 클러스터에 베어 메탈 호스트가 없고 관리 클러스터에서 관리 클러스터 노드를 제거하려면 에이전트 사양에서 clusterDeploymentName 필드를 제거하여 에이전트를 바인딩 해제하거나 제거 중인 노드에 해당하는 에이전트 사용자 정의 리소스를 삭제할 수 있습니다.

hub 클러스터에서 에이전트 리소스를 삭제하지만 관리 클러스터에서 노드를 제거하지 않으려면 에이전트 리소스에서 주석 agent.agent-install.openshift.io/skip-spoke-cleanup 을 true 로 설정할 수 있습니다.

OpenShift Container Platform 설명서의 노드 삭제 지침을 참조하십시오.

1.9.8.5. 호스트 바인딩 및 바인딩 해제
링크 복사

Agent 사용자 정의 리소스에서 spec.clusterDeploymentName 필드를 설정하거나 {}bmac.agent-install.openshift.io/cluster-reference 베어 메탈 호스트 주석을 설정하여 Red Hat OpenShift Container Platform 클러스터에 호스트를 바인딩할 수 있습니다.

{}bmac.agent-install.openshift.io/cluster-reference 베어 메탈 호스트 주석은 OpenShift Container Platform 클러스터에 대한 연결을 제어하고 호스트를 특정 클러스터에 바인딩하거나 바인딩 해제합니다.

{}bmac.agent-install.openshift.io/cluster-reference 주석을 다음 세 가지 방법 중 하나로 사용할 수 있습니다.

베어 메탈 호스트에 주석을 설정하지 않으면 호스트에 변경 사항이 적용되지 않습니다.
빈 문자열 값으로 주석을 설정하면 호스트가 바인딩 해제됩니다.
주석을 설정하고 < cluster-namespace>/<cluster-name > 형식을 따르는 문자열 값을 사용하는 경우 호스트는 ClusterDeployment 사용자 정의 리소스가 나타내는 클러스터에 바인딩합니다.

참고: 호스트에 이미 cluster-reference 주석이 포함된 InfraEnv 가 있는 경우 {}bmac.agent-install.openshift.io/cluster-reference 주석이 무시됩니다.

1.9.8.6. 추가 리소스
링크 복사

제로 터치 프로비저닝에 대한 자세한 내용은 OpenShift Container Platform 설명서 의 네트워크 맨 위에 있는 클러스터를 참조하십시오.
베어 메탈 호스트 사용에 필요한 포트에 대한 자세한 내용은 OpenShift Container Platform 설명서 의 대역 외 관리 IP 주소에 대한 포트 액세스를 참조하십시오.
루트 장치 팁에 대한 자세한 내용은 OpenShift Container Platform 설명서의 설치 구성 개요 를 참조하십시오.
이미지 풀 시크릿 사용
온-프레미스 환경에 대한 인증 정보 생성
컴퓨팅 머신 스케일링에 대한 자세한 내용은 OpenShift Container Platform 설명서에서 컴퓨팅 머신 세트 수동 스케일링을 참조하십시오.
BMC 형식 주소 지정에 대한 자세한 내용은 OpenShift Container Platform 설명서의 BMC 주소 지정을 참조하십시오.

1.9.9. 호스트 인벤토리 관리
링크 복사

콘솔을 사용하거나 명령줄 인터페이스를 사용하여 호스트 인벤토리를 관리하고 기존 호스트를 편집하고 Agent 리소스를 편집할 수 있습니다.

1.9.9.1. 콘솔을 사용하여 호스트 인벤토리 관리
링크 복사

Discovery ISO로 성공적으로 부팅한 각 호스트는 호스트 인벤토리에 행으로 표시됩니다. 콘솔을 사용하여 호스트를 편집하고 관리할 수 있습니다. 호스트를 수동으로 부팅하고 베어 메탈 Operator 자동화를 사용하지 않는 경우 콘솔에서 호스트를 승인해야 사용할 수 있습니다. OpenShift 노드로 설치할 준비가 된 호스트의 상태는 Available 입니다.

1.9.9.2. 명령줄 인터페이스를 사용하여 호스트 인벤토리 관리
링크 복사

에이전트 리소스는 각 호스트를 나타냅니다. 에이전트 리소스에서 다음 속성을 설정할 수 있습니다.

clusterDeploymentName
이 속성을 클러스터에 노드로 설치하려는 경우 사용할 ClusterDeployment 의 네임스페이스 및 이름으로 설정합니다.
선택 사항: role
클러스터에서 호스트의 역할을 설정합니다. 가능한 값은 master,worker, auto-assign 입니다. 기본값은 auto-assign 입니다.
hostname
호스트의 호스트 이름을 설정합니다. 호스트에 유효한 호스트 이름이 자동으로 할당되는 경우(예: DHCP 사용) 선택 사항입니다.
승인됨
호스트를 OpenShift 노드로 설치할 수 있는지 여부를 나타냅니다. 이 속성은 기본값이 False 인 부울입니다. 호스트를 수동으로 부팅하고 베어 메탈 Operator 자동화를 사용하지 않는 경우 호스트를 설치하기 전에 이 속성을 True 로 설정해야 합니다.
installation_disk_id
선택한 설치 디스크의 ID가 호스트의 인벤토리에 표시됩니다.
installerArgs
호스트의 coreos-installer 인수에 대한 덮어쓰기가 포함된 JSON 형식의 문자열입니다. 이 속성을 사용하여 커널 인수를 수정할 수 있습니다. 다음 예제 구문을 참조하십시오.
```
["--append-karg", "ip=192.0.2.2::192.0.2.254:255.255.255.0:core0.example.com:enp1s0:none", "--save-partindex", "4"]
```
```
["--append-karg", "ip=192.0.2.2::192.0.2.254:255.255.255.0:core0.example.com:enp1s0:none", "--save-partindex", "4"]
```
Copy to Clipboard Toggle word wrap

ignitionConfigOverrides

호스트의 ignition 구성에 대한 덮어쓰기가 포함된 JSON 형식의 문자열입니다. 이 속성을 사용하여 ignition을 사용하여 호스트에 파일을 추가할 수 있습니다. 다음 예제 구문을 참조하십시오.

{"ignition": "version": "3.1.0"}, "storage": {"files": [{"path": "/tmp/example", "contents": {"source": "data:text/plain;base64,aGVscGltdHJhcHBlZGluYXN3YWdnZXJzcGVj"}}]}}

{"ignition": "version": "3.1.0"}, "storage": {"files": [{"path": "/tmp/example", "contents": {"source": "data:text/plain;base64,aGVscGltdHJhcHBlZGluYXN3YWdnZXJzcGVj"}}]}}

Copy to Clipboard

Toggle word wrap

nodeLabels
호스트를 설치한 후 노드에 적용되는 라벨 목록입니다.

에이전트 리소스의 상태에 는 다음과 같은 속성이 있습니다.

role
클러스터에서 호스트의 역할을 설정합니다. 이전에 Agent 리소스에서 역할을 설정하면 값이 상태에 표시됩니다.
인벤토리
호스트에서 실행 중인 에이전트가 검색하는 호스트 속성을 포함합니다.
진행 상황
호스트 설치 진행 중입니다.
ntpSources
호스트의 구성된 NTP(Network Time Protocol) 소스입니다.
conditions
True 또는 False 값과 함께 다음 표준 Kubernetes 조건을 포함합니다.
- SpecSynced: 지정된 모든 속성이 성공적으로 적용되면 True 입니다. false 오류가 발생하면 false입니다.
- connected: 설치 서비스에 대한 에이전트 연결이 중단되지 않으면 True 입니다. 에이전트가 잠시 후에 설치 서비스에 도달하지 않은 경우 false 입니다.
- RequirementsMet: 호스트가 설치를 시작할 준비가 되면 True 입니다.
- validated: 모든 호스트 검증이 통과하면 True 입니다.
- installed: 호스트가 OpenShift 노드로 설치된 경우 True 입니다.
- Bound: 호스트가 클러스터에 바인딩된 경우 True 입니다.
- cleanup: Agent resouce를 삭제하라는 요청이 실패하면 False 입니다.
debugInfo
설치 로그 및 이벤트를 다운로드하기 위한 URL이 포함되어 있습니다.
validationsInfo
설치에 성공했는지 확인하기 위해 호스트가 검색된 후 에이전트가 실행되는 검증에 대한 정보가 포함되어 있습니다. 값이 False 인 경우 문제를 해결합니다.
installation_disk_id
선택한 설치 디스크의 ID가 호스트의 인벤토리에 표시됩니다.

1.9.9.3. 추가 리소스
링크 복사

1.9.10. 각 클러스터에 대한 미러 레지스트리 구성
링크 복사

미러 레지스트리 기능을 사용하여 각 AgentClusterInstall 및 InfraEnv 리소스의 전용 미러 레지스트리 구성 오브젝트를 참조하여 각 클러스터에 대한 사용자 정의 레지스트리를 구성하고 관리합니다.

격리된 레지스트리 구성이 필요한 다중 클러스터 환경에서 각 클러스터에 대한 미러 레지스트리를 구성할 수 있습니다.

1.9.10.1. 사전 요구 사항
링크 복사

중앙 인프라 관리 서비스를 활성화해야 합니다. 자세한 내용은 중앙 인프라 관리 서비스 활성화를 참조하십시오.
미러 레지스트리를 설정해야 합니다.
assisted-service 는 KubeAPI 모드에서 실행되어야 합니다.

1.9.10.2. 필요한 이미지 미러링
링크 복사

필요한 이미지가 레지스트리에 미러링되었는지 확인합니다. 다음 단계를 완료합니다.

다음 명령을 실행하여 Red Hat OpenShift Container Platform 릴리스 이미지를 미러링합니다.

oc adm release mirror \
  -a pull_secret.json \
  --from=quay.io/openshift-release-dev/ocp-release:$OCP_TAG \
  --to=$REGISTRY_IP:$REGISTRY_PORT/openshift-release-dev/ocp-release \
  --to-release-image=$REGISTRY_IP:$REGISTRY_PORT/openshift-release-dev/ocp-release:$OCP_TAG \

oc adm release mirror \
  -a pull_secret.json \
  --from=quay.io/openshift-release-dev/ocp-release:$OCP_TAG \
  --to=$REGISTRY_IP:$REGISTRY_PORT/openshift-release-dev/ocp-release \
  --to-release-image=$REGISTRY_IP:$REGISTRY_PORT/openshift-release-dev/ocp-release:$OCP_TAG \

Copy to Clipboard

Toggle word wrap

참고: 미러 레지스트리의 OpenShift Container Platform 버전이 이미지 세트 구성의 버전과 일치하는지 확인합니다.

다음 명령을 실행하여 지원 설치 프로그램 이미지를 미러링합니다.

oc image mirror \
  -a pull_secret.json \
  quay.io/edge-infrastructure/assisted-installer:latest \
  $REGISTRY_IP:$REGISTRY_PORT/edge-infrastructure/assisted-installer:latest

oc image mirror \
  -a pull_secret.json \
  quay.io/edge-infrastructure/assisted-installer-controller:latest \
  $REGISTRY_IP:$REGISTRY_PORT/edge-infrastructure/assisted-installer-controller:latest

oc image mirror \
  -a pull_secret.json \
  quay.io/edge-infrastructure/assisted-installer-agent:latest \
  $REGISTRY_IP:$REGISTRY_PORT/edge-infrastructure/assisted-installer-agent:latest

oc image mirror \
  -a pull_secret.json \
  quay.io/edge-infrastructure/assisted-installer:latest \
  $REGISTRY_IP:$REGISTRY_PORT/edge-infrastructure/assisted-installer:latest

oc image mirror \
  -a pull_secret.json \
  quay.io/edge-infrastructure/assisted-installer-controller:latest \
  $REGISTRY_IP:$REGISTRY_PORT/edge-infrastructure/assisted-installer-controller:latest

oc image mirror \
  -a pull_secret.json \
  quay.io/edge-infrastructure/assisted-installer-agent:latest \
  $REGISTRY_IP:$REGISTRY_PORT/edge-infrastructure/assisted-installer-agent:latest

Copy to Clipboard

Toggle word wrap

1.9.10.3. 업데이트된 구성으로 사용자 정의 리소스 정의 적용
링크 복사

미러 레지스트리를 설정한 후 필요한 사용자 정의 리소스 정의를 적용하여 미러링된 이미지를 사용하도록 클러스터를 구성합니다. 다음 단계를 완료합니다.

다음 콘텐츠를 사용하여 mirror_registry.yaml 이라는 ConfigMap 파일을 생성합니다. 필요한 경우 값을 바꿉니다.

apiVersion: v1
kind: ConfigMap
metadata:
  name: mirror-registry-config
  namespace: <your-namespace>
data:
  registries.conf: |
    [[registry]]
      prefix = ""
      location = "quay.io/openshift-release-dev/ocp-release"
      [[registry.mirror]]
        location = "$REGISTRY_IP:$REGISTRY_PORT/openshift-release-dev/ocp-release"
        pull-from-mirror = "digest-only"

    [[registry]]
      prefix = ""
      location = "quay.io/edge-infrastructure"
      [[registry.mirror]]
        location = "$REGISTRY_IP:$REGISTRY_PORT/edge-infrastructure"
  ca-bundle.crt: |
    -----BEGIN CERTIFICATE-----
    ...
    -----END CERTIFICATE-----

apiVersion: v1
kind: ConfigMap
metadata:
  name: mirror-registry-config
  namespace: <your-namespace>
data:
  registries.conf: |
    [[registry]]
      prefix = ""
      location = "quay.io/openshift-release-dev/ocp-release"
      [[registry.mirror]]
        location = "$REGISTRY_IP:$REGISTRY_PORT/openshift-release-dev/ocp-release"
        pull-from-mirror = "digest-only"

    [[registry]]
      prefix = ""
      location = "quay.io/edge-infrastructure"
      [[registry.mirror]]
        location = "$REGISTRY_IP:$REGISTRY_PORT/edge-infrastructure"
  ca-bundle.crt: |
    -----BEGIN CERTIFICATE-----
    ...
    -----END CERTIFICATE-----

Copy to Clipboard

Toggle word wrap

다음 명령을 실행하여 ConfigMap 을 적용합니다.

oc apply -f mirror_registry.yaml

oc apply -f mirror_registry.yaml

Copy to Clipboard

Toggle word wrap

AgentClusterInstall 및 InfraEnv 사용자 정의 리소스 정의가 미러 레지스트리 구성을 참조하는지 확인합니다. aci.yaml 및 infraenv.yaml 모두에 대한 다음 예제를 참조하십시오.
```
...
spec:
  mirrorRegistryRef:
    name: mirror-registry-config
    namespace: <your-namespace>
    ...
```
```
...
spec:
  mirrorRegistryRef:
    name: mirror-registry-config
    namespace: <your-namespace>
    ...
```
Copy to Clipboard Toggle word wrap
다음 명령을 실행하여 사용자 정의 리소스 정의를 업데이트하고 적용합니다.
```
oc apply -f aci.yaml
oc apply -f infraenv.yaml
```
```
oc apply -f aci.yaml
oc apply -f infraenv.yaml
```
Copy to Clipboard Toggle word wrap

1.9.10.4. 추가 리소스
링크 복사

이미지 미러링에 대한 자세한 내용은 OpenShift Container Platform 설명서에서 연결이 끊긴 설치 의 이미지 미러링을 참조하십시오.

1.9.1. 호스트 인벤토리 개요링크 복사링크가 클립보드에 복사되었습니다!

1.9.2. 중앙 인프라 관리 서비스 활성화링크 복사링크가 클립보드에 복사되었습니다!

1.9.2.1. 사전 요구 사항링크 복사링크가 클립보드에 복사되었습니다!

1.9.2.2. 베어 메탈 호스트 사용자 정의 리소스 정의 생성링크 복사링크가 클립보드에 복사되었습니다!

1.9.2.3. 프로비저닝 리소스 생성 또는 수정링크 복사링크가 클립보드에 복사되었습니다!

1.9.2.4. 연결이 끊긴 환경에서 중앙 인프라 관리 활성화링크 복사링크가 클립보드에 복사되었습니다!

1.9.2.5. 연결된 환경에서 중앙 인프라 관리 활성화링크 복사링크가 클립보드에 복사되었습니다!

1.9.2.6. 지원 설치 관리자를 사용하여 FIPS 지원 클러스터 설치링크 복사링크가 클립보드에 복사되었습니다!

1.9.2.6.1. OpenShift Container Platform 클러스터 버전 4.15 및 이전 버전 설치링크 복사링크가 클립보드에 복사되었습니다!

1.9.2.6.2. OpenShift Container Platform 클러스터 버전 4.16 이상 설치링크 복사링크가 클립보드에 복사되었습니다!

1.9.2.7. 추가 리소스링크 복사링크가 클립보드에 복사되었습니다!

1.9.3. Amazon Web Services에서 중앙 인프라 관리 활성화링크 복사링크가 클립보드에 복사되었습니다!

1.9.4. 콘솔을 사용하여 호스트 인벤토리 생성링크 복사링크가 클립보드에 복사되었습니다!

1.9.4.1. 사전 요구 사항링크 복사링크가 클립보드에 복사되었습니다!

1.9.4.2. 호스트 인벤토리 생성링크 복사링크가 클립보드에 복사되었습니다!

1.9.4.3. 호스트 인벤토리에 액세스링크 복사링크가 클립보드에 복사되었습니다!

1.9.4.4. 추가 리소스링크 복사링크가 클립보드에 복사되었습니다!

1.9.5. 명령줄 인터페이스를 사용하여 호스트 인벤토리 생성링크 복사링크가 클립보드에 복사되었습니다!

1.9.5.1. 사전 요구 사항링크 복사링크가 클립보드에 복사되었습니다!

1.9.5.2. 호스트 인벤토리 생성링크 복사링크가 클립보드에 복사되었습니다!

1.9.5.3. 추가 리소스링크 복사링크가 클립보드에 복사되었습니다!

1.9.6. 인프라 환경에 대한 고급 네트워킹 구성링크 복사링크가 클립보드에 복사되었습니다!

1.9.6.1. 사전 요구 사항링크 복사링크가 클립보드에 복사되었습니다!

1.9.6.2. 명령줄 인터페이스를 사용하여 고급 네트워킹 구성링크 복사링크가 클립보드에 복사되었습니다!

1.9.6.3. 추가 리소스링크 복사링크가 클립보드에 복사되었습니다!

1.9.7. Discovery Image를 사용하여 호스트 인벤토리에 호스트 추가링크 복사링크가 클립보드에 복사되었습니다!

1.9.7.1. 사전 요구 사항링크 복사링크가 클립보드에 복사되었습니다!

1.9.7.2. 콘솔을 사용하여 호스트 추가링크 복사링크가 클립보드에 복사되었습니다!

1.9.7.3. 명령줄 인터페이스를 사용하여 호스트 추가링크 복사링크가 클립보드에 복사되었습니다!

1.9.7.4. HTTP 또는 HTTPS로 iPXE 아티팩트 호스팅링크 복사링크가 클립보드에 복사되었습니다!

1.9.7.5. 추가 리소스링크 복사링크가 클립보드에 복사되었습니다!

1.9.8. 호스트 인벤토리에 베어 메탈 호스트 자동 추가링크 복사링크가 클립보드에 복사되었습니다!

1.9.8.1. 사전 요구 사항링크 복사링크가 클립보드에 복사되었습니다!

1.9.8.2. 콘솔을 사용하여 베어 메탈 호스트 추가링크 복사링크가 클립보드에 복사되었습니다!

1.9.8.3. 명령줄 인터페이스를 사용하여 베어 메탈 호스트 추가링크 복사링크가 클립보드에 복사되었습니다!

1.9.8.4. 명령줄 인터페이스를 사용하여 관리형 클러스터 노드 제거링크 복사링크가 클립보드에 복사되었습니다!

1.9.8.4.1. 베어 메탈 호스트를 사용하여 관리형 클러스터 노드 제거링크 복사링크가 클립보드에 복사되었습니다!

1.9.8.4.2. 베어 메탈 호스트 없이 관리형 클러스터 노드 제거링크 복사링크가 클립보드에 복사되었습니다!

1.9.8.5. 호스트 바인딩 및 바인딩 해제링크 복사링크가 클립보드에 복사되었습니다!

1.9.8.6. 추가 리소스링크 복사링크가 클립보드에 복사되었습니다!

1.9.9. 호스트 인벤토리 관리링크 복사링크가 클립보드에 복사되었습니다!

1.9.9.1. 콘솔을 사용하여 호스트 인벤토리 관리링크 복사링크가 클립보드에 복사되었습니다!

1.9.9.2. 명령줄 인터페이스를 사용하여 호스트 인벤토리 관리링크 복사링크가 클립보드에 복사되었습니다!

1.9.9.3. 추가 리소스링크 복사링크가 클립보드에 복사되었습니다!

1.9.10. 각 클러스터에 대한 미러 레지스트리 구성링크 복사링크가 클립보드에 복사되었습니다!

1.9.10.1. 사전 요구 사항링크 복사링크가 클립보드에 복사되었습니다!

1.9.10.2. 필요한 이미지 미러링링크 복사링크가 클립보드에 복사되었습니다!

1.9.10.3. 업데이트된 구성으로 사용자 정의 리소스 정의 적용링크 복사링크가 클립보드에 복사되었습니다!

1.9.10.4. 추가 리소스링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

1.9.1. 호스트 인벤토리 개요
링크 복사

1.9.2. 중앙 인프라 관리 서비스 활성화
링크 복사

1.9.2.1. 사전 요구 사항
링크 복사

1.9.2.2. 베어 메탈 호스트 사용자 정의 리소스 정의 생성
링크 복사

1.9.2.3. 프로비저닝 리소스 생성 또는 수정
링크 복사

1.9.2.4. 연결이 끊긴 환경에서 중앙 인프라 관리 활성화
링크 복사

1.9.2.5. 연결된 환경에서 중앙 인프라 관리 활성화
링크 복사

1.9.2.6. 지원 설치 관리자를 사용하여 FIPS 지원 클러스터 설치
링크 복사

1.9.2.6.1. OpenShift Container Platform 클러스터 버전 4.15 및 이전 버전 설치
링크 복사

1.9.2.6.2. OpenShift Container Platform 클러스터 버전 4.16 이상 설치
링크 복사

1.9.2.7. 추가 리소스
링크 복사

1.9.3. Amazon Web Services에서 중앙 인프라 관리 활성화
링크 복사

1.9.4. 콘솔을 사용하여 호스트 인벤토리 생성
링크 복사

1.9.4.1. 사전 요구 사항
링크 복사

1.9.4.2. 호스트 인벤토리 생성
링크 복사

1.9.4.3. 호스트 인벤토리에 액세스
링크 복사

1.9.4.4. 추가 리소스
링크 복사

1.9.5. 명령줄 인터페이스를 사용하여 호스트 인벤토리 생성
링크 복사

1.9.5.1. 사전 요구 사항
링크 복사

1.9.5.2. 호스트 인벤토리 생성
링크 복사

1.9.5.3. 추가 리소스
링크 복사

1.9.6. 인프라 환경에 대한 고급 네트워킹 구성
링크 복사

1.9.6.1. 사전 요구 사항
링크 복사

1.9.6.2. 명령줄 인터페이스를 사용하여 고급 네트워킹 구성
링크 복사

1.9.6.3. 추가 리소스
링크 복사

1.9.7. Discovery Image를 사용하여 호스트 인벤토리에 호스트 추가
링크 복사

1.9.7.1. 사전 요구 사항
링크 복사

1.9.7.2. 콘솔을 사용하여 호스트 추가
링크 복사

1.9.7.3. 명령줄 인터페이스를 사용하여 호스트 추가
링크 복사

1.9.7.4. HTTP 또는 HTTPS로 iPXE 아티팩트 호스팅
링크 복사

1.9.7.5. 추가 리소스
링크 복사

1.9.8. 호스트 인벤토리에 베어 메탈 호스트 자동 추가
링크 복사

1.9.8.1. 사전 요구 사항
링크 복사

1.9.8.2. 콘솔을 사용하여 베어 메탈 호스트 추가
링크 복사

1.9.8.3. 명령줄 인터페이스를 사용하여 베어 메탈 호스트 추가
링크 복사

1.9.8.4. 명령줄 인터페이스를 사용하여 관리형 클러스터 노드 제거
링크 복사

1.9.8.4.1. 베어 메탈 호스트를 사용하여 관리형 클러스터 노드 제거
링크 복사

1.9.8.4.2. 베어 메탈 호스트 없이 관리형 클러스터 노드 제거
링크 복사

1.9.8.5. 호스트 바인딩 및 바인딩 해제
링크 복사

1.9.8.6. 추가 리소스
링크 복사

1.9.9. 호스트 인벤토리 관리
링크 복사

1.9.9.1. 콘솔을 사용하여 호스트 인벤토리 관리
링크 복사

1.9.9.2. 명령줄 인터페이스를 사용하여 호스트 인벤토리 관리
링크 복사

1.9.9.3. 추가 리소스
링크 복사

1.9.10. 각 클러스터에 대한 미러 레지스트리 구성
링크 복사

1.9.10.1. 사전 요구 사항
링크 복사

1.9.10.2. 필요한 이미지 미러링
링크 복사

1.9.10.3. 업데이트된 구성으로 사용자 정의 리소스 정의 적용
링크 복사

1.9.10.4. 추가 리소스
링크 복사