更新 IBM Cloud Block Storage Attacher 插件

您可以将现有 IBM Cloud Block Storage Attacher 插件升级到最新版本。

1. 更新 Helm 存储库以在此存储库中检索所有最新版本的 Helm chart。

   helm repo update
   

2. 可选：将最新 Helm chart 下载到本地计算机。 然后，解压缩包并查看 release.md 文件，以了解最新的发行版信息。

   helm pull iks-charts/ibmcloud-block-storage-plugin
   

3. 查找 IBM Cloud Block Storage Attacher 插件的 Helm chart 名称。

   helm ls -A
   

   示例输出

   <helm_chart_name>    1           Wed Aug  1 14:55:15 2022    DEPLOYED    ibm-block-storage-attacher-1.0.0    default
   

4. 将 IBM Cloud Block Storage Attacher 升级到最新版本。

   helm upgrade --force --recreate-pods <helm_chart_name> ibm-block-storage-attacher
   

除去 IBM Cloud Block Volume Attacher 插件

如果不想在群集中配置和使用 IBM Cloud Block Storage Attacher 插件，可以卸载 Helm 图表。

1. 查找 IBM Cloud Block Storage Attacher 插件的 Helm chart 名称。

   helm list | grep ibm-block-storage-attacher
   

   示例输出

   <helm_chart_name>    1           Wed Aug  1 14:55:15 2022    DEPLOYED    ibm-block-storage-attacher-1.0.0    default
   

2. 通过除去 Helm chart 来删除 IBM Cloud Block Storage Attacher 插件。

   helm uninstall <helm_chart_name> -n <namespace>
   

3. 验证 IBM Cloud Block Storage Attacher 插件 pod 是否已除去。

   oc get pod -n kube-system -o wide | grep attacher
   

   如果 CLI 输出中未显示任何 pod，那么表明已成功除去 pod。

4. 验证 IBM Cloud Block Storage Attacher 存储类是否已除去。

   oc get sc | grep attacher
   

如果 CLI 输出中未显示任何存储类，那么表明已成功除去存储类。

使用 API 从 VPC 集群中的工作程序节点拆离原始和未格式化的 Block Storage for Classic

您可以使用 DELETE 请求从 VPC 工作程序节点拆离存储器。

从 VPC 集群拆离存储器不会除去 Block Storage for Classic 卷或存储在该卷中的数据。 您将继续计费，直到 您手动删除卷 为止。

1. 标识要除去的存储卷，并记下卷标识。

   ibmcloud is volumes
   

2. 了解音量的详细信息。 此命令返回工作程序节点标识和连接标识。 记下工作程序节点标识。 在以下命令中，此标识将作为“实例名称”返回。

   ibmcloud is volume <volume_ID>
   

3. 检索 PV 的列表。 此命令将返回 PV 的列表，然后可以使用这些 PV 来确定哪些 PVC 使用要除去的卷。

   oc get pv
   

4. 描述使用该卷的 PV。 如果您不知道哪个 PV 使用要除去的卷，那么可以在集群中的每个 PV 上运行 describe pv 命令。 请注意使用 PV 的 PVC。

   oc describe pv <pv_name>
   

5. 检查存储卷是否正由 pod 使用。 以下命令显示安装卷和关联 PVC 的 pod。 如果未返回任何 pod，那么表示存储器未在使用中。

   oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"
   

6. 如果卷正在使用的 pod 是部署的一部分，请删除该部署。 如果 pod 不属于部署，请删除 pod。

   oc delete deployment <deployment_name>
   

   oc delete pod <pod_name>
   

7. 删除 PVC 和 PV。

   oc delete pvc <pvc_name>
   

   oc delete pv <pv_name>
   

8. 检索 IAM 令牌。

   ibmcloud iam oauth-tokens
   

9. 使用 POST 请求拆离存储器。

   示例请求

   curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/deleteAttachment" -H  "accept: application/json" -H  "Authorization: <IAM_token>" -H  "X-Auth-Resource-Group-ID: <resource_group>" -H  "Content-Type: application/json" -d "{  \"cluster\": \"<cluster_name_or_ID\",  \"volumeAttachmentID\": \"<volume_attachment_ID>\",  \"volumeID\": \"<volume_ID>\",  \"worker\": \"<worker_ID>\"}"
   

   IAM_token

   当前会话的 IAM OAuth 令牌。 您可以通过运行 ibmcloud iam oauth-tokens 来检索此值。

   cluster_name_or_ID

   分配给集群的唯一标识或名称。 您可以通过运行 ibmcloud oc cluster ls 来检索此标识。

   worker_ID

   分配给要在其中连接卷的工作程序节点的唯一标识。 您可以通过运行 ibmcloud oc worker ls -c <cluster_name> 来检索此值。

   volume_ID

   分配给 Block Storage for Classic 卷的唯一标识。 您可以通过运行 ibmcloud is volumes 来检索 Block Storage for Classic 卷的列表。

   volume_attachment_ID

   分配给卷连接的唯一标识。 您可以通过运行 ibmcloud is volume <volume_ID> 来检索此标识。

使用 API 查看 VPC 工作程序节点的卷连接详细信息

您可以使用 GET 请求来检索 VPC 工作程序节点的卷连接详细信息。

1. 检索 IAM 令牌。

   ibmcloud iam oauth-tokens
   

2. 读取部署群集的资源组 ID。

   ibmcloud oc cluster get <cluster_name_or_ID> | grep "Resource Group ID"
   

3. 检索要查看其卷连接详细信息的工作程序节点的标识。 确保选择与 Block Storage for Classic 实例位于同一专区中的工作程序节点。

   ibmcloud oc worker ls --cluster <cluster_name_or_ID>
   

4. 查看工作程序节点上的现有卷连接的列表。

   curl -X GET "https://containers.cloud.ibm.com/v2/storage/getAttachments?cluster=<cluster_ID>&worker=<worker_ID>" --header "X-Auth-Resource-Group-ID: <resource_group_ID>" --header "Authorization: <IAM_token>"
   

5. 检索特定附件的详细信息。

   curl -X GET "https://containers.cloud.ibm.com/v2/storage/getAttachment?cluster=<cluster_ID>&worker=<worker_ID>&volumeAttachmentID=<volume_attachment_ID>" --header "X-Auth-Resource-Group-ID: <resource_group_ID>" --header "Authorization: <IAM_token>"
   

   IAM_token

   当前会话的 IAM OAuth 令牌。 您可以通过运行 ibmcloud iam oauth-tokens 来检索此值。

   cluster_ID

   分配给群集的唯一 ID。 您可以通过运行 ibmcloud oc cluster ls 来检索此标识。

   worker_ID

   分配给要在其中连接卷的工作程序节点的唯一标识。 您可以通过运行 ibmcloud oc worker ls -c <cluster_name> 来检索此值。

   volume_ID

   分配给 Block Storage for Classic 卷的唯一标识。 您可以通过运行 ibmcloud is volumes 来检索 Block Storage for Classic 卷的列表。

   volume_attachment_ID

   分配给卷连接的唯一标识。 您可以通过运行 ibmcloud is volume <volume_ID> 来检索此标识。

使用 CLI 从 VPC 工作程序节点中除去原始 Block Storage for VPC

您可以使用 ibmcloud oc storage attachment rm 命令从工作程序节点中除去存储器。

登录您的账户。 如果适用，请将相应的资源组设定为目标。 设置集群的上下文。

1. 列出存储卷并记下要除去的卷的标识。

   ibmcloud is vols
   

2. 获取卷的详细信息，例如连接卷的 worker-id。 worker-id 在命令输出的 Volume Attachment Instance Reference 部分中列示为 Instance name。

   ibmcloud is vol <volume-ID>
   

   示例输出

   Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name                                        Auto delete   Attachment ID                               Attachment name      
                                       data              0727_e18c10d7-7f18-48aa-b5ef-5ed163e54198   kube-bsaucubd07dhl66e4tgg-cluster-default-00000a19   false         0727-3bfe90b0-dc2d-498a-946b-8837a5dad7bc   volume-attachment
   

3. 列出集群中工作程序节点上的存储附件，并记下要除去的附件标识。

   ibmcloud oc storage attachment ls -c <cluster> --worker <worker-id>
   

   示例输出：

   Listing volume attachments...
   OK
   ID                                          Name                Status     Type   Volume ID                                   Volume Name                          Worker ID   
   0111-1a111aaa-1111-1111-111a-aaa1a1a11a11   volume-attachment   attached   boot   a001-f11ed1e1-1aa1-11dc-b11d-a0dc111b1111  dissuade-anointer-errand-handbrake   kube-aa1111aa11aaaaa11aa1-cluster-name-default-00000110
   

4. 除去存储器附件。

   ibmcloud oc storage attachment rm --attachment <attachment-ID> -c <cluster> --worker <worker-ID>
   

5. 验证是否已从工作程序节点中除去存储器。

   ibmcloud oc storage attachment ls -c <cluster-ID> --worker <worker-id>
   

设置 IBM Cloud Object Storage 服务实例

创建并配置 IBM Cloud Object Storage 服务实例，以充当要备份的数据的存储库。

1. 创建使用 HMAC 凭证的 IBM Cloud Object Storage 服务实例。
2. 将 IBM Cloud Object Storage 凭证存储在 Kubernetes 私钥 中。
3. 创建第一个 IBM Cloud Object Storage 存储区。
   1. 在“服务详细信息”页面的导航中，单击存储区。
   2. 单击创建存储区。 此时会显示一个对话框。
   3. 输入存储区的唯一名称。 该名称必须在所有区域上的 IBM Cloud Object Storage 中以及在所有 IBM Cloud 帐户上唯一。
   4. 从弹性列表中，选择希望数据具有的可用性级别。 有关更多信息，请参阅 IBM Cloud Object Storage 区域和端点。 对于 VPC 集群，请记下直接端点。 例如：s3.direct.us.cloud-object-storage.appdomain.cloud。
   5. 将位置更改为要存储数据的区域。 请记住，由于法律方面的原因，并非每个区域都允许存储您的数据。
   6. 单击创建。
4. 检索存储区的 IBM Cloud Object Storage 主机名。
   1. 单击您在上一步中创建的水桶名称。
   2. 在“服务详细信息”页面的导航中，单击存储区 > 配置。
   3. 请注意，您可以使用公共 URL 访问数据桶中的数据。

有关配置服务实例的更多信息，请参阅 IBM Cloud Object Storage 文档。

使用 IBM Cloud Object Storage 来备份和复原 PVC 数据

您可以使用 IBM Cloud 备份复原 Helm 图表将文件存储器或块存储器 PVC 中的数据备份到 IBM Cloud Object Storage，或者将数据从 IBM Cloud Object Storage 复原到集群中的 PVC。

开始之前：

• 确保您具有可备份或复原数据的 PVC。 有关如何创建 PVC 的更多信息，请参阅 向应用程序添加文件存储器 和 向应用程序添加块存储器。

• 如果要备份块存储器 PVC，请确保 PVC 未安装到应用程序。 块存储器使用 RWO 访问方式进行安装。 此访问权仅允许一次将一个 pod 安装到块存储器。 要备份数据，必须除去安装存储器的应用程序 pod。 要检查是否将 pod 安装到 PVC，请运行以下命令。

  oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"
  

• 检索 IBM Cloud Object Storage 服务凭证，存储区名称和存储区主机名。

• 遵循指示信息 在本地机器上安装 Helm 客户机，并设置 IBM Cloud Helm Chart 存储库。

• 访问 Red Hat OpenShift 集群。

您可以通过编辑和应用 Helm Chart 的 values.yaml 文件，或者通过从 CLI 运行 helm install 命令来部署 ibm-storage-backup pod 或 ibm-storage-restore pod。

要通过编辑 values.yaml 文件来备份或复原 PVC:

1. 将最新的 Helm 图表版本下载到本地计算机。

   helm fetch --untar iks-charts/ibmcloud-backup-restore
   

2. 在 nano 命令行编辑器中打开 values.yaml 文件。

   nano ibmcloud-backup-restore/values.yaml
   

3. 配置 Helm Chart 以备份或复原 PVC 数据。 您可以为多个 PVC 配置备份。

   通过配置 values.yaml 文件创建备份 pod 的示例:

   image:
       repository: icr.io/iks-charts/ibmcloud-backup-restore
   pullPolicy: Always
   tag: latest
   ACCESS_KEY_ID: # Example: 10110abab1111bbb111aa1aaa111b1a1
   SECRET_ACCESS_KEY: # Example: a1aba11aaa11b11b11aa1111a1111ba111111111a0b1b11a
   ENDPOINT: # Example: s3.us-east.cloud-object-storage.appdomain.cloud
   BUCKET_NAME: # Example: my-bucket
   BACKUP_NAME: # Example: my_backup
   PVC_NAMES:
       - # Example: my_pvc
   - # Optional example: my_pvc2
   CHART_TYPE: # Example: backup or restore
   BACKUP_TYPE: # Example: incremental
   SCHEDULE_TYPE: # Example: periodic
   SCHEDULE_INFO: # Example: weekly
   

   ACCESS_KEY_ID

   输入先前检索到的 IBM Cloud Object Storage 服务凭证的访问密钥标识。

   SECRET_ACCESS_KEY

   输入先前检索到的 IBM Cloud Object Storage 服务凭证的私钥访问密钥。

   ENDPOINT

   输入先前检索到的存储区的公共 IBM Cloud Object Storage s3 API 端点。

   BUCKET_NAME

   备份：输入您之前创建的 IBM Cloud Object Storage 桶的名称。 执行备份时，可使用此存储区来存储 PVC 数据。 复原: 输入存储备份的 IBM Cloud Object Storage 存储区的名称。

   BACKUP_NAME

   备份: 输入要在 IBM Cloud Object Storage中创建的备份的名称。 复原: 在 IBM Cloud Object Storage中输入使用 IBM Cloud 备份复原 Helm 图表创建的备份的名称。 如果您的 IBM Cloud Object Storage 服务实例中有多个完全备份，那么会使用上次完全备份的数据复原 PVC。 如果有增量备份，PVC 将使用上次完全备份的数据进行复原，包括截至开始复原的日期的所有增量备份。

   PVC_NAMES

   备份：输入要备份的 PVC 的名称。 如果要备份多个 PVC，请将每个 PVC 添加到 PVC 列表中。 要列出集群中可备份的可用 PVC，请运行 oc get pvc。 复原: 输入要将数据从 IBM Cloud Object Storage复原到的 PVC 的名称。 一次只能将数据复原到一个 PVC。 要列出集群中可将数据复原到的可用 PVC，请运行 oc get pvc。

   CHART_TYPE

   输入要部署的图表类型名称。 输入 backup 以部署备份 Chart。 输入 restore 以部署复原 Chart。

   BACKUP_TYPE

   仅对于备份是必需的。 输入 full 以创建完全备份，或者如果要仅备份新的或已更改的文件，请输入 incremental。 如果选择 incremental，那么必须指定 SCHEDULING_INFO 和 SCHEDULING_TYPE 选项。 如果未指定 BACKUP_TYPE 选项，那么缺省情况下将创建完全备份。

   SCHEDULE_TYPE

   仅对于备份是必需的。 输入 periodic 以创建调度备份，或者将此选项留空以创建一次性备份。 如果要创建定期备份，那么必须在 SCHEDULE_INFO 选项中定义备份时间间隔。

   SCHEDULE_INFO

   仅对于备份是必需的。 如果要创建定期备份，那么必须决定备份调度。 在 hourly，daily 或 weekly 之间进行选择。 如果设置此选项，那么必须将 SCHEDULE_TYPE 设置为 periodic。

4. 保存并关闭 values.yaml 文件。

5. 使用 values.yaml 文件中的定制设置安装 Helm Chart。 安装 Helm Chart 并配置备份或复原时，会将 ibm-storage-backup 或 ibm-storage-restore pod 部署到集群。 备份 pod 将数据从 PVC 备份到 IBM Cloud Object Storage，复原 pod 将数据复原到 PVC。 将 <release_name> 替换为 Helm Chart 的名称。 确保将备份和复原 pod 安装在要备份或复原的 PVC 所在的区域中。

   • 使用 helm install 命令安装 Helm 图表。

     helm install <release_name> ./ibmcloud-backup-restore -n <namespace>
     

     备份的示例输出:

     NAME: <release_name>
     LAST DEPLOYED: Mon Jan 20 09:17:02 2020
     NAMESPACE: default
     STATUS: deployed
     REVISION: 1
     TEST SUITE: None
     NOTES:
     Thank you for installing: ibmcloud-backup-restore.   Your release is named: <release_name>
     
     Please refer Chart README.md file for creating a sample PVC
     Please refer Chart RELEASE.md to see the release details/fixes
     

   • 可选: 通过在 helm install 命令中设置选项来安装 Helm Chart。 您可以通过指定 --name 参数来命名发布。

     helm install <release_name> --set ACCESS_KEY_ID=<access_key_ID> --set SECRET_ACCESS_KEY=<secret_access_key> --set ENDPOINT=<public_bucket_endpoint> --set BUCKET_NAME=<bucket_name> --set BACKUP_NAME=<backup_name> --set PVC_NAMES[0]=<pvc_name1> --set PVC_NAMES[1]=<pvc_name2> --set CHART_TYPE=backup --set BACKUP_TYPE=<backup_type> --set SCHEDULE_TYPE=<schedule_type> --set SCHEDULE_INFO=<schedule_info> ./ibmcloud-backup-restore
     

6. 验证数据备份或复原是否成功完成。

   备份：

   1. 验证 ibm-storage-backup pod 是否处于运行状态。

      oc get pods -A | grep backup
      

      示例输出

      ibm-storage-backup                        1/1     Running             0          64m
      

   2. 查看 ibm-storage-backup pod 的日志以确保备份成功。 当您在日志中看到 ... backup completed 消息时，说明备份已成功完成。

      oc logs ibm-storage-backup
      

      每日备份的示例输出。

      [2019-04-18 16:01:51,157] [utilities : 151] [INFO] *****************Start logging to ./Backup.log
      [2019-04-18 16:01:51,158] [backup : 48] [INFO] Starting backup:
      [2019-04-18 16:01:51,158] [configureOS : 66] [INFO] Configuring duplicity with IBM CloudObjectStorage i.e s3.
      [2019-04-18 16:01:51,158] [backup : 62] [INFO] Configuration done!!!
      [2019-04-18 16:01:51,158] [backup : 78] [INFO] Got all required input from config file!!
      [2019-04-18 16:01:52,366] [backup : 119] [WARNING] Incremental backup was not created
      [2019-04-18 16:01:52,366] [backup : 120] [INFO] duplicity  --no-encryption incremental /myvol s3://s3.us-south.cloud-object-storage.appdomain.cloud/mybucket/helm-backup command failed due to Fatal Error: Unable to start incremental backup.  Old signatures not found and incremental specified
      
      [2019-04-18 16:01:52,367] [backup : 121] [INFO] A full backup is required before incremental backups can begin. Creating a one-time full backup and will run incremental backups for scheduled backups.
      [2019-04-18 16:01:54,357] [backup : 129] [INFO] Full backup completed
      [2019-04-18 16:01:54,357] [backup : 130] [INFO] Local and Remote metadata are synchronized, no sync needed.
      Last full backup date: none
      --------------[ Backup Statistics ]--------------
      StartTime 1555603313.31 (Thu Apr 18 16:01:53 2019)
      EndTime 1555603313.32 (Thu Apr 18 16:01:53 2019)
      ElapsedTime 0.01 (0.01 seconds)
      SourceFiles 3
      SourceFileSize 20495 (20.0 KB)
      NewFiles 3
      NewFileSize 20495 (20.0 KB)
      DeletedFiles 0
      ChangedFiles 0
      ChangedFileSize 0 (0 bytes)
      ChangedDeltaSize 0 (0 bytes)
      DeltaEntries 3
      RawDeltaSize 15 (15 bytes)
      TotalDestinationSizeChange 183 (183 bytes)
      Errors 0
      -------------------------------------------------
      
      [2019-04-18 16:01:54,357] [backup : 162] [INFO] Scheduling backup as per configurations, please don't stop this program or run this in background !!!
      [2019-04-18 16:01:54,358] [backup : 166] [INFO] Schedule info is: ['daily']
      [2019-04-18 16:01:54,358] [backup : 172] [INFO] Scheduled for daily!!!
      

7. 验证是否已成功备份或复原数据。

   • 备份：

     1. 在 IBM Cloud 资源列表 中找到 IBM Cloud Object Storage 服务实例。
     2. 从导航中选择“桶”，然后单击备份配置中使用的桶。 您的备份会显示为存储区中的对象。
     3. 复查压缩文件。 您可以下载 *.gz 文件，提取文件并验证备份数据。

   • 恢复：

     1. 使用安装包含复原数据的 PVC 的 pod 创建 deployment.yaml 文件。 以下示例部署用于在 /test 安装目录上安装 PVC 的 nginx pod。

          apiVersion: apps/v1
          kind: Deployment
          metadata:
            name: restore
            labels:
            app: nginx
          spec:
            selector:
              matchLabels:
                app: nginx
            template:
              metadata:
                labels:
                  app: nginx
              spec:
                containers:
                  - image: nginx
                    name: nginx
                    volumeMounts:
                    - name: my-volume # Example: my_volume
                      mountPath: /test # Example: /test
                volumes:
                - name: my-volume # Example: my_volume
                  persistentVolumeClaim:
                    claimName: my-actual-pvc-name # Example: my_pvc
        

        spec.containers.image

        要使用的映像的名称。 要列出 IBM Cloud Container Registry 帐户中的可用映像，请运行 ibmcloud cr image-list。

        spec.containers.name

        要部署到集群的容器的名称。

        spec.containers.volumeMounts.mountPath

        在容器中安装卷的目录的绝对路径。 写入安装路径的数据会存储在物理块存储器实例中的根目录下。 如果要在不同应用程序之间共享音量，可以为每个应用程序指定 音量子路径。

        spec.containers.volumeMounts.name

        要安装到 pod 中的卷的名称。

        volumes.name

        要安装到 pod 中的卷的名称。 该名称通常与 volumeMounts/name

        volumes.persistentVolumeClaim.claimName

        绑定要使用的 PV 的 PVC 的名称。

     2. 创建部署。

        oc apply -f deployment.yaml
        

     3. 验证 pod 是否处于运行状态。

        如果发现 "ibm-storage-restore pod 没有达到 "已完成"或 CrashLoopBackOff 状态，则可能是恢复数据失败。 运行 oc logs ibm-storage-restore 以查找故障的根本原因。

        oc get pods | grep restore
        

        示例输出

        restore-7dfc6f4c78-wkcqp                  1/1     Running             0          3m54s
        

     4. 登录到 pod。

        oc exec <pod_name> -it bash
        

     5. 浏览至您在部署 YAML 中指定的安装目录。

        cd <mount_directory>
        

     6. 列出安装目录中的文件，以验证是否已将所有数据复原到安装目录。

        ls
        

     7. 从集群中删除 Helm Chart 安装。 如果将数据复原到块存储器 PVC，那么需要执行此步骤。 块存储器使用 RWO 访问方式进行安装。 此访问权仅允许一次将一个 pod 安装到块存储器。 由于 ibm-storage-restore pod 已安装 PVC，因此必须除去 pod 以释放 PVC，以便可以将 PVC 安装到集群中的其他 pod。

        helm uninstall <release_name> -n <namespace>
        

     8. 您已成功复原备份。 现在，可以将绑定了 PV 的 PVC 安装到集群中的其他任何 pod，以访问已复原的文件。 如果备份的容器数据包含非 root 用户，那么您必须向新容器添加非 root 许可权。 有关更多信息，请参阅添加卷的非 root 用户访问权。

在触发 IBM Cloud Monitoring 警报时对持久存储器进行故障诊断

触发警报时，请查看 IBM Cloud Monitoring 中的警报详细信息，并查看持久存储器，应用程序，工作程序节点和集群的故障诊断指南以查找警报的根本原因。 您设置的警报可能与存储卷问题无关，而是与应用程序中，工作程序节点上或集群中发生的问题相关。

• 对持久存储卷进行故障诊断。
• 对工作程序节点进行故障诊断。
• 对应用程序进行故障诊断。
• 对集群进行故障诊断。
• 打开支持案例。