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.comgcloud 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 kolomname
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.
Untuk ESP yang di-deploy di Cloud Run, lihat Tutorial Membangun image ESPv2 baru di Cloud Run untuk mengetahui detailnya.
Untuk ESP yang di-deploy di Compute Engine, lihat Tutorial memeriksa izin yang diperlukan di Compute Engine untuk mengetahui detailnya.
Untuk ESP yang di-deploy di GKE, lihat Tutorial memeriksa izin yang diperlukan di GKE untuk mengetahui detailnya.
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 authentication
yang memiliki definisi OAuth di file konfigurasi gRPC API Anda. Contoh file konfigurasi tersedia di Contoh Toko Buku di GitHub.