SF-Operator is an Operator that simplifies the deployment and operation of Software Factory instances on the OpenShift Container Platform. An instance of Software Factory is composed of Zuul and its dependencies (NodePool, Zookeeper, MariaDB, Log Server).
It is the natural evolution of the Software Factory project: the 3.8.x release of Software Factory saw the containerization of every major service, but was still delivered as RPM packages, in the form of a custom CentOS 7 distribution. SF-Operator builds upon this containerization effort to move from a distro-centric approach to a cloud-native deployment. This is also an opportunity to focus on the leanest service suite needed to provide a working gated CI infrastructure; hence a scope reduced to Zuul and its dependencies only.
SF-Operator is built mostly in Go upon the Operator Framework, with the aim of reaching the highest capability level that can be achieved, in order to bring a modern, scalable gated CI alternative to OpenShift users, with the least friction from operation as possible.
Furthermore, SF-Operator takes advantage of some of the specificities of OpenShift as a container orchestration platform:
- Improved ingress management with OpenShift's Route Custom Resources
- Integration with OLM for streamlined operator and operands' lifecycle management
- If enabled in OpenShift, SF-Operator comes with default monitoring and alerting configurations that can be used out of the box. The default alerting rules are honed from years of maintaining and running several large Zuul deployments at scale for Fedora, Ansible and RDO.
- If enabled, OpenShift provides application logs aggregation with its logging subsystem out of the box.
Finally, we also provide a Command Line Interface (CLI) to simplify common tasks related to the operator, management of the operands, development and testing.
The current project status is: Alpha - NOT PRODUCTION READY
- Level 1 - Basic Install - 10/10
- Zuul Scheduler: ✅
- Zuul Executor: ✅
- Zuul Web: ✅
- Zuul Merger: ✅
- Nodepool Launcher: ✅
- Nodepool Builder: ✅
- Zookeeper: ✅
- MariaDB: ✅
- Log Server: ✅
- Internal Config Repository, bootstrapped pipelines and default jobs: ✅
- Level 2 - Seamless upgrades - 2/2
- Operator: ✅
- Operands: ✅
- Level 3 - Full Lifecycle - 3/5
- SF 3.8.x migration ❌
- Backup: ✅
- Restore: ✅
- Rolling deployments: ❌
- Reconfiguration: ✅
- Level 4 - Deep Insights - 1/3
- Operator metrics: ❌
- Operand metrics: ✅
- Alerts: ❌ (WIP)
- Level 5 - Auto pilot - 0/3
- Auto-scaling : ❌
- Auto-healing: ❌
- Auto-tuning: ❌
- Operator documentation: for OpenShift cluster administrators, this documentation covers installing SF-Operator and managing the operator's lifecycle.
- Deployment documentation: this documentation covers the essentials for people or teams who intend to deploy and manage Zuul and its dependencies through the SF-Operator.
- Developer documentation: this documentation describes how to set up a development and testing environment to develop the SF-Operator.
- End User documentation: for users of a Software Factory instance. This documentation mostly describes the
Software Factory's config repositoryusage (configuration-as-code). - CLI refererence
Should you have any questions or feedback concerning the SF-Operator, you can:
- Join our Matrix channel
- Send an email to softwarefactory-dev@redhat.com
- File an issue for bugs and feature suggestions
Refer to CONTRIBUTING.md.
Sf-operator is distributed under the Apache License.