Documentazione di riferimento dell'interfaccia a riga di comando Migrate to Containers per Linux
m2c è uno strumento a riga di comando che consente di configurare ed eseguire migrazioni sulla 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 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 elementi 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 |
|---|---|
| analisi m2c | 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 |
| m2c config | Visualizzare e modificare le proprietà di configurazione |
| m2c copy | Copia in locale il file system di una VM. |
| generazione m2c | 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 | Gestisci 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 all'interno della 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- I parametri di analisi dei plug-in hanno il formato "nome=valore". 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 |
|---|---|
| bash di completamento m2c | Generare lo script di completamento automatico per bash |
| pesci completamento m2c | Generare lo script di completamento automatico per i pesci |
| Powershell di completamento m2c | Generare lo script di completamento automatico per PowerShell |
| zsh completamento m2c | Generare lo script di completamento automatico per zsh |
m2c completion bash
Generare lo script di completamento automatico per la shell bash.
Questo script dipende dal pacchetto "bash-completion".
Se non è già installata, puoi installarla tramite il gestore di pacchetti del tuo 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 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 questa configurazione, devi avviare una nuova shell.
Synopsis
m2c completion bash
Bandiere
--no-descriptions- disattiva descrizioni completamento
pesce completamento m2c
Genera lo script di completamento automatico per il guscio di pesce.
Per caricare i completamenti nella sessione di shell attuale:
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
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 descrizioni completamento
zsh completamento m2c
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 le comandi suggeriti nella sessione di shell corrente:
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 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. |
| elenco di configurazioni m2c | Stampa tutte le proprietà di configurazione e i relativi valori. |
| set di configurazione m2c | Imposta il valore di una proprietà di configurazione. |
| m2c config unset | Ripristina una proprietà di configurazione al suo valore predefinito. |
config get m2c
Stampa il valore di una proprietà di configurazione.
Synopsis
m2c config get KEY
elenco di configurazioni m2c
Stampa tutte le proprietà di configurazione e i relativi valori.
Synopsis
m2c config list
set di configurazione m2c
Imposta il valore di una proprietà di configurazione.
Synopsis
m2c config set KEY VALUE
Configurazione m2c annullata
Ripristina una proprietà di configurazione al suo valore predefinito.
Synopsis
m2c config unset KEY
testo m2c
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. |
| ssh copia m2c | 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.
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. Esegue l'override dei filtri predefiniti
--internal-ip- Connettiti alle istanze utilizzando i relativi indirizzi IP interni anziché gli indirizzi IP esterni. Utilizzalo per connetterti da un'istanza all'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 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- 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.
Equivale a passare
--rsync-path 'sudo rsync'a rsync. --tunnel-through-iap- Tunnel della connessione SSH tramite Cloud Identity-Aware Proxy per TCP l'inoltro. 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- 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.
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.
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 alle PVC del 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 |
|---|---|
| scomposizione dei plug-in m2c | 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 registro per garantire che la migrazione dei dati funzioni senza estrarre immagini da internet.
versione m2c
Stampa la versione dell'interfaccia a riga di comando.
Synopsis
m2c version