Skip to main content

Enabling GitHub Actions with Azure Blob storage

You can enable GitHub Actions on GitHub Enterprise Server and use Azure Blob storage to store data generated by workflow runs.

Site administrators can enable GitHub Actions and configure enterprise settings.


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

  • Create your Azure storage account for storing workflow data. GitHub Actions stores its data as block blobs, and two storage account types are supported:

    • A general-purpose storage account (also known as general-purpose v1 or general-purpose v2) using the standard performance tier.

      Warning: Using the premium performance tier with a general-purpose storage account is not supported. The standard performance tier must be selected when creating the storage account, and it cannot be changed later.

    • A BlockBlobStorage storage account, which uses the premium performance tier.

    For more information on Azure storage account types and performance tiers, see the Azure documentation.

  • 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 您的 GitHub Enterprise Server 实例's domain. For more information, see "Configuring TLS."

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

  • If you have an HTTP Proxy Server configured on 您的 GitHub Enterprise Server 实例:

    • You must add localhost and to the HTTP Proxy Exclusion list.
    • If the BYOS bucket is not routable, then you must also add the bucket's URL to the exclusion list.

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

Enabling GitHub Actions with Azure Blob storage

  1. SSH 连接到 您的 GitHub Enterprise Server 实例。 If your instance comprises multiple nodes, for example if high availability or geo-replication are configured, SSH into the primary node. If you use a cluster, you can SSH into any node. For more information about SSH access, see "Accessing the administrative shell (SSH)."

    $ ssh -p 122 admin@HOSTNAME
  2. 运行 ghe-actions-precheck 命令来测试 blob 存储配置。 更多信息请参阅“命令行实用程序”。

  3. 从 GitHub Enterprise Server 上的管理帐户中,在任何页面的右上角,单击


  4. 如果您尚未进入“站点管理员”页面,请在左上角单击 Site admin(站点管理员)

    "站点管理员" 链接的屏幕截图

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

  6. 在左侧边栏中,单击 Actions(操作)

    设置侧边栏中的 Actions 选项卡

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

  8. Under "Artifact & Log Storage", select Azure Blob Storage, and enter your Azure storage account's connection string. For more information on getting the connection string for your storage account, see the Azure documentation. Radio button for selecting Azure Blob Storage and the Connection string field

  9. 在左侧边栏下,单击 Save settings(保存设置)

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

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

  10. 等待配置运行完毕。


Next steps

After the configuration run has successfully completed, GitHub Actions will be enabled on 您的 GitHub Enterprise Server 实例. 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."