Jenkins Vagrant Saltstack
- creates a new virtualbox with masterless saltstack
- install Jenkins with Plugins and job as example
First install of the VirtualBox with Vagrat
vagrant up
After installation call "localhost:8081" from your host browser.
- You need to answer the few question from the installation wizzard.
- done and ready for work
In the VirtualBox, you can find important folders mounted from the host:
- /etc/salt
- /srv/salt/
- /var/www/
- /var/www/jenkins/jobs
Jenkins WebGui is forwared to the host!
- config.vm.network :forwarded_port, guest: 80, host: 8080
- config.vm.network :forwarded_port, guest: 8080, host: 8081
Features
- Java 8
- Jenkins
- Salstack SLS automatic usage of pre-created admin:password from file /var/lib/jenkins/secrets/initialAdminPassword
- plugins
- Github Plugin
- Green Balls
Your PHP project configuration
In your composer load the dev tools you require (i.e. PHPUnit, phpcpd, phpmd, phpcs etc) & have these run via Ant. This will allow one to control the version of the dev tools they use & allow developers to run them locally as well. Allowing Jenkins CI to focus on Continuous Integration.
Config examples (coming soon)
- Composer.json (composer)
- phpunit.xml (phpunit)
- build.xml (ant)
- job-config.xml (jenkins ci)
Recomended project directory structure (required folders/files)
- composer.json
- composer.lock
- tests/phpunit.xml
- tests/build.xml
- tests/build/.gitignore (git ignore this directory contents - will contain code coverage etc)
- tests/job-config.xml
Debugging
If you want to see a full list of what Salt is doing you can add the following line to the VagrantFile
salt.verbose = true
Or use flag below when running vagrant command
--debug
Using Salt from the Box
vagrant ssh
Box update and pre-configure with:
salt-call state.highstate
install plugins:
salt-call state.sls jenkins-plugins
install jobs:
salt-call state.sls jenkins-jobs