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

Đang mở
#215 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
docker, docker-compose, github-actions, php
Lĩnh vực
devops, infrastructure

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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
Ngôn ngữ chính
PHP
Star
49
Fork
20
Merge trung bình
16 phút
Pull request đã merge (30 ngày)
9

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của quantum-php/project

Tất cả issue của quantum-php/project

Issue tương tự

Thêm issue về PHP

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.