Skip to content

Repo sync #39475

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 15 commits into from
Jul 23, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified assets/images/help/copilot/coding-agent/agents-page-input.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/help/copilot/copilot-usage-tab.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,16 +1,15 @@
---
title: About Actions Runner Controller
shortTitle: About ARC
title: Actions Runner Controller
intro: 'You can host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows.'
versions:
fpt: '*'
ghec: '*'
ghes: '*'
type: overview
topics:
- Actions Runner Controller
redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-actions-runner-controller
- /actions/concepts/runners/about-actions-runner-controller
---

## About {% data variables.product.prodname_actions_runner_controller %}
Expand Down Expand Up @@ -146,18 +145,6 @@ RUN curl -f -L -o runner-container-hooks.zip https://github.com/actions/runner-c
USER runner
```

## Executing workflows

After installation and configuration are complete, you can use ARC to execute workflow runs. A workflow can be created in the same repository that can target a self hosted runner created by ARC. For more information about targeting workflows to run on self-hosted runners, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow).

### Using ARC runners in a workflow

{% data reusables.actions.actions-runner-controller-labels %} For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/using-actions-runner-controller-runners-in-a-workflow).

## Scaling runners

You can scale runners statically or dynamically depending on your needs. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller#scaling-runners).

## Software installed in the ARC runner image

The ARC [runner image](https://github.com/actions/runner/pkgs/container/actions-runner) is bundled with the following software:
Expand All @@ -183,3 +170,11 @@ The supported runner image is released as a separate container image, which you
## Legal notice

{% data reusables.actions.actions-runner-controller-legal-notice %}

## Next steps

When you're ready to use ARC to execute workflows, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/using-actions-runner-controller-runners-in-a-workflow).

{% data reusables.actions.actions-runner-controller-labels %} For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow).

You can scale runners statically or dynamically depending on your needs. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller#scaling-runners).
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: About GitHub-hosted runners
shortTitle: GitHub-hosted runners
title: GitHub-hosted runners
intro: '{% data variables.product.prodname_dotcom %} offers hosted virtual machines to run workflows. The virtual machine contains an environment of tools, packages, and settings available for {% data variables.product.prodname_actions %} to use.'
redirect_from:
- /articles/virtual-environments-for-github-actions
Expand All @@ -14,6 +13,7 @@ redirect_from:
- /actions/using-github-hosted-runners/about-github-hosted-runners/about-github-hosted-runners
- /actions/using-github-hosted-runners/using-github-hosted-runners/about-github-hosted-runners
- /actions/how-tos/using-github-hosted-runners/using-github-hosted-runners/about-github-hosted-runners
- /actions/concepts/runners/about-github-hosted-runners
versions:
fpt: '*'
ghes: '*'
Expand Down
16 changes: 8 additions & 8 deletions content/actions/concepts/runners/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,12 @@ versions:
ghes: '*'
ghec: '*'
children:
- /about-github-hosted-runners
- /about-larger-runners
- /about-self-hosted-runners
- /about-private-networking-with-github-hosted-runners
- /about-runner-groups
- /about-runner-scale-sets
- /about-actions-runner-controller
- /about-support-for-actions-runner-controller
- /github-hosted-runners
- /larger-runners
- /self-hosted-runners
- /private-networking-with-github-hosted-runners
- /runner-groups
- /runner-scale-sets
- /actions-runner-controller
- /support-for-actions-runner-controller
---
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: About larger runners
shortTitle: Larger runners
title: Larger runners
intro: 'Learn about the types and uses of {% data variables.product.prodname_dotcom %}-hosted {% data variables.actions.hosted_runners %}.'
permissions: '{% data reusables.actions.larger-runner-permissions %}'
versions:
Expand All @@ -10,6 +9,7 @@ versions:
redirect_from:
- /actions/using-github-hosted-runners/about-larger-runners/about-larger-runners
- /actions/using-github-hosted-runners/using-larger-runners/about-larger-runners
- /actions/concepts/runners/about-larger-runners
---

{% ifversion ghes %}
Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,11 @@
---
title: About private networking with GitHub-hosted runners
title: Private networking with GitHub-hosted runners
shortTitle: About private networking
intro: '{% data reusables.actions.private-networking-intro %}'
versions:
fpt: '*'
ghes: '*'
ghec: '*'
type: overview
topics:
- Actions
- Action development
Expand All @@ -17,6 +16,7 @@ topics:
- CD
redirect_from:
- /actions/using-github-hosted-runners/connecting-to-a-private-network/about-private-networking-with-github-hosted-runners
- /actions/concepts/runners/about-private-networking-with-github-hosted-runners
---

{% data reusables.actions.enterprise-github-hosted-runners %}
Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: About runner groups
shortTitle: Runner groups
title: Runner groups
intro: 'Learn about what a runner group is, and how to use them to control access to runners at the organization{% ifversion ghec or ghes %} and/or enterprise levels{% else %} level.{% endif %}'
versions:
fpt: '*'
ghec: '*'
ghes: '*'
type: overview
redirect_from:
- /actions/concepts/runners/about-runner-groups
---

## About runner groups
Expand Down
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: About runner scale sets
shortTitle: Runner scale sets
title: Runner scale sets
intro: 'Learn about what a runner scale set is and how they can interact with the {% data variables.product.prodname_actions_runner_controller %}.'
layout: inline
versions:
fpt: '*'
ghec: '*'
ghes: '*'
type: overview
topics:
- Actions Runner Controller
redirect_from:
- /actions/concepts/runners/about-runner-scale-sets
---

## About runner scale sets
Expand Down
Original file line number Diff line number Diff line change
@@ -1,17 +1,16 @@
---
title: About self-hosted runners
shortTitle: Self-hosted runners
title: Self-hosted runners
intro: 'You can host your own runners and customize the environment used to run jobs in your {% data variables.product.prodname_actions %} workflows.'
redirect_from:
- /github/automating-your-workflow-with-github-actions/about-self-hosted-runners
- /actions/automating-your-workflow-with-github-actions/about-self-hosted-runners
- /actions/hosting-your-own-runners/about-self-hosted-runners
- /actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners
- /actions/concepts/runners/about-self-hosted-runners
versions:
fpt: '*'
ghes: '*'
ghec: '*'
type: overview
---

A self-hosted runner is a system that you deploy and manage to execute jobs from {% data variables.product.prodname_actions %} on {% data variables.product.github %}.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: About support for Actions Runner Controller
title: Support for Actions Runner Controller
shortTitle: Support for ARC
intro: 'What to know before you [contact {% data variables.contact.github_support %}](support/contacting-github-support) for assistance with Actions Runner Controller.'
shortTitle: About Support for ARC
versions:
fpt: '*'
ghec: '*'
Expand All @@ -11,11 +11,10 @@ topics:
- Support
redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-support-for-actions-runner-controller
- /actions/concepts/runners/about-support-for-actions-runner-controller
---

You can [contact {% data variables.contact.github_support %}](/support/contacting-github-support) for assistance with Actions Runner Controller.

## About support for Actions Runner Controller Versions
## Overview

The Actions Runner Controller (ARC) project [was adopted by GitHub](https://github.com/actions/actions-runner-controller/discussions/2072) to release as a new GitHub product. As a result, there are currently two ARC releases: the legacy community-maintained ARC and GitHub's Autoscaling Runner Sets.

Expand Down
55 changes: 55 additions & 0 deletions content/actions/concepts/security/artifact-attestations.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
title: Artifact attestations
intro: 'Understand the usage and security benefits of artifact attestations.'
shortTitle: Artifact attestations
topics:
- Actions
- Security
versions:
fpt: '*'
ghec: '*'
---

## Overview

{% data reusables.actions.about-artifact-attestations %}

## SLSA levels for artifact attestations

The SLSA framework is an industry standard used to evaluate supply chain security. It is organized into levels. Each level represents an increasing degree of security and trustworthiness for a software supply chain. Artifact attestations by itself provides SLSA v1.0 Build Level 2.

This provides a link between your artifact and its build instructions, but you can take this a step further by requiring builds make use of known, vetted build instructions. A great way to do this is to have your build take place in a reusable workflow that many repositories across your organization share. Reusable workflows can provide isolation between the build process and the calling workflow, to meet SLSA v1.0 Build Level 3. For more information, see [AUTOTITLE](/actions/security-guides/using-artifact-attestations-and-reusable-workflows-to-achieve-slsa-v1-build-level-3).

For more information on SLSA levels, see [SLSA Security Levels](https://slsa.dev/spec/v1.0/levels).

## How {% data variables.product.github %} generates artifact attestations

To generate artifact attestations, {% data variables.product.prodname_dotcom %} uses Sigstore, which is an open source project that offers a comprehensive solution for signing and verifying software artifacts via attestations.

**Public repositories** that generate artifact attestations use the [Sigstore Public Good Instance](https://openssf.org/blog/2023/10/03/running-sigstore-as-a-managed-service-a-tour-of-sigstores-public-good-instance/). A copy of the generated Sigstore bundle is stored with GitHub and is also written to an immutable transparency log that is publicly readable on the internet.

**Private repositories** that generate artifact attestations use GitHub's Sigstore instance. GitHub's Sigstore instance uses the same codebase as the Sigstore Public Good Instance, but it does not have a transparency log and only federates with {% data variables.product.prodname_actions %}.

## When to generate attestations

Generating attestations alone doesn't provide any security benefit, the attestations must be verified for the benefit to be realized. Here are some guidelines for how to think about what to sign and how often:

You should sign:

* Software you are releasing that you expect people to run `gh attestation verify ...` on.
* Binaries people will run, packages people will download, or manifests that include hashes of detailed contents.

You should **not** sign:

* Frequent builds that are just for automated testing.
* Individual files like source code, documentation files, or embedded images.

## Verifying artifact attestations

If you consume software that publishes artifact attestations, you can use the {% data variables.product.prodname_cli %} to verify those attestations. Because the attestations give you information about where and how software was built, you can use that information to create and enforce security policies that elevate your supply chain security.

>[!WARNING] It is important to remember that artifact attestations are _not_ a guarantee that an artifact is secure. Instead, artifact attestations link you to the source code and the build instructions that produced them. It is up to you to define your policy criteria, evaluate that policy by evaluating the content, and make an informed risk decision when you are consuming software.

## Next steps

To start generating and verifying artifact attestations for your builds, see [AUTOTITLE](/actions/how-tos/security-for-github-actions/using-artifact-attestations/using-artifact-attestations-to-establish-provenance-for-builds).
2 changes: 1 addition & 1 deletion content/actions/concepts/security/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@ children:
- /secrets
- /github_token
- /openid-connect
- /artifact-attestations
- /script-injections
- /compromised-runners
- /kubernetes-admissions-controller
---

Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: Approving workflow runs from forks
intro: 'You can manually approve workflow runs that have been triggered by a contributor''s pull request.'
versions:
fpt: '*'
ghec: '*'
ghes: '*'
shortTitle: Approve workflow runs
redirect_from:
- /actions/managing-workflow-runs/approving-workflow-runs-from-public-forks
- /actions/managing-workflow-runs-and-deployments/managing-workflow-runs/approving-workflow-runs-from-public-forks
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/approving-workflow-runs-from-private-forks
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/approving-workflow-runs-from-public-forks
---

Workflow runs triggered by a contributor's pull request from a fork may require manual approval from a maintainer with write access. You can configure workflow approval requirements for a [repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-required-approval-for-workflows-from-public-forks), [organization](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#configuring-required-approval-for-workflows-from-public-forks), or [enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-fork-pull-requests-in-your-enterprise).

Workflow runs that have been awaiting approval for more than 30 days are automatically deleted.

## Approving workflow runs on a pull request from a public fork

{% data reusables.actions.workflows.approve-workflow-runs %}

This file was deleted.

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,7 @@ children:
- /downloading-workflow-artifacts
- /removing-workflow-artifacts
- /manage-caches
- /approving-workflow-runs-from-public-forks
- /approving-workflow-runs-from-private-forks
- /approving-workflow-runs-from-forks
redirect_from:
- /actions/managing-workflow-runs-and-deployments/managing-workflow-runs
---
Loading
Loading
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy