AWS App Runner non sarà più aperto a nuovi clienti a partire dal 30 aprile 2026. Se desideri utilizzare App Runner, registrati prima di tale data. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [AWS App Runner la pagina Modifica della disponibilità](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html). 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à. # Utilizzo della piattaforma Node.js di **Importante** App Runner interromperà il supporto per **Node.js 12**, **Node.js 14**, **Node.js 16** e **Node.js 18** il 1° dicembre 2025. Per consigli e ulteriori informazioni, consulta. [Fine del supporto per le versioni di runtime gestite](service-source-code.md#service-source-code.managed-platforms.eos) La piattaforma AWS App Runner Node.js fornisce runtime gestiti. Ogni runtime semplifica la creazione e l'esecuzione di contenitori con applicazioni Web basate su una versione Node.js. Quando si utilizza un runtime Node.js, App Runner si avvia con un'immagine di runtime Node.js gestita. Questa immagine è basata sull'[immagine Docker di Amazon Linux](https://hub.docker.com/_/amazonlinux) e contiene il pacchetto di runtime per una versione di Node.js e alcuni strumenti. App Runner utilizza questa immagine di runtime gestita come immagine di base e aggiunge il codice dell'applicazione per creare un'immagine Docker. Quindi distribuisce questa immagine per eseguire il servizio Web in un contenitore. Si specifica un runtime per il servizio App Runner quando si [crea un servizio](manage-create.md) utilizzando la console App Runner o l'[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)operazione API. Puoi anche specificare un runtime come parte del codice sorgente. Usa la `runtime` parola chiave in un [file di configurazione di App Runner](config-file.md) che includi nel tuo repository di codice. La convenzione di denominazione di un runtime gestito è. ** Per i nomi e le versioni di runtime di Node.js validi, vedere[Informazioni sulla versione di runtime di Node.js](service-source-code-nodejs-releases.md). App Runner aggiorna il runtime del servizio alla versione più recente a ogni distribuzione o aggiornamento del servizio. Se l'applicazione richiede una versione specifica di un runtime gestito, è possibile specificarla utilizzando la `runtime-version` parola chiave nel file di [configurazione di App Runner](config-file.md). È possibile utilizzare qualsiasi livello di versione, inclusa una versione principale o secondaria. App Runner effettua solo aggiornamenti di livello inferiore al runtime del servizio. Sintassi della versione per i runtime di Node.js: `major[.minor[.patch]]` Ad esempio: `22.14.0` Gli esempi seguenti mostrano il blocco della versione: + `22.14`— Blocca le versioni principali e secondarie. App Runner aggiorna solo le versioni patch. + `22.14.0`— Blocca a una versione di patch specifica. App Runner non aggiorna la versione di runtime. **Topics** + [Configurazione del runtime di Node.js](#service-source-code-nodejs.config) + [Callout per versioni di runtime specifiche](#service-source-code-nodejs.callouts) + [Esempi di runtime di Node.js](#service-source-code-nodejs.examples) + [Informazioni sulla versione di runtime di Node.js](service-source-code-nodejs-releases.md) ## Configurazione del runtime di Node.js Quando scegli un runtime gestito, devi anche configurare, come minimo, creare ed eseguire comandi. Li configuri durante la [creazione](manage-create.md) o [l'aggiornamento del](manage-configure.md) servizio App Runner. Puoi farlo utilizzando uno dei seguenti metodi: + **Utilizzo della console App Runner**: specifica i comandi nella sezione **Configure build** del processo di creazione o della scheda di configurazione. + **Utilizzo dell'API App Runner**: richiama l'operazione [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)or [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)API. Specificate i comandi utilizzando i `StartCommand` membri `BuildCommand` e del tipo di [CodeConfigurationValues](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfigurationValues.html)dati. + **Utilizzo di un [file di configurazione](config-file.md)**: specifica uno o più comandi di compilazione in un massimo di tre fasi di compilazione e un singolo comando di esecuzione che serve per avviare l'applicazione. Sono disponibili impostazioni di configurazione opzionali aggiuntive. Fornire un file di configurazione è facoltativo. Quando crei un servizio App Runner utilizzando la console o l'API, specifichi se App Runner ottiene le impostazioni di configurazione direttamente al momento della creazione o da un file di configurazione. In particolare, con i runtime di Node.js, puoi anche configurare la build e il runtime utilizzando un file JSON denominato `package.json` nella radice del tuo repository di origine. Utilizzando questo file, è possibile configurare la versione del motore Node.js, i pacchetti di dipendenze e vari comandi (applicazioni a riga di comando). I gestori di pacchetti come npm o yarn interpretano questo file come input per i loro comandi. Esempio: + **npm install**installa i pacchetti definiti dal nodo `dependencies` and `devDependencies` in. `package.json` + **npm start**o **npm run start** esegue il comando definito dal `scripts/start` nodo in`package.json`. Di seguito è riportato un esempio del file `package.json`. ### package.json ``` { "name": "node-js-getting-started", "version": "0.3.0", "description": "A sample Node.js app using Express 4", "engines": { "node": "22.14.0" }, "scripts": { "start": "node index.js", "test": "node test.js" }, "dependencies": { "cool-ascii-faces": "^1.3.4", "ejs": "^2.5.6", "express": "^4.15.2" }, "devDependencies": { "got": "^11.3.0", "tape": "^4.7.0" } } ``` *Per ulteriori informazioni su`package.json`, vedere [Creazione di un file package.json](https://docs.npmjs.com/creating-a-package-json-file) sul sito Web di npm Docs.* **Suggerimenti** Se il `package.json` file definisce un **start** comando, è possibile utilizzarlo come comando nel file di configurazione di App Runner, come illustrato nell'esempio **run** seguente. **Example** package.json ``` { "scripts": { "start": "node index.js" } } ``` apprunner.yaml ``` run: command: npm start ``` Quando esegui **npm install** nel tuo ambiente di sviluppo, npm crea il file. `package-lock.json` Questo file contiene un'istantanea delle versioni del pacchetto appena installate da npm. Successivamente, quando npm installa le dipendenze, utilizza queste versioni esatte. Se installi yarn, crea un file. `yarn.lock` Salva questi file nel tuo repository del codice sorgente per assicurarti che l'applicazione sia installata con le versioni delle dipendenze che hai sviluppato e con cui l'hai testata. È inoltre possibile utilizzare un file di configurazione di App Runner per configurare la versione di Node.js e il comando start. Quando si esegue questa operazione, queste definizioni sostituiscono quelle incluse. `package.json` Un conflitto tra la `node` versione in `package.json` e il `runtime-version` valore nel file di configurazione di App Runner causa il fallimento della fase di compilazione di App Runner. ## Callout per versioni di runtime specifiche ### Node.js 22 e Node.js 18 (build App Runner rivista) App Runner ora esegue un processo di compilazione aggiornato per le applicazioni basate sulle seguenti versioni di runtime: Python 3.11, Node.js 22 e Node.js 18. Se l'applicazione viene eseguita su una di queste versioni di runtime, consulta [Versioni di runtime gestite e build di App Runner](service-source-code.md#service-source-code.build-detail) per ulteriori informazioni sul processo di compilazione rivisto. Le applicazioni che utilizzano tutte le altre versioni di runtime non sono interessate e continuano a utilizzare il processo di compilazione originale. ## Esempi di runtime di Node.js Gli esempi seguenti mostrano i file di configurazione di App Runner per la creazione e l'esecuzione di un servizio Node.js. **Nota** La versione di runtime utilizzata in questi esempi è*22.14.0*. Puoi sostituirla con una versione che desideri utilizzare. Per l'ultima versione di runtime supportata di Node.js, vedere[Informazioni sulla versione di runtime di Node.js](service-source-code-nodejs-releases.md). ### File di configurazione minimo Node.js Questo esempio mostra un file di configurazione minimo che è possibile utilizzare con un runtime gestito da Node.js. Per le ipotesi che App Runner fa con un file di configurazione minimo, vedi. [Esempi di file di configurazione](config-file-examples.md#config-file-examples.managed) **Example apprunner.yaml** ``` version: 1.0 runtime: nodejs22 build: commands: build: - npm install --production run: command: node app.js ``` ### File di configurazione Node.js esteso Questo esempio mostra l'uso di tutte le chiavi di configurazione con un runtime gestito da Node.js. **Nota** La versione di runtime utilizzata in questi esempi è*22.14.0*. Puoi sostituirla con una versione che desideri utilizzare. Per l'ultima versione di runtime supportata di Node.js, vedere[Informazioni sulla versione di runtime di Node.js](service-source-code-nodejs-releases.md). **Example apprunner.yaml** ``` version: 1.0 runtime: nodejs22 build: commands: pre-build: - npm install --only=dev - node test.js build: - npm install --production post-build: - node node_modules/ejs/postinstall.js env: - name: MY_VAR_EXAMPLE value: "example" run: runtime-version: 22.14.0 command: node app.js network: port: 8000 env: APP_PORT env: - name: MY_VAR_EXAMPLE value: "example" ``` ### File di configurazione Node.js esteso — Node.js 22 (utilizza la build rivista) Questo esempio mostra l'uso di tutte le chiavi di configurazione con un runtime gestito da Node.js in. `apprunner.yaml` Questo esempio include una `pre-run` sezione, poiché questa versione di Node.js utilizza la build aggiornata di App Runner. Il `pre-run` parametro è supportato solo dalla build aggiornata di App Runner. Non inserire questo parametro nel file di configurazione se l'applicazione utilizza versioni di runtime supportate dalla build originale di App Runner. Per ulteriori informazioni, consulta [Versioni di runtime gestite e build di App Runner](service-source-code.md#service-source-code.build-detail). **Nota** La versione di runtime utilizzata in questi esempi è*22.14.0*. Puoi sostituirla con una versione che desideri utilizzare. Per l'ultima versione di runtime supportata di Node.js, vedere[Informazioni sulla versione di runtime di Node.js](service-source-code-nodejs-releases.md). **Example apprunner.yaml** ``` version: 1.0 runtime: nodejs22 build: commands: pre-build: - npm install --only=dev - node test.js build: - npm install --production post-build: - node node_modules/ejs/postinstall.js env: - name: MY_VAR_EXAMPLE value: "example" run: runtime-version: 22.14.0 pre-run: - node copy-global-files.js command: node app.js network: port: 8000 env: APP_PORT env: - name: MY_VAR_EXAMPLE value: "example" ``` ### App Node.js con Grunt Questo esempio mostra come configurare un'applicazione Node.js sviluppata con Grunt. [Grunt](https://gruntjs.com/) è un JavaScript task runner da riga di comando. Esegue attività ripetitive e gestisce l'automazione dei processi per ridurre l'errore umano. I plugin Grunt e Grunt vengono installati e gestiti utilizzando npm. Si configura Grunt includendo il `Gruntfile.js` file nella radice del repository di origine. **Example package.json** ``` { "scripts": { "build": "grunt uglify", "start": "node app.js" }, "devDependencies": { "grunt": "~0.4.5", "grunt-contrib-jshint": "~0.10.0", "grunt-contrib-nodeunit": "~0.4.1", "grunt-contrib-uglify": "~0.5.0" }, "dependencies": { "express": "^4.15.2" }, } ``` **Example Gruntfile.js** ``` module.exports = function(grunt) { // Project configuration. grunt.initConfig({ pkg: grunt.file.readJSON('package.json'), uglify: { options: { banner: '/*! <%= pkg.name %> <%= grunt.template.today("yyyy-mm-dd") %> */\n' }, build: { src: 'src/<%= pkg.name %>.js', dest: 'build/<%= pkg.name %>.min.js' } } }); // Load the plugin that provides the "uglify" task. grunt.loadNpmTasks('grunt-contrib-uglify'); // Default task(s). grunt.registerTask('default', ['uglify']); }; ``` **Example apprunner.yaml** La versione di runtime utilizzata in questi esempi è. *22.14.0* Puoi sostituirla con una versione che desideri utilizzare. Per l'ultima versione di runtime supportata di Node.js, vedere[Informazioni sulla versione di runtime di Node.js](service-source-code-nodejs-releases.md). ``` version: 1.0 runtime: nodejs22 build: commands: pre-build: - npm install grunt grunt-cli - npm install --only=dev - npm run build build: - npm install --production run: runtime-version: 22.14.0 command: node app.js network: port: 8000 env: APP_PORT ``` # Informazioni sulla versione di runtime di Node.js **Importante** App Runner interromperà il supporto per **Node.js 12**, **Node.js 14**, **Node.js 16** e **Node.js 18** il 1° dicembre 2025. Per consigli e ulteriori informazioni, consulta. [Fine del supporto per le versioni di runtime gestite](service-source-code.md#service-source-code.managed-platforms.eos) **Nota** La politica di deprecazione standard di App Runner prevede di rendere obsoleto un runtime quando uno dei componenti principali del runtime raggiunge la fine del supporto a lungo termine della community (LTS) e gli aggiornamenti di sicurezza non sono più disponibili. In alcuni casi, App Runner può ritardare l'obsolescenza di un runtime per un periodo limitato, oltre la data della versione linguistica supportata dal runtime. end-of-support Un esempio di questo caso potrebbe essere l'estensione del supporto per un runtime per consentire ai clienti il tempo necessario per la migrazione. Questo argomento elenca i dettagli completi per le versioni di runtime di Node.js supportate da App Runner. **Versioni di runtime supportate: build di App Runner rivista** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/service-source-code-nodejs-releases.html) **Nota** App Runner fornisce un processo di compilazione rivisto per i principali runtime specifici che sono stati rilasciati più di recente. Per questo motivo, in alcune sezioni di questo documento vedrai riferimenti alla build di *App Runner rivista e alla build* *originale di App Runner*. Per ulteriori informazioni, consulta [Versioni di runtime gestite e build di App Runner](service-source-code.md#service-source-code.build-detail). **Versioni di runtime supportate: build di App Runner rivista** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/service-source-code-nodejs-releases.html) **Versioni di runtime supportate: build originale di App Runner** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/service-source-code-nodejs-releases.html)