Referência da CLI do Migrate to Containers para Linux

O m2c é uma ferramenta de linha de comando para configurar e executar migrações na máquina local.

m2c

Uma interface de linha de comando para o Migrate to Containers.

Siga uma jornada de quatro etapas para realizar uma modernização rápida da sua carga de trabalho:

1. Copie localmente o sistema de arquivos da máquina de origem.

2. Analise o sistema de arquivos para criar um plano de modernização.

3. Edite o plano para personalizar os artefatos de modernização.

4. Gere os artefatos de modernização.

Sinopse

m2c COMMAND [options]

Flags

-q,--quiet

Não exibir nada

-v,--verbose

Exibir saída detalhada

Comandos

Comando	Descrição
m2c analyze	Analisa a configuração da carga de trabalho no sistema de arquivos indicado.
m2c cleanup	Limpa o sistema de arquivos de origem.
m2c completion	Gera o script de preenchimento automático para o shell especificado
m2c config	Mostra e edita as propriedades de configuração.
m2c copy	Copia localmente o sistema de arquivos de uma VM.
m2c generate	Gera artefatos de migração do sistema de arquivos indicado.
m2c help	Mostra a Ajuda de qualquer comando.
m2c migrate-data	Migra os dados da máquina local para PVCs.
m2c plugins	Gerencia os plug-ins de migração.
m2c version	Mostra a versão da CLI.

m2c analyze

Analisa a configuração da carga de trabalho no sistema de arquivos com um determinado plug-in.

O plano de modernização resultante estará disponível no arquivo config.yaml no diretório de saída indicado.

Sinopse

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

Flags

-o,--output path

Caminho de saída que pode ser usado como entrada para o comando m2c generate

-r,--parameter name=value

Parâmetros de análise do plug-in no formato "nome=valor". Pode ser especificado várias vezes

-p,--plugin name

Nome do plug-in

-s,--source path

O caminho para um sistema de arquivos gerado pelo comando m2c copy

--volume localPath:remotePath

Faz montagem de vinculação de um arquivo ou diretório no contêiner no formato de "localPath:remotePath". Pode ser especificado várias vezes

m2c cleanup

Limpa um sistema de arquivos de origem criado pelo comando "copy".

Sinopse

m2c cleanup -s SOURCE

Flags

-s,--source path

O caminho para a origem criada por m2c copy

m2c completion

Gera o script de preenchimento automático para m2c para o shell especificado.

Saiba como usar o script gerado na ajuda de cada subcomando.

Sinopse

m2c completion

Comandos

Comando	Descrição
m2c completion bash	Gera o script de preenchimento automático para bash
m2c completion fish	Gera o script de preenchimento automático para fish
m2c completion powershell	Gera o script de preenchimento automático para o PowerShell
m2c completion zsh	Gera o script de preenchimento automático para zsh

m2c completion bash

Gera o script de preenchimento automático para o shell bash.

Esse script depende do pacote "bash-completion".

Se ele ainda não estiver instalado, instale usando o gerenciador de pacotes do sistema operacional.

Para carregar preenchimentos na sessão de shell atual:

    source <(m2c completion bash)

Para carregar preenchimentos para cada nova sessão, execute uma vez:

Linux:

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

macOS:

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

É necessário iniciar um novo shell para que essa configuração seja aplicada.

Sinopse

m2c completion bash

Flags

--no-descriptions

Desativa as descrições de preenchimento

m2c completion fish

Gera o script de preenchimento automático para o shell fish.

Para carregar preenchimentos na sessão de shell atual:

    m2c completion fish | source

Para carregar preenchimentos para cada nova sessão, execute uma vez:

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

É necessário iniciar um novo shell para que essa configuração seja aplicada.

Sinopse

m2c completion fish

Flags

--no-descriptions

Desativa as descrições de preenchimento

m2c completion powershell

Gera o script de preenchimento automático para o PowerShell.

Para carregar preenchimentos na sessão de shell atual:

    m2c completion powershell | Out-String | Invoke-Expression

Para carregar preenchimentos para cada nova sessão, adicione a saída do comando acima

ao seu perfil do PowerShell.

Sinopse

m2c completion powershell

Flags

--no-descriptions

Desativa as descrições de preenchimento

m2c completion zsh

Gera o script de preenchimento automático para o shell zsh.

Se o preenchimento do shell ainda não estiver ativado no seu ambiente, você precisará

ativá-la. Execute o seguinte uma vez:

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

Para carregar preenchimentos na sessão de shell atual:

    source <(m2c completion zsh)

Para carregar preenchimentos para cada nova sessão, execute uma vez:

Linux:

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

macOS:

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

É necessário iniciar um novo shell para que essa configuração seja aplicada.

Sinopse

m2c completion zsh

Flags

--no-descriptions

Desativa as descrições de preenchimento

m2c config

Mostra e edita as propriedades de configuração.

Sinopse

m2c config COMMAND

Comandos

Comando	Descrição
m2c config get	Mostra o valor de uma propriedade de configuração
m2c config list	Mostra todas as propriedades de configuração e os valores delas.
m2c config set	Define o valor de uma propriedade de configuração.
m2c config unset	Redefine uma propriedade de configuração para o valor padrão

m2c config get

Mostra o valor de uma propriedade de configuração

Sinopse

m2c config get KEY

m2c config list

Mostra todas as propriedades de configuração e os valores delas.

Sinopse

m2c config list

m2c config set

Define o valor de uma propriedade de configuração.

Sinopse

m2c config set KEY VALUE

m2c config unset

Redefine uma propriedade de configuração para o valor padrão

Sinopse

m2c config unset KEY

m2c copy

Copia localmente o sistema de arquivos de uma VM.

A cópia é feita pelo rsync e pode ser realizada com a gcloud ou o SSH direto.

Sinopse

m2c copy COMMAND

Comandos

Comando	Descrição
m2c copy default-filters	Mostra os filtros de rsync padrão usados pela operação de cópia.
m2c copy gcloud	Copia localmente o sistema de arquivos de uma VM do Google Cloud com a gcloud.
m2c copy ssh	Copia o sistema de arquivos de uma VM na máquina local com SSH.

m2c copy default-filters

Mostra os filtros de rsync padrão usados pela operação de cópia.

É possível usar esse comando como base para fornecer um arquivo de filtros personalizados usando a flag --filters.

Sinopse

m2c copy default-filters

m2c copy gcloud

Copia localmente o sistema de arquivos de uma VM do Google Cloud com a gcloud.

Sinopse

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

Flags

--filters path

O caminho para um arquivo de filtros personalizados de rsync, que substituem os filtros padrão

--internal-ip

Conecta-se a instâncias usando os endereços IP internos em vez dos externos. Use esse comando para conexão entre instâncias na mesma rede VPC, por meio de uma conexão VPN, ou entre duas redes VPC com peering. Para que a conexão funcione, configure as redes e o firewall para permitir conexões SSH com o endereço IP interno da instância a que você quer se conectar. Para saber como usar essa flag, consulte https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances.

-o,--output path

Caminho de saída do sistema de arquivos copiado

-p,--project project

Projeto do Google Cloud

--remote-sudo

Usa o sudo no lado remoto do rsync. Use essa opção se as credenciais transmitidas não forem do usuário raiz. Se esse comando não for executado como superusuário, a cópia de todo o sistema de arquivos será impedida. Equivale a transmitir --rsync-path 'sudo rsync' para o rsync.

--tunnel-through-iap

Túnel da conexão SSH por meio do Cloud Identity-Aware Proxy para encaminhamento de TCP. Para saber mais, consulte a documentação do IAP para encaminhamento de TCP (https://cloud.google.com/iap/docs/tcp-forwarding-overview)

-n,--vm-name name

Nome da VM

-z,--zone zone

Zona do Google Cloud

m2c copy ssh

Copia o sistema de arquivos de uma VM na máquina local com SSH.

Sinopse

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

Flags

--filters path

O caminho para um arquivo de filtros personalizados de rsync, que substituem os filtros padrão

-i,--identity-file key

Um arquivo com a chave para autenticação

-o,--output path

Caminho de saída do sistema de arquivos copiado

--remote-sudo

Usa o sudo no lado remoto do rsync. Use essa opção se as credenciais transmitidas não forem do usuário raiz. Se esse comando não for executado como superusuário, a cópia de todo o sistema de arquivos será impedida. Equivale a transmitir --rsync-path 'sudo rsync' para o rsync.

m2c generate

Gera artefatos de migração do sistema de arquivos indicado.

O comando usa a configuração do plano de migração gerada por uma operação de análise anterior.

Sinopse

m2c generate -i ANALYSIS_DIRECTORY -o OUTPUT_PATH [options]

Flags

-i,--input path

O caminho para um diretório gerado por "m2c analyze"

-o,--output path

O caminho de saída

--volume localPath:remotePath

Faz montagem de vinculação de um arquivo ou diretório no contêiner no formato de "localPath:remotePath". Pode ser especificado várias vezes

m2c help

Mostra a ajuda de qualquer comando no aplicativo.

Digite m2c help [caminho para o comando] para conferir mais detalhes.

Sinopse

m2c help [command]

m2c migrate-data

Migra os dados da máquina local para PVCs no cluster que está conectado de acordo com o plano de migração.

Sinopse

m2c migrate-data -i INPUT_PATH [options]

Flags

-i,--input path

O caminho para um diretório gerado por m2c analyze

-n,--namespace namespace

O namespace das PVCs de destino no cluster de destino

m2c plugins

Sinopse

m2c plugins COMMAND

Comandos

Comando	Descrição
m2c plugins unpack	Importa plug-ins de um arquivo local.

m2c plugins unpack

Importa plug-ins de um arquivo local.

Para baixar um arquivo de pacote de plug-ins, acesse https://cloud.google.com/migrate/containers/docs/m2c-cli/prepare-for-migration.

Sinopse

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

Flags

-i,--input string

O caminho do arquivo de plug-ins

-r,--registry string

Um Container Registry disponível para o cluster de destino. As imagens usadas pelo processo de migração de dados serão enviadas a esse registro para garantir o funcionamento da migração sem extrair imagens da internet.

m2c version

Mostra a versão da CLI.

Sinopse

m2c version