migctl-Referenz

migctl ist ein Befehlszeilentool zum Einrichten und Verwalten einer Migrate to Containers-Migrationsumgebung in Google Cloud:

• Wenn Sie in Google Cloud einen Verarbeitungscluster für Google Kubernetes Engine (GKE) oder Anthos verwenden, führen Sie in Cloud Shell migctl aus.

• Wenn Sie einen GKE-Verarbeitungscluster verwenden, können Sie migctl auf Ihrer Administrator-Workstation installieren und ausführen, wie unter Migrate to Containers installieren beschrieben.

Eine schrittweise Einführung in wichtige migctl-Befehle und eine einfache Migration finden Sie in der Kurzanleitung.

Hinweis: In Version 1.4 wird standardmäßig zu Migrate to Containers installiert und Migrationen im Namespace v2k-system ausgeführt. In der vorherigen Version konnten Sie den Namespace festlegen.

migctl

Befehl	Beschreibung
artifacts-repo	Artefakt-Repository konfigurieren
completion	Bash-Vervollständigungsskripts generieren
debug	Befehle zur Fehlerbehebung
Fehlererfassung-Info	Sysreport-Skript collect_sysreport.sh herunterladen
docker-registry	Docker-Registry konfigurieren
doctor	Den Status der Migration to Containers und die zugehörige Konfiguration prüfen
help	Hilfe zu jedem Befehl
Logging	Logging konfigurieren
migration	Migrationsvorgänge
setup	Migrate to Containers installieren oder deinstallieren
source	Verweise auf die Migrationsquelle verwalten
version	Version für Migrate to Containers und für migctl drucken

Zusammenfassung

migctl [-h]

Flags

-h, --help

Hilfe zu diesem Befehl.

Hinweise

migctl ist in Cloud Shell enthalten.

migctl artifacts-repo

Befehl	Beschreibung
migctl artifacts-repo create	Erstellen Sie eine Artefakte-Repository-Konfiguration.
migctl artifacts-repo update	Aktualisiert eine Repository-Konfiguration für Artefakte
migctl artifacts-repo delete	Löschen Sie eine Repository-Konfiguration für Artefakte.
migctl artifacts-repo list	Die Repository-Konfigurationen für Artefakte auflisten
migctl artifacts-repo set-default	Standard-Artefakte-Repository-konfiguration festlegen.

Weitere Informationen

Daten-Repositories definieren

migctl artifacts-repo create

Erstellen Sie eine Artefakte-Repository-Konfiguration.

Zusammenfassung

migctl artifacts-repo create gcs|s3|basic-auth repository-name flags

Positionsargumente

repository-name

Name der Repository-Konfiguration für Artefakte.

Flags

-h, --help

Hilfe zu diesem Befehl.

Die übrigen Flags basieren auf dem Registry-Typ:

• Cloud Storage

  migctl artifacts-repo create gcs repository-name --bucket-name bucket-name  --json-key=m4a-install.json

  wobei

  • repository-name ist der benutzerdefinierte Name der Repository-Konfiguration für Artefakte.

  • bucket-name gibt einen vorhandenen Bucket im Cloud Storage-Repository an. Wenn Sie noch keinen Bucket haben, erstellen Sie einen anhand der Anleitung unter Buckets erstellen.

    Hinweis: Wenn Sie Migrate to Containers in Clustern in Google Cloud installieren, erstellt das Migrate to Containers-Installationsprogramm automatisch einen Standard-Bucket mit dem Namen:

    PROJECT-migration-artifacts

  • m4a-install.json ist der Name der JSON-Schlüsseldatei für das Dienstkonto für den Zugriff auf Container Registry und Cloud Storage, wie unter Dienstkonto konfigurieren beschrieben.

• S3

  migctl artifacts-repo create s3 repository-name --bucket-name bucket-name --region aws-region --access-key-id=key-id

  Sie werden aufgefordert, den geheimen Schlüssel für key-id einzugeben.

  Alternativ können Sie den Pfad zu einer Datei mit Anmeldedaten angeben:

  migctl artifacts-repo create s3 repository-name --bucket-name bucket-name --region aws-region --credentials-file-path file-path 

  Dabei gilt:

  • repository-name ist der benutzerdefinierte Name der Repository-Konfiguration für Artefakte.

  • bucket-name gibt einen vorhandenen Bucket im S3-Repository an. Wenn Sie keinen vorhandenen Bucket haben, erstellen Sie einen. Folgen Sie dazu der Anleitung unter Mit Amazon S3-Buckets arbeiten.

  • aws-region gibt die AWS-Region für das Repository an. Der Verarbeitungscluster und das Repository können sich in separaten Regionen befinden, solange der Cluster berechtigt ist, auf das Repository zuzugreifen.

  • key-id gibt den Zugriffsschlüssel an. Weitere Informationen finden Sie unter Zugriffsschlüssel für IAM-Nutzer verwalten.

  • file-path gibt den Pfad zu einer CSV-Datei an, die von der AWS-Konsole heruntergeladen wird und die Anmeldedaten enthält.

Beispiele

• Cloud Storage

  migctl artifacts-repo create gcs myRepository --json-key=m4a-install.json

• S3

  migctl artifacts-repo create s3 myRepository --bucket-name bucket-name --region aws-region --access-key-id=key-id

migctl artifacts-repo update

Aktualisiert eine Repository-Konfiguration für Artefakte

Zusammenfassung

migctl artifacts-repo update gcs|s3|basic-auth repository-name same-flags-as-create

Positionsargumente

repository-name

Name der Repository-Konfiguration für Artefakte.

Flags

same-flags-as-create

Geben Sie dieselben Flags zum Aktualisieren der Registry-Konfiguration an, wie Sie zuvor zum Erstellen verwendet haben, wie in migctl artifacts-repo create gezeigt.

migctl artifacts-repo delete

Löschen Sie eine Repository-Konfiguration für Artefakte.

Zusammenfassung

migctl artifacts-repo delete repository-name

Positionsargumente

repository-name

Name der Repository-Konfiguration für Artefakte.

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl artifacts-repo list

Die aktuell konfigurierten Repositories auflisten, einschließlich des aktuellen Standard

Zusammenfassung

migctl artifacts-repo list

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl artifacts-repo set-default

Legt das Standard-Artefakt-Repository fest, also das aktive Registry verwendet vom Verarbeitungscluster.

Zusammenfassung

migctl artifacts-repo set-default repository-name

Positionsargumente

repository-name

Name der Repository-Konfiguration für Artefakte.

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl completion

Bash-Vervollständigungsskripts generieren

Führen Sie . <(migctl completion bash) aus, um die Vervollständigung zu laden.

Wenn Sie die Bash-Shell so konfigurieren möchten, dass Vervollständigungen für jede Sitzung geladen werden, fügen Sie Folgendes zu "~/.bashrc" oder "~/.profile" hinzu: . <(migctl completion bash).

Zusammenfassung

migctl completion {bash | zsh}

Positionsargumente

{bash | zsh}

Die zu verwendende Shell

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl debug

Befehl	Beschreibung
migctl debug Release-m4ce-vm	Geben Sie eine Migration zu einer VM V4-VM frei.
migctl debug collect-info	Laden Sie das Sysreport-Skript collect_sysreport.sh herunter.

migctl debug Release-m4ce-vm

Geben Sie eine Migration zu einer VM V4-VM frei, die nach der Migration möglicherweise nicht mehr reagiert.

Zusammenfassung

migctl debug release-m4ce-vm -i VM_NAME -s SOURCE_PROVIDER_NAME

Flags

-h, --help

Hilfe zu diesem Befehl

-i, --instance

ID der Quell-VM-Instanz.

-s, --source

Name der Quelle, die mit migctl source create erstellt wurde

migctl debug collect-info

Laden Sie das Sysreport-Skript collect_sysreport.sh herunter. Sie können dann das Skript ausführen, um Informationen zu erfassen, die das Supportteam zur Lösung Ihres Problems verwendet.

Mit diesem Befehl wird das Skript in /tmp/sysreportINDEX/collect_sysreport.sh heruntergeladen, wobei INDEX ein zufälliges Suffix wird, das beim Erstellen des temporären Verzeichnisses zugewiesen wird.

Zusammenfassung

migctl debug collect-info

Flags

-h, --help

Hilfe zu diesem Befehl.

Weitere Informationen

Support personalisieren

Beispiele

Laden Sie Sysreport collect_sysreport.sh herunter:

migctl debug collect-info
Saved /tmp/sysreportINDEX/collect_sysreport.sh, please run it manually to collect sysreport

So führen Sie das Skript aus:

1. Wechseln Sie in das Verzeichnis /tmp/sysreportINDEX:

   cd /tmp/sysreportINDEX

2. Führen Sie das Skript collect_sysreport.sh aus:

   ./collect_sysreport.sh [-n NAMESPACE] [-o OUTPUT_DIRECTORY] [-m MIGRATION]

Weitere Informationen zum Ausführen des Skripts finden Sie unter Unterstützung personalisieren.

migctl docker-registry

Befehl	Beschreibung
migctl docker-registry create	Docker-Registry-Konfiguration erstellen
migctl docker-registry update	Docker-Registry-Konfiguration aktualisieren
migctl docker-registry delete	Löschen Sie eine artDocker-Registry-Konfiguration.
mmigctl docker-registry list	Docker-Registry-Konfigurationen auflisten
migctl docker-registry set-default	Legen Sie die Standard-Docker-Registry-konfiguration fest.

Weitere Informationen

Daten-Repositories definieren

migctl docker-registry create

Docker-Registry-Konfiguration erstellen

Zusammenfassung

migctl docker-registry create gcr|basic-auth registry-name flags

Positionsargumente

registry-name

Docker-Registry-Konfiguration benennen

Flags

-h, --help

Hilfe zu diesem Befehl.

Die übrigen Flags basieren auf dem Registry-Typ:

• GCR

  migctl docker-registry create gcr registry-name --project project-id --json-key=m4a-install.json

  Dabei gilt:

  • registry-name ist der benutzerdefinierte Name der Docker-Registry-Konfiguration.

  • project-id ist Ihre Google-Projekt-ID.

  • m4a-install.json ist der Name der JSON-Schlüsseldatei für das Dienstkonto. Sie wird für den Zugriff auf Container Registry und Cloud Storage verwendet, wie unter Dienstkonto konfigurieren beschrieben.

• Docker-Registry

  migctl docker-registry create basic-auth registry-name --registry-path url --username username --ca-pem-file ca-pem-filename

  Dabei gilt:

  • registry-name ist der benutzerdefinierte Name der Docker-Registry-Konfiguration.

  • url gibt die URL des Registry-Pfads ohne das Präfix http:// oder https:// an. Beispiel: localhost:8080/myregistry

  • username für die grundlegenden Anmeldedaten zur Authentifizierung der Registry Sie werden aufgefordert, das Passwort einzugeben.

  • Wenn die Registry ein selbst signiertes Zertifikat verwendet, gibt ca-pem-filename eine PEM-Datei an, die entweder den öffentlichen Schlüssel oder die vollständige CA-Kette enthält. Dies umfasst die Verkettung der Zwischen-CA-Zertifikate bis zum Root-Zertifikat. Beispiel:

    cat int1.pem int2.pem ... root.pem

Beispiele

• GCR

  migctl docker-registry create gcr my-registry --project myproject --json-key=m4a-install.json

• Docker-Registry

  migctl docker-registry create basic-auth my-registry --registry-path myexample.com/registry --username user1 --password pass1

  Wenn die Registry ein selbst signiertes Zertifikat verwendet:

  migctl docker-registry create basic-auth my-registry --registry-path myexample.com/registry --username user1 --password pass1 --ca-pem-file cert.pem

migctl docker-registry update

Docker-Registry-Konfiguration aktualisieren

Zusammenfassung

migctl docker-registry update gcr|basic-auth registry-name same-flags-as-create

Positionsargumente

registry-name

Docker-Registry-Konfiguration benennen

Flags

same-flags-as-create

Geben Sie dieselben Flags zum Aktualisieren der Registry-Konfiguration an, wie Sie zuvor zum Erstellen verwendet haben, wie in migctl docker-registry create gezeigt.

migctl docker-registry delete

Docker Registry-Konfiguration löschen

Zusammenfassung

migctl docker-registry delete registry-name

Positionsargumente

registry-name

Docker-Registry-Konfiguration benennen

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl docker-registry list

Die aktuell konfigurierten Docker-Registrys auflisten, einschließlich des aktuellen Standards.

Zusammenfassung

migctl docker-registry list

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl docker-registry set-default

Legt die Standard-Docker-Registry fest, d. h. die aktive Registry, die vom Verarbeitungscluster verwendet wird.

Zusammenfassung

migctl docker-registry set-default registry-name

Positionsargumente

registry-name

Docker-Registry-Konfiguration benennen

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl doctor

Prüfen Sie den Status der Migration to Containers und die zugehörige Konfiguration.

Zusammenfassung

migctl doctor

Flags

-h, --help

Hilfe zu diesem Befehl.

Weitere Informationen

Migrate to Containers installieren

Beispiele

Antwort auf eine funktionierende Bereitstellung von Migrate for Container.

migctl doctor
[✓] Deployment

migctl help

Hilfe zum migctl-Tool

Verwenden Sie "migctl [Befehl] --help", um weitere Informationen zu einem Befehl zu erhalten.

Zusammenfassung

migctl --help

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl-Logging

Befehl	Beschreibung
Ausführlichkeit der migctl-Logging-Einstellung	Legen Sie die Logging-Ausführlichkeit im Back-End fest.

Ausführlichkeit der migctl-Logging-Einstellung

Legen Sie die Logging-Ausführlichkeit des Back-Ends mit einer nicht negativen Ganzzahl fest.

• Legen Sie die Ebene auf 0 fest, um nur Informationslogs anzuzeigen.
• Legen Sie die Ebene auf 1 oder höher fest, um auch Logs zur Fehlerbehebung anzuzeigen.

Zusammenfassung

migctl logging set-verbosity LEVEL [flags]

Beispiele

Legen Sie die Ausführlichkeitsstufe fest, um nur Informationslogs anzuzeigen.

migctl logging set-verbosity 0

Legen Sie die Ausführlichkeitsstufe fest, um die meisten Debug-Logs anzuzeigen.

migctl logging set-verbosity 1

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl migration

Befehl	Beschreibung
migration create	Einen Migrationsplan erstellen
migration delete	Einen Migrationsplan löschen
migration generate-artifacts	Artefakte für eine bestimmte Migration erstellen
migration get	Eine Spezifikation für den Migrationsplan abrufen
migration get-artifacts	Artefakte für die Migration abrufen, z. B. YAML und Dockerfile für Deployment/StatefulSet-Spezifikation
migration list	Migrationen auflisten
migration list-types	Verfügbare Migrationstypen auflisten
migration status	Status des Migrationsplans abrufen
migration update	Migrationsplan aktualisieren

migctl migration create

Einen Migrationsplan erstellen

Ein Migrationsplan definiert die Details der Migration, darunter die Quellplattform, die VM-ID, den Projektnamen usw.

Die erzeugte Migrationsplandatei wird auf die Maschine kopiert, auf der der Befehl ausgeführt wird. Sie wird nicht auf den Verarbeitungscluster angewendet. Bei Bedarf können Sie die Datei vor der Nutzung bei der Migration bearbeiten.

Zusammenfassung

migctl migration create migration-name --source source-name --vm-id source-vm-id --type type [flags]

Positionsargumente

migration-name

Name für diese Migration

Flags

-r, --artifacts-repository string

Artefakt-Repository zum Speichern der Artefakte.

-h, --help

Hilfe zu „create“

--image-repository string

Image-Repository, in das Images hochgeladen werden sollen, für Migrationen, die Images hochladen

-l, --labels strings --labels=[KEY=VALUE,…]

Liste der hinzuzufügenden KEY=VALUE-Labelpaare. Schlüssel müssen mit einem Kleinbuchstaben beginnen und dürfen nur Bindestriche (-), Unterstriche (_), Kleinbuchstaben und Ziffern enthalten. Werte dürfen nur Bindestriche (-), Unterstriche (_), Kleinbuchstaben und Ziffern enthalten.

-p, --parameters strings --parameters=[KEY=VALUE,…]

Liste der KEY=VALUE-Labelpaare, die hinzugefügt werden sollen

-s, --source string

Name der Quelle

-t, --type string

Die Art der Migration

-v, --vm-id string

Quell-VM-ID

Beispiele

Einen Migrationsplan für die Containerisierung einer Linux-VM erstellen.

migctl migration create my-migration-1 --source my-source --vm-id my-id --type linux-system-container

Einen Migrationsplan für eine VM erstellen, auf der eine Tomcat-Anwendungskomponente ausgeführt wird.

migctl migration create my-migration-1 --source my-source --vm-id my-id --type tomcat-container

Weitere Informationen

Migration erstellen

migctl migration delete

Einen Migrationsplan löschen

Mit diesem Befehl wird eine mit migctl migration create erstellte Migration gelöscht.

Zusammenfassung

migctl migration delete migration-name

Positionsargumente

migration-name

Name der zu löschenden Migration.

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl migration generate-artifacts

Artefakte für eine bestimmte Migration erstellen

Mit diesem Befehl erstellen Sie beispielsweise ein Image, ein Daten-Volume, ein Dockerfile, eine Deployment-YAML usw.

Zusammenfassung

migctl migration generate-artifacts migration-name

Positionsargumente

migration-name

Name der Migration, für die Artefakte erstellt werden sollen

Flags

-h, --help

Hilfe zu diesem Befehl.

Weitere Informationen

Migration ausführen

migctl migration get

Eine Spezifikation für den Migrationsplan abrufen

Zusammenfassung

migctl migration get migration-name  [--output-file migration-yaml-file]

Positionsargumente

migration-name

Name der Migration, deren Plan abgerufen werden soll

Flags

--output-file migration-yaml-file

YAML-Ausgabedatei der Spezifikation zum Migrationsplan

-r, --overwrite

Vorhandene YAML-Ausgabedatei(n) der Spezifikation zum Migrationsplan überschreiben.

-h, --help

Hilfe zu diesem Befehl.

migctl migration get-artifacts

Artefakte für die Migration abrufen, z. B. YAML und Dockerfile für Deployment/StatefulSet-Spezifikation

Zusammenfassung

migctl migration get-artifacts migration-name [--output-directory directory-path] [--overwrite]

Positionsargumente

migration-name

Die Migration, für die Artefakte abgerufen werden sollen

Flags

--output-directory directory-path

Pfad des Ausgabeverzeichnisses. Der Standardwert lautet "."

--overwrite

Vorhandene lokale Dateien überschreiben

-h, --help

Hilfe zu diesem Befehl.

Weitere Informationen

Generierte Bereitstellungsdateien prüfen

migctl migration list

Migrationen auflisten

Zusammenfassung

migctl migration list [--all-namespaces]

Flags

-A, --all-namespaces

Migrationen für alle Namespaces auflisten

-h, --help

Hilfe zu diesem Befehl.

Weitere Informationen

Migration überwachen

migctl migration list-types

Verfügbare Migrationstypen auflisten

Zusammenfassung

migctl migration list-types [flags]

Flags

-h, --help

Hilfe zu „list-types“.

Weitere Informationen

Migration überwachen

migctl migration status

Status des Migrationsplans abrufen

Zusammenfassung

migctl migration status migration-name  [--verbose]

Positionsargumente

migration-name

Name der Migration, für die der Status abgerufen werden soll

Flags

-v, --verbose

Ausführlicher Status

-h, --help

Hilfe zu diesem Befehl.

Weitere Informationen

Migration überwachen

migctl migration update

Eine Migrationsspezifikation aktualisieren.

Hinweis: Zum Ausführen dieses Befehls müssen Sie mindestens eines der beiden folgenden Flags angeben.

Zusammenfassung

migctl migration update migration-name --main-config migration-spec.yaml --data-config data-spec.yaml

Positionsargumente

migration-name

Name der zu aktualisierenden Migration

Flags

--main-config migration-spec.yaml

YAML-Datei mit der aktualisierten Spezifikation des Migrationsplans.

--data-config data-spec.yaml

YAML-Datei mit der aktualisierten Datenkonfigurationsspezifikation.

-h, --help

Hilfe zu diesem Befehl.

Weitere Informationen

• Daten migrieren
• Migrationsvorgänge

migctl setup

Befehl	Beschreibung
setup install	Installieren Sie Migrate to Containers auf dem aktuellen Cluster.
setup uninstall	Deinstallieren Sie Migrate to Containers aus einem Cluster.
setup upgrade	Führen Sie ein Upgrade auf Migrate to Containers für einen Cluster durch.
setup proxy	Konfigurieren Sie einen HTTP-Proxy, der von Migrate to Containers verwendet wird.

migctl setup install

Installieren Sie Migrate to Containers auf dem aktuellen Cluster.

Hinweis: Zur Ausführung der Installations- oder Deinstallationsbefehle mit migctl sollten Sie Administratorberechtigungen für den Cluster haben, auf dem Sie die Installation durchführen.

Zusammenfassung

migctl setup install [--runtime] [--json-key service-account-json] [--node-selectors string] [--tolerations string] [--version version-number]

Flags

--runtime

Laufzeitunterstützung auf Arbeitslastclustern mit Container-Optimized OS-Knoten installieren

--json-key service-account-json

JSON-Schlüsseldatei für das Dienstkonto mit den erforderlichen Berechtigungen zur Installation von Migrate to Containers. Weitere Informationen finden Sie unter Dienstkonto für eine Migration erstellen.

--node-selectors string

Knotenauswahl für die von Migrate to Containers bereitgestellten Komponenten im Format LABEL1=VALUE1,LABEL2=VALUE2,..... Weitere Informationen finden Sie unter Installationsoptionen.

--tolerations string

Toleranzen für die von Migrate to Containers bereitgestellten Komponenten im Format KEY1=VALUE1:EFFECT1,KEY2=VALUE2:EFFECT2,..... Weitere Informationen finden Sie unter Installationsoptionen.

--version version-number

Zu installierende Migrate to Containers-Version (Standardeinstellung ist „1.50.0“).

-h, --help

Hilfe zu diesem Befehl.

Beispiele

Installieren Sie Migrate for Containers auf einem Verarbeitungscluster.

migctl setup install

Laufzeitunterstützung auf Arbeitslastclustern mit COS-Knoten installieren

migctl setup install --runtime

Weitere Informationen

Migrate to Containers installieren

migctl setup uninstall

Deinstallieren Sie Migrate to Containers aus einem Cluster.

Hinweis: Zur Ausführung der Installations- oder Deinstallationsbefehle mit migctl sollten Sie Administratorberechtigungen für den Cluster haben, auf dem Sie die Deinstallation durchführen.

Zusammenfassung

migctl setup uninstall [-f]

Flags

-f

Deinstallation während der Migration erzwingen

-h, --help

Hilfe zu diesem Befehl.

Beispiele

Deinstallieren Sie Migrate to Containers

migctl setup uninstall

Erzwingen Sie die Deinstallation von Migrate for Container während der Migration.

migctl setup uninstall --force

Weitere Informationen

Migrate to Containers deinstallieren

migctl setup upgrade

Führen Sie ein Upgrade auf Migrate to Containers für einen Cluster durch.

Hinweis: Zum Ausführen der Upgrade-Befehle mit migctl sollten Sie Administratorberechtigungen für den Cluster haben, von dem Sie deinstallieren.

Zusammenfassung

migctl setup upgrade

Flags

--runtime

Laufzeitunterstützung auf Arbeitslastclustern mit COS-Knoten installieren

-f, --force

Wenn sich Migrationen in einem Fehlerzustand befinden, erstellen Sie sie als Teil des Upgrades neu, um zu sehen, ob sie abgeschlossen werden können.

--gcp-project string

Google Cloud-Projekt zum Hochladen in Container Registry und Cloud Storage

--gcp-region string

Google Cloud-Region zum Hochladen in Cloud Storage

--json-key string

JSON-Schlüssel für das Dienstkonto, das zum Hochladen in Container Registry und Cloud Storage verwendet wird

--node-selectors string

node-selector für die von Migrate to Containers bereitgestellten Komponenten im Format LABEL1=VALUE1,LABEL2=VALUE2,...

--skip-validation

Validierung des Cluster-Deployments überschreiben

--tolerations string

Toleranzen für die von Migrate to Containers bereitgestellten Komponenten im Format KEY1=VALUE1:EFFECT1,KEY2=VALUE2:EFFECT2,...

--version string

Zu installierende Migrate to Containers-Version (Standardeinstellung ist „1.50.0“).

-h, --help

Hilfe zu diesem Befehl.

Beispiele

Führen Sie ein Upgrade von Migrate to Containers auf die aktuelle Version durch.

migctl setup upgrade

Führen Sie ein Upgrade von Migrate to Containers auf eine bestimmte Version durch.

migctl setup upgrade --version 1.15.0

Weitere Informationen

Upgrade von Migrate to Containers durchführen

migctl setup proxy

Konfigurieren Sie einen Proxyserver für den Zugriff auf Repositories für Migrate to Containers. Migrate to Containers unterstützt nur Proxyanfragen über HTTPS. HTTP wird nicht unterstützt.

Bei Verwendung eines HTTPS-Proxys unterstützt Migrate to Containers keine selbst signierten Zertifikate. Sie müssen ein signiertes Zertifikat mit einem HTTPS-Proxy verwenden.

Zusammenfassung

migctl setup proxy --https-proxy proxy-address
    [--proxy-basic-authentication] [--no-proxy address] [--remove]

Flags

--https-proxy proxy-address

Geben Sie die IP- oder Proxyserver-Adresse an, die zum Weiterleiten von Anfragen verwendet wird, ohne das Präfix https://. Wenn Ihr Proxy die Basisauthentifizierung verwendet, können Sie den Nutzernamen und das Passwort in proxy-address angeben. Beispiel:

user:password@proxy-address

Alternativ können Sie die Option --proxy-basic-authentication verwenden, um diese Werte interaktiv in der Console anzugeben.

--no-proxy address

Geben Sie eine optionale Liste von durch Kommas getrennten IP-Adressen oder Domains an, für die der Proxy nicht verwendet wird.

--remove

Entfernen Sie die Proxykonfiguration.

--proxy-basic-authentication

Wenn der Proxy eine Authentifizierung erfordert, verwenden Sie diese Option, um den Nutzernamen und das Passwort interaktiv anzugeben. Sie werden dann aufgefordert, den Nutzernamen und das Passwort einzugeben, die für den Zugriff auf den Proxy erforderlich sind, wenn Sie den Befehl eingeben. Alternativ haben Sie die Möglichkeit, diese Werte mit der Option --https-proxy als Teil von proxy-address anzugeben.

--h, --help

Hilfe zu diesem Befehl.

Beispiele

So konfigurieren Sie einen HTTPS-Proxy ohne Authentifizierung:

migctl setup proxy --https-proxy myproxy.com

So konfigurieren Sie einen HTTPS-Proxy und geben die Domains an, in denen der Proxy nicht verwendet wird:

migctl setup proxy --https-proxy myproxy.com --no-proxy localhost,mydomain.com

Wenn der Proxy die Basisauthentifizierung verwendet:

migctl setup proxy --https-proxy myproxy.com --proxy-basic-authentication

Sie werden aufgefordert, den Nutzernamen und das Passwort einzugeben.

Sie können die Anmeldedaten auch als Teil der Proxy-Adresse eingeben:

migctl setup proxy --https-proxy user:[e-mail]

So entfernen Sie die Proxy-Konfiguration:

migctl setup proxy --remove 

Weitere Informationen

HTTPS-Proxy konfigurieren

migctl source

Vorgänge für eine Migrationsquelle ausführen

Befehl	Beschreibung
source create	Dem Verarbeitungscluster eine Migrationsquelle hinzufügen
source delete	Eine Migrationsquelle aus dem Verarbeitungscluster löschen
source list	Konfigurationen der Migrationsquellen im Verarbeitungscluster auflisten
Quellstatus	Migrationsquellenstatus im Verarbeitungscluster abrufen

migctl source create

Dem Verarbeitungscluster eine Migrationsquelle hinzufügen

Befehl	Beschreibung
Quelle erstellen Compute Engine	Compute Engine als Migrationsquelle hinzufügen
source create local-vmware	Fügen Sie dem Verarbeitungscluster VMware als Migrationsquelle hinzu.
source create m2vm	Dem Verarbeitungscluster Migrate to Virtual Machines als Migrationsquelle hinzufügen

Weitere Informationen

Migrationsquelle hinzufügen

migctl source create-engine

Dem Verarbeitungscluster Compute Engine als Migrationsquelle hinzufügen

Zusammenfassung

migctl source create compute-engine name --project project [--json-key service-account-json ]

Positionsargumente

name

Ein Name für die Quelle

Flags

--project project

Standardprojekt für den Compute Engine-Quelltyp

--json-key service-account-json

JSON-Schlüsseldatei für das Dienstkonto, das zum Erstellen der Compute Engine-Quelle verwendet wurde. Weitere Informationen finden Sie unter Dienstkonto für die Verwendung von Compute Engine als Migrationsquelle erstellen.

-h, --help

Hilfe zu diesem Befehl.

Beispiele

Compute Engine als Migrationsquelle hinzufügen

migctl source create compute-engine my-ce-src --project myproject --zone us-west1-a

Weitere Informationen

Migrationsquelle hinzufügen

migctl source create local-vmware

Dem Verarbeitungscluster VMware als Migrationsquelle hinzufügen

Zusammenfassung

migctl source create local-vmware name --vc vcenter --user user [flags]

Positionsargumente

name

Ein Name für die Quelle

Flags

--dc datacenter

--vc host

Gibt den vCenter-DNS-Namen oder die vCenter-IP-Adresse an.

--username user

Der Nutzername für einen Nutzer, der berechtigt ist, auf vCenter zuzugreifen. Sie werden aufgefordert, das Nutzerpasswort einzugeben.

-h, --help

Hilfe zu diesem Befehl.

Beispiele

VMware als Migrationsquelle hinzufügen

migctl source create local-vmware local-vmware-src --vc '1.2.3.4' --username 'admin'

Weitere Informationen

Migrationsquelle hinzufügen

migctl source create m2vm

Dem Verarbeitungscluster Migrate to Virtual Machines als Migrationsquelle hinzufügen

Zusammenfassung

migctl source create m2vm name --project m2vm-service-project
--json-key path --location m2vm-service-location --m2vm-source m2vm-service-source
[ --target-project target-project ][ --target-json-key path ] [ --target-zone target-zone ]
[ --target-network target-network ] [ --target-subnet target-subnet ] [flags]

Positionsargumente

name

Ein Name für die Quelle

Flags

-h, --help

Hilfe zu „m2vm“.

--json-key string

Pfad für den JSON-Schlüssel eines Dienstkontos, der für das Migrate to Virtual Machines-Projekt verwendet wird. Weitere Informationen finden Sie unter Migrate to Virtual Machines als Migrationsquelle verwenden.

--location string

Der Speicherort des Migrate to Virtual Machines-Dienstes, z. B. us-central1.

--m2vm-source string

Der Name der Migrate to Virtual Machines-Quelle.

--project string

Projekt "Migrate to Virtual Machines".

--target-json-key string

Pfad für den JSON-Schlüssel eines Dienstkontos, der für das Zielprojekt verwendet wird. Wenn Sie das Feld leer lassen, ist dies mit dem JSON-Schlüssel für Migrate to Virtual Machines identisch.

--target-network string

Das Zielnetzwerk für Klon-VM-Bereitstellungen.

--target-project string

Das Zielprojekt für Klon-VM-Bereitstellungen. Wenn es leer bleibt, ist dies mit dem Migrate to Virtual Machines-Projekt identisch.

--target-subnet string

Das Zielsubnetz für Klon-VM-Bereitstellungen.

--target-zone string

Die Zielzone für Klon-VM-Bereitstellungen.

Beispiele

Migrate to Virtual Machines als Migrationsquelle hinzufügen

migctl source create m2vm name --project m2vm-service-project --json-key m2vm-service-sa.json --location m2vm-service-location --m2vm-source m2vm-service-source

Weitere Informationen

Migrationsquelle hinzufügen

migctl source delete

Eine Migrationsquelle aus dem Verarbeitungscluster löschen

Zusammenfassung

migctl source delete source-name [-f]

Positionsargumente

source-name

Der Name der zu löschenden Quelle, also der Name, den Sie beim Erstellen der Quelle mit migctl source create angegeben haben.

Flags

-f

Fehler ignorieren und Löschen erzwingen

-h, --help

Hilfe zu diesem Befehl.

Beispiele

Migrationsquelle löschen

migctl source delete my-source

Versuchen Sie, das Löschen einer Quelle zu erzwingen.

migctl source delete my-source -f

migctl source list

Konfigurationen der Migrationsquellen im Verarbeitungscluster auflisten

Zusammenfassung

migctl source list

Flags

-h, --help

Hilfe zu diesem Befehl.

migctl source status

Migrationsquellenstatus im Verarbeitungscluster abrufen

Zusammenfassung

migctl source status 

Flags

-h, --help

Hilfe zu diesem Befehl

-v, --verbose

Ausführliche Ausgabe für diesen Befehl

migctl version

Drücken Sie die Version für Migrate to Containers und für migctl aus.

Zusammenfassung

migctl version

Flags

-h, --help

Hilfe zu diesem Befehl.