picardrulez / admin-tools

Ansible playbooks and other admin tools used to administrate #! servers

#! Admin Tools

Ansible playbooks and other admin tools/docs for maintaining the #! network.

Requirements

• Recent version of Ansible
• Local #! pass database
• User with sudo access on all servers

Playbooks

There are 3 playbooks present here:

• shell.yml is used to synchronise the configuration (incl. installed packages) across the shell servers.
• credentials.yml is used to deploy the admin's SSH keys across all servers:
  • admins can login as root on the shell servers;
  • they can login as core on the CoreOS servers.
• coreos.yml performs CoreOS-specific tasks. Currently, it only bootstraps tha Ansible agent's dependencies.

Usage

Install a package

1. Connect to any shell server as yourself

   ssh [e-mail]

2. Install Package

   sudo apt-get install some-package

3. Deploy changes on other servers

   The configuration changes (including packages.txt) should have been auto-pushed to shell-etc. Now, you only need to re-sync the servers:

   ansible-playbook --ask-become-pass sync.yml

Making a configuration change

1. Connect to any shell server as yourself

   ssh [e-mail]

2. Make and test any desired changes to files in /etc

   sudo vim /etc/some-config/file

3. Commit changes via etckeeper

   sudo etckeeper commit -m 'updated some-config with some change'

Sync packages/config across all servers

1. Run Ansible playbook "sync"

   ansible-playbook --ask-become-pass -u your-sudo-user sync.yml