1
0
mirror of synced 2025-12-19 18:10:59 -05:00

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
2024-08-12 09:30:54 -07:00
committed by GitHub
parent c81a57835f
commit b0b1600b44
59 changed files with 161 additions and 106 deletions

View File

@@ -83,7 +83,7 @@ For more information, see "[AUTOTITLE](/actions/creating-actions)."
### Runners ### 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 %} {% data reusables.actions.workflow-basic-example-and-explanation %}

View File

@@ -16,7 +16,7 @@ learningTracks:
includeGuides: includeGuides:
- /actions/writing-workflows/quickstart - /actions/writing-workflows/quickstart
- /actions/about-github-actions/understanding-github-actions - /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/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-python
- /actions/use-cases-and-examples/building-and-testing/building-and-testing-nodejs - /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/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-amazon-elastic-container-service
- /actions/use-cases-and-examples/deploying/deploying-to-google-kubernetes-engine - /actions/use-cases-and-examples/deploying/deploying-to-google-kubernetes-engine
- /actions/creating-actions/about-custom-actions - /actions/sharing-automations/creating-actions/about-custom-actions
- /actions/creating-actions/creating-a-javascript-action - /actions/sharing-automations/creating-actions/creating-a-javascript-action
- /actions/creating-actions/creating-a-composite-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-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-circleci-to-github-actions
- /actions/migrating-to-github-actions/manually-migrating-to-github-actions/migrating-from-gitlab-cicd-to-github-actions - /actions/migrating-to-github-actions/manually-migrating-to-github-actions/migrating-from-gitlab-cicd-to-github-actions

View File

@@ -9,8 +9,8 @@ versions:
topics: topics:
- Actions Runner Controller - Actions Runner Controller
children: children:
- /quickstart-for-actions-runner-controller
- /about-actions-runner-controller - /about-actions-runner-controller
- /quickstart-for-actions-runner-controller
- /authenticating-to-the-github-api - /authenticating-to-the-github-api
- /deploying-runner-scale-sets-with-actions-runner-controller - /deploying-runner-scale-sets-with-actions-runner-controller
- /using-actions-runner-controller-runners-in-a-workflow - /using-actions-runner-controller-runners-in-a-workflow

View File

@@ -39,16 +39,14 @@ versions:
children: children:
- /about-github-actions - /about-github-actions
- /writing-workflows - /writing-workflows
- /using-workflows
- /managing-workflow-runs-and-deployments - /managing-workflow-runs-and-deployments
- /migrating-to-github-actions - /sharing-automations
- /monitoring-and-troubleshooting-workflows - /monitoring-and-troubleshooting-workflows
- /using-github-hosted-runners - /using-github-hosted-runners
- /hosting-your-own-runners - /hosting-your-own-runners
- /security-for-github-actions - /security-for-github-actions
- /use-cases-and-examples - /use-cases-and-examples
- /creating-actions - /migrating-to-github-actions
- /administering-github-actions - /administering-github-actions
- /guides - /guides
--- ---

View File

@@ -9,7 +9,7 @@ versions:
redirect_from: redirect_from:
- /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax
children: children:
- /automated-migrations - /using-github-actions-importer-to-automate-migrations
- /manually-migrating-to-github-actions - /manually-migrating-to-github-actions
--- ---

View File

@@ -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 %}.' intro: 'Use {% data variables.product.prodname_actions_importer %} to plan and automate your migration to {% data variables.product.prodname_actions %}.'
redirect_from: redirect_from:
- /actions/migrating-to-github-actions/automating-migration-with-github-actions-importer - /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: versions:
fpt: '*' fpt: '*'
ghec: '*' ghec: '*'

View File

@@ -11,6 +11,8 @@ topics:
- CI - CI
- CD - CD
shortTitle: Extending GitHub Actions Importer 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) [Legal notice](#legal-notice)

View File

@@ -17,5 +17,7 @@ children:
- /migrating-from-gitlab-with-github-actions-importer - /migrating-from-gitlab-with-github-actions-importer
- /migrating-from-jenkins-with-github-actions-importer - /migrating-from-jenkins-with-github-actions-importer
- /migrating-from-travis-ci-with-github-actions-importer - /migrating-from-travis-ci-with-github-actions-importer
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations
--- ---

View File

@@ -11,6 +11,8 @@ topics:
- CI - CI
- CD - CD
shortTitle: Azure DevOps migration 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) [Legal notice](#legal-notice)

View File

@@ -11,6 +11,8 @@ topics:
- CI - CI
- CD - CD
shortTitle: Bamboo migration shortTitle: Bamboo migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-bamboo-with-github-actions-importer
--- ---
[Legal notice](#legal-notice) [Legal notice](#legal-notice)

View File

@@ -11,6 +11,8 @@ topics:
- CI - CI
- CD - CD
shortTitle: Bitbucket Pipelines migration 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) [Legal notice](#legal-notice)

View File

@@ -11,6 +11,8 @@ topics:
- CI - CI
- CD - CD
shortTitle: CircleCI migration shortTitle: CircleCI migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-circleci-with-github-actions-importer
--- ---
[Legal notice](#legal-notice) [Legal notice](#legal-notice)

View File

@@ -11,6 +11,8 @@ topics:
- CI - CI
- CD - CD
shortTitle: GitLab migration shortTitle: GitLab migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-gitlab-with-github-actions-importer
--- ---
[Legal notice](#legal-notice) [Legal notice](#legal-notice)

View File

@@ -11,6 +11,8 @@ topics:
- CI - CI
- CD - CD
shortTitle: Jenkins migration shortTitle: Jenkins migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-jenkins-with-github-actions-importer
--- ---
[Legal notice](#legal-notice) [Legal notice](#legal-notice)

View File

@@ -11,6 +11,8 @@ topics:
- CI - CI
- CD - CD
shortTitle: Travis CI migration 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) [Legal notice](#legal-notice)

View File

@@ -10,6 +10,8 @@ topics:
- Migration - Migration
- CI - CI
- CD - CD
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/supplemental-arguments-and-settings
--- ---
[Legal notice](#legal-notice) [Legal notice](#legal-notice)

View File

@@ -1,5 +1,6 @@
--- ---
title: Avoiding duplication title: Avoiding duplication
shortTitle: Avoid duplication
intro: You can use reusable workflows or composite actions to avoid duplicating the content of workflows. intro: You can use reusable workflows or composite actions to avoid duplicating the content of workflows.
versions: versions:
fpt: '*' fpt: '*'
@@ -8,6 +9,8 @@ versions:
type: how_to type: how_to
topics: topics:
- Workflows - Workflows
redirect_from:
- /actions/using-workflows/avoiding-duplication
--- ---
## About reusable workflows and composite actions ## About reusable workflows and composite actions

View File

@@ -7,6 +7,7 @@ redirect_from:
- /actions/automating-your-workflow-with-github-actions/about-actions - /actions/automating-your-workflow-with-github-actions/about-actions
- /actions/building-actions/about-actions - /actions/building-actions/about-actions
- /actions/creating-actions/about-actions - /actions/creating-actions/about-actions
- /actions/creating-actions/about-custom-actions
versions: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'

View File

@@ -4,6 +4,7 @@ shortTitle: Create a composite action
intro: 'In this guide, you''ll learn how to build a composite action.' intro: 'In this guide, you''ll learn how to build a composite action.'
redirect_from: redirect_from:
- /actions/creating-actions/creating-a-composite-run-steps-action - /actions/creating-actions/creating-a-composite-run-steps-action
- /actions/creating-actions/creating-a-composite-action
versions: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'

View File

@@ -7,6 +7,7 @@ redirect_from:
- /github/automating-your-workflow-with-github-actions/creating-a-docker-container-action - /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/automating-your-workflow-with-github-actions/creating-a-docker-container-action
- /actions/building-actions/creating-a-docker-container-action - /actions/building-actions/creating-a-docker-container-action
- /actions/creating-actions/creating-a-docker-container-action
versions: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'

View File

@@ -7,6 +7,7 @@ redirect_from:
- /github/automating-your-workflow-with-github-actions/creating-a-javascript-action - /github/automating-your-workflow-with-github-actions/creating-a-javascript-action
- /actions/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/building-actions/creating-a-javascript-action
- /actions/creating-actions/creating-a-javascript-action
versions: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'

View File

@@ -2,7 +2,8 @@
title: Developing a third party CLI action title: Developing a third party CLI action
shortTitle: CLI setup action shortTitle: CLI setup action
intro: 'Learn how to develop an action to set up a CLI on {% data variables.product.prodname_actions %} runners.' 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: versions:
fpt: '*' fpt: '*'
ghec: '*' ghec: '*'

View File

@@ -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.' 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: redirect_from:
- /actions/building-actions/dockerfile-support-for-github-actions - /actions/building-actions/dockerfile-support-for-github-actions
- /actions/creating-actions/dockerfile-support-for-github-actions
versions: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'

View File

@@ -1,12 +1,7 @@
--- ---
title: Creating actions 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.' 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: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'
@@ -19,11 +14,9 @@ children:
- /metadata-syntax-for-github-actions - /metadata-syntax-for-github-actions
- /dockerfile-support-for-github-actions - /dockerfile-support-for-github-actions
- /setting-exit-codes-for-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 - /releasing-and-maintaining-actions
- /publishing-actions-in-github-marketplace
- /developing-a-third-party-cli-action - /developing-a-third-party-cli-action
--- ---
{% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.enterprise-github-hosted-runners %}

View File

@@ -7,6 +7,7 @@ redirect_from:
- /github/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions - /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/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions
- /actions/building-actions/metadata-syntax-for-github-actions - /actions/building-actions/metadata-syntax-for-github-actions
- /actions/creating-actions/metadata-syntax-for-github-actions
versions: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'

View File

@@ -5,6 +5,7 @@ redirect_from:
- /github/automating-your-workflow-with-github-actions/publishing-actions-in-github-marketplace - /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/automating-your-workflow-with-github-actions/publishing-actions-in-github-marketplace
- /actions/building-actions/publishing-actions-in-github-marketplace - /actions/building-actions/publishing-actions-in-github-marketplace
- /actions/creating-actions/publishing-actions-in-github-marketplace
versions: versions:
fpt: '*' fpt: '*'
ghec: '*' ghec: '*'

View File

@@ -11,6 +11,8 @@ versions:
fpt: '*' fpt: '*'
ghec: '*' ghec: '*'
ghes: '*' ghes: '*'
redirect_from:
- /actions/creating-actions/releasing-and-maintaining-actions
--- ---
{% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.enterprise-github-hosted-runners %}

View File

@@ -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.' 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: redirect_from:
- /actions/building-actions/setting-exit-codes-for-actions - /actions/building-actions/setting-exit-codes-for-actions
- /actions/creating-actions/setting-exit-codes-for-actions
versions: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'

View File

@@ -1,11 +1,12 @@
--- ---
title: Creating starter workflows for your organization title: Creating workflow templates for your organization
shortTitle: Create starter workflows shortTitle: Create workflow templates
intro: Learn how you can create starter workflows to help people in your team add new workflows more easily. intro: Learn how you can create workflow templates to help people in your team add new workflows more easily.
redirect_from: redirect_from:
- /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization
- /actions/learn-github-actions/creating-workflow-templates - /actions/learn-github-actions/creating-workflow-templates
- /actions/learn-github-actions/creating-starter-workflows-for-your-organization - /actions/learn-github-actions/creating-starter-workflows-for-your-organization
- /actions/using-workflows/creating-starter-workflows-for-your-organization
versions: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'
@@ -25,23 +26,23 @@ topics:
{% data reusables.actions.starter-workflow-categories %} {% data reusables.actions.starter-workflow-categories %}
> [!NOTE] > [!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 %} {% 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 %} {% endif %}
{% note %} {% 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 %} {% 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. If it doesn't already exist, create a new _public_ repository named `.github` in your organization.
1. Create a directory named `workflow-templates`. 1. Create a directory named `workflow-templates`.

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

View File

@@ -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. intro: You can specify which workflows will run as required status checks in all repositories or selected repositories in your organization.
versions: versions:
feature: required-workflows-deprecation 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 type: how_to
topics: topics:
- Workflows - Workflows
redirect_from:
- /actions/using-workflows/required-workflows
--- ---
{% data reusables.actions.workflows.required-workflow-beta %} {% data reusables.actions.workflows.required-workflow-beta %}

View File

@@ -4,6 +4,7 @@ shortTitle: Reuse workflows
intro: Learn how to avoid duplication when creating a workflow by reusing existing workflows. intro: Learn how to avoid duplication when creating a workflow by reusing existing workflows.
redirect_from: redirect_from:
- /actions/learn-github-actions/reusing-workflows - /actions/learn-github-actions/reusing-workflows
- /actions/using-workflows/reusing-workflows
versions: versions:
fpt: '*' fpt: '*'
ghec: '*' ghec: '*'

View File

@@ -8,6 +8,8 @@ topics:
- Actions - Actions
- Action development - Action development
shortTitle: Share from your private repository 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 ## About {% data variables.product.prodname_actions %} access to private repositories

View File

@@ -8,6 +8,8 @@ topics:
- Actions - Actions
- Action development - Action development
shortTitle: Share with your enterprise 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 ## About {% data variables.product.prodname_actions %} access to internal {% ifversion private-actions %}and private {% endif %}repositories

View File

@@ -8,6 +8,8 @@ topics:
- Actions - Actions
- Action development - Action development
shortTitle: Share with your organization 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 ## About {% data variables.product.prodname_actions %} access to private {% ifversion internal-actions %} or internal {% endif %}repositories

View File

@@ -7,8 +7,8 @@ versions:
ghec: '*' ghec: '*'
ghes: '*' ghes: '*'
children: children:
- /about-github-hosted-runners - /using-github-hosted-runners
- /about-larger-runners - /using-larger-runners
- /connecting-to-a-private-network - /connecting-to-a-private-network
--- ---

View File

@@ -10,6 +10,7 @@ redirect_from:
- /actions/reference/virtual-environments-for-github-hosted-runners - /actions/reference/virtual-environments-for-github-hosted-runners
- /actions/reference/software-installed-on-github-hosted-runners - /actions/reference/software-installed-on-github-hosted-runners
- /actions/reference/specifications-for-github-hosted-runners - /actions/reference/specifications-for-github-hosted-runners
- /actions/using-github-hosted-runners/about-github-hosted-runners/about-github-hosted-runners
versions: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'

View File

@@ -10,6 +10,7 @@ topics:
shortTitle: Customize runners shortTitle: Customize runners
redirect_from: redirect_from:
- /actions/using-github-hosted-runners/customizing-github-hosted-runners - /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 %} {% data reusables.actions.enterprise-github-hosted-runners %}

View File

@@ -10,6 +10,8 @@ children:
- /about-github-hosted-runners - /about-github-hosted-runners
- /monitoring-your-current-jobs - /monitoring-your-current-jobs
- /customizing-github-hosted-runners - /customizing-github-hosted-runners
redirect_from:
- /actions/using-github-hosted-runners/about-github-hosted-runners
--- ---
{% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.enterprise-github-hosted-runners %}

View File

@@ -6,6 +6,7 @@ versions:
feature: github-runner-dashboard feature: github-runner-dashboard
redirect_from: redirect_from:
- /actions/using-github-hosted-runners/monitoring-your-current-jobs - /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 %} {% data reusables.actions.enterprise-github-hosted-runners %}

View File

@@ -6,7 +6,7 @@ permissions: '{% data reusables.actions.larger-runner-permissions %}'
versions: versions:
feature: actions-hosted-runners feature: actions-hosted-runners
redirect_from: 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 %} ## Overview of {% data variables.actions.hosted_runners %}

View File

@@ -8,6 +8,7 @@ versions:
type: tutorial type: tutorial
redirect_from: redirect_from:
- /actions/using-github-hosted-runners/controlling-access-to-larger-runners - /actions/using-github-hosted-runners/controlling-access-to-larger-runners
- /actions/using-github-hosted-runners/about-larger-runners/controlling-access-to-larger-runners
--- ---
{% note %} {% note %}

View File

@@ -9,6 +9,8 @@ children:
- /managing-larger-runners - /managing-larger-runners
- /controlling-access-to-larger-runners - /controlling-access-to-larger-runners
- /running-jobs-on-larger-runners - /running-jobs-on-larger-runners
redirect_from:
- /actions/using-github-hosted-runners/about-larger-runners
--- ---
{% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.enterprise-github-hosted-runners %}

View File

@@ -7,6 +7,7 @@ versions:
feature: actions-hosted-runners feature: actions-hosted-runners
redirect_from: redirect_from:
- /actions/using-github-hosted-runners/managing-larger-runners - /actions/using-github-hosted-runners/managing-larger-runners
- /actions/using-github-hosted-runners/about-larger-runners/managing-larger-runners
--- ---
{% note %} {% note %}

View File

@@ -8,6 +8,7 @@ versions:
feature: actions-hosted-runners feature: actions-hosted-runners
redirect_from: redirect_from:
- /actions/using-github-hosted-runners/running-jobs-on-larger-runners - /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 ## Running jobs on your runner

View File

@@ -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
---

View File

@@ -10,6 +10,7 @@ type: overview
redirect_from: redirect_from:
- /actions/learn-github-actions/managing-complex-workflows - /actions/learn-github-actions/managing-complex-workflows
- /actions/using-workflows/advanced-workflow-features - /actions/using-workflows/advanced-workflow-features
- /actions/using-workflows/about-workflows
topics: topics:
- Workflows - Workflows
layout: inline layout: inline

View File

@@ -4,12 +4,14 @@ shortTitle: Write workflows
intro: '{% data variables.product.prodname_actions %} workflows can automate tasks throughout the software development lifecycle.' intro: '{% data variables.product.prodname_actions %} workflows can automate tasks throughout the software development lifecycle.'
redirect_from: redirect_from:
- /actions/learn-github-actions - /actions/learn-github-actions
- /actions/using-workflows
versions: versions:
fpt: '*' fpt: '*'
ghes: '*' ghes: '*'
ghec: '*' ghec: '*'
children: children:
- /quickstart - /quickstart
- /about-workflows
- /using-starter-workflows - /using-starter-workflows
- /choosing-when-your-workflow-runs - /choosing-when-your-workflow-runs
- /choosing-where-your-workflow-runs - /choosing-where-your-workflow-runs

View File

@@ -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.user-settings.context_switcher %}
* {% data reusables.actions.larger-runner-permissions %} * {% data reusables.actions.larger-runner-permissions %}
* {% data reusables.actions.about-larger-runners-billing %} * {% 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. * 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. * The {% data variables.actions.hosted_runner %}s are not free for public repositories.

View File

@@ -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: The list of valid values for `source` are:
* content * Content
* commit * Commit
* pull_request_title * Pull_request_title
* pull_request_description * Pull_request_description
* pull_request_comment * Pull_request_comment
* issue_title * Issue_title
* issue_description * Issue_description
* issue_comment * Issue_comment
* discussion_title * Discussion_title
* discussion_body * Discussion_body
* discussion_comment * Discussion_comment
* commit_comment * Commit_comment
* gist_content * Gist_content
* gist_comment * Gist_comment
* npm * Npm
* unknown * Unknown
### Implement signature verification in your secret alert service ### Implement signature verification in your secret alert service

View File

@@ -79,8 +79,8 @@ Code often needs to communicate with other systems over a network, and requires
{% ifversion fpt %} {% 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: 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 %}. * 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. * 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 %} {% 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 %} 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 %}

View File

@@ -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. > 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 #### Alt text for images of command-line interfaces

View File

@@ -9,7 +9,7 @@ featuredLinks:
startHere: startHere:
- /migrations/importing-source-code/using-github-importer/about-github-importer - /migrations/importing-source-code/using-github-importer/about-github-importer
- /migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-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: popular:
- /migrations/importing-source-code/using-github-importer/importing-a-repository-with-github-importer - /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 - /migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github

View File

@@ -5,10 +5,12 @@ getting_started:
by creating your first workflow. by creating your first workflow.
guides: guides:
- /actions/about-github-actions/understanding-github-actions - /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/writing-workflows/choosing-what-your-workflow-does/finding-and-customizing-actions
- /actions/using-workflows/reusing-workflows - /actions/writing-workflows/about-workflows
- /actions/security-for-github-actions/security-guides/security-hardening-for-github-actions - /actions/sharing-automations/reusing-workflows
- >-
/actions/security-for-github-actions/security-guides/security-hardening-for-github-actions
adopting_github_actions_for_your_enterprise_ghec: adopting_github_actions_for_your_enterprise_ghec:
title: Adopt GitHub Actions for your enterprise title: Adopt GitHub Actions for your enterprise
description: >- 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/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 /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 /billing/managing-billing-for-github-actions/about-billing-for-github-actions
adopting_github_actions_for_your_enterprise_ghes: 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-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 /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 /billing/managing-billing-for-github-actions/about-billing-for-github-actions
hosting_your_own_runners: hosting_your_own_runners:
@@ -82,11 +86,16 @@ create_actions:
your project? Learn how to build shareable actions and publish them to your project? Learn how to build shareable actions and publish them to
GitHub Marketplace. GitHub Marketplace.
guides: guides:
- /actions/creating-actions/about-custom-actions - /actions/sharing-automations/creating-actions/about-custom-actions
- /actions/creating-actions/creating-a-docker-container-action - >-
- /actions/creating-actions/creating-a-javascript-action /actions/sharing-automations/creating-actions/creating-a-docker-container-action
- /actions/creating-actions/creating-a-composite-action - /actions/sharing-automations/creating-actions/creating-a-javascript-action
- /actions/creating-actions/metadata-syntax-for-github-actions - /actions/sharing-automations/creating-actions/creating-a-composite-action
- /actions/creating-actions/dockerfile-support-for-github-actions - >-
- /actions/creating-actions/setting-exit-codes-for-actions /actions/sharing-automations/creating-actions/metadata-syntax-for-github-actions
- /actions/creating-actions/publishing-actions-in-github-marketplace - >-
/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

View File

@@ -1,6 +1,6 @@
{% warning %} {% 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 %} {% endwarning %}

View File

@@ -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 %} {% 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 %} {% endif %}

View File

@@ -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. 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 %} {% 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 %} {% endif %}
#### Example: Using groups to control where jobs are run #### Example: Using groups to control where jobs are run

View File

@@ -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)." * **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 %} {% 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)." * **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.

View File

@@ -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.