kubespray/roles/bootstrap-os
Florian Ruynat bcf695913f
Fix Oracle yum disabled repository file after EPEL install (#7639)
2021-05-25 08:30:23 -07:00
..
defaults Initial AlmaLinux support (#7538) 2021-04-22 23:50:03 -07:00
files Fix hash of pypy3.6-v7.3.2-linux64 archive. (#6897) 2020-11-11 09:20:27 -08:00
handlers Add RHEL support subscription registration (#6572) 2020-11-24 08:33:00 -08:00
molecule/default Upgrade molecule to v3 (#6468) 2020-08-04 05:24:19 -07:00
tasks Fix Oracle yum disabled repository file after EPEL install (#7639) 2021-05-25 08:30:23 -07:00
README.md Initial AlmaLinux support (#7538) 2021-04-22 23:50:03 -07:00

README.md

bootstrap-os

Bootstrap an Ansible host to be able to run Ansible modules.

This role will:

  • configure the package manager (if applicable) to be able to fetch packages
  • install Python
  • install the necessary packages to use Ansible's package manager modules
  • set the hostname of the host to {{ inventory_hostname }} when requested

Requirements

A host running an operating system that is supported by Kubespray. See Supported Linux Distributions for a current list.

SSH access to the host.

Role Variables

Variables are listed with their default values, if applicable.

General variables

  • http_proxy/https_proxy The role will configure the package manager (if applicable) to download packages via a proxy.

  • override_system_hostname: true The role will set the hostname of the machine to the name it has according to Ansible's inventory (the variable {{ inventory_hostname }}).

Per distribution variables

Flatcar Container Linux

  • coreos_locksmithd_disable: false Whether locksmithd (responsible for rolling restarts) should be disabled or be left alone.

CentOS/RHEL/AlmaLinux

  • centos_fastestmirror_enabled: false Whether the fastestmirror yum plugin should be enabled.

Dependencies

The kubespray-defaults role is expected to be run before this role.

Example Playbook

Remember to disable fact gathering since Python might not be present on hosts.

- hosts: all
  gather_facts: false  # not all hosts might be able to run modules yet
  roles:
     - kubespray-defaults
     - bootstrap-os

License

Apache 2.0