View a markdown version of this page

Personalizzazione avanzata dell'ambiente con file di configurazione (.ebextensions) - 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à.

Personalizzazione avanzata dell'ambiente con file di configurazione (.ebextensions)

È possibile aggiungere file di AWS Elastic Beanstalk configurazione (.ebextensions) al codice sorgente dell'applicazione Web per configurare l'ambiente e personalizzare le AWS risorse in esso contenute. I file di configurazione sono YAML o JSON-formatted documenti con estensione di .config file che vengono inseriti in una cartella denominata .ebextensions e distribuita nel bundle dei sorgenti dell'applicazione.

Esempio
. ebextensions/network-load-balancer.config

Questo esempio apporta una semplice modifica alla configurazione. Modifica un'opzione di configurazione per impostare il tipo del sistema di bilanciamento del carico dell'ambiente su Network Load Balancer.

option_settings:
  aws:elasticbeanstalk:environment:
    LoadBalancerType: network

Ti consigliamo di usare il formato YAML per i file di configurazione, perché è più leggibile rispetto a JSON. YAML supporta commenti, comandi multi-riga, diverse alternative per l'utilizzo di virgolette e molto altro. Puoi comunque effettuare qualsiasi modifica nei file di configurazione Elastic Beanstalk in modo identico utilizzando YAML o JSON.

Nota

I file di configurazione si applicano solo agli ambienti Beanstalk Standard. Personalizzano le istanze Amazon EC2 che eseguono l'applicazione, cosa che non è disponibile in un ambiente Beanstalk Cluster. Con Beanstalk Cluster, installate le dipendenze dell'applicazione nell'immagine del contenitore, nel Dockerfile o nel sorgente creato da Elastic Beanstalk, e impostate le opzioni di configurazione con o nella console. --option-settings Consulta Creazione di immagini di container per ambienti Beanstalk Cluster e Opzioni di configurazione per ambienti Beanstalk Cluster.

Suggerimento

Quando sviluppi o esegui il test di nuovi i file di configurazione, avvia un ambiente pulito che esegue l'applicazione predefinita e distribuisci in questo ambiente. I file di configurazione con formattazione insufficiente determinano un errore irreversibile di avvio dell'ambiente.

La sezione option_settings di un file di configurazione definisce i valori per le opzioni di configurazione. Le opzioni di configurazione consentono di configurare l'ambiente Elastic Beanstalk, le risorse in esso contenute e il software che esegue l'applicazione. AWS I file di configurazione sono solo uno dei diversi modi per impostare le opzioni di configurazione.

La Resources sezione consente di personalizzare ulteriormente le risorse nell'ambiente dell'applicazione e di definire AWS risorse aggiuntive oltre alle funzionalità fornite dalle opzioni di configurazione. È possibile aggiungere e configurare tutte le risorse supportate da AWS CloudFormation, che Elastic Beanstalk utilizza per creare ambienti.

Le altre sezioni di un file di configurazione (packages, sources, files, users, groupscommands, container_commands e services) consentono di configurare le istanze EC2 che vengono avviate nel tuo ambiente. Ogni volta che un server viene lanciato nel tuo ambiente, Elastic Beanstalk esegue le operazioni definite in queste sezioni per preparare il sistema operativo e il sistema di storage per la tua applicazione.

Per esempi di .ebextensions uso comune, vedere il repository dei file di configurazione di Elastic Beanstalk.

Requisiti

  • Posizione: Elastic Beanstalk elaborerà tutte le .ebextensions cartelle presenti nella distribuzione. Tuttavia, ti consigliamo di inserire tutti i file di configurazione in un'unica cartella, denominata.ebextensions, nella radice del pacchetto sorgente. Le cartelle che iniziano con un punto possono essere nascoste dai browser di file, pertanto accertati che la cartella venga aggiunta al momento della creazione del bundle di origine. Per ulteriori informazioni, consulta Crea un bundle di sorgenti dell'applicazione Elastic Beanstalk.

  • Denominazione: i file di configurazione devono avere l'estensione file .config.

  • Formattazione: i file di configurazione devono essere conformi alle specifiche YAML o JSON.

    Con il formato YAML utilizza sempre gli spazi per applicare il rientro alle chiavi a diversi livelli di nidificazione. Per ulteriori informazioni su YAML, vedi YAML Ain't Markup Language (YAML™) Version 1.1.

  • Unicità: utilizza ciascuna chiave solo una volta in ogni file di configurazione.

    Attenzione

    Se una chiave (ad esempio, option_settings) viene utilizzata due volte nello stesso file di configurazione, una delle sezioni verrà cancellata. Combina le sezioni duplicate in un'unica sezione o inseriscile in file di configurazione separati.

Il processo di distribuzione varia leggermente in funzione del client utilizzato per gestire gli ambienti. Per ulteriori informazioni, consulta le sezioni seguenti:

Argomenti