Lagoon
Lagoon is an open-source container-based hosting platform that provides automated deployments for Drupal applications using Docker and Kubernetes.
For general Lagoon documentation, refer to the Lagoon Documentation.
Integration
Vortex provides the following integration with Lagoon:
Tasks
With Vortex, you can:
- Download a database from a Lagoon environment for local development or CI
- Trigger deployments to Lagoon environments
- Run custom commands on Lagoon environments
When running these tasks, your .env and .env.local files are used as the
source for the project name and SSH configuration.
Deployment automation
When code is deployed, Vortex automatically:
- Provisions the site - Runs database updates, imports configuration, clears caches
- Sends notifications - Notifies configured channels about the deployment
This is implemented using post-rollout tasks defined in the
.lagoon.yml
configuration file, which also defines Docker image mappings and
environment-specific configurations.
Environment detection
Vortex automatically detects when running on Lagoon and loads appropriate
settings from web/sites/default/includes/providers/settings.lagoon.php.
This includes Lagoon-specific configurations for caching, file paths, and
environment variables provided by the platform.
Onboarding
Lagoon onboarding is part of the project setup flow. See Set up integrations in the Installation guide and select Lagoon.
Routine Operations
Download database
Download a database backup from your Lagoon environment for local development or CI builds:
ahoy download-db