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 para tu carga de trabajo mediante un recorrido de cuatro pasos:
Copia el sistema de archivos de la máquina de origen de manera 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 generes nada
-v,--verbose
- Muestra un resultado detallado
Comandos
Comando | Descripción |
---|---|
m2c analyze | Analiza la configuración de la carga de trabajo en el sistema de archivos determinado. |
Limpieza de m2c | Limpia un sistema de archivos fuente. |
m2c completion | Genera la secuencia de comandos de autocompletado para la shell especificada |
m2c config | Visualiza 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 a partir del 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 con 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 generado por el comando
m2c copy
--volume localPath:remotePath
- Bind activa un archivo o directorio en el contenedor con el formato "localPath:remotePath". Se puede especificar varias veces
Limpieza de m2c
Limpia un sistema de archivos fuente que creó el comando de copia.
Sinopsis
m2c cleanup -s SOURCE
Marcas
-s,--source path
- La ruta de acceso a la fuente creada por
m2c copy
m2c completion
Genera la secuencia de comandos de autocompletado para m2c en 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 mediante el administrador de paquetes de tu SO.
Para cargar finalizaciones en tu sesión de shell actual, haz lo siguiente:
source <(m2c completion bash)
Para cargar las finalizaciones de cada sesión nueva, ejecuta una vez:
Linux:
m2c completion bash > /etc/bash_completion.d/m2c
macOS:
m2c completion bash > $(brew --prefix)/etc/bash_completion.d/m2c
Deberás iniciar una shell nueva 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 finalizaciones en tu sesión de shell actual, haz lo siguiente:
m2c completion fish | source
Para cargar las finalizaciones de cada sesión nueva, ejecuta una vez:
m2c completion fish > ~/.config/fish/completions/m2c.fish
Deberás iniciar una shell nueva 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 finalizaciones en tu sesión de shell actual, 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 finalizaciones en tu sesión de shell actual, haz lo siguiente:
source <(m2c completion zsh)
Para cargar las finalizaciones de cada sesión nueva, ejecuta una vez:
Linux:
m2c completion zsh > "${fpath[1]}/_m2c"
macOS:
m2c completion zsh > $(brew --prefix)/share/zsh/site-functions/_m2c
Deberás iniciar una shell nueva 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 un sistema de archivos de VM de Google Cloud de forma local en gcloud. |
m2c copy ssh | Copia el sistema de archivos de una VM a la máquina local mediante ssh. |
m2c copy default-filters
Muestra los filtros de rsync predeterminados que usa la operación de copia.
Se puede usar 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 un sistema de archivos de VM de Google Cloud de forma local en 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 de acceso a un archivo de filtros de rsync personalizado. Anula los filtros predeterminados
--internal-ip
- Conéctate a 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 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 podrá copiar 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 a la máquina local mediante ssh.
Sinopsis
m2c copy ssh [USER@]HOST -o,--output OUTPUT_PATH [options]
Marcas
--filters path
- La ruta de acceso a un archivo de filtros de rsync personalizado. Anula los filtros predeterminados
-i,--identity-file key
- Un archivo que contiene la clave para la 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 podrá copiar todo el sistema de archivos.
Equivalente a pasar
--rsync-path 'sudo rsync'
a rsync.
m2c generate
Genera artefactos de migración a partir del sistema de archivos determinado.
Esto usa 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 generado por “m2c parse”
-o,--output path
- La ruta de salida
--volume localPath:remotePath
- Bind 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.
Solo escribe m2c help (ruta al comando) 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 a un directorio generado por el análisis de m2c
-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 |
---|---|
Complementos de m2c unpack | Importa complementos desde un archivo local. |
Complementos m2c descomprimir
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 del 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