code.gitea.io/gitea@v1.22.3/docs/content/installation/on-kubernetes.en-us.md (about)

     1  ---
     2  date: "2020-03-19T19:27:00+02:00"
     3  title: "Install on Kubernetes"
     4  slug: "install-on-kubernetes"
     5  sidebar_position: 80
     6  toc: false
     7  draft: false
     8  aliases:
     9    - /en-us/install-on-kubernetes
    10  menu:
    11    sidebar:
    12      parent: "installation"
    13      name: "Kubernetes"
    14      sidebar_position: 80
    15      identifier: "install-on-kubernetes"
    16  ---
    17  
    18  # Installation with Helm (on Kubernetes)
    19  
    20  Gitea provides a Helm Chart to allow for installation on kubernetes.
    21  
    22  A non-customized install can be done with:
    23  
    24  ```
    25  helm repo add gitea-charts https://dl.gitea.com/charts/
    26  helm install gitea gitea-charts/gitea
    27  ```
    28  
    29  If you would like to customize your install, which includes kubernetes ingress, please refer to the complete [Gitea helm chart configuration details](https://gitea.com/gitea/helm-chart/)
    30  
    31  ## Health check endpoint
    32  
    33  Gitea comes with a health check endpoint `/api/healthz`, you can configure it in kubernetes like this:
    34  
    35  ```yaml
    36    livenessProbe:
    37      httpGet:
    38        path: /api/healthz
    39        port: http
    40      initialDelaySeconds: 200
    41      timeoutSeconds: 5
    42      periodSeconds: 10
    43      successThreshold: 1
    44      failureThreshold: 10
    45  ```
    46  
    47  a successful health check response will respond with http code `200`, here's example:
    48  
    49  ```
    50  HTTP/1.1 200 OK
    51  
    52  {
    53    "status": "pass",
    54    "description": "Gitea: Git with a cup of tea",
    55    "checks": {
    56      "cache:ping": [
    57        {
    58          "status": "pass",
    59          "time": "2022-02-19T09:16:08Z"
    60        }
    61      ],
    62      "database:ping": [
    63        {
    64          "status": "pass",
    65          "time": "2022-02-19T09:16:08Z"
    66        }
    67      ]
    68    }
    69  }
    70  ```
    71  
    72  for more information, please reference to kubernetes documentation [Define a liveness HTTP request](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/#define-a-liveness-http-request)