Konfiguration des AWS EBS-Speichers für Satellite-Cluster

Richten Sie Amazon Elastic Block Storage(EBS) für IBM Cloud Satellite-Cluster ein, indem Sie an Ihrem Standort eine Speicherkonfiguration erstellen, um die dynamische Bereitstellung von Blockspeicher zu ermöglichen.

Bei der Erstellung Ihrer AWS EBS-Speicherkonfiguration geben Sie Ihre AWS-Berechtigungsnachweise an, die als geheimer Kubernetes-Schlüssel in den Clustern gespeichert sind, denen Sie Ihre Konfiguration zuweisen. Der geheime Schlüssel wird innerhalb des CSI-Controller-Pods angehängt, sodass Ihre AWS-Berechtigungsnachweise, wenn Sie eine Anforderung für persistenten Datenträger (PVC - Persistent Volume Claim) mithilfe einer der von IBM bereitgestellten Speicherklassen erstellen, zur dynamischen Einrichtung einer EBS-Instanz verwendet werden.

Zur Verwendung von AWS EBS-Speicher für Ihre Apps müssen sich die Satellite-Hosts, die Sie für die Workerknoten Ihres Clusters verwenden, in AWS befinden.

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 AWS EBS

Führen Sie die folgenden Tasks aus, um die AWS EBS-Speichervorlage zu verwenden:

  1. Erstellen Sie einen Satellite-Standort.

  2. Erstellen Sie einen Satellite-Cluster, der auf Rechenhosts in Amazon Web Services (AWS) 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. Weitere Informationen zum Hinzufügen von Hosts zu AWS an Ihrem Satellite-Standort, sodass sie einem Cluster hinzugefügt werden können, finden Sie unter AWS-Hosts zu Satellite hinzufügen.

  3. Erstellen Sie eine AWS-Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel für Ihre Anmeldedaten bei AWS. Diese Berechtigungsnachweise werden benötigt, um AWS EBS-Speicher in Ihrem Konto einzurichten. Wenn Sie die Speicherkonfiguration Ihrem Cluster zuweisen, werden Ihre AWS-Zugriffsschlüssel-ID und Ihr geheimer Zugriffsschlüssel in einem geheimen Kubernetes-Schlüssel auf Ihrem Cluster gespeichert.

  4. Prüfen Sie die Konfigurationsparameter für die AWS EBS-Speicherkonfiguration.

  5. Überprüfen Sie die AWS EBS Speicherklassen. Die Speichervorlage AWS EBS unterstützt keine benutzerdefinierten Speicherklassen.

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.55.0.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name aws-ebs-csi-driver --template-version 1.55.0 --param "aws-access-key=AWS-ACCESS-KEY"  --param "aws-secret-access-key=AWS-SECRET-ACCESS-KEY"

  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.55.0.

    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\": \"aws-ebs-csi-driver\", \"storage-template-version\": \"1.55.0\", \"update-assignments\": true, \"user-config-parameters\":\"user-secret-parameters\": { \"entry.name\": \"AWS-ACCESS-KEY\",{ \"entry.name\": \"AWS-SECRET-ACCESS-KEY\",}

Erstellen einer Zuweisung in der 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)

Speicherzuordnung in der API erstellen

  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 für ein Upgrade einer Konfiguration und der ihr zugeordneten Zuordnungen auf die letzte Überarbeitung.

    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"

App bereitstellen, die AWS EBS-Speicher verwendet

Sie können ebs-csi-driver verwenden, um AWS EBS-Speicher für die Apps in Ihren Clustern dynamisch einzurichten.

  1. Listen Sie die verfügbaren Speicherklassen auf und wählen Sie die Speicherklasse aus, die Sie verwenden wollen.

    oc get sc | grep ebs

    Um Details zu einer Speicherklasse anzuzeigen, verwenden Sie den Befehl oc describe sc <sc-name> oder überprüfen Sie die Speicherklassenreferenz.

  2. Erstellen Sie eine Anforderung für persistenten Datenträger (Persistent Volumes Claim - PVC), die eine AWS EBS-Speicherinstanz mit den Merkmalen einrichtet, die in der von Ihnen ausgewählten Speicherklasse beschrieben sind. Im folgenden Beispiel wird die Speicherklasse sat-aws-block-bronze verwendet, um eine HDD-AWS EBS-Speicherinstanz st1 mit einer Größe von 125 GB zu erstellen. Weitere Informationen zu diesem Speichertyp finden Sie unter Festplatten(HDD).

    apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: sat-aws-block-bronze
spec:
  accessModes:
  - ReadWriteOnce
  storageClassName: sat-aws-block-bronze
  resources:
    requests:
      storage: 125Gi

  3. Erstellen Sie die PVC in Ihrem Cluster.

    oc apply -f pvc.yaml

  4. Überprüfen Sie, ob Ihre PVC erstellt wurde. Da alle von IBM bereitgestellten Speicherklassen mit WaitForFirstConsumer konfiguriert werden, bleibt der Status Ihrer PVC so lange 'anstehend' (Pending), bis Sie eine App einrichten, die Ihre PVC anhängt.

    oc get pvc

    Beispielausgabe

    NAME                   STATUS    VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS           AGE
sat-aws-block-bronze   Pending                                      sat-aws-block-bronze   17s

  5. Erstellen Sie einen Pod, der den erstellten PVC anhängt. Wenn Sie diesen Pod erstellen, beginnt der AWS EBS-Treiber damit, Ihre Speicheranforderung zu erfüllen, indem er dynamisch eine AWS EBS-Instanz in Ihrem AWS-Konto erstellt. Im folgenden Beispiel wird ein Pod nginx erstellt, der das aktuelle Datum und die aktuelle Uhrzeit in eine Datei test.txt im Mountpfad Ihres AWS EBS-Datenträgers schreibt.

    apiVersion: v1
kind: Pod
metadata:
  name: app
spec:
  containers:
  - name: app
    image: nginx
    command: ["/bin/sh"]
    args: ["-c", "while true; do echo $(date -u) >> /test/test.txt; sleep 5; done"]
    volumeMounts:
      - name: persistent-storage
        mountPath: /test
  volumes:
  - name: persistent-storage
    persistentVolumeClaim:
        claimName: sat-aws-block-bronze

  6. Erstellen Sie den Pod in Ihrem Cluster.

    oc apply -f pod.yaml

  7. Überprüfen Sie, ob der Pod bereitgestellt wurde. Beachten Sie, dass es einige Minuten dauern kann, bis die Speicheranforderung bearbeitet ist und Ihre App in einen bestimmten Zustand Running wechselt.

    oc get pods

    Beispielausgabe

    NAME                                READY   STATUS    RESTARTS   AGE
app                                 1/1     Running   0          2m58s

  8. Überprüfen Sie, ob Ihre PVC in den Status 'Gebunden' (Bound) gewechselt hat.

    oc get pvc

    Beispielausgabe

    NAME                 STATUS  VOLUME                                   CAPACITY   ACCESS MODES   STORAGECLASS           AGE
sat-aws-block-bronze Bound   pvc-86d2f9f4-78d4-4bb2-ab73-39726d144981 125Gi      RWO            sat-aws-block-bronze   33m

    Wenn Ihr PVC den Status Pending hat, rufen Sie die Details für Ihren PVC ab, indem Sie den Befehl oc describe pvc <pvc_name> ausführen, um den Fehler anzuzeigen, der während der Bereitstellung Ihrer AWS-EBS-Speicherinstanz aufgetreten ist.

  9. Überprüfen Sie, ob die App auf Ihre AWS EBS-Instanz schreiben kann.

    1. Melden Sie sich bei Ihrem Pod an.
        oc exec <app_pod_name> -it bash
    ```
2. Zeigen Sie den Inhalt der Datei `test.txt` an, um sich zu vergewissern, dass Ihre App Daten auf Ihren persistenten Speicher schreiben kann.
```sh {: pre}
    cat /test/test.txt
    ```
    Beispielausgabe
    ```sh {: screen}
    Tue Mar 2 20:09:19 UTC 2021
    Tue Mar 2 20:09:25 UTC 2021
    Tue Mar 2 20:09:31 UTC 2021
    Tue Mar 2 20:09:36 UTC 2021
    Tue Mar 2 20:09:42 UTC 2021
    Tue Mar 2 20:09:47 UTC 2021
    ```
3. Verlassen Sie den Pod.
```sh {: pre}
    exit
    ```

  10. Überprüfen Sie, ob Ihre Speicherinstanz in AWS erstellt wurde.

    1. Listen Sie den persistenten Datenträger (PV - Persistent Volume) auf, der für Ihre PVC erstellt wurde.
        oc get pv
    ```
2. Rufen Sie die Details zu Ihrem PV ab und notieren Sie die ID Ihrer erstellten AWS EBS-Instanz im Feld `source.volumeHandle`.
```sh {: pre}
    oc describe pv <pv_name>
    ```
3. Wählen Sie im [Dashboard AWS EC2 die Option](https://console.aws.amazon.com/ec2/v2/home){: external} **Elastic Block Store** > **Volumes** aus.
4. Suchen Sie Ihren AWS EBS-Datenträger über die ID, die Sie zuvor abgerufen haben.

AWS EBS-Speicher aus den Apps entfernen

Wenn Sie Ihre AWS EBS-Instanz nicht mehr benötigen, können Sie Ihre PVC, Ihren PV und Ihre AWS EBS-Instanz aus Ihrem AWS-Konto entfernen.

Durch das Entfernen der AWS EBS-Instanz werden alle Daten entfernt, die auf dieser Instanz gespeichert sind. Diese Aktion kann nicht rückgängig gemacht werden. Stellen Sie sicher, dass Sie Ihre Daten sichern, bevor Sie die AWS EBS-Instanz löschen.

  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-aws-block-bronze
    ```
2. Entfernen Sie den Pod, der den PVC verwendet. Wenn der Pod Teil einer Bereitstellung ist, entfernen Sie die Bereitstellung.
```sh {: pre}
    oc delete pod <pod_name>
    ```
    ```sh {: pre}
    oc delete deployment <deployment_name>
    ```
3. Überprüfen Sie, ob der Pod bzw. die Bereitstellung entfernt wurde.
```sh {: pre}
    oc get pods
    ```
    ```sh {: pre}
    oc get deployments
    ```
  3. Löschen Sie die PVC. Da alle von IBM bereitgestellten AWS EBS-Klassen mit der Rückforderungsrichtlinie 'Löschen' (Delete) angegeben sind, werden der PV und die AWS EBS-Instanz in Ihrem AWS-Konto automatisch gelöscht, wenn Sie die PVC löschen.
    oc delete pvc <pvc_name>
  4. Überprüfen Sie, ob Ihr Speicher entfernt wurde.
    1. Überprüfen Sie, ob Ihr PV automatisch entfernt wurde.
        oc get pv
    ```
2. Wählen Sie im [Dashboard AWS EC2 die Option](https://console.aws.amazon.com/ec2/v2/home){: external} **Elastic Block Store** > **Volumes** aus und vergewissern Sie sich, dass Ihre AWS EBS-Instanz entfernt wurde.

AWS EBS-Speicherkonfiguration aus dem Cluster entfernen

Wenn Sie nicht länger beabsichtigen, AWS EBS-Speicher in Ihrem Cluster zu verwenden, können Sie die Zuweisung Ihres Clusters zu der Speicherkonfiguration aufheben.

Beachten Sie, dass Sie Ihre Speicherzuordnungen löschen müssen, bevor Sie Ihre Speicherkonfiguration löschen können.

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.

Eine 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.
  3. Geben Sie den Namen Ihrer Speicherkonfiguration ein.
  4. Wählen Sie Löschen aus.

AWS EBS-Speicherkonfiguration über die Befehlszeilenschnittstelle entfernen

Verwenden Sie die CLI, um die Speicherkonfiguration AWS EBS zu entfernen.

Beachten Sie, dass Sie Ihre Speicherzuordnungen löschen müssen, bevor Sie Ihre Speicherkonfiguration löschen können.

  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. Wenn die Zuweisung entfernt wird, werden die AWS EBS-Treiberpods und -Speicherklassen aus allen Clustern entfernt, die Teil der Speicherzuweisung waren.
    ibmcloud sat storage assignment rm --assignment <assignment_ID>
  3. Überprüfen Sie, ob der AWS EBS-Treiber aus dem Cluster entfernt wurde.
    1. Listen Sie die Speicherklassen in Ihrem Cluster auf und überprüfen Sie, ob die AWS EBS-Speicherklassen entfernt wurden.
        oc get sc
    ```
2. Listen Sie die Pods im Namensbereich `kube-system` auf und überprüfen Sie, ob die AWS EBS-Speichertreiberpods entfernt wurden.
```sh {: pre}
    oc get pods -n kube-system | grep ebs
    ```
3. Listen Sie die geheimen Schlüssel im Namensbereich `kube-system` auf und überprüfen Sie, ob der geheime AWS-Schlüssel, in dem Ihre AWS-Berechtigungsnachweise gespeichert wurden, entfernt wurde.
```sh {: pre}
    oc get secrets -n kube-system | grep aws
    ```
  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.55.0 parameter-Referenz

Tabelle 1. Referenzwerte für die Parameter von „ 1.55.0 “
Anzeigename CLI-Option Typ Beschreibung Standardwert
ID des AWS-Zugriffsschlüssels aws-access-key Secret ID des AWS-Zugriffsschlüssels. Nicht zutreffend
Geheimer AWS-Zugriffsschlüssel aws-secret-access-key Secret Geheimer AWS -Zugriffsschlüssel. Nicht zutreffend

Referenz der Speicherklasse für AWS EBS

Prüfen Sie die Informationen zu den Satellite-Speicherklassen für AWS EBS. Sie können Speicherklassen in der Befehlszeile mit dem Befehl oc describe sc <storage-class-name> beschreiben. Beachten Sie, dass Datenvolumen automatisch von einem verwalteten Standardschlüssel von AWS verschlüsselt werden. Weitere Informationen finden Sie unter Standard-KMS-Schlüssel für die Verschlüsselung von EBS. Weitere Informationen zur Verschlüsselung von AWS EBS finden Sie unter So funktioniert die Verschlüsselung von AWS EBS.

AWS EBS-Speicherklassenreferenz.
Speicherklassenname EBS-Datenträgertyp Dateisystemtyp Bereitsteller (Provisioner) Standardwert für E/A-Operationen pro Sekunde (IOPS) pro GB Größenbereich Festplatte Verschlüsselt? Datenträgerbindungsmodus Rückforderungsrichtlinie Weitere Informationen
sat-aws-block-gold Standard io2 ext4 ebs.csi.aws.com 10 10 GiB - 6,25 TiB SSD Ja WaitforFirstConsumer Löschen Link
sat-aws-block-silver gp3 ext4 ebs.csi.aws.com Nicht zutreffend 1 GiB - 16 TiB SSD Ja WaitforFirstConsumer Löschen Link
sat-aws-block-bronze st1 ext4 ebs.csi.aws.com Nicht zutreffend 125 GiB - 16 TiB HDD Ja WaitforFirstConsumer Löschen Link
sat-aws-block-bronze-metro st1 ext4 ebs.csi.aws.com Nicht zutreffend 125 GiB - 16 TiB HDD Ja WaitforFirstConsumer Löschen Link
sat-aws-block-silver-metro gp3 ext4 ebs.csi.aws.com 1 GiB - 16 TiB SSD Ja WaitforFirstConsumer Löschen Link
sat-aws-block-gold-metro io2 ext4 ebs.csi.aws.com 10 10 GiB - 6,25 TiB SSD Ja WaitforFirstConsumer Löschen Link

Hilfe und Unterstützung erhalten für AWS EBS

Wenn Sie AWS EBS Storage verwenden, probieren Sie die folgenden Ressourcen aus, bevor Sie einen Supportfall eröffnen.

  1. Lesen Sie die häufig gestellten Fragen im AWS 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 AWS-EBS.
  5. Das AWS Support Center ist eine weitere Ressource für AWS-Kunden, die nach detaillierteren Unterstützungsoptionen suchen.