Add how to increase quotas

Makefile

@@ -15,7 +15,7 @@ else
 	engine_opts ?= --rm --tty --user "$$(id -u)"
 endif
 
-preview_cmd ?= $(engine_cmd) run --rm --publish 35729:35729 --publish 2020:2020 --volume "${PWD}":/preview/antora ghcr.io/vshn/antora-preview:3.1.2.3 --antora=docs --style=vshn
+preview_cmd ?= $(engine_cmd) run --rm --publish 35729:35729 --publish 2020:2020 --volume "${PWD}":/preview/antora ghcr.io/vshn/antora-preview:3.1.4 --antora=docs --style=vshn
 vale_cmd ?= $(engine_cmd) run $(engine_opts) --volume "$${PWD}"/docs/modules/ROOT/pages:/pages --workdir /pages ghcr.io/vshn/vale:2.15.5 --minAlertLevel=error .
 
 UNAME := $(shell uname)

docs/modules/ROOT/pages/how-tos/appcat/appuio-quotas.adoc

@@ -0,0 +1,29 @@
+= Change AppCat service quota on APPUiO Cloud
+
+It's important, that the service instance has been created with resources lower than the quota.
+This is due to the fact, that the quotas are bound to the namespace and in order to change them, we need the namespace itself.
+
+== Namespace quotas
+The amount of namespaces and thus the amount of AppCat instances that can be created for an organization on APPUiO is limited by default. Please see the https://github.com/appuio/component-appuio-cloud/blob/master/class/defaults.yml#L174[component defaults] for the actual default number.
+
+If that limit is reached, the customer can request an increase in the amount of namespaces they can have.
+Please see https://kb.vshn.ch/appuio-cloud/how-to/day2ops/override-namespace-quota.html[Override Namespace Quota].
+
+== Resource quotas
+The resource quotas are controlled by annotations on the instance namespaces.
+AppCat adjusts the default values slightly, so that `plus-8` or `standard-8` instances could run with one replica.
+
+To adjust the quotas, simply adjust the values of the annotations:
+
+[source,yaml]
+----
+apiVersion: v1
+kind: Namespace
+metadata:
+  annotations:
+    resourcequota.appuio.io/organization-compute.limits.cpu: 4500m
+    resourcequota.appuio.io/organization-compute.limits.memory: 16500Mi
+    resourcequota.appuio.io/organization-compute.requests.cpu: 4500m
+    resourcequota.appuio.io/organization-compute.requests.memory: 16500Mi
+    resourcequota.appuio.io/organization-objects.requests.storage: "1099511627776"
+----

docs/modules/ROOT/partials/nav.adoc

@@ -106,3 +106,6 @@
 *** xref:app-catalog:ROOT:tutorials/crossplane_service_broker/setting_up_crossplane_service_broker.adoc[Crossplane Complete Setup Tutorial]
 
 ** xref:app-catalog:ROOT:how-tos/haproxy/stats.adoc[HAProxy]
+
+* Runbooks
+** xref:app-catalog:ROOT:how-tos/appcat/appuio-quotas.adoc[]