Knative Serving außerhalb von Google Cloud installieren

Informationen zum Installieren von Knative Serving in Ihren GKE-Clustern außerhalb von Google Cloud. Für Knative Serving werden jetzt Cloud Service Mesh und GKE Enterprise-Flotten verwendet. Das ist neu bei Knative Serving-FlotteniInstallationen.

Informationen zu Knative Serving auf VMware finden Sie in der GA-Installationsanleitung.

Die Unterstützung für die folgenden GKE-Cluster ist als Vorschau verfügbar:

Führen Sie die Schritte auf dieser Seite aus, um eine neue Installation zu konfigurieren oder eine vorhandene Flotten-Installation von Knative Serving zu aktualisieren.

Hinweise

Sie müssen die Voraussetzungen für die Installation erfüllen.

Benutzerdefinierte Ressource CloudRun konfigurieren

Sie müssen die benutzerdefinierte CloudRun-Ressource manuell erstellen und konfigurieren, um Ihre Installation anzupassen.

So erstellen Sie manuell eine benutzerdefinierte CloudRun-Ressource für GKE-Cluster außerhalb von Google Cloud:

  1. Sie müssen ein Dienstkonto erstellen oder ein vorhandenes Dienstkonto haben, dem die erforderliche Rolle "Monitoring-Messwert-Autor" (monitoring.metricWriter) zugewiesen wurde.

    • Informationen zum Erstellen eines neuen Dienstkontos und zum Herunterladen des Schlüssels finden Sie unter Dienstkonten verwenden.

    • Wenn Sie ein vorhandenes Dienstkonto mit den erforderlichen Berechtigungen haben, suchen Sie den Schlüssel, den Sie beim Erstellen dieses Dienstkontos heruntergeladen haben.

  2. Achten Sie darauf, dass Cloud Monitoring in Ihrem GKE-Cluster aktiviert ist:

  3. Namespace knative-serving erstellen:

    kubectl create namespace knative-serving
    
  4. Erstellen Sie im Namespace knative-serving ein Secret, das das Dienstkonto mit Berechtigungen vom Typ monitoring.metricWriter enthält:

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

    Ersetzen Sie:

    • SECRET_NAME durch den Namen, den Sie für das Secret ausgewählt haben.
    • SECRET_KEY durch den Namen der Datei, die Ihre Anmeldedaten enthält. Beispiel: key.json
    • PATH_TO_KEY_FILE durch den Pfad zum Verzeichnis von SECRET_KEY.

    Weitere Informationen, einschließlich optionaler Flags, finden Sie in der Referenz zu kubectl create secret.

  5. Erstellen Sie eine YAML-Datei mit den folgenden Attributen, z. B. 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
    

    Dabei gilt:

    • PROJECT_ID durch die ID Ihres Google Cloud-Projekts.
    • CLUSTER_LOCATION durch die Region oder Zone, in der sich der Cluster befindet.
    • CLUSTER_NAME durch die ID Ihres Clusters oder die voll qualifizierte ID für den Cluster.
    • SECRET_NAME durch den Namen des Secrets für das Dienstkonto des Namespace knative-serving.
    • SECRET_KEY durch den Schlüssel des Secrets für das Dienstkonto des Namespace knative-serving. Beispiel: key.json

      Weitere Informationen zu Dienstkonten finden Sie unter:

    Beispiel

    In diesem Beispiel für eine benutzerdefinierte Ressource CloudRun werden die Konfigurationsdetails für Cloud Monitoring angegeben, um das Secret my-gcp-logging-secret und den Schlüssel key.json zu verwenden:

     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
     ```
    

Knative Serving aktivieren und installieren

Aktivieren Sie die Komponente "Knative Serving" in Ihrer GKE Enterprise-Flotte und stellen Sie dann die benutzerdefinierte CloudRun-Ressource bereit:

  1. Aktivieren Sie Knative Serving in Ihrer Flotte:

    gcloud container fleet cloudrun enable --project=PROJECT_ID
    

    Ersetzen Sie PROJECT_ID durch die ID Ihres Google Cloud-Projekts.

    Weitere Informationen und zusätzliche Optionen finden Sie in der Referenz zu gcloud container fleet cloudrun enable.

  2. Optional: Prüfen Sie, ob die Knative Serving-Feature-Komponente aktiviert ist:

    Console

    Prüfen Sie, ob die Knative-Serving-Komponente in der Google Cloud Console aktiviert ist:

    Zu Feature Manager

    Befehlszeile

    Prüfen Sie, ob der appdevexperience-Zustand ACTIVE lautet:

    gcloud container fleet features list  --project=PROJECT_ID
    

    Ersetzen Sie PROJECT_ID durch die ID Ihres Google Cloud-Projekts.

    Weitere Informationen und zusätzliche Optionen finden Sie unter gcloud container fleet features list.

    Ergebnis:

    NAME               STATE
    appdevexperience   ACTIVE
    
  3. Für jeden GKE Enterprise-Cluster, in dem Sie Knative Serving installieren möchten, müssen Sie die benutzerdefinierte CloudRun-Ressource bereitstellen:

    gcloud

    gcloud container fleet cloudrun apply --kubeconfig=KUBECONFIG --context=CONTEXT --config=CONFIG_FILE
    

    Dabei gilt:

    • Ersetzen Sie KUBECONFIG durch den absoluten Pfad zu Ihrer kubectl-Konfigurationsdatei.
    • Ersetzen Sie CONTEXT durch den Namen des Kontextes in Ihrer kubectl-Konfigurationsdatei, um eine Verbindung herzustellen.
    • CONFIG_FILE durch den Dateinamen des relativen Pfads zu Ihrer benutzerdefinierten cloudRun-Ressource. Beispiel cloudrunanthos.yaml.

    Weitere Informationen und zusätzliche Optionen finden Sie in der Referenz zu gcloud container fleet cloudrun apply.

    kubectl

    kubectl apply --kubeconfig=KUBECONFIG --filename CONFIG_FILE
    

    Ersetzen Sie Folgendes:

    • Ersetzen Sie KUBECONFIG durch den absoluten Pfad zu Ihrer kubectl-Konfigurationsdatei.
    • Ersetzen Sie CONFIG_FILE durch den Dateinamen des relativen Pfads zu Ihrer benutzerdefinierten cloudRun-Ressource. Beispiel cloudrunanthos.yaml.

    Weitere Informationen und zusätzliche Optionen finden Sie in der Referenz zu kubectl apply.

  4. Prüfen Sie, ob Knative Serving in Ihrem Cluster aktiviert wurde:
    1. Öffnen Sie die Google Cloud Console:

      Zu GKE-Clustern

    2. Klicken Sie auf den Namen Ihres Clusters, um den Detailbereich zu öffnen.

    3. Führen Sie diesen Befehl aus, um zu prüfen, ob Sie die Details zur Version von Knative Serving sehen: kubectl get namespace knative-serving -o 'go-template={{index .metadata.labels "serving.knative.dev/release"}}'
    4. Prüfen Sie, ob alle Knative Serving-spezifischen Bereitstellungen für die Bereitstellung unter den Namespaces knative-serving und appdevexperience ausgeführt werden.

Nächste Schritte

Richten Sie Ihre Installation von Knative Serving ein.