Verpacken Ihres Ebeneninhalts

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.

In diesem Abschnitt erfahren Sie, wie Sie Ihren Ebeneninhalt ordnungsgemäß verpacken. Weitere konzeptionelle Informationen zu Ebenen sowie dazu, warum Sie ggf. welche verwenden sollten, finden Sie unter Verwaltung von Lambda-Abhängigkeiten mit Ebenen.

Der erste Schritt beim Erstellen einer Ebene besteht darin, den gesamten Ebeneninhalt in einem ZIP-Dateiarchiv zu bündeln. Da Lambda-Funktionen unter Amazon Linux ausgeführt werden, muss Ihr Ebeneninhalt in einer Linux-Umgebung kompiliert und erstellt werden können.

Um sicherzustellen, dass Ihr Ebeneninhalt ordnungsgemäß in einer Linux-Umgebung funktioniert, empfiehlt es sich, den Ebeneninhalt mit einem Tool wie Docker zu erstellen.

Ebenenpfade für jede Lambda-Laufzeit

Wenn Sie einer Funktion eine Ebene hinzufügen, lädt Lambda den Ebeneninhalt in das Verzeichnis /opt der Ausführungsumgebung. Für jede Lambda-Laufzeit enthält die Variable PATH bereits spezifische Ordnerpfade innerhalb des Verzeichnisses /opt. Um sicherzustellen, dass Lambda den Inhalt Ihrer Ebene aufnimmt, müssen die Abhängigkeiten Ihrer ZIP-Datei in einem der folgenden Ordnerpfade enthalten sein:

Laufzeit	Pfad
Node.js	nodejs/node_modules
	nodejs/node18/node_modules (NODE_PATH)
	nodejs/node20/node_modules (NODE_PATH)
	nodejs/node22/node_modules (NODE_PATH)
Python	python
	python/lib/python3.x/site-packages (Site-Verzeichnisse)
Java	java/lib (CLASSPATH)
Ruby	ruby/gems/3.4.0 (GEM_PATH)
	ruby/lib (RUBYLIB)
Alle Laufzeiten	bin (PATH)
	lib (LD_LIBRARY_PATH)

Die folgenden Beispiele zeigen, wie Sie die Ordner im ZIP-Archiv Ihrer Ebene strukturieren können.

Node.js

Beispiel Dateistruktur für das AWS X-Ray-SDK für Node.js

xray-sdk.zip
└ nodejs/node_modules/aws-xray-sdk

Python

python/              # Required top-level directory
└── requests/
└── boto3/
└── numpy/
└── (dependencies of the other packages)

Ruby

Beispiel Dateistruktur für das JSON-Gem

json.zip
└ ruby/gems/3.4.0/
               | build_info
               | cache
               | doc
               | extensions
               | gems
               | └ json-2.1.0
               └ specifications
                 └ json-2.1.0.gemspec

Java

Beispiel Dateistruktur für Jackson-JAR-Datei

layer_content.zip
└ java
    └ lib
        └ jackson-core-2.17.0.jar
        └ <other potential dependencies>
        └ ...

All

Beispiel Dateistruktur für jq-Bibliothek

jq.zip
└ bin/jq

Eine sprachspezifische Anleitung zum Verpacken, Erstellen und Hinzufügen einer Ebene finden Sie auf den folgenden Seiten:

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

• Python – Arbeiten mit Ebenen für Python Lambda-Funktionen

• Ruby – Arbeiten mit Ebenen für Ruby Lambda-Funktionen

• Java – Arbeiten mit Ebenen für Java Lambda-Funktionen

Wir empfehlen, keine Ebenen zur Verwaltung von Abhängigkeiten für in Go und Rust geschriebene Lambda-Funktionen zu verwenden. Der Grund dafür ist, dass in diesen Sprachen geschriebene Lambda-Funktionen zu einer einzigen ausführbaren Datei kompiliert werden, die Sie Lambda bei der Bereitstellung Ihrer Funktion zur Verfügung stellen. Diese ausführbare Datei enthält Ihren kompilierten Funktionscode zusammen mit all seinen Abhängigkeiten. Die Verwendung von Ebenen verkompliziert nicht nur diesen Vorgang, sondern führt auch zu längeren Kaltstartzeiten, da Ihre Funktionen während der Init-Phase zusätzliche Assemblys manuell in den Speicher laden müssen.

Um externe Abhängigkeiten mit Lambda-Funktionen in Go und Rust zu verwenden, nehmen Sie sie direkt in Ihr Bereitstellungspaket auf.