Mengelola gem Ruby

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan cara menambahkan, melihat, dan menghapus gem Ruby dan versi gem.

Sebelum memulai

1. Instal dan lakukan inisialisasi the Google Cloud CLI.

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

   gcloud version
   

2. Jika repositori target tidak ada, maka buat repositori paket Ruby.

3. Pastikan Ruby telah diinstal. Untuk mengetahui petunjuk penginstalan, lihat Google Cloud tutorial untuk menyiapkan Ruby.

4. (Opsional) Tetapkan default untuk perintah gcloud.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola gem, minta administrator untuk memberi Anda peran IAM berikut di repositori:

• Melihat gem atau file dalam gem: Pembaca Artifact Registry (roles/artifactregistry.reader)
• Mendownload atau menginstal gem: Pembaca Artifact Registry (roles/artifactregistry.reader)
• Menambahkan gem ke repositori: Penulis Artifact Registry (roles/artifactregistry.writer)
• Menghapus gem: Administrator Repositori Artifact Registry (roles/artifactregistry.repoAdmin)

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.

Menambahkan gem

Paket di Ruby disebut gem, dengan setiap gem berisi nama, versi dan platform. Project Ruby juga harus berisi gemfile, yang merupakan file konfigurasi yang menentukan dependensi gem yang diperlukan.

Mode repositori: standar

Saat Anda membuat project Ruby, file distribusi akan disimpan di subdirektori lib di project Anda. Kemudian, Anda dapat menggunakan RubyGems untuk mengupload gem ke repositori standar.

Untuk menambahkan gem ke repositori Artifact Registry Anda:

gem push GEM_NAME --host https://LOCATION-ruby.pkg.dev/PROJECT/REPOSITORY

Dengan:

• GEM_NAME adalah nama gem yang akan di-push ke repositori Anda.
• LOCATION adalah lokasi repositori Anda.
• PROJECT adalah project ID. Jika flag ini dihilangkan, maka project saat ini atau default akan digunakan.
• REPOSITORY adalah nama repositori Anda di Artifact Registry.

Melihat gem dan versi

Mode repositori: standar

Untuk melihat paket dan versi paket menggunakan konsol Google Cloud 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 dalam 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 tanda ini untuk menggunakan default.
• LOCATION adalah lokasi repositori regional atau multi-regional. Jika Anda mengonfigurasi lokasi default, Anda dapat menghilangkan tanda 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 repositori regional atau multi-regional. Gunakan tanda ini untuk melihat repositori di lokasi tertentu. Jika Anda mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan default.

Untuk repositori jarak jauh, daftar yang ditampilkan harus menyertakan semua dependensi langsung dan transitif.

Mencantumkan file

Mode repositori: standar

Anda dapat mencantumkan file di repositori, file di semua versi paket tertentu, atau file di versi tertentu dari paket.

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

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

gcloud artifacts files list

Untuk mencantumkan file di project, repositori, dan lokasi tertentu, 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: your Google Cloud project ID. Jika project ID Anda berisi titik dua (:), lihat Project dengan cakupan domain.
• REPOSITORY: nama repositori tempat penyimpanan image.
• 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 paket versi 1.0.

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

Menginstal gem

Mode repositori: standar

Untuk menginstal rilis stabil terbaru dari sebuah paket:

gem install GEM_NAME

Untuk repositori standar, Anda mendownload paket langsung dari repositori.

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

Untuk repositori virtual, Artifact Registry menelusuri repositori upstream untuk paket yang diminta.

• Repositori jarak jauh upstream akan mendownload dan meng-cache paket yang diminta jika salinan yang di-cache tidak ada. Repositori virtual hanya menayangkan paket yang diminta, bukan menyimpannya.
• Jika Anda meminta versi yang tersedia di lebih dari satu repositori upstream, Artifact Registry akan memilih repositori upstream yang akan digunakan berdasarkan setelan prioritas yang dikonfigurasi untuk repositori virtual.

Misalnya, pertimbangkan repositori virtual dengan setelan prioritas berikut untuk repositori upstream:

• main-repo: Prioritas ditetapkan ke 100
• secondary-repo1: Prioritas ditetapkan ke 80.
• secondary-repo2: Prioritas ditetapkan ke 80.
• test-repo: Prioritas ditetapkan ke 20.

main-repo memiliki nilai prioritas tertinggi, sehingga repositori virtual selalu menelusurinya terlebih dahulu.

secondary-repo1 dan secondary-repo2 memiliki prioritas yang ditetapkan ke 80. Jika paket yang diminta tidak tersedia di main-repo, Artifact Registry akan menelusuri repositori ini berikutnya. Karena keduanya memiliki nilai prioritas yang sama, Artifact Registry dapat memilih untuk menayangkan paket dari salah satu repositori jika versi tersebut tersedia di keduanya.

test-repo memiliki nilai prioritas terendah dan akan menayangkan artefak yang disimpan jika tidak ada repositori upstream lain yang memilikinya.

Informasi tambahan

Saat Anda melakukan push gem ke atau menarik gem dari repositori Artifact Registry, jika gem yang diminta atau dependensinya tidak ditemukan di repositori yang Anda tentukan, klien gem Anda akan menggunakan sumber lain yang ditentukan dalam gemfile untuk gem Anda. Jika Anda hanya ingin mengambil dan menginstal langsung dari Artifact Registry, jalankan perintah berikut untuk menghapus sumber non-Artifact Registry dari gemfile Anda:

gem sources --remove SOURCE

Untuk menambahkan rubygems.org kembali sebagai sumber:

gem sources --add SOURCE

Dengan SOURCE adalah alamat sumber, seperti https://rubygems.org.

Menghapus paket dan versi

Mode repositori: standar

Anda dapat menghapus paket dan semua versinya, atau menghapus versi tertentu.

• Setelah menghapus paket, Anda tidak dapat mengurungkan tindakan tersebut.
• Untuk repositori jarak jauh, hanya salinan paket yang di-cache yang dihapus. Sumber upstream tidak terpengaruh. Jika Anda menghapus paket yang di-cache, Artifact Registry akan mendownload dan meng-cache-nya lagi pada saat repositori menerima permintaan untuk versi paket yang sama.

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. Di 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 tanda 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 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. Di 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 tanda 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.

Batasan

• Artifact Registry tidak mendukung penambahan repositori sebagai sumber menggunakan perintah gem sources -add. Namun, Anda dapat menambahkan sumber secara manual ke file .gemrc, atau meneruskan flag --source langsung di gem perintah.

• Artifact Registry tidak mendukung penarikan gem menggunakan gem fetch.

Langkah berikutnya

• Pelajari cara mengelola image container
• Mendownload file individual dalam paket