Bagikan melalui


Quickstart: Membuat registri kontainer privat menggunakan Azure CLI

Azure Container Registry adalah layanan registri privat untuk membangun, menyimpan, dan mengelola gambar kontainer dan artefak terkait. Dalam mulai cepat ini, Anda membuat instans registri kontainer Azure menggunakan Azure CLI. Kemudian, gunakan perintah Docker untuk mendorong gambar kontainer ke dalam registri, dan akhirnya menarik dan menjalankan gambar dari registri Anda.

Mulai cepat ini mengharuskan Anda menjalankan Azure CLI (versi 2.0.55 atau yang lebih baru direkomendasikan). Jalankan az --version untuk menemukan versinya. Jika Anda perlu memasang atau meningkatkan, lihat Memasang Azure CLI.

Anda juga harus memiliki Docker yang diinstal secara lokal. Docker menyediakan paket yang mengkonfigurasi Docker pada sistem macOS, Windows, atau Linux.

Karena Azure Cloud Shell tidak menyertakan semua komponen Docker yang diperlukan (dockerd daemon), Anda tidak dapat menggunakan Cloud Shell untuk memulai cepat ini.

Buat grup sumber daya

Buat grup sumber daya dengan perintah az group create. Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure disebarkan dan dikelola.

Contoh berikut ini menampilkan cara membuat grup sumber daya bernama myResourceGroup di lokasi eastus.

az group create --name myResourceGroup --location eastus

Membuat registri kontainer

Dalam mulai cepat ini Anda membuat registri Dasar, yang merupakan opsi yang dioptimalkan biaya untuk pengembang yang mempelajari tentang Azure Container Registry. Untuk detail tentang tingkat layanan yang tersedia, lihat Tingkat layanan registri kontainer.

Buat instance ACR menggunakan perintah buat az acr. Nama registri harus unik dalam Azure, dan berisi 5-50 karakter alfanumerik huruf kecil. Dalam contoh berikut, mycontainerregistry digunakan. Perbarui nama ini ke nilai yang unik.

az acr create --resource-group myResourceGroup \
  --name mycontainerregistry --sku Basic

Saat registri dibuat, Anda akan melihat output yang mirip dengan yang berikut ini:

{
  "adminUserEnabled": false,
  "creationDate": "2019-01-08T22:32:13.175925+00:00",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/mycontainerregistry",
  "location": "eastus",
  "loginServer": "mycontainerregistry.azurecr.io",
  "name": "mycontainerregistry",
  "provisioningState": "Succeeded",
  "resourceGroup": "myResourceGroup",
  "sku": {
    "name": "Basic",
    "tier": "Basic"
  },
  "status": null,
  "storageAccount": null,
  "tags": {},
  "type": "Microsoft.ContainerRegistry/registries"
}

Perhatikan dalam loginServer output, yang merupakan nama registri yang sepenuhnya memenuhi syarat (semua huruf kecil). Sepanjang sisa mulai cepat ini adalah <registry-name> tempat penampung untuk nama registri kontainer, dan <login-server> merupakan tempat penampung untuk nama server masuk registri.

Tip

Dalam mulai cepat ini, Anda membuat registri Dasar, yang merupakan opsi yang dioptimalkan biaya untuk pengembang yang mempelajari tentang Azure Container Registry. Pilih tingkat lain untuk meningkatkan throughput penyimpanan dan gambar, dan kemampuan seperti koneksi menggunakan titik akhir privat. Untuk detail tentang tingkat layanan yang tersedia, lihat Tingkat layanan registri kontainer.

Masuk ke registri

Sebelum mendorong dan menarik gambar kontainer, Anda harus masuk ke instans registri. Untuk melakukannya, gunakan perintah az acr login. Tentukan hanya nama sumber daya registri saat masuk dengan Azure CLI. Jangan gunakan nama server masuk yang sepenuhnya memenuhi syarat.

az acr login --name <registry-name>

Contoh:

az acr login --name mycontainerregistry

Perintah mengembalikan pesan Login Succeeded setelah selesai.

Mendorong gambar ke registri

Untuk mendorong gambar ke registri Kontainer Azure, Anda harus terlebih dahulu memiliki gambar. Jika Anda belum memiliki gambar kontainer lokal, jalankan perintah docker pull untuk menarik gambar publik yang ada. Untuk contoh ini, tarik gambar hello-world dari Microsoft Container Registry.

docker pull mcr.microsoft.com/hello-world

Sebelum Anda dapat memasukkan gambar ke registri Anda, Anda harus memberi tag dengan nama server masuk registri Anda yang sepenuhnya memenuhi syarat. Nama server masuk dalam format <registry-name>.azurecr.io (harus huruf kecil semua), misalnya, mycontainerregistry.azurecr.io.

Beri tag pada gambar menggunakan perintah docker tag. Ganti <login-server> dengan nama server masuk instans Azure Container Registry Anda.

docker tag mcr.microsoft.com/hello-world <login-server>/hello-world:v1

Contoh:

docker tag mcr.microsoft.com/hello-world mycontainerregistry.azurecr.io/hello-world:v1

Terakhir, gunakan docker push untuk mendorong gambar ke instans registri. Ganti <login-server> dengan nama server masuk dari instans registri Anda. Contoh ini membuat repositori hello-world, yang berisi gambar hello-world:v1.

docker push <login-server>/hello-world:v1

Setelah mendorong gambar ke registri kontainer Anda, hapus gambar hello-world:v1 dari lingkungan Docker lokal Anda. (Perhatikan bahwa perintah docker rmi ini tidak menghapus gambar dari repositori hello-world di registri penampung Azure Anda.)

docker rmi <login-server>/hello-world:v1

Mencantumkan gambar kontainer

Contoh berikut mencantumkan repositori di registri Anda:

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

Output:

Result
----------------
hello-world

Contoh berikut mencantumkan tag di repositori hello-world.

az acr repository show-tags --name <registry-name> --repository hello-world --output table

Output:

Result
--------
v1

Menjalankan gambar dari registri

Sekarang, Anda dapat menarik dan menjalankan gambar kontainer hello-world:v1 dari registri kontainer Anda dengan menggunakan eksekusi docker:

docker run <login-server>/hello-world:v1  

Contoh output:

Unable to find image 'mycontainerregistry.azurecr.io/hello-world:v1' locally
v1: Pulling from hello-world
Digest: sha256:662dd8e65ef7ccf13f417962c2f77567d3b132f12c95909de6c85ac3c326a345
Status: Downloaded newer image for mycontainerregistry.azurecr.io/hello-world:v1

Hello from Docker!
This message shows that your installation appears to be working correctly.

[...]

Membersihkan sumber daya

Ketika tidak lagi diperlukan, Anda dapat menggunakan perintah az group delete untuk menghapus grup sumber daya, registri kontainer, dan gambar kontainer yang disimpan di sana.

az group delete --name myResourceGroup

Langkah berikutnya

Dalam mulai cepat ini, Anda membuat Azure Container Registry dengan Azure CLI, mendorong gambar kontainer, dan menarik serta menjalankan gambar dari registri. Lanjutkan ke tutorial Azure Container Registry untuk melihat ACR lebih dalam.