Bootstrap Cache is not shared between the containers

[lukasleitsch]

I ran a Laravel app with this Docker Compose file. One container (web) has the actual app with Autorun enabled. Autorun runs artisan optimize. Only the web container benefits from the bootstrap cache in /var/www/html/bootstrap/cache. The task and horizon containers do not have this cache.

The Health-Checks Package from Spatie runs checks via the scheduler, which runs in the task container. The check fails because that container has no bootstrap cache.

How do you solve this issue? My solution was to add a shared volume for the bootstrap cache folder. (See below)

services:
  web:
    image: my/laravel-app
    environment:
      - HEALTHCHECK_PATH="/up"
      - AUTORUN_ENABLED=true
      - AUTORUN_LARAVEL_MIGRATION_ISOLATION=true
  task:
    image: my/laravel-app
    command: ["php", "/var/www/html/artisan", "schedule:work"]
    stop_signal: SIGTERM
    healthcheck:
      test: ["CMD", "healthcheck-schedule"]
      start_period: 10s
  redis:
    image: redis:6
    command: "redis-server --appendonly yes --requirepass redispassword"
  horizon:
    image: my/laravel-app
    command: ["php", "/var/www/html/artisan", "horizon"]
    stop_signal: SIGTERM
    healthcheck:
      test: ["CMD", "healthcheck-horizon"]
      start_period: 10s

With Bootstrap cache volume:

services:
  web:
    image: my/laravel-app
    environment:
      - HEALTHCHECK_PATH="/up"
      - AUTORUN_ENABLED=true
      - AUTORUN_LARAVEL_MIGRATION_ISOLATION=true
    volumes:
      - ./storage:/var/www/html/storage
      - bootstrap-cache:/var/www/html/bootstrap/cache
  task:
    image: my/laravel-app
    command: ["php", "/var/www/html/artisan", "schedule:work"]
    stop_signal: SIGTERM
    healthcheck:
      test: ["CMD", "healthcheck-schedule"]
      start_period: 10s
    volumes:
      - ./storage:/var/www/html/storage
      - bootstrap-cache:/var/www/html/bootstrap/cache
  redis:
    image: redis:6
    command: "redis-server --appendonly yes --requirepass redispassword"
  horizon:
    image: my/laravel-app
    command: ["php", "/var/www/html/artisan", "horizon"]
    stop_signal: SIGTERM
    healthcheck:
      test: ["CMD", "healthcheck-horizon"]
      start_period: 10s
    volumes:
      - ./storage:/var/www/html/storage
      - bootstrap-cache:/var/www/html/bootstrap/cache

volumes:
  bootstrap-cache:

[iqbal-fadhil]

By “sharing” the bootstrap cache, I meant mounting the same bootstrap/cache directory as a Docker volume into all containers, so they all read the same generated cache files.
That way, the cache generated by artisan optimize in the web container is also visible to the task and horizon containers.

[chrillep]

yes same goes for storage

[jaydrogers]

Sorry for the delay on this. I was heads down getting Self-Host Pro out the door 🤪

I noticed @lukasleitsch had a mix of named volumes and bind mount volumes. Depending on your use case, you might want all or nothing with that (depending on the environment).

I put together this blog post as a guide: https://serversideup.net/blog/docker-compose-bind-mounts-vs-named-volumes/

But sharing volumes across multiple containers for Laravel is a great idea. It's exactly what we do for Spin.