006.md

# GitLab cloud native Helm Chart

> 原文：[https://docs.gitlab.com/charts/](https://docs.gitlab.com/charts/)

*   [Introduction](#introduction)
*   [Limitations](#limitations)
*   [GitLab Helm chart quick start guide](#gitlab-helm-chart-quick-start-guide)
*   [Troubleshooting](#troubleshooting)
*   [Installation](#installation)
    *   [Global settings](#global-settings)
    *   [Complete properties list](#complete-properties-list)
*   [Upgrading](#upgrading)
*   [Uninstall](#uninstall)
*   [Advanced](#advanced)
    *   [Advanced Configuration](#advanced-configuration)
    *   [Migrate from Omnibus GitLab to Kubernetes](#migrate-from-omnibus-gitlab-to-kubernetes)
*   [Architecture](#architecture)
*   [Development](#development)
    *   [GitLab version mappings](#gitlab-version-mappings)
    *   [Contributing](#contributing)

# GitLab cloud native Helm Chart[](#gitlab-cloud-native-helm-chart "Permalink")

这是在云本机环境上安装 GitLab 的官方，推荐和受支持的方法.

**注意：**不必在 Kubernetes 上安装 GitLab 即可使用[GitLab Kubernetes 集成](https://docs.gitlab.com/ee/user/project/clusters/) .

## Introduction[](#introduction "Permalink")

The `gitlab/gitlab` chart is the best way to operate GitLab on Kubernetes. This chart contains all the required components to get started, and can scale to large deployments.

该图表包括完整的体验所需的所有组件，但是每个部分都可以单独安装.

*   GitLab 核心组件：
    *   [NGINX 入口](charts/nginx/index.html)
    *   [登记处](charts/registry/index.html)
    *   [亚搏体育 app](charts/gitlab/gitaly/index.html) / [Gitaly](charts/gitlab/gitaly/index.html)
    *   GitLab / [GitLab 出口商](charts/gitlab/gitlab-exporter/index.html)
    *   GitLab / [GitLab Grafana](charts/gitlab/gitlab-grafana/index.html)
    *   GitLab / [GitLab 外壳](charts/gitlab/gitlab-shell/index.html)
    *   GitLab / [迁移](charts/gitlab/migrations/index.html)
    *   [亚搏体育 app](charts/gitlab/sidekiq/index.html) / [Sidekiq](charts/gitlab/sidekiq/index.html)
    *   GitLab / [web 服务](charts/gitlab/webservice/index.html)
*   可选依赖项：
    *   [PostgreSQL 的](https://hub.helm.sh/charts/bitnami/postgresql)
    *   [雷迪斯](https://hub.helm.sh/charts/bitnami/redis)
    *   [MinIO](charts/minio/index.html)
*   可选的补充：
    *   [普罗米修斯](https://hub.helm.sh/charts/stable/prometheus)
    *   [格拉法纳](https://hub.helm.sh/charts/stable/grafana)
    *   使用 Kubernetes 执行器的[*非特权*](https://docs.gitlab.com/runner/install/kubernetes.html) [GitLab Runner](https://docs.gitlab.com/runner/)
    *   使用[Jetstack](https://www.jetstack.io/)的[cert-manager](https://cert-manager.io/docs/)通过[Let's Encrypt](https://letsencrypt.org/)自动提供 SSL

## Limitations[](#limitations "Permalink")

使用 Helm 图表当前无法使用 GitLab 的某些功能：

*   [GitLab Pages](https://gitlab.com/gitlab-org/charts/gitlab/-/issues/37)
*   [Smartcard authentication](https://gitlab.com/gitlab-org/charts/gitlab/-/issues/988)

数据库限制：

*   GitLab Geo 功能[需要使用外部数据库服务](installation/deployment.html#postgresql) .

## GitLab Helm chart quick start guide[](#gitlab-helm-chart-quick-start-guide "Permalink")

对于那些希望在*非生产*用例中尽快建立并运行这些图表的人，我们提供了概念验证（PoC）部署[快速入门指南](quickstart/index.html) .

本指南将通过部署这些图表使用默认值和功能引导用户，但*不*符合生产做好准备的要求. 如果希望在持续负载下将这些图表部署到生产中，则应遵循以下完整的[安装指南](#installation) .

## Troubleshooting[](#troubleshooting "Permalink")

我们已尽力使这些图表尽可能地无缝，但偶尔也会出现无法控制的问题. 我们已收集了一些常见问题的疑难解答技巧. 在提出[问题](https://gitlab.com/gitlab-org/charts/gitlab/-/issues)之前，请先检查这些内容，并通过提出[合并请求](https://gitlab.com/gitlab-org/charts/gitlab/-/merge_requests)随意添加它们！

See [Troubleshooting](troubleshooting/index.html).

## Installation[](#installation "Permalink")

`gitlab/gitlab`图表包含所有必需的依赖项. 在生产中，您可能需要启用可选功能或[高级配置](#advanced-configuration) . 本指南深入介绍了这些图表的所有选项和功能.

如果您只是想部署概念验证进行测试，我们强烈建议您遵循我们的[快速入门](#gitlab-helm-chart-quick-start-guide)进行第一次迭代.

1.  [Preparation](installation/index.html)
2.  [Deployment](installation/deployment.html)

### Global settings[](#global-settings "Permalink")

这些图表的复杂性使其可以使用全局属性. 有许多通用全局设置适用于多个图表. 有关不同的全局配置值及其应用程序的详细信息，请参见[Globals 文档](charts/globals.html) .

### Complete properties list[](#complete-properties-list "Permalink")

经常要求我们将所有可能的属性表直接放入此索引. 这些图表是规模*庞大* ，并作为属性的这种数量超过背景的量，我们在这里很舒服配售. 请参阅我们（几乎） [全面的属性和默认值列表](installation/command-line-options.html) .

## Upgrading[](#upgrading "Permalink")

安装了 GitLab 图表后，应使用`helm upgrade`完成配置更改和图表更新：

```
helm repo add gitlab https://charts.gitlab.io/
helm repo update
helm get values gitlab > gitlab.yaml
helm upgrade gitlab gitlab/gitlab -f gitlab.yaml 
```

有关更多详细信息，请参阅[升级](installation/upgrade.html) .

## Uninstall[](#uninstall "Permalink")

要卸载 GitLab Chart，请运行以下命令：

```
helm uninstall gitlab 
```

**注意：**在 Helm v2 中，您需要使用`helm delete --purge gitlab`命令.

为了连续起见，这些图表具有一些在执行`helm uninstall`时不会删除的 Kubernetes 对象. 这些是我们要求您有*意识地*删除的项目，因为它们会影响您应选择的重新部署.

*   用于状态数据的 PVC，必须*自觉*删除
    *   Gitaly：这是您的存储库数据.
    *   PostgreSQL（如果内部）：这是您的元数据.
    *   Redis（如果内部）：这是缓存和作业队列，可以安全地将其删除.
*   机密（如果由我们的共享机密工作生成）. 这些图表旨在避免直接通过 Helm 生成 Kubernetes 秘密. 因此，Helm 无法删除它们. 它们包含密码，加密机密等.它们不应被恶意破坏.
*   ConfigMaps
    *   `ingress-controller-leader-RELEASE-nginx` ：这是由 NGINX Ingress 控制器本身生成的，不在我们图表的控制范围内. 可以安全地将其删除.

PVC 和秘密将设置`release`标签，因此您可以通过以下方式找到它们：

```
kubectl get pvc,secret -lrelease=gitlab 
```

## Advanced[](#advanced "Permalink")

除了在云本机环境中进行 GitLab 的基本部署以外，还可以进行更复杂的配置. 本节为需要进一步计划的任务提供指导，例如大规模部署或从 Omnibus GitLab 迁移.

### Advanced Configuration[](#advanced-configuration "Permalink")

高级和大规模部署具有利用外部服务，扩展功能和备用提供程序的能力.

高级配置示例：

*   亚搏体育 app Geo
*   外部对象存储提供者
*   外部 PostgreSQL，Redis，Gitaly
*   外部入口提供商

See [Advanced Configuration](advanced/index.html).

### Migrate from Omnibus GitLab to Kubernetes[](#migrate-from-omnibus-gitlab-to-kubernetes "Permalink")

可以从[Omnibus GitLab](https://docs.gitlab.com/omnibus/)迁移到这些图表. 这样做通常需要将现有数据迁移到对象存储，因此是[高级配置](advanced/index.html) .

要将现有的 Omnibus GitLab 实例迁移到这些图表，请遵循[迁移文档](installation/migration/index.html) .

## Architecture[](#architecture "Permalink")

这些图表非常复杂，因为它们可以协调整个应用程序套件的部署. 我们提供有关目标，结构，设计决策和资源消耗的[文档](architecture/index.html) .

## Development[](#development "Permalink")

对于那些有兴趣为这些图表做出贡献的人，我们提供了涵盖该项目工作范围的开发指南. 它们可以在[开发中](development/index.html) .

### GitLab version mappings[](#gitlab-version-mappings "Permalink")

GitLab 图表与 GitLab 本身的版本号不同. 预计可能需要在图表中引入一些重大更改，这些更改可能会导致重大版本颠簸，而对这些更改的要求可能会完全阻止这些图表上的其他开发，直到完成为止.

要快速查看它们映射到的`gitlab`图表版本和 GitLab 版本的完整列表，请对[Helm](installation/tools.html#helm)发出以下命令：

```
helm repo add gitlab https://charts.gitlab.io/
helm search repo -l gitlab/gitlab 
```

**注意**对于 Helm v2，搜索命令将为`helm search -l gitlab/gitlab`

有关更多信息，请访问[版本映射 docs](installation/version_mappings.html) .

### Contributing[](#contributing "Permalink")

除了我们的[贡献准则](https://gitlab.com/gitlab-org/charts/gitlab/tree/master/CONTRIBUTING.md)之外，请参阅[开发者文档](development/index.html)以了解如何对 GitLab 图表[做出贡献](https://gitlab.com/gitlab-org/charts/gitlab/tree/master/CONTRIBUTING.md) .