Extend the Docker configuration

You can use the built-in extension mechanism of Docker to specify multiple compose files. The following example replaces the default value of the ENABLE_SENDMAIL environment variable.

1. Create a docker-compose-dev.yml file inside your project root directory and add the following content:

   1
   2
   3
   4
   5
   version: '2'
   services:
     deploy:
      environment:
       - ENABLE_SENDMAIL=true
   

2. Pass both configuration files while executing your commands. For example:

   1
   docker-compose -f docker-compose.yml -f docker-compose-dev.yml run deploy bash
   

Specify Docker build sources

To test changes to images or make more extensive changes to the containers, you must build them from source. You can do this by by adding the build:context configuration to the docker-compose.override.yml file.

The following example defines the build context for the Web container. You can use the same technique to build from any of the images in the vendor/magento/magento-cloud-docker directory or any other Docker image, including local images that are resourced outside the project.

1
2
3
4
5
version: '2.1'
services:
   web:
    build:
     context: ./vendor/magento/magento-cloud-docker/images/nginx/1.9/

To update the container configuration and test iteratively, use the --force-recreate option to refresh the container build:

1
docker-compose up -d --force-recreate --build

Add a new version of existing service

In magento-cloud-docker package the available service versions are determined by the Docker service images configured in the magento-cloud-docker images directory. You can add a new service version by creating a directory for the version and adding a Dockerfile and other files to configure the new version.

To add a new service version using a Dockerfile:

1. Clone the magento-cloud-docker project to your local environment if necessary.

2. On the command line, change to the directory that contains the existing service version configurations.

   1
      cd magento-cloud-docker/images/<service-name>
   

3. Create a directory for the new version.

4. In the new directory, add the Dockerfile that contains the image configuration details for the new version. Use the Dockerfile for an existing version as a template and add any other required configuration such as supported plugins.

5. Add the docker-entrypoint.sh and healthcheck files if needed.

6. Add any necessary .conf and .ini files for the service to the etc directory.

7. Run the following command to build the image.

   docker build -t test/<service-name>:<service-version>

8. Once the build succeeds, test the changes by specifying the Docker build sources.

Add a new PHP extension

In addition to built-in extensions, you can add PHP extensions to the PHP container.

To add a new PHP extension:

1. Clone the magento-cloud-docker project to your local environment if necessary.

2. On the command line, navigate to the PHP directory.

   ```bash cd magento-cloud-docker/src/Compose/Php

3. Open the ExtensionResolver.php file, define the required extension inside the getConfig method by specifying the extension type and dependency.

   For instance the following block adds the GNUPG extension:

   1
   2
   3
   4
   5
   'gnupg' => [
     '>=7.0' => [
     self::EXTENSION_TYPE => self::EXTENSION_TYPE_PECL,
     self::EXTENSION_OS_DEPENDENCIES => ['libgpgme11-dev'],
   ],],
   

   The extension type can be either CORE or PECL, which are defined as EXTENSION_TYPE_PECL or EXTENSION_TYPE_CORE respectively.

4. Add any required .ini files to the PHP FPM container configuration.

   • On the command line, navigate to FPM image directory magento-cloud-docker/images/php/fpm:

     1
     cd ../../../images/php/fpm
     

   • Add each required .ini file to the etc directory.

   • For each .ini file that you add, you must add the following line to the Dockerfile (magento-cloud-docker/images/php/fpm/Dockerfile):

     1
     COPY etc/<filename>.ini /usr/local/etc/php/conf.d/<filename>.ini
     

5. Add any required .ini files to the PHP CLI container configuration.

   • On the command line, navigate to the CLI image directory magento-cloud-docker/images/php/cli.

     1
     cd ../cli
     

   • Add each required .ini file to the etc directory.

   • For each .ini file that you add, you must add the following line to the Dockerfile (magento-cloud-docker/images/php/cli/Dockerfile):

     1
      ADD etc/<file-name>.ini /usr/local/etc/php/conf.d/<filename>.ini
     

6. Generate an updated Dockerfile for all PHP image versions included in the magento-cloud-docker package.

   1
   bin/ece-docker image:generate:php
   

7. Test the extension by specifying the Docker build sources.