Knative serving auf VMware installieren

Hier erfahren Sie, wie Sie Knative serving in GKE-Clustern außerhalb von Google Cloud installieren. Knative serving verwendet jetzt Cloud Service Mesh- und GKE Enterprise-Flotten. Informationen zu Neuerungen und Änderungen bei Installationen der Flottenflotte von Knative serving

Warnung: Wenn Sie die Schritte auf dieser Seite ausführen, wird eine Neuinstallation von Knative serving auf VMware ausgeführt und Ihre vorherige Flotteninstallation wird unwiderruflich überschrieben. Fahren Sie nicht mit den folgenden Schritten in den Clustern fort, für die Sie Knative serving zuvor aktiviert haben.

Für frühere kostenlose Testversionen von Knative serving müssen Sie zuerst ein Upgrade von Knative serving auf VMware ausführen, um GKE Enterprise-Flotten verwenden zu können.

Führen Sie die Schritte auf dieser Seite aus, um eine neue Installation zu konfigurieren oder eine vorhandene Flotteninstallation 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. Sicherstellen, dass Cloud Monitoring in Google Distributed Cloud 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

    Ersetzen Sie Folgendes:

    • 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 Knative serving-Komponente in Ihrer GKE Enterprise-Flotte und stellen Sie dann die benutzerdefinierte Ressource CloudRun 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 Featurekomponente von Knative serving 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.

    Auswirkungen:

    NAME               STATE
appdevexperience   ACTIVE

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

    gcloud

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

    Ersetzen Sie Folgendes:

    • 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 den folgenden Befehl aus, um zu prüfen, ob die Details zur Knative serving-Version angezeigt werden: 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 in den Namespaces knative-serving und appdevexperience im Status „Wird ausgeführt“ sind.

Nächste Schritte

Richten Sie die Installation von Knative serving ein.