实践篇: 07-部署代码仓库 (Gitlab)

于 2025-06-28 10:49:33 发布
阅读量839 收藏 13
点赞数 26
CC 4.0 BY-SA版权
分类专栏： Dockerfile企业实战指南 文章标签： gitlab dockerfile docker dockerfile实战
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/unbuntu_luo/article/details/148915398

代码仓库是 DevOps 工作流的起点，用于存储、版本控制和协作开发我们的应用程序代码及 Dockerfile。Gitlab 是一个功能非常强大的、开源的代码托管平台，除了核心的 Git 仓库管理，还集成了 CI/CD、问题跟踪、Wiki 等众多功能。

注意: Gitlab 功能强大，但资源消耗也相对较高（特别是内存）。对于资源有限的环境或仅需核心 Git 功能的场景，可以考虑更轻量级的替代方案，如 Gitea。

本篇将指导你如何使用 Docker Compose 部署一个简化版的 Gitlab Community Edition (CE)，侧重于核心的代码仓库功能，并使用 HTTP 访问，方便快速入门和学习。

环境说明:

  • 准备篇路径二：模拟企业环境"用户: 请确保 hosts 文件中 git.leops.local 指向你的服务器 IP。后续配置中可以将 http://localhost 替换为 http://git.leops.local。
  • 准备篇路径一：本地学习环境"用户: 你将使用 http://localhost 或 http://<你的IP> 来访问 Gitlab。

准备目录和 Docker Compose 文件

  1. 创建 Gitlab 数据目录:
# 切换到合适的安装目录，例如 /data
cd /data
# 创建用于持久化 Gitlab 配置、日志和数据的目录
mkdir -p gitlab/config gitlab/logs gitlab/data gitlab/runner
cd gitlab
  1. 创建 docker-compose.yml 文件:
services:
  gitlab:
    image: 'swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/sameersbn/gitlab:17.11.0'
    container_name: gitlab
    restart: always
    hostname: 'git.leops.local'
    environment:
      TZ: 'Asia/Shanghai'
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://git.leops.local'
        gitlab_rails['time_zone'] = 'Asia/Shanghai'
    ports:
      - '8081:80'
      - '2222:22'
    volumes:
      - ./config:/etc/gitlab
      - ./logs:/var/log/gitlab
      - ./data:/var/opt/gitlab
      - /usr/share/zoneinfo/Asia/Shanghai:/etc/localtime:ro
    shm_size: '256m'
  gitlab-runner:
    image: gitlab/gitlab-runner:alpine3.19-v17.11.0
    restart: always
    container_name: gitlab-runner
    environment:
      CI_SERVER_URL: http://gitlab
      TZ: 'Asia/Shanghai'
    volumes:
      - ./runner:/etc/gitlab-runner
      - ./runner-cache:/cache
      - /var/run/docker.sock:/var/run/docker.sock:rw
      - /etc/localtime:/etc/localtime:ro

配置解释:

  • image: 指定了 Gitlab CE 的 Docker 镜像。建议使用明确的版本号。
  • hostname: 容器的主机名，external_url 中的域名应能解析到运行 Docker 的主机。
  • GITLAB_OMNIBUS_CONFIG: 用于配置 Gitlab 内部服务的关键部分。
  • external_url: 极其重要！ 必须设置为用户访问 Gitlab 时使用的 URL (包含 http://)。Gitlab 会基于此 URL 生成仓库克隆地址等。路径一用户请使用 http://localhost 或 http://<你的IP>。路径二用户使用 http://git.leops.local。
  • ports: 只映射了 HTTP 端口 80。如果需要通过 SSH 访问 Git 仓库，使用 ssh://git@:2222/… 的方式克隆。
  • volumes: 将 Gitlab 的配置、日志和数据持久化到宿主机的 ./config, ./logs, ./data 目录中，非常重要！
  • shm_size: Gitlab 可能需要较大的共享内存，如果遇到性能问题可以尝试增加此值（如 1gb, 2gb）。

启动 Gitlab

在包含 docker-compose.yml 文件的目录 (/data/gitlab) 中执行：

sudo docker compose up -d

首次启动 Gitlab 需要一些时间来完成初始化配置。你可以使用 sudo docker compose logs -f gitlab 来观察启动日志。当看到类似 gitlab Reconfigured! 的信息时，表示基本就绪。

资源提示: Gitlab CE 至少需要 2 核 CPU 和 4GB 可用内存才能流畅运行。如果你的机器配置较低，启动和运行可能会很慢。

Nginx 代理配置

在 /data/nginx/nginx_data/conf.d 目录下创建一个 gitlab.conf 文件：

server {
    listen 80;
    server_name git.leops.local;

    access_log /var/log/nginx/git_access.log;
    error_log /var/log/nginx/git_error.log;

    location / {
        proxy_pass http://192.168.77.140:8081;
        proxy_set_header  Host              $http_host;
        proxy_set_header  X-Real-IP         $remote_addr;
        proxy_set_header  X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header  X-Forwarded-Proto $scheme;

        proxy_buffering off;
        proxy_request_buffering off;

        proxy_send_timeout 900;
        proxy_read_timeout 900;
    }
}

重载 Nginx 配置：

docker exec nginx-proxy sh -c "nginx -t && nginx -s reload"

首次登录和基本设置

  1. 获取初始 root 密码: Gitlab 启动后，初始的 root 用户密码存储在一个临时文件中。通过以下命令查看：
# 等待 Gitlab 完全启动后再执行 (可能需要几分钟)
sudo docker exec gitlab cat /etc/gitlab/initial_root_password

复制输出的文件内容，找到其中的密码 (Password)。这个文件只在首次配置后 24 小时内有效。

  1. 登录 Gitlab:
  • 在浏览器中访问你配置的 external_url (例如 http://localhost 或 http://git.leops.local)。
  • 使用用户名 root 和上面获取的密码登录。
  1. 修改 root 密码: 首次登录后，强烈建议立即修改 root 用户的密码。点击右上角的用户头像 -> Edit profile -> Password。
  2. (可选) 关闭注册: 如果你不希望任何人都能注册账号，可以在管理中心关闭注册。Admin Area -> Settings -> General -> Sign-up restrictions，取消勾选 “Sign-up enabled”。

基本 Git 操作示例

  1. 创建新项目:
  • 登录 Gitlab 后，点击 “New project” -> “Create blank project”。
  • 输入项目名称（如 my-first-app），选择可见性级别 (Private/Public)，然后点击 “Create project”。
  1. 配置本地 Git (如果首次使用):

打开你的终端或 Git Bash，设置你的用户名和邮箱：

git config --global user.name "Your Name"
git config --global user.email "youremail@example.com"
  1. 克隆仓库: 在 Gitlab 项目页面，复制项目的 HTTP 克隆地址 (例如 http://localhost/root/my-first-app.git)。
# 切换到你存放代码的目录
cd ~/projects
git clone http://localhost/root/my-first-app.git
cd my-first-app

(如果使用 SSH 方式，需要先在 Gitlab 中添加你的 SSH 公钥，并使用 SSH 克隆地址)

  1. 添加、提交和推送文件:
# 创建一个 README 文件
echo "# My First App" > README.md

# 添加到 Git 暂存区
git add README.md

# 提交到本地仓库
git commit -m "Add README"

# 推送到 Gitlab 远程仓库 (main 分支)
git push -u origin main

刷新 Gitlab 项目页面，你应该能看到 README.md 文件了。

配置 GitLab Runner

GitLab Runner 是 GitLab CI/CD 的执行器，负责运行您在 .gitlab-ci.yml 文件中定义的作业。以下是配置流程：

  1. 获取注册令牌
  • 登录 GitLab 管理员账户
  • 进入 管理中心（Admin Area）
  • 导航至 概览 > Runners
  • 注意页面上的注册令牌（Registration token）
  1. 注册 GitLab Runner
docker exec gitlab-runner gitlab-runner register --non-interactive --url http://gitlab --registration-token glrt-dDoxCnU6McMs5JC3ls3imeq8Qq_HmR4Q.0w1pkjfn4 --executor docker --description "docker-runner" --docker-image python:3 --docker-volumes "/cache:/cache" --docker-volumes "/var/run/docker.sock:/var/run/docker.sock" --docker-pull-policy "always" --docker-shm-size 0

Gitlab 常用维护命令 (在容器内执行)

以下命令需要在 Gitlab 容器内部通过 docker compose exec gitlab 执行：

# 启动所有 gitlab 组件 (通常不需要手动执行，由 docker compose 管理)
sudo docker compose exec gitlab gitlab-ctl start

# 停止所有 gitlab 组件
sudo docker compose exec gitlab gitlab-ctl stop

# 重启所有 gitlab 组件
sudo docker compose exec gitlab gitlab-ctl restart

# 查看服务状态
sudo docker compose exec gitlab gitlab-ctl status

# 使配置文件 (/etc/gitlab/gitlab.rb, 但我们通过环境变量配置) 生效
sudo docker compose exec gitlab gitlab-ctl reconfigure

# 运行健康检查
sudo docker compose exec gitlab gitlab-rake gitlab:check SANITIZE=true --trace

# 查看日志
sudo docker compose logs -f gitlab

# 或者查看特定服务的日志
sudo docker compose exec gitlab gitlab-ctl tail nginx

现在，你已经成功部署了一个基本的 Gitlab 代码仓库，并了解了如何进行基本操作。你可以开始创建项目，管理你的代码和 Dockerfile 了！对于更高级的配置（如 HTTPS, LDAP, CI/CD Runner），请参考 Gitlab 官方文档。

gitlab部署
tian的博客
05-29 639
gitlab部署
Gitlab部署
Sojou的博客
07-28 394
小白部署gitlab服务并推送秘钥创建项目。
Gitlab代码审查集成工具：ivotical-codereview-gitlab
1. GitLab 是一个开源的代码托管平台，提供基于 Git 的代码仓库管理功能，具有代码审查、问题跟踪、持续集成和部署等功能。GitLab 允许开发者和团队协作，进行项目管理，以及通过集成测试、部署和持续集成工具来优化...
二维下料matlab代码-TransEnPackage-Gitlab:TransEnPackage-Gitlab
05-26
通过TransEnPackage-Gitlab仓库，开发者可以追踪代码的历史版本，协同工作，并管理代码分支。 8. **持续集成/持续部署（CI/CD）**：开源项目可能包含了CI/CD流程，自动测试代码质量并部署更新，确保软件的稳定性和...
charm-gitlab-runner:部署gitlab-runner的Juju Charm（hooks，bash）
03-31
2. **添加charm源**：将charm仓库添加为Juju的源，以便能够获取到charm-gitlab-runner。 3. **部署GitLab Runner Charm**：通过Juju命令行客户端部署charm，指定GitLab服务器的URL和其他配置选项。 4. **配置Runner*...
lumen-aws-gitlab-continuous-deployment：使用GitLab和AWS Elastic Beanstalk的Lumen Laravel应用程序的连续部署管道
01-30
7. **提交并触发CI/CD**：提交代码到GitLab仓库，触发`.gitlab-ci.yml`文件中的定义的流程。 通过这个项目，你可以学习如何将Lumen应用与现代DevOps工具链结合，实现高效的持续集成和持续交付，这对于现代Web开发来...
DevOps自动化部署-Ansible-Jenkins-Docker-Maven-Nexus-Gitlab-Sonarqube-Zookeeper-MySQL-Redis-Kafk.zip
最新发布
05-23
Gitlab是Git仓库管理系统，提供代码仓库、持续集成和部署等功能。Sonarqube是静态代码分析平台，帮助提升代码质量。Zookeeper是分布式应用程序协调服务，而MySQL和Redis则是常用的数据存储解决方案，前者是关系型...
GItLab 部署
weixin_33912246的博客
08-21 1774
一、git、github、gitlab的区别 Git是版本控制系统，Github是在线的基于Git的代码托管服务。GitHub是2008年由Ruby on Rails编写而成。GitHub同时提供付费账户和免费账户。这两种账户都可以创建公开的代码仓库，只有付费账户可以创建私有的代码仓库。Gitlab解决了这个问题, 可以在上面创建免费的私人repo。 二、gitlab server搭建过程 [ro...
Git，GitHub与GitLab的区别
热门推荐
ThinkWon的博客
09-26 1万+
Git Git(读音为/gɪt/。)是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理。Git 是 [Linus Torvalds](https://baike.baidu.com/item/Linus Torvalds/9336769) 为了帮助管理 Linux 内核开发而开发的一个开放源码的版本控制软件。 Torvalds 开始着手开发 Git 是为了作为一种过...
gitlab 部署
07-20 5153
到这个页面需要用初始管理员账号登陆，用户名root密码在/etc/gitlab/initial_root_password这个文件超过24小时会自动删除。这里我将GitLab站点Url修改为"external_url"​​​​​​​http//192.168.142.1309000"本次我们部署的是社区版gitlab-ce，如果要部署商业版可以把关键字替换为gitlab-ee。GitLab默认的配置文件路径是/etc/gitlab/gitlab.rb。#启动ssh服务&设置为开机启动。...........
Git lab部署
番茄炒蛋君的博客
11-28 959
目录： Git lab介绍 Git lab安装 修改Git lab登录界面 Git lab创建项目 Git lab介绍 Git lab是代码VCS的一个开源项目， 使用git作为代码管理工具，并在此基础上搭建起来的web服务，可通过web界面来访问公开的或者私人项目，它拥有与github类似的功能，能够浏览源代码，并且管理团队对于仓库的访问。它非常易于浏览提交过的版本并提供一个文件历史库...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

企鹅侠客

您的打赏是我创作旅程中的关键燃

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值