Menyimpan format lain di Artifact Registry

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

Sebelum memulai

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Artifact Registry API.

    Enable the API

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Artifact Registry API.

    Enable the API

Meluncurkan Cloud Shell

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

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

Membuat repositori umum

  1. 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"
    
  2. Untuk memverifikasi bahwa repositori Anda telah dibuat, jalankan perintah berikut:

    gcloud artifacts repositories list
    
  3. Untuk menyederhanakan perintah gcloud, jalankan perintah berikut untuk menetapkan repositori default ke quickstart-generic-repo dan lokasi default ke us-central1.

    1. Untuk menetapkan repositori default ke quickstart-generic-repo, jalankan perintah berikut:

      gcloud config set artifacts/repository quickstart-generic-repo
      
    2. Untuk menetapkan 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

  1. Di direktori utama, buat file untuk diupload ke repositori:

    echo "hello world" > hello.yaml
    
  2. 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 keterangan:

    • 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

Responsnya 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 umum

Untuk mendownload artefak umum dari repositori, jalankan perintah berikut:

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

Dengan keterangan:

  • 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 tidak dikenai biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus repositori.

Menghapus project

    Delete a Google Cloud project:

    gcloud projects delete PROJECT_ID

Menghapus repositori

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

  1. Untuk menghapus repositori quickstart-generic-repo, jalankan perintah berikut:

    gcloud artifacts repositories delete quickstart-generic-repo
    
  2. Jika Anda ingin menghapus setelan repositori dan lokasi default yang dikonfigurasi untuk konfigurasi gcloud aktif, jalankan perintah berikut:

    gcloud config unset artifacts/repository
    gcloud config unset artifacts/location
    

Langkah selanjutnya