Menyimpan format lain di Artifact Registry

Pelajari cara menyiapkan repositori format generik Artifact Registry dan mengupload file YAML.

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna membuat dan mengelola repositori paket Artifact Registry, minta administrator untuk memberi Anda peran IAM Artifact Registry Administrator (roles/artifactregistry.admin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

Meluncurkan Cloud Shell

Di konsol Google Cloud , aktifkan Cloud Shell.

Aktifkan Cloud Shell

Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

Dalam panduan memulai ini, Anda akan menggunakan Cloud Shell untuk menjalankan perintah gcloud.

Membuat repositori generik

Untuk membuat repositori format generik bernama quickstart-generic-repo di lokasi us-central1 dengan deskripsi Generic repository, jalankan perintah berikut:

gcloud artifacts repositories create quickstart-generic-repo \
    --repository-format=generic \
    --location=us-central1 \
    --description="Generic repository"

Untuk memverifikasi bahwa repositori Anda telah dibuat, jalankan perintah berikut:
```
gcloud artifacts repositories list
```
Untuk menyederhanakan perintah gcloud, jalankan perintah berikut untuk menetapkan repositori default ke quickstart-generic-repo dan lokasi default ke us-central1.
1. Untuk menyetel repositori default ke quickstart-generic-repo, jalankan perintah berikut:
```
gcloud config set artifacts/repository quickstart-generic-repo
```
2. Untuk menyetel lokasi default ke us-central1, jalankan perintah berikut:
```
gcloud config set artifacts/location us-central1
```
Setelah nilai ditetapkan, Anda tidak perlu menentukannya dalam perintah gcloud yang memerlukan repositori atau lokasi.

Mengupload artefak ke repositori

Di direktori utama, buat file untuk diupload ke repositori Anda:
```
echo "hello world" > hello.yaml
```
Untuk mengupload file sebagai artefak ke repositori, jalankan perintah berikut:
```
gcloud artifacts generic upload \
    --source=hello.yaml \
    --package=my-package \
    --version=1.0.0
```
Dengan:
- hello.yaml adalah jalur file yang akan diupload.
- my-package adalah paket yang akan diupload.
- 1.0.0 adalah versi artefak. Anda tidak dapat menimpa versi yang ada di repositori.

Melihat artefak di repositori

Untuk memverifikasi bahwa artefak Anda telah ditambahkan ke repositori, Anda dapat mencantumkan semua artefak dengan menjalankan perintah berikut:

gcloud artifacts files list

Respons mencakup detail file dalam format PACKAGE:VERSION:FILE_NAME.

Dalam contoh berikut, hello.yaml adalah FILE_NAME:

FILE: my-package:1.0.0:hello.yaml
CREATE_TIME: 2023-03-09T20:55:07
UPDATE_TIME: 2023-03-09T20:55:07
SIZE (MB): 0.000
OWNER: projects/my-project/locations/us-central1/repositories/quickstart-generic-repo/packages/my-package/versions/1.0.0

Mendownload artefak generik

Untuk mendownload artefak generik dari repositori Anda, jalankan perintah berikut:

gcloud artifacts generic download \
    --name=hello.yaml \
    --package=my-package \
    --version=1.0.0 \
    --destination=DESTINATION

Dengan:

hello.yaml adalah nama file yang akan didownload.
my-package adalah paket yang akan didownload.
1.0.0 adalah versi artefak.

Ganti DESTINATION dengan direktori di sistem file lokal tempat Anda ingin menyimpan hasil download. Folder tujuan harus sudah ada atau perintah akan gagal.

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus repositori.

Menghapus project

Perhatian: Penghapusan project memiliki efek berikut:

Semua hal dalam project akan dihapus. Jika Anda menggunakan project yang ada untuk mengerjakan tugas di dokumen ini, saat Anda menghapusnya, pekerjaan lain dalam project tersebut juga akan dihapus.
Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin juga membuat project ID kustom yang masih ingin digunakan pada masa mendatang. Agar tidak kehilangan URL yang menggunakan project ID tersebut, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

Menghapus Google Cloud project:

gcloud projects delete PROJECT_ID

Hapus repositori

Sebelum menghapus repositori, pastikan semua paket yang ingin Anda simpan tersedia di lokasi lain.

Untuk menghapus repositori quickstart-generic-repo, jalankan perintah berikut:
```
gcloud artifacts repositories delete quickstart-generic-repo
```
Jika Anda ingin menghapus setelan repositori dan lokasi default yang Anda konfigurasi untuk konfigurasi gcloud yang aktif, jalankan perintah berikut:
```
gcloud config unset artifacts/repository
gcloud config unset artifacts/location
```

Langkah berikutnya

Pelajari lebih lanjut artefak generik