DrupalPod AI QA

See the DrupalPod AI QA documentation here, or go straight to the Step-by-Step Guide.

DrupalPod AI QA is a QA tooling project within the Drupal AI initiative, built to lower the barrier to testing and contributing to Drupal's AI module and its ecosystem of contributed modules.

It spins up pre-configured Drupal environments with the right modules, versions, and Git branches already wired up.

It's useful in two ways: for QA, you can spin up an environment around a specific issue and PR and test it immediately; for active contribution, the AI and test modules are checked out as live Git repositories, so any changes you make are reflected instantly in the running Drupal site.

Configure the base AI module, a contrib module under test, your target template (CMS or Core), and any PR forks or branches you need. The system resolves a compatible set of dependencies and builds a ready-to-go Drupal install.

Install the browser extension (Chrome only - for now), open any issue in the AI module's queue on drupal.org, and click the icon. It reads the issue context from the page and pre-populates the environment variables for you.

Option 1 — Local development with DDEV

Click ddev and Generate ddev config to the config you'll need to build the ddev environment.

Install DDEV, clone the repo, and drop a .ddev/config.drupal.yaml into your project to configure what you're testing:

web_environment:
  - DP_STARTER_TEMPLATE=cms        # cms or core
  - DP_VERSION=                    # Drupal version, empty = latest stable
  - DP_AI_MODULE=ai                # Base AI module name
  - DP_AI_MODULE_VERSION=          # AI version, empty = auto-detect
  - DP_AI_ISSUE_FORK=              # Fork name for AI PR testing
  - DP_AI_ISSUE_BRANCH=            # Branch name for AI PR testing
  - DP_TEST_MODULE=                # Contrib module under test
  - DP_TEST_MODULE_VERSION=        # Test module version, empty auto-detects
  - DP_TEST_MODULE_ISSUE_FORK=     # Fork name for test module PR
  - DP_TEST_MODULE_ISSUE_BRANCH=   # Branch name for test module PR
  - DP_EXTRA_MODULES=              # Additional modules, comma-separated
  - DP_REBUILD=1                   # 1 = force clean rebuild on restart

Run ddev restart and your environment builds automatically.

Option 2 — Cloud environments with DrupalForge

Click DrupalForge and Launch DrupalForge and you will be redirected to DrupalForge with everything already configured — spin up the environment in DevPanel, and you'll have a shareable cloud environment you can hand off to others for collaborative testing.

Note: Log into DevPanel first to avoid any issues with authentication interfering with the flow.

See the DrupalPod AI QA documentation for more information and on how to use.

Any questions, just ask. We are on #ai-quality-assurance on Drupal Slack for discussion around anything with AI QA.

This project is under active development. Inspired by and forked from DrupalPod.