Skip to content

Latest commit

 

History

History
98 lines (70 loc) · 3.7 KB

README.md

File metadata and controls

98 lines (70 loc) · 3.7 KB

Kohana.World Docker Images ( kohana.world, koseven, modseven)

License GitHub Actions Demo This repository holds docker images which can be used for Kohana Framework.

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 kohana:devel version will be supproted.
travis-devel Development Branch for travis. Only latest kohana: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

kohanaworld/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 kohanaworld/docker:latest

e.g This will pull the travis branch image: docker pull kohanaworld/docker:travis-devel

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-devel 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 Kohana installation folder): Start container in background and mount installation folder:

    docker stop unittest &&  docker rm unittest
    docker run -dtP --name unittest -v $(pwd):/tmp/kohana/ kohanaworld/docker:travis-devel
  3. Start services, install composer requirements and run PHPUnit

    docker exec unittest /bin/sh -c "service redis-server start; service memcached start"
    cd /tmp/kohana
    update-alternatives --config php
    # switch php version 
    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 -it unittest /bin/bash
cd /tmp/kohana

_(Hint) You can execute a single test

docker exec -it unittest /bin/bash
cd /tmp/kohana
composer install
php vendor/bin/phpunit   --filter HTMLTest
php vendor/bin/phpunit   --filter HTMLTest --debug 

_

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

Roadmap

Target Release date
Initial master image 2024.07.01
Initial travis image 2024.06.16
Initial travis-devel 2024.06.09

Contributing

As usual, fork and send pull requests

Getting Help

  • Open issues in this project.

TODO