Magento 2 with Docker on Kubernetes

We've built a set of Dockerfiles en Kubernetes manifests for running Magento 2 on Kubernetes. This repository contains examples and instructions to get you started.

Before you begin: Bootstrap your Magento project

• Setup your Magento project with composer. Please follow the instructions at devdocs.magento.com
• Add deploy.php to the root of your project.
• In the root of your Magento project, create a folder 'deployment' and add all files from [https://github.com/cloudlets/magento2/blob/master/](our example directory) to it.
• Add your credentials to the auth.json-file in the deployments directory. Auth.json contains the necessary credentials for pulling packages from Magento's composer repository.

Step 1: Extending our base image.

Our Docker image m2-web-php on Docker Hub will be your starting point. The image contains an Nginx webserver with php-fpm, optimized for use with Magento 2. When you're intending to run Magento 2 on Kubernetes, you would want to extend this image with your Magento 2 artifact.

• Have a look at our example Dockerfile that extends our base image with the Magento codebase.
  • The first FROM-statement, as its name builder indicates, is used to build the Magento artifact. Customize this part if you want to adjust the artifact to your project's needs.
  • The second FROM-statement will build the Docker image that will be run your Magento application. Customize this part to suit your needs.

Step 2: Support for cron.

In a containerised context, you should run cronjobs in a seperate container. We have published our cron container on Docker Hub. This image extends the m2-php-fpm by installing cron and starting the cron daemon at image boot. There is no need to add cronjobs in your Dockerfile; you can do this in Kubernetes itself. See step X.

Step 3: Deploying on Kubernetes

To deploy your Docker images to Kubernetes, you'll need manifests describing how your deployment should run and behave, how containers should interact. You will also use manifests to store credentials and add cronjobs.

A lot of tools are automating the process of creating those yaml-manifests for you. We recommend using the CI/CD-option at dashboard.cloudlets.io to deploy your Magento images to Kubernetes. If you want to deploy the hard way, have a look at the deployment.yaml in this repo. TODO: manifests toevoegen