Service de fichiers statiques

Pour améliorer les performances, vous pouvez configurer le serveur proxy pour proposer des fichiers statiques (HTML ou images, par exemple) à partir d'un ensemble de répertoires dans votre application web. Lorsque le serveur proxy reçoit une demande pour un fichier dans le chemin spécifié, il fournit le fichier directement au lieu d'acheminer la demande vers votre application.

Elastic Beanstalk prend en charge la configuration du proxy pour servir des fichiers statiques sur la plupart des branches de plate-forme basées sur Amazon Linux 2. La seule exception est Docker.

Note

Sur les plates-formes Python et Ruby, Elastic Beanstalk configure certains dossiers de fichiers statiques par défaut. Pour plus de détails, consultez les sections de configuration de fichiers statiques pour Python et Ruby. Vous pouvez configurer des dossiers supplémentaires comme expliqué sur cette page.

Configurer les fichiers statiques à l'aide de la console

Pour configurer le serveur proxy afin de servir des fichiers statiques

1. Ouvrez la console Elastic Beanstalk et, dans la liste Regions (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. Faites défiler la page jusqu'à la section Logiciel de plateforme et localisez le groupe Fichiers statiques.

   1. Pour ajouter un mappage de fichiers statiques, sélectionnez Ajouter des fichiers statiques. Dans la ligne supplémentaire qui s'affiche, vous devez saisir un chemin pour servir les fichiers statiques et le répertoire qui contient les fichiers statiques à servir.

      • Dans le champ Chemin, commencez le nom du chemin par une barre oblique (/) (par exemple, « /images »).

      • Dans le champ Répertoire, spécifiez un nom de répertoire situé à la racine du code source de votre application. Ne le faites pas commencer par une barre oblique (par exemple, « static/image-files »).

      Note

      Si la section Static Files (fichiers statiques) n'apparaît pas, vous devez ajouter au moins un mappage à l'aide d'un fichier de configuration. Pour plus de détails, consultez Configurer des fichiers statiques à l'aide des options de configuration sur cette page.

   2. Pour supprimer un mappage, sélectionnez Supprimer.

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

Configurer des fichiers statiques à l'aide des options de configuration

Vous pouvez utiliser un fichier de configuration pour configurer des chemins de fichiers statiques et des emplacements de répertoires à l'aide des options de configuration. Vous pouvez ajouter un fichier de configuration au bundle source de votre application et le déployer lors de la création de l'environnement ou d'un déploiement ultérieur.

Si votre environnement utilise une branche de plateforme basée sur Amazon Linux 2, utilisez l' espace de noms aws:elasticbeanstalk:environment:proxy:staticfiles.

L'exemple de fichier de configuration suivant indique au serveur proxy de servir les fichiers du dossier statichtml sur le chemin /html et les fichiers du dossier staticimages sur le chemin /images.

Exemple .ebextensions/static-files.config

option_settings:
  aws:elasticbeanstalk:environment:proxy:staticfiles:
    /html: statichtml
    /images: staticimages

Si votre environnement Elastic Beanstalk utilise une version de plateforme AMI Amazon Linux (antérieure à Amazon Linux 2), lisez les informations supplémentaires suivantes :

Espaces de noms spécifiques à la plateforme AMI Amazon Linux

Sur les branches de la plateforme AMI Amazon Linux, les espaces de noms de configuration de fichiers statiques varient selon la plateforme. Pour plus d'informations, consultez l'une des pages suivantes :

• Espaces de noms de la configuration Go

• Espaces de noms de la configuration Java SE

• Espaces de noms de la configuration Tomcat

• Espaces de noms de la configuration Node.js

• Espaces de noms de la configuration Python