okd-installer - Getting Started

TODO / WIP page

This page is not completed!

Overview of the stack delivered by Ansible Collectio okd-installer:

okd-installer's specific Ansible Playbook and Roles
generic cloud provisioning Ansible Roles

TODO Content for Getting started

Guides:

Quick Install
Quick Setup
Quick Create Cluster
Quick Test
References more Installing Guides

See Next

---

TODO review and distribute items below to specific docs:

Install Ansible Collection `okd-installer`

Install and configure Ansible

Install Ansible
```
pip3 instlal requirements.txt
```
Create the configuration

cat << EOF > ./ansible.cfg
 $ cat ansible.cfg 
[defaults]
collections_path=./collections
EOF

Install the Collection

git clone git@github.com:mtulio/ansible-collection-okd-installer.git collections/ansible_collections/mtulio/okd_installer/

Install the OpenShift Clients

The binary path of the clients used by installer is ${HOME}/.ansible/okd-installer/bin, so the utilities like openshift-installer and oc should be present in this path.

To check if the clients used by installer is present, run the client check:

ansible-playbook mtulio.okd_installer.install_clients

To install you should have one valid pull secret file path exported to the environment variable CONFIG_PULL_SECRET_FILE. Example:

export CONFIG_PULL_SECRET_FILE=/home/mtulio/.openshift/pull-secret-latest.json

To install the clients you can run set the version and run:

ansible-playbook mtulio.okd_installer.install_clients -e version=4.11.4

Example of configuration

This is one example how to create the configuration.

Export the environment variables

The environment variables is the only steps supported at this moment. We will add more examples in the future to create your own playbook setting the your custom variables.

Generate the Configuration

To generate the install config, you must set variables (defined above) and the cluster_name:

ansible-playbook mtulio.okd_installer.config \
    -e mode=create \
    -e cluster_name=${CONFIG_CLUSTER_NAME}

The install-config.yaml will be available on the path: ${HOME}/.ansible/okd-installer/clusters/${CONFIG_CLUSTER_NAME}/install-config.yaml.