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:
Copie o sistema de arquivos localmente da máquina de origem.
Analise o sistema de arquivos para criar um plano de modernização.
Edite o plano para personalizar os artefatos de modernização.
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