Bootstrap

This package helps set up your system to be managed by Ansible.

Example Playbook

This example comes from molecule/resources/playbook.yml and is tested for every code change and release.

---
- name: Setup System
  hosts: all
  become: yes
  gather_facts: no

  roles:
    - robertdebock.bootstrap

If you are using this on a machine, you might need to prepare it. I use this playbook to make sure everything is set up correctly.

No preparation needed.

After running this role, this playbook checks if everything is working properly. It’s a good example of how to use this role.

---
- name: Check Connection
  hosts: all
  become: no
  gather_facts: yes

  tasks:
    - name: Test Connection
      ping:

You can find a detailed explanation and examples on using these roles.

Role Variables

These values are found in defaults/main.yml:

---
# Default settings for bootstrap

# User to connect to machines.
bootstrap_user: root

# Should we wait for the host to be ready?
bootstrap_wait_for_host: no

# Seconds to wait during connection testing before failing.
bootstrap_timeout: 3

# Number of attempts during installation
bootstrap_retries: 3

Requirements

• Access to an online package repository.
• A recent version of Ansible. (Tests are run on the current, previous, and next versions of Ansible.)

To meet the requirements, you can install the following roles using ansible-galaxy install -r requirements.yml:

- none

Context

This role is part of numerous compatible roles. Check out the documentation for these roles for more details.

Here's a visual of related roles:

Compatibility

This role has been tested on these container images:

Container	Tags
amazon	all
alpine	all
archlinux	all
debian	all
el	7, 8
fedora	all
opensuse	all
sles	all
ubuntu	artful, bionic

The minimum required Ansible version is 2.8, but tests have been conducted on:

• The previous version and older ones.
• The current version.
• The development version.

Testing

Unit tests are done for every commit, pull request, release, and periodically.

If you encounter issues, please report them on GitHub.

Testing is done using Tox and Molecule:

Tox tests multiple versions of Ansible. Molecule tests multiple distributions.

To test using the defaults (any installed Ansible version, namespace: robertdebock, image: fedora, tag: latest):

molecule test

# Or choose a specific image:
image=ubuntu molecule test
# Or a specific image and tag:
image="debian" tag="stable" tox

You can also test multiple versions of Ansible and select images: Tox allows for testing of multiple Ansible versions. To run the default (namespace: robertdebock, image: fedora, tag: latest) tests:

tox

# To run CentOS (namespace: `robertdebock`, tag: `latest`)
image="centos" tox
# Customize further:
image="debian" tag="stable" tox

License

Apache-2.0

Author Information

Robert de Bock