https://github.com/operate-first/peribolos-as-a-service

Declarative GitHub Organization management via Peribolos as a service
https://github.com/operate-first/peribolos-as-a-service

community

Last synced: about 2 months ago
JSON representation

Declarative GitHub Organization management via Peribolos as a service

• Host: GitHub
• URL: https://github.com/operate-first/peribolos-as-a-service
• Owner: operate-first
• License: mit
• Created: 2022-02-25T13:15:04.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-25T07:59:15.000Z (3 months ago)
• Last Synced: 2024-10-25T08:34:09.744Z (3 months ago)
• Topics: community
• Language: TypeScript
• Size: 2.05 MB
• Stars: 7
• Watchers: 10
• Forks: 13
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md
  • Support: SUPPORT.md

Awesome Lists containing this project

• awesome-starred - operate-first/peribolos-as-a-service - Declarative GitHub Organization management via Peribolos as a service (others)

README

        


  

    

  



Peribolos

GitHub organization management as code



  

    

  

  

    

  

  

    

  

  

    

  

  

    

  

  

    

  



---

[peribolos]: https://github.com/kubernetes/test-infra/tree/master/prow/cmd/peribolos

[probot]: https://probot.github.io/

If you ever wanted to manage your GitHub organization as code where everybody can simply open a PR and ask to create a team or make a repository, wait no more! This provided [Peribolos][peribolos] instance can help you in .

We are neither the original creators or maintainers of the Peribolos code base. [Peribolos tool belongs to Kubernetes project][peribolos] and they deserve all the credit.

## How it works

Simply install this application. It will ensure a special `.github` repository exists in your organization. In addition to that, Peribolos will create a pull request to this repository for you with all your github organization settings exported to `peribolos.yaml` manifest.

Later, on any change to this manifest pushed to the default branch, Peribolos will apply those changes to your organization.

## Security implications

By installing this application you're granting a lot of permissions to our service - essentially granting Peribolos organization admin privileges. This is a great deal to us and we don't take security lightly. If you have any questions please review our [SUPPORT.md](SUPPORT.md) and [SECURITY.md](SECURITY.md) guides.

## Contributions

See [`CONTRIBUTING.md`](CONTRIBUTING.md) on how to contribute.

---

## Credit

See [`ACKNOWLEDGMENTS.md`](ACKNOWLEDGMENTS.md).