Installation de livres de recettes personnalisés - AWS OpsWorks
Définition d'un référentiel de livres de recettes personnalisé

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.

Installation de livres de recettes personnalisés

Important

Le AWS OpsWorks Stacks service a atteint sa fin de vie le 26 mai 2024 et a été désactivé tant pour les nouveaux clients que pour les clients existants. Nous recommandons vivement aux clients de migrer leurs charges de travail vers d'autres solutions dès que possible. Si vous avez des questions sur la migration, contactez l' AWS Support équipe sur AWS Re:Post ou via le AWS Support Premium.

Pour qu'une pile installe et utilise des livres de recettes personnalisés, vous devez configurer la pile de façon à ce qu'elle accepte les livres personnalisés, si ce n'est déjà fait. Vous devez ensuite fournir l'URL de référentiel et les informations connexes, par exemple un mot de passe.

Important

Une fois que vous avez configuré la pile pour prendre en charge les livres de recettes personnalisés, AWS OpsWorks Stacks installe automatiquement vos livres de recettes sur toutes les nouvelles instances au démarrage. Cependant, vous devez explicitement demander à AWS OpsWorks Stacks d'installer des livres de recettes nouveaux ou mis à jour sur toutes les instances existantes en exécutant la commande Update Custom Cookbooks stack. Pour plus d’informations, consultez Mise à jour des livres de recettes personnalisés. Avant d'activer Use custom Chef cookbooks (Utiliser les livres de recettes Chef personnalisés) sur votre pile, assurez-vous que les livres de recettes personnalisés et de la communauté que vous exécutez prennent en charge la version de Chef utilisée par votre pile.

Pour configurer une pile de livres de recettes personnalisés

  1. Sur la page de votre pile, cliquez sur Stack Settings (Paramètres de la pile) pour afficher la page Settings (Paramètres). Cliquez sur Edit (Modifier) pour modifier les paramètres.

  2. Basculer Use custom Chef cookbooks (Utiliser les livres de recettes Chef personnalisés) sur Yes (Oui).

    Modification de la page des paramètres de pile

  3. Configurez vos livres de recettes personnalisés.

Lorsque vous avez terminé, cliquez sur Save (Enregistrer) pour enregistrer la pile mise à jour.

Définition d'un référentiel de livres de recettes personnalisé

Les piles Linux peuvent installer des livres de recettes personnalisés à partir de l'un des types de référentiels suivants :

  • Archives HTTP ou Amazon S3.

    Elles peuvent être publiques ou privées, mais Amazon S3 est généralement l'option préférée pour les archives privées.

  • Les référentiels Git et Subversion permettent de contrôler le code source et d'avoir plusieurs versions.

Windows Stacks peut installer des livres de recettes personnalisés à partir des archives Amazon S3 et des référentiels Git.

Tous les types de référentiels auront les champs obligatoires suivants.

  • Type de référentiel : type de référentiel

  • URL du référentiel : URL du référentiel

AWS OpsWorks Stacks prend en charge les sites de dépôt Git hébergés publiquement tels que GitHubBitbucket, ainsi que les serveurs Git hébergés en privé. Pour les référentiels Git, vous devez utiliser l'un des formats d'URL suivants, selon que le référentiel est public ou privé. Suivez les mêmes instructions d'URL pour les sous-modules Git.

Pour un référentiel Git public, utilisez les protocoles HTTPS ou Git en lecture seule :

  • Git en lecture seule —. git://github.com/amazonwebservices/opsworks-example-cookbooks.git

  • HTTPS —https://github.com/amazonwebservices/opsworks-example-cookbooks.git.

Pour un référentiel Git privé, vous devez utiliser le format de lecture/écriture SSH, comme illustré dans les exemples suivants :

  • Référentiels Github —. git@github.com:project/repository

  • Référentiels sur un serveur Git — user@server:project/repository

Les autres paramètres varient selon le type de référentiel et sont décrits dans les sections suivantes.

Archive HTTP

Si vous sélectionnez Http Archive (Archive HTTP) pour Repository type (Type de référentiel), deux paramètres supplémentaires s'affichent et vous devez les remplir si l'archive est protégée par mot de passe.

  • Nom d'utilisateur : votre nom d'utilisateur

  • Mot de passe —Votre mot de passe

Archive Amazon S3

Le fait de sélectionner S3 Archive (Archive S3) comme Repository type (Type de référentiel) permet d'afficher les paramètres optionnels et supplémentaires suivants. AWS OpsWorks Stacks peut accéder à votre référentiel en utilisant les rôles Amazon EC2 (authentification du responsable du système d'exploitation hôte), que vous utilisiez l'API ou AWS OpsWorks la console Stacks.

  • ID de clé d'accès : identifiant de clé d'accès AWS, tel que AKIAIOSFODNN7EXAMPLE.

  • Clé d'accès secrète : clé d'accès secrète AWS correspondante, telle que bPxRfi WjalrXutNFEMI/K7MDENG/CYEXAMPLEKEY.

Référentiel Git

Si vous sélectionnez Git sous Source Control (Contrôle de source), les paramètres facultatifs supplémentaires suivants s'affichent :

Repository SSH key (Clé SSH du référentiel)

Vous devez spécifier une clé SSH de déploiement pour accéder aux référentiels Git privés. Pour les sous-modules Git, la clé spécifiée doit avoir accès à ces sous-modules. Pour plus d’informations, consultez Utilisation de clés SSH d'un référentiel Git.

Important

La clé SSH de déploiement ne peut pas nécessiter de mot de passe ; AWS OpsWorks Stacks n'a aucun moyen de le transmettre.

Branch/Revision

Si le dépôt comporte plusieurs branches, AWS OpsWorks Stacks télécharge la branche principale par défaut. Pour spécifier une branche particulière, entrez le nom de la branche, le hachage SHA1 ou le nom de la balise. Pour spécifier une validation particulière, saisissez l'ID de validation complet de 40 chiffres hexadécimaux.

Référentiel Subversion

Si vous sélectionnez Subversion sous Source Control (Contrôle de source), les paramètres supplémentaires suivants s'affichent :

  • Nom d'utilisateur : votre nom d'utilisateur, pour les référentiels privés.

  • Mot de passe : votre mot de passe, pour les référentiels privés.

  • Révision — [Facultatif] Le nom de la révision, si vous avez plusieurs révisions.

    Pour spécifier une branche ou une balise, vous devez modifier l'URL du référentiel, par exemple : http://repository_domain/repos/myapp/branches/my-apps-branch ou http://repository_domain_name/repos/calc/myapp/my-apps-tag.