To run Lagoon Project your system must meet the requirements to run Docker. We suggest installing the latest version of Docker for your workstation. You can download Docker here. We also suggest allowing Docker at least 4 CPUs and 4 GB RAM.
Local Development Environments¶
TL;DR: install and start
gem install pygmy pygmy up
Learn more about Lagoon and Local Development Environments
Step by Step Guides¶
- Drupal: Lagoonize your Drupal Site
- Setup a new Project in Lagoon
- General: First Deployment
- Drupal: First Deployment Drupal
- Deployment & Build Process of Lagoon
Overview of Lagoon Configuration Files¶
They main file that will be used by Lagoon to understand what should be deployed and many more things. See Documentation for .lagoon.yml
This file is used by Docker Compose to start you Local Development environment. Lagoon also uses it to understand which of the Services should be deployed, which type and how to build them. This happens via
labels. See Documentation for docker-compose.yml
Some Docker Images and Containers need additional customizations from the provided Images, this usually has two reasons: 1. Application code: Containers like Nginx, PHP, Node, etc. need the actual programming code within their Images. This is done during a Docker Build step which are configured in Dockerfiles. Lagoon has full support for Docker and therefore also allows you full control over the resulting Images via Dockerfile customizations. 2. Customization of Images: Lagoon also allows you to customize the base Images according to your needs. This can be to inject an additional environment variable, change a service configuration or even install additional tools, even though we advise caution with installing additional tools to the Docker Images, as such adaptions need to be maintained by yourself in the future!
Supported Services & Base Images by Lagoon¶
|php-fpm||7.1, 7.2, 7.3||php/fpm/Dockerfile|
|php-cli||7.1, 7.2, 7.3||php/cli/Dockerfile|
|php-cli-drupal||7.1, 7.2, 7.3||php/cli-drupal/Dockerfile|
|solr||5.5, 6.6, 7.5||solr/Dockerfile|
|solr-drupal||5.5, 6.6, 7.5||solr-drupal/Dockerfile|
All images are pushed to https://hub.docker.com/u/amazeeio.
We suggest to always use the latest tag (like
amazeeio/nignx:latest) or unsuffixed images (like
amazeeio/node:10), as they are kept up to date in terms of features and security. If you shall choose to use a specific Lagoon Version of an image like
amazeeio/node:10-v0.21.0 it is your own responsibility to upgrade the version of the Images as soon as a new Lagoon Version is released!