Easily configure a remote machine to host your Raneto documentation.
Check out AnsibleTutorials.com for more DevOps scripts!
This repository is going to be sliced and diced into modules and then published to Ansible Galaxy.
If you like what you see, I'd suggest following me on my profile and/or sending me an email instead of starring the repo.
- Requires Mac OS X (Tested with v10.9 Mavericks)
- Tested only with Ubuntu v14.04
- VirtualBox v5.0.14
- Vagrant v1.8.1
- Vagrant Image: ubuntu/trusty64 (virtualbox, 20160127.0.0)
vagrant box add ubuntu/trusty64
- Ansible v188.8.131.52 installed with Homebrew:
$ brew install ansible
$ ansible-galaxy install -r roles.yml
1) Start Vagrant (optional, good for testing)
From the project directory run:
$ vagrant up.
This will create a new VM on your local machine and configure it to run Raneto.
That's all you need to do to deploy locally.
Check access with
$ curl -v -H "Host: devops.raneto.com" http://localhost:8888
If you want to, set the domain in /etc/hosts to point to 127.0.0.1 to access in a browser
2) Inventory Your Remote Machines
I'm using DigitalOcean as my provider, and suggest using them for the easiest compatibility.
You can use other providers or machines of your own with little to no modifications.
DigitalOcean provides VPS machines for $5/month (1 CPU, 512MB).
Use coupon code
LINUX13 to get $10 Free (I'm not affiliated with that code).
No matter what provider you choose, set a DNS record for the hostname (myhost.mydomain.com) and replace the existing hostname in the
3) Run Ansible
The following commands will configure and deploy Raneto to the machines you listed in your inventory file. If you have any problems or questions, open an issue and I'll help you.
$ ansible-playbook --inventory-file=inventory/ --ask-sudo-pass main.yml
Here's a shorter version that does the same thing:
$ ansible-playbook -i inventory/ -K main.yml
The default sudo password is
4) Adding your Raneto repository
See the new Raneto example for how to structure your project.
It's a good idea to start a new Git repository (public or private) and commit your documentation files to that repository instead of directly to a cloned copy of Raneto.
To use your Raneto project's Git repository in this deployment process:
deploy.ymland add your Git repo address
deploy.ymland change the domain
devops.raneto.comto your (sub)domain
5) Change Sudo Password (optional, recommended)
Generate a password to be used on the machines:
$ brew install python
$ pip install passlib
$ python tools/password_hasher.py [new_password]
Put the output in file
Note: Even if the password is the same, hashes will be different on each generation
- Move from Upstart to systemd
- Support Debian, CentOS, etc. out of the box
I Keep Getting Redirected!
You might be accessing the machine via IP or a site domain that has not been configured. All non-configured domains (including IPs) are redirected.
- Don't use a browser, browsers will cache the redirect for a considerable amount of time. Use the terminal instead.
- Run this command to diagnose. Make sure the "Host" header is being set to one of the configured domains.
$ curl -v -H "Host: devops.raneto.com" http://127.0.0.1:8888
The default sudo password is
SSH Key Mismatch
You may need to remove the server's record in ~/.ssh/known_hosts if the server's ip/keys change (e.g. after rebuilding the server)
Remove Old Key:
$ ssh-keygen -R [ip-or-hostname]
Creating a Machine
$ vagrant up
Run Provisioning Again (Redeploy)
$ vagrant provision
Deleting a Machine
$ vagrant destroy
SSH-ing into Vagrant:
ssh email@example.com -p 2222