Documentation de référence sur la CLI Migrate to Containers pour Linux

m2c est un outil de ligne de commande qui vous permet de configurer et d'exécuter des migrations sur votre ordinateur local.

m2c

Il s'agit d'une interface de ligne de commande pour Migrate to Containers.

Vous suivez une procédure en quatre étapes pour moderniser rapidement votre charge de travail :

1. Vous copiez localement le système de fichiers de la machine source.

2. Vous analysez le système de fichiers pour créer un plan de modernisation.

3. Vous modifiez le plan pour personnaliser les artefacts de modernisation.

4. Vous générez les artefacts de modernisation.

Synopsis

m2c COMMAND [options]

Options

-q,--quiet

Ne rien afficher en sortie

-v,--verbose

Afficher une sortie détaillée

Commandes

Commande	Description
m2c analyze	Analyse la configuration de la charge de travail dans le système de fichiers donné.
m2c cleanup	Nettoie un système de fichiers source.
m2c completion	Générer le script de saisie semi-automatique pour l'interface système spécifiée
m2c config	Afficher et modifier les propriétés de configuration
m2c copy	Cette commande copie localement le système de fichiers d'une VM.
m2c generate	Cette commande génère des artefacts de migration à partir du système de fichiers spécifié.
m2c help	Affiche des informations d'aide sur les commandes.
m2c migrate-data	Migre des données depuis la machine locale vers des PVC.
Plugins m2c	Gérer les plug-ins de migration
m2c version	Imprime la version de la CLI.

m2c analyze

Cette commande analyse la configuration de la charge de travail dans le système de fichiers donné avec un plug-in donné.

Le plan de modernisation obtenu sera disponible dans le fichier config.yaml dans le répertoire de sortie donné.

Synopsis

m2c analyze --source COPIED_FILESYSTEM_PATH --plugin PLUGIN_NAME --output OUTPUT_DIR [options]

Options

-o,--output path

Chemin de sortie pouvant être utilisé en tant qu'entrée de la commande m2c generate

-r,--parameter name=value

Paramètres d'analyse du plug-in au format "name=value". Peut être spécifié plusieurs fois

-p,--plugin name

Nom du plug-in

-s,--source path

Chemin d'accès à un système de fichiers généré par la commande m2c copy

--volume localPath:remotePath

Crée un montage lié (bind mount) d'un fichier ou d'un répertoire dans le conteneur au format "localPath:remotePath". Peut être spécifié plusieurs fois

m2c cleanup

Nettoie un système de fichiers source créé par la commande de copie.

Synopsis

m2c cleanup -s SOURCE

Options

-s,--source path

Chemin d'accès à la source créé par m2c copy

m2c completion

Cette commande génère le script de saisie semi-automatique pour m2c pour l'interface système spécifiée.

Consultez l'aide de chaque sous-commande pour savoir comment utiliser le script généré.

Synopsis

m2c completion

Commandes

Commande	Description
m2c completion bash	Générer le script de saisie semi-automatique pour bash
m2c completion fish	Générer le script de saisie semi-automatique pour Fish
m2c completion powershell	Générer le script de saisie semi-automatique pour Powershell
m2c completion zsh	Générer le script de saisie semi-automatique pour zsh

m2c completion bash

Cette commande génère le script de saisie semi-automatique pour l'interface système bash.

Ce script dépend du package "bash-complete".

Si ce n'est pas déjà fait, vous pouvez l'installer via le gestionnaire de packages de votre système d'exploitation.

Pour charger les saisies semi-automatiques dans votre session d'interface système actuelle, procédez comme suit :

    source <(m2c completion bash)

Pour charger les saisies semi-automatiques à chaque nouvelle session, exécutez une fois la commande suivante :

Linux :

    m2c completion bash > /etc/bash_completion.d/m2c

macOS :

    m2c completion bash > $(brew --prefix)/etc/bash_completion.d/m2c

Vous devrez démarrer une nouvelle session d'interface système pour que cette configuration prenne effet.

Synopsis

m2c completion bash

Options

--no-descriptions

Désactiver les descriptions des saisies semi-automatiques

m2c completion fish

Cette commande génère le script de saisie semi-automatique pour l'interface système fish.

Pour charger les saisies semi-automatiques dans votre session d'interface système actuelle, procédez comme suit :

    m2c completion fish | source

Pour charger les saisies semi-automatiques à chaque nouvelle session, exécutez une fois la commande suivante :

    m2c completion fish > ~/.config/fish/completions/m2c.fish

Vous devrez démarrer une nouvelle session d'interface système pour que cette configuration prenne effet.

Synopsis

m2c completion fish

Options

--no-descriptions

Désactiver les descriptions des saisies semi-automatiques

m2c completion powershell

Cette commande génère le script de saisie semi-automatique pour PowerShell.

Pour charger les saisies semi-automatiques dans votre session d'interface système actuelle, procédez comme suit :

    m2c completion powershell | Out-String | Invoke-Expression

Pour charger les saisies semi-automatiques à chaque nouvelle session, ajoutez le résultat de la commande ci-dessus

à votre profil PowerShell.

Synopsis

m2c completion powershell

Options

--no-descriptions

Désactiver les descriptions des saisies semi-automatiques

m2c completion zsh

Cette commande génère le script de saisie semi-automatique pour l'interface système zsh.

Si la saisie semi-automatique n'est pas déjà activée pour l'interface système dans votre environnement, vous devrez

l'activer. Vous pouvez exécuter la commande suivante une fois :

    echo "autoload -U compinit; compinit" >> ~/.zshrc

Pour charger les saisies semi-automatiques dans votre session d'interface système actuelle, procédez comme suit :

    source <(m2c completion zsh)

Pour charger les saisies semi-automatiques à chaque nouvelle session, exécutez une fois la commande suivante :

Linux :

    m2c completion zsh > "${fpath[1]}/_m2c"

macOS :

    m2c completion zsh > $(brew --prefix)/share/zsh/site-functions/_m2c

Vous devrez démarrer une nouvelle session d'interface système pour que cette configuration prenne effet.

Synopsis

m2c completion zsh

Options

--no-descriptions

Désactiver les descriptions des saisies semi-automatiques

m2c config

Affiche et modifie les propriétés de configuration.

Synopsis

m2c config COMMAND

Commandes

Commande	Description
m2c config get	Imprime la valeur d'une propriété de configuration.
m2c config list	Imprime toutes les propriétés de configuration et leurs valeurs.
m2c config set	Définit la valeur d'une propriété de configuration.
m2c config unset	Rétablit la valeur par défaut d'une propriété de configuration.

m2c config get

Imprime la valeur d'une propriété de configuration.

Synopsis

m2c config get KEY

m2c config list

Imprime toutes les propriétés de configuration et leurs valeurs.

Synopsis

m2c config list

m2c config set

Définit la valeur d'une propriété de configuration.

Synopsis

m2c config set KEY VALUE

m2c config unset

Rétablit la valeur par défaut d'une propriété de configuration.

Synopsis

m2c config unset KEY

m2c copy

Cette commande copie localement le système de fichiers d'une VM.

La copie est effectuée via rsync et peut être réalisée à l'aide de gcloud ou d'une connexion SSH directe.

Synopsis

m2c copy COMMAND

Commandes

Commande	Description
m2c copy default-filters	Afficher les filtres rsync par défaut utilisés par l'opération de copie
m2c copy gcloud	Effectue une copie locale du système de fichiers d'une VM Google Cloud via gcloud.
m2c copy ssh	Copie le système de fichiers d'une VM sur l'ordinateur local via SSH.

m2c copy default-filters

Cette commande affiche les filtres rsync par défaut utilisés par l'opération de copie.

Cela peut servir de base pour un fichier de filtres personnalisés que vous fournissez via l'option "--filters".

Synopsis

m2c copy default-filters

m2c copy gcloud

Effectue une copie locale du système de fichiers d'une VM Google Cloud via gcloud.

Synopsis

m2c copy gcloud -p,--project PROJECT_ID -z,--zone ZONE -n,--vm-name VM_NAME -o,--output OUTPUT_PATH [options]

Options

--filters path

Chemin d'accès à un fichier de filtres rsync personnalisés. Remplace les filtres par défaut

--internal-ip

Connexion aux instances à l'aide de leurs adresses IP internes plutôt que de leurs adresses IP externes. Utilisez cette option pour vous connecter d'une instance à une autre sur le même réseau VPC, via une connexion VPN ou entre deux réseaux VPC appairés. Pour que cette connexion fonctionne, vous devez configurer vos réseaux et votre pare-feu pour autoriser les connexions SSH à l'adresse IP interne de l'instance à laquelle vous souhaitez vous connecter. Pour apprendre à utiliser cette option, consultez la page https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances.

-o,--output path

Chemin de sortie du système de fichiers copié

-p,--project project

Projet Google Cloud

--remote-sudo

Utiliser sudo du côté distant de rsync. Utilisez cette option si les identifiants que vous transmettez ne sont pas ceux de l'utilisateur racine. Si la commande n'est pas exécutée en tant que super-utilisateur, il n'est pas possible de copier l'ensemble du système de fichiers. Équivaut à transmettre --rsync-path 'sudo rsync' à rsync.

--tunnel-through-iap

Utiliser un tunnel de connexion SSH via Cloud Identity-Aware Proxy pour le transfert TCP. Pour en savoir plus, consultez la documentation IAP sur le transfert TCP ( https://cloud.google.com/iap/docs/tcp-forwarding-overview).

-n,--vm-name name

Nom de la VM

-z,--zone zone

Zone Google Cloud

m2c copy ssh

Copie le système de fichiers d'une VM sur l'ordinateur local via SSH.

Synopsis

m2c copy ssh [USER@]HOST -o,--output OUTPUT_PATH [options]

Options

--filters path

Chemin d'accès à un fichier de filtres rsync personnalisés. Remplace les filtres par défaut

-i,--identity-file key

Un fichier contenant la clé pour l'authentification

-o,--output path

Chemin de sortie du système de fichiers copié

--remote-sudo

Utiliser sudo du côté distant de rsync. Utilisez cette option si les identifiants que vous transmettez ne sont pas ceux de l'utilisateur racine. Si la commande n'est pas exécutée en tant que super-utilisateur, il n'est pas possible de copier l'ensemble du système de fichiers. Équivaut à transmettre --rsync-path 'sudo rsync' à rsync.

m2c generate

Cette commande génère des artefacts de migration à partir du système de fichiers spécifié.

Elle utilise la configuration du plan de migration générée par une opération d'analyse précédente.

Synopsis

m2c generate -i ANALYSIS_DIRECTORY -o OUTPUT_PATH [options]

Options

-i,--input path

Chemin d'accès à un répertoire généré par "m2c analyze"

-o,--output path

Chemin d'accès de sortie

--volume localPath:remotePath

Crée un montage lié (bind mount) d'un fichier ou d'un répertoire dans le conteneur au format "localPath:remotePath". Peut être spécifié plusieurs fois

m2c help

L'aide fournit une assistance pour toutes les commandes de l'application.

Il vous suffit de saisir "m2c help" [chemin d'accès à la commande] pour obtenir des informations détaillées.

Synopsis

m2c help [command]

m2c migrate-data

Migre les données de la machine locale vers les PVC du cluster actuellement connecté conformément au plan de migration de données.

Synopsis

m2c migrate-data -i INPUT_PATH [options]

Options

-i,--input path

Chemin d'accès à un répertoire généré par m2c analyze

-n,--namespace namespace

Espace de noms des PVC cibles sur le cluster cible

plug-ins m2c

Synopsis

m2c plugins COMMAND

Commandes

Commande	Description
m2c plugins unpack	Importer des plug-ins à partir d'un fichier local.

m2c plugins unpack

Importer des plug-ins à partir d'un fichier local.

Pour télécharger un fichier de groupe de plug-ins, consultez la page https://cloud.google.com/migrate/containers/docs/m2c-cli/prepare-for-migration.

Synopsis

m2c plugins unpack -i,--input PATH [options]

Options

-i,--input string

Chemin d'accès au fichier des plug-ins

-r,--registry string

Registre de conteneurs disponible pour le cluster cible. Les images utilisées par le processus de migration de données seront transférées vers ce registre afin de garantir le bon fonctionnement de la migration des données sans extraire d'images d'Internet.

m2c version

Imprime la version de la CLI.

Synopsis

m2c version