2.5. SiteConfig Operator를 사용하여 단일 노드 OpenShift 클러스터 설치


기본 설치 템플릿을 사용하여 SiteConfig Operator로 클러스터를 설치합니다. Image-Based Install Operator의 설치 템플릿을 사용하여 절차를 완료합니다.

필수 액세스: 클러스터 관리자

2.5.1. 사전 요구 사항

SiteConfig Operator를 사용하여 클러스터를 설치하려면 다음 단계를 완료합니다.

2.5.2. 대상 네임스페이스 생성

가져오기 보안, BMC 시크릿, 추가 매니페스트 ConfigMap 오브젝트 및 ClusterInstance 사용자 정의 리소스를 생성할 때 대상 네임스페이스가 필요합니다.

대상 네임스페이스를 생성하려면 다음 단계를 완료합니다.

  1. 대상 네임스페이스에 대한 YAML 파일을 생성합니다. clusterinstance-namespace.yaml 이라는 다음 예제 파일을 참조하십시오.

    apiVersion: v1
    kind: Namespace
    metadata:
      name: example-sno
    Copy to Clipboard Toggle word wrap
  2. 파일을 적용하여 리소스를 생성합니다. hub 클러스터에서 다음 명령을 실행합니다.

    oc apply -f clusterinstance-namespace.yaml
    Copy to Clipboard Toggle word wrap

2.5.3. 풀 시크릿 생성

클러스터가 컨테이너 레지스트리에서 이미지를 가져올 수 있도록 하려면 풀 시크릿이 필요합니다. 풀 시크릿을 생성하려면 다음 단계를 완료합니다.

  1. YAML 파일을 생성하여 이미지를 가져옵니다. pull-secret.yaml 이라는 파일의 다음 예제를 참조하십시오.

    apiVersion: v1
    kind: Secret
    metadata:
      name: pull-secret
      namespace: example-sno 
    1
    
    data:
      .dockerconfigjson: <encoded_docker_configuration> 
    2
    
    type: kubernetes.io/dockerconfigjson
    Copy to Clipboard Toggle word wrap
    1
    네임스페이스 값이 대상 네임스페이스 와 일치하는지 확인합니다.
    2
    base64로 인코딩된 구성 파일을 값으로 지정합니다.
  2. 파일을 적용하여 리소스를 생성합니다. hub 클러스터에서 다음 명령을 실행합니다.

    oc apply -f pull-secret.yaml
    Copy to Clipboard Toggle word wrap

2.5.4. BMC 시크릿 생성

BMC(Baseboard Management Controller)에 연결하려면 시크릿이 필요합니다. 보안을 생성하려면 다음 단계를 완료합니다.

  1. BMC 시크릿에 대한 YAML 파일을 생성합니다. 이름이 example-bmc-secret.yaml 인 다음 샘플 파일을 참조하십시오.

    apiVersion: v1
    data:
      password: <password>
      username: <username>
    kind: Secret
    metadata:
      name: example-bmh-secret
      namespace: "example-sno" 
    1
    
    type: Opaque
    Copy to Clipboard Toggle word wrap
    1
    네임스페이스 값이 대상 네임스페이스 와 일치하는지 확인합니다.
  2. 파일을 적용하여 리소스를 생성합니다. hub 클러스터에서 다음 명령을 실행합니다.

    oc apply -f example-bmc-secret.yaml
    Copy to Clipboard Toggle word wrap

2.5.5. 선택 사항: 추가 매니페스트 생성

ClusterInstance 사용자 정의 리소스에서 참조해야 하는 추가 매니페스트를 생성할 수 있습니다. 추가 매니페스트를 생성하려면 다음 단계를 완료합니다.

  1. 추가 매니페스트 ConfigMap 오브젝트에 대한 YAML 파일을 생성합니다(예: enable-crun.yaml ):

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: enable-crun
      namespace: example-sno 
    1
    
    data:
      enable-crun-master.yaml: |
        apiVersion: machineconfiguration.openshift.io/v1
        kind: ContainerRuntimeConfig
        metadata:
          name: enable-crun-master
        spec:
          machineConfigPoolSelector:
            matchLabels:
              pools.operator.machineconfiguration.openshift.io/master: ""
          containerRuntimeConfig:
            defaultRuntime: crun
      enable-crun-worker.yaml: |
        apiVersion: machineconfiguration.openshift.io/v1
        kind: ContainerRuntimeConfig
        metadata:
          name: enable-crun-worker
        spec:
          machineConfigPoolSelector:
            matchLabels:
              pools.operator.machineconfiguration.openshift.io/worker: ""
          containerRuntimeConfig:
            defaultRuntime: crun
    Copy to Clipboard Toggle word wrap
    1
    네임스페이스 값이 대상 네임스페이스 와 일치하는지 확인합니다.
  2. hub 클러스터에서 다음 명령을 실행하여 리소스를 생성합니다.

    oc apply -f enable-crun.yaml
    Copy to Clipboard Toggle word wrap

2.5.6. 설치 매니페스트 렌더링

ClusterInstance 사용자 정의 리소스의 템플릿 및 지원 매니페스트를 참조합니다. 기본 클러스터 및 노드 템플릿을 사용하여 설치 매니페스트를 렌더링하려면 다음 단계를 완료합니다.

  1. example-sno 네임스페이스에서 다음 예제에서 clusterinstance-ibi.yaml 이라는 ClusterInstance 사용자 정의 리소스를 생성합니다.

    apiVersion: siteconfig.open-cluster-management.io/v1alpha1
    kind: ClusterInstance
    metadata:
      name: "example-clusterinstance"
      namespace: "example-sno" 
    1
    
    spec:
      #clusterType: "SNO" 
    2
    
      holdInstallation: false
      extraManifestsRefs: 
    3
    
        - name: extra-machine-configs
        - name: enable-crun
      pullSecretRef:
        name: "pull-secret" 
    4
    
      [...]
      clusterName: "example-sno" 
    5
    
      [...]
      clusterImageSetNameRef: "img4.17-x86-64"
      [...]
      templateRefs: 
    6
    
        - name: ibi-cluster-templates-v1
          namespace: rhacm
      [...]
      nodes:
          [...]
          bmcCredentialsName: 
    7
    
            name: "example-bmh-secret"
          [...]
          templateRefs: 
    8
    
            - name: ibi-node-templates-v1
              namespace: rhacm
          [...]
    Copy to Clipboard Toggle word wrap
    1
    ClusterInstance 사용자 정의 리소스의 네임스페이스 가 사용자가 정의한 대상 네임스페이스와 일치하는지 확인합니다.
    2
    선택 사항: 단일 노드 OpenShift 클러스터에서 확장하거나 확장하려면 spec.clusterType 필드를 "SNO" 로 설정해야 합니다.
    3
    하나 이상의 추가 매니페스트 ConfigMap 오브젝트 이름을 참조합니다.
    4
    풀 시크릿의 이름을 참조합니다.
    5
    ClusterInstance 사용자 정의 리소스의 clusterName 필드 값이 namespace 필드의 값과 일치하는지 확인합니다.
    6
    spec.templateRefs 필드에서 클러스터 수준 템플릿의 이름을 참조합니다. 기본 설치 템플릿을 사용하는 경우 네임스페이스 가 Operator가 설치된 네임스페이스와 일치해야 합니다.
    7
    BMC 시크릿의 이름을 참조합니다.
    8
    spec.nodes.templateRefs 필드에서 노드 수준 템플릿의 이름을 참조합니다. 기본 설치 템플릿을 사용하는 경우 네임스페이스 가 Operator가 설치된 네임스페이스와 일치해야 합니다.
  2. 다음 명령을 실행하여 파일을 적용하고 리소스를 생성합니다.

    oc apply -f clusterinstance-ibi.yaml
    Copy to Clipboard Toggle word wrap

    사용자 지정 리소스를 생성한 후 SiteConfig Operator가 ClusterInstance 사용자 정의 리소스를 조정한 다음 설치 매니페스트를 검증하고 렌더링합니다.

    SiteConfig Operator는 해당 ClusterInstance 사용자 정의 리소스의 클러스터 설치 진행 상황을 업데이트하기 위해 ClusterDeployment 사용자 지정 리소스의 변경 사항을 계속 모니터링합니다.

  3. 다음 명령을 실행하여 프로세스를 모니터링합니다.

    oc get clusterinstance <cluster_name> -n <target_namespace> -o yaml
    Copy to Clipboard Toggle word wrap

    매니페스트 생성에 성공하려면 status.conditions 섹션의 다음 예제 출력을 참조하십시오.

    message: Applied site config manifests
    reason: Completed
    status: "True"
    type: RenderedTemplatesApplied
    Copy to Clipboard Toggle word wrap
  4. 다음 명령을 실행하여 SiteConfig Operator가 렌더링한 매니페스트를 확인합니다.

    oc get clusterinstance <cluster_name> -n <target_namespace> -o jsonpath='{.status.manifestsRendered}'
    Copy to Clipboard Toggle word wrap

상태 조건에 대한 자세한 내용은 ClusterInstance API를 참조하십시오.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

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

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동