注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。
简介
您只需要 GitHub 仓库来创建和运行 GitHub Actions 工作流程。 在本指南中,您将添� 一个工作流程,演示 GitHub Actions 的一些基本功能。
下面的示例显示 GitHub Actions 作业如何自动触发、在哪里运行及其如何与仓库中的代� �交互。
创建第一个工作流程
-
如果
.github/workflows
目录不存在,请在 GitHub 的仓库中创建此目录。 -
在
.github/workflow
目录中,创建一个名为github-actions-demo.yml
的文件。 更多信息请参阅“创建新文件”。 -
将以下 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 }}."
-
滚动到页面底部,然后选择 Create a new branch for this commit and start a pull request(为此提交创建一个新分支并开始拉取请求)。 然后,若要创建拉取请求,请单击 Propose new file(提议新文件)。
向仓库的分支提交工作流程文件会触发 push
事件并运行工作流程。
查看工作流程结果
-
在 your GitHub Enterprise Server instance 上,导航到仓库的主页面。
-
Under your repository name, click Actions.
-
在左侧边� �中,单击您想要查看的工作流程。
-
从工作流程运行列表中,单击要查看的运行的名称。
-
在 Jobs(作业)下,单击 Explore-GitHub-Actions 作业。
-
日志显示每个步骤的处理方式。 展开任何步骤以查看其细节。
例如,您可以在仓库中看到文件列表:
更多入门工作流程
GitHub provides preconfigured starter workflow that you can customize to create your own continuous integration workflow. GitHub Enterprise Server analyzes your code and shows you CI starter workflow that might be useful for your repository. 例如,如果仓库包含 Node.js 代� �,您就会看到 Node.js 项目的建议。 You can use starter workflow as a starting place to build your custom workflow or use them as-is.
You can browse the full list of starter workflow in the actions/starter-workflows
repository on your GitHub Enterprise Server instance.
后续步骤
每次将代� �推送到分支时,您刚刚添� 的示例工作流程都会运行,并显示 GitHub Actions 如何处理仓库的内容。 但是,这只是您可以对 GitHub Actions 执行操作的开始:
- 您的仓库可以包含多个基于不同事件触发不同任务的工作流程。
- 您可以使用工作流程安装软件测试应用程序,并让它们自动在 GitHub 的运行器上测试您的代� �。
GitHub Actions 可以帮助您自动执行应用程序开发过程的� 乎每个方面。 准备好开始了吗? 以下是一些帮助您对 GitHub Actions 执行后续操作的有用资源:
- “了解 GitHub Actions”,以获取深入教程