AWS CDK tutorial per AWS Cloud9

In una sessione terminale nell' AWS Cloud9 IDE, assicuratevi che siano installati gli ultimi aggiornamenti di sicurezza e le correzioni dei bug. A tale scopo, esegui il comando yum update (per Amazon Linux) o apt update (per Ubuntu Server). Per avviare una nuova sessione del terminale, dalla barra dei menu scegli Window (Finestra), New Terminal (Nuovo terminale).

Per Amazon Linux:

sudo yum -y update

Per Ubuntu Server:

sudo apt update

Confermare se nvm è già installato. A tale scopo, eseguire il comando nvm con l'opzione --version .

nvm --version

Se l'operazione è andata a buon fine, l'output contiene il numero di versione nvm ed è possibile passare a Fase 1.2: installare Node.js.

Scaricare e installare nvm . Per fare ciò, eseguire lo script di installazione. In questo esempio, v0.33.0 è installato, ma è possibile verificare la versione più recente di nvm qui.

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash

Iniziare a usare nvm . È possibile chiudere la sessione del terminale per poi riavviarla oppure trovare il file ~/.bashrc che contiene i comandi per caricare nvm .

. ~/.bashrc

Confermare se Node.js è già installato e, in caso affermativo, confermare che la versione installata è la 16.17.0 o superiore. Questo esempio è stato testato con Node.js 16.17.0. Per controllare, con la sessione del terminale ancora aperta nell'IDE, esegui il comando node con l'opzione --version .

node --version

Se Node.js è già installato, l'output includerà il numero di versione. Se il numero di versione è v16.17.0, passare a Passaggio 1.3: Installazione TypeScript.

Installa Node.js 16 eseguendo il nvmcomando con l'installazione.

nvm install v16

Inizia a usare Node.js 16. A tale scopo, eseguire il comando nvm con l'operazione alias , il numero di versione dell'alias e la versione da utilizzare per quell'alias, come descritto di seguito.

nvm alias default 16

Per confermare che stai usando Node.js 16, esegui nuovamente il node --versioncomando. Se è installata la versione corretta, l'output contiene la versione v16.

Conferma se l'hai già TypeScript installato. Per fare ciò, con la sessione di terminale ancora aperta nell'IDE, esegui il TypeScript compilatore a riga di comando con l'--versionopzione.

tsc --version

Se l'avete TypeScript installato, l'output contiene il numero di TypeScript versione. Se TypeScript è installato, vai avanti aFase 1.4: Installare AWS CDK.

Installa TypeScript. A tale scopo, esegui il npmcomando con l'installazione, -gl'opzione e il nome del TypeScript pacchetto. Si installa TypeScript come pacchetto globale nell'ambiente.

npm install -g typescript

Conferma che TypeScript sia installato. Per fare ciò, esegui il TypeScript compilatore a riga di comando con l'--versionopzione.

tsc --version

Se TypeScript è installato, l'output contiene il numero di TypeScript versione.

Conferma se hai già AWS CDK installato il file. A tale scopo, con la sessione del terminale ancora aperta nell'IDE, esegui il comando cdk con l'opzione --version .

cdk --version

Se AWS CDK è installato, l'output contiene la AWS CDK versione e i numeri di build. Passare direttamente a Fase 2: aggiungere un codice.

Installalo AWS CDK eseguendo il npmcomando insieme all'installazione, al nome del AWS CDK pacchetto da installare e all'-gopzione per installare il pacchetto a livello globale nell'ambiente.

npm install -g aws-cdk

Verificate che AWS CDK sia installato e che vi sia un riferimento corretto. A tale scopo, eseguire il comando cdk con l'opzione --version .

cdk --version

In caso di successo, vengono visualizzati i numeri di AWS CDK versione e build.

Con la sessione del terminale ancora aperta nell'IDE, crea una directory in cui salvare il codice sorgente del progetto, ad esempio una directory ~/environment/hello-cdk nell'ambiente. Quindi passare a tale directory.

rm -rf ~/environment/hello-cdk # Remove this directory if it already exists.
mkdir ~/environment/hello-cdk  # Create the directory.
cd ~/environment/hello-cdk     # Switch to the directory.

Configura la directory come progetto linguistico per. TypeScript AWS CDK A tale scopo, esegui il comando cdk con l'operazione init , il modello sample-app e l'opzione --language insieme al nome del linguaggio di programmazione.

cdk init sample-app --language typescript

Così facendo, nella directory vengono creati i seguenti file e le seguenti sottodirectory.

Nella finestra Environment (Ambiente), aprire il file lib/hello-cdk-stack.ts e cercare il seguente codice in quel file.

import sns = require('@aws-cdk/aws-sns');
import sqs = require('@aws-cdk/aws-sqs');
import cdk = require('@aws-cdk/cdk');

export class HelloCdkStack extends cdk.Stack {
  constructor(parent: cdk.App, name: string, props?: cdk.StackProps) {
    super(parent, name, props);

    const queue = new sqs.Queue(this, 'HelloCdkQueue', {
      visibilityTimeoutSec: 300
    });

    const topic = new sns.Topic(this, 'HelloCdkTopic');

    topic.subscribeQueue(queue);
  }
}

Nella finestra Environment (Ambiente), aprire il file bin/hello-cdk.ts e cercare il seguente codice in quel file.

#!/usr/bin/env node
import cdk = require('@aws-cdk/cdk');
import { HelloCdkStack } from '../lib/hello-cdk-stack';

const app = new cdk.App();
new HelloCdkStack(app, 'HelloCdkStack');
app.run();

Questo codice carica, crea un'istanza, quindi esegue la classe HelloCdkStack dal file lib/hello-cdk-stack.ts.

npmUtilizzatelo per eseguire il TypeScript compilatore per verificare la presenza di errori di codifica, quindi abilitatelo AWS CDK per eseguire il file del progetto. bin/hello-cdk.js A tale scopo, dalla directory principale, esegui il comando npm con l'operazione run , specificando il valore di comando build nel file package.json, come descritto di seguito.

npm run build

Il comando precedente esegue il TypeScript compilatore, che aggiunge file e di supporto. bin/hello-cdk.d.ts lib/hello-cdk-stack.d.ts Il compilatore, inoltre, esegue il transpiling dei file hello-cdk.ts e hello-cdk-stack.ts nei file hello-cdk.js e hello-cdk-stack.js.

AWS CDK Fai AWS CloudFormation in modo che crei il modello di stack. A tale scopo, con la sessione del terminale ancora aperta nell'IDE, dalla directory principale del progetto esegui il comando cdk con l'operazione synth e il nome della pila.

cdk synth HelloCdkStack

In caso di successo, l'output visualizza la sezione del modello di AWS CloudFormation Resources pila.

La prima volta che distribuisci un' AWS CDK app in un ambiente per una combinazione specifica di AWS account e AWS regione, devi installare uno stack di bootstrap. Questo stack include varie risorse di cui AWS CDK ha bisogno per completare le varie operazioni. Ad esempio, questo stack include un bucket Amazon S3 che AWS CDK viene utilizzato per archiviare modelli e asset durante i processi di distribuzione. Per installare lo stack di bootstrap, eseguire il comando cdk sull'istanza con l'operazione di bootstrap .

cdk bootstrap

cdk bootstrap --profile test 123456789012/us-east-1

Fai in modo che AWS CDK esegui il modello AWS CloudFormation dello stack per distribuire lo stack. A tale scopo, dalla directory principale del progetto eseguire il comando cdk con l'operazione deploy e il nome dello stack.

cdk deploy HelloCdkStack

Se l'operazione è andata a buon fine, l'output mostra che lo stack HelloCdkStack è stato distribuito senza errori.

Per confermare che l'argomento Amazon SNS e la coda Amazon SQS sono stati implementati correttamente, invia un messaggio all'argomento, quindi controlla se la coda ha ricevuto il messaggio. A tale scopo, è possibile utilizzare uno strumento come il AWS Command Line Interface (AWS CLI) o il. AWS CloudShell Per ulteriori informazioni su questi strumenti, consulta AWS CLI e tutorial aws-shell per AWS Cloud9.

Ad esempio, per inviare un messaggio all'argomento, con la sessione terminale ancora aperta nell'IDE, usa il AWS CLI publishcomando Amazon SNS, fornendo l'oggetto e il corpo del messaggio, la AWS regione per l'argomento e l'Amazon Resource Name (ARN) dell'argomento.

aws sns publish --subject "Hello from the AWS CDK" --message "This is a message from the AWS CDK." --topic-arn arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K

Nel comando precedente, sostituite arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K con l'ARN assegnato AWS CloudFormation all'argomento. Per ottenere l'ID, puoi eseguire il comando list-topics di Amazon SNS.

aws sns list-topics --output table --query 'Topics[*].TopicArn'

Se l'operazione è andata a buon fine, l'output del comando publish mostra il valore MessageId per il messaggio pubblicato.

Per controllare la coda per il messaggio ricevuto, esegui il comando receive-message di Amazon SQS, indicando l'URL della coda.

aws sqs receive-message --queue-url https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K

Nel comando precedente, sostituite https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K con l'ARN assegnato AWS CloudFormation alla coda. Per ottenere l'URL, puoi eseguire il comando list-queues di Amazon SQS.

aws sqs list-queues --output table --query 'QueueUrls[*]'

Se l'operazione è andata a buon fine, l'output del comando receive-message mostra le informazioni sul messaggio ricevuto.