Twórz i zarządzaj woluminami trwałymi (PVs) z wykorzystaniem Azure Blob Storage w usłudze Azure Kubernetes Service (AKS).

Jeśli wiele podów wymaga współbieżnego dostępu do tego samego woluminu magazynu, możesz użyć Azure Blob Storage do połączenia z systemem plików blobfuse lub sieciowym systemem plików (NFS).

W tym artykule pokazano, jak dynamicznie i statycznie tworzyć kontenery usługi Azure Blob Storage do użycia przez wiele zasobników w klastrze usługi Azure Kubernetes Service (AKS).

Wymagania wstępne

• Włączono sterownik CSI Azure Blob Storage w Twoim klastrze AKS.

• Konto magazynowe z włączonym systemem plików NFS w wersji 3, co pozwala na zamontowanie woluminu trwałego przy użyciu protokołu NFS. Nie można włączyć NFS v3 dla istniejącego konta magazynu. Aby uzyskać więcej informacji, zobacz Tworzenie konta NFS w wersji 3.

• Aby obsługiwać konto Azure Data Lake Storage podczas korzystania z instalacji blobfuse, wykonaj następujące zadania:

  • Aby utworzyć konto Data Lake Storage przy użyciu sterownika w dynamicznej aprowizacji, określ isHnsEnabled: "true" w parametrach klasy magazynu.
  • Aby włączyć dostęp blobfuse do konta Data Lake Storage w statycznej aprowizacji, określ opcję --use-adls=true instalacji w woluminie trwałym.
  • Jeśli zamierzasz włączyć konto magazynu z hierarchiczną przestrzenią nazw, istniejące woluminy trwałe powinny zostać ponownie zainstalowane z opcją --use-adls=true instalacji.

• Domyślnie pamięć podręczna blobfuse znajduje się w /mnt katalogu. Jeśli jednostka SKU maszyny wirtualnej udostępnia dysk tymczasowy, /mnt katalog jest instalowany na dysku tymczasowym. Jeśli jednak jednostka SKU maszyny wirtualnej nie oferuje dysku tymczasowego, katalog /mnt jest montowany na dysku systemu operacyjnego, możesz ustawić opcję montowania --tmp-path=, aby określić inny katalog pamięci podręcznej.

Użyj wbudowanych klas magazynowych do tworzenia dynamicznych dysków trwałych w usłudze Azure Blob Storage

Klasa magazynu służy do definiowania sposobu tworzenia kontenera usługi Azure Blob Storage. Konto magazynu jest tworzone automatycznie w grupie zasobów węzła do użycia z klasą magazynu do przechowywania kontenera usługi Azure Blob Storage. W przypadku stosowania sterowników CSI magazynu w usłudze AKS istnieją dwie dodatkowe wbudowane funkcjonalności korzystające ze sterownika CSI usługi Azure Blob Storage.

Zasady odzyskiwania w obu klasach pamięci masowej zapewniają, że podstawowy magazyn obiektów Blob w Azure zostanie usunięty, gdy odpowiedni PV zostanie usunięty. Klasy pamięci masowej konfigurują również kontener, aby można go było rozszerzać domyślnie, ponieważ set allowVolumeExpansion parametr ma wartość true.

Możesz wybrać jedną z następujących jednostek SKU nadmiarowości magazynu platformy Azure dla parametru skuname w definicji klasy magazynu:

• Standard_LRS: Standardowa lokalna nadmiarowość przechowywania
• Premium_LRS: magazyn lokalnie nadmiarowy w warstwie Premium
• Standard_ZRS: standardowa strefowa pamięć nadmiarowa
• Premium_ZRS: magazyn strefowo nadmiarowy w warstwie Premium
• Standard_GRS: Standardowa pamięć geograficznie z nadmiarową dostępnością
• Standard_RAGRS: magazyn geograficznie nadmiarowy z dostępem do odczytu w warstwie Standardowa

Tworzenie niestandardowych klas pamięci dla dynamicznych dysków wirtualnych za pomocą usługi Azure Blob Storage

Domyślne klasy magazynu są odpowiednie dla większości scenariuszy. W niektórych przypadkach możesz chcieć dostosować własną klasę przechowywania z własnymi parametrami. W tej sekcji przedstawiono dwa przykłady: jeden przy użyciu protokołu NFS i jeden przy użyciu systemu plików blobfuse.

Przykład niestandardowej klasy magazynu przy użyciu protokołu NFS

Manifest w tym przykładzie montuje kontener magazynu danych blob przy użyciu protokołu NFS. Można go użyć do dodania parametru tags .

1. Utwórz plik o nazwie blob-nfs-sc.yaml i wklej następujący przykładowy manifest:

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: blob-nfs
   provisioner: blob.csi.azure.com
   parameters:
     protocol: nfs
     tags: environment=Development
   volumeBindingMode: Immediate
   allowVolumeExpansion: true
   

2. Utwórz klasę magazynu przy użyciu kubectl apply polecenia :

   kubectl apply -f blob-nfs-sc.yaml
   

   Dane wyjściowe powinny przypominać następujące przykładowe dane wyjściowe:

   storageclass.storage.k8s.io/blob-nfs created
   

Przykład niestandardowej klasy przechowywania przy użyciu blobfuse

Manifest w tym przykładzie używa narzędzia blobfuse i instaluje kontener usługi Blob Storage. Można go użyć do zaktualizowania parametru skuName .

1. Utwórz plik o nazwie blobfuse-sc.yaml i wklej następujący przykładowy manifest:

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: blob-fuse
   provisioner: blob.csi.azure.com
   parameters:
     skuName: Standard_GRS  # available values: Standard_LRS, Premium_LRS, Standard_GRS, Standard_RAGRS
   reclaimPolicy: Delete
   volumeBindingMode: Immediate
   allowVolumeExpansion: true
   mountOptions:
     - -o allow_other
     - --file-cache-timeout-in-seconds=120
     - --use-attr-cache=true
     - --cancel-list-on-mount-seconds=10  # prevent billing charges on mounting
     - -o attr_timeout=120
     - -o entry_timeout=120
     - -o negative_timeout=120
     - --log-level=LOG_WARNING  # LOG_WARNING, LOG_INFO, LOG_DEBUG
     - --cache-size-mb=1000  # Default will be 80% of available memory, eviction will happen beyond that.
   

2. Utwórz klasę magazynu przy użyciu kubectl apply polecenia :

   kubectl apply -f blobfuse-sc.yaml
   

   Dane wyjściowe powinny przypominać następujące przykładowe dane wyjściowe:

   storageclass.storage.k8s.io/blob-fuse created
   

Parametry klasy magazynu dla dynamicznych telewizorów z usługą Azure Blob Storage

Użyj następujących grup parametrów, aby zdefiniować niestandardową klasę magazynu dla oświadczeń trwałych woluminów (PVC) za pomocą usługi Azure Blob Storage:

• Konto magazynu: skuName, locationsubscriptionIDnetworkEndpointTypeaccessTierallowBlobPublicAccessstorageAccountresourceGrouprequireInfraEncryptionpublicNetworkAccessallowSharedKeyAccesstagsi .matchTags
• Kontener i punkt końcowy: protocol, , serveruseDataPlaneAPIcontainerNamestorageEndpointSuffixsoftDeleteBlobscontainerNamePrefixsoftDeleteContainers, i .enableBlobVersioning
• BlobFuse: storeAccountKey, , secretNamegetLatestAccountKey, secretNamespacei isHnsEnabled.
• NFS: mountPermissions i fsGroupChangePolicy.
• Sieć wirtualna: vnetResourceGroup, , vnetNamesubnetNamei vnetLinkName.

Konfigurowanie parametrów konta magazynu dla dynamicznych telewizorów z usługą Azure Blob Storage

Użyj następujących parametrów, aby skonfigurować konto magazynu Azure dla dynamicznie aprowizowania pv:

Konfigurowanie parametrów kontenera i punktu końcowego dla dynamicznych telewizorów przy użyciu usługi Azure Blob Storage

Użyj następujących parametrów, aby skonfigurować kontener, protokół instalacji, punkt końcowy magazynu i tagi dynamicznie aprowizowania pv:

Konfigurowanie parametrów blobFuse dla dynamicznych telewizorów przy użyciu usługi Azure Blob Storage

Następujące parametry mają zastosowanie tylko wtedy, gdy używasz obiektu BlobFuse dla dynamicznie aprowizowania pv:

Konfigurowanie parametrów systemu plików NFS dla dynamicznych telewizorów przy użyciu usługi Azure Blob Storage

Następujący parametr ma zastosowanie tylko w przypadku korzystania z systemu plików NFS dla dynamicznie aprowizowanej sieci PV:

Konfigurowanie parametrów sieci wirtualnej dla dynamicznych woluminów wirtualnych przy użyciu usługi Azure Blob Storage

Użyj następujących parametrów, gdy sterownik konfiguruje dostęp do sieci wirtualnej dla dynamicznie aprowizowanej sieci PV:

Konfigurowanie prywatnych punktów końcowych dla dynamicznych telewizorów z usługą Azure Blob Storage

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: blob-fuse
provisioner: blob.csi.azure.com
parameters:
  skuName: Premium_LRS  # available values: Standard_LRS, Premium_LRS, Standard_GRS, Standard_RAGRS, Standard_ZRS, Premium_ZRS
  protocol: fuse2
  networkEndpointType: privateEndpoint
reclaimPolicy: Delete
volumeBindingMode: Immediate
allowVolumeExpansion: true
mountOptions:
  - -o allow_other
  - --file-cache-timeout-in-seconds=120
  - --use-attr-cache=true
  - --cancel-list-on-mount-seconds=10  # prevent billing charges on mounting
  - -o attr_timeout=120
  - -o entry_timeout=120
  - -o negative_timeout=120
  - --log-level=LOG_WARNING  # LOG_WARNING, LOG_INFO, LOG_DEBUG
  - --cache-size-mb=1000  # Default will be 80% of available memory, eviction will happen beyond that.

Tworzenie pcV na potrzeby dynamicznej aprowizacji

Element PVC używa obiektu klasy magazynu do dynamicznego aprowizowania usługi Azure Blob Storage. W tej sekcji możesz użyć przykładowego manifestu YAML, aby utworzyć plik PVC o rozmiarze 5 GB z dostępem ReadWriteMany . Aby uzyskać więcej informacji na temat trybów dostępu, zobacz Tryby dostępu PV w Kubernetes.

1. Utwórz plik o nazwie blob-nfs-pvc.yaml i wklej następujący manifest YAML:

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: azure-blob-storage
   spec:
     accessModes:
     - ReadWriteMany
     storageClassName: azureblob-nfs-premium
     resources:
       requests:
         storage: 5Gi
   

2. Utwórz PVC przy użyciu polecenia kubectl create:

   kubectl create -f blob-nfs-pvc.yaml
   

3. Wyświetl stan PVC poleceniem kubectl get.

   kubectl get pvc azure-blob-storage
   

   Twoje dane wyjściowe powinny przypominać następujące przykładowe dane wyjściowe, które pokazują, że PVC jest w stanie Bound:

   NAME                 STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS                AGE
   azure-blob-storage   Bound    pvc-aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb   5Gi        RWX            azureblob-nfs-premium       92m
   

Instalowanie dynamicznie aprowizowanego woluminu magazynu obiektów blob w zasobniku

Poniższy kod YAML tworzy zasobnik, który używa żądania trwałego wolumenu azure-blob-storage do zamontowania usługi Azure Blob Storage w ścieżce /mnt/blob.

1. Utwórz plik o nazwie blob-nfs-pv i wklej następujący manifest YAML. Upewnij się, że element jest zgodny z claimName utworzonym wcześniej elementem PVC (azure-blob-storage).

   kind: Pod
   apiVersion: v1
   metadata:
     name: mypod
   spec:
     containers:
     - name: mypod
       image: mcr.microsoft.com/oss/nginx/nginx:1.17.3-alpine
       resources:
         requests:
           cpu: 100m
           memory: 128Mi
         limits:
           cpu: 250m
           memory: 256Mi
       volumeMounts:
       - mountPath: "/mnt/blob"
         name: volume
         readOnly: false
     volumes:
       - name: volume
         persistentVolumeClaim:
           claimName: azure-blob-storage
   

2. Utwórz zasobnik za pomocą polecenia kubectl apply

   kubectl apply -f blob-nfs-pv.yaml
   

3. Po pomyślnym uruchomieniu zasobnika utwórz nowy plik o nazwie test.txt przy użyciu następującego polecenia:

   kubectl exec mypod -- touch /mnt/blob/test.txt
   

4. Sprawdź, czy dysk jest poprawnie zainstalowany przy użyciu następującego polecenia, aby wyświetlić listę plików w zainstalowanym katalogu:

   kubectl exec mypod -- ls /mnt/blob
   

   Twoje dane wyjściowe powinny przypominać następujący przykład, który pokazuje plik test.txt utworzony w zamontowanym magazynie obiektów blob Azure.

   test.txt
   

Używanie zestawu statefulSet do zarządzania cyklem życia woluminu za pomocą usługi Azure Blob Storage

Aby zapewnić utrzymanie wolumenu danych dla obciążenia, możesz użyć elementu StatefulSet. Ten stan ułatwia dopasowanie istniejących woluminów do nowych zasobników, które zastępują te, które uległy awarii. W poniższych przykładach pokazano, jak skonfigurować element StatefulSet dla usługi Blob Storage przy użyciu protokołu NFS lub systemu Blobfuse.

Tworzenie statycznego pv za pomocą usługi Azure Blob Storage

W poniższych sekcjach znajdziesz instrukcje dotyczące tworzenia statycznego PV w usłudze magazynowej Azure Blob Storage. Statyczny pv jest woluminem trwałym tworzonym ręcznie przez administratora. Ten serwer PV jest dostępny do użycia przez zasobniki w klastrze. Aby użyć statycznego PV, należy utworzyć PVC, który odwołuje się do PV, a następnie utworzyć pod odwołujący się do PVC.

Parametry woluminu CSI dla statycznych woluminów publicznych z usługą Azure Blob Storage

W poniższej tabeli wymieniono parametry, których można użyć w źródle woluminu CSI dla statycznego pv z usługą Azure Blob Storage:

Utwórz kontener przechowywania Blob

Podczas tworzenia zasobu usługi Azure Blob Storage do użycia z usługą AKS można utworzyć zasób w grupie zasobów węzła. Takie podejście umożliwia klastrowi usługi AKS uzyskiwanie dostępu do zasobu magazynu obiektów Blob i zarządzanie tym zasobem.

1. Pobierz nazwę grupy zasobów węzła klastra usługi AKS przy użyciu polecenia az aks show z parametrem --query nodeResourceGroup.

   az aks show --resource-group myResourceGroup --name myAKSCluster --query nodeResourceGroup -o tsv
   

   Dane wyjściowe polecenia przypominają następujący przykład:

   MC_myResourceGroup_myAKSCluster_eastus
   

2. Jeśli utworzysz konto magazynu w grupie zasobów węzła, użyj nazwy grupy zasobów węzła zwróconej w poprzednim kroku (na przykład MC_myResourceGroup_myAKSCluster_eastus). Następnie wykonaj kroki opisane w temacie Zarządzanie magazynem obiektów blob , aby autoryzować dostęp i utworzyć kontener na tym koncie magazynu.

Montaż woluminu

W tej sekcji zainstalujesz wolumin trwały przy użyciu protokołu NFS lub Blobfuse.

Użyj woluminu trwałego

Poniższy kod YAML tworzy zasobnik, który używa obiektu PV lub PVC o nazwie pvc-blob utworzonego wcześniej w celu zainstalowania magazynu obiektów blob platformy Azure w ścieżce /mnt/blob .

1. Utwórz plik o nazwie nginx-pod-blob.yaml i wklej następujący manifest YAML. Upewnij się, że element jest zgodny z claimName utworzonym wcześniej elementem PVC (pvc-blob).

   kind: Pod
   apiVersion: v1
   metadata:
     name: nginx-blob
   spec:
     nodeSelector:
       "kubernetes.io/os": linux
     containers:
       - image: mcr.microsoft.com/oss/nginx/nginx:1.17.3-alpine
         name: nginx-blob
         volumeMounts:
           - name: blob01
             mountPath: "/mnt/blob"
             readOnly: false
     volumes:
       - name: blob01
         persistentVolumeClaim:
           claimName: pvc-blob
   

2. Utwórz zasobnik i zamontuj PVC przy użyciu polecenia kubectl create:

   kubectl create -f nginx-pod-blob.yaml
   

3. Utwórz interaktywną sesję powłoki z zasobnikiem przy użyciu następującego kubectl exec polecenia, aby sprawdzić, czy Blob Storage jest poprawnie zamontowana.

   kubectl exec -it nginx-blob -- df -h
   

   Dane wyjściowe powinny przypominać następujące przykładowe dane wyjściowe, które pokazują, że usługa Blob Storage jest instalowana w ścieżce /mnt/blob :

   Filesystem      Size  Used Avail Use% Mounted on
   ...
   blobfuse         14G   41M   13G   1% /mnt/blob
   ...
   

Treści powiązane

• Używanie tagów platformy Azure w usłudze Azure Kubernetes Service (AKS)
• Znane problemy z obsługą protokołu sieciowego systemu plików (NFS) 3.0 dla usługi Azure Blob Storage