jonaspammer.bootstrap
Sure! Here’s a simplified and easy-to-understand translation of the text:
This file is created automatically by a workflow in GitHub, so any changes you make here will be lost eventually.
Ansible Role: Bootstrap
Author: Jonas Pammer (opensource@jonaspammer.at)
Description: This Ansible role helps set up a Linux system to be managed by Ansible. It installs essential packages like python
and sudo
using a built-in module and a custom system to detect the operating system.
Updates: The role keeps the package cache updated on most systems. It is recommended to use this role with another role called core_dependencies
.
Disclaimer
This role is based on a version created by Robert de Bock, with several updates and improvements made by Jonas Pammer.
Metadata
- Required Ansible Version: 2.9 or higher
- Supported Platforms:
- EL (e.g., Rocky Linux 9)
- Fedora (e.g., versions 38 and 39)
- Debian (e.g., Bullseye and Bookworm)
- Ubuntu (e.g., Focal and Jammy)
Role Variables
bootstrap_user
: User set toroot
bootstrap_become
: Default value isfalse
, assumingsudo
isn't available initially.bootstrap_wait_for_host
: Whether to wait for the host to be ready on port22
.bootstrap_timeout
: Time in seconds to wait for the remote system to respond.
Example Usage
Basic Setup: To set up Linux machines for management by Ansible:
- hosts: servers:&provisioned roles: - role: jonaspammer.bootstrap
Change User: If
root
isn't available, specify another user:vars: bootstrap_user: "{{ ansible_user }}"
Using Sudo: If you have
sudo
, you can enable it:vars: bootstrap_become: true
Testing
This role has been tested on various Linux distributions with specific versions.
Contributing
You're welcome to contribute to this project. Please create issues or pull requests to suggest changes or fix problems. Follow these steps:
- Fork the repository.
- Clone your fork.
- Make changes on a new branch.
- Push to your fork and create a pull request.
License
This project is licensed under the MIT License.
Feel free to ask if you need further modifications or details!
An ansible role for preparing a linux system to be managed by ansible. Based on robertdebock's role.
ansible-galaxy install jonaspammer.bootstrap