Working in Your Containers¶

When using Docker, we often have to run commands inside the Docker containers. For example, you can run the same Drush commands you would run in a non-Docker environment, but you must run those commands inside the Drupal container.

Running Commands in the Containers¶

If you want to work inside a container, you can use Docker Compose to run bash from inside the container. You can get a bash shell inside the Drupal container by running

docker compose exec drupal-dev with-contenv bash

Or you can run your command from the host machine by running

docker compose exec -T drupal-dev with-contenv bash -lc 'YOUR COMMAND'

For example, if you want to perform a Drush cache rebuild you could run

docker compose exec -T drupal-dev with-contenv bash -lc 'drush cr'

Container Names

The container name drupal-dev is the ‘services’ name as set in your docker-compose.yml. To access the drupal container in production you would replace drupal-dev with drupal-prod.

You can also access other containers in this way, by replacing drupal-dev with their service name. For example, mariadb-dev or solr-prod.

For more information, see the documentation on docker compose exec

Container Variables¶

In some of the commands throughout the ISLE Site Template documentation you will see references to variables like ${DRUPAL_DEFAULT_SITE_URL}. These are variables that are provided in the containers by the s6-overlay in Islandora Buildkit.

If you want to see their values, you can run

docker compose exec -T drupal-dev with-contenv bash -lc 'echo ${DRUPAL_DEFAULT_SITE_URL}'

with-contenv

Adding with-contenv to your commands gives you access to the s6-overlay environment variables. If you don’t need to use these variables, the commands above can be simplified to

docker compose exec drupal-dev bash

and

docker compose exec -T drupal-dev -lc 'YOUR COMMAND'

Helpful Commands¶

Checking logs¶

You can read logs for a container with:

docker compose logs service_name

For example, to read nginx logs for Drupal, use docker compose logs drupal-dev.

If you don't know what you're looking for exactly, you can turn on the fire hose and look through all logs by dropping the service name and simply using:

docker compose logs

Reindex Solr¶

You can reindex Solr through the Drupal admin page, or via drush commands by queuing for reindex:

docker compose exec -T drupal-dev with-contenv bash -lc 'drush --root /var/www/drupal/web -l ${DRUPAL_DEFAULT_SITE_URL} search-api-reindex'

then triggering the reindex:

docker compose exec -T drupal-dev with-contenv bash -lc 'drush --root /var/www/drupal/web -l ${DRUPAL_DEFAULT_SITE_URL} search-api-index'

Reindex Fedora¶

Note

This requires the Views Bulk Operations module

You can reindex all of your Drupal data into Fedora, by running the following commands:

docker compose exec -T drupal-dev with-contenv bash -lc 'drush --root /var/www/drupal/web -l ${DRUPAL_DEFAULT_SITE_URL} vbo-exec non_fedora_files emit_file_event --configuration="queue=islandora-indexing-fcrepo-file-external&event=Update"'

docker compose exec -T drupal-dev with-contenv bash -lc 'drush --root /var/www/drupal/web -l ${DRUPAL_DEFAULT_SITE_URL} vbo-exec all_taxonomy_terms emit_term_event --configuration="queue=islandora-indexing-fcrepo-content&event=Update"'

docker compose exec -T drupal-dev with-contenv bash -lc 'drush --root /var/www/drupal/web -l ${DRUPAL_DEFAULT_SITE_URL} vbo-exec content emit_node_event --configuration="queue=islandora-indexing-fcrepo-content&event=Update"'

docker compose exec -T drupal-dev with-contenv bash -lc 'drush --root /var/www/drupal/web -l ${DRUPAL_DEFAULT_SITE_URL} vbo-exec media emit_media_event --configuration="queue=islandora-indexing-fcrepo-media&event=Update"'

Reindex Blazegraph¶

Note

This requires the Views Bulk Operations module

You can reindex all of your Drupal data into Blazegraph, by running the following commands:

docker compose exec -T drupal-dev with-contenv bash -lc 'drush --root /var/www/drupal/web -l ${DRUPAL_DEFAULT_SITE_URL} vbo-exec all_taxonomy_terms emit_term_event --configuration="queue=islandora-indexing-triplestore-index&event=Update"'

docker compose exec -T drupal-dev with-contenv bash -lc 'drush --root /var/www/drupal/web -l ${DRUPAL_DEFAULT_SITE_URL} vbo-exec content emit_node_event --configuration="queue=islandora-indexing-triplestore-index&event=Update"'

docker compose exec -T drupal-dev with-contenv bash -lc 'drush --root /var/www/drupal/web -l ${DRUPAL_DEFAULT_SITE_URL} vbo-exec media emit_media_event --configuration="queue=islandora-indexing-triplestore-index&event=Update"'

Last update: April 30, 2025