Étape 3 : configurer votre environnement pour exécuter le script

Configurez votre environnement pour exécuter le script à l'aide de la commande suivante.

pipenv install -r requirements.txt
pipenv shell

Note

À l'heure actuelle, le script ne peut fournir que des applications monocouches dans le gestionnaire d'applications. Par exemple, si vous exécutez le script deux fois pour deux couches d'une même pile, le script crée deux applications différentes dans Application Manager.

Après avoir configuré votre environnement, passez en revue les paramètres du script. Vous pouvez consulter les options disponibles pour le script de migration en exécutant la python3 stack_exporter.py --help commande.

Paramètre	Description	Obligatoire	Type	Valeur par défaut
--layer-id	Exporte un CloudFormation modèle pour cet ID de OpsWorks couche.	Oui	chaîne
--region	La AWS région de la OpsWorks pile. Si votre région de OpsWorks pile et votre région de point de terminaison d'API sont différentes, utilisez la région de pile. Il s'agit de la même région que les autres ressources de votre OpsWorks pile (par exemple, les instances et les sous-réseaux EC2).	Non	chaîne	us-east-1
--provision-application	Par défaut, le script approvisionne l'application exportée par le CloudFormation modèle. Transmettez ce paramètre au script avec la valeur FALSE pour ignorer le provisionnement du CloudFormation modèle.	Non	Booléen	TRUE
--launch-template	Ce paramètre définit s'il faut utiliser un modèle de lancement existant ou créer un nouveau modèle de lancement. Vous pouvez créer un nouveau modèle de lancement qui utilise les propriétés d'instance recommandées ou qui utilise des propriétés d'instance correspondant à une instance en ligne. Les valeurs valides sont les suivantes : RECOMMENDED- Utilise les caractéristiques d'instance de la dernière AMI pour le système d'exploitation de la OpsWorks pile et une taille d'instance c5.large. MATCH_LAST_INSTANCE- Utilise les dernières caractéristiques des instances en ligne disponibles. LaunchTemplateID/[LaunchTemplateVersion]- Utilise un modèle de lancement existant. Vous pouvez éventuellement fournir une version du modèle. Si vous ne fournissez pas de version de modèle, le script utilise la version par défaut.	Non	chaîne	RECOMMENDED
--system-updates	Définit s'il faut effectuer des mises à jour du noyau et du package lors du démarrage de l'instance. Les valeurs valides sont les suivantes : ALL_UPDATES- Effectue les mises à jour du système pour le noyau et les packages au démarrage de l'instance. NO_UPDATES- N'effectue pas de mises à jour du système au démarrage de l'instance. MATCH_LAYER_SETTINGS- Utilise la InstallUpdatesOnBoot propriété de la OpsWorks couche ou de l'instance pour déterminer s'il faut installer les mises à jour du système.	Non	chaîne	ALL_UPDATES
--http-username	Nom du SecureString paramètre Systems Manager qui stocke le nom d'utilisateur utilisé pour s'authentifier auprès de l'archive HTTP contenant les livres de recettes personnalisés.	Non	chaîne
--http-password	Nom du SecureString paramètre Systems Manager qui stocke le mot de passe utilisé pour s'authentifier auprès de l'archive HTTP contenant les livres de recettes personnalisés.	Non	chaîne
--repo-private-key	Nom du SecureString paramètre Systems Manager qui stocke la clé SSH utilisée pour s'authentifier auprès du référentiel contenant les livres de recettes personnalisés. Si le dépôt est activé GitHub, vous devez générer une nouvelle clé Ed25519 SSH. Si vous ne générez pas de nouvelle clé Ed25519 SSH, la connexion au GitHub dépôt échoue.	Non	chaîne
--lb-type	Le type d'équilibreur de charge, le cas échéant, à créer lors de la migration de votre équilibreur de charge existant. Les valeurs valides sont les suivantes : ALB(Application Load Balancer) Classis(Classic Load Balancer) None(si vous ne souhaitez pas créer d'équilibreur de charge)	Non	chaîne	ALB
--lb-access-logs-path	Chemin d'accès à un compartiment S3 existant et préfixe pour stocker les journaux d'accès à l'équilibreur de charge. Le compartiment S3 et l'équilibreur de charge doivent se trouver dans la même région. Si vous ne fournissez aucune valeur et que la valeur du --lb-type paramètre est définie surNone, le script crée un nouveau compartiment et un nouveau préfixe S3. Assurez-vous qu'il existe une politique de compartiment appropriée pour ce préfixe.	Non	chaîne
--enable-instance-protection	S'il est défini surTRUE, le script crée une politique de résiliation personnalisée (fonction Lambda) pour votre groupe Auto Scaling. Les instances EC2 dotées d'une protected_instance balise sont protégées contre les événements d'extension. Ajoutez une protected_instance balise à chaque instance EC2 que vous souhaitez protéger contre les événements de montée en puissance.	Non	Booléen	FALSE
--command-logs-bucket	Le nom d'un compartiment S3 existant dans lequel stocker les MountEBSVolumes journaux AWS ApplyChefRecipe et. Si vous ne fournissez aucune valeur, le script crée un nouveau compartiment S3.	Non	chaîne	aws-opsworks-application-manager-logs-account-id
--custom-json-bucket	Le nom d'un compartiment S3 existant pour stocker le JSON personnalisé. Si vous ne fournissez aucune valeur, le script crée un nouveau compartiment S3.	Non	chaîne	aws-apply-chef-application-manager-transition-data-account-id

Remarques :

• Si vous utilisez un GitHub dépôt privé, vous devez créer une nouvelle clé d'Ed25519hôte pour SSH. Cela est dû au fait que les clés prises en charge par SSH ont été GitHub modifiées et le protocole Git non chiffré a été supprimé. Pour plus d'informations sur la clé Ed25519 d'hôte, consultez le billet de GitHub blog Améliorer la sécurité du protocole Git sur GitHub. Après avoir généré une nouvelle clé Ed25519 d'hôte, créez un SecureString paramètre Systems Manager pour la clé SSH et utilisez le nom du SecureString paramètre comme valeur du --repo-private-key paramètre. Pour plus d'informations sur la création d'un SecureString paramètre Systems Manager, voir Create a SecureString parameter (AWS CLI) ou Create a Systems Manager parameter (console) dans le Guide de AWS Systems Manager l'utilisateur.

• Les --http-username --repo-private-key paramètres --http-password et font référence au nom d'un SecureString paramètre de Systems Manager. Le script de migration utilise ces paramètres lorsque vous exécutez le AWS-ApplyChefRecipes document.

• Le --http-username paramètre nécessite également que vous spécifiiez une valeur pour le --http-password paramètre.

• Le --http-password paramètre nécessite également que vous spécifiiez une valeur pour le --http-username paramètre.

• Ne définissez pas de valeurs pour les deux --http-password et--repo-private-key. Indiquez soit le nom du SecureString paramètre Systems Manager correspondant à une clé SSH (--repo-private-key), soit le nom d'utilisateur (--http-username) et le mot de passe (--http-password) du référentiel.