這是 AWS CDK v2 開發人員指南。較舊的 CDK v1 於 2022 年 6 月 1 日進入維護，並於 2023 年 6 月 1 日結束支援。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
識別符和 AWS CDK
建置 AWS Cloud Development Kit (AWS CDK) 應用程式時，您會使用多種類型的識別符和名稱。若要 AWS CDK 有效使用 並避免錯誤，請務必了解識別符的類型。
識別符必須在建立它們的範圍內是唯一的；它們不需要在您的 AWS CDK 應用程式中全域是唯一的。
如果您嘗試在相同範圍內建立具有相同值的識別符， 會 AWS CDK 擲回例外狀況。
建構 IDs
最常見的識別符 id是實例化建構物件時作為第二個引數傳遞的識別符。此識別符與所有識別符一樣，只需要在其建立的範圍內是唯一的，這是在實例化建構物件時的第一個引數。
我們來看一個範例，其中有兩個具有識別符的建構amzn-s3-demo-bucket。第一個定義在具有識別符 的堆疊範圍內Stack1。第二個是定義在具有識別符 的堆疊範圍內Stack2。因為它們是在不同的範圍內定義，這不會造成任何衝突，而且可以在同一應用程式中並存而不會發生問題。
- 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");
}
}
路徑
應用程式中的建構會 AWS CDK 形成以App類別為根的階層。我們將 集合IDs從指定的建構、其父建構、其祖父母等，稱為路徑 ，以至建構樹的根目錄。
AWS CDK 通常會將範本中的路徑顯示為字串。IDs 來自 層級的 會以斜線分隔，從根App執行個體下的節點開始，通常為堆疊。例如，上一個程式碼範例中兩個 Amazon S3 儲存貯體資源的路徑為 Stack1/amzn-s3-demo-bucket和 Stack2/amzn-s3-demo-bucket。
您可以程式設計方式存取任何建構的路徑，如下列範例所示。這會取得路徑 myConstruct（或 my_construct，因為 Python 開發人員會寫入）。由於 在其建立的範圍內IDs必須是唯一的，因此其路徑在 AWS CDK 應用程式中一律是唯一的。
- 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;
唯一 IDs
AWS CloudFormation 要求範本IDs中的所有邏輯都是唯一的。因此， AWS CDK 必須能夠為應用程式中的每個建構產生唯一的識別符。資源具有全域唯一路徑 （從堆疊到特定資源的所有範圍名稱）。因此， 會串連路徑的元素並新增 8 位數雜湊，以 AWS CDK 產生必要的唯一識別碼。（若要區分不同的路徑，例如 A/B/C和 A/BC，這會導致相同的 AWS CloudFormation 識別符，雜湊是必要的。 AWS CloudFormation 識別符是英數字元，不能包含斜線或其他分隔符號字元。） 會將此字串 AWS CDK 呼叫為建構的唯一 ID。
一般而言，您的 AWS CDK 應用程式不需要知道唯一的 IDs。不過，您可以以程式設計方式存取任何建構的唯一 ID，如下列範例所示。
- 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);
地址是另一種唯一識別符，可唯一區分CDK資源。衍生自路徑的 SHA-1 雜湊，無法人類讀取。不過，其固定、相對較短的長度 （一律為 42 個十六進位字元） 可讓您在「傳統」唯一 ID 可能太長的情況下使用。某些建構可能使用合成 AWS CloudFormation 範本中的地址，而不是唯一的 ID。同樣地，您的應用程式通常不需要知道其建構地址，但您可以擷取建構地址，如下所示。
- 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;
邏輯 IDs
針對代表資源的建構所產生 AWS CloudFormation 範本中，唯一 IDs 可做為 AWS 資源的邏輯識別符 （或邏輯名稱 ）。
例如，在上一個範例中建立的 Amazon S3 儲存貯體Stack2會產生AWS::S3::Bucket資源。資源的邏輯 ID 位於產生的 AWS CloudFormation 範本Stack2amzn-s3-demo-bucket4DD88B4F中。（如需如何產生此識別碼的詳細資訊，請參閱 唯一 IDs。）
邏輯 ID 穩定性
建立資源之後，請避免變更資源的邏輯 ID。 會依其邏輯 ID 來 AWS CloudFormation 識別資源。因此，如果您變更資源的邏輯 ID， 會使用新的邏輯 ID AWS CloudFormation 建立新的資源，然後刪除現有的資源。視資源類型而定，這可能會導致服務中斷、資料遺失或兩者兼有。
