Menginstal penayangan Knative di luar Google Cloud

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

Untuk inferensi Knative di VMware, lihat panduan penginstalan tingkat GA.

Dukungan untuk cluster GKE berikut tersedia sebagai Pratinjau:

Gunakan langkah-langkah di halaman ini untuk mengonfigurasi penginstalan baru atau untuk memperbarui penginstalan fleet penayangan Knative yang ada.

Sebelum memulai

Anda harus memastikan bahwa Anda memenuhi prasyarat penginstalan.

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 luar Google Cloud:

  1. Anda harus membuat atau memiliki akun layanan yang sudah ada dan telah diberikan peran Monitoring Metric Writer (monitoring.metricWriter) yang diperlukan.

    • Untuk membuat akun layanan baru, lalu mendownload kuncinya, lihat Menggunakan akun layanan.

    • Jika Anda sudah memiliki akun layanan dengan izin yang diperlukan, temukan kunci yang Anda download saat membuat akun layanan tersebut.

  2. Pastikan Cloud Monitoring diaktifkan di cluster GKE Anda:

  3. Buat namespace knative-serving:

    kubectl create namespace knative-serving

  4. Buat secret di namespace knative-serving yang menyimpan akun layanan dengan izin monitoring.metricWriter:

    kubectl create secret -n knative-serving generic SECRET_NAME --from-file=PATH_TO_KEY_FILE/SECRET_KEY

    Ganti:

    • SECRET_NAME dengan nama yang Anda pilih untuk secret.
    • SECRET_KEY dengan nama file yang menyertakan kredensial Anda. Contoh: key.json
    • PATH_TO_KEY_FILE dengan jalur ke direktori SECRET_KEY.

    Lihat referensi kubectl create secret untuk mempelajari lebih lanjut, termasuk flag opsional.

  5. Buat file YAML dengan atribut berikut, misalnya cloudrunanthos.yaml:

    apiVersion: operator.run.cloud.google.com/v1alpha1
kind: CloudRun
metadata:
  name: cloud-run
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:

    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 penayangan 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 --kubeconfig=KUBECONFIG --context=CONTEXT --config=CONFIG_FILE

    Ganti kode berikut:

    • KUBECONFIG dengan jalur absolut ke file konfigurasi kubectl Anda.
    • CONTEXT dengan nama konteks dalam file konfigurasi kubectl yang akan digunakan untuk terhubung.
    • 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.