Add Kubernetes and Argo CD deployment manifests

README.md

@@ -46,3 +46,31 @@ packages.
 ```sh
 docker build --build-arg COMMIT_ID="$(git rev-parse HEAD)" -t hiyv-nginx:local .
 ```
+
+## Deploy with Argo CD
+
+The Kubernetes manifests in `k8s/` deploy two HIYV replicas and expose them
+through a cluster-internal Service. They use the public Gitea image directly;
+no `imagePullSecrets` are required.
+
+The repository URL is deliberately not hard-coded. Set `HIYV_GIT_REPO` to the
+public Git repository that contains these manifests, make sure the Argo CD CLI
+is authenticated, and run:
+
+```sh
+export HIYV_GIT_REPO='<public Git repository URL>'
+./scripts/create-argocd-application.sh
+```
+
+If `HIYV_GIT_REPO` is unset, the script explains what is missing and exits
+without changing Argo CD. When it is set, the script creates or updates the
+`hiyv` Application with automated sync, pruning, self-healing, and namespace
+creation enabled.
+
+Optional configuration:
+
+- `HIYV_GIT_REVISION` (default: `main`)
+- `HIYV_MANIFEST_PATH` (default: `k8s`)
+- `HIYV_ARGOCD_APP_NAME` (default: `hiyv`)
+- `HIYV_DESTINATION_SERVER` (default: in-cluster Kubernetes API)
+- `HIYV_DESTINATION_NAMESPACE` (default: `hiyv`)