lession01

Author: nferc

README.md

@@ -0,0 +1,55 @@
+# Microservices in Python
+
+## [Lession 1](docs/lession1.md) - Preparation
+  - Install Tools
+  - Create Project
+  - VS Code Finetuning
+
+## [Lession 2](docs/lession2.md) - Get into Kubernetes
+  - Dockerize
+  - Logging
+  - Tilt & Debugging
+
+## [Lession 3](docs/lession3.md) - REST Service
+  - Model
+  - Database Connection
+  - Router
+  - Database Schema
+  - Health Check
+
+## [Lession 4](docs/lession4.md) - Unit Testing
+  - Dependency Injection
+  - Unit Testing
+
+## [Lession 5](docs/lession5.md) - Relation on Entities
+  - Releations
+  - Functional Validators
+  - Booking API
+
+## [Lession 6](docs/lession6.md) - Model Details
+  - Nested Models
+  - Separate Model for Creation
+  - Working with Entities
+
+## [Lession 7](docs/lession7.md) - Message Queue - Produce
+  - Feeding the Message Queue
+  - Broker
+  - Producer
+
+## [Lession 8](docs/lession8.md) - 2nd Microservice
+  - Next Microservice
+
+## [Lession 9](docs/lession9.md) - Message Queue - Receive
+  - Receiving Messages
+
+## [Lession 10](docs/lession10.md) - Monitoring
+  - Monitoring Prometheus
+
+## [Lession 11](docs/lession11.md) - Tracing
+  - Tracing with OpenTelemetry
+  - Instrumentation
+  - Collector
+  - Spans, Attributes, Events
+
+## [Lession 12](docs/lession12.md) - Load Testing
+  - Basic Load Testing

dispo/.gitignore

@@ -0,0 +1,2 @@
+__pycache__/
+.venv/

dispo/.vscode/launch.json

@@ -0,0 +1,19 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Python Debugger: FastAPI",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "uvicorn",
+      "args": [
+        "main:app",
+        "--reload"
+      ],
+      "jinja": true
+    }
+  ]
+}

dispo/README.md

@@ -0,0 +1,8 @@
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def hello_world():
+    return {"message": "hello world"}

dispo/main.py

@@ -0,0 +1,16 @@
+[tool.poetry]
+name = "dispo"
+version = "0.1.0"
+description = ""
+authors = ["Your Name <you@example.com>"]
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.12"
+fastapi = "^0.109.2"
+uvicorn = {extras = ["standart"], version = "^0.27.0.post1"}
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

dispo/poetry.lock

@@ -0,0 +1,130 @@
+### Lesson 1
+
+- Install Tools
+- Create Project
+- VS Code Finetuning
+  - Code Formatting
+  - Linting
+  - Debugging
+
+
+# Install Tools
+
+- Python 3.9 or later \
+My suggestion ist to use the latest version posibile.
+- [Visual Studio Code](https://code.visualstudio.com/)
+  - Plugins:
+    - Python (with Pylance & Debugger)
+    - Black Formatter
+    - Flake8
+    - isort
+  - Optional Plugins:
+    - YAML
+    - Tiltfile
+    - Kubernetes
+    - Docker
+    - Markdown Preview
+    - Jupyter
+
+- [Poetry](https://python-poetry.org/) \
+  using pip (outside virtualenv), pipx or brew (macos)
+
+- [Tilt.dev](https://tilt.dev/)
+
+# Create Project
+
+```sh
+mkdir dispo
+poetry init
+# do not define dependencies
+
+```
+See result in `pyproject.toml` file.
+
+# Create WebServer
+
+`poetry add fastapi "uvicorn[standart]"`
+
+With `poetry add` the package will also be installed. Use `poetry install` if the dependencies are already declared.
+
+You must create an README.md file, otherwise poetry install will fail.
+
+Let's start with our first code snippet:
+
+```python
+#dispo/main.py
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def hello_world():
+    return {"message": "hello world"}
+
+```
+To start the app:
+```sh
+poetry shell
+uvicorn main:app
+```
+
+Check `http://localhost:8000`
+
+Swagger/OpenApi is already included, see `http://localhost:8000/docs`.
+
+
+# VS Code Finetuning
+
+## Virtual Environment
+Virtual Environments will be recognized when activated at startup. If you prefer the the .venv inside the project directory, do `poetry config virtualenvs.in-project true`.
+
+## Code Formatting
+
+We do use Black as formatter and isort for sorted import statements.
+
+```json
+# >Preferences, Open User Settings(Json)
+# settings.json - add following:
+    "[python]": {
+        "editor.defaultFormatter": "ms-python.black-formatter",
+        "editor.formatOnSave": true,
+        "editor.codeActionsOnSave": {
+            "source.organizeImports": "explicit"
+        },
+    },
+    "isort.args":["--profile", "black"],
+```
+
+To fix issues with black vs isort, add this
+
+```toml
+# pyproject.toml
+[tool.isort]
+profile = "black"
+```
+
+## Linting
+
+Is done by flake8. I do suggest to use the vs-code plugin for this. The following config will fix the usage with Black. This config could NOT be included in pyproject.toml.
+
+```toml
+# .flake8
+[flake8]
+max-line-length = 88
+extend-ignore = E203
+```
+
+If you will now add a not needed import like `import os` then you should notice:
+
+- Sorting the import statements on save
+- A new Issue on Problems View
+
+## Debugging
+
+Go to Run&Debug, get to `create a launch.json` - `Python Debugger` - `FastAPI` - defaults should be ok.
+
+- start the app
+- set a breakpoint
+- check it
+

dispo/pyproject.toml

@@ -0,0 +1,116 @@
+### Lession 10
+
+# Monitoring
+
+This is optional step as Prometheus is also included in OpenTelementry, which we will do next.
+
+In this example we will only instrument FastApi. There is also an instrumention solution for Celery.
+
+## Add dependencies
+
+```bash
+poetry add prometheus_fastapi_instrumentator
+
+```
+
+
+## Add Instrumentation
+
+```python
+# dispo/dispo/main.py - add
+from prometheus_fastapi_instrumentator import Instrumentator as PrometheusInstrumentator
+
+# add beyond app creation
+prom_instrumentator = PrometheusInstrumentator().instrument(app)
+prom_instrumentator.expose(app)
+
+```
+
+## Add Collector
+
+
+```docker
+# prometheus/Dockerfile
+FROM prom/prometheus
+ADD prometheus.yml /etc/prometheus/
+
+```
+
+```yaml
+global:
+  scrape_interval: "15s"
+scrape_configs:
+  - job_name: 'dispo'
+    static_configs:
+    - targets: ['dispo:80']
+
+```
+
+```yaml
+# deploy/prometheus.yaml
+
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: prometheus
+  labels:
+    app: prometheus
+spec:
+  selector:
+    matchLabels:
+      app: prometheus
+  template:
+    metadata:
+      labels:
+        app: prometheus
+    spec:
+      containers:
+        - name: prometheus
+          image: myprometheus
+          ports:
+            - containerPort: 9090
+          resources:
+            limits:
+              memory: 256Mi
+              cpu: 400m
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: prometheus
+spec:
+  selector:
+    app: prometheus
+  ports:
+    - protocol: TCP
+      port: 9090
+      targetPort: 9090
+```
+
+```python
+# Tiltfile - add
+docker_build(
+    'myprometheus',
+    context='./myprometheus',
+    dockerfile='./myprometheus/Dockerfile'
+)
+
+k8s_yaml('deploy/prometheus.yaml')
+
+k8s_resource(
+    'prometheus',
+    port_forwards=['9090:9090']
+)
+
+```
+
+
+
+## Testing
+
+```bash
+curl http://localhost:8080/metrics
+
+```
+
+Prometheus: http://localhost:9090