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 :
Vous copiez localement le système de fichiers de la machine source.
Vous analysez le système de fichiers pour créer un plan de modernisation.
Vous modifiez le plan pour personnaliser les artefacts de modernisation.
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