Skip to main content

使用 Amazon S3 存储启用 GitHub Actions

可以在 GitHub Enterprise Server 上启用 GitHub Actions,并使用 Amazon S3 存储来存储工作流运行生成的数据。

Who can use this feature

Site administrators can enable GitHub Actions and configure enterprise settings.

先决条件

注意:唯一支持 GitHub 的 S3 存储提供商是 Amazon S3 和适用于 NAS 的 MinIO 网关。

还有其他与 S3 API 兼容的存储产品,GitHub 合作伙伴已经将它们自我验证为可以与 GitHub Actions 在 GitHub Enterprise Server 上运行。 有关详细信息,请参阅 GHES 存储合作伙伴存储库。

对于通过 GitHub 技术合作伙伴计划验证的存储产品,存储提供商负责为将存储产品与 GitHub Actions 配合使用提供支持和文档。

在启用 GitHub Actions 之前,请确保您已完成以下步骤:

  • 创建 Amazon S3 存储桶,用于存储工作流程运行生成的数据。 GitHub Actions 需要以下访问密钥的权限才可访问存储桶:

    • s3:PutObject
    • s3:GetObject
    • s3:ListBucketMultipartUploads
    • s3:ListMultipartUploadParts
    • s3:AbortMultipartUpload
    • s3:DeleteObject
    • s3:ListBucket
    • kms:GenerateDataKey(如果已启用密钥管理服务 (KMS) 加密)
  • Review the hardware requirements for GitHub Actions. For more information, see "Getting started with GitHub Actions for GitHub Enterprise Server."

  • TLS must be configured for your GitHub Enterprise Server instance's domain. For more information, see "Configuring TLS."

    Note: 我们强烈建议您在 GitHub Enterprise Server 上配置 TLS,并有信任的机构签名的证书。 虽然自签名证书可以工作,但自托管的运行器需要额外的配置,不推荐用于生产环境。

  • 如果在 your GitHub Enterprise Server instance 上配置了 HTTP 代理服务器:

    • 必须将 localhost127.0.0.1 添加到“HTTP 代理排除”列表。
    • 如果外部存储位置不可路由,则还必须将外部存储 URL 添加到排除列表中。

    有关更改代理设置的详细信息,请参阅“配置出站 Web 代理服务器”。

使用 Amazon S3 存储启用 GitHub Actions

  1. 从 GitHub Enterprise Server 上的管理帐户任意页面的右上角,单击

    用于访问站点管理员设置的火箭图标的屏幕截图

  2. 如果你尚未在“站点管理员”页上,请在左上角单击“站点管理员”。

    “站点管理员”链接的屏幕截图 1. 在左侧边栏中,单击“管理控制台”。 左侧边栏中的 管理控制台 选项卡 1. 在左侧边栏中,单击“操作”。

    设置侧边栏中的 Actions 选项卡 1. 选择“启用 GitHub Actions”。 “启用 GitHub Actions”复选框

  3. 在“工件和日志存储”下,选择“Amazon S3”,然后输入存储桶的详细信息:

    • AWS 服务 URL:存储桶的服务 URL。 例如,如果你的 S3 存储桶是在 us-west-2 区域中创建的,则此值应为 https://s3.us-west-2.amazonaws.com

      有关详细信息,请参阅 AWS 文档中的“AWS 服务终结点”。

    • AWS S3 存储桶:S3 存储桶的名称。

    • AWS S3 访问密钥和 AWS S3 密钥:存储桶的 AWS 访问密钥 ID 和密钥 。 有关管理 AWS 访问密钥的详细信息,请参阅“AWS 标识和访问管理文档”。

    用于选择 Amazon S3 存储和 S3 配置字段的单选按钮1. 单击“测试存储设置”按钮验证存储设置。

    如果在验证存储设置时出现任何错误,请检查存储提供程序设置并重试。 1. 在左侧边栏下,单击“保存设置”。

    管理控制台 中的“保存设置”按钮的屏幕截图

    注意:保存 管理控制台 中的设置会重启系统服务,这可能会导致用户可察觉的停机时间。

  4. 等待配置运行完毕。

    配置实例

Next steps

After the configuration run has successfully completed, GitHub Actions will be enabled on your GitHub Enterprise Server instance. For your next steps, such as managing GitHub Actions access permissions and adding self-hosted runners, return to "Getting started with GitHub Actions for GitHub Enterprise Server."