add latest changes

Author: thetillhoff

.gitignore

@@ -1,8 +1,3 @@
-**/*.js
-**/!jest.config.js
-**/*.d.ts
 **/node_modules
 
-# CDK asset staging directory
-**/cdk.staging
-**/cdk.out
+.DS_Store

README.md

@@ -1,9 +1,7 @@
-# Statista AWS Workshop 2024-02
+# AWS Workshop
 
-## Start the workshop
+This is a hands-on workshop about some of the most common AWS services.
 
-```sh
-cd docs
-npm install
-npm run start
-```
+The recommended way to start this workshop is to visit the published Github Pages site for it.
+
+If you want to run it locally, or make changes to it, check the [docs/README.md](docs/README.md) for more information.

docs/0_welcome.md

@@ -1,10 +1,16 @@
-# AWS Advanced Workshop: Container Orchestration and Delivery
+# AWS Workshop
+
+![Welcome to this AWS Workshop](media/welcome.png)
 
-![Welcome to AWS Advanced Workshop](media/welcome.png)
 
 ## Introduction
 
-Welcome to the AWS Advanced Workshop! This workshop is designed for developers who want to learn about container orchestration, load balancing, and content delivery on AWS. Through hands-on labs, you'll build a containerized application infrastructure using Pulumi.
+Welcome to this AWS Workshop! It is designed for developers who want to learn about container orchestration, load balancing, databases, lambdas 
+<!-- TODO update this later -->
+and content delivery on AWS. Through the included hands-on labs, you'll build a containerized application infrastructure using aws-cdk.
+
+
+## Target Audience
 
 ## How to Use This Guide
 
@@ -17,127 +23,36 @@ This workshop is structured into several labs, each focusing on a specific AWS s
 
 Navigate through the labs in order, as each builds upon the previous one. Use the sidebar to move between sections.
 
+
+<!-- TODO change or remove this
 ## Project Overview
 
-This guide takes you beyond the basics of AWS, focusing on building modern containerized applications. Through the hands-on labs, you'll create a sophisticated cloud infrastructure using Amazon ECS, Application Load Balancers, and CloudFront, all orchestrated with Pulumi's infrastructure as code. You'll learn how to deploy containerized applications, manage container registries, implement load balancing, and optimize content delivery. This workshop builds upon fundamental AWS knowledge, guiding you through the practical implementation of container orchestration, high availability patterns, and scalable architectures. By the end of this workshop, you'll have hands-on experience building and deploying containerized applications on AWS, preparing you for real-world cloud architecture challenges.
+This guide takes you beyond the basics of AWS, focusing on building modern containerized applications. Through the hands-on labs, you'll create a sophisticated cloud infrastructure using Amazon ECS, Application Load Balancers, and CloudFront, all orchestrated with Pulumi's infrastructure as code. You'll learn how to deploy containerized applications, manage container registries, implement load balancing, and optimize content delivery. This workshop builds upon fundamental AWS knowledge, guiding you through the practical implementation of container orchestration, high availability patterns, and scalable architectures. By the end of this workshop, you'll have hands-on experience building and deploying containerized applications on AWS, preparing you for real-world cloud architecture challenges. -->
+
 
 ## Prerequisites
 
-- Basic understanding of AWS and containerization concepts
+- Basic understanding of AWS, commandline and containerization concepts
 - Familiarity with Docker
 - AWS account with appropriate permissions
-- Node.js (version 14 or later)
-- Docker installed locally
-- AWS CLI version 2 installed and configured
-- Previous experience with Pulumi (completion of AWS Fundamentals Workshop recommended)
-
-## Workshop Architecture Evolution
-
-Throughout this workshop, we'll build our architecture in stages:
-
-1. **ECS Fargate Setup**: Basic ECS cluster with Fargate launch type
-   ![ECS Setup Architecture](media/lab_1_arch.drawio.svg)
-
-2. **Load Balancer Integration**: Adding ALB and target groups
-   ![ALB Integration Architecture](media/lab_2_arch.drawio.svg)
-
-3. **Container Registry**: Building and pushing custom images to ECR
-   ![ECR Integration Architecture](media/lab_3_arch.drawio.svg)
-
-4. **Autoscaling**: Adding autoscaling to the ECS cluster
-   ![Complete Architecture](media/lab_4_arch.drawio.svg)
-
-5. **Content Delivery**: Adding CloudFront distribution
-   ![Complete Architecture](media/lab_5_arch.drawio.svg)
-
-6. **Message Queuing**: Adding SQS with a lambda consumer
-   ![Complete Architecture](media/lab_6_arch.drawio.svg)
-
-### Labs Overview
-
-#### 1. Container Orchestration with ECS
-- **Introduction to containerization and ECS concepts**
-- **Understanding Fargate vs EC2 launch types**
-- **Container networking and security**
-- **Hands-On: Deploy containerized applications using Pulumi**
-  - Set up ECS cluster and VPC
-  - Define task definitions and services
-  - Configure container networking
-
-#### 2. Load Balancing and Service Discovery
-- **Application Load Balancer architecture**
-- **Target groups and health checks**
-- **SSL/TLS termination**
-- **Hands-On: Implement load balancing with Pulumi**
-  - Create ALB and target groups
-  - Configure listeners and rules
-  - Integrate with ECS services
-
-#### 3. Container Registry and Image Management
-- **Introduction to Amazon ECR**
-- **Docker image best practices**
-- **Image lifecycle policies**
-- **Hands-On: Build and deploy custom containers**
-  - Create ECR repositories
-  - Build and tag Docker images
-  - Push images to ECR
-  - Update ECS services
-
-#### 4. Auto Scaling and Monitoring
-- **Scaling patterns and strategies**
-- **CloudWatch metrics and alarms**
-- **Capacity planning**
-- **Hands-On: Implement auto scaling**
-  - Configure scaling policies
-  - Set up CloudWatch alarms
-  - Monitor application metrics
-  - Test scaling behavior
-
-#### 5. Content Delivery and Edge Computing
-- **CloudFront architecture and concepts**
-- **Cache behaviors and policies**
-- **Edge computing patterns**
-- **Hands-On: Implement CDN with Pulumi**
-  - Create CloudFront distributions
-  - Configure origins and behaviors
-  - Set up cache policies
-  - Implement SSL/TLS
-
-#### 6. Message Processing
-- **Event-driven architecture patterns**
-- **Message queue concepts**
-- **Dead letter queues**
-- **Hands-On: Implement message processing**
-  - Create SQS queues
-  - Configure message retention
-  - Implement Lambda consumers
-  - Set up monitoring
-
-## Workshop Duration
-
-This is a self-paced workshop. The time ranges provided for each lab are estimates, and you should feel free to spend more time on areas you find challenging or interesting. Remember to take breaks as needed.
-
-Total estimated time: 4-6 hours
-
-- Lab 1: 45-60 minutes
-- Lab 2: 30-45 minutes
-- Lab 3: 45-60 minutes
-- Lab 4: 30-45 minutes
-- Lab 5: 45-60 minutes
-- Lab 6: 45-60 minutes
-
-Note: Actual duration may vary based on individual pace and prior experience.
-
-## Conclusion
-
-By the end of this workshop, you will have built a production-ready containerized application infrastructure on AWS. You'll understand how to orchestrate containers, implement load balancing, manage container images, and optimize content delivery. The hands-on experience with Pulumi will prepare you for implementing Infrastructure as Code in real-world scenarios.
-
-### Next Steps
-
-To continue your AWS learning journey:
-
-1. Explore the AWS documentation for services covered in this workshop
-2. Try applying these concepts to your own projects
-3. Consider pursuing AWS certifications, starting with the AWS Certified Cloud Practitioner
-
-Let's begin your journey into advanced AWS services!
+- Docker installed
+- Node.js (v22 recommended)
+- AWS CLI version 2 installed
+- curl or Postman installed
+- jq installed (optional)
+
+
+## How to use this workshop
+
+The topics covered by this workshop are the first level chapters.
+Each topic has multiple hands-on steps, which are the second level chapters.
+Each step contains instructions, and a codebase containing the end-state.
+
+If you get stuck during any of the steps, you can always check the end-state to see what you should have at the end of the particular step.
+To see the difference between your current state and the end-state, you can use for example `diff -Nur --exclude=node_modules task-service goal-step-2/task-service`.
+
+To be able to `diff`, you'll need to check out this repository locally.
+
+It's recommended to start with the workshop from the root folder of this repository.
+
+When this workshop describes filepaths, like `cdk/package.json`, they're always relative to that path.

docs/2_next.md

@@ -1,3 +1,5 @@
+<!-- TODO -->
+
 # Next Steps
 
 Congratulations on completing the AWS Advanced workshop! You've learned about several advanced AWS services and best practices. This guide outlines several paths to further develop your AWS skills and apply your newfound knowledge.

docs/3_conclusion.md

@@ -1,3 +1,5 @@
+<!-- TODO -->
+
 # Conclusion
 
 Congratulations on completing the AWS Advanced workshop! You've taken a significant step in your journey to understanding and utilizing Amazon Web Services.

docs/README.md

@@ -1,3 +1,11 @@
-# Headline
+# Docs
 
-> An awesome project.
+This folder contains a docsify project.
+
+It is published to Github Pages.
+
+To run it locally, run
+```sh
+npm install
+npm run start
+```