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:

1. Copia el sistema de archivos de la máquina de origen de forma local.

2. Analiza el sistema de archivos para crear un plan de modernización.

3. Edita el plan para personalizar los artefactos de modernización.

4. Genera los artefactos de modernización.

Sinopsis

m2c COMMAND [options]

Marcas

-q,--quiet

No mostrar nada

-v,--verbose

Mostrar un resultado detallado

Comandos

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

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

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

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

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