Mengelola paket Java

Halaman ini menjelaskan penambahan, tampilan, dan penghapusan paket Java.

Jika Anda ingin menggunakan sbt sebagai alat build untuk Scala dan Java, bukan menggunakan Maven atau Gradle, tersedia plugin sbt buatan komunitas. Dokumentasi ini tidak menjelaskan konfigurasi atau penggunaan klien Scala.

Sebelum memulai

Jika repositori target tidak ada, buat repositori baru.
Pastikan Anda memiliki izin yang diperlukan untuk repositori.
Verifikasi bahwa Anda telah mengonfigurasi autentikasi. Jika Anda menggunakan token akses, pastikan Anda me-refresh token sebelum terhubung ke repositori.
(Opsional) Konfigurasi default untuk perintah gcloud.

Peran yang diperlukan

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

Melihat paket atau file dalam paket: Artifact Registry Reader (roles/artifactregistry.reader)
Download atau instal paket: Artifact Registry Reader (roles/artifactregistry.reader)
Tambahkan paket ke repositori: Artifact Registry Writer (roles/artifactregistry.writer)
Hapus paket: Artifact Registry Repository Administrator (roles/artifactregistry.repoAdmin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

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

Menambahkan paket

Mode repositori: Standar

Untuk menambahkan paket ke repositori:

Maven

Gunakan mvn deploy dan mvn release untuk menambahkan paket ke repositori.

Agar berhasil men-deploy project Maven yang merujuk ke induk, project harus menyertakan penyedia Artifact Registry Wagon dalam file ekstensi inti seperti yang dijelaskan dalam petunjuk autentikasi.

Gunakan mvn deploy:deploy-file untuk mengupload artefak yang dibuat di luar Maven.

Misalnya, perintah contoh ini men-deploy example/external.jar dan file project-nya example/pom.xml ke repositori us-central1-maven.pkg.dev/my-project/my-repo

mvn deploy:deploy-file \
-Durl=artifactregistry://us-central1-maven.pkg.dev/my-project/my-repo \
-DpomFile=example/pom.xml -Dfile=example/external.jar

Untuk mengonfigurasi integrasi dengan Cloud Build, lihat artikel Mengintegrasikan dengan Cloud Build.

Gradle

Agar berhasil memublikasikan ke repositori, file build.gradle Anda harus menyertakan bagian publikasi yang menentukan file yang akan diupload.

Gunakan perintah gradle publish untuk mengupload paket ke repositori.

Melihat paket dan versi

Mode repositori: standar, jarak jauh

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

Konsol

Buka halaman Repositories di Konsol Google Cloud.

Buka halaman Repositori
Dalam daftar repositori, klik repositori yang sesuai.

Halaman Packages mencantumkan paket dalam repositori.
Klik paket untuk melihat versi paket.

gcloud

Untuk mencantumkan paket dalam repositori, jalankan perintah berikut:

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

Dari mana

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

Untuk melihat versi paket, jalankan perintah berikut:

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

Dari mana

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

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

Membuat listingan file

Mode repositori: standar, jarak jauh

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

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

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

Untuk menampilkan daftar file bagi semua versi paket tertentu:

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

Untuk menampilkan daftar 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-central1
Paket: my-app

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

gcloud artifacts files list \
    --location=us-central1 \
    --repository=my-repo

Perintah berikut mencantumkan file dalam versi 1.0 paket.

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

Mendownload paket

Mode repositori: standar, jarak jauh, virtual

Untuk mendownload artefak sebagai bagian dari build, Anda harus mendeklarasikan artefak sebagai dependensi.

Maven

Deklarasikan paket yang ingin Anda download dalam file pom.xml project. Contoh berikut mendeklarasikan versi 1.0 dari artifact paket sebagai dependensi.
```
<dependencies>
    <dependency>
        <groupId>group</groupId>
        <artifactId>artifact</artifactId>
        <version>1.0</version>
    </dependency>
</dependencies>
```
Untuk mempelajari dependensi Maven lebih lanjut, lihat pengantar dependensi dan referensi dependensi Maven.
Bangun project Java.
```
mvn compile
```

Gradle

Deklarasikan paket yang ingin Anda download dalam file build.gradle project. Contoh berikut mendeklarasikan versi 1.0 dari paket artifact sebagai dependensi kompilasi eksternal.

Untuk mempelajari dependensi Gradle lebih lanjut, lihat dokumentasi Gradle.
```
dependencies {
    compile group: 'group', name: 'artifact', version: '1.0'
}
```
Bangun project Java.
```
gradle build
```

Untuk repositori standar, Anda mendownload paket langsung dari repositori.

Untuk repositori jarak jauh, Anda harus 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 men-cache-nya sebelum menayangkannya kepada Anda. Anda dapat memverifikasi bahwa repositori jarak jauh mengambil paket dari sumber upstream dengan melihat daftar paket dalam 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 menyajikan paket yang diminta, tidak 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 menyalurkan paket dari salah satu repositori jika versi tersebut tersedia di keduanya.

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

Menghapus paket dan versi

Mode repositori: standar, jarak jauh

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

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

Sebelum menghapus paket atau versi paket, pastikan Anda telah mengomunikasikan atau mengatasi dependensi penting pada paket atau versi tersebut.

Untuk menghapus paket:

Konsol

Buka halaman Repositories di Konsol Google Cloud.

Buka halaman Repositori
Dalam daftar repositori, klik repositori yang sesuai.

Halaman Packages mencantumkan paket dalam repositori.
Pilih paket yang ingin Anda hapus.
Klik HAPUS.
Di kotak dialog konfirmasi, klik HAPUS.

gcloud

Jalankan perintah berikut:

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

Dari mana

PACKAGE adalah nama paket dalam repositori.
REPOSITORY adalah nama repositori. Jika mengonfigurasi repositori default, Anda dapat menghilangkan tanda ini untuk menggunakan repositori default.
LOCATION adalah lokasi regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan lokasi default.
--async Segera kembali, tanpa menunggu operasi yang sedang berlangsung selesai.

Untuk menghapus versi paket:

Konsol

Buka halaman Repositories di Konsol Google Cloud.

Buka halaman Repositori
Dalam daftar repositori, klik repositori yang sesuai.

Halaman Packages mencantumkan paket dalam repositori.
Klik paket untuk melihat versi paket tersebut.
Pilih versi yang ingin Anda hapus.
Klik HAPUS.
Di kotak dialog konfirmasi, klik HAPUS.

gcloud

Jalankan perintah berikut:

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

Dari mana

PACKAGE adalah nama paket dalam repositori.
REPOSITORY adalah nama repositori. Jika mengonfigurasi repositori default, Anda dapat menghilangkan tanda ini untuk menggunakan repositori default.
LOCATION adalah lokasi regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan lokasi default.
--async segera ditampilkan, tanpa menunggu operasi yang sedang berlangsung selesai.

Mengelola paket Java

Sebelum memulai

Peran yang diperlukan

Menambahkan paket

Maven

Gradle

Melihat paket dan versi

Konsol

gcloud

Membuat listingan file

Contoh

Mendownload paket

Maven

Gradle

Menghapus paket dan versi

Konsol

gcloud

Konsol

gcloud

Langkah selanjutnya