https://github.com/hjosugi/learning-platform-engineering
Platform engineering learning repo for CI/CD, security, observability, WebTransport, and operations
https://github.com/hjosugi/learning-platform-engineering
devops github-actions learning opentelemetry security webtransport
Last synced: 3 days ago
JSON representation
Platform engineering learning repo for CI/CD, security, observability, WebTransport, and operations
- Host: GitHub
- URL: https://github.com/hjosugi/learning-platform-engineering
- Owner: hjosugi
- Created: 2026-06-20T12:22:25.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-20T12:48:57.000Z (about 1 month ago)
- Last Synced: 2026-06-20T14:34:19.867Z (about 1 month ago)
- Topics: devops, github-actions, learning, opentelemetry, security, webtransport
- Size: 6.84 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Learning Platform Engineering
CI/CD, containers, Kubernetes, NGINX, observability, security, release, and operational engineering for the learning repositories.
Last verified: 2026-06-21
## Development Environment
If Python, Node.js, or NGINX are missing locally, enter the Nix shell:
```bash
nix develop
```
## Runnable Starter Project
Run a tiny observable service before adding Docker, Kubernetes, NGINX, or OpenTelemetry:
```bash
python3 projects/healthcheck-observability/server.py --demo
python3 projects/healthcheck-observability/test_server.py
```
## Target Hands-On Projects
Network protocol foundations:
```bash
python3 projects/network-protocol-lab/protocol.py
python3 projects/network-protocol-lab/test_protocol.py
```
NGINX:
```bash
python3 projects/nginx-reverse-proxy/check_config.py
```
GitHub Actions:
```bash
python3 projects/github-actions-ci/check_workflow.py
```
Realtime networking:
```bash
node projects/realtime-transport-fallback/transport.test.mjs
node projects/p2p-udp-gossip/peer.test.mjs
```
These are real config files kept under `projects/` so they can be copied into active apps when ready.
To run the local HTTP service:
```bash
python3 projects/healthcheck-observability/server.py
```
## Why This Repo Exists
Frontend, backend, and AI examples all need the same platform skills:
- CI that catches breakage
- repeatable local environments
- safe secret handling
- dependency and supply-chain hygiene
- observable services
- real-time networking experiments
- TCP/UDP/HTTP protocol fundamentals
- reverse proxy and edge-routing basics
- simple deployment notes
- runbooks for failures
This repo keeps those cross-cutting skills out of app-specific repos.
## How To Use This Repo
Use this as the operations notebook for the other learning repositories. A good study loop is:
1. pick one small application from another repo
2. add CI so build/test/check is repeatable
3. put a local service or reverse proxy in front of it
4. add logs, metrics, traces, and health checks
5. write the release, rollback, and failure notes
The point is not to build a production platform. The point is to understand the smallest useful operational layer around an application.
## Learning Path
1. GitHub Actions CI
2. Docker and Compose
3. Kubernetes concepts
4. Network foundations: TCP framing, UDP loss, HTTP idempotency, timeouts
5. NGINX reverse proxy, static files, TLS, load balancing, WebSocket proxying
6. OpenTelemetry traces, metrics, logs
7. Real-time networking: SSE, WebSocket, and WebTransport
8. OWASP Top 10 and secure coding basics
9. dependency security and SBOM basics
10. release and rollback checklist
11. runbooks and incident notes
## Planned Structure
```text
examples/
github-actions/
docker-compose-postgres/
kubernetes-basic-web-api/
nginx-reverse-proxy/
realtime/
docs/
2026-learning-items.md
networking-foundations.md
nginx-reverse-proxy.md
realtime-networking.md
repository-profile.md
security-checklist.md
release-checklist.md
runbook-template.md
```
## What Belongs Here
- CI/CD workflow templates
- Docker, Compose, and Kubernetes learning examples
- TCP/UDP/HTTP protocol drills
- NGINX and reverse proxy notes
- OpenTelemetry and logging/metrics/traces notes
- release checklists, runbooks, and operational templates
- defensive security checklist items that apply to every repo
## What Belongs Elsewhere
- P2P, WebRTC, and libp2p protocol mechanics belong here under realtime networking notes
- ethical hacking labs belong in `learning-security-labs`
- app-specific framework code belongs in frontend/backend/AI repos
- Bazel and Nix experiments belong in `learning-build-systems`
## Repository Profile
See [docs/repository-profile.md](docs/repository-profile.md) for GitHub description, topics, public safety notes, and first milestones.
## License
0BSD. You can use, copy, modify, and distribute this project for almost any purpose.