Risoluzione dei problemi di Cloud Endpoints in GKE

Questo documento illustra le tecniche per la risoluzione dei problemi per Endpoints su Google Kubernetes Engine (GKE) e Kubernetes.

Operazione non riuscita in kubectl create -f gke.yaml

Se viene visualizzato il messaggio di errore Failed in kubectl create -f gke.yaml, prendi il seguenti passaggi:

  1. Autorizza gcloud:

    gcloud auth login
gcloud auth application-default login

  2. Creare un cluster. Puoi utilizzare il seguente gcloudcomando o creare un cluster utilizzando la console Google Cloud.

    gcloud container clusters create CLUSTER_NAME

    Sostituisci CLUSTER_NAME con il nome del cluster.

  3. Richiedi le credenziali per il tuo cluster e rendile disponibili a kubectl:

    gcloud container clusters get-credentials CLUSTER_NAME

Le metriche e i log degli endpoint non vengono visualizzati

Se riesci a inviare richieste alla tua API, ma non visualizzi metriche o log nella pagina Endpoints > Servizi della console Google Cloud, svolgi i seguenti passaggi:

  1. Verifica che tutti i servizi richiesti siano attivi.
  2. Verifica che tutte le autorizzazioni richieste siano state concesse.

Accesso ai log da Extensible Service Proxy

Se devi accedere ai log di Extensible Service Proxy (ESP) per eseguire la diagnostica problemi, usa kubectl nel seguente modo:

  1. Ottieni il nome del pod:

    kubectl get pod

NAME                       READY     STATUS    RESTARTS   AGE
esp-echo-174578890-x09gl   2/2       Running   2          21s

    Il nome del pod è esp-echo-174578890-x09gl e ha due container: esp e echo.

  2. Per visualizzare i log in un pod, usa kubectl logs:

    kubectl logs POD_NAME -c CONTAINER_NAME

    Dove POD_NAME e CONTAINER_NAME vengono restituiti dal comando kubectl get pod nel passaggio precedente. Ad esempio:

      kubectl logs esp-echo-174578890-x09gl -c esp

Verifica del nome del servizio

Se viene visualizzato il messaggio di errore Fetching service config failed, verifica che il nome del servizio specificato nel campo --service del file manifest di Deployment (chiamato file deployment.yaml) corrisponda al nome nel campo host del documento OpenAPI (chiamato file openapi.yaml).

Se il nome errato si trova nel file deployment.yaml:

  1. Apri il file deployment.yaml e vai alla sezione configurata per il contenitore ESP. Ad esempio:

    containers:
- name: esp
  image: gcr.io/endpoints-release/endpoints-runtime:1
  args: [
    "--http_port=8081",
    "--backend=127.0.0.1:8080",
    "--service=SERVICE_NAME",
    "--rollout_strategy=managed"
  ]

    Modifica SERVICE_NAME in modo che corrisponda al nome nel campo host in openapi.yaml e salva il file deployment.yaml.

  2. Avvia il servizio Kubernetes:

      kubectl create -f deployment.yaml

Se il nome errato si trova nel file openapi.yaml:

  1. Recuperare il nome del servizio configurato per l'uso da parte di Endpoints.

  2. Elimina il servizio:

    gcloud endpoints services delete SERVICE_NAME

    Sostituisci SERVICE_NAME con il nome del passaggio precedente. Sono necessari 30 giorni per l'eliminazione del servizio da Google Cloud. Durante questo periodo non potrai riutilizzare il nome del servizio.

  3. Apri il file openapi.yaml, correggi il nome nel campo host e salva del file.

  4. Esegui il deployment della configurazione del servizio aggiornata:

      gcloud endpoints services deploy openapi.yaml

  5. Attendi il completamento del deployment della configurazione del servizio.

  6. Avvia il servizio Kubernetes:

      kubectl create -f deployment.yaml

Controllo dei file di configurazione

  1. Usa ssh per connetterti al pod utilizzando kubectl:

    kubectl exec -ti -c CONTAINER_NAME POD_NAME bash

    Sostituisci CONTAINER_NAME con il nome del tuo e POD_NAME con il nome del tuo pod.

  2. Nella directory etc/nginx/endpoints/, controlla la seguente configurazione per gli errori:

    • nginx.conf- Il file di configurazione nginx con le istruzioni ESP
    • service.jso - Il file di configurazione del servizio

Accedere alla pagina dello stato degli endpoint

Se hai impostato rollout_strategy su managed quando hai avviato ESP, e devi trovare l'ID configurazione di cui un'istanza ESP sta usando, la pagina dello stato di Endpoints contiene le informazioni.

Per accedere alla pagina dello stato degli endpoint:

  1. Usa ssh per connetterti al pod utilizzando kubectl:

    kubectl exec -ti -c CONTAINER_NAME POD_NAME bash

    Sostituisci CONTAINER_NAME con il nome del contenitore e POD_NAME con il nome del pod.

  2. Installa curl.

  3. Inserisci quanto segue:

      curl http://localhost:8090/endpoints_status

    Il risultato è simile al seguente:

    "serviceConfigRollouts": {
    "rolloutId": "2017-08-09r27",
    "percentages": {
         "2017-08-09r26": "100"
    }
}

Il valore nel campo rolloutId corrisponde all'ID di configurazione del servizio che ESP sta usando. Per assicurarti che ESP utilizzi la stessa configurazione di Endpoints, vedi Recuperare il nome del servizio e l'ID configurazione.