AWS CDK: Custom Resource
Zusammenfassung
Kurz
Der Beitrag beschreibt zwei Wege, CloudFormation-Custom-Resources mit AWS CDK umzusetzen: über `Provider` und `CustomResource` mit eigener Lambda oder über `AwsCustomResource` für AWS-SDK-Aktionen. Er erklärt Anfrage- und Antwortverarbeitung, die Bedeutung der stabilen `PhysicalResourceId` sowie Hinweise zu Fehlern, sensiblen Daten, Berechtigungen und erzwungenen Updates.
Mittel
Der Artikel erläutert CloudFormation-Custom-Resources als Möglichkeit, eigene Bereitstellungslogik bei Erstellung, Änderung oder Löschung eines Stacks auszuführen. Als Anwendungsfälle nennt der Autor fehlende CloudFormation-Ressourcentypen, Zusatzaktionen wie das Leeren eines S3-Buckets und das Auflösen zyklischer Abhängigkeiten. Er stellt zwei CDK-Varianten vor: `Provider` mit `CustomResource` und `AwsCustomResource` für AWS-SDK-Aktionen.
Beim Provider-Ansatz leitet ein Service-Token Anfragen an eine Lambda-Funktion weiter. Der Provider übernimmt unter anderem die Antwortübermittlung und unterstützt asynchrone Abläufe. Ein Rust-Beispiel zeigt die Verarbeitung von Create-, Update- und Delete-Anfragen. Der Autor empfiehlt, Fehler als Antwort mit Status `ERROR` und Begründung zurückzugeben und sensible Antwortdaten mit `NoEcho` zu maskieren.
Die `PhysicalResourceId` muss laut Beitrag nicht leer und für dieselbe Ressource stabil sein; ein geänderter Wert kann eine Ersetzung auslösen. `AwsCustomResource` eignet sich laut Beispiel für einzelne SDK-Aufrufe, nutzt aber eine gemeinsame Singleton-Lambda, deren Rolle alle nötigen Berechtigungen braucht. Ohne Stack-Änderung erfolgt kein Update-Aufruf; ein wechselnder Zeitwert kann ihn erzwingen. Eine umfassende Prüfung der Beispiele bietet der Artikel nicht.
Ausführlich lesen
Der Artikel erklärt, wozu CloudFormation-Custom-Resources dienen und wie sie sich in einem AWS-CDK-Stack umsetzen lassen. Der Autor beschreibt sie als Möglichkeit, eigene Bereitstellungslogik in CloudFormation einzubinden. Sie können bei Stack-Erstellung, Änderungen an der Custom Resource und beim Löschen aufgerufen werden. Als mögliche Einsatzfälle nennt er Ressourcen, für die es keinen passenden CloudFormation-Ressourcentyp gibt, zusätzliche Aktionen wie das Leeren eines S3-Buckets vor dessen Löschung und das Auflösen zyklischer Abhängigkeiten zwischen Ressourcen.
Der Ablauf ist laut Artikel: CloudFormation sendet bei Create, Update oder Delete eine Anfrage. Ein Handler führt die gewünschte Aktion aus und liefert eine Antwort zurück. Diese Antwort kann direkt an eine vorab signierte S3-Adresse gesendet oder durch den CDK-Provider verwaltet werden. Für CDK stellt der Beitrag zwei Ansätze gegenüber: `Provider` zusammen mit `CustomResource` sowie `AwsCustomResource` für Aufrufe registrierter AWS-Ressourcen beziehungsweise AWS-SDK-Aktionen.
Beim ersten Ansatz zeigt der Autor eine Lambda-Funktion als Handler, die mit einem `Provider` verknüpft und über dessen `serviceToken` an die Custom Resource angeschlossen wird. Eigenschaften der Resource werden als Schlüssel-Wert-Paare übermittelt und erscheinen laut Beispiel im Feld `ResourceProperties` der CloudFormation-Anfrage. Der Provider übernimmt unter anderem die Antwortübermittlung, prüft Rückgabewerte, unterstützt asynchrone Abläufe mit einem zusätzlichen `isCompleteHandler` und stellt Standardverhalten für physische Ressourcen-IDs bereit. Einstellungen wie VPC, Sicherheitsgruppen und Subnetze können ebenfalls konfiguriert werden.
Ein Rust-Beispiel verarbeitet Create-, Update- und Delete-Anfragen und baut eine Erfolgsantwort. Der Autor empfiehlt, Fehler nicht einfach aus der Lambda-Funktion zurückzuwerfen, sondern eine Antwort mit Status `ERROR` und Begründung zu senden. Sensible Werte im Antwortfeld `Data` sollten nach seiner Darstellung durch `NoEcho: true` maskiert werden, da sie sonst etwa über Stack-Ereignisse sichtbar sein können.
Besondere Bedeutung misst der Beitrag der `PhysicalResourceId` bei. Sie muss eine nicht leere Zeichenkette sein und bei Antworten für dieselbe Ressource gleich bleiben. Bleibt sie bei einem Update gleich, gilt dies laut Artikel als normales Update; ändert sie sich, behandelt CloudFormation es als Ersatz und sendet eine Löschanfrage für die alte Ressource. Als Wert kommen etwa das Service-Token oder – abhängig von der Implementierung – die Kennung der tatsächlich angelegten Ressource infrage.
`AwsCustomResource` wird als einfachere Möglichkeit für einzelne AWS-SDK-Aktionen vorgestellt, beispielsweise einen S3-`putObject`-Aufruf, ohne dafür eine eigene Handler-Lambda zu schreiben. Der Autor warnt, dass CDK-Aufrufe dieses Typs eine Singleton-Lambda gemeinsam nutzen. Deren Rolle muss daher gegebenenfalls Berechtigungen für alle benötigten Aktionen und Ressourcen erhalten; der Beitrag zeigt dafür eine eigens definierte Rolle.
Zum Schluss merkt der Autor an, dass ohne Stack-Änderung kein Update-Aufruf erfolgt. Ein zusätzliches, bei jeder Bereitstellung wechselndes Feld – etwa ein Zeitwert – könne einen erneuten Aufruf auslösen. Die Beispiele veranschaulichen die Ansätze, behandeln aber keine systematische Bewertung oder vollständige Betriebs- und Sicherheitsanalyse der gezeigten Implementierungen.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Die Zusammenfassung enthält einen inhaltlichen Fehler: Der Bericht sagt, die PhysicalResourceId müsse ein nicht leerer String sein, Luna schreibt dagegen, sie müsse nicht leer sein. Lunas Einordnung enthält keine Frage (jeweils „(keine)“), daher bleibt die Einordnung leer.
Im Bericht, aber nicht in der Zusammenfassung
- Die Empfehlung, Lambda-Funktionen nicht direkt als serviceToken zu verwenden, weil der Provider mehr leistet (Antwortbehandlung, Validierung, Standardverhalten für IDs).
- Antworten können entweder selbst an die pre-signed S3-URL gesendet oder über den Provider abgewickelt werden.
In der Zusammenfassung, laut Prüfung nicht im Bericht belegt
- Die Aussage, der Artikel biete keine umfassende Prüfung der Beispiele, steht so nicht im Bericht.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.