部署 GitLab

1. 选择或创建一个 Docker Compose 文件：你可以使用 Docker Compose 来定义和运行 GitLab 的容器。以下是一个示例的 docker-compose.yml 文件，用于部署 GitLab：

version: '3'
services:
  gitlab:
    image: 'gitlab/gitlab-ce:latest'
    container_name: gitlab
    hostname: 'gitlab.example.com' # 设置主机名
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url '<http://gitlab.example.com>' # 设置主机名
        gitlab_rails['initial_root_password'] = "your-password-here"
        gitlab_rails['initial_root_email'] = "[email protected]"
    ports:
      - '80:80'
      - '443:443'
      - '22:22'
    volumes:
      - './gitlab/config:/etc/gitlab'
      - './gitlab/logs:/var/log/gitlab'
      - './gitlab/data:/var/opt/gitlab'

在这个示例中，hostname 和 external_url 用于设置 GitLab 的主机名。你应该将其替换为你自己的域名。一定要设置，不然GitLab上的某些功能页面的URL会指向gitlab.example.com/xxx。

2. 配置 DNS：你需要确保你的域名解析到运行 GitLab 容器的服务器的 IP 地址。这通常涉及在你的 DNS 提供商的控制面板中创建一个 A 记录。

3. 启动容器：在包含 docker-compose.yml 文件的目录中运行以下命令来启动 GitLab 容器：

docker-compose up -d

4. 配置反向代理（可选）：如果你想在 HTTPS 上提供 GitLab，并且/或者在同一台服务器上运行其他 web 服务，你可能还需要配置一个反向代理，例如 Nginx 或 Apache。这将允许你为 GitLab 设置 SSL 证书，并将流量路由到正确的容器。

5. 配置防火墙（可选）：确保你的服务器防火墙允许通过 HTTP（端口 80）、HTTPS（端口 443）和 SSH（端口 22，如果你想通过 SSH 使用 Git）的流量。

GitLab CI/CD

.gitlab-ci.yml 详解

stages:
  - build
  - deploy

variables:
  IMAGE_NAME: my-django-app
  IMAGE_TAG: latest

build:
  stage: build
  script:
    - docker build -t $IMAGE_NAME:$IMAGE_TAG .
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - docker tag $IMAGE_NAME:$IMAGE_TAG $CI_REGISTRY_IMAGE:$IMAGE_TAG
    - docker push $CI_REGISTRY_IMAGE:$IMAGE_TAG

deploy:
  stage: deploy
  script:
    - ssh $DEPLOY_SERVER_USER@$DEPLOY_SERVER "docker pull $CI_REGISTRY_IMAGE:$IMAGE_TAG"
    - ssh $DEPLOY_SERVER_USER@$DEPLOY_SERVER "docker-compose -f /path/to/docker-compose.yml up -d"

Stages 定义

stages:
  - build
  - deploy

• stages:：定义了流水线的阶段。流水线中的任务将按照这些阶段的顺序执行。

• build：第一个阶段，用于构建 Docker 镜像。

• deploy：第二个阶段，用于部署 Docker 镜像。

Variables 定义

variables:
  IMAGE_NAME: my-django-app
  IMAGE_TAG: latest

• variables:：这一行开始定义变量的部分。

• IMAGE_NAME: my-django-app：定义了一个名为 IMAGE_NAME 的变量，并将其值设置为 my-django-app。这个变量用于指定 Docker 镜像的名称。

• IMAGE_TAG: latest：定义了一个名为 IMAGE_TAG 的变量，并将其值设置为 latest。这个变量用于指定 Docker 镜像的标签。

Build 阶段

build:
  stage: build
  script:
    - docker build -t $IMAGE_NAME:$IMAGE_TAG .
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - docker tag $IMAGE_NAME:$IMAGE_TAG $CI_REGISTRY_IMAGE:$IMAGE_TAG
    - docker push $CI_REGISTRY_IMAGE:$IMAGE_TAG

• build:：定义了名为 "build" 的任务。

• stage: build：指定该任务属于 "build" 阶段。

• script:：定义了任务中要执行的命令。
• docker build -t $IMAGE_NAME:$IMAGE_TAG .：构建 Docker 镜像，并使用之前定义的名称和标签。
• docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY：使用 GitLab CI 提供的凭证登录 Docker 注册表。
• docker tag $IMAGE_NAME:$IMAGE_TAG $CI_REGISTRY_IMAGE:$IMAGE_TAG：标记 Docker 镜像，以便将其推送到注册表。
• docker push $CI_REGISTRY_IMAGE:$IMAGE_TAG：将标记的镜像推送到 Docker 注册表。

Deploy 阶段

deploy:
  stage: deploy
  script:
    - ssh $DEPLOY_SERVER_USER@$DEPLOY_SERVER "docker pull $CI_REGISTRY_IMAGE:$IMAGE_TAG"
    - ssh $DEPLOY_SERVER_USER@$DEPLOY_SERVER "docker-compose -f /path/to/docker-compose.yml up -d"

• deploy:：定义了名为 "deploy" 的任务。

• stage: deploy：指定该任务属于 "deploy" 阶段。

• script:：定义了任务中要执行的命令。
• ssh $DEPLOY_SERVER_USER@$DEPLOY_SERVER "docker pull $CI_REGISTRY_IMAGE:$IMAGE_TAG"：通过 SSH 连接到部署服务器，并从 Docker 注册表拉取镜像。
• ssh $DEPLOY_SERVER_USER@$DEPLOY_SERVER "docker-compose -f /path/to/docker-compose.yml up -d"：通过 SSH 连接到部署服务器，并使用 docker-compose 命令启动服务。

GitLab Runner

sudo docker pull gitlab/gitlab-runner:latest
sudo docker run -d \
  --name gitlab-runner \
  --network gitlab-network \
  --restart always \
  -v /srv/gitlab-runner/config:/etc/gitlab-runner \
  -v /var/run/docker.sock:/var/run/docker.sock \
  gitlab/gitlab-runner:latest

注册GitLab Runner时的executor应该怎么选？

1. shell：在 Runner 主机上直接运行脚本。这是最简单的执行器，但可能会导致安全和隔离问题。

2. docker：在 Docker 容器中运行作业。这提供了良好的隔离，并允许你为每个作业指定一个 Docker 镜像。如果你已经在使用 Docker，并希望每个作业都在干净的环境中运行，这可能是一个好选择。

3. kubernetes：在 Kubernetes 集群中运行作业。如果你已经使用 Kubernetes，这可能是一个强大的选项。

4. ssh：通过 SSH 在远程服务器上运行作业。这允许你在特定的远程机器上运行作业。

5. virtualbox、parallels：在 VirtualBox 或 Parallels 虚拟机中运行作业。这提供了更强的隔离，但可能更复杂和资源密集型。

6. docker+machine：使用 Docker Machine 创建和管理 Docker 主机。这允许 Runner 在需要时动态创建和销毁虚拟机。

7. custom：允许你定义自己的执行器。这是一个高级选项，需要你完全理解你的需求和环境。

8. instance、docker-autoscaler、docker-windows：这些是特定用例或环境的执行器。

全栈之初识 Gitlab-CI -- 进入持续集成的世界

本文将会对Gitlab CI进行简要介绍，包括Gitlab Runner，Gitlab CI中的相关概念以及.gitlab-ci.yml的常用配置。 一、GitLab CI 是什么？ GitLab CI 是GitLab内置的进行持续集成的工具，只需要在仓库根目录下创建.gi…

https://zhuanlan.zhihu.com/p/122313251

gitlab-runner | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror

gitlab-runner 使用帮助 | 镜像站使用帮助 | 清华大学开源软件镜像站，致力于为国内和校内用户提供高质量的开源软件镜像、Linux 镜像源服务，帮助用户更方便地获取开源软件。本镜像站由清华大学 TUNA 协会负责运行维护。

https://mirrors.tuna.tsinghua.edu.cn/help/gitlab-runner/