Red Hat Advanced Developer Suite Workshop

This workshop provides hands-on experience with Red Hat Advanced Developer Suite (RHADS), focusing on modern software delivery practices that accelerate secure application development and deployment.

Workshop Overview

Target Audience: Developers and DevOps professionals looking to experience modern secure software delivery

Learning Style: Personal narrative journey where learners become the protagonist solving real business challenges

Business Context: You’re a new developer at ACME Retail facing a Black Friday deadline crisis - learn how RHADS transforms traditional 10-week delivery cycles into 4-week successes

Key Technologies: Red Hat Developer Hub, OpenShift Pipelines (Tekton), Jenkins, GitLab, Quay, Advanced Cluster Security, Trusted Artifact Signer

Workshop Features

1. Dual Learning Paths: Choose between OpenShift Pipelines (Tekton) or Jenkins implementation approaches

2. Personal Narrative Style: Based on the successful storytelling approach from showroom-lb1696-jenkins-rhtap

3. Hands-on Activities: Real development experience with modern security-integrated workflows

4. Progressive Learning: From setup through production deployment with built-in security

5. Self-Service Focus: Experience how RHADS eliminates traditional platform team bottlenecks

Getting Started

Using Containers (Recommended)

In order to test and develop on your local machine, you can use a specially built container with Podman or Docker as follows.

1. Create a git repo from this template

   1. Suggested naming: showroom_<lab-name>

2. Clone your new repo and cd into it

3. When you make changes to the content, all you need is to kill the container and run it again.

   podman run --rm --name antora -v $PWD:/antora -p 8080:8080 -i -t ghcr.io/juliaaano/antora-viewer

For SELinux environments, :z may need to be appended to the volume mount:

podman run --rm --name antora -v $PWD:/antora:z -p 8080:8080 -i -t ghcr.io/juliaaano/antora-viewer

Live-reload is not supported.

Using Local Files (Less Recommended)

1. Create a git repo from this template

2. Clone the repo and cd into it

3. Run ./utilities/lab-serve

4. Open http://localhost:8080 in your browser

5. Run ./utilities/lab-build to build your html

To rebuild your html, run ./utilities/lab-build.

Workshop Learning Paths

The workshop offers two distinct paths that demonstrate different approaches to implementing RHADS:

🚀 OpenShift Pipelines (Tekton) Path

Perfect for teams embracing modern Kubernetes-native development practices

• tekton-intro.adoc - Introduction to OpenShift Pipelines development challenges

• tekton-dev.adoc - Development phase with self-service app creation

• tekton-stage.adoc - Staging environment promotion and testing

• tekton-prod.adoc - Production deployment with GitOps

• tekton-finish.adoc - Summary and next steps

🔧 Jenkins Pipeline Path

Ideal for organizations with existing enterprise tooling investments

• jenkins-intro.adoc - Introduction to enhanced Jenkins development

• jenkins-dev.adoc - Development phase with enhanced Jenkins integration

• jenkins-stage.adoc - Staging environment with enterprise workflows

• jenkins-prod.adoc - Production deployment maintaining enterprise patterns

• jenkins-finish.adoc - Summary and enterprise transformation insights

Workshop Directory Structure

./content/modules/ROOT/
├── assets
│   └── images                       # Workshop screenshots and diagrams
│       ├── 3_Authorize.png          # Authentication flow
│       ├── 4_RHDH_Landing_Page.png  # Developer Hub welcome
│       ├── 90_Gitsign_Commit_Message.png # Commit signing process
│       └── 93_Gitsign_Commit_Signed.png  # Successful signed commit
├── nav.adoc                         # Workshop navigation structure
└── pages                            # Workshop content
    ├── index.adoc                   # Workshop overview and introduction
    ├── lab-access.adoc              # Lab access credentials and environment info
    ├── introduction.adoc            # ACME story and personal narrative setup
    ├── tekton-intro.adoc            # OpenShift Pipelines path introduction
    ├── tekton-dev.adoc              # OpenShift Pipelines development activities
    ├── tekton-stage.adoc            # OpenShift Pipelines staging workflow
    ├── tekton-prod.adoc             # OpenShift Pipelines production deployment
    ├── tekton-finish.adoc           # OpenShift Pipelines path summary
    ├── jenkins-intro.adoc           # Enterprise path introduction
    ├── jenkins-dev.adoc             # Enterprise development activities
    ├── jenkins-stage.adoc           # Enterprise staging workflow
    ├── jenkins-prod.adoc            # Enterprise production deployment
    ├── jenkins-finish.adoc          # Enterprise path summary
    └── glossary.adoc                # Key terminology and definitions

Personal Narrative Approach

This workshop follows the engaging storytelling style pioneered in showroom-lb1696-jenkins-rhtap:

You as the Protagonist: Learners become a new developer at ACME Retail facing real business challenges

Emotional Investment: Personal stakes in solving the Black Friday deadline crisis

Progressive Empowerment: Journey from frustration with traditional processes to confidence with RHADS

Hands-on Discovery: Learning through doing rather than just reading about concepts

Narrative Elements

• Personal challenges: "You’ve been dealing with 1-2 weeks of Jenkins setup tickets…​"

• Emotional reactions: "Finally!" you think, "A template that includes security built-in"

• Internal thoughts: "This is going to change everything," you think to yourself

• Achievement moments: "You feel a sense of accomplishment" with successful signed commits

• Progressive discovery: From "Your Current Reality" to "Your New Reality with RHADS"

Workshop Flow

1. Introduction - Meet your new role at ACME and the Black Friday challenge

2. Path Selection - Choose between OpenShift Pipelines (Tekton) or Jenkins approach

3. Development Phase - Create your first secure application with self-service templates

4. Staging Phase - Experience automated promotion and testing workflows

5. Production Phase - Deploy with confidence using GitOps and integrated security

6. Reflection - Understand the transformation you’ve experienced

Technical Implementation

The workshop demonstrates key RHADS capabilities:

• Self-Service Development - Red Hat Developer Hub templates eliminate platform team bottlenecks

• Integrated Security - Automatic vulnerability scanning, image signing, and policy enforcement

• GitOps Deployment - Automated, auditable deployments across environments

• Developer Experience - Browser-based development with OpenShift Dev Spaces

• Pipeline Automation - Both OpenShift Pipelines (Tekton) and Jenkins implementations

• Compliance - Built-in audit trails and governance without developer friction

Contributing

When editing workshop content:

1. Use the personal narrative voice ("You" rather than "The user")

2. Include emotional context and reactions

3. Focus on the learner’s journey and transformation

4. Maintain technical accuracy while emphasizing the human experience

5. Use screenshots and images to support the narrative flow

Development Setup

Using Containers (Recommended)

podman run --rm --name antora -v $PWD:/antora -p 8080:8080 -i -t ghcr.io/juliaaano/antora-viewer

For SELinux environments:

podman run --rm --name antora -v $PWD:/antora:z -p 8080:8080 -i -t ghcr.io/juliaaano/antora-viewer

Using Local Files

1. Run ./utilities/lab-serve

2. Open http://localhost:8080 in your browser

3. Run ./utilities/lab-build to build your html