Referencia de la CLI de Migrate to Containers para Linux
m2c es una herramienta de línea de comandos que te permite configurar y ejecutar migraciones en tu máquina local.
m2c
Una interfaz de línea de comandos para Migrate to Containers.
Moderniza rápidamente tu carga de trabajo siguiendo un proceso de cuatro pasos:
Copia el sistema de archivos de la máquina de origen de forma local.
Analiza el sistema de archivos para crear un plan de modernización.
Edita el plan para personalizar los artefactos de modernización.
Genera los artefactos de modernización.
Sinopsis
m2c COMMAND [options]
Banderas
-q,--quiet- No muestra nada
-v,--verbose- Mostrar salida detallada
Comandos
| Comando | Descripción |
|---|---|
| m2c analyze | Analiza la configuración de la carga de trabajo en el sistema de archivos indicado. |
| Limpieza de m2c | Limpiar un sistema de archivos de origen. |
| m2c completion | Genera la secuencia de comandos de autocompletado para el shell especificado. |
| Configuración de m2c | Ver y editar propiedades de configuración |
| m2c copy | Copia el sistema de archivos de una VM de forma local. |
| m2c generate | Genera artefactos de migración a partir del sistema de archivos proporcionado. |
| m2c help | Ayuda sobre cualquier comando |
| m2c migrate-data | Migra los datos del equipo local a los PVCs. |
| Complementos m2c | Gestionar complementos de migración |
| Versión m2c | Imprime la versión de la CLI. |
m2c analyze
Analiza la configuración de la carga de trabajo en el sistema de archivos proporcionado con un complemento determinado.
El plan de modernización resultante estará disponible en el archivo config.yaml del directorio de salida especificado.
Sinopsis
m2c analyze --source COPIED_FILESYSTEM_PATH --plugin PLUGIN_NAME --output OUTPUT_DIR [options]
Banderas
-o,--output path- Ruta de salida que se puede usar como entrada para el comando
m2c generate -r,--parameter name=value- Parámetros de análisis de complementos con el formato "nombre=valor". Se puede especificar varias veces
-p,--plugin name- Nombre del complemento
-s,--source path- La ruta a un sistema de archivos generado por el comando
m2c copy --volume localPath:remotePath- Monta un archivo o un directorio en el contenedor con el formato "localPath:remotePath". Se puede especificar varias veces
Limpieza de m2c
Limpia un sistema de archivos de origen que se haya creado con el comando de copia.
Sinopsis
m2c cleanup -s SOURCE
Banderas
-s,--source path- Ruta a la fuente creada por
m2c copy
m2c completion
Genera la secuencia de comandos de autocompletado para m2c en el shell especificado.
Consulta la ayuda de cada subcomando para obtener información sobre cómo usar la secuencia de comandos generada.
Sinopsis
m2c completion
Comandos
| Comando | Descripción |
|---|---|
| m2c completion bash | Generar la secuencia de comandos de autocompletado para bash |
| m2c completion fish | Generar la secuencia de comandos de autocompletado para fish |
| m2c completion powershell | Generar la secuencia de comandos de autocompletado para PowerShell |
| m2c completion zsh | Generar la secuencia de comandos de autocompletado para zsh |
m2c completion bash
Genera la secuencia de comandos de autocompletado para el shell bash.
Esta secuencia de comandos depende del paquete "bash-completion".
Si aún no está instalado, puedes instalarlo a través del gestor de paquetes de tu sistema operativo.
Para cargar las autocompletaciones en la sesión de shell actual, haz lo siguiente:
source <(m2c completion bash)
Para cargar las finalizaciones en cada sesión nueva, ejecuta el siguiente comando una vez:
Linux:
m2c completion bash > /etc/bash_completion.d/m2c
macOS:
m2c completion bash > $(brew --prefix)/etc/bash_completion.d/m2c
Para que esta configuración surta efecto, tendrás que iniciar un shell nuevo.
Sinopsis
m2c completion bash
Banderas
--no-descriptions- Desactivar las descripciones de las finalizaciones
m2c completion fish
Genera la secuencia de comandos de autocompletado para el shell fish.
Para cargar las autocompletaciones en la sesión de shell actual, haz lo siguiente:
m2c completion fish | source
Para cargar las finalizaciones en cada sesión nueva, ejecuta el siguiente comando una vez:
m2c completion fish > ~/.config/fish/completions/m2c.fish
Para que esta configuración surta efecto, tendrás que iniciar un shell nuevo.
Sinopsis
m2c completion fish
Banderas
--no-descriptions- Desactivar las descripciones de las finalizaciones
m2c completion powershell
Genera la secuencia de comandos de autocompletado para PowerShell.
Para cargar las autocompletaciones en la sesión de shell actual, haz lo siguiente:
m2c completion powershell | Out-String | Invoke-Expression
Para cargar las finalizaciones en cada sesión nueva, añade el resultado del comando anterior
a tu perfil de PowerShell.
Sinopsis
m2c completion powershell
Banderas
--no-descriptions- Desactivar las descripciones de las finalizaciones
m2c completion zsh
Genera la secuencia de comandos de autocompletado para el shell zsh.
Si la función de autocompletado de shell no está habilitada en tu entorno, tendrás que
para habilitarlo. Puedes ejecutar lo siguiente una vez:
echo "autoload -U compinit; compinit" >> ~/.zshrc
Para cargar las autocompletaciones en la sesión de shell actual, haz lo siguiente:
source <(m2c completion zsh)
Para cargar las finalizaciones en cada sesión nueva, ejecuta el siguiente comando una vez:
Linux:
m2c completion zsh > "${fpath[1]}/_m2c"
macOS:
m2c completion zsh > $(brew --prefix)/share/zsh/site-functions/_m2c
Para que esta configuración surta efecto, tendrás que iniciar un shell nuevo.
Sinopsis
m2c completion zsh
Banderas
--no-descriptions- Desactivar las descripciones de las finalizaciones
Configuración de m2c
Ver y editar las propiedades de configuración.
Sinopsis
m2c config COMMAND
Comandos
| Comando | Descripción |
|---|---|
| m2c config get | Imprime el valor de una propiedad de configuración. |
| Lista de configuración de m2c | Imprime todas las propiedades de configuración y sus valores. |
| m2c config set | Define el valor de una propiedad de configuración. |
| m2c config unset | Restablece el valor predeterminado de una propiedad de configuración. |
m2c config get
Imprime el valor de una propiedad de configuración.
Sinopsis
m2c config get KEY
Lista de configuración de m2c
Imprime todas las propiedades de configuración y sus valores.
Sinopsis
m2c config list
m2c config set
Define el valor de una propiedad de configuración.
Sinopsis
m2c config set KEY VALUE
m2c config unset
Restablece el valor predeterminado de una propiedad de configuración.
Sinopsis
m2c config unset KEY
m2c copy
Copia el sistema de archivos de una VM de forma local.
La copia se realiza mediante rsync y se puede llevar a cabo con gcloud o SSH directo.
Sinopsis
m2c copy COMMAND
Comandos
| Comando | Descripción |
|---|---|
| m2c copy default-filters | Muestra los filtros rsync predeterminados que utiliza la operación de copia. |
| m2c copy gcloud | Copia localmente el sistema de archivos de una VM de Google Cloud mediante gcloud. |
| m2c copy ssh | Copia el sistema de archivos de una VM en el equipo local a través de SSH. |
m2c copy default-filters
Muestra los filtros rsync predeterminados que utiliza la operación de copia.
Se puede usar como base para un archivo de filtros personalizados que se proporciona mediante la marca --filters.
Sinopsis
m2c copy default-filters
m2c copy gcloud
Copia localmente el sistema de archivos de una VM de Google Cloud mediante gcloud.
Sinopsis
m2c copy gcloud -p,--project PROJECT_ID -z,--zone ZONE -n,--vm-name VM_NAME -o,--output OUTPUT_PATH [options]
Banderas
--filters path- Ruta a un archivo de filtros rsync personalizado. Anula los filtros predeterminados
--internal-ip- Conéctate a las instancias mediante sus direcciones IP internas en lugar de sus direcciones IP externas. Úsalo para conectarte de una instancia a otra en la misma red de VPC, a través de una conexión VPN o entre dos redes de VPC emparejadas. Para que esta conexión funcione, debes configurar tus redes y tu cortafuegos para permitir las conexiones SSH a la dirección IP interna de la instancia a la que quieras conectarte. Para saber cómo usar esta marca, consulta https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances .
-o,--output path- Ruta de salida del sistema de archivos copiado
-p,--project project- Proyecto de Google Cloud
--remote-sudo- Usa sudo en el lado remoto de rsync.
Usa esta opción si las credenciales que proporcionas no son las del usuario raíz.
Si no se ejecuta como superusuario, no se podrá copiar todo el sistema de archivos.
Equivale a pasar opción
--rsync-path 'sudo rsync'a rsync. --tunnel-through-iap- Encamina la conexión SSH a través de Cloud Identity-Aware Proxy para el reenvío de TCP. Para obtener más información, consulta la documentación de IAP para el reenvío de TCP ( https://cloud.google.com/iap/docs/tcp-forwarding-overview).
-n,--vm-name name- Nombre de la VM
-z,--zone zone- Zona de Google Cloud
m2c copy ssh
Copia el sistema de archivos de una VM en el equipo local a través de SSH.
Sinopsis
m2c copy ssh [USER@]HOST -o,--output OUTPUT_PATH [options]
Banderas
--filters path- Ruta a un archivo de filtros rsync personalizado. Anula los filtros predeterminados
-i,--identity-file key- Un archivo que contiene la clave de autenticación
-o,--output path- Ruta de salida del sistema de archivos copiado
--remote-sudo- Usa sudo en el lado remoto de rsync.
Usa esta opción si las credenciales que proporcionas no son las del usuario raíz.
Si no se ejecuta como superusuario, no se podrá copiar todo el sistema de archivos.
Equivale a pasar opción
--rsync-path 'sudo rsync'a rsync.
m2c generate
Genera artefactos de migración a partir del sistema de archivos proporcionado.
Para ello, se utiliza la configuración del plan de migración generada por una operación de análisis anterior.
Sinopsis
m2c generate -i ANALYSIS_DIRECTORY -o OUTPUT_PATH [options]
Banderas
-i,--input path- Ruta a un directorio generado por "m2c analyze"
-o,--output path- La ruta de salida
--volume localPath:remotePath- Monta un archivo o un directorio en el contenedor con el formato "localPath:remotePath". Se puede especificar varias veces
Ayuda de m2c
Ayuda proporciona ayuda para cualquier comando de la aplicación.
Solo tienes que escribir m2c help [ruta al comando] para obtener información detallada.
Sinopsis
m2c help [command]
m2c migrate-data
Migra los datos de la máquina local a los PVCs del clúster conectado según el plan de migración de datos.
Sinopsis
m2c migrate-data -i INPUT_PATH [options]
Banderas
-i,--input path- Ruta a un directorio generado por m2c analyze
-n,--namespace namespace- El espacio de nombres de los PVC de destino en el clúster de destino
Complementos m2c
Sinopsis
m2c plugins COMMAND
Comandos
| Comando | Descripción |
|---|---|
| m2c plugins unpack | Importar complementos desde un archivo local. |
m2c plugins unpack
Importar complementos desde un archivo local.
Para descargar un archivo de paquete de complementos, consulta https://cloud.google.com/migrate/containers/docs/m2c-cli/prepare-for-migration .
Sinopsis
m2c plugins unpack -i,--input PATH [options]
Banderas
-i,--input string- Ruta del archivo de complementos
-r,--registry string- Un registro de contenedores que esté disponible para el clúster de destino. Las imágenes que se usen en el proceso de migración de datos se enviarán a este registro para que la migración de datos funcione sin descargar imágenes de Internet.
Versión m2c
Imprime la versión de la CLI.
Sinopsis
m2c version