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

オープン
#215 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
docker, docker-compose, github-actions, php

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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
主要言語
PHP
スター
49
フォーク
20
平均マージ
16分
マージ済み PR(30日)
9

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

quantum-php/project のほかの issue

quantum-php/project の issue をすべて見る

似ている issue

PHP の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。