Let's launch a local cluster using VKPR in less than 5 minutes.
Note: You need Docker installed for this to work.
The VKPR CLI tool will do its best to hide its internals (including Ritchie).
# Install the VKPR
curl -fsSL https://get.vkpr.net/ | bash
# Create alias
alias vkpr="rit vkpr"
Optionally you can use VKPR internal tools by changing PATH:
Try yourself to use VKPR following the next steps:
Create a cluster
After installing VKPR, you may be creating the Kubernetes Cluster in your environment for testing as a production environment.
To do that, you can run the command:
vkpr infra up
Deploy a sample app
To test some application using VKPR, we will use
whoami as an example.
For this, we will implement an ingress controller and the whoami itself:
vkpr ingress install --default
vkpr whoami install --default
Now you can test this sample application with a simple
curl -H "Host: whoami.localhost" localhost:8000
Use the second form if
whoami.localhost does not resolve to
After all tests, if you want to destroy the created cluster, you may discard his with a single command:
vkpr infra down
A brief explanation
Each of VKPR's CLI commands is called a formula (implemented using Ritchie).
vkpr infra upformula starts a local kubernetes cluster using k3d.
vkpr ingress installformula deploys an ingress controller nginx, in this case exposed to localhost in ports 8000 (http) and 8001 (https).
vkpr whoami installformula deploys a sample application with a valid ingress configuration.