

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.

# Utilisation d'index OpsWorks de recherche spécifiques aux piles sur Windows Stacks
<a name="cookbooks-101-opsworks-opsworks-stack-config-search-opsworks"></a>

**Important**  
Le AWS OpsWorks Stacks service a pris fin 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.

**Note**  
Cet exemple suppose que vous avez déjà fait l'exemple [Exécution d'une recette sur une instance Windows](cookbooks-101-opsworks-opsworks-windows.md). Si tel n'est pas le cas, commencez par cet exemple. Il décrit plus particulièrement comment autoriser l'accès RDP à vos instances.

OpsWorks Stacks fournit les index de recherche suivants en plus de : `node` 
+ `aws_opsworks_stack`— La configuration de la pile.
+ `aws_opsworks_layer`— Les configurations des couches de la pile.
+ `aws_opsworks_instance`— Les configurations d'instance de la pile.
+ `aws_opsworks_app`— Les configurations des applications de la pile.
+ `aws_opsworks_user`— Les configurations utilisateur de la pile.
+ `aws_opsworks_rds_db_instance`— Informations de connexion pour les instances RDS enregistrées.

Ces index incluent certains attributs Chef standard, mais sont principalement destinés à récupérer des attributs spécifiques à OpsWorks Stacks. Par exemple, `aws_opsworks_instance` inclut un attribut `status` qui fournit l'état de l'instance, par exemple `online`. 

**Note**  
La méthode recommandée consiste à utiliser `node` dès que possible pour que vos recettes soient conformes aux pratiques standard de Chef. Pour obtenir un exemple, consultez [Utilisation de l'index de recherche du nœud sur les piles Windows](cookbooks-101-opsworks-opsworks-stack-config-search-node.md).

Cet exemple montre comment utiliser les index OpsWorks Stacks pour récupérer la valeur d'un attribut spécifique à OpsWorks Stacks. Il repose sur une simple pile Windows avec une couche personnalisée qui a une instance. Il utilise la recherche Chef pour obtenir l'ID OpsWorks Stacks de l'instance et place les résultats dans le journal Chef.

Voici un bref résumé de la création d'une pile pour cet exemple. Pour de plus amples informations, veuillez consulter [Créer une pile](workingstacks-creating.md).

**Création d’une pile**

1. Ouvrez la [console OpsWorks Stacks](https://console.aws.amazon.com/opsworks/) et choisissez **\$1 Stack**. Spécifiez les paramètres suivants, acceptez les valeurs par défaut pour les autres paramètres et choisissez **Add Stack (Ajouter une pile)**.
   + **Nom** — IDSearch
   + **Région** — Ouest des États-Unis (Oregon)

     Cet exemple fonctionne dans n'importe quelle région, mais nous vous recommandons d'utiliser US West (Oregon) pour les didacticiels.
   + **Système d'exploitation par défaut** : Microsoft Windows Server 2012 R2

1. Choisissez **Add a layer (Ajouter une couche)** et [ajoutez une couche personnalisée](workinglayers-custom.md) à la pile avec les paramètres suivants.
   + **Nom** — IDCheck
   + **Nom court** — idcheck

1. [Ajoutez une instance t2.micro 24h/24 et 7j/7](workinginstances-add.md) avec les paramètres par défaut à la IDCheck couche et [démarrez-la](workinginstances-starting.md). Elle sera nommée iptest1.

   OpsWorks Stacks est automatiquement attribué `AWS-OpsWorks-RDP-Server` à cette instance. [Activation de l'accès RDP](cookbooks-101-opsworks-opsworks-windows.md#cookbooks-101-opsworks-opsworks-windows-rdp)explique comment ajouter une règle entrante à ce groupe de sécurité qui permet aux utilisateurs autorisés de se connecter à l'instance.

1. Choisissez **Permissions (Autorisations)**, puis **Edit (Modifier)**, et choisissez **SSH/RDP** et **sudo/admin**. Les utilisateurs standard ont besoin de cette autorisation en plus du groupe de sécurité `AWS-OpsWorks-RDP-Server` pour se connecter à l'instance. 
**Note**  
Vous pouvez également vous connecter en tant qu'Administrator, mais en ayant recours à une procédure différente. Pour de plus amples informations, veuillez consulter [Connexion avec RDP](workinginstances-rdp.md).

**Pour configurer le livre de recettes**

1. Créez un répertoire nommé `idcheck` et accédez à celui-ci.

1. Créez un fichier `metadata.rb` avec le contenu suivant et enregistrez-le sur `opstest`.

   ```
   name "idcheck"
   version "0.1.0"
   ```

1. Créez un répertoire `recipes` dans `idcheck` et ajoutez un fichier `default.rb` dans le répertoire qui contient la recette suivante.

   ```
   windowsserver = search(:aws_opsworks_instance, "hostname:idcheck*").first
   Chef::Log.info("**********The public IP address is: '#{windowsserver[:instance_id]}'**********")
   ```

   La recette utilise la fonctionnalité de recherche Chef avec un index de recherche `aws_opsworks_instance` afin d'obtenir les [attributs d'instance](data-bag-json-instance.md) de chaque instance de la pile avec un nom d'hôte commençant par `idcheck`. Si vous utilisez le thème par défaut, qui crée des noms d'hôtes en ajoutant des entiers au nom abrégé de la couche, cette requête renverra toutes les instances de la couche. IDCheck Pour cet exemple, la couche n'a qu'une seule instance, c'est pourquoi la recette attribue simplement la première à `windowsserver`. Pour plusieurs instances, vous pouvez obtenir la liste complète, puis les énumérer.

   La recette profite de la présence d'une seule instance dans la pile avec ce nom d'hôte, c'est pourquoi le premier résultat est le bon. Si la pile comporte plusieurs instances, la recherche sur d'autres attributs peut retourner plusieurs résultats. Pour obtenir une liste d'attributs d'instance, consultez [Conteneur de données de l'instance (aws\$1opsworks\$1instance)](data-bag-json-instance.md).

   Les attributs de l'instance sont essentiellement une table de hachage, et l'identifiant OpsWorks Stacks de l'instance est attribué à l'`instance_id`attribut. Vous pouvez donc appeler l'ID. `windowsserver[:instance_id]` La recette insère la chaîne correspondante dans le message et l'ajoute dans le journal de Chef.

1. Créez une `.zip` archive du `ipaddress` livre de recettes, [chargez l'archive dans un compartiment Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/UG/UploadingObjectsintoAmazonS3.html) et enregistrez l'URL de l'archive. Pour plus d'informations sur les référentiels de livre de recettes, consultez [Référentiels de livres de recettes](workingcookbook-installingcustom-repo.md).

   Le contenu livré aux compartiments Amazon S3 peut contenir du contenu client. Pour plus d'informations sur la suppression de données sensibles, consultez [How Do I Empty an S3 Bucket?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/empty-bucket.html) (Comment puis-je vider un compartiment S3 ?) ou [How Do I Delete an S3 Bucket?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) (Comment supprimer un compartiment S3 ?).

Vous pouvez maintenant installer le livre de recettes et exécuter la recette.

**Pour installer le livre de recettes et exécuter la recette**

1. [Modifiez la pile pour activer les livres personnalisés](workingcookbook-installingcustom-enable.md) et spécifiez les paramètres suivants.
   + **Type de référentiel** — **S3 Archive**
   + **URL du référentiel : URL** de l'archive du livre de recettes que vous avez enregistrée précédemment

   Acceptez les valeurs par défaut pour les autres paramètres, puis choisissez **Save (Enregistrer)** pour mettre à jour la configuration de la pile.

1. [Exécutez la commande de pile de mise à jour des livres de recettes personnalisés](workingstacks-commands.md), qui installe la version actuelle de vos livres de recettes personnalisés sur les instances de la pile, dont les instances en ligne. Si une version antérieure de vos livres de recettes est présente, cette commande la remplace.

1. Une fois la mise à jour des livres de recettes personnalisées terminée, exécutez la recette en exécutant la [commande de pile **Execute Recipes (Exécuter les recettes)**](workingstacks-commands.md) avec le paramètre **Recipes to execute (Recettes à exécuter)** défini sur **idcheck::default**. Cette commande lance une exécution de Chef, avec une liste d'exécution composée de votre recette. Laissez la page execute\$1recipes ouverte.

Une fois que la recette a été exécutée avec succès, vous pouvez la vérifier en recherchant dans le [journal de Chef](troubleshoot-debug-log.md) l'événement execute\$1recipes le plus récent. Sur la **page Running command execute\$1recipes (Exécution de la commande execute\$1recipes)**, choisissez **show (afficher)** dans la colonne **Log (Journal)** de l'instance iptest1 pour afficher le journal. Faites défiler vers le bas pour trouver votre message de journal près de la fin, comme illustré ci-après.

```
...
[2015-05-13T20:03:47+00:00] INFO: Storing updated cookbooks/nodesearch/recipes/default.rb in the cache.
[2015-05-13T20:03:47+00:00] INFO: Storing updated cookbooks/nodesearch/metadata.rb in the cache.
[2015-05-13T20:03:47+00:00] INFO: **********The instance ID is: 'i-8703b570'**********
[2015-05-13T20:03:47+00:00] INFO: Chef Run complete in 0.312518 seconds 
...
```