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 Imprime toutes les propriétés de configuration et leurs valeurs.
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 "m2canalyze"
-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