Google Cloud NetApp Volumes ONTAP 모드 스토리지 풀 구성
Trident 26.06 버전부터 기존 ontap-san 및 ontap-nas 백엔드를 구성하여 Google Cloud NetApp Volumes(GCNV) ONTAP 모드 스토리지 풀에 스토리지를 프로비저닝할 수 있습니다. 이 기능은 기술 미리 보기로 제공됩니다.
|
|
이 기능은 Trident 26.10의 기술 미리보기 기능입니다. 기술 미리보기 기능은 실제 운영 환경에서 사용할 수 없습니다. 기능, 구성 필드 및 지원 매트릭스는 정식 출시(GA) 전에 변경될 수 있습니다. |
작동 원리
Trident는 기존 ontap-san 및 ontap-nas 드라이버 로직을 재사용하고 ONTAP REST 호출을 GCNV 프록시 엔드포인트를 통해 라우팅합니다. 이 방식을 통해 GCNV에서 호스팅되는 ONTAP 클러스터의 스토리지를 프로비저닝하고 관리하는 동시에 직접 ONTAP 백엔드에 사용하는 것과 동일한 운영 워크플로를 유지할 수 있습니다. ONTAP 모드는 새로운 스토리지 드라이버를 도입하지 않습니다. gcnv 구성 블록을 ontap-san 또는 ontap-nas 백엔드에 추가하여 백엔드별로 활성화할 수 있습니다.
프로비저닝 경로는 다음과 같습니다.
PersistentVolumeClaim → Trident (ontap-san or ontap-nas) → ONTAP REST 클라이언트 → GCNV 프록시 → GCNV 풀의 ONTAP 클러스터
지원되는 범위 및 지원되지 않는 범위
이 기술 미리보기 버전은 다음을 지원합니다.
-
드라이버:
ontap-san(iSCSI) 및ontap-nas(NFS 또는 SMB). -
프록시를 통한 라이프사이클 작업: 백엔드 초기화, 볼륨 생성 및 삭제, 관련 ONTAP REST 흐름.
-
인증 모델: 워크로드 ID 풀(WIP), 서비스 계정 키 및 애플리케이션 기본 자격 증명(ADC) 대체 방식.
다음 사항은 이번 기술 미리보기의 범위에서 제외됩니다.
-
ontap-san-economy,ontap-nas-economy및ontap-nas-flexgroup드라이버. -
ASA r2 퍼스낼리티 경로.
-
ZAPI 대체 기능입니다. ONTAP 모드는 ONTAP REST만 사용합니다.
필수 구성 요소
ONTAP 모드 백엔드를 구성하기 전에 다음 사항을 확인하십시오.
-
Trident 26.06 이상 버전.
-
대상 프로젝트 및 위치에 GCNV ONTAP 모드 스토리지 풀이 있어야 합니다.
-
사용자 환경에 맞게 범위가 지정된 프록시 작업에 대한 GCP IAM 권한입니다.
-
proxyURL,projectNumber,location및 `poolID`를 포함하는 백엔드 구성입니다. -
iSCSI SAN 워크플로우의 경우, 플랫폼에 필요한 노드 측 iSCSI 및 다중 경로 필수 조건을 확인하십시오. "작업자 노드를 준비합니다"을 참조하십시오.
백엔드 구성
A TridentBackendConfig`는 Kubernetes Secret을 참조하기 위해 `credentials`를 필요로 합니다. ONTAP 모드의 경우, Secret은 ONTAP `managementLIF / username / `password`가 아닌 GCP 프록시 액세스에 대한 자격 증명을 제공합니다. 인증 방법에 따라 서비스 계정 키 필드를 포함하거나 비워둘 수 있습니다. `svm`는 선택 사항입니다. 현재 각 GCNV ONTAP 모드 풀에는 하나의 SVM이 있으며, 생략할 경우 Trident는 풀에서 이를 파생합니다.
서비스 계정 키 인증의 경우 네이티브 GCNV와 동일한 패턴을 사용하십시오. 비민감 필드는 gcnv.apiKey`에, `private_key 및 `private_key_id`는 시크릿에 포함합니다. "Google Cloud NetApp Volumes 구성 예시"을(를) 참조하십시오. 워크로드 ID 풀 또는 GKE 클라우드 ID 인증의 경우 인증의 예제를 참조하십시오.
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-san
namespace: trident
spec:
version: 1
storageDriverName: ontap-san
backendName: gcnv-ontap-san
credentials:
name: gcnv-sa-secret
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
svm: "<svm-name>"
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-nas
namespace: trident
spec:
version: 1
storageDriverName: ontap-nas
backendName: gcnv-ontap-nas
credentials:
name: gcnv-sa-secret
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
apiKey:
type: service_account
project_id: "<project-id>"
client_email: "<service-account-email>"
client_id: "<client-id>"
auth_uri: "https://accounts.google.com/o/oauth2/auth"
token_uri: "https://oauth2.googleapis.com/token"
auth_provider_x509_cert_url: "https://www.googleapis.com/oauth2/v1/certs"
client_x509_cert_url: "<client-x509-cert-url>"
svm: "<svm-name>"
apiVersion: v1
kind: Secret
metadata:
name: gcnv-sa-secret
namespace: trident
type: Opaque
stringData:
private_key_id: "<private-key-id>"
private_key: |
-----BEGIN PRIVATE KEY-----
<private-key>
-----END PRIVATE KEY-----
|
|
`TridentBackendConfig` 사양에 `private_key` 또는 `private_key_id`을 넣지 마십시오. CRD에서 이를 거부합니다. 블록 스토리지에는 동일한 `gcnv` 및 자격 증명 패턴을 가진 `ontap-san`을 사용하십시오. |
인증
Trident는 다음 순서로 프록시 액세스에 대한 자격 증명을 확인합니다:
-
워크로드 ID 풀(WIP)
-
서비스 계정 키
-
애플리케이션 기본 자격 증명(ADC)
이번 Tech Preview에서는 다음 사항을 준수하십시오:
-
가능한 경우 Workload Identity Pool을 우선적으로 사용하십시오.
-
버전 관리되는 백엔드 파일에 개인 키를 직접 포함시키지 마십시오. 자격 증명은 Kubernetes 시크릿에 저장하십시오.
-
서비스 계정에 최소 권한 IAM 스코프를 적용합니다.
`gcnv` 블록의 `location`은(는) 풀의 위치와 일치해야 합니다. 영역 풀에는 영역을, 지역 풀에는 지역을 사용하십시오.
워크로드 ID 풀
`gcnv.wipCredential`은(는) `TridentBackendConfig`에 구성된 명시적 외부 계정 페더레이션에 사용하십시오. OpenShift에서 Trident는 `/var/run/secrets/wif-token/token`에 토큰을 프로젝션합니다. 이는 Trident가 OpenShift WIF에 대해 프로젝션하는 유일한 토큰 경로이므로 `credential_source.file`에 사용하십시오. link:gcnv.html#openshift-wif["워크로드 ID 페더레이션을 사용하여 Google Cloud NetApp Volumes 구성"]에 설명된 대로 WIF 대상으로 Trident를 설치하십시오. `credentials` 필드는 여전히 Secret을 참조하지만, Secret에는 `private_key`이(가) 포함되어서는 안 됩니다.
apiVersion: v1
kind: Secret
metadata:
name: gcnv-ontap-empty
namespace: trident
type: Opaque
---
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-nas-wip
namespace: trident
spec:
version: 1
storageDriverName: ontap-nas
backendName: gcnv-ontap-nas-wip
useREST: true
nasType: nfs
nfsMountOptions: nfsvers=4.1
credentials:
name: gcnv-ontap-empty
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
wipCredential:
type: external_account
audience: "//iam.googleapis.com/projects/<wif-pool-project-number>/locations/global/workloadIdentityPools/<wif-pool-id>/providers/<provider-id>"
subject_token_type: "urn:ietf:params:oauth:token-type:jwt"
token_url: "https://sts.googleapis.com/v1/token"
service_account_impersonation_url: "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/<service-account-email>:generateAccessToken"
credential_source:
file: "/var/run/secrets/wif-token/token"
GKE 클라우드 ID
GKE의 경우, "GKE 워크로드 ID 사용"에 설명된 대로 설치 시 Trident의 클라우드 ID를 구성하십시오. 백엔드는 애플리케이션 기본 자격 증명(ADC)을 사용하므로, gcnv.apiKey 및 gcnv.wipCredential`를 모두 생략하십시오. `credentials 필드는 여전히 Secret을 참조하지만, 그 안에 `private_key`를 넣지 마십시오.
apiVersion: v1
kind: Secret
metadata:
name: gcnv-ontap-empty
namespace: trident
type: Opaque
---
apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
name: gcnv-ontap-nas-wi
namespace: trident
spec:
version: 1
storageDriverName: ontap-nas
backendName: gcnv-ontap-nas-wi
useREST: true
nasType: nfs
nfsMountOptions: nfsvers=4.1
credentials:
name: gcnv-ontap-empty
type: secret
gcnv:
proxyURL: "https://netapp.googleapis.com"
projectNumber: "<project-number>"
location: "<pool-location>"
poolID: "<pool-id>"
유효성 검사 및 초기화 동작
Trident는 초기화 중에 ONTAP 모드 백엔드를 검증하고 부분 초기화 대신 즉시 실패합니다.
필수 gcnv 필드가 누락되었거나, 드라이버가 ONTAP 모드에서 지원되지 않거나, 자격 증명 확인에 실패하면 백엔드 초기화가 실패합니다.
알려진 제한 사항
-
이 기능은 기술 미리보기 버전입니다. 정식 출시 전에 동작 방식 및 지원되는 매트릭스가 변경될 수 있습니다.
-
ONTAP 모드에서는 ZAPI 폴백이 사용되지 않습니다.
-
프로토콜 및 노드 준비 요구 사항은 여전히 적용됩니다. 예를 들어, iSCSI 워크플로에는 "작업자 노드를 준비합니다"에 설명된 노드 측 필수 조건이 필요합니다.
-
기존 ONTAP 및 GCNV 환경 제약 조건은 여전히 적용됩니다.
업그레이드 및 호환성
ONTAP 모드는 gcnv 구성 블록을 통해 백엔드별로 선택적으로 활성화할 수 있습니다:
-
기존의 GCNV 이외의 ONTAP 백엔드는 영향을 받지 않습니다.
-
직접 ONTAP 백엔드와 ONTAP 모드 프록시 백엔드를 결합한 혼합 배포는 백엔드 수준 구성을 통해 지원됩니다. 각 백엔드는 독립적으로 구성됩니다.
-
ONTAP 모드 사용을 중지하려면 해당 백엔드를 제거하거나 교체하십시오. 전역 스위치는 필요하지 않습니다.
다음 단계
TBC 전에 시크릿을 적용하십시오. 예시와 일치하도록 kubectl apply 및 `-n trident`를 사용하십시오.