Tutorial: Verwendung AWS Lambda mit Amazon DocumentDB DocumentDB-Streams

Öffnen Sie die AWS Cloud9 Konsole und wählen Sie Umgebung erstellen.

Erstellen Sie eine Umgebung mit der folgenden Konfiguration:

Wählen Sie Create (Erstellen) aus. Die Bereitstellung Ihrer neuen AWS Cloud9 Umgebung kann mehrere Minuten dauern.

Öffnen Sie die EC2Konsole. Wählen Sie unter Netzwerk und Sicherheit die Option Sicherheitsgruppen aus.

Wählen Sie Sicherheitsgruppe erstellen aus.

Erstellen Sie eine Sicherheitsgruppe mit der folgenden Konfiguration:

Wählen Sie Sicherheitsgruppe erstellen aus.

Öffnen Sie die Amazon DocumentDB DocumentDB-Konsole. Wählen Sie unter Cluster die Option Erstellen aus.

Erstellen Sie einen Cluster mit der folgenden Konfiguration:

Wählen Sie Cluster erstellen. Die Bereitstellung Ihres Amazon DocumentDB-Clusters kann mehrere Minuten dauern.

Öffnen Sie die Secrets-Manager-Konsole und wählen Sie Neues Secret speichern.

Wählen Sie für Secret-Typ auswählen eine der folgenden Optionen aus:

Wählen Sie unter Secret konfigurieen eine der folgenden Optionen aus:

Wählen Sie Weiter.

Wählen Sie Store (Speichern) aus.

Aktualisieren Sie die Konsole, um zu überprüfen, ob Sie das DocumentDBSecret-Secret erfolgreich gespeichert haben.

Öffnen Sie die AWS Cloud9 -Konsole. Klicken Sie neben der DocumentDBCloud9Environment Umgebung, die Sie zuvor erstellt haben, auf den Link Öffnen in der AWS Cloud9 IDESpalte.

Erstellen Sie im Terminal-Fenster die MongoDB-Repository-Datei mit dem folgenden Befehl:

echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://www.mongodb.org/static/pgp/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo

Installieren Sie daraufhin die mongo-Shell mit dem folgenden Befehl:

sudo yum install -y mongodb-org-shell

Um Daten während der Übertragung zu verschlüsseln, laden Sie den öffentlichen Schlüssel für Amazon DocumentDB. Der folgende Befehl lädt eine Datei mit dem Namen global-bundle.pem herunter:

wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem

Öffnen Sie die Amazon DocumentDB DocumentDB-Konsole. Wählen Sie unter Cluster Ihren Cluster aus, indem Sie seine Cluster-ID auswählen.

Wählen Sie auf der Registerkarte Konnektivität und Sicherheit unter Mit der Mongo-Shell mit diesem Cluster Connect die Option Kopieren aus.

Fügen Sie diesen Befehl in Ihrer AWS Cloud9 Umgebung in das Terminal ein. Ersetzen Sie <insertYourPassword> durch das richtige Passwort.

Stellen Sie in Ihrer AWS Cloud9 Umgebung sicher, dass Sie immer noch mit Ihrem Amazon DocumentDB-Cluster verbunden sind.

Erstellen Sie mit dem folgenden Befehl im Terminal-Fenster eine neue Datenbank mit dem Namen docdbdemo:

use docdbdemo

Verwenden Sie dann den folgenden Befehl, um einen Datensatz einzufügen docdbdemo:

db.products.insert({"hello":"world"})

Die Ausgabe sollte in etwa wie folgt aussehen:

WriteResult({ "nInserted" : 1 })

Verwenden Sie den folgenden Befehl, um alle Datenbanken aufzulisten:

show dbs

Stellen Sie sicher, dass Ihre Ausgabe die docdbdemo-Datenbank enthält:

docdbdemo  0.000GB

Öffnen Sie die VPCKonsole. Wählen Sie im linken Menü unter Virtual Private Cloud die Option Endpunkte aus.

Wählen Sie Endpunkt erstellen aus. Erstellen Sie einen Endpunkt mit der folgenden Konfiguration:

Wählen Sie erneut Endpunkt erstellen. Erstellen Sie einen Endpunkt mit der folgenden Konfiguration:

Öffnen Sie die Seite Richtlinien in der IAM Konsole und wählen Sie Richtlinie erstellen aus.

Wählen Sie die JSONRegisterkarte. Ersetzen Sie in der folgenden Richtlinie die Secrets Manager Manager-Ressource ARN in der letzten Zeile der Anweisung durch Ihr Geheimnis ARN von früher und kopieren Sie die Richtlinie in den Editor.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "LambdaESMNetworkingAccess",
            "Effect": "Allow",
            "Action": [
                "ec2:CreateNetworkInterface",
                "ec2:DescribeNetworkInterfaces",
                "ec2:DescribeVpcs",
                "ec2:DeleteNetworkInterface",
                "ec2:DescribeSubnets",
                "ec2:DescribeSecurityGroups",
                "kms:Decrypt"
            ],
            "Resource": "*"
        },
        {
            "Sid": "LambdaDocDBESMAccess",
            "Effect": "Allow",
            "Action": [
                "rds:DescribeDBClusters",
                "rds:DescribeDBClusterParameters",
                "rds:DescribeDBSubnetGroups"
            ],
            "Resource": "*"
        },
        {
            "Sid": "LambdaDocDBESMGetSecretValueAccess",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": "arn:aws:secretsmanager:us-east-1:123456789012:secret:DocumentDBSecret"
        }
    ]
}

Wählen Sie Weiter: Tags und dann Weiter: Prüfen aus.

Geben Sie unter Name AWSDocumentDBLambdaPolicy ein.

Wählen Sie Create Policy (Richtlinie erstellen) aus.

Öffnen Sie die Seite Rollen in der IAM Konsole und wählen Sie Rolle erstellen aus.

Wählen Sie für Vertrauenswürdige Entität auswählen die folgenden Optionen:

Wählen Sie für Berechtigungen hinzufügen die AWSDocumentDBLambdaPolicy Richtlinie aus, die Sie gerade erstellt haben, sowie die, AWSLambdaBasicExecutionRole um Ihrer Funktion Berechtigungen zum Schreiben in Amazon CloudWatch Logs zu erteilen.

Wählen Sie Weiter.

Geben Sie für Role name (Rollenname) den Namen AWSDocumentDBLambdaExecutionRole ein.

Wählen Sie Create role (Rolle erstellen) aus.

Kopieren Sie den Beispiel-Code in eine Datei mit dem Namen index.js.

Erstellen Sie ein Bereitstellungspaket mit dem folgenden -Befehl.

zip function.zip index.js

Verwenden Sie den folgenden CLI Befehl, um die Funktion zu erstellen. us-east-1Ersetzen Sie es durch die AWS-Region, und 123456789012 durch Ihre Konto-ID.

aws lambda create-function \
  --function-name ProcessDocumentDBRecords \
  --zip-file fileb://function.zip --handler index.handler --runtime nodejs20.x \
  --region us-east-1 \
  --role arn:aws:iam::123456789012:role/AWSDocumentDBLambdaExecutionRole

Öffnen Sie die Seite Funktionen in der Lambda-Konsole.

Wählen Sie die ProcessDocumentDBRecords-Funktion aus, die Sie zuvor erstellt haben.

Wählen Sie die Registerkarte Konfiguration und dann im linken Menü Trigger aus.

Wählen Sie Add trigger.

Wählen Sie unter Trigger-Konfiguration für die Quelle Amazon DocumentDB aus.

Erstellen Sie die Zuordnung von Ereignisquellen mit der folgenden Konfiguration:

Wählen Sie Hinzufügen aus. Die Erstellung Ihrer Zuordnung von Ereignisquellen kann einige Minuten dauern.

Öffnen Sie die Seite Funktionen in der Lambda-Konsole.

Wählen Sie die Registerkarte „Überwachen“ und anschließend „ CloudWatch Protokolle anzeigen“. Dadurch gelangen Sie zu der spezifischen Protokollgruppe, die Ihrer Funktion in der CloudWatch Konsole zugeordnet ist.

Wählen Sie den neuesten Protokollstreams aus. In den Protokollnachrichten sollten Sie das Ereignis sehenJSON.

Stellen Sie erneut eine Verbindung zu Ihrem Amazon DocumentDB-Cluster in Ihrer AWS Cloud9 Umgebung her.

Verwenden Sie diesen Befehl, um sicherzustellen, dass Sie gerade die docdbdemo-Datenbank verwenden:

use docdbdemo

Fügen Sie einen Datensatz in die products-Sammlung der docdbdemo-Datenbank ein:

db.products.insert({"name":"Pencil", "price": 1.00})

Ö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.

Öffnen Sie die Rollenseite der IAM Konsole.

Wählen Sie die von Ihnen erstellte Ausführungsrolle aus.

Wählen Sie Löschen.

Geben Sie den Namen der Rolle in das Texteingabefeld ein und wählen Sie Delete (Löschen) aus.

Öffnen Sie die VPCKonsole. Wählen Sie im linken Menü unter Virtual Private Cloud die Option Endpunkte aus.

Wählen Sie die Endpunkte aus, die Sie erstellt haben.

Wählen Sie „Aktionen“, „VPCEndpoints löschen“.

Geben Sie delete in das Texteingabefeld ein.

Wählen Sie Löschen.

Öffnen Sie die Amazon DocumentDB DocumentDB-Konsole.

Wählen Sie den Amazon DocumentDB-Cluster aus, den Sie für dieses Tutorial erstellt haben, und deaktivieren Sie den Löschschutz.

Wählen Sie auf der Cluster-Hauptseite erneut Ihren Amazon DocumentDB-Cluster aus.

Wählen Sie Aktionen, Löschen aus.

Wählen Sie für Finalen Cluster-Snapshot erstellen die Option Nein aus.

Geben Sie delete in das Texteingabefeld ein.

Wählen Sie Löschen.

Öffnen Sie die Secrets Manager-Konsole.

Wählen Sie das Secret aus, das Sie für dieses Tutorial erstellt haben.

Wählen Sie Aktionen, Secret löschen.

Wählen Sie Schedule deletion.

Öffnen Sie die EC2Konsole. Wählen Sie unter Netzwerk und Sicherheit die Option Sicherheitsgruppen aus.

Wählen Sie die Sicherheitsgruppe, die Sie für dieses Tutorial erstellt haben.

Wählen Sie Aktionen, Sicherheitsgruppen löschen.

Wählen Sie Löschen.

Öffnen Sie die AWS Cloud9 -Konsole.

Wählen Sie die Umgebung aus, die Sie für dieses Tutorial erstellt haben.

Wählen Sie Löschen.

Geben Sie delete in das Texteingabefeld ein.

Wählen Sie Löschen.