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.
Modernizza rapidamente il tuo carico di lavoro seguendo un percorso in quattro passaggi:
Copia in locale il file system dalla macchina di origine.
Analizza il file system per creare un piano di modernizzazione.
Modifica il piano per personalizzare gli artefatti di modernizzazione.
Genera gli artefatti di modernizzazione.
Synopsis
m2c COMMAND [options]
Bandiere
-q,--quiet
- Non generare output
-v,--verbose
- Mostra output dettagliato
Comandi
Comando | Descrizione |
---|---|
m2c analyze | Analizza la configurazione del carico di lavoro nel file system specificato. |
pulizia m2c | Pulisci un file system di origine. |
m2c completion | Genera lo script di completamento automatico per la shell specificata |
config m2c | Visualizzare e modificare le proprietà di configurazione |
m2c copy | Copia in locale il file system di una VM. |
m2c generate | Genera gli elementi della migrazione dal file system specificato. |
m2c help | Guida per qualsiasi comando |
m2c migrate-data | Migrazione dei dati dal computer locale alle 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
pulizia m2c
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 |
---|---|
bash di completamento m2c | Generare lo script di completamento automatico per bash |
pesci completamento m2c | Generare lo script di completamento automatico per fish |
m2c completion powershell | Generare lo script di completamento automatico per PowerShell |
zsh completamento m2c | Genera lo script di completamento automatico per zsh |
bash di completamento m2c
Genera lo script di completamento automatico per la shell bash.
Questo script dipende dal "completamento-bash" pacchetto.
Se non è già installato, puoi farlo tramite il gestore pacchetti del sistema operativo.
Per caricare i completamenti nella sessione di shell attuale:
source <(m2c completion bash)
Per caricare i completamenti per ogni nuova sessione, esegui il comando una volta:
Linux:
m2c completion bash > /etc/bash_completion.d/m2c
macOS:
m2c completion bash > $(brew --prefix)/etc/bash_completion.d/m2c
Per applicare la configurazione, devi avviare una nuova shell.
Synopsis
m2c completion bash
Bandiere
--no-descriptions
- disattiva descrizioni completamento
m2c completion fish
Genera lo script di completamento automatico per la shell fish.
Per caricare i completamenti nella sessione di shell attuale:
m2c completion fish | source
Per caricare i completamenti per ogni nuova sessione, esegui il comando una volta:
m2c completion fish > ~/.config/fish/completions/m2c.fish
Per applicare la configurazione, devi avviare una nuova shell.
Synopsis
m2c completion fish
Bandiere
--no-descriptions
- disattiva descrizioni completamento
PowerShell di completamento m2c
Genera lo script di completamento automatico per PowerShell.
Per caricare i completamenti nella sessione di shell attuale:
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 quanto segue una sola volta:
echo "autoload -U compinit; compinit" >> ~/.zshrc
Per caricare i completamenti nella sessione di shell attuale:
source <(m2c completion zsh)
Per caricare i completamenti per ogni nuova sessione, esegui il comando una volta:
Linux:
m2c completion zsh > "${fpath[1]}/_m2c"
macOS:
m2c completion zsh > $(brew --prefix)/share/zsh/site-functions/_m2c
Per applicare la 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. |
elenco di configurazioni m2c | Stampa tutte le proprietà di configurazione e i relativi valori. |
m2c config set | Imposta il valore di una proprietà di configurazione. |
m2c config unset | Reimposta il valore predefinito di una proprietà di configurazione. |
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
Reimposta il valore predefinito di una proprietà di configurazione.
Synopsis
m2c config unset KEY
m2c copy
Copia in locale il file system di una VM.
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-filtri | 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. |
filtri predefiniti copia m2c
Mostra i filtri rsync predefiniti utilizzati dall'operazione di copia.
Può essere usato come base per fornire un file di filtri personalizzati tramite il flag --filtri.
Synopsis
m2c copy default-filters
m2c copy gcloud
Copia in locale il file system di una VM Google Cloud 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é e i relativi indirizzi IP esterni. Utilizzalo per connetterti da un'istanza un'altra sulla stessa rete VPC, tramite una connessione VPN o tra due reti VPC in peering. Affinché questa connessione funzioni, devi configurare le reti e per consentire le connessioni SSH all'indirizzo IP interno del alla quale 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
- Usa 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.
Equivale 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 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.
genera m2c
Generare artefatti di 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 nell'applicazione.
Per informazioni dettagliate, digita semplicemente m2c help [percorso al comando].
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 delle PVC di destinazione sul cluster di destinazione
Plug-in m2c
Synopsis
m2c plugins COMMAND
Comandi
Comando | Descrizione |
---|---|
m2c plugins unpack | Importa i plug-in da un file locale. |
Estrazione dei plug-in m2c
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