Initium project CLI

A single static binary that can run on any CI to build your code and deploy it in a single step.

All with a nice development workflow in mind like ephemeral environment for your PRs.

Pre-requisites

1. GoLang

   You can install it with your prefered package manager or usign asfd with asdf install.

2. Docker (or similar solutions)

   Here you can find a list of possible candidates:

   • Docker ( cross-platform, paid solution )
   • Rancher Desktop ( cross-platform, FOSS )
   • lima + nerdctl ( macOS only )

Build the executable

In order to build the executable you simply need to run

make build

You will be able to run the executable from

./bin/initium

Setup local environment

These are the environment variables that you have to set in order to use the onmain, onbranch commands from your local environment

export INITIUM_REGISTRY_PASSWORD="<github_pat>"
export INITIUM_REGISTRY_USER="<github_user>"

and

export INITIUM_CLUSTER_ENDPOINT=$(kubectl config view -o jsonpath='{.clusters[?(@.name == "kind-k8s-kurated-addons")].cluster.server}')
export INITIUM_CLUSTER_TOKEN=$(kubectl get secrets initium-cli-token -o jsonpath="{.data.token}" | base64 -d)
export INITIUM_CLUSTER_CA_CERT=$(kubectl get secrets initium-cli-token -o jsonpath="{.data.ca\.crt}" | base64 -d)

Supported Application Runtimes

Following we have a matrix related to which application runtime our CLI is currently compatible with. For each one of them a Dockerfile template is being used in order to provide an easy way to build and deploy the application to a Kubernetes cluster.

| Application Runtimes | Supported | |----------------------|:------------------:| | Nodejs | :white_check_mark: | | GoLang | :white_check_mark: | | Python | Coming Soon | | More will be added...| |

CI Integrations

The matrix below gives an overview of the integration status of our CLI with CI platforms. CLI is able to create automatically build and deploy pipelines in order to enable CICD process for the application it is used with. Related template files are being used to cover different process steps.

| CI Systems | Supported | |----------------------|:------------------:| | GitHub Actions | :white_check_mark: | | Gitlab CI | Coming Soon | | Azure Devops | Coming Soon | | More will be added...| |