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:
Akun layanan App Engine default tidak memiliki peran Storage Object Viewer (
roles/storage.objectViewer
).- Untuk mengatasi masalah ini, berikan peran Storage Object Viewer ke akun layanan.
Project Anda memiliki Perimeter Layanan VPC yang membatasi akses ke Cloud Storage API menggunakan akses berlapis.
- Untuk mengatasi masalah ini, tambahkan akun layanan yang Anda gunakan untuk men-deploy aplikasi ke accessPolicies Perimeter Layanan VPC yang sesuai.
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:
- Pastikan Anda telah memberikan peran Editor (
roles/editor
) ke akun layanan App Engine default. Pastikan Anda telah memberikan peran berikut ke akun layanan yang Anda gunakan untuk menjalankan aplikasi (biasanya akun layanan default,
app-id@appspot.gserviceaccount.com
):Berikan peran jika akun layanan tidak memilikinya.
Jika Anda melakukan deployment dalam konfigurasi VPC Bersama dan meneruskan
instance_tag
diapp.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:
- Setel enkripsi ke kunci enkripsi yang dikelola Google.
- Hapus kebijakan retensi.
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.