Déploiement d'une application Symfony sur Elastic Beanstalk

Symfony est une infrastructure open source destinée au développement d'applications web PHP dynamiques. Ce tutoriel explique le processus de génération d'une application Symfony et de son déploiement dans un AWS Elastic Beanstalk environnement.

Prérequis

Ce tutoriel suppose que vous connaissez les opérations de base Elastic Beanstalk et la console Elastic Beanstalk. Si ce n'est pas déjà fait, suivez les instructions dans Commencer à utiliser Elastic Beanstalk pour lancer votre premier environnement Elastic Beanstalk.

Pour suivre les procédures décrites dans ce guide, vous aurez besoin d'un shell ou d'un terminal de ligne de commande pour exécuter des commandes. Dans les listes, les commandes sont précédées d'un symbole d'invite ($) et du nom du répertoire actuel, le cas échéant.

~/eb-project$ this is a command
this is output

Sous Linux et macOS, vous pouvez utiliser le shell et le gestionnaire de package de votre choix. Sur Windows, vous pouvez installer le sous-système Windows pour Linux afin d'obtenir une version intégrée à Windows d'Ubuntu et de Bash.

Symfony 4.4.9 nécessite PHP 7.1.3 ou version ultérieure. Il requiert également les extensions PHP répertoriées dans la rubrique Exigences techniques de la documentation d'installation officielle de Symfony. Dans le cadre de ce tutoriel, nous utilisons PHP 7.2 et la version correspondante de la plateforme Elastic Beanstalk. Suivez les instructions de la rubrique Configuration de votre environnement de PHP développement pour Elastic Beanstalk pour installer PHP et Composer.

Pour plus d'informations sur la prise en charge et la maintenance de Symfony, consultez la rubrique Versions de Symfony sur le site Web de Symfony. Pour plus d'informations sur les mises à jour liées à la prise en charge des versions de PHP pour Symfony 4.4.9, consultez la rubrique Notes de mise à jour de Symfony 4.4.9 sur le site Web de Symfony.

Lancer un environnement Elastic Beanstalk

Utilisez la console Elastic Beanstalk pour créer un environnement Elastic Beanstalk. Choisissez la plateforme PHP et acceptez les paramètres par défaut et l'exemple de code.

Pour lancer un environnement (console)

1. Ouvrez la console Elastic Beanstalk à l'aide de ce lien préconfiguré : console.aws.amazon.com/elasticbeanstalk/home#/ newApplication?ApplicationName=Tutorials &EnvironmentType= LoadBalanced

2. Pour Platform (Plateforme), sélectionnez la plateforme et la branche de plateforme qui correspondent au langage utilisé par votre application.

3. Pour l'option Code de l'application, choisissez Exemple d'application.

4. Choisissez Vérifier et lancer.

5. Passez en revue les options disponibles. Choisissez l'option disponible que vous souhaitez utiliser et, une fois que vous êtes prêt, choisissez Create app (Créer une application).

La création d'un environnement prend environ 5 minutes et crée les ressources suivantes :

• Instance EC2 – Machine virtuelle Amazon Elastic Compute Cloud (Amazon EC2) configurée pour exécuter des applications web sur la plateforme de votre choix.

  Chaque plateforme exécute un ensemble spécifique de logiciels, de fichiers de configuration et de scripts pour prendre en charge une version de langage, une infrastructure ou un conteneur web spécifiques, ou une combinaison de ces éléments. La plupart des plateformes utilisent Apache ou nginx comme proxy inverse situé devant votre application web, qui lui transmet des demandes, traite des ressources statiques et génère des journaux d'accès et d'erreur.

• Groupe de sécurité de l'instance – Groupe de sécurité Amazon EC2 configuré pour autoriser le trafic entrant sur le port 80. Cette ressource autorise le trafic HTTP provenant de l'équilibreur de charge à atteindre l'instance EC2 qui exécute votre application web. Par défaut, le trafic n'est pas autorisé sur les autres ports.

• Équilibreur de charge – Équilibreur de charge Elastic Load Balancing configuré pour répartir les demandes vers les instances exécutant votre application. De plus, l'équilibreur de charge vous évite d'exposer directement vos instances sur Internet.

• Groupe de sécurité de l'équilibreur de charge – Groupe de sécurité Amazon EC2 configuré pour autoriser le trafic entrant sur le port 80. Cette ressource autorise le trafic HTTP provenant d'Internet à atteindre l'équilibreur de charge. Par défaut, le trafic n'est pas autorisé sur les autres ports.

• Groupe Auto Scaling – Groupe Auto Scaling configuré pour remplacer une instance si elle est résiliée ou devient indisponible.

• Compartiment Amazon S3 – Emplacement de stockage pour votre code source, les journaux et autres artefacts qui sont créés lorsque vous utilisez Elastic Beanstalk.

• CloudWatch Alarmes Amazon : deux CloudWatch alarmes qui surveillent la charge sur les instances de votre environnement et qui sont déclenchées si la charge est trop élevée ou trop faible. Lorsqu'une alarme est déclenchée, votre groupe Auto Scaling s'adapte en fonction, à la hausse ou à la baisse.

• AWS CloudFormation stack — Elastic AWS CloudFormation Beanstalk utilise pour lancer les ressources de votre environnement et propager les modifications de configuration. Les ressources sont définies dans un modèle, que vous pouvez afficher dans la console AWS CloudFormation.

• Nom de domaine – Nom de domaine qui permet d'accéder à votre application web sous la forme sous-domaine.région.elasticbeanstalk.com.

  Note

  Pour renforcer la sécurité de vos applications Elastic Beanstalk, le domaine elasticbeanstalk.com est enregistré dans la liste des suffixes publics (PSL). Pour plus de sécurité, nous vous recommandons d'utiliser des cookies avec un préfixe __Host- si vous devez définir des cookies sensibles dans le nom de domaine par défaut de vos applications Elastic Beanstalk. Cette pratique vous aidera à protéger votre domaine contre les tentatives de falsification de requêtes intersites (CSRF). Pour plus d'informations, consultez la page Set-Cookie du Mozilla Developer Network.

Toutes ces ressources sont gérées par Elastic Beanstalk. Lorsque vous arrêtez votre environnement, Elastic Beanstalk arrête toutes les ressources qu'il contient.

Note

Le compartiment Amazon S3 créé par Elastic Beanstalk est partagé entre les environnements et n'est pas supprimé lors de l'arrêt de l'environnement. Pour plus d’informations, consultez Utilisation d'Elastic Beanstalk avec Amazon S3.

Installation de Symfony et génération d'un site web

Composer peut installer Symfony et créer un projet de travail avec une commande :

~$ composer create-project symfony/website-skeleton eb-symfony

Composer installe Symfony et ses dépendances et génère un projet par défaut.

Si vous rencontrez des problèmes lors de l'installation de Symfony, accédez à la rubrique consacrée à l'installation dans la documentation officielle de Symfony.

Déploiement de votre application

Accédez au répertoire du projet.

~$ cd eb-symfony

Créez un bundle source contenant les fichiers créés par Composer. La commande suivante permet de créer une solution groupée source nommée symfony-default.zip. Elle exclut les fichiers du dossier vendor, lesquels prennent beaucoup de place et ne sont pas nécessaires pour le déploiement de votre application dans Elastic Beanstalk.

eb-symfony$ zip ../symfony-default.zip -r * .[^.]* -x "vendor/*"

Chargez le bundle source sur Elastic Beanstalk pour déployer Symfony dans votre environnement.

Pour déployer un groupe source

1. Ouvrez la console Elastic Beanstalk, puis dans la liste des régions, sélectionnez votre. Région AWS

2. Dans le panneau de navigation, choisissez Environments (Environnements), puis choisissez le nom de votre environnement dans la liste.

   Note

   Si vous avez plusieurs environnements, utilisez la barre de recherche pour filtrer la liste des environnements.

3. Sur la page de présentation de l'environnement, choisissez Upload and deploy (Charger et déployer).

4. Utilisez la boîte de dialogue à l'écran pour charger le bundle source.

5. Choisissez Deploy (Déployer).

6. Lorsque le déploiement est terminé, vous pouvez sélectionner l'URL de site pour ouvrir votre site web dans un nouvel onglet.

Note

En vue d'optimiser davantage le bundle source, initialisez un référentiel Git et utilisez la commande git archive pour créer le bundle source. Le projet Symfony par défaut inclut un fichier .gitignore qui indique à Git d'exclure le dossier vendor et d'autres fichiers qui ne sont pas nécessaires pour le déploiement.

Configuration des paramètres Composer

Au terme du déploiement, cliquez sur l'URL pour ouvrir votre application Symfony dans le navigateur.

De quoi s'agit-il ? Par défaut, Elastic Beanstalk constitue la racine de votre projet sur le chemin d'accès racine du site web. Dans ce cas, cependant, la page par défaut (app.php) est un niveau en-dessous dans le dossier web. Vous pouvez vérifier cela en ajoutant /public à l'URL. Par exemple : http://symfony.us-east-2.elasticbeanstalk.com/public.

Pour servir l'application Symfony dans le chemin d'accès racine, utilisez la console Elastic Beanstalk pour configurer le document racine du site web.

Pour configurer la racine du document de votre site web

1. Ouvrez la console Elastic Beanstalk, puis dans la liste des régions, sélectionnez votre. Région AWS

2. Dans le panneau de navigation, choisissez Environments (Environnements), puis choisissez le nom de votre environnement dans la liste.

   Note

   Si vous avez plusieurs environnements, utilisez la barre de recherche pour filtrer la liste des environnements.

3. Dans le panneau de navigation, choisissez Configuration.

4. Dans la catégorie de configuration Mises à jour, surveillance et journalisation, sélectionnez Modifier.

5. Pour Racine du document, entrez /public.

6. Pour enregistrer les modifications, cliquez sur Appliquer en bas de la page.

7. Lorsque la mise à jour est terminée, cliquez sur l'URL pour rouvrir votre site dans le navigateur.

Nettoyage

Lorsque vous avez fini d'utiliser Elastic Beanstalk, vous pouvez arrêter votre environnement. Elastic Beanstalk AWS met fin à toutes les ressources associées à votre environnement, telles que les instances Amazon EC2, les instances de base de données, les équilibreursde charge, les groupes de sécurité et les alarmes.

Pour mettre fin à votre environnement Elastic Beanstalk depuis la console

1. Ouvrez la console Elastic Beanstalk, puis dans la liste des régions, sélectionnez votre. Région AWS

2. Dans le panneau de navigation, choisissez Environments (Environnements), puis choisissez le nom de votre environnement dans la liste.

   Note

   Si vous avez plusieurs environnements, utilisez la barre de recherche pour filtrer la liste des environnements.

3. Choisissez Actions (Actions), puis Terminate Environment (Résilier l’environnement).

4. Utilisez la boîte de dialogue à l'écran pour confirmer la résiliation de l'environnement.

Avec Elastic Beanstalk, vous pouvez facilement créer un nouvel environnement pour votre application à tout moment.

Étapes suivantes

Pour plus d'informations sur Symfony, consultez la rubrique Qu'est-ce que Symfony ? sur le site symfony.com.

À mesure que vous continuez à développer votre application, vous souhaiterez probablement disposer d'une solution pour gérer des environnements et déployer votre application sans devoir créer un fichier .zip et le charger manuellement sur la console Elastic Beanstalk. L'interface de ligne de commande Elastic Beanstalk (EB CLI easy-to-use ) fournit des commandes pour créer, configurer et déployer des applications dans les environnements Elastic Beanstalk à partir de la ligne de commande.

Dans ce tutoriel, vous avez utilisé la console Elastic Beanstalk pour configurer les options du composeur. Pour que cette configuration fasse partie de votre source d'application, vous pouvez utiliser un fichier de configuration comme celui qui suit.

Exemple .ebextensions/composer.config

option_settings:
  aws:elasticbeanstalk:container:php:phpini:
    document_root: /public

Pour plus d’informations, consultez Personnalisation d'environnement avancée avec fichiers de configuration (.ebextensions).

Symfony utilise ses propres fichiers de configuration pour configurer les connexions de base de données. Pour de plus amples informations sur la connexion à une base de données avec Symfony, veuillez consulter Connexion à une base de données avec Symfony.

Enfin, si vous prévoyez d'utiliser votre application dans un environnement de production, vous devez configurer un nom de domaine personnalisé pour votre environnement et activer HTTPS pour des connexions sécurisées.