Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/epinio/epinio
Opinionated platform that runs on Kubernetes, that takes you from App to URL in one step.
https://github.com/epinio/epinio
hacktoberfest kubernetes paas
Last synced: about 1 month ago
JSON representation
Opinionated platform that runs on Kubernetes, that takes you from App to URL in one step.
- Host: GitHub
- URL: https://github.com/epinio/epinio
- Owner: epinio
- License: apache-2.0
- Created: 2020-11-09T22:51:28.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-07-19T08:31:52.000Z (5 months ago)
- Last Synced: 2024-08-02T06:24:51.675Z (4 months ago)
- Topics: hacktoberfest, kubernetes, paas
- Language: Go
- Homepage: https://epinio.io
- Size: 20.8 MB
- Stars: 522
- Watchers: 27
- Forks: 55
- Open Issues: 56
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# Epinio
Opinionated platform that runs on Kubernetes to take you from Code to URL in one step.
[](https://pkg.go.dev/github.com/epinio/epinio/internal/api/v1)
[](https://goreportcard.com/report/github.com/epinio/epinio)
[](https://github.com/epinio/epinio/actions/workflows/main.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio/actions/workflows/golangci-lint.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio/actions/workflows/aks.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio/actions/workflows/eks.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio/actions/workflows/gke.yml??query=branch%3Amain)
[](https://github.com/epinio/epinio/actions/workflows/rke.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio/actions/workflows/rke2-lh-ec2.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio/actions/workflows/aks-letsencrypt.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio/actions/workflows/gke-letsencrypt.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio/actions/workflows/gke-upgrade.yml??query=branch%3Amain)
[](https://github.com/epinio/epinio/actions/workflows/rke-upgrade.yml?query=branch%3Amain)
[E2E tests](https://github.com/epinio/epinio-end-to-end-tests):
[](https://github.com/epinio/epinio-end-to-end-tests/actions/workflows/scenario_1_chrome_rancher_ui.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio-end-to-end-tests/actions/workflows/scenario_2_firefox_rancher_ui.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio-end-to-end-tests/actions/workflows/std_ui_latest_chrome.yml?query=branch%3Amain)
[](https://github.com/epinio/epinio-end-to-end-tests/actions/workflows/std_ui_latest_firefox.yml?query=branch%3Amain)
## What problem does Epinio solve?
Epinio makes it easy for developers to develop their applications running in Kubernetes clusters. Easy means:
- No experience with Kubernetes is needed
- No steep learning curve
- Quick local setup with minimal configuration
- Deploying to production the same as deploying in development
[Kubernetes](https://kubernetes.io/) is the standard for container orchestration.
Developers may want to use Kubernetes for its benefits or because their Ops team has chosen it.
In either case, working with Kubernetes can be complex depending on the environment.
It has a steep learning curve and doing it right is a full-time job.
Developers should spend their time working on their applications, not doing operations.
Epinio adds the needed abstractions and tools to allow developers to use Kubernetes as a [PaaS](https://en.wikipedia.org/wiki/Platform_as_a_service).
## Documentation
Documentation is available at [docs.epinio.io](https://docs.epinio.io/).
### Installation
Requires a Kubernetes cluster, an Ingress Controller and a Cert Manager as explained in the [installation](https://docs.epinio.io/installation/install_epinio) documentation.
Once this is in place, and leaving out DNS setup, an installation reduces to:
```
helm repo add epinio https://epinio.github.io/helm-charts
helm repo update
helm install --namespace epinio --create-namespace epinio epinio/epinio \
--set global.domain=mydomain.example.com
```
### CLI installation
Installation of the Epinio CLI is by downloading a binary from the
[release page](https://github.com/epinio/epinio/releases), or usage of `brew`, i.e.
```
brew install epinio
```
There is further documentation [here](https://docs.epinio.io/installation/install_epinio_cli).
### Quick Start Tutorial
Our [QuickStart Tutorial](https://docs.epinio.io/tutorials/quickstart) works through how to create a namespace and push an application.
### Reach Us
- Slack: #epinio on [Rancher Users](https://rancher-users.slack.com/)
- Github: [Discuss](https://github.com/epinio/epinio/discussions/new)
### Contributing
`Epinio` uses [Github Project](https://github.com/epinio/epinio/projects/1) for tracking issues.
Find more information in the [Contribution Guide](./CONTRIBUTING.md).
The [developer documentation](./docs) explains how to build and run Epinio from a git source checkout.
## Features
- **Security**
- TLS secured API server
- Basic Authentication to access the API
- __or__ OIDC-based token
- **Epinio Clients**
- Web UI
- Epinio CLI
- **Apps**
- Push code directly without further tools or steps
- Basic operation of your application once pushed
- Cloud Native Buildpacks build and containerize your code for you
- **Configurations**
- CRUD operations on your configuration. A configuration can be a database, SaaS etc. A configuration can be an external component or can be created using `epinio configuration`.
- Bind configurations to apps.
## Example apps
- Rails: https://github.com/epinio/example-rails
- Java: https://github.com/spring-projects/spring-petclinic/
- Paketo Buildpack example apps: https://github.com/paketo-buildpacks/samples
## License
Copyright (c) 2020-2023 [SUSE, LLC](https://suse.com)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.