From 4736c4fe27e0de6a35a3d1e664cf7bf1c6d1048e Mon Sep 17 00:00:00 2001 From: Euan Kemp Date: Sun, 4 Mar 2018 12:44:39 -0800 Subject: [PATCH 1/2] docs/devel: add 'deploy to minikube' docs The rbac and docker-env bits are tricky enough that I think it's worth documenting this. --- docs/devel/README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/docs/devel/README.md b/docs/devel/README.md index e69de29bb..2db936d05 100644 --- a/docs/devel/README.md +++ b/docs/devel/README.md @@ -0,0 +1,46 @@ +# Develop with minikube + +## Start minikube + +First, run minikube, and configure your local kubectl command to work with minikube; minikube typically does this automatically. + + +```shell +$ minikube version +minikube version: v0.25.0 + +$ minikube start --extra-config=apiserver.Authorization.Mode=RBAC +# Verify it works +$ kubectl cluster-info +# Should output a local master ip + +$ kubectl create clusterrolebinding default-admin --clusterrole=cluster-admin --serviceaccount=kube-system:default +$ helm init +``` + +## Build a dev version of cert-manager for minikube + +```shell +$ eval "$(minikube docker-env)" +$ make build +# .... +Successfully tagged quay.io/jetstack/cert-manager-controller:build +``` + +## Deploy that version with helm + +```shell +$ helm install --set image.tag=build --name cert-manager ./contrib/charts/cert-manager +``` + +From here, you should be able to do whatever manual testing or development you wish to. + +## Deploy a new version + +In general, upgrading can be done simply by running `make build`, and then deleting the deployed pod using `kubectl delete pod`. + +However, if you make changes to the helm chart or wish to change the controller's arguments, such as to change the logging level, you may also update it with the following: + +```shell +$ helm upgrade --set extraArgs="{-v=5}" --set image.tag=build cert-manager ./contrib/charts/cert-manager +``` From c82226c7d111ba875a3a736d7de70e7fb5482a82 Mon Sep 17 00:00:00 2001 From: Euan Kemp Date: Sun, 4 Mar 2018 15:36:02 -0800 Subject: [PATCH 2/2] docs/examples: fix typo in example cert --- docs/examples/acme-cert.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/examples/acme-cert.yaml b/docs/examples/acme-cert.yaml index 505aee87f..a0dd0d541 100644 --- a/docs/examples/acme-cert.yaml +++ b/docs/examples/acme-cert.yaml @@ -35,11 +35,11 @@ spec: provider: cloudflare domains: - cm-dns-cloudflare.k8s.group - - dns-01: + - dns01: provider: route53 domains: - cm-dns-route53.k8s.group - - dns-01: + - dns01: provider: azuredns domains: - cm-dns-azuredns.k8s.group