Files

234 lines
8.4 KiB
Ruby
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ============================================================================
# GitLab 17.5.2 性能优化配置 - 专用于 4C8G 宿主机的 CI/CD 场景
# ============================================================================
#
# 宿主机配置: 4 CPU / 8GB RAM
# 内存预算分配 (目标总占用 ≤ 7GB):
# PostgreSQL ~2GB (shared_buffers)
# Redis ~512MB
# Puma ~2GB (2 workers x ~1GB)
# Sidekiq ~512MB
# Gitaly ~512MB
# Nginx ~256MB
# 其他/OS ~1GB+
#
# 与默认配置相比的主要优化:
# 1. 禁用全部监控导出器 (节省 ~300MB 内存 + CPU)
# 2. 禁用 KAS / Pages / Registry / Mattermost / Geo / Spamcheck 等非必要服务
# 3. PostgreSQL 调优 (shared_buffers=2GB, work_mem=16MB, maintenance_work_mem=256MB)
# 4. Puma 2 workers (4C8G 下比 4 workers 更稳定,避免 OOM)
# 5. Sidekiq concurrency 10 (平衡 CI/CD 吞吐与内存)
# 6. Nginx worker_processes=4, worker_connections=10240
# 7. Redis maxmemory=512MB
# 8. Workhorse / Webhook 超时优化适配 CI/CD 大文件场景
# ============================================================================
# ----------------------------------------------------------------------------
# 基础配置
# ----------------------------------------------------------------------------
external_url 'http://gitlab.example.com'
gitlab_rails['time_zone'] = 'Asia/Shanghai'
# ----------------------------------------------------------------------------
# 禁用监控相关服务(节省约 300MB 内存 + CPU 开销)
# 如需使用外部 Prometheus,可保持禁用
# ----------------------------------------------------------------------------
alertmanager['enable'] = false
prometheus['enable'] = false
node_exporter['enable'] = false
redis_exporter['enable'] = false
postgres_exporter['enable'] = false
gitlab_rails['exporter_enabled'] = false
puma['exporter_enabled'] = false
# ----------------------------------------------------------------------------
# 禁用不需要的集成功能
# ----------------------------------------------------------------------------
# Kubernetes Agent Server
gitlab_kas['enable'] = false
# Pages 静态网站托管
gitlab_pages['enable'] = false
# Container Registry 容器镜像仓库
registry['enable'] = false
gitlab_rails['registry_enabled'] = false
# Mattermost 团队协作
mattermost['enable'] = false
# Geo 地理分布式
geo_postgresql['enable'] = false
geo_logcursor['enable'] = false
# Spamcheck 垃圾邮件检查
spamcheck['enable'] = false
# Service Desk 服务台
gitlab_rails['service_desk_email_enabled'] = false
# ----------------------------------------------------------------------------
# 禁用外部服务和遥测
# ----------------------------------------------------------------------------
# LDAP 认证(如不需要)
gitlab_rails['ldap_enabled'] = false
# OmniAuth 第三方登录(如只需本地账号)
gitlab_rails['omniauth_enabled'] = false
# Gravatar 头像(内网环境禁用以减少外部请求)
gitlab_rails['gravatar_plain_url'] = ''
gitlab_rails['gravatar_ssl_url'] = ''
# 使用统计上报
gitlab_rails['usage_ping_enabled'] = false
# Sentry 错误报告
gitlab_rails['sentry_enabled'] = false
gitlab_pages['sentry_enabled'] = false
# Feature Flags(GitLab 内部用,小规模部署可关闭)
gitlab_rails['feature_flags_unleash_enabled'] = false
# ----------------------------------------------------------------------------
# PostgreSQL 调优 (针对 8GB RAM)
# ----------------------------------------------------------------------------
# 建议值: 总内存的 1/4, 上限 14GB → 8GB * 1/4 = 2GB
postgresql['shared_buffers'] = "2GB"
# work_mem: 每个排序/哈希操作的内存,不宜过大(并发时会累乘)
postgresql['work_mem'] = "16MB"
# maintenance_work_mem: VACUUM / CREATE INDEX 等维护操作内存
postgresql['maintenance_work_mem'] = "256MB"
# effective_cache_size: 告诉查询规划器系统可用的缓存总量
postgresql['effective_cache_size'] = "6GB"
# max_connections: Puma workers + Sidekiq + 其他连接
# 2 workers x 4 threads + 10 sidekiq + 10 overhead = 28, 设为 200 留余量
postgresql['max_connections'] = 200
# autovacuum 并发
postgresql['autovacuum_max_workers'] = "3"
# checkpoint 调优
postgresql['checkpoint_timeout'] = "5min"
postgresql['checkpoint_completion_target'] = 0.9
postgresql['max_wal_size'] = "1GB"
postgresql['min_wal_size'] = "80MB"
# 并行查询(4 核下适度开启)
postgresql['max_worker_processes'] = 4
postgresql['max_parallel_workers_per_gather'] = 2
# IO 调优
postgresql['effective_io_concurrency'] = 200
# 统计采样
postgresql['default_statistics_target'] = 1000
# 超时与死锁
postgresql['statement_timeout'] = "60000"
postgresql['idle_in_transaction_session_timeout'] = "60000"
postgresql['deadlock_timeout'] = '5s'
# 日志
postgresql['log_lock_waits'] = 1
# ----------------------------------------------------------------------------
# Redis 调优
# ----------------------------------------------------------------------------
redis['maxclients'] = '10000'
# Redis 内存限制:512MB,8G 内存下给 Redis 适度空间
# CI/CD 场景用 allkeys-lru 可在内存满时自动淘汰最久未用的 key
redis['maxmemory'] = "512mb"
redis['maxmemory_policy'] = "allkeys-lru"
# 快照持久化频率(默认值即可,CI/CD 场景不需要太频繁)
redis['save'] = [ '900 1', '300 10', '60 10000' ]
# 线程 IO(Redis 6.0+,4 核下适度开启)
redis['io_threads'] = 2
redis['io_threads_do_reads'] = true
# TCP 超时
redis['tcp_timeout'] = "300"
redis['tcp_keepalive'] = "60"
# ----------------------------------------------------------------------------
# Nginx 优化(适配 4C8G + CI/CD 大文件传输)
# ----------------------------------------------------------------------------
nginx['enable'] = true
nginx['client_max_body_size'] = '250m'
nginx['gzip_enabled'] = true
nginx['worker_processes'] = 4
nginx['worker_connections'] = 10240
# CI/CD 场景大文件上传下载超时
nginx['proxy_read_timeout'] = 3600
nginx['proxy_connect_timeout'] = 300
# 开启 sendfile / tcp_nopush / tcp_nodelay 提升传输效率
nginx['sendfile'] = 'on'
nginx['tcp_nopush'] = 'on'
nginx['tcp_nodelay'] = 'on'
# keepalive 优化
nginx['keepalive_timeout'] = 65
# ----------------------------------------------------------------------------
# Puma 调优 (Web 服务进程)
# ----------------------------------------------------------------------------
# 4C8G 下: 2 workers x 4 threads = 8 并发, 每 worker ~1GB
# 不要设 4 workers(4x4=16 并发, 内存可能超 4GB 导致 OOM)
puma['worker_processes'] = 2
puma['max_threads'] = 4
puma['min_threads'] = 2
puma['worker_timeout'] = 60
# ----------------------------------------------------------------------------
# Sidekiq 调优 (后台任务处理)
# ----------------------------------------------------------------------------
# 4C8G 下 concurrency=10 是比较平衡的值
# CI/CD 场景有大量异步任务 (pipeline / artifact 清理等)
sidekiq['concurrency'] = 10
# ----------------------------------------------------------------------------
# GitLab Workhorse (反向代理 / 文件传输)
# ----------------------------------------------------------------------------
# CI/CD 场景不限制 API 并发
gitlab_workhorse['api_limit'] = 0
gitlab_workhorse['api_queue_limit'] = 0
# CI Runner 长轮询时间(默认 60s,适当延长减少请求频率)
gitlab_workhorse['api_ci_long_polling_duration'] = '300s'
# ----------------------------------------------------------------------------
# Git / Webhook / LFS 相关优化
# ----------------------------------------------------------------------------
# Git 操作超时(大仓库 clone / push)
gitlab_rails['gitlab_shell_git_timeout'] = 800
# LFS 大文件存储
gitlab_rails['lfs_enabled'] = true
# Webhook 超时(CI/CD 回调场景适当增大)
gitlab_rails['webhook_timeout'] = 300
# ----------------------------------------------------------------------------
# 数据库备份保留策略(默认 7 天)
# ----------------------------------------------------------------------------
gitlab_rails['backup_keep_time'] = 604800
# ----------------------------------------------------------------------------
# 日志优化(减少磁盘 I/O)
# ----------------------------------------------------------------------------
logging['logrotate_rotate'] = 14
logging['logrotate_frequency'] = "daily"
# Git log 级别(生产环境 warn 即可,减少日志量)
# gitaly 默认 level=warn,无需额外配置