Memecahkan masalah error App Engine

Deployment

Jika Anda mengalami masalah saat men-deploy aplikasi menggunakan App Engine Admin API, halaman ini menampilkan pesan error yang mungkin Anda lihat dan memberikan saran terkait cara memperbaiki setiap error.

Pemanggil tidak memiliki izin untuk mengakses project

Error berikut terjadi saat Anda men-deploy aplikasi:

User EMAIL_ADDRESS does not have permission to access project PROJECT_ID (or it may not exist): The caller does not have permission

Error ini terjadi jika akun yang Anda gunakan untuk men-deploy aplikasi tidak memiliki izin untuk men-deploy aplikasi untuk project yang sedang berjalan.

Untuk mengatasi masalah ini, berikan peran App Engine Deployer (roles/appengine.deployer) ke akun tersebut. Untuk melihat akun mana yang Anda gunakan untuk men-deploy, lakukan salah satu hal berikut:

  • Jika Anda menggunakan Google Cloud CLI untuk melakukan deployment, jalankan perintah gcloud auth list.
  • Jika Anda melakukan deployment dari IDE, lihat setelan untuk plugin Cloud Tools.

Gagal mengambil metadata dari registry

Error berikut terjadi saat Anda men-deploy aplikasi:

Failed to fetch metadata from the registry, with reason: generic::permission_denied

Error ini terjadi jika Anda menggunakan perintah gcloud app deploy dari akun layanan yang tidak memiliki peran Admin Penyimpanan (roles/storage.admin).

Untuk mengatasi masalah ini, berikan peran Admin Penyimpanan ke akun layanan:

  • Untuk melihat akun mana yang Anda gunakan, jalankan perintah gcloud auth list.
  • Untuk memahami alasan mengapa penetapan peran App Engine Deployer (roles/appengine.deployer) saja mungkin tidak memadai dalam beberapa kasus, lihat peran App Engine.

Akun layanan harus memiliki izin untuk gambar

Error berikut terjadi saat Anda men-deploy aplikasi:

The App Engine appspot and App Engine flexible environment service accounts must have permissions on the image IMAGE_NAME

Error ini terjadi karena salah satu alasan berikut:

Gagal membuat cloud build

Error berikut terjadi saat Anda men-deploy aplikasi:

Failed to create cloud build: Permission denied

Error ini terjadi jika Anda menggunakan perintah gcloud app deploy dari akun yang tidak memiliki peran Cloud Build Editor (roles/cloudbuild.builds.editor).

Untuk mengatasi masalah ini, berikan peran Cloud Build Editor ke akun layanan yang digunakan untuk men-deploy aplikasi Anda.

Untuk melihat akun mana yang Anda gunakan, jalankan perintah gcloud auth list.

Terjadi error saat mengambil izin aplikasi

Error berikut terjadi saat Anda men-deploy aplikasi:

Permissions error fetching application apps/app_name. Please make sure you are using the correct project ID and that you have permission to view applications on the project

Jika Anda menjalankan Google Cloud CLI versi 328 atau yang lebih baru, error berikut akan terjadi saat Anda men-deploy aplikasi:

Permissions error fetching application apps/app_name. Please
make sure that you have permission to view applications on the project and that
SERVICE_ACCOUNT has the App Engine Deployer (roles/appengine.deployer) role.

Error ini terjadi jika akun yang Anda gunakan untuk men-deploy aplikasi tidak memiliki peran App Engine Deployer (roles/appengine.deployer).

Untuk mengatasi masalah ini, pastikan Anda telah memberikan peran App Engine Deployer ke akun layanan yang digunakan untuk men-deploy aplikasi Anda; berikan peran tersebut jika akun layanan tidak memilikinya. Untuk melihat akun mana yang digunakan untuk men-deploy aplikasi, lakukan salah satu langkah berikut:

  • Jika Anda menggunakan Google Cloud CLI untuk melakukan deployment, jalankan perintah gcloud auth list.
  • Jika Anda melakukan deployment dari IDE, lihat setelan untuk plugin Cloud Tools.

Waktu tunggu hingga infrastruktur aplikasi responsif telah habis

Error berikut terjadi saat Anda men-deploy aplikasi:

Timed out waiting for the app infrastructure to become healthy

Berbagai faktor dapat menyebabkan error ini, seperti izin tidak ada, error kode, CPU atau memori tidak memadai, atau health check yang gagal. Error hanya terjadi di lingkungan fleksibel App Engine.

Untuk mengatasi masalah ini, abaikan kemungkinan penyebab berikut:

  1. Pastikan Anda telah memberikan peran Editor (roles/editor) ke akun layanan App Engine default.
  2. Pastikan Anda telah memberikan peran berikut ke akun layanan yang Anda gunakan untuk menjalankan aplikasi (biasanya akun layanan default, app-id@appspot.gserviceaccount.com):

  3. Berikan peran jika akun layanan tidak memilikinya.

  4. Jika Anda melakukan deployment dalam konfigurasi VPC Bersama dan meneruskan instance_tag di app.yaml, lihat bagian ini untuk memperbaiki masalah.

Error izin saat men-deploy layanan dengan Konektor Akses VPC Serverless

Error berikut terjadi saat Anda men-deploy aplikasi:

Please ensure you have [compute.globalOperations.get] on the service project

Error ini terjadi saat pengguna atau akun layanan yang mencoba men-deploy aplikasi dengan Konektor VPC Serverless tidak memiliki izin yang diperlukan.

Untuk mengatasi masalah ini, pastikan pengguna atau akun layanan yang melakukan deployment memiliki peran Serverless VPC Access User dan Compute Viewer IAM.

Terjadi error nilai tidak valid saat men-deploy dalam konfigurasi VPC Bersama

Error berikut muncul di Cloud Logging untuk instance Flex VM saat Anda men-deploy aplikasi:

Invalid value for field 'resource.tags.items[1]': 'aef-instance'. Duplicate
tags are not allowed: aef-instance on compute.instances.insert

Error ini disebabkan oleh masalah yang sedang sering terjadi di mana pengaturan instance_tag mengakibatkan error saat membuat instance.

Untuk mengatasi masalah ini, hapus kolom instance_tag dari app.yaml, lalu deploy ulang.

Error saat men-deploy aplikasi dengan maksimal 3 instance atau kurang

Aplikasi yang di-deploy dengan max_instances disetel ke 3 atau kurang mungkin akan mengalami error atau periode nonaktif yang tidak terduga. Untuk mengatasi masalah ini, tentukan setidaknya 4 instance maksimum di app.yaml lalu deploy ulang.

Terjadi error saat melebihi batas pada instance maksimum

Error berikut terjadi saat Anda men-deploy aplikasi:

You may not have more than 'xx' total max instances in your project.

Ada batas jumlah maksimum instance yang dapat Anda buat per project. Permintaan untuk membuat instance tambahan akan gagal jika Anda melebihi batas ini.

Untuk mengatasi masalah ini, tetapkan nilaimax_instances di file app.yaml pada nilai di bawah batas ini atau hapus beberapa layanan atau versi agar jumlahnya max_instances sesuai batas.

Build selama deployment gagal tanpa adanya error di log build

Error berikut terjadi saat Anda men-deploy aplikasi:

ERROR: (gcloud.app.deploy) Cloud build failed. Check logs at https://console.cloud.google.com/cloud-build/builds/BUILD_ID?project=PROJECT_NUMBER Failure status: UNKNOWN: Error Response: [2] Build failed; check build logs for details

Merujuk pada link dalam pesan error akan menunjukkan bahwa semua langkah build berhasil. Namun, aplikasi gagal dibangun.

Masalah ini terjadi jika Anda menggunakan Kunci enkripsi yang dikelola pelanggan (CMEK) atau telah menyiapkan kebijakan retensi data untuk bucket staging.PROJECT_ID.appspot.com.

Untuk mengatasi masalah ini, ubah setelan berikut untuk bucket staging.PROJECT_ID.appspot.com Anda:

Build selama deployment gagal saat dijalankan dengan NODE_ENV=development

Error ini mungkin terjadi saat Anda men-deploy aplikasi Node.js. Secara default, runtime Node.js akan mengeksekusi npm run build jika skrip build terdeteksi di file package.json.

Hal ini dapat menyebabkan perilaku yang tidak terduga, seperti build yang berjalan lama, atau error kehabisan memori.

Tentukan NODE_ENV=development di file app.yaml Anda untuk menjamin eksekusi memiliki semua dependensi yang diperlukan.

Meskipun terjadi error, Anda dapat memaksa produksi dengan menentukan NODE_ENV: 'production' di bawah build-env-variables dalam file app.yaml Anda:

  build_env_variables:
    NODE_ENV: 'production'

Untuk mengetahui informasi selengkapnya, lihat Menjalankan langkah-langkah build kustom selama deployment.

Aktif

Bagian berikut membahas error inisialisasi dan penayangan aplikasi.

Terjadi error izin saat membuat aplikasi dengan akun layanan default

Jika Anda membuat aplikasi setelah mengaktifkan App Engine API untuk pertama kalinya, aplikasi akan gagal dengan menampilkan error berikut:

  • gcloud CLI:

    An internal error occurred while calling service consumer manager for service account.
    Creating  App Engine application in project [PROJECT__ID] and [REGION]....failed. DEBUG: (gcloud.app.create) Error Response: [13] an internal error has occurred
    
  • Log permintaan:

    Service account creation is not allowed on this project.
    
  • Konsol:

    Error while initialising App Engine.
    

Error ini dapat terjadi karena penerapan batasan kebijakan organisasi constraints/iam.disableServiceAccountCreation saat membuat aplikasi Anda. Kebijakan ini mencegah penyediaan akun layanan default App Engine PROJECT_ID@appspot.gserviceaccount.com. Akun layanan default diperlukan untuk pembuatan aplikasi dan tidak dapat dilewati. Hal ini juga berlaku saat Anda menggunakan akun layanan per versi.

Untuk mengatasi masalah ini, Anda harus menghapus batasan kebijakan organisasi constraints/iam.disableServiceAccountCreation untuk sementara agar pembuatan dan deployment akun layanan default App Engine dapat dilakukan. Selanjutnya, akun layanan default App Engine dapat dihapus atau diganti dengan akun layanan yang Anda buat setelah deployment berhasil.

Jika Anda menggunakan akun layanan yang Anda buat, tinjau Ringkasan rekomendasi peran untuk memahami cara menerapkan izin pembatasan, seperti memberikan peran pembuat token pada akun layanan yang Anda buat untuk agen layanan.

Error keamanan saat menggunakan layanan lama yang dipaketkan untuk Python

Jika Anda menggunakan API layanan lama yang dipaketkan saat aplikasi Python 3 dimulai, Anda mungkin melihat pesan error berikut:

Attempted RPC call without active security ticket

Error ini dapat terjadi dalam skenario seperti membaca nilai tertentu dari Memcache saat aplikasi Anda mulai mengonfigurasi koneksi database atau menetapkan variabel global.

Untuk mengatasi masalah ini, Anda dapat mencoba memindahkan logika tersebut ke permintaan pemanasan.