GitLab cloud native Helm Chart · Gitlab 中文文檔

# 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) .