Mendownload file

Halaman ini menjelaskan cara mendownload file satu per satu dari repositori standar dan repositori jarak jauh Artifact Registry. Repositori dapat berupa format artefak apa pun.

Mendownload file dapat berguna saat Anda ingin memasukkan file ke lingkungan lokal tanpa alat khusus format. Perlu diperhatikan bahwa Anda tetap harus melakukan autentikasi ke Artifact Registry sebelum mendownload file.

File yang dapat didownload

Anda dapat mendownload setiap data atau file metadata yang ditemukan di repositori. Misalnya, repositori Maven akan menyimpan paket Java sebagai artefak. Semua file dalam paket Java, seperti file jar dan file pom.xml, tersedia satu per satu untuk didownload.

Penggunaan fitur ini tidak direkomendasikan untuk artefak yang sangat bergantung pada alat klien untuk operasi download, seperti image Docker.

Sebelum memulai

• (Opsional) Menetapkan default untuk perintah gcloud CLI.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mendownload file yang disimpan di repositori, minta administrator untuk memberi Anda peran IAM Artifact Registry Reader (roles/artifactregistry.reader) di repositori. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Mencantumkan file

Anda dapat membuat daftar file dalam repositori untuk melihat apa yang tersedia untuk didownload.

Untuk semua perintah berikut, Anda dapat menetapkan jumlah file maksimum yang akan ditampilkan dengan menambahkan flag --limit ke perintah.

Untuk mencantumkan semua file dalam project, repositori, dan lokasi default saat nilai default dikonfigurasi:

gcloud artifacts files list

Untuk menampilkan daftar file dalam project, repositori, dan lokasi yang ditentukan, jalankan perintah:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

Untuk menampilkan daftar file bagi semua versi paket tertentu:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

Untuk menampilkan daftar file untuk versi paket tertentu:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

Ganti nilai berikut:

• LOCATION: lokasi regional atau multi-regional repositori.
• PROJECT: project ID Google Cloud Anda. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.
• REPOSITORY: nama repositori tempat image disimpan.
• PACKAGE: nama paket.
• VERSION: versi paket.

Untuk repositori Docker, Anda dapat membuat daftar file untuk tag image container tertentu dengan menambahkan flag --tag ke perintah.

Untuk mengetahui informasi selengkapnya, lihat daftar file gcloud artefak.

Mendownload file

Untuk mendownload file satu per satu dari repositori, jalankan perintah berikut:

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

• PROJECT: project ID Google Cloud Anda. Jika project ID Anda berisi titik dua (:), lihat Project dengan cakupan domain.
• LOCATION: lokasi regional atau multi-regional dari repositori.
• REPOSITORY: nama repositori tempat artefak disimpan.
• DESTINATION: jalur ke folder tujuan di sistem file lokal Anda. Folder tujuan harus sudah ada atau perintah akan gagal.
• FILE: nama file lengkap. Anda dapat menemukan nilai ini dengan menjalankan perintah gcloud artifacts files list dan menyalin nilai untuk FILE.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud artifacts files download \
    --project=PROJECT \
    --location=LOCATION \
    --repository=REPOSITORY \
    --destination=DESTINATION \
    FILE

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud artifacts files download `
    --project=PROJECT `
    --location=LOCATION `
    --repository=REPOSITORY `
    --destination=DESTINATION `
    FILE

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud artifacts files download ^
    --project=PROJECT ^
    --location=LOCATION ^
    --repository=REPOSITORY ^
    --destination=DESTINATION ^
    FILE

Proses download akan segera dimulai.

API

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT: project ID Google Cloud Anda. Jika project ID Anda berisi titik dua (:), lihat Project dengan cakupan domain.
• LOCATION: lokasi regional atau multi-regional dari repositori.
• REPOSITORY: nama repositori tempat artefak disimpan.
• DESTINATION: jalur ke folder tujuan di sistem file lokal Anda. Folder tujuan harus sudah ada atau perintah akan gagal.
• FILE: nama file yang dienkode ke URL. Anda dapat menemukan nilai ini dengan menjalankan perintah gcloud artifacts files list dan menyalin nilai untuk FILE. Parameter ini harus dikonversi ke format yang dienkode ke URL untuk perintah ini. Misalnya, path/to/file.jar harus dimasukkan sebagai path%2Fto%2Ffile.jar.

Metode HTTP dan URL:

GET https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     --output DESTINATION \
     "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -OutFile DESTINATION `
    -Uri "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

Download akan segera dimulai.

Langkah selanjutnya

• Melihat dan mencantumkan repositori
• Repositori label
• Repositori tag
• Menghapus repositori