Skip to content

Commit e87bb9a

Browse files
committed
suggestions implement
1 parent c62b30d commit e87bb9a

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

docs/book/src/faq.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ However, note that this problem is fixed and will not occur if you deploy the pr
9494
9595
## The error `Too long: must have at most 262144 bytes` is faced when I run `make install` to apply the CRD manifests . How to solve it? Why this error is faced?
9696
97-
The Kubernetes API has a size limit. Then, when the apply is used the API will add the annotation last-applied-configuration with all previous configuration which is exceeding this amount. [More info](https://kubernetes.io/docs/tasks/manage-kubernetes-objects/declarative-config/#how-to-create-objects)
97+
The Kubernetes API has a size limit. Then, when the apply is used the API will add the annotation last-applied-configuration with all previous configuration which is exceeding this amount. [More info][k8s-obj-creation]
9898
9999
Therefore, you have a few options to workround this scenario such as:
100100
@@ -112,12 +112,16 @@ Therefore, you have a few options to workround this scenario such as:
112112

113113
Instead of Kubectl create command use Kubectl apply and it will work because kubectl create will send the request at once and it will fail while kubect apply send the request in small chunks so the desc len will be divided.
114114

115-
Add maxDescLen=0 and it will ensure that the crd description size is utmost and hence it will go through it.
115+
By using the maxDescLen=0 [controller-gen][cont-gen] will generate the CRD without description which will consequently reduce its size which might sort out the issue
116116

117+
Permanent solution is to work on server-side. but it is not yet supported by controller-gen. Take a look at [this][controller-tool-pr]
117118

119+
[k8s-obj-creation]: https://kubernetes.io/docs/tasks/manage-kubernetes-objects/declarative-config/#how-to-create-objects
118120
[gvk]: ./cronjob-tutorial/gvks.md
119121
[project-file-def]: ./reference/project-config.md
120122
[klog]: https://github.com/kubernetes/klog
121123
[zap]: https://github.com/uber-go/zap
122124
[permission-issue]: https://github.com/kubernetes/kubernetes/issues/82573
123125
[permission-PR]: https://github.com/kubernetes/kubernetes/pull/89193
126+
[cont-gen]: ./reference/controller-gen.html
127+
[controller-tool-pr]: https://github.com/kubernetes-sigs/controller-tools/pull/536

0 commit comments

Comments
 (0)