Questa è la guida per sviluppatori AWS CDK v2. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Identificatori
Durante la creazione di AWS Cloud Development Kit (AWS CDK) app, utilizzerai molti tipi di identificatori e nomi. Per utilizzarli AWS CDK in modo efficace ed evitare errori, è importante comprendere i tipi di identificatori.
Gli identificatori devono essere univoci nell'ambito in cui vengono creati; non è necessario che siano univoci a livello globale nell'applicazione AWS CDK .
Se si tenta di creare un identificatore con lo stesso valore all'interno dello stesso ambito, viene generata un' AWS CDK eccezione.
Costruisci ID
L'identificatore più comune,id
, è l'identificatore passato come secondo argomento durante l'istanziazione di un oggetto di costruzione. Questo identificatore, come tutti gli identificatori, deve essere univoco solo nell'ambito in cui viene creato, che è il primo argomento quando si crea un'istanza di un oggetto di costruzione.
Nota
L'id
of a stack è anche l'identificatore utilizzato per fare riferimento ad esso in. AWS CDK Toolkit (cdkcomando)
Diamo un'occhiata a un esempio in cui abbiamo due costrutti con l'identificatore MyBucket
nella nostra app. Il primo è definito nell'ambito dello stack con l'identificatore. Stack1
Il secondo è definito nell'ambito di uno stack con l'identificatore. Stack2
Poiché sono definiti in ambiti diversi, ciò non causa alcun conflitto e possono coesistere nella stessa app senza problemi.
Percorsi
I costrutti di un' AWS CDK applicazione formano una gerarchia radicata nella classe. App
Ci riferiamo alla raccolta di ID di un determinato costrutto, al suo costrutto genitore, al suo predecessore e così via alla radice dell'albero dei costrutti, come percorso.
AWS CDK In genere visualizza i percorsi nei modelli come una stringa. Gli ID dei livelli sono separati da barre, a partire dal nodo immediatamente sotto l'App
istanza root, che di solito è una pila. Ad esempio, i percorsi delle due risorse del bucket Amazon S3 nell'esempio di codice precedente sono e. Stack1/MyBucket
Stack2/MyBucket
È possibile accedere al percorso di qualsiasi costrutto a livello di codice, come illustrato nell'esempio seguente. Questo ottiene il percorso di myConstruct
(omy_construct
, come lo scriverebbero gli sviluppatori Python). Poiché gli ID devono essere unici nell'ambito in cui vengono creati, i loro percorsi sono sempre unici all'interno di un' AWS CDK applicazione.
ID univoci
AWS CloudFormation richiede che tutti gli ID logici in un modello siano univoci. Per questo motivo, AWS CDK devono essere in grado di generare un identificatore univoco per ogni costrutto in un'applicazione. Le risorse hanno percorsi univoci a livello globale (i nomi di tutti gli ambiti dallo stack a una risorsa specifica). Pertanto, AWS CDK genera gli identificatori univoci necessari concatenando gli elementi del percorso e aggiungendo un hash a 8 cifre. (L'hash è necessario per distinguere percorsi distinti, come A/B/C
eA/BC
, che risulterebbero nello stesso identificatore. AWS CloudFormation AWS CloudFormation
gli identificatori sono alfanumerici e non possono contenere barre o altri caratteri separatori.) AWS CDK Chiama questa stringa l'ID univoco del costrutto.
In generale, la tua AWS CDK app non dovrebbe aver bisogno di conoscere gli ID univoci. Tuttavia, potete accedere all'ID univoco di qualsiasi costrutto a livello di codice, come illustrato nell'esempio seguente.
L'indirizzo è un altro tipo di identificatore univoco che distingue in modo univoco le risorse CDK. Derivato dall'hash SHA-1 del percorso, non è leggibile dall'uomo. Tuttavia, la sua lunghezza costante e relativamente breve (sempre 42 caratteri esadecimali) lo rende utile in situazioni in cui l'ID univoco «tradizionale» potrebbe essere troppo lungo. Alcuni costrutti possono utilizzare l'indirizzo nel AWS CloudFormation modello sintetizzato anziché l'ID univoco. Anche in questo caso, la tua app in genere non dovrebbe aver bisogno di conoscere gli indirizzi dei suoi costrutti, ma puoi recuperare l'indirizzo di un costrutto come segue.
ID logici
Gli ID univoci fungono da identificatori logici (o nomi logici) delle risorse nei AWS CloudFormation modelli generati per i costrutti che rappresentano AWS le risorse.
Ad esempio, il bucket Amazon S3 dell'esempio precedente, creato all'interno, restituisce una Stack2
risorsa. AWS::S3::Bucket
L'ID logico della risorsa si trova Stack2MyBucket4DD88B4F
nel modello risultante AWS CloudFormation . (Per i dettagli su come viene generato questo identificatore, vedereID univoci.)
Stabilità dell'ID logico
Evita di modificare l'ID logico di una risorsa dopo che è stata creata. AWS CloudFormation identifica le risorse in base al relativo ID logico. Pertanto, se si modifica l'ID logico di una risorsa, AWS CloudFormation crea una nuova risorsa con il nuovo ID logico, quindi elimina quello esistente. A seconda del tipo di risorsa, ciò potrebbe causare l'interruzione del servizio, la perdita di dati o entrambe le cose.