Skip to content

Commit 429c64b

Browse files
authored
Merge pull request #36009 from github/repo-sync
Repo sync
2 parents c7d69c9 + a76f359 commit 429c64b

File tree

93 files changed

+113
-369
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

93 files changed

+113
-369
lines changed

content/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ For more information about installing and using self-hosted runners, see [AUTOTI
5353
* Are customizable to your hardware, operating system, software, and security requirements.
5454
* Don't need to have a clean instance for every job execution.
5555
* Are free to use with {% data variables.product.prodname_actions %}, but you are responsible for the cost of maintaining your runner machines.{% ifversion ghec or ghes %}
56-
* Can be organized into groups to restrict access to specific {% ifversion restrict-groups-to-workflows %}workflows, {% endif %}organizations and repositories. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups).{% endif %}
56+
* Can be organized into groups to restrict access to specific workflows, organizations, and repositories. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups).{% endif %}
5757

5858
## Requirements for self-hosted runner machines
5959

content/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ For runner groups in an organization, you can change what repositories in the or
6262
{% data reusables.actions.runner-groups-org-navigation %}
6363
{% data reusables.actions.changing-repository-access-for-a-runner-group %}
6464

65-
{% ifversion restrict-groups-to-workflows %}
65+
{% ifversion ghec or ghes %}
6666

6767
## Changing which workflows can access a runner group
6868

content/actions/hosting-your-own-runners/managing-self-hosted-runners/using-labels-with-self-hosted-runners.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ shortTitle: Label runners
1313

1414
{% data reusables.actions.enterprise-github-hosted-runners %}
1515

16-
For information on how to use labels to route jobs to specific types of self-hosted runners, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow). {% ifversion target-runner-groups %}You can also route jobs to runners in a specific group. For more information, see [AUTOTITLE](/actions/using-jobs/choosing-the-runner-for-a-job#targeting-runners-in-a-group).{% endif %}
16+
For information on how to use labels to route jobs to specific types of self-hosted runners, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow). You can also route jobs to runners in a specific group. For more information, see [AUTOTITLE](/actions/using-jobs/choosing-the-runner-for-a-job#targeting-runners-in-a-group).
1717

1818
{% data reusables.actions.self-hosted-runner-management-permissions-required %}
1919

content/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow.md

Lines changed: 5 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Using self-hosted runners in a workflow
3-
intro: 'To use self-hosted runners in a workflow, you can use labels{% ifversion target-runner-groups %} or groups{% endif %} to specify the runner for a job.'
3+
intro: 'To use self-hosted runners in a workflow, you can use labels or groups to specify the runner for a job.'
44
redirect_from:
55
- /github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow
66
- /actions/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow
@@ -15,7 +15,7 @@ shortTitle: Use runners in a workflow
1515

1616
{% data reusables.actions.enterprise-github-hosted-runners %}
1717

18-
You can target self-hosted runners for use in a workflow based on the labels assigned to the runners{% ifversion target-runner-groups %}, or their group membership, or a combination of these{% endif %}.
18+
You can target self-hosted runners for use in a workflow based on the labels assigned to the runners, or their group membership, or a combination of these.
1919

2020
>[!IMPORTANT]Runner Scale Sets do not support multiple labels, only the name of the runner can be used in place of a label. See [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller).
2121
@@ -27,8 +27,6 @@ Labels allow you to send workflow jobs to specific types of self-hosted runners,
2727

2828
For information on creating custom and default labels, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/using-labels-with-self-hosted-runners).
2929

30-
{% ifversion target-runner-groups %}
31-
3230
## About self-hosted runner groups
3331

3432
For self-hosted runners defined at the organization {% ifversion ghec or ghes %}or enterprise levels{% else %}level{% endif %}, you can group your runners with shared characteristics into a single runner group and then configure your job to target the runner group.
@@ -37,8 +35,6 @@ To specify a self-hosted runner group for your job, configure `runs-on.group` in
3735

3836
For information on creating and managing runner groups, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups).
3937

40-
{% endif %}
41-
4238
{% ifversion repository-actions-runners %}
4339

4440
## Viewing available runners for a repository
@@ -95,8 +91,6 @@ runs-on: [self-hosted, linux, x64, gpu]
9591

9692
These labels operate cumulatively, so a self-hosted runner must have all four labels to be eligible to process the job.
9793

98-
{% ifversion target-runner-groups %}
99-
10094
## Using groups to route jobs
10195

10296
{% data reusables.actions.jobs.example-runs-on-groups %}
@@ -105,13 +99,11 @@ These labels operate cumulatively, so a self-hosted runner must have all four la
10599

106100
{% data reusables.actions.jobs.example-runs-on-labels-and-groups %}
107101

108-
{% endif %}
109-
110102
## Routing precedence for self-hosted runners
111103

112-
When routing a job to a self-hosted runner, {% data variables.product.prodname_dotcom %} looks for a runner that matches the job's `runs-on` labels{% ifversion target-runner-groups %} and groups{% endif %}:
104+
When routing a job to a self-hosted runner, {% data variables.product.prodname_dotcom %} looks for a runner that matches the job's `runs-on` labels and groups:
113105

114-
* If {% data variables.product.prodname_dotcom %} finds an online and idle runner that matches the job's `runs-on` labels{% ifversion target-runner-groups %} and groups{% endif %}, the job is then assigned and sent to the runner.
106+
* If {% data variables.product.prodname_dotcom %} finds an online and idle runner that matches the job's `runs-on` labels and groups, the job is then assigned and sent to the runner.
115107
* If the runner doesn't pick up the assigned job within 60 seconds, the job is re-queued so that a new runner can accept it.
116-
* If {% data variables.product.prodname_dotcom %} doesn't find an online and idle runner that matches the job's `runs-on` labels {% ifversion target-runner-groups %} and groups{% endif %}, then the job will remain queued until a runner comes online.
108+
* If {% data variables.product.prodname_dotcom %} doesn't find an online and idle runner that matches the job's `runs-on` labels and groups, then the job will remain queued until a runner comes online.
117109
* If the job remains queued for more than 24 hours, the job will fail.

content/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/disabling-and-enabling-a-workflow.md

Lines changed: 1 addition & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -36,15 +36,7 @@ You can also disable and enable a workflow using the REST API. For more informat
3636
1. In the left sidebar, click the workflow you want to disable.
3737
1. Click {% octicon "kebab-horizontal" aria-label="Show workflow options" %} to display a dropdown menu and click **Disable workflow**.
3838

39-
{% ifversion workflow-nav-2022 -%}
4039
![Screenshot of a workflow. The "Show workflow options" button, shown with a kebab icon, and the "Disable workflow" menu item are outlined in orange.](/assets/images/help/repository/actions-disable-workflow-2022.png)
41-
{%- else -%}
42-
![Screenshot of a workflow. Features apart from the "Disable workflow" menu item are grayed out.](/assets/images/help/repository/actions-disable-workflow.png)
43-
44-
The disabled workflow is marked {% octicon "stop" aria-label="The stop icon" %} to indicate its status.
45-
46-
![Screenshot showing the actions list. The name of the disabled "Greet Everyone" workflow is prefixed with a stop icon.](/assets/images/help/repository/actions-find-disabled-workflow.png)
47-
{%- endif %}
4840

4941
{% endwebui %}
5042

@@ -70,11 +62,8 @@ You can re-enable a workflow that was previously disabled.
7062
{% data reusables.repositories.actions-tab %}
7163
1. In the left sidebar, click the workflow you want to enable.
7264

73-
{% ifversion workflow-nav-2022 -%}
7465
![Screenshot of the "Actions" page. In the left sidebar, a workflow name is highlighted with an outline in dark orange.](/assets/images/help/repository/actions-select-disabled-workflow-2022.png)
75-
{%- else -%}
76-
![Screenshot of the "Actions" page. Features are grayed out apart from one workflow name in the left sidebar.](/assets/images/help/repository/actions-select-disabled-workflow.png)
77-
{%- endif %}
66+
7867
1. Click **Enable workflow**.
7968

8069
{% endwebui %}

content/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/manually-running-a-workflow.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,11 +29,8 @@ To trigger the `workflow_dispatch` event, your workflow must be in the default b
2929
{% data reusables.repositories.actions-tab %}
3030
1. In the left sidebar, click the name of the workflow you want to run.
3131

32-
{% ifversion workflow-nav-2022 -%}
3332
![Screenshot of the "Actions" page. In the left sidebar, a workflow name is highlighted with an outline in dark orange.](/assets/images/help/repository/actions-select-workflow-2022.png)
34-
{%- else -%}
35-
![Screenshot of the "Actions" page. Features apart from one workflow in the left sidebar are grayed out.](/assets/images/help/repository/actions-select-workflow.png)
36-
{%- endif %}
33+
3734
1. Above the list of workflow runs, click the **Run workflow** button.
3835

3936
> [!NOTE]

content/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/re-running-workflows-and-jobs.md

Lines changed: 2 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Re-running workflows and jobs
33
shortTitle: Re-run workflows and jobs
4-
intro: 'You can re-run a workflow run{% ifversion re-run-jobs %}, all failed jobs in a workflow run, or specific jobs in a workflow run{% endif %} up to 30 days after its initial run.'
4+
intro: 'You can re-run a workflow run, all failed jobs in a workflow run, or specific jobs in a workflow run up to 30 days after its initial run.'
55
permissions: People with write permissions to a repository can re-run workflows in the repository.
66
redirect_from:
77
- /actions/managing-workflow-runs/re-running-a-workflow
@@ -16,7 +16,7 @@ versions:
1616

1717
## About re-running workflows and jobs
1818

19-
Re-running a workflow{% ifversion re-run-jobs %} or jobs in a workflow{% endif %} uses the same `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) of the original event that triggered the workflow run. The workflow will use the privileges of the actor who initially triggered the workflow, not the privileges of the actor who initiated the re-run. You can re-run a workflow{% ifversion re-run-jobs %} or jobs in a workflow{% endif %} for up to 30 days after the initial run.{% ifversion re-run-jobs %} You cannot re-run jobs in a workflow once its logs have passed their retention limits. For more information, see [AUTOTITLE](/actions/learn-github-actions/usage-limits-billing-and-administration#artifact-and-log-retention-policy).{% endif %} When you re-run a workflow or jobs in a workflow, you can enable debug logging for the re-run. This will enable runner diagnostic logging and step debug logging for the re-run. For more information about debug logging, see [AUTOTITLE](/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging).
19+
Re-running a workflow or jobs in a workflow uses the same `GITHUB_SHA` (commit SHA) and `GITHUB_REF` (Git ref) of the original event that triggered the workflow run. The workflow will use the privileges of the actor who initially triggered the workflow, not the privileges of the actor who initiated the re-run. You can re-run a workflow or jobs in a workflow for up to 30 days after the initial run. You cannot re-run jobs in a workflow once its logs have passed their retention limits. For more information, see [AUTOTITLE](/actions/learn-github-actions/usage-limits-billing-and-administration#artifact-and-log-retention-policy). When you re-run a workflow or jobs in a workflow, you can enable debug logging for the re-run. This will enable runner diagnostic logging and step debug logging for the re-run. For more information about debug logging, see [AUTOTITLE](/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging)
2020

2121
## Re-running all the jobs in a workflow
2222

@@ -60,8 +60,6 @@ gh run watch
6060

6161
{% endcli %}
6262

63-
{% ifversion re-run-jobs %}
64-
6563
## Re-running failed jobs in a workflow
6664

6765
If any jobs in a workflow run failed, you can re-run just the jobs that failed. When you re-run failed jobs in a workflow, a new workflow run will start for all failed jobs and their dependents. Any outputs for any successful jobs in the previous workflow run will be used for the re-run. Any artifacts that were created in the initial run will be available in the re-run. Any deployment protection rules that passed in the previous run will automatically pass in the re-run.
@@ -125,16 +123,10 @@ gh run rerun --job JOB_ID --debug
125123

126124
{% endcli %}
127125

128-
{% endif %}
129-
130-
{% ifversion partial-reruns-with-reusable %}
131-
132126
## Re-running workflows and jobs with reusable workflows
133127

134128
{% data reusables.actions.partial-reruns-with-reusable %}
135129

136-
{% endif %}
137-
138130
## Reviewing previous workflow runs
139131

140132
You can view the results from your previous attempts at running a workflow. You can also view previous workflow runs using the API. For more information, see [AUTOTITLE](/rest/actions/workflow-runs#get-a-workflow-run).
@@ -143,8 +135,4 @@ You can view the results from your previous attempts at running a workflow. You
143135
{% data reusables.repositories.actions-tab %}
144136
{% data reusables.repositories.navigate-to-workflow %}
145137
{% data reusables.repositories.view-run %}
146-
{%- ifversion re-run-jobs %}
147138
1. To the right of the run name, select the **Latest** dropdown menu and click a previous run attempt.
148-
{%- else %}
149-
1. In the left pane, click a previous run attempt.
150-
{%- endif %}

content/actions/monitoring-and-troubleshooting-workflows/monitoring-workflows/using-workflow-run-logs.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ versions:
1010
ghes: '*'
1111
ghec: '*'
1212
---
13-
13+
1414
{% data reusables.actions.enterprise-github-hosted-runners %}
1515

1616
You can see whether a workflow run is in progress or complete from the workflow run page. You must be logged in to a {% data variables.product.prodname_dotcom %} account to view workflow run information, including for public repositories. For more information, see [AUTOTITLE](/get-started/learning-about-github/access-permissions-on-github).
@@ -61,13 +61,9 @@ You can download the log files from your workflow run. You can also download a w
6161

6262
![Screenshot of the log for a job. In the header, a gear icon is outlined in dark orange.](/assets/images/help/actions/download-logs-drop-down.png)
6363

64-
{% ifversion re-run-jobs %}
65-
6664
> [!NOTE]
6765
> When you download the log archive for a workflow that was partially re-run, the archive only includes the jobs that were re-run. To get a complete set of logs for jobs that were run from a workflow, you must download the log archives for the previous run attempts that ran the other jobs.
6866
69-
{% endif %}
70-
7167
## Deleting logs
7268

7369
You can delete the log files from your workflow runs through the {% data variables.product.prodname_dotcom %} web interface or programmatically. {% data reusables.repositories.permissions-statement-write %}

content/actions/security-for-github-actions/security-guides/security-hardening-for-github-actions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -344,7 +344,7 @@ For third-party images, such as the images for ARM-powered runners, you can find
344344

345345
{% data reusables.actions.disable-selfhosted-runners-crossrefs %}
346346

347-
When a self-hosted runner is defined at the organization or enterprise level, {% data variables.product.github %} can schedule workflows from multiple repositories onto the same runner. Consequently, a security compromise of these environments can result in a wide impact. To help reduce the scope of a compromise, you can create boundaries by organizing your self-hosted runners into separate groups. You can restrict what {% ifversion restrict-groups-to-workflows %}workflows, {% endif %}organizations and repositories can access runner groups. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups).
347+
When a self-hosted runner is defined at the organization or enterprise level, {% data variables.product.github %} can schedule workflows from multiple repositories onto the same runner. Consequently, a security compromise of these environments can result in a wide impact. To help reduce the scope of a compromise, you can create boundaries by organizing your self-hosted runners into separate groups. You can restrict what {% ifversion ghec or ghes %}workflows, {% endif %}organizations and repositories can access runner groups. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups).
348348

349349
You should also consider the environment of the self-hosted runner machines:
350350
* What sensitive information resides on the machine configured as a self-hosted runner? For example, private SSH keys, API access tokens, among others.

content/actions/sharing-automations/reusing-workflows.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -430,16 +430,12 @@ For information about using the REST API to query the audit log for an organizat
430430
> [!NOTE]
431431
> Audit data for `prepared_workflow_job` can only be viewed using the REST API. It is not visible in the {% data variables.product.prodname_dotcom %} web interface, or included in JSON/CSV exported audit data.
432432

433-
{% ifversion partial-reruns-with-reusable %}
434-
435433
## Re-running workflows and jobs with reusable workflows
436434

437435
{% data reusables.actions.partial-reruns-with-reusable %}
438436

439-
{% endif %}
440-
441437
## Next steps
442438

443439
To continue learning about {% data variables.product.prodname_actions %}, see [AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows).
444440

445-
{% ifversion restrict-groups-to-workflows %}You can standardize deployments by creating a self-hosted runner group that can only execute a specific reusable workflow. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups).{% endif %}
441+
{% ifversion ghec or ghes %}You can standardize deployments by creating a self-hosted runner group that can only execute a specific reusable workflow. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups).{% endif %}

0 commit comments

Comments
 (0)