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.

Mise en œuvre des recettes pour les piles Chef 11.10

Les piles Chef 11.10 offrent les avantages suivants sur les piles Chef 11.4 :

Installation et priorité des livres de recettes

La procédure d'installation AWS OpsWorks Les livres de recettes Stacks fonctionnent un peu différemment pour les piles Chef 11.10 par rapport aux versions antérieures de Chef. Pour les piles Chef 11.10, après AWS OpsWorks Stacks installe les livres de recettes intégrés, personnalisés et Berkshelf, puis les fusionne dans un répertoire commun dans l'ordre suivant :

Lorsque AWS OpsWorks Stacks effectue cette fusion, il copie l'intégralité du contenu des répertoires, y compris les recettes. En cas de doublons, les règles suivantes s'appliquent :

Pour illustrer le fonctionnement de ce processus, envisagez le scénario suivant, où les trois répertoires de livres de recettes incluent tous un livre de recettes nommé mycookbook :

Le livre de recettes fusionné contient les éléments suivants :

Utilisation de Chef Search

Vous pouvez utiliser la méthode search de Chef dans vos recettes pour interroger les données de la pile. Vous utilisez la même syntaxe que pour le serveur Chef, mais AWS OpsWorks Stacks obtient les données à partir de l'objet du nœud local au lieu d'interroger un serveur Chef. Ces données comprennent :

Les attributs de configuration et de déploiement de pile contiennent la plupart des informations que les recettes obtiennent généralement via la recherche, y compris les données telles que les noms d'hôte et les adresses IP de chaque instance en ligne de la pile. AWS OpsWorks Stacks met à jour ces attributs pour chaque événement du cycle de vie, ce qui garantit qu'ils reflètent précisément l'état actuel de la pile. Cela signifie que vous pouvez souvent utiliser dans votre pile des recettes de la communauté dépendant de la recherche sans modification. La méthode de recherche retourne toujours les données appropriées ; elles proviennent simplement des attributs de configuration et de déploiement de pile, et non d'un serveur.

La principale limite de AWS OpsWorks La recherche dans les piles gère uniquement les données de l'objet du nœud local, en particulier la configuration de la pile et les attributs de déploiement. Pour cette raison, les types de données suivants ne peuvent pas être disponibles par le biais de la recherche :

L'extrait de recette suivant montre comment obtenir l'adresse IP privée de l'instance d'une PHP couche à l'aide de la fonction de recherche.

appserver = search(:node, "role:php-app").first
Chef::Log.info("The private IP is '#{appserver[:private_ip]}'")

Utilisation des conteneurs de données

Vous pouvez utiliser la méthode data_bag_item de Chef dans vos recettes pour exécuter une requête sur un conteneur de données. Vous utilisez la même syntaxe que pour le serveur Chef, mais AWS OpsWorks Stacks obtient les données à partir de la configuration de la pile et des attributs de déploiement de l'instance. Cependant, AWS OpsWorks Stacks ne prend actuellement pas en charge les environnements Chef, il revient _default donc node.chef_environment toujours.

Vous créez un sac de données en utilisant le JSON mode personnalisé pour ajouter un ou plusieurs attributs à l'[:opsworks][:data_bags]attribut. L'exemple suivant montre le format général de création d'un sac de données personnaliséJSON.

{
  "opsworks": {
    "data_bags": {
      "bag_name1": {
        "item_name1: {
          "key1" : “value1”,
          "key2" : “value2”,
          ...
        }
      },
      "bag_name2": {
        "item_name1": {
          "key1" : “value1”,
          "key2" : “value2”,
          ...
        }
      },
      ...
    }
  }
}

Vous spécifiez généralement la JSON valeur personnalisée pour la pile, qui installe les attributs personnalisés sur chaque instance pour chaque événement du cycle de vie suivant. Vous pouvez également définir une option personnalisée JSON lorsque vous déployez une application, mais ces attributs ne sont installés que pour ce déploiement et peuvent être installés uniquement sur un ensemble d'instances sélectionné. Pour de plus amples informations, veuillez consulter Déploiement d'applications.

L'JSONexemple personnalisé suivant crée un sac de données nommémyapp. Il possède un seul élément, mysql, avec deux paires clé-valeur.

{ "opsworks": {
    "data_bags": {
      "myapp": {
        "mysql": { 
          "username": "default-user",
          "password": "default-pass"
        }
      }
    }
  }
}

Pour utiliser les données dans votre recette, vous pouvez appeler data_bag_item et lui transmettre les noms du conteneur de données et des valeurs, comme illustré dans l'extrait suivant.

mything = data_bag_item("myapp", "mysql")
Chef::Log.info("The username is '#{mything['username']}' ")

Pour modifier les données du sac de données, il suffit de modifier la personnalisationJSON, qui sera installée sur les instances de la pile lors du prochain événement du cycle de vie.

Utilisation de Berkshelf

Avec les piles Chef 0.9 et Chef 11.4, vous ne pouvez installer qu'un seul référentiel de livres de recettes personnalisés. Avec les piles Chef 11.10, vous pouvez utiliser Berkshelf pour gérer vos livres de recettes et leurs dépendances, ce qui vous permet d'installer des livres de recettes à partir de plusieurs référentiels. (Pour plus d’informations, consultez Empaquetage local des dépendances des livres de recettes.) En particulier, avec Berkshelf, vous pouvez installer AWS OpsWorks Des livres de recettes communautaires compatibles avec Stacks directement depuis leurs référentiels au lieu d'avoir à les copier dans votre référentiel de livres de recettes personnalisé. Les versions Berkshelf prises en charge dépendent du système d'exploitation. Pour de plus amples informations, veuillez consulter AWS OpsWorks Systèmes d'exploitation Stacks.

Pour utiliser Berkshelf, vous devez l'activer explicitement, comme décrit dans Installation de livres de recettes personnalisés. Ensuite, incluez un fichier Berksfile dans le répertoire racine de votre référentiel de livres de recettes qui spécifie les livres à installer.

Pour spécifier une source de livre de recettes externe dans un Berksfile, incluez un attribut source en haut du fichier qui spécifie le référentiel par défaut. URL Berkshelf recherchera les livres de recettes dans la source, URLs sauf si vous spécifiez explicitement un dépôt. Ensuite, incluez une ligne pour chaque livre de recettes que vous voulez installer dans le format suivant :

cookbook 'cookbook_name', ['>= cookbook_version'], [cookbook_options]

Les champs après cookbook spécifient le livre de recettes.

Voici un exemple de fichier Berksfile qui indique les différentes façons de spécifier les livres de recettes. Pour plus d'informations sur la façon de créer un fichier Berksfile, consultez Berkshelf.

source "https://supermarket.chef.io"

cookbook 'apt'
cookbook 'bluepill', '>= 2.3.1'
cookbook 'ark', git: 'git://github.com/opscode-cookbooks/ark.git'
cookbook 'build-essential', '>= 1.4.2', git: 'git://github.com/opscode-cookbooks/build-essential.git', tag: 'v1.4.2'

Le fichier installe les livres de recettes suivants :

Un référentiel de livres de recettes personnalisés peut contenir des livres de recettes personnalisés en plus d'un fichier Berksfile. Dans ce cas, AWS OpsWorks Stacks installe les deux ensembles de livres de recettes, ce qui signifie qu'une instance peut avoir jusqu'à trois référentiels de livres de recettes.

Les livres de recettes intégrés et vos livres de recettes personnalisés sont installés sur chaque instance lors de l'installation et ne sont pas mis à jour par la suite, sauf si vous lancez manuellement la commande de pile Update Custom Cookbooks. AWS OpsWorks Stacks fonctionne berks install pour chaque course de Chef. Vos livres de recettes Berkshelf sont donc mis à jour pour chaque événement du cycle de vie, conformément aux règles suivantes :

Vous pouvez aussi mettre à jour vos livres de recettes Berkshelf en exécutant la commande de pile Update Custom Cookbooks, qui met à jour aussi bien les livres Berkshelf que vos livres de recettes personnalisés.