AgnosticD v2 Skill

Source Repository: agnosticd/agnosticd-v2

Overview

AgnosticD v2 is the Ansible Agnostic Deployer — a framework for provisioning infrastructure and deploying workloads on AWS, Azure, OpenStack, and OpenShift. This skill teaches your AI assistant how to use the agd CLI, configure deployments, and follow AgnosticD best practices.

When the AI Uses This Skill

Your AI assistant will activate this skill when you’re:

  • Setting up the AgnosticD v2 local development environment
  • Running agd commands (setup, provision, destroy, stop, start, status)
  • Creating or modifying configs and workloads
  • Configuring secrets files or account credentials
  • Setting up a fork for workshop development
  • Deploying Field-Sourced Content or Showroom as workloads
  • Debugging deployment failures
  • Generating independent deploy.sh / teardown.sh scripts for your project
  • Provisioning multiple student environments (multi-student loop with parallel option)
  • Setting up a hub+student RHACM topology and scaffolding the ocp4_workload_rhacm_import role

Key Concepts

The agd CLI

All operations use ./bin/agd from within the agnosticd-v2 directory:

./bin/agd setup                                            # one-time setup
./bin/agd provision -g myguid -c my-config -a my-account   # deploy
./bin/agd destroy -g myguid -c my-config -a my-account     # teardown

Directory Structure

AgnosticD v2 requires sibling directories (created by agd setup):

agnosticd-v2/             # code repository
agnosticd-v2-vars/        # configuration variables
agnosticd-v2-secrets/     # secrets (never committed)
agnosticd-v2-output/      # ansible run output
agnosticd-v2-virtualenv/  # Python venv with ansible-navigator

Fork Workflow

Users developing workshops should fork agnosticd-v2 to their own GitHub org. Custom configs and workloads live in the fork; only generic improvements (bug fixes, core features) should be submitted as PRs to upstream.

git clone https://github.com/your-org/agnosticd-v2.git
cd agnosticd-v2
git remote add upstream https://github.com/agnosticd/agnosticd-v2.git

Workshop-specific variables go in agnosticd-v2-vars/ and secrets in agnosticd-v2-secrets/ – both outside the repo, never committed.

Independent Deployment Scripts

The skill guides you to create standalone scripts in agnosticd-v2-vars/<config-name>/ that wrap all agd lifecycle commands:

Script Wraps Notes
deploy.sh agd provision Loops over N students (default 2); sequential or parallel; hub-first for RHACM
teardown.sh agd destroy Reads students.txt manifest; prompts before RHACM-registered clusters
stop.sh agd stop Loops over all manifested student GUIDs
start.sh agd start Loops over all manifested student GUIDs

Key behaviors:

  • NUM_STUDENTS=2 by default; set PARALLEL=true for groups larger than 5
  • students.txt manifest is written on deploy and consumed by all other scripts (add to .gitignore)
  • Set DEPLOY_HUB=true when using a hub+student RHACM topology — hub provisions before student clusters
  • Secrets are never embedded in scripts — they come from agnosticd-v2-secrets/

RHACM hub-and-spoke note

No RHACM cluster registration role exists in upstream agnosticd/agnosticd-v2. When using a hub+student RHACM topology, the skill scaffolds an ocp4_workload_rhacm_import role in your fork — see (RESEARCH NEEDED — RQ-HUB-8) in the skill for the task details once research resolves them.

Skill Integration
Field-Sourced Content AgnosticD deploys field content via the ocp4_workload_field_content workload role
Showroom AgnosticD deploys Showroom lab guides via the ocp4_workload_showroom infra_workload
Student Readiness After provisioning, verify the environment is ready for students end-to-end

See ADR-010 for the cross-skill dependency model and ADR-011 for validation and troubleshooting.

Reference Documentation

When installed, the references/ directory includes:

Document Description
setup.adoc Development environment setup (RHEL, macOS, Fedora)
contributing.adoc Contribution guidelines and PR format
conversion_guide.adoc Migrating from AgnosticD v1 to v2
git-style-guide.adoc Git conventions for the project
core-workloads-catalog.md Catalog of all 35 core_workloads roles with descriptions

Install 

./install.sh install --skill agnosticd