allow running cronjob tutorial w/o webhoooks

Webhook support isn't easy to set up locally, so add an env var for
disabling them.

Author: DirectXMan12

docs/book/src/cronjob-tutorial/running.md

@@ -13,13 +13,26 @@ Now that we've installed our CRDs, we can run the controller against our
 cluster.  This will use whatever credentials that we connect to the
 cluster with, so we don't need to worry about RBAC just yet.
 
-Note that if you have a webhook and want to deploy it locally, you need to
-ensure the certificates are in the right place.
+<aside class="note"> 
+
+<h1>Running webhooks locally</h1>
+
+If you want to run the webhooks locally, you'll have to generate
+certificates for serving the webhooks, and place them in the right
+directory (`/tmp/k8s-webhook-server/serving-certs/tls.{crt,key}`, by
+default).
+
+If you're not running a local API server, you'll also need to figure out
+how to proxy traffic from the remote cluster to your local webhook server.
+For this reason, we generally reccomended disabling webhooks when doing
+your local code-run-test cycle, as we do below.
+
+</aside>
 
 In a separate terminal, run
 
 ```bash
-make run
+make run ENABLE_WEBHOOKS=false
 ```
 
 You should see logs from the controller about starting up, but it won't do

docs/book/src/cronjob-tutorial/testdata/project/api/v1/zz_generated.deepcopy.go

@@ -22,6 +22,7 @@ package v1
 
 import (
 	corev1 "k8s.io/api/core/v1"
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
 	"k8s.io/apimachinery/pkg/runtime"
 )
 
@@ -130,7 +131,8 @@ func (in *CronJobStatus) DeepCopyInto(out *CronJobStatus) {
 	}
 	if in.LastScheduleTime != nil {
 		in, out := &in.LastScheduleTime, &out.LastScheduleTime
-		*out = (*in).DeepCopy()
+		*out = new(metav1.Time)
+		(*in).DeepCopyInto(*out)
 	}
 }
 

docs/book/src/cronjob-tutorial/testdata/project/main.go

@@ -91,9 +91,20 @@ func main() {
 		setupLog.Error(err, "unable to create controller", "controller", "Captain")
 		os.Exit(1)
 	}
-	if err = (&batchv1.CronJob{}).SetupWebhookWithManager(mgr); err != nil {
-		setupLog.Error(err, "unable to create webhook", "webhook", "Captain")
-		os.Exit(1)
+
+	/*
+		We'll also set up webhooks for our type, which we'll talk about next.
+		We just need to add them to the manager.  Since we might want to run
+		the webhooks separately, or not run them when testing our controller
+		locally, we'll put them behind an environment variable.
+
+		We'll just make sure to set `ENABLE_WEBHOOKS=false` when we run locally.
+	*/
+	if os.Getenv("ENABLE_WEBHOOKS") != "false" {
+		if err = (&batchv1.CronJob{}).SetupWebhookWithManager(mgr); err != nil {
+			setupLog.Error(err, "unable to create webhook", "webhook", "Captain")
+			os.Exit(1)
+		}
 	}
 	// +kubebuilder:scaffold:builder
 

docs/book/src/cronjob-tutorial/webhook-implementation.md

@@ -1,4 +1,4 @@
-# Implementing admission webhooks
+# Implementing defaulting/validating webhooks
 
 If you want to implement [admission webhooks](../reference/admission-webhook.md)
 for your CRD, the only thing you need to do is to implement the `Defaulter`