Skip to content

Add Docker setup guide for application templates#394

Draft
Copilot wants to merge 2 commits intomasterfrom
copilot/create-docker-setup-guide
Draft

Add Docker setup guide for application templates#394
Copilot wants to merge 2 commits intomasterfrom
copilot/create-docker-setup-guide

Conversation

Copy link
Contributor

Copilot AI commented Mar 18, 2026

No guide existed for the Docker infrastructure bundled with yiisoft/app and yiisoft/app-api. Both templates ship with a FrankenPHP/Caddy-based setup covering dev, test, and production environments, but it was undocumented.

Changes

  • New page src/guide/tutorial/docker.md covering:

    • Annotated docker/ directory tree
    • All four .env files (docker/.env, docker/dev/.env, docker/test/.env, docker/prod/.env) with per-variable tables distinguishing Compose-level from app-level variables
    • Override env file pattern (override.env.example) for developer-local settings
    • Each compose.yml (base, dev, test, prod/Swarm) with key config points explained
    • Multi-stage Dockerfile breakdown: composerbasedev / prod-builderprod
    • Full make command reference grouped by Development / Tools / Testing / Production
  • src/.vitepress/config.js — added page to Tutorial sidebar

  • src/guide/index.md — added link under Special topics

Original prompt

This section details on the original issue you should resolve

<issue_title>Create a guide page about Docker setup in application templates</issue_title>
<issue_description>### Description

Create a user guide for Docker in https://github.com/yiisoft/app and https://github.com/yiisoft/app-api

Things to note especially:

  1. make commands usage.
  2. Contents of /docker overview.
  3. Each .env purpose and examples.
  4. compose.yml.
  5. The idea of multi-stage builds.</issue_description>

Comments on the Issue (you are @copilot in this section)


💬 Send tasks to Copilot coding agent from Slack and Teams to turn conversations into code. Copilot posts an update in your thread when it's finished.

Co-authored-by: samdark <47294+samdark@users.noreply.github.com>
Copilot AI changed the title [WIP] Add guide page about Docker setup in application templates Add Docker setup guide for application templates Mar 18, 2026
Copilot AI requested a review from samdark March 18, 2026 21:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create a guide page about Docker setup in application templates

2 participants