Mengelola paket Conda

Setelah membuat repositori Conda di Artifact Registry, Anda akan siap menginstal paket Conda di repositori baru. Halaman ini menjelaskan cara menginstal, melihat, dan menghapus paket Conda Anda.

Sebelum memulai

  1. Instal dan lakukan inisialisasi Google Cloud CLI.

    Google Cloud CLI versi 354.0.0 atau yang lebih baru diperlukan untuk menjalankan perintah untuk repositori Conda. Anda dapat memeriksa versinya dengan perintah:

    gcloud version

  2. Untuk menggunakan Conda CLI dalam lingkungan Google Cloud Anda, instal salah satu pengelola paket Conda berikut:

  3. Jika Anda tidak memiliki repositori Conda di Artifact Registry, buat repositori paket Conda.

  4. (Opsional) Tetapkan default untuk perintah gcloud.

Artifact Registry mendukung repositori Conda standar dan jarak jauh. Anda dapat menggunakan salah satu alamat berikut untuk repositori jarak jauh Anda.

  • https://repo.anaconda.com/pkgs/main
  • https://repo.anaconda.com/pkgs/r
  • https://repo.anaconda.com/pkgs/msys2
  • https://conda.anaconda.org/conda-forge
  • https://conda.anaconda.org/bioconda

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola paket Conda, minta administrator untuk memberi Anda peran IAM berikut pada repositori:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

Mengelola paket Conda

Setelah menambahkan paket Conda ke repositori Artifact Registry, Anda dapat menginstal paket tersebut ke lingkungan Conda dan melihat detail tentang paket tersebut menggunakan Google Cloud.

Menambahkan paket ke repositori Artifact Registry

Untuk menambahkan paket Conda ke repositori Artifact Registry, jalankan perintah berikut:

gcloud artifacts files upload \
    --source=PACKAGE_NAME \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

Dengan:

  • REPO_NAME adalah ID repositori.
  • PROJECT adalah ID project yang berisi repositori.
  • LOCATION adalah lokasi regional atau multi-regional untuk repositori.

Untuk menambahkan beberapa paket sekaligus:

gcloud artifacts files upload \
    --source-directory=DIRECTORY \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

Dengan:

  • DIRECTORY adalah alamat folder lokal yang berisi paket Conda Anda.

Menginstal paket

Mode repositori: standar, jarak jauh

Untuk menginstal rilis stabil terbaru paket ke lingkungan Conda Anda, jalankan perintah berikut:

Conda

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Miniforge

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Mamba

mamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Micromamba

micromamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Dengan:

  • ENVIRONMENT_NAME adalah nama lingkungan Conda Anda. Jika Anda sudah mengaktifkan lingkungan dan menginstal paket di lingkungan secara langsung, Anda dapat mengabaikan -n ENVIRONMENT_NAME.

  • PACKAGE_NAME adalah nama paket Conda Anda.

    Untuk menginstal versi tertentu dari paket di lingkungan Conda Anda, sertakan VERSION setelah nama paket.

Untuk repositori standar, Anda mendownload paket langsung dari repositori.

Untuk repositori jarak jauh, Anda mendownload salinan paket dan dependensinya yang di-cache. Jika salinan yang di-cache tidak ada, repositori jarak jauh akan mendownload paket dari sumber upstream dan meng-cache-nya sebelum menyajikannya kepada Anda. Anda dapat memverifikasi bahwa repositori jarak jauh mengambil paket dari sumber upstream dengan melihat daftar paket di repositori.

Melihat paket dan versi

Mode repositori: standar, jarak jauh

Untuk melihat paket dan versi paket menggunakan Google Cloud konsol atau gcloud:

Konsol

  1. Buka halaman Repositori di Google Cloud konsol.

    Buka halaman Repositori

  2. Dalam daftar repositori, klik repositori yang sesuai.

    Halaman Paket mencantumkan paket di repositori.

  3. Klik paket untuk melihat versi paket.

gcloud

Untuk mencantumkan paket di repositori, jalankan perintah berikut:

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

Ganti kode berikut:

  • REPOSITORY adalah nama repositori. Jika Anda mengonfigurasi repositori default, Anda dapat menghapus flag ini untuk menggunakan default.
  • LOCATION adalah lokasi regional atau multi-regional lokasi repositori. Jika Anda mengonfigurasi default lokasi, Anda dapat menghapus flag ini untuk menggunakan default.

Untuk melihat versi paket, jalankan perintah berikut:

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Ganti kode berikut:

  • PACKAGE adalah ID paket atau ID yang sepenuhnya memenuhi syarat untuk paket.
  • REPOSITORY adalah nama repositori. Jika Anda mengonfigurasi repositori default, Anda dapat menghapus flag ini untuk menggunakan default.
  • LOCATION adalah lokasi regional atau multi-regional lokasi repositori. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika Anda mengonfigurasi lokasi default, Anda dapat menghapus flag ini untuk menggunakan default.

Untuk repositori jarak jauh, daftar yang ditampilkan hanya menampilkan paket yang di-cache.

Membuat daftar file

Mode repositori: standar, jarak jauh

Untuk repositori jarak jauh, daftar yang ditampilkan hanya menampilkan paket Conda dan file indeks yang di-cache.

Anda dapat mencantumkan file dalam repositori, file di semua versi paket yang ditentukan, atau file dalam versi paket tertentu.

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.

Contoh

Pertimbangkan informasi paket berikut:

  • Project: my-project
  • Repositori: my-repo
  • Lokasi repositori: us-west1
  • Paket: my-app

Perintah berikut mencantumkan semua file di repositori my-repo di lokasi us-west1 dalam project default:

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo
Perintah berikut mencantumkan file dalam versi 1.0 paket.

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=1.0

Menghapus paket dan versi

Mode repositori: standar, jarak jauh

Anda dapat menghapus paket dan semua versinya, atau menghapus versi tertentu. Paket yang dihapus tidak dapat dipulihkan.

Sebelum menghapus paket atau versi paket, pastikan Anda telah mengomunikasikan atau mengatasi semua dependensi penting di dalamnya.

Untuk menghapus paket:

Konsol

  1. Buka halaman Repositori di Google Cloud konsol.

    Buka halaman Repositori

  2. Dalam daftar repositori, klik repositori yang sesuai.

    Halaman Paket mencantumkan paket di repositori.

  3. Pilih paket yang ingin Anda hapus.

  4. Klik DELETE.

  5. Pada kotak dialog konfirmasi, klik HAPUS.

gcloud

Jalankan perintah berikut:

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

Ganti kode berikut:

  • PACKAGE adalah nama paket di repositori.
  • REPOSITORY adalah nama repositori. Jika Anda mengonfigurasi repositori default, Anda dapat menghapus tanda ini untuk menggunakan default.
  • LOCATION adalah lokasi repositori regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika Anda mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan default.

Bendera --async menyebabkan perintah langsung kembali, tanpa menunggu operasi yang sedang berlangsung selesai.

Untuk menghapus versi paket:

Konsol

  1. Buka halaman Repositori di Google Cloud konsol.

    Buka halaman Repositori

  2. Dalam daftar repositori, klik repositori yang sesuai.

    Halaman Paket mencantumkan paket di repositori.

  3. Klik paket untuk melihat versi paket tersebut.

  4. Pilih versi yang ingin Anda hapus.

  5. Klik DELETE.

  6. Pada kotak dialog konfirmasi, klik HAPUS.

gcloud

Jalankan perintah berikut:

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

Ganti kode berikut:

  • VERSION adalah nama versi yang akan dihapus.
  • PACKAGE adalah nama paket di repositori.
  • REPOSITORY adalah nama repositori. Jika Anda mengonfigurasi repositori default, Anda dapat menghapus tanda ini untuk menggunakan default.
  • LOCATION adalah lokasi repositori regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika Anda mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan default.

Flag --async menyebabkan perintah segera ditampilkan, tanpa menunggu operasi yang sedang berlangsung selesai.

Untuk repositori jarak jauh, Artifact Registry menghapus data caching untuk paket yang dipilih, termasuk versi dan file paket.

Langkah berikutnya