naizhao/gitlab-arm64

GitLab CE & EE ARM 64 Docker镜像

概述

本镜像为ARM 64架构构建，提供GitLab CE（社区版）和EE（企业版）的Docker化部署方案，旨在简化ARM 64平台上GitLab的安装与运行流程，确保与官方GitLab核心功能兼容。

核心功能

• ARM 64架构支持：专为ARM 64处理器优化，可在ARM 64服务器或设备上稳定运行
• 多版本兼容：包含GitLab CE（社区版）和EE（企业版），满足不同用户需求
• 功能完整性：与官方GitLab镜像功能一致，支持代码仓库管理、CI/CD流水线、用户权限控制等核心功能
• 部署简化：通过Docker容器化封装，减少环境依赖配置，快速完成部署

使用场景

• ARM 64架构服务器（如基于ARM的云服务器、边缘计算设备）部署GitLab实例
• 开发/测试环境中快速搭建ARM平台的GitLab服务
• 企业或个人用户在ARM架构硬件上运行GitLab社区版或企业版

使用方法

前提条件

• 已安装支持ARM 64的Docker环境
• 系统资源建议：至少4GB内存（生产环境推荐8GB以上）
• 网络连接正常（用于拉取镜像及GitLab服务通信）

快速启动（docker run）

使用以下命令启动GitLab容器（以CE版为例，具体镜像标签请参考GitHub仓库）：

bash
docker run -d \
  --name gitlab-ce \
  --hostname gitlab.example.com \  # 替换为实际域名或IP
  -p 80:80 -p 443:443 -p 22:22 \  # 端口映射（HTTP/HTTPS/SSH）
  -v /srv/gitlab/config:/etc/gitlab \  # 配置文件持久化
  -v /srv/gitlab/logs:/var/log/gitlab \  # 日志文件持久化
  -v /srv/gitlab/data:/var/opt/gitlab \  # 数据文件持久化
  naizhao/gitlab-arm64:ce-latest  # 镜像名称及标签（CE版）

Docker Compose配置

创建docker-compose.yml文件（示例）：

yaml
version: '3'
services:
  gitlab:
    image: naizhao/gitlab-arm64:ce-latest  # CE版镜像，EE版需替换标签
    container_name: gitlab
    hostname: gitlab.example.com  # 替换为实际域名或IP
    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  # 数据目录
    restart: always  # 容器异常退出时自动重启

启动服务：

bash
docker-compose up -d

配置说明

数据持久化

通过挂载本地目录实现数据持久化，核心挂载路径：

• /etc/gitlab：GitLab配置文件目录（如gitlab.rb）
• /var/log/gitlab：日志文件目录
• /var/opt/gitlab：应用数据目录（含代码仓库、数据库等）

高级配置

1. 编辑本地挂载的/srv/gitlab/config/gitlab.rb文件进行自定义配置（如邮件服务、LDAP集成、外部数据库等）
2. 配置修改后需重启容器生效：

   bash
   docker restart gitlab-ce  # 替换为实际容器名称
   

访问GitLab

容器启动完成后（首次启动需几分钟初始化），通过以下方式访问：

• Web界面：http://<服务器IP或域名>（默认管理员账号：root，初始密码在/srv/gitlab/config/initial_root_password文件中）
• SSH访问：ssh git@<服务器IP或域名>

注意事项

• 首次启动初始化时间较长（取决于硬件性能），建议通过docker logs -f <容器名称>查看启动进度
• 生产环境建议配置外部数据库和Redis以提升性能和可靠性
• 镜像版本及更新日志请参考项目GitHub仓库
• 企业版使用需确保已获取官方授权许可

获取更多信息

完整文档、镜像标签及更新说明，请访问GitHub项目主页：
https://github.com/naizhao/gitlab-arm64