Streaming artefak di Azure Container Registry (Pratinjau)

Streaming artefak adalah fitur di Azure Container Registry yang memungkinkan Anda menyimpan gambar kontainer dalam satu registri, mengelola, dan mengalirkan gambar kontainer ke kluster Azure Kubernetes Service (AKS) di beberapa wilayah. Fitur ini dirancang untuk mempercepat beban kerja kontainer untuk pelanggan Azure menggunakan AKS. Dengan streaming artefak, Anda dapat dengan mudah menskalakan beban kerja tanpa harus menunggu waktu tarik yang lambat untuk simpul Anda.

Kasus penggunaan

Berikut adalah beberapa skenario untuk menggunakan streaming artefak:

Menyebarkan aplikasi dalam kontainer ke beberapa wilayah: Dengan streaming artefak, Anda dapat menyimpan gambar kontainer dalam satu registri dan mengelola dan mengalirkan gambar kontainer ke kluster AKS di beberapa wilayah. Streaming artefak memungkinkan penyebaran aplikasi kontainer ke berbagai wilayah tanpa menghabiskan waktu dan sumber daya.

Mengurangi latensi penarikan gambar: Streaming artefak dapat mengurangi waktu kesiapan pod lebih dari 15%, tergantung pada ukuran gambar, dan berfungsi paling baik untuk gambar < 30 GB. Fitur ini mengurangi latensi penarikan gambar dan startup kontainer cepat, yang bermanfaat bagi pengembang perangkat lunak dan arsitek sistem.

Penskalaan efektif aplikasi terkontainerisasi: Streaming artefak memberikan kesempatan untuk merancang, membangun, dan menyebarkan aplikasi terkontainerisasi dalam skala besar.

Aspek streaming artefak

Berikut adalah beberapa aspek singkat dari streaming artefak:

• Pelanggan dengan registri baru dan yang sudah ada dapat memulai streaming artefak untuk repositori atau tag tertentu.

• Pelanggan dapat menyimpan baik artefak asli maupun artefak streaming di ACR dengan memulai streaming artefak.

• Pelanggan memiliki akses ke artefak asal dan artefak yang dialirkan bahkan setelah menonaktifkan streaming artefak untuk repositori atau artefak.

• Pelanggan yang memiliki streaming artefak dan Penghapusan Sementara diaktifkan, ketika menghapus repositori atau artefak, maka kedua versi yakni versi asli dan versi streaming artefak tersebut dihapus. Namun, hanya versi asli yang tersedia di portal penghapusan sementara.

Informasi ketersediaan dan harga

Streaming artefak hanya tersedia di tingkat layanan Premium(juga dikenal sebagai SKU). Streaming artefak berpotensi meningkatkan konsumsi penyimpanan registri secara keseluruhan. Pelanggan dikenakan lebih banyak biaya penyimpanan seperti yang diuraikan dalam harga kami jika konsumsi melebihi ambang batas SKU Premium 500 GiB yang disertakan.

Batasan pratinjau

Streaming artefak saat ini sedang dalam tahap pratinjau. Batasan berikut berlaku:

• Hanya gambar dengan arsitektur Linux AMD64 yang didukung dalam rilis pratinjau.
• Rilis pratinjau tidak mendukung citra kontainer yang berbasis Windows dan citra ARM64.
• Rilis pratinjau sebagian mendukung gambar multi-arsitektur; hanya arsitektur AMD64 yang didukung.
• Untuk membuat kumpulan simpul berbasis Ubuntu di AKS, pilih Ubuntu versi 20.04 atau yang lebih tinggi.
• Untuk Kubernetes, gunakan Kubernetes versi 1.26 atau lebih tinggi atau Kubernetes versi > 1.25.
• Hanya registri SKU premium yang mendukung pembuatan artefak streaming dalam rilis pratinjau. Registri SKU nonpremium tidak menawarkan fitur ini saat masa pratinjau.
• Daftar CMK (Kunci yang Dikelola Pelanggan) TIDAK didukung dalam versi pratinjau.
• Regcred Kubernetes saat ini TIDAK didukung.

Prasyarat

• Anda dapat menggunakan Azure Cloud Shell atau penginstalan lokal Azure CLI untuk menjalankan contoh perintah dalam artikel ini. Jika Anda ingin menggunakannya secara lokal, diperlukan versi 2.54.0 atau yang lebih baru. Jalankan az --version untuk menemukan versi. Jika Anda perlu memasang atau meningkatkan, lihat Memasang Azure CLI.

• Masuk ke portal Azure.

Mulai streaming artifak

Mulai streaming artefak dengan menggunakan perintah Azure CLI dan portal Azure untuk mengirim, mengimpor, dan menghasilkan artefak streaming untuk citra kontainer di Azure Container Registry (ACR). Instruksi ini menguraikan proses untuk membuat ACR SKU Premium, mengimpor gambar, menghasilkan artefak streaming, dan mengelola operasi streaming artefak. Pastikan untuk mengganti placeholder dengan nilai yang sesuai jika diperlukan.

Mendorong/Mengimpor gambar dan menghasilkan artefak streaming - Azure CLI

Streaming artefak tersedia di tingkat layanan registri kontainer Premium . Untuk memulai streaming Artefak, perbarui registri menggunakan Azure CLI (versi 2.54.0 atau lebih tinggi). Untuk memasang atau meningkatkan, lihat Pasang Azure CLI.

Mulai streaming artefak, dengan mengikuti langkah-langkah umum berikut:

Catatan

Jika Anda sudah memiliki registri kontainer premium, Anda dapat melewati langkah ini. Jika pengguna menggunakan SKU Dasar Standar, perintah berikut akan gagal. Kode ditulis dalam Azure CLI dan dapat dijalankan dalam mode interaktif. Harap diperhatikan bahwa placeholder harus diganti dengan nilai aktual sebelum menjalankan perintah.

1. Buat Azure Container Registry (ACR) baru menggunakan SKU premium melalui:

   Misalnya, jalankan perintah buat grup az untuk membuat Grup Sumber Daya Azure dengan nama my-streaming-test di wilayah US Barat lalu jalankan perintah az acr create.

   az group create -n my-streaming-test -l westus
   az acr create -n mystreamingtest -g my-streaming-test -l westus --sku premium
   

2. Dorong atau impor gambar ke registri melalui:

   Misalnya, jalankan perintah [az configure] untuk mengonfigurasi ACR default, dan perintah az acr import untuk mengimpor gambar Jupyter Notebook dari Docker Hub ke mystreamingtest ACR.

   az configure --defaults acr="mystreamingtest"
   az acr import --source docker.io/jupyter/all-spark-notebook:latest -t jupyter/all-spark-notebook:latest
   

3. Membuat streaming artefak dari Gambar

   Memulai pembuatan artefak streaming dari gambar yang ditentukan.

   Misalnya, jalankan perintah az acr artefact-streaming create untuk membuat artefak streaming dari jupyter/all-spark-notebook:latest gambar di mystreamingtest ACR.

   az acr artifact-streaming create --image jupyter/all-spark-notebook:latest
   

Catatan

ID operasi dihasilkan selama proses untuk referensi di masa mendatang untuk memverifikasi status operasi.

4. Verifikasi streaming artefak yang dihasilkan di Azure CLI.

   Misalnya, jalankan perintah az acr manifest list-referrers untuk mencantumkan artefak streaming untuk jupyter/all-spark-notebook:latest gambar di mystreamingtest ACR.

   az acr manifest list-referrers -n jupyter/all-spark-notebook:latest
   

5. Membatalkan pembuatan streaming artefak (jika diperlukan)

   Batalkan pembuatan artefak streaming jika konversi belum selesai. Ini menghentikan operasi.

   Misalnya, jalankan perintah az acr artefact-streaming operation cancel untuk membatalkan operasi konversi untuk jupyter/all-spark-notebook:latest gambar di mystreamingtest ACR.

   az acr artifact-streaming operation cancel --repository jupyter/all-spark-notebook --id c015067a-7463-4a5a-9168-3b17dbe42ca3
   

6. Memulai konversi otomatis pada repositori

   Mulai konversi otomatis di repositori untuk gambar yang baru didorong atau diimpor. Ketika dimulai, gambar baru yang diunggah ke repositori tersebut memicu pembuatan artefak streaming yang baru.

   Catatan

   Konversi otomatis tidak berlaku untuk gambar yang ada. Gambar yang ada dapat dikonversi secara manual.

   Misalnya, jalankan perintah az acr artefak-streaming update untuk memulai konversi otomatis untuk repositori jupyter/all-spark-notebook di dalam mystreamingtest ACR.

   az acr artifact-streaming update --repository jupyter/all-spark-notebook --enable-streaming true
   

7. Verifikasi kemajuan konversi streaming, setelah mengunggah gambar baru jupyter/all-spark-notebook:newtag ke repositori di atas.

   Misalnya, jalankan perintah az acr artifact-streaming operation show untuk memeriksa status operasi konversi gambar jupyter/all-spark-notebook:newtag di mystreamingtest ACR.

   az acr artifact-streaming operation show --image jupyter/all-spark-notebook:newtag
   

8. Setelah Anda memverifikasi status konversi, Anda sekarang dapat tersambung ke AKS. Lihat dokumentasi AKS.

9. Nonaktifkan artefak streaming dari repositori.

   Misalnya, jalankan perintah az acr artefact-streaming update untuk menghapus artefak streaming untuk jupyter/all-spark-notebook:latest gambar di mystreamingtest ACR.

   az acr artifact-streaming update --repository jupyter/all-spark-notebook --enable-streaming false
   

Catatan

Streaming artefak dapat berfungsi di seluruh wilayah, terlepas dari apakah replikasi geografis dimulai atau tidak. Streaming artefak dapat bekerja melalui titik akhir privat dan menghubungkannya.

Dorong/Impor gambar dan hasilkan artefak streaming - portal Azure

Streaming artefak tersedia di premiumSKU Azure Container Registry. Untuk memulai streaming artefak, perbarui registri menggunakan portal Azure.

Ikuti langkah-langkah untuk membuat streaming artefak di portal Azure.

1. Navigasikan ke Azure Container Registry Anda.

2. Di Menu samping, di bawah Layanan, pilih Repositori.

3. Pilih gambar terbaru yang diimpor.

4. Konversikan gambar dan buat streaming artefak di portal Azure.

   

5. Periksa artefak streaming yang dihasilkan dari gambar di tab Rujukan.

   

6. Anda juga dapat menghapus streaming artefak dari repositori.

   

7. Anda juga dapat mengaktifkan konversi otomatis dengan mengakses repositori di portal. Aktif berarti autoconversion diaktifkan pada repositori. Tidak aktif berarti konversi otomatis dinonaktifkan pada repositori.

   

Catatan

Status streaming artefak di repositori (tidak aktif atau aktif) menentukan apakah citra kompatibel yang baru saja didorong akan dikonversi secara otomatis. Secara default, semua repositori berada dalam status tidak aktif untuk streaming artefak. Ini berarti bahwa ketika gambar baru yang kompatibel didorong ke repositori, streaming artefak tidak akan dipicu, dan gambar tidak akan dikonversi secara otomatis. Jika Anda ingin konversi otomatis gambar yang baru saja dipush dimulai, Anda perlu mengatur streaming artefak repositori ke status aktif. Setelah repositori dalam status aktif, gambar kontainer kompatibel baru yang diunggah ke repositori akan mengaktifkan streaming artefak. Ini akan memulai konversi otomatis gambar-gambar tersebut.

Langkah berikutnya

Memecahkan masalah streaming Artefak