vCenter-CA-Zertifikatsverweise aktualisieren

Wenn sich das vCenter-CA-Zertifikat ändert, müssen Sie den Zertifikatsverweis aktualisieren, damit laufende Administrator- und Nutzercluster das neue Zertifikat erkennen. Wenn Sie dieses Update auf Ihre Google Distributed Cloud-Software nur für VMware-Cluster anwenden möchten, ersetzen Sie die Zertifikatsdatei im Pfad vCenter.caCertPath in der Konfigurationsdatei Ihres Administratorclusters. Verweisen Sie als Nächstes in den Konfigurationsdateien des Nutzerclusters im Feld vCenter.caCertPath auf die neue Datei und führen Sie gkectl update für jeden Cluster aus.

Referenziertes vCenter-CA-Zertifikat in den Cluster-Konfigurationsdateien aktualisieren

So aktualisieren Sie die laufenden Administrator- und Nutzercluster mit dem neuen Zertifikat:

  1. Rufen Sie das neue vCenter-CA-Zertifikat ab und extrahieren Sie es:

    curl -o certs.zip https://VCENTER_IP_ADDRESS_OR_FQDN/certs/download.zip
    unzip certs.zip
    

    Sie können das Flag -k verwenden, wenn Sie unbekannte Zertifikate zulassen möchten. Damit vermeiden Sie Zertifikatsprobleme, auf die Sie beim Zugriff auf vCenter haben können.

  2. Ermitteln Sie, welches der vCenter-Zertifikate gültig ist. Nur eine der Linux-Zertifikatsdateien im extrahierten Ordner ..../certs/lin ist das gültige vCenter-Zertifikat. So ermitteln Sie, welche Datei das gültige vCenter-Zertifikat ist:

    1. Legen Sie die folgenden Umgebungsvariablen auf der Administrator-Workstation fest, auf der govc bereits installiert ist. Falls noch nicht geschehen, laden Sie das govc-Tool herunter und installieren Sie es:

      export GOVC_URL=https://VCENTER_IP_ADDRESS_OR_FQDN
      export GOVC_USERNAME=VCENTER_USERNAME
      export GOVC_PASSWORD=VCENTER_PASSWORD
      export GOVC_TLS_CA_CERTS=FULL_PATH_OF_EXTRACTED_LIN_FILE
      export GOVC_INSECURE=false
      

      Ersetzen Sie Folgendes:

      • VCENTER_IP_ADDRESS_OR_FQDN: die IP-Adresse oder der FQDN des vCenter-Servers.

      • VCENTER_USERNAME: der Nutzername des vCenter-Servers.

      • VCENTER_PASSWORD: das Passwort für den angegebenen Nutzernamen.

      • FULL_PATH_OF_EXTRACTED_LIN_FILE: der vollständige Pfad zur Linux-Zertifikatsdatei, für die Sie einen Gültigkeitstest durchführen.

    2. Führen Sie den Befehl govc about aus, um zu prüfen, ob das vCenter-Zertifikat gültig ist:

      govc about
      

      Wenn das vCenter-Zertifikat gültig ist, gibt der Befehl govc about Details zum vCenter Server aus, die in etwa so aussehen:

      FullName: VMware vCenter Server 7.0.3 build-24322018
      Name: VMware vCenter Server
      Vendor: VMware, Inc.
      Version: 7.0.3
      Build: 24322018
      OS type: linux-x64
      API type: VirtualCenter
      API version: 7.0.3.0
      Product ID: vpx
      UUID: 475fa366-faa9-43f0-9417-e6dadc55514c
      

      Wenn das Zertifikat ungültig ist, sollte der Fehler x509 angezeigt werden. Wenn der Fehler x509 angezeigt wird, aktualisieren Sie die Umgebungsvariable GOVC_TLS_CA_CERTS so, dass sie auf eine andere Linux-Zertifikatsdatei im extrahierten Ordner ..../certs/lin verweist, und führen Sie dann den Befehl govc about noch einmal aus. Wiederholen Sie die Schritte a und b, bis Sie das gültige Zertifikat gefunden haben oder bis Sie alle Linux-Zertifikatsdateien im extrahierten Ordner ..../certs/lin getestet haben.

  3. Wenn Sie die alte vCenter-CA-Zertifikatsdatei sichern möchten, die sich im Pfad befindet, der im Feld vCenter.caCertPath der Konfigurationsdatei des Administratorclusters angegeben ist, benennen Sie sie in vcenter-ca-cert.pem.old um.

  4. Benennen Sie die neue gültige Zertifikatsdatei im Ordner ..../certs/lin in vcenter-ca-cert.pem um und verschieben Sie sie dann in den Pfad, der im Feld vCenter.caCertPath der Konfigurationsdatei des Administratorclusters angegeben ist.

  5. Wenn Sie Ihre Administrator-Workstation mit gkeadm erstellt haben, muss der vCenter.caCertPath in der Konfigurationsdatei der Administrator-Workstation denselben Pfad wie die Konfigurationsdatei des Administratorclusters haben.

Wenn Controlplane V2 für Ihre Nutzercluster aktiviert ist (was ab Version 1.32 erforderlich ist), aktualisieren Sie zuerst Ihre Nutzercluster und dann den Administratorcluster. Aktualisieren Sie bei Nutzerclustern, für die Controlplane V2 nicht aktiviert ist (auch als „Kubeception“ bezeichnet), zuerst den Administratorcluster und dann die Nutzercluster.

Steuerungsebene v2

  1. Legen Sie in jeder Nutzercluster-Konfigurationsdatei vCenter.caCertPath auf den Pfad Ihrer neuen vcenter-ca-cert.pem-Datei fest.

  2. Führen Sie für jeden Ihrer Nutzercluster den Befehl gkectl update aus:

    gkectl update cluster --config USER_CLUSTER_CONFIG --kubeconfig ADMIN_CLUSTER_KUBECONFIG

    Ersetzen Sie Folgendes:

    • USER_CLUSTER_CONFIG: der Pfad Ihrer Nutzercluster-Konfigurationsdatei.
    • ADMIN_CLUSTER_KUBECONFIG: der Pfad zur kubeconfig-Datei des Administratorclusters.

    Nachdem der Aktualisierungsbefehl für einen bestimmten Nutzercluster abgeschlossen ist, verwendet der Cluster das neue Zertifikat.

  3. Prüfen Sie, ob der Nutzercluster fehlerfrei ist:

    gkectl diagnose cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
      --cluster-name USER_CLUSTER_NAME
    

    Ersetzen Sie USER_CLUSTER_NAME durch den Namen Ihres Nutzerclusters.

    Weitere Informationen finden Sie unter Nutzercluster diagnostizieren.

  4. Aktualisieren Sie den Administratorcluster:

    gkectl update admin --config ADMIN_CLUSTER_CONFIG --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    

    Ersetzen Sie Folgendes:

    • ADMIN_CLUSTER_CONFIG: Pfad Ihrer Konfigurationsdatei für den Administratorcluster.
    • ADMIN_CLUSTER_KUBECONFIG: der Pfad zur kubeconfig-Datei des Administratorclusters.

    Nachdem der Aktualisierungsbefehl abgeschlossen ist, verwendet der Administratorcluster das neue Zertifikat.

  5. Prüfen Sie, ob der Administratorcluster fehlerfrei ist:

    gkectl diagnose cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    

    Weitere Informationen finden Sie unter Administratorcluster diagnostizieren.

Kubception

  1. Aktualisieren Sie den Administratorcluster:

    gkectl update admin --config ADMIN_CLUSTER_CONFIG --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    

    Ersetzen Sie Folgendes:

    • ADMIN_CLUSTER_CONFIG: Pfad Ihrer Konfigurationsdatei für den Administratorcluster.
    • ADMIN_CLUSTER_KUBECONFIG: der Pfad zur kubeconfig-Datei des Administratorclusters.

    Nachdem der Aktualisierungsbefehl abgeschlossen ist, verwendet der Administratorcluster das neue Zertifikat.

  2. Prüfen Sie, ob der Administratorcluster fehlerfrei ist:

    gkectl diagnose cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    

    Weitere Informationen finden Sie unter Administratorcluster diagnostizieren.

  3. Legen Sie in jeder Nutzercluster-Konfigurationsdatei vCenter.caCertPath auf den Pfad Ihrer neuen vcenter-ca-cert.pem-Datei fest.

  4. Führen Sie für jeden Ihrer Nutzercluster den Befehl gkectl update aus:

    gkectl update cluster --config USER_CLUSTER_CONFIG --kubeconfig ADMIN_CLUSTER_KUBECONFIG

    Ersetzen Sie Folgendes:

    • USER_CLUSTER_CONFIG: der Pfad Ihrer Nutzercluster-Konfigurationsdatei.
    • ADMIN_CLUSTER_KUBECONFIG: der Pfad zur kubeconfig-Datei des Administratorclusters.

    Nachdem der Aktualisierungsbefehl für einen bestimmten Nutzercluster abgeschlossen ist, verwendet der Cluster das neue Zertifikat.

  5. Prüfen Sie, ob der Nutzercluster fehlerfrei ist:

    gkectl diagnose cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
      --cluster-name USER_CLUSTER_NAME
    

    Ersetzen Sie USER_CLUSTER_NAME durch den Namen Ihres Nutzerclusters.

    Weitere Informationen finden Sie unter Nutzercluster diagnostizieren.