

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 16 : Mettre à jour le livre de recettes pour utiliser les livres de recettes de la communauté
<a name="gettingstarted-cookbooks-community-cookbooks"></a>

**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](https://repost.aws/) ou via le [AWS Support](https://aws.amazon.com/support) Premium.

Enfin, mettez à jour le livre de recettes pour utiliser les fonctionnalités fournies dans un livre de recettes externe fourni par la communauté Chef. Le livre de recettes externe que vous utilisez pour cette procédure pas à pas est disponible via le [supermarché Chef](https://supermarket.chef.io/), célèbre endroit pour accéder aux livres de recettes Chef externes. Ce livre de recettes externe fournit une ressource personnalisée qui vous permet de télécharger et d'installer des applications, de la même manière que ce que vous avez fait dans [Étape 4 : Mettre à jour le livre de recettes pour installer un package](gettingstarted-cookbooks-install-package.md). Cependant, cette ressource peut installer des applications web et autres types d'applications en plus des packages.

Quand un livre de recettes repose sur un autre livre de recettes, vous devez spécifier une dépendance sur les autres livres de recettes. Pour déclarer et gérer les dépendances de livre de recettes, nous recommandons d'utiliser un outil appelé Berkshelf. Pour plus d'informations sur la façon d'installer Berkshelf sur votre poste de travail local, consultez [About Berkshelf (À propos de Berkshelf) ](https://docs.chef.io/berkshelf.html) sur le site web de Chef.

Une fois que vous avez installé Berkshelf, suivez ces procédures pour déclarer la dépendance du livre de recettes, puis créez une recette qui appelle la ressource du livre de recettes externe :

**Pour déclarer la dépendance du livre de recettes**

1. Sur votre ordinateur local, dans le répertoire `opsworks_cookbook_demo`, ajoutez la ligne suivante à la fin du fichier `metadata.rb` :

   ```
   depends "application", "5.0.0"
   ```

   Cette action déclare une dépendance sur un livre de recettes intitulé `application`, version 5.0.0. 

1. Depuis la racine du répertoire `opsworks_cookbook_demo`, exécutez la commande suivante. Le point à la fin de la commande est intentionnel.

   ```
   berks init .
   ```

   Berkshelf crée un certain nombre de dossiers et de fichiers que vous pouvez utiliser ultérieurement pour les scénarios plus avancés. Le seul fichier dont nous avons besoin pour cette procédure pas à pas est le fichier nommé `Berksfile`.

1. Ajoutez la ligne suivante à la fin du fichier `Berksfile` : 

   ```
   cookbook "application", "5.0.0"
   ```

   Cette action informe Berkshelf que vous voulez utiliser [la version 5.0.0 du livre de recettes « application »](https://supermarket.chef.io/cookbooks/application/versions/5.0.0), que Berkshelf télécharge via le Chef Supermarket.

1. Depuis un terminal ou une invite de commande, exécutez la commande suivante à partir de la racine du répertoire `opsworks_cookbook_demo` :

   ```
   berks install
   ```

   Berkshelf crée une liste de dépendances pour votre livre de recettes et pour le livre de recettes « application ». Berkshelf utilise cette liste de dépendances dans la procédure suivante.

**Pour mettre à jour le livre de recettes sur l'instance et exécuter la nouvelle recette**

1. Dans le sous-répertoire `recipes` du répertoire `opsworks_cookbook_demo`, créez un fichier nommé `dependencies_demo.rb` qui contient le code suivant :

   ```
   application "Install NetHack" do
     package "nethack.x86_64"
   end
   ```

   Cette recette dépend de la ressource d'application contenue dans le livre de recettes de l'application pour installer le célèbre jeu d'aventure textuel NetHack sur l'instance. (Vous pouvez, bien sûr, utiliser le nom de package de votre choix, à condition que le package soit facilement accessible pour le gestionnaire de package sur l'instance.)

1. Depuis la racine du répertoire `opsworks_cookbook_demo`, exécutez la commande suivante :

   ```
   berks package
   ```

   Berkshelf utilise la liste des dépendances de la procédure précédente pour créer un fichier nommé `cookbooks-timestamp.tar.gz`, qui contient le répertoire `opsworks_cookbook_demo` et son contenu mis à jour, y compris les livres de recettes dépendants du livre de recettes. Renommez le fichier `opsworks_cookbook_demo.tar.gz`. 

1. Chargez le fichier renommé `opsworks_cookbook_demo.tar.gz` mis à jour dans votre compartiment S3.

1. Suivez les procédures décrites dans [Étape 5 : Mettre à jour le livre de recettes sur l'instance et exécuter la recette](gettingstarted-cookbooks-copy-cookbook.md) pour mettre à jour le livre de recettes sur l'instance et exécuter la recette. Dans la procédure « Pour exécuter la recette », pour **Recipes to execute (Recettes à exécuter)**, tapez **opsworks\$1cookbook\$1demo::dependencies\$1demo**.

1. Une fois que vous avez exécuté la recette, vous devriez pouvoir vous connecter à l'instance, puis taper **nethack** à l'invite de commande pour commencer à jouer. (Pour plus d'informations sur le jeu, consultez [NetHack](https://en.wikipedia.org/wiki/NetHack)et le [NetHackGuide](http://www.nethack.org/v343/Guidebook.html).) 

À l'[étape suivante](gettingstarted-cookbooks-clean-up.md), vous pouvez nettoyer les AWS ressources que vous avez utilisées pour cette procédure pas à pas. Cette étape suivante est facultative. Vous souhaiterez peut-être continuer à utiliser ces AWS ressources tout en continuant à en apprendre davantage sur OpsWorks Stacks. Cependant, la conservation de ces AWS ressources peut entraîner des frais permanents sur votre AWS compte. Si vous souhaitez conserver ces AWS ressources pour une utilisation ultérieure, vous avez maintenant terminé cette procédure pas à pas et vous pouvez passer à[Étapes suivantes](gettingstarted-cookbooks-next-steps.md).