1
0
mirror of synced 2025-12-22 19:34:15 -05:00
Files
docs/content/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server.md

5.4 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.
/enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage
/admin/github-actions/enabling-github-actions-and-configuring-storage
enterprise-server
>=2.22

{% if currentVersion == "enterprise-server@2.22" %} {% note %}

Note: {% data variables.product.prodname_actions %} support on {% data variables.product.prodname_ghe_server %} 2.22 is a limited public beta. Review the external storage requirements below and sign up for the beta.

{% endnote %} {% endif %}

{% 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.

Review hardware considerations

{% data reusables.actions.enterprise-hardware-considerations %}

{% endif %}

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 is a limited public beta. Sign up for the beta.

Further reading

{% 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:

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 %}