{"id":20155245,"url":"https://github.com/redhat-cop/ocp4-helpernode","last_synced_at":"2026-01-27T01:31:48.548Z","repository":{"id":37819270,"uuid":"246910822","full_name":"redhat-cop/ocp4-helpernode","owner":"redhat-cop","description":"This playbook helps set up an \"all-in-one\" node, that has all the infrastructure/services in order to install OpenShift 4. ","archived":false,"fork":false,"pushed_at":"2025-11-17T07:25:43.000Z","size":12802,"stargazers_count":349,"open_issues_count":30,"forks_count":310,"subscribers_count":41,"default_branch":"main","last_synced_at":"2025-11-17T09:17:10.616Z","etag":null,"topics":["container-cop"],"latest_commit_sha":null,"homepage":"","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/redhat-cop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-12T19:03:59.000Z","updated_at":"2025-11-17T07:25:48.000Z","dependencies_parsed_at":"2023-02-14T08:31:42.942Z","dependency_job_id":"542f27a9-ef07-4d6a-a501-770c9783d4ad","html_url":"https://github.com/redhat-cop/ocp4-helpernode","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/redhat-cop/ocp4-helpernode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Focp4-helpernode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Focp4-helpernode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Focp4-helpernode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Focp4-helpernode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/redhat-cop","download_url":"https://codeload.github.com/redhat-cop/ocp4-helpernode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redhat-cop%2Focp4-helpernode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28795468,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T01:07:07.743Z","status":"ssl_error","status_checked_at":"2026-01-27T01:07:06.974Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["container-cop"],"created_at":"2024-11-13T23:30:52.489Z","updated_at":"2026-01-27T01:31:48.530Z","avatar_url":"https://github.com/redhat-cop.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OCP4 Helper Node\n\n\u003e :heavy_exclamation_mark: *Red Hat support cannot assist with problems with this Repo*. For issues please open a GitHub issue\n\nThis playbook helps set up an \"all-in-one\" node, that has all the infrastructure/services in order to install OpenShift 4. After you run the playbook, you'll be ready to begin the installation process.\n\nA lot of OpenShift 4 specific jargon is used throughout this doc, so please visit the [official documentation page](https://docs.openshift.com/container-platform/latest) to get familiar with OpenShift 4.\n\n\u003e :warning: This playbook originally was written with BareMetal UPI install in mind\n\nThis playbook assumes the following:\n\n1. You're on a Network that has access to the internet.\n2. The network you're on does NOT have DHCP (you can disable installing DHCP on the helper).\n3. The ocp4-helpernode will be your LB/DHCP/PXE/DNS and HTTP server.\n4. You still have to do the OpenShift Install steps by hand.\n5. I used CentOS 7/8, but RHEL 7/8 will work as well.\n6. You will be running the `openshift-install` command from the ocp4-helpernode.\n\nBelow is a highlevel diagram how the ocp4-helpernode fits into your network.\n\n![ocp4-helpernode](docs/images/hn.png)\n\n\nIt's important to note that you can delegate DNS to this ocp4-helpernode if you don't want to use it as your main DNS server. You will have to delegate `$CLUSTERID.$DOMAIN` to this helper node.\n\nFor example; if you want a `$CLUSTERID` of **ocp4**, and you have a `$DOMAIN` of **example.com**. Then you will delegate `ocp4.example.com` to this ocp4-helpernode.\n\n# Using this playbook\n\nThe following are highlevel steps on how to use this playbook. There are more detailed instructions in the [\"quickstarts\"](#quickstarts) section.\n\n## Prereqs\n\n\u003e :warning: **NOTE** If using RHEL 7, you will need to enable the `rhel-7-server-rpms` and the `rhel-7-server-extras-rpms` repos. If you're using RHEL 8, you will need to enable `rhel-8-for-x86_64-baseos-rpms`, `rhel-8-for-x86_64-appstream-rpms`, and `ansible-2.9-for-rhel-8-x86_64-rpms`.\n\n\nInstall a CentOS 7 or CentOS 8 server with this recommended setup:\n\n* 4 vCPUs\n* 4 GB of RAM\n* 30GB HD\n* Static IP\n\nThere is a sample kickstart file for [EL 7](docs/examples/helper-ks.cfg) and [EL 8](docs/examples/helper-ks8.cfg) that is used during testing, if you'd like to automate the initial install of the OS.\n\nOnce the base OS is installed, install [EPEL](https://fedoraproject.org/wiki/EPEL)\n\n```\nyum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(rpm -E %rhel).noarch.rpm\n```\n\nNext install `ansible` and `git`, then clone this repo.\n\n```\nyum -y install ansible git\ngit clone https://github.com/redhat-cop/ocp4-helpernode\ncd ocp4-helpernode\n```\n\n## Setup your Environment Vars\n\nInside that dir there is a [vars.yaml](docs/examples/vars.yaml) file under `docs/examples/var.yaml` ... **__modify it__** to match your network and the environment. (the example one assumes a `/24`)\n\n```\ncp docs/examples/vars.yaml .\n```\n\n\u003e :warning: **NOTE**, currently this playbook assumes/is limited to a `/24` network\n\nSee the `vars.yaml` [documentation page](docs/vars-doc.md) for more info about what you can define. There are different options, depending on what you're doing. For example, if you're doing a static ip install vs a dhcp install.\n\n\n## Run the playbook\n\nOnce you edited your `vars.yaml` file; run the playbook\n\n```\nansible-playbook -e @vars.yaml tasks/main.yml\n```\n\n## Helper Script\n\nYou can run this script and it's options to display helpful information about the install and other post-install goodies.\n\n```\n/usr/local/bin/helpernodecheck\n```\n\n## Install OpenShift 4 UPI\n\nNow you're ready to follow the [OCP4 UPI install doc](https://docs.openshift.com/container-platform/latest/installing/installing_bare_metal/installing-bare-metal.html#ssh-agent-using_installing-bare-metal)\n\n\n# Quickstarts\n\nThe following are quickstarts. These are written using libvirt, but are generic enough to be used in BareMetal or other Virtualized Environments.\n\n\n* Bare Metal DHCP install [quickstart](docs/bmquickstart.md)\n* Bare Metal Static IPs install [quickstart](docs/bmquickstart-static.md)\n* Libvirt DHCP install [quickstart](docs/quickstart.md)\n* Libvirt Static IPs install [quickstart](docs/quickstart-static.md)\n* DHCP install on KVM/Power [quickstart](docs/quickstart-ppc64le.md)\n* DHCP install on PowerVM [quickstart](docs/quickstart-powervm.md)\n* OCP4 on VMware vSphere UPI Automation [quickstart](https://github.com/RedHatOfficial/ocp4-vsphere-upi-automation)\n* A Video \"how-to\" done on a [Twitch Stream](docs/yt-twitch.md)\n\n# Contributing\n\nPlease see the [contributing doc](docs/contribute.md) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredhat-cop%2Focp4-helpernode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredhat-cop%2Focp4-helpernode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredhat-cop%2Focp4-helpernode/lists"}