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 menyebarkan aplikasi kontainer ke beberapa 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 aplikasi kontainer yang efektif: Streaming artefak memberikan kesempatan untuk merancang, membangun, dan menyebarkan aplikasi dalam kontainer dalam skala tinggi.

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 artefak asli dan streaming di ACR dengan memulai streaming artefak.

  • Pelanggan memiliki akses ke artefak asli dan streaming bahkan setelah menonaktifkan streaming artefak untuk repositori atau artefak.

  • Pelanggan dengan streaming artefak dan Penghapusan Sementara diaktifkan, menghapus repositori atau artefak, lalu versi streaming asli dan artefak 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 dalam pratinjau. Batasan berikut berlaku:

  • Hanya gambar dengan arsitektur Linux AMD64 yang didukung dalam rilis pratinjau.
  • Rilis pratinjau tidak mendukung gambar kontainer berbasis Windows dan gambar 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 fungsionalitas ini selama pratinjau.
  • Registri CMK (Kunci yang Dikelola Pelanggan) TIDAK didukung dalam rilis 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 artefak

Mulai streaming artefak dengan seri dengan perintah Azure CLI dan portal Azure untuk mendorong, mengimpor, dan menghasilkan artefak streaming untuk gambar 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 tempat penampung dengan nilai aktual Anda jika perlu.

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 dicatat bahwa tempat penampung 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 untuk membuat Azure Container Registry premium dengan nama mystreamingtest di grup sumber daya tersebut.

    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 perintah impor ACR dan az acr default 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.

  1. 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
    
  2. 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
    
  3. Memulai konversi otomatis pada repositori

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

    Catatan

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

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

    az acr artifact-streaming update --repository jupyter/all-spark-notebook --enable-streaming true
    
  4. Verifikasi kemajuan konversi streaming, setelah mendorong gambar jupyter/all-spark-notebook:newtag baru ke repositori di atas.

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

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

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 melampirkannya.

Dorong/Impor gambar dan hasilkan artefak streaming - portal Azure

Streaming artefak tersedia di SKU premiumAzure 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.

    A screenshot of Azure portal with the create streaming artifact button highlighted.

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

    A screenshot of Azure portal with the streaming artifact highlighted.

  6. Anda juga dapat menghapus streaming artefak dari repositori.

    A screenshot of Azure portal with the delete artifact streaming button highlighted.

  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.

    A screenshot of Azure portal with the start artifact streaming button highlighted.

Catatan

Status streaming artefak di repositori (tidak aktif atau aktif) menentukan apakah gambar yang kompatibel yang baru 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 memulai konversi otomatis gambar yang baru didorong, Anda perlu mengatur streaming artefak repositori ke status aktif. Setelah repositori dalam status aktif, gambar kontainer baru yang kompatibel yang didorong ke repositori akan memicu streaming artefak. Ini akan memulai konversi otomatis gambar-gambar tersebut.

Langkah berikutnya