Menginstal penyaluran Knative di luar Google Cloud

Pelajari cara menginstal inferensi Knative di cluster GKE Anda di luar Google Cloud. Penayangan Knative kini menggunakan Cloud Service Mesh dan GKE Enterprise armada mereka. Mempelajari apa yang baru dan berubah dengan penayangan Knative penginstalan perangkat.

Untuk penyaluran Knative di VMware, lihat referensi Panduan penginstalan tingkat GA.

Dukungan untuk cluster GKE berikut tersedia sebagai Pratinjau:

Gunakan langkah-langkah pada halaman ini untuk mengkonfigurasi penginstalan baru atau untuk memperbarui penginstalan perangkat yang ada penyaluran Knative.

Sebelum memulai

Anda harus memastikan bahwa Anda memenuhi prasyarat penginstalan.

Konfigurasi resource kustom CloudRun Anda

Anda harus membuat dan mengonfigurasi resource kustom CloudRun secara manual untuk mengkonfigurasi instalasi Anda.

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

  1. Anda harus membuat atau sudah memiliki akun layanan yang diberikan persyaratan Peran Penulis Metrik Monitoring (monitoring.metricWriter).

    • Untuk membuat akun layanan baru dan mendownload kunci, 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 rahasia 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 rahasia.
    • SECRET_KEY dengan nama file yang menyertakan memiliki kredensial yang lengkap. Contoh: key.json
    • PATH_TO_KEY_FILE dengan jalur ke direktori direktori SECRET_KEY.

    Lihat Referensi kubectl create secret untuk mempelajari lebih lanjut, termasuk tanda 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 Google Cloud Anda proyek.
    • CLUSTER_LOCATION dengan region atau zona tempat properti cluster Anda berada.
    • CLUSTER_NAME dengan ID cluster Anda atau ID cluster yang memenuhi syarat untuk cluster tersebut.
    • SECRET_NAME dengan nama Secret untuk akun layanan dari 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 khusus CloudRun ini, detail konfigurasi untuk Cloud Monitoring ditetapkan untuk menggunakan rahasia my-gcp-logging-secret dan tombol 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

Mengaktifkan komponen inferensi Knative di fleet GKE Enterprise Anda lalu deploy resource kustom CloudRun Anda:

  1. Aktifkan penayangan Knative di perangkat 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 gcloud container fleet cloudrun enable alamat IP internal.

  2. Opsional: Pastikan bahwa komponen fitur penayangan Knative diaktifkan:

    Konsol

    Lihat apakah komponen penayangan Knative Diaktifkan di bagian Konsol Google Cloud:

    Buka Feature Manager

    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 daftar fitur fleet container gcloud alamat IP internal.

    Hasil:

    NAME               STATE
    appdevexperience   ACTIVE
    
  3. Untuk setiap cluster GKE Enterprise tempat Anda ingin menginstal inferensi 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 konfigurasi kubectl .
    • CONTEXT dengan nama konteks di kubectl file konfigurasi yang akan digunakan untuk menghubungkan.
    • CONFIG_FILE dengan jalur relatif nama file ke Resource kustom cloudRun. Contoh cloudrunanthos.yaml.

    Untuk mengetahui detail dan opsi tambahan, lihat gcloud container fleet cloudrun apply alamat IP internal.

    kubectl

    kubectl apply --kubeconfig=KUBECONFIG --filename CONFIG_FILE
    

    Ganti kode berikut:

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

    Untuk mengetahui detail dan opsi tambahan, lihat kubectl apply alamat IP internal.

  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 khusus penayangan Knative berada dalam status berjalan pada namespace knative-serving dan appdevexperience.

Langkah selanjutnya

Siapkan penginstalan penayangan Knative Anda.