This repo combines Jenkins, Bats, and Docker together to provide a simple example of the CI/CD process. Execute build.sh
to get started.
Execute get-plugins.sh to retrieve a list of installed plugins within your Jenkins master instance. You can use make get-plugins
to call the script from within the Jenkins container.
Execute sync-plugins.sh to install all the plugins listed within the plugins.txt file. You can use make sync-plugins
to call the script from within the Jenkins container.
During your initial installation of Jenkins, execute make init-admin-password
to retrieve the initial, autogenerated administrator password. Note that this password will be visible in the shell.
A fairly simple example Jenkins file has been included. This file will execute the battery of tests included in the tests directory. A test results report will be generated using the TAPS plugin.
The Jenkins container has access to the Docker socket to facilitate communication with the Docker daemon (note that there are security implications in doing this). Both Docker
and docker-compose
are installed during the Jenkins build process, allowing docker commands to be executed within your Jenkins pipelines.
The BATS framework has been included for use during unit and integration testing. See the tests directory for some example tests that will be executed during the Jenkins pipeline. tests.bats contains a battery of simple tests to determine if Docker is correctly installed within the Jenkins container. jenkins_helper.bash is a helper bash script that can contain any reusable variables or functions that you may wish to include in your tests.