Debug di errori IBM Cloud Object Storage

Esaminare le opzioni per eseguire il debug di Object Storage e individuare le cause di eventuali guasti.

Verifica che il pod che monta l'istanza di archiviazione sia stato distribuito correttamente

Attieniti alla procedura per esaminare eventuali messaggi di errore correlati alla distribuzione del pod.

  1. Elenca i pod nel tuo cluster. Un pod è stato distribuito correttamente se lo stato del pod è Running.

    oc get pods

  2. Verifica i dettagli del tuo pod ed esamina eventuali messaggi di errore visualizzati nella sezione “Eventi” dell’output della CLI.

    oc describe pod <pod_name>

  3. Richiama i log per il tuo pod e riesamina eventuali messaggi di errore.

    oc logs <pod_name>

  4. Consultare la Object Storage per la procedura per risolvere gli errori comuni.

Riavvio del tuo pod dell'applicazione

Alcuni problemi possono essere risolti riavviando e ridistribuendo i tuoi pod. Attieniti alla procedura per ridistribuire un pod specifico.

  1. Se il tuo pod fa parte di una distribuzione, elimina il pod e lascia che la distribuzione lo ricrei. Se il pod non fa parte di una distribuzione, elimina il pod e applica nuovamente il suo file di configurazione.

    1. Elimina il pod.
        oc delete pod <pod_name>
    ```
    Output di esempio
    ```sh {: screen}
    pod "nginx" deleted
    ```
2. Riapplica il file di configurazione per ridistribuire il pod.
```sh {: pre}
    oc apply -f <app.yaml>
    ```
    Output di esempio
    ```sh {: pre}
    pod/nginx created
    ```

  2. Se il riavvio del pod non risolve il problema, ricarica i nodi di lavoro.

  3. Accertati di utilizzare la versione più recente di IBM Cloud e del plug-in IBM Cloud Kubernetes Service.

    ibmcloud update

    ibmcloud plugin repo-plugins

    ibmcloud plugin update

Verificare che il driver di archiviazione e i pod plug-in presentino lo stato “In esecuzione ”

Attieniti alla procedura per controllare lo stato del tuo driver di archiviazione e dei pod del plug-in ed esaminare eventuali messaggi di errore.

  1. Elenca i pod nel progetto kube-system.

    oc get pods -n kube-system

  2. Se il driver di archiviazione e i pod plug-in non mostrano lo stato " In esecuzione ", ottenere ulteriori dettagli sul pod per individuare la causa principale. A seconda dello stato del tuo pod, i seguenti comandi potrebbero avere esito negativo.

    1. Ottieni i nomi dei contenitori che vengono eseguiti nel pod del driver.
        kubectl describe pod POD_NAME -n kube-system
    ```
2. Esporta i log dal pod del driver in un file `logs.txt` sulla tua macchina locale.

```sh {: pre}
    oc logs <pod_name> -n kube-system > logs.txt
    ```
3. Riesamina il file di log.

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

  3. Controllare i log più recenti per eventuali messaggi di errore. Consultare la Object Storage per la procedura per risolvere gli errori comuni.

Verifica che il tuo PVC sia stato configurato correttamente

Attieniti alla procedura per controllare lo stato della tua PVC ed esaminare eventuali messaggi di errore.

  1. Controlla lo stato della tua PVC. Il provisioning della PVC viene eseguito correttamente se lo stato della PVC è Bound (Collegato).

    oc get pvc

    • Se la PVC mostra uno stato di Bound, il provisioning della PVC viene eseguito correttamente.

      Output di esempio

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

    • Se lo stato della PVC mostra In sospeso, descrivere la PVC ed esaminare la sezione Eventi dell'output per eventuali avvertenze o messaggi di errore. Nota che le PVC che fanno riferimento a classi di archiviazione con la modalità di bind del volume impostata su WaitForFirstConsumer rimangono in sospeso fino a quando non viene distribuito un pod dell'applicazione che utilizza la PVC.

      oc describe pvc <pvc_name>

      Output di esempio

      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. Esamina la documentazione per la risoluzione dei problemi di Object Storage per la procedura per risolvere gli errori PVC comuni Object Storage.

Controllo e aggiornamento della versione della CLI oc

Se si utilizza una versione della CLI di oc che non corrisponde almeno alla versione major.minor del proprio cluster, potrebbero verificarsi risultati imprevisti. Ad esempio, Kubernetes non supporta le versioni client di oc che presentano una differenza di 2 o più versioni rispetto alla versione server (n ± 2).

  1. Verifica che la versione della CLI di oc in esecuzione sul tuo computer locale corrisponda alla versione di Kubernetes installata nel tuo cluster. Visualizza la versione della CLI di oc installata nel tuo cluster e sul tuo computer locale.

    oc version

    Output di esempio:

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

    Le versioni delle CLI corrispondono se la versione visualizzata per il client e per il server in GitVersion è la stessa. Puoi ignorare la parte +IKS della versione del server.

  2. Se le versioni della CLI di oc sul tuo computer locale e sul tuo cluster non corrispondono, aggiorna il cluster oppure installa una versione diversa della CLI sul tuo computer locale.

Controllo e aggiornamento del plug-in Object Storage

Segui la procedura per aggiornare il plug-in Object Storage.

Controllo dei log del programma di controllo e della versione del programma di controllo installata

Per controllare i log del driver e visualizzare la versione del driver della tua installazione di Object Storage, completa la seguente procedura.

  1. Elenca i pod presenti nel namespace kube-system.
    kubectl get pods -n kube-system -o wide -l app=ibmcloud-object-storage-driver
  2. Controlla i log dei tuoi pod.
    kubectl -n kube-system exec -it -- cat /host/log/ibmc-s3fs.log

Aggiornamento del grafico " Helm "

Per aggiornare il grafico Helm da qualsiasi versione precedente, completa la seguente procedura.

  1. Disinstallare il grafico " Helm " attualmente installato.

    helm ls --all --all-namespaces

    helm uninstall <helm_chart_name> -n <helm_chart_namespace>

  2. Aggiungi e aggiorna il repository Helm.

    helm repo add ibm-helm https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm

    helm repo update

  3. Installa il nuovo grafico Helm.

    helm plugin uninstall ibmc
helm fetch --untar ibm-helm/ibm-object-storage-plugin && cd ibm-object-storage-plugin
helm plugin install ./ibm-object-storage-plugin/helm-ibmc
helm ibmc --help