Utilizzo della piattaforma Node.js di Elastic Beanstalk

Questo argomento descrive come configurare, creare ed eseguire le applicazioni Node.js su Elastic Beanstalk.

AWS Elastic Beanstalk supporta una serie di rami di piattaforma per diverse versioni del linguaggio di programmazione Node.js. Per un elenco completo, consulta Node.js nel documento AWS Elastic Beanstalk Platforms.

Elastic Beanstalk fornisce le opzioni di configurazione che puoi utilizzare per personalizzare il software in esecuzione sulle istanze EC2 nell'ambiente Elastic Beanstalk. È possibile configurare le variabili di ambiente necessarie per l'applicazione, abilitare la rotazione dei log su Amazon S3 e mappare le cartelle nel codice sorgente dell'applicazione che contengono i file statici ai percorsi serviti dal server proxy.

Sono disponibili opzioni di configurazione specifiche della piattaforma nella console Elastic Beanstalk per la modifica della configurazione di un ambiente in esecuzione. Per conservare la configurazione dell'ambiente una volta terminata, puoi utilizzare configurazioni salvate per salvare le impostazioni e applicarle successivamente a un altro ambiente.

Per salvare le impostazioni nel codice sorgente, puoi includere i file di configurazione. Le impostazioni nei file di configurazione vengono applicate ogni volta che crei un ambiente o distribuisci l'applicazione. Puoi inoltre utilizzare i file di configurazione per installare pacchetti, eseguire script o altre operazioni di personalizzazione delle istanze durante le distribuzioni.

Puoi includere un file Package.json nel bundle di origine per installare i pacchetti durante l'implementazione, per fornire un comando start e per specificare la versione di Node.js che desideri sia utilizzata dall'applicazione. Puoi includere un file npm-shrinkwrap.json per bloccare le versioni delle dipendenze.

La piattaforma Node.js include un server proxy che serve asset statici, inoltra il traffico verso la tua applicazione e comprime le risposte. Puoi estendere o sostituire la configurazione proxy predefinita per scenari avanzati.

Ci sono diverse opzioni per avviare l'applicazione. Puoi aggiungere un Procfile al tuo bundle di origine per specificare il comando che avvia l'applicazione. Quando non fornisci un Procfile ma specifichi un file package.json, Elastic Beanstalk esegue npm start. Se non viene fornito, Elastic Beanstalk cerca il file app.js o server.js, in questo ordine, e lo esegue.

Le impostazioni applicate nella console Elastic Beanstalk sostituiscono le stesse impostazioni nei file di configurazione, se esistenti. Ciò ti consente di disporre di impostazioni predefinite nei file di configurazione, sostituibili con impostazioni specifiche per l'ambiente nella console. Per ulteriori informazioni sulla precedenza e altri metodi di modifica delle impostazioni, consulta Opzioni di configurazione.

Per informazioni dettagliate sui vari modi in cui è possibile estendere una piattaforma Elastic Beanstalk basata su Linux, consulta Estensione delle piattaforme Elastic Beanstalk Linux.

Configurazione dell'ambiente Node.js

Puoi utilizzare le impostazioni della Node.js piattaforma per ottimizzare il comportamento delle tue istanze Amazon EC2 . Puoi modificare la configurazione dell' EC2 istanza Amazon per il tuo ambiente Elastic Beanstalk utilizzando la console Elastic Beanstalk.

Utilizza la console Elastic Beanstalk per attivare la rotazione dei log in Amazon S3 e configurare variabili che l'applicazione è in grado di leggere dall'ambiente.

Opzioni del container

È possibile specificare le seguenti opzioni specifiche della piattaforma:

Opzioni di log

La sezione Log Options (Opzioni di log) ha due impostazioni:

File statici

Per migliorare le prestazioni, la sezione Static files (File statici) consente di configurare il server proxy affinché fornisca file statici (ad esempio, HTML o immagini) da un set di directory all'interno dell'applicazione Web. Per ogni directory, è possibile impostare il percorso virtuale per la mappatura delle directory. Quando il server proxy riceve una richiesta da un file nel percorso specificato, questo serve il file direttamente anziché instradare la richiesta all'applicazione.

Per informazioni dettagliate sulla configurazione di file statici utilizzando file di configurazione o la console Elastic Beanstalk, consulta Fornire i file statici.

Proprietà dell'ambiente

Utilizza la sezione Environment Properties per specificare le impostazioni di configurazione dell'ambiente sulle EC2 istanze Amazon su cui è in esecuzione l'applicazione. Queste impostazioni sono passate come coppie chiave-valore all'applicazione.

All'interno dell'Node.jsambiente in cui viene eseguito AWS Elastic Beanstalk, puoi accedere alle variabili di ambiente process.env.ENV_VARIABLE eseguendo.

var endpoint = process.env.API_ENDPOINT

La piattaforma Node.js imposta la variabile di ambiente PORT sulla porta a cui il server proxy trasferisce il traffico. Per ulteriori informazioni, consulta Configurazione del server proxy.

Per ulteriori informazioni, consulta Variabili di ambiente e altre impostazioni software.

Spazi dei nomi per la configurazione di Node.js

È possibile utilizzare un file di configurazione per impostare le opzioni di configurazione ed eseguire alte attività di configurazione delle istanze durante le distribuzioni. Le opzioni di configurazione possono essere specifiche della piattaforma o essere applicate a tutte le piattaforme del servizio Elastic Beanstalk nel suo complesso. Le opzioni di configurazione sono organizzate in namespace.

È possibile scegliere il proxy da utilizzare nelle istanze dell'ambiente utilizzando lo spazio dei nomi aws:elasticbeanstalk:environment:proxy. L'esempio seguente configura l'ambiente in modo da utilizzare il server proxy HTTPD di Apache.

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: apache

È possibile configurare il proxy per servire file statici utilizzando lo spazio dei nomi aws:elasticbeanstalk:environment:proxy:staticfiles. Per ulteriori informazioni e un esempio, consulta Fornire i file statici.

In Elastic Beanstalk sono disponibili varie opzioni di configurazione per la personalizzazione dell'ambiente. Oltre ai file di configurazione, puoi impostare le opzioni di configurazione tramite la console, le configurazioni salvate, la CLI EB o AWS CLI. Per ulteriori informazioni, consulta Opzioni di configurazione.

var port = process.env.PORT || 8080;

app.listen(port, function() {
  console.log('Server running at http://127.0.0.1:%s', port);
});

option_settings:
  aws:elasticbeanstalk:container:nodejs: 
    NodeCommand: "npm start"
    ProxyServer: apache
    GzipCompression: true
  aws:elasticbeanstalk:container:nodejs:staticfiles:
    /html: statichtml
    /images: staticimages