Resource name constraints (3) (#19120)

xref: #17969, #19099, #18746
2020-03-05 06:18:38 -08:00
parent ddb114e717
commit 3d63002fa3
10 changed files with 23 additions and 5 deletions
@@ -27,7 +27,8 @@ that the cron job controller uses.
 {{< /caution >}}

 When creating the manifest for a CronJob resource, make sure the name you provide
-is no longer than 52 characters. This is because the CronJob controller will automatically
+is a valid [DNS subdomain name](/docs/concepts/overview/working-with-objects/names#dns-subdomain-names).
+The name must be no longer than 52 characters. This is because the CronJob controller will automatically
 append 11 characters to the job name provided and there is a constraint that the
 maximum length of a Job name is no more than 63 characters.

@@ -114,6 +114,7 @@ The output is similar to this:
 ## Writing a Job Spec

 As with all other Kubernetes config, a Job needs `apiVersion`, `kind`, and `metadata` fields.
+Its name must be a valid [DNS subdomain name](/docs/concepts/overview/working-with-objects/names#dns-subdomain-names).

 A Job also needs a [`.spec` section](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status).