Documentazione di riferimento dell'interfaccia a riga di comando Migrate to Containers per Linux

m2c è uno strumento a riga di comando che ti consente di configurare ed eseguire le migrazioni sulla tua macchina locale.

m2c

Un'interfaccia a riga di comando per Migrate to Containers.

Esegui una rapida modernizzazione del tuo carico di lavoro seguendo un percorso in quattro passaggi:

  1. Copia il file system dalla macchina di origine localmente.

  2. Analizza il file system per creare un piano di modernizzazione.

  3. Modifica il piano per personalizzare gli elementi di modernizzazione.

  4. Genera gli artefatti di modernizzazione.

Synopsis

m2c COMMAND [options]

Bandiere

-q,--quiet
Non viene visualizzato alcun output
-v,--verbose
Mostra output dettagliato

Comandi

Comando Descrizione
m2c analyze Analizza la configurazione del carico di lavoro nel file system specificato.
m2c cleanup Ripulisci un file system di origine.
m2c completion Genera lo script di completamento automatico per la shell specificata
m2c config Visualizzare e modificare le proprietà di configurazione
m2c copy Copia il file system di una VM localmente.
m2c generate Genera gli elementi della migrazione dal file system specificato.
m2c help Guida per qualsiasi comando
m2c migrate-data Esegui la migrazione dei dati dalla macchina locale ai PVC.
Plug-in m2c Gestire i plug-in di migrazione
Versione m2c Stampa la versione dell'interfaccia a riga di comando.

m2c analyze

Analizza la configurazione del carico di lavoro nel file system specificato con un determinato plug-in.

Il piano di modernizzazione risultante sarà disponibile nel file config.yaml nella directory di output specificata.

Synopsis

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

Bandiere

-o,--output path
Percorso di output che può essere utilizzato come input per il comando m2c generate
-r,--parameter name=value
Parametri di analisi del plug-in nel formato "name=value". Può essere specificato più volte
-p,--plugin name
Nome plug-in
-s,--source path
Il percorso di un file system generato dal comando m2c copy
--volume localPath:remotePath
Bind monta un file o una directory nel contenitore nel formato "localPath:remotePath". Può essere specificato più volte

m2c cleanup

Ripulire un file system di origine creato dal comando di copia.

Synopsis

m2c cleanup -s SOURCE

Bandiere

-s,--source path
Il percorso dell'origine creata da m2c copy

m2c completion

Genera lo script di completamento automatico per m2c per la shell specificata.

Consulta la guida di ciascun comando secondario per informazioni dettagliate su come utilizzare lo script generato.

Synopsis

m2c completion

Comandi

Comando Descrizione
m2c completion bash Generare lo script di completamento automatico per bash
m2c completion fish Generare lo script di completamento automatico per fish
m2c completion powershell Generare lo script di completamento automatico per PowerShell
m2c completion zsh Generare lo script di completamento automatico per zsh

m2c completion bash

Genera lo script di completamento automatico per la shell bash.

Questo script dipende dal pacchetto "bash-completion".

Se non è già installato, puoi farlo tramite il gestore pacchetti del sistema operativo.

Per caricare le comandi suggeriti nella sessione di shell corrente:

    source <(m2c completion bash)

Per caricare i completamenti per ogni nuova sessione, esegui una volta:

Linux:

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

macOS:

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

Per applicare questa configurazione, devi avviare una nuova shell.

Synopsis

m2c completion bash

Bandiere

--no-descriptions
disattiva le descrizioni di completamento

m2c completion fish

Genera lo script di completamento automatico per la shell fish.

Per caricare le comandi suggeriti nella sessione di shell corrente:

    m2c completion fish | source

Per caricare i completamenti per ogni nuova sessione, esegui una volta:

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

Per applicare questa configurazione, devi avviare una nuova shell.

Synopsis

m2c completion fish

Bandiere

--no-descriptions
disattiva le descrizioni di completamento

m2c completion powershell

Genera lo script di completamento automatico per PowerShell.

Per caricare le comandi suggeriti nella sessione di shell corrente:

    m2c completion powershell | Out-String | Invoke-Expression

Per caricare i completamenti per ogni nuova sessione, aggiungi l'output del comando precedente

al tuo profilo PowerShell.

Synopsis

m2c completion powershell

Bandiere

--no-descriptions
disattiva le descrizioni di completamento

m2c completion zsh

Genera lo script di completamento automatico per la shell zsh.

Se il completamento della shell non è già attivo nel tuo ambiente, devi

per attivarlo. Puoi eseguire una volta quanto segue:

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

Per caricare le comandi suggeriti nella sessione di shell corrente:

    source <(m2c completion zsh)

Per caricare i completamenti per ogni nuova sessione, esegui una volta:

Linux:

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

macOS:

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

Per applicare questa configurazione, devi avviare una nuova shell.

Synopsis

m2c completion zsh

Bandiere

--no-descriptions
disattiva le descrizioni di completamento

Configurazione m2c

Visualizza e modifica le proprietà di configurazione.

Synopsis

m2c config COMMAND

Comandi

Comando Descrizione
m2c config get Stampa il valore di una proprietà di configurazione.
m2c config list Stampa tutte le proprietà di configurazione e i relativi valori.
m2c config set Imposta il valore di una proprietà di configurazione.
m2c config unset Ripristina una proprietà di configurazione al suo valore predefinito.

m2c config get

Stampa il valore di una proprietà di configurazione.

Synopsis

m2c config get KEY

Elenco di configurazione m2c

Stampa tutte le proprietà di configurazione e i relativi valori.

Synopsis

m2c config list

m2c config set

Imposta il valore di una proprietà di configurazione.

Synopsis

m2c config set KEY VALUE

m2c config unset

Ripristina una proprietà di configurazione al suo valore predefinito.

Synopsis

m2c config unset KEY

m2c copy

Copia il file system di una VM localmente.

La copia viene eseguita tramite rsync e può essere eseguita utilizzando gcloud o SSH diretto.

Synopsis

m2c copy COMMAND

Comandi

Comando Descrizione
m2c copy default-filters Mostra i filtri rsync predefiniti utilizzati dall'operazione di copia
m2c copy gcloud Copia il file system di una VM Google Cloud localmente tramite gcloud.
m2c copy ssh Copia il file system di una VM sulla macchina locale tramite SSH.

m2c copy default-filters

Mostra i filtri rsync predefiniti utilizzati dall'operazione di copia.

Questo può essere utilizzato come base per un file di filtri personalizzati da fornire tramite il flag --filters.

Synopsis

m2c copy default-filters

m2c copy gcloud

Copia il file system di una VM Google Cloud localmente tramite gcloud.

Synopsis

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

Bandiere

--filters path
Il percorso di un file di filtri rsync personalizzato. Sostituisce i filtri predefiniti
--internal-ip
Connettiti alle istanze utilizzando i relativi indirizzi IP interni anziché quelli esterni. Utilizzalo per connetterti da un'istanza a un'altra nella stessa rete VPC, tramite una connessione VPN o tra due reti VPC in peering. Affinché questa connessione funzioni, devi configurare le reti e il firewall in modo da consentire le connessioni SSH all'indirizzo IP interno dell'istanza a cui vuoi connetterti. Per scoprire come utilizzare questo flag, consulta https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances .
-o,--output path
Percorso di output del file system copiato
-p,--project project
Progetto Google Cloud
--remote-sudo
Utilizza sudo sul lato remoto di rsync. Utilizza questa opzione se le credenziali che passi non sono per l'utente root. L'esecuzione non come superutente impedisce la copia dell'intero file system. Equivalente a passare --rsync-path 'sudo rsync' a rsync.
--tunnel-through-iap
Esegui il tunnel della connessione SSH tramite Cloud Identity-Aware Proxy per l'inoltro TCP. Per saperne di più, consulta la documentazione di IAP per il forwarding TCP ( https://cloud.google.com/iap/docs/tcp-forwarding-overview).
-n,--vm-name name
Nome della VM
-z,--zone zone
Zona Google Cloud

m2c copy ssh

Copia il file system di una VM sulla macchina locale tramite SSH.

Synopsis

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

Bandiere

--filters path
Il percorso di un file di filtri rsync personalizzato. Sostituisce i filtri predefiniti
-i,--identity-file key
Un file contenente la chiave per l'autenticazione
-o,--output path
Percorso di output del file system copiato
--remote-sudo
Utilizza sudo sul lato remoto di rsync. Utilizza questa opzione se le credenziali che passi non sono per l'utente root. L'esecuzione non come superutente impedisce la copia dell'intero file system. Equivalente a passare --rsync-path 'sudo rsync' a rsync.

m2c generate

Genera gli elementi della migrazione dal file system specificato.

Viene utilizzata la configurazione del piano di migrazione generata da un'operazione di analisi precedente.

Synopsis

m2c generate -i ANALYSIS_DIRECTORY -o OUTPUT_PATH [options]

Bandiere

-i,--input path
Il percorso di una directory generata da "m2c analyze"
-o,--output path
Il percorso di output
--volume localPath:remotePath
Bind monta un file o una directory nel contenitore nel formato "localPath:remotePath". Può essere specificato più volte

Guida di m2c

La guida fornisce assistenza per qualsiasi comando dell'applicazione.

Digita semplicemente m2c help [path to command] per visualizzare tutti i dettagli.

Synopsis

m2c help [command]

m2c migrate-data

Esegui la migrazione dei dati dalla macchina locale ai PVC sul cluster attualmente connesso in base al piano di migrazione dei dati.

Synopsis

m2c migrate-data -i INPUT_PATH [options]

Bandiere

-i,--input path
Il percorso di una directory generata da m2c analyze
-n,--namespace namespace
Lo spazio dei nomi dei PVC di destinazione nel cluster di destinazione

Plug-in m2c

Synopsis

m2c plugins COMMAND

Comandi

Comando Descrizione
m2c plugins unpack Importa i plug-in da un file locale.

m2c plugins unpack

Importa i plug-in da un file locale.

Per scaricare un file del bundle di plug-in, consulta https://cloud.google.com/migrate/containers/docs/m2c-cli/prepare-for-migration .

Synopsis

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

Bandiere

-i,--input string
Il percorso del file dei plug-in
-r,--registry string
Un registry dei container disponibile per il cluster di destinazione. Le immagini utilizzate dal processo di migrazione dei dati verranno inviate a questo registry per garantire che la migrazione dei dati funzioni senza estrarre le immagini da internet.

Versione m2c

Stampa la versione dell'interfaccia a riga di comando.

Synopsis

m2c version