ueberdosis / laravel-docker-health-check
Fund package maintenance!
ueberdosis/
Installs: 1 768
Dependents: 0
Suggesters: 0
Security: 0
Stars: 6
Watchers: 3
Forks: 0
Open Issues: 0
Requires
- php: ^7.4|^8.0
- illuminate/support: ^7.0|^8.0|^9.0|^10.0|^11.0
README
A simple package that makes it easier to work with Laravel and Docker in production.
Installation
Install it with composer:
composer require ueberdosis/laravel-docker-health-check
Add the Middleware to your app/Http/Kernel.php
:
class Kernel extends HttpKernel { /** * The application's global HTTP middleware stack. * * These middleware are run during every request to your application. * * @var array */ protected $middleware = [ // ... \Ueberdosis\DockerHealthCheck\Middleware\ClearCacheOnInitialRequest::class, ]; // ... }
Update your health check script to curl the newly registered route /docker-health-check
. The following is an example health check script, please update your own implementation:
#!/usr/bin/env bash set -e if [ $(curl -o /dev/null -L -s -w "%{http_code}\n" http://localhost/docker-health-check) = "200" ]; then exit 0 else exit 1 fi
What problem is this package solving?
When using Laravel with Docker in production you would normally write a huge entrypoint script that runs migrations, clears caches and so on. But clearing caches in this entrypoint script doesn't work well. Why?
Well, the orchestrator waits for the Laravel container to become healthy before directing actual traffic to it. So when you update your stack, the old container will handle all the traffic at the moment when you call php artisan view:clear
in your entrypoint up to the moment when the new container is healthy. When traffic hits the site in that moment, the cache will be rebuilt in the old container.
This is a huge pain on big dockerized Laravel apps. This package will clear caches on the first request to a new container by using a temporary file in the app root.
And it conveniently registers a nice /docker-health-check
route for you that returns a response with status code 200 for your health check script.
License
MIT