Memecahkan masalah Cloud Endpoints di GKE

Dokumen ini menyajikan teknik pemecahan masalah untuk deployment Endpoints di Google Kubernetes Engine (GKE) dan Kubernetes.

Gagal di kubectl create -f gke.yaml

Jika Anda melihat pesan error Failed in kubectl create -f gke.yaml, lakukan langkah-langkah berikut:

  1. Memberikan otorisasi pada gcloud:

    gcloud auth login
gcloud auth application-default login

  2. Membuat cluster. Anda dapat menggunakan perintah gcloud berikut, atau membuat cluster menggunakan konsolGoogle Cloud .

    gcloud container clusters create CLUSTER_NAME

    Ganti CLUSTER_NAME dengan nama cluster Anda.

  3. Dapatkan kredensial untuk cluster Anda dan sediakan untuk kubectl:

    gcloud container clusters get-credentials CLUSTER_NAME

Metrik dan log endpoint tidak ditampilkan

Jika Anda berhasil mengirim permintaan ke API, tetapi tidak melihat metrik atau log di halaman Endpoints > Services di Google Cloud console, lakukan langkah-langkah berikut:

  1. Periksa apakah semua layanan yang diperlukan telah diaktifkan.
  2. Periksa apakah semua izin yang diperlukan telah diberikan.

Mengakses log dari Extensible Service Proxy

Jika Anda perlu mengakses log Extensible Service Proxy (ESP) untuk mendiagnosis masalah, gunakan kubectl sebagai berikut:

  1. Dapatkan nama pod:

    kubectl get pod

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

    Nama pod adalah esp-echo-174578890-x09gl dan memiliki dua container: esp dan echo.

  2. Untuk melihat log di pod, gunakan kubectl logs:

    kubectl logs POD_NAME -c CONTAINER_NAME

    Dengan POD_NAME dan CONTAINER_NAME ditampilkan dari perintah kubectl get pod pada langkah sebelumnya. Contoh:

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

Memverifikasi nama layanan

Jika Anda melihat pesan error Fetching service config failed, pastikan nama layanan yang Anda tentukan di kolom --service dalam file manifes Deployment (disebut sebagai file deployment.yaml) cocok dengan nama host di properti name yang ditentukan dalam file YAML konfigurasi gRPC API (disebut sebagai file api_config.yaml).

Jika nama yang salah ada di file deployment.yaml:

  1. Buka file deployment.yaml, lalu buka bagian yang dikonfigurasi untuk penampung ESP. Contoh:

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

    Ubah SERVICE_NAME agar cocok dengan nama host yang ditentukan dalam properti name di file api_config.yaml, lalu simpan file deployment.yaml.

  2. Mulai layanan Kubernetes:

      kubectl create -f deployment.yaml

Jika nama yang salah ada di file api_config.yaml:

  1. Dapatkan nama layanan yang dikonfigurasi untuk digunakan oleh Endpoints.

  2. Hapus layanan:

    gcloud endpoints services delete SERVICE_NAME

    Ganti SERVICE_NAME dengan nama dari langkah sebelumnya. Perlu waktu 30 hari agar layanan dihapus dari Google Cloud. Anda tidak dapat menggunakan kembali nama layanan selama waktu ini.

  3. Buka file api_config.yaml dan perbaiki nama host di properti name, lalu simpan file.

  4. Deploy konfigurasi layanan yang diperbarui:

    gcloud endpoints services deploy api_descriptor.pb api_config.yaml api_config_http.yaml

    Tunggu hingga konfigurasi layanan berhasil di-deploy.

  5. Mulai layanan Kubernetes:

      kubectl create -f deployment.yaml

Memeriksa file konfigurasi

  1. Gunakan ssh untuk terhubung ke pod menggunakan kubectl:

    kubectl exec -ti -c CONTAINER_NAME POD_NAME bash

    Ganti CONTAINER_NAME dengan nama container Anda dan POD_NAME dengan nama pod Anda.

  2. Di direktori etc/nginx/endpoints/, periksa apakah ada error dalam file konfigurasi berikut:

    • nginx.conf- File konfigurasi nginx dengan direktif ESP
    • service.jso - File konfigurasi layanan

Mengakses halaman status Endpoint

Jika Anda menyetel rollout_strategy ke managed saat memulai ESP, dan Anda perlu mengetahui ID konfigurasi yang digunakan oleh instance ESP, halaman status Endpoints memiliki informasi tersebut.

Untuk mengakses halaman status Endpoint:

  1. Gunakan ssh untuk terhubung ke pod menggunakan kubectl:

    kubectl exec -ti -c CONTAINER_NAME POD_NAME bash

    Ganti CONTAINER_NAME dengan nama container Anda dan POD_NAME dengan nama pod Anda.

  2. Instal curl.

  3. Masukkan:

      curl http://localhost:8090/endpoints_status

    Tab tersebut menampilkan sesuatu yang mirip dengan berikut ini:

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

Nilai dalam rolloutId adalah ID konfigurasi layanan yang digunakan ESP. Untuk memastikan bahwa ESP menggunakan konfigurasi yang sama dengan Endpoints, lihat Mendapatkan nama layanan dan ID konfigurasi.