Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bukharovsi/docker_plugin
PHP Docker plugin is a plugin for composer that helps build and push docker images
https://github.com/bukharovsi/docker_plugin
build-automation build-tool continuous-integration docker docker-image dockerfile php
Last synced: 19 days ago
JSON representation
PHP Docker plugin is a plugin for composer that helps build and push docker images
- Host: GitHub
- URL: https://github.com/bukharovsi/docker_plugin
- Owner: Bukharovsi
- License: apache-2.0
- Created: 2016-09-07T21:35:10.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-05-11T15:12:50.000Z (over 7 years ago)
- Last Synced: 2024-11-15T04:36:16.728Z (about 1 month ago)
- Topics: build-automation, build-tool, continuous-integration, docker, docker-image, dockerfile, php
- Language: PHP
- Homepage:
- Size: 193 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
PHP Docker plugin
=================
[](https://travis-ci.org/Bukharovsi/docker_plugin)
[](https://www.codacy.com/app/bukharovSI/docker_plugin?utm_source=github.com&utm_medium=referral&utm_content=Bukharovsi/docker_plugin&utm_campaign=Badge_Grade)
[](https://www.versioneye.com/user/projects/58a763664ca76f0047de1714)
PHP Docker plugin is a plugin for composer that helps build and push docker images.
It is very useful for continuous integration.
This plugin allow you to define image name, compute tags and generate reports.
When you use this plugin you still need `Dockerfile`. The plugin only simplified automation build!
Basic usage
-----------
If you already have `Dockerfile` and can build image manually just install plugin and build image immediately
and push it to docker registry
```
php composer.phar require bukharovsi/docker_plugin
php composer.phar docker:build
php composer.phar docker:push
```
You will get docker image with tag: :
Advanced usage
--------------
### How to change project defaults?
Defaults can be changed in `composer.json` and with console arguments
#### Change project defaults in `composer.json`
define in `composer.json` `extra` section:
```
"extra": {
"docker": {
"name": "wine_the_pooh.com/honey",
"version": "1.0",
"dockerfile": "Dockerfile",
"workingdirectory": "."
}
}
```
all definitions are optional
#### Change project defaults with console arguments
all arguments are optional
```
php composer.phar docker:build --name wine_the_pooh.com --tag latest --dockerfile Dockerfile --workingdirectory /var/www/wine_the_pooh
```
#### Getting image version from git
If you are using Git for version control or git flow you can generate image tag based on current Git branch or Git tag.
For using this feature specify `"version":"@vcs"` in `composer.json` or add `--tag @vcs` to `composer docker:build`
and `composer docker:push` command
How does Git tag transforms to Docker tag?
| Git branch | Docker tag |
|---------------------------|-----------------------------------------------------------------------------------------------|
| master | latest, (*if commit has a git tag then it add docker tag that will be equals current git tag) |
| dev, develop, development | dev |
| any_other_branch | any_other_branch, Commit SHA |
### Integration with Teamcity
Docker plugin can notify Teamcity about built image versions. This plugin use teamcity environment variables
- `env.BuildTag`
- `env.BuildTag.1`
- `env.BuildTag.2`
- ...
- `env.BuildTag.n`
after running `composer docker:build` you can use `%env.BuildTag%` and other variables in your scripts