zengxs/gitlab

GitLab Docker镜像（ARM64架构）

镜像概述

本镜像为针对ARM64架构优化的GitLab Docker镜像，基于GitLab官方核心功能开发，专为ARM64平台（如ARM服务器、开发板等）提供稳定的GitLab服务部署方案。镜像完整适配ARM64架构特性，确保在ARM64设备上可直接运行，无需额外架构转换，简化GitLab在ARM环境中的部署流程。

核心功能和特性

• 完整GitLab功能支持：包含代码仓库管理、版本控制、分支管理、合并请求、代码审查、CI/CD流水线、Issue跟踪、Wiki文档等GitLab标准功能。
• ARM64架构深度适配：针对ARM64处理器指令集优化，确保服务运行效率与稳定性，兼容主流ARM64设备。
• 数据持久化：支持通过卷挂载实现配置文件、日志和应用数据的持久化存储，避免容器重启导致数据丢失。
• 灵活配置：支持通过环境变量、配置文件自定义GitLab服务参数（如外部访问URL、端口映射、资源限制等）。

使用场景和适用范围

• ARM64服务器部署：适用于基于ARM64架构的物理服务器或云服务器（如AWS Graviton、阿里云ARM实例等）部署GitLab服务。
• 开发板环境：支持在ARM64开发板（如树莓派4/5、NVIDIA Jetson系列、Rockchip平台设备等）搭建本地GitLab服务器。
• 边缘计算场景：满足边缘计算节点、物联网设备等ARM64环境下的本地化代码管理与CI/CD需求。
• 低成本私有仓库：在ARM64低功耗设备上部署轻量级GitLab服务，降低硬件成本。

详细使用方法和配置说明

基本部署（Docker Run）

通过docker run命令快速启动服务：

bash
docker run -d \
  --name gitlab-arm64 \
  --restart always \
  -p 80:80 \           # HTTP端口映射
  -p 443:443 \         # HTTPS端口映射（如需）
  -p 22:22 \           # SSH端口映射（Git仓库SSH访问）
  -v /srv/gitlab/config:/etc/gitlab \       # 配置文件持久化
  -v /srv/gitlab/logs:/var/log/gitlab \     # 日志文件持久化
  -v /srv/gitlab/data:/var/opt/gitlab \     # 应用数据持久化
  zengxs/gitlab-docker:latest

Docker Compose配置（推荐）

创建docker-compose.yml文件，定义服务配置：

yaml
version: '3.8'
services:
  gitlab:
    image: zengxs/gitlab-docker:latest
    container_name: gitlab
    restart: always
    ports:
      - "80:80"       # HTTP端口
      - "443:443"     # HTTPS端口
      - "22:22"       # SSH端口
    volumes:
      - /srv/gitlab/config:/etc/gitlab
      - /srv/gitlab/logs:/var/log/gitlab
      - /srv/gitlab/data:/var/opt/gitlab
    environment:
      - TZ=Asia/Shanghai  # 设置时区
      - GITLAB_OMNIBUS_CONFIG="external_url 'http://gitlab.example.com'; gitlab_rails['gitlab_shell_ssh_port'] = 22;"  # 核心配置
    deploy:
      resources:
        limits:
          cpus: '4'      # CPU资源限制（根据设备调整）
          memory: 4G     # 内存限制（建议至少4GB）

启动服务：

bash
docker-compose up -d

核心配置参数

环境变量说明

关键配置示例（GITLAB_OMNIBUS_CONFIG）

bash
GITLAB_OMNIBUS_CONFIG="
  external_url 'https://gitlab.example.com';  # 外部访问URL（HTTP/HTTPS）
  gitlab_rails['gitlab_shell_ssh_port'] = 2222;  # 自定义SSH端口（如宿主机22端口被占用时）
  nginx['ssl_certificate'] = '/etc/gitlab/ssl/gitlab.crt';  # SSL证书路径
  nginx['ssl_certificate_key'] = '/etc/gitlab/ssl/gitlab.key';  # SSL密钥路径
  postgresql['shared_buffers'] = '1GB';  # PostgreSQL缓存配置（根据内存调整）
"

数据持久化说明

为避免容器重启或删除导致数据丢失，需挂载以下目录：

服务访问与初始化

1. 首次启动：服务首次启动需5-10分钟（取决于设备性能），可通过docker logs -f gitlab查看启动进度。
2. 访问方式：通过http://<宿主机IP>或配置的external_url访问GitLab Web界面。
3. 初始化配置：首次登录需设置管理员密码（默认管理员账号为root），完成后即可创建用户、项目并使用GitLab功能。

注意事项

• 硬件要求：建议ARM64设备至少满足4核CPU、4GB RAM、20GB存储空间（代码仓库数据量较大时需增加存储）。
• 端口冲突：若宿主机22/80/443端口已被占用，需修改端口映射（如-p 8080:80）并同步更新GITLAB_OMNIBUS_CONFIG中的URL和端口配置。
• SSL配置：如需启用HTTPS，需将SSL证书文件放置于宿主机挂载的/srv/gitlab/config/ssl目录，并在GITLAB_OMNIBUS_CONFIG中配置证书路径。
• 升级说明：升级镜像时需先备份数据卷，建议通过docker pull zengxs/gitlab-docker:latest拉取最新镜像后重启容器。