Aprowizuj woluminy NFS usługi Azure NetApp Files dla usługi Azure Kubernetes Service

  • Artykuł

Po skonfigurowaniu usługi Azure NetApp Files dla usługi Azure Kubernetes Service można aprowizować woluminy usługi Azure NetApp Files dla usługi Azure Kubernetes Service.

Usługa Azure NetApp Files obsługuje woluminy przy użyciu systemu plików NFS (NFSv3 lub NFSv4.1), SMB lub podwójnego protokołu (NFSv3 i SMB lub NFSv4.1 i SMB).

Statyczne konfigurowanie dla aplikacji korzystających z woluminów NFS

W tej sekcji opisano sposób tworzenia woluminu NFS w usłudze Azure NetApp Files i uwidaczniania woluminu statycznie na platformie Kubernetes. W tym artykule opisano również sposób używania woluminu z konteneryzowaną aplikacją.

Tworzenie woluminu NFS

  1. Zdefiniuj zmienne dla późniejszego użycia. Zastąp ciąg myresourcegroup, mylocation, myaccountname, mypool1, premium, myfilepath, myvolsize, myvolname, vnetid i anfSubnetID odpowiednią wartością z konta i środowiska. Ścieżka pliku musi być unikatowa we wszystkich kontach ANF.

    RESOURCE_GROUP="myresourcegroup"
LOCATION="mylocation"
ANF_ACCOUNT_NAME="myaccountname"
POOL_NAME="mypool1"
SERVICE_LEVEL="premium" # Valid values are Standard, Premium, and Ultra
UNIQUE_FILE_PATH="myfilepath"
VOLUME_SIZE_GIB="myvolsize"
VOLUME_NAME="myvolname"
VNET_ID="vnetId"
SUBNET_ID="anfSubnetId"

  2. Utwórz wolumin przy użyciu az netappfiles volume create polecenia . Aby uzyskać więcej informacji, zobacz Tworzenie woluminu NFS dla usługi Azure NetApp Files.

    az netappfiles volume create \
    --resource-group $RESOURCE_GROUP \
    --location $LOCATION \
    --account-name $ANF_ACCOUNT_NAME \
    --pool-name $POOL_NAME \
    --name "$VOLUME_NAME" \
    --service-level $SERVICE_LEVEL \
    --vnet $VNET_ID \
    --subnet $SUBNET_ID \
    --usage-threshold $VOLUME_SIZE_GIB \
    --file-path $UNIQUE_FILE_PATH \
    --protocol-types NFSv3

Tworzenie woluminu trwałego

  1. Wyświetl szczegóły woluminu przy użyciu az netappfiles volume show polecenia . Zastąp zmienne odpowiednimi wartościami z konta i środowiska usługi Azure NetApp Files, jeśli nie zostały zdefiniowane w poprzednim kroku.

    az netappfiles volume show \
    --resource-group $RESOURCE_GROUP \
    --account-name $ANF_ACCOUNT_NAME \
    --pool-name $POOL_NAME \
    --volume-name "$VOLUME_NAME -o JSON

    Poniższe dane wyjściowe to przykład powyższego polecenia wykonanego z rzeczywistymi wartościami.

    {
  ...
  "creationToken": "myfilepath2",
  ...
  "mountTargets": [
    {
      ...
      "ipAddress": "10.0.0.4",
      ...
    }
  ],
  ...
}

  2. Utwórz plik o nazwie pv-nfs.yaml i skopiuj go w następującym języku YAML. Upewnij się, że serwer jest zgodny z wyjściowym adresem IP z kroku 1, a ścieżka jest zgodna z danymi wyjściowymi z creationToken powyższych. Pojemność musi być również zgodna z rozmiarem woluminu z powyższego kroku.

    apiVersion: v1
kind: PersistentVolume
metadata:
  name: pv-nfs
spec:
  capacity:
    storage: 100Gi
  accessModes:
    - ReadWriteMany
  mountOptions:
    - vers=3
  nfs:
    server: 10.0.0.4
    path: /myfilepath2

  3. Utwórz wolumin trwały przy użyciu kubectl apply polecenia :

    kubectl apply -f pv-nfs.yaml

  4. Sprawdź, czy stan woluminu trwałego jest dostępny za pomocą kubectl describe polecenia :

    kubectl describe pv pv-nfs

Tworzenie trwałego oświadczenia woluminu

  1. Utwórz plik o nazwie pvc-nfs.yaml i skopiuj go w następującym języku YAML. Ten manifest tworzy pvc o nazwie pvc-nfs dla magazynu 100Gi i ReadWriteMany trybu dostępu, pasując do utworzonego pv.

    apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: pvc-nfs
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: ""
  resources:
    requests:
      storage: 100Gi

  2. Utwórz oświadczenie trwałego woluminu kubectl apply przy użyciu polecenia :

    kubectl apply -f pvc-nfs.yaml

  3. Sprawdź, czy stan oświadczenia trwałego woluminu ma wartość Powiązana przy użyciu kubectl describe polecenia :

    kubectl describe pvc pvc-nfs

Instalowanie za pomocą zasobnika

  1. Utwórz plik o nazwie nginx-nfs.yaml i skopiuj go w następującym języku YAML. Ten manifest definiuje nginx zasobnik, który używa trwałego oświadczenia woluminu.

    kind: Pod
apiVersion: v1
metadata:
  name: nginx-nfs
spec:
  containers:
  - image: mcr.microsoft.com/oss/nginx/nginx:1.15.5-alpine
    name: nginx-nfs
    command:
    - "/bin/sh"
    - "-c"
    - while true; do echo $(date) >> /mnt/azure/outfile; sleep 1; done
    volumeMounts:
    - name: disk01
      mountPath: /mnt/azure
  volumes:
  - name: disk01
    persistentVolumeClaim:
      claimName: pvc-nfs

  2. Utwórz zasobnik przy użyciu kubectl apply polecenia :

    kubectl apply -f nginx-nfs.yaml

  3. Sprawdź, czy zasobnik jest uruchomiony przy użyciu kubectl describe polecenia :

    kubectl describe pod nginx-nfs

  4. Sprawdź, czy wolumin został zainstalowany na zasobniku przy użyciu polecenia kubectl exec , aby nawiązać połączenie z zasobnikem, a następnie sprawdź df -h , czy wolumin jest zainstalowany.

    kubectl exec -it nginx-nfs -- sh

    / # df -h
Filesystem             Size  Used Avail Use% Mounted on
...
10.0.0.4:/myfilepath2  100T  384K  100T   1% /mnt/azure
...

Dynamiczne konfigurowanie dla aplikacji korzystających z woluminów NFS

Narzędzie Astra Trident może służyć do dynamicznej aprowizacji plików NFS lub SMB w usłudze Azure NetApp Files. Dynamiczne aprowizowane woluminy SMB są obsługiwane tylko w przypadku węzłów procesu roboczego systemu Windows.

W tej sekcji opisano sposób używania narzędzia Astra Trident do dynamicznego tworzenia woluminu NFS w usłudze Azure NetApp Files i automatycznego instalowania go w konteneryzowanej aplikacji.

Instalowanie narzędzia Astra Trident

Aby dynamicznie aprowizować woluminy NFS, należy zainstalować aplikację Astra Trident. Astra Trident jest dynamicznym aprowizatorem magazynu netApp, który został specjalnie utworzony dla platformy Kubernetes. Uprość zużycie magazynu dla aplikacji Kubernetes przy użyciu standardowego sterownika interfejsu CSI (Container Storage Interface) firmy Astra Trident. Usługa Astra Trident wdraża w klastrach Kubernetes jako zasobniki i udostępnia dynamiczne usługi orkiestracji magazynu dla obciążeń Kubernetes.

Trident można zainstalować przy użyciu operatora Trident (ręcznie lub przy użyciu narzędzia Helm) lub tridentctl. Aby dowiedzieć się więcej o tych metodach instalacji i sposobie ich działania, zobacz Astra Trident Install Guide (Przewodnik instalacji narzędzia Astra Trident).

Instalowanie narzędzia Astra Trident przy użyciu narzędzia Helm

Program Helm musi być zainstalowany na stacji roboczej, aby zainstalować narzędzie Astra Trident przy użyciu tej metody. Aby zapoznać się z innymi metodami instalowania narzędzia Astra Trident, zobacz Astra Trident Install Guide (Przewodnik instalacji narzędzia Astra Trident).

  1. Aby zainstalować narzędzie Astra Trident przy użyciu programu Helm dla klastra z tylko węzłami roboczymi systemu Linux, uruchom następujące polecenia:

    helm repo add netapp-trident https://netapp.github.io/trident-helm-chart   
helm install trident netapp-trident/trident-operator --version 23.04.0  --create-namespace --namespace trident

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

    NAME: trident
LAST DEPLOYED: Fri May  5 13:55:36 2023
NAMESPACE: trident
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
Thank you for installing trident-operator, which will deploy and manage NetApp's Trident CSI storage provisioner for Kubernetes.

Your release is named 'trident' and is installed into the 'trident' namespace.
Please note that there must be only one instance of Trident (and trident-operator) in a Kubernetes cluster.

To configure Trident to manage storage resources, you will need a copy of tridentctl, which is available in pre-packaged Trident releases.  You may find all Trident releases and source code online at https://github.com/NetApp/trident. 

To learn more about the release, try:

    $ helm status trident
      $ helm get all trident

  2. Aby potwierdzić, że aplikacja Astra Trident została pomyślnie zainstalowana, uruchom następujące kubectl describe polecenie:

    kubectl describe torc trident

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

    Name:         trident
Namespace:    
Labels:       app.kubernetes.io/managed-by=Helm
Annotations:  meta.helm.sh/release-name: trident
              meta.helm.sh/release-namespace: trident
API Version:  trident.netapp.io/v1
Kind:         TridentOrchestrator
Metadata:
    ...
Spec:
  IPv6:                  false
  Autosupport Image:     docker.io/netapp/trident-autosupport:23.04
  Autosupport Proxy:     <nil>
  Disable Audit Log:     true
  Enable Force Detach:   false
  Http Request Timeout:  90s
  Image Pull Policy:     IfNotPresent
  k8sTimeout:            0
  Kubelet Dir:           <nil>
  Log Format:            text
  Log Layers:            <nil>
  Log Workflows:         <nil>
  Namespace:             trident
  Probe Port:            17546
  Silence Autosupport:   false
  Trident Image:         docker.io/netapp/trident:23.04.0
  Windows:               false
Status:
  Current Installation Params:
    IPv6:                       false
    Autosupport Hostname:       
    Autosupport Image:          docker.io/netapp/trident-autosupport:23.04
    Autosupport Proxy:          
    Autosupport Serial Number:  
    Debug:                      false
    Disable Audit Log:          true
    Enable Force Detach:        false
    Http Request Timeout:       90s
    Image Pull Policy:          IfNotPresent
    Image Pull Secrets:
    Image Registry:       
    k8sTimeout:           30
    Kubelet Dir:          /var/lib/kubelet
    Log Format:           text
    Log Layers:           
    Log Level:            info
    Log Workflows:        
    Probe Port:           17546
    Silence Autosupport:  false
    Trident Image:        docker.io/netapp/trident:23.04.0
  Message:                Trident installed
  Namespace:              trident
  Status:                 Installed
  Version:                v23.04.0
Events:
  Type    Reason      Age    From                        Message
  ----    ------      ----   ----                        -------
  Normal  Installing  2m59s  trident-operator.netapp.io  Installing Trident
  Normal  Installed   2m31s  trident-operator.netapp.io  Trident installed

Tworzenie zaplecza

Aby poinstruować Astra Trident o subskrypcji usługi Azure NetApp Files i miejscu, w którym musi utworzyć woluminy, zostanie utworzone zaplecze. Ten krok wymaga szczegółowych informacji o koncie utworzonym w poprzednim kroku.

  1. Utwórz plik o nazwie backend-secret.yaml i skopiuj go w następującym języku YAML. Zmień wartości Client ID i clientSecret na poprawne dla danego środowiska.

    apiVersion: v1
kind: Secret
metadata:
  name: backend-tbc-anf-secret
type: Opaque
stringData:
  clientID: abcde356-bf8e-fake-c111-abcde35613aa
  clientSecret: rR0rUmWXfNioN1KhtHisiSAnoTherboGuskey6pU

  2. Utwórz plik o nazwie backend-anf.yaml i skopiuj go w następującym języku YAML. Zmień wartości subscriptionID, , locationtenantIDi serviceLevel na poprawne dla danego środowiska. subscriptionID Użyj elementu dla subskrypcji platformy Azure, w której włączono usługę Azure NetApp Files. tenantIDUzyskaj identyfikator , clientIDi clientSecret z rejestracji aplikacji w usłudze Microsoft Entra ID z wystarczającymi uprawnieniami dla usługi Azure NetApp Files. Rejestracja aplikacji obejmuje rolę Właściciel lub Współautor wstępnie zdefiniowaną przez platformę Azure. Lokalizacja musi być lokalizacją platformy Azure zawierającą co najmniej jedną delegowana podsieć utworzoną w poprzednim kroku. Element serviceLevel musi być zgodny ze skonfigurowanym serviceLevel dla puli pojemności w temacie Konfigurowanie obciążeń usługi Azure NetApp Files dla usługi AKS.

    apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
  name: backend-tbc-anf
spec:
  version: 1
  storageDriverName: azure-netapp-files
  subscriptionID: 12abc678-4774-fake-a1b2-a7abcde39312
  tenantID: a7abcde3-edc1-fake-b111-a7abcde356cf
  location: eastus
  serviceLevel: Premium
  credentials:
    name: backend-tbc-anf-secret

    Aby uzyskać więcej informacji na temat zapleczy, zobacz Opcje konfiguracji zaplecza i przykłady usługi Azure NetApp Files.

  3. Zastosuj wpis tajny i zaplecze przy użyciu kubectl apply polecenia . Najpierw zastosuj wpis tajny:

    kubectl apply -f backend-secret.yaml -n trident

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

    secret/backend-tbc-anf-secret created

    Zastosuj zaplecze:

    kubectl apply -f backend-anf.yaml -n trident

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

    tridentbackendconfig.trident.netapp.io/backend-tbc-anf created

  4. Upewnij się, że zaplecze zostało utworzone przy użyciu kubectl get polecenia :

     kubectl get tridentbackends -n trident

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

    NAME        BACKEND               BACKEND UUID
tbe-kfrdh   backend-tbc-anf   8da4e926-9dd4-4a40-8d6a-375aab28c566

Tworzenie klasy magazynu

Klasa magazynu służy do definiowania sposobu dynamicznego tworzenia jednostki magazynu przy użyciu woluminu trwałego. Aby korzystać z woluminów usługi Azure NetApp Files, należy utworzyć klasę magazynu.

  1. Utwórz plik o nazwie anf-storageclass.yaml i skopiuj go w następującym pliku YAML:

    apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: azure-netapp-files
provisioner: csi.trident.netapp.io
parameters:
  backendType: "azure-netapp-files"
  fsType: "nfs"

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

    kubectl apply -f anf-storageclass.yaml

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

    storageclass/azure-netapp-files created

  3. Uruchom polecenie , kubectl get aby wyświetlić stan klasy magazynu:

    kubectl get sc
NAME                 PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE   ALLOWVOLUMEEXPANSION   AGE
azure-netapp-files   csi.trident.netapp.io   Delete          Immediate           false

Tworzenie pcv

Oświadczenie trwałego woluminu (PVC) jest żądaniem magazynu przez użytkownika. Po utworzeniu trwałego oświadczenia woluminu usługa Astra Trident automatycznie tworzy wolumin usługi Azure NetApp Files i udostępnia go dla obciążeń Kubernetes do użycia.

  1. Utwórz plik o nazwie anf-pvc.yaml i skopiuj go w następującym języku YAML. W tym przykładzie wymagany jest wolumin 1-TiB z dostępem ReadWriteMany.

    kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: anf-pvc
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 1Ti
  storageClassName: azure-netapp-files

  2. Utwórz oświadczenie trwałego woluminu za kubectl apply pomocą polecenia :

    kubectl apply -f anf-pvc.yaml

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

    persistentvolumeclaim/anf-pvc created

  3. Aby wyświetlić informacje o trwałym oświadczeniu woluminu, uruchom kubectl get polecenie:

    kubectl get pvc

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

    kubectl get pvc -n trident
NAME      STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS         AGE
anf-pvc   Bound    pvc-bffa315d-3f44-4770-86eb-c922f567a075   1Ti        RWO            azure-netapp-files   62s

Używanie woluminu trwałego

Po utworzeniu pvc Astra Trident tworzy wolumin trwały. Zasobnik można połączyć w celu zainstalowania i uzyskania dostępu do woluminu usługi Azure NetApp Files.

Poniższy manifest może służyć do definiowania zasobnika NGINX, który instaluje wolumin usługi Azure NetApp Files utworzony w poprzednim kroku. W tym przykładzie wolumin jest instalowany pod adresem /mnt/data.

  1. Utwórz plik o nazwie anf-nginx-pod.yaml i skopiuj go w następującym pliku YAML:

    kind: Pod
apiVersion: v1
metadata:
  name: nginx-pod
spec:
  containers:
  - name: nginx
    image: mcr.microsoft.com/oss/nginx/nginx:1.15.5-alpine
    resources:
      requests:
        cpu: 100m
        memory: 128Mi
      limits:
        cpu: 250m
        memory: 256Mi
    volumeMounts:
    - mountPath: "/mnt/data"
      name: volume
  volumes:
    - name: volume
      persistentVolumeClaim:
        claimName: anf-pvc

  2. Utwórz zasobnik przy użyciu kubectl apply polecenia :

    kubectl apply -f anf-nginx-pod.yaml

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

    pod/nginx-pod created

    Platforma Kubernetes utworzyła zasobnik z zainstalowanym woluminem i dostępnym w kontenerze nginx pod adresem /mnt/data. Możesz potwierdzić, sprawdzając dzienniki zdarzeń zasobnika przy użyciu kubectl describe polecenia :

    kubectl describe pod nginx-pod

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

    [...]
Volumes:
  volume:
    Type:       PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
    ClaimName:  anf-pvc
    ReadOnly:   false
  default-token-k7952:
    Type:        Secret (a volume populated by a Secret)
    SecretName:  default-token-k7952
    Optional:    false
[...]
Events:
  Type    Reason                  Age   From                     Message
  ----    ------                  ----  ----                     -------
  Normal  Scheduled               15s   default-scheduler        Successfully assigned trident/nginx-pod to brameshb-non-root-test
  Normal  SuccessfulAttachVolume  15s   attachdetach-controller  AttachVolume.Attach succeeded for volume "pvc-bffa315d-3f44-4770-86eb-c922f567a075"
  Normal  Pulled                  12s   kubelet                  Container image "mcr.microsoft.com/oss/nginx/nginx:1.15.5-alpine" already present on machine
  Normal  Created                 11s   kubelet                  Created container nginx
  Normal  Started                 10s   kubelet                  Started container nginx

Następne kroki

Aplikacja Astra Trident obsługuje wiele funkcji w usłudze Azure NetApp Files. Aby uzyskać więcej informacji, zobacz: