Tips dan pemecahan masalah

Bagian berikut dapat membantu Anda jika mengalami masalah saat menggunakan Deployment Manager.

Error umum selama deployment

Error yang Anda lihat dalam deployment memiliki format berikut:

- code: ERROR_CODE
  location: /path/to/template
  message: "{"Error message"}"

Jenis error yang biasanya Anda lihat dijelaskan di bagian berikut.

Error resource (kode: RESOURCE_ERROR)

Error resource disebarkan dari API yang mendasarinya untuk resource yang Anda kelola dengan Deployment Manager. Misalnya, jika deployment Anda memiliki instance VM Compute Engine, dan terjadi error saat membuat instance, Anda akan melihat error tersebut sebagai error resource di Deployment Manager.

Dalam respons Deployment Manager, Anda dapat melihat error dari API yang mendasarinya di kolom message.ResourceErrorCode dan message.ResourceErrorMessage.

Error validasi (kode: CONDITION_NOT_MET)

Anda akan mendapatkan error validasi saat kolom dalam konfigurasi gagal validasi, seperti jika kolom menggunakan nilai string saat boolean diharapkan.

Loop dependensi (kode: CYCLIC_REFERENCES)

Menunjukkan bahwa konfigurasi Anda memiliki loop dependensi. Misalnya, jika resource A bergantung pada resource B, B bergantung pada C, dan C bergantung pada A.

Pesan error menunjukkan resource yang berada dalam loop dependensi.

Anda mungkin melihat dependensi dalam resource dalam skenario berikut:

  • Referensi ke properti resource lain. Misalnya, jika deployment Anda memiliki pengelola grup instance yang menggunakan template instance dari deployment yang sama, pengelola grup instance secara implisit bergantung pada template instance. Deployment Manager membuat template instance terlebih dahulu, lalu membuat pengelola grup instance.

  • Properti dependsOn eksplisit, yang menunjukkan bahwa resource saat ini harus dibuat setelah resource yang menjadi dependensinya.

Untuk mengatasi error, ubah referensi atau properti dependsOn sehingga loop terputus.

Error saat memperluas template

Template Anda dibatasi jumlah waktu dan resource yang digunakan Deployment Manager untuk memperluas template menjadi satu konfigurasi.

Anda mungkin melihat salah satu error berikut:

  • MANIFEST_EXPANSION_TOO_MUCH_CPU: Memperluas konfigurasi memerlukan terlalu banyak CPU.
  • MANIFEST_EXPANSION_TOO_MUCH_MEMORY: Memperluas konfigurasi memerlukan terlalu banyak memori.
  • MANIFEST_EXPANSION_TOO_MUCH_WALL_TIME: Memperluas konfigurasi memerlukan terlalu banyak waktu.
  • MANIFEST_EXPANSION_USER_ERROR: Ada error dalam konfigurasi atau salah satu template Anda.

MANIFEST_EXPANSION_TOO_MUCH_CPU dan MANIFEST_EXPANSION_TOO_MUCH_MEMORY mungkin menunjukkan bahwa template Anda mungkin memiliki struktur kompleks yang melibatkan rekursi, atau terlalu banyak loop.

Untuk mengatasi error ini, pertimbangkan untuk membagi template menjadi template yang lebih kecil, atau menyederhanakan template.