Tutorial: Menyebarkan dan menggunakan Azure Container Registry (ACR)

Azure Container Registry (ACR) adalah registri pribadi untuk gambar kontainer. Registri kontainer privat memungkinkan Anda membangun dan menyebarkan aplikasi dan kode kustom dengan aman. Dalam tutorial ini, bagian dua dari tujuh, Anda menyebarkan instance ACR dan mendorong gambar kontainer ke sana. Anda mempelajari cara untuk:

  • Membuat instance ACR
  • Menandai gambar kontainer untuk ACR
  • Mengunggah gambar ke ACR
  • Menampilkan gambar di registri Anda

Dalam tutorial selanjutnya, Anda mengintegrasikan instans ACR dengan kluster Kubernetes di AKS, dan menyebarkan aplikasi dari gambar.

Sebelum Anda mulai

Dalam tutorial sebelumnya, Anda membuat gambar kontainer untuk aplikasi Azure Voting sederhana. Jika Anda belum membuat gambar aplikasi Azure Voting, kembali ke Tutorial 1: Menyiapkan aplikasi untuk AKS.

Tutorial ini mengharuskan Anda menjalankan Azure CLI versi 2.0.53 atau yang lebih baru. Jalankan az --version untuk menemukan versinya. Jika Anda perlu menginstal atau memutakhirkan, lihat Menginstal Azure CLI.

Membuat Azure Container Registry

Sebelum membuat ACR, Anda memerlukan grup sumber daya. Grup sumber daya Azure adalah kontainer logis tempat Anda menyebarkan dan mengelola sumber daya Azure.

  1. Buat grup sumber daya dengan perintah az group create.
az group create --name myResourceGroup --location eastus
  1. Buat instans ACR dengan az acr create perintah dan berikan nama registri unik Anda sendiri. Nama registri harus unik dalam Azure dan berisi 5-50 karakter alfanumerik. Dalam tutorial lain di kursus ini, <acrName> digunakan sebagai tempat penampung untuk nama registri kontainer. SKU dasar adalah titik masuk yang dioptimalkan biaya untuk tujuan pengembangan yang menyediakan keseimbangan penyimpanan dan hasil.
az acr create --resource-group myResourceGroup --name <acrName> --sku Basic

Masuk ke registri kontainer

Masuk ke ACR Anda menggunakan az acr login perintah dan berikan nama unik yang diberikan ke registri kontainer di langkah sebelumnya.

az acr login --name <acrName>

Perintah mengembalikan pesan Masuk Berhasil setelah selesai.

Menandai gambar kontainer

Untuk melihat daftar gambar lokal Anda saat ini, gunakan docker images perintah .

docker images

Contoh output berikut menunjukkan daftar gambar Docker lokal saat ini:

REPOSITORY                                     TAG                 IMAGE ID            CREATED             SIZE
mcr.microsoft.com/azuredocs/azure-vote-front   v1                  84b41c268ad9        7 minutes ago       944MB
mcr.microsoft.com/oss/bitnami/redis            6.0.8               3a54a920bb6c        2 days ago          103MB
tiangolo/uwsgi-nginx-flask                     python3.6           a16ce562e863        6 weeks ago         944MB

Untuk menggunakan gambar kontainer azure-vote-front dengan ACR, Anda perlu menandai gambar dengan alamat server login registri Anda. Tag digunakan untuk perutean saat mendorong gambar kontainer ke registri gambar.

Untuk mendapatkan alamat server login, gunakan az acr list perintah dan kueri untuk loginServer.

az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table

Kemudian, tandai gambar azure-vote-front lokal Anda dengan alamat acrLoginServer dari registri kontainer. Untuk menunjukkan versi gambar, tambahkan :v1 ke akhir nama gambar:

docker tag mcr.microsoft.com/azuredocs/azure-vote-front:v1 <acrLoginServer>/azure-vote-front:v1

Untuk memverifikasi bahwa tag diterapkan, jalankan docker images lagi.

docker images

Contoh output berikut menunjukkan gambar yang ditandai dengan alamat instans ACR dan nomor versi:

REPOSITORY                                      TAG                 IMAGE ID            CREATED             SIZE
mcr.microsoft.com/azuredocs/azure-vote-front    v1                  84b41c268ad9        16 minutes ago      944MB
mycontainerregistry.azurecr.io/azure-vote-front v1                  84b41c268ad9        16 minutes ago      944MB
mcr.microsoft.com/oss/bitnami/redis             6.0.8               3a54a920bb6c        2 days ago          103MB
tiangolo/uwsgi-nginx-flask                      python3.6           a16ce562e863        6 weeks ago         944MB

Mendorong gambar ke registri

Dorong gambar azure-vote-front ke instans ACR Anda menggunakan docker push perintah . Pastikan untuk memberikan alamat acrLoginServer Anda sendiri untuk nama gambar.

docker push <acrLoginServer>/azure-vote-front:v1

Mungkin perlu waktu beberapa menit untuk menyelesaikan pendorongan gambar ke ACR.

Mencamtumkan gambar dalam registri

Untuk mengembalikan daftar gambar yang telah didorong ke instans ACR Anda, gunakan az acr repository list perintah , menyediakan milik Anda sendiri <acrName>.

az acr repository list --name <acrName> --output table

Contoh output berikut mencantumkan gambar azure-vote-front sebagaimana tersedia di registri:

Result
----------------
azure-vote-front

Untuk melihat tag untuk gambar tertentu, gunakan az acr repository show-tags perintah .

az acr repository show-tags --name <acrName> --repository azure-vote-front --output table

Contoh output berikut menunjukkan gambar v1 yang ditandai di langkah sebelumnya:

Result
--------
v1

Langkah berikutnya

Dalam tutorial ini, Anda membuat ACR dan mendorong gambar untuk digunakan dalam kluster AKS. Anda mempelajari cara untuk:

  • Membuat instance ACR
  • Menandai gambar kontainer untuk ACR
  • Mengunggah gambar ke ACR
  • Menampilkan gambar di registri Anda

Dalam tutorial berikutnya, Anda akan mempelajari cara menyebarkan kluster Kubernetes di Azure.