Memecahkan masalah deployment konfigurasi Cloud Endpoints

OpenAPI | gRPC

Halaman ini menjelaskan cara memecahkan masalah yang mungkin Anda alami saat men-deploy konfigurasi Cloud Endpoints. Pesan error yang Anda lihat berisi informasi khusus untuk project Anda. Misalnya, Anda mungkin melihat pesan error yang berisi project ID Anda di dalamnya. Di halaman ini, Anda akan melihat nilai placeholder seperti YOUR_PROJECT_ID.

Setelah melakukan setiap langkah, jalankan kembali perintah gcloud endpoints services deploy untuk melihat apakah error telah teratasi.

Tidak dapat mengonversi ke konfigurasi layanan

ERROR: unknown location: http: In path template '[PATH]': unexpected end of input '/'.'

Error ini ditampilkan saat satu atau beberapa jalur dalam dokumen OpenAPI Anda menyertakan karakter garis miring (/). Untuk memperbaiki masalah ini, hapus garis miring di akhir semua jalur. Misalnya, cuplikan berikut dalam dokumen OpenAPI menghasilkan error ini:

paths:
  "/echo/":
    post:
      description: "Echo back a given message."

Untuk memperbaikinya, hapus garis miring dari /echo/:

paths:
  "/echo":
    post:
      description: "Echo back a given message."

Tidak diizinkan mendapatkan setelan project

ERROR: (gcloud.endpoints.services.deploy) PERMISSION_DENIED:
Not allowed to get project settings for project YOUR_PROJECT_ID

Lakukan autentikasi dengan gcloud CLI lagi untuk mengonfirmasi bahwa Anda melakukan autentikasi dengan akun yang memiliki izin untuk mengakses project yang ditampilkan dalam pesan error:
```
gcloud auth login
```
Tab browser baru akan terbuka dan Anda akan diminta untuk memilih akun.
Pastikan bahwa project ID yang ditampilkan dalam pesan error sesuai dengan project Google Cloud yang Anda inginkan untuk men-deploy konfigurasi Endpoint:
```
gcloud projects list
```
Pastikan gcloud CLI memiliki project ID yang benar sebagai project saat ini:
```
gcloud config set project YOUR_PROJECT_ID
```

Penelepon tidak memiliki izin

ERROR: (gcloud.endpoints.services.deploy) PERMISSION_DENIED:
Caller does not have permission 'servicemanagement.services.create' on project YOUR_PROJECT_ID

Saat Anda pertama kali men-deploy konfigurasi Endpoint, Pengelolaan Layanan akan membuat layanan terkelola untuk API Anda. Untuk membuat layanan terkelola, setidaknya Anda harus memiliki peran Editor di level project. Setelah Pengelolaan Layanan membuat layanan terkelola, izin minimum yang diperlukan untuk men-deploy ulang konfigurasi Endpoint adalah peran Service Config Editor (roles/servicemanagement.configEditor) di layanan. Untuk informasi selengkapnya, lihat Memberikan akses ke API.

Kepemilikan untuk nama domain tidak dapat diverifikasi

ERROR: (gcloud.endpoints.services.deploy) PERMISSION_DENIED:
Ownership for domain name YOUR_DOMAIN_NAME on project YOUR_PROJECT_ID cannot be verified

Jika memiliki domain kustom (seperti example.com) yang dikonfigurasi di kolom host pada dokumen OpenAPI, Anda harus memverifikasi nama domain sebelum dapat men-deploy dokumen OpenAPI.
Jika Anda menggunakan domain cloud.goog, pastikan nilai untuk kolom host dalam format berikut, dan project ID sudah benar:
```
API_NAME.endpoints.YOUR_PROJECT_ID.cloud.goog
```
Jika Anda menggunakan domain appspot.com (hanya didukung untuk App Engine), pastikan kolom host memiliki format berikut, dan project ID sudah benar:
```
YOUR_PROJECT_ID.appspot.com
```

Memecahkan masalah error lainnya

Jika Anda menerima error yang tidak tercantum di sini, atau jika informasi tersebut tidak memecahkan masalah, jalankan lagi perintah gcloud dengan flag tersebut untuk menampilkan informasi debug:

gcloud --verbosity=debug endpoints services deploy openapi.yaml