Add a Dockerfile and publish a Docker image of the starter project on Docker Hub

Abierto
#215 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
docker, docker-compose, github-actions, php

Línea de trabajo

First resolve the listed decisions about the Docker Hub namespace, PHP versions, image type, and database; the work is also gated on the project requiring PHP 8.2. Read the README and project setup requirements, then add the Dockerfile, .dockerignore, docker-compose.yml, and .github/workflows/docker.yml described in the issue. Verify that docker compose up serves the home page and php qt install:demo runs, then confirm the release workflow publishes version and latest tags without baking in secrets.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

feature

Summary

Let users run a new Quantum project with Docker, and publish an image of it on Docker Hub with every release. The repository has no Docker files today. This is planned for 3.2.0, which raises the minimum PHP version to 8.2, so the image starts from PHP 8.2.

Why

Starting a Quantum project needs PHP 8.2 or newer (the minimum of 3.2.0), Composer and several extensions (pdo, curl, json, simplexml, fileinfo, openssl, bcmath, plus dom and zip for some features). An image gives a working setup in one command, on any machine, without installing PHP.

Scope

Files to add to this repository:

  • Dockerfile: PHP 8.2 on Apache, the extensions above, Composer, the document root set to public/, mod_rewrite on, and write access to logs/, cache/ and runtime/. The .env is read at run time, and no secret is stored in the image.
  • .dockerignore.
  • docker-compose.yml: the app, a database, and Redis as an option.
  • .github/workflows/docker.yml: build and push the image to Docker Hub when a release tag is published, for amd64 and arm64.
  • A short section in README.md on how to run it.

Two kinds of image are possible: a runtime image where the project is mounted or created with composer create-project quantum/project, and a ready image that already contains a created project and starts a working app. The first one comes first; the second is a thin layer on top of it.

To decide before the work starts

  • the Docker Hub namespace and repository, and who owns them
  • the PHP versions to publish, from 8.2 up
  • which kind of image comes first
  • which database the compose file starts with

The access token and the account name are stored as the repository secrets DOCKERHUB_TOKEN and DOCKERHUB_USERNAME by the maintainer.

Order

The work starts after the project requires PHP 8.2 (3.2.0), because the image must run the version the project supports.

Out of scope

  • Changes to the framework repository.
  • Tags and releases: they are cut by the maintainer, and the workflow only reacts to a published tag.

Acceptance criteria

  • docker compose up starts the project, and the home page answers
  • the image runs php qt commands, including install:demo
  • no secret is baked into the image
  • a published release tag pushes the image to Docker Hub with the version tag and latest
  • the README explains how to run it
Lenguaje dominante
PHP
Estrellas
49
Forks
20
Merge medio
16 min
PR fusionados (30 d)
9

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de quantum-php/project

Todos los issues de quantum-php/project

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.