D2 Ansible playbooks v 19.10.0

This document (version 19.10.0) describes the D2 Ansible playbooks [*] (ansible-dims-playbooks for short) repository contents.

Contents:

• 1. Introduction
  • 1.1. Installation Steps
• 2. Ansible and Configuration Management
  • 2.1. Ansible fundamentals
  • 2.2. Variables
  • 2.3. Configuration and Customization of ansible and ansible-playbook
    • 2.3.1. Controlling account, SSH port, etc.
  • 2.4. Lessons from the Fedora Project Ansible Playbooks
  • 2.5. Generating iptables Rules from a Template
  • 2.6. Customization of System and Service Configuration
  • 2.7. Tags on Tasks
    • 2.7.1. DIMS Tagging Methodology
    • 2.7.2. Examples of DIMS Tags
  • 2.8. Ansible Best Practices and Related Documentation
• 3. Developing in the Cloud
  • 3.1. Developing on DigitalOcean
    • 3.1.1. Getting Started
    • 3.1.2. Bootstrapping DigitalOcean Droplets
    • 3.1.3. Creating DigitalOcean Resources
    • 3.1.4. Bootstrapping DigitalOcean Droplets
    • 3.1.5. Backing Up Certificates and Trident Portal Data
    • 3.1.6. Destroying DigitalOcean Resources
• 4. Developing Locally
  • 4.1. Initial Connectivity
  • 4.2. Establishing Full Internet Connectivity
  • 4.3. Bootstrapping Full Ansible Control
  • 4.4. Integration into Working Inventory
  • 4.5. Normal Playbook Operations
  • 4.6. Validating VNC over SSH Tunnelling
  • 4.7. Creating VMs
    • 4.7.1. Manual Installation of Virtual Machines
    • 4.7.2. Bootstrapping the New VMs
    • 4.7.3. Initial Provisioning of the New VMs
• 5. Customizing a Private Deployment
  • 5.1. Cookiecutter
    • 5.1.1. Top Level Files and Directories
    • 5.1.2. The dims-new-repo Cookiecutter
    • 5.1.3. The dims-private Cookiecutter
  • 5.2. Populating the Private Configuration Repository
• 6. Testing System Components
  • 6.1. Organizing Bats Tests
  • 6.2. Organizing tests in DIMS Ansible Playbooks Roles
  • 6.3. Running Bats Tests Using the DIMS test.runner
  • 6.4. Controlling the Amount and Type of Output
    • 6.4.1. Using DIMS Bash functions in Bats tests
• 7. Debugging with Ansible and Vagrant
  • 7.1. Debugging Ansible
    • 7.1.1. Examining Variables
    • 7.1.2. Debugging Filter Logic
    • 7.1.3. Developing Custom Jinja Filters
• 8. Regular System Maintenance
  • 8.1. Updating Operating System Packages
  • 8.2. Renewing Letsencrypt Certificates
  • 8.3. Updating Secondary Components
    • 8.3.1. Updating Vagrant Plugins
    • 8.3.2. Updating PyCharm Community Edition
• 9. Backups and Restoration
  • 9.1. Backup Directories and Files
  • 9.2. Creating a Backup
  • 9.3. Restoring from a Backup
  • 9.4. Scheduled Backups
  • 9.5. Other System Backups
• 10. License
• 11. Appendices
  • 11.1. Quick Steps to Restarting Squid Proxy Container
  • 11.2. Recovering From Operating System Corruption
  • 11.3. Advanced Ansible Tasks or Jinja Templating
    • 11.3.1. Multi-line fail or debug Output
  • 11.4. Leveraging the Terraform State File
    • 11.4.1. Introduction to jq
    • 11.4.2. Processing terraform output --json

[*]	D2 is a fork of the original DIMS Ansible Playbooks.

Section author: Dave Dittrich dave.dittrich@gmail.com

Copyright © 2018 David Dittrich. All rights reserved.