Tips dan pemecahan masalah

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

Error umum selama deployment

Error yang Anda lihat di deployment ditampilkan dalam format berikut:

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

Jenis error yang mungkin biasa Anda temui 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 dasar di kolom message.ResourceErrorCode dan message.ResourceErrorMessage.

Error validasi (kode: CONDITION_NOT_MET)

Anda mendapatkan error validasi saat kolom dalam konfigurasi gagal divalidasi, misalnya jika kolom tersebut 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 tidak terganggu.

Error saat memperluas template

Template Anda memiliki batas 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 memori yang terlalu banyak.
  • MANIFEST_EXPANSION_TOO_MUCH_WALL_TIME: Memperluas konfigurasi memerlukan waktu terlalu banyak.
  • MANIFEST_EXPANSION_USER_ERROR: Terjadi error pada konfigurasi atau salah satu template Anda.

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

Untuk mengatasi error ini, sebaiknya pisahkan template menjadi template yang lebih kecil, atau sederhanakan template tersebut.