ricardoamaro/drupal9 repository overview

⁠drupal9-docker-app

Table of Contents

• drupal9-docker-app⁠
• What is this?⁠
• Quick 3 step instructions for a Drupal 9 Trial Run:⁠
  • 1 - Install docker:⁠
  • 2 - Get the image and run it using port 80:⁠
  • 3 - Visit Drupal 9 in your browser⁠
  • Extra - Visualize MySQL tables in your browser⁠
• COMMUNITY CONTRIBUTIONS⁠
  • Using drupal9_local.sh or drupal9_local.bat for local development⁠
    • Fresh install⁠
    • Credentials (will be shown in the output)⁠
    • Stoping and starting Drupal9-docker-app⁠
    • Example usage for testing:⁠
  • For older Drupal versions check:⁠
  • You can also clone this repo somewhere and build it,⁠
  • Or build it directly from github,⁠
• More docker awesomeness⁠
  • Clean up⁠
• Known Issues⁠
• Contributing⁠
  • Authors⁠
  • License⁠

⁠What is this?

This repo contains a Docker recipe for making a container running Drupal9, using Linux, Apache, MySQL, Memcache and SSH. You can also use it on the Drupal Contribution Sprints for quickly starting working on your Drupal9 project. Note that, despite what other Docker solutions do, this will deliver you a fast, one-shot container with all necessary services, thus avoiding the need of container orchestration and the need of installing more software.

• To just Trial Drupal 9 please Install Docker⁠.

• To use this repository as development environment, on Linux, MacOSX or Win10 make sure both bash+docker are installed.

Feel free to test and report any issues.

⁠Quick 3 step instructions for a Drupal 9 Trial Run:

⁠1 - Install docker:

https://docs.docker.com/installation/⁠

⁠2 - Get the image and run it using port 80:

Open a terminal and run

docker run -i -t -p 80:80 ricardoamaro/drupal9

That's it!

⁠3 - Visit Drupal 9 in your browser

http://localhost/⁠

Credentials (user/pass): admin/admin

⁠Extra - Visualize MySQL tables in your browser

http://localhost/adminer.php⁠

⁠COMMUNITY CONTRIBUTIONS

If you want Code and Database persistence with Drupal9 code on the local/web folder and MySQL on the local/data folder:

⁠Linux/Mac Users

git clone https://github.com/ricardoamaro/drupal9-docker-app.git
cd drupal9-docker-app
./drupal9_local.sh

⁠Windows Users

git clone https://github.com/ricardoamaro/drupal9-docker-app.git
cd drupal9-docker-app
drupal9_local.bat

⁠Using drupal9_local.sh or drupal9_local.bat for local development

⁠Fresh install

For a fresh install or re-install of your existing code

1. Remove the local/data/ folder
2. Create a local/web/ folder with your Drupal 9 docroot eg. composer create-project drupal-composer/drupal-project:8.x-dev local --no-interaction
3. Delete the sites/default/settings.php file
4. Run drupal9_local.sh to linux/mac users or drupal9_local.bat to windows users

⁠Credentials (will be shown in the output)

• Drupal account-name=admin & account-pass=admin
• ROOT SSH/MYSQL PASSWORD will be on $mysql/mysql-root-pw.txt
• DRUPAL MYSQL_PASSWORD will be on $mysql/drupal-db-pw.txt

⁠Stoping and starting Drupal9-docker-app

To stop and restart the installed existing site

1. Press CTRL+C on the console showing the logs
2. Run drupal9_local.sh or drupal9_local.bat on the same directory
3. Open the site URL mentioned in the console

⁠Example usage for testing:

Using docker exec {ID} {COMMAND}, to run your own commands.

~$ docker run --name mydrupal9 -i -t -p 80:80 ricardoamaro/drupal9

~$ docker exec mydrupal9  uptime
 10:02:59 up 16:41,  0 users,  load average: 1.17, 0.92, 0.76

~$ docker exec mydrupal9 drush status
 PHP binary    : /usr/bin/php7.3
 PHP config    : /etc/php/7.3/cli/php.ini
 PHP OS        : Linux
 Drush script  : /.composer/vendor/drush/drush/drush
 Drush version : 10.2.2
 Drush temp    : /tmp
 Drush configs : /.composer/vendor/drush/drush/drush.yml

⁠For older Drupal versions check:

https://github.com/ricardoamaro/drupal7-docker-app⁠ https://github.com/ricardoamaro/drupal6-docker-app⁠

⁠You can also clone this repo somewhere and build it,

git clone https://github.com/ricardoamaro/drupal9-docker-app.git
cd drupal9-docker-app
sudo docker build -t <yourname>/drupal9 .

⁠Or build it directly from github,

sudo docker build -t ricardo/drupal9 https://github.com/ricardoamaro/drupal9-docker-app.git

Note1: you cannot have port 80 already used or the container will not start. In that case you can start by setting: -p 8080:80

Note2: To run the container in the background

sudo docker run -d -t -p 80:80 <yourname>/drupal9

⁠More docker awesomeness

How to go back to the last docker run?

docker ps -al
(get the container ID)
docker start -i -a (container ID)

This will create an ID that you can start/stop/commit changes:

# sudo docker ps
ID                  IMAGE                   COMMAND               CREATED             STATUS              PORTS
538example20        <yourname>/drupal9:latest   /bin/bash /start.sh   3 minutes ago       Up 6 seconds        80->80

Start/Stop

sudo docker stop 538example20
sudo docker start 538example20

Commit the actual state to the image

sudo docker commit 538example20 <yourname>/drupal9

Starting again with the commited changes

sudo docker run -d -t -p 80:80 <yourname>/drupal9 /start.sh

Shipping the container image elsewhere

sudo docker push  <yourname>/drupal9

You can find more images using the Docker Index⁠.

⁠Clean up

While i am developing i use this to rm all old instances

sudo docker ps -a | awk '{print $1}' | grep -v CONTAINER | xargs -n1 -I {} sudo docker rm {}

⁠Known Issues

• Warning: This is still in development and ports shouldn't be open to the outside world.

⁠Contributing

Feel free to submit any bugs, requests, or fork and contribute to this code. :)

1. Fork the repo
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

⁠Authors

Created and maintained by Ricardo Amaro⁠ http://blog.ricardoamaro.com⁠

⁠License

GPL v3