7.2 KiB
title, intro, permissions, redirect_from, versions
| title | intro | permissions | redirect_from | versions | ||||
|---|---|---|---|---|---|---|---|---|
| Getting started with GitHub Actions for GitHub Enterprise Server | Learn about enabling and configuring {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} for the first time. | Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings. |
|
|
{% data reusables.actions.enterprise-beta %}
{% data reusables.actions.enterprise-github-hosted-runners %}
{% if currentVersion ver_gt "enterprise-server@2.22" %}
This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. It covers the hardware and software requirements, presents the storage options, and describes the security management policies.
{% endif %}
Review hardware considerations
{% if currentVersion == "enterprise-server@2.22" or currentVersion == "enterprise-server@3.0" %}
{% note %}
Note: {% if currentVersion == "enterprise-server@2.22" %}{% data variables.product.prodname_actions %} was available for {% data variables.product.prodname_ghe_server %} 2.22 as a limited beta. {% endif %}If you're upgrading an existing {% data variables.product.prodname_ghe_server %} instance to 3.0 or later and want to configure {% data variables.product.prodname_actions %}, note that the minimum hardware requirements have increased. For more information, see "Upgrading {% data variables.product.prodname_ghe_server %}."
{% endnote %}
{% endif %}
{% data reusables.actions.enterprise-hardware-considerations %}
For more information about resource requirements for {% data variables.product.prodname_ghe_server %}, see the hardware considerations for your instance's platform.
{% data reusables.enterprise_installation.about-adjusting-resources %}
External storage requirements
To enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}, you must have access to external blob storage.
{% data variables.product.prodname_actions %} uses blob storage to store artifacts generated by workflow runs, such as workflow logs and user-uploaded build artifacts. The amount of storage required depends on your usage of {% data variables.product.prodname_actions %}. Only a single external storage configuration is supported, and you can't use multiple storage providers at the same time.
{% data variables.product.prodname_actions %} supports these storage providers:
- Azure Blob storage
- Amazon S3
- S3-compatible MinIO Gateway for NAS
{% note %}
Note: These are the only storage providers that {% data variables.product.company_short %} supports and can provide assistance with. Other S3 API-compatible storage providers are unlikely to work due to differences from the S3 API. Contact us to request support for additional storage providers.
{% endnote %}
{% if currentVersion == "enterprise-server@2.22" %}
Amazon S3 permissions
{% data reusables.actions.enterprise-s3-permission %}
Enabling {% data variables.product.prodname_actions %}
{% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 was available as a limited beta. To configure {% data variables.product.prodname_actions %} for your instance, upgrade to {% data variables.product.prodname_ghe_server %} 3.0 or later. For more information, see the {% data variables.product.prodname_ghe_server %} 3.0 release notes and "Upgrading {% data variables.product.prodname_ghe_server %}."
Further reading
- "Hardware considerations" for your platform in "Setting up a {% data variables.product.prodname_ghe_server %} instance"
{% endif %}
{% if currentVersion ver_gt "enterprise-server@2.22" %}
Enabling {% data variables.product.prodname_actions %} with your storage provider
Follow one of the procedures below to enable {% data variables.product.prodname_actions %} with your chosen storage provider:
- Enabling GitHub Actions with Azure Blob storage
- Enabling GitHub Actions with Amazon S3 storage
- Enabling GitHub Actions with MinIO Gateway for NAS storage
Managing access permissions for {% data variables.product.prodname_actions %} in your enterprise
You can use policies to manage access to {% data variables.product.prodname_actions %}. For more information, see "Enforcing GitHub Actions policies for your enterprise."
Adding self-hosted runners
{% data reusables.actions.enterprise-github-hosted-runners %}
To run {% data variables.product.prodname_actions %} workflows, you need to add self-hosted runners. You can add self-hosted runners at the enterprise, organization, or repository levels. For more information, see "Adding self-hosted runners."
Managing which actions can be used in your enterprise
You can control which actions your users are allowed to use in your enterprise. This includes setting up {% data variables.product.prodname_github_connect %} for automatic access to actions from {% data variables.product.prodname_dotcom_the_website %}, or manually syncing actions from {% data variables.product.prodname_dotcom_the_website %}.
For more information, see "About using actions on {% data variables.product.prodname_ghe_server %}."
General security hardening for {% data variables.product.prodname_actions %}
If you want to learn more about security practices for {% data variables.product.prodname_actions %}, see "Security hardening for {% data variables.product.prodname_actions %}."
{% endif %}