Skip to content

Commit d62681e

Browse files
authored
Merge pull request #42375 from github/repo-sync
Repo sync
2 parents 03d191b + b09f0be commit d62681e

File tree

60 files changed

+1033
-209
lines changed

Some content is hidden

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

60 files changed

+1033
-209
lines changed

content/actions/how-tos/monitor-workflows/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ children:
1111
- /view-job-execution-time
1212
- /add-a-status-badge
1313
- /use-workflow-run-logs
14+
- /view-job-condition-logs
1415
- /enable-debug-logging
1516
redirect_from:
1617
- /actions/monitoring-and-troubleshooting-workflows/monitoring-workflows
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
title: Viewing job condition expression logs
3+
shortTitle: View job condition logs
4+
intro: 'Learn how to access and interpret expression evaluation logs for job-level `if` conditions in {% data variables.product.prodname_actions %}.'
5+
versions:
6+
fpt: '*'
7+
ghec: '*'
8+
contentType: how-tos
9+
---
10+
11+
When a job's `if` condition is evaluated, {% data variables.product.prodname_actions %} logs the expression evaluation to help you understand the result. This is useful for debugging both why a job was skipped and why a job ran when you expected it to be skipped.
12+
13+
## Accessing expression logs
14+
15+
1. Navigate to the workflow run summary.
16+
1. Click on the job.
17+
1. Click **{% octicon "gear" aria-label="The Gear icon" %}**.
18+
1. Select **Download log archive**.
19+
1. Extract the ZIP file and open the `JOB-NAME/system.txt` file.
20+
21+
## Understanding the log output
22+
23+
The system log shows the expression evaluation:
24+
25+
```text
26+
Evaluating: (success() && ((github.repository == 'octo-org/octo-repo-prod')))
27+
Expanded: (true && (('my-username/octo-repo-prod' == 'octo-org/octo-repo-prod')))
28+
Result: false
29+
```
30+
31+
| Line | Description |
32+
|------|-------------|
33+
| **Evaluating** | The original `if` expression from your workflow file. |
34+
| **Expanded** | The expression with context values substituted. This shows you exactly what values were used at runtime. |
35+
| **Result** | The final evaluation result (`true` or `false`). |
36+
37+
In this example, the expanded line reveals that `github.repository` was `'my-username/octo-repo-prod'` (not `'octo-org/octo-repo-prod'`), which caused the condition to evaluate to `false`.
38+
39+
> [!NOTE]
40+
> Expression logs are only available for job-level `if` conditions. For step-level conditions, you can enable debug logging to see expression evaluation in the job logs. For more information, see [AUTOTITLE](/actions/how-tos/monitor-workflows/enable-debug-logging).

content/actions/how-tos/troubleshoot-workflows.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,23 @@ For path filtering, evaluating diffs is limited to the first 300 files. If there
9898

9999
Workflow execution involves any issues seen after the workflow was triggered and a workflow run has been created.
100100

101+
{% ifversion fpt or ghec %}
102+
103+
### Debugging job conditions
104+
105+
If a job was skipped unexpectedly, or ran when you expected it to be skipped, you can view the expression evaluation to understand why:
106+
107+
1. Click on the job in the workflow run.
108+
1. Download the log archive from the job's menu.
109+
1. Open the `JOB-NAME/system.txt` file.
110+
1. Look for the `Evaluating`, `Expanded`, and `Result` lines.
111+
112+
The `Expanded` line shows the actual runtime values that were substituted into your `if` condition, making it clear why the expression evaluated to `true` or `false`.
113+
114+
For more information, see [AUTOTITLE](/actions/how-tos/monitor-workflows/view-job-condition-logs).
115+
116+
{% endif %}
117+
101118
### Canceling Workflows
102119

103120
If standard cancellation through the [UI](/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/canceling-a-workflow) or [API](/rest/actions/workflow-runs?apiVersion=2022-11-28#cancel-a-workflow-run) does not process as expected, there may be a conditional statement configured for your running workflow job(s) that causes it to not cancel.

content/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,3 +37,9 @@ Skipped jobs display the message "This check was skipped."
3737
3838
> [!NOTE]
3939
> A job that is skipped will report its status as "Success". It will not prevent a pull request from merging, even if it is a required check.
40+
41+
{% ifversion fpt or ghec %}
42+
43+
To debug why a job was skipped or ran unexpectedly, you can view job condition expression logs. For more information, see [AUTOTITLE](/actions/how-tos/monitor-workflows/view-job-condition-logs).
44+
45+
{% endif %}

content/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,19 +16,27 @@ redirect_from:
1616

1717
## Currently unavailable features
1818

19-
The following features are currently unavailable on {% data variables.enterprise.data_residency_site %}.
19+
The following features are currently unavailable on {% data variables.enterprise.data_residency_site %}, but may be planned for future development.
2020

2121
| Feature | Details | More information |
2222
| :- | :- | :- |
23-
| {% data variables.product.prodname_copilot_short %} Metrics API | Currently unavailable | [AUTOTITLE](/rest/copilot/copilot-metrics) |
23+
| {% data variables.product.prodname_copilot_short %} Metrics API | Currently unavailable. | [AUTOTITLE](/rest/copilot/copilot-metrics) |
2424
| {% data variables.product.prodname_github_codespaces %} | Currently unavailable. | [AUTOTITLE](/codespaces/quickstart) |
25-
| {% data variables.product.prodname_importer %} (the "Import repository" button on {% data variables.product.prodname_dotcom_the_website %}) | Instead, the **{% data variables.product.prodname_importer_proper_name %}** is available to migrate data. See [AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer). | [AUTOTITLE](/migrations/importing-source-code/using-github-importer/about-github-importer) |
26-
| {% data variables.product.prodname_marketplace %} | Currently, apps from {% data variables.product.prodname_marketplace %} are unavailable. {% data variables.product.prodname_actions %} workflows from {% data variables.product.prodname_marketplace %} may not function as expected. For more information, see [{% data variables.product.prodname_actions %} workflows from {% data variables.product.prodname_marketplace %}](#github-actions-workflows-from-github-marketplace). | [AUTOTITLE](/search-github/searching-on-github/searching-github-marketplace)<br>[AUTOTITLE](/enterprise-server@latest/admin/configuration/configuring-github-connect/about-github-connect#github-connect-features) in the {% data variables.product.prodname_ghe_server %} documentation |
27-
| {% data variables.product.prodname_github_models %} | Currently unavailable | [AUTOTITLE](/github-models/about-github-models) |
2825
| macOS runners for {% data variables.product.prodname_actions %} | Currently unavailable. | [AUTOTITLE](/actions/using-github-hosted-runners/about-github-hosted-runners/about-github-hosted-runners) |
2926
| Maven and Gradle support for {% data variables.product.prodname_registry %} | Currently unavailable. | [AUTOTITLE](/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry) |
30-
| {% data variables.product.prodname_spark_short %} | Unavailable due to dependency on {% data variables.product.prodname_github_codespaces %} | [AUTOTITLE](/copilot/concepts/spark) |
31-
| Some features currently in {% data variables.release-phases.public_preview %} or {% data variables.release-phases.private_preview %} | Certain features that are in a preview phase on {% data variables.product.prodname_dotcom_the_website %} may not be available on {% data variables.enterprise.data_residency_site %} | |
27+
| {% data variables.product.prodname_spark_short %} | Currently unavailable. | [AUTOTITLE](/copilot/concepts/spark) |
28+
| {% data variables.product.prodname_marketplace %} | {% data variables.product.prodname_marketplace %}, as a means of searching for, purchasing, and directly installing apps and actions, is unavailable. Ecosystem apps and actions can still be discovered and installed from their source, but they may require modification to work on {% data variables.enterprise.data_residency_site %}. | [{% data variables.product.prodname_actions %} workflows from {% data variables.product.prodname_marketplace %}](#github-actions-workflows-from-github-marketplace) |
29+
| Certain features of {% data variables.product.prodname_github_connect %} | Although you can connect an enterprise on {% data variables.enterprise.data_residency_site %} to a {% data variables.product.prodname_ghe_server %} instance, certain features of {% data variables.product.prodname_github_connect %} are not available, including resolution of actions from {% data variables.product.prodname_dotcom_the_website %}. | [{% data variables.product.prodname_github_connect %}](#github-connect) |
30+
| Some features currently in {% data variables.release-phases.public_preview %} or {% data variables.release-phases.private_preview %} | Certain features that are in a preview phase on {% data variables.product.prodname_dotcom_the_website %} may not be available on {% data variables.enterprise.data_residency_site %} until GA. | |
31+
32+
## Permanently unavailable features
33+
34+
By design, the following features are permanently unavailable on {% data variables.enterprise.data_residency_site %}. This is generally because they are not intended for large enterprises with strict compliance requirements.
35+
36+
| Feature | Details | More information |
37+
| :- | :- | :- |
38+
| Features unavailable with {% data variables.product.prodname_emus %} | Because {% data variables.product.prodname_emus %} is the only option for identity management on {% data variables.enterprise.data_residency_site %}, features that are unavailable with {% data variables.product.prodname_emus %} on {% data variables.product.prodname_dotcom_the_website %} are also unavailable on {% data variables.enterprise.data_residency_site %}. Notably, these include gists and public repositories. | [AUTOTITLE](/admin/managing-iam/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts) |
39+
| {% data variables.product.prodname_importer %} (the "Import repository" button on {% data variables.product.prodname_dotcom_the_website %}) | Instead, the **{% data variables.product.prodname_importer_proper_name %}** is available to migrate data. See [AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer). | [AUTOTITLE](/migrations/importing-source-code/using-github-importer/about-github-importer) |
3240

3341
## Features that work differently
3442

content/code-security/concepts/secret-security/about-delegated-bypass-for-push-protection.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ topics:
1515
shortTitle: Delegated bypass
1616
redirect_from:
1717
- /code-security/secret-scanning/using-advanced-secret-scanning-and-push-protection-features/delegated-bypass-for-push-protection/about-delegated-bypass-for-push-protection
18+
- /code-security/secret-scanning/using-advanced-secret-scanning-and-push-protection-features/delegated-bypass-for-push-protection
1819
contentType: concepts
1920
---
2021

content/code-security/concepts/secret-security/about-secret-scanning.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,6 @@ Define your own patterns for secrets used by your organization that {% data vari
126126

127127
* [AUTOTITLE](/code-security/secret-scanning/enabling-secret-scanning-features/enabling-secret-scanning-for-your-repository)
128128
* [AUTOTITLE](/code-security/secret-scanning/introduction/about-push-protection)
129-
* [AUTOTITLE](/code-security/secret-scanning/working-with-secret-scanning-and-push-protection)
130129
* [AUTOTITLE](/code-security/getting-started/best-practices-for-preventing-data-leaks-in-your-organization)
131130
* [AUTOTITLE](/code-security/getting-started/securing-your-repository)
132131
* [AUTOTITLE](/authentication/keeping-your-account-and-data-secure)

content/code-security/dependabot/ecosystems-supported-by-dependabot/index.md

Lines changed: 0 additions & 19 deletions
This file was deleted.

content/code-security/dependabot/index.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,6 @@ topics:
1414
- Repositories
1515
- Dependencies
1616
children:
17-
- /ecosystems-supported-by-dependabot
1817
- /dependabot-alerts
1918
- /dependabot-auto-triage-rules
2019
- /dependabot-version-updates

content/code-security/dependabot/working-with-dependabot/index.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@ topics:
1616
children:
1717
- /automating-dependabot-with-github-actions
1818
- /configuring-multi-ecosystem-updates
19-
- /dependabot-options-reference
2019
- /setting-dependabot-to-run-on-self-hosted-runners-using-arc
2120
- /setting-dependabot-to-run-on-github-hosted-runners-using-vnet
2221
---

0 commit comments

Comments
 (0)