Mulai cepat: Buat registri kontainer Azure menggunakan Azure PowerShell
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 PowerShell. Kemudian, gunakan perintah Docker untuk mendorong gambar kontainer ke dalam registri, dan akhirnya menarik dan menjalankan gambar dari registri Anda.
Prasyarat
Catatan
Kami menyarankan agar Anda menggunakan modul Azure Az PowerShell untuk berinteraksi dengan Azure. Lihat Menginstal Azure PowerShell untuk memulai. 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 memasang atau meningkatkan, lihat Modul pemasangan Azure PowerShell.
Anda juga harus memiliki Docker yang dipasang secara lokal. Docker menyediakan paket untuk sistemmacOS, Windows, dan Linux.
Karena Azure Cloud Shell tidak menyertakan semua komponen Docker yang diperlukan (dockerddaemon), 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 harus unik dalam Azure dan berisi 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 Basic
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 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 akan kembali 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 <nama-registry>.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
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.
[...]
Bersihkan 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 mulai cepat ini, Anda membuat Azure Container Registry dengan Azure PowerShell, mendorong gambar container, dan menarik serta menjalankan gambar dari registri. Lanjutkan ke tutorial Azure Container Registry untuk melihat Azure Container Registry lebih dalam.