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:
-
To avoid resource contention on the appliance, we recommend that MinIO be hosted separately from your GitHub Enterprise Server instance.
-
Create your bucket for storing workflow artifacts. To set up your bucket and access key, see the MinIO documentation. 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)
-
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 代理服务器 ,则必须添�
localhost
和127.0.0.1
到 HTTP 代理排除 列表中。 有关更改代理设置的更多信息,请参阅“配置出站 Web 代理服务器”。
Enabling GitHub Actions with MinIO Gateway for NAS storage
-
SSH 连接到 your GitHub Enterprise Server instance。 更多信息请参阅“访问管理 shell (SSH)。”
$ ssh -p 122 admin@HOSTNAME
-
Run the
ghe-actions-precheck
command to test your blob storage configuration. 更多信息请参阅“命令行实用程序”。 -
From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .
-
If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.
-
在左侧边� �中,单击 管理控制台。
-
在左侧边� �中,单击 Actions(操作)。
-
选择 Enable GitHub Actions(启用 GitHub Actions)。
-
Under "Artifact & Log Storage", select Amazon S3, and enter your storage bucket's details:
- AWS Service URL: The URL to your MinIO service. For example,
https://my-minio.example:9000
. - AWS S3 Bucket: The name of your S3 bucket.
- AWS S3 Access Key and AWS S3 Secret Key: The
MINIO_ACCESS_KEY
andMINIO_SECRET_KEY
used for your MinIO instance. For more information, see the MinIO documentation.
- AWS Service URL: The URL to your MinIO service. For example,
-
Under "Artifact & Log Storage", select Force path style.
-
在左侧边� �下,单击 Save settings(保存设置)。
Note: Saving settings in the 管理控制台 restarts system services, which could result in user-visible downtime.
-
等待配置运行完毕。
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."