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:

  1. Copia in locale il file system dalla macchina di origine.

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

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

  4. 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