Google Cloud-Installation anpassen

So installieren Sie Knative Serving in Ihren GKE-Clustern in Google Cloud. Knative Serving verwendet jetzt Cloud Service Mesh- und GKE Enterprise-Flotten. Das ist neu bei Knative Serving-Flotteninstallationen.

Auf dieser Seite können Sie eine neue Installation anpassen oder eine vorhandene Flotten-Installation von Knative Serving konfigurieren. Sie können beispielsweise für private Cluster konfigurieren oder Anmeldedaten für Cloud Monitoring festlegen.

Mit den Standardinstallationsschritten wird die folgende benutzerdefinierte CloudRun-Ressource automatisch bereitgestellt, die die Messwerte für GKE Enterprise in Google Cloud-Clustern aktiviert:

  apiVersion: operator.run.cloud.google.com/v1alpha1
  kind: CloudRun
  metadata:
    name: cloud-run

Allgemeine Informationen zu benutzerdefinierten Ressourcen finden Sie unter Benutzerdefinierte Ressourcen.

Hinweis

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

• Wenn Knative Serving in Ihrem Cluster installiert ist, müssen Sie dafür sorgen, dass das GKE-Add-on nicht vorhanden ist, bevor Sie diese Schritte zur Installation der Flottenkomponenten ausführen. Wenn das Add-on installiert ist, müssen Sie stattdessen die Schritte zum Upgrade auf GKE Enterprise-Flotten ausführen.

  Prüfen, ob das GKE-Add-on installiert ist

  Mit dem folgenden Befehl können Sie prüfen, ob Ihre Installation von Knative Serving das GKE-Add-on ist:

  gcloud container clusters describe \
  CLUSTER_NAME \
  --region CLUSTER_LOCATION \
  --project PROJECT_ID --format='get(addonsConfig.cloudRunConfig)'

  Ersetzen Sie:

  • CLUSTER_NAME durch den Namen Ihres Clusters.
  • CLUSTER_LOCATION durch die Standort, an dem sich der Cluster befindet.
  • Ersetzen Sie PROJECT_ID durch die ID Ihres Google Cloud-Projekts.

  Das Ergebnis:

  • GKE-Add-on ist nicht installiert:
    • Wenn das Add-on nie installiert war, wird nichts an Ihr Terminal zurückgegeben.
    • disabled=true wird zurückgegeben, wenn das Add-on zuvor deinstalliert wurde.
  • GKE-Add-on ist installiert: Wenn das Add-on in Ihrem Cluster installiert ist, werden die Konfigurationsdetails für das Add-on zurückgegeben. Beispiel: loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL

  Beispiel:

  Im folgenden Beispiel wird gezeigt, dass Knative Serving im Cluster my-addon-cluster über das GKE-Add-on installiert wurde, das für die Verarbeitung externen Traffics konfiguriert ist:

  gcloud container clusters describe my-addon-cluster \
  --region us-central1-c --project my-gcp-project \
  --format='get(addonsConfig.cloudRunConfig)'

  Antwort:

  loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL

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 Anthos-Cluster in Google Cloud:

1. Erstellen Sie eine YAML-Datei und fügen Sie die Standardkonfiguration hinzu, z. B. cloudrunanthos.yaml:

   apiVersion: operator.run.cloud.google.com/v1alpha1
   kind: CloudRun
   metadata:
     name: cloud-run
   

2. In cloudrunanthos.yaml können Sie die Installation anpassen, wenn Sie eines oder mehrere der folgenden Attribute im Abschnitt spec konfigurieren:

   • Private Cluster: Sie müssen die Attrributsätze clusterConfig und isPrivate hinzufügen, um Knative-Dienste auf privaten Clustern in Google Cloud zu installieren.

     Die Attribute clusterConfig und isPrivate:

     spec:
       clusterConfig:
         isPrivate: true
     

     Beachten Sie, dass durch diese Einstellung Verwaltetes TLS deaktiviert wird, da private Cluster nicht standardmäßig mit der Zertifizierungsstelle kommunizieren können.

   • Messwerte: Fügen Sie die metricscollector-Attribute zur Konfiguration von Cloud Monitoring hinzu. Standardmäßig sind Messwerte für GKE Enterprise in Google Cloud-Clustern aktiviert.

     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:

       • Dienstkonten erstellen
       • Dienstkontoschlüssel erstellen

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 --gke-cluster=CLUSTER_LOCATION/CLUSTER_NAME --config=CONFIG_FILE
   

   Ersetzen Sie Folgendes:

   • 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.
   • 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.