Mulai dengan Artifact Registry

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.

Gunakan Artifact Registry untuk mengunggah image kontainer dengan Docker dan mengelolanya di Unity Catalog.

Halaman ini menjelaskan cara mengonfigurasi autentikasi, memberikan akses, mengirim image, dan menemukan image tersebut. Untuk konsep dan keterbatasan, lihat Registri Artefak. Jika sebuah perintah atau operasi gagal, lihat Troubleshoot Artifact Registry.

Requirements

Sebelum memulai, Anda harus:

Sebuah workspace di wilayah yang mendukung Registri Artefak. Lihat Batasan.
Databricks CLI (antarmuka baris perintah) versi 1.18.0 atau lebih tinggi terpasang di mesin lokal Anda.
CLI Docker terpasang di mesin lokal Anda.
Katalog dan skema Unity Catalog yang sudah ada dan dapat diakses dari workspace.
Hak akses Unity Catalog untuk operasi Anda.

Atur autentikasi Docker

Databricks CLI menyertakan perintah eksperimental yang mengonfigurasi Docker untuk meminta kredensial untuk registri workspace. Pembantu kredensial Docker memerlukan profil workspace OAuth yang dibuat oleh databricks auth login. Aplikasi ini tidak mendukung profil yang menggunakan token akses pribadi, kredensial mesin ke mesin OAuth (M2M), atau autentikasi hanya akun.

Buat atau perbarui profil untuk ruang kerja target:
```
databricks auth login --profile <profile>
```
Konfigurasikan autentikasi Docker untuk registri workspace:
```
databricks auth docker configure --profile <profile>
```
Hilangkan --profile <profile> untuk menggunakan profil CLI Databricks bawaan Anda.

CLI Databricks menentukan region registri dan menampilkan hostname registri workspace. Gunakan hostname ini saat Anda mengunggah image.

Berikan izin

Registri Artefak tidak membuat katalog atau skema. Keduanya harus sudah ada di Unity Catalog dan dapat diakses dari workspace.

Artifact Registry menggunakan hak istimewa Unity Catalog untuk mengontrol akses gambar. Tabel berikut menunjukkan hibah dengan hak istimewa paling rendah untuk setiap operasi. Hak istimewa manajemen yang lebih luas juga dapat mengizinkan beberapa operasi.

Operasi	Hibah dengan hak istimewa paling kecil
Dorong artefak baru	`USE CATALOG`, `USE SCHEMA`, dan `CREATE VOLUME`
Dorong versi baru atau pindahkan tag	`USE CATALOG`, `USE SCHEMA`, dan `WRITE VOLUME`
Temukan artefak dan versi	`USE CATALOG`, `USE SCHEMA`, dan `READ METADATA`
Gunakan gambar dalam beban kerja yang didukung	`USE CATALOG`, `USE SCHEMA`, dan `READ VOLUME`

Untuk skema yang didedikasikan untuk Registri Artefak, administrator dapat memberikan hak istimewa pada tingkat skema. Hak istimewa tingkat skema berlaku untuk setiap objek yang sesuai dalam skema, termasuk objek yang dibuat kemudian. Gunakan skema terpisah untuk penerbit yang seharusnya tidak dapat memodifikasi artefak satu sama lain. Berikan setiap prinsipal hanya hak istimewa yang diperlukan untuk operasinya. Ganti nilai contoh dan hapus pernyataan hak istimewa yang tidak diperlukan sebelum Anda menjalankan pernyataan berikut:

GRANT USE CATALOG ON CATALOG <catalog> TO `<principal>`;
GRANT USE SCHEMA ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT CREATE VOLUME ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT WRITE VOLUME ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT READ METADATA ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT READ VOLUME ON SCHEMA <catalog>.<schema> TO `<principal>`;

Untuk detail tentang CREATE VOLUME, WRITE VOLUME, READ METADATA, dan READ VOLUME, lihat referensi hak istimewa Unity Catalog. Untuk metode hibah lainnya, lihat Tampilkan, berikan, dan cabut hak istimewa.

Dorong sebuah gambar

Gunakan nama host registri ruang kerja bersama nama catalog.schema.artifact:tag gambar.

Dapatkan nama host registry

Gunakan hostname registri yang ditampilkan oleh databricks auth docker configure. Untuk menemukan nama host profil nanti dan memeriksa apakah pembantu kredensial Docker-nya sudah dikonfigurasi, jalankan:

databricks auth docker host --profile <profile>

Jika Anda perlu menyusun nama host secara manual, gunakan ID workspace numerik dan wilayah workspace. Untuk mengetahui ID workspace, lihat Nama instance workspace, URL, dan ID.

Untuk menemukan wilayah workspace, buka workspace switcher di bilah navigasi atas. Kawasan muncul di bawah nama ruang kerja. Anda juga dapat menemukannya di konsol akun di bawah Ruang Kerja.

Gunakan nama host berikut:

<workspace-id>.container.<region>.azuredatabricks.net

Persyaratan nama artefak

Important

Nama artefak harus berupa nama lengkap Unity Catalog dalam format <catalog>.<schema>.<artifact>. Jangan gunakan garis miring dalam nama. Lihat Hierarki objek Unity Catalog.

Segmen ini <artifact> dapat berisi hingga 255 karakter. Gunakan hanya huruf kecil, angka, garis bawah, dan tanda hubung. Harus dimulai dan diakhiri dengan huruf atau angka. Gunakan tidak lebih dari dua garis bawah berturut-turut, dan jangan letakkan garis bawah di samping tanda hubung.

Tag dan dorong gambar

Warning

Jangan sertakan kredensial atau data sensitif lainnya dalam sebuah gambar. Periksa gambar sebelum Anda menekannya. Versi artefak tidak dapat diubah, dan permintaan penghapusan tidak didukung. Jika Anda mengirimkan data sensitif, segera rotasi atau cabut data tersebut dan minta administrator membatasi izin akses READ VOLUME yang berlaku untuk artefak yang terdampak. Hentikan penggunaan digest yang terdampak dan setiap tag yang merujuk kepadanya, lalu lihat informasi yang perlu disertakan saat Anda meminta bantuan.

Tandai gambar lokal untuk Registri Artefak:

docker tag <local-image>:<local-tag> \
  <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>

Dorong gambar:

docker push <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>

Temukan gambar dan versi

Gunakan API Artefak Perangkat Lunak untuk mencantumkan artefak dalam katalog dan skema, lalu mencantumkan versi artefak.

Note

Perintah CLI Databricks khusus untuk mencantumkan dan mengelola gambar Registri Artefak tidak tersedia. Gunakan databricks api untuk memanggil API Artefak Perangkat Lunak.

Contoh berikut menggunakan profil yang Anda konfigurasikan untuk autentikasi Docker. Hilangkan --profile <profile> jika itu adalah profil default Databricks CLI Anda.

Daftar artefak

Untuk mencantumkan artefak, jalankan perintah berikut:

databricks api get --profile <profile> \
  "/api/2.1/unity-catalog/software-artifacts?parent=schemas/<catalog>.<schema>"

Responnya mencakup nama artefak dan pemiliknya. Jika respons mencakup next_page_token, masukkan nilainya ke parameter page_token query untuk mengambil halaman berikutnya, misalnya, &page_token=<next_page_token>.

Mencantumkan versi

Untuk mencantumkan versi artefak, jalankan perintah berikut:

databricks api get --profile <profile> \
  "/api/2.1/unity-catalog/software-artifacts/<catalog>.<schema>.<artifact>/versions"

Respons mencakup digest image, tag, dan image_acceleration_details.status untuk setiap versi. Untuk batas respons, lihat Keterbatasan.

Periksa status akselerasi gambar

Baca image_acceleration_details.status dari respons versi artefak:

Status	Meaning
`SUCCESS`	Akselerasi gambar berhasil diselesaikan.
`UNSPECIFIED`	Tidak ada hasil akselerasi gambar yang berhasil tercatat. Status ini tidak mengidentifikasi kegagalan.

Gunakan image dalam beban kerja Azure Databricks yang didukung

Setelah Anda mendorong sebuah gambar ke Artifact Registry, referensikan saat Anda membuat beban kerja Azure Databricks yang didukung.

Untuk menggunakan image dalam beban kerja AI Runtime, lihat Gunakan image Docker kustom dengan AI Runtime.

Sumber daya tambahan

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-10-06