Manifest di ambiente (env.yaml)

Puoi includere un manifest di ambiente in formato YAML nella radice del bundle di origine della tua applicazione per configurare il nome dell'ambiente, lo stack di soluzioni e collegamenti tra ambienti da utilizzare durante la creazione dell'ambiente.

Questo formato di file include supporto per gruppi di ambiente. Per utilizzare i gruppi, specifica il nome dell'ambiente nel manifest con un simbolo + alla fine. Quando crei o aggiorni l'ambiente, specifica il nome del gruppo con --group-name (AWS CLI) o --env-group-suffix (CLI EB). Per ulteriori informazioni sui gruppi, consulta Creazione e aggiornamento di gruppi di ambienti Elastic Beanstalk.

L'esempio di manifest seguente definisce un ambiente server Web con un collegamento a un componente di ambiente lavoratore da cui dipende. Il manifest utilizza i gruppi per consentire la creazione di più ambienti con lo stesso bundle di origine:

~/myapp/frontend/env.yaml

AWSConfigurationTemplateVersion: 1.1.0.0
SolutionStack: 64bit Amazon Linux 2015.09 v2.0.6 running Multi-container Docker 1.7.1 (Generic)
OptionSettings:
  aws:elasticbeanstalk:command:
    BatchSize: '30'
    BatchSizeType: Percentage
  aws:elasticbeanstalk:sns:topics:
    Notification Endpoint: [e-mail]
  aws:elb:policies:
    ConnectionDrainingEnabled: true
    ConnectionDrainingTimeout: '20'
  aws:elb:loadbalancer:
    CrossZone: true
  aws:elasticbeanstalk:environment:
    ServiceRole: aws-elasticbeanstalk-service-role
  aws:elasticbeanstalk:application:
    Application Healthcheck URL: /
  aws:elasticbeanstalk:healthreporting:system:
    SystemType: enhanced
  aws:autoscaling:launchconfiguration:
    IamInstanceProfile: aws-elasticbeanstalk-ec2-role
    InstanceType: t2.micro
    EC2KeyName: workstation-uswest2
  aws:autoscaling:updatepolicy:rollingupdate:
    RollingUpdateType: Health
    RollingUpdateEnabled: true
Tags:
  Cost Center: WebApp Dev
CName: front-A08G28LG+
EnvironmentName: front+
EnvironmentLinks:
  "WORKERQUEUE" : "worker+"

Sono supportate le seguenti chiavi.

• AWSConfigurationTemplateVersion (obbligatoria): versione del modello di configurazione (1.1.0.0,).

  AWSConfigurationTemplateVersion: 1.1.0.0

• Platform: Amazon Resource Name (ARN) della versione della piattaforma dell'ambiente. Puoi specificare una piattaforma in base all'ARN oppure il nome dello stack di soluzioni.

  Platform:
    PlatformArn: arn:aws:elasticbeanstalk:us-east-2::platform/Java 8 running on 64bit Amazon Linux/2.5.0

• SolutionStack: nome completo dello stack di soluzioni utilizzato per creare l'ambiente.

  SolutionStack: 64bit Amazon Linux 2017.03 v2.5.0 running Java 8

• OptionSettings: impostazioni delle opzioni di configurazione da applicare all'ambiente. Ad esempio, la seguente voce imposta il tipo di istanza su t2.micro.

  OptionSettings:
    aws:autoscaling:launchconfiguration:
      InstanceType: t2.micro

• Tags: fino a 47 tag da applicare alle risorse create all'interno dell'ambiente.

  Tags:
    Cost Center: WebApp Dev

• EnvironmentTier: tipo di ambiente da creare. Per un ambiente server Web, è possibile escludere questa sezione (il server Web è l'impostazione predefinita). Per un ambiente lavoratore, utilizza le seguenti indicazioni.

  EnvironmentTier:
    Name: Worker
    Type: SQS/HTTP

• CName: CNAME dell'ambiente. Includi un carattere + alla fine del nome per abilitare i gruppi.

  CName: front-A08G28LG+

• EnvironmentName: nome dell'ambiente da creare. Includi un carattere + alla fine del nome per abilitare i gruppi.

  EnvironmentName: front+

  Con i gruppi abilitati, devi specificare un nome del gruppo quando crei gli ambienti. Elastic Beanstalk aggiunge il nome del gruppo al nome dell'ambiente con un trattino. Ad esempio, con il nome dell'ambiente front+ e il nome del gruppo dev, Elastic Beanstalk creerà l'ambiente con il nome front-dev.

• EnvironmentLinks: mappa dei nomi delle variabili e degli ambienti delle dipendenze. L'esempio seguente rende l'ambiente worker+ una dipendenza e indica a Elastic Beanstalk di salvare le informazioni di collegamento su una variabile denominata WORKERQUEUE.

  EnvironmentLinks:
    "WORKERQUEUE" : "worker+"

  Il valore della variabile di collegamento varia a seconda del tipo di ambiente collegato. Per un ambiente server Web, il link è il CNAME dell'ambiente. Per un ambiente worker, il collegamento è il nome della coda Amazon Simple Queue Service (Amazon SQS) dell'ambiente.

Le chiavi CName, EnvironmentName (Nome ambiente) e EnvironmentLinks (Link ambiente) possono essere utilizzate per creare i gruppi di ambienti e i link ad altri ambienti. Queste caratteristiche sono attualmente supportate quando utilizzi la CLI EB, AWS CLI o un SDK.