re-format and cleanup

This commit is contained in:
Maciek 2022-11-05 15:42:56 +01:00
parent 2fb7523d06
commit 0234041e1e

View file

@ -439,42 +439,43 @@ Configuration is relatively straightforward. As an example, a minimal configurat
kubectl create configmap ntfy --from-file=server.yml
```
### Kustomization
Create new folder, name it nfty and create kustomization.yaml within along all resources listed below.
Ingress is optional - you can skip this one if planning to expose service using different service type (hash it out from kustomization file)
## Kustomize
`ntfy` can be deployed in Kubernetes cluster with [Kustomize](https://github.com/kubernetes-sigs/kustomize) - tool used to customize Kubernetes objects using kustomization file.
1. Create new folder - `ntfy`
2. Add all files listed below
1. kustomization.yaml - stores all configmaps and resources used in deployment
2. ntfy-deployment.yam - define deployment type and it's parameters-
3. ntfy-pvc.yaml - describes how [persistent volume](https://kubernetes.io/docs/concepts/storage/persistent-volumes/) will be created
4. ntfy-svc.yaml - expose application to the internal kubernetes network
5. ntfy-ingress.yaml - expose service to outside network using [Ingress controller](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/)
6. server.yaml - simple server configuration
4. Replace **TESTNAMESPACE** within kustomization.yaml with designated namespace
5. Replace **ntfy.test** within ntfy-ingress.yaml with desired DNS name
6. Apply configuration to cluster set in current context:
```bash
kubectl apply -k /ntfy
```
=== "kustomization.yaml"
```yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- ntfy-deployment.yaml # main deployment
- ntfy-svc.yaml # service connecting two pods together
- ntfy-pvc.yaml # pvc uset to store cache and attachment
- ntfy-ingress.yaml # ingress traefik
- ntfy-deployment.yaml # deployment definition
- ntfy-svc.yaml # service connecting pods to cluster network
- ntfy-pvc.yaml # pvc used to store cache and attachment
- ntfy-ingress.yaml # ingress definition
configMapGenerator: # will parse config from raw config to configmap,it allows for dynamic reload of application if additional app is deployed ie https://github.com/stakater/Reloader
- name: server-config
files:
- server.yml
namespace: TESTNAMESPACE # select namaespace for whole application
----
apiVersion: kustomize.config.k8s.io/v1beta1 #local resources
kind: Kustomization
resources:
- git@github.com:gituser/kustomize.git/kustomize/main/ #WIP when complete config will be stored in repo
namespace: TESTNAMESPACE # select namaespace for whole application
namespace: TESTNAMESPACE # select namespace for whole application
```
### ntfy-deployment.yaml
=== "ntfy-deployment.yaml"
```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
@ -494,7 +495,7 @@ spec:
spec:
containers:
- name: ntfy
image: binwiederhier/ntfy:v1.28.0 # select version here latest is not the greatest idea !
image: binwiederhier/ntfy:v1.28.0 # set deployed version
args: ["serve"]
env: #example of adjustments made in environmental variables
- name: TZ # set timezone
@ -530,8 +531,7 @@ spec:
claimName: ntfy-pvc
```
### ntfy-pvc.yaml
Stores all in cache folder for event of the pod re-deployment
=== "ntfy-pvc.yaml"
```yaml
apiVersion: v1
kind: PersistentVolumeClaim
@ -544,11 +544,9 @@ spec:
resources:
requests:
storage: 1Gi
```
### ntfy-svc.yaml
Exposes pod to internal network of the cluster
=== "ntfy-svc.yaml"
```yaml
apiVersion: v1
kind: Service
@ -565,9 +563,7 @@ spec:
targetPort: http-ntfy
```
### ntfy-ingress.yaml
If cluster uses Ingress controller you have to deploy ingress to access application externally. It will not have TLS/SSL enabled so you have to deploy cert-manager and generate CA cert along certificate for service
=== "ntfy-ingress.yaml"
```yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
@ -587,16 +583,8 @@ spec:
number: 80
```
### server.yml
=== "server.yml"
```yaml
cache-file: "/var/cache/ntfy/cache.db"
attachment-cache-dir: "/var/cache/ntfy/attachments"
```
### Deploying from kustomization
Go one level up from folder where all resources were created and apply configuration
```bash
kubectl apply -k /nfty
```