Registri Artefak

Important

Fitur ini ada di Beta. Untuk menggunakannya, admin ruang kerja harus mengaktifkan Databricks Artifact Registry dari halaman Pratinjau. Lihat Kelola Pratinjau Azure Databricks. Databricks akan mengumumkan harga untuk Artifact Registry ketika sudah tersedia secara umum.

Artifact Registry menyimpan gambar kontainer sebagai aset yang diatur di Unity Catalog. Gambar-gambar disimpan di wilayah yang sama dengan metastore Unity Catalog. Gunakan layanan ini untuk mengirim image dengan perintah Docker standar, mengontrol akses dengan hak istimewa Unity Catalog, dan membuat image tersedia untuk workload Azure Databricks yang didukung.

Konsep Utama

  • Artefak: Gambar kontainer bernama yang disimpan di Unity Catalog, diidentifikasi dengan nama tiga tingkat dalam format catalog.schema.artifact.
  • Tag: Alias yang dapat diubah dan menunjuk ke versi artefak menggunakan format catalog.schema.artifact:tag. Melakukan push pada tag lagi dapat mengubah versi yang dirujuk oleh tag tersebut. Untuk deployment yang dapat diulang, hindari tag yang dapat berubah seperti latest, dan gunakan digest sebagai referensi saat workload mendukung referensi digest.
  • Ringkasan gambar: Pengenal yang tidak dapat diubah dan dialamatkan konten untuk versi tertentu dari sebuah artefak.
  • Akselerasi gambar: Optimasi yang diterapkan secara otomatis oleh Azure Databricks setelah Anda mendorong gambar yang memenuhi syarat ke Artifact Registry. Proses ini mengubah gambar ke format yang dirancang untuk mengurangi latensi pull pada beban kerja yang didukung. Untuk memeriksa status akselerasi gambar versi artefak, lihat Periksa status akselerasi gambar.

Cara kerja Registri Artefak

Penerbit dan pengguna bekerja dengan gambar kontainer di Artifact Registry melalui siklus hidup berikut:

  1. Bangun dan dorong: Penerbit membuat image, menandainya dengan nama Unity Catalog tiga tingkat dalam format catalog.schema.artifact:tag, dan mendorongnya ke registri workspace. Lihat persyaratan nama artefak dan Push sebuah gambar.
  2. Kelola: Registri Artefak menyimpan citra dalam katalog dan skema Unity Catalog yang ditentukan. Unity Catalog memiliki hak istimewa untuk mengontrol siapa yang dapat mempublikasikan, menemukan, dan membaca gambar tersebut. Lihat Memberikan izin.
  3. Temukan: Pengguna memanggil API Artefak Perangkat Lunak untuk menemukan gambar dan versi yang tersedia serta memeriksa status akselerasi gambar. Lihat Temukan gambar dan versi.
  4. Penggunaan: Pengguna merujuk pada sebuah citra saat mereka membuat beban kerja Azure Databricks yang didukung, seperti pekerjaan yang menjalankan citra kontainer kustom. Lihat Penggunaan image pada workload Azure Databricks yang didukung.

Diagram yang menunjukkan penerbit mendorong image ke Artifact Registry, tempat Unity Catalog mengelolanya sebelum image tersebut ditemukan dan digunakan oleh pengguna.

Batasan

Batasan berikut berlaku:

Availability

  • Workspace Anda dan metastore Unity Catalog-nya harus berada di wilayah yang sama. Jika wilayahnya berbeda, Anda tidak dapat menggunakan Artifact Registry dari workspace tersebut.

  • Registri Artefak tersedia di wilayah berikut:

    • australiaeast
    • brazilsouth
    • canadacentral
    • centralindia
    • centralus
    • eastasia
    • eastus
    • eastus2
    • francecentral
    • germanywestcentral
    • japaneast
    • koreacentral
    • northcentralus
    • northeurope
    • southcentralus
    • southeastasia
    • swedencentral
    • switzerlandnorth
    • uaenorth
    • uksouth
    • ukwest
    • westcentralus
    • westeurope
    • westus
    • westus2
    • westus3

Penggunaan yang didukung

Authentication

  • Token akses workspace OAuth yang digunakan untuk autentikasi Docker kedaluwarsa setelah satu jam. Push yang memakan waktu lebih lama dapat gagal otorisasi untuk layer yang diunggah setelah kedaluwarsa. Coba ulang push agar pembantu kredensial Docker meminta token baru.

Percepatan gambar

  • Gambar lebih besar dari 30 GB tidak dapat dikonversi untuk akselerasi gambar.
  • Akselerasi gambar tidak menampilkan status konversi yang gagal. Lihat Periksa status percepatan gambar.

Penemuan dan pengelolaan

  • Catalog Explorer tidak menyediakan antarmuka untuk gambar.
  • Endpoint registri tidak mendukung permintaan daftar tag Open Container Initiative (OCI) maupun permintaan hapus.
  • API Software Artifacts mengembalikan paling banyak 10 tag untuk suatu versi jika lebih dari 10 tag mengarah ke digest yang sama.

Nama artefak

Sumber daya tambahan