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

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

É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 EC2 instances et les sous-réseaux). 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. EC2les instances dotées d'une protected_instance balise sont protégées contre les événements de scale-in. Ajoutez une protected_instance balise à chaque EC2 instance que vous souhaitez protéger contre les événements d'extension. Non Booléen FALSE
--command-logs-bucket Le nom d'un compartiment S3 existant pour 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 à la fois pour --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.