管理员文档(核心只有)
了解如何管理您的GitLab实例(社区版和企业版)。普通用户无法访问GitLab管理工具和设置。
GitLab有两个产品发行版:开源版GitLab社区版(CE),以及开放核心GitLab企业版(EE),可透过不同的订阅.
你可以安装GitLab CE或GitLab EE,但您可以访问的功能取决于您选择的订阅(核心、入门、高级或终极)。GitLab社区版安装只能访问核心功能。
GitLab.com由GitLab, Inc.管理,因此,只有GitLab团队成员有权访问其管理配置。如果你是GitLab.com的用户,请检查用户文档.
安装和维护GitLab
了解如何安装、配置、更新和维护您的GitLab实例。
安装GitLab
配置GitLab
- 调整实例的时区:自定义GitLab默认时区。
- 系统钩子:用户、项目和键发生变化时发出通知。
- 安全:了解如何进一步保护GitLab实例。
- 使用统计、版本检查和使用ping:启用或禁用发送到GitLab, Inc.的实例信息。
- 轮询:配置GitLab UI轮询更新的频率。
- GitLab Pages配置:启用并配置GitLab Pages。
- GitLab源代码安装的GitLab Pages配置:开启并配置GitLab Pages源安装.
- 环境变量:支持的环境变量,可以用来覆盖它们的默认值,以配置GitLab。
- 插件:通过自定义插件,GitLab管理员可以引入自定义集成,而无需修改GitLab的源代码。
- 执行服务条款
定制GitLab的外观
- 头标志:更改所有页面和电子邮件标题的标识。
- 品牌登录页面:自定义登录页面的logo、标题和描述。
- 欢迎信息:在登录页面添加自定义欢迎信息。
- “新项目”页面:自定义在用户创建新项目时打开的页面上显示的文本。
维护GitLab
- Raketasks:执行各种维护、备份、自动webhook设置等任务。
- 备份和恢复:备份和恢复您的GitLab实例。
- 操作:保持GitLab正常运行(清理Redis会话,移动存储库,Sidekiq Job节流,Sidekiq MemoryKiller, Unicorn)。
- 重启GitLab:了解如何重新启动GitLab及其组件。
更新GitLab
- GitLab版本和维护策略:了解GitLab版本和版本(主要、次要、补丁、安全),以及更新建议。
- 更新GitLab:更新指南,将安装升级到新版本。
- Downtimeless更新:升级到较新的GitLab主要版本、次要版本或补丁版本,而无需使GitLab实例脱机。
- 将您的GitLab CI/CD数据迁移到另一个版本的GitLab:如果你有一个旧的GitLab安装(8.0以上),按照本指南将现有的GitLab CI/CD数据迁移到另一个版本的GitLab。
升级或降级GitLab
- 从GitLab CE升级到GitLab EE:了解如何将GitLab社区版升级到GitLab企业版。
- 从GitLab EE降级到GitLab CE:了解如何将GitLab企业版降级为社区版。
GitLab平台集成
- Mattermost:集成Mattermost这是一个提供网络信息的开源私有云工作场所。
- PlantUML:在AsciiDoc和Markdown文档中创建简单的图表,这些文档在代码段、wiki和repo中创建。
- 网络终端:从GitLab的CI/CD中为部署到Kubernetes的应用程序提供终端访问环境.
用户设置和权限
- Libravatar:用户头像使用Libravatar而不是Gravatar。
- 注册的限制:阻断特定域的email地址,或只将特定域加入白名单。
- 访问限制:定义哪些Git访问协议可以用来与GitLab对话(SSH, HTTP, HTTPS)。
- 认证/授权:强制2FA,使用LDAP、SAML、CAS和其他Omniauth提供者配置外部身份验证。
- 传入的电子邮件:配置接收的电子邮件以允许用户通过电子邮件回复,创建通过电子邮件解决问题而且通过电子邮件合并请求,并启用[服务台]。
- 接收电子邮件的后缀:在Ubuntu上为传入的电子邮件设置一个IMAP认证的基本Postfix邮件服务器。
- 用户组:显示每月新用户的队列及其随时间变化的活动。
项目设置
- 容器注册表:使用GitLab配置容器注册表。
- 发行结束模式:自定义如何从提交消息中关闭问题。
- 吉塔:配置Gitaly, GitLab的Git仓库存储服务。
- 默认的标签:创建将自动添加到每个新项目的标签。
- 限制使用公共或内部项目:限制用户在创建项目或代码片段时使用可见性级别。
存储库设置
持续集成设置
- 启用/禁用GitLab CI/CD:为实例启用或禁用GitLab CI/CD。
- GitLab CI/CD管理设置:定义最大工件大小和过期时间。
- 工作的工件:启用、禁用和配置作业构件(作业成功完成时输出的一组文件和目录)。
- 工作的痕迹:任务跟踪(日志)信息。
- 工件大小和过期:定义最大工件限制和过期日期。
- 注册共享的和特定的运行程序:了解如何向自己的实例注册和配置共享的和特定的runner。
- 共享runner管道配额:限制共享运行程序的管道分钟数的使用。
- 启用/禁用自动DevOps:为实例启用或禁用自动DevOps。
Git配置选项
监控GitLab
- 监控GitLab:
- 监控运行时间:使用健康检查端点检查服务器状态。
- IP白名单:监视在探测时提供运行状况检查信息的端点。
- 监控GitHub导入: GitLab的GitHub Importer显示Prometheus指标来监控导入器的运行状况和进度。
- 会话发展(ConvDev)索引:提供整个实例的特性使用情况的概述。
性能监控
- GitLab性能监控:
- 开启性能监控:开启GitLab性能监控。
- 使用InfluxDB监视GitLab性能:配置GitLab和InfluxDB用于测量性能指标。
- InfluxDB模式:存储在InfluxDB中的测量值。
- 使用Prometheus进行GitLab性能监视:配置GitLab和Prometheus用于性能度量。
- 用Grafana监控GitLab性能:配置GitLab以通过图形和仪表板可视化时间序列指标。
- 要求分析:获取慢速请求的详细配置文件。
- 性能酒吧:获取当前页面的性能信息。
故障排除
- 调试技巧:出现问题时调试问题的技巧
- 日志系统:哪里可以找到日志。
- Sidekiq故障排除:当Sidekiq显示挂起并且没有处理作业时进行调试。