6.11. Azure 파일 CSI 드라이버 운영자

1. 다음 적용 가능한 명령을 실행하여 Azure ID(서비스 주체 또는 관리 ID)를 기록합니다. Azure ID는 이후 단계에서 필요합니다.

   • 클러스터를 설치할 때 서비스 주체 를 Azure ID로 사용하는 경우:

     $ sp_id=$(oc -n openshift-cluster-csi-drivers get secret azure-file-credentials -o jsonpath='{.data.azure_client_id}' | base64 --decode)
     
     $ az ad sp show --id ${sp_id} --query displayName --output tsv

     Copy to Clipboard Toggle word wrap

   • 클러스터를 설치할 때 관리 ID를 Azure ID로 사용하는 경우:

     $ mi_id=$(oc -n openshift-cluster-csi-drivers get secret azure-file-credentials -o jsonpath='{.data.azure_client_id}' | base64 --decode)
     
     $ az identity list --query "[?clientId=='${mi_id}'].{Name:name}" --output tsv

     Copy to Clipboard Toggle word wrap

2. 다음 중 하나를 수행하여 Azure 파일 공유를 프로비저닝하려는 다른 구독 B의 리소스 그룹에 액세스할 수 있는 권한을 Azure ID(서비스 주체 또는 관리 ID)에 부여합니다.

   • 다음 Azure CLI 명령을 실행합니다.

     az role assignment create \
       --assignee <object-id-or-app-id> \
       --role <role-name> \
       --scope /subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>

     Copy to Clipboard Toggle word wrap

     다음과 같습니다.

     <object-id-or-app-id> : 이전 단계에서 얻은 서비스 주체 또는 관리 ID(예: sp_id 또는 mi_id) 입니다.

     <역할 이름> : 역할 이름. 기여자 또는 필요한 권한이 있는 본인의 역할.

     <subscription-id> : 구독 B ID.

     <리소스 그룹 이름> : 구독 B 리소스 그룹 이름입니다.

     또는

   • Azure Portal에 로그인하고 왼쪽 메뉴에서 리소스 그룹을 클릭합니다.

     1. 구독 B에서 역할을 할당하려는 리소스 그룹을 선택합니다 . 리소스 그룹 액세스 제어(IAM) 역할 할당 탭을 클릭하여 현재 할당을 확인한 다음 추가 > 역할 할당 추가를 클릭합니다.
     2. 역할 탭에서 할당할 기여자 역할을 선택한 후 다음을 클릭합니다. 필요한 권한을 부여받아 자신의 역할을 만들고 선택할 수도 있습니다.

     3. 회원 탭에서:

        1. 사용자, 그룹 또는 서비스 주체(또는 관리 ID) 등 담당자 유형을 선택하여 담당자를 선택합니다.
        2. 회원 선택을 클릭하세요.
        3. 이전 단계에서 기록한 원하는 서비스 주체 또는 관리 ID를 검색하여 선택합니다.
        4. 선택을 클릭하여 확인하세요.
     4. 검토 + 할당 탭에서 설정을 검토합니다.

     5. 역할 할당을 완료하려면 검토 + 할당을 클릭하세요.

        참고

        Azure 파일 공유를 프로비저닝하는 데 특정 스토리지 계정만 사용하려는 경우 비슷한 단계를 사용하여 스토리지 계정에 액세스하기 위한 Azure ID(서비스 주체 또는 관리 ID) 권한을 얻을 수도 있습니다.

3. 다음과 유사한 구성을 사용하여 Azure 파일 저장소 클래스를 만듭니다.

   Azure 파일 저장소 클래스 YAML 파일 예제

   allowVolumeExpansion: true
   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: <sc-name> 

   1

   
   mount options:
     - mfsymlinks
     - cache=strict
     - nosharesock
     - actimeo=30
   parameters:
     subscriptionID: <xxxx-xxxx-xxxx-xxxx-xxxx> 

   2

   
     resourceGroup: <resource group name> 

   3

   
     storageAccount: <storage account> 

   4

   
     skuName: <skuName> 

   5

   
   provisioner: file.csi.azure.com
   reclaimPolicy: Delete
   volumeBindingMode: Immediate

   Copy to Clipboard Toggle word wrap

   1

   저장 클래스의 이름

   2

   구독 B ID

   3

   구독 B 리소스 그룹 이름

   4

   저장 계정 이름(사용자가 직접 지정하려는 경우)

   5

   SKU 유형의 이름

4. 다음과 유사한 구성을 사용하여 이전 단계에서 만든 Azure 파일 저장소 클래스를 지정하는 영구적 볼륨 클레임(PVC)을 만듭니다.

   PVC YAML 파일 예시

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: <pvc-name> 

   1

   
   spec:
     storageClassName: <sc-name-cross-sub> 

   2

   
     accessModes:
       - ReadWriteMany
     resources:
       requests:
         storage: 5Gi

   Copy to Clipboard Toggle word wrap

   1

   PVC의 이름.

   2

   이전 단계에서 만든 스토리지 클래스의 이름입니다.

프로세스

1. Azure 파일 공유의 경우 리소스 그룹, 스토리지 계정, 스토리지 계정 키 및 Azure 파일 이름을 기록합니다. 이러한 값은 다음 단계에 사용됩니다.

2. 다음 명령을 실행하여 영구 볼륨 매개변수 spec.csi.nodeStageSecretRef.name 에 대한 비밀을 만듭니다.

   $ oc create secret generic azure-storage-account-<storageaccount-name>-secret --from-literal=azurestorageaccountname="<azure-storage-account-name>" --from-literal azurestorageaccountkey="<azure-storage-account-key>" --type=Opaque

   Copy to Clipboard Toggle word wrap

   여기서: <azure-storage-account-name> 과 <azure-storage-account-key> 는 각각 1단계에서 기록한 Azure Storage 계정 이름과 키입니다.

3. 다음 예제 파일과 유사한 구성을 사용하여 영구 볼륨(PV)을 만듭니다.

   PV YAML 파일 예시

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     annotations:
       pv.kubernetes.io/provisioned-by: file.csi.azure.com
     name: <pv-name> 

   1

   
   spec:
     capacity:
       storage: 10Gi 

   2

   
     accessModes:
       - ReadWriteMany
     persistentVolumeReclaimPolicy: Retain
     storageClassName: <sc-name> 

   3

   
     mountOptions:
       - cache=strict
       - nosharesock
       - actimeo=30
       - nobrl
     csi:
       driver: file.csi.azure.com
       volumeHandle: "{resource-group-name}#{storage-account-name}#{file-share-name}" 

   4

   
       volumeAttributes:
         shareName: <existing-file-share-name> 

   5

   
       nodeStageSecretRef:
         name: <secret-name>  

   6

   
         namespace: <secret-namespace>  

   7

   Copy to Clipboard Toggle word wrap

   1

   PV의 이름입니다.

   2

   PV의 크기입니다.

   3

   저장 클래스 이름.

   4

   클러스터의 모든 동일한 공유에 대해 volumeHandle 이 고유한지 확인하세요.

   5

   `<기존 파일 공유 이름>'에는 전체 경로가 아닌 파일 공유 이름만 사용하세요.

   6

   이전 단계에서 생성된 비밀 이름입니다.

   7

   비밀이 있는 네임스페이스입니다.

4. 1단계에서 참조한 기존 Azure 파일 공유를 지정하는 영구적 값 클레임(PVC)을 다음과 유사한 구성을 사용하여 만듭니다.

   PVC YAML 파일 예시

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: <pvc-name> 

   1

   
   spec:
     storageClassName: <sc-name> 

   2

   
     accessModes:
       - ReadWriteMany
     resources:
       requests:
         storage: 5Gi

   Copy to Clipboard Toggle word wrap

   1

   PVC의 이름.

   2

   이전 단계에서 PV에 대해 지정한 스토리지 클래스의 이름입니다.