Referência da CLI do Migrate to Containers para Linux

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

m2c

Uma interface de linha de comando para migrar para contêineres.

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

  1. Copie o sistema de arquivos localmente 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]

Sinalizações

-q,--quiet
Não exibir nada
-v,--verbose
Exibir saída detalhada

Comandos

Comando Descrição
análise do m2c Analisar a configuração da carga de trabalho no sistema de arquivos fornecido
Limpeza do m2c Limpar um sistema de arquivos de origem.
Conclusão do m2c Gerar o script de preenchimento automático para o shell especificado
Configuração do m2c Ver e editar propriedades de configuração
m2c Copie o sistema de arquivos de uma VM localmente.
m2c generate Gera artefatos de migração do sistema de arquivos fornecido.
Ajuda do m2c Ajuda sobre qualquer comando
m2c migrate-data Migrar dados da máquina local para PVCs.
Plug-ins do m2c Gerenciar plug-ins de migração
Versão m2c Imprima a versão da CLI.

análise do m2c

Analise 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 fornecido.

Sinopse

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

Sinalizações

-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 "name=value". 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
A vinculação monta um arquivo ou diretório no contêiner no formato de "localPath:remotePath". Pode ser especificado várias vezes

Limpeza de m2c

Limpe um sistema de arquivos de origem criado pelo comando de cópia.

Sinopse

m2c cleanup -s SOURCE

Sinalizações

-s,--source path
O caminho para a origem criada por m2c copy

conclusão do m2c

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

Consulte a ajuda de cada subcomando para ver detalhes sobre como usar o script gerado.

Sinopse

m2c completion

Comandos

Comando Descrição
bash da conclusão do m2c Gerar o script de preenchimento automático para o bash
peixe de conclusão m2c Gerar o script de preenchimento automático para peixes
Powershell de conclusão m2c Gerar o script de preenchimento automático para o PowerShell
m2c de conclusão zsh Gerar o script de preenchimento automático para zsh

bash de conclusão m2c

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

Esse script depende do pacote "bash-completion".

Se ainda não estiver instalado, você pode instalá-lo através do gerenciador de pacotes do sistema operacional.

Para carregar conclusões na sessão de shell atual:

    source <(m2c completion bash)

Para carregar conclusões 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

Sinalizações

--no-descriptions
desativar descrições de conclusão

m2c peixe de conclusão

Gere o script de preenchimento automático para o shell do peixe.

Para carregar conclusões na sessão de shell atual:

    m2c completion fish | source

Para carregar conclusões 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

Sinalizações

--no-descriptions
desativar descrições de conclusão

powershell de conclusão m2c

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

Para carregar conclusões na sessão de shell atual:

    m2c completion powershell | Out-String | Invoke-Expression

Para carregar as conclusões de cada nova sessão, adicione a saída do comando acima

ao seu perfil do PowerShell.

Sinopse

m2c completion powershell

Sinalizações

--no-descriptions
desativar descrições de conclusão

m2c conclusão zsh

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

Se a conclusão do shell ainda não estiver ativada em seu ambiente, você precisará

para ativá-lo. Você pode executar o seguinte uma vez:

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

Para carregar conclusões na sessão de shell atual:

    source <(m2c completion zsh)

Para carregar conclusões 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

Sinalizações

--no-descriptions
desativar descrições de conclusão

Configuração da m2c

Veja e edite as propriedades de configuração.

Sinopse

m2c config COMMAND

Comandos

Comando Descrição
m2c config get Para exibir o valor de uma propriedade de configuração
Lista de configurações do m2c Para exibir todas as propriedades de configuração e os valores delas:
Conjunto da configuração m2c Definir o valor de uma propriedade de configuração
Configuração do m2c não definida Para redefinir uma propriedade de configuração para o valor padrão

m2c config get

Para exibir o valor de uma propriedade de configuração

Sinopse

m2c config get KEY

Lista de configurações do m2c

Para exibir todas as propriedades de configuração e os valores delas:

Sinopse

m2c config list

Conjunto da configuração m2c

Definir o valor de uma propriedade de configuração

Sinopse

m2c config set KEY VALUE

Configuração de m2c não definida

Para redefinir uma propriedade de configuração para o valor padrão

Sinopse

m2c config unset KEY

cópia do m2c

Copie o sistema de arquivos de uma VM localmente.

A cópia é feita por meio do rsync e pode ser feita usando o gcloud ou o SSH direto.

Sinopse

m2c copy COMMAND

Comandos

Comando Descrição
m2c cópia de filtros padrão Mostrar os filtros de rsync padrão usados pela operação de cópia
m2c copiar gcloud Copia localmente o sistema de arquivos de uma VM do Google Cloud pelo gcloud
m2c copiar ssh Copie o sistema de arquivos de uma VM na máquina local por SSH.

m2c copiar filtros padrão

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

Isso pode ser usado como base para que um arquivo de filtros personalizados seja fornecido por meio da sinalização --filters.

Sinopse

m2c copy default-filters

m2c copiar gcloud

Copia localmente o sistema de arquivos de uma VM do Google Cloud pelo gcloud

Sinopse

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

Sinalizações

--filters path
O caminho para um arquivo personalizado de filtros de rsync. modifica os filtros padrão
--internal-ip
Conecte-se a instâncias usando os endereços IP internos em vez de endereços IP externos. Use-o para se conectar de uma instância a outra na mesma rede VPC, por meio de uma conexão VPN ou entre duas redes VPC com peering. Para que essa conexão funcione, configure suas redes e seu firewall para permitir conexões SSH com o endereço IP interno da VM de TPU à qual você quer se conectar. Para saber como usar essa sinalização, 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
Use sudo no lado remoto do rsync. Use essa opção se as credenciais transmitidas não forem para o usuário raiz. A não execução como superusuário impede a cópia de todo o sistema de arquivos. Equivalente 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 copiar ssh

Copie o sistema de arquivos de uma VM na máquina local por SSH.

Sinopse

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

Sinalizações

--filters path
O caminho para um arquivo personalizado de filtros de rsync. modifica os filtros padrão
-i,--identity-file key
Um arquivo que contém a chave para autenticação
-o,--output path
Caminho de saída do sistema de arquivos copiado
--remote-sudo
Use sudo no lado remoto do rsync. Use essa opção se as credenciais transmitidas não forem para o usuário raiz. A não execução como superusuário impede a cópia de todo o sistema de arquivos. Equivalente a transmitir --rsync-path 'sudo rsync' para o rsync.

gerar m2c

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

Isso utiliza 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]

Sinalizações

-i,--input path
O caminho para um diretório gerado por "m2c analyze"
-o,--output path
O caminho de saída
--volume localPath:remotePath
A vinculação monta um arquivo ou diretório no contêiner no formato de "localPath:remotePath". Pode ser especificado várias vezes

Ajuda do m2c

A Ajuda fornece ajuda para qualquer comando no aplicativo.

Digite m2c [path to command] para ver todos os detalhes.

Sinopse

m2c help [command]

m2c migrate-data

Migrar dados da máquina local para PVCs no cluster conectado no momento de acordo com o plano de migração de dados.

Sinopse

m2c migrate-data -i INPUT_PATH [options]

Sinalizações

-i,--input path
O caminho para um diretório gerado pela análise do m2c
-n,--namespace namespace
O namespace das PVCs de destino no cluster de destino

Plug-ins do m2c

Sinopse

m2c plugins COMMAND

Comandos

Comando Descrição
Descompactar plug-ins do m2c Importe plug-ins de um arquivo local.

Descompactar plug-ins do m2c

Importe plug-ins de um arquivo local.

Para fazer o download de 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]

Sinalizações

-i,--input string
O caminho do arquivo de plug-ins
-r,--registry string
Um registro de contêiner 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 imagens da Internet.

versão m2c

Imprima a versão da CLI.

Sinopse

m2c version