Initial commit

Author: kevchu3

README.md

@@ -0,0 +1,87 @@
+# 🚀 **Module 4: Creating and Deploying Your First Serverless Function**
+
+**Technology Stack:**
+
+- Python
+- Serverless
+
+---
+
+## 🎯 **Scenario**
+
+Instead of managing servers directly, your applications can scale automatically in response to events, scaling down to zero when idle, which can improve resource efficiency and cost management. In this workspace, you will be required to quickly build an application image, upload it to the internal repository and then load balance it with Red Hat Serverless!
+
+---
+
+## 🐾 **Guided Walkthrough**
+
+1. Create a new project/namespace from the openshift ui and name it <username>-serverless
+2. From the openshift UI, start a new terminal
+  - 2.1. Type in `oc project` to see which project you have enabled
+  - 2.2. Type in `kn` to download the k-native CLI
+3. Create your first Knative service
+
+  ```sh
+  kn service create module4-helloworld \
+  --image quay.io/pknezevich/module4-dotnet-hellolang \
+  --autoscale-window 20s \
+  --env countryCode=DE
+  ```
+
+4. Verify your service has been created and you can curl/navigate to your application
+5. Tag the revision to **green**
+6. NOTE: we will update with ENV VAR but typically you would use: `kn service update <service-name> --image <new-image>`
+
+  ```sh
+  kn service update module4-helloworld \
+  --env countryCode=DE \
+  --tag module4-helloworld-00001=blue --untag green \
+  --tag @latest=green \
+  --traffic blue=100,green=0
+  ```
+
+7. Tag the blue revision to **inactive**
+8. To create a third revision:
+  - 8.1. From OC change the tag from `module4-helloworld-00002` green to blue
+  - 8.2. Create a new revision
+    - 8.2.1. ENV change (quick revision, this is usually done via an image change)
+      - 8.2.1.1. Change a **different country code**
+    - 8.2.2. Tag the **old revision to blue**
+    - 8.2.3. Do not allow any traffic to new revision until you’re ready to (traffic distribution still stays on blue)
+
+  ```sh
+  kn service update module4-helloworld \
+  --env countryCode=FR \
+  --tag module4-helloworld-00002=blue --untag green \
+  --tag @latest=green \
+  --traffic blue=100,green=0
+  ```
+
+9. Build a 3-revision load-balanced environment with 3 different country languages, distribute the traffic evenly between each (33%)
+10. Add a new image as a revision - `quay.io/pknezevich/helloworld-v2`
+
+  ```sh
+  kn service update module4-helloworld \
+    --image quay.io/pknezevich/helloworld-v2 \
+    --env countryCode=IT \
+    --tag module4-helloworld-00001=blue --untag green \
+    --tag @latest=green \
+    --traffic blue=100,green=0
+  ```
+
+---
+
+## 🧩 **Challenge**
+
+- [ ] Design your current environment - canary, blue/green, knife edge
+  - You can rename the revision tags to whatever you’d like them to be
+
+---
+
+## ✅ **Key Takeaways**
+
+- First time approach to Red Hat’s Serverless Scale-to-zero and auto-scaling 
+- Understanding Revisions and Introduced ‘image tagging’ to your container image
+- Demonstrated blue-green deployment
+- Demonstrated canary deployments (using traffic distribution)
+- Demonstrated a knife-edge cutover

catalog-info.yaml

@@ -0,0 +1,17 @@
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+  name: workshop-module4-python
+  title: Module 4 - Python
+  description: |
+    Creating and Deploying Your First Serverless Function
+  annotations:
+    backstage.io/techdocs-ref: dir:.
+  tags:
+    - serverless
+    - python
+spec:
+  type: module
+  lifecycle: production
+  owner: group:default/cluster-admins
+  subcomponentOf: component:default/workshop-repository

devfile.yaml

@@ -0,0 +1,65 @@
+schemaVersion: 2.2.2
+metadata:
+  name: workshop-module2-python
+  version: 1.0.0
+  description: DevSpaces workspace for Python app
+attributes:
+  che-editor: vscode
+components:
+- container:
+    args:
+    - tail
+    - -f
+    - /dev/null
+    endpoints:
+    - name: https-py-5000
+      protocol: https
+      targetPort: 5000
+    - name: https-py-5001
+      protocol: https
+      targetPort: 5001
+    - exposure: none
+      name: debug
+      targetPort: 5858
+    env:   
+    - name: DEBUG_PORT
+      value: "5858"
+    - name: countryCode
+      value: "en"
+    image: image-registry.openshift-image-registry.svc.cluster.local:5000/openshift/devspaces-dotnet-python:latest
+    mountSources: true
+  name: py
+
+commands:
+- exec:
+    commandLine: pip install -r requirements.txt
+    component: py
+    group:
+      isDefault: true
+      kind: build
+    workingDir: ${PROJECT_SOURCE}/hello-world-v1
+   id: pip-install-requirements-hello-world-v1
+- exec:
+    commandLine: flask run --host=0.0.0.0 --port=5000
+    component: py
+    group:
+      isDefault: true
+      kind: run
+    workingDir: ${PROJECT_SOURCE}/hello-world-v1
+  id: run-python-hello-world-v1
+- exec:
+    commandLine: pip install -r requirements.txt
+    component: py
+    group:
+      isDefault: true
+      kind: build
+    workingDir: ${PROJECT_SOURCE}/hello-world-v2
+  id: pip-install-requirements-hello-world-v2
+- exec:
+    commandLine: flask run --host=0.0.0.0 --port=5001
+    component: py
+    group:
+      isDefault: true
+      kind: run
+    workingDir: ${PROJECT_SOURCE}/hello-world-v2
+  id: run-python-hello-world-v2

docs/index.md

@@ -0,0 +1,87 @@
+# 🚀 **Module 4: Creating and Deploying Your First Serverless Function**
+
+**Technology Stack:**
+
+- Python
+- Serverless
+
+---
+
+## 🎯 **Scenario**
+
+Instead of managing servers directly, your applications can scale automatically in response to events, scaling down to zero when idle, which can improve resource efficiency and cost management. In this workspace, you will be required to quickly build an application image, upload it to the internal repository and then load balance it with Red Hat Serverless!
+
+---
+
+## 🐾 **Guided Walkthrough**
+
+1. Create a new project/namespace from the openshift ui and name it <username>-serverless
+2. From the openshift UI, start a new terminal
+  - 2.1. Type in `oc project` to see which project you have enabled
+  - 2.2. Type in `kn` to download the k-native CLI
+3. Create your first Knative service
+
+  ```sh
+  kn service create module4-helloworld \
+  --image quay.io/pknezevich/module4-dotnet-hellolang \
+  --autoscale-window 20s \
+  --env countryCode=DE
+  ```
+
+4. Verify your service has been created and you can curl/navigate to your application
+5. Tag the revision to **green**
+6. NOTE: we will update with ENV VAR but typically you would use: `kn service update <service-name> --image <new-image>`
+
+  ```sh
+  kn service update module4-helloworld \
+  --env countryCode=DE \
+  --tag module4-helloworld-00001=blue --untag green \
+  --tag @latest=green \
+  --traffic blue=100,green=0
+  ```
+
+7. Tag the blue revision to **inactive**
+8. To create a third revision:
+  - 8.1. From OC change the tag from `module4-helloworld-00002` green to blue
+  - 8.2. Create a new revision
+    - 8.2.1. ENV change (quick revision, this is usually done via an image change)
+      - 8.2.1.1. Change a **different country code**
+    - 8.2.2. Tag the **old revision to blue**
+    - 8.2.3. Do not allow any traffic to new revision until you’re ready to (traffic distribution still stays on blue)
+
+  ```sh
+  kn service update module4-helloworld \
+  --env countryCode=FR \
+  --tag module4-helloworld-00002=blue --untag green \
+  --tag @latest=green \
+  --traffic blue=100,green=0
+  ```
+
+9. Build a 3-revision load-balanced environment with 3 different country languages, distribute the traffic evenly between each (33%)
+10. Add a new image as a revision - `quay.io/pknezevich/helloworld-v2`
+
+  ```sh
+  kn service update module4-helloworld \
+    --image quay.io/pknezevich/helloworld-v2 \
+    --env countryCode=IT \
+    --tag module4-helloworld-00001=blue --untag green \
+    --tag @latest=green \
+    --traffic blue=100,green=0
+  ```
+
+---
+
+## 🧩 **Challenge**
+
+- [ ] Design your current environment - canary, blue/green, knife edge
+  - You can rename the revision tags to whatever you’d like them to be
+
+---
+
+## ✅ **Key Takeaways**
+
+- First time approach to Red Hat’s Serverless Scale-to-zero and auto-scaling 
+- Understanding Revisions and Introduced ‘image tagging’ to your container image
+- Demonstrated blue-green deployment
+- Demonstrated canary deployments (using traffic distribution)
+- Demonstrated a knife-edge cutover

hello-world-v1/Dockerfile

@@ -0,0 +1,23 @@
+# Use an official Python runtime as a parent image (we won't use the Red Hat UBI as this is a very fast test)
+FROM python:3.9-slim
+
+# Set the working directory to /projects
+WORKDIR /projects
+
+# Copy requirements.txt into the container
+COPY requirements.txt /projects/requirements.txt
+
+# Install dependencies from requirements.txt
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy the rest of the project files into the container
+COPY . /projects
+
+# Make port 5000 available to the world outside this container
+EXPOSE 5000
+
+# Define environment variable (optional, you can override this at runtime)
+ENV countryCode=EN
+
+# Run the app using uvicorn when the container launches
+CMD ["gunicorn", "--bind", "0.0.0.0:5000", "app:app"]

hello-world-v1/app.py

@@ -0,0 +1,28 @@
+from flask import Flask, request
+import os
+
+app = Flask(__name__)
+
+@app.route("/")
+def hello():
+    country = os.environ.get('countryCode')
+    if country and len(country) == 2:
+        translation = translations.get(country.upper())
+        if translation:
+            return translation
+        else:
+            return "Translation not available for this country.", 404
+    return "Hello World!"
+
+
+translations = {
+    "EN": "Hello World!",
+    "SP": "¡Hola Mundo!",
+    "FR": "Bonjour le monde!",
+    "DE": "Hallo Welt!",
+    "IT": "Ciao Mondo!",
+    "SW": "Hej världen!"
+}
+
+if __name__ == "__main__":
+    app.run(debug=True)

hello-world-v1/requirements.txt

@@ -0,0 +1,4 @@
+flask
+python-dotenv
+Flask
+gunicorn

hello-world-v2/Dockerfile

@@ -0,0 +1,23 @@
+# Use an official Python runtime as a parent image (we won't use the Red Hat UBI as this is a very fast test)
+FROM python:3.9-slim
+
+# Set the working directory to /projects
+WORKDIR /projects
+
+# Copy requirements.txt into the container
+COPY requirements.txt /projects/requirements.txt
+
+# Install dependencies from requirements.txt
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy the rest of the project files into the container
+COPY . /projects
+
+# Make port 5000 available to the world outside this container
+EXPOSE 5000
+
+# Define environment variable (optional, you can override this at runtime)
+ENV countryCode=EN
+
+# Run the app using uvicorn when the container launches
+CMD ["gunicorn", "--bind", "0.0.0.0:5000", "app:app"]