Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Azure Container Registry adalah layanan registri privat untuk membangun, menyimpan, dan mengelola gambar kontainer dan artefak terkait. Dalam panduan cepat ini, Anda akan membuat instance Azure Container Registry dengan menggunakan Azure PowerShell di lokal. Kemudian, menggunakan Docker CLI Anda akan mengunduh gambar kontainer hello-world, menandai gambar kontainer hello-world dengan tag untuk membuat gambar kontainer baru, mendorong gambar kontainer baru ke registri kontainer, menghapus gambar kontainer lokal, dan akhirnya mengunduh serta menjalankan kontainer dari registri Anda.
Prasyarat
Catatan
Sebaiknya Anda menggunakan modul Azure Az PowerShell untuk berinteraksi dengan Azure. Untuk memulai, lihat Menginstal Azure PowerShell. Untuk mempelajari cara bermigrasi ke modul Az PowerShell, lihat Memigrasikan Azure PowerShell dari AzureRM ke Az.
Mulai cepat ini memerlukan modul Azure PowerShell. Jalankan Get-Module -ListAvailable Az untuk menentukan versi terinstal Anda. Jika Anda perlu menginstal atau meningkatkan, lihat Menginstal modul Azure PowerShell.
Anda juga harus memiliki Docker yang diinstal secara lokal. Docker menyediakan paket untuk sistemmacOS, Windows, dan Linux.
Karena Azure Cloud Shell tidak menyertakan semua komponen Docker yang diperlukan (dockerd daemon), Anda tidak dapat menggunakan Cloud Shell untuk memulai cepat ini.
Masuk ke Azure
Masuk ke langganan Azure Anda dengan perintah Connect-AzAccount, dan ikuti petunjuk pada layar.
Connect-AzAccount
Buat grup sumber daya
Setelah Anda diautentikasi dengan Azure, buat grup sumber daya dengan New-AzResourceGroup. Grup sumber daya Azure adalah kontainer logis yang Anda sebarkan dan mengelola sumber daya Azure Anda.
New-AzResourceGroup -Name myResourceGroup -Location EastUS
Buat registri kontainer
Selanjutnya, buat registri kontainer di grup sumber daya baru Anda dengan perintah New-AzContainerRegistry.
Nama registri haruslah unik dalam Azure, dan berisi antara 5-50 karakter alfanumerik. Contoh berikut membuat registri bernama "mycontainerregistry." Ganti mycontainerregistry dalam perintah berikut, lalu jalankan untuk membuat registri:
$registry = New-AzContainerRegistry -ResourceGroupName "myResourceGroup" -Name "mycontainerregistry" -EnableAdminUser -Sku Standard -Location EastUS
Petunjuk / Saran
Dalam panduan memulai cepat ini, Anda membuat registri Standar, yang cukup untuk sebagian besar alur kerja Azure Container Registry. Untuk peningkatan penyimpanan dan throughput gambar, serta kemampuan seperti koneksi menggunakan titik akhir privat, opsi paket harga (SKU) Premium ini tersedia. Untuk detail tentang tingkat layanan (SKU), lihat Fitur dan batasan SKU Azure Container Registry.
Masuk ke registri
Sebelum mendorong dan menarik gambar kontainer, Anda harus masuk ke registri dengan cmdlet Connect-AzContainerRegistry. Contoh berikut menggunakan kredensial yang sama dengan yang Anda gunakan saat mengautentikasi ke Azure dengan cmdlet Connect-AzAccount.
Catatan
Dalam contoh berikut, nilai $registry.Name adalah nama sumber daya, bukan nama registri yang sepenuhnya memenuhi syarat.
Connect-AzContainerRegistry -Name $registry.Name
Perintah mengembalikan Login Succeeded setelah selesai.
Mendorong gambar ke registri
Untuk mengunggah citra ke registri Kontainer Azure, Anda harus terlebih dahulu memiliki citra. 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 dapat mendorong gambar ke registri, Anda harus menandainya dengan menggunakan tag docker dengan nama server masuk registri Anda yang sepenuhnya memenuhi syarat.
- Format nama server masuk untuk registri yang dilindungi Domain Name Label (DNL) dengan hash nama DNS unik yang disertakan adalah
mycontainerregistry-abc123.azurecr.io. - Format nama server login untuk registri yang dibuat dengan opsi
UnsecureDNL adalahmycontainerregistry.azurecr.io.
Misalnya, jika Anda membuat registri dengan Tenant Reuse cakupan DNL, server login mungkin terlihat seperti mycontainerregistry-abc123.azurecr.io dengan hash dalam nama DNS. Jika Anda membuat registri dengan Unsecure opsi DNL, server masuk terlihat seperti mycontainerregistry.azurecr.io, tanpa hash.
Tandai gambar dengan menggunakan perintah tag docker dengan server masuk registri Anda. Untuk panduan mulai cepat ini, tandai hello-world gambar dengan v1.
Contoh perintah untuk menandai gambar untuk registri yang dilindungi DNL:
docker tag mcr.microsoft.com/hello-world mycontainerregistry-abc123.azurecr.io/hello-world:v1
Contoh perintah untuk menandai gambar untuk registri non-DNL:
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 hello-world:v1 gambar dari lingkungan Docker lokal Anda dengan menggunakan perintah docker rmi . Perintah ini tidak menghapus gambar dari repositori hello-world di registri kontainer Azure Anda.
docker rmi <login-server>/hello-world: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
Setelah Anda selesai bekerja dengan sumber daya yang Anda buat dalam mulai cepat ini, gunakan perintah Hapus-AzResourceGroup untuk menghapus grup sumber daya, registri kontainer, dan gambar kontainer yang disimpan di sana:
Remove-AzResourceGroup -Name myResourceGroup
Langkah berikutnya
Dalam panduan memulai cepat ini, Anda membuat instans Azure Container Registry menggunakan Azure PowerShell secara lokal, mengambil image kontainer contoh hello-world, menandai image hello-world untuk membuat image kontainer baru, mengunggah image kontainer baru ke dalam registri kontainer, menghapus image kontainer lokal, dan akhirnya mengambil serta menjalankan image dari registri Anda. Lanjutkan ke tutorial Azure Container Registry untuk melihat ACR lebih dalam.