Migrate to Containers CLI Referenz für Linux

m2c ist ein Befehlszeilentool, mit dem Sie Migrationen auf Ihrem lokalen Computer einrichten und ausführen können.

m2c

Eine Befehlszeile für Migrate to Containers.

Führen Sie eine schnelle Modernisierung für Ihre Arbeitslast mit einem vierstufigen Prozess durch:

1. Kopieren Sie das Dateisystem lokal von der Quellmaschine.

2. Analysieren Sie das Dateisystem, um einen Modernisierungsplan zu erstellen.

3. Bearbeiten Sie den Plan, um Modernisierungsartefakte anzupassen.

4. Generieren Sie die Modernisierungsartefakte.

Zusammenfassung

m2c COMMAND [options]

Flags

-q,--quiet

Nichts ausgeben

-v,--verbose

Detaillierte Ausgabe anzeigen

Befehle

Befehl	Beschreibung
m2c analyze	Arbeitslastkonfiguration im angegebenen Dateisystem analysieren
m2c cleanup	Bereinigen Sie ein Quelldateisystem.
m2c completion	Script zur automatischen Vervollständigung für die angegebene Shell generieren
m2c config	Konfigurationsattribute aufrufen und bearbeiten
m2c copy	Kopieren Sie hiermit das Dateisystem einer VM lokal.
m2c generate	Generieren Sie hiermit Migrationsartefakte aus dem angegebenen Dateisystem.
m2c help	Hilfe zu jedem Befehl
m2c migrate-data	Daten vom lokalen Computer zu PVCs migrieren.
m2c-Plug-ins	Migrations-Plug-ins verwalten
m2c version	Die CLI-Version drucken

m2c analyze

Analysieren Sie hiermit die Konfiguration der Arbeitslast im angegebenen Dateisystem mit einem bestimmten Plug-in.

Der resultierende Modernisierungsplan ist in der Datei „config.yaml“ im angegebenen Ausgabeverzeichnis verfügbar.

Zusammenfassung

m2c analyze --source COPIED_FILESYSTEM_PATH --plugin PLUGIN_NAME --output OUTPUT_DIR [options]

Flags

-o,--output path

Ausgabepfad, der als Eingabe für den m2c generate-Befehl verwendet werden kann

-r,--parameter name=value

Plug-in-Analyseparameter im Format "name=value". Kann mehrmals angegeben werden

-p,--plugin name

Name des Plug-ins

-s,--source path

Der Pfad zu einem Dateisystem, das mit dem Befehl m2c copy generiert wird

--volume localPath:remotePath

Bindet eine Datei oder ein Verzeichnis im Container im Format „localPath:remotePath“ bereit. Kann mehrmals angegeben werden

m2c cleanup

Bereinigen Sie ein Quelldateisystem, das mit dem Kopierbefehl erstellt wurde.

Zusammenfassung

m2c cleanup -s SOURCE

Flags

-s,--source path

Der Pfad zur Quelle, die von m2c copy erstellt wurde.

m2c completion

Generieren Sie hiermit das Script zur automatischen Vervollständigung für m2c für die angegebene Shell.

Weitere Informationen zur Verwendung des generierten Skripts finden Sie in der Hilfe der einzelnen Unterbefehle.

Zusammenfassung

m2c completion

Befehle

Befehl	Beschreibung
m2c completion bash	Script zur automatischen Vervollständigung für bash generieren
m2c completion fish	Script zur automatischen Vervollständigung für fish generieren
m2c completion powershell	Script zur automatischen Vervollständigung für powershell generieren
m2c completion zsh	Script zur automatischen Vervollständigung für zsh generieren

m2c completion bash

Generieren Sie hiermit das Script zur automatischen Vervollständigung für die bash-Shell.

Dieses Script hängt vom Paket „bash-completion“ ab.

Wenn es noch nicht installiert ist, können Sie es über den Paketmanager Ihres Betriebssystems installieren.

So laden Sie Vervollständigungen in Ihrer aktuellen Shell-Sitzung:

    source <(m2c completion bash)

Führen Sie Folgendes einmal aus, um Vervollständigungen für jede neue Sitzung zu laden:

Linux:

    m2c completion bash > /etc/bash_completion.d/m2c

macOS:

    m2c completion bash > $(brew --prefix)/etc/bash_completion.d/m2c

Sie müssen eine neue Shell starten, damit diese Einrichtung wirksam wird.

Zusammenfassung

m2c completion bash

Flags

--no-descriptions

Vervollständigungsbeschreibungen deaktivieren

m2c completion fish

Generieren Sie hiermit das Script zur automatischen Vervollständigung für die fish-Shell.

So laden Sie Vervollständigungen in Ihrer aktuellen Shell-Sitzung:

    m2c completion fish | source

Führen Sie Folgendes einmal aus, um Vervollständigungen für jede neue Sitzung zu laden:

    m2c completion fish > ~/.config/fish/completions/m2c.fish

Sie müssen eine neue Shell starten, damit diese Einrichtung wirksam wird.

Zusammenfassung

m2c completion fish

Flags

--no-descriptions

Vervollständigungsbeschreibungen deaktivieren

m2c completion powershell

Generieren Sie hiermit das Script zur automatischen Vervollständigung für powershell.

So laden Sie Vervollständigungen in Ihrer aktuellen Shell-Sitzung:

    m2c completion powershell | Out-String | Invoke-Expression

Um Vervollständigungen für jede neue Sitzung zu laden, fügen Sie die Ausgabe des obigen Befehls

Ihrem powershell-Profil hinzu.

Zusammenfassung

m2c completion powershell

Flags

--no-descriptions

Vervollständigungsbeschreibungen deaktivieren

m2c completion zsh

Generieren Sie hiermit das Script zur automatischen Vervollständigung für die zsh-Shell.

Wenn die Shell-Vervollständigung in der Umgebung noch nicht aktiviert ist, müssen Sie

dies tun. Sie können Folgendes einmal ausführen:

    echo "autoload -U compinit; compinit" >> ~/.zshrc

So laden Sie Vervollständigungen in Ihrer aktuellen Shell-Sitzung:

    source <(m2c completion zsh)

Führen Sie Folgendes einmal aus, um Vervollständigungen für jede neue Sitzung zu laden:

Linux:

    m2c completion zsh > "${fpath[1]}/_m2c"

macOS:

    m2c completion zsh > $(brew --prefix)/share/zsh/site-functions/_m2c

Sie müssen eine neue Shell starten, damit diese Einrichtung wirksam wird.

Zusammenfassung

m2c completion zsh

Flags

--no-descriptions

Vervollständigungsbeschreibungen deaktivieren

m2c config

Konfigurationsattribute aufrufen und bearbeiten

Zusammenfassung

m2c config COMMAND

Befehle

Befehl	Beschreibung
m2c config get	Wert eines Konfigurationsattributs ausgeben
m2c config list	Alle Konfigurationsattribute und ihre Werte ausgeben
m2c config set	Wert eines Konfigurationsattributs festlegen
m2c config unset	Konfigurationsattribut auf seinen Standardwert zurücksetzen

m2c config get

Wert eines Konfigurationsattributs ausgeben

Zusammenfassung

m2c config get KEY

m2c config list

Alle Konfigurationsattribute und ihre Werte ausgeben

Zusammenfassung

m2c config list

m2c config set

Wert eines Konfigurationsattributs festlegen

Zusammenfassung

m2c config set KEY VALUE

m2c config unset

Konfigurationsattribut auf seinen Standardwert zurücksetzen

Zusammenfassung

m2c config unset KEY

m2c copy

Kopieren Sie hiermit das Dateisystem einer VM lokal.

Das Kopieren erfolgt über rsync und kann mit gcloud oder direktem SSH ausgeführt werden.

Zusammenfassung

m2c copy COMMAND

Befehle

Befehl	Beschreibung
m2c copy default-filters	Vom Kopiervorgang verwendete Standard-rsync-Filter anzeigen
m2c copy gcloud	Kopiert das Dateisystem einer Google Cloud-VM lokal über gcloud
m2c copy ssh	Kopiert das Dateisystem einer VM über SSH auf den lokalen Computer.

m2c copy default-filters

Rufen Sie hiermit die standardmäßigen rsync-Filter auf, die vom Kopiervorgang verwendet werden.

Dies kann als Grundlage für eine benutzerdefinierte Filterdatei verwendet werden, die über das Flag „--filters“ bereitgestellt wird.

Zusammenfassung

m2c copy default-filters

m2c copy gcloud

Kopiert das Dateisystem einer Google Cloud-VM lokal über gcloud

Zusammenfassung

m2c copy gcloud -p,--project PROJECT_ID -z,--zone ZONE -n,--vm-name VM_NAME -o,--output OUTPUT_PATH [options]

Flags

--filters path

Pfad zu einer benutzerdefinierten rsync-Filterdatei. Überschreibt die Standardfilter

--internal-ip

Stellen Sie eine Verbindung zu Instanzen anhand ihrer internen IP-Adressen statt ihrer externen IP-Adressen her. Verwenden Sie diese Option, um eine Verbindung von einer Instanz zu einer anderen im selben VPC-Netzwerk, über eine VPN-Verbindung oder zwischen zwei Peering-VPC-Netzwerken herzustellen. Für eine funktionierende Verbindung müssen Sie Ihre Netzwerke und Ihre Firewall so konfigurieren, dass SSH-Verbindungen zur internen IP-Adresse der Instanz zulässig sind, zu der Sie eine Verbindung herstellen möchten. Informationen zur Verwendung dieses Flags finden Sie unter https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances.

-o,--output path

Ausgabepfad des kopierten Dateisystems

-p,--project project

Google Cloud-Projekt

--remote-sudo

sudo auf der Remoteseite von rsync verwenden. Verwenden Sie diese Option, wenn die übergebenen Anmeldedaten nicht für den Root-Nutzer gelten. Wenn die Ausführung nicht als Superuser erfolgt, wird das Kopieren des gesamten Dateisystems verhindert. Entspricht der Übergabe von --rsync-path 'sudo rsync' an rsync.

--tunnel-through-iap

Tunnel für die SSH -Verbindung über Cloud Identity-Aware Proxy zur TCP-Weiterleitung einrichten. Weitere Informationen finden Sie in der Dokumentation zu IAP für die TCP-Weiterleitung (https://cloud.google.com/iap/docs/tcp-forwarding-overview).

-n,--vm-name name

VM-Name

-z,--zone zone

Google Cloud-Zone

m2c copy ssh

Kopiert das Dateisystem einer VM über SSH auf den lokalen Computer.

Zusammenfassung

m2c copy ssh [USER@]HOST -o,--output OUTPUT_PATH [options]

Flags

--filters path

Pfad zu einer benutzerdefinierten rsync-Filterdatei. Überschreibt die Standardfilter

-i,--identity-file key

Eine Datei, die den Schlüssel für die Authentifizierung enthält

-o,--output path

Ausgabepfad des kopierten Dateisystems

--remote-sudo

sudo auf der Remoteseite von rsync verwenden. Verwenden Sie diese Option, wenn die übergebenen Anmeldedaten nicht für den Root-Nutzer gelten. Wenn die Ausführung nicht als Superuser erfolgt, wird das Kopieren des gesamten Dateisystems verhindert. Entspricht der Übergabe von --rsync-path 'sudo rsync' an rsync.

m2c generate

Generieren Sie hiermit Migrationsartefakte aus dem angegebenen Dateisystem.

Dies verwendet die Migrationsplankonfiguration, die von einem vorherigen Analysevorgang generiert wurde.

Zusammenfassung

m2c generate -i ANALYSIS_DIRECTORY -o OUTPUT_PATH [options]

Flags

-i,--input path

Der Pfad zu einem Verzeichnis, das von „m2c analysis“ generiert wurde

-o,--output path

Der Ausgabepfad

--volume localPath:remotePath

Stellt eine Datei oder ein Verzeichnis im Container im Format „localPath:remotePath“ bereit. Kann mehrmals angegeben werden

m2c help

Hilfe für einen beliebigen Befehl in der Anwendung.

Geben Sie einfach „m2c help [Pfad zum Befehl]“ ein.

Zusammenfassung

m2c help [command]

m2c migrate-data

Migrieren Sie Daten gemäß dem Plan zur Datenmigration vom lokalen Computer zu PVCs auf dem derzeit verbundenen Cluster.

Zusammenfassung

m2c migrate-data -i INPUT_PATH [options]

Flags

-i,--input path

Pfad zu einem Verzeichnis, das von m2c analyze generiert wurde

-n,--namespace namespace

Der Namespace der PVCs für den Zielcluster

m2c-Plug-ins

Zusammenfassung

m2c plugins COMMAND

Befehle

Befehl	Beschreibung
m2c-Plug-ins entpacken	Plug-ins aus einer lokalen Datei importieren.

m2c-Plug-ins entpacken

Plug-ins aus einer lokalen Datei importieren.

Informationen zum Herunterladen einer Plug-in-Bundle-Datei finden Sie unter https://cloud.google.com/migrate/containers/docs/m2c-cli/prepare-for-migration

Zusammenfassung

m2c plugins unpack -i,--input PATH [options]

Flags

-i,--input string

Der Pfad für die Plug-in-Datei

-r,--registry string

Eine Container Registry, die für den Zielcluster verfügbar ist. Die bei der Datenmigration verwendeten Images werden in diese Registry übertragen, um sicherzustellen, dass die Datenmigration funktioniert, ohne Images aus dem Internet abzurufen.

m2c version

Die CLI-Version drucken

Zusammenfassung

m2c version