Mengelola layanan

Halaman ini menjelaskan pembuatan layanan dan menampilkan informasi tentang layanan. Service adalah sumber daya utama penyaluran Knative.

Membuat service

Anda membuat layanan baru dan revisinya dengan untuk pertama kalinya men-deploy image container ke dalamnya. Lihat Men-deploy layanan baru untuk mempelajari lebih lanjut membuat layanan.

Melihat daftar layanan di project Anda

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

Konsol

Untuk melihat daftar layanan:

  1. Buka penyaluran Knative di Konsol Google Cloud:

    Buka penayangan 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 penyaluran Knative di Konsol Google Cloud:

    Buka penayangan 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 YAML dengan perintah gcloud run services describe menggunakan Tanda --format=export. Anda kemudian dapat memodifikasi file YAML itu 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 menjadi file bernama service.yaml pada ruang kerja lokal:

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

    Ganti SERVICE dengan nama Anda Layanan penyaluran Knative.

  2. Lakukan 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. Jika Anda men-deploy salinan ke cluster Kubernetes yang berbeda, Anda dapat menggunakan nama yang sama.

    • Pastikan nilai untuk REVISION-NAME dimulai dengan layanan nama (SERVICE). Misalnya, jika nama layanan baru adalah mynewfoo, maka nama revisi harus dalam format mynewfoo-whatever. Jika perlu, hapus nilai sepenuhnya dan nama revisi baru akan dibuat secara otomatis.

  3. Salin layanan menggunakan perintah berikut:

    gcloud run services replace service.yaml

    Menggunakan --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 penyaluran Knative di Konsol Google Cloud:

    Buka penayangan Knative

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

  3. Perhatikan tab REVISIONS, LOGS, dan DETAIL. Tab revisi menampilkan daftar revisi, tab log akan menampilkan log layanan, dan tab {i>detail<i} menampilkan autentikasi atau setelan konektivitas.

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 detail tentang revisi layanan, lihat Mengelola Revisi.

Mengubah setelan konektivitas layanan

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

  • external, 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 penyaluran Knative di Konsol Google Cloud:

    Buka penayangan 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:

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

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

  • 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 otomatis dihapus dari Container Registry. Untuk menghapus image penampung dari Container Registry lihat Menghapus image.

Perlu diketahui bahwa penghapusan layanan bersifat permanen: tidak ada tindakan untuk mengurungkan atau memulihkan. Namun, jika setelah menghapus layanan, Anda men-deploy layanan baru dengan di cluster yang sama, instance tersebut akan memiliki URL endpoint yang sama.

Konsol

Untuk menghapus layanan:

  1. Buka penyaluran Knative di Konsol Google Cloud:

    Buka penayangan 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.