{"id":18446446,"url":"https://github.com/ovh/puppet-thebastion","last_synced_at":"2025-12-11T21:22:07.982Z","repository":{"id":55867421,"uuid":"316006834","full_name":"ovh/puppet-thebastion","owner":"ovh","description":"Puppet module for Thebastion management.","archived":false,"fork":false,"pushed_at":"2025-03-05T11:08:13.000Z","size":90,"stargazers_count":7,"open_issues_count":0,"forks_count":3,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-04-04T15:18:04.654Z","etag":null,"topics":["automation","bastion","puppet"],"latest_commit_sha":null,"homepage":"https://forge.puppet.com/modules/goldenkiwi/thebastion","language":"Puppet","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ovh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-25T17:17:21.000Z","updated_at":"2025-03-05T10:43:53.000Z","dependencies_parsed_at":"2024-03-25T09:41:22.210Z","dependency_job_id":"79283e16-bb1e-4162-ba2c-7956b00223b7","html_url":"https://github.com/ovh/puppet-thebastion","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovh%2Fpuppet-thebastion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovh%2Fpuppet-thebastion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovh%2Fpuppet-thebastion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovh%2Fpuppet-thebastion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ovh","download_url":"https://codeload.github.com/ovh/puppet-thebastion/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247675598,"owners_count":20977378,"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":["automation","bastion","puppet"],"created_at":"2024-11-06T07:09:19.627Z","updated_at":"2025-12-11T21:22:02.913Z","avatar_url":"https://github.com/ovh.png","language":"Puppet","funding_links":[],"categories":[],"sub_categories":[],"readme":"Puppet-Thebastion\n=================\n\nPuppet module for Thebastion management.\n\n## Table of Contents\n\n1. [Description](#description)\n2. [Getting started](#setup)\n    * [Setup requirements](#setup-requirements)\n    * [Install and configure thebastion](#install-and-configure-thebastion)\n3. [Usage - Configuration options and additional functionality](#usage)\n4. [Limitations - OS compatibility](#limitations)\n\n## Description\n\nThis module manages:\n* Software installation (with the use of git and github).\n* Dependencies on supported OS (packages).\n* Main configuration\n* Addons configuration\n* Plugins configuration\n\n## Setup\n\n### Setup Requirements\n\nThis module has two dependencies:\n* [Concat](https://forge.puppet.com/modules/puppetlabs/concat)\n* [Stdlib](https://forge.puppet.com/modules/puppetlabs/stdlib)\n\n### Install and configure thebastion\n\nSimply call the main class in a Puppet manifest:\n\n```puppet\nclass{'thebastion': }\n```\n\n## Usage\n\n### Customize Installation\n\nTo ease integration to more complex setups, you can decide whether you want to\npull the code and/or install required system packages.\n\nFor instance, you can decide not to install dependencies packages with this\nmodule. Simply pass the relevant parameter to the class:\n\n```puppet\nclass {'thebastion':\n  install_packages =\u003e false,\n}\n```\n\n### Customize configuration and addons\n\nThis module allows every parameter to be customized via hiera, or via class\ninstantiation.\n\nYou can, for instance, change interactive mode timeout to 30 seconds:\n\n```puppet\nclass {'thebastion':\n  interactive_mode_timeout =\u003e 30,\n}\n```\n\nYou can consult [REFERENCE.md](REFERENCE.md) file for a complete list of\navailable parameters.\n\n### Customize plugins configuration\n\nFor security reasons, or simple customization of a plugin, you might want to\nchange a plugin configuration.\nYou have multiple choices in order to do this:\n\n* Instantiate a plugin configuration directly in your manifest:\n\n```puppet\nthebastion::plugin {'selfResetIngressKeys':\n  configuration =\u003e {\n    disabled =\u003e true,\n  }\n}\n```\n\n* Pass a list of plugins inside the main class:\n\n```puppet\nclass {'thebastion':\n  plugins =\u003e {\n    selfResetIngressKeys =\u003e {\n      configuration =\u003e {\n        disabled =\u003e true,\n      }\n    }\n  }\n}\n```\n\n* Pass the same parameters via a hiera file:\n\n```yaml\nthebastion::plugins:\n  selfResetIngressKeys:\n    configuration:\n      disabled: true\n```\n\n## Limitations\n\nTake a close look at the supported distributions in [metadata.json](metadata.json) file.\nAlthough the main configuration offers sane default values in order to be\ndirectly operable, the addons configuration will require some tweaks in order\nto be fully operational (e.g `sync_watcher_remote_host_list` parameter).\n\n## Related\n\n- [The Bastion](https://github.com/ovh/the-bastion) - The Bastion main repository\n\n## License\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovh%2Fpuppet-thebastion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fovh%2Fpuppet-thebastion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovh%2Fpuppet-thebastion/lists"}