Skip to content

openshift-hub-cluster-init

Initialize hub cluster by running ansible playbook from git repository

This task runs on a hub cluster in a hub-spoke OpenShift topology. It initializes the hub cluster by:

  1. Setting up SSH access using the configured SSH key
  2. Cloning a git repository containing hub initialization playbooks
  3. Running ansible-playbook from the cloned repository

The task requires the cluster to be already deployed with kubeconfig available.

Requirements

  • OpenShift cluster must be deployed and running
  • SSH key for repository access must be configured
  • Git repository must be accessible via SSH

Parameters

  • openshift/hub-cluster-init-repo — SSH git repository URL (e.g., git@github.com:org/hub-init.git)
  • openshift/hub-cluster-init-repo-ssh-key — SSH private key for repository access

Usage

This task is typically run as part of the hub cluster initialization pipeline.

Note

The repo format is Red Hat specific and customer specific. The source of this repo should start from https://github.com/redhat-cop/gitops-standards-repo-template. You will need to work with Red Hat services to generate the playbook.yaml that will start the initialization process.

Objects that Reference openshift-hub-cluster-init

Not used in current content packs

Objects used by openshift-hub-cluster-init