Skip to content

repo sync #18184

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 5 commits into from
May 24, 2022
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 removed assets/images/help/education/create-org-button.png
Binary file not shown.
Binary file not shown.
Binary file not shown.
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
Expand Up @@ -17,7 +17,7 @@ versions:

## About re-running workflows and jobs

Re-running a workflow{% if 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. You can re-run a workflow{% if re-run-jobs %} or jobs in a workflow{% endif %} for up to 30 days after the initial run.
Re-running a workflow{% if 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. You can re-run a workflow{% if re-run-jobs %} or jobs in a workflow{% endif %} for up to 30 days after the initial run.{% if debug-reruns %} 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 "[Enabling debug logging](/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging)."{% endif %}

## Re-running all the jobs in a workflow

Expand All @@ -37,6 +37,7 @@ Re-running a workflow{% if re-run-jobs %} or jobs in a workflow{% endif %} uses
1. In the upper-right corner of the workflow, use the **Re-run jobs** drop-down menu, and select **Re-run all jobs**.
![Re-run checks drop-down menu](/assets/images/help/repository/rerun-checks-drop-down-updated.png)
{% endif %}
{% data reusables.actions.enable-debug-logging %}

{% endwebui %}

Expand All @@ -50,6 +51,15 @@ To re-run a failed workflow run, use the `run rerun` subcommand. Replace `run-id
gh run rerun <em>run-id</em>
```

{% if debug-reruns %}
{% data reusables.actions.enable-debug-logging-cli %}

```shell
gh run rerun <em>run-id</em> --debug
```

{% endif %}

To view the progress of the workflow run, use the `run watch` subcommand and select the run from the interactive list.

```shell
Expand All @@ -71,6 +81,7 @@ If any jobs in a workflow run failed, you can re-run just the jobs that failed.
{% data reusables.repositories.view-run %}
1. In the upper-right corner of the workflow, use the **Re-run jobs** drop-down menu, and select **Re-run failed jobs**.
![Re-run failed jobs drop-down menu](/assets/images/help/repository/rerun-failed-jobs-drop-down.png)
{% data reusables.actions.enable-debug-logging %}

{% endwebui %}

Expand All @@ -82,6 +93,14 @@ To re-run failed jobs in a workflow run, use the `run rerun` subcommand with the
gh run rerun <em>run-id</em> --failed
```

{% if debug-reruns %}
{% data reusables.actions.enable-debug-logging-cli %}

```shell
gh run rerun <em>run-id</em> --failed --debug
```

{% endif %}
{% endcli %}

## Re-running a specific job in a workflow
Expand All @@ -99,6 +118,7 @@ When you re-run a specific job in a workflow, a new workflow run will start for

Alternatively, click on a job to view the log. In the log, click {% octicon "sync" aria-label="The re-run icon" %}.
![Re-run selected job](/assets/images/help/repository/re-run-single-job-from-log.png)
{% data reusables.actions.enable-debug-logging %}

{% endwebui %}

Expand All @@ -110,6 +130,14 @@ To re-run a specific job in a workflow run, use the `run rerun` subcommand with
gh run rerun --job <em>job-id</em>
```

{% if debug-reruns %}
{% data reusables.actions.enable-debug-logging-cli %}

```shell
gh run rerun --job <em>job-id</em> --debug
```

{% endif %}
{% endcli %}

{% endif %}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,12 @@ These extra logs are enabled by setting secrets in the repository containing the

For more information on setting secrets, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)."

{% if debug-reruns %}

Additionally, anyone who has access to run a workflow can enable runner diagnostic logging and step debug logging for a workflow re-run. For more information, see "[Re-running workflows and jobs](/actions/managing-workflow-runs/re-running-workflows-and-jobs)."

{% endif %}

## Enabling runner diagnostic logging

Runner diagnostic logging provides additional log files that contain information about how a runner is executing a job. Two extra log files are added to the log archive:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1199,6 +1199,16 @@ Action | Description
| `secret_scanning.disable` | An organization owner disabled secret scanning for all existing{% ifversion ghec %} private or internal{% endif %} repositories. For more information, see "[About secret scanning](/github/administering-a-repository/about-secret-scanning)."
| `secret_scanning.enable` | An organization owner enabled secret scanning for all existing{% ifversion ghec %} private or internal{% endif %} repositories.

{% if secret-scanning-alert-audit-log %}
### `secret_scanning_alert` category actions

| Action | Description
|------------------|-------------------
| `secret_scanning_alert.create` | {% data variables.product.prodname_dotcom %} detected a secret and created a {% data variables.product.prodname_secret_scanning %} alert. For more information, see "[Managing alerts from {% data variables.product.prodname_secret_scanning %}](/code-security/secret-scanning/managing-alerts-from-secret-scanning)."
| `secret_scanning_alert.reopen` | A user reopened a {% data variables.product.prodname_secret_scanning %} alert.
| `secret_scanning_alert.resolve` | A user resolved a {% data variables.product.prodname_secret_scanning %} alert.
{% endif %}

### `secret_scanning_new_repos` category actions

| Action | Description
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,27 +32,6 @@ For more information about personal accounts on {% data variables.product.produc
{% data reusables.education.plan-to-use-github %}
{% data reusables.education.submit-application %}

## Upgrading your organization

After your request for an educator or researcher discount has been approved, you can upgrade the organizations you use with your learning community to {% data variables.product.prodname_team %}, which allows unlimited users and private repositories with full features, for free. You can upgrade an existing organization or create a new organization to upgrade.

### Upgrading an existing organization

{% data reusables.education.upgrade-page %}
{% data reusables.education.upgrade-organization %}

### Upgrading a new organization

{% data reusables.education.upgrade-page %}
1. Click {% octicon "plus" aria-label="The plus symbol" %} **Create an organization**.
![Create an organization button](/assets/images/help/education/create-org-button.png)
3. Read the information, then click **Create organization**.
![Create organization button](/assets/images/help/education/create-organization-button.png)
4. Under "Choose your plan", click **Choose {% data variables.product.prodname_free_team %}**.
5. Follow the prompts to create your organization.
{% data reusables.education.upgrade-page %}
{% data reusables.education.upgrade-organization %}

## Further reading

- "[Why wasn't my application for an educator or researcher discount approved?](/articles/why-wasn-t-my-application-for-an-educator-or-researcher-discount-approved)"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -740,7 +740,19 @@ For more information, see "[Managing the publication of {% data variables.produc
|------------------|-------------------
| `disable` | Triggered when an organization owner disables secret scanning for all existing{% ifversion ghec %}, private or internal{% endif %} repositories. For more information, see "[About secret scanning](/github/administering-a-repository/about-secret-scanning)."
| `enable` | Triggered when an organization owner enables secret scanning for all existing{% ifversion ghec %}, private or internal{% endif %} repositories.
{% endif %}

{% if secret-scanning-alert-audit-log %}
### `secret_scanning_alert` category actions

| Action | Description
|------------------|-------------------
| `create` | Triggered when {% data variables.product.prodname_dotcom %} detects an exposed secret and creates a {% data variables.product.prodname_secret_scanning %} alert. For more information, see "[Managing alerts from {% data variables.product.prodname_secret_scanning %}](/code-security/secret-scanning/managing-alerts-from-secret-scanning)."
| `reopen` | Triggered when a user reopens a {% data variables.product.prodname_secret_scanning %} alert.
| `resolve` | Triggered when a user resolves a {% data variables.product.prodname_secret_scanning %} alert.
{% endif %}

{% ifversion ghec or ghes or ghae %}
### `secret_scanning_new_repos` category actions

| Action | Description
Expand Down
7 changes: 7 additions & 0 deletions data/features/debug-reruns.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Issue 6629
# Enabling debug logging when re-running jobs or workflows
versions:
fpt: '*'
ghec: '*'
ghes: '>=3.6'
ghae: 'issue-6629'
6 changes: 6 additions & 0 deletions data/features/secret-scanning-alert-audit-log.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Reference: #7046.
# Documentation for new audit log events for alerts for secret scanning.
versions:
ghec: '*'
ghes: '>=3.6'
ghae: 'issue-7046'
1 change: 1 addition & 0 deletions data/reusables/actions/enable-debug-logging-cli.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
To enable enable runner diagnostic logging and step debug logging for the re-run, use the `--debug` flag.
4 changes: 4 additions & 0 deletions data/reusables/actions/enable-debug-logging.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{% if debug-reruns %}
1. Optionally, to enable runner diagnostic logging and step debug logging for the re-run, select **Enable debug logging**.
![Enable debug logging](/assets/images/help/repository/enable-debug-logging.png)
{% endif %}
2 changes: 0 additions & 2 deletions data/reusables/education/upgrade-organization.md

This file was deleted.

1 change: 0 additions & 1 deletion data/reusables/education/upgrade-page.md

This file was deleted.