AWS CDK tutoriel pour AWS Cloud9

Lors d'une session de terminal dans le AWS Cloud9 IDE, assurez-vous que les dernières mises à jour de sécurité et corrections de bogues sont installées. Pour ce faire, exécutez la commande yum update (pour Amazon Linux) ou apt update (pour Ubuntu Server). (Pour démarrer une nouvelle séance de terminal, dans la barre de menus, choisissez Window, Nouveau Terminal.)

Pour Amazon Linux :

sudo yum -y update

Pour Ubuntu Server :

sudo apt update

Vérifiez si nvm est déjà installé. Pour ce faire, exécutez la commande nvm avec l'option --version .

nvm --version

En cas de réussite, la sortie contient le numéro de version de nvm, et vous pouvez passer directement à Étape 1.2 : Installer Node.js..

Téléchargez et installez nvm . Pour ce faire, exécutez le script d'installation. Dans cet exemple, v0.33.0 est installé, mais vous pouvez vérifier la dernière version de nvm ici.

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

Commencez à utiliser nvm . Vous pouvez fermer la session de terminal et la redémarrer, ou approvisionner le fichier ~/.bashrc qui contient les commandes pour charger nvm .

. ~/.bashrc

Vérifiez si vous avez déjà installé Node.js et, si vous le faites, assurez-vous qu'il s'agit de la version 16.17.0 ou d'une version supérieure. Cet exemple a été testé avec Node.js 16.17.0. Pour vérifier, la session du terminal étant toujours ouverte dans leIDE, exécutez la nodecommande avec l'--versionoption.

node --version

Si Node.js est bien installé, la sortie contient le numéro de version. Si le numéro de version est v16.17.0, passez directement à Étape 1.3 : Installation TypeScript.

Installez Node.js 16 en exécutant la nvmcommande avec l'installaction.

nvm install v16

Commencez à utiliser Node.js 16. Pour ce faire, exécutez la commande nvm avec l'action alias , le numéro de version d'alias et la version à utiliser pour cet alias, comme suit.

nvm alias default 16

Pour confirmer que vous utilisez Node.js 16, réexécutez la node --versioncommande. Si la bonne version est installée, la sortie contient la version v16.

Vérifiez si vous l'avez déjà TypeScript installé. Pour ce faire, la session du terminal étant toujours ouverte dans leIDE, exécutez le TypeScript compilateur de ligne de commande avec l'--versionoption.

tsc --version

Si vous l'avez TypeScript installé, la sortie contient le numéro de TypeScript version. S' TypeScript il est installé, passez directement àÉtape 1.4 : Installation du AWS CDK.

Installez TypeScript. Pour ce faire, exécutez la npmcommande avec l'installaction, l'-goption et le nom du TypeScript package. Cela s'installe TypeScript en tant que package global dans l'environnement.

npm install -g typescript

Confirmez qu' TypeScript il est installé. Pour ce faire, exécutez le TypeScript compilateur en ligne de commande avec l'--versionoption.

tsc --version

S'il TypeScript est installé, la sortie contient le numéro de TypeScript version.

Vérifiez si vous l'avez déjà AWS CDK installé. Pour ce faire, la session du terminal étant toujours ouverte dans leIDE, exécutez la cdkcommande avec l'--versionoption.

cdk --version

Si le AWS CDK est installé, la sortie contient les numéros de AWS CDK version et de build. Passez directement à Étape 2 : Ajouter du code.

Installez le AWS CDK en exécutant la npmcommande accompagnée de l'installaction, du nom du AWS CDK package à installer et de l'-goption permettant d'installer le package globalement dans l'environnement.

npm install -g aws-cdk

Vérifiez que le AWS CDK est installé et correctement référencé. Pour ce faire, exécutez la commande cdk avec l'option --version .

cdk --version

En cas de succès, les numéros de AWS CDK version et de version sont affichés.

La session du terminal étant toujours ouverte dans leIDE, créez un répertoire pour stocker le code source du projet, par exemple un ~/environment/hello-cdk répertoire dans votre environnement. Puis basculez sur ce répertoire.

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.

Configurez le répertoire en tant que projet de TypeScript langue pour AWS CDK. Pour ce faire, exécutez la commande cdk avec l'action init , le modèle sample-app et l'option --language , ainsi que le nom du langage de programmation.

cdk init sample-app --language typescript

Cela crée les fichiers et sous-répertoires suivants dans le répertoire.

Dans la fenêtre Environnement, ouvrez le fichier lib/hello-cdk-stack.ts et recherchez le code suivant dans le fichier.

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);
  }
}

Dans la fenêtre Environnement, ouvrez le fichier bin/hello-cdk.ts et recherchez le code suivant dans le fichier.

#!/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();

Ce code charge, instancie, puis exécute la classe HelloCdkStack à partir du fichier lib/hello-cdk-stack.ts.

npmUtilisez-le pour exécuter le TypeScript compilateur afin de vérifier les erreurs de codage, puis d'activer le AWS CDK pour exécuter le bin/hello-cdk.js fichier du projet. Pour ce faire, dans le répertoire racine du projet, exécutez la commande npm avec l'action run , en spécifiant la valeur de la commande build dans le fichier package.json, comme suit.

npm run build

La commande précédente exécute le TypeScript compilateur, qui ajoute des supports bin/hello-cdk.d.ts et lib/hello-cdk-stack.d.ts des fichiers. Le compilateur transpile également les fichiers hello-cdk-stack.ts et hello-cdk.ts dans les fichiers hello-cdk-stack.js et hello-cdk.js.

Demandez à AWS CDK créer le modèle de AWS CloudFormation pile. Pour ce faire, la session du terminal étant toujours ouverte dans le IDE répertoire racine du projet, exécutez la cdkcommande avec l'synthaction et le nom de la pile.

cdk synth HelloCdkStack

En cas de succès, la sortie affiche la Resources section du modèle de AWS CloudFormation pile.

La première fois que vous déployez une AWS CDK application dans un environnement pour une combinaison de AWS compte et de AWS région spécifique, vous devez installer une pile bootstrap. Cette pile comprend diverses ressources dont elle a AWS CDK besoin pour effectuer ses différentes opérations. Par exemple, cette pile inclut un compartiment Amazon S3 AWS CDK utilisé pour stocker des modèles et des actifs au cours de ses processus de déploiement. Pour installer la pile d'amorçage, exécutez la commande cdk avec l'action bootstrap.

cdk bootstrap

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

Demandez-leur d' AWS CDK exécuter le modèle de AWS CloudFormation pile pour déployer la pile. Pour ce faire, à partir du répertoire à la racine du projet, exécutez la commande cdk avec l'action deploy , et le nom de la pile.

cdk deploy HelloCdkStack

En cas de réussite, la sortie affiche que la pile HelloCdkStack a été déployée sans erreur.

Pour confirmer que le SNS sujet Amazon et la SQS file d'attente Amazon ont été correctement déployés, envoyez un message au sujet, puis vérifiez le message reçu dans la file d'attente. Pour ce faire, vous pouvez utiliser un outil tel que le AWS Command Line Interface (AWS CLI) ou le AWS CloudShell. Pour plus d'informations sur ces outils, consultez AWS CLI et tutoriel aws-shell pour AWS Cloud9.

Par exemple, pour envoyer un message au sujet, alors que la session du terminal est toujours ouverte dans leIDE, utilisez la commande AWS CLI pour exécuter la SNS publishcommande Amazon, en fournissant l'objet et le corps du message, la AWS région du sujet et le nom de la ressource Amazon du sujet (ARN).

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

Dans la commande précédente, remplacez arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K par celui ARN qui AWS CloudFormation est affecté au sujet. Pour obtenir l'identifiant, vous pouvez exécuter la SNS list-topicscommande Amazon.

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

En cas de réussite, la sortie de la commande publish affiche la valeur MessageId pour le message qui a été publié.

Pour vérifier la présence du message reçu dans la file d'attente, exécutez la SQS receive-messagecommande Amazon en fournissant les informations de la file d'attenteURL.

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

Dans la commande précédente, remplacez https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K par ARN celui qui est affecté AWS CloudFormation à la file d'attente. Pour l'obtenirURL, vous pouvez exécuter la SQS list-queuescommande Amazon.

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

En cas de réussite, la sortie de la commande receive-message affiche l'information pour le message qui a été reçu.