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/usage-limits-billing-and-administration.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -118,7 +118,7 @@ The workflow runs in a repository's workflow run history are retained for 400 da
118
118
119
119
{% data reusables.actions.disabling-github-actions %}
120
120
121
-
{% ifversion actions-cache-admin-ui %}You can also manage {% data variables.product.prodname_actions %} settings for your enterprise, such as workflow permissions and cache storage.{% endif %}
121
+
{% ifversion ghes %}You can also manage {% data variables.product.prodname_actions %} settings for your enterprise, such as workflow permissions and cache storage.{% endif %}
Copy file name to clipboardExpand all lines: content/actions/managing-workflow-runs-and-deployments/managing-deployments/managing-environments-for-deployment.md
+2-15
Original file line number
Diff line number
Diff line change
@@ -28,7 +28,7 @@ Environments are used to describe a general deployment target like `production`,
28
28
29
29
You can configure environments with protection rules and secrets. When a workflow job references an environment, the job won't start until all of the environment's protection rules pass. A job also cannot access secrets that are defined in an environment until all the deployment protection rules pass.
30
30
31
-
{% ifversion actions-break-glass %}Optionally, you can bypass an environment's protection rules and force all pending jobs referencing the environment to proceed. For more information, see [AUTOTITLE](/actions/managing-workflow-runs/reviewing-deployments#bypassing-environment-protection-rules).{% endif %}
31
+
Optionally, you can bypass an environment's protection rules and force all pending jobs referencing the environment to proceed. For more information, see [AUTOTITLE](/actions/managing-workflow-runs/reviewing-deployments#bypassing-environment-protection-rules).
32
32
33
33
{% ifversion fpt %}
34
34
@@ -41,14 +41,12 @@ You can configure environments with protection rules and secrets. When a workflo
41
41
42
42
## Deployment protection rules
43
43
44
-
Deployment protection rules require specific conditions to pass before a job referencing the environment can proceed. You can use deployment protection rules to require a manual approval, delay a job, or restrict the environment to certain branches.{% ifversion actions-custom-deployment-protection-rules-beta %} You can also create and implement custom protection rules powered by {% data variables.product.prodname_github_apps %} to use third-party systems to control deployments referencing environments configured on {% data variables.product.github %}.
44
+
Deployment protection rules require specific conditions to pass before a job referencing the environment can proceed. You can use deployment protection rules to require a manual approval, delay a job, or restrict the environment to certain branches. You can also create and implement custom protection rules powered by {% data variables.product.prodname_github_apps %} to use third-party systems to control deployments referencing environments configured on {% data variables.product.github %}.
45
45
46
46
Third-party systems can be observability systems, change management systems, code quality systems, or other manual configurations that you use to assess readiness before deployments are safely rolled out to environments.
47
47
48
48
{% data reusables.actions.custom-deployment-protection-rules-limits %}
49
49
50
-
{% endif %}
51
-
52
50
### Required reviewers
53
51
54
52
Use required reviewers to require a specific person or team to approve workflow jobs that reference the environment. You can list up to six users or teams as reviewers. The reviewers must have at least read access to the repository. Only one of the required reviewers needs to approve the job for it to proceed.
@@ -107,8 +105,6 @@ Use deployment branches{% ifversion deployment-protections-tag-patterns %} and t
107
105
108
106
{% endif %}
109
107
110
-
{% ifversion actions-break-glass %}
111
-
112
108
### Allow administrators to bypass configured protection rules
113
109
114
110
By default, administrators can bypass the protection rules and force deployments to specific environments. For more information, see [AUTOTITLE](/actions/managing-workflow-runs/reviewing-deployments#bypassing-environment-protection-rules).
@@ -121,9 +117,6 @@ Alternatively, you can configure environments to disallow bypassing the protecti
121
117
> Allowing administrators to bypass protection rules is only available for public repositories for users on {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, and {% data variables.product.prodname_team %} plans.
@@ -140,8 +133,6 @@ Once custom deployment protection rules have been created and installed on a rep
140
133
141
134
{% endif %}
142
135
143
-
{% endif %}
144
-
145
136
## Environment secrets
146
137
147
138
Secrets stored in an environment are only available to workflow jobs that reference the environment. If the environment requires approval, a job cannot access environment secrets until one of the required reviewers approves it. For more information about secrets, see [AUTOTITLE](/actions/security-guides/using-secrets-in-github-actions).
@@ -195,16 +186,12 @@ Variables stored in an environment are only available to workflow jobs that refe
195
186
1. Select **Wait timer**.
196
187
1. Enter the number of minutes to wait.
197
188
1. Click **Save protection rules**.
198
-
{%- ifversion actions-break-glass %}
199
189
1. Optionally, disallow bypassing configured protection rules. For more information, see [Allow administrators to bypass configured protection rules](#allow-administrators-to-bypass-configured-protection-rules).
200
190
1. Deselect **Allow administrators to bypass configured protection rules**.
1. Optionally, enable any custom deployment protection rules that have been created with {% data variables.product.prodname_github_apps %}. For more information, see [Custom deployment protection rules](#custom-deployment-protection-rules).
205
193
1. Select the custom protection rule you want to enable.
206
194
1. Click **Save protection rules**.
207
-
{%- endif %}
208
195
1. Optionally, specify what branches{% ifversion deployment-protections-tag-patterns %} and tags{% endif %} can deploy to this environment. For more information, see [Deployment branches{% ifversion deployment-protections-tag-patterns %} and tags{% endif %}](/actions/deployment/targeting-different-environments/managing-environments-for-deployment#deployment-branches{% ifversion deployment-protections-tag-patterns %}-and-tags{% endif %}).
209
196
1. Select the desired option in the **Deployment branches** dropdown.
210
197
1. If you chose **Selected branches{% ifversion deployment-protections-tag-patterns %} and tags{% endif %}**, to add a new rule, click **Add deployment branch{% ifversion deployment-protections-tag-patterns %} or tag{% endif %} rule**
Copy file name to clipboardExpand all lines: content/actions/managing-workflow-runs-and-deployments/managing-deployments/reviewing-deployments.md
-3
Original file line number
Diff line number
Diff line change
@@ -34,8 +34,6 @@ For more information about environments and required approvals, see [AUTOTITLE](
34
34
35
35
{% endif %}
36
36
37
-
{% ifversion actions-break-glass %}
38
-
39
37
## Bypassing deployment protection rules
40
38
41
39
If you have configured deployment protection rules that control whether software can be deployed to an environment, you can bypass these rules and force all pending jobs referencing the environment to proceed.
@@ -50,4 +48,3 @@ If you have configured deployment protection rules that control whether software
50
48
1. In the pop-up window, select the environments for which you want to bypass deployment protection rules.
51
49
1. Under **Leave a comment**, enter a description for bypassing the deployment protection rules.
52
50
1. Click **I understand the consequences, start deploying**.
Copy file name to clipboardExpand all lines: content/actions/writing-workflows/choosing-what-your-workflow-does/caching-dependencies-to-speed-up-workflows.md
+2-28
Original file line number
Diff line number
Diff line change
@@ -257,22 +257,14 @@ For example, if a pull request contains a `feature` branch and targets the defau
257
257
258
258
## Usage limits and eviction policy
259
259
260
-
{% data variables.product.prodname_dotcom %} will remove any cache entries that have not been accessed in over 7 days. There is no limit on the number of caches you can store, but the total size of all caches in a repository is limited{% ifversion actions-cache-policy-apis %}. By default, the limit is 10 GB per repository, but this limit might be different depending on policies set by your enterprise owners or repository administrators.{% else %} to 10 GB.{% endif %} {% data reusables.actions.cache-eviction-policy %}
260
+
{% data variables.product.prodname_dotcom %} will remove any cache entries that have not been accessed in over 7 days. There is no limit on the number of caches you can store, but the total size of all caches in a repository is limited{% ifversion ghes %}. By default, the limit is 10 GB per repository, but this limit might be different depending on policies set by your enterprise owners or repository administrators.{% else %} to 10 GB.{% endif %} {% data reusables.actions.cache-eviction-policy %}
261
261
262
-
{% data reusables.actions.cache-eviction-process %} {% ifversion actions-cache-ui %}The cache eviction process may cause cache thrashing, where caches are created and deleted at a high frequency. To reduce this, you can review the caches for a repository and take corrective steps, such as removing caching from specific workflows. For more information, see [Managing caches](#managing-caches).{% endif %}{% ifversion actions-cache-admin-ui %} You can also increase the cache size limit for a repository. For more information, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository).
263
-
264
-
{% elsif actions-cache-policy-apis %}
265
-
266
-
For information on changing the policies for the repository cache size limit, see [AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-cache-storage-in-your-enterprise) and [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository).
262
+
{% data reusables.actions.cache-eviction-process %} The cache eviction process may cause cache thrashing, where caches are created and deleted at a high frequency. To reduce this, you can review the caches for a repository and take corrective steps, such as removing caching from specific workflows. For more information, see [Managing caches](#managing-caches).{% ifversion ghes %} You can also increase the cache size limit for a repository. For more information, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository).
267
263
268
264
{% endif %}
269
265
270
-
{% ifversion actions-cache-management %}
271
-
272
266
## Managing caches
273
267
274
-
{% ifversion actions-cache-ui %}
275
-
276
268
To manage caches created from your workflows, you can:
277
269
278
270
* View a list of all cache entries for a repository.
@@ -289,16 +281,6 @@ There are multiple ways to manage caches for your repositories:
289
281
> [!NOTE]
290
282
> If you are doing this manually, ensure you have version 2.32.0 or higher of the CLI installed.
291
283
292
-
{% else %}
293
-
294
-
You can use the {% data variables.product.product_name %} REST API to manage your caches. {% ifversion actions-cache-list-delete-apis %}You can use the API to list and delete cache entries, and see your cache usage.{% elsif actions-cache-management %}At present, you can use the API to see your cache usage, with more functionality expected in future updates.{% endif %} For more information, see [AUTOTITLE](/rest/actions/cache).
295
-
296
-
You can also install a {% data variables.product.prodname_cli %} extension to manage your caches from the command line. For more information about the extension, see [the extension documentation](https://github.com/actions/gh-actions-cache#readme). For more information about {% data variables.product.prodname_cli %} extensions, see [AUTOTITLE](/github-cli/github-cli/using-github-cli-extensions).
297
-
298
-
{% endif %}
299
-
300
-
{% ifversion actions-cache-ui %}
301
-
302
284
### Viewing cache entries
303
285
304
286
You can use the web interface to view a list of cache entries for a repository. In the cache list, you can see how much disk space each cache is using, when the cache was created, and when the cache was last used.
@@ -324,12 +306,6 @@ Users with `write` access to a repository can use the {% data variables.product.
324
306
325
307

326
308
327
-
{% endif %}
328
-
329
-
{% endif %}
330
-
331
-
{% ifversion actions-cache-list-delete-apis %}
332
-
333
309
### Force deleting cache entries
334
310
335
311
Caches have branch scope restrictions in place, which means some caches have limited usage options. For more information on cache scope restrictions, see [Restrictions for accessing a cache](#restrictions-for-accessing-a-cache), earlier in this article. If caches limited to a specific branch are using a lot of storage quota, it may cause caches from the `default` branch to be created and deleted at a high frequency.
@@ -371,5 +347,3 @@ jobs:
371
347
```
372
348
373
349
Alternatively, you can use the API to automatically list or delete all caches on your own cadence. For more information, see [AUTOTITLE](/rest/actions/cache#about-the-cache-in-github-actions).
Copy file name to clipboardExpand all lines: content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -111,7 +111,7 @@ By default, artifacts and log files generated by workflows are retained for 90 d
111
111
112
112
Changes only apply to new artifacts and log files.
113
113
114
-
{% ifversion actions-cache-policy-apis %}
114
+
{% ifversion ghes %}
115
115
116
116
### Maximum and default cache size limits
117
117
@@ -124,7 +124,7 @@ By default:
124
124
125
125
You can customize both the default total cache size for each repository and the maximum total cache size allowed for a repository. For example, you might want the default total cache size for each repository to be 5 GB, but also allow administrators to configure a total cache size up to 15 GB for individual repositories.
126
126
127
-
{% ifversion actions-cache-admin-ui %}Organization owners can set a lower total cache size that applies to each repository in their organization. {% endif %}People with admin access to a repository can set a total cache size for their repository up to the maximum cache size allowed by the enterprise {% ifversion actions-cache-admin-ui %}or organization{% endif %} policy setting.
127
+
Organization owners can set a lower total cache size that applies to each repository in their organization. People with admin access to a repository can set a total cache size for their repository up to the maximum cache size allowed by the enterprise or organization policy setting.
Copy file name to clipboardExpand all lines: content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md
-4
Original file line number
Diff line number
Diff line change
@@ -41,13 +41,9 @@ If you're a member of an {% data variables.enterprise.prodname_emu_enterprise %}
41
41
> * If you're a member{% ifversion fpt or ghec %} or billing manager{% endif %} of an organization that requires 2FA, you will be unable to access that organization's resources while you have 2FA disabled.
42
42
> * If you disable 2FA, you will automatically lose access to the organization. To regain access to the organization, if you're a member{% ifversion fpt or ghec %} or billing manager{% endif %}, you must re-enable 2FA. If you're an outside collaborator, you will also lose access to any private forks you have of the organization's private repositories after disabling 2FA, and must re-enable 2FA and contact an organization owner to have access restored.
43
43
44
-
{% ifversion 2fa-reconfiguration-inline-update %}
45
-
46
44
> [!NOTE]
47
45
> You can reconfigure your 2FA settings without disabling 2FA entirely, allowing you to keep both your recovery codes and your membership in organizations that require 2FA.
48
46
49
-
{% endif %}
50
-
51
47
## Configuring two-factor authentication using a TOTP app
52
48
53
49
A time-based one-time password (TOTP) application automatically generates an authentication code that changes after a certain period of time. These apps can be downloaded to your phone or desktop. We recommend using cloud-based TOTP apps. {% data variables.product.prodname_dotcom %} is app-agnostic when it comes to TOTP apps, so you have the freedom to choose any TOTP app you prefer. Just search for `TOTP app` in your browser to find various options. You can also refine your search by adding keywords like `free` or `open source` to match your preferences.
Copy file name to clipboardExpand all lines: content/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -190,7 +190,7 @@ By default, when you create a new organization, workflows are not allowed to {%
190
190
191
191
## Managing {% data variables.product.prodname_actions %} cache storage for your organization
192
192
193
-
Organization administrators can view {% ifversion actions-cache-admin-ui %}and manage {% endif %}{% data variables.product.prodname_actions %} cache storage for all repositories in the organization.
193
+
Organization administrators can view {% ifversion ghes %}and manage {% endif %}{% data variables.product.prodname_actions %} cache storage for all repositories in the organization.
194
194
195
195
### Viewing {% data variables.product.prodname_actions %} cache storage by repository
196
196
@@ -202,7 +202,7 @@ For each repository in your organization, you can see how much cache storage a r
202
202
1. In the left sidebar, click **{% octicon "play" aria-hidden="true" %} Actions**, then click **Caches**.
203
203
1. Review the list of repositories for information about their {% data variables.product.prodname_actions %} caches. You can click on a repository name to see more detail about the repository's caches.
204
204
205
-
{% ifversion actions-cache-admin-ui %}
205
+
{% ifversion ghes %}
206
206
207
207
### Configuring {% data variables.product.prodname_actions %} cache storage for your organization
Copy file name to clipboardExpand all lines: content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md
+2-5
Original file line number
Diff line number
Diff line change
@@ -203,20 +203,17 @@ You can also define a custom retention period for a specific artifact created by
203
203
{% data reusables.repositories.settings-sidebar-actions-general %}
204
204
{% data reusables.actions.change-retention-period-for-artifacts-logs %}
205
205
206
-
{% ifversion actions-cache-policy-apis %}
206
+
{% ifversion ghes %}
207
207
208
208
## Configuring cache storage for a repository
209
209
210
210
{% data reusables.actions.cache-default-size %} However, these default sizes might be different if an enterprise owner has changed them. {% data reusables.actions.cache-eviction-process %}
211
211
212
-
You can set a total cache storage size for your repository up to the maximum size allowed by the {% ifversion actions-cache-admin-ui %}organization or{% endif %} enterprise policy setting{% ifversion actions-cache-admin-ui %}s{% endif %}.
213
-
214
-
{% ifversion actions-cache-admin-ui %}
212
+
You can set a total cache storage size for your repository up to the maximum size allowed by the organization or enterprise policy settings.
215
213
216
214
{% data reusables.repositories.navigate-to-repo %}
217
215
{% data reusables.repositories.sidebar-settings %}
218
216
{% data reusables.repositories.settings-sidebar-actions-general %}
219
217
{% data reusables.actions.change-cache-size-limit %}
Environments are used to describe a general deployment target like `production`, `staging`, or `development`. When a {% data variables.product.prodname_actions %} workflow deploys to an environment, the environment is displayed on the main page of the repository. You can use environments to require approval for a job to proceed, restrict which branches can trigger a workflow{% ifversion actions-custom-deployment-protection-rules-beta %}, gate deployments with custom deployment protection rules{% endif %}, or limit access to secrets. For more information about creating environments, see [AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment).
1
+
Environments are used to describe a general deployment target like `production`, `staging`, or `development`. When a {% data variables.product.prodname_actions %} workflow deploys to an environment, the environment is displayed on the main page of the repository. You can use environments to require approval for a job to proceed, restrict which branches can trigger a workflow, gate deployments with custom deployment protection rules, or limit access to secrets. For more information about creating environments, see [AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment).
0 commit comments