Mengelola modul Go

Halaman ini menjelaskan cara mengelola modul Go yang dikemas dan disimpan di Artifact Registry.

Sebelum memulai

1. Jika repositori target tidak ada, buat repositori baru. Pilih Go sebagai format repositori.
2. Pastikan Anda memiliki izin yang diperlukan untuk repositori.
3. (Opsional) Konfigurasi default untuk perintah gcloud.
4. Instal Go 1.15 atau yang lebih baru.

5. Instal add-on gcloud CLI package-go-module:

   gcloud components install package-go-module

6. Konfigurasi Go untuk melakukan autentikasi dengan Artifact Registry.

Peran yang Diperlukan

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

• Melihat modul: Pembaca Artifact Registry (roles/artifactregistry.reader)
• Mendownload atau menginstal modul: Pembaca Artifact Registry (roles/artifactregistry.reader)
• Menambahkan modul ke repositori: Penulis Artifact Registry (roles/artifactregistry.writer)
• Menghapus modul: 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.

Mengupload modul

Mode repositori: standar

Untuk mengemas dan mengupload modul ke repositori, jalankan perintah berikut:

  gcloud artifacts go upload --project=PROJECT \
      --repository=REPOSITORY \
      --location=LOCATION \
      --module-path=MODULE_PATH \
      --version=VERSION \
      --source=SOURCE_LOCATION

Ganti kode berikut:

• PROJECT dengan Google Cloud project ID Anda.
• REPOSITORY dengan nama repositori tempat paket disimpan.
• LOCATION dengan lokasi regional atau multi-regional repositori.
• MODULE_PATH dengan jalur modul. Misalnya: example.com/foo Lihat Referensi Modul Go untuk mengetahui informasi selengkapnya.
• VERSION dengan versi semantik modul dalam bentuk vX.Y.Z dengan X adalah versi utama, Y adalah versi minor, dan Z adalah versi patch.
• SOURCE_LOCATION dengan jalur ke direktori root modul Go Anda. Jika Anda menghapus flag --source, defaultnya adalah direktori saat ini.

Modul diupload ke Artifact Registry.

Untuk mengetahui informasi selengkapnya tentang cara membuat modul Go, lihat tutorial ini.

Mengupload versi modul baru

Mode repositori: standar

Untuk mengupload versi baru modul Anda ke project, repositori, dan lokasi default saat nilai default dikonfigurasi, jalankan perintah berikut dengan nomor versi baru:

  gcloud artifacts go upload \
      --module-path=MODULE_PATH \
      --version=VERSION \
      --source=SOURCE_LOCATION

Ganti VERSION dengan versi modul yang diperbarui. Misalnya, untuk mengupload modul versi 0.1.1 dengan jalur example.com/foo, jalankan perintah berikut:

  gcloud artifacts go upload \
      --module-path=example.com/foo \
      --version=v0.1.1 \
      --source=SOURCE_LOCATION

Untuk menandai modul sebagai versi pra-rilis, tambahkan tanda hubung setelah VERSION dan tambahkan ID pra-rilis modul Anda:

  gcloud artifacts go upload \
      --module-path=MODULE_PATH \
      --version=VERSION-PRE_RELEASE_IDENTIFIERS \
      --source=SOURCE_LOCATION

Ganti PRE_RELEASE_IDENTIFIERS dengan tanda hubung dan karakter alfanumerik ASCII yang dipisahkan titik. Misalnya, untuk mengupload pra-rilis modul dengan jalur modul example.com/foo yang diidentifikasi oleh alpha.x.12m.5, jalankan perintah berikut:

  gcloud artifacts go upload \
      --module-path=example.com/foo \
      --version=v1.0.0-alpha.x.12m.5 \
      --source=SOURCE_LOCATION

Catatan: ID pra-rilis harus berupa tanda hubung dan karakter alfanumerik ASCII yang dipisahkan titik. Metadata tidak didukung. Untuk mengetahui informasi selengkapnya tentang pembuatan versi, lihat Pembuatan versi semantik 2.0.0 dan postingan blog ini untuk detail khusus Go.

Mengupload versi utama baru

Mode repositori: standar

Versi utama tidak kompatibel dengan versi sebelumnya. Untuk mencegah pengguna mengimpor perubahan yang melanggar, versi utama setelah v1 harus memiliki jalur modul yang berbeda dari versi sebelumnya. Mulai dari v2, versi utama ditambahkan ke akhir jalur modul.

Misalnya, jalur modul untuk v2.0.0 dari example.com/foo adalah example.com/foo/v2.

Praktik terbaik yang direkomendasikan adalah mengembangkan versi utama setelah v1 di direktori terpisah yang diberi nama sesuai dengan akhiran versi utamanya.

Untuk mengupload versi utama baru 2.0.0 dari modul dengan jalur example.com/foo ke project, repositori, dan lokasi default saat nilai default dikonfigurasi:

  gcloud artifacts go upload --module-path=example.com/foo/v2 --version=v2.0.0

Membuat daftar modul

Mode repositori: standar, jarak jauh, virtual

Jalankan perintah berikut untuk memeriksa modul Go yang diupload di default project, repositori, dan lokasi saat nilai default dikonfigurasi:

  gcloud artifacts packages list

Output akan terlihat seperti berikut:

  Listing items under project my-project, location us-west1, repository my-repo.

  PACKAGE                   CREATE_TIME          UPDATE_TIME
  example.com/foo           2022-06-03T20:43:39  2022-06-20T20:37:40

Melihat detail versi modul

Mode repositori: standar, jarak jauh, virtual

Jalankan perintah berikut untuk melihat versi modul di default project, repositori, dan lokasi saat nilai default dikonfigurasi:

  gcloud artifacts versions list --package=MODULE_PATH

Output akan terlihat seperti berikut:

  Listing items under project my-project, location us-west1, repository my-repo, package example.com/foo.

  VERSION  DESCRIPTION  CREATE_TIME          UPDATE_TIME
  v0.1.0                2022-06-03T20:43:39  2022-06-03T20:43:39
  v0.1.1                2022-06-20T20:37:40  2022-06-20T20:37:40

Menggunakan modul sebagai dependensi

Mode repositori: standar, jarak jauh, virtual

Untuk mengimpor modul yang disimpan di Artifact Registry, Anda harus menginstruksikan Go untuk mencari dependensi dari Artifact Registry dan melewati database checksum. Ikuti petunjuk untuk menyiapkan autentikasi dan lingkungan Go di Menyiapkan autentikasi untuk Go.

1. Jika Anda menggunakan kredensial berumur pendek untuk melakukan autentikasi ke Artifact Registry, Anda harus memperbarui token OAuth dengan menjalankan perintah berikut:

     GOPROXY=proxy.golang.org \
     go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@latest refresh
   

2. Jika modul Anda belum memiliki file go.mod, ubah direktori ke folder modul Anda dan jalankan go mod init untuk membuat file go.mod untuk paket Anda.

     go mod init MODULE_PATH
   

   Ganti MODULE_PATH dengan jalur modul untuk modul yang disimpan di Artifact Registry. Lihat Referensi Modul Go untuk mengetahui informasi selengkapnya.

3. Untuk mewajibkan versi modul Anda yang disimpan di Artifact Registry, edit file go.mod agar terlihat seperti berikut:

   
   module example.com/bar
   
   go 1.19
   
   require example.com/foo v0.1.0
   

   Ganti kode berikut:

   • example.com/foo adalah jalur modul dari modul yang diperlukan
   • v0.1.0 adalah versi yang disimpan di Artifact Registry

4. Sertakan jalur modul seperti biasa di bagian import file main.go Anda.

   Misalnya, untuk mengimpor modul dengan jalur example.com/foo yang disimpan di Artifact Registry, bagian impor Anda mungkin terlihat seperti berikut:

     
     package main
   
     import (
       foo "example.com/foo"
     )
   
     func main() {
   
       ...
   
     }
   
     
   

5. Jalankan go mod tidy untuk mendownload dependensi:

     go mod tidy
   

6. Jalankan modul Anda seperti biasa:

     go run .
   

   Modul yang disimpan di Artifact Registry akan didownload dan digunakan sebagai dependensi.

Menghapus modul Go yang dikemas

Mode repositori: standar, jarak jauh

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

• Setelah menghapus paket, Anda tidak dapat mengurungkan tindakan tersebut.

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.

Langkah berikutnya

• Coba Panduan Memulai Go.
• Unduh file individual yang terkait dengan modul atau versi tanpa menggunakan perintah Go.