Merge branch 'main' into bwestover/connect-backup-utils-fix

Author: bwestover

assets/images/help/images/actions-enterprise-overview.png

@@ -13,6 +13,7 @@ learningTracks:
   - continuous_integration
   - continuous_deployment
   - deploy_to_the_cloud
+  - '{% ifversion ghec or ghes or ghae %}adopting_github_actions_for_your_enterprise{% endif %}'
   - hosting_your_own_runners
   - create_actions
 includeGuides:

assets/images/help/images/actions-policies-overview.png

@@ -23,7 +23,7 @@ topics:
 
 ## Overview
 
-{% data variables.product.prodname_actions %} help you automate tasks within your software development life cycle. {% data variables.product.prodname_actions %} are event-driven, meaning that you can run a series of commands after a specified event has occurred. For example, every time someone creates a pull request for a repository, you can automatically run a command that executes a software testing script.
+{% data reusables.actions.about-actions %} {% data variables.product.prodname_actions %} are event-driven, meaning that you can run a series of commands after a specified event has occurred. For example, every time someone creates a pull request for a repository, you can automatically run a command that executes a software testing script.
 
 This diagram demonstrates how you can use {% data variables.product.prodname_actions %} to automatically run your software testing scripts. An event automatically triggers the _workflow_, which contains a _job_. The job then uses _steps_ to control the order in which _actions_ are run. These actions are the commands that automate your software testing.
 
@@ -59,7 +59,7 @@ _Actions_ are standalone commands that are combined into _steps_ to create a _jo
 
 {% ifversion ghae %}A runner is a server that has the [{% data variables.product.prodname_actions %} runner application](https://github.com/actions/runner) installed. For {% data variables.product.prodname_ghe_managed %}, you can use the security hardened {% data variables.actions.hosted_runner %}s which are bundled with your instance in the cloud. A runner listens for available jobs, runs one job at a time, and reports the progress, logs, and results back to {% data variables.product.prodname_dotcom %}. {% data variables.actions.hosted_runner %}s run each workflow job in a fresh virtual environment. For more information, see "[About {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/about-ae-hosted-runners)."
 {% else %}
-A runner is a server that has the [{% data variables.product.prodname_actions %} runner application](https://github.com/actions/runner) installed. You can use a runner hosted by {% data variables.product.prodname_dotcom %}, or you can host your own. A runner listens for available jobs, runs one job at a time, and reports the progress, logs, and results back to {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_dotcom %}-hosted runners are based on Ubuntu Linux, Microsoft Windows, and macOS, and each job in a workflow runs in a fresh virtual environment.  For information on {% data variables.product.prodname_dotcom %}-hosted runners, see "[About {% data variables.product.prodname_dotcom %}-hosted runners](/actions/using-github-hosted-runners/about-github-hosted-runners)." If you need a different operating system or require a specific hardware configuration, you can host your own runners. For information on self-hosted runners, see "[Hosting your own runners](/actions/hosting-your-own-runners)."
+{% data reusables.actions.about-runners %} A runner listens for available jobs, runs one job at a time, and reports the progress, logs, and results back to {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_dotcom %}-hosted runners are based on Ubuntu Linux, Microsoft Windows, and macOS, and each job in a workflow runs in a fresh virtual environment.  For information on {% data variables.product.prodname_dotcom %}-hosted runners, see "[About {% data variables.product.prodname_dotcom %}-hosted runners](/actions/using-github-hosted-runners/about-github-hosted-runners)." If you need a different operating system or require a specific hardware configuration, you can host your own runners. For information on self-hosted runners, see "[Hosting your own runners](/actions/hosting-your-own-runners)."
 {% endif %}
 
 ## Create an example workflow

content/actions/guides.md

@@ -6,7 +6,6 @@ versions:
 topics:
   - Enterprise
 children:
-  - /getting-started-with-github-actions-for-github-enterprise-server
   - /enabling-github-actions-with-azure-blob-storage
   - /enabling-github-actions-with-amazon-s3-storage
   - /enabling-github-actions-with-minio-gateway-for-nas-storage

content/actions/learn-github-actions/understanding-github-actions.md

@@ -1,7 +1,7 @@
 ---
 title: Getting started with GitHub Actions for GitHub AE
-shortTitle: Getting started with GitHub Actions
-intro: 'Learn configuring {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_managed %}.'
+shortTitle: Get started
+intro: 'Learn about configuring {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_managed %}.'
 permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
 versions:
   ghae: '*'
@@ -11,12 +11,21 @@ topics:
   - Enterprise
 redirect_from:
   - /admin/github-actions/getting-started-with-github-actions-for-github-ae
+  - /admin/github-actions/using-github-actions-in-github-ae/getting-started-with-github-actions-for-github-ae
 ---
 
 {% data reusables.actions.ae-beta %}
 
+## About {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_managed %}
+
 This article explains how site administrators can configure {% data variables.product.prodname_ghe_managed %} to use {% data variables.product.prodname_actions %}.
 
+{% data variables.product.prodname_actions %} is enabled for {% data variables.product.prodname_ghe_managed %} by default. To get started using {% data variables.product.prodname_actions %} within your enterprise, you need to manage access permissions for {% data variables.product.prodname_actions %} and add runners to run workflows.
+
+{% data reusables.actions.introducing-enterprise %}
+
+{% data reusables.actions.migrating-enterprise %}
+
 ## 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](/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."
@@ -31,7 +40,4 @@ You can use policies to manage access to {% data variables.product.prodname_acti
 
 To run {% data variables.product.prodname_actions %} workflows, you need to add runners. You can add runners at the enterprise, organization, or repository levels. For more information, see  "[About {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/about-ae-hosted-runners)."
 
-
-## 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 %}](/actions/learn-github-actions/security-hardening-for-github-actions)."
+{% data reusables.actions.general-security-hardening %}

content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/index.md

@@ -0,0 +1,34 @@
+---
+title: Getting started with GitHub Actions for GitHub Enterprise Cloud
+shortTitle: Get started
+intro: 'Learn how to configure {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_cloud %}.'
+permissions: 'Enterprise owners can configure {% data variables.product.prodname_actions %}.'
+versions:
+  ghec: '*'
+type: how_to
+topics:
+  - Actions
+  - Enterprise
+---
+
+## About {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_cloud %}
+
+{% data variables.product.prodname_actions %} is enabled for your enterprise by default. To get started using {% data variables.product.prodname_actions %} within your enterprise, you can manage the policies that control how enterprise members use {% data variables.product.prodname_actions %} and optionally add self-hosted runners to run workflows.
+
+{% data reusables.actions.introducing-enterprise %}
+
+{% data reusables.actions.migrating-enterprise %}
+
+## Managing policies for {% data variables.product.prodname_actions %}
+
+You can use policies to control how enterprise members use {% data variables.product.prodname_actions %}. For example, you can restrict which actions are allowed and configure artifact and log retention. For more information, see "[Enforcing GitHub Actions policies for your enterprise](/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise)."
+
+## Adding runners
+
+To run {% data variables.product.prodname_actions %} workflows, you need to use runners. {% data reusables.actions.about-runners %} If you use {% data variables.product.company_short %}-hosted runners, you will be be billed based on consumption after exhausting the minutes included in {% data variables.product.product_name %}, while self-hosted runners are free. For more information, see "[About billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)."
+
+For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)."
+
+If you choose self-hosted runners, you can add runners at the enterprise, organization, or repository levels. For more information, see "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)"
+
+{% data reusables.actions.general-security-hardening %}

…ted-with-github-actions-for-github-ae.md …ted-with-github-actions-for-github-ae.mdcontent/admin/github-actions/using-github-actions-in-github-ae/getting-started-with-github-actions-for-github-ae.md renamed to content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-ae.md content/admin/github-actions/using-github-actions-in-github-ae/getting-started-with-github-actions-for-github-ae.md renamed to content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-ae.md

@@ -1,12 +1,13 @@
 ---
 title: Getting started with GitHub Actions for GitHub Enterprise Server
-shortTitle: Getting started with GitHub Actions
+shortTitle: Get started
 intro: 'Learn about enabling and configuring {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} for the first time.'
 permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
 redirect_from:
   - /enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage
   - /admin/github-actions/enabling-github-actions-and-configuring-storage
   - /admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server
+  - /admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server
 versions:
   ghes: '*'
 type: how_to
@@ -18,11 +19,15 @@ topics:
 
 {% data reusables.actions.enterprise-github-hosted-runners %}
 
-{% ifversion ghes %}
+## About {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}
 
-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.
+This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. 
 
-{% endif %}
+{% data variables.product.prodname_actions %} is not enabled for {% data variables.product.prodname_ghe_server %} by default. You'll need to determine whether your instance has adequate CPU and memory resources to handle the load from {% data variables.product.prodname_actions %} without causing performance loss, and possibly increase those resources. You'll also need to decide which storage provider you'll use for the blob storage required to store artifacts generated by workflow runs. Then, you'll enable {% data variables.product.prodname_actions %} for your enterprise, manage access permissions, and add self-hosted runners to run workflows.
+
+{% data reusables.actions.introducing-enterprise %}
+
+{% data reusables.actions.migrating-enterprise %}
 
 ## Review hardware considerations
 
@@ -137,9 +142,7 @@ You can control which actions your users are allowed to use in your enterprise.
 
 For more information, see "[About using actions in your enterprise](/admin/github-actions/about-using-actions-in-your-enterprise)."
 
-## 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 %}](/actions/learn-github-actions/security-hardening-for-github-actions)."
+{% data reusables.actions.general-security-hardening %}
 
 {% endif %}
 

content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud.md

@@ -0,0 +1,19 @@
+---
+title: Getting started with GitHub Actions for your enterprise
+intro: "Learn how to adopt {% data variables.product.prodname_actions %} for your enterprise."
+versions:
+  ghec: '*'
+  ghes: '*'
+  ghae: '*'
+topics:
+  - Enterprise
+  - Actions
+children:
+  - /introducing-github-actions-to-your-enterprise
+  - /migrating-your-enterprise-to-github-actions
+  - /getting-started-with-github-actions-for-github-enterprise-cloud
+  - /getting-started-with-github-actions-for-github-enterprise-server
+  - /getting-started-with-github-actions-for-github-ae
+shortTitle: Get started
+---
+