docs: add README.md

kube/base/README.md

@@ -0,0 +1,26 @@
+## Deploying FarosCE on Kubernetes
+
+We provide all required Kubernetes manifests for a full stack deployment in this repository under `kube/base`. These manifests can be used raw but are also exposed using [Kustomize](https://kustomize.io/) for a more flexible and scalable deployment model.
+
+> Local Kubernetes clusters can be setup in a few different ways. Here's a list of the few most common tools for local K8s deployment: [kind](https://kind.sigs.k8s.io/), [k3d](https://k3d.io/v5.4.3/) or [minikube](https://minikube.sigs.k8s.io/docs/start/).
+
+Provided you have have access to a Kubernetes cluster and have configured access to it via `kubectl`, FarosCE can be deployed with the following command:
+
+```base
+kustomize build --load-restrictor LoadRestrictionsNone https://github.com/saviogl/faros-community-edition/kube/base | kubectl apply -f -
+```
+
+Kustomize will load the deployment definition in this reposirotry over Github, build the manifests and pipe them over to `kubectl` for deployment in the configured cluster.
+
+### Using kustomization.yaml file
+
+**_Alternativelly_** you can create your own local `kustomization.yaml` file and reference the same path in the resources attribute:
+
+```yaml
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+resources:
+  - https://github.com/saviogl/faros-community-edition/kube/base
+```
+
+> This allow you to customize the Kubernetes resources objects in any way you want to meet whatever desired cluster requiremenets you might have