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.
Bereitstellen von Lambda-Go-Funktionen mit ZIP-Dateiarchiven
Der Code Ihrer AWS Lambda-Funktion besteht aus Skripts oder kompilierten Programmen und deren Abhängigkeiten. Sie verwenden ein Bereitstellungspaket, um Ihren Funktionscode in Lambda bereitzustellen. Lambda unterstützt zwei Arten von Bereitstellungspaketen: Container-Images und ZIP-Dateiarchiven.
Auf dieser Seite wird beschrieben, wie Sie eine ZIP-Datei als Bereitstellungspaket für die Go-Laufzeitumgebung erstellen und die ZIP-Datei dann verwenden, um Ihren Funktionscode auf AWS Lambda bereitzustellen, indem Sie AWS-Managementkonsole, AWS Command Line Interface (AWS CLI) und AWS Serverless Application Model (AWS SAM) verwenden.
Da Lambda POSIX-Dateiberechtigungen verwendet, müssen Sie möglicherweise Berechtigungen für den Bereitstellungspaketordner festlegen
Abschnitte
Erstellen einer ZIP-Datei unter macOS und Linux
Im Folgenden wird beschrieben, wie Sie Ihre ausführbare Datei mithilfe des Befehls go build kompilieren und ein Bereitstellungspaket in Form einer ZIP-Datei für Lambda erstellen. Vergewissern Sie sich vor dem Kompilieren des Codes, dass Sie das Paket lambda
go get github.com/aws/aws-lambda-go/lambda
Wenn Ihre Funktion das AWS SDK für Go verwendet, laden Sie den Standardsatz von SDK-Modulen zusammen mit allen für Ihre Anwendung erforderlichen AWS-Service-API-Clients herunter. Informationen zur Installation des SDK für Go finden Sie unter Erste Schritte mit AWS SDK für Go V2
Verwenden der bereitgestellten Laufzeitfamilie
Go wird anders implementiert als andere verwaltete Laufzeiten. Da Go nativ zu einer ausführbaren Binärdatei kompiliert wird, ist keine spezielle Sprachlaufzeit erforderlich. Verwenden Sie eine reine Betriebssystemlaufzeit (die provided-Laufzeit-Familie), um Go-Funktionen für Lambda bereitzustellen.
So erstellen Sie ein ZIP-Bereitstellungspaket (macOS/Linux)
-
Kompilieren Sie Ihre ausführbare Datei in dem Projektverzeichnis, das die Datei
main.goIhrer Anwendung enthält. Beachten Sie Folgendes:-
Die ausführbare Datei muss
bootstrapheißen. Weitere Informationen finden Sie unter Namenskonventionen für Handler. -
Legen Sie die Befehlssatzarchitektur des Ziels fest. Reine Betriebssystem-Laufzeiten unterstützen sowohl arm64 als auch x86_64.
-
Sie können das optionale Tag
lambda.norpcverwenden, um die RPC-Komponente (Remote Procedure Call, Remoteprozeduraufruf) der Bibliothek lambdaauszuschließen. Die RPC-Komponente ist nur erforderlich, wenn Sie die veraltete Go 1.x-Laufzeit verwenden. Durch Ausschließen der RPC-Komponente verringert sich die Größe des Bereitstellungspakets.
arm64-Architektur:
GOOS=linux GOARCH=arm64go build -tags lambda.norpc -o bootstrap main.gox86_64-Architektur:
GOOS=linux GOARCH=amd64go build -tags lambda.norpc -o bootstrap main.go -
-
(Optional) Möglicherweise müssen Sie Pakete mit Einstellung von
CGO_ENABLED=0in Linux kompilieren:GOOS=linux GOARCH=arm64CGO_ENABLED=0 go build -o bootstrap -tags lambda.norpc main.goDieser Befehl erstellt ein stabiles Binärpaket für Standard-C-Bibliotheksversionen (
libc), was auf Lambda und anderen Geräten unterschiedlich sein kann. -
Erstellen Sie ein Bereitstellungspaket, indem Sie die ausführbare Datei in eine ZIP-Datei packen.
zip myFunction.zip bootstrapAnmerkung
Fügen Sie die
bootstrap-Datei dem Stamm der ZIP-Datei hinzu. -
Erstellen der -Funktion Beachten Sie Folgendes:
-
Die Binärdatei muss
bootstrapbenannt werden, aber der Handlername kann beliebig sein. Weitere Informationen finden Sie unter Namenskonventionen für Handler. -
Die
--architectures-Option ist nur bei Verwendung von „arm64“ erforderlich. Der Standardwert ist „x86_64“. -
Geben Sie für
--roleden Amazon-Ressourcennamen (ARN) der Ausführungsrolle an.
aws lambda create-function --function-name myFunction \ --runtime provided.al2023 --handlerbootstrap\ --architecturesarm64\ --rolearn:aws:iam::111122223333:role/lambda-ex\ --zip-file fileb://myFunction.zip -
Erstellen einer ZIP-Datei unter Windows
Im Folgenden wird gezeigt, wie Sie das Tool build-lambda-zip
Anmerkung
Falls noch nicht geschehen, müssen Sie gitgit-Datei Ihrer Windows- %PATH%-Umgebungsvariable hinzufügen.
Stellen Sie vor dem Kompilieren des Codes sicher, dass Sie die Lambda-Bibliothek
go get github.com/aws/aws-lambda-go/lambda
Wenn Ihre Funktion das AWS SDK für Go verwendet, laden Sie den Standardsatz von SDK-Modulen zusammen mit allen für Ihre Anwendung erforderlichen AWS-Service-API-Clients herunter. Informationen zur Installation des SDK für Go finden Sie unter Erste Schritte mit AWS SDK für Go V2
Verwenden der bereitgestellten Laufzeitfamilie
Go wird anders implementiert als andere verwaltete Laufzeiten. Da Go nativ zu einer ausführbaren Binärdatei kompiliert wird, ist keine spezielle Sprachlaufzeit erforderlich. Verwenden Sie eine reine Betriebssystemlaufzeit (die provided-Laufzeit-Familie), um Go-Funktionen für Lambda bereitzustellen.
So erstellen Sie ein ZIP-Bereitstellungspaket (Windows)
-
Laden Sie das build-lambda-zip-Tool von GitHub herunter.
go install github.com/aws/aws-lambda-go/cmd/build-lambda-zip@latest -
Verwenden Sie das Tool aus Ihrer
GOPATH, um eine ZIP-Datei zu erstellen. Bei einer Go-Standardinstallation befindet sich das Tool in der Regel unter%USERPROFILE%\Go\bin. Navigieren Sie andernfalls an den Installationsort der Go-Laufzeit und führen Sie einen der folgenden Schritte aus: -
Erstellen der -Funktion Beachten Sie Folgendes:
-
Die Binärdatei muss
bootstrapbenannt werden, aber der Handlername kann beliebig sein. Weitere Informationen finden Sie unter Namenskonventionen für Handler. -
Die
--architectures-Option ist nur bei Verwendung von „arm64“ erforderlich. Der Standardwert ist „x86_64“. -
Geben Sie für
--roleden Amazon-Ressourcennamen (ARN) der Ausführungsrolle an.
aws lambda create-function --function-name myFunction \ --runtime provided.al2023 --handlerbootstrap\ --architecturesarm64\ --rolearn:aws:iam::111122223333:role/lambda-ex\ --zip-file fileb://myFunction.zip -
Go Lambda-Funktionen mithilfe von ZIP-Dateien erstellen und aktualisieren
Nach der Erstellung Ihres ZIP-Bereitstellungspakets können Sie es verwenden, um eine neue Lambda-Funktion zu erstellen oder eine vorhandene zu aktualisieren. Ihr ZIP-Bereitstellungspaket lässt sich über die Lambda-Konsole, das AWS Command Line Interface und die Lambda-API hochladen. Sie können Lambda-Funktionen auch mit AWS Serverless Application Model (AWS SAM) und CloudFormation erstellen und aktualisieren.
Die maximale Größe eines ZIP-Bereitstellungspakets für Lambda beträgt 250 MB (entpackt). Beachten Sie, dass dieser Grenzwert für die kombinierte Größe aller hochgeladenen Dateien gilt, einschließlich aller Lambda-Ebenen.
Die Lambda-Laufzeit benötigt die Berechtigung zum Lesen der Dateien in Ihrem Bereitstellungspaket. In der oktalen Linux-Notation der Berechtigungen benötigt Lambda 644 Berechtigungen für nicht ausführbare Dateien (rw-r--r--) und 755 Berechtigungen (rwxr-xr-x) für Verzeichnisse und ausführbare Dateien.
Verwenden Sie unter Linux und MacOS den chmod-Befehl, um Dateiberechtigungen für Dateien und Verzeichnisse in Ihrem Bereitstellungspaket zu ändern. Um beispielsweise einer nicht ausführbaren Datei die richtigen Berechtigungen zu geben, führen Sie den folgenden Befehl aus.
chmod 644 <filepath>
Informationen zum Ändern von Dateiberechtigungen in Windows finden Sie unter Festlegen, Anzeigen, Ändern oder Entfernen von Berechtigungen für ein Objekt
Anmerkung
Wenn Sie Lambda nicht die Berechtigungen gewähren, die es für den Zugriff auf Verzeichnisse in Ihrem Bereitstellungspaket benötigt, setzt Lambda die Berechtigungen für diese Verzeichnisse auf 755 (rwxr-xr-x).
Erstellen und Aktualisieren von Funktionen mit ZIP-Dateien unter Verwendung der Konsole
Eine neue Funktion müssen Sie zuerst in der Konsole erstellen und dann Ihr ZIP-Archiv hochladen. Zum Aktualisieren einer bestehenden Funktion öffnen Sie die Seite für Ihre Funktion und gehen dann genauso vor, um Ihre aktualisierte ZIP-Datei hinzuzufügen.
Bei einer ZIP-Datei mit unter 50 MB können Sie eine Funktion erstellen oder aktualisieren, indem Sie die Datei direkt von Ihrem lokalen Computer hochladen. Bei ZIP-Dateien mit einer Größe von mehr als 50 MB müssen Sie Ihr Paket zuerst in einen Amazon-S3-Bucket hochladen. Anweisungen zum Hochladen einer Datei in einen Amazon-S3-Bucket unter Verwendung der AWS-Managementkonsole finden Sie unter Erste Schritte mit Amazon S3. Informationen zum Hochladen von Dateien mit der AWS CLI finden Sie im AWS CLI-Benutzerhandbuch unter Verschieben von Objekten.
Anmerkung
Sie können eine vorhandene Container-Image-Funktion nicht konvertieren, um ein ZIP-Archiv zu verwenden. Sie müssen eine neue Funktion erstellen.
So erstellen Sie eine neue Funktion (Konsole)
-
Öffnen Sie die Funktionsseite
der Lambda-Konsole und wählen Sie Funktion erstellen aus. -
Wählen Sie Author from scratch aus.
-
Führen Sie unter Basic information (Grundlegende Informationen) die folgenden Schritte aus:
-
Geben Sie als Funktionsname den Namen Ihrer Funktion ein.
-
Wählen Sie unter Runtime (Laufzeit)
provided.al2023aus.
-
-
(Optional) Erweitern Sie unter Berechtigungen die Option Standardausführungsrolle ändern. Sie können eine neue Ausführungsrolle erstellen oder eine vorhandene Rolle verwenden.
-
Wählen Sie Funktion erstellen. Lambda erstellt eine grundlegende „Hello World“-Funktion mit der von Ihnen gewählten Laufzeit.
So laden Sie ein ZIP-Archiv von Ihrem lokalen Computer hoch (Konsole)
-
Wählen Sie auf der Funktionsseite
der Lambda-Konsole die Funktion aus, für die Sie die ZIP-Datei hochladen möchten. -
Wählen Sie die Registerkarte Code aus.
-
Wählen Sie im Bereich Codequelle die Option Hochladen von aus.
-
Wählen Sie die ZIP-Datei aus.
-
Laden Sie die ZIP-Datei wie folgt hoch:
-
Wählen Sie Hochladen und dann Ihre ZIP-Datei in der Dateiauswahl aus.
-
Klicken Sie auf Open.
-
Wählen Sie Speichern.
-
So laden Sie ein ZIP-Archiv aus einem Amazon-S3-Bucket hoch (Konsole)
-
Wählen Sie auf der Funktionsseite
der Lambda-Konsole die Funktion aus, für die Sie eine neue ZIP-Datei hochladen möchten. -
Wählen Sie die Registerkarte Code aus.
-
Wählen Sie im Bereich Codequelle die Option Hochladen von aus.
-
Wählen Sie den Amazon-S3-Speicherort aus.
-
Fügen Sie die Amazon-S3-Link-URL Ihrer ZIP-Datei ein und wählen Sie Speichern aus.
Erstellen und Aktualisieren von Funktionen mit ZIP-Dateien unter Verwendung der AWS CLI
Sie können die AWS CLI verwenden, um eine neue Funktion zu erstellen oder eine vorhandene unter Verwendung einer ZIP-Datei zu aktualisieren. Verwenden Sie die Befehle Funktion erstellen und Funktionscode aktualisieren, um Ihr ZIP-Paket bereitzustellen. Wenn Ihre ZIP-Datei kleiner als 50 MB ist, können Sie das ZIP-Paket von einem Dateispeicherort auf Ihrem lokalen Build-Computer hochladen. Bei größeren Dateien müssen Sie Ihr ZIP-Paket aus einem Amazon-S3-Bucket hochladen. Anweisungen zum Hochladen einer Datei in einen Amazon-S3-Bucket unter Verwendung der AWS CLI finden Sie unter Verschieben von Objekten im AWS CLI-Benutzerhandbuch.
Anmerkung
Wenn Sie Ihre ZIP-Datei unter Verwendung der AWS CLI aus einem Amazon-S3-Bucket hochladen, muss sich der Bucket in der gleichen AWS-Region wie Ihre Funktion befinden.
Um eine neue Funktion unter Verwendung einer ZIP-Datei mit der AWS CLI zu erstellen, müssen Sie Folgendes angeben:
-
Den Namen Ihrer Funktion (
--function-name) -
Die Laufzeit Ihrer Funktion (
--runtime) -
Den Amazon-Ressourcennamen (ARN) der Ausführungsrolle der Funktion (
--role). -
Den Namen der Handler-Methode in Ihrem Funktionscode (
--handler)
Sie müssen auch den Speicherort Ihrer ZIP-Datei angeben. Befindet sich Ihre ZIP-Datei in einem Ordner auf Ihrem lokalen Build-Computer, verwenden Sie die --zip-file-Option, um den Dateipfad anzugeben, wie im folgenden Beispielbefehl gezeigt.
aws lambda create-function --function-name myFunction \ --runtime provided.al2023 --handler bootstrap \ --role arn:aws:iam::111122223333:role/service-role/my-lambda-role \ --zip-file fileb://myFunction.zip
Zur Angabe des Speicherorts der ZIP-Datei in einem Amazon-S3-Bucket verwenden Sie die im folgenden Beispielbefehl gezeigte --code-Option. Sie müssen den S3ObjectVersion-Parameter nur für versionierte Objekte verwenden.
aws lambda create-function --function-name myFunction \ --runtime provided.al2023 --handler bootstrap \ --role arn:aws:iam::111122223333:role/service-role/my-lambda-role \ --code S3Bucket=amzn-s3-demo-bucket,S3Key=myFileName.zip,S3ObjectVersion=myObjectVersion
Um eine vorhandene Funktion mit der CLI zu aktualisieren, geben Sie den Namen Ihrer Funktion unter Verwendung des --function-name-Parameters an. Sie müssen auch den Speicherort der ZIP-Datei angeben, die Sie zum Aktualisieren Ihres Funktionscodes verwenden möchten. Befindet sich Ihre ZIP-Datei in einem Ordner auf Ihrem lokalen Build-Computer, verwenden Sie die --zip-file-Option, um den Dateipfad anzugeben, wie im folgenden Beispielbefehl gezeigt.
aws lambda update-function-code --function-name myFunction \ --zip-file fileb://myFunction.zip
Zur Angabe des Speicherorts der ZIP-Datei in einem Amazon-S3-Bucket verwenden Sie die im folgenden Beispielbefehl gezeigten --s3-bucket- und --s3-key-Optionen. Sie müssen den --s3-object-version-Parameter nur für versionierte Objekte verwenden.
aws lambda update-function-code --function-name myFunction \ --s3-bucket amzn-s3-demo-bucket --s3-key myFileName.zip --s3-object-version myObject Version
Erstellen und Aktualisieren von Funktionen mit ZIP-Dateien unter Verwendung der Lambda-API
Um Funktionen zu erstellen und zu konfigurieren, die ein ZIP-Dateiarchiv verwenden, verwenden Sie die folgenden API-Operationen:
Erstellen und Aktualisieren von Funktionen mit ZIP-Dateien unter Verwendung von AWS SAM
Das AWS Serverless Application Model (AWS SAM) ist ein Toolkit, das den Prozess der Erstellung und Ausführung von Serverless-Anwendungen auf AWS optimiert. Sie definieren die Ressourcen für Ihre Anwendung in einer YAML- oder JSON-Vorlage und verwenden die AWS SAM-Befehlszeilenschnittstelle (AWS SAM CLI), um Ihre Anwendungen zu erstellen, zu verpacken und bereitzustellen. Wenn Sie eine Lambda-Funktion aus einer AWS SAM-Vorlage erstellen, erstellt AWS SAM automatisch ein ZIP-Bereitstellungspaket oder ein Container-Image mit Ihrem Funktionscode und allen von Ihnen angegebenen Abhängigkeiten. Weitere Informationen zur Verwendung von AWS SAM für die Erstellung und Bereitstellung von Lambda-Funktionen finden Sie unter Erste Schritte mit AWS SAM im AWS Serverless Application Model-Entwicklerhandbuch.
Sie können außerdem AWS SAM verwenden, um eine Lambda-Funktion unter Verwendung eines vorhandenen ZIP-Dateiarchivs zu erstellen. Um eine Lambda-Funktion unter Verwendung von AWS SAM zu erstellen, können Sie Ihre ZIP-Datei in einem Amazon-S3-Bucket oder in einem lokalen Ordner auf Ihrem Build-Computer speichern. Anweisungen zum Hochladen einer Datei in einen Amazon-S3-Bucket unter Verwendung der AWS CLI finden Sie unter Verschieben von Objekten im AWS CLI-Benutzerhandbuch.
In Ihrer AWS SAM-Vorlage gibt die AWS::Serverless::Function-Ressource Ihre Lambda-Funktion an. Legen Sie in dieser Ressource die folgenden Eigenschaften fest, um eine Funktion zu erstellen, die als ZIP-Datei-Archiv definiert ist:
-
PackageType– festlegen aufZip -
CodeUri– festlegen auf die Amazon-S3-URI, den Pfad zum lokalen Ordner oder das Funktionscode-Objekt -
Runtime– festlegen auf die gewünschte Laufzeit
Mit AWS SAM müssen Sie Ihre ZIP-Datei nicht zuerst in einen Amazon-S3-Bucket hochladen, auch wenn sie größer als 50 MB ist. AWS SAM kann ZIP-Pakete bis zur maximal zulässigen Dateigröße von 250 MB (entpackt) von einem Speicherort auf Ihrem lokalen Build-Computer hochladen.
Weitere Informationen zur Bereitstellung von Funktionen mit einer ZIP-Datei in AWS SAM finden Sie unter AWS::Serverless::Function im AWS SAM-Entwicklerhandbuch.
Beispiel: Verwenden von AWS SAM zum Erstellen einer Go-Funktion mit „provided.al2023“
-
Erstellen Sie eine AWS SAM-Vorlage mit folgenden Eigenschaften:
-
BuildMethod: Gibt den Compiler für Ihre Anwendung an. Verwenden Sie
go1.x. -
Runtime: Verwenden Sie
provided.al2023. -
CodeUri: Geben Sie den Pfad zu Ihrem Code ein.
-
Architectures: Verwenden Sie
[arm64]für die arm64-Architektur. Verwenden Sie für die x86_64-Befehlssatzarchitektur die Option[amd64]oder entfernen Sie die EigenschaftArchitectures.
Beispiel template.yaml
AWSTemplateFormatVersion: '2010-09-09' Transform: 'AWS::Serverless-2016-10-31' Resources: HelloWorldFunction: Type: AWS::Serverless::Function Metadata: BuildMethod:go1.xProperties: CodeUri:hello-world/# folder where your main program resides Handler: bootstrap Runtime:provided.al2023Architectures:[arm64] -
-
Verwenden Sie den Befehl sam build, um die ausführbare Datei zu kompilieren.
sam build -
Verwenden Sie den Befehl sam deploy, um die Funktion in Lambda bereitzustellen.
sam deploy --guided
Erstellen und Aktualisieren von Funktionen mit ZIP-Dateien unter Verwendung von CloudFormation
Sie können CloudFormation verwenden, um eine Lambda-Funktion unter Verwendung eines ZIP-Dateiarchivs zu erstellen. Um eine Lambda-Funktion aus einer ZIP-Datei zu erstellen, müssen Sie Ihre Datei zunächst in einen Amazon-S3-Bucket hochladen. Anweisungen zum Hochladen einer Datei in einen Amazon-S3-Bucket unter Verwendung der AWS CLI finden Sie unter Verschieben von Objekten im AWS CLI-Benutzerhandbuch.
In Ihrer CloudFormation-Vorlage gibt die AWS::Lambda::Function-Ressource Ihre Lambda-Funktion an. Legen Sie in dieser Ressource die folgenden Eigenschaften fest, um eine Funktion zu erstellen, die als ZIP-Datei-Archiv definiert ist:
-
PackageType– festlegen aufZip -
Code– Geben Sie den Namen des Amazon-S3-Buckets und den ZIP-Dateinamen in die FelderS3BucketundS3Keyein -
Runtime– festlegen auf die gewünschte Laufzeit
Die von CloudFormation generierte ZIP-Datei darf nicht größer als 4 MB sein. Weitere Informationen zur Bereitstellung von Funktionen mit einer ZIP-Datei in CloudFormation finden Sie unter AWS::Lambda::Function im CloudFormation-Entwicklerhandbuch.