You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/actions/administering-github-actions/sharing-workflows-secrets-and-runners-with-your-organization.md
+3-3
Original file line number
Diff line number
Diff line change
@@ -19,15 +19,15 @@ type: how_to
19
19
20
20
If you need to share workflows and other {% data variables.product.prodname_actions %} features with your team, then consider collaborating within a {% data variables.product.prodname_dotcom %} organization. An organization allows you to centrally store and manage secrets, artifacts, and self-hosted runners. You can also create workflow templates in the `.github` repository and share them with other users in your organization.
21
21
22
-
## Sharing {% ifversion internal-actions %}actions and {% endif %}workflows
22
+
## Sharing {% ifversion ghec or ghes %}actions and {% endif %}workflows
23
23
24
-
{% ifversion internal-actions %}
24
+
{% ifversion ghec or ghes %}
25
25
You can share both individual actions and entire workflows with your organization, with or without publishing the actions or workflows publicly. You can reuse actions and workflows exactly by referencing them in your workflow file, and you can create workflow templates.
26
26
{% else %}
27
27
Your organization can share workflows by reusing the workflows exactly or by creating workflow templates
Copy file name to clipboardExpand all lines: content/actions/sharing-automations/creating-actions/about-custom-actions.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -25,7 +25,7 @@ topics:
25
25
You can create actions by writing custom code that interacts with your repository in any way you'd like, including integrating with {% data variables.product.prodname_dotcom %}'s APIs and any publicly available third-party API. For example, an action can publish npm modules, send SMS alerts when urgent issues are created, or deploy production-ready code.
26
26
27
27
{% ifversion fpt or ghec %}
28
-
You can write your own actions to use in your workflow or share the actions you build with the {% data variables.product.prodname_dotcom %} community. To share actions you've built with everyone, your repository must be public. {% ifversion internal-actions %}To share actions only within your enterprise, your repository must be internal.{% endif %}
28
+
You can write your own actions to use in your workflow or share the actions you build with the {% data variables.product.prodname_dotcom %} community. To share actions you've built with everyone, your repository must be public. {% ifversion ghec %}To share actions only within your enterprise, your repository must be internal.{% endif %}
29
29
{% endif %}
30
30
31
31
Actions can run directly on a machine or in a Docker container. You can define an action's inputs, outputs, and environment variables.
Copy file name to clipboardExpand all lines: content/actions/sharing-automations/reusing-workflows.md
+3-11
Original file line number
Diff line number
Diff line change
@@ -60,7 +60,7 @@ A reusable workflow can be used by another workflow if any of the following is t
60
60
You cannot directly use reusable workflows defined on {% data variables.product.prodname_dotcom_the_website %}. Instead store a copy of the reusable workflow on {% data variables.location.product_location %}, and call the workflow from that path.
61
61
62
62
{% elsif actions-workflow-policy %}, and your {% ifversion ghec %}enterprise{% else %}organization{% endif %} allows you to use public reusable workflows.{% endif %}{% ifversion ghes or ghec %}
63
-
* The called workflow is stored in an internal repository and the settings for that repository allow it to be accessed. For more information, see {% ifversion internal-actions %}[AUTOTITLE](/actions/creating-actions/sharing-actions-and-workflows-with-your-enterprise){% else %}[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-an-internal-repository){% endif %}.{% endif %}
63
+
* The called workflow is stored in an internal repository and the settings for that repository allow it to be accessed. For more information, see [AUTOTITLE](/actions/creating-actions/sharing-actions-and-workflows-with-your-enterprise).{% endif %}
64
64
* The called workflow is stored in a private repository and the settings for that repository allow it to be accessed. For more information, see {% ifversion ghes or ghec %}[AUTOTITLE](/actions/creating-actions/sharing-actions-and-workflows-with-your-enterprise).{% else %}[AUTOTITLE](/actions/creating-actions/sharing-actions-and-workflows-with-your-organization) and [AUTOTITLE](/actions/creating-actions/sharing-actions-and-workflows-from-your-private-repository).{% endif %}
65
65
66
66
The following table shows the accessibility of reusable workflows to a caller workflow, depending on the visibility of the host repository.
@@ -93,15 +93,11 @@ Called workflows that are owned by the same user or organization{% ifversion ghe
93
93
94
94
## Limitations
95
95
96
-
{% ifversion nested-reusable-workflow %}
97
96
* You can connect up to four levels of workflows. For more information, see [Nesting reusable workflows](#nesting-reusable-workflows).
98
97
* You can call a maximum of 20 unique reusable workflows from a single workflow file. This limit includes any trees of nested reusable workflows that may be called starting from your top-level caller workflow file.
99
98
100
99
For example, _top-level-caller-workflow.yml_ → _called-workflow-1.yml_ → _called-workflow-2.yml_ counts as 2 reusable workflows.
101
-
{% else %}
102
-
* Reusable workflows can't call other reusable workflows.
103
-
* You can call a maximum of 20 unique reusable workflows from a single workflow file.
104
-
{% endif %}
100
+
105
101
* Any environment variables set in an `env` context defined at the workflow level in the caller workflow are not propagated to the called workflow. For more information, see [AUTOTITLE](/actions/learn-github-actions/variables) and [AUTOTITLE](/actions/learn-github-actions/contexts#env-context).
106
102
* Similarly, environment variables set in the `env` context, defined in the called workflow, are not accessible in the `env` context of the caller workflow. Instead, you must use outputs of the reusable workflow. For more information, see [Using outputs from a reusable workflow](#using-outputs-from-a-reusable-workflow).
107
103
* To reuse variables in multiple workflows, set them at the organization, repository, or environment levels and reference them using the `vars` context. For more information see [AUTOTITLE](/actions/learn-github-actions/variables) and [AUTOTITLE](/actions/learn-github-actions/contexts#vars-context).
@@ -294,8 +290,6 @@ jobs:
294
290
295
291
{% endraw %}
296
292
297
-
{% ifversion nested-reusable-workflow %}
298
-
299
293
## Nesting reusable workflows
300
294
301
295
You can connect a maximum of four levels of workflows - that is, the top-level caller workflow and up to three levels of reusable workflows. For example: _caller-workflow.yml_ → _called-workflow-1.yml_ → _called-workflow-2.yml_ → _called-workflow-3.yml_. Loops in the workflow tree are not permitted.
@@ -349,7 +343,6 @@ A workflow that contains nested reusable workflows will fail if any of the neste
349
343
`GITHUB_TOKEN` permissions can only be the same or more restrictive in nested workflows. For example, in the workflow chain A > B > C, if workflow A has `package: read` token permission, then B and C cannot have `package: write` permission. For more information, see [AUTOTITLE](/actions/security-guides/automatic-token-authentication).
350
344
351
345
For information on how to use the API to determine which workflow files were involved in a particular workflow run, see [Monitoring which workflows are being used](#monitoring-which-workflows-are-being-used).
352
-
{% endif %}
353
346
354
347
## Using outputs from a reusable workflow
355
348
@@ -428,9 +421,8 @@ You can use the {% data variables.product.prodname_dotcom %} REST API to monitor
428
421
* `repo` - the organization/repository where the workflow job is located. For a job that calls another workflow, this is the organization/repository of the caller workflow.
429
422
* `@timestamp` - the date and time that the job was started, in Unix epoch format.
430
423
* `job_name` - the name of the job that was run.
431
-
{% ifversion nested-reusable-workflow %}
432
424
* `calling_workflow_refs` - an array of file paths for all the caller workflows involved in this workflow job. The items in the array are in the reverse order that they were called in. For example, in a chain of workflows A > B > C, when viewing the logs for a job in workflow C, the array would be `["octo-org/octo-repo/.github/workflows/B.yml", "octo-org/octo-repo/.github/workflows/A.yml"]`.
433
-
* `calling_workflow_shas` - an array of SHAs for all the caller workflows involved in this workflow job. The array contains the same number of items, in the same order, as the `calling_workflow_refs` array. {% endif %}
425
+
* `calling_workflow_shas` - an array of SHAs for all the caller workflows involved in this workflow job. The array contains the same number of items, in the same order, as the `calling_workflow_refs` array.
434
426
* `job_workflow_ref` - the workflow file that was used, in the form `{owner}/{repo}/{path}/{filename}@{ref}`. For a job that calls another workflow, this identifies the called workflow.
435
427
436
428
For information about using the REST API to query the audit log for an organization, see [AUTOTITLE](/rest/orgs#get-the-audit-log-for-an-organization).
## About {% data variables.product.prodname_actions %} access to private {% ifversion internal-actions %} or internal {% endif %}repositories
15
+
## About {% data variables.product.prodname_actions %} access to private {% ifversion ghec or ghes %} or internal {% endif %}repositories
16
16
17
17
You can share actions and reusable workflows within your organization, without publishing them publicly, by allowing {% data variables.product.prodname_actions %} workflows to access a private repository that contains the action or reusable workflow.
18
18
@@ -24,7 +24,7 @@ Any actions or reusable workflows stored in the private repository can be used i
24
24
25
25
## Sharing actions and workflows with your organization
26
26
27
-
1. Store the action or reusable workflow in a private {% ifversion internal-actions %} or internal {% endif %}repository. For more information, see [AUTOTITLE](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility).
27
+
1. Store the action or reusable workflow in a private {% ifversion ghec or ghes %} or internal {% endif %}repository. For more information, see [AUTOTITLE](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility).
28
28
1. Configure the repository to allow access to workflows in other private repositories. For more information, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-a-private-repository).
Copy file name to clipboardExpand all lines: content/actions/writing-workflows/choosing-what-your-workflow-does/store-information-in-variables.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -284,7 +284,7 @@ We strongly recommend that actions use variables to access the filesystem rather
284
284
| `GITHUB_RUN_ATTEMPT` | A unique number for each attempt of a particular workflow run in a repository. This number begins at 1 for the workflow run's first attempt, and increments with each re-run. For example, `3`. |
285
285
| `GITHUB_RUN_ID` | {% data reusables.actions.run_id_description %} For example, `1658821493`. |
286
286
| `GITHUB_RUN_NUMBER` | {% data reusables.actions.run_number_description %} For example, `3`. |
287
-
| `GITHUB_SERVER_URL`| The URL of {% data variables.location.product_location_enterprise %}. For example: `https://{% data variables.product.product_url %}`. |
287
+
| `GITHUB_SERVER_URL`| The URL of the {% data variables.product.github %} server. For example: `https://{% data variables.product.product_url %}`. |
288
288
| `GITHUB_SHA` | {% data reusables.actions.github_sha_description %} |
289
289
| `GITHUB_STEP_SUMMARY` | The path on the runner to the file that contains job summaries from workflow commands. The path to this file is unique to the current step and changes for each step in a job. For example, `/home/runner/_layout/_work/_temp/_runner_file_commands/step_summary_1cb22d7f-5663-41a8-9ffc-13472605c76c`. For more information, see [AUTOTITLE](/actions/using-workflows/workflow-commands-for-github-actions#adding-a-job-summary). |
290
290
| `GITHUB_TRIGGERING_ACTOR` | {% data reusables.actions.github-triggering-actor-description %} |
Copy file name to clipboardExpand all lines: content/actions/writing-workflows/choosing-what-your-workflow-does/using-pre-written-building-blocks-in-your-workflow.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ Actions can be:
33
33
34
34
The actions you use in your workflow can be defined in:
35
35
36
-
* The same repository as your workflow file{% ifversion internal-actions %}
36
+
* The same repository as your workflow file{% ifversion ghec or ghes %}
37
37
* An internal repository within the same enterprise account that is configured to allow access to workflows{% endif %}
38
38
* Any public repository
39
39
* A published Docker container image on Docker Hub
@@ -91,7 +91,7 @@ The `action.yml` file is used to provide metadata for the action. Learn about th
91
91
92
92
If an action is defined in a different repository than your workflow file, you can reference the action with the `{owner}/{repo}@{ref}` syntax in your workflow file.
93
93
94
-
The action must be stored in a public repository{% ifversion internal-actions %} or an internal repository that is configured to allow access to workflows. For more information, see [AUTOTITLE](/actions/creating-actions/sharing-actions-and-workflows-with-your-enterprise).{% else %}.{% endif %}
94
+
The action must be stored in a public repository{% ifversion ghec or ghes %} or an internal repository that is configured to allow access to workflows. For more information, see [AUTOTITLE](/actions/creating-actions/sharing-actions-and-workflows-with-your-enterprise).{% else %}.{% endif %}
Copy file name to clipboardExpand all lines: content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/about-the-management-console.md
-4
Original file line number
Diff line number
Diff line change
@@ -24,12 +24,8 @@ To access the {% data variables.enterprise.management_console %}, you can use th
24
24
25
25
The {% data variables.enterprise.management_console %} password hash is stored in `/data/user/common/secrets.conf`. If high availability or clustering is configured, the file is automatically synced from the primary node to any additional nodes. Any change to the primary's password will automatically be replicated to all of the instance's nodes. For more information about high availability, see [AUTOTITLE](/admin/enterprise-management/configuring-high-availability/about-high-availability-configuration).
When someone performs an action in the {% data variables.enterprise.management_console %} via the web interface or REST API, an event appears in the audit log. For more information, see [AUTOTITLE](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise).
30
28
31
-
{% endif %}
32
-
33
29
## Examples of activities in the {% data variables.enterprise.management_console %}
34
30
35
31
In the {% data variables.enterprise.management_console %}, you can perform administrative tasks for {% data variables.location.product_location %}, including:
Copy file name to clipboardExpand all lines: content/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode.md
-10
Original file line number
Diff line number
Diff line change
@@ -70,20 +70,10 @@ You can also use a command-line utility to configure the IP exception list. For
70
70
{% data reusables.enterprise_management_console.custom-maintenance-message %}
71
71
1. Click **Save**.
72
72
73
-
{% ifversion maintenance-management-api %}
74
-
75
73
## Managing maintenance mode using the REST API
76
74
77
75
You can manage maintenance mode on {% data variables.location.product_location %} using the REST API. For more information, see [AUTOTITLE](/rest/enterprise-admin/manage-ghes#get-the-status-of-maintenance-mode).
78
76
79
-
{% else %}
80
-
81
-
## Scheduling maintenance mode with the {% data variables.product.prodname_enterprise_api %}
82
-
83
-
You can schedule maintenance for different times or dates with the {% data variables.product.prodname_enterprise_api %}. For more information, see [AUTOTITLE](/rest/enterprise-admin/management-console#enable-or-disable-maintenance-mode).
84
-
85
-
{% endif %}
86
-
87
77
{% ifversion ghes-manage-api-cli-extension %}
88
78
89
79
## Managing maintenance mode using the {% data variables.product.prodname_cli %}
Copy file name to clipboardExpand all lines: content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md
-4
Original file line number
Diff line number
Diff line change
@@ -75,10 +75,6 @@ With reusable workflows, your team can call one workflow from another workflow,
75
75
76
76
To provide a starting place for developers building new workflows, you can use workflow templates. This not only saves time for your developers, but promotes consistency and best practice across your enterprise. For more information, see [AUTOTITLE](/actions/using-workflows/creating-starter-workflows-for-your-organization).
77
77
78
-
{% ifversion not internal-actions %}
79
-
Whenever your workflow developers want to use an action that's stored in a private repository, they must configure the workflow to clone the repository first. To reduce the number of repositories that must be cloned, consider grouping commonly used actions in a single repository. For more information, see [AUTOTITLE](/actions/creating-actions/about-custom-actions#choosing-a-location-for-your-action).
80
-
{% endif %}
81
-
82
78
## Managing resources
83
79
84
80
You should plan for how you'll manage the resources required to use {% data variables.product.prodname_actions %}.
Copy file name to clipboardExpand all lines: content/admin/upgrading-your-instance/troubleshooting-upgrades/known-issues-with-upgrades-to-your-instance.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ redirect_from:
21
21
22
22
{% data variables.product.company_short %} strongly recommends regular backups of your instance's configuration and data. Before you proceed with any upgrade, back up your instance, then validate the backup in a staging environment. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance) and [AUTOTITLE](/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance).
23
23
24
-
{% ifversion mysql-8-upgrade %}
24
+
{% ifversion ghes = 3.10 %}
25
25
26
26
## Increased I/O utilization from MySQL 8 upgrade in {% data variables.product.prodname_ghe_server %} 3.9 or later
Copy file name to clipboardExpand all lines: content/authentication/authenticating-with-saml-single-sign-on/index.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Authenticating with SAML single sign-on
3
-
intro: 'You can authenticate to {% data variables.product.product_name %} with SAML single sign-on (SSO){% ifversion ghec %} and view your active sessions{% endif %}.'
3
+
intro: 'You can authenticate to {% data variables.product.github %} with SAML single sign-on (SSO){% ifversion ghec %} and view your active sessions{% endif %}.'
0 commit comments