AWS App Runner wird ab dem 30. April 2026 nicht mehr für Neukunden geöffnet sein. Wenn Sie App Runner verwenden möchten, melden Sie sich vor diesem Datum an. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Änderung der AWS App Runner Verfügbarkeit](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html). Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Verwenden der Node.js-Plattform von **Wichtig** App Runner wird die Unterstützung für **Node.js 12**, **Node.js 14**, **Node.js 16** und **Node.js 18** am 1. Dezember 2025 einstellen. Empfehlungen und weitere Informationen finden Sie unter[Ende der Unterstützung für verwaltete Runtime-Versionen](service-source-code.md#service-source-code.managed-platforms.eos). Die Plattform AWS App Runner Node.js bietet verwaltete Laufzeiten. Jede Laufzeit macht es einfach, Container mit Webanwendungen zu erstellen und auszuführen, die auf einer Version von Node.js basieren. Wenn Sie eine Node.js Runtime verwenden, startet App Runner mit einem verwalteten Node.js Runtime-Image. Dieses Image basiert auf dem [Amazon Linux Docker-Image](https://hub.docker.com/_/amazonlinux) und enthält das Runtime-Paket für eine Version von Node.js und einige Tools. App Runner verwendet dieses verwaltete Runtime-Image als Basis-Image und fügt Ihren Anwendungscode hinzu, um ein Docker-Image zu erstellen. Anschließend wird dieses Image bereitgestellt, um Ihren Webservice in einem Container auszuführen. Sie geben eine Laufzeit für Ihren App Runner-Dienst an, wenn Sie [einen Dienst mithilfe der App Runner-Konsole oder des [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)API-Vorgangs erstellen](manage-create.md). Sie können auch eine Laufzeit als Teil Ihres Quellcodes angeben. Verwenden Sie das `runtime` Schlüsselwort in einer [App Runner-Konfigurationsdatei](config-file.md), die Sie in Ihr Code-Repository aufnehmen. Die Benennungskonvention einer verwalteten Laufzeit lautet**. Gültige Laufzeitnamen und Versionen von Node.js finden Sie unter[Informationen zur Runtime-Version von Node.js](service-source-code-nodejs-releases.md). App Runner aktualisiert die Laufzeit für Ihren Dienst bei jeder Bereitstellung oder jedem Service-Update auf die neueste Version. Wenn Ihre Anwendung eine bestimmte Version einer verwalteten Laufzeit benötigt, können Sie diese mithilfe des `runtime-version` Schlüsselworts in der [App Runner-Konfigurationsdatei](config-file.md) angeben. Sie können sich auf eine beliebige Versionsebene beschränken, einschließlich einer Haupt- oder Nebenversion. App Runner aktualisiert die Laufzeit Ihres Dienstes nur auf niedrigerer Ebene. Versionssyntax für die Laufzeiten von Node.js: `major[.minor[.patch]]` Beispiel: `22.14.0` Die folgenden Beispiele veranschaulichen das Sperren von Versionen: + `22.14`— Sperren Sie die Haupt- und Nebenversionen. App Runner aktualisiert nur Patch-Versionen. + `22.14.0`— Auf eine bestimmte Patch-Version festlegen. App Runner aktualisiert Ihre Runtime-Version nicht. **Topics** + [Laufzeitkonfiguration von Node.js](#service-source-code-nodejs.config) + [Callouts für bestimmte Runtime-Versionen](#service-source-code-nodejs.callouts) + [Beispiele für die Laufzeit von Node.js](#service-source-code-nodejs.examples) + [Informationen zur Runtime-Version von Node.js](service-source-code-nodejs-releases.md) ## Laufzeitkonfiguration von Node.js Wenn Sie sich für eine verwaltete Runtime entscheiden, müssen Sie mindestens auch Build- und Run-Befehle konfigurieren. Sie konfigurieren sie bei der [Erstellung](manage-create.md) oder [Aktualisierung](manage-configure.md) Ihres App Runner-Dienstes. Sie können dies mit einer der folgenden Methoden tun: + **Verwenden der App Runner-Konsole** — Geben Sie die Befehle im Abschnitt **Build konfigurieren** des Erstellungsprozesses oder der Registerkarte Konfiguration an. + **Verwenden der App Runner-API** — Rufen Sie den [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)API-Vorgang [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)oder auf. Geben Sie die Befehle mithilfe der `StartCommand` Elemente `BuildCommand` und des [CodeConfigurationValues](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfigurationValues.html)Datentyps an. + **Mithilfe einer [Konfigurationsdatei](config-file.md)** — Geben Sie einen oder mehrere Build-Befehle in bis zu drei Build-Phasen sowie einen einzelnen Run-Befehl an, der zum Starten Ihrer Anwendung dient. Es gibt zusätzliche optionale Konfigurationseinstellungen. Die Bereitstellung einer Konfigurationsdatei ist optional. Wenn Sie einen App Runner-Dienst mithilfe der Konsole oder der API erstellen, geben Sie an, ob App Runner Ihre Konfigurationseinstellungen direkt bei der Erstellung oder aus einer Konfigurationsdatei bezieht. Speziell bei den Laufzeiten von Node.js können Sie den Build und die Laufzeit auch mithilfe einer JSON-Datei konfigurieren, die `package.json` im Stammverzeichnis Ihres Quell-Repositorys benannt ist. Mithilfe dieser Datei können Sie die Engine-Version von Node.js, die Abhängigkeitspakete und verschiedene Befehle (Befehlszeilenanwendungen) konfigurieren. Paketmanager wie npm oder yarn interpretieren diese Datei als Eingabe für ihre Befehle. Beispiel: + **npm install**installiert Pakete, die durch den `devDependencies` Knoten `dependencies` und in `package.json` definiert sind. + **npm start**oder **npm run start** führt den durch den `scripts/start` Knoten in definierten Befehl aus`package.json`. Im Folgenden sehen Sie ein Beispiel für eine `package.json`-Datei. ### 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" } } ``` Weitere Informationen `package.json` dazu finden Sie unter [Erstellen einer package.json-Datei](https://docs.npmjs.com/creating-a-package-json-file) auf der *npm* Docs-Website. **Tipps** Wenn Ihre `package.json` Datei einen **start** Befehl definiert, können Sie ihn als **run** Befehl in Ihrer App Runner-Konfigurationsdatei verwenden, wie das folgende Beispiel zeigt. **Example** package.json ``` { "scripts": { "start": "node index.js" } } ``` apprunner.yaml ``` run: command: npm start ``` Wenn Sie **npm install** in Ihrer Entwicklungsumgebung ausführen, erstellt npm die Datei. `package-lock.json` Diese Datei enthält einen Snapshot der Paketversionen, die npm gerade installiert hat. Wenn npm anschließend Abhängigkeiten installiert, verwendet es genau diese Versionen. Wenn Sie Garn installieren, wird eine `yarn.lock` Datei erstellt. Übergeben Sie diese Dateien in Ihr Quellcode-Repository, um sicherzustellen, dass Ihre Anwendung mit den Versionen der Abhängigkeiten installiert wird, mit denen Sie sie entwickelt und getestet haben. Sie können auch eine App Runner-Konfigurationsdatei verwenden, um die Version von Node.js und den Startbefehl zu konfigurieren. Wenn Sie dies tun, überschreiben diese Definitionen die Definitionen in`package.json`. Ein Konflikt zwischen der `node` Version in `package.json` und dem `runtime-version` Wert in der App Runner-Konfigurationsdatei führt dazu, dass die App Runner-Buildphase fehlschlägt. ## Callouts für bestimmte Runtime-Versionen ### Node.js 22 und Node.js 18 (überarbeiteter App Runner-Build) App Runner führt jetzt einen aktualisierten Build-Prozess für Anwendungen aus, die auf den folgenden Laufzeitversionen basieren: Python 3.11, Node.js 22 und Node.js 18. Wenn Ihre Anwendung auf einer dieser Runtime-Versionen ausgeführt wird, finden Sie weitere Informationen [Verwaltete Runtime-Versionen und der App Runner-Build](service-source-code.md#service-source-code.build-detail) zum überarbeiteten Build-Prozess unter. Anwendungen, die alle anderen Runtime-Versionen verwenden, sind nicht betroffen, und sie verwenden weiterhin den ursprünglichen Build-Prozess. ## Beispiele für die Laufzeit von Node.js Die folgenden Beispiele zeigen App Runner-Konfigurationsdateien zum Erstellen und Ausführen eines Node.js -Dienstes. **Anmerkung** Die Runtime-Version, die in diesen Beispielen verwendet wird, ist*22.14.0*. Sie können sie durch eine Version ersetzen, die Sie verwenden möchten. Die neueste unterstützte Laufzeitversion von Node.js finden Sie unter[Informationen zur Runtime-Version von Node.js](service-source-code-nodejs-releases.md). ### Minimale Konfigurationsdatei Node.js Dieses Beispiel zeigt eine Minimalkonfigurationsdatei, die Sie mit einer verwalteten Laufzeit von Node.js verwenden können. Informationen zu den Annahmen, die App Runner mit einer minimalen Konfigurationsdatei trifft, finden Sie unter[Beispiele für Konfigurationsdateien](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 ``` ### Erweiterte Konfigurationsdatei Node.js Dieses Beispiel zeigt die Verwendung aller Konfigurationsschlüssel mit einer verwalteten Laufzeit von Node.js. **Anmerkung** Die Runtime-Version, die in diesen Beispielen verwendet wird, ist*22.14.0*. Sie können sie durch eine Version ersetzen, die Sie verwenden möchten. Die neueste unterstützte Laufzeitversion von Node.js finden Sie unter[Informationen zur Runtime-Version von 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" ``` ### Erweiterte Konfigurationsdatei Node.js — Node.js 22 (verwendet einen überarbeiteten Build) Dieses Beispiel zeigt die Verwendung aller Konfigurationsschlüssel mit einer von Node.js verwalteten Laufzeit in der`apprunner.yaml`. Dieses Beispiel enthält einen `pre-run` Abschnitt, da diese Version von Node.js den überarbeiteten App Runner-Build verwendet. Der `pre-run` Parameter wird nur vom überarbeiteten App Runner-Build unterstützt. Fügen Sie diesen Parameter nicht in Ihre Konfigurationsdatei ein, wenn Ihre Anwendung Runtime-Versionen verwendet, die vom ursprünglichen App Runner-Build unterstützt werden. Weitere Informationen finden Sie unter [Verwaltete Runtime-Versionen und der App Runner-Build](service-source-code.md#service-source-code.build-detail). **Anmerkung** Die Runtime-Version, die in diesen Beispielen verwendet wird, ist*22.14.0*. Sie können sie durch eine Version ersetzen, die Sie verwenden möchten. Die neueste unterstützte Laufzeitversion von Node.js finden Sie unter[Informationen zur Runtime-Version von 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 mit Grunt Dieses Beispiel zeigt, wie eine Node.js -Anwendung konfiguriert wird, die mit Grunt entwickelt wurde. [Grunt](https://gruntjs.com/) ist ein JavaScript Task-Runner über die Befehlszeile. Es führt sich wiederholende Aufgaben aus und verwaltet die Prozessautomatisierung, um menschliche Fehler zu reduzieren. Die Plugins Grunt und Grunt werden mit npm installiert und verwaltet. Sie konfigurieren Grunt, indem Sie die `Gruntfile.js` Datei in das Stammverzeichnis Ihres Quell-Repositorys aufnehmen. **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** Die Runtime-Version, die in diesen Beispielen verwendet wird, ist. *22.14.0* Sie können sie durch eine Version ersetzen, die Sie verwenden möchten. Die neueste unterstützte Laufzeitversion von Node.js finden Sie unter[Informationen zur Runtime-Version von 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 ``` # Informationen zur Runtime-Version von Node.js **Wichtig** App Runner wird den Support für **Node.js 12**, **Node.js 14**, **Node.js 16** und **Node.js 18** am 1. Dezember 2025 einstellen. Empfehlungen und weitere Informationen finden Sie unter[Ende der Unterstützung für verwaltete Runtime-Versionen](service-source-code.md#service-source-code.managed-platforms.eos). **Anmerkung** Die Standardrichtlinie von App Runner sieht vor, dass eine Laufzeit als veraltet eingestuft wird, wenn für eine wichtige Komponente der Laufzeit der Community Long-Term Support (LTS) ausläuft und keine Sicherheitsupdates mehr verfügbar sind. In einigen Fällen kann App Runner das Verfallen einer Laufzeit für einen begrenzten Zeitraum hinauszögern, und zwar über das end-of-support Datum der von der Laufzeit unterstützten Sprachversion hinaus. Ein Beispiel für einen solchen Fall könnte die Erweiterung des Supports für eine Runtime sein, um Kunden Zeit für die Migration zu geben. In diesem Thema werden die vollständigen Informationen zu den Runtime-Versionen von Node.js aufgeführt, die App Runner unterstützt. **Unterstützte Runtime-Versionen — überarbeiteter App Runner-Build** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/service-source-code-nodejs-releases.html) **Anmerkung** App Runner bietet einen überarbeiteten Build-Prozess für bestimmte Haupt-Runtimes, die in jüngerer Zeit veröffentlicht wurden. Aus diesem Grund finden Sie in bestimmten Abschnitten dieses Dokuments Verweise auf den *überarbeiteten App Runner-Build* *und den ursprünglichen App Runner-Build*. Weitere Informationen finden Sie unter [Verwaltete Runtime-Versionen und der App Runner-Build](service-source-code.md#service-source-code.build-detail). **Unterstützte Runtime-Versionen — überarbeiteter App Runner-Build** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/service-source-code-nodejs-releases.html) **Unterstützte Runtime-Versionen — originaler App Runner-Build** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/service-source-code-nodejs-releases.html)