我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
GitHub AE 目前是有限发行版。请联系我们的销售团队了解更多信息。

GitHub Packages 快速入门

通过 GitHub Actions 发布到 GitHub Packages。

本文内容

注意: GitHub Actions 目前正在测试用于 GitHub AE 。

警告: 自托管运行器目前对 GitHub AE 禁用。 这是因为 GitHub AE 为安全边界提供了不符合自托管运行器工作方式的保证。 但是,如果您确实需要使用具有 GitHub AE 的自托管运行器并了解安全的意义,可以联系 GitHub 支持以了解将会启用自托管运行器的安全异常。

如果您不需要自托管的运行器,则可使用 AE 托管的运行器 来运行您的工作流程。 更多信息请参阅“关于 AE 托管的运行器”。

简介

在本指南中,您将创建 GitHub Actions 工作流程来测试代码,然后将其发布到 GitHub Packages。

发布包

  1. 在 GitHub 上创建新仓库,为节点添加 .gitignore。 更多信息请参阅“创建新仓库”。

  2. 将仓库克隆到本机。

    $ git clone https://YOUR-HOSTNAME/YOUR-USERNAME/YOUR-REPOSITORY.git
    $ cd YOUR-REPOSITORY
  3. 创建 index.js 文件,并添加基本警报说 "Hello world!"

    JavaScript
    alert("Hello, World!");
  4. 使用 npm init 初始化 npm 包。 在包初始化向导中,输入包名称:@YOUR-USERNAME/YOUR-REPOSITORY,将测试脚本设置为 exit 0。 这将生成一个 package.json 文件,其中包含关于您的包的信息。

    $ npm init
      ...
      package name: @YOUR-USERNAME/YOUR-REPOSITORY
      ...
      test command: exit 0
      ...    
  1. 运行 npm install 来生成 package-lock.json 文件,然后提交并将更改推送到 GitHub。

    $ npm install
    $ git add index.js package.json package-lock.json
    $ git commit -m "initialize npm package"
    $ git push
  2. 创建 .github/workflow 目录。 在该目录中,创建一个名为 release-package.yml 的文件。

  3. 将以下 YAML 内容复制到 release-package.yml 文件,将 YOUR-HOSTNAME 替换为企业的名称。

    YAML
    name: Node.js Package
    
    on:
      release:
        types: [created]
    
    jobs:
      build:
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v2
          - uses: actions/setup-node@v1
            with:
              node-version: 12
          - run: npm ci
          - run: npm test
    
      publish-gpr:
        needs: build
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v2
          - uses: actions/setup-node@v1
            with:
              node-version: 12
              registry-url: https://npm.YOUR-HOSTNAME.com/
          - run: npm ci
          - run: npm publish
            env:
              NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}
  4. 提交并推送更改到 GitHub。

    $ git add .github/workflows/release-package.yml
    $ git commit -m "workflow to publish package"
    $ git push
  5. 只要您的仓库中创建新版本,您创建的工作流程就会运行。 如果测试通过,则包将发布到 GitHub Packages。

    要测试这一点,请导航到仓库中的 Code(代码)选项卡,并创建新版本。 更多信息请参阅“管理仓库中的发行版”。

查看已发布的包

包在仓库级别发布。 您可以查看仓库中的所有包,也可以搜索特定的包。

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

  2. 在文件列表右侧,单击 Packages(包)

    概述页面上的包链接

  3. 单击要查看的包的名称。 包名称

安装已发布的包

现在,您已发布包,您需要使用它作为项目之间的依赖项。 更多信息请参阅"配置 npm 用于 GitHub Packages"。

后续步骤

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

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

此文档对您有帮助吗?

Privacy policy

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。