Identifikatoren und die AWS CDK - AWS Cloud Development Kit (AWS CDK) v2

Dies ist der AWS CDK v2-Entwicklerhandbuch. Die ältere CDK Version 1 wurde am 1. Juni 2022 in die Wartung aufgenommen und der Support wurde am 1. Juni 2023 eingestellt.

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.

Identifikatoren und die AWS CDK

Beim Erstellen von AWS Cloud Development Kit (AWS CDK) Apps werden Sie viele Arten von Kennungen und Namen verwenden. Um sie AWS CDK effektiv zu nutzen und Fehler zu vermeiden, ist es wichtig, die Arten von Identifikatoren zu verstehen.

Identifikatoren müssen innerhalb des Bereichs, in dem sie erstellt wurden, eindeutig sein. Sie müssen in Ihrer AWS CDK Anwendung nicht global eindeutig sein.

Wenn Sie versuchen, einen Bezeichner mit demselben Wert innerhalb desselben Bereichs zu erstellen, wird eine AWS CDK Ausnahme ausgelöst.

Konstruieren IDs

Der häufigste Bezeichner,id, ist der Bezeichner, der bei der Instanziierung eines Konstruktobjekts als zweites Argument übergeben wird. Dieser Bezeichner muss, wie alle Bezeichner, nur innerhalb des Bereichs, in dem er erstellt wurde, eindeutig sein. Dies ist das erste Argument bei der Instanziierung eines Konstruktobjekts.

Anmerkung

Der Wert id eines Stacks ist auch der Bezeichner, mit dem Sie in der auf ihn verweisen. AWS CDK CLI Referenz

Schauen wir uns ein Beispiel an, bei dem wir zwei Konstrukte mit dem Identifier amzn-s3-demo-bucket in unserer App haben. Das erste ist im Bereich des Stacks mit dem Bezeichner Stack1 definiert. Der zweite ist im Gültigkeitsbereich eines Stacks mit dem Bezeichner definiertStack2. Da sie in unterschiedlichen Bereichen definiert sind, führt dies zu keinem Konflikt und sie können problemlos in derselben App koexistieren.

TypeScript
import { App, Stack, StackProps } from 'aws-cdk-lib'; import { Construct } from 'constructs'; import * as s3 from 'aws-cdk-lib/aws-s3'; class MyStack extends Stack { constructor(scope: Construct, id: string, props: StackProps = {}) { super(scope, id, props); new s3.Bucket(this, 'amzn-s3-demo-bucket'); } } const app = new App(); new MyStack(app, 'Stack1'); new MyStack(app, 'Stack2');
JavaScript
const { App , Stack } = require('aws-cdk-lib'); const s3 = require('aws-cdk-lib/aws-s3'); class MyStack extends Stack { constructor(scope, id, props = {}) { super(scope, id, props); new s3.Bucket(this, 'amzn-s3-demo-bucket'); } } const app = new App(); new MyStack(app, 'Stack1'); new MyStack(app, 'Stack2');
Python
from aws_cdk import App, Construct, Stack, StackProps from constructs import Construct from aws_cdk import aws_s3 as s3 class MyStack(Stack): def __init__(self, scope: Construct, id: str, **kwargs): super().__init__(scope, id, **kwargs) s3.Bucket(self, "amzn-s3-demo-bucket") app = App() MyStack(app, 'Stack1') MyStack(app, 'Stack2')
Java
// MyStack.java package com.myorg; import software.amazon.awscdk.App; import software.amazon.awscdk.Stack; import software.amazon.awscdk.StackProps; import software.constructs.Construct; import software.amazon.awscdk.services.s3.Bucket; public class MyStack extends Stack { public MyStack(final Construct scope, final String id) { this(scope, id, null); } public MyStack(final Construct scope, final String id, final StackProps props) { super(scope, id, props); new Bucket(this, "amzn-s3-demo-bucket"); } } // Main.java package com.myorg; import software.amazon.awscdk.App; public class Main { public static void main(String[] args) { App app = new App(); new MyStack(app, "Stack1"); new MyStack(app, "Stack2"); } }
C#
using Amazon.CDK; using constructs; using Amazon.CDK.AWS.S3; public class MyStack : Stack { public MyStack(Construct scope, string id, IStackProps props) : base(scope, id, props) { new Bucket(this, "amzn-s3-demo-bucket"); } } class Program { static void Main(string[] args) { var app = new App(); new MyStack(app, "Stack1"); new MyStack(app, "Stack2"); } }

Pfade

Die Konstrukte in einer AWS CDK Anwendung bilden eine Hierarchie, die in der Klasse verwurzelt ist. App Wir bezeichnen die Sammlung IDs von einem bestimmten Konstrukt, seinem übergeordneten Konstrukt, seinem übergeordneten Konstrukt usw. bis zur Wurzel des Konstruktbaums als Pfad.

AWS CDK In der Regel werden Pfade in Ihren Vorlagen als Zeichenfolge angezeigt. Die IDs von den Ebenen werden durch Schrägstriche getrennt, beginnend am Knoten unmittelbar unter der App Root-Instance, bei der es sich normalerweise um einen Stack handelt. Die Pfade der beiden Amazon S3 S3-Bucket-Ressourcen im vorherigen Codebeispiel lauten beispielsweise Stack1/amzn-s3-demo-bucket undStack2/amzn-s3-demo-bucket.

Sie können programmgesteuert auf den Pfad eines beliebigen Konstrukts zugreifen, wie im folgenden Beispiel gezeigt. Dies erhält den Pfad von myConstruct (odermy_construct, wie Python-Entwickler ihn schreiben würden). Da sie innerhalb des Bereichs, in dem sie erstellt wurden, eindeutig sein IDs müssen, sind ihre Pfade innerhalb einer AWS CDK Anwendung immer eindeutig.

TypeScript
const path: string = myConstruct.node.path;
JavaScript
const path = myConstruct.node.path;
Python
path = my_construct.node.path
Java
String path = myConstruct.getNode().getPath();
C#
string path = myConstruct.Node.Path;

Einzigartig IDs

AWS CloudFormation erfordert, dass alle logischen IDs Elemente in einer Vorlage eindeutig sind. Aus diesem Grund AWS CDK muss der in der Lage sein, für jedes Konstrukt in einer Anwendung einen eindeutigen Bezeichner zu generieren. Ressourcen haben Pfade, die weltweit einzigartig sind (die Namen aller Bereiche vom Stapel bis zu einer bestimmten Ressource). Daher AWS CDK generiert der die erforderlichen eindeutigen Identifikatoren, indem er die Elemente des Pfads verkettet und einen 8-stelligen Hash hinzufügt. (Der Hash ist notwendig, um verschiedene Pfade wie A/B/C und zu unterscheidenA/BC, die zu derselben Kennung führen würden. AWS CloudFormation AWS CloudFormation Bezeichner sind alphanumerisch und dürfen keine Schrägstriche oder andere Trennzeichen enthalten.) Der AWS CDK nennt diese Zeichenfolge die eindeutige ID des Konstrukts.

Im Allgemeinen sollte Ihre AWS CDK App nichts über Unique wissen müssenIDs. Sie können jedoch programmgesteuert auf die eindeutige ID eines beliebigen Konstrukts zugreifen, wie im folgenden Beispiel gezeigt.

TypeScript
const uid: string = Names.uniqueId(myConstruct);
JavaScript
const uid = Names.uniqueId(myConstruct);
Python
uid = Names.unique_id(my_construct)
Java
String uid = Names.uniqueId(myConstruct);
C#
string uid = Names.Uniqueid(myConstruct);

Die Adresse ist eine weitere Art von eindeutiger Kennung, die Ressourcen eindeutig unterscheidetCDK. Er wurde vom Hash SHA -1 des Pfads abgeleitet und ist nicht für Menschen lesbar. Aufgrund ihrer konstanten, relativ kurzen Länge (immer 42 Hexadezimalzeichen) ist sie jedoch in Situationen nützlich, in denen die „traditionelle“ eindeutige ID möglicherweise zu lang ist. Einige Konstrukte verwenden möglicherweise die Adresse in der synthetisierten AWS CloudFormation Vorlage anstelle der eindeutigen ID. Auch hier sollte Ihre App im Allgemeinen nichts über die Adressen ihrer Konstrukte wissen müssen, aber Sie können die Adresse eines Konstrukts wie folgt abrufen.

TypeScript
const addr: string = myConstruct.node.addr;
JavaScript
const addr = myConstruct.node.addr;
Python
addr = my_construct.node.addr
Java
String addr = myConstruct.getNode().getAddr();
C#
string addr = myConstruct.Node.Addr;

Logisch IDs

Unique IDs dienen als logische Bezeichner (oder logische Namen) von Ressourcen in den generierten AWS CloudFormation Vorlagen für Konstrukte, die Ressourcen repräsentieren AWS .

Der Amazon S3 S3-Bucket im vorherigen Beispiel, der innerhalb erstellt wurde, Stack2 führt beispielsweise zu einer AWS::S3::Bucket Ressource. Die logische ID der Ressource befindet sich Stack2amzn-s3-demo-bucket4DD88B4F in der resultierenden AWS CloudFormation Vorlage. (Einzelheiten darüber, wie dieser Bezeichner generiert wird, finden Sie unterEinzigartig IDs.)

Stabilität logischer IDs

Vermeiden Sie es, die logische ID einer Ressource zu ändern, nachdem sie erstellt wurde. AWS CloudFormation identifiziert Ressourcen anhand ihrer logischen ID. Wenn Sie also die logische ID einer Ressource ändern, AWS CloudFormation wird eine neue Ressource mit der neuen logischen ID erstellt und anschließend die vorhandene gelöscht. Je nach Ressourcentyp kann dies zu Betriebsunterbrechungen, Datenverlust oder beidem führen.