Bagikan melalui

Memperbarui kontainer di Azure Container Instances

  • Artikel

Selama pengoperasian normal instans kontainer, Anda dapat merasa perlu untuk memperbarui kontainer yang sedang berjalan dalam grup kontainer. Misalnya, Anda mungkin ingin memperbarui properti seperti versi gambar, nama DNS, atau variabel lingkungan, atau merefresh properti dalam kontainer yang aplikasinya mengalami crash.

Perbarui kontainer dalam grup kontainer yang sedang berjalan dengan melakukan penyebaran ulang grup yang ada dengan setidaknya satu properti yang dimodifikasi. Saat Anda memperbarui grup kontainer, semua kontainer yang sedang berjalan dalam grup akan dihidupkan ulang di tempat, biasanya di host kontainer yang mendasari yang sama.

Catatan

Grup kontainer yang dihentikan atau dihapus tidak dapat diperbarui. Setelah grup kontainer dihentikan (dengan status Berhasil atau Gagal) atau dihapus, grup harus disebarkan sebagai grup baru. Lihat batasan lainnya.

Memperbarui satu grup kontainer

Untuk memperbarui grup kontainer yang ada:

  • Keluarkan perintah buat (atau gunakan portal Microsoft Azure) dan tentukan nama grup yang sudah ada
  • Ubah atau tambahkan setidaknya satu properti grup yang mendukung pembaruan saat Anda melakukan penyebaran ulang. Properti tertentu tidak mendukung pembaruan.
  • Atur properti lain dengan nilai yang Anda berikan sebelumnya. Jika Anda tidak mengatur nilai untuk properti, properti tersebut akan kembali ke nilai default.

Catatan

Jika Anda mengatur semua properti ke nilai yang sebelumnya Anda berikan dan tidak mengubah atau menambahkan apa pun, kontainer akan memulai ulang sebagai respons terhadap perintah buat.

Tip

File YAML membantu mempertahankan konfigurasi penyebaran grup kontainer, dan menyediakan titik awal untuk menyebarkan grup yang diperbarui. Jika menggunakan metode yang berbeda untuk membuat grup, Anda dapat mengekspor konfigurasi ke YAML dengan menggunakan az container export,

Contoh

Contoh Azure CLI berikut memperbarui grup kontainer dengan label nama DNS baru. Karena properti label nama DNS grup adalah salah satu yang dapat diperbarui, grup kontainer disebarkan ulang, dan kontainernya dihidupkan ulang.

Penyebaran awal dengan label nama DNS myapplication-staging:

# Create container group
az container create --resource-group myResourceGroup --name mycontainer \
    --image nginx:alpine --dns-name-label myapplication-staging

Perbarui grup kontainer dengan label nama DNS baru, aplikasi, dan atur properti yang tersisa dengan nilai yang digunakan sebelumnya:

# Update DNS name label (restarts container), leave other properties unchanged
az container create --resource-group myResourceGroup --name mycontainer \
    --image nginx:alpine --dns-name-label myapplication

Keuntungan pembaruan

Keuntungan utama memperbarui grup kontainer yang ada adalah penyebaran yang lebih cepat. Ketika Anda menyebarkan ulang grup kontainer yang ada, lapisan gambar kontainernya ditarik dari lapisan yang di-cache oleh penyebaran sebelumnya. Alih-alih menarik semua lapisan gambar yang baru dari registri seperti yang dilakukan di penyebaran baru, hanya lapisan yang dimodifikasi (jika ada) saja yang ditarik.

Aplikasi berdasarkan gambar kontainer yang lebih besar seperti Windows Server Core dapat melihat peningkatan signifikan dalam kecepatan penyebaran saat Anda memperbarui alih-alih menghapus dan menyebarkan yang baru.

Batasan

  • Tidak semua properti grup kontainer mendukung pembaruan. Untuk mengubah beberapa properti grup kontainer, Anda harus terlebih dahulu menghapus, lalu melakukan penyebaran ulang grup. Lihat Properti yang memerlukan penghapusan kontainer.
  • Semua kontainer dalam grup kontainer akan dihidupkan ulang saat Anda memperbarui grup kontainer. Anda tidak dapat melakukan pembaruan atau hidupkan ulang di tempat dari kontainer tertentu dalam grup multi-kontainer.
  • Alamat IP grup kontainer biasanya dipertahankan di antara pembaruan, tetapi tidak dijamin tetap sama. Selama grup kontainer disebarkan ke host yang mendasari yang sama, grup kontainer akan mempertahankan alamat IP-nya. Meskipun jarang, ada beberapa peristiwa internal Azure yang dapat menyebabkan penyebaran ulang ke host yang berbeda. Untuk memitigasi masalah ini, sebaiknya gunakan label nama DNS untuk instans kontainer Anda.
  • Grup kontainer yang dihentikan atau dihapus tidak dapat diperbarui. Setelah grup kontainer dihentikan (dalam status Dihentikan) atau dihapus, grup akan disebarkan sebagai grup baru.

Catatan

Perintah pembaruan mungkin tidak berfungsi jika Grup Kontainer Azure dilampirkan ke profil Azure Storage.

Properti yang memerlukan penghapusan kontainer

Tidak semua properti grup kontainer dapat diperbarui. Misalnya, untuk mengubah kebijakan hidupkan ulang dari kontainer, Anda harus terlebih dahulu menghapus grup kontainer, lalu membuatnya lagi.

Perubahan pada properti ini memerlukan penghapusan grup kontainer sebelum penyebaran ulang:

  • Jenis OS
  • Sumber daya CPU, memori, atau GPU
  • Memulai ulang kebijakan
  • Profil jaringan
  • Zona ketersediaan

Penting

Profil jaringan telah dihentikan pada versi API 2021-07-01. Jika Anda menggunakan versi ini atau yang lebih baru, abaikan langkah dan tindakan apa pun yang terkait dengan profil jaringan.

Saat Anda menghapus grup kontainer dan membuatnya kembali, grup tersebut bukan "disebarkan ulang," tetapi dibuat baru. Semua lapisan gambar ditarik segar dari registri, bukan dari lapisan yang di-cache oleh penyebaran sebelumnya. Alamat IP kontainer juga dapat berubah karena disebarkan ke host yang mendasari yang berbeda.

Langkah berikutnya

Artikel ini menyebutkan grup kontainer beberapa kali. Setiap kontainer dalam Azure Container Instances disebarkan dalam grup kontainer, dan grup kontainer dapat berisi lebih dari satu kontainer. Artikel berikut ini menyediakan informasi selengkapnya tentang grup kontainer: