Koseven Docker Images

This repository holds docker images which can be used for Koseven.

There will be 4 branches which all server a different purpose:

Branch	Purpose
master	Image for a development/production environment.
travis	Image for Unit-Testing inside Travis CI (CAREFUL: Don't use on production servers.)
devel	Development Branch for master. Only latest koseven:devel version will be supproted.
travis-devel	Development Branch for travis. Only latest koseven:devel version will be supproted.

Using the container images

Using one of the container is quite straight forward. The docker repository for them is called koseven/docker.

By specifying the desired branch as docker-tag you can acquire the desired image.

Note: for pulling the master branch use latest as tag name.

e.g. This will pull the master branch image: docker pull koseven/docker:latest

e.g This will pull the travis branch image: docker pull koseven/docker:travis

After executing the docker pull command from above you're done setting up your docker image, now you can go ahead and use it!

Example for using master image

Coming Soon. Stay tuned!

Example for using travis image

For this particular Image you have multiple options.

1. Some IDE's (PHPStorm for example) have full support for docker unittesting, you just need to configure it there and you are good to go!

2. Run the tests from the cli. Execute the following cli commands (from within your Koseven installation folder):

   1. Start container in background and mount installation folder:
      docker run -dtP --name unittest -v $(pwd):/tmp/koseven/ koseven/docker:travis

   2. Start services, install composer requirements and run PHPUnit
      docker exec unittest /bin/sh -c "service redis-server start; cd /tmp/koseven; composer install; php vendor/bin/phpunit"

(Hint) You can execute a /bin/bash shell inside the container and modify it before Unit-Testing
docker exec -i -t unittest /bin/bash

For more examples / tutorials how to create and interact with container visit the official Docker Help

Roadmap

Target	Release date
Initial master image	2019.11.??
Initial travis image	2019.09.??
Initial travis-devel	2019.08.??

Contributing

As usual, fork and send pull requests

Getting Help

• Open issues in this project.