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.

Arbeiten mit Ebenen für Node.js Lambda-Funktionen

Eine Lambda-Ebene ist ein ZIP-Dateiarchiv mit ergänzendem Code oder ergänzenden Daten. Ebenen enthalten üblicherweise Bibliotheksabhängigkeiten, eine benutzerdefinierte Laufzeit oder Konfigurationsdateien. Das Erstellen einer Ebene umfasst drei allgemeine Schritte:

Dieses Thema enthält Schritte und Anleitungen zum ordnungsgemäßen Verpacken und Erstellen einer Node.js-Lambda-Ebene mit externen Bibliotheksabhängigkeiten.

Voraussetzungen

Um die Schritte in diesem Abschnitt ausführen zu können, müssen Sie über folgende Voraussetzungen verfügen:

In diesem Thema verweisen wir auf die layer-nodejs-Beispielanwendung im GitHub-Repository aws-lambda-developer-guide. Diese Anwendung enthält Skripte, die eine Abhängigkeit herunterladen und in eine Ebene packen. Die Anwendung enthält auch entsprechende Funktionen, die die Abhängigkeit von der Ebene nutzen. Nachdem Sie eine Ebene erstellt haben, können Sie die entsprechende Funktion bereitstellen und aufrufen, um zu überprüfen, ob alles funktioniert. Diese Beispielanwendung verwendet die 20-Laufzeit von Node.js. Wenn Sie zusätzliche Abhängigkeiten zu Ihrer Ebene hinzufügen, müssen diese mit Node.js 20 kompatibel sein.

Die layer-nodejs-Beispielanwendung packt die lodash-Bibliothek in eine Lambda-Ebene. Das layer-Verzeichnis enthält die Skripten zur Generierung der Ebene. Das function-Verzeichnis enthält eine Beispielfunktion, mit der Sie testen können, ob die Ebene funktioniert. In diesem Dokument wird beschrieben, wie Sie diese Ebene erstellen, verpacken, bereitstellen und testen.

Kompatibilität der Node.js- Ebene mit der Lambda-Laufzeitumgebung

Wenn Sie Code in einer Node.js- Ebene verpacken, geben Sie die Lambda-Laufzeitumgebungen an, mit denen der Code kompatibel ist. Um die Codekompatibilität mit einer Laufzeit zu beurteilen, sollten Sie sich überlegen, für welche Versionen von Node.js, für welche Betriebssysteme und für welche Befehlssatzarchitekturen der Code konzipiert ist.

Lambda-Node.js-Laufzeiten geben ihre Node.js-Version und ihr Betriebssystem an. In diesem Dokument verwenden Sie die Node.js-20-Laufzeit, die auf AL2023 basiert. Weitere Informationen zu Laufzeitversionen finden Sie unter Unterstützte Laufzeiten. Wenn Sie eine Lambda-Funktion erstellen, geben Sie die Befehlssatzarchitektur an. In diesem Dokument verwenden Sie die arm64-Architektur. Weitere Informationen über Architekturen in Lambda finden Sie unter Auswahl und Konfiguration einer Befehlssatzarchitektur für Ihre Lambda-Funktion.

Wenn Sie Code verwenden, der in einem Paket bereitgestellt wird, definiert jeder Paketbetreuer unabhängig dessen Kompatibilität. Die meisten Node.js-Entwicklungen sind so konzipiert, dass sie unabhängig von Betriebssystem und Befehlssatzarchitektur funktionieren. Außerdem sind Inkompatibilitäten mit neuen Node.js-Versionen nicht so häufig. Rechnen Sie damit, dass Sie mehr Zeit damit verbringen werden, die Kompatibilität zwischen den Paketen zu prüfen, als die Kompatibilität der Pakete mit der Node.js-Version, dem Betriebssystem oder der Befehlssatzarchitektur zu prüfen.

Manchmal enthalten Node.js-Pakete kompilierten Code, bei dem Sie die Kompatibilität mit dem Betriebssystem und der Befehlssatzarchitektur berücksichtigen müssen. Wenn Sie die Kompatibilität des Codes für Ihre Pakete beurteilen müssen, müssen Sie die Pakete und ihre Dokumentation untersuchen. NPM-Pakete können ihre Kompatibilität über die Felder engines, os und cpu in ihrer Manifestdatei package.json angeben. Weitere Informationen über package.json-Dateien finden Sie unter package.json in der NPM-Dokumentation.

Ebenenpfade für Node.js-Laufzeiten

Wenn Sie einer Funktion eine Ebene hinzufügen, lädt Lambda den Ebeneninhalt in die Ausführungsumgebung. Wenn Ihre Ebene Abhängigkeiten in bestimmten Ordnerpfaden verpackt, erkennt die Node.js-Ausführungsumgebung die Module, und Sie können in Ihrem Funktionscode auf die Module verweisen.

Um sicherzustellen, dass Ihre Module aufgenommen werden, verpacken Sie sie in Ihre Ebenen-.zip-Datei in einem der folgenden Ordnerpfade. Diese Dateien werden in /opt gespeichert, und die Ordnerpfade werden in die Umgebungsvariable PATH geladen.

Die resultierende Ebenen-.zip-Datei, die Sie in diesem Tutorial erstellen, hat beispielsweise die folgende Verzeichnisstruktur:

layer_content.zip
└ nodejs
    └ node20
        └ node_modules
            └ lodash
            └ <other potential dependencies>
            └ ...

Sie werden die lodash Bibliothek in das nodejs/node20/node_modules-Verzeichnis einfügen. Dadurch wird sichergestellt, dass Lambda die Bibliothek bei Funktionsaufrufen finden kann.

Verpacken des Ebeneninhalts

In diesem Beispiel verpacken Sie die lodash-Bibliothek in einer Ebenen-.zip-Datei. Führen Sie die folgenden Schritte aus, um den Ebeneninhalt zu installieren und zu verpacken.

Erstellen der Ebene

Nehmen Sie die layer_content.zip-Datei, die Sie im vorherigen Abschnitt erstellt haben und laden Sie sie als Lambda-Ebene hoch. Sie können eine Ebene mit der AWS Management Console oder der Lambda-API über die AWS Command Line Interface (AWS CLI) hochladen. Wenn Sie die .zip-Datei Ihrer Ebene hochladen, geben Sie im folgenden Befehl PublishLayerVersion AWS CLI nodejs20.x als kompatible Laufzeit und arm64 als kompatible Architektur an.

aws lambda publish-layer-version --layer-name nodejs-lodash-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes nodejs20.x \
    --compatible-architectures "arm64"

Notieren Sie sich aus der Antwort den LayerVersionArn, der wie arn:aws:lambda:us-east-1:123456789012:layer:nodejs-lodash-layer:1 aussieht. Sie benötigen diesen Amazon-Ressourcennamen (ARN) im nächsten Schritt dieses Tutorials, wenn Sie die Ebene zu Ihrer Funktion hinzufügen.

Hinzufügen der Ebene zur Funktion

Stellen Sie eine Lambda-Beispielfunktion bereit, die die lodash-Bibliothek in ihrem Funktionscode verwendet, und fügen Sie dann die von Ihnen erstellte Ebene hinzu. Um die Funktion bereitzustellen, benötigen Sie eine Ausführungsrolle. Weitere Informationen finden Sie unter Definieren von Lambda-Funktionsberechtigungen mit einer Ausführungsrolle. Wenn Sie noch keine Ausführungsrolle haben, folgen Sie den Schritten im zusammenklappbaren Abschnitt. Andernfalls überspringen Sie diesen Abschnitt und gehen Sie direkt zum Bereitstellen der Funktion.

Der Beispielfunktionscode verwendet die Methode lodash _.findLastIndex, um ein Array von Objekten zu lesen. Er vergleicht die Objekte mit einem Kriterium, um den Index einer Übereinstimmung zu finden. Anschließend werden der Index und der Wert des Objekts in der Lambda-Antwort zurückgegeben.

import _ from "lodash"

export const handler = async (event) => {

  var users = [
  { 'user': 'Carlos',  'active': true },
  { 'user': 'Gil-dong',    'active': false },
  { 'user': 'Pat', 'active': false }
  ];

  let out = _.findLastIndex(users, function(o) { return o.user == 'Pat'; });
  const response = {
    statusCode: 200,
    body: JSON.stringify(out + ", " + users[out].user),
  };
  return response;
};