Menyimpan paket Java di Artifact Registry

Meluncurkan Cloud Shell

Cloud Shell telah diinstal lebih dulu dengan Google Cloud CLI dan Java. gcloud CLI menyediakan antarmuka command line utama untuk Google Cloud.

Meluncurkan Cloud Shell:

1. Buka Google Cloud console.

   Google Cloud console

2. Di toolbar konsol Google Cloud , klik Activate Cloud Shell:

Sesi Cloud Shell akan terbuka di dalam frame yang lebih rendah di konsol. Anda menggunakan shell ini untuk menjalankan perintah gcloud.

Membuat repositori paket Java

1. Buat repositori:

Mengonfigurasi Maven

1. Pilih project Maven sederhana yang ingin Anda gunakan.

   Jika tidak memiliki project sederhana, Anda dapat membuat project Maven dalam 5 menit.

   Panduan memulai ini mengasumsikan bahwa project sederhana Anda tidak memiliki dependensi induk atau plugin tambahan yang disimpan di Artifact Registry. Untuk mengetahui detail tentang cara mengonfigurasi project Maven dengan dependensi di Artifact Registry, lihat Mengautentikasi dengan credential helper.

2. Untuk menyederhanakan perintah gcloud, tetapkan repositori default ke quickstart-java-repo dan lokasi default ke us-central1. Setelah nilai ditetapkan, Anda tidak perlu menentukannya dalam perintah gcloud yang memerlukan repositori atau lokasi.

   Untuk menyetel repositori, jalankan perintah:

   gcloud config set artifacts/repository quickstart-java-repo
   

   Untuk menyetel lokasi, jalankan perintah:

   gcloud config set artifacts/location us-central1
   

   Untuk mengetahui informasi selengkapnya tentang perintah ini, lihat dokumentasi gcloud config set.

3. Jalankan perintah berikut untuk mencetak setelan repositori quickstart-java-repo default.

   gcloud artifacts print-settings mvn
   

   Output perintah gcloud terlihat seperti cuplikan berikut, dengan PROJECT adalah project ID Anda.

   <distributionManagement>
     <snapshotRepository>
       <id>artifact-registry</id>
       <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url>
     </snapshotRepository>
     <repository>
       <id>artifact-registry</id>
       <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url>
     </repository>
   </distributionManagement>
   
   <repositories>
     <repository>
       <id>artifact-registry</id>
       <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>true</enabled>
       </snapshots>
     </repository>
   </repositories>
   
   <build>
     <extensions>
       <extension>
         <groupId>com.google.cloud.artifactregistry</groupId>
         <artifactId>artifactregistry-maven-wagon</artifactId>
         <version>2.2.5</version>
       </extension>
     </extensions>
   </build>
   

4. Tambahkan setelan ke file pom.xml untuk project Maven Anda. Garis berikut menunjukkan penempatan relatif setiap elemen utama. Lihat referensi POM Maven untuk mengetahui detail tentang struktur file.

   <project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                         http://maven.apache.org/xsd/maven-4.0.0.xsd">
   
     <!-- Build Settings -->
     <build>
       ...
       <extensions>...</extensions>
     </build>
   
     <!-- Environment Settings -->
     <repositories>...</repositories>
     <distributionManagement>...</distributionManagement>
   </project>
   

Project Maven Anda kini dapat mengupload paket ke repositori Anda.

Mengonfigurasi Gradle

Untuk menyederhanakan perintah gcloud, tetapkan repositori default ke quickstart-java-repo dan lokasi default ke us-central1. Setelah nilai ditetapkan, Anda tidak perlu menentukannya dalam perintah gcloud yang memerlukan repositori atau lokasi.

Untuk menyetel repositori, jalankan perintah:

gcloud config set artifacts/repository quickstart-java-repo

Untuk menyetel lokasi, jalankan perintah:

gcloud config set artifacts/location us-central1

Untuk mengetahui informasi selengkapnya tentang perintah ini, lihat dokumentasi gcloud config set.

1. Tambahkan setelan untuk menghubungkan repositori ke file build.gradle. Perintah berikut mencetak setelan yang akan ditambahkan untuk repositori quickstart-java-repo default.

   gcloud artifacts print-settings gradle
   

   Output perintah gcloud akan terlihat seperti contoh berikut, dengan PROJECT adalah project ID Anda.

   plugins {
     id "maven-publish"
     id "com.google.cloud.artifactregistry.gradle-plugin" version "2.2.5"
         }
   
   publishing {
     repositories {
       maven {
         url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo"
       }
     }
   }
   
   repositories {
     maven {
       url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo"
     }
   }
   

2. Verifikasi bahwa file build.gradle menyertakan bagian publications. Jika tidak ada, tambahkan ke file build.gradle Anda.

   Bagian publications adalah turunan dari publishing seperti yang ditunjukkan dalam contoh berikut:

   publishing {
     publications {
          mavenJava(MavenPublication) {
             groupId  'maven.example.id'
             from components.java
          }
     }
     repositories {
       maven {
         url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo"
       }
     }
   }
   

   Anda juga dapat menambahkan konfigurasi repositori ke file init.gradle atau settings. Untuk mengetahui detail tentang opsi ini, lihat Menyiapkan autentikasi.

   Mengupload paket ke repositori

   Untuk Maven, Anda dapat menggunakan mvn deploy dan mvn release untuk menambahkan paket ke repositori.

   Untuk Gradle, gunakan perintah gradle publish untuk mengupload paket ke repositori.

   Melihat paket di repositori

   Untuk memverifikasi bahwa paket Anda telah ditambahkan ke repositori:

   Konsol

   1. Buka halaman Repositories di konsol Google Cloud .

      Buka halaman Repositori

   2. Di daftar repositori, klik repositori quickstart-java-repo.

      Halaman Paket mencantumkan paket di repositori.

   gcloud

   1. Untuk mencantumkan paket di repositori quickstart-java-repo, jalankan perintah berikut:

      gcloud artifacts packages list --repository=quickstart-java-repo
      

      Outputnya akan seperti ini:

      Listing items under project <project-id>, location us-central1,\
      repository quickstart-java-repo.
      
      PACKAGE: maven.example.id:gradle-demo
      CREATE_TIME: 2022-01-20T22:46:07
      UPDATE_TIME: 2022-01-20T22:46:07
      

      Dengan maven.example.id:gradle-demo adalah ID paket

      Untuk melihat versi paket, jalankan perintah berikut:

      gcloud artifacts versions list --package=PACKAGE
      

      Dengan PACKAGE adalah ID paket.