2.2. 설치 템플릿 개요

templated 필드를 사용자 지정할 수 있습니다. SiteConfig Operator는 모든 sprig 라이브러리 함수 를 지원합니다.

또한 ClusterInstance API는 사용자 정의 매니페스트를 생성하는 동안 사용할 수 있는 다음 기능을 제공합니다.

ClusterInstance.Spec.Proxy 필드에서 .toYaml 사양의 다음 예제를 참조하십시오.

{{ if .Spec.Proxy }}
  proxy:
{{ .Spec.Proxy | toYaml | indent 4 }}
{{ end }}

{{ if .Spec.Proxy }}
  proxy:
{{ .Spec.Proxy | toYaml | indent 4 }}
{{ end }}

SiteConfig Operator는 Operator가 설치된 동일한 네임스페이스에 있는 다음과 같은 기본, 유효성 검사 및 변경 불가능한 템플릿 세트를 제공합니다.

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

SiteConfig Operator는 템플릿에서 사용할 수 있는 특수 템플릿 변수 집합을 제공합니다. 다음 목록을 참조하십시오.

텍스트 템플릿에서 필드 이름을 대문자로 지정하여 사용자 지정 템플릿 필드를 생성합니다.

예를 들어 ClusterInstance spec 필드는 .Spec 접두사를 사용하여 참조합니다. 그러나 .SpecialVars 접두사를 사용하여 특수 변수 필드를 참조해야 합니다.

중요: spec.nodes 필드에 .Spec.Nodes 접두사를 사용하는 대신 .SpecialVars.CurrentNode 특수 템플릿 변수로 참조해야 합니다.

예를 들어 CurrentNode 특수 템플릿 변수를 사용하여 현재 노드의 이름과 네임스페이스 를 지정하려면 다음 양식에서 필드 이름을 사용합니다.

name: "{{ .SpecialVars.CurrentNode.HostName }}"
namespace: "{{ .Spec.ClusterName }}"

name: "{{ .SpecialVars.CurrentNode.HostName }}"
namespace: "{{ .Spec.ClusterName }}"

siteconfig.open-cluster-management.io/sync- ECDSA 주석을 사용하여 매니페스트가 생성, 업데이트 및 삭제된 순서를 제어할 수 있습니다. 주석은 정수를 값으로 사용하고 해당 정수는 웨이브 로 구성됩니다.

단일 웨이브에 하나 또는 여러 매니페스트를 추가할 수 있습니다. 값을 지정하지 않으면 주석에서 기본값인 0 을 사용합니다.

SiteConfig Operator는 리소스를 생성하거나 업데이트할 때 오름차순으로 매니페스트를 오름차순으로 조정하고 내림차순으로 리소스를 삭제합니다.

다음 예에서 SiteConfig Operator가 매니페스트를 생성하거나 업데이트하면 AgentClusterInstall 및 ClusterDeployment 사용자 정의 리소스가 첫 번째 웨이브에서 조정되는 반면 KlusterletAddonConfig 및 ManagedCluster 사용자 정의 리소스는 세 번째 파동에서 조정됩니다.

apiVersion: v1
data:
  AgentClusterInstall: |-
    ...
        siteconfig.open-cluster-management.io/sync-wave: "1"
    ...
  ClusterDeployment: |-
    ...
        siteconfig.open-cluster-management.io/sync-wave: "1"
    ...
  InfraEnv: |-
    ...
        siteconfig.open-cluster-management.io/sync-wave: "2"
    ...
  KlusterletAddonConfig: |-
    ...
        siteconfig.open-cluster-management.io/sync-wave: "3"
    ...
  ManagedCluster: |-
    ...
        siteconfig.open-cluster-management.io/sync-wave: "3"
    ...
kind: ConfigMap
metadata:
  name: assisted-installer-templates
  namespace: example-namespace

apiVersion: v1
data:
  AgentClusterInstall: |-
    ...
        siteconfig.open-cluster-management.io/sync-wave: "1"
    ...
  ClusterDeployment: |-
    ...
        siteconfig.open-cluster-management.io/sync-wave: "1"
    ...
  InfraEnv: |-
    ...
        siteconfig.open-cluster-management.io/sync-wave: "2"
    ...
  KlusterletAddonConfig: |-
    ...
        siteconfig.open-cluster-management.io/sync-wave: "3"
    ...
  ManagedCluster: |-
    ...
        siteconfig.open-cluster-management.io/sync-wave: "3"
    ...
kind: ConfigMap
metadata:
  name: assisted-installer-templates
  namespace: example-namespace

SiteConfig Operator가 리소스를 삭제하는 경우 KlusterletAddonConfig 및 ManagedCluster 사용자 정의 리소스가 가장 먼저 삭제되는 반면 AgentClusterInstall 및 ClusterDeployment 사용자 정의 리소스가 마지막입니다.

ClusterInstance API에서 extraAnnotations 및 extraLabels 필드를 사용하여 클러스터 수준 및 노드 수준 설치 매니페스트 모두에 추가 주석 및 레이블을 구성할 수 있습니다. SiteConfig Operator는 ClusterInstance 리소스에서 지정하는 매니페스트에 추가 주석 및 레이블을 적용합니다.

추가 주석 및 레이블을 생성할 때 SiteConfig 운영자가 일치하는 모든 매니페스트에 적용할 수 있도록 매니페스트 유형을 지정해야 합니다. 그러나 주석과 레이블은 임의의 것이며 애플리케이션에 의미 있는 모든 키 및 값 쌍을 설정할 수 있습니다.

참고: 추가 주석 및 레이블은 참조된 템플릿을 통해 렌더링된 리소스에만 적용됩니다.

추가 주석 및 extra Labels 의 다음 예제 애플리케이션을 확인합니다.

apiVersion: siteconfig.open-cluster-management.io/v1alpha1
kind: ClusterInstance
metadata:
  name: "example-sno"
  namespace: "example-sno"
spec:
  [...]
  clusterName: "example-sno"
  extraAnnotations: 
    ClusterDeployment:
      myClusterAnnotation: success
  extraLabels: 
    ManagedCluster:
      common: "true"
      group-du: ""
  nodes:
    - hostName: "example-sno.example.redhat.com"
      role: "master"
      extraAnnotations: 
        BareMetalHost:
          myNodeAnnotation: success
      extraLabels: 
        BareMetalHost:
          "testExtraLabel": "success"

apiVersion: siteconfig.open-cluster-management.io/v1alpha1
kind: ClusterInstance
metadata:
  name: "example-sno"
  namespace: "example-sno"
spec:
  [...]
  clusterName: "example-sno"
  extraAnnotations: 

    ClusterDeployment:
      myClusterAnnotation: success
  extraLabels: 

    ManagedCluster:
      common: "true"
      group-du: ""
  nodes:
    - hostName: "example-sno.example.redhat.com"
      role: "master"
      extraAnnotations: 

        BareMetalHost:
          myNodeAnnotation: success
      extraLabels: 

        BareMetalHost:
          "testExtraLabel": "success"