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:
Copia il file system dalla macchina di origine localmente.
Analizza il file system per creare un piano di modernizzazione.
Modifica il piano per personalizzare gli elementi di modernizzazione.
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