Ajout d'applications - 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.

Ajout d'applications

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.

La première étape du déploiement d'une application sur vos serveurs d'applications consiste à ajouter une application à la pile. L'application contient une grande variété de métadonnées, comme le nom de l'application et le type, ainsi que les informations requises pour déployer l'application sur les instances serveur, telles que l'URL du référentiel. Vous devez gérer les autorisations Manage pour ajouter une application à une pile. Pour plus d’informations, consultez Gestion des autorisations utilisateur.

Note

La procédure de cette section s'applique à Chef 12 et aux piles les plus récentes. Pour plus d'informations sur l'ajout d'applications aux couches des piles Chef 11, consultez Étape 2.4 : Créer et déployer une application - Chef 11.

Pour ajouter une application à une pile
  1. Placez le code dans votre dépôt préféré : une archive Amazon S3, un dépôt Git, un dépôt Subversion ou une archive HTTP. Pour plus d’informations, consultez Source de l'application.

  2. Cliquez sur Apps (Applications) dans le panneau de navigation. Sur la page Apps (Applications), cliquez sur Add an app (Ajouter une application) pour votre première application. Pour les applications suivantes, cliquez sur +App.

  3. Utilisez la page App New (Nouvelle application) pour configurer l'application, comme décrit dans la section suivante.

Configuration d'une application

La page Add App (Ajouter une application) se compose des sections suivantes : Settings (Paramètres), Application source (Source d'application), Data Sources (Sources de données), Environment Variables (Variables d'environnement), Add Domains (Ajouter des domaines) et SSL Settings (Paramètres SSL).

Paramètres

Nom

Le nom de l'application, qui est utilisé pour représenter l'application dans l'interface utilisateur. AWS OpsWorks Stacks utilise également ce nom pour générer un nom abrégé pour l'application utilisée en interne et pour identifier l'application dans la configuration de la pile et les attributs de déploiement. Une fois que vous avez ajouté l'application à la pile, vous pouvez voir le nom court en cliquant sur Apps (Applications) dans le panneau de navigation, puis sur le nom de l'application pour ouvrir la page des détails.

Document root (Racine du document)

AWS OpsWorks Stacks attribue le paramètre Document root à l'[:document_root]attribut dans les attributs de l'deployapplication. La valeur par défaut est null. Vos recettes de déploiement peuvent obtenir cette valeur à partir des attributs deploy à l'aide de la syntaxe de nœud Chef standard et déployer le code spécifié à l'emplacement approprié sur le serveur. Pour plus d'informations sur la façon de déployer les applications, consultez Recettes Deploy.

Source de l'application

Vous pouvez déployer des applications à partir des types de référentiels suivants : Git, bundle Amazon S3, bundle HTTP et Other. Tous les types de référentiel nécessitent que vous spécifiiez le type du référentiel et l'URL du référentiel. Les types de référentiel individuels ont leurs propres exigences, comme expliqué ci-dessous.

Note

AWS OpsWorks Stacks déploie automatiquement les applications depuis les référentiels standard vers les couches de serveur intégrées. Si vous utilisez le type de référentiel Autre, qui est la seule option pour les piles Windows, AWS OpsWorks Stacks place les informations du référentiel dans les deployattributs de l'application, mais vous devez implémenter des recettes personnalisées pour gérer les tâches de déploiement.

Archive HTTP

Pour utiliser un serveur HTTP accessible publiquement comme référentiel :

  1. Créez une archive compressée (zip, gzip, bzip2, Java WAR ou tarball) du dossier contenant le code de l'application et tous les fichiers associés.

    Note

    AWS OpsWorks Stacks ne prend pas en charge les archives non compressées.

  2. Chargez le fichier d'archive sur le serveur.

  3. Pour spécifier le référentiel dans la console, sélectionnez HTTP Archive comme type de référentiel et saisissez l'URL.

    Si l'archive est protégée par mot de passe, sous Source de l'application, spécifiez les informations de connexion.

Archive Amazon S3

Pour utiliser un bucket Amazon Simple Storage Service comme référentiel :

  1. Créez un compartiment Amazon S3 public ou privé. Pour plus d'informations, consultez la documentation Amazon S3.

  2. Pour que AWS OpsWorks Stacks puisse accéder aux compartiments privés, vous devez être un utilisateur disposant au moins de droits en lecture seule sur le compartiment Amazon S3 et vous aurez besoin de l'ID de la clé d'accès et de la clé d'accès secrète. Pour plus d'informations, consultez la documentation AWS Identity and Access Management.

  3. Placez le code et les fichiers associés dans un dossier, puis stockez le dossier dans une archive compressée (zip, gzip, bzip2, Java WAR ou tarball).

    Note

    AWS OpsWorks Stacks ne prend pas en charge les archives non compressées.

  4. Téléchargez le fichier d'archive dans le compartiment Amazon S3 et enregistrez l'URL.

  5. Pour spécifier le référentiel dans la console AWS OpsWorks Stacks, définissez le type de référentiel sur S3 Archive et entrez l'URL de l'archive. Pour une archive privée, vous devez également fournir un ID de clé d'accès AWS et une clé d'accès secrète dont la stratégie accorde les autorisations pour accéder au compartiment. Laissez les paramètres en blanc pour les archives publiques.

Référentiel Git

Un dépôt Git permet le contrôle des sources et le contrôle des versions. AWS OpsWorks Stacks prend en charge les sites de dépôt hébergés publiquement tels que GitHubBitbucket, ainsi que les serveurs Git hébergés en privé. Pour les applications et les sous-modules Git, le format que vous utilisez pour spécifier l'URL du référentiel dans Application Source (Source d'application) dépend du fait que le référentiel est public ou privé :

Référentiel public : utilisez les protocoles en lecture seule HTTPS ou Git. Mise en route des piles Linux Chef 11Utilise, par exemple, un GitHub référentiel public accessible via l'un des formats d'URL suivants :

  • Git en lecture seule : git://github.com/amazonwebservices/opsworks-demo-php-simple-app.git

  • HTTPS: https://github.com/amazonwebservices/opsworks-demo-php-simple-app.git

Référentiel privé : utilisez le format de lecture/écriture SSH 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

La sélection de Git sous Source Control (Contrôle de source) affiche deux paramètres facultatifs supplémentaires :

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. Ce champ nécessite la clé privée ; la clé publique est attribuée à votre référentiel Git. 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 (Branche/Révision)

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'identifiant de validation complet de 40 chiffres hexadécimaux.

Autres référentiels

Si les référentiels standard ne répondent pas à vos besoins, vous pouvez utiliser d'autres référentiels, comme Bazaar. Cependant, AWS OpsWorks Stacks ne déploie pas automatiquement les applications à partir de tels référentiels. Vous devez implémenter des recettes personnalisées pour gérer le processus de déploiement et les assigner aux événements Deploy des couches appropriées. Pour obtenir un exemple de la façon d'implémenter les recettes Deploy, consultez Recettes Deploy.

Sources de données

Cette section attache une base de données à l'application. Vous avez les options suivantes :

  • RDS — Attachez l'une des couches de service Amazon RDS de la pile.

  • Aucun : n'attachez pas de serveur de base de données.

Si vous sélectionnez RDS, vous devez spécifier les valeurs suivantes.

Instance de base de données

La liste inclut toutes les couches de service Amazon RDS. Vous pouvez aussi sélectionner l'une des valeurs suivantes :

(Obligatoire) Spécifiez le serveur de base de données à attacher à l'application. Le contenu de la liste dépend de la source de données.

  • RDS — Liste des couches de service Amazon RDS de la pile.

Nom de base de données

(Facultatif) Spécifiez un nom de base de données.

  • couche Amazon RDS : entrez le nom de base de données que vous avez spécifié pour l'instance Amazon RDS.

    Vous pouvez obtenir le nom de la base de données depuis la console Amazon RDS.

Lorsque vous déployez une application avec une base de données attachée, AWS OpsWorks Stacks ajoute la connexion de l'instance de base de données aux deployattributs de l'application.

Vous pouvez écrire une recette personnalisée pour récupérer les informations des attributs deploy et les placer dans un fichier accessible par l'application. Il s'agit de la seule option pour fournir des informations de connexion de base de données au type d'application Other.

Pour plus d'informations sur la façon de gérer les connexions de base de données, consultez Connexion à une base de données.

Pour détacher un serveur de base de données d'une application, modifiez la configuration de l'application afin de spécifier un autre serveur de base de données ou aucun serveur.

Variables d'environnement

Vous pouvez spécifier un ensemble de variables d'environnement pour chaque application, spécifiques à l'application. Par exemple, si vous avez deux applications, les variables d'environnement que vous définissez pour la première application ne sont pas accessibles par la seconde application, et inversement. Vous pouvez également définir la même variable d'environnement pour plusieurs applications et lui attribuer une valeur différente pour chaque application.

Note

Il n'y a pas de limite spécifique au nombre de variables d'environnement. Toutefois, la taille de la structure de données associée, qui inclut les noms, les valeurs et les valeurs des indicateurs protégés des variables, ne peut pas dépasser 20 Ko. Cette limite doit convenir à la plupart des cas, si ce n'est tous. Son dépassement entraîne une erreur de service (console) ou une exception (API) avec le message, « Environment: is too large (maximum is 20KB) ».

AWS OpsWorks Stacks stocke les variables sous forme d'attributs dans les deployattributs de l'application. Vous pouvez obtenir que vos recettes personnalisées récupèrent ces valeurs en utilisant la syntaxe de nœud Chef standard. Pour obtenir des exemples de la façon d'accéder aux variables d'environnement d'une application, consultez Utilisation des variables d'environnement .

Clé

Nom de la variable. Il peut contenir jusqu'à 64 caractères majuscules et minuscules, chiffres et traits de soulignement (_), mais il doit commencer par une lettre ou un trait de soulignement.

Valeur

Valeur de la variable. Elle peut contenir jusqu'à 256 caractères, qui doivent tous être affichables.

Valeur protégée

Indique si la valeur est protégée. Ce paramètre vous permet de masquer les informations sensibles telles que les mots de passe. Si vous définissez Protected value (Valeur protégée) pour une variable, une fois que vous avez créé l'application :

  • La page des détails de l'application affiche uniquement le nom de la variable, pas la valeur.

  • Si vous avez l'autorisation de modifier l'application, vous pouvez cliquer sur Update value (Mettre à jour la valeur) pour spécifier une nouvelle valeur, mais vous ne pouvez pas afficher ou modifier l'ancienne valeur.

Note

Les journaux de déploiement Chef peuvent parfois inclure des variables d'environnement. Cela signifie que des variables protégées peuvent s'afficher dans la console. Pour empêcher l'affichage de variables protégées dans la console, nous vous recommandons d'utiliser des compartiments Amazon S3 comme espace de stockage pour les variables protégées que vous ne souhaitez pas voir apparaître dans la console. Vous trouverez un exemple d'utilisation d'un compartiment S3 à cet effet dans la section Utilisation d'un compartiment Amazon S3 de ce guide.

Domaine et paramètres SSL

Pour le type d'application Autre, AWS OpsWorks Stacks ajoute les paramètres aux deploy attributs de l'application. Vos recettes peuvent récupérer les données à partir de ces attributs et configurer le serveur en fonction des besoins.

Paramètres de domaine

Cette section possède un champ facultatif Add Domains (Ajouter des domaines) pour spécifier les domaines. Pour plus d’informations, consultez Utilisation des domaines personnalisés.

Paramètres SSL

Cette section possède un bouton bascule SSL Support (Prise en charge SSL) que vous pouvez utiliser pour activer ou désactiver SSL. Si vous cliquez sur Yes (Oui), vous devrez fournir les informations de certificat SSL. Pour plus d'informations, voir Utilisation de SSL.