Konfigurationsdateien aus einem Cluster generieren

In diesem Dokument wird gezeigt, wie Sie einen Satz von Konfigurationsdateien aus einem vorhandenen Cluster generieren.

Eine Möglichkeit, einen Cluster zu erstellen, ist die Verwendung des gkectl-Befehlszeilentools. Zuerst erstellen Sie eine Reihe von Konfigurationsdateien für den Cluster. Führen Sie dann einen der folgenden Befehle aus:

• gkectl create admin zum Erstellen eines Administratorclusters
• gkectl create cluster, um einen Nutzercluster zu erstellen

Im Laufe der Zeit können Ihre ursprünglichen Konfigurationsdateien vom tatsächlichen Zustand Ihres Clusters abweichen. Wenn Sie beispielsweise einen Cluster durch Bearbeiten einer benutzerdefinierten Ressource aktualisieren, entsprechen Ihre ursprünglichen Konfigurationsdateien möglicherweise nicht mehr dem Cluster.

Eine weitere Möglichkeit, einen Cluster zu erstellen, ist die Verwendung der Google Cloud Console. In diesem Fall haben Sie keine Clusterkonfigurationsdateien. Später benötigen Sie möglicherweise Clusterkonfigurationsdateien, um bestimmte Aktualisierungen am Cluster vorzunehmen.

Wenn Sie vermuten, dass Ihre ursprünglichen Konfigurationsdateien nicht mit Ihrem Cluster synchron sind, oder wenn Sie keine Konfigurationsdateien haben, können Sie mit dem Befehl gkectl get-config einen neuen Satz von Konfigurationsdateien generieren, die den aktuellen Status des Clusters genau darstellen.

Sie können gkectl get-config mit Folgendem verwenden:

• Nutzercluster
• Administratorcluster

Hinweis: gkectl get-config unterstützt keine Cluster, die Topologiedomains verwenden. Diese Einschränkung gilt für einen Administratorcluster, für den infraConfigFilePath in der Konfigurationsdatei festgelegt ist, und für alle Nutzercluster, die vom Administratorcluster verwaltet werden. Wenn Sie gkectl get-config für diese Cluster ausführen, schlägt der Befehl fehl. Behalten Sie stattdessen die Konfigurationsdateien bei, die Sie zum Erstellen und Aktualisieren dieser Cluster verwenden, einschließlich der vSphere-Infrastrukturkonfigurationsdatei und der IP-Blockdateien.

Konfigurationsdateien generieren

So generieren Sie einen neuen Satz von Konfigurationsdateien für einen Nutzercluster:

gkectl get-config cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --cluster-name USER_CLUSTER_NAME

Ersetzen Sie Folgendes:

• ADMIN_CLUSTER_KUBECONFIG: der Pfad der kubeconfig-Datei für den Administratorcluster

• USER_CLUSTER_NAME: der Name des Nutzerclusters

So generieren Sie einen neuen Satz von Konfigurationsdateien für einen Administratorcluster:

gkectl get-config admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --bundle-path BUNDLE

Ersetzen Sie Folgendes:

• ADMIN_CLUSTER_KUBECONFIG ist die kubeconfig-Datei für den Administratorcluster

• BUNDLE: der Pfad der Google Distributed Cloud-Bundle-Datei. Die Bundle-Datei befindet sich auf Ihrer Administrator-Workstation, normalerweise unter /var/lib/gke/bundles/gke-onprem-vsphere-VERSION-full.tgz. Wenn Sie noch keine Bundle-Datei haben, können Sie eine herunterladen.

Standardmäßig werden die generierten Konfigurationsdateien in ein Unterverzeichnis des aktuellen Verzeichnisses geschrieben. Für einen Nutzercluster heißt das Ausgabeverzeichnis user-cluster-config-output. Bei einem Administratorcluster heißt das Ausgabeverzeichnis admin-cluster-config-output.

Wenn Sie die generierten Dateien in einem anderen Verzeichnis speichern möchten, können Sie mit dem Parameter --output-dir den Pfad eines Ausgabeverzeichnisses angeben. Beispiele:

gkectl get-config cluster --kubeconfig my-kubeconfig \
    --cluster-name my-cluster \
    --output-dir /home/me/configuration/generated-files

Wenn sich bereits Dateien im Standardausgabeverzeichnis oder in einem angegebenen Ausgabeverzeichnis befinden, müssen Sie das Flag --force einfügen, damit die neu generierten Dateien die vorhandenen Dateien ersetzen. Andernfalls schlägt der Befehl fehl. Beispiele:

gkectl get-config cluster --kubeconfig my-kubeconfig \
    --cluster-name my-cluster \
    --output-dir /home/me/configuration/generated-files
    --force

Generierte Dateien für einen Administratorcluster

Dateiname	Beschreibung
admin-cluster.yaml	Konfigurationsdatei für den Administratorcluster Immer generiert
admin-cluster-creds.yaml	Datei mit Cluster-Anmeldedaten Wird immer generiert
component-access-key.json	JSON-Schlüsseldatei für Ihr Dienstkonto für den Komponentenzugriff Wird immer generiert
vcenter-ca-cert.pem	Root-Zertifikat für Ihren vCenter-Server Wird immer generiert
admin-cluster-ipblock.yaml	IP-Blockdatei für Clusterknoten Wird generiert, wenn die Clusterknoten statische IP-Adressen verwenden
connect-register-key.json	JSON-Schlüsseldatei für Ihr Connect-Register-Dienstkonto Wird immer generiert
private-registry-ca.crt	Root-Zertifikat für Ihren privaten Registry-Server Wird generiert, wenn der Cluster eine private Registry verwendet
stackdriver-key.json	JSON-Schlüsseldatei für Ihr Logging-Monitoring-Dienstkonto Wird generiert, wenn der Cluster so konfiguriert ist, dass Logs und Messwerte nach Cloud Logging und Cloud Monitoring exportiert werden (Abschnitt stackdriver in der Cluster-Konfigurationsdatei)
audit-logging-key.json	JSON-Schlüsseldatei für Ihr Audit-Logging-Dienstkonto Wird generiert, wenn der Cluster Cloud-Audit-Logs verwendet

Generierte Dateien für einen Nutzercluster

Dateiname	Beschreibung
user-cluster.yaml	Konfigurationsdatei für den Nutzercluster Wird immer generiert
user-cluster-creds.yaml	Datei mit Cluster-Anmeldedaten Wird generiert, wenn der Cluster keine vorbereiteten Anmeldedaten verwendet
vcenter-ca-cert.pem	Root-Zertifikat für Ihren vCenter-Server Wird immer generiert
user-cluster-ipblock.yaml	IP-Blockdatei für Clusterknoten Wird generiert, wenn die Clusterknoten statische IP-Adressen verwenden
private-registry-ca.crt	Root-Zertifikat für Ihren privaten Registry-Server Wird generiert, wenn der Cluster eine private Registry verwendet
component-access-key.json	JSON-Schlüsseldatei für Ihr Dienstkonto für den Komponentenzugriff Wird generiert, wenn der Cluster keine private Registry verwendet
connect-register-key.json	JSON-Schlüsseldatei für Ihr Connect-Register-Dienstkonto Wird immer generiert
stackdriver-key.json	JSON-Schlüsseldatei für Ihr Logging-Monitoring-Dienstkonto Wird generiert, wenn der Cluster so konfiguriert ist, dass Logs und Messwerte nach Cloud Logging und Cloud Monitoring exportiert werden (Abschnitt stackdriver in der Cluster-Konfigurationsdatei)
audit-logging-key.json	JSON-Schlüsseldatei für Ihr Audit-Logging-Dienstkonto Wird generiert, wenn der Cluster Cloud-Audit-Logs verwendet
usage-metering-key.json	JSON-Schlüsseldatei für Ihr Dienstkonto zur Nutzungsmessung Wird generiert, wenn der Cluster Nutzungsdaten in einem BigQuery-Dataset speichert
secrets.yaml	Konfigurationsdatei für Secrets Wird generiert, wenn der Cluster vorbereitete Anmeldedaten verwendet. Damit diese Datei generiert wird, müssen Sie das Flag --export-secrets-config in den Befehl gkectl get-config cluster einfügen.
sni-cert.pem	Zusätzliches Bereitstellungszertifikat für den Kubernetes API-Server Wird generiert, wenn der Cluster für die Verwendung von Server Name Indication (SNI) konfiguriert ist
sni-key.json	Datei mit dem privaten Schlüssel für das zusätzliche Bereitstellungszertifikat Wird generiert, wenn der Cluster für die Verwendung von SNI konfiguriert ist