Skip to content

docs: add Module 11 Jenkins architecture, pipelines and production operations - #11

Merged
EdwinPhilip merged 15 commits into
mainfrom
docs/add-jenkins-architecture-operations-module
Oct 25, 2026
Merged

EdwinPhilip merged 15 commits into
mainfrom
docs/add-jenkins-architecture-operations-module

Conversation

@EdwinPhilip

Copy link
Copy Markdown
Owner

Module 11: Jenkins Architecture, Pipelines & Production Operations

Publish a complete, general-purpose, senior-level Jenkins engineering module consistent with the public VitePress knowledge base. All examples use fictional services and infrastructure.

Chapters (10)

  1. Controller, nodes, agents, executors, queue, CPS and end-to-end scheduling
  2. Declarative/Scripted Pipelines, Groovy CPS, durable stages, parallelism and artifacts
  3. Multibranch SCM, webhook/indexing, trusted Jenkinsfiles and untrusted PRs
  4. Ephemeral Kubernetes agents, Pod provisioning, workspaces and capacity planning
  5. Docker/BuildKit, dependency caching, artifact identities and multi-architecture builds
  6. Shared Libraries, vars/src, version pinning, trusted versus sandboxed code
  7. Jenkins security, credentials binding, Groovy interpolation, CSRF and agent trust
  8. Controller lifecycle: JCasC, JENKINS_HOME, backup, upgrades and tested restores
  9. Production troubleshooting: queue, 502s, JVM/GC, CPS exceptions, disk and network
  10. Jenkins CI as a platform: golden paths, GitOps handoff, SLOs and governance

Complete practice materials

  • 47 advanced technical FAQs with full model answers, not condensed prompts.
  • 8 hands-on labs/tabletop drills, each with safety boundaries and expected evidence.
  • 15 native Mermaid flow/sequence diagrams using the existing renderer.
  • Configurations and runnable-style Jenkinsfile, Groovy, Bash, Dockerfile, Kubernetes and JCasC examples.
  • Scenario-based failure analysis, trade-offs and spoken technical explanations.
  • Authoritative Jenkins and plugin documentation linked from chapters.

Site changes

Created docs/guides/jenkins/index.md, q1.md through q10.md, follow-ups.md and labs.md (13 files). Updated only docs/.vitepress/config.mts and docs/guides/index.md (2 files). Preserved site base /, Mermaid setup, previous modules, theme, homepage, About and deployment workflow. No additional runtime dependencies or workflow permission changes.

Validation

  • Confirmed 10 complete chapter files, FAQ count 47 and 15 Mermaid source diagrams.
  • Checked balanced Markdown fences, relative guide links, public-documentation disallowed terms and question heading conventions; no issues found.
  • Actual npm install, npm run docs:audit and npm run docs:build results: pending GitHub Actions PR validation, not assumed passed.
  • Browser-level diagram visual verification not separately performed.
  • Examples are intentionally educational and plugin/version dependent.

Expected URL after merge and successful Pages deployment

https://edwinphilip.github.io/guides/jenkins/

Please review and merge manually. Do not auto-merge.

@EdwinPhilip
EdwinPhilip merged commit 282d77b into main Oct 25, 2026
1 check passed
@EdwinPhilip
EdwinPhilip deleted the docs/add-jenkins-architecture-operations-module branch October 25, 2026 15:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant