Skip to main content

kuberise logo

kuberise.io

kuberise.io is a free open source internal developer platform for Kubernetes environment. The goal is to provide tools and templates in Kubernetes environment by a fast and easy installation to help developers focus on the development of the business applications rather than installation and configuration of side tools and preparations of the environments and automation.

Prerequisites

  • CLI tools: kubectl, helm, htpasswd, git, openssl
  • A Github account or another git repository system
  • K9s for dashboard (recommended)
  • A kind kubernetes cluster for local installation (kind create cluster) or any other kubernetes cluster
  • cloud-provider-kind for loadBalancer services and ingresses in kind cluster.

Installation

  1. Fork this repository https://github.com/kuberise/kuberise.io into your Github account.
  2. Clone your new repository in your local computer and enter to the folder.
  3. Run this command:
./scripts/install.sh [CONTEXT] [NAME] [REPO_URL] [REVISION] [DOMAIN] [TOKEN]
  • [CONTEXT] This is your kubernetes context. You can find your current kubernetes context by running this command: kubectl config current-context
  • [NAME] This is the name of your platform. For this name there should be a values-[NAME].yaml in app-of-apps folder and also a [NAME] folder in values folder for all configurations.
  • [REPO_URL] This is the url of your forked repository.
  • [REVISION] This is the branch or commit sha or tag of the commit that you want to use for this installation. For example you can write "main" to deploy from the main branch.
  • [DOMAIN] This is the domain for the cluster. All platform services and applications would be subdomain of this domain, for example: keycloak.[DOMAIN]. If you are deploying into minikube you can choose minikube.kuberise.dev for the domain then your keycloak address would be keycloak.minikube.kuberise.dev
  • [TOKEN] If you are pushing this code to a private repository, you have to put a token here so the ArgoCD can access your repository. If your repository is public, skip this parameter.

Example: If you deployed a kubernetes cluster using minikube start and your platform name is local-example then this would be the installation command:

./scripts/install.sh minikube local-example https://github.com/kuberise/kuberise.git main minikube.kuberise.dev