Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

Run Doctrine migrations automatically on container start

Ouverte Adaptée aux débutants
  • Quelque chose ne va pas ?
#309 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

@akramer-zibra y travaille déjà.

Depuis le 15/10/2026.

  • #310 par @akramer-zibra — ouverte

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
66/100
Type d'issue
Fonctionnalité
Clarté
Clairement spécifiée
Activité
Active
Stack technique
docker, php, shell
Domaine
devops, infrastructure

Piste de recherche

Commence par le Dockerfile et le Dockerfile-standalone à la racine du dépôt, ainsi que le répertoire docker/configurations/ où se trouverait le entrypoint.sh proposé. Vérifie comment bin/console s'exécute avec APP_ENV=prod. Ajoute le script, branche-le comme ENTRYPOINT dans les deux Dockerfile, puis construis une image et démarre un conteneur pour confirmer que les migrations s'exécutent avant php-fpm ou supervisord. C'est terminé quand un conteneur neuf migre et démarre, et que les surcharges de CMD via docker run sont toujours transmises.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

feature request
Problem / motivation

Currently, after docker pull + restart, migrations must be run manually:

docker exec -it davis sh -c "APP_ENV=prod bin/console doctrine:migrations:migrate --no-interaction"

If this step is forgotten, Davis boots fine but fails in confusing ways (PROPPATCH errors, address books that won't create, etc.) instead of refusing to start. Time spend for upgrading would also decrease with this automation.

Proposed solution

Bake a minimal entrypoint.sh into both docker images that runs migrations before the server starts, then execs the normal process:

#!/bin/sh
set -e

php bin/console doctrine:migrations:migrate --no-interaction

exec "$@"

Wire it up in both Dockerfiles:

COPY ./docker/configurations/entrypoint.sh /usr/local/bin/entrypoint.sh
RUN chmod +x /usr/local/bin/entrypoint.sh

# In Dockerfile
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
CMD ["php-fpm"]

# In Dockerfile-standalone
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
CMD ["/usr/bin/supervisord", "-c", "/etc/supervisord.conf"] # Dockerfile-standalone

exec "$@" keeps it transparent to whatever CMD (or a docker run override) supplies.

Known limitations
  • No DB-ready retry: if the database isn't accepting connections yet on first docker-compose up, the migrate step fails fast and the container exits. Compose files don't currently gate depends_on on a healthcheck.
  • No concurrency lock: if the image is ever scaled to multiple replicas, each would race to run migrations on start. Not an issue for the single-instance docker-compose setups in this repo.
Alternatives considered

No response

Area

Docker / deployment

Additional context

No response

Langage dominant
PHP
Étoiles
760
Forks
45
Merge moyen
1 j 14 h
PR mergées (30 j)
3

Préparer son environnement

Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de tchapi/davis

Toutes les issues de tchapi/davis

Issues similaires

Plus d'issues PHP

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.