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

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-storage --template-version 1.0.0 --param "install-local-storage-file=INSTALL-LOCAL-STORAGE-FILE"  --param "auto-discover-devices-file=AUTO-DISCOVER-DEVICES-FILE"  --param "file-nodes-label-key=FILE-NODES-LABEL-KEY"  --param "file-nodes-label-value=FILE-NODES-LABEL-VALUE"  --param "file-devicepath=FILE-DEVICEPATH"  --param "fstype=FSTYPE"  --param "install-local-storage-block=INSTALL-LOCAL-STORAGE-BLOCK"  --param "auto-discover-devices-block=AUTO-DISCOVER-DEVICES-BLOCK"  --param "block-nodes-label-key=BLOCK-NODES-LABEL-KEY"  --param "block-nodes-label-value=BLOCK-NODES-LABEL-VALUE"  --param "block-devicepath=BLOCK-DEVICEPATH"
   

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 zum Erstellen einer Konfiguration der Version 1.0.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\": \"local-storage\", \"storage-template-version\": \"1.0.0\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"INSTALL-LOCAL-STORAGE-FILE\", { \"entry.name\": \"AUTO-DISCOVER-DEVICES-FILE\", { \"entry.name\": \"FILE-NODES-LABEL-KEY\", { \"entry.name\": \"FILE-NODES-LABEL-VALUE\", { \"entry.name\": \"FILE-DEVICEPATH\", { \"entry.name\": \"FSTYPE\", { \"entry.name\": \"INSTALL-LOCAL-STORAGE-BLOCK\", { \"entry.name\": \"AUTO-DISCOVER-DEVICES-BLOCK\", { \"entry.name\": \"BLOCK-NODES-LABEL-KEY\", { \"entry.name\": \"BLOCK-NODES-LABEL-VALUE\", { \"entry.name\": \"BLOCK-DEVICEPATH\",\"user-secret-parameters\": }
   

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"
   

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.

Entfernen der Konfiguration des lokalen Speichers über die Befehlszeile

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

2. 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)
   

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

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

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

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

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

   oc get pvc
   

8. Entfernen Sie alle Pods, die die PVC zurzeit 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-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
       ```
   

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

10. Überprüfen Sie, ob Ihre PVC entfernt wurde.

    oc get pvc
    

11. Listen Sie Ihre PVs auf und notieren Sie den Namen der PVs, die Sie entfernen wollen.

    oc get pv
    

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

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

    oc get pv