From 151bceb8c54bd4d6a8917a7ecdb4e0632b52ccbe Mon Sep 17 00:00:00 2001
From: phil <phil.dev@philome.mooo.com>
Date: Fri, 27 Dec 2024 06:09:14 +0100
Subject: [PATCH] Deployment: add documenation for Kubernetes

---
 deployment/kubernetes/.gitignore |  1 +
 deployment/kubernetes/README.md  | 57 ++++++++++++++++++++++++++++++++
 2 files changed, 58 insertions(+)
 create mode 100644 deployment/kubernetes/.gitignore
 create mode 100644 deployment/kubernetes/README.md

diff --git a/deployment/kubernetes/.gitignore b/deployment/kubernetes/.gitignore
new file mode 100644
index 0000000..68242e7
--- /dev/null
+++ b/deployment/kubernetes/.gitignore
@@ -0,0 +1 @@
+gisaf-*.tgz
diff --git a/deployment/kubernetes/README.md b/deployment/kubernetes/README.md
new file mode 100644
index 0000000..e6922d8
--- /dev/null
+++ b/deployment/kubernetes/README.md
@@ -0,0 +1,57 @@
+# Kubernetes deployment
+
+This directory contains files for deployment on Kubernetes.
+
+The standard installation uses a namespace named `gisaf`.
+
+Commands below assume that they are run from this directory.
+
+## Plain Kubernetes
+
+2 files: `gisaf.yaml` and `config.yaml`
+
+Deploy on Kubernetes (without Helm)
+
+```sh
+kubectl create namespace gisaf
+kubectl apply -f config.yaml
+```
+
+Update after modification:
+
+```sh
+kubectl --namespace gisaf rollout restart deployment gisaf-server-deployment
+```
+
+## Helm
+
+The `helm` chart is in the directory named `helm`.
+
+### Deploy on Kubernetes
+
+```sh
+kubectl create namespace gisaf
+helm install gisaf helm
+```
+
+#### Update
+
+```sh
+helm upgrade gisaf helm
+```
+
+### Publish the Helm chart
+
+First, build the Helm package:
+
+```sh
+helm package heml
+```
+
+Then upload it:
+
+```sh
+helm --user phil:<password> -X POST \
+--upload-file gisaf-0.1.0.tgz \
+https://code.philo.ydns.eu/api/packages/philorg/helm/api/charts
+```