Ringkasan pemecahan masalah

Halaman ini memberikan informasi pemecahan masalah umum dan memberikan link ke halaman lain untuk informasi tambahan.

Error saat men-deploy konfigurasi Cloud Endpoints

Jika Anda mendapatkan pesan error dari perintah gcloud endpoints services deploy, baca artikel Memecahkan masalah deployment konfigurasi Endpoint untuk mendapatkan informasi tentang cara memecahkan masalah error tersebut.

Error saat men-deploy backend API

Deployment API dan Extensible Service Proxy (ESP) ke backend Google Cloud bergantung pada platform. Lihat panduan pemecahan masalah berikut untuk informasi selengkapnya:

Error respons

Saat Anda mengirim permintaan ke API dan menerima respons error, lihat Memecahkan masalah error respons untuk mendapatkan informasi tentang cara memecahkan masalah error.

Memeriksa layanan yang diperlukan

Memeriksa layanan yang diperlukan

Setidaknya, Endpoint dan ESP mengharuskan layanan Google berikut diaktifkan:
Nama Judul
servicemanagement.googleapis.com Service Management API
servicecontrol.googleapis.com Service Control API
endpoints.googleapis.com Google Cloud Endpoints

Dalam sebagian besar kasus, perintah gcloud endpoints services deploy akan mengaktifkan layanan wajib ini. Namun, perintah gcloud berhasil diselesaikan tetapi tidak mengaktifkan layanan yang diperlukan dalam situasi berikut:

  • Jika Anda menggunakan aplikasi pihak ketiga seperti Terraform, dan Anda tidak menyertakan layanan ini.

  • Anda telah men-deploy konfigurasi Endpoint ke project Google Cloud yang ada, yang menonaktifkan layanan ini secara eksplisit.

Gunakan perintah berikut untuk mengonfirmasi bahwa layanan yang diperlukan telah diaktifkan:

gcloud services list

Jika Anda tidak melihat layanan yang diperlukan tercantum, aktifkan layanan tersebut:

gcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.com
gcloud services enable endpoints.googleapis.com

Aktifkan juga layanan Endpoint Anda:

gcloud services enable ENDPOINTS_SERVICE_NAME

Untuk menentukan ENDPOINTS_SERVICE_NAME, Anda dapat:

  • Setelah men-deploy konfigurasi Endpoint, buka halaman Endpoint di Cloud Console. Daftar kemungkinan ENDPOINTS_SERVICE_NAME ditampilkan di bawah kolom Service name.

  • Untuk OpenAPI, ENDPOINTS_SERVICE_NAME adalah yang Anda tentukan dalam kolom host pada spesifikasi OpenAPI. Untuk gRPC, ENDPOINTS_SERVICE_NAME adalah yang Anda tentukan di kolom name pada konfigurasi Endpoint gRPC Anda.

Untuk mengetahui informasi selengkapnya tentang perintah gcloud, lihat layanan gcloud.

Memeriksa izin yang diperlukan

Instance yang menjalankan Extensible Service Proxy memerlukan izin untuk memanggil Service Management dan ServiceControl.

Memeriksa informasi debug

Menjalankan Google Cloud CLI dengan panjang debug akan membantu proses debug.

gcloud --verbosity=debug COMMAND

Dengan perintah ini, Google Cloud CLI akan mencetak log error yang panjang. Bergantung pada perintah yang dijalankan, output dapat menyertakan informasi permintaan dan respons dari server.

Mengaktifkan layanan

Anda dapat memeriksa apakah layanan diaktifkan menggunakan gcloud.

gcloud services list

Untuk menampilkan konfigurasi layanan tertentu, gunakan perintah berikut:

gcloud endpoints services describe SERVICE_NAME

OAuth proxy gagal, tetapi permintaan lulus

Pastikan ada bagian security yang mencantumkan definisi OAuth Anda di dokumen OpenAPI. Contoh file spesifikasi tersedia di Contoh untuk memulai di GitHub.

Langkah selanjutnya