{"id":15157699,"url":"https://github.com/appuio/puppet-openshift","last_synced_at":"2025-10-21T01:56:52.647Z","repository":{"id":44920765,"uuid":"99595442","full_name":"appuio/puppet-openshift","owner":"appuio","description":"Simple Puppet module to manage Ansible and the OpenShift Ansible inventory","archived":true,"fork":false,"pushed_at":"2022-06-26T09:12:41.000Z","size":61,"stargazers_count":2,"open_issues_count":1,"forks_count":3,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-01-17T03:10:00.002Z","etag":null,"topics":["ansible","openshift","openshift-ansible","puppet"],"latest_commit_sha":null,"homepage":null,"language":"Puppet","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/appuio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-07T15:58:05.000Z","updated_at":"2023-05-03T15:49:22.000Z","dependencies_parsed_at":"2022-09-05T17:42:04.745Z","dependency_job_id":null,"html_url":"https://github.com/appuio/puppet-openshift","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appuio%2Fpuppet-openshift","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appuio%2Fpuppet-openshift/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appuio%2Fpuppet-openshift/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appuio%2Fpuppet-openshift/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/appuio","download_url":"https://codeload.github.com/appuio/puppet-openshift/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234712845,"owners_count":18875521,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["ansible","openshift","openshift-ansible","puppet"],"created_at":"2024-09-26T20:01:42.216Z","updated_at":"2025-09-30T07:30:39.963Z","avatar_url":"https://github.com/appuio.png","language":"Puppet","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Puppet module for managing OpenShift - the Ansible part\n\n#### Table of Contents\n\n1. [Description](#description)\n2. [Setup - The basics of getting started with openshift](#setup)\n    * [What openshift affects](#what-openshift-affects)\n    * [Setup requirements](#setup-requirements)\n    * [Beginning with openshift](#beginning-with-openshift)\n3. [Usage - Configuration options and additional functionality](#usage)\n4. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\n5. [Limitations - OS compatibility, etc.](#limitations)\n6. [Development - Guide for contributing to the module](#development)\n\n## Description\n\nThis Puppet module manages Ansible for setting up an OpenShift cluster with the official\n[openshift-ansible](https://github.com/openshift/openshift-ansible) Playbooks.\n\n## Setup\n\n### What `openshift` affects\n\nThe module has two \"roles\":\n\n* `openshift::role::ansible_master`:\n  * Installs Ansible\n  * Checks out `openshift-ansible` from git\n  * Configures SSH for Ansible\n  * Writes the inventory file in YAML format\n* `openshift::role::node`:\n  * Installs required packages\n  * Enables NetworkManager\n  * Add some missing CA certificates\n\n### Setup Requirements\n\nRequired modules:\n\n* [vcsrepo](https://forge.puppet.com/puppetlabs/vcsrepo)\n* [inifile](https://forge.puppet.com/puppetlabs/inifile)\n\n### Beginning with `openshift`\n\nOn the host you want to run Ansible, apply the `ansible_master` role and pass the inventory to it:\n\n```puppet\nclass { 'openshift::role::ansible_master':\n  host_groups =\u003e {\n    'OSEv3' =\u003e {\n      children =\u003e [\"nodes\", \"masters\"],\n    },\n    masters =\u003e {\n      vars =\u003e {\n        osm_default_node_selector =\u003e \"foo=bar\",\n      },\n      hosts =\u003e {\n        \"master1.example.com\" =\u003e {},\n        \"master2.example.com\" =\u003e {},\n      },\n      children =\u003e [\"etcd\"],\n    },\n    nodes =\u003e {\n      hosts =\u003e {\n        \"node[1:9].example.com\" =\u003e {\n          custom_var =\u003e true,\n        },\n      },\n    },\n  }\n}\n```\n\nThis parameters can also be configured in Hiera.\n\nAn all nodes, apply the `node` role:\n\n```puppet\nclass { 'openshift::role::node': }\n```\n\n## Usage\n\n## Reference\n\n### Classes\n\n#### Public Classes\n\n* `openshift::role::ansible_master`: Installs and configures Ansible.\n\n[*host_groups*]\n  Default: {}. Hash of Ansible inventory data.\n\n[*playbooks_source*]\n  Default: https://github.com/openshift/openshift-ansible.git.\n  Git repository where the Ansible plabooks are stored.\n\n[*playbooks_version*]\n  Default: master\n  Git reference to check out\n\n* `openshift::role::node`: Prepares node for OpenShift.\n\nNo parameters available.\n\n## Limitations\n\nThis Puppet module only runs on CentOS and RHEL.\n\n## Development\n\n1. Fork it (https://github.com/appuio/puppet-openshift/fork)\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappuio%2Fpuppet-openshift","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fappuio%2Fpuppet-openshift","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappuio%2Fpuppet-openshift/lists"}