geerlingguy/drupal-vm-docker

Drupal VM Docker Composer Plugin

DEPRECATED - Drupal VM Docker Composer Plugin

This project has been deprecated. It is no longer maintained.

The quickest way to add a local development environment to your Drupal project!

Get started:

composer require --dev geerlingguy/drupal-vm-docker

Run this command inside the directory of a Drupal project that is built using Composer, and it will create a Docker Compose file which will run a local instance of Drupal VM.

Make sure you have Docker CE installed and running, then run docker-compose up -d. After a minute or two, you should be able to access your Drupal site at http://localhost/.

To install Drupal, the default Drupal VM database name, username, and password are all drupal.

Shutting down the environment

When you're finished developing, run the command:

docker-compose stop

And once you're ready to develop again, run:

docker-compose start

If you want to completely clear out the local environment (e.g. to start over or if you're finished with a project), run:

docker-compose down

Updating the Docker Compose file

The Docker Compose file should be updated automatically any time you update to a newer version of this plugin. However, you can also manually force the file to be updated by running:

composer drupal-vm-docker-update

You should then tell Docker to restart anything that needs to be restarted with docker-compose up -d.

License

This project is licensed under the MIT open source license.

About the Author

Jeff Geerling created the Drupal VM Docker Composer Plugin in 2018 for a more efficient Drupal site and core/contrib development workflow.

drupal-vm-docker's Issues

Missing volume in docker-compose leads to MySQL not starting

See related issue upstream: geerlingguy/drupal-vm#1973

Allow some configuration through composer.json extra config

I would like to allow a few settings to be configured through a Drupal project's composer.json extras config, e.g.:

    "extra": {
        "drupal-vm-docker": {
            "container_name": "custom-container-name",
            "http_port": "80",
            "https_port": "443",
        }
    }

Basic things like that which will be templated into the docker-compose.yml file. Or maybe do something else here, but basically I want a few configurable flags.

Customization of Drupal-VM in Docker.

• How to migrate from vagrant box/config.yml to Docker
• Host OS /etc/hosts file doesnot updated after running docker-composer up
• How can I execute Ansible playbook.yml file inside docker container so it will automatically setup all the configuration.

Put Composer plugin on Packagist

As the title says...

Add automated tests

At a minimum:

• Validate the composer.json file.
• Can we install the plugin and then verify the docker-compose.yml file is created?
• Can we install the plugin and then run the drupal-vm-docker-compose-update command?

Kubernetes support?

I've been longing to see how you would achieve a similar product under a Kubernetes release.

I understand this is overkill, but it would be very nice to somebody such as myself.

If you're not interested feel free to close this ticket.