Mengelola Layanan

Halaman ini menjelaskan pembuatan layanan dan menampilkan informasi tentang layanan. Layanan adalah resource utama Cloud Run. Setiap layanan memiliki URL yang unik dan permanen yang tidak akan berubah seiring waktu saat Anda men-deploy revisi baru pada URL tersebut.

Domain permanen layanan terdiri dari nama layanan dan hash.

Membuat service

Anda membuat layanan baru dengan men-deploy image container ke layanan tersebut untuk pertama kalinya. Men-deploy layanan baru berisi petunjuk lebih lengkap.

Melihat daftar layanan di project Anda

Anda dapat melihat daftar layanan yang tersedia di project Anda menggunakan Konsol Google Cloud atau command line gcloud:

Konsol

Untuk melihat daftar layanan:

Buka Cloud Run
Periksa daftar layanan yang ditampilkan untuk project Anda:

Command line

Untuk mencantumkan layanan dalam project Anda:

gcloud run services list

Perhatikan bahwa setiap layanan memiliki URL terkait.

Anda dapat memfilter daftar ini berdasarkan properti definisi layanan, seperti label yang ditetapkan.

Cloud Code

Untuk melihat daftar layanan dengan Cloud Code, baca panduan Cloud Run Explorer untuk IntelliJ dan Visual Studio Code.

Library klien

Untuk melihat daftar layanan dari kode:

REST API

Untuk melihat daftar layanan dalam project Anda, kirim permintaan HTTP GET ke endpoint service Cloud Run Admin API.

Misalnya, menggunakan curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services

Ganti:

ACCESS_TOKEN dengan token akses yang valid untuk akun yang memiliki izin IAM untuk melihat layanan. Misalnya, jika Anda login ke gcloud, Anda dapat mengambil token akses menggunakan gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container.
REGION dengan region layanan Google Cloud.
PROJECT-ID dengan ID project Google Cloud.

Menyalin layanan

Anda dapat membuat salinan layanan yang ada menggunakan Konsol Google Cloud atau YAML. Anda dapat mengubah apa pun yang Anda inginkan di salinan, termasuk nama dan region.

Konsol

Untuk menyalin layanan:

Buka Cloud Run
Pilih layanan yang akan disalin dari daftar layanan yang ditampilkan untuk project Anda:
1. Klik Salin.
2. Di halaman salinan layanan, tetapkan atau ubah nilai apa pun yang ingin Anda ubah, seperti region, dll. Jika Anda mempertahankan region yang sama, Anda harus memberikan nama baru untuk layanan tersebut.
3. Klik Buat untuk membuat salinan dan men-deploy-nya menggunakan nama layanan baru.

YAML

Anda dapat mendownload dan melihat konfigurasi layanan yang ada menggunakan perintah gcloud run services describe --format export, yang memberikan hasil yang telah diolah dalam format YAML. Kemudian, Anda dapat mengubah kolom yang dijelaskan di bawah ini dan mengunggah YAML yang telah dimodifikasi menggunakan perintah gcloud run services replace. Pastikan Anda hanya mengubah kolom seperti yang didokumentasikan.

Untuk melihat dan mendownload konfigurasi:

gcloud run services describe SERVICE --format export > service.yaml

Buat perubahan konfigurasi yang diinginkan pada layanan.
```
 apiVersion: serving.knative.dev/v1
 kind: Service
 metadata:
   annotations:
     ...
   name: SERVICE
   ...
 spec:
   template:
     metadata:
       annotations:
       ...
       name: REVISION
```
- Jika Anda tidak men-deploy salinan ke region lain, ganti SERVICE dengan nama yang ingin Anda gunakan untuk salinan tersebut. Jika Anda men-deploy salinan ke region lain, Anda dapat menggunakan nama lama.
- Ganti REVISION dengan nama revisi baru atau hapus (jika ada). Jika Anda menyediakan nama revisi baru, nama tersebut harus memenuhi kriteria berikut:
  - Dimulai denganSERVICE-
  - Hanya berisi huruf kecil, angka, dan -
  - Tidak diakhiri dengan -
  - Tidak melebihi 63 karakter
Salin layanan menggunakan perintah berikut:
```
gcloud run services replace service.yaml
```
Gunakan flag --region untuk men-deploy salinan ke region yang berbeda.

Melihat detail selengkapnya tentang layanan

Untuk melihat detail selengkapnya mengenai layanan,

Konsol

Untuk melihat detail layanan:

Buka Cloud Run
Klik layanan yang diinginkan dalam daftar layanan yang ditampilkan untuk project Anda guna membuka tampilan detail layanan.

Command line

Untuk melihat detail layanan:

gcloud run services describe SERVICE

Ganti SERVICE dengan nama layanan.

Anda dapat menggunakan flag --format untuk memformat output. Contohnya sebagai YAML:

gcloud run services describe SERVICE --format yaml

Anda dapat menggunakan --format export untuk mengekspor sebagai YAML tanpa label atau status yang dibuat secara otomatis:

gcloud run services describe SERVICE --format export

Anda juga dapat menggunakan flag --format untuk mendapatkan URL layanan:

gcloud run services describe SERVICE --format='value(status.url)'

Cloud Code

Untuk melihat detail layanan dengan Cloud Code, baca panduan Cloud Run Explorer untuk IntelliJ dan Visual Studio Code.

Untuk detail selengkapnya tentang revisi layanan, lihat Mengelola Revisi.

Library klien

Untuk melihat detail tentang layanan dari kode:

REST API

Untuk melihat detail tentang layanan, kirim permintaan HTTP GET ke endpoint service Cloud Run Admin API.

Misalnya, menggunakan curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME

Ganti:

ACCESS_TOKEN dengan token akses yang valid untuk akun yang memiliki izin IAM untuk melihat detail layanan. Misalnya, jika Anda login ke gcloud, Anda dapat mengambil token akses menggunakan gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container.
SERVICE-NAME dengan nama layanan.
REGION dengan region layanan Google Cloud.
PROJECT-ID dengan ID project Google Cloud.

Menonaktifkan layanan yang ada

Cloud Run tidak menawarkan cara langsung untuk membuat layanan berhenti menyajikan traffic, tetapi Anda dapat mencapai hasil yang serupa dengan mencabut izin untuk memanggil layanan ke identitas yang memanggil layanan. Khususnya, jika layanan Anda bersifat "public", hapus allUsers dari peran Cloud Run Invoker (roles/run.invoker).

Menghapus layanan yang ada

Pertimbangan berikut berlaku untuk penghapusan layanan:

Menghapus layanan akan menghapus semua resource yang terkait dengan layanan ini, termasuk semua revisi layanan ini, terlepas dari apakah layanan tersebut melayani traffic atau tidak.
Menghapus layanan tidak secara otomatis menghapus image container dari Container Registry. Untuk menghapus image container yang digunakan oleh revisi yang telah dihapus dari Container Registry, lihat Menghapus image.
Menghapus layanan dengan satu atau beberapa pemicu Eventarc tidak secara otomatis menghapus pemicu tersebut. Untuk menghapus pemicu, lihat Mengelola pemicu.
Setelah dihapus, layanan tetap terlihat di Konsol Google Cloud dan di antarmuka command line hingga penghapusan selesai sepenuhnya. Namun, Anda tidak dapat mengupdate layanan tersebut.
Penghapusan layanan bersifat permanen: tidak dapat diurungkan atau dipulihkan. Namun, jika setelah menghapus layanan, Anda men-deploy layanan baru dengan nama yang sama di region yang sama, layanan tersebut akan memiliki URL endpoint yang sama.

Konsol

Untuk menghapus layanan:

Buka Cloud Run
Temukan layanan yang ingin Anda hapus dalam daftar layanan, lalu klik kotak centang layanan tersebut untuk memilihnya.
Klik HAPUS. Tindakan ini akan menghapus semua revisi layanan.

Command line

Untuk menghapus layanan, gunakan perintah:

gcloud run services delete [SERVICE]

Ganti [SERVICE] dengan nama layanan Anda.

Library klien

Untuk menghapus layanan dari kode:

REST API

Untuk menghapus layanan, kirim permintaan HTTP DELETE ke endpoint service Cloud Run Admin API.

Misalnya, menggunakan curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME

Ganti:

ACCESS_TOKEN dengan token akses yang valid untuk akun yang memiliki izin IAM untuk menghapus layanan. Misalnya, jika Anda login ke gcloud, Anda dapat mengambil token akses menggunakan gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container.
SERVICE-NAME dengan nama layanan.
REGION dengan region layanan Google Cloud.
PROJECT-ID dengan ID project Google Cloud.