Prepare your system to be managed by Ansible.
Go to file
Robert de Bock 38f3b8637f Ubuntu Noble. 2024-04-26 14:16:19 +02:00
.github Ubuntu Noble. 2024-04-26 14:16:19 +02:00
defaults Change yes/no to true/false, adhere to yamlspec 1.2.2 2024-03-18 09:52:29 +01:00
meta Change yes/no to true/false, adhere to yamlspec 1.2.2 2024-03-18 09:52:29 +01:00
molecule/default More booleans set to true/false. 2024-03-20 11:26:39 +01:00
tasks Change yes/no to true/false, adhere to yamlspec 1.2.2 2024-03-18 09:52:29 +01:00
vars executable file `LANG=C` not found. 2023-08-24 15:49:38 +02:00
.ansible-lint Allow "yes" and "no" as truthy values, more English, more readable. 2024-03-15 10:40:08 +01:00
.gitignore Make unused variable finding work on Mac OS X 2021-03-25 15:04:23 +01:00
.gitlab-ci.yml Ubuntu Noble. 2024-04-26 14:16:19 +02:00
.pre-commit-config.yaml Updated action and container, newer components. 2023-11-11 09:15:41 +01:00
.yamllint More booleans set to true/false. 2024-03-20 11:26:39 +01:00
CODE_OF_CONDUCT.md Adding community guidelines. 2018-03-02 07:40:29 +01:00
CONTRIBUTING.md Happy 2024\! 2024-01-02 08:51:26 +01:00
LICENSE Happy 2024\! 2024-01-02 08:51:26 +01:00
README.md Change yes/no to true/false, adhere to yamlspec 1.2.2 2024-03-18 09:52:29 +01:00
SECURITY.md Update components, regenerate files. 2023-02-28 11:55:27 +01:00
requirements.txt Updated action and container, newer components. 2023-11-11 09:15:41 +01:00
requirements.yml Remove not-required collections, add collections that are required, FQCN. 2022-01-25 21:52:31 +01:00
tox.ini Test and Ansible 8 AND 9. 2023-11-26 11:56:53 +01:00

README.md

Ansible role bootstrap

Prepare your system to be managed by Ansible.

GitHub GitLab Downloads Version
github gitlab downloads Version

Example Playbook

This example is taken from molecule/default/converge.yml and is tested on each push, pull request and release.

---
- name: Converge
  hosts: all
  # This role installs packages using the `raw` module and needs to connect as
  # `root`. (`sudo` is not available before bootstrapping.) All tasks in the
  # role have `become` set to `false`, so you can use either `false` or `true`
  # for `become`, the role will not use become (so `sudo`) for any task.
  become: true  # `false` will also work.
  # This role installs python, gathering facts can't be done before `python` is
  # installed. This role runs the `setup` module, so facts will be available
  # after running the role.
  gather_facts: false

  roles:
    - role: robertdebock.bootstrap

Also see a full explanation and example on how to use these roles.

Role Variables

The default values for the variables are set in defaults/main.yml:

---
# defaults file for bootstrap

# Do you want to wait for the host to be available?
bootstrap_wait_for_host: false

# The number of seconds you want to wait during connection test before failing.
bootstrap_timeout: 3

# Tell the role to "become" or not.
bootstrap_become: true

Requirements

Context

This role is a part of many compatible roles. Have a look at the documentation of these roles for further information.

Here is an overview of related roles: dependencies

Compatibility

This role has been tested on these container images:

container tags
Alpine all
Amazon Candidate
EL all
Debian all
Fedora all
opensuse all
Ubuntu all

The minimum version of Ansible required is 2.12, tests have been done to:

  • The previous version.
  • The current version.
  • The development version.

If you find issues, please register them in GitHub.

License

Apache-2.0.

Author Information

robertdebock

Please consider sponsoring me.