Building an application FROM dmstr/phd5

Docker images from phd5-app can also be used as base images, just by adding modules to the source code.

Visit dmstr/phd5-template for an example.

Getting started

Installation

• Download the phd5-template repository.
• Create a git-repository and commit its initial source-code

See also installation

Configuration

• Copy .env-dist to .env and adjust project defaults.
• Copy project/config/local.env-dist to project/config/local.env
• Adjust sane project default in project/tests/.env-dist files.
• :bulb: Edit the base image if your want to build from another pre-build application template.
• Update Dockerfile with application defaults, like APP_NAME and APP_LANGUAGES.

See also configuration

Run

make init

to create the inital development setup

Initialize application

Run inital setup with demo data migrations

make setup

Start stack

make up

or

docker-compose up -d

Open the application in your browser

open http://$DOCKER_HOST_IP:21080

Customize

Application environment variables

Persistent defaults should be set in Dockerfile

For runtime changes you can create a file under src/local.env.

edit src/local.env

Enable the host-volume by uncommenting services.php.volumes in docker-compose.dev.yml

- ./src/local.env:/app/src/local.env

Create database migrations

make bash

$ yii migrate/create first

Adjust migration code

See also create migrations from files

Apply schema changes by running the migrations.

$ yii migrate

Create frontend module & database CRUD with schmunk42/yii2-giiant

See Code generation

Install additional packages

docker cp $(docker-compose ps -q php):/app/composer.json .

Edit run composer require or edit composer.json

composer update -vv

edit Dockerfile

docker-compose build

:exclamation: Running composer updates in a Docker container might be pretty slow if you are using host-volumes on OS X. See also: issue.

See also Composer update

Test

Make sure you have set a unique COMPOSE_PROJECT_NAME in project/tests/.env-dist

cd tests
docker-compose up -d

Run tests

docker-compose run --rm php codecept run

See testing

Makefile support

Copy Makefile and Makefile.base from phd5.

Build

Setup build

GitLab setup

• REGISTRY_HOST

See also CI

Travis

Enable Travis build https://travis-ci.org/profile/schmunk42

GitHub Services > Travis https://github.com/schmunk42/planck/settings/installations

Release

DockerHub setup

Set ENV settings

• REGISTRY_PASS
• REGISTRY_USER
• DEPLOY_TOKEN

Deploy

curl -X POST \
  -F token=${GITLAB_PROJECT_TOKEN} 
  -F "ref=master" 
  -F "variables[TRIGGER_STACK_DIR]=demos/${TRAVIS_REPO_SLUG}" 
  https://{$GITLAB_HOSTNAME}/api/v3/projects/${GITLAB_PROJECT_ID}/trigger/builds

See also Environments