Tutorial: Menyebarkan dan menggunakan Azure Container Registry

Azure Container Registry (ACR) adalah registri pribadi untuk gambar kontainer. Registri kontainer pribadi memungkinkan Anda menyusun 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:

  • Buat instans Azure Container Registry (ACR)
  • Menandai gambar kontainer untuk ACR
  • Mengunggah gambar ke ACR
  • Menampilkan gambar di registri Anda

Dalam tutorial selanjutnya, instans ACR ini terintegrasi dengan kluster Kubernetes di AKS, dan aplikasi disebarkan dari gambar.

Sebelum Anda mulai

Dalam tutorial sebelumnya, gambar kontainer dibuat untuk aplikasi Azure Voting sederhana. Jika Anda belum membuat gambar aplikasi Azure Voting, kembali ke Tutorial 1 – Buat gambar kontainer.

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

Membuat Azure Container Registry

Saat membuat Azure Container Registry, Anda terlebih dahulu memerlukan grup sumber daya. Grup sumber daya Azure adalah kontainer logis yang disebarkan dan dikelola sumber daya Azure.

Buat grup sumber daya dengan perintah az group create. Dalam contoh ini, grup sumber daya bernama myResourceGroup dibuat di wilayah eastus:

az group create --name myResourceGroup --location eastus

Buat instans Azure Container Registry dengan az acr create dan berikan nama registri 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. Berikan nama registri unik Anda sendiri. 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

Untuk menggunakan instans ACR, Anda harus masuk terlebih dahulu. Gunakan perintah az acr login dan berikan nama unik yang diberikan kepada registri kontainer pada langkah sebelumnya.

az acr login --name <acrName>

Perintah mengembalikan pesan Masuk Berhasil setelah selesai.

Menandai gambar kontainer

Untuk melihat daftar gambar lokal saat ini, gunakan perintah gambar docker:

docker images

Output perintah di atas menampilkan daftar gambar lokal Anda 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, gambar perlu ditandai dengan alamat server login registri Anda. Tag ini digunakan untuk perutean saat mendorong gambar kontainer ke registri gambar.

Untuk mendapatkan alamat server login, gunakan perintah az acr list dan kueri untuk loginServer sebagai berikut:

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

Sekarang, 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 kembali gambar docker.

docker images

Gambar 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

Dengan gambar Anda yang dibuat dan ditandai, dorong gambar azure-vote-front ke instans ACR Anda. Gunakan docker push dan berikan alamat acrLoginServer Anda sendiri untuk nama gambar sebagai berikut:

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 registri instans ACR Anda, gunakan perintah daftar repository list. Sediakan sendiri <acrName> sebagai berikut:

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 perintah az acr repository show-tags sebagai berikut:

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

Sekarang Anda memiliki gambar kontainer yang disimpan dalam instans Azure Container Registry pribadi. Gambar ini disebarkan dari ACR ke klaster Kubernetes pada tutorial selanjutnya.

Langkah berikutnya

Dalam tutorial ini, Anda membuat Azure Container Registry dan mendorong gambar untuk digunakan dalam klaster AKS. Anda mempelajari cara untuk:

  • Buat instans Azure Container Registry (ACR)
  • Menandai gambar kontainer untuk ACR
  • Mengunggah gambar ke ACR
  • Menampilkan gambar di registri Anda

Lanjutkan ke tutorial berikutnya untuk mempelajari cara menyebarkan klaster Kubernetes di Azure.