debops / examples

Repository with example DebOps projects

DebOps Examples

This is a repository of example DebOps projects - mostly Ansible inventories and some additional Bash scripts, when user needs to perform actions outside Ansible.

Further documentation will be added at a later time.

Basic examples

• vagrant-multi-machine: Using Debops with a multi-machine Vagrantfile
• webhost-gitusers-dokuwiki: Setting up a Webserver with nginx, docuwiki and gituser.
• testing-roles-rolespec-vagrant: Setting up a virtual machine (using Vagrant) for testing roles using rolespec

Advanced examples

• debops-bootstrap: Bootstrap a DebOps virtual machine with Vagrant and run debops against it.
• devlab: manage a "development lab" on an Ubuntu/Xubuntu host with KVM virtual machines guests, which also are LXC hosts for containers.

Other examples

• vagrant-ansible-single-machine: Using Ansible (but not debops) with a single Vagrant box.

examples's Issues

how do I contribute with an example?

Can I use DebOps to setup a similar setup like this https://github.com/FriendsOfCake/vagrant-ansible#vagrant-ansible-for-cakephp?

webhost-gitusers-dokuwiki example doesn't show dokuwiki

I expected the example to have dokuwiki installed, but it's not installed.

I guess that the machine needs to be grouped into the debops_dokuwiki group.

Also, when loading the machine's address in a web browser, the nginx default page is shown. It's unclear how to open the dokuwiki.

vagrant-multi-machine

To simplify the Ansible/Vagrant issue I created a basic provisioner which outputs the vagrant file to wherever you like. You can then run Ansible or Debops outside of Vagrant as normal. Using a custom provisioner means you don't need to create a dummy playbook, vagrant won't try to run Ansible at all and you can specify where you want the inventory to be created, so you don't have to use symlinks. It also means you don't have to deal with port numbers and ssh keys like you would with a hand-crafted inventory file.

I haven't yet fixed the issue of it running for each machine defined in the Vagrantfile , but doing so doesn't hurt anything and is easy to work around.

bootstrapping vm fails

Trying to bootstrap a VM in multi VM environment:

$ ANSIBLE_SSH_ARGS="-o UserKnownHostsFile=/dev/null" debops boostrap -l h1 -u root -k
Running Ansible playbooks:
/usr/local/lib/python3.8/site-packages/debops/ansible/playbooks/site.yml
ERROR! the playbook: boostrap could not be found

On a mac with brew installed ansible, debops via pip. Any ideas?

webhost-gitusers-dokuwiki example documentation wrong

currently, the documentation states

    ANSIBLE_SSH_ARGS="-o UserKnownHostsFile=/dev/null" debops ./simpletest.yml

that should probably be test.yml as the simpletest.yml file does not exist.

Also, I recommend explicitly calling env as putting the variables in front is a bashism.

But running test.yml yields:

env ANSIBLE_SSH_ARGS="-o UserKnownHostsFile=/dev/null" debops test.yml 
Running Ansible playbook from:
test.yml ...
ERROR: debug is not a legal parameter in an Ansible task or handler