Configuration du processus de l'application avec un Procfile - AWS Elastic Beanstalk

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.

Configuration du processus de l'application avec un Procfile

Pour spécifier des commandes personnalisées pour démarrer une application Go, incluez un fichier nommé Procfile à la racine de votre groupe source.

Pour plus d'informations sur l'écriture et l'utilisation d'un Procfile, développez la section Buildfile et Procfile dans Extension des plateformes Linux Elastic Beanstalk.

Exemple Procfile
web: bin/server
queue_process: bin/queue_processor
foo: bin/fooapp

Vous devez appeler l'application principale web et la répertorier comme première commande dans votre fichier Procfile. Elastic Beanstalk expose la principale application web sur l'URL racine de l'environnement ; par exemple, http://my-go-env.elasticbeanstalk.com.

Elastic Beanstalk exécute également n'importe quelle application dont le nom n'a pas le préfixe web_, mais ces applications ne sont pas disponibles à l'extérieur de votre instance.

Elastic Beanstalk s'attend à ce que les processus s'exécutant à partir du fichier Procfile le fassent en continu. Elastic Beanstalk surveille ces applications et redémarre tout processus qui s'arrête. Pour les processus de courte durée, utilisez une commande Buildfile.

Si votre environnement Elastic Beanstalk Go utilise une version de plateforme AMI Amazon Linux (antérieure à Amazon Linux 2), lisez les informations supplémentaires dans cette section.

Remarques

  • Les informations de cette rubrique s'appliquent uniquement aux branches de plateforme basées sur l'AMI Amazon Linux (AL1). Les branches de plateforme AL2023/AL2 sont incompatibles avec les versions de plateforme précédentes de l'AMI Amazon Linux (AL1) et nécessitent des paramètres de configuration différents.

  • Le 18 juillet 2022, Elastic Beanstalk définira les statuts de toutes les branches de plateforme basées sur une AMI Amazon Linux (AL1) sur mise hors service. Pour plus d'informations sur la migration vers une branche de plateforme Amazon Linux 2023 actuelle et entièrement prise en charge, consultez Migration de votre application Elastic Beanstalk Linux vers Amazon Linux 2023 ou Amazon Linux 2.

Note

Les informations de cette rubrique s'appliquent uniquement aux branches de plateforme basées sur l'AMI Amazon Linux (AL1). Les branches de plateforme AL2023/AL2 sont incompatibles avec les versions de plateforme précédentes de l'AMI Amazon Linux (AL1) et nécessitent des paramètres de configuration différents.

Elastic Beanstalk configure le proxy nginx pour transmettre les demandes à votre application sur le numéro de port indiqué dans la propriété d'environnement PORT de votre application. Votre application doit toujours écouter sur ce port. Vous pouvez accéder à cette variable dans votre d'application en appelant la méthode os.Getenv("PORT").

Elastic Beanstalk utilise le numéro de port spécifié dans la propriété d'environnement PORT pour le port de la première application dans le fichier Procfile. Il augmente ensuite le numéro de port de 100 pour chaque application ultérieure dans le fichier Procfile. Si la propriété d'environnement PORT n'est pas définie, Elastic Beanstalk utilise 5000 pour le port initial.

Dans l'exemple précédent, la propriété d'environnement PORT pour l'application web est 5000, l'application queue_process est 5100 et l'application foo est 5200.

Vous pouvez spécifier le port initial en définissant l'option PORT avec l'espace de noms aws:elasticbeanstalk:application:environment, comme illustré dans l'exemple suivant. 

option_settings:
  - namespace:  aws:elasticbeanstalk:application:environment
    option_name:  PORT
    value:  <first_port_number>

Pour de plus amples informations sur la définition des propriétés d'environnement pour votre application, veuillez consulter Paramètres d'option.