Bagikan melalui

Panduan pemecahan masalah untuk cache Artefak

  • Artikel

Dalam tutorial ini, Anda memecahkan masalah paling umum untuk registri yang diaktifkan dengan fitur cache Artefak dengan mengidentifikasi Gejala, penyebab, dan solusi potensial untuk menggunakan fitur secara efektif.

Gejala dan Penyebab

Dapat mencakup satu atau beberapa masalah berikut:

Solusi Potensial

Gambar yang di-cache tidak muncul di repositori langsung

Jika Anda mengalami masalah dengan gambar cache yang tidak muncul di repositori Anda di Azure Container Registry (ACR), sebaiknya verifikasi jalur repositori. Jalur repositori yang salah menyebabkan gambar yang di-cache tidak muncul di repositori Anda di ACR.

  • Server Login untuk Docker Hub adalah docker.io.
  • Server Login untuk Registri Artefak Microsoft adalah mcr.microsoft.com.

portal Azure mengisi otomatis bidang ini untuk Anda. Namun, banyak repositori Docker dimulai dengan library/ di jalur mereka. Misalnya, untuk menyimpan repositori hello-world , Jalur Repositori yang benar adalah docker.io/library/hello-world.

Kredensial Tidak Sehat

Kredensial adalah sekumpulan rahasia Key Vault yang beroperasi sebagai Nama Pengguna dan Kata Sandi untuk repositori privat. Kredensial yang tidak sehat sering kali merupakan akibat dari rahasia ini tidak lagi valid. Di portal Azure, Anda bisa memilih kredensial, untuk mengedit dan menerapkan perubahan.

  • Verifikasi rahasia di Azure Key Vault kedaluwarsa.
  • Verifikasi rahasia di Azure Key Vault valid.
  • Verifikasi akses ke Azure Key Vault ditetapkan.

Untuk menetapkan akses ke Azure Key Vault:

az keyvault set-policy --name myKeyVaultName --object-id myObjID --secret-permissions get

Pelajari lebih lanjut tentang Key Vault. Pelajari selengkapnya tentang Menetapkan akses ke Azure Key Vault.

Tidak dapat membuat aturan Cache

Batas aturan cache

Jika Anda menghadapi masalah saat membuat aturan Cache, sebaiknya verifikasi apakah Anda memiliki lebih dari 1.000 aturan cache yang dibuat.

Sebaiknya hapus aturan cache yang tidak diinginkan untuk menghindari mencapai batas.

Pelajari selengkapnya tentang Terminologi Cache.

Tidak dapat membuat aturan cache menggunakan kartubebas

Jika Anda mencoba membuat aturan cache, tetapi ada konflik dengan aturan yang sudah ada. Pesan kesalahan menunjukkan bahwa sudah ada aturan cache dengan kartubebas untuk repositori target yang ditentukan.

Untuk mengatasi masalah ini, Anda perlu mengikuti langkah-langkah berikut:

  1. Identifikasi aturan cache yang ada yang menyebabkan konflik. Cari aturan yang sudah ada yang menggunakan kartubebas (*) untuk repositori target.

  2. Hapus aturan cache yang bertentangan yang tumpang tindih dengan repositori sumber dan kartubebas.

  3. Buat aturan cache baru dengan wildcard dan repositori target yang diinginkan.

  4. Periksa kembali konfigurasi cache Anda untuk memastikan bahwa aturan baru diterapkan dengan benar dan tidak ada aturan lain yang bertentangan.

Dukungan upstram

Cache artefak saat ini mendukung registri upstram berikut:

Peringatan

Kami menyarankan pelanggan untuk membuat set kredensial saat mendapatkan konten dari hub Docker.

Registri Upstream Dukungan Ketersediaan
Docker Hub Mendukung penarikan yang diautentikasi dan tidak diautentikasi. Azure CLI
Docker Hub Mendukung penarikan terautentikasi saja. Portal Azure
Registri Artefak Microsoft Hanya mendukung penarikan yang tidak diatomatiskan. Azure CLI, portal Azure
Galeri Publik AWS Elastic Container Registry (ECR) Hanya mendukung penarikan yang tidak diatomatiskan. Azure CLI, portal Azure
GitHub Container Registry Mendukung penarikan yang diautentikasi dan tidak diautentikasi. Azure CLI, portal Azure
Dermaga Mendukung penarikan yang diautentikasi dan tidak diautentikasi. Azure CLI, portal Azure
registry.k8s.io Mendukung penarikan yang diautentikasi dan tidak diautentikasi. Azure CLI
Google Container Registry Mendukung penarikan yang diautentikasi dan tidak diautentikasi. Azure CLI