Google Cloud-Installation anpassen

Hier erfahren Sie, wie Sie Knative serving in GKE-Clustern in 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

Auf dieser Seite können Sie eine Neuinstallation anpassen oder eine vorhandene Flotteninstallation von Knative serving konfigurieren. Sie können beispielsweise für private Cluster konfigurieren oder Anmeldedaten für Cloud Monitoring festlegen.

In den Standardinstallationsschritten wird automatisch die folgende benutzerdefinierte CloudRun-Ressource bereitgestellt, die Messwerte in 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.

Hinweise

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

• Wenn Knative serving im Cluster installiert ist, müssen Sie dafür sorgen, dass das GKE-Add-on nicht vorhanden ist, bevor Sie diese Schritte für die Installation der Flottenkomponenten ausführen. Wenn Sie das Add-on installiert haben, müssen Sie stattdessen die Schritte für ein Upgrade auf GKE Enterprise-Flotten ausführen.

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

  Führen Sie den folgenden Befehl aus, um zu 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:

  Das folgende Beispiel zeigt, dass Knative serving im Cluster my-addon-cluster über das GKE-Add-on installiert wurde, das für die Verarbeitung von externem Traffic konfiguriert ist:

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

  Lösung:

  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 GKE-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 Attribute clusterConfig und isPrivate hinzufügen, um Knative serving auf einem privaten Cluster 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 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 --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 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.