Actions IA: move "sharing automations" content (#51862)
Co-authored-by: jc-clark <jc-clark@github.com> Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com> Co-authored-by: sunbrye <sunbrye@github.com>
This commit is contained in:
Siara
@@ -83,7 +83,7 @@ For more information, see "[AUTOTITLE](/actions/creating-actions)."
|
||||
|
||||
### Runners
|
||||
|
||||
{% data reusables.actions.about-runners %} Each runner can run a single job at a time. {% ifversion ghes %} You must host your own runners for {% data variables.product.product_name %}. {% elsif fpt or ghec %}{% data variables.product.company_short %} provides Ubuntu Linux, Microsoft Windows, and macOS runners to run your workflows; each workflow run executes in a fresh, newly-provisioned virtual machine. {% ifversion actions-hosted-runners %} {% data variables.product.prodname_dotcom %} also offers {% data variables.actions.hosted_runner %}s, which are available in larger configurations. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/using-larger-runners)." {% endif %}If you need a different operating system or require a specific hardware configuration, you can host your own runners.{% endif %} For more information{% ifversion fpt or ghec %} about self-hosted runners{% endif %}, see "[AUTOTITLE](/actions/hosting-your-own-runners)."
|
||||
{% data reusables.actions.about-runners %} Each runner can run a single job at a time. {% ifversion ghes %} You must host your own runners for {% data variables.product.product_name %}. {% elsif fpt or ghec %}{% data variables.product.company_short %} provides Ubuntu Linux, Microsoft Windows, and macOS runners to run your workflows; each workflow run executes in a fresh, newly-provisioned virtual machine. {% ifversion actions-hosted-runners %} {% data variables.product.prodname_dotcom %} also offers {% data variables.actions.hosted_runner %}s, which are available in larger configurations. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/using-larger-runners/about-larger-runners)." {% endif %}If you need a different operating system or require a specific hardware configuration, you can host your own runners.{% endif %} For more information{% ifversion fpt or ghec %} about self-hosted runners{% endif %}, see "[AUTOTITLE](/actions/hosting-your-own-runners)."
|
||||
|
||||
{% data reusables.actions.workflow-basic-example-and-explanation %}
|
||||
|
||||
|
||||
@@ -16,7 +16,7 @@ learningTracks:
|
||||
includeGuides:
|
||||
- /actions/writing-workflows/quickstart
|
||||
- /actions/about-github-actions/understanding-github-actions
|
||||
- /actions/creating-actions/creating-a-docker-container-action
|
||||
- /actions/sharing-automations/creating-actions/creating-a-docker-container-action
|
||||
- /actions/writing-workflows/using-starter-workflows
|
||||
- /actions/use-cases-and-examples/building-and-testing/building-and-testing-python
|
||||
- /actions/use-cases-and-examples/building-and-testing/building-and-testing-nodejs
|
||||
@@ -41,9 +41,9 @@ includeGuides:
|
||||
- /actions/use-cases-and-examples/using-containerized-services/creating-postgresql-service-containers
|
||||
- /actions/use-cases-and-examples/deploying/deploying-to-amazon-elastic-container-service
|
||||
- /actions/use-cases-and-examples/deploying/deploying-to-google-kubernetes-engine
|
||||
- /actions/creating-actions/about-custom-actions
|
||||
- /actions/creating-actions/creating-a-javascript-action
|
||||
- /actions/creating-actions/creating-a-composite-action
|
||||
- /actions/sharing-automations/creating-actions/about-custom-actions
|
||||
- /actions/sharing-automations/creating-actions/creating-a-javascript-action
|
||||
- /actions/sharing-automations/creating-actions/creating-a-composite-action
|
||||
- /actions/migrating-to-github-actions/manually-migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions
|
||||
- /actions/migrating-to-github-actions/manually-migrating-to-github-actions/migrating-from-circleci-to-github-actions
|
||||
- /actions/migrating-to-github-actions/manually-migrating-to-github-actions/migrating-from-gitlab-cicd-to-github-actions
|
||||
|
||||
@@ -9,8 +9,8 @@ versions:
|
||||
topics:
|
||||
- Actions Runner Controller
|
||||
children:
|
||||
- /quickstart-for-actions-runner-controller
|
||||
- /about-actions-runner-controller
|
||||
- /quickstart-for-actions-runner-controller
|
||||
- /authenticating-to-the-github-api
|
||||
- /deploying-runner-scale-sets-with-actions-runner-controller
|
||||
- /using-actions-runner-controller-runners-in-a-workflow
|
||||
|
||||
@@ -39,16 +39,14 @@ versions:
|
||||
children:
|
||||
- /about-github-actions
|
||||
- /writing-workflows
|
||||
- /using-workflows
|
||||
- /managing-workflow-runs-and-deployments
|
||||
- /migrating-to-github-actions
|
||||
- /sharing-automations
|
||||
- /monitoring-and-troubleshooting-workflows
|
||||
- /using-github-hosted-runners
|
||||
- /hosting-your-own-runners
|
||||
- /security-for-github-actions
|
||||
- /use-cases-and-examples
|
||||
- /creating-actions
|
||||
- /migrating-to-github-actions
|
||||
- /administering-github-actions
|
||||
- /guides
|
||||
---
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ versions:
|
||||
redirect_from:
|
||||
- /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax
|
||||
children:
|
||||
- /automated-migrations
|
||||
- /using-github-actions-importer-to-automate-migrations
|
||||
- /manually-migrating-to-github-actions
|
||||
---
|
||||
|
||||
|
||||
@@ -3,6 +3,7 @@ title: Automating migration with GitHub Actions Importer
|
||||
intro: 'Use {% data variables.product.prodname_actions_importer %} to plan and automate your migration to {% data variables.product.prodname_actions %}.'
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automating-migration-with-github-actions-importer
|
||||
- /actions/migrating-to-github-actions/automated-migrations/automating-migration-with-github-actions-importer
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
@@ -11,6 +11,8 @@ topics:
|
||||
- CI
|
||||
- CD
|
||||
shortTitle: Extending GitHub Actions Importer
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automated-migrations/extending-github-actions-importer-with-custom-transformers
|
||||
---
|
||||
|
||||
[Legal notice](#legal-notice)
|
||||
@@ -17,5 +17,7 @@ children:
|
||||
- /migrating-from-gitlab-with-github-actions-importer
|
||||
- /migrating-from-jenkins-with-github-actions-importer
|
||||
- /migrating-from-travis-ci-with-github-actions-importer
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automated-migrations
|
||||
---
|
||||
|
||||
@@ -11,6 +11,8 @@ topics:
|
||||
- CI
|
||||
- CD
|
||||
shortTitle: Azure DevOps migration
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-azure-devops-with-github-actions-importer
|
||||
---
|
||||
|
||||
[Legal notice](#legal-notice)
|
||||
@@ -11,6 +11,8 @@ topics:
|
||||
- CI
|
||||
- CD
|
||||
shortTitle: Bamboo migration
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-bamboo-with-github-actions-importer
|
||||
---
|
||||
|
||||
[Legal notice](#legal-notice)
|
||||
@@ -11,6 +11,8 @@ topics:
|
||||
- CI
|
||||
- CD
|
||||
shortTitle: Bitbucket Pipelines migration
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-bitbucket-pipelines-with-github-actions-importer
|
||||
---
|
||||
|
||||
[Legal notice](#legal-notice)
|
||||
@@ -11,6 +11,8 @@ topics:
|
||||
- CI
|
||||
- CD
|
||||
shortTitle: CircleCI migration
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-circleci-with-github-actions-importer
|
||||
---
|
||||
|
||||
[Legal notice](#legal-notice)
|
||||
@@ -11,6 +11,8 @@ topics:
|
||||
- CI
|
||||
- CD
|
||||
shortTitle: GitLab migration
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-gitlab-with-github-actions-importer
|
||||
---
|
||||
|
||||
[Legal notice](#legal-notice)
|
||||
@@ -11,6 +11,8 @@ topics:
|
||||
- CI
|
||||
- CD
|
||||
shortTitle: Jenkins migration
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-jenkins-with-github-actions-importer
|
||||
---
|
||||
|
||||
[Legal notice](#legal-notice)
|
||||
@@ -11,6 +11,8 @@ topics:
|
||||
- CI
|
||||
- CD
|
||||
shortTitle: Travis CI migration
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-travis-ci-with-github-actions-importer
|
||||
---
|
||||
|
||||
[Legal notice](#legal-notice)
|
||||
@@ -10,6 +10,8 @@ topics:
|
||||
- Migration
|
||||
- CI
|
||||
- CD
|
||||
redirect_from:
|
||||
- /actions/migrating-to-github-actions/automated-migrations/supplemental-arguments-and-settings
|
||||
---
|
||||
|
||||
[Legal notice](#legal-notice)
|
||||
@@ -1,5 +1,6 @@
|
||||
---
|
||||
title: Avoiding duplication
|
||||
shortTitle: Avoid duplication
|
||||
intro: You can use reusable workflows or composite actions to avoid duplicating the content of workflows.
|
||||
versions:
|
||||
fpt: '*'
|
||||
@@ -8,6 +9,8 @@ versions:
|
||||
type: how_to
|
||||
topics:
|
||||
- Workflows
|
||||
redirect_from:
|
||||
- /actions/using-workflows/avoiding-duplication
|
||||
---
|
||||
|
||||
## About reusable workflows and composite actions
|
||||
@@ -7,6 +7,7 @@ redirect_from:
|
||||
- /actions/automating-your-workflow-with-github-actions/about-actions
|
||||
- /actions/building-actions/about-actions
|
||||
- /actions/creating-actions/about-actions
|
||||
- /actions/creating-actions/about-custom-actions
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -4,6 +4,7 @@ shortTitle: Create a composite action
|
||||
intro: 'In this guide, you''ll learn how to build a composite action.'
|
||||
redirect_from:
|
||||
- /actions/creating-actions/creating-a-composite-run-steps-action
|
||||
- /actions/creating-actions/creating-a-composite-action
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -7,6 +7,7 @@ redirect_from:
|
||||
- /github/automating-your-workflow-with-github-actions/creating-a-docker-container-action
|
||||
- /actions/automating-your-workflow-with-github-actions/creating-a-docker-container-action
|
||||
- /actions/building-actions/creating-a-docker-container-action
|
||||
- /actions/creating-actions/creating-a-docker-container-action
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -7,6 +7,7 @@ redirect_from:
|
||||
- /github/automating-your-workflow-with-github-actions/creating-a-javascript-action
|
||||
- /actions/automating-your-workflow-with-github-actions/creating-a-javascript-action
|
||||
- /actions/building-actions/creating-a-javascript-action
|
||||
- /actions/creating-actions/creating-a-javascript-action
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -2,7 +2,8 @@
|
||||
title: Developing a third party CLI action
|
||||
shortTitle: CLI setup action
|
||||
intro: 'Learn how to develop an action to set up a CLI on {% data variables.product.prodname_actions %} runners.'
|
||||
redirect_from: []
|
||||
redirect_from:
|
||||
- /actions/creating-actions/developing-a-third-party-cli-action
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
@@ -4,6 +4,7 @@ shortTitle: Dockerfile support
|
||||
intro: 'When creating a `Dockerfile` for a Docker container action, you should be aware of how some Docker instructions interact with GitHub Actions and an action''s metadata file.'
|
||||
redirect_from:
|
||||
- /actions/building-actions/dockerfile-support-for-github-actions
|
||||
- /actions/creating-actions/dockerfile-support-for-github-actions
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -1,12 +1,7 @@
|
||||
---
|
||||
title: Creating actions
|
||||
shortTitle: Create actions
|
||||
intro: 'You can create your own actions, use and customize actions shared by the {% data variables.product.prodname_dotcom %} community, or write and share the actions you build.'
|
||||
redirect_from:
|
||||
- /articles/building-actions
|
||||
- /github/automating-your-workflow-with-github-actions/building-actions
|
||||
- /actions/automating-your-workflow-with-github-actions/building-actions
|
||||
- /actions/building-actions
|
||||
- /articles/creating-a-github-action
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -19,11 +14,9 @@ children:
|
||||
- /metadata-syntax-for-github-actions
|
||||
- /dockerfile-support-for-github-actions
|
||||
- /setting-exit-codes-for-actions
|
||||
- /publishing-actions-in-github-marketplace
|
||||
- /sharing-actions-and-workflows-from-your-private-repository
|
||||
- /sharing-actions-and-workflows-with-your-enterprise
|
||||
- /sharing-actions-and-workflows-with-your-organization
|
||||
- /releasing-and-maintaining-actions
|
||||
- /publishing-actions-in-github-marketplace
|
||||
- /developing-a-third-party-cli-action
|
||||
---
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
@@ -7,6 +7,7 @@ redirect_from:
|
||||
- /github/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions
|
||||
- /actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions
|
||||
- /actions/building-actions/metadata-syntax-for-github-actions
|
||||
- /actions/creating-actions/metadata-syntax-for-github-actions
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -5,6 +5,7 @@ redirect_from:
|
||||
- /github/automating-your-workflow-with-github-actions/publishing-actions-in-github-marketplace
|
||||
- /actions/automating-your-workflow-with-github-actions/publishing-actions-in-github-marketplace
|
||||
- /actions/building-actions/publishing-actions-in-github-marketplace
|
||||
- /actions/creating-actions/publishing-actions-in-github-marketplace
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
@@ -11,6 +11,8 @@ versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
redirect_from:
|
||||
- /actions/creating-actions/releasing-and-maintaining-actions
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
@@ -4,6 +4,7 @@ shortTitle: Set exit codes
|
||||
intro: 'You can use exit codes to set the status of an action. {% data variables.product.prodname_dotcom %} displays statuses to indicate passing or failing actions.'
|
||||
redirect_from:
|
||||
- /actions/building-actions/setting-exit-codes-for-actions
|
||||
- /actions/creating-actions/setting-exit-codes-for-actions
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -1,11 +1,12 @@
|
||||
---
|
||||
title: Creating starter workflows for your organization
|
||||
shortTitle: Create starter workflows
|
||||
intro: Learn how you can create starter workflows to help people in your team add new workflows more easily.
|
||||
title: Creating workflow templates for your organization
|
||||
shortTitle: Create workflow templates
|
||||
intro: Learn how you can create workflow templates to help people in your team add new workflows more easily.
|
||||
redirect_from:
|
||||
- /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization
|
||||
- /actions/learn-github-actions/creating-workflow-templates
|
||||
- /actions/learn-github-actions/creating-starter-workflows-for-your-organization
|
||||
- /actions/using-workflows/creating-starter-workflows-for-your-organization
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -25,23 +26,23 @@ topics:
|
||||
{% data reusables.actions.starter-workflow-categories %}
|
||||
|
||||
> [!NOTE]
|
||||
> Because starter workflows require a public `.github` repository, they are not available for {% data variables.product.prodname_emus %}.
|
||||
> Because workflow templates require a public `.github` repository, they are not available for {% data variables.product.prodname_emus %}.
|
||||
|
||||
## Creating a starter workflow
|
||||
## Creating a workflow template
|
||||
|
||||
Starter workflows can be created by users with write access to the organization's _public_ `.github` repository. These can then be used by organization members who have permission to create workflows.
|
||||
Workflow templates can be created by users with write access to the organization's _public_ `.github` repository. These can then be used by organization members who have permission to create workflows.
|
||||
|
||||
{% ifversion fpt %}
|
||||
Starter workflows created by users can only be used to create workflows in public repositories. Organizations using {% data variables.product.prodname_ghe_cloud %} can also use starter workflows to create workflows in private repositories. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/using-workflows/creating-starter-workflows-for-your-organization).
|
||||
Workflow templates created by users can only be used to create workflows in public repositories. Organizations using {% data variables.product.prodname_ghe_cloud %} can also use workflow templates to create workflows in private repositories. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/using-workflows/creating-starter-workflows-for-your-organization).
|
||||
{% endif %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** To avoid duplication among starter workflows you can call reusable workflows from within a workflow. This can help make your workflows easier to maintain. For more information, see "[AUTOTITLE](/actions/using-workflows/reusing-workflows)."
|
||||
**Note:** To avoid duplication among workflow templates you can call reusable workflows from within a workflow. This can help make your workflows easier to maintain. For more information, see "[AUTOTITLE](/actions/using-workflows/reusing-workflows)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
This procedure demonstrates how to create a starter workflow and metadata file. The metadata file describes how the starter workflows will be presented to users when they are creating a new workflow.
|
||||
This procedure demonstrates how to create a workflow template and metadata file. The metadata file describes how the workflow templates will be presented to users when they are creating a new workflow.
|
||||
|
||||
1. If it doesn't already exist, create a new _public_ repository named `.github` in your organization.
|
||||
1. Create a directory named `workflow-templates`.
|
||||
26
content/actions/sharing-automations/index.md
Normal file
26
content/actions/sharing-automations/index.md
Normal file
@@ -0,0 +1,26 @@
|
||||
---
|
||||
title: Sharing automations
|
||||
shortTitle: Share automations
|
||||
intro: 'Create modular automations that you can share and reuse across {% data variables.product.prodname_actions %} workflows.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghec: '*'
|
||||
redirect_from:
|
||||
- /actions/creating-actions
|
||||
- /github/automating-your-workflow-with-github-actions/building-actions
|
||||
- /actions/automating-your-workflow-with-github-actions/building-actions
|
||||
- /actions/building-actions
|
||||
- /articles/creating-a-github-action
|
||||
children:
|
||||
- /avoiding-duplication
|
||||
- /creating-actions
|
||||
- /reusing-workflows
|
||||
- /creating-workflow-templates-for-your-organization
|
||||
- /sharing-actions-and-workflows-from-your-private-repository
|
||||
- /sharing-actions-and-workflows-with-your-organization
|
||||
- /sharing-actions-and-workflows-with-your-enterprise
|
||||
- /required-workflows
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
@@ -4,10 +4,12 @@ shortTitle: Required workflows
|
||||
intro: You can specify which workflows will run as required status checks in all repositories or selected repositories in your organization.
|
||||
versions:
|
||||
feature: required-workflows-deprecation
|
||||
permissions: Because {% data variables.product.company_short %} no longer supports this feature, this article is only relevant if you are already using required workflows for {% data variables.product.prodname_actions %}.
|
||||
permissions: 'Because {% data variables.product.company_short %} no longer supports this feature, this article is only relevant if you are already using required workflows for {% data variables.product.prodname_actions %}.'
|
||||
type: how_to
|
||||
topics:
|
||||
- Workflows
|
||||
redirect_from:
|
||||
- /actions/using-workflows/required-workflows
|
||||
---
|
||||
|
||||
{% data reusables.actions.workflows.required-workflow-beta %}
|
||||
@@ -4,6 +4,7 @@ shortTitle: Reuse workflows
|
||||
intro: Learn how to avoid duplication when creating a workflow by reusing existing workflows.
|
||||
redirect_from:
|
||||
- /actions/learn-github-actions/reusing-workflows
|
||||
- /actions/using-workflows/reusing-workflows
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
@@ -8,6 +8,8 @@ topics:
|
||||
- Actions
|
||||
- Action development
|
||||
shortTitle: Share from your private repository
|
||||
redirect_from:
|
||||
- /actions/creating-actions/sharing-actions-and-workflows-from-your-private-repository
|
||||
---
|
||||
|
||||
## About {% data variables.product.prodname_actions %} access to private repositories
|
||||
@@ -8,6 +8,8 @@ topics:
|
||||
- Actions
|
||||
- Action development
|
||||
shortTitle: Share with your enterprise
|
||||
redirect_from:
|
||||
- /actions/creating-actions/sharing-actions-and-workflows-with-your-enterprise
|
||||
---
|
||||
|
||||
## About {% data variables.product.prodname_actions %} access to internal {% ifversion private-actions %}and private {% endif %}repositories
|
||||
@@ -8,6 +8,8 @@ topics:
|
||||
- Actions
|
||||
- Action development
|
||||
shortTitle: Share with your organization
|
||||
redirect_from:
|
||||
- /actions/creating-actions/sharing-actions-and-workflows-with-your-organization
|
||||
---
|
||||
|
||||
## About {% data variables.product.prodname_actions %} access to private {% ifversion internal-actions %} or internal {% endif %}repositories
|
||||
@@ -7,8 +7,8 @@ versions:
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
children:
|
||||
- /about-github-hosted-runners
|
||||
- /about-larger-runners
|
||||
- /using-github-hosted-runners
|
||||
- /using-larger-runners
|
||||
- /connecting-to-a-private-network
|
||||
---
|
||||
|
||||
|
||||
@@ -10,6 +10,7 @@ redirect_from:
|
||||
- /actions/reference/virtual-environments-for-github-hosted-runners
|
||||
- /actions/reference/software-installed-on-github-hosted-runners
|
||||
- /actions/reference/specifications-for-github-hosted-runners
|
||||
- /actions/using-github-hosted-runners/about-github-hosted-runners/about-github-hosted-runners
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -10,6 +10,7 @@ topics:
|
||||
shortTitle: Customize runners
|
||||
redirect_from:
|
||||
- /actions/using-github-hosted-runners/customizing-github-hosted-runners
|
||||
- /actions/using-github-hosted-runners/about-github-hosted-runners/customizing-github-hosted-runners
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
@@ -10,6 +10,8 @@ children:
|
||||
- /about-github-hosted-runners
|
||||
- /monitoring-your-current-jobs
|
||||
- /customizing-github-hosted-runners
|
||||
redirect_from:
|
||||
- /actions/using-github-hosted-runners/about-github-hosted-runners
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
@@ -6,6 +6,7 @@ versions:
|
||||
feature: github-runner-dashboard
|
||||
redirect_from:
|
||||
- /actions/using-github-hosted-runners/monitoring-your-current-jobs
|
||||
- /actions/using-github-hosted-runners/about-github-hosted-runners/monitoring-your-current-jobs
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
@@ -6,7 +6,7 @@ permissions: '{% data reusables.actions.larger-runner-permissions %}'
|
||||
versions:
|
||||
feature: actions-hosted-runners
|
||||
redirect_from:
|
||||
- /actions/using-github-hosted-runners/using-larger-runners
|
||||
- /actions/using-github-hosted-runners/about-larger-runners/about-larger-runners
|
||||
---
|
||||
|
||||
## Overview of {% data variables.actions.hosted_runners %}
|
||||
@@ -8,6 +8,7 @@ versions:
|
||||
type: tutorial
|
||||
redirect_from:
|
||||
- /actions/using-github-hosted-runners/controlling-access-to-larger-runners
|
||||
- /actions/using-github-hosted-runners/about-larger-runners/controlling-access-to-larger-runners
|
||||
---
|
||||
|
||||
{% note %}
|
||||
@@ -9,6 +9,8 @@ children:
|
||||
- /managing-larger-runners
|
||||
- /controlling-access-to-larger-runners
|
||||
- /running-jobs-on-larger-runners
|
||||
redirect_from:
|
||||
- /actions/using-github-hosted-runners/about-larger-runners
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
@@ -7,6 +7,7 @@ versions:
|
||||
feature: actions-hosted-runners
|
||||
redirect_from:
|
||||
- /actions/using-github-hosted-runners/managing-larger-runners
|
||||
- /actions/using-github-hosted-runners/about-larger-runners/managing-larger-runners
|
||||
---
|
||||
|
||||
{% note %}
|
||||
@@ -8,6 +8,7 @@ versions:
|
||||
feature: actions-hosted-runners
|
||||
redirect_from:
|
||||
- /actions/using-github-hosted-runners/running-jobs-on-larger-runners
|
||||
- /actions/using-github-hosted-runners/about-larger-runners/running-jobs-on-larger-runners
|
||||
---
|
||||
|
||||
## Running jobs on your runner
|
||||
@@ -1,29 +0,0 @@
|
||||
---
|
||||
title: Using workflows
|
||||
shortTitle: Using workflows
|
||||
intro: 'Creating and managing {% data variables.product.prodname_actions %} workflows.'
|
||||
redirect_from:
|
||||
- /actions/configuring-and-managing-workflows/configuring-a-workflow
|
||||
- /articles/creating-a-workflow-with-github-actions
|
||||
- /articles/configuring-a-workflow
|
||||
- /github/automating-your-workflow-with-github-actions/configuring-a-workflow
|
||||
- /actions/automating-your-workflow-with-github-actions/configuring-a-workflow
|
||||
- /actions/creating-workflows/workflow-configuration-options
|
||||
- /articles/configuring-workflows
|
||||
- /github/automating-your-workflow-with-github-actions/configuring-workflows
|
||||
- /actions/automating-your-workflow-with-github-actions/configuring-workflows
|
||||
- /actions/configuring-and-managing-workflows
|
||||
- /actions/workflows
|
||||
- /actions/advanced-guides
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghec: '*'
|
||||
children:
|
||||
- /about-workflows
|
||||
- /avoiding-duplication
|
||||
- /reusing-workflows
|
||||
- /required-workflows
|
||||
- /creating-starter-workflows-for-your-organization
|
||||
---
|
||||
|
||||
@@ -10,6 +10,7 @@ type: overview
|
||||
redirect_from:
|
||||
- /actions/learn-github-actions/managing-complex-workflows
|
||||
- /actions/using-workflows/advanced-workflow-features
|
||||
- /actions/using-workflows/about-workflows
|
||||
topics:
|
||||
- Workflows
|
||||
layout: inline
|
||||
@@ -4,12 +4,14 @@ shortTitle: Write workflows
|
||||
intro: '{% data variables.product.prodname_actions %} workflows can automate tasks throughout the software development lifecycle.'
|
||||
redirect_from:
|
||||
- /actions/learn-github-actions
|
||||
- /actions/using-workflows
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghec: '*'
|
||||
children:
|
||||
- /quickstart
|
||||
- /about-workflows
|
||||
- /using-starter-workflows
|
||||
- /choosing-when-your-workflow-runs
|
||||
- /choosing-where-your-workflow-runs
|
||||
|
||||
@@ -134,7 +134,7 @@ Jobs that run on Windows and macOS runners that {% data variables.product.prodna
|
||||
* {% data reusables.user-settings.context_switcher %}
|
||||
* {% data reusables.actions.larger-runner-permissions %}
|
||||
* {% data reusables.actions.about-larger-runners-billing %}
|
||||
* For {% data variables.actions.hosted_runner %}s, there is no additional cost for configurations that assign public static IP addresses to a {% data variables.actions.hosted_runner %}. For more information on {% data variables.actions.hosted_runner %}s, see "[AUTOTITLE](/actions/using-github-hosted-runners/using-larger-runners)."
|
||||
* For {% data variables.actions.hosted_runner %}s, there is no additional cost for configurations that assign public static IP addresses to a {% data variables.actions.hosted_runner %}. For more information on {% data variables.actions.hosted_runner %}s, see "[AUTOTITLE](/actions/using-github-hosted-runners/using-larger-runners/about-larger-runners)."
|
||||
* Included minutes cannot be used for {% data variables.actions.hosted_runner %}s.
|
||||
* The {% data variables.actions.hosted_runner %}s are not free for public repositories.
|
||||
|
||||
|
||||
@@ -88,22 +88,22 @@ The message body is a JSON array that contains one or more objects, with each ob
|
||||
|
||||
The list of valid values for `source` are:
|
||||
|
||||
* content
|
||||
* commit
|
||||
* pull_request_title
|
||||
* pull_request_description
|
||||
* pull_request_comment
|
||||
* issue_title
|
||||
* issue_description
|
||||
* issue_comment
|
||||
* discussion_title
|
||||
* discussion_body
|
||||
* discussion_comment
|
||||
* commit_comment
|
||||
* gist_content
|
||||
* gist_comment
|
||||
* npm
|
||||
* unknown
|
||||
* Content
|
||||
* Commit
|
||||
* Pull_request_title
|
||||
* Pull_request_description
|
||||
* Pull_request_comment
|
||||
* Issue_title
|
||||
* Issue_description
|
||||
* Issue_comment
|
||||
* Discussion_title
|
||||
* Discussion_body
|
||||
* Discussion_comment
|
||||
* Commit_comment
|
||||
* Gist_content
|
||||
* Gist_comment
|
||||
* Npm
|
||||
* Unknown
|
||||
|
||||
### Implement signature verification in your secret alert service
|
||||
|
||||
|
||||
@@ -79,8 +79,8 @@ Code often needs to communicate with other systems over a network, and requires
|
||||
|
||||
{% ifversion fpt %}
|
||||
You can enable and configure additional scanning that will alert you about accidentally leaked secrets on {% data variables.product.product_name %} if you own:
|
||||
* public repositories on {% data variables.product.prodname_dotcom_the_website %}.
|
||||
* an organization using {% data variables.product.prodname_ghe_cloud %} with a license for {% data variables.product.prodname_GH_advanced_security %}. {% data variables.product.prodname_secret_scanning_caps %} will also analyze your private repositories.
|
||||
* Public repositories on {% data variables.product.prodname_dotcom_the_website %}.
|
||||
* An organization using {% data variables.product.prodname_ghe_cloud %} with a license for {% data variables.product.prodname_GH_advanced_security %}. {% data variables.product.prodname_secret_scanning_caps %} will also analyze your private repositories.
|
||||
|
||||
{% elsif secret-scanning-user-owned-repos %}
|
||||
If your organization uses {% data variables.product.prodname_GH_advanced_security %}, you can enable {% data variables.secret-scanning.user_alerts %} on any repository owned by the organization, including private repositories. {% data reusables.secret-scanning.secret-scanning-user-owned-repos-beta %}
|
||||
|
||||
@@ -411,7 +411,7 @@ Use alt text to express the core idea of the image, without duplicating the webp
|
||||
|
||||
> Diagram showing a five-step process by which a {% data variables.product.prodname_actions %} runner can be automatically added to named classes of runners and then requested by specific jobs.
|
||||
|
||||
For example, see [accompanying explanation of this diagram in the Actions documentation](/free-pro-team@latest/actions/using-github-hosted-runners/using-larger-runners#architectural-overview-of-larger-runners).
|
||||
For example, see [accompanying explanation of this diagram in the Actions documentation](/free-pro-team@latest/actions/using-github-hosted-runners/using-larger-runners/about-larger-runners#architectural-overview-of-larger-runners).
|
||||
|
||||
#### Alt text for images of command-line interfaces
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ featuredLinks:
|
||||
startHere:
|
||||
- /migrations/importing-source-code/using-github-importer/about-github-importer
|
||||
- /migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer
|
||||
- /actions/migrating-to-github-actions/automated-migrations/automating-migration-with-github-actions-importer#about-github-actions-importer
|
||||
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/automating-migration-with-github-actions-importer#about-github-actions-importer
|
||||
popular:
|
||||
- /migrations/importing-source-code/using-github-importer/importing-a-repository-with-github-importer
|
||||
- /migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github
|
||||
|
||||
@@ -5,10 +5,12 @@ getting_started:
|
||||
by creating your first workflow.
|
||||
guides:
|
||||
- /actions/about-github-actions/understanding-github-actions
|
||||
- /actions/writing-workflows/choosing-what-your-workflow-does/finding-and-customizing-actions
|
||||
- /actions/using-workflows/about-workflows
|
||||
- /actions/using-workflows/reusing-workflows
|
||||
- /actions/security-for-github-actions/security-guides/security-hardening-for-github-actions
|
||||
- >-
|
||||
/actions/writing-workflows/choosing-what-your-workflow-does/finding-and-customizing-actions
|
||||
- /actions/writing-workflows/about-workflows
|
||||
- /actions/sharing-automations/reusing-workflows
|
||||
- >-
|
||||
/actions/security-for-github-actions/security-guides/security-hardening-for-github-actions
|
||||
adopting_github_actions_for_your_enterprise_ghec:
|
||||
title: Adopt GitHub Actions for your enterprise
|
||||
description: >-
|
||||
@@ -26,7 +28,8 @@ adopting_github_actions_for_your_enterprise_ghec:
|
||||
/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions
|
||||
- >-
|
||||
/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud
|
||||
- /actions/security-for-github-actions/security-guides/security-hardening-for-github-actions
|
||||
- >-
|
||||
/actions/security-for-github-actions/security-guides/security-hardening-for-github-actions
|
||||
- >-
|
||||
/billing/managing-billing-for-github-actions/about-billing-for-github-actions
|
||||
adopting_github_actions_for_your_enterprise_ghes:
|
||||
@@ -50,7 +53,8 @@ adopting_github_actions_for_your_enterprise_ghes:
|
||||
/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server
|
||||
- >-
|
||||
/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise
|
||||
- /actions/security-for-github-actions/security-guides/security-hardening-for-github-actions
|
||||
- >-
|
||||
/actions/security-for-github-actions/security-guides/security-hardening-for-github-actions
|
||||
- >-
|
||||
/billing/managing-billing-for-github-actions/about-billing-for-github-actions
|
||||
hosting_your_own_runners:
|
||||
@@ -82,11 +86,16 @@ create_actions:
|
||||
your project? Learn how to build shareable actions and publish them to
|
||||
GitHub Marketplace.
|
||||
guides:
|
||||
- /actions/creating-actions/about-custom-actions
|
||||
- /actions/creating-actions/creating-a-docker-container-action
|
||||
- /actions/creating-actions/creating-a-javascript-action
|
||||
- /actions/creating-actions/creating-a-composite-action
|
||||
- /actions/creating-actions/metadata-syntax-for-github-actions
|
||||
- /actions/creating-actions/dockerfile-support-for-github-actions
|
||||
- /actions/creating-actions/setting-exit-codes-for-actions
|
||||
- /actions/creating-actions/publishing-actions-in-github-marketplace
|
||||
- /actions/sharing-automations/creating-actions/about-custom-actions
|
||||
- >-
|
||||
/actions/sharing-automations/creating-actions/creating-a-docker-container-action
|
||||
- /actions/sharing-automations/creating-actions/creating-a-javascript-action
|
||||
- /actions/sharing-automations/creating-actions/creating-a-composite-action
|
||||
- >-
|
||||
/actions/sharing-automations/creating-actions/metadata-syntax-for-github-actions
|
||||
- >-
|
||||
/actions/sharing-automations/creating-actions/dockerfile-support-for-github-actions
|
||||
- >-
|
||||
/actions/sharing-automations/creating-actions/setting-exit-codes-for-actions
|
||||
- >-
|
||||
/actions/sharing-automations/creating-actions/publishing-actions-in-github-marketplace
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{% warning %}
|
||||
|
||||
**Warning**: If you use an IP allow list and would also like to use {% data variables.product.prodname_actions %}, you must use self-hosted runners{% ifversion actions-hosted-runners %} or {% data variables.product.prodname_dotcom %}-hosted larger runners with static IP address ranges{% endif %}. When using [Azure private networking](/admin/configuration/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise), IPs from your Azure subnet must be used. To reduce the number of required IPs, we recommend creating a load balancer to provide a single IP range for the GitHub allow list. For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners)" {% ifversion actions-hosted-runners %} or "[AUTOTITLE](/actions/using-github-hosted-runners/using-larger-runners)"{% endif %}.
|
||||
**Warning**: If you use an IP allow list and would also like to use {% data variables.product.prodname_actions %}, you must use self-hosted runners{% ifversion actions-hosted-runners %} or {% data variables.product.prodname_dotcom %}-hosted larger runners with static IP address ranges{% endif %}. When using [Azure private networking](/admin/configuration/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise), IPs from your Azure subnet must be used. To reduce the number of required IPs, we recommend creating a load balancer to provide a single IP range for the GitHub allow list. For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners)" {% ifversion actions-hosted-runners %} or "[AUTOTITLE](/actions/using-github-hosted-runners/using-larger-runners/about-larger-runners)"{% endif %}.
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@ You can use `runs-on` to target runner groups, so that the job will execute on a
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
Runner groups can only have [{% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/using-larger-runners) or [self-hosted runners](/actions/hosting-your-own-runners) as members.
|
||||
Runner groups can only have [{% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/using-larger-runners/about-larger-runners) or [self-hosted runners](/actions/hosting-your-own-runners) as members.
|
||||
|
||||
{% endif %}
|
||||
|
||||
|
||||
@@ -132,7 +132,7 @@ For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managin
|
||||
You can use `runs-on` to target runner groups, so that the job will execute on any runner that is a member of that group. For more granular control, you can also combine runner groups with labels.
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
Runner groups can only have [{% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/using-larger-runners) or [self-hosted runners](/actions/hosting-your-own-runners) as members.
|
||||
Runner groups can only have [{% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/using-larger-runners/about-larger-runners) or [self-hosted runners](/actions/hosting-your-own-runners) as members.
|
||||
{% endif %}
|
||||
|
||||
#### Example: Using groups to control where jobs are run
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
{% data variables.product.prodname_dotcom %} provides ready-to-use starter workflows for the following high level categories:
|
||||
{% data variables.product.prodname_dotcom %} provides ready-to-use workflow templates for the following high level categories:
|
||||
* **Deployment (CD)**. For more information, see "[AUTOTITLE](/actions/deployment/about-deployments/about-continuous-deployment)."
|
||||
{% ifversion fpt or ghec %}- **Security**. For more information, see "[AUTOTITLE](/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/configuring-advanced-setup-for-code-scanning#configuring-code-scanning-using-third-party-actions)."{% endif %}
|
||||
* **Continuous Integration (CI)**. For more information, see "[AUTOTITLE](/actions/automating-builds-and-tests/about-continuous-integration)."
|
||||
* **Automation**. Automation starter workflows offer solutions for automating workflows, such as triaging pull requests and applying a label based on the paths that are modified in the pull request, or greeting users who are first time contributors to the repository.
|
||||
* **Automation**. Automation workflow templates offer solutions for automating workflows, such as triaging pull requests and applying a label based on the paths that are modified in the pull request, or greeting users who are first time contributors to the repository.
|
||||
|
||||
@@ -1 +1 @@
|
||||
Starter workflows allow everyone in your organization who has permission to create workflows to do so more quickly and easily. When you create a new workflow, you can choose a starter workflow and some or all of the work of writing the workflow will be done for you. You can use starter workflows as a starting place to build your custom workflow or use them as-is. This not only saves time, it promotes consistency and best practice across your organization.
|
||||
Workflow templates allow everyone in your organization who has permission to create workflows to do so more quickly and easily. When you create a new workflow, you can choose a workflow template and some or all of the work of writing the workflow will be done for you. You can use workflow templates as a starting place to build your custom workflow or use them as-is. This not only saves time, it promotes consistency and best practice across your organization.
|
||||
|
||||
Reference in New Issue
Block a user