Memeriksa kesehatan registri kontainer Azure

Artikel
10/31/2023

Saat menggunakan registri kontainer Azure, terkadang Anda mungkin mengalami masalah. Misalnya, Anda mungkin tidak dapat menarik citra kontainer karena masalah dengan Docker di lingkungan lokal Anda. Atau, masalah jaringan mungkin mencegah Anda tersambung ke registri.

Sebagai langkah diagnostik pertama, jalankan perintah cek kesehatan az acr untuk mendapatkan informasi selengkapnya tentang kesehatan lingkungan registri dan mengakses registri target secara opsional. Perintah ini tersedia di Azure CLI versi 2.0.67 atau yang lebih baru. Jika Anda perlu menginstal atau memutakhirkan, lihat Menginstal Azure CLI.

Untuk panduan pemecahan masalah registri tambahan, lihat:

Jalankan cek kesehatan az acr

Contoh berikut menunjukkan berbagai cara untuk menjalankan perintah az acr check-health.

Catatan

Jika Anda menjalankan perintah di Azure Cloud Shell, lingkungan lokal tidak diperiksa. Namun, Anda dapat memeriksa akses ke registri target.

Memeriksa lingkungan saja

Untuk memeriksa daemon Docker lokal, versi CLI, dan konfigurasi klien Helm, jalankan perintah tanpa parameter tambahan:

az acr check-health

Memeriksa lingkungan dan registri target

Untuk memeriksa akses ke registri serta melakukan pemeriksaan lingkungan lokal, berikan nama registri target. Contohnya:

az acr check-health --name myregistry

Memeriksa akses registri di jaringan virtual

Untuk memverifikasi pengaturan DNS guna merutekan ke titik akhir privat, berikan nama jaringan virtual atau ID sumber daya. ID sumber daya diperlukan saat jaringan virtual berada dalam langganan atau grup sumber daya yang berbeda dari registri.

az acr check-health --name myregistry --vnet myvnet

Pelaporan kesalahan

Perintah mencatat informasi ke output standar. Jika masalah terdeteksi, perintah tersebut menyediakan kode kesalahan dan deskripsi. Untuk informasi selengkapnya tentang kode dan solusi yang mungkin, lihat referensi kesalahan.

Secara default, perintah berhenti setiap kali menemukan kesalahan. Anda juga dapat menjalankan perintah sehingga menyediakan output untuk semua pemeriksaan kesehatan, bahkan jika kesalahan ditemukan. Tambahkan parameter --ignore-errors, seperti yang ditunjukkan dalam contoh berikut:

# Check environment only
az acr check-health --ignore-errors

# Check environment and target registry; skip confirmation to pull image
az acr check-health --name myregistry --ignore-errors --yes

Contoh output:

az acr check-health --name myregistry --ignore-errors --yes

Docker daemon status: available
Docker version: Docker version 18.09.2, build 6247962
Docker pull of 'mcr.microsoft.com/mcr/hello-world:latest' : OK
ACR CLI version: 2.2.9
Helm version:
Client: &version.Version{SemVer:"v2.14.1", GitCommit:"5270352a09c7e8b6e8c9593002a73535276507c0", GitTreeState:"clean"}
DNS lookup to myregistry.azurecr.io at IP 40.xxx.xxx.162 : OK
Challenge endpoint https://myregistry.azurecr.io/v2/ : OK
Fetch refresh token for registry 'myregistry.azurecr.io' : OK
Fetch access token for registry 'myregistry.azurecr.io' : OK

Periksa apakah registri dikonfigurasi dengan karantina

Setelah Anda mengaktifkan registri kontainer untuk dikarantina, setiap gambar yang Anda terbitkan ke repositori ini akan dikarantina. Setiap upaya untuk mengakses atau menarik gambar yang dikarantina akan gagal dengan kesalahan. Untuk informasi selengkapnya, lihat menarik gambar karantina.

Langkah berikutnya

Untuk detail tentang kode kesalahan yang dikembalikan oleh perintah cek kesehatan az acr, lihat Referensi kesalahan pemeriksaan kesehatan.

Lihat FAQ untuk tanya jawab umum dan masalah lain yang diketahui tentang Azure Container Registry.

Bagikan melalui