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.
Tutorial: Verwenden eines Amazon-S3-Auslösers zum Erstellen von Miniaturbildern
In diesem Tutorial wird eine Lambda-Funktion erstellt und konfiguriert, die die Größe von Bildern anpasst, die einem Amazon Simple Storage Service (Amazon S3)-Bucket hinzugefügt werden. Wenn Sie Ihrem Bucket eine Bilddatei hinzufügen, ruft Amazon S3 Ihre Lambda-Funktion auf. Die Funktion erstellt daraufhin eine Miniaturversion des Bilds und gibt sie an einen anderen Amazon-S3-Bucket aus.
Führen Sie für dieses Tutorial die folgenden Schritte aus:
-
Erstellen Sie Quell- und Ziel-Buckets für Amazon S3 und laden Sie ein Beispielbild hoch.
-
Erstellen Sie eine Lambda-Funktion, die die Größe eines Bildes anpasst und eine Miniaturansicht an einen Amazon-S3-Bucket ausgibt.
-
Konfigurieren Sie einen Lambda-Auslöser, der Ihre Funktion aufruft, wenn Objekte in Ihren Quell-Bucket hochgeladen werden.
-
Testen Sie Ihre Funktion zunächst mit einem Dummy-Ereignis und anschließend durch Hochladen eines Bilds in Ihren Quell-Bucket.
Diese Schritte zeigen, wie Sie Lambda verwenden, um eine Dateiverarbeitungsaufgabe für Objekte auszuführen, die einem Amazon-S3-Bucket hinzugefügt werden. Sie können dieses Tutorial abschließen, indem Sie die AWS Command Line Interface oder die AWS CLI (AWS Management Console) verwenden.
Ein einfacheres Beispiel, das zeigt, wie Sie einen Amazon-S3-Auslöser für Lambda konfigurieren, finden Sie unter Tutorial: Verwenden eines Amazon-S3-Auslösers zum Aufrufen einer Lambda-Funktion.
Voraussetzungen
Wenn Sie kein AWS-Konto haben, führen Sie die folgenden Schritte zum Erstellen durch.
AWS sendet Ihnen eine Bestätigungs-E-Mail, sobald die Anmeldung abgeschlossen ist. Sie können jederzeit Ihre aktuelle Kontoaktivität anzeigen und Ihr Konto verwalten. Rufen Sie dazu https://aws.amazon.com/ auf und klicken Sie auf Mein Konto.
Nachdem Sie sich für ein AWS-Kontoangemeldet haben, sichern Sie Ihr Root-Benutzer des AWS-Kontos, aktivieren Sie AWS IAM Identity Centerund erstellen Sie einen administrativen Benutzer, damit Sie nicht den Root-Benutzer für alltägliche Aufgaben verwenden.
Anmelden als Administratorbenutzer
-
Um sich mit Ihrem IAM-Identity-Center-Benutzer anzumelden, verwenden Sie die Anmelde-URL, die an Ihre E-Mail-Adresse gesendet wurde, als Sie den IAM-Identity-Center-Benutzer erstellt haben.
Hilfe bei der Anmeldung mit einem IAM-Identity-Center-Benutzer finden Sie unter Anmelden beim AWS-Zugangsportal im AWS-Anmeldung Benutzerhandbuch zu.
Wenn Sie für das Tutorial die AWS CLI verwenden möchten, installieren Sie die neueste Version der AWS Command Line Interface.
Für Ihren Lambda-Funktionscode können Sie Python, Node.js oder Java verwenden. Installieren Sie die Tools zur Sprachunterstützung und einen Paketmanager für die gewünschte Sprache.
Erstellen von zwei Amazon-S3-Buckets
Erstellen Sie zunächst zwei Amazon-S3-Buckets. Der erste Bucket ist der Quell-Bucket, in den Sie Ihre Bilder hochladen. Der zweite Bucket wird von Lambda verwendet, um das verkleinerte Miniaturbild zu speichern, wenn Sie Ihre Funktion aufrufen.
- AWS Management Console
-
So erstellen Sie die Amazon-S3-Buckets (Konsole)
-
Öffnen Sie die Seite Buckets der Amazon-S3-Konsole.
-
Wählen Sie Bucket erstellen aus.
-
Führen Sie unter Allgemeine Konfiguration die folgenden Schritte aus:
-
Geben Sie für den Bucket-Namen einen global eindeutigen Namen ein, der den Regeln für die Bucket-Benennung von Amazon S3 entspricht. Bucket-Namen dürfen nur aus Kleinbuchstaben, Zahlen, Punkten (.) und Bindestrichen (-) bestehen.
-
Wählen Sie unter AWS-Region die AWS-Region aus, die Ihrem geografischen Standort am nächsten ist. Notieren Sie sich die gewählte Region, da Sie Ihre Lambda-Funktion im weiteren Verlauf des Tutorials in der gleichen AWS-Region erstellen müssen.
-
Belassen Sie alle anderen Optionen auf ihren Standardwerten und wählen Sie Bucket erstellen aus.
-
Wiederholen Sie die Schritte 1 bis 4, um Ihren Ziel-Bucket zu erstellen. Geben Sie unter Bucket-Name den Namen SOURCEBUCKET-resizedSOURCEBUCKET
- AWS CLI
-
So erstellen Sie die Amazon-S3-Buckets (AWS CLI)
-
Führen Sie den folgenden CLI-Befehl aus, um Ihren Quell-Bucket zu erstellen. Der gewählte Name für Ihren Bucket muss global eindeutig sein und den Regeln für die Benennung von Buckets für Amazon S3 entsprechen. Namen dürfen nur Kleinbuchstaben, Zahlen, Punkte (.) und Bindestriche (-) enthalten. Wählen Sie für region und LocationConstraint die AWS-Region aus, die Ihrem geografischen Standort am nächsten ist.
aws s3api create-bucket --bucket SOURCEBUCKET --region us-west-2 \
--create-bucket-configuration LocationConstraint=us-west-2
Notieren Sie sich die gewählte Region, da Sie Ihre Lambda-Funktion im weiteren Verlauf des Tutorials in der gleichen AWS-Region erstellen müssen wie Ihren Quell-Bucket.
-
Führen Sie den folgenden Befehl aus, um Ihren Ziel-Bucket zu erstellen. Verwenden Sie für den Bucket-Namen SOURCEBUCKET-resizedSOURCEBUCKETregion und LocationConstraint die gleiche AWS-Region aus, die Sie auch bei der Erstellung Ihres Quell-Bucket verwendet haben.
aws s3api create-bucket --bucket SOURCEBUCKET-resized --region us-west-2 \
--create-bucket-configuration LocationConstraint=us-west-2
Hochladen eines Testbilds in Ihren Quell-Bucket
Später in diesem Tutorial testen Sie Ihre Lambda-Funktion, indem Sie sie über die AWS CLI oder über die Lambda-Konsole aufrufen. Damit Sie sich vergewissern können, dass Ihre Funktion ordnungsgemäß funktioniert, muss Ihr Quell-Bucket ein Testbild enthalten. Bei diesem Bild kann es sich um eine beliebige JPG- oder PNG-Datei handeln.
- AWS Management Console
-
So laden Sie ein Testbild in Ihren Quell-Bucket hoch (Konsole)
-
Öffnen Sie die Seite Buckets der Amazon-S3-Konsole.
-
Wählen Sie den Quell-Bucket aus, den Sie im vorherigen Schritt erstellt haben.
-
Klicken Sie auf Hochladen.
-
Wählen Sie Dateien hinzufügen aus und wählen Sie mit der Dateiauswahl das Objekt aus, das Sie hochladen möchten.
-
Wählen Sie Öffnen und anschließend Hochladen aus.
- AWS CLI
-
So laden Sie ein Testbild in Ihren Quell-Bucket hoch (AWS CLI)
-
Führen Sie in dem Verzeichnis, das das hochzuladende Bild enthält, den folgenden CLI-Befehl aus. Ersetzen Sie dabei den Parameter --bucket durch den Namen Ihres Quell-Buckets. Verwenden Sie für die Parameter --key und --body den Dateinamen Ihres Testbilds.
aws s3api put-object --bucket SOURCEBUCKET --key HappyFace.jpg --body ./HappyFace.jpg
Erstellen einer Berechtigungsrichtlinie
Im ersten Schritt der Erstellung Ihrer Lambda-Funktion wird eine Berechtigungsrichtlinie erstellt. Diese Richtlinie erteilt Ihrer Funktion die Berechtigungen, die sie für den Zugriff auf andere AWS-Ressourcen benötigt. Für dieses Tutorial erteilt die Richtlinie Lambda Lese- und Schreibberechtigungen für Amazon S3-Buckets und ermöglicht es ihm, in Amazon CloudWatch Logs zu schreiben.
- AWS Management Console
-
So erstellen Sie die Richtlinie (Konsole)
-
Öffnen Sie die Seite Richtlinien in der AWS Identity and Access Management-(IAM)-Konsole.
-
Wählen Sie Richtlinie erstellen aus.
-
Wählen Sie die Registerkarte JSON aus und kopieren Sie dann die folgende benutzerdefinierte JSON-Richtlinie in den JSON-Editor.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:PutLogEvents",
"logs:CreateLogGroup",
"logs:CreateLogStream"
],
"Resource": "arn:aws:logs:*:*:*"
},
{
"Effect": "Allow",
"Action": [
"s3:GetObject"
],
"Resource": "arn:aws:s3:::*/*"
},
{
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": "arn:aws:s3:::*/*"
}
]
}
-
Wählen Sie Weiter aus.
-
Geben Sie unter Richtliniendetails für den Richtliniennamen LambdaS3Policy
-
Wählen Sie Richtlinie erstellen aus.
- AWS CLI
-
So erstellen Sie die Richtlinie (AWS CLI)
-
Speichern Sie den folgenden JSON-Code in einer Datei mit dem Namen policy.json:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:PutLogEvents",
"logs:CreateLogGroup",
"logs:CreateLogStream"
],
"Resource": "arn:aws:logs:*:*:*"
},
{
"Effect": "Allow",
"Action": [
"s3:GetObject"
],
"Resource": "arn:aws:s3:::*/*"
},
{
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": "arn:aws:s3:::*/*"
}
]
}
-
Führen Sie in dem Verzeichnis, in dem Sie das JSON-Richtliniendokument gespeichert haben, den folgenden CLI-Befehl aus:
aws iam create-policy --policy-name LambdaS3Policy --policy-document file://policy.json
Erstellen einer Ausführungsrolle
Eine Ausführungsrolle ist eine IAM-Rolle, die einer Lambda-Funktion Zugriffsberechtigungen für AWS-Services und für Ressourcen erteilt. Um Ihrer Funktion Lese- und Schreibzugriff auf einen Amazon-S3-Bucket zu erteilen, fügen Sie die Berechtigungsrichtlinie an, die Sie im vorherigen Schritt erstellt haben.
- AWS Management Console
-
So erstellen Sie eine Ausführungsrolle und fügen Ihre Berechtigungsrichtlinie hinzu (Konsole)
-
Öffnen Sie die Seite Rollen der (IAM-)Konsole.
-
Wählen Sie Rolle erstellen aus.
-
Wählen Sie unter Vertrauenswürdiger Entitätstyp die Option AWS-Service und unter Anwendungsfall die Option Lambda aus.
-
Wählen Sie Weiter aus.
-
Fügen Sie die Berechtigungsrichtlinie hinzu, die Sie im vorherigen Schritt erstellt haben:
-
Geben Sie im Feld für die Richtliniensuche LambdaS3Policy
-
Aktivieren Sie in den Suchergebnissen das Kontrollkästchen für LambdaS3Policy.
-
Wählen Sie Weiter aus.
-
Geben Sie unter Rollendetails im Feld Rollenname den Namen LambdaS3Role
-
Wählen Sie Rolle erstellen aus.
- AWS CLI
-
So erstellen Sie eine Ausführungsrolle und fügen Ihre Berechtigungsrichtlinie an (AWS CLI)
-
Speichern Sie den folgenden JSON-Code in einer Datei mit dem Namen trust-policy.json: Diese Vertrauensrichtlinie ermöglicht es Lambda, die Berechtigungen der Rolle zu verwenden, indem es dem Service-Prinzipal lambda.amazonaws.com die Erlaubnis erteilt, die Aktion AWS Security Token Service (AWS STS) AssumeRole aufzurufen.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "lambda.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
-
Führen Sie in dem Verzeichnis, in dem Sie das JSON-Vertrauensrichtliniendokument gespeichert haben, den folgenden CLI-Befehl aus, um die Ausführungsrolle zu erstellen:
aws iam create-role --role-name LambdaS3Role --assume-role-policy-document file://trust-policy.json
-
Führen Sie den folgenden CLI-Befehl aus, um die im vorherigen Schritt erstellte Berechtigungsrolle anzufügen. Ersetzen Sie dabei die Nummer AWS-Konto im ARN der Richtlinie durch Ihre eigene Kontonummer.
aws iam attach-role-policy --role-name LambdaS3Role --policy-arn arn:aws:iam::123456789012:policy/LambdaS3Policy
Erstellen des Bereitstellungspakets für die Funktion
Um Ihre Funktion zu erstellen, erstellen Sie ein Bereitstellungspaket, das Ihren Funktionscode und die zugehörigen Abhängigkeiten enthält. Bei der hier verwendeten Funktion CreateThumbnail verwendet Ihr Funktionscode eine separate Bibliothek für die Anpassung der Bildgröße. Folgen Sie den Anweisungen für die von Ihnen gewählte Sprache, um ein Bereitstellungspaket zu erstellen, das die erforderliche Bibliothek enthält.
- Node.js
-
So erstellen Sie das Bereitstellungspaket (Node.js)
-
Erstellen Sie ein Verzeichnis namens lambda-s3 für Ihren Funktionscode und die Abhängigkeiten und navigieren Sie dorthin.
mkdir lambda-s3
cd lambda-s3
-
Speichern Sie den folgenden Funktionscode in einer lokalen Datei namens index.mjs: Stellen Sie sicher, dass Sie durch 'us-west-2' die ersetzen, AWS-Region in der Sie Ihre eigenen Quell- und Ziel-Buckets erstellt haben.
// dependencies
import { S3Client, GetObjectCommand, PutObjectCommand } from '@aws-sdk/client-s3';
import { Readable } from 'stream';
import sharp from 'sharp';
import util from 'util';
// create S3 client
const s3 = new S3Client({region: 'us-west-2'});
// define the handler function
export const handler = async (event, context) => {
// Read options from the event parameter and get the source bucket
console.log("Reading options from event:\n", util.inspect(event, {depth: 5}));
const srcBucket = event.Records[0].s3.bucket.name;
// Object key may have spaces or unicode non-ASCII characters
const srcKey = decodeURIComponent(event.Records[0].s3.object.key.replace(/\+/g, " "));
const dstBucket = srcBucket + "-resized";
const dstKey = "resized-" + srcKey;
// Infer the image type from the file suffix
const typeMatch = srcKey.match(/\.([^.]*)$/);
if (!typeMatch) {
console.log("Could not determine the image type.");
return;
}
// Check that the image type is supported
const imageType = typeMatch[1].toLowerCase();
if (imageType != "jpg" && imageType != "png") {
console.log(`Unsupported image type: ${imageType}`);
return;
}
// Get the image from the source bucket. GetObjectCommand returns a stream.
try {
const params = {
Bucket: srcBucket,
Key: srcKey
};
var response = await s3.send(new GetObjectCommand(params));
var stream = response.Body;
// Convert stream to buffer to pass to sharp resize function.
if (stream instanceof Readable) {
var content_buffer = Buffer.concat(await stream.toArray());
} else {
throw new Error('Unknown object stream type');
}
} catch (error) {
console.log(error);
return;
}
// set thumbnail width. Resize will set the height automatically to maintain aspect ratio.
const width = 200;
// Use the sharp module to resize the image and save in a buffer.
try {
var output_buffer = await sharp(content_buffer).resize(width).toBuffer();
} catch (error) {
console.log(error);
return;
}
// Upload the thumbnail image to the destination bucket
try {
const destparams = {
Bucket: dstBucket,
Key: dstKey,
Body: output_buffer,
ContentType: "image"
};
const putResult = await s3.send(new PutObjectCommand(destparams));
} catch (error) {
console.log(error);
return;
}
console.log('Successfully resized ' + srcBucket + '/' + srcKey +
' and uploaded to ' + dstBucket + '/' + dstKey);
};
-
Installieren Sie die Sharp-Bibliothek mithilfe von npm im Verzeichnis lambda-s3. Beachten Sie, dass die neueste Version von Sharp (0.33) nicht mit Lambda kompatibel ist. Installieren Sie für dieses Tutorial daher Version 0.32.6.
npm install sharp@0.32.6
Der npm-Befehl install erstellt ein Verzeichnis namens node_modules für Ihre Module. Nach diesem Schritt sollte Ihre Verzeichnisstruktur wie folgt aussehen:
lambda-s3
|- index.mjs
|- node_modules
| |- base64js
| |- bl
| |- buffer
...
|- package-lock.json
|- package.json
-
Erstellen Sie ein ZIP-Bereitstellungspaket, das Ihren Funktionscode und die zugehörigen Abhängigkeiten enthält. Führen Sie unter macOS oder Linux den folgenden Befehl aus:
zip -r function.zip .
Verwenden Sie unter Windows Ihr bevorzugtes ZIP-Programm, um eine ZIP-Datei zu erstellen. Achten Sie darauf, dass sich die Dateien index.mjs, package.json und package-lock.json und das Verzeichnis node_modules im Stammverzeichnis der ZIP-Datei befinden.
- Python
-
So erstellen Sie das Bereitstellungspaket (Python)
-
Speichern Sie den Beispielcode als Datei mit dem Namen lambda_function.py.
import boto3
import os
import sys
import uuid
from urllib.parse import unquote_plus
from PIL import Image
import PIL.Image
s3_client = boto3.client('s3')
def resize_image(image_path, resized_path):
with Image.open(image_path) as image:
image.thumbnail(tuple(x / 2 for x in image.size))
image.save(resized_path)
def lambda_handler(event, context):
for record in event['Records']:
bucket = record['s3']['bucket']['name']
key = unquote_plus(record['s3']['object']['key'])
tmpkey = key.replace('/', '')
download_path = '/tmp/{}{}'.format(uuid.uuid4(), tmpkey)
upload_path = '/tmp/resized-{}'.format(tmpkey)
s3_client.download_file(bucket, key, download_path)
resize_image(download_path, upload_path)
s3_client.upload_file(upload_path, '{}-resized'.format(bucket), 'resized-{}'.format(key))
-
Erstellen Sie in dem Verzeichnis, in dem Sie auch Ihre lambda_function.py-Datei erstellt haben, ein neues Verzeichnis mit dem Namen package und installieren Sie die Bibliothek Pillow (PIL) sowie das AWS SDK for Python (Boto3). Die Lambda-Python-Laufzeit enthält zwar eine Version des Boto3 SDK, es empfiehlt sich jedoch, dem Bereitstellungspaket alle Abhängigkeiten Ihrer Funktion hinzuzufügen, auch wenn sie in der Laufzeit enthalten sind. Weitere Informationen finden Sie in der Laufzeitabhängigkeiten in Python.
mkdir package
pip install \
--platform manylinux2014_x86_64 \
--target=package \
--implementation cp \
--python-version 3.9 \
--only-binary=:all: --upgrade \
pillow boto3
Die Pillow-Bibliothek enthält Code in C/C++. Mithilfe der Optionen --platform manylinux_2014_x86_64 und --only-binary=:all: lädt pip eine Version von Pillow herunter und installiert sie, die vorkompilierte Binärdateien enthält, die mit dem Betriebssystem Amazon Linux 2 kompatibel sind. Dadurch wird sichergestellt, dass Ihr Bereitstellungspaket in der Lambda-Ausführungsumgebung funktioniert, unabhängig vom Betriebssystem und der Architektur Ihrer lokalen Build-Maschine.
-
Erstellen Sie eine ZIP-Datei, die Ihren Anwendungscode sowie die Pillow- und die Boto3-Bibliothek enthält. Führen Sie unter Linux oder MacOS die folgenden Befehle über Ihre Befehlszeilenschnittstelle aus:
cd package
zip -r ../lambda_function.zip .
cd ..
zip lambda_function.zip lambda_function.py
Verwenden Sie unter Windows Ihr bevorzugtes ZIP-Tool, um die lambda_function.zip-Datei zu erstellen. Achten Sie darauf, dass sich die Datei lambda_function.py und die Ordner, die Ihre Abhängigkeiten enthalten, im Stammverzeichnis der ZIP-Datei befinden.
Sie können Ihr Bereitstellungspaket auch in einer virtuellen Python-Umgebung erstellen. Siehe Arbeiten mit ZIP-Dateiarchiven und Python-Lambda-Funktionen
So erstellen Sie die Lambda-Funktion:
Sie können Ihre Lambda-Funktion entweder mithilfe der AWS CLI oder über die Lambda-Konsole erstellen. Folgen Sie den Anweisungen für die von Ihnen gewählte Sprache, um die Funktion zu erstellen.
- AWS Management Console
-
So erstellen Sie die Funktion (Konsole)
Wenn Sie Ihre Lambda-Funktion über die Konsole erstellen möchten, erstellen Sie zunächst eine Basisfunktion, die etwas Hello-World-Code enthält. Anschließend ersetzen Sie diesen Code durch Ihren eigenen Funktionscode, indem Sie die im vorherigen Schritt erstellte ZIP- oder JAR-Datei hochladen.
-
Öffnen Sie die Seite Funktionen der Lambda-Konsole.
-
Stellen Sie sicher, dass Sie in derselben AWS-Region arbeiten, in der Sie Ihren Amazon-S3-Bucket erstellt haben. Sie können Ihre Region mithilfe der Dropdown-Liste am oberen Bildschirmrand ändern.
-
Wählen Sie Funktion erstellen.
-
Wählen Sie Author from scratch aus.
-
Führen Sie unter Basic information (Grundlegende Informationen) die folgenden Schritte aus:
-
Geben Sie für Function name (Funktionsname) CreateThumbnail
-
Wählen Sie unter Laufzeit entweder Node.js 18.x oder Python 3.9 aus (je nachdem, welche Sprache Sie für Ihre Funktion gewählt haben).
-
Wählen Sie für Architektur x86_64 aus.
-
Gehen Sie auf der Registerkarte Standard-Ausführungsrolle ändern wie folgt vor:
-
Erweitern Sie die Registerkarte und wählen Sie dann Verwenden einer vorhandenen Rolle aus.
-
Wählen Sie die zuvor erstellte LambdaS3Role aus.
-
Wählen Sie Funktion erstellen.
So laden Sie den Funktionscode hoch (Konsole)
-
Wählen Sie im Bereich Codequelle die Option Hochladen von aus.
-
Wählen Sie die ZIP-Datei aus.
-
Klicken Sie auf Hochladen.
-
Wählen Sie in der Dateiauswahl Ihre ZIP-Datei und anschließend Öffnen aus.
-
Wählen Sie Speichern.
- AWS CLI
-
So erstellen Sie die Funktion (AWS CLI)
Damit Ihre Lambda-Funktion ausgeführt wird, wenn Sie ein Bild in Ihren Quell-Bucket hochladen, müssen Sie einen Auslöser für Ihre Funktion konfigurieren. Sie können den Amazon-S3-Auslöser entweder über die Konsole oder mithilfe der AWS CLI konfigurieren.
Mit diesem Verfahren wird der Amazon-S3-Bucket so konfiguriert, dass die Funktion jedes Mal aufgerufen wird, wenn ein Objekt im Bucket erstellt wird. Konfigurieren Sie dieses Verhalten nur für den Quell-Bucket. Wenn Ihre Lambda-Funktion Objekte in dem Bucket erstellt, der sie aufruft, kann es passieren, dass Ihre Funktion kontinuierlich in einer Schleife aufgerufen wird. Dies kann unerwartete Gebühren für Ihr AWS-Konto zur Folge haben.
- AWS Management Console
-
So konfigurieren Sie den Amazon-S3-Auslöser (Konsole)
-
Öffnen Sie die Seite Funktionen der Lambda-Konsole und wählen Sie Ihre Funktion (CreateThumbnail) aus.
-
Wählen Sie Add trigger.
-
Wählen Sie S3 aus.
-
Wählen Sie unter Bucket Ihren Quell-Bucket aus.
-
Wählen Sie unter Ereignistypen die Option Alle Objekterstellungsereignisse aus.
-
Aktivieren Sie unter Rekursiver Aufruf das Kontrollkästchen, um zu bestätigen, dass die Verwendung desselben Amazon-S3-Buckets für die Ein- und Ausgabe nicht empfohlen wird. Weitere Informationen zu rekursiven Aufrufmustern in Lambda finden Sie bei Serverless Land unter Recursive patterns that cause run-away Lambda functions.
-
Wählen Sie Hinzufügen aus.
Wenn Sie einen Auslöser über die Lambda-Konsole erstellen, erstellt Lambda automatisch eine ressourcenbasierte Richtlinie, um dem von Ihnen ausgewählten Dienst die Berechtigung zum Aufrufen Ihrer Funktion zu erteilen.
- AWS CLI
-
So konfigurieren Sie den Amazon-S3-Auslöser (AWS CLI)
-
Damit Ihr Amazon-S3-Quell-Bucket Ihre Funktion aufruft, wenn Sie eine Bilddatei hinzufügen, müssen Sie zunächst mithilfe einer ressourcenbasierten Richtlinie Berechtigungen für Ihre Funktion konfigurieren. Eine ressourcenbasierte Richtlinienanweisung erteilt anderen AWS-Services die Berechtigung zum Aufrufen Ihrer Funktion. Führen Sie den folgenden CLI-Befehl aus, um Amazon S3 die Berechtigung zum Aufrufen Ihrer Funktion zu erteilen. Ersetzen Sie dabei den Parameter source-account durch Ihre eigene AWS-Konto-ID und verwenden Sie Ihren eigenen Quell-Bucket-Namen.
aws lambda add-permission --function-name CreateThumbnail \
--principal s3.amazonaws.com --statement-id s3invoke --action "lambda:InvokeFunction" \
--source-arn arn:aws:s3:::SOURCEBUCKET \
--source-account 123456789012
Die mit diesem Befehl definierte Richtlinie ermöglicht es Amazon S3 nur, Ihre Funktion aufzurufen, wenn eine Aktion in Ihrem Quell-Bucket ausgeführt wird.
Namen von Amazon-S3-Buckets sind zwar global eindeutig, trotzdem empfiehlt es sich, bei der Verwendung ressourcenbasierter Richtlinien anzugeben, dass der Bucket zu Ihrem Konto gehören muss. Der Grund: Wenn Sie einen Bucket löschen, kann ein anderes AWS-Konto einen Bucket mit dem gleichen Amazon-Ressourcennamen (ARN) erstellen.
-
Speichern Sie den folgenden JSON-Code in einer Datei mit dem Namen notification.json: Wenn dieser JSON-Code auf Ihren Quell-Bucket angewendet wird, wird der Bucket so konfiguriert, dass er jedes Mal, wenn ein neues Objekt hinzugefügt wird, eine Benachrichtigung an Ihre Lambda-Funktion sendet. Ersetzen Sie die AWS-Konto-Nummer und die AWS-Region im ARN der Lambda-Funktion durch Ihre eigene Kontonummer und Region.
{
"LambdaFunctionConfigurations": [
{
"Id": "CreateThumbnailEventConfiguration",
"LambdaFunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:CreateThumbnail",
"Events": [ "s3:ObjectCreated:Put" ]
}
]
}
-
Führen Sie den folgenden CLI-Befehl aus, um die Benachrichtigungseinstellungen in der von Ihnen erstellten JSON-Datei auf Ihren Quell-Bucket anzuwenden. Ersetzen Sie dabei SOURCEBUCKET durch den Namen Ihres Quell-Buckets.
aws s3api put-bucket-notification-configuration --bucket SOURCEBUCKET \
--notification-configuration file://notification.json
Weitere Informationen über den put-bucket-notification-configuration Befehl und die notification-configuration Option finden Sie unter put-bucket-notification-configuration in der AWS CLI-Befehlsreferenz .
Testen Ihrer Lambda-Funktion mit einem Dummy-Ereignis
Bevor Sie Ihr gesamtes Setup testen, indem Sie Ihrem Amazon-S3-Quell-Bucket eine Bilddatei hinzufügen, testen Sie, ob Ihre Lambda-Funktion ordnungsgemäß funktioniert, indem Sie sie mit einem Dummy-Ereignis aufrufen. In Lambda ist ein Ereignis ein Dokument im JSON-Format, das Daten enthält, die von Ihrer Lambda-Funktion verarbeitet werden sollen. Wenn Ihre Funktion von Amazon S3 aufgerufen wird, enthält das an Ihre Funktion gesendete Ereignis Informationen wie den Bucket-Namen, den Bucket-ARN und den Objektschlüssel.
- AWS Management Console
-
So testen Sie Ihre Lambda-Funktion mit einem Dummy-Ereignis (Konsole)
-
Öffnen Sie die Seite Funktionen der Lambda-Konsole und wählen Sie Ihre Funktion (CreateThumbnail) aus.
-
Wählen Sie die Registerkarte Test.
-
Gehen Sie im Bereich Testereignis wie folgt vor, um Ihr Testereignis zu erstellen:
-
Wählen Sie unter Testereignisaktion die Option Neues Ereignis erstellen aus.
-
Geben Sie für Event name (Ereignisname) myTestEvent ein.
-
Wählen Sie unter Vorlage die Option S3 Put aus.
-
Ersetzen Sie die Werte für die folgenden Parameter durch Ihre eigenen Werte:
-
Ersetzen Sie für awsRegion den Wert us-east-1 durch die AWS-Region, in der Sie den Amazon-S3-Bucket erstellt haben.
-
Ersetzen Sie für name den Wert example-bucket durch den Namen Ihres eigenen Amazon-S3-Quell-Buckets.
-
Ersetzen Sie für key den Wert test%2Fkey durch den Dateinamen des Testobjekts, das Sie im Schritt Hochladen eines Testbilds in Ihren Quell-Bucket in Ihren Quell-Bucket hochgeladen haben.
{
"Records": [
{
"eventVersion": "2.0",
"eventSource": "aws:s3",
"awsRegion": "us-east-1",
"eventTime": "1970-01-01T00:00:00.000Z",
"eventName": "ObjectCreated:Put",
"userIdentity": {
"principalId": "EXAMPLE"
},
"requestParameters": {
"sourceIPAddress": "127.0.0.1"
},
"responseElements": {
"x-amz-request-id": "EXAMPLE123456789",
"x-amz-id-2": "EXAMPLE123/5678abcdefghijklambdaisawesome/mnopqrstuvwxyzABCDEFGH"
},
"s3": {
"s3SchemaVersion": "1.0",
"configurationId": "testConfigRule",
"bucket": {
"name": "example-bucket",
"ownerIdentity": {
"principalId": "EXAMPLE"
},
"arn": "arn:aws:s3:::example-bucket"
},
"object": {
"key": "test%2Fkey",
"size": 1024,
"eTag": "0123456789abcdef0123456789abcdef",
"sequencer": "0A1B2C3D4E5F678901"
}
}
}
]
}
-
Wählen Sie Speichern.
-
Wählen Sie im Bereich Testereignis die Option Testen aus.
-
Gehen Sie wie folgt vor, um zu überprüfen, ob Ihre Funktion eine verkleinerte Version Ihres Bilds erstellt und in Ihrem Amazon-S3-Ziel-Bucket gespeichert hat:
-
Öffnen Sie die Seite Buckets der Amazon-S3-Konsole.
-
Wählen Sie Ihren Ziel-Bucket aus und vergewissern Sie sich, dass die Datei, deren Größe angepasst wurde, im Bereich Objekte vorhanden ist.
- AWS CLI
-
So testen Sie Ihre Lambda-Funktion mit einem Dummy-Ereignis (AWS CLI)
-
Speichern Sie den folgenden JSON-Code in einer Datei mit dem Namen dummyS3Event.json: Ersetzen Sie die Werte für die folgenden Parameter durch Ihre eigenen Werte:
-
Ersetzen Sie für awsRegion den Wert us-west-2 durch die AWS-Region, in der Sie den Amazon-S3-Bucket erstellt haben.
-
Ersetzen Sie für name den Wert SOURCEBUCKET durch den Namen Ihres eigenen Amazon-S3-Quell-Buckets.
-
Ersetzen Sie für key den Wert HappyFace.jpg durch den Dateinamen des Testobjekts, das Sie im Schritt Hochladen eines Testbilds in Ihren Quell-Bucket in Ihren Quell-Bucket hochgeladen haben.
{
"Records":[
{
"eventVersion":"2.0",
"eventSource":"aws:s3",
"awsRegion":"us-west-2",
"eventTime":"1970-01-01T00:00:00.000Z",
"eventName":"ObjectCreated:Put",
"userIdentity":{
"principalId":"AIDAJDPLRKLG7UEXAMPLE"
},
"requestParameters":{
"sourceIPAddress":"127.0.0.1"
},
"responseElements":{
"x-amz-request-id":"C3D13FE58DE4C810",
"x-amz-id-2":"FMyUVURIY8/IgAtTv8xRjskZQpcIZ9KG4V5Wp6S7S/JRWeUWerMUE5JgHvANOjpD"
},
"s3":{
"s3SchemaVersion":"1.0",
"configurationId":"testConfigRule",
"bucket":{
"name":"SOURCEBUCKET",
"ownerIdentity":{
"principalId":"A3NL1KOZZKExample"
},
"arn":"arn:aws:s3:::SOURCEBUCKET"
},
"object":{
"key":"HappyFace.jpg",
"size":1024,
"eTag":"d41d8cd98f00b204e9800998ecf8427e",
"versionId":"096fKKXTRTtl3on89fVO.nfljtsv6qko"
}
}
}
]
}
-
Rufen Sie die Funktion in dem Verzeichnis auf, in dem Sie die Datei dummyS3Event.json gespeichert haben, indem Sie den folgenden CLI-Befehl ausführen. Dieser Befehl ruft Ihre Lambda-Funktion synchron auf, indem RequestResponse als Wert des Parameters „invocation-type“ angegeben wird. Weitere Informationen zu synchronen und asynchronen Aufrufen finden Sie unter Aufrufen von Lambda-Funktionen.
aws lambda invoke --function-name CreateThumbnail \
--invocation-type RequestResponse --cli-binary-format raw-in-base64-out \
--payload file://dummyS3Event.json outputfile.txt
Die cli-binary-format Option ist erforderlich, wenn Sie Version 2 des verwendenAWS CLI. Um dies zur Standardeinstellung zu machen, führen Sie aws configure set cli-binary-format raw-in-base64-out aus. Weitere Informationen finden Sie unter AWS CLI-unterstützte globale Befehlszeilenoptionen.
-
Vergewissern Sie sich, dass Ihre Funktion eine Miniaturversion Ihres Bilds erstellt und in Ihrem Amazon-S3-Ziel-Bucket gespeichert hat. Führen Sie den folgenden CLI-Befehl aus und ersetzen Sie dabei SOURCEBUCKET-resized durch den Namen Ihres eigenen Ziel-Buckets:
aws s3api list-objects-v2 --bucket SOURCEBUCKET-resized
Die Ausgabe sollte in etwa wie folgt aussehen: Der Parameter Key zeigt den Dateinamen Ihrer verkleinerten Bilddatei an.
{
"Contents": [
{
"Key": "resized-HappyFace.jpg",
"LastModified": "2023-06-06T21:40:07+00:00",
"ETag": "\"d8ca652ffe83ba6b721ffc20d9d7174a\"",
"Size": 2633,
"StorageClass": "STANDARD"
}
]
}
Testen Ihrer Funktion mit dem Amazon-S3-Auslöser
Nachdem Sie sich vergewissert haben, dass Ihre Lambda-Funktion ordnungsgemäß funktioniert, können Sie Ihr gesamtes Setup testen, indem Sie Ihrem Amazon-S3-Quell-Bucket eine Bilddatei hinzufügen. Wenn Sie Ihr Bild dem Quell-Bucket hinzufügen, sollte Ihre Lambda-Funktion automatisch aufgerufen werden. Ihre Funktion erstellt eine verkleinerte Version der Datei und speichert sie in Ihrem Ziel-Bucket.
- AWS Management Console
-
So testen Sie Ihre Lambda-Funktion unter Verwendung des Amazon-S3-Auslösers (Konsole)
-
Gehen Sie wie folgt vor, um ein Bild in Ihren Amazon-S3-Bucket hochzuladen:
-
Öffnen Sie die Seite Buckets der Amazon-S3-Konsole und wählen Sie Ihren Quell-Bucket aus.
-
Klicken Sie auf Hochladen.
-
Wählen Sie Dateien hinzufügen und anschließend über die Dateiauswahl die Bilddatei aus, die Sie hochladen möchten. Ihr Bildobjekt kann eine beliebige JPG- oder PNG-Datei sein.
-
Wählen Sie Öffnen und anschließend Hochladen aus.
-
Vergewissern Sie sich, dass Lambda eine verkleinerte Version Ihrer Bilddatei in Ihrem Ziel-Bucket gespeichert hat:
-
Navigieren Sie wieder zur Seite Buckets der Amazon-S3-Konsole und wählen Sie Ihren Ziel-Bucket aus.
-
Im Bereich Objekte sollten jetzt zwei verkleinerte Bilddateien angezeigt werden (jeweils eine aus den beiden Tests Ihrer Lambda-Funktion). Wählen Sie zum Herunterladen Ihres verkleinerten Bilds die Datei und anschließend Herunterladen aus.
- AWS CLI
-
So testen Sie Ihre Lambda-Funktion unter Verwendung des Amazon-S3-Auslösers (AWS CLI)
-
Führen Sie in dem Verzeichnis, das das hochzuladende Bild enthält, den folgenden CLI-Befehl aus. Ersetzen Sie dabei den Parameter --bucket durch den Namen Ihres Quell-Buckets. Verwenden Sie für die Parameter --key und --body den Dateinamen Ihres Testbilds. Ihr Testbild kann eine beliebige JPG- oder PNG-Datei sein.
aws s3api put-object --bucket SOURCEBUCKET --key SmileyFace.jpg --body ./SmileyFace.jpg
-
Vergewissern Sie sich, dass Ihre Funktion eine Miniaturversion Ihres Bilds erstellt und in Ihrem Amazon-S3-Ziel-Bucket gespeichert hat. Führen Sie den folgenden CLI-Befehl aus und ersetzen Sie dabei SOURCEBUCKET-resized durch den Namen Ihres eigenen Ziel-Buckets:
aws s3api list-objects-v2 --bucket SOURCEBUCKET-resized
Wenn Ihre Funktion erfolgreich ausgeführt wird, erhalten Sie eine Ausgabe wie die folgende. Ihr Ziel-Bucket sollte jetzt zwei verkleinerte Dateien enthalten.
{
"Contents": [
{
"Key": "resized-HappyFace.jpg",
"LastModified": "2023-06-07T00:15:50+00:00",
"ETag": "\"7781a43e765a8301713f533d70968a1e\"",
"Size": 2763,
"StorageClass": "STANDARD"
},
{
"Key": "resized-SmileyFace.jpg",
"LastModified": "2023-06-07T00:13:18+00:00",
"ETag": "\"ca536e5a1b9e32b22cd549e18792cdbc\"",
"Size": 1245,
"StorageClass": "STANDARD"
}
]
}
Bereinigen Ihrer Ressourcen
Sie können jetzt die Ressourcen, die Sie für dieses Tutorial erstellt haben, löschen, es sei denn, Sie möchten sie behalten. Durch das Löschen von AWS-Ressourcen, die Sie nicht mehr verwenden, können Sie verhindern, dass unnötige Gebühren in Ihrem AWS-Konto anfallen.
So löschen Sie die Lambda-Funktion:
-
Öffnen Sie die Seite Funktionen der Lambda-Konsole.
-
Wählen Sie die Funktion aus, die Sie erstellt haben.
-
Wählen Sie Aktionen, Löschen aus.
-
Geben Sie delete in das Texteingabefeld ein und wählen Sie Delete (Löschen) aus.
So löschen Sie die von Ihnen erstellte Richtlinie
-
Öffnen Sie die Seite Richtlinien in der IAM-Konsole.
-
Wählen Sie die Richtlinie aus, die Sie erstellt haben (AWSLambdaS3Policy).
-
Wählen Sie Policy actions (Richtlinienaktionen) und anschließend Delete (Löschen) aus.
-
Wählen Sie Löschen aus.
So löschen Sie die Ausführungsrolle
-
Öffnen Sie die Seite Roles in der IAM-Konsole.
-
Wählen Sie die von Ihnen erstellte Ausführungsrolle aus.
-
Wählen Sie Löschen aus.
-
Geben Sie den Namen der Rolle in das Texteingabefeld ein und wählen Sie Delete (Löschen) aus.
So löschen Sie den S3-Bucket:
-
Öffnen Sie die Amazon S3-Konsole.
-
Wählen Sie den Bucket aus, den Sie erstellt haben.
-
Wählen Sie Löschen aus.
-
Geben Sie den Namen des Buckets in das Texteingabefeld ein.
-
Wählen Sie Bucket löschen aus.
