Playground sandbox for Atlassian applications with automated server setup with vagrant. The aim of this project is to get a sandbox running in 3 steps:
~$ git clone https://github.com/wooyek/jira-sandbox.git
~$ cd jira-sandbox/
~/jira-sandbox$ vagrant up full
…assuming that you have all prerequisite tools installed and Atlassian software downloaded (see below)
Before you can enjoy quick virtual machine provisioning you need to install VirtualBox and Vagrant
On widnows please open an administrative cmd.exe command prompt and run these commands there
@powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin
choco install git
choco install vagrant
choco install putty
vagrant plugin install vagrant-multi-putty
If you like to have total control over what and how software is intalled on your machine, please install there manually:
I you want to have an ssh access to the virtual machine you should install PuTTY
on windows.
On linux you should have an ssh
tool installed by default.
Please download Atlassian software installation files and put them in downloads folder:
You can download them with download-x64.sh script. Or manually
- atlassian-jira-software-7.0.0-jira-7.0.0-x64.bin
- atlassian-servicedesk-3.0.0-jira-7.0.0-x64.bin
- atlassian-confluence-5.8.14-x64.bin
- atlassian-bitbucket-4.0.2-x64.bin
- atlassian-bamboo-5.9.4.tar.gz
To use this sandbox you'll need to map few domains to VM private network IPs. You'll need admin privileges to do this.
On Windows host edit %SystemRoot%\System32\drivers\etc\hosts
file:
On Linux host edit /etc/hosts
file:
…and append it with contents of hosts.txt file.
To finish setting up this sandbox run:
jira-sandbox$ vagrant up full
or
jira-sandbox$ vagrant up testing
See vagrant up command description for more details.
After your sandbox virtual machine is up and running, you should be able to access it through following URLs. Each time select testing configuration with built in database for quick configuration.
-
http://confluence.example.com/ During setting up user managment with JIRA user
jira-software-users
instead ofjira-users
.
I you have port 80 already taken, you can change port mapping in Vagrantfile and listening port for Nginx in atlassian.conf, then:
~$ vagrant reload
~$ vagrant ssh full
vagrant@jira-sandbox:~$ sudo cp /vagrant/atlassian.conf ./
vagrant@jira-sandbox:~$ sudo nginx -s reload
There is an experimental support for one domain and setup of all services in context paths like http://localhost/jira.
To run services on one domain you'll need to modify Tomcat configuration files on installes services. See the attlasian-one-domain.sh for examples.
Nginx configuration for this setup is in atlassian-one-domain.conf.
Please bare in mind that you'll problaby run into issues with Bitbucket as cookies can be overwritten by different services.
When you want re-provision the environment use these commands:
~/jira-sandbox$ git pull origin master
~/jira-sandbox$ vagrant destroy basic
~/jira-sandbox$ vagrant up basic