Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spinspire/drupal-docker
https://github.com/spinspire/drupal-docker
Last synced: 12 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/spinspire/drupal-docker
- Owner: spinspire
- Created: 2022-08-21T02:47:05.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-11-16T00:02:00.000Z (about 1 year ago)
- Last Synced: 2024-04-17T19:27:26.185Z (8 months ago)
- Language: PHP
- Size: 58.6 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Drupal Starter Project
Use this project as a starting point for your containerized Drupal projects.
It has the following features:
- Very lightweight. Ideal for local development.
- Dockerized: It uses 2 or 3 containers - web, php, db (optional if you use sqlite)
- `docker-compose.*.yml` files for mysql, pgsql, traefik etc.
- Includes `drupal` (core), `composer`, and `drush`
- PROD fallback: Allows your local dev environment to redirect requests for uploaded file assets to the PROD instance. That way you don't have to copy all of them from PROD to local.
- Pre-existing `entrypoint` scripts to set everything up for you every time you rebuild the containers
# Steps to use it
- `cp .env.example .env` and then edit .env to your taste.
- Edit email addresses and site URL in `drupal/drush/drush.yml`
- Optionally: Copy database dump files (`*.sql` and `*.sql.gz`) into `db-init`
- Bring up the containers ...
```
docker-compose up -d
```
- Wait for db container to be ready. Check with ...
```
docker-compose logs -f php
docker-compose logs -f db
docker-compose logs -f web
```
- If you did not restore an existing site, then create a new one with ...
```
docker-compose exec php drush site-install
```
- Now visit your website. Either use the public URL or use the following to find the Docker IP's URL.
```
echo "http://$(docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $(docker-compose ps -q web))"
```
# Troubleshooting
- See what containers are running:
```
docker-compose ps
```
- Look at the logs
```
docker-compose logs
```
- Look at `php` logs
```
docker-compose logs php
```
- Tail the `php` logs
```
docker-compose logs -f php
```
# Optional Steps
You can add some useful extensions with ...
```
docker-compose exec php composer require drupal/admin_toolbar drupal/module_filter drupal/pathauto
docker-compose exec php drush -y en admin_toolbar_tools module_filter pathauto
```
And then configure Pathauto patterns.
If you want to use `xdebug`, change the command in docker-compose.override.yml to:
```
command: php-fpm81 -F -d zend_extension=xdebug.so
```
Credit: https://github.com/skilld-labs/docker-php