Share via

Kötet létrehozása és használata Az Azure Blob Storage használatával az Azure Kubernetes Service-ben (AKS)

  • Cikk

A tárolóalapú alkalmazásoknak gyakran külső adatkötetben kell hozzáférnie és meg kell őriznie az adatokat. Ha több podnak egyidejű hozzáférésre van szüksége ugyanahhoz a tárkötethez, az Azure Blob Storage használatával blobfuse vagy hálózati fájlrendszer (NFS) használatával csatlakozhat.

Ez a cikk bemutatja, hogyan:

  • Dinamikus állandó kötet (PV) használata a Container Storage Interface (CSI) illesztő telepítésével, valamint egy Azure Blob Storage-tároló dinamikus létrehozásával a podhoz való csatoláshoz.
  • Statikus PV-vel dolgozhat egy Azure Blob Storage-tároló létrehozásával, vagy használhat egy meglévőt, és csatolhatja egy podhoz.

A Kubernetes-kötetekkel kapcsolatos további információkért tekintse meg az AKS-alkalmazások tárolási lehetőségeit.

Mielőtt elkezdené

  • Engedélyezze a Blob Storage CSI-illesztőprogramot az AKS-fürtön.

  • Ha egy Azure DataLake Gen2-tárfiókot szeretne támogatni a blobfuse csatlakoztatásakor, a következőket kell tennie:

    • Ha ADLS-fiókot szeretne létrehozni az illesztővel a dinamikus kiépítésben, adja meg isHnsEnabled: "true" a tárolási osztály paramétereit.
    • Ha engedélyezni szeretné a blobfuse hozzáférést egy ADLS-fiókhoz a statikus kiépítés során, adja meg a csatlakoztatási lehetőséget --use-adls=true az állandó kötetben.
    • Ha hierarchikus névtérrel rendelkező tárfiókot szeretne engedélyezni, a meglévő állandó köteteket csatlakoztatási beállítással --use-adls=true kell újra csatlakoztatni.

  • Tudnivalók a blobfuse-gyorsítótárról

    • Alapértelmezés szerint a blobfüzérek gyorsítótára a /mnt könyvtárban található. Ha a virtuálisgép-termékváltozat ideiglenes lemezt biztosít, a /mnt címtár az ideiglenes lemezre van csatlakoztatva. Ha azonban a virtuálisgép-termékváltozat nem biztosít ideiglenes lemezt, a /mnt könyvtár az operációsrendszer-lemezre van csatlakoztatva, beállíthatja --tmp-path= a csatlakoztatási beállítást egy másik gyorsítótárkönyvtár megadásához

Kötet dinamikus kiépítése

Ez a szakasz útmutatást nyújt a fürt rendszergazdáinak, akik egy vagy több állandó kötetet szeretnének kiépíteni, amelyek tartalmazzák a Blob Storage részleteit a számítási feladat számára. Egy állandó mennyiségi jogcím (PVC) a tárolási osztály objektumával dinamikusan kiépíteni egy Azure Blob Storage-tárolót.

Tárolási osztály paraméterei dinamikus állandó kötetekhez

Az alábbi táblázat olyan paramétereket tartalmaz, amelyekkel egyéni tárosztályt határozhat meg az állandó kötet jogcíméhez.

Név Leírás Példa Kötelező Alapértelmezett érték
skuName Adjon meg egy Azure Storage-fióktípust (alias: storageAccountType). Standard_LRS, Premium_LRS, Standard_GRSStandard_RAGRS Nem Standard_LRS
hely Adjon meg egy Azure-helyet. eastus Nem Ha üres, az illesztőprogram ugyanazt a helynevet fogja használni, mint az aktuális fürt.
resourceGroup Adjon meg egy Azure-erőforráscsoportnevet. myResourceGroup Nem Ha üres, az illesztőprogram ugyanazt az erőforráscsoportnevet fogja használni, mint az aktuális fürt.
storageAccount Adjon meg egy Azure Storage-fióknevet. storageAccountName - Nem blobfuse csatlakoztatáshoz
– Igen az NFSv3 csatlakoztatáshoz.		 - Blobfuse csatlakoztatás esetén: ha üres, az illesztőprogram talál egy megfelelő tárfiókot, amely ugyanabban az erőforráscsoportban egyezik skuName . Ha a tárfiók neve meg van adva, a tárfióknak léteznie kell.
- NFSv3 csatlakoztatás esetén meg kell adni a tárfiók nevét.
networkEndpointType Adja meg az illesztőprogram által létrehozott tárfiók hálózati végponttípusát. Ha a privateEndpoint meg van adva, a tárfiókhoz létrejön egy privát végpont . Más esetekben létrejön egy szolgáltatásvégpont az NFS-protokollhoz.1 privateEndpoint Nem AKS-fürt esetén adja hozzá az AKS-fürt nevét a VNET-et üzemeltető erőforráscsoport közreműködői szerepköréhez.
Protokoll Blobfuse-csatlakoztatás vagy NFSv3-csatlakoztatás megadása. fuse, nfs Nem fuse
containerName Adja meg a meglévő tároló (könyvtár) nevét. tároló Nem Ha üres, az illesztőprogram létrehoz egy új tárolónevet, kezdve a blobfuse vagy pvc-nfs az NFS v3 fájllalpvc-fuse.
containerNamePrefix Adja meg az illesztőprogram által létrehozott Azure Storage-címtár-előtagot. saját Csak kisbetűket, számokat, kötőjeleket és hosszokat tartalmazhat, legfeljebb 21 karakter hosszúságú lehet. Nem
kiszolgáló Adja meg az Azure Storage-fiók tartománynevét. Meglévő tárfiók DNS-tartományneve, például <storage-account>.privatelink.blob.core.windows.net. Nem Ha üres, az illesztőprogram alapértelmezett <storage-account>.blob.core.windows.net vagy más szuverén felhőbeli tárfiók DNS-tartománynevét használja.
allowBlobPublicAccess Az illesztőprogram által létrehozott tárfiók összes blobjának vagy tárolójának nyilvános hozzáférésének engedélyezése vagy letiltása. true,false Nem false
storageEndpointSuffix Adja meg az Azure Storage-végpont utótagját. core.windows.net Nem Ha üres, az illesztőprogram az alapértelmezett tárolási végpont utótagját fogja használni a felhőkörnyezetnek megfelelően.
címkét A címkék új tárfiókban lesznek létrehozva. Címkeformátum: 'foo=aaa,bar=bbb' Nem ""
egyezéscímkék A címkék egyezése, amikor az illesztőprogram megfelelő tárfiókot próbál megtalálni. true,false Nem false
--- A következő paraméterek csak a blobfuse-hoz tartoznak --- --- ---
subscriptionID Adja meg az Azure-előfizetés azonosítóját, ahol létrejön a Blob Storage-címtár. Azure-előfizetés azonosítója Nem Ha nem üres, resourceGroup meg kell adni.
storeAccountKey Adja meg a Kubernetes titkos kulcsához tartozó tárfiókkulcsot.

Megjegyzés:
false azt jelenti, hogy az illesztőprogram kubelet-identitást használ a fiókkulcs lekéréséhez.		 true,false Nem true
secretName Adja meg a fiókkulcs tárolásához használt titkos nevet. Nem
secretNamespace Adja meg a fiókkulcs tárolására használt titkos kód névterét. defaultstbkube-system. Nem pvc névtér
isHnsEnabled Azure Data Lake Storage-fiók engedélyezése Hierarchical namespace . true,false Nem false
--- A következő paraméterek csak az NFS protokollhoz tartoznak --- --- ---
mountPermissions A csatlakoztatott mappák engedélyeinek megadása. Az alapértelmezett érték 0777. Ha be van állítva, az 0illesztő nem fog teljesíteni chmod a csatlakoztatás után. 0777 Nem

1 Ha a tárfiókot az illesztőprogram hozza létre, akkor csak a tárolási osztály paraméterét kell megadnia networkEndpointType: privateEndpoint . A CSI-illesztő létrehozza a privát végpontot a fiókkal együtt. Ha saját tárfiókot hoz létre, létre kell hoznia a tárfiók privát végpontját .

Állandó mennyiségi jogcím létrehozása beépített tárolási osztály használatával

Egy állandó mennyiségi jogcím (PVC) a tárolási osztály objektumával dinamikusan kiépíteni egy Azure Blob Storage-tárolót. Az alábbi YAML használatával létrehozhat egy 5 GB méretű állandó kötetigénylést ReadWriteMany-hozzáféréssel a beépített tárolási osztály használatával. A hozzáférési módokkal kapcsolatos további információkért tekintse meg a Kubernetes állandó köteteinek dokumentációját.

  1. Hozzon létre egy fájlt, blob-nfs-pvc.yaml és másolja a következő YAML-fájlba.

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

  2. Hozza létre az állandó kötet jogcímét a kubectl create paranccsal:

    kubectl create -f blob-nfs-pvc.yaml

Miután elkészült, létrejön a Blob Storage-tároló. A PVC állapotának megtekintéséhez használja a kubectl get parancsot:

kubectl get pvc azure-blob-storage

A parancs kimenete a következő példához hasonlít:

NAME                 STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS                AGE
azure-blob-storage   Bound    pvc-b88e36c5-c518-4d38-a5ee-337a7dda0a68   5Gi        RWX            azureblob-nfs-premium       92m

Az állandó kötet jogcímének használata

Az alábbi YAML létrehoz egy podot, amely az azure-blob-storage állandó mennyiségi jogcímet használja az Azure Blob Storage csatlakoztatásához az "/mnt/blob" útvonalon.

  1. Hozzon létre egy fájlt, blob-nfs-pvés másolja a következő YAML-be. Győződjön meg arról, hogy a jogcímnév megegyezik az előző lépésben létrehozott PVC-vel .

    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. Hozza létre a podot a kubectl apply paranccsal:

    kubectl apply -f blob-nfs-pv.yaml

  3. Miután a pod futó állapotban van, futtassa a következő parancsot egy új, úgynevezett test.txtfájl létrehozásához.

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

  4. A lemez megfelelő csatlakoztatásának ellenőrzéséhez futtassa a következő parancsot, és ellenőrizze, hogy a fájl megjelenik-e test.txt a kimenetben:

    kubectl exec mypod -- ls /mnt/blob

    A parancs kimenete a következő példához hasonlít:

    test.txt

Egyéni tárosztály létrehozása

Az alapértelmezett tárolási osztályok megfelelnek a leggyakoribb forgatókönyveknek, de nem mindegyiknek. Bizonyos esetekben előfordulhat, hogy saját tárolóosztályt szeretne testreszabni a saját paramétereivel. Ebben a szakaszban két példát mutatunk be. Az első az NFS protokollt, a második pedig blobfüzért használ.

Tárolási osztály NFS protokoll használatával

Ebben a példában az alábbi jegyzék egy Blob Storage-tároló csatlakoztatását konfigurálja az NFS protokoll használatával. A címkeparaméter hozzáadásához használja.

  1. Hozzon létre egy nevű blob-nfs-sc.yamlfájlt, és illessze be a következő példajegyzéket:

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

  2. Hozza létre a tárosztályt a kubectl apply paranccsal:

    kubectl apply -f blob-nfs-sc.yaml

    A parancs kimenete a következő példához hasonlít:

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

Tárolási osztály blobfuse használatával

Ebben a példában a következő jegyzék blobtároló használatával konfigurál, és csatlakoztat egy Blob Storage-tárolót. Ezzel frissítheti az skuName paramétert.

  1. Hozzon létre egy nevű blobfuse-sc.yamlfájlt, és illessze be a következő példajegyzéket:

    apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: azureblob-fuse-premium
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. Hozza létre a tárosztályt a kubectl apply paranccsal:

    kubectl apply -f blobfuse-sc.yaml

    A parancs kimenete a következő példához hasonlít:

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

Kötet statikus kiépítése

Ez a szakasz útmutatást nyújt azoknak a fürtgazdáknak, akik egy vagy több állandó kötetet szeretnének létrehozni, amelyek tartalmazzák a Blob Storage részleteit a számítási feladat számára.

Statikus kiépítési paraméterek állandó kötetekhez

Az alábbi táblázat olyan paramétereket tartalmaz, amelyekkel állandó kötetet definiálhat.

Név Leírás Példa Kötelező Alapértelmezett érték
volumeHandle Adja meg azt az értéket, amellyel az illesztőprogram egyedileg azonosíthatja a fürtön található tárolót. Az egyedi érték előállításának ajánlott módja a globálisan egyedi tárfiók neve és a tároló neve: {account-name}_{container-name}.
Megjegyzés: A #, / karakter belső használatra van fenntartva, és nem használható kötetfogantyúkban.		 Igen
volumeAttributes.resourceGroup Adja meg az Azure-erőforráscsoport nevét. myResourceGroup Nem Ha üres, az illesztőprogram ugyanazt az erőforráscsoportnevet használja, mint az aktuális fürt.
volumeAttributes.storageAccount Adjon meg egy meglévő Azure Storage-fióknevet. storageAccountName Igen
volumeAttributes.containerName Adja meg a meglévő tárolónevet. tároló Igen
volumeAttributes.protocol Blobfuse-csatlakoztatás vagy NFS v3-csatlakoztatás megadása. fuse, nfs Nem fuse
--- A következő paraméterek csak a blobfuse-hoz tartoznak --- --- ---
volumeAttributes.secretName A tárfiók nevét és kulcsát tároló titkos név (csak az SMB-hez érvényes). Nem
volumeAttributes.secretNamespace Adja meg a titkos kód névterét a fiókkulcs tárolásához. default Nem Pvc-névtér
nodeStageSecretRef.name Adja meg a titkos kód nevét, amely az alábbiak egyikét tárolja:
azurestorageaccountkey
azurestorageaccountsastoken
msisecret
azurestoragespnclientsecret.		 Nem Meglévő Kubernetes-titkos név
nodeStageSecretRef.namespace Adja meg a titkos kód névterét. Kubernetes-névtér Igen
--- A következő paraméterek csak az NFS protokollhoz tartoznak --- --- ---
volumeAttributes.mountPermissions A csatlakoztatott mappák engedélyeinek megadása. 0777 Nem
--- A következő paraméterek csak az NFS virtuális hálózat beállításához szükségesek --- --- ---
vnetResourceGroup Adja meg a virtuális hálózatot üzemeltető virtuális hálózati erőforráscsoportot. myResourceGroup Nem Ha üres, az illesztőprogram az vnetResourceGroup Azure cloud config fájlban megadott értéket használja.
vnetName Adja meg a virtuális hálózat nevét. aksVNet Nem Ha üres, az illesztőprogram az vnetName Azure cloud config fájlban megadott értéket használja.
alhálózatnév Adja meg az ügynökcsomópont meglévő alhálózati nevét. aksSubnet Nem Ha üres, az illesztőprogram az subnetName Azure cloud config fájlban lévő értéket használja.
--- A következő paraméterek csak a funkcióhoz tartoznak: blobfuse
Felügyelt identitás és szolgáltatásnév hitelesítése		 --- --- ---
volumeAttributes.AzureStorageAuthType Adja meg a hitelesítési típust. Key, SAS, MSISPN Nem Key
volumeAttributes.AzureStorageIdentityClientID Adja meg az identitásügyfél azonosítóját. Nem
volumeAttributes.AzureStorageIdentityObjectID Adja meg az identitásobjektum azonosítóját. Nem
volumeAttributes.AzureStorageIdentityResourceID Adja meg az identitás erőforrás-azonosítóját. Nem
volumeAttributes.MSIEndpoint Adja meg az MSI-végpontot. Nem
volumeAttributes.AzureStorageSPNClientID Adja meg az Azure Service Principal Name (SPN) ügyfélazonosítóját. Nem
volumeAttributes.AzureStorageSPNTenantID Adja meg az Azure SPN-bérlő azonosítóját. Nem
volumeAttributes.AzureStorageAADEndpoint Adja meg a Microsoft Entra-végpontot. Nem
--- A következő paraméterek csak a funkcióhoz tartoznak: blobfuse read account key or SAS token from Key Vault --- --- ---
volumeAttributes.keyVaultURL Adja meg az Azure Key Vault DNS-nevét. {vault-name}.vault.azure.net Nem
volumeAttributes.keyVaultSecretName Adja meg az Azure Key Vault titkos kódnevét. Meglévő Azure Key Vault-titkos név. Nem
volumeAttributes.keyVaultSecretVersion Az Azure Key Vault titkos verziója. Meglévő verzió Nem Ha üres, az illesztőprogram az aktuális verziót használja.

Blob Storage-tároló létrehozása

Amikor létrehoz egy Azure Blob Storage-erőforrást az AKS-hez való használatra, létrehozhatja az erőforrást a csomópont erőforráscsoportjában. Ez a megközelítés lehetővé teszi az AKS-fürt számára a blobtároló-erőforrás elérését és kezelését.

Ebben a cikkben hozza létre a tárolót a csomópont erőforráscsoportjában. Először kérje le az erőforráscsoport nevét az az aks show paranccsal, és adja hozzá a --query nodeResourceGroup lekérdezési paramétert. Az alábbi példa a myResourceGroup nevű erőforráscsoportban lekéri a myAKSCluster nevű AKS-fürt csomópont-erőforráscsoportját:

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

A parancs kimenete a következő példához hasonlít:

MC_myResourceGroup_myAKSCluster_eastus

Ezután hozzon létre egy tárolót a blobok tárolásához a Blob Storage kezelése lépésekkel a hozzáférés engedélyezéséhez, majd hozza létre a tárolót.

Kötet csatlakoztatása

Ebben a szakaszban az állandó kötetet az NFS protokoll vagy a Blobfuse használatával csatlakoztatja.

A Blob Storage csatlakoztatása az NFS v3 protokoll használatával nem hitelesít fiókkulcs használatával. Az AKS-fürtnek ugyanabban vagy társhálózatban kell lennie, mint az ügynökcsomópont. A tárfiókban lévő adatok védelmének egyetlen módja egy virtuális hálózat és más hálózati biztonsági beállítások használata. A tárfiókhoz való NFS-hozzáférés beállításáról további információt a Blob Storage csatlakoztatása a Hálózati fájlrendszer (NFS) 3.0 protokoll használatával című témakörben talál.

Az alábbi példa bemutatja, hogyan csatlakoztathat egy Blob Storage-tárolót állandó kötetként az NFS protokoll használatával.

  1. Hozzon létre egy fájlt, pv-blob-nfs.yaml és másolja a következő YAML-fájlba. Alatt storageClass, frissítés resourceGroup, storageAccountés containerName.

    Feljegyzés

    volumeHandle az értéknek egyedi volumeID-nek kell lennie a fürt minden azonos tárolóblobtárolójában. A karakter # belső / használatra van fenntartva, és nem használható.

    apiVersion: v1
kind: PersistentVolume
metadata:
  annotations:
    pv.kubernetes.io/provisioned-by: blob.csi.azure.com
  name: pv-blob
spec:
  capacity:
    storage: 1Pi
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain  # If set as "Delete" container would be removed after pvc deletion
  storageClassName: azureblob-nfs-premium
  mountOptions:
    - nconnect=4
  csi:
    driver: blob.csi.azure.com
    # make sure volumeid is unique for every identical storage blob container in the cluster
    # character `#` and `/` are reserved for internal use and cannot be used in volumehandle
    volumeHandle: account-name_container-name
    volumeAttributes:
      resourceGroup: resourceGroupName
      storageAccount: storageAccountName
      containerName: containerName
      protocol: nfs

    Feljegyzés

    Bár a Kubernetes APIkapacitásattribútum kötelező, az Azure Blob Storage CSI-illesztőprogram nem használja ezt az értéket, mert rugalmasan írhat adatokat, amíg el nem éri a tárfiók kapacitáskorlátját. Az attribútum értéke csak a capacity PersistentVolumes és a PersistentVolumeClaims közötti méretegyeztetéshez használatos. Azt javasoljuk, hogy fiktív magas értéket használjon. A pod egy 5 Petabájt fiktív méretű csatlakoztatott kötetet lát.

  2. Futtassa a következő parancsot az állandó kötet létrehozásához a kubectl create paranccsal, amely a korábban létrehozott YAML-fájlra hivatkozik:

    kubectl create -f pv-blob-nfs.yaml

  3. Hozzon létre egy pvc-blob-nfs.yaml fájlt egy PersistentVolumeClaim használatával. Példa:

    kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: pvc-blob
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 10Gi
  volumeName: pv-blob
  storageClassName: azureblob-nfs-premium

  4. Futtassa a következő parancsot az állandó kötet jogcímének létrehozásához a kubectl create paranccsal, amely a korábban létrehozott YAML-fájlra hivatkozik:

    kubectl create -f pvc-blob-nfs.yaml

Az állandó kötet használata

Az alábbi YAML létrehoz egy podot, amely a korábban létrehozott pvc-blob nevű állandó kötet vagy állandó kötet jogcímet használja az Azure Blob Storage csatlakoztatásához az /mnt/blob útvonalon.

  1. Hozzon létre egy fájlt, nginx-pod-blob.yamlés másolja a következő YAML-be. Győződjön meg arról, hogy a jogcímnév megegyezik az előző lépésben létrehozott PVC-vel , amikor állandó kötetet hoz létre az NFS-hez vagy a Blobfuse-hoz.

    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. Futtassa a következő parancsot a pod létrehozásához és a PVC csatlakoztatásához a korábban létrehozott YAML-fájlra hivatkozó kubectl create paranccsal:

    kubectl create -f nginx-pod-blob.yaml

  3. Futtassa a következő parancsot egy interaktív rendszerhéj-munkamenet létrehozásához a pod használatával a csatlakoztatott Blob Storage ellenőrzéséhez:

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

    A parancs kimenete a következő példához hasonlít:

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

Következő lépések