ARM64平台GitLab-CE部署实战：Docker Compose编排与低内存优化

1. ARM64平台GitLab-CE部署概述

在树莓派、Mac M系列芯片等ARM64设备上部署GitLab-CE，既能充分利用闲置硬件资源，又能获得完整的代码托管体验。但ARM架构与传统x86环境存在差异，官方Docker镜像也不直接支持ARM64，这就需要我们寻找替代方案。

我实测发现，GitLab-CE在2GB内存的设备上运行会频繁出现502错误，这是因为默认配置中Sidekiq、Prometheus等组件会占用大量资源。通过禁用非必要服务、调整Unicorn工作进程数等优化手段，完全可以在低配ARM设备上稳定运行。

2. 准备工作与环境配置

2.1 硬件需求建议

• 内存：最低2GB（需优化配置），推荐4GB以上
• 存储：至少10GB可用空间（代码仓库体积会持续增长）
• SWAP分区：建议配置1GB以上交换分区（尤其在内存不足时）

在树莓派4B上实测：未优化前内存占用立即突破1.8GB，优化后可控制在1.2GB以内。

2.2 ARM64兼容镜像选择

官方镜像不支持ARM架构，推荐使用社区维护的替代镜像：

docker pull yrzr/gitlab-ce-arm64v8:latest

这个镜像基于官方代码重新编译，已修复Redis在ARM平台的COW-BUG问题。若需要最新版本，可自行构建：

FROM ubuntu:22.04 RUN apt-get update && apt-get install -y curl openssh-server ca-certificates RUN curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | bash RUN apt-get install gitlab-ce

3. Docker Compose编排实战

3.1 目录结构规划

建议将配置、数据、日志分离存储：

mkdir -p /srv/gitlab/{config,data,logs} chmod 777 /srv/gitlab/logs # 解决权限问题

3.2 编写docker-compose.yml

version: '3.7' services: gitlab: image: yrzr/gitlab-ce-arm64v8:latest container_name: gitlab-ce restart: unless-stopped hostname: 'gitlab.yourdomain.com' environment: GITLAB_OMNIBUS_CONFIG: | external_url 'http://192.168.1.100:8080' gitlab_rails['gitlab_shell_ssh_port'] = 2222 redis['max_memory'] = '256MB' # Redis内存限制 sidekiq['max_concurrency'] = 2 # 减少Sidekiq线程 ports: - "8080:80" - "2222:22" volumes: - /srv/gitlab/config:/etc/gitlab - /srv/gitlab/data:/var/opt/gitlab - /srv/gitlab/logs:/var/log/gitlab mem_limit: 2g # 容器内存限制 memswap_limit: 3g # 总内存+SWAP限制

关键参数说明：

• mem_limit：硬性内存限制，超出会被OOM Killer终止
• sidekiq['max_concurrency']：减少后台任务并发数
• redis['max_memory']：限制Redis最大内存使用量

4. 低内存优化方案

4.1 禁用非必要服务

编辑/etc/gitlab/gitlab.rb（容器内路径）：

# 关闭监控系统 prometheus['enable'] = false node_exporter['enable'] = false redis_exporter['enable'] = false postgres_exporter['enable'] = false # 调整Unicorn工作进程 unicorn['worker_processes'] = 2 # 默认是CPU核心数 unicorn['worker_memory_limit_min'] = "200MB" unicorn['worker_memory_limit_max'] = "300MB" # 减少后台任务占用 sidekiq['max_concurrency'] = 2 sidekiq['min_concurrency'] = 1

4.2 定期清理任务

添加定时任务（需在宿主机操作）：

# 每天凌晨清理无用数据 0 3 * * * docker exec gitlab-ce gitlab-rake gitlab:cleanup:orphan_job_artifact_files

4.3 SWAP空间优化

对于物理设备，建议创建ZRAM交换分区（以树莓派为例）：

sudo apt install zram-tools echo "ALGO=lz4" | sudo tee -a /etc/default/zramswap echo "PERCENT=100" | sudo tee -a /etc/default/zramswap sudo systemctl restart zramswap

5. 常见问题排查

5.1 Redis启动失败

ARM64平台特有的COW-BUG会导致Redis崩溃，解决方案：

# 在容器内执行 echo 'disable-thp yes' >> /etc/gitlab/redis/redis.conf gitlab-ctl restart redis

5.2 502 Gateway错误

通常由内存不足引起，检查方向：

1. 查看实时资源占用：

   docker stats gitlab-ce

2. 分析OOM日志：

   journalctl -k | grep -i oom

3. 调整Puma替代Unicorn（需GitLab 14.0+）：

   puma['worker_processes'] = 2 puma['per_worker_max_memory_mb'] = 256

5.3 中文语言设置

通过环境变量配置：

environment: GITLAB_OMNIBUS_CONFIG: | gitlab_rails['gitlab_default_can_create_group'] = true gitlab_rails['gitlab_ui_zh_cn'] = true

6. 性能监控与调优

6.1 基础监控命令

# 查看容器实时状态 docker exec gitlab-ce gitlab-ctl status # 检查服务响应时间 docker exec gitlab-ce curl -Is http://localhost/-/health | grep X-Runtime # 数据库性能分析 docker exec -it gitlab-ce gitlab-rails dbconsole > SELECT * FROM pg_stat_activity;

6.2 日志分析技巧

关键日志文件位置：

• /var/log/gitlab/gitlab-rails/production.log- 应用日志
• /var/log/gitlab/nginx/gitlab_access.log- 访问日志

使用grep快速定位问题：

# 查找慢请求 docker exec gitlab-ce grep -B1 -A1 'Completed 200 OK' /var/log/gitlab/gitlab-rails/production.log | grep -E '([0-9]{3})ms' # 监控Sidekiq队列积压 docker exec gitlab-ce gitlab-rake gitlab:sidekiq:queue_latency

在M1 MacBook Pro上的实测数据：优化后内存占用从3.2GB降至1.8GB，页面平均响应时间从1200ms降低到400ms。对于个人开发者或小型团队，这套方案完全能满足日常代码托管需求。