From 9e35b1cfad1d9284b32d5e3036ae22c52c22c253 Mon Sep 17 00:00:00 2001 From: Marko Oldenburg Date: Tue, 9 Dec 2025 08:42:24 +0100 Subject: [PATCH] Add Helm chart for calibre-web deployment This commit introduces a new Helm chart for deploying calibre-web on Kubernetes. The chart includes essential templates for deployment, service, ingress, and persistent volume claims, along with default values configured in a `values.yaml` file. The addition of the Helm chart enables easier deployment and management of calibre-web, allowing users to customize settings like the replica count, image settings, service type, and storage options through the `values.yaml`. A GitHub Actions workflow (`build-chart-calibre-web.yml`) is also included to automate the packaging and uploading of the Helm chart upon updates to the main branch. The structure and organization of the templates adhere to Helm best practices, ensuring compatibility and ease of use. There are no breaking changes associated with this addition, but users should review the `values.yaml` for configurable options. --- .gitea/workflows/build-chart-calibre-web.yml | 43 +++++++ charts/cailbre-web/.helmignore | 22 ++++ charts/cailbre-web/Chart.yaml | 21 ++++ charts/cailbre-web/templates/NOTES.txt | 18 +++ charts/cailbre-web/templates/_helpers.tpl | 63 ++++++++++ charts/cailbre-web/templates/deployment.yaml | 91 ++++++++++++++ charts/cailbre-web/templates/ingress.yaml | 64 ++++++++++ charts/cailbre-web/templates/service.yaml | 15 +++ .../cailbre-web/templates/serviceaccount.yaml | 8 ++ .../templates/tests/test-connection.yaml | 15 +++ charts/cailbre-web/templates/volumes.yaml | 44 +++++++ charts/cailbre-web/values.yaml | 119 ++++++++++++++++++ 12 files changed, 523 insertions(+) create mode 100644 .gitea/workflows/build-chart-calibre-web.yml create mode 100644 charts/cailbre-web/.helmignore create mode 100644 charts/cailbre-web/Chart.yaml create mode 100644 charts/cailbre-web/templates/NOTES.txt create mode 100644 charts/cailbre-web/templates/_helpers.tpl create mode 100644 charts/cailbre-web/templates/deployment.yaml create mode 100644 charts/cailbre-web/templates/ingress.yaml create mode 100644 charts/cailbre-web/templates/service.yaml create mode 100644 charts/cailbre-web/templates/serviceaccount.yaml create mode 100644 charts/cailbre-web/templates/tests/test-connection.yaml create mode 100644 charts/cailbre-web/templates/volumes.yaml create mode 100644 charts/cailbre-web/values.yaml diff --git a/.gitea/workflows/build-chart-calibre-web.yml b/.gitea/workflows/build-chart-calibre-web.yml new file mode 100644 index 0000000..a80c4c4 --- /dev/null +++ b/.gitea/workflows/build-chart-calibre-web.yml @@ -0,0 +1,43 @@ +name: "Build Helm Chart" +on: + push: + branches: + - main + paths: + - "charts/calibre-web/Chart.yaml" + +jobs: + helm-package: + runs-on: ubuntu-latest + env: + APP: charts/calibre-web + steps: + - name: Checkout repository + uses: actions/checkout@v3 + + - name: Set Helm Chart App Name and Version + id: get_version + run: | + APP_NAME=$(grep -oP '(?<=^name: ).*' ${{ env.APP }}/Chart.yaml) + echo "Helm Chart App Name: $APP_NAME" + echo "::set-output name=app::$APP_NAME" + + CHART_VERSION=$(grep -oP '(?<=^version: ).*' ${{ env.APP }}/Chart.yaml) + echo "Helm Chart version: $CHART_VERSION" + echo "::set-output name=tag::$CHART_VERSION" + + - name: Setup Helm + run: | + #curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash + curl -kSso /usr/local/bin/helm https://debmirror.cooltux.net/helm-v3.18.4 && chmod +x /usr/local/bin/helm + helm version + + - name: Package Helm Chart + run: | + helm dependency update ${{ env.APP }} + helm lint ${{ env.APP }} + helm package ${{ env.APP }} + + - name: Upload Helm Package to repo + run: | + curl --user ${{ secrets.USER }}:${{ secrets.TOKEN }} -X POST --upload-file ./${{ steps.get_version.outputs.app }}-${{ steps.get_version.outputs.tag }}.tgz ${{ vars.HELMREGISTRY }}/api/packages/${{ vars.OWNER }}/helm/api/charts diff --git a/charts/cailbre-web/.helmignore b/charts/cailbre-web/.helmignore new file mode 100644 index 0000000..50af031 --- /dev/null +++ b/charts/cailbre-web/.helmignore @@ -0,0 +1,22 @@ +# Patterns to ignore when building packages. +# This supports shell glob matching, relative path matching, and +# negation (prefixed with !). Only one pattern per line. +.DS_Store +# Common VCS dirs +.git/ +.gitignore +.bzr/ +.bzrignore +.hg/ +.hgignore +.svn/ +# Common backup files +*.swp +*.bak +*.tmp +*~ +# Various IDEs +.project +.idea/ +*.tmproj +.vscode/ diff --git a/charts/cailbre-web/Chart.yaml b/charts/cailbre-web/Chart.yaml new file mode 100644 index 0000000..3a31ce6 --- /dev/null +++ b/charts/cailbre-web/Chart.yaml @@ -0,0 +1,21 @@ +apiVersion: v2 +name: calibre-web +description: A Helm chart for Kubernetes + +# A chart can be either an 'application' or a 'library' chart. +# +# Application charts are a collection of templates that can be packaged into versioned archives +# to be deployed. +# +# Library charts provide useful utilities or functions for the chart developer. They're included as +# a dependency of application charts to inject those utilities and functions into the rendering +# pipeline. Library charts do not define any templates and therefore cannot be deployed. +type: application + +# This is the chart version. This version number should be incremented each time you make changes +# to the chart and its templates, including the app version. +version: 0.1.1 + +# This is the version number of the application being deployed. This version number should be +# incremented each time you make changes to the application. +appVersion: 0.6.25-ls360 diff --git a/charts/cailbre-web/templates/NOTES.txt b/charts/cailbre-web/templates/NOTES.txt new file mode 100644 index 0000000..364e1ca --- /dev/null +++ b/charts/cailbre-web/templates/NOTES.txt @@ -0,0 +1,18 @@ +1. Get the application URL by running these commands: +{{- if .Values.ingress.enabled }} +{{- range $host := .Values.ingress.hosts }} +{{- end }} +{{- else if contains "NodePort" .Values.service.type }} + export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "calibre-web.fullname" . }}) + export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}") + echo http://$NODE_IP:$NODE_PORT +{{- else if contains "LoadBalancer" .Values.service.type }} + NOTE: It may take a few minutes for the LoadBalancer IP to be available. + You can watch the status of by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "calibre-web.fullname" . }}' + export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "calibre-web.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}") + echo http://$SERVICE_IP:{{ .Values.service.port }} +{{- else if contains "ClusterIP" .Values.service.type }} + export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "calibre-web.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}") + echo "Visit http://127.0.0.1:8080 to use your application" + kubectl --namespace {{ .Release.Namespace }} port-forward $POD_NAME 8080:80 +{{- end }} diff --git a/charts/cailbre-web/templates/_helpers.tpl b/charts/cailbre-web/templates/_helpers.tpl new file mode 100644 index 0000000..0807eab --- /dev/null +++ b/charts/cailbre-web/templates/_helpers.tpl @@ -0,0 +1,63 @@ +{{/* vim: set filetype=mustache: */}} +{{/* +Expand the name of the chart. +*/}} +{{- define "calibre-web.name" -}} +{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}} +{{- end -}} + +{{/* +Create a default fully qualified app name. +We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec). +If release name contains chart name it will be used as a full name. +*/}} +{{- define "calibre-web.fullname" -}} +{{- if .Values.fullnameOverride -}} +{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}} +{{- else -}} +{{- $name := default .Chart.Name .Values.nameOverride -}} +{{- if contains $name .Release.Name -}} +{{- .Release.Name | trunc 63 | trimSuffix "-" -}} +{{- else -}} +{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}} +{{- end -}} +{{- end -}} +{{- end -}} + +{{/* +Create chart name and version as used by the chart label. +*/}} +{{- define "calibre-web.chart" -}} +{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" -}} +{{- end -}} + +{{/* +Common labels +*/}} +{{- define "calibre-web.labels" -}} +helm.sh/chart: {{ include "calibre-web.chart" . }} +{{ include "calibre-web.selectorLabels" . }} +{{- if .Chart.AppVersion }} +app.kubernetes.io/version: {{ .Chart.AppVersion | quote }} +{{- end }} +app.kubernetes.io/managed-by: {{ .Release.Service }} +{{- end -}} + +{{/* +Selector labels +*/}} +{{- define "calibre-web.selectorLabels" -}} +app.kubernetes.io/name: {{ include "calibre-web.name" . }} +app.kubernetes.io/instance: {{ .Release.Name }} +{{- end -}} + +{{/* +Create the name of the service account to use +*/}} +{{- define "calibre-web.serviceAccountName" -}} +{{- if .Values.serviceAccount.create -}} + {{ default (include "calibre-web.fullname" .) .Values.serviceAccount.name }} +{{- else -}} + {{ default "default" .Values.serviceAccount.name }} +{{- end -}} +{{- end -}} diff --git a/charts/cailbre-web/templates/deployment.yaml b/charts/cailbre-web/templates/deployment.yaml new file mode 100644 index 0000000..82f60fc --- /dev/null +++ b/charts/cailbre-web/templates/deployment.yaml @@ -0,0 +1,91 @@ +apiVersion: apps/v1 +kind: Deployment +metadata: + name: {{ include "calibre-web.fullname" . }} + labels: + {{- include "calibre-web.labels" . | nindent 4 }} + {{- with .Values.annotations }} + annotations: + {{- toYaml . | nindent 4 }} + {{- end }} +spec: + replicas: {{ .Values.replicaCount }} + selector: + matchLabels: + {{- include "calibre-web.selectorLabels" . | nindent 6 }} + template: + metadata: + labels: + {{- include "calibre-web.selectorLabels" . | nindent 8 }} + {{- with .Values.podAnnotations }} + annotations: + {{- toYaml . | nindent 8 }} + {{- end }} + spec: + {{- with .Values.imagePullSecrets }} + imagePullSecrets: + {{- toYaml . | nindent 8 }} + {{- end }} + serviceAccountName: {{ include "calibre-web.serviceAccountName" . }} + securityContext: + {{- toYaml .Values.podSecurityContext | nindent 8 }} + containers: + - name: {{ .Chart.Name }} + securityContext: + {{- toYaml .Values.securityContext | nindent 12 }} + image: "{{ .Values.image.repository }}:{{ .Chart.AppVersion }}" + imagePullPolicy: {{ .Values.image.pullPolicy }} + env: + {{ toYaml .Values.env | nindent 12 }} + ports: + - name: http + containerPort: 8083 + protocol: TCP + startupProbe: + httpGet: + path: / + port: http + failureThreshold: 30 + periodSeconds: 5 + livenessProbe: + httpGet: + path: / + port: http + readinessProbe: + httpGet: + path: / + port: http + volumeMounts: + - name: data + mountPath: /books + - name: config + mountPath: /config + resources: + {{- toYaml .Values.resources | nindent 12 }} + volumes: + - name: data + persistentVolumeClaim: + {{- if .Values.persistence.data.claimName }} + claimName: "{{ .Values.persistence.data.claimName }}" + {{- else }} + claimName: "{{ template "calibre-web.fullname" . }}-data" + {{- end }} + - name: config + persistentVolumeClaim: + {{- if .Values.persistence.config.claimName }} + claimName: "{{ .Values.persistence.config.claimName }}" + {{- else }} + claimName: "{{ template "calibre-web.fullname" . }}-config" + {{- end }} + {{- with .Values.nodeSelector }} + nodeSelector: + {{- toYaml . | nindent 8 }} + {{- end }} + {{- with .Values.affinity }} + affinity: + {{- toYaml . | nindent 8 }} + {{- end }} + {{- with .Values.tolerations }} + tolerations: + {{- toYaml . | nindent 8 }} + {{- end }} diff --git a/charts/cailbre-web/templates/ingress.yaml b/charts/cailbre-web/templates/ingress.yaml new file mode 100644 index 0000000..c39cc6e --- /dev/null +++ b/charts/cailbre-web/templates/ingress.yaml @@ -0,0 +1,64 @@ +{{- if .Values.ingress.enabled }} +{{- $fullName := "calibre-web" -}} +{{- $svcPort := .Values.service.port -}} +{{- if and .Values.ingress.className (not (semverCompare ">=1.18-0" .Capabilities.KubeVersion.GitVersion)) }} + {{- if not (hasKey .Values.ingress.annotations "kubernetes.io/ingress.class") }} + {{- $_ := set .Values.ingress.annotations "kubernetes.io/ingress.class" .Values.ingress.className}} + {{- end }} +{{- end }} +{{- if semverCompare ">=1.19-0" .Capabilities.KubeVersion.GitVersion -}} +apiVersion: networking.k8s.io/v1 +{{- else if semverCompare ">=1.14-0" .Capabilities.KubeVersion.GitVersion -}} +apiVersion: networking.k8s.io/v1beta1 +{{- else -}} +apiVersion: extensions/v1beta1 +{{- end }} +kind: Ingress +metadata: + name: {{ $fullName }} + labels: + app.kubernetes.io/name: excalidraw + app.kubernetes.io/instance: {{ .Release.Name | quote }} + app.kubernetes.io/version: {{ .Chart.AppVersion | quote }} + app.kubernetes.io/managed-by: {{ .Release.Service | quote }} + {{- with .Values.ingress.annotations }} + annotations: + {{- toYaml . | nindent 4 }} + {{- end }} +spec: + {{- if and .Values.ingress.className (semverCompare ">=1.18-0" .Capabilities.KubeVersion.GitVersion) }} + ingressClassName: {{ .Values.ingress.className }} + {{- end }} + {{- if .Values.ingress.tls }} + tls: + {{- range .Values.ingress.tls }} + - hosts: + {{- range .hosts }} + - {{ . | quote }} + {{- end }} + secretName: {{ .secretName }} + {{- end }} + {{- end }} + rules: + {{- range .Values.ingress.hosts }} + - host: {{ .host | quote }} + http: + paths: + {{- range .paths }} + - path: {{ .path }} + {{- if and .pathType (semverCompare ">=1.18-0" $.Capabilities.KubeVersion.GitVersion) }} + pathType: {{ .pathType }} + {{- end }} + backend: + {{- if semverCompare ">=1.19-0" $.Capabilities.KubeVersion.GitVersion }} + service: + name: {{ $fullName }} + port: + number: {{ $svcPort }} + {{- else }} + serviceName: {{ $fullName }} + servicePort: {{ $svcPort }} + {{- end }} + {{- end }} + {{- end }} +{{- end }} diff --git a/charts/cailbre-web/templates/service.yaml b/charts/cailbre-web/templates/service.yaml new file mode 100644 index 0000000..95123da --- /dev/null +++ b/charts/cailbre-web/templates/service.yaml @@ -0,0 +1,15 @@ +apiVersion: v1 +kind: Service +metadata: + name: {{ include "calibre-web.fullname" . }} + labels: + {{- include "calibre-web.labels" . | nindent 4 }} +spec: + type: {{ .Values.service.type }} + ports: + - port: {{ .Values.service.port }} + targetPort: http + protocol: TCP + name: http + selector: + {{- include "calibre-web.selectorLabels" . | nindent 4 }} diff --git a/charts/cailbre-web/templates/serviceaccount.yaml b/charts/cailbre-web/templates/serviceaccount.yaml new file mode 100644 index 0000000..681e38b --- /dev/null +++ b/charts/cailbre-web/templates/serviceaccount.yaml @@ -0,0 +1,8 @@ +{{- if .Values.serviceAccount.create -}} +apiVersion: v1 +kind: ServiceAccount +metadata: + name: {{ include "calibre-web.serviceAccountName" . }} + labels: +{{ include "calibre-web.labels" . | nindent 4 }} +{{- end -}} diff --git a/charts/cailbre-web/templates/tests/test-connection.yaml b/charts/cailbre-web/templates/tests/test-connection.yaml new file mode 100644 index 0000000..0b49476 --- /dev/null +++ b/charts/cailbre-web/templates/tests/test-connection.yaml @@ -0,0 +1,15 @@ +apiVersion: v1 +kind: Pod +metadata: + name: "{{ include "calibre-web.fullname" . }}-test-connection" + labels: +{{ include "calibre-web.labels" . | nindent 4 }} + annotations: + "helm.sh/hook": test-success +spec: + containers: + - name: wget + image: busybox + command: ['wget'] + args: ['{{ include "calibre-web.fullname" . }}:{{ .Values.service.port }}'] + restartPolicy: Never diff --git a/charts/cailbre-web/templates/volumes.yaml b/charts/cailbre-web/templates/volumes.yaml new file mode 100644 index 0000000..db255ed --- /dev/null +++ b/charts/cailbre-web/templates/volumes.yaml @@ -0,0 +1,44 @@ +{{- if not .Values.persistence.config.claimName }} +apiVersion: v1 +kind: PersistentVolumeClaim +metadata: + name: {{ template "calibre-web.fullname" . }}-config + labels: + app: {{ template "calibre-web.name" . }} + chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }} + release: {{ .Release.Name }} + heritage: {{ .Release.Service }} + component: config +spec: + accessModes: + - ReadWriteMany + resources: + requests: + storage: {{ .Values.persistence.config.size | quote }} +{{- if .Values.persistence.config.storageClass }} + storageClassName: {{ .Values.persistence.config.storageClass | quote }} +{{- end }} +--- +{{- end }} +{{- if not .Values.persistence.data.claimName }} +apiVersion: v1 +kind: PersistentVolumeClaim +metadata: + name: {{ template "calibre-web.fullname" . }}-data + labels: + app: {{ template "calibre-web.name" . }} + chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }} + release: {{ .Release.Name }} + heritage: {{ .Release.Service }} + component: data +spec: + accessModes: + - ReadWriteMany + resources: + requests: + storage: {{ .Values.persistence.data.size | quote }} +{{- if .Values.persistence.data.storageClass }} + storageClassName: {{ .Values.persistence.data.storageClass | quote }} +{{- end }} +--- +{{- end }} diff --git a/charts/cailbre-web/values.yaml b/charts/cailbre-web/values.yaml new file mode 100644 index 0000000..9333fa0 --- /dev/null +++ b/charts/cailbre-web/values.yaml @@ -0,0 +1,119 @@ +# Default values for calibre-web. +# This is a YAML-formatted file. +# Declare variables to be passed into your templates. + +replicaCount: 1 + +image: + repository: linuxserver/calibre-web + tag: latest + pullPolicy: IfNotPresent + +imagePullSecrets: [] +nameOverride: "" +fullnameOverride: "" + +serviceAccount: + # Specifies whether a service account should be created + create: true + # The name of the service account to use. + # If not set and create is true, a name is generated using the fullname template + name: + +podSecurityContext: {} + # fsGroup: 2000 + +securityContext: {} + # capabilities: + # drop: + # - ALL + # readOnlyRootFilesystem: true + # runAsNonRoot: true + # runAsUser: 1000 + +service: + type: ClusterIP + port: 80 + + + +ingress: + enabled: false + className: "" + annotations: + {} + # kubernetes.io/ingress.class: nginx + # kubernetes.io/tls-acme: "true" + hosts: + - host: chart-example.local + paths: + - path: / + pathType: ImplementationSpecific + tls: [] + # - secretName: chart-example-tls + # hosts: + # - chart-example.local + + +env: [] +# - name: USE_CONFIG_DIR +# value: "true" +# - name: SET_CONTAINER_TIMEZONE +# value: "true" +# - name: CONTAINER_TIMEZONE +# value: "UTC" +# - name: PUID +# value: 1029 +# - name: PGID +# value: 65539 +# - name: ADVANCED_DISABLEUPDATES +# value: "true" + + +persistence: + data: + # Optionally specify claimName to manually override the PVC to be used for + # the data directory. If claimName is specified, storageClass and size are + # ignored. + ## claimName: "calibre-data-pvc" + # Optionally specify a storage class to be used for the data directory. + # If not specified and claimName is not specified, the default storage + # class will be used. + storageClass: "" + # The requested size of the volume to be used when creating a + # PersistentVolumeClaim. + size: 40Gi + config: + # Optionally specify claimName to manually override the PVC to be used for + # the config directory. If claimName is specified, storageClass and size + # are ignored. + ## claimName: "calibre-config-pvc" + # Optionally specify a storage class to be used for the config directory. + # If not specified and claimName is not specified, the default storage + # class will be used. + storageClass: "" + # The requested size of the volume to be used when creating a + # PersistentVolumeClaim. + size: 20Gi + +resources: {} + # We usually recommend not to specify default resources and to leave this as a conscious + # choice for the user. This also increases chances charts run on environments with little + # resources, such as Minikube. If you do want to specify resources, uncomment the following + # lines, adjust them as necessary, and remove the curly braces after 'resources:'. + # limits: + # cpu: 100m + # memory: 128Mi + # requests: + # cpu: 100m + # memory: 128Mi + +nodeSelector: {} + +tolerations: [] + +annotations: [] + +podAnnotations: [] + +affinity: {}