Warning Make sure you are using the correct version of these instructions by using the link in the release notes for the version you're trying to install. If you're not sure, check our latest release.
In order to install korifi on kind effortlessly we have prepared an installation job definition that you simply apply to your kind cluster. It will install korifi with reasonable defautls using a local docker registry (also running on your kind cluster).
Warning The installer will deploy korifi with experimental features. To find out more please check out the
experimental
section of korifi's helm values file.
In order to access the Korifi API, we'll need to expose the cluster ingress locally. To do it, create your kind cluster using a command like this:
cat <<EOF | kind create cluster --name korifi --config=-
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
containerdConfigPatches:
- |-
[plugins."io.containerd.grpc.v1.cri".registry]
[plugins."io.containerd.grpc.v1.cri".registry.mirrors]
[plugins."io.containerd.grpc.v1.cri".registry.mirrors."localregistry-docker-registry.default.svc.cluster.local:30050"]
endpoint = ["http://127.0.0.1:30050"]
[plugins."io.containerd.grpc.v1.cri".registry.configs]
[plugins."io.containerd.grpc.v1.cri".registry.configs."127.0.0.1:30050".tls]
insecure_skip_verify = true
nodes:
- role: control-plane
extraPortMappings:
- containerPort: 32080
hostPort: 80
protocol: TCP
- containerPort: 32443
hostPort: 443
protocol: TCP
- containerPort: 30050
hostPort: 30050
protocol: TCP
EOF
- Run the installer job:
kubectl apply -f https://github.com/cloudfoundry/korifi/releases/latest/download/install-korifi-kind.yaml
- If you want track the job progress, run:
kubectl -n korifi-installer logs --follow job/install-korifi
- Optional After the job is complete you can delete the
korifi-installer
namespace
kubectl delete namespace korifi-installer
- Target the api:
cf api https://localhost --skip-ssl-validation
- Authenticate as the cf admin user:
cf auth kind-korifi
- Create and target an org and a space
cf create-org org && cf create-space -o org space && cf target -o org
- Push a buildpack app and access it:
make build-dorifi
cf push dorifi -p tests/assets/dorifi
curl -k https://dorifi.apps-127-0-0-1.nip.io
- Push a docker app and access it:
cf push nginx --docker-image nginxinc/nginx-unprivileged:1.23.2
curl -k https://nginx.apps-127-0-0-1.nip.io
When you no longer need korifi you can delete the whole kind cluster via:
kind delete cluster --name korifi