Skip to content

SF-Operator is an Operator that simplifies the deployment and operation of OpenDev's Zuul and its dependencies (NodePool, Zookeeper, MariaDB, Log Server) on the OpenShift Container Platform.

License

Notifications You must be signed in to change notification settings

softwarefactory-project/sf-operator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SF-Operator: a Zuul-based CI infrastructure for OpenShift

Matrix Channel Testing only; use in production at your own risks

About

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.

Status

The current project status is: Alpha - NOT PRODUCTION READY

Capability Levels

  • 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: ❌

Getting Started

Documentation

  • 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 repository usage (configuration-as-code).
  • CLI refererence

Getting Help

Should you have any questions or feedback concerning the SF-Operator, you can:

Contributing

Refer to CONTRIBUTING.md.

Licence

Sf-operator is distributed under the Apache License.

About

SF-Operator is an Operator that simplifies the deployment and operation of OpenDev's Zuul and its dependencies (NodePool, Zookeeper, MariaDB, Log Server) on the OpenShift Container Platform.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published