https://github.com/kubesphere/s2ioperator
Operator for Source to image
https://github.com/kubesphere/s2ioperator
devops kubernetes operator s2i
Last synced: 2 months ago
JSON representation
Operator for Source to image
- Host: GitHub
- URL: https://github.com/kubesphere/s2ioperator
- Owner: kubesphere
- License: apache-2.0
- Created: 2019-02-28T08:33:36.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-02-20T09:06:27.000Z (over 1 year ago)
- Last Synced: 2024-04-13T21:43:07.270Z (about 1 year ago)
- Topics: devops, kubernetes, operator, s2i
- Language: Go
- Homepage:
- Size: 18.1 MB
- Stars: 44
- Watchers: 4
- Forks: 29
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
README
[](https://gitpod.io/#https://github.com/kubesphere/s2ioperator)
# Source-to-image Operator
[](https://github.com/kubesphere/s2ioperator/blob/master/LICENSE) [](https://goreportcard.com/report/github.com/kubesphere/s2ioperator) [](https://github.com/kubesphere/s2ioperator/releases/tag/v0.0.14)
Source-to-image(S2I)-Operator is a Kubernetes [Custom Resource Defintion](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/) (CRD) controller that provides easy Kubernetes-style resources for declaring CI/CD-style pipelines. S2I Operator create a ready-to-run images by injecting source code into a container image and letting the container prepare that source code for execution. And create workload automatically with ready-to-run images.
## Native S2I vs S2I Operator
Compare with native S2I, S2I Operator also has the following advantages on the original foundation.
1. **Provide S2I Open API**: you can call S2I API directly to generate image, or carry out secondary development.
2. **Simple Config**: you just provide source code url, and specify the image repo which you want to push, other configurations will setted automatically. And all configurations are stored as different resources in Kubernetes.
3. **Deep integration with Kubernetes**: Use containers as their building blocks. And you can use kubectl to create s2i pipelines just as you do with Kubernetes' built-in resources.
## Installation
#### Prerequisites
1. A Kubernetes cluster. (if you don't have an existing cluster, please [create it](https://kubernetes.io/docs/setup/).
2. Grant cluster-admin permissions to the current user.
#### Install S2I Operator
You can install S2I Operator in any kubernetes cluster with following commands:
```shell
# create a namespaces, such as kubesphere-devops-system
kubectl create ns kubesphere-devops-system
# create S2I Operator and all CRD
kubectl apply -f https://github.com/kubesphere/s2ioperator/releases/download/v0.0.2/s2ioperator.yaml
```
Now monitor the S2I Operator components show a `STATUS` of `Running`:
```shell
# please change you namespace
kubectl -n kubesphere-devops-system get pods -w
```
## Quick Start
Here is [quick-start](docs/QUICK-START.md) to walk you through the process, with a quick overview of the core features of S2I Operator that helps you to get familiar with it.
If you want to get a better experience with S2I Operator, perhaps you can use S2I CI/CD in [KubeSphere](https://github.com/kubesphere/kubesphere).
## Welcome to contribute
We are so excited to have you!
- See [Kubesphere community guide](https://github.com/kubesphere/community) for an overview of our processes
- See [DEVELOPMENT.md](docs/DEVELOPMENT.md) for how to get started