Drupal Upsun Fixed Testing

Expert guidance for Drupal 11 projects configured for Upsun Fixed (Platform.sh) deployment using DDEV local development environment.

Purpose

This skill provides specialized assistance for Drupal 11 projects that use Upsun Fixed (Platform.sh) as their hosting infrastructure. It focuses on testing and validating the ddev-upsun add-on, ensuring proper configuration synchronization, deployment workflows, and service integrations between local DDEV environments and Upsun production/staging environments.

Instructions

When assisting with this project, follow these guidelines:

1. **Understand the Context**

- This is a Drupal 11 project specifically designed for Upsun Fixed (Platform.sh)

- Primary goal is testing the ddev-upsun add-on functionality

- Focus on deployment workflows, configuration management, and platform integration

2. **DDEV Development Patterns**

- Follow standard DDEV organization patterns documented at https://github.com/ddev/.github/blob/main/AGENTS.md

- Use DDEV commands for local development tasks

- Respect DDEV project structure and conventions

3. **Key Testing Areas**

- Configuration synchronization between local and remote environments

- Deployment workflows from DDEV to Upsun

- Service integrations (database, cache, search, etc.)

- Platform.sh/Upsun-specific configurations

- ddev-upsun add-on functionality validation

4. **Configuration Management**

- Verify Drupal configuration exports/imports work correctly

- Ensure environment-specific settings are properly separated

- Test configuration sync between DDEV and Upsun environments

- Validate settings.php and settings.platformsh.php configurations

5. **Deployment Testing**

- Test deployment processes from local to staging/production

- Verify environment variables are correctly passed

- Check service connections (MySQL, Redis, etc.) in deployed environments

- Validate build hooks and deployment scripts

6. **Code Discipline**

- Do what has been asked; nothing more, nothing less

- NEVER create files unless absolutely necessary

- ALWAYS prefer editing existing files over creating new ones

- NEVER proactively create documentation files (README, docs, etc.)

7. **Common Tasks**

- Setting up ddev-upsun add-on: `ddev add-on get ddev/ddev-upsun`

- Pushing database: `ddev push upsun`

- Pulling database: `ddev pull upsun`

- SSH into Upsun environment: `ddev ssh -s upsun`

- Running Drush commands: `ddev drush [command]`

- Exporting config: `ddev drush config:export`

- Importing config: `ddev drush config:import`

8. **Troubleshooting Focus**

- Configuration mismatch between environments

- Database synchronization issues

- Service connection problems

- Deployment failures

- ddev-upsun add-on errors

- Platform.sh/Upsun-specific issues

Example Usage

"Help me troubleshoot why configuration import is failing after pulling from Upsun"

"How do I test the ddev-upsun add-on push workflow?"

"My Redis connection isn't working in the Upsun environment"

"What's the correct way to handle environment-specific settings for Upsun?"

Constraints