GitHub Actions 快速入门

简介

您只需要 GitHub 仓库来创建和运行 GitHub Actions 工作流程。 在本指南中，您将添加一个工作流程，演示 GitHub Actions 的一些基本功能。

下面的示例显示 GitHub Actions 作业如何自动触发、在哪里运行及其如何与仓库中的代码交互。

创建第一个工作流程

1. Create a .github/workflows directory in your repository on GitHub if this directory does not already exist.

2. In the .github/workflows directory, create a file named github-actions-demo.yml. 更多信息请参阅“创建新文件”。

3. 将以下 YAML 内容复制到 github-actions-demo.yml 文件中：

   YAML

   name: GitHub Actions Demo
   on: [push]
   jobs:
     Explore-GitHub-Actions:
       runs-on: ubuntu-latest
       steps:
         - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
         - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!"
         - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
         - name: Check out repository code
           uses: actions/checkout@v2
         - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner."
         - run: echo "🖥️ The workflow is now ready to test your code on the runner."
         - name: List files in the repository
           run: |
             ls ${{ github.workspace }}
         - run: echo "🍏 This job's status is ${{ job.status }}."
   

4. 滚动到页面底部，然后选择 Create a new branch for this commit and start a pull request（为此提交创建一个新分支并开始拉取请求）。 然后，若要创建拉取请求，请单击 Propose new file（提议新文件）。

向仓库的分支提交工作流程文件会触发 push 事件并运行工作流程。

查看工作流程结果

1. 在 GitHub 上，导航到仓库的主页面。

2. 在仓库名称下，单击 Actions（操作）。

3. 在左侧边栏中，单击您想要查看的工作流程。

   

4. 从工作流程运行列表中，单击要查看的运行的名称。

   

5. 在 Jobs（作业）下，单击 Explore-GitHub-Actions 作业。

   

6. 日志显示每个步骤的处理方式。 展开任何步骤以查看其细节。

   

   例如，您可以在仓库中看到文件列表：

更多工作流程模板

GitHub 提供预配置的工作流程模板，您可以自定义以创建自己的持续集成工作流程。 GitHub 分析代码并显示可能适用于您的仓库的 CI 模板。 例如，如果仓库包含 Node.js 代码，您就会看到 Node.js 项目的建议。 您可以使用工作流程模板作为基础来构建自定义工作流程，或按原样使用模板。

您可以在 actions/starter-workflows 仓库中浏览工作流程模板的完整列表。

后续步骤

每次将代码推送到分支时，您刚刚添加的示例工作流程都会运行，并显示 GitHub Actions 如何处理仓库的内容。 但是，这只是您可以对 GitHub Actions 执行操作的开始：

• 您的仓库可以包含多个基于不同事件触发不同任务的工作流程。
• 您可以使用工作流程安装软件测试应用程序，并让它们自动在 GitHub 的运行器上测试您的代码。

GitHub Actions 可以帮助您自动执行应用程序开发过程的几乎每个方面。 准备好开始了吗？ 以下是一些帮助您对 GitHub Actions 执行后续操作的有用资源：

• “了解 GitHub Actions”，以获取深入教程