Menyesuaikan penginstalan Google Cloud

Pelajari cara menginstal penayangan Knative di cluster GKE Anda di Google Cloud. Penyertaan Knative kini menggunakan Cloud Service Mesh dan fleet GKE Enterprise. Pelajari yang baru dan yang berubah dengan penginstalan armada penayangan Knative.

Gunakan halaman ini untuk menyesuaikan penginstalan baru atau mengonfigurasi penginstalan fleet penayangan Knative yang ada. Misalnya, Anda dapat mengonfigurasi untuk cluster pribadi atau menetapkan kredensial Cloud Monitoring.

Langkah-langkah penginstalan default secara otomatis men-deploy resource kustom CloudRun berikut yang mengaktifkan metrik di GKE Enterprise di cluster Google Cloud:

  apiVersion: operator.run.cloud.google.com/v1alpha1
  kind: CloudRun
  metadata:
    name: cloud-run

Untuk mempelajari resource kustom secara umum, lihat resource kustom.

Sebelum memulai

• Anda harus memastikan bahwa Anda memenuhi prasyarat penginstalan.

• Jika penayangan Knative diinstal di cluster, Anda harus memastikan bahwa "add-on GKE" tidak ada sebelum melakukan langkah-langkah penginstalan komponen fleet ini. Jika telah menginstal "add-on", Anda harus mengikuti langkah-langkah untuk mengupgrade ke fleet GKE Enterprise.

  Periksa apakah "add-on GKE" telah diinstal.

  Untuk memeriksa apakah penginstalan penayangan Knative Anda adalah "add-on GKE", jalankan perintah berikut:

  gcloud container clusters describe \
  CLUSTER_NAME \
  --region CLUSTER_LOCATION \
  --project PROJECT_ID --format='get(addonsConfig.cloudRunConfig)'

  Ganti:

  • CLUSTER_NAME dengan nama cluster Anda.
  • CLUSTER_LOCATION dengan lokasi tempat cluster Anda berada.
  • PROJECT_ID dengan ID project Google Cloud Anda.

  Hasil:

  • "Add-on GKE" tidak diinstal:
    • Tidak ada yang ditampilkan ke terminal jika add-on tidak pernah diinstal.
    • disabled=true ditampilkan jika add-on sebelumnya di-uninstal.
  • "GKE add-on" diinstal: Jika add-on diinstal di cluster Anda, detail konfigurasi untuk add-on akan ditampilkan. Contoh: loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL

  Contoh:

  Contoh berikut menunjukkan bahwa penayangan Knative diinstal di cluster my-addon-cluster melalui "add-on GKE", yang dikonfigurasi untuk menangani traffic eksternal:

  gcloud container clusters describe my-addon-cluster \
  --region us-central1-c --project my-gcp-project \
  --format='get(addonsConfig.cloudRunConfig)'

  Respons:

  loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL

Mengonfigurasi resource kustom CloudRun

Anda perlu membuat dan mengonfigurasi resource kustom CloudRun secara manual untuk mengonfigurasi penginstalan.

Untuk membuat resource kustom CloudRun secara manual untuk cluster GKE di Google Cloud:

1. Buat file YAML dan sertakan konfigurasi default, misalnya cloudrunanthos.yaml:

   apiVersion: operator.run.cloud.google.com/v1alpha1
   kind: CloudRun
   metadata:
     name: cloud-run
   

2. Di cloudrunanthos.yaml, Anda menyesuaikan penginstalan dengan mengonfigurasi satu atau beberapa atribut berikut di bagian spec:

   • Cluster pribadi: Anda harus menambahkan kumpulan atribut clusterConfig dan isPrivate untuk menginstal penayangan Knative di cluster pribadi di Google Cloud.

     Atribut clusterConfig dan isPrivate:

     spec:
       clusterConfig:
         isPrivate: true
     

     Perhatikan bahwa setelan ini menonaktifkan TLS Terkelola karena cluster pribadi tidak dapat berkomunikasi dengan otoritas sertifikat secara default.

   • Metrik: Tambahkan kumpulan atribut metricscollector untuk mengonfigurasi Cloud Monitoring. Secara default, metrik diaktifkan untuk GKE Enterprise di cluster Google Cloud.

     spec:
       metricscollector:
         stackdriver:
           projectid: PROJECT_ID
           gcpzone: CLUSTER_LOCATION
           clustername: CLUSTER_NAME
           secretname: SECRET_NAME
           secretkey: SECRET_KEY
     

     Ganti kode berikut:

     • PROJECT_ID dengan ID project Google Cloud Anda.
     • CLUSTER_LOCATION dengan region atau zona tempat cluster Anda berada.
     • CLUSTER_NAME dengan ID cluster Anda atau ID yang sepenuhnya memenuhi syarat untuk cluster.
     • SECRET_NAME dengan nama Secret untuk akun layanan namespace knative-serving.

     • SECRET_KEY dengan kunci Secret untuk akun layanan namespace knative-serving. Contoh: key.json

       Untuk mengetahui detail tentang akun layanan, lihat:

       • Membuat akun layanan
       • Membuat kunci akun layanan

Contoh

Dalam contoh resource kustom CloudRun ini, detail konfigurasi untuk Cloud Monitoring ditentukan untuk menggunakan secret my-gcp-logging-secret dan kunci key.json:

 apiVersion: operator.run.cloud.google.com/v1alpha1
 kind: CloudRun
 metadata:
   name: cloud-run
 spec:
   metricscollector:
     stackdriver:
       projectid: my-gcp-project-id
       gcpzone: us-central1-c
       clustername: my-anthos-cluster-name
       secretname: my-gcp-logging-secret
       secretkey: key.json
 ```

Mengaktifkan dan menginstal penayangan Knative

Aktifkan komponen penayangan Knative di fleet GKE Enterprise, lalu deploy resource kustom CloudRun:

1. Aktifkan penayangan Knative di fleet Anda:

   gcloud container fleet cloudrun enable --project=PROJECT_ID
   

   Ganti PROJECT_ID dengan ID project Google Cloud Anda.

   Untuk mengetahui detail dan opsi tambahan, lihat referensi gcloud container fleet cloudrun enable.

2. Opsional: Pastikan komponen fitur penayangan Knative diaktifkan:

   Konsol

   Lihat apakah komponen penyaluran Knative Diaktifkan di konsol Google Cloud:

   Buka Pengelola Fitur

   Command line

   Lihat apakah status appdevexperience adalah ACTIVE:

   gcloud container fleet features list  --project=PROJECT_ID
   

   Ganti PROJECT_ID dengan ID project Google Cloud Anda.

   Untuk mengetahui detail dan opsi tambahan, lihat referensi daftar fitur fleet penampung gcloud.

   Hasil:

   NAME               STATE
   appdevexperience   ACTIVE
   

3. Untuk setiap cluster GKE Enterprise tempat Anda ingin menginstal penayangan Knative, Anda harus men-deploy resource kustom CloudRun:

   gcloud

   gcloud container fleet cloudrun apply --gke-cluster=CLUSTER_LOCATION/CLUSTER_NAME --config=CONFIG_FILE
   

   Ganti kode berikut:

   • CLUSTER_LOCATION dengan region atau zona tempat cluster Anda berada.
   • CLUSTER_NAME dengan ID cluster Anda atau ID yang sepenuhnya memenuhi syarat untuk cluster.
   • CONFIG_FILE dengan jalur relatif nama file ke resource kustom cloudRun Anda. Contoh cloudrunanthos.yaml.

   Untuk mengetahui detail dan opsi tambahan, lihat referensi gcloud container fleet cloudrun apply.

   kubectl

   kubectl apply --kubeconfig=KUBECONFIG --filename CONFIG_FILE
   

   Ganti kode berikut:

   • KUBECONFIG dengan jalur absolut ke file konfigurasi kubectl Anda.
   • CONFIG_FILE dengan nama file dan jalur relatif ke resource kustom cloudRun Anda. Contoh cloudrunanthos.yaml.

   Untuk mengetahui detail dan opsi tambahan, lihat referensi kubectl apply.

4. Pastikan penayangan Knative telah diaktifkan di cluster Anda:
   1. Buka konsol Google Cloud:

      Buka cluster GKE

   2. Klik nama cluster Anda untuk membuka panel detail.

   3. Jalankan perintah ini untuk memeriksa apakah Anda dapat melihat detail versi penayangan Knative: kubectl get namespace knative-serving -o 'go-template={{index .metadata.labels "serving.knative.dev/release"}}'
   4. Pastikan semua deployment tertentu yang ditayangkan Knative dalam status berjalan di namespace knative-serving dan appdevexperience.

Langkah selanjutnya

Siapkan penginstalan inferensi Knative.