Mendownload file

Halaman ini menjelaskan cara mendownload setiap file 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. Perhatikan bahwa Anda masih harus melakukan autentikasi ke Artifact Registry sebelum mendownload file.

File yang dapat didownload

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

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

Sebelum memulai

Peran yang diperlukan

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

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

Mencantumkan file

Anda dapat mencantumkan file di repositori untuk melihat file yang tersedia untuk didownload.

console

  1. Buka halaman Repositories di konsol Google Cloud.

    Buka halaman Repositori

  2. Di daftar repositori, pilih repositori.

  3. Klik nama paket.

  4. Untuk melihat file yang dapat didownload untuk semua versi paket, klik tab File.

  5. Untuk melihat file yang dapat didownload untuk versi paket tertentu, klik nama versi, lalu klik tab File.

gcloud

Untuk semua perintah berikut, Anda dapat menetapkan jumlah maksimum file 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 mencantumkan file dalam project, repositori, dan lokasi yang ditentukan, jalankan perintah:

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

Untuk mencantumkan file untuk semua versi paket tertentu:

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

Untuk mencantumkan 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 mencantumkan file untuk tag image container tertentu dengan menambahkan flag --tag ke perintah.

Untuk mengetahui informasi selengkapnya, lihat daftar file artefak gcloud.

Mendownload file

Untuk mendownload setiap file 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 cakupan domain.
  • LOCATION: lokasi regional atau multi-regional 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

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud artifacts files download ^
    --project=PROJECT ^
    --location=LOCATION ^
    --repository=REPOSITORY ^
    --destination=DESTINATION ^
    FILE
 Anda akan langsung melihat download 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 cakupan domain.
  • LOCATION: lokasi regional atau multi-regional 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 URL. Anda dapat menemukan nilai ini dengan menjalankan perintah gcloud artifacts files list dan menyalin nilai untuk FILE. URL harus dikonversi ke format yang dienkode 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:

Anda akan segera melihat download dimulai.

Langkah selanjutnya