Prepare AWS Builders Day Zuerich

Author: giograno

.gitmodules

@@ -0,0 +1,6 @@
+[submodule "image-resizer-sample"]
+	path = image-resizer-sample
+	url = https://github.com/localstack/serverless-image-resizer
+[submodule "full-sample-pods-ci"]
+	path = full-sample-pods-ci
+	url = https://github.com/giograno/serverless-api-ecs-apigateway-sample

README.md

@@ -4,49 +4,56 @@ Repository with code samples for the LocalStack workshop.
 
 Note: The project can either be cloned and installed on your local machine, or you can spin up a remote development environment (Gitpod, or Github Codespaces) to access the project directly from your browser.
 
-* **Option 1:** Open project in [Github Codespaces](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=630930347)
-* **Option 2:** Open project in [Gitpod](https://gitpod.io/#https://github.com/localstack/localstack-workshop)
-* **Option 3:** Run project locally (see instructions below)
+* **Option 1:** Open the project in [Github Codespaces](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=630930347)
+* **Option 2:** Open the project in [Gitpod](https://gitpod.io/#https://github.com/localstack/localstack-workshop)
+* **Option 3:** Run the project locally (see instructions below)
 
 ## Prerequisites
 
 * Docker
 * Python/`pip`
-* Node/`npm` (for CDK tooling)
 * LocalStack Pro API key ([free trial key here](https://app.localstack.cloud))
 
-## Installation
+## Installation & Getting Started
+
+LocalStack can be started in [different ways](https://docs.localstack.cloud/getting-started/installation/).
+The easiest way (the one we recommend) is through the [LocalStack CLI](https://docs.localstack.cloud/getting-started/installation/#localstack-cli).
 
 First, install the LocalStack command-line interface (CLI):
 ```
 pip install localstack
 ```
-Then we start the LocalStack container locally:
+Then we can simply start the LocalStack container locally:
 ```
 export LOCALSTACK_API_KEY=... # insert your API key here
 DEBUG=1 localstack start
 ```
 
-Additionally, we're also installing the following packages, to make the [`awslocal`](https://github.com/localstack/awscli-local), [`tflocal`](https://github.com/localstack/terraform-local) and [`cdklocal`](https://github.com/localstack/aws-cdk-local) commands available:
+Once LocalStack is running in the Docker container, we can issue CLI commands to create and interact with AWS resources. Let's say, for instance, that we want to create a S3 bucket. 
+If you have the [AWS Command Line Interface](https://aws.amazon.com/cli/) installed on your machine, you can simply type:
 ```
-pip install awscli-local[ver1] terraform-local
-npm install -g aws-cdk-local aws-cdk
+aws --endpoint=http://localhost.localstack.cloud:4566 s3 mb s3://demo-bucket
 ```
 
-## Workshop Sections
-
-### Part 1: Getting Started - Serverless Apps
+To make things simpler, you might want to install [`awslocal`](https://github.com/localstack/awscli-local), i.e., our wrapper around the AWS CLI. This way, you don't need to set up the endpoint for every CLI command. The previous command would just be:
+```
+awslocal s3 mb s3://demo-bucket
+```
 
-...
+You can create and browse resources in LocalStack also from the research browser.
+Simply, go to our [Web App](https://app.localstack.cloud/), log in, and click on _Resources_ in the top navigation bar. You will gain access to our research browser, where each service has a console to manage its resources.
 
-### Part 2: Infrastructure-as-Code Tools
+### Hello World
 
-...
+Every programming language tutorial starts with printing a _Hello World_. Let us have the [equivalent](https://github.com/localstack/localstack-workshop/tree/update-after-aws-zurich/hello-world) in LocalStack.
 
-### Part 3: LocalStack in CI Pipelines
+## Deploy a Serverless App on LocalStack
 
-...
+It's time now to deploy a meaningful [serverless application](https://github.com/localstack/serverless-image-resizer/tree/a882f4c050dd8ec4594c35fa5002d4db31c5a834).
 
-### Part 4: LocalStack Persistence and Cloud Pods
+## Infrastructure-as-Code Tools - Cloud Pods - LocalStack in CI
 
-...
+We mostly interacted with LocalStack through the CLI so far. 
+However, large systems are hardly built this way.
+Luckily, LocalStack supports a [wide range of integrations](https://docs.localstack.cloud/user-guide/integrations/) that will cover your favorite Infrastructure-as-Code (IaC) tool.
+In the following [sample](https://github.com/giograno/serverless-api-ecs-apigateway-sample/tree/4bae4b7920da518034237bd95d6b6d0ab607a29d), we will first deploy a complex application with either Terraform or CloudFormation. Then, we will write a small unit test. Finally, we will close the loop by deploying and testing this app in CI with LocalStack.

full-sample-pods-ci

@@ -0,0 +1,12 @@
+# Hello World in LocalStack
+
+This simple serverless app is the Hello World of LocalStack.
+It will deploy an s3 static website with a simple _"Hello World"_.
+
+For more information, visit our [docs](https://docs.localstack.cloud/tutorials/s3-static-website-terraform/).
+
+## How to run
+
+Simply start LocalStack with `localstack start -d` and then run the `deploy.sh` script.
+
+**Note**: If you are executing in Github Codespaces, you can right-click on port 4566, then "Copy Local Address", and then append the suffix /testwebsite/index.html to the URL. For example, the final URL may look something like this: https://yourusername-vigilant-umbrella-q94554wwv-4566.preview.app.github.dev/testwebsite/index.html

hello-world/README.md

@@ -0,0 +1,12 @@
+{
+    "Version": "2012-10-17",
+    "Statement": [
+        {
+            "Sid": "PublicReadGetObject",
+            "Effect": "Allow",
+            "Principal": "*",
+            "Action": "s3:GetObject",
+            "Resource": "arn:aws:s3:::aws-day/*"
+        }
+    ]
+}

hello-world/bucket-policy.json

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+awslocal s3api create-bucket --bucket testwebsite
+
+awslocal s3api put-bucket-policy --bucket testwebsite --policy file://bucket-policy.json
+
+awslocal s3 sync ./ s3://testwebsite
+
+awslocal s3 website s3://testwebsite/ --index-document index.html
+
+echo "Visit http://testwebsite.s3-website.localhost.localstack.cloud:4566/"

hello-world/deploy.sh

@@ -0,0 +1,3 @@
+<html>
+    Hello world
+</html>