AWS CDK tutorial para AWS Cloud9

En una sesión terminal en el AWS Cloud9 IDE, asegúrese de que estén instaladas las últimas actualizaciones de seguridad y correcciones de errores. Para ello, ejecute el comando yum update (para Amazon Linux) o apt update (para Ubuntu Server). (Para iniciar una nueva sesión del terminal, en la barra de menús, seleccione Window [Ventana], New Terminal [Nuevo terminal]).

Para Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt update

Confirme si nvm ya está instalado. Para ello, ejecute el comando nvm con la opción --version.

nvm --version

Si se ejecuta correctamente, el resultado contiene el número de versión de nvm , en cuyo caso puede ir directamente a Paso 1.2: Instalar Node.js.

Descargue e instale nvm. Para ello, ejecute el script de instalación. En este ejemplo, la versión instalada es la 0.33.0, pero puede consultar la última versión de nvm aquí.

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

Comience a utilizar nvm. Puede cerrar la sesión del terminal e iniciarla de nuevo, o bien cargar el archivo ~/.bashrc que contiene los comandos para cargar nvm.

. ~/.bashrc

Confirme si ya tiene instalado Node.js. Si es así, asegúrese de que la versión instalada es 16.17.0 o superior. Este ejemplo se ha probado con Node.js 16.17.0. Para verificarlo, con la sesión del terminal aún abierta en el IDE, ejecute el comando node con la opción --version .

node --version

Si ha instalado Node.js, la salida contendrá el número de versión. Si el número de versión es 16.17.0, vaya directamente a Paso 1.3: Instalar TypeScript.

Instale Node.js 16 ejecutando el comando nvm con la acción install .

nvm install v16

Comience a utilizar Node.js 16. Para ello, ejecute el comando nvm junto con la acción alias, el número de versión para el alias y la versión que se va a utilizar para dicho alias, tal y como se indica a continuación.

nvm alias default 16

Para confirmar que está utilizando 16 Node.js, vuelva a ejecutar el comando node --version . Si la versión instalada es la correcta, la salida incluirá la versión v16.

Confirme si ya lo ha TypeScript instalado. Para ello, con la sesión de terminal aún abierta en el IDE, ejecute el TypeScript compilador de línea de comandos con la --versionopción.

tsc --version

Si lo ha TypeScript instalado, el resultado contiene el número de TypeScript versión. Si TypeScript está instalado, pase aPaso 1.4: Instale el AWS CDK.

Instalar TypeScript. Para ello, ejecute el npmcomando con la installacción, la -gopción y el nombre del TypeScript paquete. Se instala TypeScript como un paquete global en el entorno.

npm install -g typescript

Confirme que TypeScript esté instalado. Para ello, ejecute el TypeScript compilador de línea de comandos con la --versionopción.

tsc --version

Si TypeScript está instalado, la salida contiene el número de TypeScript versión.

Confirme si ya lo tiene AWS CDK instalado. Para ello, con la sesión del terminal aún abierta en el IDE, ejecute el comando cdk con la opción --version .

cdk --version

Si AWS CDK está instalado, el resultado contiene los números de AWS CDK versión y compilación. Vaya a Paso 2: Agregar el código.

Para instalarlo, ejecute el npmcomando junto con la install acción, el nombre del AWS CDK paquete que se va a instalar y la -g opción de instalar el paquete globalmente en el entorno. AWS CDK

npm install -g aws-cdk

Confirme que AWS CDK está instalado y que está correctamente referenciado. Para ello, ejecute el comando cdk con la opción --version.

cdk --version

Si se ejecuta correctamente, se muestran los números de AWS CDK versión y compilación.

Con la sesión del terminal aún abierta en el IDE, cree un directorio para almacenar el código fuente del proyecto; por ejemplo, un directorio ~/environment/hello-cdk en su entorno. Luego, cambie a ese directorio.

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.

Configure el directorio como un TypeScript proyecto de lenguaje para. AWS CDK Para ello, ejecute el comando cdk con la acción init, la plantilla sample-app y la opción --language junto con el nombre del lenguaje de programación.

cdk init sample-app --language typescript

De esta forma, se crean los siguientes archivos y subdirectorios en el directorio.

En la ventana Environment (Entorno), abra el archivo lib/hello-cdk-stack.ts y examine el siguiente código en ese archivo.

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

En la ventana Environment (Entorno), abra el archivo bin/hello-cdk.ts y examine el siguiente código en ese archivo.

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

Este código carga, crea una instancia y luego ejecuta la clase HelloCdkStack a partir del archivo lib/hello-cdk-stack.ts.

Se utiliza npmpara ejecutar el TypeScript compilador para comprobar si hay errores de codificación y, AWS CDK a continuación, habilitar la ejecución del bin/hello-cdk.js archivo del proyecto. Para ello, desde el directorio raíz del proyecto, ejecute el comando npm con la acción run y especifique el valor del comando build en el archivo package.json, tal y como se indica a continuación.

npm run build

El comando anterior ejecuta el TypeScript compilador, que añade archivos bin/hello-cdk.d.ts y lib/hello-cdk-stack.d.ts soportes. El compilador también transpone los archivos hello-cdk-stack.ts y hello-cdk.ts en los archivos hello-cdk-stack.js y hello-cdk.js.

Haga que creen la plantilla de pila. AWS CDK CloudFormation Para ello, con la sesión del terminal aún abierta en el IDE, desde el directorio raíz del proyecto, ejecute el comando cdk con la acción synth y el nombre de la pila.

cdk synth HelloCdkStack

Si tiene éxito, el resultado muestra la Resources sección de la plantilla de CloudFormation pila.

La primera vez que despliegues una AWS CDK aplicación en un entorno para una combinación específica de AWS cuenta y AWS región, debes instalar una pila de arranque. Esta pila incluye varios recursos que AWS CDK necesita para completar sus distintas operaciones. Por ejemplo, esta pila incluye un bucket de Amazon S3 que AWS CDK utiliza para almacenar plantillas y activos durante sus procesos de implementación. Para instalar la pila de arranque, ejecute el comando cdk con la acción bootstrap .

cdk bootstrap

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

Haga que AWS CDK ejecute la plantilla de CloudFormation pila para implementar la pila. Para ello, desde el directorio raíz del proyecto, ejecute el comando cdk con la acción deploy y el nombre de la pila.

cdk deploy HelloCdkStack

Si se ejecuta correctamente, la salida muestra que la pila HelloCdkStack se ha implementado sin errores.

Para confirmar que el tema de Amazon SNS y la cola de Amazon SQS se han implementado correctamente, envíe un mensaje al tema y, luego, verifique la cola para ver si se ha recibido el mensaje. Para ello, puede utilizar una herramienta como el AWS Command Line Interface (AWS CLI) o el AWS CloudShell. Para obtener más información sobre estas herramientas, consulte AWS CLI y tutorial de aws-shell para AWS Cloud9.

Por ejemplo, para enviar un mensaje al tema, con la sesión de terminal aún abierta en el IDE, utilice el publishcomando AWS CLI to run Amazon SNS, proporcionando el asunto y el cuerpo del mensaje, la AWS región del tema y el nombre de recurso de Amazon (ARN) del tema.

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

En el comando anterior, arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K sustitúyalo por el ARN que se CloudFormation asigna al tema. Para obtener el ID, puede ejecutar el comando list-topics de Amazon SNS.

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

Si se ejecuta correctamente, la salida del comando publish muestra el valor de MessageId del mensaje que se publicó.

Para verificar la cola para ver si se ha recibido el mensaje, ejecute el comando receive-message de Amazon SQS y proporcione la URL de la cola.

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

En el comando anterior, https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K sustitúyalo por el ARN que se CloudFormation asigna a la cola. Para obtener la URL, puede ejecutar el comando list-queues de Amazon SQS.

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

Si se ejecuta correctamente, la salida del comando receive-message muestra información del mensaje que se recibió.