Skip to content
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
2 changes: 1 addition & 1 deletion translations/zh-CN/content/packages/index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: GitHub 包文档
shortTitle: GitHub Packages
intro: '了解如何安全地发布和使用包,将包与代码存储在一起,以及与您的团队私下分享或与开源社区公开分享您的包。 还可以使用 {% data variables.product.prodname_actions %} 自动执行您的包。'
intro: '了解如何安全地发布和使用包,将包与代码存储在一起,以及与您的团队私下分享或与开源社区公开分享您的包。还可以使用 {% data variables.product.prodname_actions %} 自动执行您的包。'
introLinks:
quickstart: /packages/quickstart
reference: /packages/manage-packages
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ ms.locfileid: '147882333'
```
有关详细信息,请参阅 Docker 官方文档中的“[标签](https://docs.docker.com/engine/reference/builder/#label)”和 `opencontainers/image-spec` 存储库中的“[预定义的注释键](https://github.com/opencontainers/image-spec/blob/master/annotations.md#pre-defined-annotation-keys)”。

2. 构建容器映像。 此示例从当前目录中的 Dockerfile 生成映像,并分配映像名称 `hello_docker`。
2. 构建容器映像。此示例从当前目录中的 Dockerfile 生成映像,并分配映像名称 `hello_docker`。

```shell
$ docker build -t hello_docker .
Expand All @@ -70,7 +70,7 @@ ms.locfileid: '147882333'
$ docker tag 38f737a91f39 {% data reusables.package_registry.container-registry-example-hostname %}/monalisa/hello_docker:latest
```

5. 如果尚未向 {% data variables.product.prodname_container_registry %} 验证,请验证。 有关详细信息,请参阅“[对 {% data variables.product.prodname_container_registry %} 进行身份验证](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-the-container-registry)”。
5. 如果尚未向 {% data variables.product.prodname_container_registry %} 验证,请验证。有关详细信息,请参阅“[对 {% data variables.product.prodname_container_registry %} 进行身份验证](/packages/managing-container-images-with-github-container-registry/pushing-and-pulling-docker-images#authenticating-to-the-container-registry)”。
{% raw %}
```shell
$ echo $CR_PAT | docker login {% endraw %}{% data reusables.package_registry.container-registry-hostname %}{% raw %} -u USERNAME --password-stdin
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,15 +23,15 @@ ms.locfileid: '145130322'

## 关于包的安装

您可以在 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上搜索,以查找 {% data variables.product.prodname_registry %} 中可以在自己项目中安装的包。 有关详细信息,请参阅“[在 {% data variables.product.prodname_registry %} 中搜索包](/search-github/searching-on-github/searching-for-packages)”。
您可以在 {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} 上搜索,以查找 {% data variables.product.prodname_registry %} 中可以在自己项目中安装的包。有关详细信息,请参阅“[在 {% data variables.product.prodname_registry %} 中搜索包](/search-github/searching-on-github/searching-for-packages)”。

找到包后,您可以在包页面上阅读包的说明以及安装和使用说明。

## 安装包

你可以按照相同的一般准则,使用任何为实例启用的{% ifversion fpt or ghae or ghec %}支持的包客户端{% else %}包类型{% endif %}从 {% data variables.product.prodname_registry %} 安装包。

1. 按照包客户端的说明,向 {% data variables.product.prodname_registry %} 验证。 有关详细信息,请参阅“[对 GitHub 包进行身份验证](/packages/learn-github-packages/introduction-to-github-packages#authenticating-to-github-packages)”。
1. 按照包客户端的说明,向 {% data variables.product.prodname_registry %} 验证。有关详细信息,请参阅“[对 GitHub 包进行身份验证](/packages/learn-github-packages/introduction-to-github-packages#authenticating-to-github-packages)”。
2. 按照包客户端的说明安装包。

有关特定于包客户端的说明,请参阅“[使用 {% data variables.product.prodname_registry %} 注册表](/packages/working-with-a-github-packages-registry)”。
Original file line number Diff line number Diff line change
Expand Up @@ -22,21 +22,21 @@ ms.locfileid: '145130320'

## 关于发布的包

您可以在包页面上提供说明和其他详细信息,例如安装和使用说明,以帮助他人了解和使用您的包。 {% data variables.product.product_name %} 提供每个版本的元数据,例如发布日期、下载活动和最新版本。 有关示例包页面,请参阅 [@Codertocat/hello-world-npm](https://github.com/Codertocat/hello-world-npm/packages/10696?version=1.0.1)。
您可以在包页面上提供说明和其他详细信息,例如安装和使用说明,以帮助他人了解和使用您的包。 {% data variables.product.product_name %} 提供每个版本的元数据,例如发布日期、下载活动和最新版本。有关示例包页面,请参阅 [@Codertocat/hello-world-npm](https://github.com/Codertocat/hello-world-npm/packages/10696?version=1.0.1)。

{% data reusables.package_registry.public-or-private-packages %} 一个仓库可连接到多个包。 为避免混淆,请确保使用自述文件和说明清楚地阐明每个包的相关信息。
{% data reusables.package_registry.public-or-private-packages %} 一个仓库可连接到多个包。为避免混淆,请确保使用自述文件和说明清楚地阐明每个包的相关信息。

{% ifversion fpt or ghec %} 如果包的新版本修复了安全漏洞,则应在存储库中发布安全公告。 {% data variables.product.prodname_dotcom %} 审查每个发布的安全通告,并且可能使用它向受影响的仓库发送 {% data variables.product.prodname_dependabot_alerts %}。 有关详细信息,请参阅“[关于 GitHub 安全公告](/github/managing-security-vulnerabilities/about-github-security-advisories)”。
{% ifversion fpt or ghec %} 如果包的新版本修复了安全漏洞,则应在存储库中发布安全公告。 {% data variables.product.prodname_dotcom %} 审查每个发布的安全通告,并且可能使用它向受影响的仓库发送 {% data variables.product.prodname_dependabot_alerts %}。有关详细信息,请参阅“[关于 GitHub 安全公告](/github/managing-security-vulnerabilities/about-github-security-advisories)”。
{% endif %}

## 发布包

您可以按照一般准则,使用任何{% ifversion fpt or ghae or ghec %}支持的包客户端{% else %}为您的实例启用的包类型{% endif %}将包发布到 {% data variables.product.prodname_registry %}。

1. 针对要完成的任务,创建具有适当作用域的访问令牌或使用现有的此类令牌。 有关详细信息,请参阅“[关于 {% data variables.product.prodname_registry %} 的权限](/packages/learn-github-packages/about-permissions-for-github-packages)”。
1. 针对要完成的任务,创建具有适当作用域的访问令牌或使用现有的此类令牌。有关详细信息,请参阅“[关于 {% data variables.product.prodname_registry %} 的权限](/packages/learn-github-packages/about-permissions-for-github-packages)”。
2. 按照包客户端的说明,使用访问令牌向 {% data variables.product.prodname_registry %} 验证。
3. 按照包客户端的说明发布包。

有关包客户端的特定说明,请参阅“[使用 GitHub Packages 注册表](/packages/working-with-a-github-packages-registry)”。

在发布包后,您可以在 {% data variables.product.prodname_dotcom %} 上查看该包。 有关详细信息,请参阅“[查看包](/packages/learn-github-packages/viewing-packages)”。
在发布包后,您可以在 {% data variables.product.prodname_dotcom %} 上查看该包。有关详细信息,请参阅“[查看包](/packages/learn-github-packages/viewing-packages)”。
16 changes: 8 additions & 8 deletions translations/zh-CN/content/packages/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ ms.locfileid: '147876154'

## 发布包

1. 在 {% data variables.product.prodname_dotcom %} 上创建新存储库,为节点添加 `.gitignore`。 有关详细信息,请参阅“[创建新存储库](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)”。
1. 在 {% data variables.product.prodname_dotcom %} 上创建新存储库,为节点添加 `.gitignore`。有关详细信息,请参阅“[创建新存储库](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)”。
2. 将存储库克隆到本地计算机。
```shell
$ git clone https://{% ifversion ghes or ghae %}<em>YOUR-HOSTNAME</em>{% else %}github.com{% endif %}/<em>YOUR-USERNAME</em>/<em>YOUR-REPOSITORY</em>.git
Expand All @@ -35,7 +35,7 @@ ms.locfileid: '147876154'
console.log("Hello, World!");
```
{% endraw %}
4. 使用 `npm init` 初始化 npm 包。 在包初始化向导中,输入名称为 _`@YOUR-USERNAME/YOUR-REPOSITORY`_ 的包,并将测试脚本设置为 `exit 0`。 这将生成一个 `package.json` 文件,其中包含有关包的信息。
4. 使用 `npm init` 初始化 npm 包。在包初始化向导中,输入名称为 _`@YOUR-USERNAME/YOUR-REPOSITORY`_ 的包,并将测试脚本设置为 `exit 0`。这将生成一个 `package.json` 文件,其中包含有关包的信息。
{% raw %}
```shell
$ npm init
Expand All @@ -53,7 +53,7 @@ ms.locfileid: '147876154'
$ git commit -m "initialize npm package"
$ git push
```
6. 创建 `.github/workflows` 目录。 在此目录中,创建名为 `release-package.yml` 的文件。
6. 创建 `.github/workflows` 目录。在此目录中,创建名为 `release-package.yml` 的文件。
7. 将以下 YAML 内容复制到 `release-package.yml` 文件{% ifversion ghes or ghae %} 中,将 `YOUR-HOSTNAME` 替换为企业名称{% endif %}。
```yaml{:copy}
name: Node.js Package
Expand Down Expand Up @@ -111,9 +111,9 @@ ms.locfileid: '147876154'
$ git commit -m "workflow to publish package"
$ git push
```
10. 只要您的仓库中创建新版本,您创建的工作流程就会运行。 如果测试通过,则包将发布到 {% data variables.product.prodname_registry %}。
10. 只要您的仓库中创建新版本,您创建的工作流程就会运行。如果测试通过,则包将发布到 {% data variables.product.prodname_registry %}。

要测试这一点,请导航到存储库中的“代码”选项卡,并创建新版本。 有关详细信息,请参阅“[管理存储库中的发行版](/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release)”。
要测试这一点,请导航到存储库中的“代码”选项卡,并创建新版本。有关详细信息,请参阅“[管理存储库中的发行版](/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release)”。

## 查看已发布的包

Expand All @@ -123,13 +123,13 @@ ms.locfileid: '147876154'

## 安装已发布的包

现在,您已发布包,您需要使用它作为项目之间的依赖项。 有关详细信息,请参阅“[使用 npm 注册表](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#installing-a-package)”。
现在,您已发布包,您需要使用它作为项目之间的依赖项。有关详细信息,请参阅“[使用 npm 注册表](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#installing-a-package)”。

## 后续步骤

您刚刚添加的基本工作流程在仓库中创建新版本时运行。 但是,这只是您可以对 {% data variables.product.prodname_registry %} 执行操作的开始。 您可以使用单个工作流和将包发布到多个注册表,触发工作流程以在发生不同事件(如合并拉取请求、管理容器等)时运行。
您刚刚添加的基本工作流程在仓库中创建新版本时运行。但是,这只是您可以对 {% data variables.product.prodname_registry %} 执行操作的开始。您可以使用单个工作流和将包发布到多个注册表,触发工作流程以在发生不同事件(如合并拉取请求、管理容器等)时运行。

合并 {% data variables.product.prodname_registry %} 和 {% data variables.product.prodname_actions %} 可以帮助您实现应用程序开发过程几乎每个方面的自动化。 准备好开始了吗? 以下是一些有用的资源,可用于执行 {% data variables.product.prodname_registry %} 和 {% data variables.product.prodname_actions %} 的后续步骤:
合并 {% data variables.product.prodname_registry %} 和 {% data variables.product.prodname_actions %} 可以帮助您实现应用程序开发过程几乎每个方面的自动化。准备好开始了吗?以下是一些有用的资源,可用于执行 {% data variables.product.prodname_registry %} 和 {% data variables.product.prodname_actions %} 的后续步骤:

- 有关 GitHub 包的深入教程,请“[了解 {% data variables.product.prodname_registry %}](/packages/learn-github-packages)”。
- 有关 GitHub Actions 的深入教程,请“[了解 {% data variables.product.prodname_actions %}](/actions/learn-github-actions)”
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ ms.locfileid: '147409489'

## 关于从 Docker 注册表迁移

{% data reusables.package_registry.container-registry-replaces-docker-registry %}如果已将 Docker 映像存储在 Docker 注册表中,则{% ifversion docker-ghcr-enterprise-migration %}企业所有者{% else %}{% data variables.product.company_short %}{% endif %}会逐步将映像迁移到 {% data variables.product.prodname_container_registry %}。 你无需执行任何操作。
{% data reusables.package_registry.container-registry-replaces-docker-registry %}如果已将 Docker 映像存储在 Docker 注册表中,则{% ifversion docker-ghcr-enterprise-migration %}企业所有者{% else %}{% data variables.product.company_short %}{% endif %}会逐步将映像迁移到 {% data variables.product.prodname_container_registry %}。你无需执行任何操作。

{% ifversion docker-ghcr-enterprise-migration %}

Expand All @@ -57,7 +57,7 @@ ms.locfileid: '147409489'

{% ifversion fpt or ghec %}

迁移后,便无法再使用 GraphQL API 来查询 `PackageType` 为“DOCKER”的包。 可以改为使用 REST API 查询 `package_type` 为“容器”的包。 有关详细信息,请参阅 REST API 文档中的“[包](/rest/reference/packages)”。
迁移后,便无法再使用 GraphQL API 来查询 `PackageType` 为“DOCKER”的包。可以改为使用 REST API 查询 `package_type` 为“容器”的包。有关详细信息,请参阅 REST API 文档中的“[包](/rest/reference/packages)”。

## 关于 {% data variables.product.prodname_container_registry %} 的计费

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,11 +35,11 @@ ms.locfileid: '147061704'

{% data reusables.package_registry.required-scopes %}

通过编辑 ~/.m2/settings.xml 文件以包含个人访问令牌,可以使用 Apache Maven 向 {% data variables.product.prodname_registry %} 进行身份验证。 如果 ~/.m2/settings.xml 文件不存在,请新建该文件。
通过编辑 ~/.m2/settings.xml 文件以包含个人访问令牌,可以使用 Apache Maven 向 {% data variables.product.prodname_registry %} 进行身份验证。如果 ~/.m2/settings.xml 文件不存在,请新建该文件。

在 `servers` 标记中,添加一个带有 `id` 的子 `server` 标记,将“USERNAME”替换为 {% data variables.product.prodname_dotcom %} 用户名,并将“TOKEN”替换为个人访问令牌。

在 `repositories` 标记中,通过将存储库的 `id` 映射到在包含凭据的 `server` 标记中添加的 `id` 来对该存储库进行配置。 将 {% ifversion ghes or ghae %}HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名,并将{% endif %} OWNER 替换为拥有该存储库的用户或组织帐户的名称。 由于不支持大写字母,因此,即使您的 {% data variables.product.prodname_dotcom %} 用户或组织名称中包含大写字母,也必须对仓库所有者使用小写字母。
在 `repositories` 标记中,通过将存储库的 `id` 映射到在包含凭据的 `server` 标记中添加的 `id` 来对该存储库进行配置。将 {% ifversion ghes or ghae %}HOSTNAME 替换为 {% data variables.product.product_location %} 的主机名,并将{% endif %} OWNER 替换为拥有该存储库的用户或组织帐户的名称。由于不支持大写字母,因此,即使您的 {% data variables.product.prodname_dotcom %} 用户或组织名称中包含大写字母,也必须对仓库所有者使用小写字母。

如果要与多个存储库交互,可以将每个存储库添加到 `repositories` 标记中独立的子 `repository`,将每个存储库的
`id` 映射到 `servers` 标记中的凭据。
Expand Down Expand Up @@ -135,7 +135,7 @@ ms.locfileid: '147061704'
`com.example:test` 的包发布到名为
`OWNER/test` 的存储库中。

如果要将多个包发布到同一存储库,可以在 pom.xml 文件的 `<distributionManagement>` 元素中包含该存储库的 URL。 {% data variables.product.prodname_dotcom %} 将根据该字段匹配仓库。 由于存储库名称也是 `distributionManagement` 元素的一部分,因此将多个包发布到同一存储库无需额外步骤。
如果要将多个包发布到同一存储库,可以在 pom.xml 文件的 `<distributionManagement>` 元素中包含该存储库的 URL。 {% data variables.product.prodname_dotcom %} 将根据该字段匹配仓库。由于存储库名称也是 `distributionManagement` 元素的一部分,因此将多个包发布到同一存储库无需额外步骤。

有关创建包的详细信息,请参阅 [maven.apache.org 文档](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html)。

Expand Down Expand Up @@ -171,7 +171,7 @@ ms.locfileid: '147061704'

## 安装包

要从 {% data variables.product.prodname_registry %} 安装 Apache Maven 包,请编辑 pom.xml 文件以包含该包作为依赖项。 如果要从多个存储库安装包,请为每个存储库添加 `repository` 标记。 有关在项目中使用 pom.xml 文件的详细信息,请参阅 Apache Maven 文档中的“[POM 简介](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)”。
要从 {% data variables.product.prodname_registry %} 安装 Apache Maven 包,请编辑 pom.xml 文件以包含该包作为依赖项。如果要从多个存储库安装包,请为每个存储库添加 `repository` 标记。有关在项目中使用 pom.xml 文件的详细信息,请参阅 Apache Maven 文档中的“[POM 简介](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)”。

{% data reusables.package_registry.authenticate-step %}
2. 将包依赖项添加到项目 pom.xml 文件的 `dependencies` 元素,将 `com.example:test` 替换为包。
Expand Down
Loading