Spanish Translation

workshop/config.toml

@@ -15,6 +15,9 @@ hasCJKLanguage = true
   [languages.ja]
     languageName = "日本語"
     contentDir = "content/japanese"
+  [languages.es]
+    languageName = "Español"
+    contentDir = "content/spanish"
 
 [markup]
 [markup.goldmark.renderer]

workshop/content/spanish/15-prerequisites/100-awscli.md

@@ -0,0 +1,13 @@
++++
+title = "AWS CLI"
+weight = 100
++++
+
+# AWS CLI
+
+AWS CLI le permite interactuar con los servicios de AWS desde una terminal. Asegúrese de tener instalada la última versión de AWS CLI en tu equipo.
+
+* Windows: [MSI installer](https://docs.aws.amazon.com/cli/latest/userguide/install-windows.html#install-msi-on-windows)
+* Linux, macOS o Unix: [Bundled installer](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-bundle.html#install-bundle-other)
+
+Mira la siguiente página para más detalles [Instalación de AWS Command Line Interface](https://docs.aws.amazon.com/es_es/cli/latest/userguide/cli-chap-getting-started.html)

workshop/content/spanish/15-prerequisites/200-account.md

@@ -0,0 +1,61 @@
++++
+title = "Cuenta de AWS y usuario"
+weight = 200
++++
+
+## Cuenta de AWS para experimentación
+
+Para desplegar nuestra aplicación, necesitarás acceso a una cuenta de AWS. Si ya tienes una y tu equipo estás configurado con las credenciales de un usuario administrador, puedes [moverte a la siguiente sección](http://#).
+
+{{% notice warning %}}
+Si estás usando una cuenta existente, sea personal o
+una cuenta empresarial, asegurate de entender las implicaciones y políticas de
+aprovisionamiento de recursos en esa cuenta.
+{{% /notice %}}
+
+Si no tienes una cuenta de AWS, puedes [crear una cuenta gratis aquí](https://portal.aws.amazon.com/billing/signup#/start/email)
+
+## Usuario Administrador
+
+1. Inicia sesión en tu cuenta de AWS.
+2. Dirígete hacia la consola de **AWS IAM**
+3. Debajo de la pestaña de **Administración del acceso**, selecciona **Usuarios**
+4. Clic en el botón **Agregar usuarios**
+5. Escribe un nombre para tu usuario (Ejemplo: `cdk-workshop`), selecciona la casilla **Proporcione acceso de usuario a la consola de administración de AWS: *Opcional***
+6. Seleccione el **Quiero crear un usuario de IAM**
+7. Elija la configuración de contraseña que desee, clic en **siguiente**
+
+
+    ![](./nuevo-usuario.png)
+
+1. En opciones de permiso elija Adjuntar políticas directamente. 
+
+*Como práctica recomendada, le sugerimos, en cambio, adjuntar políticas a un grupo. A continuación, agregue el usuario al grupo adecuado.*
+
+1. Seleccione la política con el nombre **AdministratorAccess**, y clic en **siguiente**.
+2. Clic en **Crear usuario**
+3. Regresa a la lista de usuarios, selecciona el usuario recientemente creado **cdk-workshop**
+4. Selecciona la pestaña **credenciales de seguridad**, En el apartado **Claves de acceso** clic en **Crear clave de acceso**
+5. En Caso de uso, selecciona Interfaz de línea de comandos (CLI)
+6. Clic en el checkbox ***Entiendo la recomendación anterior y deseo proceder a la creación de una clave de acceso**.* Y **Siguiente**. Y luego en **Crear clave de acceso**
+
+*Puedes copiar la clave de acceso y la clave de acceso secreta o descargar el archivo.csv con la información.*
+
+Configura tus credenciales
+
+Abre una ventana de terminal y escribe `aws configure` para configurar tu ambiente. Ingresa la **access key ID** (Clave de acceso) y la **secret access key** (Clave de acceso secreta), luego elija una región por defecto (Puedes usar `us-east-1`, `us-west-1`, `us-west-2` por ejemplo). Preferiblemente elija una región que no contenga ningún recurso desplegado en ella.
+
+
+```
+aws configure
+```
+
+Y llena la información desde la consola:
+
+
+```
+AWS Access Key ID [None]: <type key ID here>
+AWS Secret Access Key [None]: <type access key>
+Default region name [None]: <choose region (e.g. "us-east-1", "eu-west-1")>
+Default output format [None]: <leave blank>
+```

workshop/content/spanish/15-prerequisites/300-nodejs.md

@@ -0,0 +1,23 @@
++++
+title = "Node.js"
+chapter = false
+weight = 300
++++
+
+
+El AWS CDK usa Node.js (>= 10.13.0, excepto para versiones 13.0.0 - 13.6.0). Se recomienda una versión con soporte activa a largo plazo (16.x en el momento de escribir este workshop).
+
+
+* Para instalar Node.js visita el sitio web [node.js](https://nodejs.org/es)
+    * **Windows**: Si tienes una versión anterior de Node.js instalada en tu equipo, puede ser requerido correr el .msi installation como Administrador
+* Si ya tienes instalado Node.js, verifica que tienes una versión compatible
+
+```
+node --version
+```
+
+La salida debe ser >= 10.13.0:
+
+```
+v10.3.0
+```

workshop/content/spanish/15-prerequisites/400-ide.md

@@ -0,0 +1,18 @@
++++
+title = "IDE para tu lenguaje de programación"
+weight = 400
++++
+
+Uno de los beneficios de AWS CDK es que puedes usar tus ambientes de desarrollo favoritos y tener una gran experiencia mientras exploras  los cientos de diferentes servicios y características de AWS.
+
+Nosotros recomendamos usar un IDE que soporte completado de código y destacado de sintáxis para el lenguaje de tu elección:
+
+
+* [VSCode](https://code.visualstudio.com/) (recomendado)
+* [AWS Cloud9](https://aws.amazon.com/cloud9)
+* [Atom](https://atom.io/) con el plugin [atom-typescript](https://atom.io/packages/atom-typescript)
+* [vim](https://www.vim.org/) con [tsuquyomi](https://github.com/Quramy/tsuquyomi)
+* [WebStorm](https://www.jetbrains.com/help/webstorm/typescript-support.html)
+* [Emacs](https://www.gnu.org/software/emacs/) con el modo [tide](https://github.com/ananthakumaran/tide)
+* [PyCharm](https://www.jetbrains.com/pycharm/download/)
+* [Eclipse](https://www.eclipse.org/ide/)

workshop/content/spanish/15-prerequisites/500-toolkit.md

@@ -0,0 +1,22 @@
++++
+title = "AWS CDK Toolkit"
+weight = 500
++++
+
+Ahora, necesitaremos instalar el AWS CDK Toolkit. El toolkit is una utilidad de lineas de comando el cual permite trabajar con aplicaciones de CDK.
+
+Abre una ventana de terminal y ejecuta el siguiente comando:
+
+* Windows: Necesitaras ejecutarlo como un Administrador
+* POSIX: En algunos sistemas es necesario ejecutar el comando con `sudo`
+
+```
+npm install -g aws-cdk
+```
+
+Puedes verificar la versión del toolkit:
+
+```
+cdk --version
+{{% cdkversion %}}
+```

workshop/content/spanish/15-prerequisites/600-python.md

@@ -0,0 +1,10 @@
++++
+title = "Python"
+weight = 600
++++
+
+Si estás planeando usar el workshop para Python, entonces obviamente necesitarás tener Python instalado. Especificamente, necesitarás la versión 3.6 o superior. Puedes encontrar información acerca de cómo descargar e instalar Python [aquí](https://www.python.org/downloads/).
+
+Si usas Windows, asegúrate que Python esté en tu PATH. Para ver sí está, escribe `python` en una terminal. La manera más fácil de estar seguro que Python está en tu PATH es marcar el checkbox **Add Python 3.x to PATH** en la pantalla del instalador de Python. Sí ya tienes instalado Python, pero no está en tu PATH, puedes añadirlo editando la variable de entorno `PATH`. Para editar las variables de entorno, has clic en el botón Variables de entorno en la página avanzada de las propiedades del sistema de Windows. (La manera más rápida de obtener: Presiona y libera la tecla Windows, escribe **env**, y elija **Editar las variables de entorno del sistema** desde el menú de inicio.
+
+Adicionalmente, necesitarás tener el instalador de paquetes de Python (pip) instalado. Mira las instrucciones de instalación [aquí](https://pypi.org/project/pip/).

workshop/content/spanish/15-prerequisites/700-dotnet.md

@@ -0,0 +1,8 @@
++++
+title = ".NET"
+weight = 700
++++
+
+Si planea usar .NET Workshop, obviamente necesitará tener instalado el SDK de.NET Core. En concreto, necesitará la versión 3.1 o posterior. Puedes encontrar información sobre cómo descargar e instalar el SDK de.NET Core [aquí](https://dotnet.microsoft.com/download).
+
+Usaremos la CLI de.NET Core para este proyecto, así que si no está familiarizado, consulte su [documentación](https://docs.microsoft.com/en-us/dotnet/core/tools).

workshop/content/spanish/15-prerequisites/800-java.md

@@ -0,0 +1,6 @@
++++
+title = "Java"
+weight = 800
++++
+
+Si planeas usar Java Workshop, obviamente necesitarás tener un JDK instalado. En concreto, necesitará el JDK 11 o una versión posterior. Puede encontrar información sobre cómo descargar e instalar la distribución Amazon Corretto 11 [aquí](https://aws.amazon.com/corretto/). Hay otras distribuciones de JDK 11 disponibles si no desea utilizar Amazon Corretto.

workshop/content/spanish/15-prerequisites/900-go.md

@@ -0,0 +1,6 @@
++++
+title = "Go"
+weight = 900
++++
+
+Si planea usar Go Workshop, necesitará instalar Go. Puedes descargar Go desde [go.dev](https://go.dev/), la página de descarga mostrará las versiones estables, todas las cuales funcionarán con el CDK.

workshop/content/spanish/15-prerequisites/_index.md

@@ -0,0 +1,25 @@
++++
+title = "Prerequisitos"
+bookCollapseSection = true
+bookFlatSection = true 
+weight = 15
++++
+
+# Prerrequisitos para el workshop
+
+Para realizar este workshop, necesitarás lo siguiente:
+
+{{< children showhidden="false" />}}
+
+Node.js  es requerido para usar el CDK, pero los otros lenguajes dentro de los prerrequisitos, sólo serán necesarios si se quiere construir una aplicación con el CDK en ese lenguaje.
+
+Puedes salar cualquiera de estos pasos si ya tienes instaladas estas herramientas en tu máquina.
+
+Clic en la flecha a la derecha para continuar hacia el primer paso
+
+
+### Mira también
+
+
+
+* [Prerrequisitos en la guía de usuario de AWS CDK](https://docs.aws.amazon.com/es_es/cdk/v2/guide/getting_started.html)

workshop/content/spanish/20-typescript/20-create-project/100-cdk-init.md

@@ -0,0 +1,53 @@
++++
+title = "cdk init"
+weight = 100
++++
+
+## Crear directorio de proyectos
+
+Cree un directorio vacío en su sistema:
+
+```
+mkdir cdk-workshop && cd cdk-workshop
+```
+
+## cdk init
+
+Usaremos `cdk init` para crear un nuevo proyecto de TypeScript CDK:
+
+```
+cdk init sample-app --language typescript
+```
+
+El resultado debería tener este aspecto (puedes ignorar de forma segura las advertencias sobre la inicialización de un repositorio de git, esto probablemente signifique que no tienes git instalado, lo cual está bien para este workshop):
+
+```
+Applying project template app for typescript
+Initializing a new git repository...
+Executing npm install...
+npm notice created a lockfile as package-lock.json. You should commit this file.
+npm WARN [email protected] No repository field.
+npm WARN [email protected] No license field.
+
+# Welcome to your CDK TypeScript project!
+
+You should explore the contents of this project. It demonstrates a CDK app with an instance of a stack (`CdkWorkshopStack`)
+which contains an Amazon SQS queue that is subscribed to an Amazon SNS topic.
+
+The `cdk.json` file tells the CDK Toolkit how to execute your app.
+
+## Useful commands
+
+ * `npm run build`   compile typescript to js
+ * `npm run watch`   watch for changes and compile
+ * `npm run test`    perform the jest unit tests
+ * `cdk deploy`      deploy this stack to your default AWS account/region
+ * `cdk diff`        compare deployed stack with current state
+ * `cdk synth`       emits the synthesized CloudFormation template
+```
+
+Como puede ver, nos muestra un montón de comandos útiles para empezar.
+
+## Ver También
+
+- [AWS CDK Command Line Toolkit (cdk) in the AWS CDK User Guide](https://docs.aws.amazon.com/CDK/latest/userguide/tools.html)

workshop/content/spanish/20-typescript/20-create-project/300-structure.md

@@ -0,0 +1,82 @@
++++
+title = "Estructura del proyecto"
+weight = 300
++++
+
+## Abre tu IDE
+
+Ahora es un buen momento para abrir el proyecto en tu IDE favorito y explorarlo.
+
+> Si usa VSCode, simplemente puede escribir `code .` en el directorio del proyecto.
+
+## Explore su directorio de proyectos
+
+Verás algo como esto:
+
+![](./structure.png)
+
+* __`lib/cdk-workshop-stack.ts`__ es donde se define la pila principal de la aplicación CDK.
+ Este es el archivo en el que pasaremos la mayor parte del tiempo.
+* `bin/cdk-workshop.ts` es el punto de entrada de la aplicación CDK. Cargará la pila definida en `lib/cdk-workshop-stack.ts`.
+* `package.json` es el manifiesto de tu módulo npm. Incluye información como la
+ el nombre de tu aplicación, la versión, las dependencias y los scripts de compilación como "watch" y
+ "build" (`package-lock.json` es mantenido por npm)
+* `cdk.json` indica al kit de herramientas cómo ejecutar la aplicación. En nuestro caso, será
+  `"npx ts-node bin/cdk-workshop.ts"`
+* `tsconfig.json` el de tu proyecto [typescript
+  configuración](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html)
+* `.gitignore` y `.npmignore` dígale a git y npm qué archivos incluir/excluir
+ desde el control de código fuente y al publicar este módulo en el administrador de paquetes.
+* `node_modules` es mantenido por npm e incluye todos sus proyectos
+ dependencias.
+
+## El punto de entrada de tu aplicación
+
+Echemos un vistazo rápido a `bin/cdk-workshop.ts`:
+
+```js
+#!/usr/bin/env node
+import * as cdk from 'aws-cdk-lib';
+import { CdkWorkshopStack } from '../lib/cdk-workshop-stack';
+
+const app = new cdk.App();
+new CdkWorkshopStack(app, 'CdkWorkshopStack');
+```
+
+Este código carga y crea instancias del `CdkWorkshopStack` clase del
+`lib/cdk-workshop-stack.ts` archivo. Ya no necesitaremos mirar este archivo.
+
+## La pila principal
+
+Abre `lib/cdk-workshop-stack.ts`. Aquí es donde está el meollo de nuestra aplicación
+es:
+
+```ts
+import * as cdk from 'aws-cdk-lib';
+import * as sns from 'aws-cdk-lib/aws-sns';
+import * as subs from 'aws-cdk-lib/aws-sns-subscriptions';
+import * as sqs from 'aws-cdk-lib/aws-sqs';
+
+export class CdkWorkshopStack extends cdk.Stack {
+  constructor(scope: cdk.App, id: string, props?: cdk.StackProps) {
+    super(scope, id, props);
+
+    const queue = new sqs.Queue(this, 'CdkWorkshopQueue', {
+      visibilityTimeout: cdk.Duration.seconds(300)
+    });
+
+    const topic = new sns.Topic(this, 'CdkWorkshopTopic');
+
+    topic.addSubscription(new subs.SqsSubscription(queue));
+  }
+}
+```
+
+Como puede ver, nuestra aplicación se creó con una pila de CDK de muestra
+(`CdkWorkshopStack`).
+
+La pila incluye:
+
+- SQS Queue (`new sqs.Queue`)
+- SNS Topic (`new sns.Topic`)
+- Suscribe la cola para recibir cualquier mensaje publicado en el tema (`topic.addSubscription`)