Memecahkan masalah deployment fleksibel App Engine

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

Error saat deployment

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

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

Pastikan file app.yaml Anda memiliki bagian readiness_check dengan nilai untuk app_start_timeout_sec. Jika tidak ada, tambahkan bagian dan tetapkan nilai app_start_timeout_sec ke lebih tinggi dari default 300 detik. Untuk 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 mengetahui 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 Anda tentukan di bagian ini untuk mendapatkan konfigurasi untuk layanan Anda. Anda harus menentukan ID konfigurasi di kolom config_id, atau menyertakan opsi rollout_strategy: managed, tetapi tidak boleh keduanya. Opsi ini mengonfigurasi ESP untuk menggunakan konfigurasi layanan terbaru yang di-deploy. Saat Anda menentukan opsi ini, hingga 5 menit setelah Anda men-deploy konfigurasi layanan baru, ESP akan 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. 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 ditetapkan ke "fixed" Pesan error ini ditampilkan saat app.yaml tidak menyertakan rollout_strategy: managed atau rollout_strategy ditetapkan 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 di app.yaml dan jalankan ulang gcloud app deploy.

Melihat log di instance

Error App Engine dan log sistem memberikan informasi tentang alasan aplikasi gagal diluncurkan atau berperforma seperti yang diinginkan. Anda dapat menemukan informasi proses debug selengkapnya di log Endpoints.

  1. Di konsol Google Cloud, gunakan SSH untuk terhubung ke virtual machine Anda. Lihat menghubungkan ke instance untuk mengetahui informasi selengkapnya.

  2. Gunakan penampil teks seperti tail:

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

Langkah selanjutnya