A self-service platform that provisions Azure infrastructure for containerised
web applications, driven by GitHub Actions and Terraform. External systems
trigger the platform through repository_dispatch or workflow_dispatch
events; the platform takes care of standing up secure, observable,
production-grade environments without the requesting team having to write any
infrastructure code.
Status: functional end-to-end. Plan → apply → verify, application repo creation from template, GitHub Environments + variables, OIDC federated credentials, CI observation and per-run tracking issue are all wired.
The full documentation — overview, architecture, setup guide, conventions,
roadmap, and a self-service provisioning form — is published as a GitHub
Pages site rendered from docs/:
➜ https://deors.github.io/workshop-platform-eng/
(Replace the URL above with your fork's Pages URL if you've cloned the repo.
The site activates once Pages is enabled on the repository — see
docs/pages.md.)
| What you're looking for | Where |
|---|---|
| What the platform provisions, architecture, roadmap | docs/index.md (Pages home) |
Setup for GitHub: repository, Environments, GH_PAT — do this first, whatever the cloud |
docs/setup-github.md |
| Setup for Azure: App Registration, RBAC, federated credentials, state storage | docs/setup-azure.md |
| How the Pages site is built and how to enable it | docs/pages.md |
| Self-service provisioning (pick a cloud, one-click trigger) | docs/provision.html — best viewed on the Pages site |
| Contribution guidelines, coding standards, PR checklist | CONTRIBUTING.md |
MIT — see the license file for details.