Tutorial: Membuat Azure Container Registry untuk AKS yang diaktifkan oleh Arc

Berlaku untuk: AKS di Azure Stack HCI 22H2, AKS di Windows Server

Azure Container Registry adalah registri privat 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 instans Azure Container Registry dan mendorong gambar kontainer untuk digunakan di AKS. Anda akan mempelajari cara:

  • Buat instans Azure Container Registry
  • Menandai gambar kontainer untuk Azure Container Registry
  • Unggah gambar ke Azure Container Registry
  • Menampilkan gambar di registri Anda

Dalam tutorial selanjutnya, instans Azure Container Registry ini terintegrasi dengan kluster Kubernetes, dan aplikasi disebarkan dari gambar.

Sebelum Anda mulai

Tutorial sebelumnya menjelaskan cara membuat gambar kontainer untuk aplikasi Azure Voting yang 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 versi yang lebih baru. Jalankan az --version untuk menemukan versinya. Jika Anda perlu menginstal atau meningkatkan, lihat Menginstal Azure CLI.

Membuat Azure Container Registry

Untuk membuat instans Azure Container Registry, Anda memerlukan grup sumber daya terlebih dahulu. 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 ke registri kontainer pada langkah sebelumnya:

az acr login --name <acrName>

Perintah mengembalikan pesan Login Berhasil setelah selesai.

Menandai gambar kontainer

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

docker images

Output perintah ini menunjukkan 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 Azure Container Registry, pastikan Anda menandai gambar dengan alamat server masuk 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 gambar docker lagi:

docker images

Gambar ditandai dengan alamat instans Azure Container Registry 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 dibuat dan diberi tag, dorong gambar azure-vote-front ke instans Azure Container Registry Anda. Gunakan docker push dan berikan alamat Anda sendiri acrLoginServer untuk nama gambar sebagai berikut:

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

Mungkin perlu waktu beberapa menit untuk menyelesaikan dorongan gambar ke Azure Container Registry.

Mencamtumkan gambar dalam registri

Untuk mengembalikan daftar gambar yang didorong ke instans Azure Container Registry Anda, gunakan perintah az acr 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 :

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 Azure Container Registry ke kluster Kubernetes di tutorial berikutnya.

Langkah berikutnya

Dalam tutorial ini, Anda membuat Azure Container Registry dan mendorong gambar untuk digunakan dalam kluster Kubernetes. 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.