62 lines
3.6 KiB
Markdown
62 lines
3.6 KiB
Markdown
# Jenkins Operator
|
|
|
|
[](https://github.com/jenkinsci/kubernetes-operator/releases/tag/v0.2.2)
|
|
[](https://travis-ci.org/jenkinsci/kubernetes-operator)
|
|
[](https://goreportcard.com/report/github.com/jenkinsci/kubernetes-operator)
|
|
[](https://hub.docker.com/r/virtuslab/jenkins-operator/tags)
|
|
|
|
Go to [**our documentation website**](https://jenkinsci.github.io/kubernetes-operator/) for more informaiton, with examples and guides.
|
|
|
|
|
|
|
|
## What's the Jenkins Operator?
|
|
|
|
Jenkins operator is a Kubernetes native operator which fully manages Jenkins on Kubernetes.
|
|
It was built with immutability and declarative configuration as code in mind.
|
|
|
|
Out of the box it provides:
|
|
- integration with Kubernetes ([Jenkins kubernetes-plugin](https://github.com/jenkinsci/kubernetes-plugin))
|
|
- pipelines as code ([Jenkins pipelines](https://jenkins.io/doc/book/pipeline/))
|
|
- extensibility via groovy scripts (simmilar to [Jenkins script console](https://wiki.jenkins.io/display/JENKINS/Jenkins+Script+Console)) or ([configuration as code plugin](https://github.com/jenkinsci/configuration-as-code-plugin))
|
|
- secure defaults and hardening (see [the security section](https://jenkinsci.github.io/kubernetes-operator/docs/security/) of the documentaiton)
|
|
|
|
## Problem statement and goals
|
|
|
|
The main reason why we decided to implement the **Jenkins Operator** is the fact that we faced a lot of problems with standard Jenkins deployment.
|
|
We want to make Jenkins more robust, suitable for dynamic and multi-tenant environments.
|
|
|
|
Some of the problems we want to solve:
|
|
- volumes handling (AWS EBS volume attach/detach issue when using PVC)
|
|
- [installing plugins with incompatible versions or security vulnerabilities](https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/customization/#install-plugins)
|
|
- [better configuration as code](https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/customization/)
|
|
- lack of end to end tests
|
|
- handle graceful shutdown properly
|
|
- [security and hardening out of the box](https://jenkinsci.github.io/kubernetes-operator/docs/security/)
|
|
- orphaned jobs with no jnlp connection
|
|
- [make errors more visible for end users](https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/diagnostics/)
|
|
- [backup and restore for jobs history](https://jenkinsci.github.io/kubernetes-operator/docs/getting-started/latest/configure-backup-and-restore/)
|
|
|
|
## Documentation
|
|
|
|
1. [Installation][installation]
|
|
2. [Getting Started][getting_started]
|
|
3. [How it works][how_it_works]
|
|
4. [Security][security]
|
|
5. [Developer Guide][developer_guide]
|
|
5. [Jenkins scheme][jenkins_scheme]
|
|
|
|
## Contribution
|
|
|
|
Feel free to file [issues](https://github.com/jenkinsci/kubernetes-operator/issues) or [pull requests](https://github.com/jenkinsci/kubernetes-operator/pulls).
|
|
|
|
## About the authors
|
|
|
|
This project was originally developed by [VirtusLab](https://virtuslab.com/) and the following [CONTRIBUTORS](https://github.com/jenkinsci/kubernetes-operator/graphs/contributors).
|
|
|
|
[installation]:documentation/installation.md
|
|
[getting_started]:documentation/v0.2.0/getting-started.md
|
|
[how_it_works]:documentation/how-it-works.md
|
|
[security]:documentation/security.md
|
|
[developer_guide]:documentation/developer-guide.md
|
|
[jenkins_scheme]:documentation/v0.2.0/jenkins-v1alpha2-scheme.md
|