Konfigurationsdateien aus einem Cluster generieren

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

Eine Möglichkeit zum Erstellen eines Clusters ist das gkectl-Befehlszeilentool. Zuerst erstellen Sie eine Reihe von Konfigurationsdateien für den Cluster. Führen Sie dann einen der folgenden Befehle aus:

• gkectl create admin, um einen Administratorcluster zu erstellen
• gkectl create cluster, um einen Nutzercluster zu erstellen

Im Laufe der Zeit sind Ihre ursprünglichen Konfigurationsdateien möglicherweise nicht mehr mit dem tatsächlichen Status Ihres Clusters synchronisiert. Wenn Sie beispielsweise einen Cluster aktualisieren, indem Sie eine benutzerdefinierte Ressource bearbeiten, sind Ihre ursprünglichen Konfigurationsdateien möglicherweise nicht genau.

Sie können einen Cluster auch mit der Google Cloud Console erstellen. In diesem Fall gibt es keine Clusterkonfigurationsdateien. Später benötigen Sie möglicherweise Clusterkonfigurationsdateien, um bestimmte Updates am Cluster vorzunehmen.

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

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

• Nutzercluster
• Administratorcluster

Konfigurationsdateien generieren

So generieren Sie neue 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 neue 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 zur Google Distributed Cloud-Bundledatei. 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. Bei einem 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 zu einem Ausgabeverzeichnis angeben. Beispiele:

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

Wenn sich im Standardausgabeverzeichnis oder in einem angegebenen Ausgabeverzeichnis bereits Dateien befinden, müssen Sie das Flag --force angeben, 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

Generierte Dateien für einen Nutzercluster