调试 Block Storage for Classic 失败

审查调试选项 Block Storage for Classic，找出任何故障的根本原因。

检查挂载您的存储实例的 Pod 是否已成功部署

执行以下步骤以查看与 pod 部署相关的任何错误消息。

  1. 列出集群中的 pod。 如果 pod 显示的状态为 Running，说明 pod 已成功供应。

    oc get pods

  2. 查看您的 Pod 的详细信息，并检查 CLI 输出中 “事件”部分显示的任何错误消息。

    oc describe pod <pod_name>

  3. 检索 pod 的日志并查看任何错误消息。

    oc logs <pod_name>

  4. 查看 Block Storage for Classic 故障诊断文档以了解解决常见错误的步骤。

重新启动应用程序 pod

可以通过重新启动并重新部署 pod 来解决某些问题。 执行以下步骤以重新部署特定 pod。

  1. 如果您的 pod 是部署的一部分，请删除该 pod 并让部署重新构建该 pod。 如果 pod 不是部署的一部分，请删除 pod 并重新应用 pod 配置文件。

    1. 删除 pod。
        oc delete pod <pod_name>
    ```
    示例输出
    ```sh {: screen}
    pod "nginx" deleted
    ```
2. 重新应用配置文件以重新部署 pod。
```sh {: pre}
    oc apply -f <app.yaml>
    ```
    示例输出
    ```sh {: pre}
    pod/nginx created
    ```

  2. 如果重新启动 pod 无法解决问题，请 重新装入工作程序节点。

  3. 验证是否使用的是最新的 IBM Cloud 和 IBM Cloud Kubernetes Service 插件版本。

    ibmcloud update

    ibmcloud plugin repo-plugins

    ibmcloud plugin update

验证存储驱动程序和插件 Pod 的状态是否显示为 “运行中”

执行以下步骤以检查存储驱动程序和插件 pod 的状态，并查看任何错误消息。

  1. 列出 kube-system 项目中的 pod。

    oc get pods -n kube-system

  2. 如果存储驱动程序和插件 pod 未显示 正在运行 状态，请获取 pod 的更多详细信息以查找根本原因。 根据 pod 的状态，以下命令可能会失败。

    1. 获取在驱动程序 pod 中运行的容器的名称。
        kubectl describe pod POD_NAME -n kube-system
    ```
2. 将日志从驱动程序 pod 导出到本地机器上的 `logs.txt` 文件。

```sh {: pre}
    oc logs <pod_name> -n kube-system > logs.txt
    ```
3. 查看日志文件。

```sh {: pre}
    cat logs.txt
    ```

  3. 如果存储驱动程序和插件 pod 未显示 正在运行 状态，请获取 pod 的更多详细信息以查找根本原因。 根据您的 Pod 状态，您可能无法执行以下所有命令。

    1. 获取在驱动程序 pod 中运行的容器的名称。
        kubectl get pod ibm-vpc-block-csi-controller-0 -n kube-system -o jsonpath="{.spec['containers','initContainers'][*].name}" | tr -s '[[:space:]]' '\n'
    ```
    **以下是 Block Storage for VPC**
    ```sh {: screen}
    csi-provisioner
    csi-attacher
    liveness-probe
    iks-vpc-block-driver
    ```
2. 将容器日志从驱动程序 pod 导出到本地机器上的 `logs.txt` 文件。
```sh {: pre}
    oc logs <pod_name> -n kube-system -c <container_name> > logs.txt
    ```

  4. 请检查最新日志以获取任何错误消息。 查看 Block Storage for Classic 故障诊断文档以了解解决常见错误的步骤。

正在检查您的 PVC 是否已成功配置。

执行以下步骤以检查 PVC 的状态并查看任何错误消息。

  1. 请查看您的PVC状态。 如果 PVC 显示的状态为 Bound，说明 PVC 已成功供应。

    oc get pvc

    • 如果 PVC 显示状态为 Bound，那么表示已成功供应 PVC。

      示例输出

      NAME         STATUS    VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS                AGE
silver-pvc   Bound     pvc-4b881a6b-ada8-4a44-b568-fe909107d756   24Gi       RWX            ibmc-file-silver            7m29s

    • 如果 PVC 的状态显示为 暂挂，请描述 PVC 并查看输出的 事件 部分以获取任何警告或错误消息。 请注意，在使用 PVC 部署应用程序 pod 之前，引用卷绑定方式设置为 WaitForFirstConsumer 的存储类的 PVC 将保持 暂挂 状态。

      oc describe pvc <pvc_name>

      示例输出

      Name:          local-pvc
Namespace:     default
StorageClass:  sat-local-file-gold
Status:        Pending
Volume:        
Labels:        <none>
Annotations:   <none>
Finalizers:    [kubernetes.io/pvc-protection]
Capacity:      
Access Modes:  
VolumeMode:    Filesystem
Mounted By:    <none>
Events:
Type     Reason              Age                 From                         Message
----     ------              ----                ----                         -------
Warning  ProvisioningFailed  60s (x42 over 11m)  persistentvolume-controller  storageclass.storage.k8s.io "sat-local-file-gold" not found

  2. 查看 Block Storage for Classic 故障诊断文档以了解解决常见错误的步骤。

检查和更新 oc CLI 版本

如果您使用的 oc 命令行界面（CLI）版本低于集群的 major.minor 版本，可能会导致出现意外结果。 例如，Kubernetes 不支持与服务器版本相差 2 个或更多版本（n ± 2）的 oc 客户端版本。

  1. 请确认您在本地机器上运行的 oc CLI版本与集群中安装的 Kubernetes 版本一致。 显示集群和本地机器上已安装的 oc 命令行工具（CLI）的版本。

    oc version

    示例输出：

    Client Version: version.Info{Major:"1", Minor:"23", GitVersion:"v1.35", GitCommit:"641856db18352033a0d96dbc99153fa3b27298e5", GitTreeState:"clean", BuildDate:"2019-03-25T15:53:57Z", GoVersion:"go1.12.1", Compiler:"gc", Platform:"darwin/amd64"}
Server Version: version.Info{Major:"1", Minor:"23", GitVersion:"v1.35+IKS", GitCommit:"e15454c2216a73b59e9a059fd2def4e6712a7cf0", GitTreeState:"clean", BuildDate:"2019-04-01T10:08:07Z", GoVersion:"go1.11.5", Compiler:"gc", Platform:"linux/amd64"}

    如果在 GitVersion 中看到客户机和服务器的版本相同，说明 CLI 版本匹配。 可以忽略服务器版本中的 +IKS 部分。

  2. 如果本地机器和集群上的 oc CLI 版本不一致，请更新集群，或者 在本地机器上安装其他版本的 CLI。

检查和更新 Block Storage for Classic 驱动程序

  1. 对于 Block Storage for VPC，请验证您是否具有最新版本的 Block Storage for VPC 集群附加组件。

  2. 对于经典集群上的 Block Storage for Classic，请确保已安装插件的最新 Helm Chart 版本。

    1. 更新 Helm chart 存储库。
        helm repo update
    ```
2. 列出存储库中的 Helm chart。
```sh {: pre}
    helm search repo iks-charts | grep block-storage-plugin
    ```
    示例输出
    ```sh {: screen}
    iks-charts-stage/ibmcloud-block-storage-plugin    1.5.0                                                        A Helm chart for installing ibmcloud block storage plugin   
    iks-charts/ibmcloud-block-storage-plugin          1.5.0                                                        A Helm chart for installing ibmcloud block storage plugin   
    ```
3. 列出集群中已安装的 Helm chart，并将安装的版本与可用版本进行比较。
```sh {: pre}
    helm list --all-namespaces
    ```
4. 如果有更新版本可用，请安装此版本。 有关指示信息，请参阅 [更新 IBM Cloud Block Storage 插件](/docs/openshift?topic=openshift-vpc-block#vpc-addon-update)。