Skip to main content
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

Helm을 사용하여 Trident 운영자 배포(표준 모드)

PDF

Helm을 사용하여 Trident 오퍼레이터를 배포하고 Trident를 설치할 수 있습니다. 이 프로세스는 Trident에 필요한 컨테이너 이미지가 프라이빗 레지스트리에 저장되지 않은 설치에 적용됩니다. 프라이빗 이미지 레지스트리가 있는 경우 "오프라인 배포 프로세스"을 사용하십시오.

Trident 25.10에 대한 중요 정보

Trident에 대한 다음 중요 정보를 읽어야 합니다.

<strong>Trident에 대한 중요 정보</strong>

  • Kubernetes 1.34는 이제 Trident에서 지원됩니다. Kubernetes를 업그레이드하기 전에 Trident를 먼저 업그레이드하십시오.

  • Trident는 SAN 환경에서 다중 경로 구성 사용을 엄격하게 시행하며, multipath.conf 파일에 권장 값은 `find_multipaths: no`입니다.

    다중 경로를 사용하지 않는 구성 또는 multipath.conf 파일에서 find_multipaths: yes 또는 find_multipaths: smart 값을 사용하면 마운트가 실패합니다. Trident는 21.07 릴리스부터 find_multipaths: no 사용을 권장해 왔습니다.

Helm을 사용하여 Trident 오퍼레이터를 배포하고 Trident를 설치하십시오

Trident "Helm Chart"를 사용하여 Trident 운영자를 배포하고 Trident를 한 번에 설치할 수 있습니다.

"설치 개요"을(를) 검토하여 설치 사전 요구 사항을 충족했는지, 그리고 사용 환경에 맞는 올바른 설치 옵션을 선택했는지 확인하십시오.

시작하기 전에

"배포 사전 요구 사항" 외에도 "Helm 버전 3"이(가) 필요합니다.

단계

  1. Trident Helm 리포지토리 추가:

    helm repo add netapp-trident https://netapp.github.io/trident-helm-chart

  2. `helm install`를 사용하고 다음 예시와 같이 배포 이름을 지정하십시오. 여기서 `100.2506.0`는 설치하려는 Trident 버전입니다.

    helm install <name> netapp-trident/trident-operator --version 100.2506.0 --create-namespace --namespace <trident-namespace>
    참고 이미 Trident에 대한 네임스페이스를 생성한 경우 --create-namespace 매개변수는 추가 네임스페이스를 생성하지 않습니다. 
    `helm list`을 사용하여 이름, 네임스페이스, 차트, 상태, 앱 버전 및 수정 번호와 같은 설치 세부 정보를 검토할 수 있습니다.

설치 중에 구성 데이터를 전달합니다

설치 중에 구성 데이터를 전달하는 방법에는 두 가지가 있습니다.

옵션 설명

--values (또는 -f)

재정의를 포함하는 YAML 파일을 지정합니다. 이 파일은 여러 번 지정할 수 있으며 가장 오른쪽에 있는 파일이 우선 적용됩니다.

--set

명령줄에서 재정의를 지정합니다.

예를 들어, `debug`의 기본값을 변경하려면 다음 명령을 실행하십시오. 여기서 `100.2506.0`는 설치하려는 Trident 버전입니다.

helm install <name> netapp-trident/trident-operator --version 100.2506.0  --create-namespace --namespace trident --set tridentDebug=true

구성 옵션

이 표와 Helm 차트의 일부인 values.yaml 파일은 키 목록과 해당 기본값을 제공합니다.

옵션 설명 기본값

nodeSelector

POD 할당을 위한 노드 레이블

podAnnotations

Pod 주석

deploymentAnnotations

배포 주석

tolerations

POD 할당에 대한 톨러레이션

affinity

POD 할당에 대한 선호도

 
affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
            - key: kubernetes.io/arch
              operator: In
              values:
              - arm64
              - amd64
            - key: kubernetes.io/os
              operator: In
              values:
              - linux
경고 values.yaml 파일에서 기본 선호도를 제거하지 마십시오. 사용자 지정 선호도를 제공하려면 기본 선호도를 확장하십시오.

tridentControllerPluginNodeSelector

Pod에 대한 추가 노드 선택기입니다. 자세한 내용은 컨트롤러 Pod 및 노드 Pod 이해을 참조하십시오.

tridentControllerPluginTolerations

Pod에 대한 Kubernetes 허용 설정을 재정의합니다. 자세한 내용은 컨트롤러 Pod 및 노드 Pod 이해을(를) 참조하십시오.

tridentNodePluginNodeSelector

Pod에 대한 추가 노드 선택기입니다. 자세한 내용은 컨트롤러 Pod 및 노드 Pod 이해을 참조하십시오.

tridentNodePluginTolerations

Pod에 대한 Kubernetes 허용 설정을 재정의합니다. 자세한 내용은 컨트롤러 Pod 및 노드 Pod 이해을(를) 참조하십시오.

imageRegistry

trident-operator, trident 및 기타 이미지에 대한 레지스트리를 식별합니다. 기본값을 사용하려면 비워 두십시오. 중요: 개인 리포지토리에 Trident를 설치할 때 리포지토리 위치를 지정하기 위해 imageRegistry 스위치를 사용하는 경우 리포지토리 경로에 `/netapp/`를 사용하지 마십시오.

""

imagePullPolicy

`trident-operator`에 대한 이미지 풀 정책을 설정합니다.

IfNotPresent

imagePullSecrets

trident-operator, trident 및 기타 이미지에 대한 이미지 가져오기 비밀 키를 설정합니다.

kubeletDir

kubelet의 내부 상태의 호스트 위치를 재정의할 수 있습니다.

"/var/lib/kubelet"

operatorLogLevel

Trident 운영자의 로그 레벨을 trace, debug, info, warn, error 또는 `fatal`로 설정할 수 있습니다.

"info"

operatorDebug

Trident 운영자의 로그 수준을 디버그로 설정할 수 있습니다.

true

operatorImage

`trident-operator`에 대한 이미지의 완전한 재정의를 허용합니다.

""

operatorImageTag

trident-operator 이미지의 태그를 재정의할 수 있습니다.

""

tridentIPv6

Trident가 IPv6 클러스터에서 작동하도록 설정할 수 있습니다.

false

tridentK8sTimeout

대부분의 Kubernetes API 작업에 대한 기본 30초 시간 초과를 재정의합니다(0이 아닌 경우 초 단위).

0

tridentHttpRequestTimeout

HTTP 요청에 대한 기본 90초 타임아웃을 재정의하며, `0s`는 타임아웃의 무한 기간입니다. 음수 값은 허용되지 않습니다.

"90s"

tridentSilenceAutosupport

Trident 주기적인 AutoSupport 보고 기능을 비활성화할 수 있습니다.

false

tridentAutosupportImageTag

Trident AutoSupport 컨테이너의 이미지 태그를 재정의할 수 있습니다.

<version>

tridentAutosupportProxy

Trident AutoSupport 컨테이너가 HTTP 프록시를 통해 홈에 전화를 걸 수 있도록 합니다.

""

tridentLogFormat

Trident 로깅 형식을 설정합니다((text 또는 json).

"text"

tridentDisableAuditLog

Trident 감사 로거를 비활성화합니다.

true

tridentLogLevel

Trident의 로그 레벨을 trace, debug, info, warn, error 또는 `fatal`로 설정할 수 있습니다.

"info"

tridentDebug

Trident의 로그 레벨을 `debug`로 설정할 수 있습니다. 노드 상태 점검(NHC) 연산자와 통합하여 강제 분리 프로세스를 자동화할 수 있습니다. 자세한 내용은 "Trident를 사용하여 상태 저장 애플리케이션의 페일오버 자동화"를 참조하십시오.

false

tridentLogWorkflows

특정 Trident 워크플로우에 대해 추적 로깅 또는 로그 억제를 활성화할 수 있습니다.

""

tridentLogLayers

특정 Trident 레이어에 대해 추적 로깅 또는 로그 억제를 활성화할 수 있습니다.

""

tridentImage

Trident의 이미지를 완전히 재정의할 수 있습니다.

""

tridentImageTag

Trident의 이미지 태그를 재정의할 수 있습니다.

""

tridentProbePort

Kubernetes 활성/준비 상태 프로브에 사용되는 기본 포트를 재정의할 수 있습니다.

""

windows

Windows 워커 노드에 Trident를 설치할 수 있도록 합니다.

false

enableForceDetach

강제 분리 기능을 활성화할 수 있습니다.

false

excludePodSecurityPolicy

운영자 포드 보안 정책을 생성에서 제외합니다.

false

cloudProvider

`"Azure"`AKS 클러스터에서 관리형 ID 또는 클라우드 ID를 사용하는 경우 로 설정합니다. EKS 클러스터에서 클라우드 ID를 사용하는 경우 "AWS"로 설정합니다.

""

cloudIdentity

AKS 클러스터에서 클라우드 ID를 사용하는 경우 워크로드 ID("azure.workload.identity/client-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx")로 설정하십시오. EKS 클러스터에서 클라우드 ID를 사용하는 경우 AWS IAM 역할("eks.amazonaws.com/role-arn: arn:aws:iam::123456:role/trident-role")로 설정하십시오.

""

iscsiSelfHealingInterval

iSCSI 자체 복구가 호출되는 간격입니다.

5m0s

iscsiSelfHealingWaitTime

iSCSI 자체 복구 기능이 로그아웃 후 로그인을 수행하여 오래된 세션을 해결하려고 시도하는 기간입니다.

7m0s

nodePrep

Trident가 지정된 데이터 스토리지 프로토콜을 사용하여 볼륨을 관리하도록 Kubernetes 클러스터의 노드를 준비할 수 있습니다. 현재 `iscsi`만 지원됩니다. 참고: OpenShift 4.19부터 이 기능을 지원하는 최소 Trident 버전은 25.06.1입니다.

enableConcurrency

처리량 향상을 위해 동시 Trident 컨트롤러 작업을 지원합니다.

참고 Tech Preview: 이 기능은 실험적이며 현재 ONTAP-NAS(NFS만 해당) 및 ONTAP-SAN(통합 ONTAP 9용 NVMe) 드라이버를 사용한 제한된 병렬 워크플로를 지원하며, ONTAP-SAN 드라이버(통합 ONTAP 9의 iSCSI 및 FCP 프로토콜)에 대한 기존 Tech Preview도 지원합니다.

거짓

k8sAPIQPS

컨트롤러가 Kubernetes API 서버와 통신할 때 사용하는 초당 쿼리 수(QPS) 제한입니다. 버스트 값은 QPS 값을 기반으로 자동으로 설정됩니다.

100; 선택 사항

resources

Trident 컨트롤러, 노드 및 오퍼레이터 파드에 대한 Kubernetes 리소스 제한 및 요청을 설정합니다. 각 컨테이너 및 사이드카에 대한 CPU 및 메모리를 구성하여 Kubernetes에서 리소스 할당을 관리할 수 있습니다.

리소스 요청 및 제한 구성에 대한 자세한 내용은 "Pod 및 컨테이너에 대한 리소스 관리"을(를) 참조하십시오.

경고

  • 컨테이너 또는 필드의 이름을 변경하지 마십시오.

  • 들여쓰기를 변경하지 마십시오. YAML 들여쓰기는 올바른 구문 분석에 매우 중요합니다.
참고

  • 기본적으로 제한은 적용되지 않으며 요청에만 기본값이 있고 지정하지 않으면 자동으로 적용됩니다.

  • 컨테이너 이름은 Pod 사양에 나타난 대로 나열됩니다.

  • 사이드카는 각 메인 컨테이너 아래에 나열됩니다.

  • TORC status.CurrentInstallationParams 필드를 확인하여 현재 적용된 값을 확인하십시오.

 
resources:
  controller:
    trident-main:
      requests:
        cpu: 10m
        memory: 80Mi
      limits:
          cpu:
          memory:
    csi-provisioner:
      requests:
        cpu: 2m
        memory: 20Mi
      limits:
        cpu:
        memory:
    csi-attacher:
      requests:
        cpu: 2m
        memory: 20Mi
      limits:
        cpu:
        memory:
    csi-resizer:
      requests:
        cpu: 3m
        memory: 20Mi
      limits:
        cpu:
        memory:
    csi-snapshotter:
      requests:
        cpu: 2m
        memory: 20Mi
      limits:
        cpu:
        memory:
    trident-autosupport:
      requests:
        cpu: 1m
        memory: 30Mi
      limits:
        cpu:
        memory:
  node:
    linux:
      trident-main:
        requests:
          cpu: 10m
          memory: 60Mi
        limits:
          cpu:
          memory:
      node-driver-registrar:
        requests:
          cpu: 1m
          memory: 10Mi
        limits:
          cpu:
          memory:
    windows:
      trident-main:
        requests:
          cpu: 6m
          memory: 40Mi
        limits:
          cpu:
          memory:
      node-driver-registrar:
        requests:
          cpu: 6m
          memory: 40Mi
        limits:
          cpu:
          memory:
      liveness-probe:
        requests:
          cpu: 2m
          memory: 40Mi
        limits:
          cpu:
          memory:
  operator:
    requests:
      cpu: 10m
      memory: 40Mi
    limits:
      cpu:
      memory:

httpsMetrics

Prometheus 메트릭 엔드포인트에 대해 HTTPS를 활성화합니다.

거짓

hostNetwork

Trident 컨트롤러에 호스트 네트워킹을 활성화합니다. 이는 멀티홈 네트워크에서 프런트엔드와 백엔드 트래픽을 분리하려는 경우 유용합니다.

거짓

컨트롤러 Pod 및 노드 Pod 이해

Trident는 단일 컨트롤러 Pod와 클러스터의 각 작업자 노드에 있는 노드 Pod로 실행됩니다. 노드 Pod는 Trident 볼륨을 마운트하려는 모든 호스트에서 실행되어야 합니다.

Kubernetes "노드 선택기"와 "톨러레이션 및 테인트"는 특정 또는 선호하는 노드에서 실행되도록 Pod를 제약하는 데 사용됩니다. `ControllerPlugin`와 `NodePlugin`를 사용하여 제약 및 오버라이드를 지정할 수 있습니다.

  • 컨트롤러 플러그인은 스냅샷 및 크기 조정과 같은 볼륨 프로비저닝 및 관리를 처리합니다.

  • 노드 플러그인은 스토리지를 노드에 연결하는 작업을 처리합니다.