BuildBox
The repository provides a complete set of build tools for web developers. These images MUST NOT be used in production. The targeted usage of those images is GitlabCI.
Versions
Please review the CHANGELOG.md file for versions per tag.
Testing
Each box is tested and built using TravisCI.
CI workflow:
- PR: only images with modified files are built.
- Merge to master: only images with modified files are built and pushed to the docker registry with the tag
latest-IMAGE
- TAG: all images are built and pushed to the docker registry
- Nightly: all images are built and pushed to the docker registry with the tag
nightly-IMAGE
Local testing
To contribute you will need python3.6 and pipenv (installed by pip install pipenv
).
- Clone the repo
- Create your pipenv environnement
pipenv install
- Load your pipenv
pipenv shell
- Run the script
python travis.py build --image image --version version
$ python travis.py build --help
Usage: travis.py build [OPTIONS]
Options:
--image TEXT image to build
--version TEXT image version
-d, --debug debug
--help Show this message and exit.
$ python travis.py build --image java --version 11
> Building: ekino/docker-buildbox:latest-java11
Build succesfull
> Testing ekino/docker-buildbox:latest-java11
Tests successful
Adding your image to the build box
Create a directory named after your image and corresponding Dockerfile in it. Then add an entry in config.yml
according to this schema:
image_name:
version:
test_config:
volume: ... # docker volume if needed, format: localdir:/path/to/mount
cmd: [...] # shell commands run to be sure tools are well installed
build_args: [...] # If ARG are defined in Dockerfile
template_vars: [...] # If templated Dockerfile
dockerfile_dir: /path/to/dockerfile # If Dockerfile's path is not ./<image_name>/Dockerfile
Make sure the image_name
in the config file entry matches your directory.
Do not forget to add an entry in .travis.yml
too following other image scheme.
Volume mounting for test configuration only need the directory name as full local path is build by the script.
Available images
Ansible
Contains Ansible, CI Helper and Python 2.7
Arachni
Contains Arachni + CI Helper
To run the web UI:
docker run -d -p 9292:9292 ekino/docker-buildbox:latest-arachni1.5 arachni_web -o 0.0.0.0
Then go to http://localhost:9292
AWS
Contains AWS Cli, AWS EB Cli, CI Helper and jq.
AWSLinux systemd
Amazon Linux based image containing Systemd for service management in docker container.
Azure
Contains Azure Cli and Terraform.
Chrome
Contains Chromium browser and the latest Node LTS.
DIND - AWS
Adds AWS Cli & CI Helper to GitLab's dind image (to run docker in a GitLab runner).
Use case:
# .gitlab-ci.yml
test:
image: ekino/docker-buildbox:latest-dind-aws
services:
- ekino/docker-buildbox:latest-dind-aws
variables:
DOCKER_DRIVER: overlay2
DOCKER_HOST: "tcp://ekino__docker-buildbox:2375"
script:
- docker ...
Golang
Based upon official Golang image, contains glide, gin, AWS Cli and CI Helper.
Java
Contains AWS Cli, CI Helper, Maven, Graphviz, jq and Java.
Kubectl
Contains kubectl, kubens, kubectx, kube-score.
Node
Contains node (installed in the NODE_VERSION env var value), CI Helper and AWS Cli.
PHP
Contains PHP (installed from official alpine in the PHP_VERSION env var value) within Blackfire, Composer, PHP CS Fixer, Security Checker, AWS Cli and CI Helper.
About Blackfire, please read the official documentation to install the agent https://blackfire.io/docs/integrations/docker, then you should be able to profile a PHP script like this:
docker exec -it -e BLACKFIRE_CLIENT_ID -e BLACKFIRE_CLIENT_TOKEN my-php-container blackfire run bin/console app:foo:bar
Platform.sh CLI
Based on python 3.6 alpine image, contains php7 and platform.sh CLI.
Python
Contains Python with PIP and PIPENV.
React Native Android
Contains Java 8, Gradle, Android SDK, Node 7.10 and React Native Cli
Ruby
Contains Ruby (installed from official alpine) and CI Helper.
Scoutsuite
Contains ScoutSuite cloud scanner.
Serverless
Contains node Serverless module with python3.
SonarQube Scanner
Contains SonarQube Scanner and CI Helper.
Terraform
Contains Terraform and AWS Cli.