Knative-Bereitstellung auf VMware installieren

Hier erfahren Sie, wie Sie Knative in Ihren GKE-Clustern außerhalb von Google Cloud installieren. Für die Bereitstellung von Knative werden jetzt Anthos Service Mesh- und GKE Enterprise-Flotten verwendet. Informationen zu den Neuerungen und Änderungen bei der Bereitstellung von Flotteninstallationen von Knative

Warnung: Mit den Schritten auf dieser Seite wird eine Neuinstallation von Knative für die Bereitstellung auf VMware ausgeführt und Ihre vorherige Nicht-Flotteninstallation wird unwiderruflich überschrieben. Führen Sie die folgenden Schritte nicht in den Clustern aus, für die Sie zuvor die Knative-Bereitstellung aktiviert haben.

Für frühere kostenlose Testinstallationen von Knative müssen Sie zuerst ein Upgrade von Knative für die Bereitstellung auf VMware durchführen, um GKE Enterprise-Flotten zu verwenden.

Führen Sie die Schritte auf dieser Seite aus, um eine neue Installation zu konfigurieren oder eine vorhandene Flotteninstallation von Knative 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 GKE on VMware 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
     ```
    

Bereitstellung mit Knative aktivieren und installieren

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

  1. Aktivieren Sie die Knative-Bereitstellung 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 Funktion für die Bereitstellung von Knative aktiviert ist:

    Console

    Prüfen Sie in der Google Cloud Console, ob die Knative-Bereitstellungskomponente Aktiviert ist:

    Zu den GKE Enterprise-Features

    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-Bereitstellung 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 die Knative-Bereitstellung in Ihrem Cluster aktiviert ist:
    1. Öffnen Sie die Google Cloud Console:

      Zu GKE Enterprise-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 Sie die Details zur Bereitstellungsversion von Knative sehen: kubectl get namespace knative-serving -o 'go-template={{index .metadata.labels "serving.knative.dev/release"}}'
    4. Prüfen Sie, ob alle für Knative bereitgestellten Bereitstellungen unter den Namespaces knative-serving und appdevexperience den Status „Running“ haben.

Nächste Schritte

Installation von Knative einrichten