Skip to content

AutoCorrect fix for translations/zh-CN/content/actions #20846

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -27,27 +27,27 @@ ms.locfileid: '147880659'

## 关于持续集成

持续集成 (CI) 是一种需要频繁提交代码到共享仓库的软件实践。 频繁提交代码能较早检测到错误,减少在查找错误来源时开发者需要调试的代码量。 频繁的代码更新也更便于从软件开发团队的不同成员合并更改。 这对开发者非常有益,他们可以将更多时间用于编写代码,而减少在调试错误或解决合并冲突上所花的时间。
持续集成 (CI) 是一种需要频繁提交代码到共享仓库的软件实践。频繁提交代码能较早检测到错误,减少在查找错误来源时开发者需要调试的代码量。频繁的代码更新也更便于从软件开发团队的不同成员合并更改。这对开发者非常有益,他们可以将更多时间用于编写代码,而减少在调试错误或解决合并冲突上所花的时间。

提交代码到仓库时,可以持续创建并测试代码,以确保提交未引入错误。 您的测试可以包括代码语法检查(检查样式格式)、安全性检查、代码覆盖率、功能测试及其他自定义检查。
提交代码到仓库时,可以持续创建并测试代码,以确保提交未引入错误。您的测试可以包括代码语法检查(检查样式格式)、安全性检查、代码覆盖率、功能测试及其他自定义检查。

创建和测试代码需要服务器。 您可以在推送代码到仓库之前在本地创建并测试更新,也可以使用 CI 服务器检查仓库中的新代码提交。
创建和测试代码需要服务器。您可以在推送代码到仓库之前在本地创建并测试更新,也可以使用 CI 服务器检查仓库中的新代码提交。

## 关于使用 {% data variables.product.prodname_actions %} 的持续集成

{% ifversion ghae %}使用 {% data variables.product.prodname_actions %} 的 CI 提供可以在存储库中生成代码并运行测试的工作流。 工作流程可以在您托管的运行器系统上运行。 有关详细信息,请参阅[关于自承载运行器](/actions/hosting-your-own-runners/about-self-hosted-runners)。
{% else %}使用 {% data variables.product.prodname_actions %} 的 CI 提供可以在仓库中构建代码并运行测试的工作流程。 工作流程可在 {% data variables.product.prodname_dotcom %} 托管的虚拟机或您自行托管的机器上运行。 有关详细信息,请参阅“[关于 {% data variables.product.prodname_dotcom %} 托管的运行器](/actions/using-github-hosted-runners/about-github-hosted-runners)”和“[关于自托管运行器](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)”。
{% ifversion ghae %}使用 {% data variables.product.prodname_actions %} 的 CI 提供可以在存储库中生成代码并运行测试的工作流。工作流程可以在您托管的运行器系统上运行。有关详细信息,请参阅[关于自承载运行器](/actions/hosting-your-own-runners/about-self-hosted-runners)。
{% else %}使用 {% data variables.product.prodname_actions %} 的 CI 提供可以在仓库中构建代码并运行测试的工作流程。工作流程可在 {% data variables.product.prodname_dotcom %} 托管的虚拟机或您自行托管的机器上运行。有关详细信息,请参阅“[关于 {% data variables.product.prodname_dotcom %} 托管的运行器](/actions/using-github-hosted-runners/about-github-hosted-runners)”和“[关于自托管运行器](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)”。
{% endif %}

可以配置 CI 工作流,使其在 {% data variables.product.prodname_dotcom %} 事件发生时(例如,当新代码推送到存储库时)运行、按设定的时间表运行,或在使用存储库分发 Webhook 的外部事件发生时运行。

{% data variables.product.product_name %} 运行 CI 测试并在拉取请求中提供每次测试的结果,因此您可以查看分支中的更改是否引入错误。 如果工作流程中的所有 CI 测试通过,您推送的更改可供团队成员审查或合并 如果测试失败,则是其中某项更改导致了失败。
{% data variables.product.product_name %} 运行 CI 测试并在拉取请求中提供每次测试的结果,因此您可以查看分支中的更改是否引入错误。如果工作流程中的所有 CI 测试通过,您推送的更改可供团队成员审查或合并 如果测试失败,则是其中某项更改导致了失败。

如果在仓库中设置了 CI,{% data variables.product.product_name %} 会分析仓库中的代码,并根据仓库中的语言和框架推荐 CI 工作流程。 例如,如果使用 [Node.js](https://nodejs.org/en/),{% data variables.product.product_name %} 将建议使用入门工作流来安装 Node.js 包并运行测试。 您可以使用 {% data variables.product.product_name %} 建议的 CI 入门工作流程,自定义建议的入门工作流程,或创建自己的自定义工作流程文件来运行 CI 测试。
如果在仓库中设置了 CI,{% data variables.product.product_name %} 会分析仓库中的代码,并根据仓库中的语言和框架推荐 CI 工作流程。例如,如果使用 [Node.js](https://nodejs.org/en/),{% data variables.product.product_name %} 将建议使用入门工作流来安装 Node.js 包并运行测试。您可以使用 {% data variables.product.product_name %} 建议的 CI 入门工作流程,自定义建议的入门工作流程,或创建自己的自定义工作流程文件来运行 CI 测试。

![建议的持续集成入门工作流程屏幕截图](/assets/images/help/repository/ci-with-actions-template-picker.png)

除了帮助设置项目的 CI 工作流程之外,您还可以使用 {% data variables.product.prodname_actions %} 创建跨整个软件开发生命周期的工作流程。 例如,您可以使用操作来部署、封装或发行项目。 有关详细信息,请参阅“[关于 {% data variables.product.prodname_actions %}](/articles/about-github-actions)”。
除了帮助设置项目的 CI 工作流程之外,您还可以使用 {% data variables.product.prodname_actions %} 创建跨整个软件开发生命周期的工作流程。例如,您可以使用操作来部署、封装或发行项目。有关详细信息,请参阅“[关于 {% data variables.product.prodname_actions %}](/articles/about-github-actions)”。

有关常用术语的定义,请参阅“[{% data variables.product.prodname_actions %} 的核心概念](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)”。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,18 +23,18 @@ ms.locfileid: '147079572'

本指南介绍如何构建、测试和发布 Go 包。

{% ifversion ghae %} {% data reusables.actions.self-hosted-runners-software %} {% else %} {% data variables.product.prodname_dotcom %} 托管的运行器有一个带有预装软件的工具缓存,其中包括 Go 的依赖项。 有关最新软件和 Go 预安装版本的完整列表,请参阅“[关于 {% data variables.product.prodname_dotcom %} 托管的运行器](/actions/using-github-hosted-runners/about-github-hosted-runners#preinstalled-software)”。
{% ifversion ghae %} {% data reusables.actions.self-hosted-runners-software %} {% else %} {% data variables.product.prodname_dotcom %} 托管的运行器有一个带有预装软件的工具缓存,其中包括 Go 的依赖项。有关最新软件和 Go 预安装版本的完整列表,请参阅“[关于 {% data variables.product.prodname_dotcom %} 托管的运行器](/actions/using-github-hosted-runners/about-github-hosted-runners#preinstalled-software)”。
{% endif %}

## 先决条件

您应该已经熟悉 YAML 语法及其如何与 {% data variables.product.prodname_actions %} 结合使用。 有关详细信息,请参阅“[{% data variables.product.prodname_actions %} 的工作流语法](/actions/using-workflows/workflow-syntax-for-github-actions)”。
您应该已经熟悉 YAML 语法及其如何与 {% data variables.product.prodname_actions %} 结合使用。有关详细信息,请参阅“[{% data variables.product.prodname_actions %} 的工作流语法](/actions/using-workflows/workflow-syntax-for-github-actions)”。

建议你对 Go 语言有基本的了解。 有关详细信息,请参阅 [Go 入门](https://golang.org/doc/tutorial/getting-started)。
建议你对 Go 语言有基本的了解。有关详细信息,请参阅 [Go 入门](https://golang.org/doc/tutorial/getting-started)。

## 使用 Go 入门工作流程

{% data variables.product.prodname_dotcom %} 提供了一个适用于大多数 Go 项目的 Go 入门工作流程。 本指南包含可用于自定义入门工作流程的示例。 有关详细信息,请参阅 [Go 入门工作流](https://github.com/actions/starter-workflows/blob/main/ci/go.yml)。
{% data variables.product.prodname_dotcom %} 提供了一个适用于大多数 Go 项目的 Go 入门工作流程。本指南包含可用于自定义入门工作流程的示例。有关详细信息,请参阅 [Go 入门工作流](https://github.com/actions/starter-workflows/blob/main/ci/go.yml)。

若要快速开始,请将起始工作流添加到存储库的 `.github/workflows` 目录。

Expand Down Expand Up @@ -64,11 +64,11 @@ jobs:

## 指定 Go 版本

指定 Go 版本的最简单方法是使用由 {% data variables.product.prodname_dotcom %} 提供的 `setup-go` 操作。 有关详细信息,请参阅 [`setup-go` 操作](https://github.com/actions/setup-go/)。
指定 Go 版本的最简单方法是使用由 {% data variables.product.prodname_dotcom %} 提供的 `setup-go` 操作。有关详细信息,请参阅 [`setup-go` 操作](https://github.com/actions/setup-go/)。

若要在 {% data variables.product.prodname_dotcom %} 托管的运行器上使用 Go 的预安装版本,请将相关版本传递给 `setup-go` 操作的 `go-version` 属性。 此操作从每个运行器上的工具缓存中查找特定版本的 Go,并将必要的二进制文件添加到 `PATH`。 这些更改将持续用于作业的其余部分。
若要在 {% data variables.product.prodname_dotcom %} 托管的运行器上使用 Go 的预安装版本,请将相关版本传递给 `setup-go` 操作的 `go-version` 属性。此操作从每个运行器上的工具缓存中查找特定版本的 Go,并将必要的二进制文件添加到 `PATH`。这些更改将持续用于作业的其余部分。

`setup-go` 操作是 Go与 {% data variables.product.prodname_actions %} 结合使用时的推荐方式,因为它帮助确保不同运行器和不同版本的 Go 行为一致。 如果使用自托管运行器,则必须安装 Go 并将其添加到 `PATH`。
`setup-go` 操作是 Go 与 {% data variables.product.prodname_actions %} 结合使用时的推荐方式,因为它帮助确保不同运行器和不同版本的 Go 行为一致。如果使用自托管运行器,则必须安装 Go 并将其添加到 `PATH`。

### 使用多个版本的 Go

Expand Down Expand Up @@ -98,7 +98,7 @@ jobs:

### 使用特定的 Go 版本

可以将作业配置为使用 Go 的特定版本,例如 `1.16.2`。 或者,您也可以使用语义版本语法来获得最新的次要版本。 此示例使用 Go 1.16 最新的修补程序版本:
可以将作业配置为使用 Go 的特定版本,例如 `1.16.2`。或者,您也可以使用语义版本语法来获得最新的次要版本。此示例使用 Go 1.16 最新的修补程序版本:

```yaml{:copy}
- name: Setup Go 1.16.x
Expand Down Expand Up @@ -130,7 +130,7 @@ jobs:

### 缓存依赖项

可以使用 [`setup-go` 操作](https://github.com/actions/setup-go)缓存和还原依赖项。 默认情况下,缓存处于禁用状态,但可以通过将参数 `cache` 设置为 `true` 来启用它。
可以使用 [`setup-go` 操作](https://github.com/actions/setup-go)缓存和还原依赖项。默认情况下,缓存处于禁用状态,但可以通过将参数 `cache` 设置为 `true` 来启用它。

启用缓存后,`setup-go` 操作将在存储库根目录中搜索依赖项文件 `go.sum`,并使用依赖项文件的哈希作为缓存密钥的一部分。

Expand All @@ -152,13 +152,13 @@ jobs:
cache-dependency-path: subdir/go.sum
```

如果有自定义要求或需要更精细的缓存控制,可以使用 [`cache` 操作](https://github.com/marketplace/actions/cache)。 有关详细信息,请参阅“[缓存依赖项以加快工作流](/actions/using-workflows/caching-dependencies-to-speed-up-workflows)”。
如果有自定义要求或需要更精细的缓存控制,可以使用 [`cache` 操作](https://github.com/marketplace/actions/cache)。有关详细信息,请参阅“[缓存依赖项以加快工作流](/actions/using-workflows/caching-dependencies-to-speed-up-workflows)”。

{% endif %}

## 构建和测试代码

您可以使用与本地相同的命令来构建和测试代码。 此示例工作流演示如何在作业中使用 `go build` 和 `go test`:
您可以使用与本地相同的命令来构建和测试代码。此示例工作流演示如何在作业中使用 `go build` 和 `go test`:

```yaml{:copy}
name: Go
Expand All @@ -184,7 +184,7 @@ jobs:

## 将工作流数据打包为构件

工作流程完成后,您可以上传产生的项目进行分析。 例如,您可能需要保存日志文件、核心转储、测试结果或屏幕截图。 以下示例演示如何使用 `upload-artifact` 操作上传测试结果。
工作流程完成后,您可以上传产生的项目进行分析。例如,您可能需要保存日志文件、核心转储、测试结果或屏幕截图。以下示例演示如何使用 `upload-artifact` 操作上传测试结果。

有关详细信息,请参阅“[将工作流数据存储为构件](/actions/using-workflows/storing-workflow-data-as-artifacts)”。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,26 +26,26 @@ ms.locfileid: '145084729'

## 简介

本指南介绍如何使用 Ant 构建系统为 Java 项目创建执行持续集成 (CI) 的工作流程。 您创建的工作流程将允许您查看拉取请求提交何时会在默认分支上导致构建或测试失败; 这个方法可帮助确保您的代码始终是健康的。 您可以扩展 CI 工作流程以从工作流程运行上传构件。
本指南介绍如何使用 Ant 构建系统为 Java 项目创建执行持续集成 (CI) 的工作流程。您创建的工作流程将允许您查看拉取请求提交何时会在默认分支上导致构建或测试失败;这个方法可帮助确保您的代码始终是健康的。您可以扩展 CI 工作流程以从工作流程运行上传构件。

{% ifversion ghae %} {% data reusables.actions.self-hosted-runners-software %} {% else %} {% data variables.product.prodname_dotcom %} 托管的运行器有一个带有预安装软件的工具缓存,其中包括 Java 开发工具包 (JDK) 和 Ant。 有关 JDK 和 Ant 的软件和预安装版本的列表,请参阅“[{% data variables.product.prodname_dotcom %} 托管的运行器规范](/actions/reference/specifications-for-github-hosted-runners/#supported-software)”。
{% ifversion ghae %} {% data reusables.actions.self-hosted-runners-software %} {% else %} {% data variables.product.prodname_dotcom %} 托管的运行器有一个带有预安装软件的工具缓存,其中包括 Java 开发工具包 (JDK) 和 Ant。有关 JDK 和 Ant 的软件和预安装版本的列表,请参阅“[{% data variables.product.prodname_dotcom %} 托管的运行器规范](/actions/reference/specifications-for-github-hosted-runners/#supported-software)”。
{% endif %}

## 先决条件

您应该熟悉 YAML 和 {% data variables.product.prodname_actions %} 的语法。 有关详细信息,请参阅:
您应该熟悉 YAML 和 {% data variables.product.prodname_actions %} 的语法。有关详细信息,请参阅:
- “[{% data variables.product.prodname_actions %} 工作流语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)”
- “[了解 {% data variables.product.prodname_actions %}](/actions/learn-github-actions)”

建议您对 Java 和 Ant 框架有个基本的了解。 有关详细信息,请参阅 [Apache Ant 手册](https://ant.apache.org/manual/)。
建议您对 Java 和 Ant 框架有个基本的了解。有关详细信息,请参阅 [Apache Ant 手册](https://ant.apache.org/manual/)。

{% data reusables.actions.enterprise-setup-prereq %}

## 使用 Ant 入门工作流程

{% data variables.product.prodname_dotcom %} 提供有 Ant 入门工作流程,适用于大多数基于 Ant 的 Java 项目。 有关详细信息,请参阅 [Ant 入门工作流](https://github.com/actions/starter-workflows/blob/main/ci/ant.yml)。
{% data variables.product.prodname_dotcom %} 提供有 Ant 入门工作流程,适用于大多数基于 Ant 的 Java 项目。有关详细信息,请参阅 [Ant 入门工作流](https://github.com/actions/starter-workflows/blob/main/ci/ant.yml)。

要快速开始,您可以在创建新工作流程时选择预配置的 Ant 入门工作流程。 有关详细信息,请参阅“[{% data variables.product.prodname_actions %} 快速入门](/actions/quickstart)”。
要快速开始,您可以在创建新工作流程时选择预配置的 Ant 入门工作流程。有关详细信息,请参阅“[{% data variables.product.prodname_actions %} 快速入门](/actions/quickstart)”。

也可以通过在存储库的 `.github/workflows` 目录中创建新文件来手动添加此工作流。

Expand Down Expand Up @@ -85,9 +85,9 @@ jobs:

您可以使用与本地相同的命令来构建和测试代码。

入门工作流将运行“build.xml”文件中指定的默认目标。 默认目标通常设置为将类、运行测试和包类设置为其可分发格式,例如 JAR 文件。
入门工作流将运行“build.xml”文件中指定的默认目标。默认目标通常设置为将类、运行测试和包类设置为其可分发格式,例如 JAR 文件。

如果使用不同的命令来构建项目,或者想要运行不同的目标,则可以指定这些命令。 例如,你可能想要运行在 `_build-ci.xml_` 文件中配置的 `jar` 目标。
如果使用不同的命令来构建项目,或者想要运行不同的目标,则可以指定这些命令。例如,你可能想要运行在 `_build-ci.xml_` 文件中配置的 `jar` 目标。

```yaml{:copy}
steps:
Expand All @@ -102,9 +102,9 @@ steps:

## 将工作流数据打包为构件

构建成功且测试通过后,您可能想要上传生成的 Java 包作为构件。 这会将构建的包存储为工作流程运行的一部分,并允许您下载它们。 构件可帮助您在拉取请求合并之前在本地环境中测试并调试它们。 有关详细信息,请参阅“[使用项目保留工作流数据](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。
构建成功且测试通过后,您可能想要上传生成的 Java 包作为构件。这会将构建的包存储为工作流程运行的一部分,并允许您下载它们。构件可帮助您在拉取请求合并之前在本地环境中测试并调试它们。有关详细信息,请参阅“[使用项目保留工作流数据](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。

Ant 通常会在 `build/jar` 目录中创建 JAR、EAR 或 WAR 等输出文件。 可以使用 `upload-artifact` 操作上传该目录的内容。
Ant 通常会在 `build/jar` 目录中创建 JAR、EAR 或 WAR 等输出文件。可以使用 `upload-artifact` 操作上传该目录的内容。

```yaml{:copy}
steps:
Expand Down
Loading