Referência da CLI Migrate to Containers para Linux
O m2c é uma ferramenta de linha de comandos que lhe permite configurar e executar migrações na sua máquina local.
m2c
Uma interface de linhas de comando para o Migrate to Containers.
Faça uma modernização rápida da sua carga de trabalho seguindo um percurso de quatro passos:
Copie o sistema de ficheiros do computador de origem localmente.
Analise o sistema de ficheiros para criar um plano de modernização.
Edite o plano para personalizar os artefactos de modernização.
Gere os artefactos de modernização.
Synopsis
m2c COMMAND [options]
Bandeiras
-q,--quiet- Não gerar nada
-v,--verbose- Mostrar saída detalhada
Comandos
| Comando | Descrição |
|---|---|
| m2c analyze | Analise a configuração da carga de trabalho no sistema de ficheiros fornecido. |
| m2c cleanup | Limpar um sistema de ficheiros de origem. |
| m2c completion | Gere o script de preenchimento automático para a shell especificada |
| m2c config | Veja e edite propriedades de configuração |
| m2c copy | Copiar o sistema de ficheiros de uma VM localmente. |
| m2c generate | Gere artefactos de migração a partir do sistema de ficheiros fornecido. |
| m2c help | Ajuda sobre qualquer comando |
| m2c migrate-data | Migre dados da máquina local para PVCs. |
| Plug-ins m2c | Faça a gestão dos plug-ins de migração |
| Versão m2c | Imprima a versão da CLI. |
m2c analyze
Analise a configuração da carga de trabalho no sistema de ficheiros fornecido com um determinado plug-in.
O plano de modernização resultante vai estar disponível no ficheiro config.yaml no diretório de saída indicado.
Synopsis
m2c analyze --source COPIED_FILESYSTEM_PATH --plugin PLUGIN_NAME --output OUTPUT_DIR [options]
Bandeiras
-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 de plug-ins 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 ficheiros gerado pelo comando
m2c copy --volume localPath:remotePath- Monta um ficheiro ou um diretório no contentor no formato "localPath:remotePath". Pode ser especificado várias vezes
m2c cleanup
Limpar um sistema de ficheiros de origem criado pelo comando de cópia.
Synopsis
m2c cleanup -s SOURCE
Bandeiras
-s,--source path- O caminho para a origem criada por
m2c copy
m2c completion
Gere o script de preenchimento automático para o m2c para a shell especificada.
Consulte a ajuda de cada subcomando para ver detalhes sobre como usar o script gerado.
Synopsis
m2c completion
Comandos
| Comando | Descrição |
|---|---|
| m2c completion bash | Gere o script de preenchimento automático para bash |
| m2c completion fish | Gere o script de preenchimento automático para o fish |
| m2c completion powershell | Gere o script de preenchimento automático para o PowerShell |
| m2c completion zsh | Gere o script de preenchimento automático para zsh |
m2c completion bash
Gere o script de preenchimento automático para o shell bash.
Este script depende do pacote "bash-completion".
Se ainda não estiver instalado, pode instalá-lo através do gestor de pacotes do seu SO.
Para carregar conclusões na sua 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
Tem de iniciar uma nova shell para que esta configuração entre em vigor.
Synopsis
m2c completion bash
Bandeiras
--no-descriptions- desativar descrições de conclusão
m2c completion fish
Gere o script de preenchimento automático para o shell fish.
Para carregar conclusões na sua 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
Tem de iniciar uma nova shell para que esta configuração entre em vigor.
Synopsis
m2c completion fish
Bandeiras
--no-descriptions- desativar descrições de conclusão
m2c completion powershell
Gere o script de preenchimento automático para o PowerShell.
Para carregar conclusões na sua sessão de shell atual:
m2c completion powershell | Out-String | Invoke-Expression
Para carregar conclusões para cada nova sessão, adicione o resultado do comando acima
ao seu perfil do PowerShell.
Synopsis
m2c completion powershell
Bandeiras
--no-descriptions- desativar descrições de conclusão
m2c completion zsh
Gere o script de preenchimento automático para o shell zsh.
Se a conclusão de comandos não estiver ativada no seu ambiente, precisa de
para a ativar. Pode executar o seguinte uma vez:
echo "autoload -U compinit; compinit" >> ~/.zshrc
Para carregar conclusões na sua 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
Tem de iniciar uma nova shell para que esta configuração entre em vigor.
Synopsis
m2c completion zsh
Bandeiras
--no-descriptions- desativar descrições de conclusão
Configuração m2c
Ver e editar as propriedades de configuração.
Synopsis
m2c config COMMAND
Comandos
| Comando | Descrição |
|---|---|
| m2c config get | Imprima o valor de uma propriedade de configuração. |
| m2c config list | Imprima todas as propriedades de configuração e os respetivos valores. |
| m2c config set | Defina o valor de uma propriedade de configuração. |
| m2c config unset | Reponha uma propriedade de configuração para o respetivo valor predefinido. |
m2c config get
Imprima o valor de uma propriedade de configuração.
Synopsis
m2c config get KEY
Lista de configurações m2c
Imprima todas as propriedades de configuração e os respetivos valores.
Synopsis
m2c config list
m2c config set
Defina o valor de uma propriedade de configuração.
Synopsis
m2c config set KEY VALUE
m2c config unset
Reponha uma propriedade de configuração para o respetivo valor predefinido.
Synopsis
m2c config unset KEY
Cópia m2c
Copiar o sistema de ficheiros de uma VM localmente.
A cópia é feita através do rsync e pode ser realizada com o gcloud ou o SSH direto.
Synopsis
m2c copy COMMAND
Comandos
| Comando | Descrição |
|---|---|
| m2c copy default-filters | Mostrar os filtros rsync predefinidos usados pela operação de cópia |
| m2c copy gcloud | Copie o sistema de ficheiros de uma VM do Google Cloud localmente através do gcloud. |
| m2c copy ssh | Copie o sistema de ficheiros de uma VM para a máquina local através de SSH. |
m2c copy default-filters
Mostrar os filtros rsync predefinidos usados pela operação de cópia.
Pode usar isto como base para um ficheiro de filtros personalizados a fornecer através da flag --filters.
Synopsis
m2c copy default-filters
m2c copy gcloud
Copie o sistema de ficheiros de uma VM do Google Cloud localmente através do gcloud.
Synopsis
m2c copy gcloud -p,--project PROJECT_ID -z,--zone ZONE -n,--vm-name VM_NAME -o,--output OUTPUT_PATH [options]
Bandeiras
--filters path- O caminho para um ficheiro de filtros rsync personalizado. Substitui os filtros predefinidos
--internal-ip- Estabeleça ligação a instâncias através dos respetivos endereços IP internos em vez dos endereços IP externos. Use esta opção para estabelecer ligação de uma instância a outra na mesma rede VPC, através de uma ligação VPN ou entre duas redes VPC em intercâmbio. Para que esta ligação funcione, tem de configurar as suas redes e firewall para permitir ligações SSH ao endereço IP interno da instância à qual quer estabelecer ligação. Para saber como usar esta flag, consulte https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances .
-o,--output path- Caminho de saída do sistema de ficheiros copiado
-p,--project project- Projeto do Google Cloud
--remote-sudo- Use sudo no lado remoto do rsync.
Use esta opção se as credenciais que transmite não forem para o utilizador raiz.
A não execução como superutilizador impede a cópia de todo o sistema de ficheiros.
Equivalente a transmitir
--rsync-path 'sudo rsync'ao rsync. --tunnel-through-iap- Encaminhe a ligação SSH através do Cloud Identity-Aware Proxy para o encaminhamento de TCP. Para saber mais, consulte a documentação sobre o 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
Copie o sistema de ficheiros de uma VM para a máquina local através de SSH.
Synopsis
m2c copy ssh [USER@]HOST -o,--output OUTPUT_PATH [options]
Bandeiras
--filters path- O caminho para um ficheiro de filtros rsync personalizado. Substitui os filtros predefinidos
-i,--identity-file key- Um ficheiro que contém a chave para autenticação
-o,--output path- Caminho de saída do sistema de ficheiros copiado
--remote-sudo- Use sudo no lado remoto do rsync.
Use esta opção se as credenciais que transmite não forem para o utilizador raiz.
A não execução como superutilizador impede a cópia de todo o sistema de ficheiros.
Equivalente a transmitir
--rsync-path 'sudo rsync'ao rsync.
m2c generate
Gere artefactos de migração a partir do sistema de ficheiros fornecido.
Esta ação usa a configuração do plano de migração gerada por uma operação de análise anterior.
Synopsis
m2c generate -i ANALYSIS_DIRECTORY -o OUTPUT_PATH [options]
Bandeiras
-i,--input path- O caminho para um diretório gerado por "m2c analyze"
-o,--output path- O caminho de saída
--volume localPath:remotePath- Monta um ficheiro ou um diretório no contentor no formato "localPath:remotePath". Pode ser especificado várias vezes
m2c help
A ajuda fornece ajuda para qualquer comando na aplicação.
Basta escrever m2c help [caminho para o comando] para ver todos os detalhes.
Synopsis
m2c help [command]
m2c migrate-data
Migrar dados da máquina local para PVCs no cluster atualmente ligado de acordo com o plano de migração de dados.
Synopsis
m2c migrate-data -i INPUT_PATH [options]
Bandeiras
-i,--input path- O caminho para um diretório gerado pela análise m2c
-n,--namespace namespace- O espaço de nomes dos PVCs de destino no cluster de destino
Plugins m2c
Synopsis
m2c plugins COMMAND
Comandos
| Comando | Descrição |
|---|---|
| m2c plugins unpack | Importe plug-ins de um ficheiro local. |
m2c plugins unpack
Importe plug-ins de um ficheiro local.
Para transferir um ficheiro de pacote de plug-ins, consulte https://cloud.google.com/migrate/containers/docs/m2c-cli/prepare-for-migration .
Synopsis
m2c plugins unpack -i,--input PATH [options]
Bandeiras
-i,--input string- O caminho para o ficheiro de plug-ins
-r,--registry string- Um registo de contentores que está disponível para o cluster de destino. As imagens usadas pelo processo de migração de dados são enviadas para este registo para garantir que a migração de dados funciona sem extrair imagens da Internet.
Versão m2c
Imprima a versão da CLI.
Synopsis
m2c version