Skip to content

About

🦸 A hands-on playground for learning and experimenting with GitHub Actions.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🌐 English Β· Ψ§Ω„ΨΉΨ±Ψ¨ΩŠΨ©

🦸 Action Hero

GitHub Actions Status License


🎯 About This Project

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.

🧭 Learning Path

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

πŸ§ͺ The Curriculum

# 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


🧩 Local Actions

Reusable building blocks under .github/actions/:

  • setup-pnpm β€” composite: pnpm + Node + frozen-lockfile install in one line
  • deploy-firebase-hosting β€” composite: write SA credentials & deploy to Firebase Hosting
  • hello-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.


πŸ—‚οΈ Project Structure

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

πŸ“š Progress

🌱 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

🀝 Contributing

This is a personal learning repo, but suggestions are welcome β€” feel free to open an issue.


πŸ“„ License

MIT Β© Abdullah Abdulkhaleq

About

🦸 A hands-on playground for learning and experimenting with GitHub Actions.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages