Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions .github/workflows/marp-pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -29,18 +29,24 @@ jobs:
- name: Copy images
run: mkdir build && cp -R slides/img build/img && cp -R slides/themes build/themes

- name: Marp Build (README)
uses: docker://marpteam/marp-cli:latest
- name: Marp Build (HTML)
uses: docker://marpteam/marp-cli:v4.5.0
with:
args: --theme-set slides/themes -o build/index.html --html -- slides/Slides.md
env:
MARP_USER: root:root
- name: Marp Build (PDF)
uses: docker://marpteam/marp-cli:v4.5.0
with:
args: --theme-set slides/themes -o build/Slides.pdf --html --pdf --allow-local-files -- slides/Slides.md
env:
MARP_USER: root:root
- name: Setup Pages
uses: actions/configure-pages@v6
- name: Upload artifact
uses: actions/upload-pages-artifact@v5
with:
# Upload entire repository
# Upload HTML, PDF, and slide assets
path: 'build'
- name: Deploy to GitHub Pages
id: deployment
Expand Down
38 changes: 7 additions & 31 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,15 @@
# Guardians of the Container Galaxy: Defending the Cosmic Cluster

This repository contains a pragmatic container security framework mapped onto a memorable "Guardians of the Galaxy" crew metaphor. Each character archetype represents a critical defensive layer—supply chain integrity, runtime behavioral detection, zero‑trust networking, and observability—to help teams remember and implement comprehensive container security practices.
Learn layered container security through a "Guardians of the Galaxy" crew metaphor, covering policy guardrails, supply chain integrity, image hardening, runtime detection, zero-trust networking, and observability.

## Slides

Slides can be found at [chris-ayers.com/container-security](https://chris-ayers.com/container-security)

## Cluster Setup

All six demos run on a single local Kubernetes cluster. For NetworkPolicy
enforcement (demo 5) use **kind + Calico** via
[`scripts/setup-kind-cluster.sh`](scripts/setup-kind-cluster.sh) (or
[`scripts/setup-kind-cluster.ps1`](scripts/setup-kind-cluster.ps1) on Windows),
and tear everything down with
[`scripts/teardown-kind-cluster.sh`](scripts/teardown-kind-cluster.sh) (or
`.ps1`) when finished. See **[docs/CLUSTER-SETUP.md](docs/CLUSTER-SETUP.md)** for
the lifecycle, prerequisites, the "which cluster should I use?" decision guide,
and the quickstart.

## Demos

Hands-on walkthroughs live under `demos/` for each Guardian archetype:

1. [demos/1-policy-guardrails/](demos/1-policy-guardrails/) – **Star-Lord**: Kyverno admission policy guardrails (non-root + simulated signed-image validation)
2. [demos/2-supply-chain-trust/](demos/2-supply-chain-trust/) – **Gamora**: SBOM, scanning, signing pipeline
3. [demos/3-image-hardening/](demos/3-image-hardening/) – **Rocket**: Dockerfile before/after with Trivy diff
4. [demos/4-runtime-detection/](demos/4-runtime-detection/) – **Drax**: Falco custom rule + controlled trigger
5. [demos/5-zero-trust-networking/](demos/5-zero-trust-networking/) – **Groot**: Deny-by-default NetworkPolicies
6. [demos/6-observability-signals/](demos/6-observability-signals/) – **Mantis**: OTEL telemetry + Falco alert correlation
[View HTML slides](https://chris-ayers.com/container-security/) | [Download PDF](https://chris-ayers.com/container-security/Slides.pdf)

## Resources

- [Slide source](slides/Slides.md)
- [Cluster setup and demo guide](docs/CLUSTER-SETUP.md) - prerequisites, shared cluster lifecycle, and all six hands-on walkthroughs
- [Falco](https://falco.org)
- [Trivy](https://aquasecurity.github.io/trivy/)
- [Cosign](https://github.com/sigstore/cosign)
Expand All @@ -42,14 +21,11 @@ Hands-on walkthroughs live under `demos/` for each Guardian archetype:
- [OPA Gatekeeper](https://open-policy-agent.github.io/gatekeeper/)
- [CNCF Cloud Native Security Whitepaper](https://www.cncf.io/projects/security/)

## Connect with Chris Ayers
## Contact

Feel free to connect with Chris Ayers on social media and visit his blog for more insights on DevOps, Azure, and container security.
**Chris Ayers**, Principal Software Engineer

- Mastodon: [@Chrisayers@hachyderm.io](https://hachyderm.io/@Chrisayers)
- LinkedIn: [chris-l-ayers](https://linkedin.com/in/chris-l-ayers/)
- Blog: [chris-ayers.com](https://chris-ayers.com/)
- GitHub: [Codebytes](https://github.com/codebytes)
[Blog](https://chris-ayers.com/) | [GitHub](https://github.com/codebytes) | [LinkedIn](https://linkedin.com/in/chris-l-ayers/) | [Bluesky](https://bsky.app/profile/chris-ayers.com) | [Mastodon](https://hachyderm.io/@Chrisayers)

---

Expand Down
21 changes: 21 additions & 0 deletions docs/CLUSTER-SETUP.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,27 @@ container-security demos — including demo 5 (zero-trust networking), which onl

---

## Demos

Hands-on walkthroughs live under `demos/` for each Guardian archetype:

1. [demos/1-policy-guardrails/](../demos/1-policy-guardrails/) – **Star-Lord**: Kyverno admission policy guardrails (non-root + simulated signed-image validation)
2. [demos/2-supply-chain-trust/](../demos/2-supply-chain-trust/) – **Gamora**: SBOM, scanning, signing pipeline
3. [demos/3-image-hardening/](../demos/3-image-hardening/) – **Rocket**: Dockerfile before/after with Trivy diff
4. [demos/4-runtime-detection/](../demos/4-runtime-detection/) – **Drax**: Falco custom rule + controlled trigger
5. [demos/5-zero-trust-networking/](../demos/5-zero-trust-networking/) – **Groot**: Deny-by-default NetworkPolicies
6. [demos/6-observability-signals/](../demos/6-observability-signals/) – **Mantis**: OTEL telemetry + Falco alert correlation

For NetworkPolicy enforcement (demo 5), use **kind + Calico** via
[`scripts/setup-kind-cluster.sh`](../scripts/setup-kind-cluster.sh) (or
[`scripts/setup-kind-cluster.ps1`](../scripts/setup-kind-cluster.ps1) on Windows).
When finished, tear down with
[`scripts/teardown-kind-cluster.sh`](../scripts/teardown-kind-cluster.sh) (or
[`scripts/teardown-kind-cluster.ps1`](../scripts/teardown-kind-cluster.ps1)).
The sections below cover the lifecycle, prerequisites, cluster choice, and quickstart.

---

## Lifecycle: set up once, tear down when finished

The whole talk uses **one shared cluster** as the single source of truth.
Expand Down
2 changes: 1 addition & 1 deletion slides/Slides.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
marp: true
theme: custom-default
paginate: true
footer: 'chris-ayers.com | @Chris_L_Ayers'
footer: '[chris-ayers.com](https://chris-ayers.com/) | [Bluesky](https://bsky.app/profile/chris-ayers.com)'
description: 'A layered, CNCF-based walkthrough of pragmatic container security.'
---

Expand Down
Loading