Azure Disk CSI-Treiber

Der Azure Disk CSI-Treiber für IBM Cloud Satellite® implementiert die CSI-Spezifikation, so dass Container-Orchestrierungswerkzeuge den Lebenszyklus von Azure Disk-Volumes verwalten können.

Einen Überblick über die verfügbaren Funktionen des Azure Disk CSI-Treibers finden Sie unter Funktionen.

Die Azure Disk CSI-Treibervorlage für Satellite ist derzeit für die Clusterversionen 4.7 und höher verfügbar.

Bevor Sie Speichervorlagen in Clustern an Ihrem Standort bereitstellen können, müssen Sie Satellite Config einrichten, indem Sie in der Konsole die Option Enable cluster admin access for Satellite Config (Cluster-Administrationszugriff für Config aktivieren ) auswählen oder bei der Erstellung Ihres Clusters die Option --enable-config-admin angeben.

Sie können Ihre Speicherklassen nicht anpassen, da Satellite Config Ihre Änderungen überschreibt.

Sie können den Satellite Speicherdienst nicht auf Ressourcengruppen ausweiten. Wenn Sie jedoch andere Ressourcen wie Standorte und Cluster zu Ressourcengruppen zusammenfassen, müssen Sie Satellite reader und link administrator role für alle Ressourcen im Konto hinzufügen.

Voraussetzungen für die Verwendung von Azure Disk

Richten Sie Azure ein: Erstellen Sie eine Festplattenspeicherkonfiguration für Satellite-Cluster an Ihrem Standort. Wenn Sie Ihren Clustern eine Speicherkonfiguration zuweisen, werden die Speichertreiber des ausgewählten Speicherproviders auf Ihrem Cluster installiert.

Führen Sie die folgenden Schritte aus, um die Speichervorlage Azure-Disk-CSI-Treiber zu verwenden.

  1. Erstellen Sie einen Azure-Standort mithilfe der Standortvorlage oder durch manuelles Hinzufügen von Azure-Hosts zu Satellite. Wenn Sie dafür entscheiden, Hosts manuell zuzuweisen, müssen Sie vor dem Erstellen der Speicherkonfiguration Ihre Workerknoten mit Bezeichnungen versehen.

  2. Erstellen Sie einen Satellite Cluster , der auf Rechenhosts in Azure ausgeführt wird. Stellen Sie sicher, dass Sie beim Erstellen des Clusters die Option Clusteradministratorzugriff für Satellite Config auswählen. Wenn Sie beim Erstellen Ihres Clusters den Administratorzugriff (admin) für Satellite Config nicht aktivieren, müssen Sie Ihren Cluster erneut erstellen und den Administratorzugriff aktivieren, bevor Sie Speicher bereitstellen können.

  3. Erstellen Sie Ihre Konfigurationsdatei.

Optional: Workerknoten für Azure-Platte kennzeichnen

Führen Sie die folgenden Schritte aus, um die erforderlichen Beschriftungen zu Ihren Worker-Knoten für die Azure Disk CSI-Treibervorlage hinzuzufügen.

Wenn Sie Ihre Azure-Hosts manuell Ihrem Standort zugewiesen und die Vorlage Schematics in der Konsole nicht verwendet haben, müssen Sie Ihre Worker-Knoten kennzeichnen, bevor Sie Ihre Speicherkonfiguration erstellen.

  1. Listen Sie Ihre Azure-Worker-Knoten auf und notieren Sie sich den name jedes Knotens.

    oc get nodes

  2. Stellen Sie die Details eines jeden Knotens ab und notieren Sie sich die zone , in der sich der Knoten befindet. Beispiel: eastus-1.

    oc get nodes <node-name> -o yaml | grep zone

  3. Kennzeichnen Sie Ihre Worker-Knoten mit dem Wert zone , den Sie zuvor abgerufen haben. Ersetzen Sie <node-name> und <zone> durch den Knotennamen und die Zone Ihres Workerknotens. Wenn Sie beispielsweise einen Worker-Knoten in der Zone eastus-1haben, verwenden Sie die folgenden Befehle, um eastus-1 als Bezeichnung dem Worker-Knoten in der Zone eastus-1 hinzuzufügen.

    oc label node <node-name> topology.kubernetes.io/zone-
oc label node <node-name> topology.kubernetes.io/zone=<zone> --overwrite

  4. Wiederholen Sie die vorherigen Schritte für jeden Worker-Knoten

  5. Melden Sie sich bei Ihrem Azure-Konto an und rufen die erforderlichen Parameter ab. Weitere Informationen zu den Parametern finden Sie unter Clusterkonfiguration.

Konfiguration in der Konsole erstellen und zuordnen

  1. Überprüfen Sie die Parameterreferenz.

  2. Wählen Sie in der Standortkonsole den Standort aus, an dem Sie eine Speicherkonfiguration erstellen möchten.

  3. Wählen Sie Speicher > Speicherkonfiguration erstellen aus

  4. Geben Sie einen Namen für Ihre Konfiguration ein.

  5. Wählen Sie den Speichertyp aus.

  6. Wählen Sie die Version aus und klicken Sie auf Weiter

  7. Wenn der von Ihnen ausgewählte Speichertyp benutzerdefinierte Parameter akzeptiert, geben Sie sie auf der Registerkarte Parameter ein.

  8. Wenn der von Ihnen ausgewählte Speichertyp geheime Schlüssel erfordert, geben Sie sie auf der Registerkarte Geheime Schlüssel ein.

  9. Überprüfen Sie auf der Registerkarte Speicherklassen die Speicherklassen, die von der Konfiguration implementiert werden, oder erstellen Sie eine angepasste Speicherklasse.

  10. Wählen Sie auf der Registerkarte Service zuordnen den Service aus, dem Sie Ihre Konfiguration zuordnen wollen.

  11. Klicken Sie auf Abschließen, um Ihre Speicherkonfiguration zuzuordnen.

Konfiguration in der Befehlszeilenschnittstelle erstellen

  1. Überprüfen Sie die Parameterreferenz für die Vorlagenversion, die Sie verwenden wollen.

  2. Melden Sie sich bei der IBM Cloud-CLI an.

    ibmcloud login

  3. Listen Sie Ihre Satellite Standorte auf und notieren Sie die Spalte Managed from .

    ibmcloud sat location ls

  4. Wählen Sie die Region Managed from Ihrer Position Satellite aus. Beispiel: Für wdc -Ziel us-east. Weitere Informationen finden Sie unter Satellite Regionen.

    ibmcloud target -r us-east

  5. Wenn Sie eine andere Ressourcengruppe als defaultverwenden, wählen Sie sie aus.

    ibmcloud target -g RESOURCE_GROUP

  6. Kopieren Sie einen der folgenden Beispielbefehle für die Vorlagenversion, die Sie verwenden möchten. Weitere Informationen zu dem Befehl finden Sie unter ibmcloud sat storage config create in der Befehlsreferenz.

    Beispielbefehl zum Erstellen einer Konfiguration der Version 1.30.3.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name azuredisk-csi-driver --template-version 1.30.3 --param "tenantId=TENANTID"  --param "subscriptionId=SUBSCRIPTIONID"  --param "aadClientId=AADCLIENTID"  --param "location=LOCATION"  --param "aadClientSecret=AADCLIENTSECRET"  --param "resourceGroup=RESOURCEGROUP"  --param "vmType=VMTYPE"  --param "securityGroupName=SECURITYGROUPNAME"  --param "vnetName=VNETNAME"  --param "useWorkloadIdentity=USEWORKLOADIDENTITY"  --param "workloadIdentityClientId=WORKLOADIDENTITYCLIENTID"  --param "workloadIdentityTenantId=WORKLOADIDENTITYTENANTID"  --param "enableOtelTracing=ENABLEOTELTRACING"  --param "otelServiceName=OTELSERVICENAME"  --param "otelExporterEndpoint=OTELEXPORTERENDPOINT"  --param "useHostNetwork=USEHOSTNETWORK"

  7. Passen Sie den Befehl basierend auf den Einstellungen an, die Sie verwenden möchten.

  8. Führen Sie den Befehl aus, um eine Konfiguration zu erstellen.

  9. Überprüfen Sie, ob Ihre Konfiguration erstellt wurde.

    ibmcloud sat storage config get --config CONFIG

Konfiguration in der API erstellen

  1. Generieren Sie einen API-Schlüssel und fordern Sie anschließend ein Aktualisierungstoken an. Weitere Informationen finden Sie im Abschnitt zur Generierung eines IBM Cloud IAM-Token mithilfe eines API-Schlüssels.

  2. Überprüfen Sie die Parameterreferenz für die Vorlagenversion, die Sie verwenden wollen.

  3. Kopieren Sie eine der folgenden Beispielanforderungen und ersetzen Sie die Variablen, die Sie verwenden möchten.

    Beispielanforderung für die Erstellung einer Konfiguration der Version 1.30.3.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"azuredisk-csi-driver\", \"storage-template-version\": \"1.30.3\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"LOCATION\", { \"entry.name\": \"RESOURCEGROUP\", { \"entry.name\": \"VMTYPE\", { \"entry.name\": \"SECURITYGROUPNAME\", { \"entry.name\": \"VNETNAME\", { \"entry.name\": \"USEWORKLOADIDENTITY\", { \"entry.name\": \"ENABLEOTELTRACING\", { \"entry.name\": \"OTELSERVICENAME\", { \"entry.name\": \"OTELEXPORTERENDPOINT\", { \"entry.name\": \"USEHOSTNETWORK\",\"user-secret-parameters\": { \"entry.name\": \"TENANTID\",{ \"entry.name\": \"SUBSCRIPTIONID\",{ \"entry.name\": \"AADCLIENTID\",{ \"entry.name\": \"AADCLIENTSECRET\",{ \"entry.name\": \"WORKLOADIDENTITYCLIENTID\",{ \"entry.name\": \"WORKLOADIDENTITYTENANTID\",}

Erstellen einer Zuweisung in der Befehlszeilenschnittstelle (CLI)

  1. Listen Sie Ihre Speicherkonfigurationen auf und notieren Sie sich die Speicherkonfiguration, die Sie Ihren Clustern zuweisen möchten.

    ibmcloud sat storage config ls

  2. Rufen Sie die ID des Clusters, der Clustergruppe oder des Dienstes ab, dem Sie Speicher zuweisen möchten.

    Um sicherzustellen, dass Ihr Cluster bei Satellite Config oder zum Erstellen von Gruppen registriert ist, lesen Sie die Informationen im Abschnitt Cluster für die Verwendung mit Satellite Configeinrichten.

    Beispielbefehl zum Auflisten von Clustergruppen.

    ibmcloud sat group ls

    Beispielbefehl zum Auflisten von Clustern.

    ibmcloud oc cluster ls --provider satellite

    Beispielbefehl zum Auflisten von Satellite-Services.

    ibmcloud sat service ls --location LOCATION

  3. Ordnen Sie Ihre Speicherkonfiguration dem Cluster, der Gruppe bzw. dem Service zu, den Sie zuvor abgerufen haben. Weitere Informationen finden Sie unter dem Befehlibmcloud sat storage assignment create.

    Beispielbefehl zum Zuordnen einer Konfiguration zu einer Clustergruppe.

    ibmcloud sat storage assignment create --group GROUP --config CONFIG --name NAME

    Beispielbefehl für die Zuordnung einer Konfiguration zu einem Cluster

    ibmcloud sat storage assignment create --cluster CLUSTER --config CONFIG --name NAME

    Beispielbefehl zum Zuordnen einer Konfiguration zu einem Service-Cluster.

    ibmcloud sat storage assignment create --service-cluster-id CLUSTER --config CONFIG --name NAME

  4. Überprüfen Sie, ob Ihre Zuweisung erstellt wurde.

    ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)

Erstellen einer Speicherzuweisung in der Anwendungsprogrammierschnittstelle (API)

  1. Kopieren Sie eine der folgenden Beispielanforderungen:

    Beispielanforderung zum Zuordnen einer -Konfiguration zu einem Cluster.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignmentByCluster" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"CLUSTER-ID\", \"controller\": \"LOCATION-ID\", \"name\": \"ASSIGNMENT-NAME\"}"

    Beispielanforderung zum Zuordnen der Konfiguration zu einer Clustergruppe.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"string\", \"groups\": [ \"CLUSTER-GROUP\" ], \"name\": \"ASSIGNMENT-NAME\"}"

  2. Ersetzen Sie die Variablen durch Ihre Details und führen Sie die Anforderung aus.

  3. Überprüfen Sie, ob die Zuordnung erstellt wurde, indem Sie Ihre Zuordnungen auflisten.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignments" -H "accept: application/json" -H "Authorization: Bearer TOKEN"

Speicherzuordnungen in der Konsole aktualisieren

Sie können die Satellite-Konsole verwenden, um die neuesten Patchaktualisierungen auf Ihre Zuordnungen anzuwenden.

  1. Wählen Sie auf der Seite Positionen in der Satellite-KonsoleIhren Standort aus.

  2. Klicken Sie auf die Registerkarte Speicher, um Ihre Konfigurationen anzuzeigen.

  3. Klicken Sie auf die Konfiguration, die Sie aktualisieren möchten.

  4. Klicken Sie auf das Informationssymbol Informationen (i), um die letzte Überarbeitung oder Programmkorrektur anzuwenden.

  5. Optional: Aktivieren Sie automatische Patchaktualisierungen für Ihre Speicherzuordnung. Die Aktivierung automatischer Patchaktualisierungen stellt sicher, dass Ihre Zuordnung immer über die neuesten Sicherheitskorrekturen verfügt.

Wenn Sie automatische Patchaktualisierungen aktivieren, müssen Sie die Hauptaktualisierungen dennoch manuell anwenden.

Zuordnungen in der Befehlszeilenschnittstelle manuell aktualisieren

Aktualisieren Sie eine Zuordnung, um die neueste Speichervorlagenrevision zu verwenden.

  1. Listen Sie Ihre Satellite-Speicherzuordnungen auf und notieren Sie sich die Satellite-Zuordnung, für die Sie ein Upgrade durchführen möchten.

    ibmcloud sat storage assignment ls

  2. Listen Sie die Satellite-Speichervorlagen auf, um die neuesten verfügbaren Versionen anzuzeigen.

    ibmcloud sat storage template ls

  3. Aktualisieren Sie die Satellite-Zuordnung.

    Beispielbefehl für das Upgrade einer Zuordnung.

    ibmcloud sat storage assignment upgrade --assignment ASSIGNMENT

Automatische Patchaktualisierungen für Konfigurationen und Zuordnungen in der Befehlszeilenschnittstelle aktivieren

Sie können die sat storage assignment autopatch enable-CLI verwenden, um automatische Patchaktualisierungen für Ihre Zuordnungen zu aktivieren. Durch die Aktivierung automatischer Patchaktualisierungen werden die neuesten Speichervorlagenrevisionen (Patches) automatisch angewendet. Sie müssen wichtige Aktualisierungen dennoch manuell anwenden.

  1. Listen Sie Ihre Satellite-Speicherkonfigurationen auf. Notieren Sie sich die Konfigurations-ID.

    ibmcloud sat storage assignment ls

  2. Führen Sie einen der folgenden Beispielbefehle aus, um automatische Patchaktualisierungen für Ihre Konfiguration und die zugehörigen Zuordnungen zu aktivieren. Geben Sie die Konfigurations-ID ein, die Sie im vorherigen Schritt abgerufen haben.

    Beispielbefehl zum Aktivieren automatischer Patchaktualisierungen für eine Zuordnung.

    ibmcloud sat storage assignment autopatch enable --config CONFIG  (--all | --assignment ASSIGNMENT-ID [--assignment ASSIGNMENT-ID])

    Beispielbefehl zum Aktivieren automatischer Patchaktualisierungen für alle Speicherzuordnungen in einer bestimmten Konfiguration.

    ibmcloud sat storage assignment autopatch enable --config CONFIG --all

    Beispielbefehl zum Inaktivieren der automatischen Patchaktualisierungen für alle Zuordnungen in einer bestimmten Konfiguration.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --all

    Beispielbefehl zum Inaktivieren von automatischen Patchaktualisierungen für eine einzelne Zuordnung und eine bestimmte Konfiguration

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID

    Beispielbefehl zum Inaktivieren automatischer Patchaktualisierungen für eine Mehrfachzuordnung und eine bestimmte Konfiguration.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID --assignment ASSIGNMENT-ID

Manuelles Upgrade von Konfigurationen in der Befehlszeilenschnittstelle

Sie können Ihre Satellite-Speicherkonfigurationen aktualisieren, um die neueste Version der Speichervorlage innerhalb derselben Hauptversion zu erhalten.

  1. Listen Sie Ihre Satellite-Speicherkonfigurationen auf und notieren Sie sich die Satellite-Konfiguration, für die Sie ein Upgrade durchführen wollen.

    ibmcloud sat storage config ls

  2. Führen Sie das Upgrade der Satellite-Konfiguration durch. Beachten Sie, dass nur die Konfiguration aktualisiert wird. Wenn Sie die Zuordnungen aktualisieren möchten, die diese Konfiguration verwenden, können Sie die Option --include-assignments angeben oder jede Zuordnung manuell mit dem Befehl assignment update aktualisieren.

    Beispielbefehl für ein Upgrade einer Konfiguration auf die neueste Überarbeitung.

    ibmcloud sat storage config upgrade --config CONFIG [--include-assignments]

    Beispielbefehl zum Aktualisieren einer Konfiguration und der zugehörigen Zuweisungen auf die neueste Version.

    ibmcloud sat storage config upgrade --config CONFIG --include-assignments

Upgrade für Konfiguration und Zuordnungen in der API durchführen

Sie können die /v2/storage/satellite/updateAssignment-API verwenden, um Ihre Zuordnungen mit neuen Clustern oder Clustergruppen zu aktualisieren. Setzen Sie updateConfigVersion auf true, um die Revisionsaktualisierung anzuwenden.

  1. Kopieren Sie die folgende Beispielanforderung und ersetzen Sie die Variablen für die Clustergruppen und Zuordnungen, die Sie aktualisieren wollen.

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/updateAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"groups\": [ \"CLUSTER-GROUPS\" ], \"name\": \"ASSIGNMENT-NAME\", \"updateConfigVersion\": true, \"uuid\": \"ASSIGNMENT-ID\"}"

  2. Führen Sie die Anforderung aus.

  3. Rufen Sie die Details Ihrer Zuordnung ab, um die Aktualisierung zu überprüfen.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"

Automatische Patchaktualisierungen für Zuordnungen in der API aktivieren

Sie können die /v2/storage/satellite/setAssignmentAutoupgrade-API verwenden, um automatische Patchaktualisierungen für Ihre Zuordnungen zu aktivieren. Durch die Aktivierung automatischer Patchaktualisierungen werden die neuesten Speichervorlagenrevisionen (Patches) automatisch angewendet. Sie müssen wichtige Aktualisierungen dennoch manuell anwenden.

  1. Kopieren Sie die folgende Beispielanforderung und ersetzen Sie die Variablen für die Clustergruppen und Zuordnungen, die Sie aktualisieren wollen.

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/setAssignmentAutoupgrade" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d { "config": "string", "controller": "string", "autopatch": boolean,"assignment" : { "all": boolean, "uuid": ["string", "string", ...], } }

  2. Führen Sie die Anforderung aus.

  3. Rufen Sie die Details Ihrer Zuordnung ab, um das Upgrade zu überprüfen.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"

Implementieren einer App, die Ihren Azure-Plattenspeicher verwendet

Sie können den Azure-Disk-Treiber verwenden, um PVCs zu erstellen, die Sie in Ihren Clusterworkloads verwenden können.

  1. Erstellen Sie ein PVC, das auf eine zuvor erstellte Azure-Disk-Speicherklasse verweist.

    apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: pvc-azuredisk
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  storageClassName: sat-azure-block-silver

  2. Erstellen Sie die PVC in Ihrem Cluster.

    oc apply -f pvc-azuredisk.yaml

  3. Überprüfen Sie, ob das PVC erzeugt wurde und der Status Bound ist.

    oc get pvc

  4. Erstellen Sie eine YAML-Konfigurationsdatei für eine statusabhängige Gruppe, die das von Ihnen erstellte PVC unterstützt.

    apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: statefulset-azuredisk
  labels:
    app: nginx
spec:
  podManagementPolicy: Parallel  # default is OrderedReady
  serviceName: statefulset-azuredisk
  replicas: 1
  template:
    metadata:
      labels:
        app: nginx
    spec:
      nodeSelector:
        "kubernetes.io/os": linux
      containers:
        - name: statefulset-azuredisk
          image: mcr.microsoft.com/oss/nginx/nginx:1.19.5
          command:
            - "/bin/bash"
            - "-c"
            - set -euo pipefail; while true; do echo $(date) >> /mnt/azuredisk/outfile; sleep 1; done
          volumeMounts:
            - name: persistent-storage
              mountPath: /mnt/azuredisk
  updateStrategy:
    type: RollingUpdate
  selector:
    matchLabels:
      app: nginx
  volumeClaimTemplates:
    - metadata:
        name: persistent-storage
        annotations:
          volume.beta.kubernetes.io/storage-class: sat-azure-block-silver
      spec:
        accessModes: ["ReadWriteOnce"]
        resources:
          requests:
            storage: 10Gi

  5. Erstellen Sie den Pod in Ihrem Cluster.

    oc apply -f statefulset-azuredisk.yaml

  6. Überprüfen Sie, ob der Pod bereitgestellt wurde. Beachten Sie, dass es einige Minuten dauern kann, bis Ihre App einen bestimmten Zustand Running erreicht.

    oc get pods

    NAME                                READY   STATUS    RESTARTS   AGE
statefulset-azuredisk       1/1     Running   0          2m58s

  7. Überprüfen Sie, ob die App auf Ihre Azure-Platte schreiben kann, indem Sie sich an Ihrem Pod anmelden.

    oc exec statefulset-azuredisk -it bash

  8. Zeigen Sie den Inhalt der Datei outfile an, um zu bestätigen, dass Ihre App Daten in Ihren persistenten Speicher schreiben kann.

    cat /mnt/azuredisk/outfile

    Beispielausgabe

    Fri Jul 16 07:49:39 EDT 2021
Fri Jul 16 07:49:39 EDT 2021
Fri Jul 16 07:49:39 EDT 2021

  9. Verlassen Sie den Pod.

    exit

Löschen von Azure Disk-Speicher aus Ihren Apps

Wenn Sie Ihre Azure-Disk-Konfiguration nicht mehr benötigen, können Sie Ihre Apps, PVCs, PVs und die Zuordnung aus Ihren Clustern entfernen.

  1. Listen Sie Ihre PVCs auf und notieren Sie den Namen der PVC, die Sie entfernen wollen.

    oc get pvc

  2. Entfernen Sie alle Pods, die den Persistent Volume Claim anhängen.

    1. Listen Sie alle Pods auf, die derzeit den PVC anhängen, den Sie löschen möchten. Wenn keine Pods zurückgegeben werden, haben Sie keine Pods, die Ihre PVC zurzeit verwenden.
        oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"
    ```
    Beispielausgabe


    ```sh {: screen}
    app    sat-azure-block-platinum
    ```
1. Entfernen Sie den Pod, der den PVC verwendet. Wenn der Pod Teil einer Bereitstellung oder eines StatefulSets ist, entfernen Sie die Bereitstellung oder das StatefulSet.

```sh {: pre}
    oc delete pod <pod_name>
    ```
    ```sh {: pre}
    oc delete deployment <deployment_name>
    ```
    ```sh {: pre}
    oc delete statefulset <statefulset_name>
    ```
1. Überprüfen Sie, ob der Pod, die Implementierung, oder das StatefulSet entfernt wurde.

```sh {: pre}
    oc get pods
    ```
    ```sh {: pre}
    oc get deployments
    ```
    ```sh {: pre}
    oc get statefulset
    ```

  3. Löschen Sie die PVC. Da alle Azure-Plattenspeicherklassen mit einer Wiederherstellungsrichtlinie 'Löschen' (Delete) angegeben sind, werden die PV-und die Platten in Ihrem Azure-Konto automatisch gelöscht, wenn Sie das PVC löschen.

    oc delete pvc <pvc_name>

  4. Überprüfen Sie, ob Ihr PV automatisch entfernt wurde.

    oc get pv

Speichern der Azure-Plattenspeicher-Konfiguration aus Ihrem Cluster

Wenn Sie die Verwendung von Azure Disk-Speicher in Ihrem Cluster nicht mehr planen, können Sie den Cluster über die Befehlszeilenschnittstelle aus der Speicherkonfiguration entfernen.

Wenn Sie die Speicherkonfiguration entfernen, wird der Treiber anschließend aus allen zugeordneten Clustern deinstalliert. Ihre PVCs, PVs und Daten werden nicht entfernt. Sie können jedoch erst wieder auf Ihre Daten zugreifen, wenn Sie den Treiber in Ihrem Cluster erneut installiert haben.

Azure Disk-Speicherkonfiguration aus der Konsole entfernen

  1. Wählen Sie im Dashboard für den Satellite-Speicher die Speicherkonfiguration aus, die gelöscht werden soll.
  2. Wählen Sie Aktionen > Löschen aus
  3. Geben Sie den Namen Ihrer Speicherkonfiguration ein.
  4. Wählen Sie Löschen aus.

Azure Disk-Speicherkonfiguration aus der Befehlszeilenschnittstelle entfernen

  1. Listen Sie Ihre Speicherzuweisungen auf und ermitteln Sie diejenige, die für Ihren Cluster verwendet wurde.

    ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)

  2. Entfernen Sie die Zuweisung. Nachdem die Zuordnung entfernt wurde, werden die Treiberpods und -Speicherklassen aus allen Clustern entfernt, die Teil der Speicherzuordnung waren.

    ibmcloud sat storage assignment rm --assignment <assignment_ID>

  3. Überprüfen Sie, ob der Treiber aus dem Cluster entfernt wurde.

    1. Listen Sie die Speicherklassen in Ihrem Cluster auf und überprüfen Sie, ob die Speicherklassen entfernt werden.
        oc get sc
    ```
2. Listen Sie die Pods im Namensbereich `kube-system` auf und überprüfen Sie, ob die Speichertreiber-Pods entfernt werden.

```sh {: pre}
    oc get pods -n kube-system | grep azure
    ```

  4. Optional: Entfernen Sie die Speicherkonfiguration.

    1. Listen Sie die Speicherkonfigurationen auf.
        ibmcloud sat storage config ls
    ```
2. Entfernen Sie die Speicherkonfiguration.

```sh {: pre}
    ibmcloud sat storage config rm --config <config_name>
    ```

Parameterreferenz

1.30.3 parameter-Referenz

Tabelle 1. Referenzwerte für die Parameter von „ 1.30.3 “
Anzeigename CLI-Option Typ Beschreibung Standardwert
Tenant-ID tenantId Secret Die Azure-Tenant-ID, die Sie für Ihre Konfiguration verwenden wollen. Ihre Mandanten-ID finden Sie im Azure-Portal oder durch Ausführen des az account tenant list Befehls. Nicht zutreffend
Abonnement-ID subscriptionId Secret Ihre Azure-Subskriptions-ID. Suchen Sie im Azure-Portal nach 'Abonnement', um eine Liste Ihrer Abonnements zu finden. Sie können Ihre Abonnement-ID auch ermitteln, indem Sie den az account subscription list Befehl ausführen. Nicht zutreffend
Client-ID für Azure Active Directory aadClientId Secret Ihre Azure Active Directory-Client-ID. Sie finden Ihre Client-ID im Portal Azure oder durch Ausführen des az ad sp list --display-name appDisplayName Befehls. Nicht zutreffend
Standort location Konfiguration Der Standort Ihres Azure-Hosts. Den Standort Ihrer virtuellen Maschinen finden Sie im Azure-Portal oder durch Ausführen des az vm list Befehls. Beispielstandort: 'useast'. Nicht zutreffend
Geheimer Clientschlüssel für Azure Active Directory aadClientSecret Secret Ihr geheimer Azure Active Directory-Clientschlüssel. Sie finden Ihren Client-Secret im Portal Azure im Menü App registrations. Nicht zutreffend
Ressourcengruppe resourceGroup Konfiguration Der Name der Azure-Ressourcengruppe. Die Details zu Ihrer Ressourcengruppe finden Sie im Azure-Portal oder durch Ausführen des az group list Befehls. Nicht zutreffend
Typ der virtuellen Maschine vmType Konfiguration Sie können Ihren virtuellen Maschinentyp im Portal Azure oder durch Ausführen des az vm list Befehls ermitteln. Beispieltypen: 'standard' oder 'VMSS' Nicht zutreffend
Name der Sicherheitsgruppe des Netzes securityGroupName Konfiguration Der Name Ihrer Sicherheitsgruppe. Die Details zu Ihrer Sicherheitsgruppe finden Sie im Azure-Portal oder durch Ausführen des az network nsg list Befehls. Nicht zutreffend
Name des virtuellen Netzes vnetName Konfiguration Der Name des virtuellen Netzes. Den Namen Ihres virtuellen Netzwerks finden Sie im Azure-Portal oder durch Ausführen des az network vnet list Befehls. Nicht zutreffend
Workload-Identität verwenden useWorkloadIdentity Konfiguration Setzen Sie diese Option auf 'true', wenn Sie Microsoft Entra Workload ID verwenden möchten. Falls aktiviert, müssen Sie auch die Client- und Tenant-ID für den Workload angeben. false
Workload-Identität Client-ID workloadIdentityClientId Secret Die Client-ID der Azure-Anwendung Active Directory (AAD) oder der benutzerzugewiesenen verwalteten Identität. Sie können die Client-ID der AAD-Anwendung ermitteln, indem Sie den Befehl az ad sp list --display-name APPLICATION_NAME --query '[0].appId' -otsv ausführen, und die Client-ID der dem Benutzer zugewiesenen verwalteten Identität, indem Sie den Befehl az identity show --name USER_ASSIGNED_IDENTITY_NAME --resource-group IDENTITY_RESOURCE_GROUP --query 'clientId' -otsv ausführen. Nicht zutreffend
Workload-Identität Mieter-ID workloadIdentityTenantId Secret Die Mandanten-ID der Azure-Anwendung Active Directory (AAD) oder der dem Benutzer zugewiesenen verwalteten Identität. Befindet sich die AAD-Anwendung oder die benutzerzugewiesene verwaltete Identität nicht im selben Mandanten wie der Cluster, legen Sie den Wert tenantID für die AAD-Anwendung bzw. die benutzerzugewiesene verwaltete Identität fest. Sie können die Tenant-ID der AAD-Anwendung ermitteln, indem Sie den Befehl az ad sp list --display-name APPLICATION_NAME --query '[0].appOwnerOrganizationId' -otsv ausführen, und die Tenant-ID der dem Benutzer zugewiesenen verwalteten Identität, indem Sie den Befehl az identity show --name USER_ASSIGNED_IDENTITY_NAME --resource-group IDENTITY_RESOURCE_GROUP --query 'tenantId' -otsv ausführen. Nicht zutreffend
Aktivieren Sie OpenTelemetry Tracing enableOtelTracing Konfiguration Setzen Sie den Wert auf true, wenn Sie die OpenTelemetry-Ablaufverfolgung aktivieren möchten. Wenn diese Option aktiviert ist, müssen Sie auch den Namen des OpenTelemetry-Dienstes und den Endpunkt des Exporteurs angeben. false
OpenTelemetry Dienst Name otelServiceName Konfiguration Name des Dienstes für die Rückverfolgung OpenTelemetry Nicht zutreffend
OpenTelemetry Exporter Endpunkt otelExporterEndpoint Konfiguration Endpunkt des OpenTelemetry Exporters Nicht zutreffend
Host-Netzwerk verwenden useHostNetwork Konfiguration Setzen Sie diesen Wert auf 'true', wenn Sie das Hostnetz verwenden wollen. Wenn aktiviert, wird der Endpunkt liveness-probe HTTP auf localhost an Port 29602 gesetzt. false

Speicherklassenreferenz für Azure-Platte

Speicherklassen-Referenz für Azure Disk-Speicher
Speicherklassenname IOPS-Bereich pro Platte Größenbereich Plattentyp Rückforderungsrichtlinie Datenträgerbindungsmodus
sat-azure-block-platinum 1200-160000 4 GiB-64 TiB SSD Löschen Sofort
sat-azure-block-platinum-metro 1200-160000 4 GiB-64 TiB SSD Löschen WaitForFirstConsumer
sat-azure-block-gold 120-20000 32 GiB-32 TiB SSD Löschen Sofort
sat-azure-block-gold-metro Standard 120-20000 32 GiB-32 TiB SSD Löschen WaitForFirstConsumer
sat-azure-block-silver 120-6000 Nicht zutreffend SSD Löschen Sofort
sat-azure-block-silver-metro 120-6000 Nicht zutreffend SSD Löschen WaitForFirstConsumer
sat-azure-block-bronze 500 - 2000 32 GiB-32 TiB HDD Löschen Sofort
sat-azure-block-bronze-metro 500 - 2000 32 GiB-32 TiB HDD Löschen WaitForFirstConsumer

Hilfe und Unterstützung für Azure-Plattenspeicher anfordern

Wenn Sie Azure Disk Storage verwenden, probieren Sie die folgenden Ressourcen aus, bevor Sie einen Support-Fall eröffnen.

  1. Lesen Sie die häufig gestellten Fragen im Azure Knowledge Center.
  2. Lesen Sie die Dokumentation zur Fehlerbehebung, um allgemeine Probleme zu beheben und zu beheben.
  3. Überprüfen Sie den Status der IBM Cloud-Plattform und der Ressourcen auf der Statusseite.
  4. Überprüfen Sie Stack Overflow, um festzustellen, ob andere Benutzer dasselbe Problem hatten. Versehen Sie Fragen mit den Tags ibm-cloud und Azure-Disk.
  5. Suchen Sie im Azure Service Portal nach weiteren Informationen.