π English Β· Ψ§ΩΨΉΨ±Ψ¨ΩΨ©
Action Hero is my personal sandbox for mastering GitHub Actions.
Each stage lives twice: a runnable workflow in .github/workflows/NN-*.yml
and a lesson in docs/NN-*.md (Arabic: docs/NN-*.ar.md).
Note
π§ This project is a work in progress. Some links in the tables below (lessons, workflow files, or actions) may not work yet or may show a 404, because those files haven't been written or pushed yet. They will start working as each stage is completed, and the Progress checklist is ticked off stage by stage.
Go in order β every stage builds on the previous one.
| Level | Stages | What you get |
|---|---|---|
| Foundations | 01β03 | Read and write a workflow, trigger it, use contexts |
| Core CI | 04β08 | Test, branch logic, secure, share data, control runs |
| Delivery | 09β13 | Reuse code, deploy, preview, gate with approvals |
| Production | 14β15 | Keyless cloud auth (OIDC), releases, custom actions |
| # | Stage | Workflow | Lesson | Key Concepts |
|---|---|---|---|---|
| 01 | Anatomy | 01-hello.yml |
01-anatomy | on Β· jobs Β· steps Β· run |
| 02 | Triggers | 02-triggers.yml |
02-triggers | push Β· schedule Β· dispatch Β· paths |
| 03 | Contexts & Expressions | 03-contexts.yml |
03-contexts | github.* Β· ${{ }} Β· functions |
| 04 | CI Β· Matrix Β· Cache | 04-ci.yml |
04-ci-matrix-cache | matrix Β· needs Β· cache |
| 05 | Conditionals & Outputs | 05-conditionals.yml |
05-conditionals-outputs | if Β· always() Β· GITHUB_OUTPUT |
| 06 | Secrets Β· Vars Β· Perms | 06-secrets.yml |
06-secrets-vars-permissions | secrets Β· vars Β· permissions |
| 07 | Artifacts | 07-artifacts.yml |
07-artifacts | upload/download Β· retention |
| 08 | Concurrency & Timeouts | 08-concurrency.yml |
08-concurrency-timeouts | concurrency Β· timeout-minutes |
| 09 | Composite Actions | 09-composite.yml |
09-composite-actions | runs.using: composite |
| 10 | Deploy (live) | 10-deploy.yml |
10-deploy | Firebase Hosting Β· live deploy |
| 11 | Previews | 11-preview.yml |
11-previews | channels Β· expires |
| 12 | Reusable Workflows | 12-reusable.yml |
12-reusable-workflows | workflow_call Β· secrets: inherit |
| 13 | Environments | 13-environments.yml |
13-environments | required reviewers Β· env secrets |
| 14 | OIDC | 14-oidc.yml |
14-oidc | id-token: write Β· WIF |
| 15 | Release & Docker | 15-release.yml |
15-release-custom-actions | tags Β· GHCR Β· Docker Β· custom actions |
π New term?
00-glossary.mdπ€ Stuck on an error? mistakes log
Reusable building blocks under .github/actions/:
setup-pnpmβ composite: pnpm + Node + frozen-lockfile install in one linedeploy-firebase-hostingβ composite: write SA credentials & deploy to Firebase Hostinghello-customβ custom: a JavaScript/Docker action (stage 15)
π‘ Composite action vs reusable workflow? A composite action bundles steps (used inside a job). A reusable workflow bundles whole jobs (called with
uses:at the job level). See 09 and 12.
action-hero/
βββ .github/
β βββ actions/ # composite & custom actions
β β βββ setup-pnpm/
β β βββ deploy-firebase-hosting/
β β βββ hello-custom/ # stage 15 (JS action)
β βββ workflows/ # one numbered workflow per lesson (01 β 15)
β β βββ 01-hello.yml
β β βββ 02-triggers.yml
β β βββ 03-contexts.yml
β β βββ 04-ci.yml
β β βββ 05-conditionals.yml
β β βββ 06-secrets.yml
β β βββ 07-artifacts.yml
β β βββ 08-concurrency.yml
β β βββ 09-composite.yml
β β βββ 10-deploy.yml
β β βββ 11-preview.yml
β β βββ 12-reusable.yml
β β βββ 12-reusable-called.yml
β β βββ 13-environments.yml
β β βββ 14-oidc.yml
β β βββ 15-release.yml
β βββ dependabot.yml # keeps action versions up to date
βββ docs/ # lessons (NN-*.md + NN-*.ar.md), glossary, mistakes log
β βββ 00-glossary.md / .ar.md
β βββ 01-anatomy.md / .ar.md
β βββ 02-triggers.md / .ar.md
β βββ 03-contexts.md / .ar.md
β βββ 04-ci-matrix-cache.md / .ar.md
β βββ 05-conditionals-outputs.md / .ar.md
β βββ 06-secrets-vars-permissions.md / .ar.md
β βββ 07-artifacts.md / .ar.md
β βββ 08-concurrency-timeouts.md / .ar.md
β βββ 09-composite-actions.md / .ar.md
β βββ 10-deploy.md / .ar.md
β βββ 11-previews.md / .ar.md
β βββ 12-reusable-workflows.md / .ar.md
β βββ 13-environments.md / .ar.md
β βββ 14-oidc.md / .ar.md
β βββ 15-release-custom-actions.md / .ar.md
β βββ README.md / README.ar.md # β you are here
β βββ mistakes-log.md / .ar.md
βββ src/ # NestJS app β the "real project" CI runs against
βββ test/ # e2e specs
βββ vitest.config.ts
βββ vitest.config.e2e.ts
π± Foundations
- 01 β Anatomy:
on,jobs,steps - 02 β Triggers: push, PR, schedule, manual dispatch,
paths - 03 β Contexts & expressions
π οΈ Core CI
- 04 β CI: matrix (
include),needs, caching - 05 β Conditionals & job outputs
- 06 β Secrets, variables & least-privilege permissions
- 07 β Artifacts between jobs
- 08 β Concurrency & timeouts
π Delivery
- 09 β Composite actions
- 10 β Deploying to Firebase Hosting
- 11 β PR preview channels
- 12 β Reusable workflows
- 13 β Environments with manual approvals
π Production
- 14 β OIDC: keyless authentication to Google Cloud
- 15 β Release & Docker
This is a personal learning repo, but suggestions are welcome β feel free to open an issue.
MIT Β© Abdullah Abdulkhaleq