Impostazione delle opzioni di configurazione durante la creazione di un ambiente - AWS Elastic Beanstalk

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Impostazione delle opzioni di configurazione durante la creazione di un ambiente

Quando si crea un ambiente AWS Elastic Beanstalk utilizzando la console Elastic Beanstalk, la CLI EB, la AWS CLI, un SDK o l'API Elastic Beanstalk, è possibile fornire valori per le opzioni di configurazione al fine di personalizzare l'ambiente e le risorse AWS avviate al suo interno.

Per tutto ciò di diverso da una modifica di configurazione una tantum, è possibile archiviare i file di configurazione in locale, nel bundle di origine o in Amazon S3.

Questo argomento include le procedure per tutti i metodi di impostazione delle opzioni di configurazione durante la creazione dell'ambiente.

Nella console Elastic Beanstalk

Quando crei un ambiente Elastic Beanstalk nella console Elastic Beanstalk, è possibile fornire le opzioni di configurazione utilizzando i file di configurazione, le configurazioni salvate e i moduli nella procedura guidata Create New Environment (Crea nuovo ambiente).

Utilizzo dei file di configurazione (.ebextensions)

Includi i file .config nel bundle di origine dell'applicazione in una cartella chiamata .ebextensions.

Per informazioni dettagliate sui file di configurazione, consulta .Ebextensions.

~/workspace/my-app-v1.zip |-- .ebextensions | |-- environmentvariables.config | `-- healthcheckurl.config |-- index.php `-- styles.css

Carica normalmente il bundle sorgente su Elastic Beanstalk durante la creazione dell'ambiente.

La console Elastic Beanstalk applica valori consigliati per alcune opzioni di configurazione e campi dei moduli per le altre. Le impostazioni configurate dalla console Elastic Beanstalk vengono applicate direttamente all'ambiente e sovrascrivono le impostazioni nei file di configurazione.

Utilizzo di una configurazione salvata

Quando crei un nuovo ambiente utilizzando la console Elastic Beanstalk, uno dei primi passaggi è scegliere una configurazione. La configurazione può essere una Predefined configuration (Configurazione predefinita), generalmente la versione più recente di una piattaforma, ad esempio PHP o Tomcat oppure una Saved configuration (Configurazione salvata).

Per applicare una configurazione salvata durante la creazione dell'ambiente (console Elastic Beanstalk)
  1. Apri la console Elastic Beanstalk e nell'elenco Regions (Regioni) seleziona la tua Regione AWS.

  2. Nel riquadro di navigazione, scegliere Applicazioni, quindi selezionare il nome dell'applicazione dall'elenco.

    Nota

    Se si dispone di molte applicazioni, utilizzare la barra di ricerca per filtrare l'elenco delle applicazioni.

  3. Nel riquadro di spostamento individuare il nome dell'applicazione e scegliere Saved configurations (Configurazioni salvate).

  4. Selezionare la configurazione salvata che si desidera applicare, quindi scegliere Launch environment (Avvia ambiente).

  5. Procedi seguendo la procedura guidata per creare l'ambiente.

Le configurazioni salvate sono specifiche dell'applicazione. Consulta Configurazioni salvate per dettagli sulla creazione di configurazioni salvate.

Utilizzo della procedura guidata per la creazione del nuovo ambiente

La maggior parte delle opzioni di configurazione standard sono riportate nella pagina Configure more options (Configurazione di più opzioni) della procedura guidata Create New Environment (Crea un nuovo ambiente). Se crei un database Amazon RDS o configuri un VPC per l'ambiente in uso, le opzioni di configurazione aggiuntive sono disponibili per tali risorse.

Per impostare le opzioni di configurazione durante la creazione dell'ambiente (console Elastic Beanstalk)
  1. Apri la console Elastic Beanstalk e nell'elenco Regions (Regioni) seleziona la tua Regione AWS.

  2. Nel riquadro di navigazione, scegliere Applications (Applicazioni).

  3. Seleziona o crea un'applicazione.

  4. Selezionare Actions (Operazioni) e scegliere Create environment (Crea ambiente).

  5. Continua con la procedura guidata e scegli Configure more options (Configura altre opzioni).

  6. Scegliere una delle configuration presets (impostazioni di configurazione predefinite) e successivamente scegliere Edit (Modifica) in una o più categorie di configurazione per modificare un gruppo di opzioni di configurazione correlate.

  7. Una volta selezionate le opzioni, scegli Create environment (Crea ambiente).

Le opzioni impostate nella procedura guidata del nuovo ambiente sono impostate direttamente sull'ambiente e sovrascrivono le impostazioni delle opzioni nelle configurazioni salvate o nei file di configurazione (.ebextensions) che applichi. Dopo la creazione dell'ambiente, è possibile annullare le impostazioni utilizzando la CLI EB o la AWS CLI per permettere la visualizzazione delle impostazioni nelle configurazioni salvate o nei file di configurazione.

Per ulteriori informazioni sulla procedura guidata per il nuovo ambiente, consultare Procedura guidata per la creazione del nuovo ambiente.

Utilizzo della CLI EB

Utilizzo dei file di configurazione (.ebextensions)

Includi i file .config nella tua cartella di progetto in .ebextensions per distribuirli con il codice della tua applicazione.

Per informazioni dettagliate sui file di configurazione, consulta .Ebextensions.

~/workspace/my-app/ |-- .ebextensions | |-- environmentvariables.config | `-- healthcheckurl.config |-- .elasticbeanstalk | `-- config.yml |-- index.php `-- styles.css

Crea un ambiente e distribuisci il codice sorgente nello stesso con eb create.

~/workspace/my-app$ eb create my-env

Utilizzo delle configurazioni salvate

Per applicare una configurazione salvata al momento della creazione di un ambiente con eb create, utilizza l'opzione --cfg.

~/workspace/my-app$ eb create --cfg savedconfig

Puoi archiviare la configurazione salvata nella cartella del progetto o nella posizione di storage Elastic Beanstalk in Amazon S3. Nell'esempio precedente, la CLI EB prima cerca un file di configurazione salvato denominato savedconfig.cfg.yml nella cartella .elasticbeanstalk/saved_configs/. Non includere le estensioni dei nomi dei file (.cfg.yml) quando applichi una configurazione salvata con --cfg.

~/workspace/my-app/ |-- .ebextensions | `-- healthcheckurl.config |-- .elasticbeanstalk | |-- saved_configs | | `-- savedconfig.cfg.yml | `-- config.yml |-- index.php `-- styles.css

Se la CLI EB non trova la configurazione localmente, viene eseguita la ricerca nella posizione di storage Elastic Beanstalk in Amazon S3. Per informazioni dettagliate sulla creazione, sulla modifica e sul caricamento delle configurazioni salvate, consulta Configurazioni salvate.

Utilizzo delle opzioni della riga di comando

Il comando eb create della CLI EB presenta diverse opzioni che è possibile utilizzare per impostare le opzioni di configurazione durante la creazione dell'ambiente. Queste opzioni possono essere utilizzate per aggiungere un database RDS all'ambiente, configurare un VPC o sostituire i valori consigliati.

Ad esempio, la CLI EB utilizza il tipo di istanza t2.micro per impostazione predefinita. Per scegliere un tipo di istanza diverso, utilizza l'opzione --instance_type.

$ eb create my-env --instance_type t2.medium

Per creare un'istanza database Amazon RDS e collegarla all'ambiente, utilizza le opzioni --database.

$ eb create --database.engine postgres --database.username dbuser

Se ometti il nome dell'ambiente, la password del database o altri parametri necessari per creare l'ambiente, la CLI EB richiede di immetterli.

Vedi eb create per un elenco completo delle opzioni disponibili e degli esempi di utilizzo.

Tramite la AWS CLI

Quando utilizzi il comando create-environment per creare un ambiente Elastic Beanstalk con la AWS CLI, la AWS CLI non applica i valori consigliati. Tutte le opzioni di configurazione sono definite nei file di configurazione del bundle di origine da te specificati.

Utilizzo dei file di configurazione (.ebextensions)

Per applicare i file di configurazione a un ambiente creato con la AWS CLI, devi includerli nel bundle di origine dell'applicazione caricato in Amazon S3.

Per informazioni dettagliate sui file di configurazione, consulta .Ebextensions.

~/workspace/my-app-v1.zip |-- .ebextensions | |-- environmentvariables.config | `-- healthcheckurl.config |-- index.php `-- styles.css
Per caricare un bundle fonte dell'applicazione e creare un ambiente con AWS CLI
  1. Se non hai già un bucket Elastic Beanstalk in Amazon S3, creane uno con create-storage-location.

    $ aws elasticbeanstalk create-storage-location { "S3Bucket": "elasticbeanstalk-us-west-2-123456789012" }
  2. Carica il bundle di origine dell'applicazione su Amazon S3.

    $ aws s3 cp sourcebundle.zip s3://elasticbeanstalk-us-west-2-123456789012/my-app/sourcebundle.zip
  3. Per creare la versione dell'applicazione.

    $ aws elasticbeanstalk create-application-version --application-name my-app --version-label v1 --description MyAppv1 --source-bundle S3Bucket="elasticbeanstalk-us-west-2-123456789012",S3Key="my-app/sourcebundle.zip" --auto-create-application
  4. Creazione dell'ambiente

    $ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --solution-stack-name "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"

Utilizzo di una configurazione salvata

Per applicare una configurazione salvata a un ambiente durante la creazione, utilizza il parametro --template-name.

$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --template-name savedconfig --version-label v1

Quando specifichi una configurazione salvata, non devi anche specificare un nome dello stack di soluzioni. Le configurazioni salvate già specificano uno stack di soluzioni ed Elastic Beanstalk restituisce un errore se tenti di utilizzare entrambe le opzioni.

Utilizzo delle opzioni della riga di comando

Utilizza il parametro --option-settings per specificare le opzioni di configurazione in formato JSON.

$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --template-name savedconfig --option-settings '[ { "Namespace": "aws:elasticbeanstalk:application", "OptionName": "Application Healthcheck URL", "Value": "/health" } ]

Per caricare il formato JSON da un file, utilizza il prefisso file://.

$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --template-name savedconfig --option-settings file://healthcheckurl.json

Elastic Beanstalk applica le impostazioni delle opzioni specificate con l'opzione --option-settings direttamente nell'ambiente. Se le stesse opzioni vengono specificate in una configurazione salvata o in un file di configurazione, --option-settings sostituisce tali valori.