查看“GitLab CI/CD 流程概览”的源代码


要使用 GitLab CI/CD：

# 确保您有可用的 runner 运行您的作业。 如果您没有 runner，需要为您的示例、项目或群组安装 GitLab Runner并注册 runner。
# 在仓库的根目录下创建一个 .gitlab-ci.yml 文件。该文件是您定义 CI/CD 作业的地方。
# 当您将文件提交到仓库时，runner 会运行您的作业。 作业结果显示在流水线中。

<span id="确保您有可用的-runner"></span>
== 确保您有可用的 runner ==

在极狐GitLab 中，runners 是运行 CI/CD 作业的代理。

您可能已经有可用于您的项目的 runner，包括共享 runner，它们可用于您的实例中的所有项目。

<blockquote>要查看可用的 runner：

# 转到 设置 &gt; CI/CD 并展开 Runners。
# 只要您至少有一个有效的 runner，旁边有一个绿色圆圈，您就有一个 runner 可以处理您的作业。
</blockquote>
如果 UI 中的 Runners 页面上没有列出任何 runner，您或管理员必须安装 GitLab Runner 和注册至少一名 runner。

如果您正在测试 CI/CD，您可以在本地机器上安装 GitLab Runner 并注册 runner。 当您的 CI/CD 作业运行时，它们会在您的本地机器上运行。

<span id="创建-.gitlab-ci.yml-文件"></span>
== 创建 .gitlab-ci.yml 文件 ==

<code>.gitlab-ci.yml</code> 文件是一个 YAML 文件，您可以在其中配置 GitLab CI/CD 的特定指令。

在此文件中，您定义：

* runner 应执行的作业的结构和顺序。
* runner 在遇到特定条件时应做出的决定。

例如，您可能希望在提交到除默认分支之外的任何分支时运行一组测试。当您提交到默认分支时，您希望运行相同的套件，但还要发布您的应用程序。

所有这些都在 .gitlab-ci.yml 文件中定义。

<span id="创建一个-.gitlab-ci.yml-文件"></span>
=== 创建一个 .gitlab-ci.yml 文件 ===

<ol style="list-style-type: decimal;">
<li><p>在左侧边栏上，选择 项目信息 &gt; 详细信息。</p></li>
<li><p>在文件列表上方，选择要提交的分支，点击加号图标，然后选择 新建文件：</p></li>
<li><p>对于文件名称，输入 <code>.gitlab-ci.yml</code> 并在较大的窗口中粘贴以下示例代码：</p>
<pre> build-job:
 stage: build
 script:
     - echo &quot;Hello, $GITLAB_USER_LOGIN!&quot;

 test-job1:
 stage: test
 script:
     - echo &quot;This job tests something&quot;

 test-job2:
 stage: test
 script:
     - echo &quot;This job tests something, but takes more time than test-job1.&quot;
     - echo &quot;After the echo commands complete, it runs the sleep command for 20 seconds&quot;
     - echo &quot;which simulates a test that runs 20 seconds longer than test-job1&quot;
     - sleep 20

 deploy-prod:
 stage: deploy
 script:
     - echo &quot;This job deploys something from the $CI_COMMIT_BRANCH branch.&quot;
 environment: production</pre>
<p>$GITLAB_USER_LOGIN 和 $CI_COMMIT_BRANCH 是在作业运行时填充的预定义变量。</p></li>
<li><p>点击提交变更。</p></li>
<li><p>提交后，流水线开始。</p></li></ol>

<blockquote>.gitlab-ci.yml tips 创建第一个 .gitlab-ci.yml 文件后，使用流水线编辑器 对文件进行所有未来的编辑。使用流水线编辑器，您可以： - 使用自动语法突出显示和验证来编辑流水线配置。 - 查看 CI/CD 配置可视化，是您的 .gitlab-ci.yml 文件的图形化表示。
</blockquote>
如果您希望 runner 使用 Docker 容器运行作业，请编辑 .gitlab-ci.yml 文件以包含镜像名称：

<pre>default:
  image: ruby:2.7.5</pre>
此命令告诉 runner 使用来自 Docker Hub 的 Ruby 镜像并在从该镜像生成的容器中运行作业。

此过程不同于将应用程序构建为 Docker 容器。您的应用程序无需构建为 Docker 容器即可在 Docker 容器中运行 CI/CD 作业。

=== 每个作业包含的脚本和阶段 ===

* default 关键字用于自定义默认值，例如 before_script 和 after_script。
* stage 描述了作业的顺序执行。 只要有可用的 runner，单个阶段中的作业就会并行运行。
* 使用 Directed Acyclic Graphs (DAG) 关键字以乱序运行作业。


您可以设置其他配置来自定义您的作业和阶段的执行方式： 
* 使用 rules 关键字指定何时运行或跳过作业。 only 和 except 旧关键字仍受支持，但不能在同一作业中与 rules 一起使用。 
* 使用 cache 和 artifacts 在流水线中保持跨作业和阶段的信息持久化。这些关键字是存储依赖项和作业输出的方法，即使在为每个作业使用临时 runner 时也是如此。

== 查看流水线和作业的状态 ==

当您提交更改时，流水线启动。

要查看您的流水线：

* 转到 CI/CD &gt; 流水线。
* 应显示具有三个阶段的流水线。
* 要查看流水线的可视化表示，请单击流水线 ID。
* 要查看作业的详细信息，请单击作业名称，例如 deploy-prod。
* 如果作业状态为 stuck，请检查以确保为项目正确配置了 runner。