GitOps Infrastructure & Application Delivery Platform
Install | Documentation | Twitter | Slack | Blog
Kubefirst CLI
The Kubefirst CLI is a cloud provisioning tool. With simple setup and two CLI commands, we create a kubernetes cluster managed with automated Infrastructure as Code, GitOps asset management and application delivery, secrets management, a sample application delivered to development, staging, and production, and so much more. It's an open source platform ready to be customized to suit your company's needs.
DNS Setup
In order to install Kubefirst it's required to have a public domain. For root domains, setting the --hosted-zone-name
is enough, in case you want to use subdomains, and the domain is hosted on AWS, please follow the
AWS documentation.
Provisioned services on root domain will be hosted as:
argocd.example.com
gitlab.example.com
...
Provisioned services on subdomains will be hosted as:
argocd.subdomain.example.com
gitlab.subdomain.example.com
...
Installing the CLI
brew install kubefirst/tools/kubefirst
Other installation techniques:
Initialization
Some process requires previous initialization, for that, run:
kubefirst init \
--cloud aws \
--profile default \
--region eu-central-1 \
--admin-email [email protected] \
--cluster-name your_cluster_name \
--hosted-zone-name domain.example
Creation
At this point, everything is ready to start provisioning the cloud services, and for that run:
kubefirst cluster create
Destroy
It will destroy the kubefirst management cluster, and clean up every change made in the cloud.
kubefirst destroy
What to do next
If you want learn more
Access ArgoCD
aws eks update-kubeconfig --name your_cluster_name
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d
kubectl -n argocd port-forward svc/argocd-server 8080:80
Available Commands
Kubefirst provides extra tooling for handling the provisioning work.
Command | Description |
---|---|
argocdSync | Request ArgoCD to synchronize applications |
checktools | use to check compatibility of .kubefirst/tools |
clean | removes all kubefirst resources locally for new execution |
cluster create | create a kubefirst management cluster |
destroy | destroy the kubefirst management cluster |
info | provides general Kubefirst setup data |
init | initialize your local machine to execute create |
version | print the version number for kubefirst-cli" |