ocp_ignition

insidegroup.ocp_ignition

⭐ Star us on GitHub — it motivates us a lot!

Create ignition files to install Red Hat Openshift or OKD

Platforms Supported:

Platform	Versions
Ubuntu	focal, jammy
Fedora	all

⚠️ Requirements

Ansible >= 2.9.

Ansible role dependencies

None.

⚡ Installation

Install with Ansible Galaxy

ansible-galaxy install insidegroup.ocp_ignition

Install with git

If you do not want a global installation, clone it into your roles_path.

git clone https://github.com/InsideCommunity/ocp_ignition.git  insidegroup.ocp_ignition

But I often add it as a submodule in a given playbook_dir repository.

git submodule add https://github.com/InsideCommunity/ocp_ignition.git roles/insidegroup.ocp_ignition

As the role is not managed by Ansible Galaxy, you do not have to specify the github user account.

✏️ Example Playbook

Basic usage is:

- hosts: all
  roles:
    - role: insidegroup.ocp_ignition
      vars:
        ocp_ignition_base_domain: example.com
        ocp_ignition_butane_boot_device: {}
        ocp_ignition_butane_disabled: false
        ocp_ignition_butane_passwd: {}
        ocp_ignition_butane_storage:
          files:
            - contents:
                inline: Ansible Generated file from ocp_ignition role provided by InsideGroup(www.insidegroup.fr)
              mode: 420
              path: /etc/ignition_example_file
          filesystems:
            - device: /dev/mapper/root
              format: xfs
              wipe_filesystem: true
          luks:
            - device: /dev/disk/by-partlabel/root
              key_file:
                inline: AZERTyuiop
              name: luks-root
        ocp_ignition_cluster_name: ocp4
        ocp_ignition_config_cluster_networks:
          - cidr: 10.128.0.0/14
            hostPrefix: 23
        ocp_ignition_config_proxy: {}
        ocp_ignition_config_pull_secret: ''
        ocp_ignition_config_service_networks:
          - 172.30.0.0/16
        ocp_ignition_config_ssh_key: ''
        ocp_ignition_config_trust_bundle: ''
        ocp_ignition_dest: /var/www/html/example/ignitions
        ocp_ignition_ocp_version: 4.12.0
        ocp_ignition_private_dest: /home/user/ignitions
        ocp_ignition_role: controler
        ocp_ignition_safe_mode: true

⚙️ Role Variables

Variables are divided in three types.

The default vars section shows you which variables you may override in your ansible inventory. As a matter of fact, all variables should be defined there for explicitness, ease of documentation as well as overall role manageability.

The context variables are shown in section below hint you on how runtime context may affects role execution.

Default variables

Role default variables from defaults/main.yml.

Variable Name	Value
ocp_ignition_ocp_version	4.12.0
ocp_ignition_safe_mode	True
ocp_ignition_private_dest	/home/user/ignitions
ocp_ignition_dest	/var/www/html/example/ignitions
ocp_ignition_role	controler
ocp_ignition_cluster_name	ocp4
ocp_ignition_base_domain	example.com
ocp_ignition_butane_disabled	False
ocp_ignition_butane_storage	[]
ocp_ignition_butane_passwd	{}
ocp_ignition_butane_boot_device	{}
ocp_ignition_config_proxy	{}
ocp_ignition_config_trust_bundle
ocp_ignition_config_cluster_networks	- cidr: 10.128.0.0/14 hostPrefix: 23
ocp_ignition_config_service_networks	- 172.30.0.0/16
ocp_ignition_config_pull_secret
ocp_ignition_config_ssh_key

Focus on ocp_ignition_butane_storage if you needed to customize networking

# Should be defined in host_vars or both group_vars and host_vars
ocp_ignition_butane_storage:
files:
- contents:
    inline: Ansible Generated file from ocp_ignition role provided by InsideGroup(www.insidegroup.fr)
  mode: 420
  path: /etc/ignition_example_file
filesystems:
- device: /dev/mapper/root
  format: xfs
  wipe_filesystem: true
luks:
- device: /dev/disk/by-partlabel/root
  key_file:
    inline: AZERTyuiop
  name: luks-root