Mengelola layanan

Halaman ini menjelaskan pembuatan layanan dan menampilkan informasi tentang layanan. Layanan adalah resource utama penayangan Knative.

Membuat service

Anda membuat layanan baru dan revisi-nya dengan men-deploy image container ke layanan tersebut untuk pertama kalinya. Lihat Men-deploy layanan baru untuk mempelajari lebih lanjut cara membuat layanan.

Melihat daftar layanan di project Anda

Anda dapat melihat daftar layanan yang tersedia di project Anda menggunakan Konsol Google Cloud atau Google Cloud CLI:

Konsol

Untuk melihat daftar layanan:

  1. Buka penayangan Knative di konsol Google Cloud:

    Buka Inferensi Knative

  2. Periksa daftar layanan yang ditampilkan untuk project Anda:

Command line

Untuk mencantumkan layanan dalam project Anda:

gcloud run services list

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

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:

  1. Buka penayangan Knative di konsol Google Cloud:

    Buka Inferensi Knative

  2. Pilih layanan yang akan disalin dari daftar layanan yang ditampilkan untuk project Anda:

    1. Klik Copy.

    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 konfigurasi layanan yang ada ke dalam file YAML dengan perintah gcloud run services describe menggunakan tanda --format=export. Kemudian, Anda dapat mengubah file YAML tersebut dan men-deploy perubahan tersebut dengan perintah gcloud run services replace. Anda harus memastikan bahwa Anda hanya mengubah atribut yang ditentukan.

  1. Download konfigurasi layanan Anda ke file bernama service.yaml di ruang kerja lokal:

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

    Ganti SERVICE dengan nama layanan penayangan Knative Anda.

  2. Buat perubahan konfigurasi yang diinginkan pada layanan seperti yang dijelaskan dalam berbagai halaman konfigurasi.

     apiVersion: serving.knative.dev/v1
 kind: Service
 metadata:
   annotations:
     ...
   name: SERVICE
   ...
 spec:
   template:
     metadata:
       annotations:
       ...
       name: REVISION-NAME

    • Jika Anda men-deploy salinan ke cluster Kubernetes yang sama, ganti SERVICE dengan nama yang ingin Anda gunakan untuk salinan tersebut. Jika Anda men-deploy salinan ke cluster Kubernetes yang berbeda, Anda dapat menggunakan nama yang sama.

    • Pastikan nilai untuk REVISION-NAME dimulai dengan nama layanan (SERVICE). Misalnya, jika nama layanan baru adalah mynewfoo, nama revisi harus dalam format mynewfoo-whatever. Anda juga dapat menghapus nilai secara keseluruhan dan nama revisi baru akan dibuat secara otomatis.

  3. Salin layanan menggunakan perintah berikut:

    gcloud run services replace service.yaml

    Gunakan flag --region untuk men-deploy salinan ke region yang berbeda.

Melihat detail lengkap mengenai layanan

Untuk melihat detail selengkapnya mengenai layanan,

Konsol

Untuk melihat detail layanan:

  1. Buka penayangan Knative di konsol Google Cloud:

    Buka Inferensi Knative

  2. Klik layanan yang diinginkan dalam daftar layanan yang ditampilkan untuk project Anda guna membuka tampilan detail layanan:

  3. Perhatikan tab REVISIONS, LOGS, dan DETAILS. Tab revisi menampilkan daftar revisi, tab log menampilkan log layanan, dan tab detail menampilkan setelan autentikasi atau konektivitas saat ini.

Command line

Untuk melihat detail layanan: 

gcloud run services describe SERVICE
 Ganti SERVICE dengan nama layanan.

Anda dapat menggunakan tanda --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)'

Untuk mengetahui detail tentang revisi layanan, lihat Mengelola Revisi.

Mengubah setelan konektivitas layanan

Layanan penayangan Knative dapat memiliki salah satu dari dua opsi koneksi:

  • eksternal, yang memungkinkan akses eksternal ke layanan Anda

  • internal yang hanya membatasi akses ke layanan lain di cluster Anda.

Anda dapat menggunakan konsol atau Google Cloud CLI untuk mengubah setelan.

Konsol

Untuk mengubah setelan konektivitas layanan:

  1. Buka penayangan Knative di konsol Google Cloud:

    Buka Inferensi Knative

  2. Klik layanan yang diinginkan dalam daftar layanan yang ditampilkan untuk project Anda guna membuka tampilan detail layanan.

  3. Klik tab Trigger.

  4. Pilih setelan yang diinginkan, lalu klik Simpan.

Command line

Untuk mengubah setelan konektivitas layanan, perbarui layanan dengan setelan konektivitas yang diinginkan:

gcloud run services update [SERVICE] --connectivity=[OPTION]

  • Ganti [SERVICE] dengan nama layanan yang sedang Anda update. Anda dapat menghilangkan parameter ini sepenuhnya, tetapi Anda akan diminta untuk memasukkan nama layanan jika mengabaikannya.

  • Mengganti [OPTION] dengan internal atau external.

Menghapus layanan yang ada

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.

Saat menghapus layanan, image container yang digunakan oleh revisi yang dihapus tidak akan dihapus secara otomatis dari Container Registry. Untuk menghapus image container dari Container Registry, lihat Menghapus image.

Perhatikan bahwa penghapusan layanan bersifat permanen: tidak dapat diurungkan atau dipulihkan. Namun, jika setelah menghapus layanan, Anda men-deploy layanan baru dengan nama yang sama di cluster yang sama, layanan tersebut akan memiliki URL endpoint yang sama.

Konsol

Untuk menghapus layanan:

  1. Buka penayangan Knative di konsol Google Cloud:

    Buka Inferensi Knative

  2. Temukan layanan yang ingin Anda hapus dalam daftar layanan, lalu klik kotak centang layanan tersebut untuk memilihnya.

  3. 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.