Memecahkan masalah deployment fleksibel App Engine

Dokumen ini menjelaskan teknik pemecahan masalah untuk deployment Cloud Endpoints di lingkungan fleksibel App Engine. Jika Anda menerima error kembali dari permintaan ke API, lihat Memecahkan masalah error respons untuk mendapatkan informasi tentang cara memecahkan masalah error tersebut.

Error saat deployment

Bagian ini menjelaskan cara memecahkan masalah error dari gcloud app deploy.

Pesan error Pemecahan masalah
Deployment Anda gagal dalam kondisi baik dalam waktu yang ditentukan, sehingga di-roll back. Jika Anda yakin ini adalah error, coba sesuaikan setelan app_start_timeout_sec di bagian readiness_check.

Periksa apakah file app.yaml Anda memiliki bagian readiness_check dengan nilai untuk app_start_timeout_sec. Jika tidak ada, tambahkan bagian tersebut dan tetapkan nilai app_start_timeout_sec ke lebih tinggi daripada default 300 detik. Untuk mengetahui informasi selengkapnya, lihat pemeriksaan kesiapan.

Pastikan semua layanan Google Cloud yang diperlukan Endpoint dan ESP diaktifkan di project Anda. Lihat Memeriksa layanan yang diperlukan untuk detailnya.

Pesan error tentang rollout_strategy

Saat mengonfigurasi app.yaml sebelum men-deploy, Anda harus menambahkan bagian endpoints_api_service. Extensible Service Proxy (ESP) memerlukan setelan yang ditentukan di bagian ini untuk mendapatkan konfigurasi bagi layanan Anda. Anda harus menentukan ID konfigurasi di kolom config_id, atau menyertakan opsi rollout_strategy: managed, tetapi jangan keduanya. Opsi ini mengonfigurasi ESP agar menggunakan konfigurasi layanan terbaru yang di-deploy. Saat Anda menentukan opsi ini, hingga 5 menit setelah Anda men-deploy konfigurasi layanan baru, ESP mendeteksi perubahan dan otomatis mulai menggunakannya. Sebaiknya tentukan opsi ini, bukan ID konfigurasi tertentu yang akan digunakan ESP. Contoh:

endpoints_api_service:
  name: example-project-12345.appspot.com
  rollout_strategy: managed

Jika bagian endpoints_api_service tidak menyertakan informasi yang diperlukan ESP untuk mendapatkan konfigurasi layanan, salah satu pesan berikut akan ditampilkan:

Pesan error Pemecahan masalah
config_id dilarang jika rollout_strategy ditetapkan ke "managed" Anda tidak dapat menentukan ID konfigurasi dan rollout_strategy: managed sekaligus. Kecuali jika Anda memiliki alasan untuk menggunakan ID konfigurasi tertentu, sebaiknya hapus config_id: [YOUR_CONFIG_ID] dari app.yaml dan jalankan kembali gcloud app deploy.
config_id harus ditentukan jika rollout_strategy tidak ditentukan atau disetel ke "fixed" Pesan error ini ditampilkan jika app.yaml tidak menyertakan rollout_strategy: managed atau rollout_strategy disetel ke fixed dan Anda belum menentukan ID konfigurasi. Kecuali jika Anda memiliki alasan untuk menggunakan ID konfigurasi tertentu, sebaiknya tambahkan rollout_strategy: managed ke bagian endpoints_api_service dalam app.yaml dan jalankan ulang gcloud app deploy.

Melihat log pada instance

Error App Engine dan log sistem memberikan informasi tentang penyebab aplikasi gagal diluncurkan atau berfungsi sebagaimana mestinya. Anda dapat menemukan informasi proses debug lebih lanjut di log Endpoint.

  1. Di konsol Google Cloud, terapkan SSH ke virtual machine Anda. Baca bagian menghubungkan ke instance untuk mengetahui informasi selengkapnya.

  2. Gunakan penampil teks seperti tail:

     tail -f /var/log/nginx/error.log

Langkah selanjutnya