This project spins up a VM running Jenkins CI, and then you can create a job to run a local Ansible playbook which will be run on the local machine via a Jenkins job.
- Download and install VirtualBox.
- Download and install Vagrant.
- [Mac/Linux only] Install Ansible.
Note for Windows users: This guide assumes you're on a Mac or Linux host. Windows hosts are unsupported at this time.
- Download this project and put it wherever you want.
- Open Terminal, cd to this directory (containing the
Vagrantfile
and this README file). - Run
ansible-galaxy install -r requirements.yml
to install required Ansible roles. - Type in
vagrant up
, and let Vagrant do its magic.
Note: If there are any errors during the course of running vagrant up
, and it drops you back to your command prompt, just run vagrant provision
to continue building the VM from where you left off. If there are still errors after doing this a few times, post an issue to this project's issue queue on GitHub with the error.
- Edit your hosts file, adding the line
192.168.76.76 jenkinsci.test
so you can connect to the VM. - Open your browser and access https://jenkinsci.test:8080.
- To shut down the virtual machine, enter
vagrant halt
in the Terminal in the same folder that has theVagrantfile
. To destroy it completely (if you want to save a little disk space, or want to rebuild it from scratch withvagrant up
again), type invagrant destroy
.
This project was created by Jeff Geerling as an example for Ansible for DevOps.