Enabling GitHub Actions with Amazon S3 storage

You can enable GitHub Actions on GitHub Enterprise Server and use Amazon S3 storage to store artifacts generated by workflow runs.

Site administrators can enable GitHub Actions and configure enterprise settings.

Prerequisites

警告: 唯一支持的 S3 存储提供商是 Amazon S3 和 MinIO Gateway for NAS。 不支持其他 S3 API 兼容的存储提供商。 有关支持的存储提供商的更多信息,请参阅“GitHub Enterprise Server 的 GitHub Actions 使用入门”。

Before enabling GitHub Actions, make sure you have completed the following steps:

  • Create your Amazon S3 bucket for storing artifacts generated by workflow runs. GitHub Actions 需要以下访问密钥的权限才可访问存储桶:

    • s3:PutObject
    • s3:GetObject
    • s3:ListBucketMultipartUploads
    • s3:ListMultipartUploadParts
    • s3:AbortMultipartUpload
    • s3:DeleteObject
    • s3:ListBucket
    • kms:GenerateDataKey (if Key Management Service (KMS) encryption has been enabled)
  • 查看 GitHub Actions 的硬件要求。 更多信息请参阅“GitHub Enterprise Server 的 GitHub Actions 使用入门”。

  • 必须为 your GitHub Enterprise Server instance 的域配置 TLS。 更多信息请参阅“配置 TLS”。

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

  • 如果您在 your GitHub Enterprise Server instance上配置了 HTTP 代理服务器 ,则必须添加 localhost127.0.0.1HTTP 代理排除 列表中。 有关更改代理设置的更多信息,请参阅“配置出站 Web 代理服务器”。

Enabling GitHub Actions with Amazon S3 storage

  1. 从 GitHub Enterprise Server 上的管理帐户,点击任何页面右上角的 用于访问站点管理员设置的火箭图标

  2. 在左侧边栏中,单击 管理控制台左侧边栏中的 管理控制台 选项卡

  3. 在左侧边栏中,单击 Actions(操作)设置侧边栏中的 Actions 选项卡

  4. 选择 Enable GitHub Actions(启用 GitHub Actions)启用 GitHub Actions 的复选框

  5. Under "Artifact & Log Storage", select Amazon S3, and enter your storage bucket's details:

    • AWS Service URL: The service URL for your bucket. For example, if your S3 bucket was created in the us-west-2 region, this value should be https://s3.us-west-2.amazonaws.com.

      For more information, see "AWS service endpoints" in the AWS documentation.

    • AWS S3 Bucket: The name of your S3 bucket.

    • AWS S3 Access Key and AWS S3 Secret Key: The AWS access key ID and secret key for your bucket. For more information on managing AWS access keys, see the "AWS Identity and Access Management Documentation."

    Radio button for selecting Amazon S3 Storage and fields for S3 configuration

  6. 在左侧边栏下,单击 Save settings(保存设置)管理控制台 中的 Save settings 按钮

  7. 等待配置运行完毕。

后续步骤

配置运行成功完成后, GitHub Actions 将在 your GitHub Enterprise Server instance 上启用。 有关后续步骤,例如管理 GitHub Actions 访问权限和添加自托管运行器,请返回到“GitHub Enterprise Server 的 GitHub Actions 使用入门”。

此文档对您有帮助吗?

隐私政策

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

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

做出贡献

或者, 了解如何参与。