Tutorial - Membuat Azure Container Registry (ACR) dan membuat gambar

Azure Container Registry (ACR) adalah registri privat untuk gambar kontainer. Registri kontainer privat memungkinkan Anda membangun dan menyebarkan aplikasi dan kode kustom dengan aman.

Dalam tutorial ini, Anda menyebarkan instans ACR dan mendorong gambar kontainer ke dalamnya. Anda akan mempelajari cara untuk:

Buat instans ACR.
Gunakan Tugas ACR untuk membangkitkan dan mendorong citra kontainer ke ACR.
Lihat gambar di registri Anda.

Sebelum Anda mulai

Dalam tutorial previous, Anda mengkloning repositori kode aplikasi dan menggunakan Docker untuk membuat gambar kontainer untuk aplikasi Azure Store Front sederhana. Jika Anda tidak membuat gambar aplikasi Azure Store Front, kembali ke Tutorial 1 - Siapkan aplikasi untuk AKS.

Tutorial ini membuat sumber daya Azure yang dapat ditagih, termasuk grup sumber daya dan Azure Container Registry. Untuk menyelesaikan langkah-langkah ini, Anda memerlukan izin untuk membuat grup sumber daya dan Azure Container Registry sumber daya di langganan Anda, seperti Kontributor atau Pemilik.

Azure CLI
Azure PowerShell

Tutorial ini memerlukan Azure CLI versi 2.0.53 atau yang lebih baru. Untuk menemukan versi, jalankan az --version perintah . Jika Anda perlu menginstal atau meningkatkan, lihat Install Azure CLI.

Membuat Azure Container Registry

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

Azure CLI
Azure PowerShell

Buat variabel untuk nama grup sumber daya, lokasi, dan nama registri. Anda dapat menggunakan nilai-nilai ini atau membuat nilai Anda sendiri. Nilai variabel nama registri yang disimpan dalam ACRNAME harus unik dalam Azure dan berisi 5-50 karakter alfanumerik huruf kecil.
```
export RESOURCE_GROUP=myResourceGroup
export LOCATION=westus2
export RANDOM_STRING=$(printf '%05d%05d' "$RANDOM" "$RANDOM")
export ACRNAME="myregistry${RANDOM_STRING}"
```
Nilai variabel nama registri yang disimpan dalam ACRNAME harus unik dalam Azure dan berisi 5-50 karakter alfanumerik huruf kecil. Nilai ACRNAME digabungkan dengan RANDOM_STRING variabel yang menyimpan string 10 digit acak untuk memastikan nama registri unik. Variabel RESOURCE_GROUP dengan nilai myResourceGroup untuk grup sumber daya dan LOCATION dengan nilai westus2. Anda dapat menggunakan nilai-nilai ini atau membuat nilai Anda sendiri.

Buat grup sumber daya menggunakan az group create perintah .

az group create --name $RESOURCE_GROUP --location $LOCATION

Buat instans ACR dengan menggunakan New-AzContainerRegistry cmdlet dan berikan nama registri unik Anda sendiri. SKU Dasar adalah pilihan awal yang dioptimalkan untuk biaya guna tujuan pengembangan, menyediakan keseimbangan antara penyimpanan dan kecepatan pemrosesan.
```
az group show --name $RESOURCE_GROUP --query name --output tsv
```
Buat instans ACR menggunakan az acr create perintah dan berikan nama registri unik Anda sendiri. SKU Dasar adalah pilihan awal yang dioptimalkan untuk biaya guna tujuan pengembangan, menyediakan keseimbangan antara penyimpanan dan kecepatan pemrosesan.
```
az acr create \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --name $ACRNAME \
  --sku Basic
```
Verifikasi bahwa status provisi registri adalah Succeeded sebelum melanjutkan:
```
az acr show --name $ACRNAME --resource-group $RESOURCE_GROUP --query provisioningState --output tsv
```

Buat variabel untuk nama grup sumber daya, lokasi, dan nama registri. Anda dapat menggunakan nilai-nilai ini atau membuat nilai Anda sendiri. Nilai variabel nama registri yang disimpan dalam ACRNAME harus unik dalam Azure dan berisi 5-50 karakter alfanumerik huruf kecil.
```
$RESOURCE_GROUP="myResourceGroup"
$LOCATION="westus2"
$randobj=New-Object System.Random
$RAND=$randobj.Next()
$ACRNAME="myregistry$RAND"
```
Nilai variabel nama registri yang disimpan dalam ACRNAME harus unik dalam Azure dan berisi 5-50 karakter alfanumerik huruf kecil. Nilai ACRNAME digabungkan dengan RAND variabel yang menyimpan string 10 digit acak untuk memastikan nama registri unik. Variabel RESOURCE_GROUP dengan nilai myResourceGroup untuk grup sumber daya dan LOCATION dengan nilai westus2. Anda dapat menggunakan nilai-nilai ini atau membuat nilai Anda sendiri.

Buat grup sumber daya menggunakan New-AzResourceGroup cmdlet .

New-AzResourceGroup -Name $RESOURCE_GROUP -Location $LOCATION

Verifikasi bahwa grup sumber daya dibuat sebelum melanjutkan:

Get-AzResourceGroup -Name $RESOURCE_GROUP | Select-Object -ExpandProperty ResourceGroupName

Buat instans ACR menggunakan New-AzContainerRegistry cmdlet dan berikan nama registri unik Anda sendiri. SKU Dasar adalah pilihan awal yang dioptimalkan untuk biaya guna tujuan pengembangan, menyediakan keseimbangan antara penyimpanan dan kecepatan pemrosesan.
```
New-AzContainerRegistry -ResourceGroupName $RESOURCE_GROUP -Name $ACRNAME -Location $LOCATION -Sku Basic
```
Verifikasi bahwa status provisi registri adalah Succeeded sebelum melanjutkan:
```
Get-AzContainerRegistry -ResourceGroupName $RESOURCE_GROUP -Name $ACRNAME | Select-Object -ExpandProperty ProvisioningState
```

Membangun dan mengunggah image kontainer ke registri

Buat dan dorong gambar ke ACR Anda menggunakan perintah Azure CLI az acr build. Perintah az acr build menggunakan gambar di repositori yang Anda kloning di artikel sebelumnya menyiapkan aplikasi untuk AKS. Pastikan Anda beralih ke direktori tersebut atau build perintah akan gagal. Misalnya, jika Anda membuat demorepo direktori dan mengkloning repositori, direktori akar repositori adalah aks-store-demo, jadi beralihlah ke direktori demorepo/aks-store-demo .

Sebelum menjalankan perintah build, verifikasi bahwa direktori Anda saat ini berisi folder layanan yang diharapkan:

ls ./src/order-service ./src/store-front

Tidak ada cmdlet Azure PowerShell yang setara yang membangun atau mendorong gambar kontainer ke registri. Anda perlu menggunakan langkah-langkah untuk Azure CLI, tetapi variabel ACRNAME harus diatur ke nilai yang Anda tentukan di PowerShell. Di PowerShell Anda bisa mendapatkan nilai dengan perintah $ACRNAME.

Dalam contoh berikut, kami tidak membangun gambar product-service. Gambar ini dapat memakan waktu lama untuk dibuat, dan ada gambar kontainer yang sudah tersedia di GitHub Container Registry (GHCR). Anda dapat menggunakan az acr import perintah untuk mengimpor gambar dari GHCR ke instans ACR Anda. Kami juga tidak membangun rabbitmq citra. Gambar ini tersedia dari repositori publik Docker Hub dan tidak perlu dibuat atau didorong ke instans ACR Anda.

az acr import \
  --name $ACRNAME \
  --source ghcr.io/azure-samples/aks-store-demo/product-service:latest \
  --image aks-store-demo/product-service:1.0

az acr build \
  --registry $ACRNAME \
  --image aks-store-demo/order-service:1.0 ./src/order-service/

az acr build \
  --registry $ACRNAME \
  --image aks-store-demo/store-front:1.0 ./src/store-front/

Jika Anda mendapatkan kesalahan otorisasi, jalankan az login, konfirmasi langganan aktif dengan az account show, lalu jalankan ulang perintah yang gagal.

Lihat gambar di instans ACR Anda menggunakan az acr repository list perintah .

az acr repository list --name $ACRNAME --output table

Contoh output berikut mencantumkan gambar yang tersedia di registri Anda:

Result
----------------
aks-store-demo/product-service
aks-store-demo/order-service
aks-store-demo/store-front

Lihat gambar dalam instans ACR Anda menggunakan Get-AzContainerRegistryRepository cmdlet .

Get-AzContainerRegistryRepository -RegistryName $ACRNAME

Contoh output berikut mencantumkan gambar yang tersedia di registri Anda:

aks-store-demo/productservice
aks-store-demo/orderservice
aks-store-demo/storefront

Langkah berikutnya

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

Buat instans ACR.
Gunakan Tugas ACR untuk membangkitkan dan mendorong citra kontainer ke ACR.
Lihat gambar di registri Anda.

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

Menyebarkan Kluster Kubernetes

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-07-02