Operator für lokalen Speicher - Blockspeicher

Einrichten von persistenten Speichermedien mithilfe lokaler Volumes für IBM Cloud Satellite®-Cluster. Zum Erstellen von Speicherkonfigurationen können Sie Satellite-Speichervorlagen verwenden. Wenn Sie Ihren Clustern eine Speicherkonfiguration zuweisen, werden die Speichertreiber des ausgewählten Speicherproviders auf Ihrem Cluster installiert.

Wenn Sie eine Speicherkonfiguration für lokalen Blockspeicher erstellen, geben Sie die Pfade der lokalen Blockspeichereinheiten an, die Sie als persistente Datenträger (PVs - Persistent Volumes) in Ihren Clustern verfügbar machen wollen. Nach der Zuweisung der Speicherkonfiguration zu einem Cluster stellt Satellite den Operator für lokalen Speicher bereit, der die lokalen Platten anhängt, die Sie in der Konfiguration angegeben haben. Der Operator erstellt weiterhin die lokalen persistenten Datenträger (PVs) und erstellt die Speicherklasse sat-local-block-gold, mit deren Hilfe Sie Anforderungen für persistente Datenträger (Persistent Volumes Claims - PVCs) erstellen können. Anschließend können Sie in Ihren Kubernetes-Workloads auf diese PVCs verweisen.

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 lokalem Blockspeicher

Bevor Sie eine Speicherkonfiguration für lokalen Blockspeicher erstellen können, müssen Sie die Workerknoten in Ihren Clustern ermitteln, die die erforderlichen verfügbaren Platten haben. Versehen Sie diese Workerknoten anschließend mit Bezeichnungen (Labels), sodass die Treiber für lokalen Speicher nur auf diesen Workerknoten installiert werden.

Erstellen Sie einen Satellite-Standort.
Stellen Sie sicher, dass die Workerknoten in Ihrem Cluster, die Sie in Ihrer Speicherkonfiguration verwenden wollen, mindestens eine lokale Platte zusätzlich zu den Platten haben, die für Satellite erforderlich sind. Die zusätzlichen Platten müssen unformatiert sein.
Rufen Sie die Einheitendetails Ihrer Workerknoten ab.
Versehen Sie die Workerknoten mit einer Bezeichnung, die eine verfügbare Platte haben und die Sie in Ihrer Konfiguration verwenden wollen. Die lokalen Speichertreiber werden nur auf den markierten Worker-Knoten installiert.

Einheitendetails für die Speicherkonfiguration des lokalen Blockspeichers abrufen

Wenn Sie Ihre Speicherkonfiguration für lokalen Blockspeicher erstellen, müssen Sie die Einheiten angeben, die Sie verwenden wollen. Die Einheitenpfade, die Sie in den folgenden Schritten abrufen, werden bei der Erstellung Ihrer Konfiguration als Parameter angegeben.

Melden Sie sich bei Ihrem Cluster an und rufen Sie eine Liste der verfügbaren Workerknoten ab. Notieren Sie die Workerknoten, die Sie in Ihrer Konfiguration verwenden wollen.
```
oc get nodes
```
Melden Sie sich bei jedem Workerknoten an, den Sie für die Speicherkonfiguration Ihres lokalen Speichers verwenden wollen.
```
oc debug node/<node-name>
```

Wenn der Debug-Pod auf dem Workerknoten bereitgestellt wurde, führen Sie die folgenden Befehle aus, um die verfügbaren Platten auf dem Workerknoten aufzulisten.

Lassen Sie Host-Binärdateien zu.

    chroot /host
    ```
1. Listen Sie Ihre Geräte auf.

```sh {: pre}
    lsblk
    ```
1. Rufen Sie die Details zu Ihren Einheiten ab. Vergewissern Sie sich, dass die Einheiten, die Sie verwenden wollen, nicht angehängt und unformatiert sind.

```sh {: pre}
    fdisk -l
    ```

Listen Sie die verfügbaren Blockspeicherplatten auf Ihrem Workerknoten auf. Sie müssen nicht angehängte Platten für die lokale Speicherkonfiguration verwenden. In der folgenden Beispielausgabe für den Befehl lsblk ist die Platte nvme2n1 nicht angehängt und hat keine Partitionen.
```
NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
nvme0n1     259:3    0   100G  0 disk
|-nvme0n1p1 259:4    0     1M  0 part
`-nvme0n1p2 259:5    0   100G  0 part /
nvme1n1     259:0    0    20G  0 disk
nvme2n1     259:1    0    20G  0 disk
nvme3n1     259:2    0 139.7G  0 disk /var/data
```
Wiederholen Sie die vorherigen Schritte für jeden Workerknoten, den Sie für die Speicherkonfiguration Ihres lokalen Blockspeichers verwenden wollen.

Workerknoten bei Verwendung von lokalem Blockspeicher kennzeichnen

Nachdem Sie die Einheitenpfade für die Platten abgerufen haben, die Sie in Ihrer Konfiguration verwenden wollen, versehen Sie die Workerknoten, auf denen sich die Platten befinden, mit Bezeichnungen (Labels).

Rufen Sie die IP-Adressen der Workerknoten ab.
```
oc get nodes
```
Versehen Sie die Workerknoten, die Sie abgerufen haben, mit einer Bezeichnung. Die Treiber für lokalen Speicher werden auf den Workerknoten mit dieser Bezeichnung bereitgestellt. Sie können die Bezeichnung storage=local-block im Beispielbefehl verwenden oder Sie können eine eigene Bezeichnung im Format key=value erstellen.
```
oc label nodes <worker-IP> <worker-IP> <worker-IP> "storage=local-block"
```
Beispielausgabe
```
node/<worker-IP> labeled
node/<worker-IP> labeled
node/<worker-IP> labeled
```
Überprüfen Sie, ob die Bezeichnung den Workerknoten hinzugefügt wurde, die Sie verwenden wollen. Führen Sie den folgenden Befehl aus, um die Bezeichnungen auf Ihren Workerknoten anzuzeigen und die Bezeichnung hervorzuheben, die Sie im vorherigen Schritt hinzugefügt haben.
```
oc get nodes --show-labels | grep --color=always storage=local-block
```

Konfiguration in der Konsole erstellen und zuordnen

Überprüfen Sie die Parameterreferenz.
Wählen Sie in der Standortkonsole den Standort aus, an dem Sie eine Speicherkonfiguration erstellen möchten.
Wählen Sie Speicher > Speicherkonfiguration erstellen aus
Geben Sie einen Namen für Ihre Konfiguration ein.
Wählen Sie den Speichertyp aus.
Wählen Sie die Version aus und klicken Sie auf Weiter
Wenn der von Ihnen ausgewählte Speichertyp benutzerdefinierte Parameter akzeptiert, geben Sie sie auf der Registerkarte Parameter ein.
Wenn der von Ihnen ausgewählte Speichertyp geheime Schlüssel erfordert, geben Sie sie auf der Registerkarte Geheime Schlüssel ein.
Überprüfen Sie auf der Registerkarte Speicherklassen die Speicherklassen, die von der Konfiguration implementiert werden, oder erstellen Sie eine angepasste Speicherklasse.
Wählen Sie auf der Registerkarte Service zuordnen den Service aus, dem Sie Ihre Konfiguration zuordnen wollen.
Klicken Sie auf Abschließen, um Ihre Speicherkonfiguration zuzuordnen.

Erstellen einer Konfiguration in der Befehlszeilenschnittstelle (CLI)

Überprüfen Sie die Parameterreferenz für die Vorlagenversion, die Sie verwenden wollen.
Melden Sie sich bei der IBM Cloud-CLI an.
```
ibmcloud login
```
Listen Sie Ihre Satellite Standorte auf und notieren Sie die Spalte Managed from .
```
ibmcloud sat location ls
```
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
```
Wenn Sie eine andere Ressourcengruppe als defaultverwenden, wählen Sie sie aus.
```
ibmcloud target -g RESOURCE_GROUP
```

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

ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-volume-block --template-version 4.9 --param "auto-discover-devices=AUTO-DISCOVER-DEVICES"  --param "label-key=LABEL-KEY"  --param "label-value=LABEL-VALUE"  --param "devicepath=DEVICEPATH"

Beispielbefehl zum Erstellen einer Konfiguration der Version 4.10.

ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-volume-block --template-version 4.10 --param "auto-discover-devices=AUTO-DISCOVER-DEVICES"  --param "label-key=LABEL-KEY"  --param "label-value=LABEL-VALUE"  --param "devicepath=DEVICEPATH"

Beispielbefehl zum Erstellen einer Konfiguration der Version 4.11.

ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-volume-block --template-version 4.11 --param "auto-discover-devices=AUTO-DISCOVER-DEVICES"  --param "label-key=LABEL-KEY"  --param "label-value=LABEL-VALUE"  --param "devicepath=DEVICEPATH"

Beispielbefehl zum Erstellen einer Konfiguration der Version 4.12.

ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-volume-block --template-version 4.12 --param "auto-discover-devices=AUTO-DISCOVER-DEVICES"  --param "label-key=LABEL-KEY"  --param "label-value=LABEL-VALUE"  --param "devicepath=DEVICEPATH"

Beispielbefehl zum Erstellen einer Konfiguration der Version 4.13.

ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-volume-block --template-version 4.13 --param "auto-discover-devices=AUTO-DISCOVER-DEVICES"  --param "label-key=LABEL-KEY"  --param "label-value=LABEL-VALUE"  --param "devicepath=DEVICEPATH"

Passen Sie den Befehl basierend auf den Einstellungen an, die Sie verwenden möchten.
Führen Sie den Befehl aus, um eine Konfiguration zu erstellen.
Überprüfen Sie, ob Ihre Konfiguration erstellt wurde.
```
ibmcloud sat storage config get --config CONFIG
```

Erstellen einer Konfiguration in der Anwendungsprogrammierschnittstelle (API)

Generieren Sie einen API-Schlüssel und fordern Sie anschließend ein Aktualisierungstoken an. Weitere Informationen finden Sie unter Erstellen eines IAM-Tokens(IBM Cloud Identity and Access Management)mithilfe eines API-Schlüssels.
Überprüfen Sie die Parameterreferenz für die Vorlagenversion, die Sie verwenden wollen.

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

Beispielanforderung zum Erstellen einer Konfiguration der Version 4.9.

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\": \"local-volume-block\", \"storage-template-version\": \"4.9\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"AUTO-DISCOVER-DEVICES\", { \"entry.name\": \"LABEL-KEY\", { \"entry.name\": \"LABEL-VALUE\", { \"entry.name\": \"DEVICEPATH\",\"user-secret-parameters\": }

Beispielanforderung zum Erstellen einer Konfiguration der Version 4.10.

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\": \"local-volume-block\", \"storage-template-version\": \"4.10\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"AUTO-DISCOVER-DEVICES\", { \"entry.name\": \"LABEL-KEY\", { \"entry.name\": \"LABEL-VALUE\", { \"entry.name\": \"DEVICEPATH\",\"user-secret-parameters\": }

Beispielanforderung zum Erstellen einer Konfiguration der Version 4.11.

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\": \"local-volume-block\", \"storage-template-version\": \"4.11\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"AUTO-DISCOVER-DEVICES\", { \"entry.name\": \"LABEL-KEY\", { \"entry.name\": \"LABEL-VALUE\", { \"entry.name\": \"DEVICEPATH\",\"user-secret-parameters\": }

Beispielanforderung zum Erstellen einer Konfiguration der Version 4.12.

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\": \"local-volume-block\", \"storage-template-version\": \"4.12\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"AUTO-DISCOVER-DEVICES\", { \"entry.name\": \"LABEL-KEY\", { \"entry.name\": \"LABEL-VALUE\", { \"entry.name\": \"DEVICEPATH\",\"user-secret-parameters\": }

Beispielanforderung zum Erstellen einer Konfiguration der Version 4.13.

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\": \"local-volume-block\", \"storage-template-version\": \"4.13\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"AUTO-DISCOVER-DEVICES\", { \"entry.name\": \"LABEL-KEY\", { \"entry.name\": \"LABEL-VALUE\", { \"entry.name\": \"DEVICEPATH\",\"user-secret-parameters\": }

Erstellen einer Zuweisung in der Befehlszeilenschnittstelle (CLI)

Listen Sie Ihre Speicherkonfigurationen auf und notieren Sie sich die Speicherkonfiguration, die Sie Ihren Clustern zuweisen möchten.
```
ibmcloud sat storage config ls
```
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
```
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
```

Ü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)

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\"}"

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

Ü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"

Zuordnungen in der Befehlszeilenschnittstelle manuell aktualisieren

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

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
```
Listen Sie die Satellite-Speichervorlagen auf, um die neuesten verfügbaren Versionen anzuzeigen.
```
ibmcloud sat storage template ls
```
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.

Listen Sie Ihre Satellite-Speicherkonfigurationen auf. Notieren Sie sich die Konfigurations-ID.
```
ibmcloud sat storage assignment ls
```
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
```

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.

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\"}"

Führen Sie die Anforderung aus.

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"

Bereitstellung einer App, die lokalen Blockspeicher nutzt

Nachdem Sie eine Speicherkonfiguration für lokalen Blockspeicher erstellt und Ihren Clustern zugewiesen haben, können Sie eine App erstellen, die Ihren lokalen Blockspeicher verwendet.

Sie können Ihre PVCs bestimmten persistenten Datenträgern (PVs) zuordnen, indem Sie Ihre persistenten Datenträger mit Bezeichnungen versehen. Weitere Informationen finden Sie in der Kubernetes-Dokumentation für Selektoren.

Speichern Sie die folgende YAML-Datei mit dem Namen local-pvc.yaml für Ihre PVC auf Ihrer lokalen Maschine.

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: local-pvc
spec:
  accessModes:
  - ReadWriteOnce
  volumeMode: Block
  resources:
  requests:
    storage: 20Gi # Important: Ensure that size of your claim is not larger than the local disk.
  storageClassName: sat-local-block-gold

Erstellen Sie die PVC in Ihrem Cluster.
```
oc create -f local-pvc.yaml
```
Überprüfen Sie, ob Ihre PVC erstellt wurde. Beachten Sie, dass die Speicherklasse volumeBindingMode den Wert sat-local-block-gold für den Datenträgerbindungsmodus (waitForFirstConsumer) hat.
```
oc get pvc | grep local
```
Um sicherzustellen, dass Ihre Pods auf Worker-Knoten mit Speicher terminiert werden, oder um sicherzustellen, dass die Apps, für die Speicher erforderlich ist, nicht von anderen Pods verprellt werden, können Sie nodeAffinity angeben und die Pods-Priorität festlegen. Weitere Informationen finden Sie in der Kubernetes-Dokumentation für pod priority and preemption und Einstellung für Knotenaffinität.

Stellen Sie einen App-Pod bereit, der Ihre PVC für lokalen Speicher verwendet. Speichern Sie das folgende Beispiel eines YAML-Codes für eine App als Datei mit dem Namen app.yaml auf Ihrer lokalen Maschine. In diesem Beispiel stellt die Angabe für nodeAffinity sicher, dass dieser Pod nur auf einem Workerknoten geplant wird, der die angegebene Bezeichnung (Label) besitzt.

apiVersion: v1
kind: Pod
metadata:
  name: app
spec:
  affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
      - matchExpressions:
        - key: storage # Enter the 'key' of the worker node label created earlier.
          operator: In
          values:
          - local-block # Enter the 'value' of the worker label that you created earlier.
  containers:
    - name: nginx
      image: nginx
      volumeDevices:
        - name: data
          devicePath: "/dev/nvme2n1" # Enter the path to your local device.
  volumes:
    - name: data
      persistentVolumeClaim:
      claimName: local-pvc

Erstellen Sie den App-Pod in Ihrem Cluster.
```
oc create -f app.yaml
```
Melden Sie sich bei Ihrem App-Pod an und überprüfen Sie, ob Sie auf Ihre lokale Platte schreiben können.
```
kubectl exec <pod_name> -it bash
```
Wechseln Sie in den Ordner dev.
```
cd dev
```
Führen Sie den Befehl ls -lR <device-path> aus, um Ihre Gerätedetails zu überprüfen und um sicherzustellen, dass Ihr App-Pod über Lese- und Schreibberechtigungen für Ihr Blockgerät verfügt. Das wird durch brw in der Befehlsausgabe angegeben.
```
ls -lR /dev/nvme2n1
```
Beispielausgabe
```
brw-rw-rw-. 1 root disk 202, 32 Mar  3 21:24 /dev/nvme2n1
```

Optional: Führen Sie die folgenden Befehle aus, um Daten auf Ihre Blockeinheit zu schreiben.

Schreiben Sie auf "block_data" das lokale Speichergerät, das Sie in Ihrer App eingebunden haben. Ersetzen Sie <device-path> durch den Pfad zu Ihrem Speichermedium. Beispiel: /dev/nvme2n1.

    kubectl exec <pod_name> -- bash -c "echo "block_data" | dd conv=unblock of=<device-path>"
    ```
2. Überprüfen Sie, ob die Daten auf Ihre Einheit geschrieben wurden. Ersetzen Sie `<device-path>` durch den Pfad für die Speichereinheit. Beispiel: `/dev/nvme2n1`.

```sh {: pre}
    kubectl exec <pod_name> -- bash -c "od -An -c -N 10 <device-path>"
    ```
    Beispielausgabe

    ```sh {: screen}
    b   l   o   c   k   _   d   a   t   a
    ```

Löschen Sie den Testpod (test).
```
oc delete pod <pod_name>
```

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.

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
```
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
```

Speicherzuordnungen in der Konsole aktualisieren

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

Wählen Sie auf der Seite Positionen in der Satellite-KonsoleIhren Standort aus.
Klicken Sie auf die Registerkarte Speicher, um Ihre Konfigurationen anzuzeigen.
Klicken Sie auf die Konfiguration, die Sie aktualisieren möchten.
Klicken Sie auf das Informationssymbol Informationen (i), um die letzte Überarbeitung oder Programmkorrektur anzuwenden.
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.

Lokale Blockspeicherkonfiguration aus dem Cluster entfernen

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

Wenn Sie die Speicherkonfiguration entfernen, werden die Ressourcen des Operators für lokalen Speicher und die Speicherklasse sat-local-block-gold 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.

Lokale Blockspeicherkonfiguration über die Konsole entfernen

Verwenden Sie die Konsole, um eine Speicherkonfiguration zu entfernen.

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

Lokale Blockspeicherkonfiguration über die Befehlszeile entfernen

Listen Sie die Ressourcen im Namensbereich local-storage auf. Wenn Sie Ihre Speicherzuweisung löschen, werden diese Ressourcen entfernt.

oc get all -n local-storage

Beispielausgabe

NAME                                         READY   STATUS    RESTARTS   AGE
pod/local-disk-local-diskmaker-clvg6         1/1     Running   0          29h
pod/local-disk-local-diskmaker-kqddq         1/1     Running   0          29h
pod/local-disk-local-diskmaker-p6z9q         1/1     Running   0          29h
pod/local-disk-local-provisioner-dw5g7       1/1     Running   0          29h
pod/local-disk-local-provisioner-hxd9n       1/1     Running   0          29h
pod/local-disk-local-provisioner-tfg95       1/1     Running   0          29h
pod/local-storage-operator-df4994656-7826l   1/1     Running   0          29h
NAME                             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)     AGE
service/local-storage-operator   ClusterIP   172.21.147.17   <none>        60000/TCP   29h
NAME                                          DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
daemonset.apps/local-disk-local-diskmaker     3         3         3       3            3           <none>          29h
daemonset.apps/local-disk-local-provisioner   3         3         3       3            3           <none>          29h
NAME                                     READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/local-storage-operator   1/1     1            1           29h
NAME                                               DESIRED   CURRENT   READY   AGE
replicaset.apps/local-storage-operator-df4994656   1         1         1       29h

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)

Entfernen Sie die Zuweisung. Wenn die Zuweisung entfernt wird, werden die Treiberpods und Speicherklassen für den lokalen Speicher aus allen Clustern entfernt, die Teil der Speicherzuweisung waren.
```
ibmcloud sat storage assignment rm --assignment <assignment_ID>
```
Listen Sie die Ressourcen im Namensbereich local-storage auf und überprüfen Sie, ob die Treiberpods für den lokalen Speicher entfernt wurden.
```
oc get all -n local-storage
```
Beispielausgabe
```
No resources found in local-storage namespace.
```
Listen Sie die Speicherklassen in Ihrem Cluster auf und überprüfen Sie, ob die Speicherklassen für den lokalen Speicher entfernt wurden.
```
oc get sc
```

Optional: Entfernen Sie die Speicherkonfiguration.

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>
    ```

Listen Sie Ihre PVCs auf und notieren Sie den Namen der PVC, die Sie entfernen wollen.
```
oc get pvc
```

Entfernen Sie alle Pods, die die PVC zurzeit anhängen.

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-local-block-gold
    ```

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
    ```

Löschen Sie die PVC. Da alle von IBM bereitgestellten Speicherklassen für lokalen Blockspeicher mit der Rückforderungsrichtlinie 'Beibehalten' (Retain) angegeben sind, werden der PV und die PVC nicht automatisch gelöscht, wenn Sie Ihre App oder Bereitstellung löschen.
```
oc delete pvc <pvc-name>
```
Überprüfen Sie, ob Ihre PVC entfernt wurde.
```
oc get pvc
```
Listen Sie Ihre PVs auf und notieren Sie den Namen der PVs, die Sie entfernen wollen.
```
oc get pv
```
Löschen Sie die PVs. Durch das Löschen der PVs werden Ihre Platten für andere Workloads verfügbar gemacht.
```
oc delete pv <pv-name>
```
Überprüfen Sie, ob Ihr PV entfernt wurde.
```
oc get pv
```

Parameterreferenz

4.9 Parameterreferenz

Tabelle 1. 4.9 Parameter-Referenz
Anzeigename	CLI-Option	Typ	Beschreibung	Standardwert
Automatische Erkennung von Speicherdatenträgern	`auto-discover-devices`	Konfiguration	Setzen Sie den Wert auf 'true', wenn die Speicherdatenträger auf Ihren Workerknoten automatisch erkannt und verwendet werden sollen.	`false`
Schlüssel für Knotenbezeichnung	`label-key`	Konfiguration	Der 'Schlüssel'-Teil der Bezeichnung 'Schlüssel=Wert' des Workerknotens.	Nicht zutreffend
Schlüsselwert für Knotenbezeichnung	`label-value`	Konfiguration	Der 'Wert'-Teil der Bezeichnung 'Schlüssel=Wert' des Workerknotens.	Nicht zutreffend
Einheitenpfad	`devicepath`	Konfiguration	Der Pfad der lokalen Speichereinheit. Beispiel: '/dev/sdc'. Erforderlich, wenn 'auto-discover-devices' auf 'false' gesetzt ist.	Nicht zutreffend

4.10 Parameterreferenz

Tabelle 2. 4.10 Parameter-Referenz
Anzeigename	CLI-Option	Typ	Beschreibung	Standardwert
Automatische Erkennung von Speicherdatenträgern	`auto-discover-devices`	Konfiguration	Setzen Sie den Wert auf 'true', wenn die Speicherdatenträger auf Ihren Workerknoten automatisch erkannt und verwendet werden sollen.	`false`
Schlüssel für Knotenbezeichnung	`label-key`	Konfiguration	Der 'Schlüssel'-Teil der Bezeichnung 'Schlüssel=Wert' des Workerknotens.	Nicht zutreffend
Schlüsselwert für Knotenbezeichnung	`label-value`	Konfiguration	Der 'Wert'-Teil der Bezeichnung 'Schlüssel=Wert' des Workerknotens.	Nicht zutreffend
Einheitenpfad	`devicepath`	Konfiguration	Der Pfad der lokalen Speichereinheit. Beispiel: '/dev/sdc'. Erforderlich, wenn 'auto-discover-devices' auf 'false' gesetzt ist.	Nicht zutreffend

4.11 Parameterreferenz

Tabelle 3. 4.11 Parameter-Referenz
Anzeigename	CLI-Option	Typ	Beschreibung	Standardwert
Automatische Erkennung von Speicherdatenträgern	`auto-discover-devices`	Konfiguration	Setzen Sie den Wert auf 'true', wenn die Speicherdatenträger auf Ihren Workerknoten automatisch erkannt und verwendet werden sollen.	`false`
Schlüssel für Knotenbezeichnung	`label-key`	Konfiguration	Der 'Schlüssel'-Teil der Bezeichnung 'Schlüssel=Wert' des Workerknotens.	Nicht zutreffend
Schlüsselwert für Knotenbezeichnung	`label-value`	Konfiguration	Der 'Wert'-Teil der Bezeichnung 'Schlüssel=Wert' des Workerknotens.	Nicht zutreffend
Einheitenpfad	`devicepath`	Konfiguration	Der Pfad der lokalen Speichereinheit. Beispiel: '/dev/sdc'. Erforderlich, wenn 'auto-discover-devices' auf 'false' gesetzt ist.	Nicht zutreffend

4.12 Parameterreferenz

Tabelle 4. 4.12 Parameter-Referenz
Anzeigename	CLI-Option	Typ	Beschreibung	Standardwert
Automatische Erkennung von Speicherdatenträgern	`auto-discover-devices`	Konfiguration	Setzen Sie den Wert auf 'true', wenn die Speicherdatenträger auf Ihren Workerknoten automatisch erkannt und verwendet werden sollen.	`false`
Schlüssel für Knotenbezeichnung	`label-key`	Konfiguration	Der 'Schlüssel'-Teil der Bezeichnung 'Schlüssel=Wert' des Workerknotens.	Nicht zutreffend
Schlüsselwert für Knotenbezeichnung	`label-value`	Konfiguration	Der 'Wert'-Teil der Bezeichnung 'Schlüssel=Wert' des Workerknotens.	Nicht zutreffend
Einheitenpfad	`devicepath`	Konfiguration	Der Pfad der lokalen Speichereinheit. Beispiel: '/dev/sdc'. Erforderlich, wenn 'auto-discover-devices' auf 'false' gesetzt ist.	Nicht zutreffend

4.13 Parameterreferenz

Tabelle 5. 4.13 Parameter-Referenz
Anzeigename	CLI-Option	Typ	Beschreibung	Standardwert
Automatische Erkennung von Speicherdatenträgern	`auto-discover-devices`	Konfiguration	Setzen Sie den Wert auf 'true', wenn die Speicherdatenträger auf Ihren Workerknoten automatisch erkannt und verwendet werden sollen.	`false`
Schlüssel für Knotenbezeichnung	`label-key`	Konfiguration	Der 'Schlüssel'-Teil der Bezeichnung 'Schlüssel=Wert' des Workerknotens.	Nicht zutreffend
Schlüsselwert für Knotenbezeichnung	`label-value`	Konfiguration	Der 'Wert'-Teil der Bezeichnung 'Schlüssel=Wert' des Workerknotens.	Nicht zutreffend
Einheitenpfad	`devicepath`	Konfiguration	Der Pfad der lokalen Speichereinheit. Beispiel: '/dev/sdc'. Erforderlich, wenn 'auto-discover-devices' auf 'false' gesetzt ist.	Nicht zutreffend

Referenz zu Speicherklassen für lokalen Blockspeicher

Prüfen Sie die Informationen zu den Satellite-Speicherklassen für lokalen Blockspeicher. Sie können Speicherklassen in der Befehlszeile mit dem Befehl oc describe sc <storage-class-name> beschreiben.

Klassenreferenz des lokalen Blockspeichers
Speicherklassenname	Typ	Rückforderungsrichtlinie
`sat-local-block-gold`	Block	Beibehalten

Hilfe und Support für lokalen Blockspeicher

Lesen Sie die häufig gestellten Fragen in der Dokumentation zuRed Hat OpenShift.
Lesen Sie die Dokumentation zur Fehlerbehebung, um allgemeine Probleme zu beheben und zu beheben.
Überprüfen Sie den Status der IBM Cloud-Plattform und der Ressourcen auf der Statusseite.
Überprüfen Sie Stack Overflow, um festzustellen, ob andere Benutzer dasselbe Problem hatten. Versehen Sie alle Fragen mit "ibm-cloud", damit sie von den IBM Cloud-Entwicklungsteams gesehen werden können.
Sollten Sie ein Problem mit der Vorlage Local Storage Operator – Block haben, können Sie ein Ticket im Red Hat-Kundenportal eröffnen.