caddy-ingess/CONTRIBUTING.md
Marco Vito Moscaritolo 20b498f76c
Helm chart refactoring & automation (#31)
* remove test data

* Create helm chart using the suggested structure from helm3

* Fix minor naming consistency in Dockerfile

* Move skaffold to use helm chart

* improve skaffold configuration

* Update chart name to use the naming convenction

* update sample path

* Update contribution guideline

* Add helm chart validation rules

* Add chart home since is a required field

* Add linting action for helm charts

* Add fixes to chart definition

* fix timeout duration

* Update kind cluster

* test CI with minikube

* Add MetalLB to test load balancer feature

* Publish chart when merged on master

* test publishing chart with fake tag

* move charts dir

* finalize charts publishing CI

* reformat skaffold
2020-06-20 21:37:46 +02:00

2.1 KiB

Requirements

  • A running kubernetes cluster (if you don't have one see Setup a local cluster section)
  • helm 3 installed on your machine
  • skaffold installed on your machine

Setup a local cluster

  • You need a machine with docker up & running
  • You need to install kind on your machine

Than we can create a two nodes cluster (one master and one worker):

cat <<EOF | kind create cluster --config=-
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
- role: worker
EOF

and activate the kubectl config via:

kind export kubeconfig

Setup development env

Replace also the domain name to use in hack/test/example-ingress.yaml from kubernetes.localhost to your domain (ensure also that the subdomain example1 and example2 are resolved to the server public IP)

Create a namespace to host the caddy ingress controller:

kubectl create ns caddy-system

Than we can start skaffold using:

skaffold dev --port-forward

this will automatically:

  • build your docker image every time you change some code
  • update the helm release every time you change the helm chart
  • expose the caddy ingress controller (port 8080 and 8443)

You can test that all work as expected with:

curl -H 'Host: example1.kubernetes.localhost http://127.0.0.1:80/hello1
curl -H 'Host: example1.kubernetes.localhost http://127.0.0.1:80/hello2
curl -H 'Host: example2.kubernetes.localhost http://127.0.0.1:80/hello1
curl -H 'Host: example2.kubernetes.localhost http://127.0.0.1:80/hello2

Notes

  • You can change local port forwarded by skaffold by changing the port values in the skaffold.yaml file on section portForward localPort. Remind that you can forward only port greather than 1024 if you execute it as non root user
  • You can delete your local cluster with the command kind delete cluster
  • To use TLS your domain should be publically resolved to your cluster IP in order to allow Let's Encript to validate the domain