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.
Realiza una modernización rápida de tu carga de trabajo mediante el siguiente recorrido 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]
Marcas
-q,--quiet- No mostrar nada
-v,--verbose- Mostrar un resultado detallado
Comandos
| Comando | Descripción |
|---|---|
| m2c analyze | Analiza la configuración de la carga de trabajo en el sistema de archivos determinado. |
| m2c cleanup | Limpia un sistema de archivos de origen. |
| m2c completion | Genera la secuencia de comandos de autocompletado para la shell especificada |
| m2c config | Ve y edita las propiedades de configuración |
| m2c copy | Copia el sistema de archivos de una VM de forma local. |
| m2c generate | Genera artefactos de migración desde el sistema de archivos determinado. |
| m2c help | Ofrece ayuda sobre cualquier comando. |
| m2c migrate-data | Migra datos desde la máquina local a PVC. |
| Complementos de m2c | Administra complementos de migración |
| m2c version | Imprime la versión de la CLI. |
m2c analyze
Analiza la configuración de la carga de trabajo en un sistema de archivos determinado con un complemento determinado
El plan de modernización resultante estará disponible en el archivo config.yaml en el directorio de salida determinado.
Sinopsis
m2c analyze --source COPIED_FILESYSTEM_PATH --plugin PLUGIN_NAME --output OUTPUT_DIR [options]
Marcas
-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 en el formato "name=value". Se puede especificar varias veces
-p,--plugin name- Nombre del complemento
-s,--source path- La ruta a un sistema de archivos que genera el comando
m2c copy --volume localPath:remotePath- Activa un archivo o directorio en el contenedor con el formato “localPath:remotePath”. Se puede especificar varias veces
m2c cleanup
Limpia un sistema de archivos de origen que creó el comando de copia.
Sinopsis
m2c cleanup -s SOURCE
Marcas
-s,--source path- La ruta de acceso a la fuente que creó
m2c copy
m2c completion
Genera la secuencia de comandos de autocompletado para m2c para la shell especificada.
Consulta la ayuda de cada subcomando para obtener detalles sobre cómo usar la secuencia de comandos generada.
Sinopsis
m2c completion
Comandos
| Comando | Descripción |
|---|---|
| m2c completion bash | Genera la secuencia de comandos de autocompletado para bash |
| m2c completion fish | Genera la secuencia de comandos de autocompletado para fish |
| m2c completion powershell | Genera la secuencia de comandos de autocompletado para powerShell |
| m2c completion zsh | Genera la secuencia de comandos de autocompletado para zsh |
m2c completion bash
Genera la secuencia de comandos de autocompletado para la shell bash.
Esta secuencia de comandos depende del paquete “bash-completion”.
Si aún no está instalado, puedes hacerlo a través del administrador de paquetes de tu SO.
Para cargar las finalizaciones en tu sesión actual de shell, haz lo siguiente:
source <(m2c completion bash)
Para cargar las finalizaciones en cada sesión nueva, ejecuta una vez lo siguiente:
Linux:
m2c completion bash > /etc/bash_completion.d/m2c
macOS:
m2c completion bash > $(brew --prefix)/etc/bash_completion.d/m2c
Deberás iniciar una nueva shell para que se aplique esta configuración.
Sinopsis
m2c completion bash
Marcas
--no-descriptions- Inhabilita las descripciones de finalización
m2c completion fish
Genera la secuencia de comandos de autocompletado para la shell fish.
Para cargar las finalizaciones en tu sesión actual de shell, haz lo siguiente:
m2c completion fish | source
Para cargar las finalizaciones en cada sesión nueva, ejecuta una vez lo siguiente:
m2c completion fish > ~/.config/fish/completions/m2c.fish
Deberás iniciar una nueva shell para que se aplique esta configuración.
Sinopsis
m2c completion fish
Marcas
--no-descriptions- Inhabilita las descripciones de finalización
m2c completion powershell
Genera la secuencia de comandos de autocompletado para powerShell.
Para cargar las finalizaciones en tu sesión actual de shell, haz lo siguiente:
m2c completion powershell | Out-String | Invoke-Expression
Para cargar las finalizaciones en cada sesión nueva, agrega el resultado del comando anterior
a tu perfil de powerShell.
Sinopsis
m2c completion powershell
Marcas
--no-descriptions- Inhabilita las descripciones de finalización
m2c completion zsh
Genera la secuencia de comandos de autocompletado para la shell zsh.
Si la finalización de shell aún no está habilitada en tu entorno, necesitarás
para habilitarla. Puedes ejecutar lo siguiente una vez:
echo "autoload -U compinit; compinit" >> ~/.zshrc
Para cargar las finalizaciones en tu sesión actual de shell, haz lo siguiente:
source <(m2c completion zsh)
Para cargar las finalizaciones en cada sesión nueva, ejecuta una vez lo siguiente:
Linux:
m2c completion zsh > "${fpath[1]}/_m2c"
macOS:
m2c completion zsh > $(brew --prefix)/share/zsh/site-functions/_m2c
Deberás iniciar una nueva shell para que se aplique esta configuración.
Sinopsis
m2c completion zsh
Marcas
--no-descriptions- Inhabilita las descripciones de finalización
m2c config
Visualiza y edita las propiedades de configuración
Sinopsis
m2c config COMMAND
Comandos
| Comando | Descripción |
|---|---|
| m2c config get | Permite imprimir el valor de una propiedad de configuración. |
| m2c config list | Permite imprimir todas las propiedades de configuración y sus valores. |
| m2c config set | Permite establecer el valor de una propiedad de configuración. |
| m2c config unset | Permite restablecer una propiedad de configuración al valor predeterminado, usa el siguiente comando. |
m2c config get
Permite imprimir el valor de una propiedad de configuración.
Sinopsis
m2c config get KEY
m2c config list
Permite imprimir todas las propiedades de configuración y sus valores.
Sinopsis
m2c config list
m2c config set
Permite establecer el valor de una propiedad de configuración.
Sinopsis
m2c config set KEY VALUE
m2c config unset
Permite restablecer una propiedad de configuración al valor predeterminado, usa el siguiente comando.
Sinopsis
m2c config unset KEY
m2c copy
Copia el sistema de archivos de una VM de forma local.
La copia se realiza a través de rsync y se puede realizar con gcloud o SSH directo.
Sinopsis
m2c copy COMMAND
Comandos
| Comando | Descripción |
|---|---|
| m2c copy default-filters | Muestra los filtros de rsync predeterminados que usa la operación de copia |
| m2c copy gcloud | Copia el sistema de archivos de una VM de Google Cloud de forma local a través de gcloud. |
| m2c copy ssh | Copia el sistema de archivos de una VM en la máquina local a través de ssh. |
m2c copy default-filters
Muestra los filtros de rsync predeterminados que usa la operación de copia.
Se puede utilizar como base para que se proporcione un archivo de filtros personalizados a través de la marca --filters.
Sinopsis
m2c copy default-filters
m2c copy gcloud
Copia el sistema de archivos de una VM de Google Cloud de forma local a través de gcloud.
Sinopsis
m2c copy gcloud -p,--project PROJECT_ID -z,--zone ZONE -n,--vm-name VM_NAME -o,--output OUTPUT_PATH [options]
Marcas
--filters path- La ruta a un archivo de filtros rsync personalizado. Anula los filtros predeterminados
--internal-ip- Conéctate a las instancias con sus direcciones IP internas en lugar de con sus direcciones IP externas. Úsala para conectarte de una instancia a otra en la misma red de VPC, a través de una conexión de VPN o entre dos redes de VPC con intercambio de tráfico. Para que esta conexión funcione, debes configurar las redes y el firewall para permitir conexiones SSH a la dirección IP interna de la instancia a la que deseas conectarte. Para obtener información sobre cómo usar esta marca, consulta https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances.
-o,--output path- Ruta de acceso 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 pasas no son para el usuario raíz.
Si no se ejecuta como superusuario, no se copia todo el sistema de archivos.
Equivalente a pasar
--rsync-path 'sudo rsync'a rsync. --tunnel-through-iap- Canaliza la conexión ssh a través de Cloud Identity-Aware Proxy para el redireccionamiento de TCP. Para obtener más información, consulta la documentación de IAP para el redireccionamiento de TCP (https://cloud.google.com/iap/docs/tcp-forwarding-overview).
-n,--vm-name name- VM name
-z,--zone zone- Zona de Google Cloud
m2c copy ssh
Copia el sistema de archivos de una VM en la máquina local a través de ssh.
Sinopsis
m2c copy ssh [USER@]HOST -o,--output OUTPUT_PATH [options]
Marcas
--filters path- La 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 acceso 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 pasas no son para el usuario raíz.
Si no se ejecuta como superusuario, no se copia todo el sistema de archivos.
Equivalente a pasar
--rsync-path 'sudo rsync'a rsync.
m2c generate
Genera artefactos de migración desde el sistema de archivos determinado.
Esto utiliza la configuración del plan de migración que generó una operación de análisis anterior.
Sinopsis
m2c generate -i ANALYSIS_DIRECTORY -o OUTPUT_PATH [options]
Marcas
-i,--input path- La ruta a un directorio que genera el “análisis de m2c”
-o,--output path- La ruta de salida
--volume localPath:remotePath- Activa un archivo o directorio en el contenedor con el formato “localPath:remotePath”. Se puede especificar varias veces
m2c help
Ayuda proporciona ayuda para cualquier comando en la aplicación.
Simplemente escribe m2c help [path to command] para obtener todos los detalles.
Sinopsis
m2c help [command]
m2c migrate-data
Migra datos de la máquina local a PVC en el clúster conectado actualmente según el plan de migración de datos.
Sinopsis
m2c migrate-data -i INPUT_PATH [options]
Marcas
-i,--input path- La ruta de acceso 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 de m2c
Sinopsis
m2c plugins COMMAND
Comandos
| Comando | Descripción |
|---|---|
| m2c plugins unpack | Importa complementos desde un archivo local. |
m2c plugins unpack
Importa 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]
Marcas
-i,--input string- La ruta de acceso al archivo de complementos
-r,--registry string- Un registro de contenedores que está disponible para el clúster de destino. Las imágenes que usa el proceso de migración de datos se enviarán a este registro para garantizar que la migración de datos funcione sin extraer imágenes de Internet.
m2c version
Imprime la versión de la CLI.
Sinopsis
m2c version