From 3996e27a1baa31bd35888ff2f7cebfeee8634d4e Mon Sep 17 00:00:00 2001 From: docubot <67483024+docubot@users.noreply.github.com> Date: Wed, 30 Nov 2022 09:22:25 -0800 Subject: [PATCH] New translation batch for ru (#33101) --- translations/log/msft-ru-resets.csv | 9 +- .../adding-labels-to-issues.md | 43 ++-- ...card-is-added-to-a-project-board-column.md | 59 +++--- ...o-your-enterprise-with-an-ip-allow-list.md | 24 +-- .../upgrading-github-enterprise-server.md | 1 + .../about-server-statistics.md | 143 +++++++------ ...bership-information-for-your-enterprise.md | 14 +- .../viewing-and-updating-dependabot-alerts.md | 10 + ...ion-options-for-the-dependabot.yml-file.md | 22 +- ...creating-a-repository-security-advisory.md | 46 ++--- ...-github-codespaces-plugin-for-jetbrains.md | 23 +-- .../introduction-to-dev-containers.md | 193 +++++++++--------- ...oubleshooting-github-codespaces-clients.md | 62 ++++-- ...-with-github-copilot-in-a-jetbrains-ide.md | 124 +++++------ ...th-github-copilot-in-visual-studio-code.md | 88 ++++---- ...ed-with-github-copilot-in-visual-studio.md | 84 ++++---- .../about-marketplace-badges.md | 12 +- ...management-system-with-github-classroom.md | 36 ++-- .../using-the-graphql-api-for-discussions.md | 12 +- .../automatically-generated-release-notes.md | 124 ++++++----- .../reusables/copilot/copilot-cta-button.md | 9 + .../discussions/repository-category-limit.md | 12 +- 22 files changed, 625 insertions(+), 525 deletions(-) create mode 100644 translations/ru-RU/data/reusables/copilot/copilot-cta-button.md diff --git a/translations/log/msft-ru-resets.csv b/translations/log/msft-ru-resets.csv index d7647d275e..e594095940 100644 --- a/translations/log/msft-ru-resets.csv +++ b/translations/log/msft-ru-resets.csv @@ -646,7 +646,6 @@ translations/ru-RU/content/admin/installation/setting-up-a-github-enterprise-ser translations/ru-RU/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-openstack-kvm.md,rendering error translations/ru-RU/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-vmware.md,rendering error translations/ru-RU/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md,rendering error -translations/ru-RU/content/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics.md,rendering error translations/ru-RU/content/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/exporting-server-statistics.md,rendering error translations/ru-RU/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity/managing-global-webhooks.md,rendering error translations/ru-RU/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/about-the-audit-log-for-your-enterprise.md,rendering error @@ -806,6 +805,7 @@ translations/ru-RU/content/code-security/secret-scanning/secret-scanning-pattern translations/ru-RU/content/code-security/security-advisories/global-security-advisories/about-the-github-advisory-database.md,rendering error translations/ru-RU/content/code-security/security-advisories/guidance-on-reporting-and-writing/privately-reporting-a-security-vulnerability.md,rendering error translations/ru-RU/content/code-security/security-advisories/repository-security-advisories/configuring-private-vulnerability-reporting-for-a-repository.md,rendering error +translations/ru-RU/content/code-security/security-advisories/repository-security-advisories/creating-a-repository-security-advisory.md,rendering error translations/ru-RU/content/code-security/security-overview/about-the-security-overview.md,rendering error translations/ru-RU/content/code-security/security-overview/filtering-alerts-in-the-security-overview.md,rendering error translations/ru-RU/content/code-security/security-overview/index.md,rendering error @@ -817,20 +817,16 @@ translations/ru-RU/content/code-security/supply-chain-security/understanding-you translations/ru-RU/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-the-dependency-graph.md,rendering error translations/ru-RU/content/codespaces/codespaces-reference/security-in-github-codespaces.md,broken liquid tags translations/ru-RU/content/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository.md,rendering error -translations/ru-RU/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md,broken liquid tags +translations/ru-RU/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md,rendering error translations/ru-RU/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md,broken liquid tags translations/ru-RU/content/codespaces/overview.md,rendering error -translations/ru-RU/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md,broken liquid tags translations/ru-RU/content/codespaces/the-githubdev-web-based-editor.md,broken liquid tags translations/ru-RU/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md,rendering error translations/ru-RU/content/communities/documenting-your-project-with-wikis/about-wikis.md,rendering error translations/ru-RU/content/communities/documenting-your-project-with-wikis/changing-access-permissions-for-wikis.md,rendering error translations/ru-RU/content/communities/documenting-your-project-with-wikis/editing-wiki-content.md,rendering error translations/ru-RU/content/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors.md,rendering error -translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md,broken liquid tags translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-neovim.md,rendering error -translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md,broken liquid tags -translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md,broken liquid tags translations/ru-RU/content/copilot/quickstart.md,broken liquid tags translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop.md,rendering error translations/ru-RU/content/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/index.md,rendering error @@ -1089,6 +1085,7 @@ translations/ru-RU/content/repositories/managing-your-repositorys-settings-and-f translations/ru-RU/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-commit-signoff-policy-for-your-repository.md,rendering error translations/ru-RU/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility.md,rendering error translations/ru-RU/content/repositories/releasing-projects-on-github/about-releases.md,rendering error +translations/ru-RU/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md,rendering error translations/ru-RU/content/repositories/releasing-projects-on-github/comparing-releases.md,rendering error translations/ru-RU/content/repositories/releasing-projects-on-github/linking-to-releases.md,rendering error translations/ru-RU/content/repositories/releasing-projects-on-github/managing-releases-in-a-repository.md,rendering error diff --git a/translations/ru-RU/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md b/translations/ru-RU/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md index f0982f0d25..999b678c08 100644 --- a/translations/ru-RU/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md +++ b/translations/ru-RU/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md @@ -13,32 +13,30 @@ type: tutorial topics: - Workflows - Project management -ms.openlocfilehash: e5cb19c98e2d136e67a14726c9edff328f299034 -ms.sourcegitcommit: 7b86410fc3bc9fecf0cb71dda4c7d2f0da745b85 +ms.openlocfilehash: a3523069b9422ecd8107007ca5e00fb0071dd738 +ms.sourcegitcommit: 4d6d3735d32540cb6de3b95ea9a75b8b247c580d ms.translationtype: MT ms.contentlocale: ru-RU -ms.lasthandoff: 10/05/2022 -ms.locfileid: '148010032' +ms.lasthandoff: 11/30/2022 +ms.locfileid: '148185564' --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} ## Введение -В этом руководстве показано, как использовать [действие `andymckay/labeler`](https://github.com/marketplace/actions/simple-issue-labeler) в рабочем процессе для добавления меток к новым открытым или повторно открытым проблемам. Например, метку `triage` можно добавлять при каждом открытии или повторном открытии проблемы. Затем можно просмотреть все проблемы, которые необходимо уделить внимание, отфильтровав проблемы с меткой `triage`. +В этом руководстве показано, как использовать [действие `actions/github-script`](https://github.com/marketplace/actions/github-script) в рабочем процессе для добавления меток к новым открытым или повторно открытым проблемам. Например, метку `triage` можно добавлять при каждом открытии или повторном открытии проблемы. Затем можно просмотреть все проблемы, которые необходимо уделить внимание, отфильтровав проблемы с меткой `triage`. -В этом руководстве вы сначала создадите файл рабочего процесса, использующий [действие `andymckay/labeler`](https://github.com/marketplace/actions/simple-issue-labeler). Затем вы настроите рабочий процесс в соответствии с вашими потребностями. +Это `actions/github-script` действие позволяет легко использовать API {% data variables.product.prodname_dotcom %} в рабочем процессе. + +В этом руководстве вы сначала создадите файл рабочего процесса, использующий [действие `actions/github-script`](https://github.com/marketplace/actions/github-script). Затем вы настроите рабочий процесс в соответствии с вашими потребностями. ## Создание рабочего процесса 1. {% data reusables.actions.choose-repo %} 2. {% data reusables.actions.make-workflow-file %} 3. Скопируйте следующее содержимое YAML в файл рабочего процесса. - + ```yaml{:copy} -{% indented_data_reference reusables.actions.actions-not-certified-by-github-comment spaces=4 %} - -{% indented_data_reference reusables.actions.actions-use-sha-pinning-comment spaces=4 %} - name: Label issues on: issues: @@ -51,15 +49,20 @@ ms.locfileid: '148010032' permissions: issues: write steps: - - name: Label issues - uses: andymckay/labeler@e6c4322d0397f3240f0e7e30a33b5c5df2d39e90 + - uses: {% data reusables.actions.action-github-script %} with: - add-labels: "triage" - repo-token: {% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %} + script: | + github.rest.issues.addLabels({ + issue_number: context.issue.number, + owner: context.repo.owner, + repo: context.repo.repo, + labels: ["triage"] + }) ``` -4. Настройте параметры в файле рабочего процесса. - - В качестве значения для `add-labels` укажите список меток, которые вы хотите добавить к проблеме. Несколько меток следует разделять запятыми. Например, `"help wanted, good first issue"`. Дополнительные сведения о метках см. в статье "[Управление метками](/github/managing-your-work-on-github/managing-labels#applying-labels-to-issues-and-pull-requests)". +4. `script` Настройте параметр в файле рабочего процесса: + - Значения `issue_number`, `owner`и `repo` задаются автоматически с помощью `context` объекта . Изменять их не нужно. + - В качестве значения для `labels` укажите список меток, которые вы хотите добавить к проблеме. Несколько меток следует разделять запятыми. Например, `["help wanted", "good first issue"]`. Дополнительные сведения о метках см. в статье "[Управление метками](/github/managing-your-work-on-github/managing-labels#applying-labels-to-issues-and-pull-requests)". 5. {% data reusables.actions.commit-workflow %} ## Тестирование рабочего процесса @@ -74,6 +77,6 @@ ms.locfileid: '148010032' ## Дальнейшие действия -- Дополнительные сведения о задачах, которые можно выполнять с помощью действия `andymckay/labeler`, например удаление меток или пропуск этого действия, если проблема назначена или имеет определенную метку, см. в [документации по действию `andymckay/labeler`](https://github.com/marketplace/actions/simple-issue-labeler). -- Дополнительные сведения о различных событиях, которые могут активировать рабочий процесс, см. в статье "[События, которые активируют рабочие процессы](/actions/reference/events-that-trigger-workflows#issues)". Действие `andymckay/labeler` работает только с событиями `issues`, `pull_request` или `project_card`. -- [Выполните поиск в GitHub](https://github.com/search?q=%22uses:+andymckay/labeler%22&type=code), чтобы найти примеры рабочих процессов, использующих это действие. +- Дополнительные сведения о дополнительных действиях, которые можно выполнить с `actions/github-script` помощью действия, см. в [документации по`actions/github-script` действию](https://github.com/marketplace/actions/github-script). +- Дополнительные сведения о различных событиях, которые могут активировать рабочий процесс, см. в статье "[События, которые активируют рабочие процессы](/actions/reference/events-that-trigger-workflows#issues)". +- [Выполните поиск в GitHub](https://github.com/search?q=%22uses:+actions/github-script%22&type=code), чтобы найти примеры рабочих процессов, использующих это действие. diff --git a/translations/ru-RU/content/actions/managing-issues-and-pull-requests/removing-a-label-when-a-card-is-added-to-a-project-board-column.md b/translations/ru-RU/content/actions/managing-issues-and-pull-requests/removing-a-label-when-a-card-is-added-to-a-project-board-column.md index 6bf73a24bc..995068223a 100644 --- a/translations/ru-RU/content/actions/managing-issues-and-pull-requests/removing-a-label-when-a-card-is-added-to-a-project-board-column.md +++ b/translations/ru-RU/content/actions/managing-issues-and-pull-requests/removing-a-label-when-a-card-is-added-to-a-project-board-column.md @@ -1,6 +1,6 @@ --- title: Удаление метки при добавлении карточки в столбец доски проекта -intro: 'Вы можете использовать {% data variables.product.prodname_actions %} для автоматического удаления метки при добавлении проблемы или запроса на вытягивание в определенный столбец на доске проекта.' +intro: '{% data variables.product.prodname_actions %} можно использовать для автоматического удаления метки при добавлении проблемы или запроса на вытягивание в определенный столбец в {% data variables.projects.projects_v1_board %}.' redirect_from: - /actions/guides/removing-a-label-when-a-card-is-added-to-a-project-board-column versions: @@ -13,74 +13,77 @@ topics: - Workflows - Project management shortTitle: Remove label when adding card -ms.openlocfilehash: c23edb495719c7059c9c5d8dab1c29acb0e78cb6 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT +ms.openlocfilehash: d86d9e5ad198c9cf8811b47f2a6c8a7114e20104 +ms.sourcegitcommit: 4d6d3735d32540cb6de3b95ea9a75b8b247c580d +ms.translationtype: MT ms.contentlocale: ru-RU -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147410110' +ms.lasthandoff: 11/30/2022 +ms.locfileid: '148185632' --- {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} ## Введение -В этом руководстве показано, как использовать [действие `andymckay/labeler`](https://github.com/marketplace/actions/simple-issue-labeler) с условием для удаления метки из проблем и запросов на вытягивание, добавленных в определенный столбец на доске проекта. Например, можно удалять метку `needs review` при перемещении карточки проекта в столбец `Done`. +В этом руководстве показано, как использовать [`actions/github-script` действие](https://github.com/marketplace/actions/github-script) вместе с условным для удаления метки из проблем и запросов на вытягивание, которые добавляются в определенный столбец в {% data variables.projects.projects_v1_board %}. Например, можно удалять метку `needs review` при перемещении карточки проекта в столбец `Done`. -В этом руководстве вы сначала создадите файл рабочего процесса, использующий [действие `andymckay/labeler`](https://github.com/marketplace/actions/simple-issue-labeler). Затем вы настроите рабочий процесс в соответствии с вашими потребностями. +В этом руководстве вы сначала создадите файл рабочего процесса, использующий [действие `actions/github-script`](https://github.com/marketplace/actions/github-script). Затем вы настроите рабочий процесс в соответствии с вашими потребностями. ## Создание рабочего процесса 1. {% data reusables.actions.choose-repo %} -2. Выберите проект, принадлежащий репозиторию. Этот рабочий процесс нельзя использовать с проектами, принадлежащими пользователям или организациям. Вы можете использовать существующий проект или создать новый. Дополнительные сведения о создании проекта см. в статье [Создание доски проекта](/github/managing-your-work-on-github/creating-a-project-board). +2. Выберите {% data variables.projects.projects_v1_board %}, принадлежащий репозиторию. Этот рабочий процесс нельзя использовать с проектами, принадлежащими пользователям или организациям. Можно использовать существующий {% data variables.projects.projects_v1_board %} или создать новый {% data variables.projects.projects_v1_board %}. Дополнительные сведения о создании проекта см. в разделе [Создание {% data variables.product.prodname_project_v1 %}](/github/managing-your-work-on-github/creating-a-project-board). 3. {% data reusables.actions.make-workflow-file %} 4. Скопируйте следующее содержимое YAML в файл рабочего процесса. + ```yaml{:copy} -{% indented_data_reference reusables.actions.actions-not-certified-by-github-comment spaces=4 %} - -{% indented_data_reference reusables.actions.actions-use-sha-pinning-comment spaces=4 %} - - name: Remove labels + name: Remove a label on: project_card: types: - moved jobs: - remove_labels: + remove_label: if: github.event.project_card.column_id == '12345678' runs-on: ubuntu-latest permissions: issues: write pull-requests: write steps: - - name: remove labels - uses: andymckay/labeler@5c59dabdfd4dd5bd9c6e6d255b01b9d764af4414 + - uses: {% data reusables.actions.action-github-script %} with: - remove-labels: "needs review" - repo-token: {% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %} + script: | + // this gets the number at the end of the content URL, which should be the issue/PR number + const issue_num = context.payload.project_card.content_url.split('/').pop() + github.rest.issues.removeLabel({ + issue_number: issue_num, + owner: context.repo.owner, + repo: context.repo.repo, + name: ["needs review"] + }) ``` 5. Настройте параметры в файле рабочего процесса. - В `github.event.project_card.column_id == '12345678'` замените `12345678` на идентификатор столбца, в котором нужно удалять метки из проблем и запросов на вытягивание, перемещаемых в этот столбец. - Чтобы найти идентификатор столбца, перейдите к доске проекта. Рядом с заголовком столбца щелкните {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} и выберите **Копировать ссылку на столбец**. Идентификатор столбца — это номер в конце скопированной ссылки. Например, `24687531` — это идентификатор столбца для `https://github.com/octocat/octo-repo/projects/1#column-24687531`. + Чтобы найти идентификатор столбца, перейдите к {% data variables.projects.projects_v1_board %}. Рядом с заголовком столбца щелкните {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} и выберите **Копировать ссылку на столбец**. Идентификатор столбца — это номер в конце скопированной ссылки. Например, `24687531` — это идентификатор столбца для `https://github.com/octocat/octo-repo/projects/1#column-24687531`. Если вы хотите выполнять действия сразу с несколькими столбцами, перечислите условия через `||`. Например, условие `if github.event.project_card.column_id == '12345678' || github.event.project_card.column_id == '87654321'` будет выполняться при каждом добавлении карточки проекта в столбец `12345678` или в столбец `87654321`. Столбцы могут находиться на разных досках проектов. - - Измените значение `remove-labels` на список меток, которые необходимо удалять из проблем или запросов на вытягивание при их перемещении в указанные столбцы. Несколько меток следует разделять запятыми. Например, `"help wanted, good first issue"`. Дополнительные сведения о метках см. в статье [Управление метками](/github/managing-your-work-on-github/managing-labels#applying-labels-to-issues-and-pull-requests). + - Измените значение в `name` `github.rest.issues.removeLabel()` функции на имя метки, которую нужно удалить из проблем или запросов на вытягивание, которые перемещаются в указанные столбцы. Дополнительные сведения о метках см. в статье [Управление метками](/github/managing-your-work-on-github/managing-labels#applying-labels-to-issues-and-pull-requests). 6. {% data reusables.actions.commit-workflow %} ## Тестирование рабочего процесса -Этот рабочий процесс будет выполняться при перемещении любой карточки проекта в репозитории. Если карточка является проблемой или запросом на вытягивание и перемещается в указанный вами столбец, то рабочий процесс удалит указанные метки из такой проблемы или запроса на вытягивание. Карточки, представляющие собой примечания, останутся без изменений. +При каждом перемещении карточки проекта в {% data variables.projects.projects_v1_board %} в репозитории будет выполняться этот рабочий процесс. Если карточка является проблемой или запросом на вытягивание и перемещается в указанный столбец, рабочий процесс удалит указанную метку из проблемы или запроса на вытягивание. Карточки, представляющие собой примечания, останутся без изменений. -Протестируйте рабочий процесс, переместив проблему в проекте в целевой столбец. +Протестируйте рабочий процесс, переместив проблему в {% data variables.projects.projects_v1_board %} в целевой столбец. 1. Откройте проблему в репозитории. Дополнительные сведения см. в статье "[Создание проблемы](/github/managing-your-work-on-github/creating-an-issue)". -2. Добавьте метки в проблему, которую рабочий процесс должен удалить. Дополнительные сведения см. в статье "[Управление метками](/github/managing-your-work-on-github/managing-labels#applying-labels-to-issues-and-pull-requests)". -3. Добавьте проблему в столбец проекта, указанный в файле рабочего процесса. Дополнительные сведения см. в разделе [Добавление проблем и запросов на вытягивание на доску проекта](/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board). +2. Пометка проблемы меткой, которую требуется удалить рабочим процессом. Дополнительные сведения см. в статье "[Управление метками](/github/managing-your-work-on-github/managing-labels#applying-labels-to-issues-and-pull-requests)". +3. Добавьте проблему в столбец {% data variables.projects.projects_v1_board %}, указанный в файле рабочего процесса. Дополнительные сведения: [Добавление проблем и запросов на вытягивание к компоненту "{% data variables.product.prodname_project_v1 %}"](/github/managing-your-work-on-github/adding-issues-and-pull-requests-to-a-project-board). 4. Чтобы увидеть выполнение рабочего процесса, который запускается при добавлении проблемы в проект, просмотрите журнал выполнений рабочего процесса. Дополнительные сведения см. в статье "[Просмотр журнала выполнения рабочего процесса](/actions/managing-workflow-runs/viewing-workflow-run-history)". -5. После завершения рабочего процесса указанные метки в проблеме, добавленной в столбец проекта, должна быть удалены. +5. После завершения рабочего процесса у проблемы, добавленной в столбец проекта, должна быть удалена указанная метка. ## Дальнейшие действия -- Дополнительные сведения о задачах, которые можно выполнять с помощью действия `andymckay/labeler`, таких как добавление меток или пропуск этого действия в случае, если проблема назначена или имеет определенную метку, см. в [документации по действию `andymckay/labeler`](https://github.com/marketplace/actions/simple-issue-labeler). -- [Выполните поиск в GitHub](https://github.com/search?q=%22uses:+andymckay/labeler%22&type=code), чтобы найти примеры рабочих процессов, использующих это действие. +- Дополнительные сведения о дополнительных действиях, которые можно выполнить с `actions/github-script` помощью действия, см. в [документации по`actions/github-script` действию](https://github.com/marketplace/actions/github-script). +- [Выполните поиск в GitHub](https://github.com/search?q=%22uses:+actions/github-script%22&type=code), чтобы найти примеры рабочих процессов, использующих это действие. diff --git a/translations/ru-RU/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list.md b/translations/ru-RU/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list.md index b13df168ad..44bbe1b2aa 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list.md +++ b/translations/ru-RU/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list.md @@ -1,7 +1,7 @@ --- title: Ограничение сетевого трафика для предприятия с помощью списка разрешенных IP-адресов shortTitle: Restricting network traffic -intro: Вы можете ограничить доступ к предприятиям и разрешить доступ только к ресурсам с указанных IP-адресов с помощью списка разрешенных IP-адресов. +intro: Вы можете ограничить доступ к организации и разрешить доступ к ресурсам только с указанных IP-адресов с помощью списка разрешенных IP-адресов. permissions: Enterprise owners can configure IP allow lists. miniTocMaxHeadingLevel: 3 versions: @@ -17,12 +17,12 @@ topics: redirect_from: - /admin/configuration/restricting-network-traffic-to-your-enterprise - /admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise -ms.openlocfilehash: d9a4518f2fcc23d4b49967effb7b9a3022a7c6bd -ms.sourcegitcommit: 7a74d5796695bb21c30e4031679253cbc16ceaea +ms.openlocfilehash: b62ab2a143ed0e7ec57f7e7225a09c0ca713295c +ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67 ms.translationtype: MT ms.contentlocale: ru-RU -ms.lasthandoff: 11/28/2022 -ms.locfileid: '148184015' +ms.lasthandoff: 11/29/2022 +ms.locfileid: '148185046' --- ## Сведения об ограничениях сетевого трафика @@ -30,13 +30,13 @@ ms.locfileid: '148184015' {% ifversion ghec %} -Если ваше предприятие использует {% data variables.product.prodname_emus %} с OIDC, вы можете выбрать, следует ли использовать функцию списка разрешенных IP-адресов {% data variables.product.company_short %}или использовать ограничения списка разрешений для поставщика удостоверений (IdP). Если ваше предприятие не использует {% data variables.product.prodname_emus %} с OIDC, можно использовать функцию списка разрешений {% data variables.product.company_short %}. +Если ваше предприятие использует {% data variables.product.prodname_emus %} с OIDC, вы можете выбрать, следует ли использовать функцию списка разрешенных IP-адресов {% data variables.product.company_short %} или использовать ограничения списка разрешений для поставщика удостоверений (IdP). Если ваше предприятие не использует {% data variables.product.prodname_emus %} с OIDC, можно использовать функцию списка разрешений {% data variables.product.company_short %}. {% elsif ghae %} По умолчанию правила группы безопасности сети (NSG) Azure оставляют весь входящий трафик открытым на портах 22, 80, 443 и 25. Вы можете связаться с {% data variables.contact.github_support %}, чтобы настроить ограничения доступа для {% data variables.product.product_name %}. -Для получения ограничений на использование групп безопасности сети Azure обратитесь к {% data variables.contact.github_support %} с IP-адресами, которым должен быть разрешен доступ к {% data variables.product.product_name %}. Укажите диапазоны адресов, используя стандартный формат CIDR (бесклассовая междоменная маршрутизация). {% data variables.contact.github_support %} настроит соответствующие правила брандмауэра, чтобы ограничить сетевой доступ по протоколам HTTP, SSH, HTTPS и SMTP. Дополнительные сведения см. в разделе [Получение помощи от {% data variables.contact.github_support %}](/admin/enterprise-support/receiving-help-from-github-support). +Чтобы ограничить использование групп безопасности сети Azure, обратитесь в {% data variables.contact.github_support %} с IP-адресами, которым должен быть разрешен доступ к {% data variables.product.product_name %}. Укажите диапазоны адресов, используя стандартный формат CIDR (бесклассовая междоменная маршрутизация). {% data variables.contact.github_support %} настроит соответствующие правила брандмауэра, чтобы ограничить сетевой доступ по протоколам HTTP, SSH, HTTPS и SMTP. Дополнительные сведения см. в разделе [Получение помощи от {% data variables.contact.github_support %}](/admin/enterprise-support/receiving-help-from-github-support). {% endif %} @@ -44,7 +44,7 @@ ms.locfileid: '148184015' ## Сведения о списке разрешенных IP-адресов {% data variables.product.company_short %} -Вы можете использовать список разрешенных IP-адресов {% data variables.product.company_short %}, чтобы управлять доступом к вашему предприятию и ресурсам, принадлежащим организациям на предприятии. +Список разрешенных IP-адресов {% data variables.product.company_short %} можно использовать для управления доступом к предприятию и ресурсам, принадлежащим организациям предприятия. {% data reusables.identity-and-permissions.ip-allow-lists-cidr-notation %} @@ -54,13 +54,13 @@ ms.locfileid: '148184015' Если вы используете {% data variables.product.prodname_emus %} с OIDC, можно использовать список разрешений поставщика удостоверений. -Использование списка разрешений поставщика удостоверений отключает конфигурации списков разрешенных IP-адресов {% data variables.product.company_short %} для всех организаций на предприятии и отключает API GraphQL для включения списков разрешенных IP-адресов и управления ими. +Использование списка разрешений поставщика удостоверений отключает конфигурации списка разрешений IP-адресов {% data variables.product.company_short %} для всех организаций на предприятии и отключает API GraphQL для включения списков разрешенных IP-адресов и управления ими. По умолчанию поставщик удостоверений запускает CAP при начальном интерактивном входе SAML или OIDC в {% data variables.product.company_short %} для любой выбранной конфигурации списка разрешенных IP-адресов. -Cap OIDC применяется только для запросов к API с использованием маркера типа "пользователь—сервер", например маркера для {% data variables.product.prodname_oauth_app %} или {% data variables.product.prodname_github_app %}, действующего от имени пользователя. Cap OIDC не применяется, если {% data variables.product.prodname_github_app %} использует токен между серверами. Дополнительные сведения см. в разделах [Проверка подлинности с помощью {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps/authenticating-with-github-apps#authenticating-as-an-installation)и [Сведения о поддержке политики условного доступа поставщиков удостоверений](/enterprise-cloud@latest/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy#github-apps-and-oauth-apps). +OIDC CAP применяется только к запросам к API с использованием маркера "пользователь—сервер", например маркера для {% data variables.product.prodname_oauth_app %} или {% data variables.product.prodname_github_app %}, действующего от имени пользователя. Cap OIDC не применяется, если {% data variables.product.prodname_github_app %} использует токен "сервер-сервер". Дополнительные сведения см. в разделах [Проверка подлинности с помощью {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps/authenticating-with-github-apps#authenticating-as-an-installation)и [Сведения о поддержке политики условного доступа поставщиков удостоверений](/enterprise-cloud@latest/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy#github-apps-and-oauth-apps). -Чтобы обеспечить беспроблемное использование OIDC CAP при одновременном применении политики к маркерам типа "пользователь —сервер", необходимо скопировать все диапазоны IP-адресов из каждого {% data variables.product.prodname_github_app %}, используемых предприятием, в политику поставщика удостоверений. +Чтобы обеспечить беспроблемное использование OIDC CAP при одновременном применении политики к маркерам от пользователя к серверу, необходимо скопировать все диапазоны IP-адресов из каждого {% data variables.product.prodname_github_app %}, который использует ваше предприятие, в политику поставщика удостоверений. ## Использование списка разрешенных IP-адресов {% data variables.product.company_short %} @@ -115,7 +115,7 @@ Cap OIDC применяется только для запросов к API с 1. В разделе "Список разрешенных IP-адресов" выберите раскрывающийся список и щелкните **Поставщик удостоверений**. ![Снимок экрана: раскрывающееся меню с тремя параметрами конфигурации списка разрешенных IP-адресов: Отключено, Поставщик удостоверений и GitHub](/assets/images/help/security/enable-identity-provider-ip-allow-list.png) - - При необходимости, чтобы разрешить установленным {% data variables.product.company_short %} и {% data variables.product.prodname_oauth_apps %} доступ к организации с любого IP-адреса, выберите **Пропустить проверку поставщика удостоверений для приложений**. +1. При необходимости, чтобы разрешить установленным {% data variables.product.company_short %} и {% data variables.product.prodname_oauth_apps %} доступ к организации с любого IP-адреса, выберите **Пропустить проверку поставщика удостоверений для приложений**. ![Флажок для разрешения IP-адресов](/assets/images/help/security/ip-allow-list-skip-idp-check.png) 1. Выберите команду **Сохранить**. diff --git a/translations/ru-RU/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md b/translations/ru-RU/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md index 58c6be3da8..07c165c8f6 100644 --- a/translations/ru-RU/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md +++ b/translations/ru-RU/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md @@ -236,6 +236,7 @@ Appliances configured for high-availability and geo-replication use replica inst - If you have upgraded each node to {% data variables.product.product_name %} 3.6.0 or later and started replication, but `git replication is behind the primary` continues to appear after 45 minutes, 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)." {%- endif %} + - {% ifversion ghes = 3.4 or ghes = 3.5 or ghes = 3.6 %}Otherwise, if{% else %}If{% endif %} `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.location.product_location %}. diff --git a/translations/ru-RU/content/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics.md b/translations/ru-RU/content/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics.md index 8dca96d496..80fb355074 100644 --- a/translations/ru-RU/content/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics.md +++ b/translations/ru-RU/content/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics.md @@ -1,6 +1,6 @@ --- -title: About Server Statistics -intro: 'You can use {% data variables.product.prodname_server_statistics %} to analyze your own aggregate data from {% data variables.product.prodname_ghe_server %}, and help us improve {% data variables.product.company_short %} products.' +title: Сведения о статистике сервера +intro: 'Вы можете использовать {% data variables.product.prodname_server_statistics %}, чтобы проанализировать собственные статистические данные из {% data variables.product.prodname_ghe_server %}, а также помочь нам улучшить продукты {% data variables.product.company_short %}.' versions: feature: server-statistics permissions: 'Enterprise owners can enable {% data variables.product.prodname_server_statistics %}.' @@ -8,93 +8,102 @@ redirect_from: - /early-access/github/analyze-how-your-team-works-with-server-statistics/about-server-statistics topics: - Enterprise +ms.openlocfilehash: 3d17df54cd5dcf9ad102ab5079794a9bcb3e664b +ms.sourcegitcommit: 1a77ceb9e20c002173dda983db9405bcd5be254a +ms.translationtype: MT +ms.contentlocale: ru-RU +ms.lasthandoff: 11/29/2022 +ms.locfileid: '148185188' --- +## Сведения о преимуществах {% data variables.product.prodname_server_statistics %} -## About the benefits of {% data variables.product.prodname_server_statistics %} +{% data variables.product.prodname_server_statistics %} поможет вам предусмотреть потребности вашей организации, понять, как работает ваша команда, и показать значение, полученное из {% data variables.product.prodname_ghe_server %}. -{% data variables.product.prodname_server_statistics %} can help you anticipate the needs of your organization, understand how your team works, and show the value you get from {% data variables.product.prodname_ghe_server %}. +После включения {% data variables.product.prodname_server_statistics %} собирает статистические данные о том, сколько конкретных функций используется в экземпляре с течением времени. В отличие от других конечных точек [API статистики для администраторов](/rest/reference/enterprise-admin#admin-stats), которые возвращают данные только за последний день, {% data variables.product.prodname_server_statistics %} предоставляет исторические данные всех метрик {% data variables.product.prodname_server_statistics %} с момента включения этой возможности. Дополнительные сведения см. в статье [Включение {% data variables.product.prodname_server_statistics %} для предприятия](/admin/configuration/configuring-github-connect/enabling-server-statistics-for-your-enterprise). -Once enabled, {% data variables.product.prodname_server_statistics %} collects aggregate data on how much certain features are used on your instance over time. Unlike other [Admin Stats API](/rest/reference/enterprise-admin#admin-stats) endpoints, which only return data for the last day, {% data variables.product.prodname_server_statistics %} provides historical data of all {% data variables.product.prodname_server_statistics %} metrics collected since the day you enabled the feature. For more information, see "[Enabling {% data variables.product.prodname_server_statistics %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-server-statistics-for-your-enterprise)." +При включении {% data variables.product.prodname_server_statistics %} вы помогаете выполнять сборку более качественных {% data variables.product.prodname_dotcom %}. Статистические данные, которые вы предоставляете, дают нам представление о том, как {% data variables.product.prodname_dotcom %} добавляет ценность нашим клиентам. Эти сведения позволяют {% data variables.product.company_short %} принимать более обоснованные решения о продукте, что в конечном итоге приносит вам пользу. -When you enable {% data variables.product.prodname_server_statistics %}, you're helping to build a better {% data variables.product.prodname_dotcom %}. The aggregated data you'll provide gives us insights into how {% data variables.product.prodname_dotcom %} adds value to our customers. This information allows {% data variables.product.company_short %} to make better and more informed product decisions, ultimately benefiting you. +## Сведения о безопасности данных -## About data security +Мы уважаем ваши данные. Мы никогда не будем передавать данные из {% data variables.location.product_location %}, если вы сначала не предоставили нам разрешение на это. -We respect your data. We will never transmit data from {% data variables.location.product_location %} unless you have first given us permission to do so. +Мы не собираем персональные данные. Мы также не собираем содержимое {% data variables.product.company_short %}, такое как код, проблемы, комментарии или содержимое запроса на вытягивание. -We collect no personal data. We also don't collect any {% data variables.product.company_short %} content, such as code, issues, comments, or pull request content. +Доступ к данным могут получить только владельцы подключенной корпоративной учетной записи или организации в {% data variables.product.prodname_ghe_cloud %}. -Only owners of the connected enterprise account or organization on {% data variables.product.prodname_ghe_cloud %} can access the data. +В репозиториях, проблемах, запросах на вытягивание и других возможностях собираются только определенные статистические метрики. Список собранных статистических метрик см. в статье [Собранные данные {% data variables.product.prodname_server_statistics %}](#server-statistics-data-collected). -Only certain aggregate metrics are collected on repositories, issues, pull requests, and other features. To see the list of aggregate metrics collected, see "[{% data variables.product.prodname_server_statistics %} data collected](#server-statistics-data-collected)." +Любые обновления собранных метрик будут выполняться в будущих выпусках с новыми функциями {% data variables.product.prodname_ghe_server %} и будут описаны в [заметках о выпуске {% data variables.product.prodname_ghe_server %}](/admin/release-notes). Кроме того, мы добавим в эту статью все обновления метрик. -Any updates to the collected metrics will happen in future feature releases of {% data variables.product.prodname_ghe_server %} and will be described in the [{% data variables.product.prodname_ghe_server %} release notes](/admin/release-notes). In addition, we will update this article with all metric updates. +Чтобы узнать больше о хранении и защите данных {% data variables.product.prodname_server_statistics %}, см. статью [Безопасность GitHub](https://github.com/security). -For a better understanding of how we store and secure {% data variables.product.prodname_server_statistics %} data, see "[GitHub Security](https://github.com/security)." +### Сведения о хранении и удалении данных -### About data retention and deletion +{% data variables.product.company_short %} собирает данные {% data variables.product.prodname_server_statistics %} до тех пор, пока лицензия {% data variables.product.prodname_ghe_server %} активна, а возможность {% data variables.product.prodname_server_statistics %} включена. -{% data variables.product.company_short %} collects {% data variables.product.prodname_server_statistics %} data for as long as your {% data variables.product.prodname_ghe_server %} license is active and the {% data variables.product.prodname_server_statistics %} feature is enabled. +Если необходимо удалить данные, это можно сделать, обратившись в службу поддержки GitHub, к вашему представителю учетной записи {% data variables.product.prodname_dotcom %} или вашему менеджеру по успеху клиентов. Как правило, мы удаляем данные за временной интервал, указанный в нашем заявлении о конфиденциальности. Дополнительные сведения см. в [заявлении о конфиденциальности {% data variables.product.company_short %}](/free-pro-team@latest/site-policy/privacy-policies/github-privacy-statement#data-retention-and-deletion-of-data) в документации по {% data variables.product.prodname_dotcom_the_website %}. -If you would like to delete your data, you may do so by contacting GitHub Support, your {% data variables.product.prodname_dotcom %} account representative, or your Customer Success Manager. Generally, we delete data in the timeframe specified in our privacy statement. For more information, see [{% data variables.product.company_short %}'s privacy statement](/free-pro-team@latest/site-policy/privacy-policies/github-privacy-statement#data-retention-and-deletion-of-data) in the {% data variables.product.prodname_dotcom_the_website %} documentation. +### Сведения о переносимости данных -### About data portability +Как владелец организации или предприятия в {% data variables.product.prodname_ghe_cloud %} вы можете получить доступ к данным {% data variables.product.prodname_server_statistics %} путем экспорта данных в CSV-файле или JSON-файле либо через REST API {% data variables.product.prodname_server_statistics %}. Дополнительные сведения см. в статье [Отправка запроса о {% data variables.product.prodname_server_statistics %} с помощью REST API](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/requesting-server-statistics-using-the-rest-api) или [Экспорт {% data variables.product.prodname_server_statistics %}](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/exporting-server-statistics). -As an organization owner or enterprise owner on {% data variables.product.prodname_ghe_cloud %}, you can access {% data variables.product.prodname_server_statistics %} data by exporting the data in a CSV or JSON file or through the {% data variables.product.prodname_server_statistics %} REST API. For more information, see "[Requesting {% data variables.product.prodname_server_statistics %} using the REST API](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/requesting-server-statistics-using-the-rest-api)" or "[Exporting {% data variables.product.prodname_server_statistics %}](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/exporting-server-statistics)." +## Сведения об отключении сбора данных -## About disabling data collection +Возможность {% data variables.product.prodname_server_statistics %} можно отключить в любое время. Дополнительные сведения см. в статье [Включение {% data variables.product.prodname_server_statistics %} для предприятия](/admin/configuration/configuring-github-connect/enabling-server-statistics-for-your-enterprise). -You can disable the {% data variables.product.prodname_server_statistics %} feature at any time. For more information, see "[Enabling {% data variables.product.prodname_server_statistics %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-server-statistics-for-your-enterprise)." +## Собранные данные {% data variables.product.prodname_server_statistics %} -## {% data variables.product.prodname_server_statistics %} data collected +После включения {% data variables.product.prodname_server_statistics %} метрики собираются с помощью ежедневного задания, которое выполняется в {% data variables.location.product_location %}. Статистические метрики хранятся в вашей организации или корпоративной учетной записи в {% data variables.product.prodname_ghe_cloud %} и не хранятся в {% data variables.location.product_location %}. -After you enable {% data variables.product.prodname_server_statistics %}, metrics are collected through a daily job that runs on {% data variables.location.product_location %}. The aggregate metrics are stored on your organization or enterprise account on {% data variables.product.prodname_ghe_cloud %} and are not stored on {% data variables.location.product_location %}. +Следующие статистические метрики будут собираться и передаваться ежедневно и представлять общее количество за день. -The following aggregate metrics will be collected and transmitted on a daily basis and represent the total counts for the day: - - `active_hooks` - - `admin_users` - - `closed_issues` - - `closed_milestones` - - `collection_date` - - `disabled_orgs` - - `dormancy_threshold` - - `fork_repos` - - `ghes_version` - - `github_connect_features_enabled` - - `inactive_hooks` - - `mergeable_pulls` - - `merged_pulls` - - `open_issues` - - `open_milestones` - - `org_repos` - - `private_gists` - - `public_gists` - - `root_repos` - - `schema_version` - - `server_id` - - `suspended_users` - - `total_commit_comments` - - `total_dormant_users` - - `total_gist_comments` - - `total_gists` - - `total_hooks` - - `total_issues` - - `total_issue_comments` - - `total_milestones` - - `total_repos` - - `total_orgs` - - `total_pages` - - `total_pull_request_comments` - - `total_pulls` - - `total_pushes` - - `total_team_members` - - `total_teams` - - `total_users` - - `total_wikis` - - `unmergeable_pulls` +Столбец CSV | Имя | Описание | +---------- | ---- | ----------- | +Объект | `github_connect.features_enabled` | Массив функций {% data variables.product.prodname_github_connect %}, включенных для вашего экземпляра (см. раздел "[Сведения о {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/about-github-connect#github-connect-features)" ) | +B | `host_name` | Имя узла для экземпляра | +C | `dormant_users.dormancy_threshold` | Время, в течение времени, когда пользователь должен быть неактивным, чтобы считаться неактивным | +D | `dormant_users.total_dormant_users` | Число неактивных учетных записей пользователей | +E | `ghes_version` | Версия {% data variables.product.product_name %}, на котором выполняется ваш экземпляр | +F | `server_id` | UUID, созданный для вашего экземпляра +G | `collection_date` | Дата сбора метрик | +H | `schema_version` | Версия схемы базы данных, используемая для хранения этих данных | +I | `ghe_stats.comments.total_commit_comments` | Количество комментариев к фиксациям | +J | `ghe_stats.comments.total_gist_comments` | Количество комментариев в gist | +K | `ghe_stats.comments.total_issue_comments` | Количество комментариев по проблемам | +L | `ghe_stats.comments.total_pull_request_comments` | Количество комментариев к запросам на вытягивание | +M | `ghe_stats.gists.total_gists` | Число gists (как секретная, так и общедоступная) | +Нет | `ghe_stats.gists.private_gists` | Число секретов gist | +O | `ghe_stats.gists.public_gists` | Количество открытых объектов gist | +P | `ghe_stats.hooks.total_hooks` | Количество перехватчиков предварительного получения (активных и неактивных) | +Q | `ghe_stats.hooks.active_hooks` | Количество активных перехватчиков предварительного получения | +R | `ghe_stats.hooks.inactive_hooks` | Количество неактивных перехватчиков предварительного получения | +S | `ghe_stats.issues.total_issues` | Количество проблем (как открытых, так и закрытых) | +T | `ghe_stats.issues.open_issues` | Число открытых проблем | +U | `ghe_stats.issues.closed_issues` | Количество закрытых проблем | +V | `ghe_stats.milestones.total_milestones` | Количество вех (открытых и закрытых) | +W | `ghe_stats.milestones.open_milestones` | Количество открытых вех | +X | `ghe_stats.milestones.closed_milestones` | Количество закрытых вех | +Да | `ghe_stats.orgs.total_orgs` | Число организаций (включенных и отключенных) | +Z | `ghe_stats.orgs.disabled_orgs` | Число отключенных организаций | +AA | `ghe_stats.orgs.total_teams` | Число команд | +AB | `ghe_stats.orgs.total_team_members` | Число участников команды | +AC | `ghe_stats.pages.total_pages` | Количество сайтов {% data variables.product.prodname_pages %} | +AD | `ghe_stats.pulls.total_pulls` | Количество запросов на вытягивание | +AE | `ghe_stats.pulls.merged_pulls` | Количество объединенных запросов на вытягивание | +AF | `ghe_stats.pulls.mergeable_pulls` | Количество запросов на вытягивание, которые в настоящее время можно объединить | +ГД | `ghe_stats.pulls.unmergeable_pulls` | Количество запросов на вытягивание, которые в настоящее время не могут быть объединяемыми | +AH | `ghe_stats.repos.total_repos` | Количество репозиториев (как вышестоящих, так и вилок) | +ИИ | `ghe_stats.repos.root_repos` | Число вышестоящих репозиториев | +AJ | `ghe_stats.repos.fork_repos` | Количество вилок | +AK | `ghe_stats.repos.org_repos` | Количество репозиториев, принадлежащих организациям | +AL | `ghe_stats.repos.total_pushes` | Количество отложений в репозитории | +AM | `ghe_stats.repos.total_wikis` | Количество вики-сайтов | +AN | `ghe_stats.users.total_users` | Количество учетных записей пользователей | +АО | `ghe_stats.users.admin_users` | Количество учетных записей пользователей, которые являются администраторами сайта | +Доступности и устойчивости к разделению сети | `ghe_stats.users.suspended_users` | Количество приостановленных учетных записей пользователей | -## {% data variables.product.prodname_server_statistics %} payload example +## Примеры данных {% data variables.product.prodname_server_statistics %} -To see an example of the response payload for the {% data variables.product.prodname_server_statistics %} API, see "[Requesting {% data variables.product.prodname_server_statistics %} using the REST API](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/requesting-server-statistics-using-the-rest-api)." +Чтобы просмотреть пример заголовков, включенных в экспорт CSV для {% data variables.product.prodname_server_statistics %}, скачайте [пример CSV-файла {% data variables.product.prodname_server_statistics %}](/assets/server-statistics-csv-example.csv). -To see a list of the data collected, see "[{% data variables.product.prodname_server_statistics %} data collected](#server-statistics-data-collected)." +Пример полезных данных ответа для API {% data variables.product.prodname_server_statistics %} см. в статье [Отправка запроса о {% data variables.product.prodname_server_statistics %} с помощью REST API](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/requesting-server-statistics-using-the-rest-api). diff --git a/translations/ru-RU/content/admin/user-management/managing-users-in-your-enterprise/exporting-membership-information-for-your-enterprise.md b/translations/ru-RU/content/admin/user-management/managing-users-in-your-enterprise/exporting-membership-information-for-your-enterprise.md index 0048383cbc..cdd3c02772 100644 --- a/translations/ru-RU/content/admin/user-management/managing-users-in-your-enterprise/exporting-membership-information-for-your-enterprise.md +++ b/translations/ru-RU/content/admin/user-management/managing-users-in-your-enterprise/exporting-membership-information-for-your-enterprise.md @@ -7,19 +7,13 @@ topics: - Enterprise shortTitle: Export membership information permissions: Enterprise owners can export membership information for an enterprise. -ms.openlocfilehash: ba7519aae1b38cd629a46baeacd5edc9d138efdc -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 8da0e7b91e8bff85cb27fb7df3f06e62bdb290f2 +ms.sourcegitcommit: 7e2b5213fd15d91222725ecab5ee28cef378d3ad ms.translationtype: MT ms.contentlocale: ru-RU -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148106424' +ms.lasthandoff: 11/29/2022 +ms.locfileid: '148185546' --- -{% note %} - -**Примечание:** Экспорт сведений о членстве для enterpirise в настоящее время находится в бета-версии и может быть изменен. - -{% endnote %} - Чтобы выполнить аудит людей с доступом к ресурсам предприятия, можно скачать CSV-отчет со сведениями о членстве для вашего предприятия. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} diff --git a/translations/ru-RU/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md b/translations/ru-RU/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md index 94166566bd..500d597c65 100644 --- a/translations/ru-RU/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md +++ b/translations/ru-RU/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md @@ -230,3 +230,13 @@ You can view all open alerts, and you can reopen alerts that have been previousl ![Screenshot of closed alerts with "Reopen" button emphasized](/assets/images/help/graphs/reopen-multiple-alerts.png) {% endif %} + + +## Reviewing the audit logs for {% data variables.product.prodname_dependabot_alerts %} + +When a member of your organization {% ifversion not fpt %}or enterprise {% endif %}performs an action related to {% data variables.product.prodname_dependabot_alerts %}, you can review the actions in the audit log. For more information about accessing the log, see "[Reviewing the audit log for your organization](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#accessing-the-audit-log){% ifversion not fpt %}" and "[Accessing the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/accessing-the-audit-log-for-your-enterprise)."{% else %}."{% endif %} +{% ifversion dependabot-alerts-audit-log %} + +![Screenshot of the audit log showing Dependabot alerts](/assets/images/help/dependabot/audit-log-UI-dependabot-alert.png){% endif %} + +Events in your audit log for {% data variables.product.prodname_dependabot_alerts %} include details such as who performed the action, what the action was, and when the action was performed. {% ifversion dependabot-alerts-audit-log %}The event also includes a link to the alert itself. When a member of your organization dismisses an alert, the event displays the dismissal reason and comment.{% endif %} For information on the {% data variables.product.prodname_dependabot_alerts %} actions, see the `repository_vulnerability_alert` category in "[Reviewing the audit log for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization#repository_vulnerability_alert-category-actions){% ifversion not fpt %}" and "[Audit log events for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise#repository_vulnerability_alert-category-actions)."{% else %}."{% endif %} diff --git a/translations/ru-RU/content/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file.md b/translations/ru-RU/content/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file.md index 2453d469fb..891b600257 100644 --- a/translations/ru-RU/content/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file.md +++ b/translations/ru-RU/content/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file.md @@ -478,8 +478,28 @@ By default, {% data variables.product.prodname_dependabot %} automatically rebas Available rebase strategies -- `disabled` to disable automatic rebasing. - `auto` to use the default behavior and rebase open pull requests when changes are detected. +- `disabled` to disable automatic rebasing. + +When `rebase-strategy` is set to `auto`, {% data variables.product.prodname_dependabot %} attempts to rebase pull requests in the following cases. +- When you use {% data variables.product.prodname_dependabot_version_updates %}, for any open {% data variables.product.prodname_dependabot %} pull request when your schedule runs. +- When you reopen a closed {% data variables.product.prodname_dependabot %} pull request. +- When you change the value of `target-branch` in the {% data variables.product.prodname_dependabot %} configuration file. For more information about this field, see "[`target-branch`](#target-branch)." +- When {% data variables.product.prodname_dependabot %} detects that a {% data variables.product.prodname_dependabot %} pull request is in conflict after a recent push to the target branch. + +{% note %} + +**Note:** {% data variables.product.prodname_dependabot %} will keep rebasing a pull request indefinitely until the pull request is closed, merged or you disable {% data variables.product.prodname_dependabot_updates %}. + +{% endnote %} + +When `rebase-strategy` is set to `disabled`, {% data variables.product.prodname_dependabot %} stops rebasing pull requests. + +{% note %} + +**Note:** This behavior only applies to pull requests that go into conflict with the target branch. {% data variables.product.prodname_dependabot %} will keep rebasing pull requests opened prior to the `rebase-strategy` setting being changed, and pull requests that are part of a scheduled run. + +{% endnote %} {% data reusables.dependabot.option-affects-security-updates %} diff --git a/translations/ru-RU/content/code-security/security-advisories/repository-security-advisories/creating-a-repository-security-advisory.md b/translations/ru-RU/content/code-security/security-advisories/repository-security-advisories/creating-a-repository-security-advisory.md index 7630ba9486..8f8ea3d298 100644 --- a/translations/ru-RU/content/code-security/security-advisories/repository-security-advisories/creating-a-repository-security-advisory.md +++ b/translations/ru-RU/content/code-security/security-advisories/repository-security-advisories/creating-a-repository-security-advisory.md @@ -1,6 +1,6 @@ --- -title: Создание рекомендаций по безопасности репозитория -intro: Вы можете создать проект рекомендаций по безопасности для частного обсуждения и устранения уязвимости безопасности в проекте разработки ПО с открытым кодом. +title: Creating a repository security advisory +intro: You can create a draft security advisory to privately discuss and fix a security vulnerability in your open source project. redirect_from: - /articles/creating-a-maintainer-security-advisory - /github/managing-security-vulnerabilities/creating-a-maintainer-security-advisory @@ -15,31 +15,31 @@ topics: - Security advisories - Vulnerabilities shortTitle: Create repository advisories -ms.openlocfilehash: de22432173f6bf909d001a3f780b0f9943769ec0 -ms.sourcegitcommit: 27882d9b3f19979c817c25952a2fb4dc4c6f0a65 -ms.translationtype: MT -ms.contentlocale: ru-RU -ms.lasthandoff: 10/27/2022 -ms.locfileid: '148114111' --- -Любой пользователь с правами администратора в репозитории может создать рекомендации по безопасности. + +Anyone with admin permissions to a repository can create a security advisory. {% data reusables.security-advisory.security-researcher-cannot-create-advisory %} -## Создание рекомендаций по безопасности +## Creating a security advisory -{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-advisories %} -4. Щелкните **Создать черновик рекомендаций по безопасности** , чтобы открыть форму проекта рекомендаций. - ![Кнопка для открытия черновика рекомендаций](/assets/images/help/security/security-advisory-new-draft-security-advisory-button.png) -5. Введите заголовок для рекомендаций по безопасности. -{% data reusables.repositories.security-advisory-edit-details %} {% data reusables.repositories.security-advisory-edit-severity %} {% data reusables.repositories.security-advisory-edit-cwe-cve %} {% data reusables.repositories.security-advisory-edit-description %} -11. Щелкните **Create draft security advisory** (Создать черновик рекомендаций по безопасности). - ![Кнопка для создания рекомендаций по безопасности](/assets/images/help/security/security-advisory-create-security-advisory-button.png) +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-advisories %} +1. Click **New draft security advisory** to open the draft advisory form. The fields marked with an asterisk are required. + ![Open draft advisory button](/assets/images/help/security/security-advisory-new-draft-security-advisory-button.png) +1. Type a title for your security advisory. +{% data reusables.repositories.security-advisory-edit-details %} +{% data reusables.repositories.security-advisory-edit-severity %} +{% data reusables.repositories.security-advisory-edit-cwe-cve %} +{% data reusables.repositories.security-advisory-edit-description %} +1. Click **Create draft security advisory**. + ![Create security advisory button](/assets/images/help/security/security-advisory-create-security-advisory-button.png) -## Дальнейшие действия +## Next steps -- Прокомментируйте черновик рекомендаций по безопасности, чтобы обсудить уязвимость со своей командой. -- Добавьте в рекомендации по безопасности участников совместной работы. Дополнительные сведения см. в разделе [Добавление участника совместной работы в рекомендации по безопасности репозитория](/code-security/repository-security-advisories/adding-a-collaborator-to-a-repository-security-advisory). -- Осуществляйте закрытую совместную работу для устранения уязвимости во временной частной вилке. Дополнительные сведения см. в разделе [Совместная работа во временной частной вилке для устранения уязвимости репозитория](/code-security/repository-security-advisories/collaborating-in-a-temporary-private-fork-to-resolve-a-repository-security-vulnerability). -- Добавьте лиц, на чей счет должен быть отнесен вклад в работу над рекомендациями по безопасности. Дополнительные сведения см. в статье [Изменение рекомендаций по безопасности репозитория](/code-security/repository-security-advisories/editing-a-repository-security-advisory#about-credits-for-security-advisories). -- Опубликуйте рекомендации по безопасности, чтобы уведомить свое сообщество об уязвимости. Дополнительные сведения см. в статье [Публикация рекомендаций по безопасности репозитория](/code-security/repository-security-advisories/publishing-a-repository-security-advisory). +- Comment on the draft security advisory to discuss the vulnerability with your team. +- Add collaborators to the security advisory. For more information, see "[Adding a collaborator to a repository security advisory](/code-security/repository-security-advisories/adding-a-collaborator-to-a-repository-security-advisory)." +- Privately collaborate to fix the vulnerability in a temporary private fork. For more information, see "[Collaborating in a temporary private fork to resolve a repository security vulnerability](/code-security/repository-security-advisories/collaborating-in-a-temporary-private-fork-to-resolve-a-repository-security-vulnerability)." +- Add individuals who should receive credit for contributing to the security advisory. For more information, see "[Editing a repository security advisory](/code-security/repository-security-advisories/editing-a-repository-security-advisory#about-credits-for-security-advisories)." +- Publish the security advisory to notify your community of the security vulnerability. For more information, see "[Publishing a repository security advisory](/code-security/repository-security-advisories/publishing-a-repository-security-advisory)." diff --git a/translations/ru-RU/content/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains.md b/translations/ru-RU/content/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains.md index b66a8b0503..6aba1c4fcb 100644 --- a/translations/ru-RU/content/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains.md +++ b/translations/ru-RU/content/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains.md @@ -8,12 +8,12 @@ versions: type: reference topics: - Codespaces -ms.openlocfilehash: 8ffd48856a2653f3db3c871122d3acd23c246d7a -ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.openlocfilehash: 3f4ef139386e616d14ef9a9cc5b474c96983de91 +ms.sourcegitcommit: 1a77ceb9e20c002173dda983db9405bcd5be254a ms.translationtype: MT ms.contentlocale: ru-RU -ms.lasthandoff: 11/09/2022 -ms.locfileid: '148159938' +ms.lasthandoff: 11/29/2022 +ms.locfileid: '148185180' --- {% data reusables.codespaces.codespaces-jetbrains-beta-note %} @@ -42,16 +42,10 @@ ms.locfileid: '148159938' * **Обновление активного codespace** - ![Снимок экрана: кнопка "Обновить"](/assets/images/help/codespaces/jetbrains-plugin-icon-refresh-BAK.png) + ![Снимок экрана: кнопка "Обновить"](/assets/images/help/codespaces/jetbrains-plugin-icon-refresh.png) Обновите сведения в окне инструментов {% data variables.product.prodname_github_codespaces %}. Например, если вы использовали {% data variables.product.prodname_cli %} для изменения отображаемого имени, можно нажать эту кнопку, чтобы отобразить новое имя. -* **Отключение и остановка** - - ![Снимок экрана: кнопка "Остановить"](/assets/images/help/codespaces/jetbrains-plugin-icon-stop.png) - - Остановите codespace, остановите серверную интегрированную среду разработки на удаленном компьютере и закройте локальный клиент JetBrains. - * **Управление codespace из Интернета** ![Снимок экрана: кнопка "Список"](/assets/images/help/codespaces/jetbrains-plugin-icon-index.png) @@ -63,10 +57,3 @@ ms.locfileid: '148159938' ![Снимок экрана: кнопка "Журнал"](/assets/images/help/codespaces/jetbrains-plugin-icon-log.png) Откройте журнал создания codespace в окне редактора. Дополнительные сведения см. в статье [Журналы {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/github-codespaces-logs). - -* **Перестроение контейнера разработки** - - ![Снимок экрана: кнопка "Перестроить"](/assets/images/help/codespaces/jetbrains-plugin-icon-rebuild.png) - - Перестройте codespace, чтобы применить изменения, внесенные в конфигурацию контейнера разработки. Клиент JetBrains закроется, и необходимо повторно открыть codespace. Дополнительные сведения см. в разделе [Жизненный цикл codespace](/codespaces/developing-in-codespaces/the-codespace-lifecycle#rebuilding-a-codespace). - diff --git a/translations/ru-RU/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md b/translations/ru-RU/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md index d755ec57f7..4f3db3d369 100644 --- a/translations/ru-RU/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md +++ b/translations/ru-RU/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md @@ -1,6 +1,6 @@ --- -title: Introduction to dev containers -intro: 'When you work in a codespace, the environment you are working in is created using a development container, or dev container, hosted on a virtual machine.' +title: Основные сведения о контейнерах разработки +intro: 'При работе в codespace среда, в которой вы работаете, создается с помощью контейнера разработки, размещенного на виртуальной машине.' permissions: People with write permissions to a repository can create or edit the codespace configuration. redirect_from: - /github/developing-online-with-github-codespaces/configuring-github-codespaces-for-your-project @@ -16,71 +16,76 @@ topics: - Codespaces - Set up - Fundamentals +ms.openlocfilehash: 646f8068e68040f1d12f8155c3ba9e2bdb84c2ca +ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67 +ms.translationtype: MT +ms.contentlocale: ru-RU +ms.lasthandoff: 11/29/2022 +ms.locfileid: '148185094' --- +## Сведения о контейнерах разработки -## About dev containers +Контейнеры разработки или контейнеры разработки — это контейнеры Docker, специально настроенные для предоставления полнофункциональный среды разработки. Каждый раз, когда вы работаете в среде codespace, вы используете контейнер разработки на виртуальной машине. -Development containers, or dev containers, are Docker containers that are specifically configured to provide a fully featured development environment. Whenever you work in a codespace, you are using a dev container on a virtual machine. +Можно настроить контейнер разработки для репозитория, чтобы codespace, созданные для этого репозитория, дали вам специализированную среду разработки со всеми инструментами и средами выполнения, которые необходимо использовать для конкретного проекта. Если вы не определили конфигурацию в репозитории, {% data variables.product.prodname_github_codespaces %} использует конфигурацию по умолчанию, которая содержит множество общих средств, которые может потребоваться команде для разработки проекта. Дополнительные сведения см. в разделе [Использование конфигурации контейнера разработки по умолчанию](#using-the-default-dev-container-configuration). -You can configure the dev container for a repository so that codespaces created for that repository give you a tailored development environment, complete with all the tools and runtimes you need to work on a specific project. If you don't define a configuration in the repository then {% data variables.product.prodname_github_codespaces %} uses a default configuration, which contains many of the common tools that your team might need for development with your project. For more information, see "[Using the default dev container configuration](#using-the-default-dev-container-configuration)." +Файлы конфигурации для контейнера разработки содержатся в каталоге `.devcontainer` в репозитории. Для добавления файлов конфигурации можно использовать {% data variables.product.prodname_vscode %}. Можно выбрать одну из стандартных конфигураций для различных типов проектов. Их можно использовать без дополнительной настройки, либо можно изменить конфигурации для более точной настройки среды, которую они создают. Дополнительные сведения см. в разделе [Использование предопределенной конфигурации контейнера разработки](#using-a-predefined-dev-container-configuration). -The configuration files for a dev container are contained in a `.devcontainer` directory in your repository. You can use {% data variables.product.prodname_vscode %} to add configuration files for you. You can choose from a selection of predefined configurations for various project types. You can use these without further configuration, or you can edit the configurations to refine the development environment they produce. For more information, see "[Using a predefined dev container configuration](#using-a-predefined-dev-container-configuration)." +Кроме того, можно добавлять собственные пользовательские файлы конфигурации. Дополнительные сведения см. в разделе [Создание настраиваемой конфигурации контейнера разработки](#creating-a-custom-dev-container-configuration). -Alternatively, you can add your own custom configuration files. For more information, see "[Creating a custom dev container configuration](#creating-a-custom-dev-container-configuration)." +Можно определить одну конфигурацию контейнера разработки для репозитория, разные конфигурации для разных ветвей или несколько конфигураций. При наличии нескольких конфигураций пользователи могут выбрать предпочтительную конфигурацию при создании среды codespace. Это особенно полезно для больших репозиториев, содержащих исходный код на разных языках программирования или для различных проектов. Можно создать набор конфигураций, которые позволяют разным командам работать в codespace, настроенном соответствующим образом для выполняемой ими работы. -You can define a single dev container configuration for a repository, different configurations for different branches, or multiple configurations. When multiple configurations are available, users can choose their preferred configuration when they create a codespace. This is particularly useful for large repositories that contain source code in different programming languages or for different projects. You can create a choice of configurations that allow different teams to work in a codespace that's set up appropriately for the work they are doing. - -When you create a codespace from a template, you might start with one or more dev container configuration files in your workspace. To configure your environment further, you can add or remove settings from these files and rebuild the container to apply the changes to the codespace you're working in. If you publish your codespace to a repository on {% data variables.product.product_name %}, then any codespaces created from that repository will share the configuration you've defined. For more information, see "[Applying configuration changes to a codespace](#applying-configuration-changes-to-a-codespace)" and "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-to-a-remote-repository)." +При создании codespace на основе шаблона можно начать с одного или нескольких файлов конфигурации контейнера разработки в рабочей области. Чтобы дополнительно настроить среду, можно добавить или удалить параметры из этих файлов и перестроить контейнер, чтобы применить изменения к пространству кода, в которой вы работаете. Если вы публикуете codespace в репозитории на {% data variables.product.product_name %}, все пространства кода, созданные из этого репозитория, будут совместно использовать определенную конфигурацию. Дополнительные сведения см. в разделах [Применение изменений конфигурации к codespace](#applying-configuration-changes-to-a-codespace) и [Создание codespace на основе шаблона](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-to-a-remote-repository). ### devcontainer.json -The primary file in a dev container configuration is the `devcontainer.json` file. You can use this file to determine the environment of codespaces created for your repository. The contents of this file define a dev container that can include frameworks, tools, extensions, and port forwarding. The `devcontainer.json` file usually contains a reference to a Dockerfile, which is typically located alongside the `devcontainer.json` file. +Основным файлом в конфигурации контейнера разработки является файл `devcontainer.json`. Этот файл можно использовать для определения сред codespace, созданных для репозитория. Содержимое этого файла определяет контейнер разработки, который может включать платформы, средства, расширения и перенаправление портов. Файл `devcontainer.json` обычно содержит ссылку на файл Dockerfile, который обычно находится рядом с файлом `devcontainer.json`. -If you create a codespace from a repository without a `devcontainer.json` file, or if you start from {% data variables.product.company_short %}'s blank template, the default dev container configuration is used. For more information, see "[Using the default dev container configuration](#using-the-default-dev-container-configuration)." +Если вы создаете пространство кода из репозитория без `devcontainer.json` файла или начинаете с пустого шаблона {% data variables.product.company_short %}, используется конфигурация контейнера разработки по умолчанию. Дополнительные сведения см. в разделе [Использование конфигурации контейнера разработки по умолчанию](#using-the-default-dev-container-configuration). -The `devcontainer.json` file is usually located in the `.devcontainer` directory of your repository. Alternatively, you can locate it directly in the root of the repository, in which case the file name must begin with a period: `.devcontainer.json`. +Файл `devcontainer.json` обычно находится в каталоге `.devcontainer` репозитория. Кроме того, его можно расположить непосредственно в корне репозитория, в этом случае имя файла должно начинаться с точки: `.devcontainer.json`. -If you want to have a choice of dev container configurations in your repository, any alternatives to the `.devcontainer/devcontainer.json` (or `.devcontainer.json`) file must be located in their own subdirectory at the path `.devcontainer/SUBDIRECTORY/devcontainer.json`. For example, you could have a choice of two configurations: +Если вы хотите выбирать конфигурации контейнеров разработки в репозитории, все альтернативы файлу `.devcontainer/devcontainer.json` (или `.devcontainer.json`) должны находиться в собственном подкаталоге по пути `.devcontainer/SUBDIRECTORY/devcontainer.json`. Например, вы можете иметь на выбор две конфигурации: * `.devcontainer/database-dev/devcontainer.json` * `.devcontainer/gui-dev/devcontainer.json` -When you have multiple `devcontainer.json` files in your repository, each codespace is created from only one of the configurations. Settings cannot be imported or inherited between `devcontainer.json` files. If a `devcontainer.json` file in a custom subdirectory has dependent files, such as the Dockerfile or scripts that are run by commands in the `devcontainer.json` file, it's recommended that you co-locate these files in the same subdirectory. +При наличии нескольких файлов `devcontainer.json` в репозитории каждый codespace создается только из одной из конфигураций. Параметры нельзя импортировать или наследовать между файлами `devcontainer.json`. Если файл `devcontainer.json` в настраиваемом подкаталоге содержит зависимые файлы, такие как Dockerfile или сценарии, выполняемые командами в файле `devcontainer.json`, рекомендуется располагать эти файлы в этом же подкаталоге. -For information about how to choose your preferred dev container configuration when you create a codespace, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)." +Сведения о том, как выбрать предпочтительную конфигурацию контейнера разработки при создании codespace, см. в разделе [Создание codespace для репозитория](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository). {% data reusables.codespaces.more-info-devcontainer %} -#### How to use the devcontainer.json +#### Использование файла devcontainer.json -It's useful to think of the `devcontainer.json` file as providing "customization" rather than "personalization." You should only include things that everyone working on your codebase needs as standard elements of the development environment, not things that are personal preferences. Things like linters are good to standardize on, and to require everyone to have installed, so they're good to include in your `devcontainer.json` file. Things like user interface decorators or themes are personal choices that should not be put in the `devcontainer.json` file. +Рекомендуется рассматривать файл `devcontainer.json` как предоставление "настройки", а не "персонализации". Следует включать только те вещи, которые всем пользователям, работающим с вашей базой кода, необходимы в качестве стандартных элементов среды разработки, а не как личные предпочтения. Такие вещи, как анализатор кода, полезно стандартизировать и требовать, чтобы они были установлены у всех, поэтому они хорошо подходят для включения в файл `devcontainer.json`. Такие элементы, как декораторы пользовательского интерфейса или темы, — это личный выбор каждого, и их не следует помещать в файл `devcontainer.json`. -You can personalize your codespaces by using dotfiles and Settings Sync. For more information, see "[Personalizing {% data variables.product.prodname_github_codespaces %} for your account](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account)." +Вы можете персонализировать свою среду codespace с помощью файлов с точкой и синхронизации параметров. Дополнительные сведения см. в разделе [Персонализация {% data variables.product.prodname_github_codespaces %} для учетной записи](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account). ### Dockerfile -You can add a Dockerfile as part of your dev container configuration. +Dockerfile можно добавить как часть конфигурации контейнера разработки. -The Dockerfile is a text file that contains the instructions needed to create a Docker container image. This image is used to generate a development container each time someone creates a codespace using the `devcontainer.json` file that references this Dockerfile. The instructions in the Dockerfile typically begin by referencing a parent image on which the new image that will be created is based. This is followed by commands that are run during the image creation process, for example to install software packages. +Dockerfile — это текстовый файл с инструкциями, необходимыми для создания образа контейнера Docker. Этот образ используется для создания контейнера разработки каждый раз, когда кто-то создает codespace с помощью файла `devcontainer.json`, который ссылается на этот файл Dockerfile. Инструкции в Dockerfile обычно начинаются со ссылки на родительский образ, на котором будет основан новый образ. За этим следуют команды, которые выполняются в процессе создания образа, например для установки пакетов программного обеспечения. -The Dockerfile for a dev container is typically located in the `.devcontainer` folder, alongside the `devcontainer.json` in which it is referenced. +Файл Dockerfile для контейнера разработки обычно находится в папке `.devcontainer` вместе с файлом `devcontainer.json`, который на него ссылается. {% note %} -**Note**: As an alternative to using a Dockerfile you can use the `image` property in the `devcontainer.json` file to refer directly to an existing image you want to use. The image you specify here must be allowed by any organization image policy that has been set. For more information, see "[Restricting the base image for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces)." If neither a Dockerfile nor an image is found then the default container image is used. For more information, see "[Using the default dev container configuration](#using-the-default-dev-container-configuration)." +**Примечание.** В качестве альтернативы использованию Dockerfile можно использовать свойство `image` в файле `devcontainer.json` для ссылки непосредственно на существующий образ, который вы хотите использовать. Указанный здесь образ должен быть разрешен любой заданной политикой образов организации. Дополнительные сведения см. в разделе [Ограничение базового образа для codespace.](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces) Если ни файл Dockerfile ни образ не найдены, используется образ контейнера по умолчанию. Дополнительные сведения см. в разделе [Использование конфигурации контейнера разработки по умолчанию](#using-the-default-dev-container-configuration). {% endnote %} -#### Simple Dockerfile example +#### Простой пример файла Dockerfile -The following example uses four instructions: +В следующем примере используются четыре инструкции: -`ARG` defines a build-time variable. +`ARG` определяет переменную времени сборки. -`FROM` specifies the parent image on which the generated Docker image will be based. +`FROM` указывает родительский образ, на котором будет основан создаваемый образ Docker. -`COPY` copies a file and adds it to the filesystem. +`COPY` копирует файл и добавляет его в файловую систему. -`RUN` updates package lists and runs a script. You can also use a `RUN` instruction to install software, as shown by the commented out instructions. To run multiple commands, use `&&` to combine the commands into a single `RUN` statement. +`RUN` обновляет списки пакетов и запускает сценарий. Вы также можете использовать инструкцию `RUN` для установки программного обеспечения, как показано в комментариях. Чтобы выполнить несколько команд, используйте оператор `&&` для объединения команд в одну инструкцию `RUN`. ```Dockerfile{:copy} ARG VARIANT="16-buster" @@ -97,11 +102,11 @@ COPY library-scripts/github-debian.sh /tmp/library-scripts/ RUN apt-get update && bash /tmp/library-scripts/github-debian.sh ``` -For more information about Dockerfile instructions, see "[Dockerfile reference](https://docs.docker.com/engine/reference/builder)" in the Docker documentation. +Дополнительные сведения об инструкциях в файле Dockerfile см. в [Справочнике по Dockerfile](https://docs.docker.com/engine/reference/builder) в документации по Docker. -#### Using a Dockerfile +#### Использование файла Dockerfile -To use a Dockerfile as part of a dev container configuration, reference it in your `devcontainer.json` file by using the `dockerfile` property. +Чтобы использовать файла Dockerfile в рамках конфигурации контейнера разработки, необходимо сделать ссылку на него в файле `devcontainer.json` с помощью свойства `dockerfile`. ```json{:copy} { @@ -111,134 +116,134 @@ To use a Dockerfile as part of a dev container configuration, reference it in yo } ``` -Various options are available to you if you want to use existing container orchestration in your dev container. For more information, see the "Orchestration options" section of the [Specification](https://containers.dev/implementors/spec/#orchestration-options) on the Development Containers website. +Если вы хотите использовать существующую оркестрацию контейнеров в контейнере разработки, доступны различные параметры. Дополнительные сведения см. в разделе "Параметры оркестрации" [статьи Спецификация](https://containers.dev/implementors/spec/#orchestration-options) на веб-сайте "Контейнеры разработки". -## Using the default dev container configuration +## Использование конфигурации контейнера разработки по умолчанию -If you don't define a configuration in your repository, {% data variables.product.prodname_dotcom %} creates a codespace using a default Linux image. This Linux image includes a number of runtime versions for popular languages like Python, Node, PHP, Java, Go, C++, Ruby, and .NET Core/C#. The latest or LTS releases of these languages are used. There are also tools to support data science and machine learning, such as JupyterLab and Conda. The image also includes other developer tools and utilities like Git, GitHub CLI, yarn, openssh, and vim. To see all the languages, runtimes, and tools that are included use the `devcontainer-info content-url` command inside your codespace terminal and follow the URL that the command outputs. +Если вы не определили конфигурацию в репозитории, {% data variables.product.prodname_dotcom %} создает codespace с помощью образа Linux по умолчанию. Этот образ Linux включает ряд версий среды выполнения для популярных языков, таких как Python, Node, PHP, Java, Go, C++, Ruby и .NET Core/C#. Используются последние или LTS-выпуски этих языков. Существуют также средства для поддержки обработки и анализа данных и машинного обучения, таких как JupyterLab и Conda. Этот образ также включает другие средства разработчика и служебные программы, такие как Git, GitHub CLI, yarn, openssh и vim. Чтобы просмотреть список всех языков, сред выполнения и средств, которые включены, используйте команду `devcontainer-info content-url` в терминале codespace и перейдите по URL-адресу, который выведет команда. -For information about what's included in the default Linux image, see the [`devcontainers/images`](https://github.com/devcontainers/images/tree/main/src/universal) repository. +Сведения о том, что входит в образ Linux по умолчанию, см. в репозитории [`devcontainers/images`](https://github.com/devcontainers/images/tree/main/src/universal) . -The default configuration is a good option if you're working on a small project that uses the languages and tools that {% data variables.product.prodname_github_codespaces %} provides. +Конфигурация по умолчанию является хорошим вариантом, если вы работаете над небольшим проектом, использующим языки и средства, которые предоставляет {% data variables.product.prodname_github_codespaces %}. -## Using a predefined dev container configuration +## Использование предопределенной конфигурации контейнера разработки -If you use {% data variables.product.prodname_codespaces %} in {% data variables.product.prodname_vscode %}, or in a web browser, you can create a dev container configuration for your repository by choosing from a list of predefined configurations. These configurations provide common setups for particular project types, and can help you quickly get started with a configuration that already has the appropriate container options, {% data variables.product.prodname_vscode %} settings, and {% data variables.product.prodname_vscode %} extensions that should be installed. +Если вы используете {% data variables.product.prodname_codespaces %} в {% data variables.product.prodname_vscode %} или в веб-браузере, вы можете создать конфигурацию контейнера разработки для репозитория, выбрав из списка предопределенных конфигураций. Эти конфигурации предоставляют общие параметры для конкретных типов проектов и помогут вам быстро приступить к работе с конфигурацией, которая уже имеет соответствующие параметры контейнера, параметры {% data variables.product.prodname_vscode %} и расширения {% data variables.product.prodname_vscode %}, которые необходимо установить. -Using a predefined configuration is a great idea if you need some additional extensibility. You can also start with a predefined configuration and amend it as needed for your project. For more information about the definitions of predefined dev containers, see the [`devcontainers/images`](https://github.com/devcontainers/images/tree/main/src) repository. +Использование предопределенной конфигурации — это отличная идея, если требуется дополнительная расширяемость. Вы также можете начать с предопределенной конфигурации и изменять ее по мере необходимости в процессе развития проекта. Дополнительные сведения об определениях предопределенных контейнеров разработки см. в репозитории [`devcontainers/images`](https://github.com/devcontainers/images/tree/main/src) . -You can add a predefined dev container configuration either while working in a codespace, or while working on a repository locally. To do this in {% data variables.product.prodname_vscode_shortname %} while you are working locally, and not connected to a codespace, you must have the "Dev Containers" extension installed and enabled. For more information about this extension, see the [{% data variables.product.prodname_vs_marketplace_shortname %}](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers). The following procedure describes the process when you are using a codespace. The steps in {% data variables.product.prodname_vscode_shortname %} when you are not connected to a codespace are very similar. +Можно добавить предопределенную конфигурацию контейнера разработки либо во время работы в codespace, либо при локальной работе с репозиторием. Чтобы сделать это в {% data variables.product.prodname_vscode_shortname %} во время работы локально и не подключены к codespace, необходимо установить и включить расширение Dev Containers. Дополнительные сведения об этом расширении см. в [{% data variables.product.prodname_vs_marketplace_shortname %}](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers). В следующей процедуре описывается процесс использования codespace. Действия в {% data variables.product.prodname_vscode_shortname %}, если вы не подключены к codespace, очень похожи. {% data reusables.codespaces.command-palette-container %} -1. Click the definition you want to use. +1. Щелкните определение, которое вы хотите использовать. - ![Screenshot of a list of predefined container definitions](/assets/images/help/codespaces/predefined-container-definitions-list.png) + ![Снимок экрана: список стандартных определений контейнеров](/assets/images/help/codespaces/predefined-container-definitions-list.png) -1. Follow the prompts to customize your definition. For more information on the options to customize your definition, see "[Adding additional features to your `devcontainer.json` file](#adding-additional-features-to-your-devcontainerjson-file)." -1. Click **OK**. +1. Следуйте инструкциям по настройке определения. Дополнительные сведения о параметрах настройки определения см. в разделе [Добавление дополнительных функций в файл `devcontainer.json`](#adding-additional-features-to-your-devcontainerjson-file). +1. Нажмите кнопку **ОК**. - ![Screenshot of the OK button](/assets/images/help/codespaces/prebuilt-container-ok-button.png) + ![Снимок экрана: кнопка "ОК"](/assets/images/help/codespaces/prebuilt-container-ok-button.png) -1. If you are working in a codespace, apply your changes, by clicking **Rebuild now** in the message at the bottom right of the window. For more information about rebuilding your container, see "[Applying changes to your configuration](#applying-configuration-changes-to-a-codespace)." +1. Если вы работаете в codespace, примените изменения, нажав кнопку **Перестроить** в сообщении в правом нижнем углу окна. Дополнительные сведения о перестроении контейнера см. в разделе [Применение изменений к конфигурации](#applying-configuration-changes-to-a-codespace). - ![Screenshot of a prompt to 'Rebuild now'](/assets/images/help/codespaces/rebuild-prompt.png) + ![Снимок экрана: запрос на "Перестроить сейчас"](/assets/images/help/codespaces/rebuild-prompt.png) -### Adding additional features to your `devcontainer.json` file +### Добавление дополнительных функций в файл `devcontainer.json` -{% data reusables.codespaces.about-features %} For more information, see "[Adding features to a `devcontainer.json` file](/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file?tool=vscode)." +{% data reusables.codespaces.about-features %} Дополнительные сведения см. в разделе [Добавление компонентов в `devcontainer.json` файл](/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file?tool=vscode). -## Creating a custom dev container configuration +## Создание настраиваемой конфигурации контейнера разработки -If none of the predefined configurations meets your needs, you can create a custom configuration by writing your own `devcontainer.json` file. +Если ни одна из предопределенных конфигураций не соответствует вашим потребностям, можно создать пользовательскую конфигурацию, написав собственный файл `devcontainer.json`. -* If you're adding a single `devcontainer.json` file that will be used by everyone who creates a codespace from your repository, create the file within a `.devcontainer` directory at the root of the repository. -* If you want to offer users a choice of configuration, you can create multiple custom `devcontainer.json` files, each located within a separate subdirectory of the `.devcontainer` directory. +* Если вы добавляете один файл `devcontainer.json`, который будет использоваться всеми, кто создает codespace из репозитория, создайте файл в каталоге `.devcontainer` в корне репозитория. +* Если вы хотите предложить пользователям выбор конфигурации, можно создать несколько пользовательских файлов `devcontainer.json`, каждый из которых должен находится в отдельном подкаталоге каталога `.devcontainer`. {% note %} - **Notes**: - - You can't locate your `devcontainer.json` files in directories more than one level below `.devcontainer`. For example, a file at `.devcontainer/teamA/devcontainer.json` will work, but `.devcontainer/teamA/testing/devcontainer.json` will not. - - {% data reusables.codespaces.configuration-choice-templates %} For more information, see "[Setting up a template repository for {% data variables.product.prodname_github_codespaces %}](/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces)." + **Примечания** + - Вы не можете найти файлы `devcontainer.json` в каталогах более чем на один уровень ниже `.devcontainer`. Например, файл в каталоге `.devcontainer/teamA/devcontainer.json` будет работать, а в `.devcontainer/teamA/testing/devcontainer.json` — нет. + - {% data reusables.codespaces.configuration-choice-templates %} Дополнительные сведения см. в разделе [Настройка репозитория шаблонов для {% data variables.product.prodname_github_codespaces %}](/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces). {% endnote %} - If multiple `devcontainer.json` files are found in the repository, they are listed in the codespace creation options page. For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)." + Если в репозитории найдено несколько файлов `devcontainer.json`, они будут показаны на странице параметров создания codespace. Дополнительные сведения см. в разделе [Создание codespace для репозитория](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository). - ![Screenshot of a choice of configuration files](/assets/images/help/codespaces/configuration-file-choice.png) + ![Снимок экрана: выбор файлов конфигурации](/assets/images/help/codespaces/configuration-file-choice.png) -### Adding a `devcontainer.json` file +### `devcontainer.json` Добавление файла -If you don't already have a `devcontainer.json` file in your repository, you can quickly add one from {% data variables.product.prodname_dotcom_the_website %}. -1. Navigate to your repository and click the **{% octicon "code" aria-label="The code icon" %} Code** dropdown. -1. In the **Codespaces** tab, click the ellipsis (**...**), then select **Configure dev container**. +Если у `devcontainer.json` вас еще нет файла в репозитории, его можно быстро добавить из {% data variables.product.prodname_dotcom_the_website %}. +1. Перейдите в репозиторий и щелкните раскрывающийся список **{% octicon "code" aria-label="The code icon" %} Code (Код).** +1. На вкладке **Codespaces** щелкните многоточие (**...**), а затем выберите **Настроить контейнер разработки**. - ![Screenshot of the Code dropdown, with "Configure dev container" highlighted](/assets/images/help/codespaces/configure-dev-container.png) + ![Снимок экрана: раскрывающийся список "Код" с выделенным элементом "Настройка контейнера разработки"](/assets/images/help/codespaces/configure-dev-container.png) -A new `.devcontainer/devcontainer.json` file will open in the editor. The file will contain some initial properties, including a `features` object to which you can add new tools, libraries, or runtimes. For more information, see "[Adding features to a `devcontainer.json` file](/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file?tool=webui)." +В редакторе откроется новый `.devcontainer/devcontainer.json` файл. Файл будет содержать некоторые начальные свойства, включая `features` объект, в который можно добавить новые инструменты, библиотеки или среды выполнения. Дополнительные сведения см. в разделе [Добавление компонентов в `devcontainer.json` файл](/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file?tool=webui). -If your repository already contains one or more `devcontainer.json` files, then clicking **Configure dev container** will open the existing `devcontainer.json` file with the highest precedence according to the [specification](https://containers.dev/implementors/spec/#devcontainerjson) on containers.dev. +Если репозиторий уже содержит один или несколько `devcontainer.json` файлов, щелкните **Настроить контейнер разработки** , чтобы открыть существующий `devcontainer.json` файл с наивысшим приоритетом в соответствии со [спецификацией](https://containers.dev/implementors/spec/#devcontainerjson) containers.dev. -### Default configuration selection during codespace creation +### Выбор конфигурации по умолчанию во время создания пространства кода -If `.devcontainer/devcontainer.json` or `.devcontainer.json` exists, it will be the default selection in the list of available configuration files when you create a codespace. If neither file exists, the default dev container configuration will be selected by default. +Если файл `.devcontainer/devcontainer.json` или `.devcontainer.json` существует, он будет выбором по умолчанию в списке доступных файлов конфигурации при создании пространства кода. Если ни один из файлов не существует, будет выбрана конфигурация контейнера разработки по умолчанию. -![Screenshot of the default configuration choice selected](/assets/images/help/codespaces/configuration-file-choice-default.png) +![Снимок экрана: выбор конфигурации по умолчанию](/assets/images/help/codespaces/configuration-file-choice-default.png) -### Editing the devcontainer.json file +### Изменение файла devcontainer.json -You can add and edit the supported configuration keys in the `devcontainer.json` file to specify aspects of the codespace's environment, like which {% data variables.product.prodname_vscode_shortname %} extensions will be installed. {% data reusables.codespaces.more-info-devcontainer %} +Можно добавлять и изменять поддерживаемые ключи конфигурации в файле `devcontainer.json`, чтобы указать аспекты среды codespace, например, какие расширения {% data variables.product.prodname_vscode_shortname %} будут установлены. {% data reusables.codespaces.more-info-devcontainer %} -The `devcontainer.json` file is written using the JSONC (JSON with comments) format. This allows you to include comments within the configuration file. For more information, see "[Editing JSON with {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/languages/json#_json-with-comments)" in the {% data variables.product.prodname_vscode_shortname %} documentation. +Файл `devcontainer.json` записывается в формате JSONC (JSON с комментариями). Это позволяет включать комментарии в файл конфигурации. Дополнительные сведения см. в разделе [Редактирование JSON в {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/languages/json#_json-with-comments) в документации по {% data variables.product.prodname_vscode_shortname %}. {% note %} -**Note**: If you use a linter to validate the `devcontainer.json` file, make sure it is set to JSONC and not JSON or comments will be reported as errors. +**Примечание.** Если вы используете анализатор кода для проверки файла `devcontainer.json`, убедитесь, что для него задано значение JSONC, а не JSON. В противном случае комментарии будут отображаться как ошибки. {% endnote %} -### Interface settings for {% data variables.product.prodname_vscode_shortname %} +### Параметры интерфейса для {% data variables.product.prodname_vscode_shortname %} -You can configure the interface settings for {% data variables.product.prodname_vscode_shortname %}, with three scopes: Workspace, Remote [Codespaces], and User. You can view these scopes in the {% data variables.product.prodname_vscode_shortname %} Settings editor. +Параметры интерфейса для {% data variables.product.prodname_vscode_shortname %} можно настроить с тремя областями: Рабочая область, Удаленные [пространства кода] и Пользователь. Эти области можно просмотреть в редакторе параметров {% data variables.product.prodname_vscode_shortname %}. -![Screenshot showing the choice of scopes in the Settings editor](/assets/images/help/codespaces/scopes-for-vscode.png) +![Снимок экрана: выбор областей в редакторе параметров](/assets/images/help/codespaces/scopes-for-vscode.png) -If a setting is defined in multiple scopes, Workspace settings take priority, then Remote [Codespaces], then User. +Если параметр определен в нескольких областях, в первую очередь приоритет имеют параметры рабочей области, затем параметры удаленного репозитория [Codespaces] , а затем пользователя. -You can define default interface settings for {% data variables.product.prodname_vscode_shortname %} in two places. +Параметры интерфейса по умолчанию для {% data variables.product.prodname_vscode_shortname %} можно определить в двух местах. -* Interface settings defined in the `.vscode/settings.json` file in your repository are applied as Workspace-scoped settings in the codespace. -* Interface settings defined in the `settings` key in the `devcontainer.json` file are applied as Remote [Codespaces]-scoped settings in the codespace. +* Параметры интерфейса, определенные в `.vscode/settings.json` файле в репозитории, применяются как параметры области рабочей области в codespace. +* Параметры интерфейса, определенные в `settings` ключе в `devcontainer.json` файле, применяются как удаленные [Codespaces] параметры в codespace. -## Applying configuration changes to a codespace +## Применение изменений конфигурации к среде codespace -Changes to a configuration will be applied the next time you create a codespace. However, you can apply your changes to an existing codespace by rebuilding the container. You can do this within a codespace in the {% data variables.product.prodname_vscode_shortname %} web client or desktop application, or you can use {% data variables.product.prodname_cli %}. +Изменения конфигурации будут применены при следующем создании codespace. Однако вы можете применить изменения к существующему пространству кода, перестроив контейнер. Это можно сделать в codespace в веб-клиенте или классическом приложении {% data variables.product.prodname_vscode_shortname %} или использовать {% data variables.product.prodname_cli %}. -### Rebuilding the dev container in the {% data variables.product.prodname_vscode_shortname %} web client or desktop application +### Перестроение контейнера разработки в веб-клиенте или классическом приложении {% data variables.product.prodname_vscode_shortname %} {% data reusables.codespaces.rebuild-command %} 1. {% data reusables.codespaces.recovery-mode %} - ![Screenshot of the error message about recovery mode](/assets/images/help/codespaces/recovery-mode-error-message.png) + ![Снимок экрана: сообщение об ошибке о режиме восстановления](/assets/images/help/codespaces/recovery-mode-error-message.png) - - To diagnose the error by reviewing the creation logs, click **View creation log**. - - To fix the errors identified in the logs, update your `devcontainer.json` file. - - To apply the changes, rebuild your container. + - Диагностируйте проблему путем просмотра журналов создания. Для этого нажмите кнопку **Просмотр журнала создания**. + - Чтобы устранить ошибки, выявленные в журналах, обновите файл `devcontainer.json`. + - Чтобы применить изменения, перестройте контейнер. -### Using {% data variables.product.prodname_cli %} to rebuild a dev container +### Использование {% data variables.product.prodname_cli %} для перестроения контейнера разработки -If you've changed a dev container configuration outside of VS Code (for example, on {% data variables.product.prodname_dotcom_the_website %} or in a JetBrains IDE), you can use {% data variables.product.prodname_cli %} to rebuild the dev container for an existing codespace. +Если вы изменили конфигурацию контейнера разработки за пределами VS Code (например, в {% data variables.product.prodname_dotcom_the_website %} или в интегрированной среде разработки JetBrains), вы можете использовать {% data variables.product.prodname_cli %} для перестроения контейнера разработки для существующего пространства кода. -1. In a terminal, enter the following command. +1. В окне терминала введите следующую команду. ``` gh cs rebuild ``` - Your codespaces are listed. + В списке перечислены пространства кода. -1. Use the arrow keys on your keyboard to highlight the required codespace, then press Enter. +1. Используйте клавиши со стрелками на клавиатуре, чтобы выделить требуемое кодовое пространство, а затем нажмите клавишу ВВОД. -## Further reading +## Дополнительные материалы -- "[Prebuilding your codespaces](/codespaces/prebuilding-your-codespaces)" +- [Предварительная сборка сред codespace](/codespaces/prebuilding-your-codespaces) diff --git a/translations/ru-RU/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md b/translations/ru-RU/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md index a4c21cac4d..d2886f3931 100644 --- a/translations/ru-RU/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md +++ b/translations/ru-RU/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md @@ -1,5 +1,5 @@ --- -title: Устранение неполадок с клиентами GitHub Codespaces +title: Устранение неполадок клиентов GitHub Codespaces shortTitle: Codespaces clients intro: 'В этой статье содержатся сведения об устранении неполадок, которые могут возникнуть с клиентом, используемым для {% data variables.product.prodname_github_codespaces %}.' miniTocMaxHeadingLevel: 3 @@ -11,12 +11,12 @@ topics: - Codespaces redirect_from: - /codespaces/troubleshooting/troubleshooting-codespaces-clients -ms.openlocfilehash: 682160b3b92960487c0709fc411fc2143d18f415 -ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.openlocfilehash: 35bd9dd859612307c1f9e49ea8ed9771e4f5efcd +ms.sourcegitcommit: bf4e3590ab71b0a1bfa8d74b00183f63193acbbf ms.translationtype: MT ms.contentlocale: ru-RU -ms.lasthandoff: 11/09/2022 -ms.locfileid: '148159901' +ms.lasthandoff: 11/30/2022 +ms.locfileid: '148186174' --- {% jetbrains %} @@ -28,9 +28,9 @@ ms.locfileid: '148159901' ## Устранение неполадок веб-клиента {% data variables.product.prodname_vscode %} -Если у вас возникли проблемы с использованием {% data variables.product.prodname_github_codespaces %} в браузере, который не является Chromium, попробуйте переключиться на браузер на основе Chromium, например Google Chrome или Microsoft Edge. Кроме того, проверьте наличие известных проблем с браузером в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen) , выполнив поиск проблем с именем браузера, например [`firefox`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+label%3Afirefox) или [`safari`](https://github.com/Microsoft/vscode/issues?q=is%3Aopen+is%3Aissue+label%3Asafari). +При возникновении проблем с использованием {% data variables.product.prodname_github_codespaces %} в браузере, который не Chromium, попробуйте переключиться на браузер на основе Chromium, например Google Chrome или Майкрософт Edge. Кроме того, можно проверить наличие известных проблем с браузером в [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen) репозитории, выполнив поиск проблем с именем браузера, например [`firefox`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+label%3Afirefox) или [`safari`](https://github.com/Microsoft/vscode/issues?q=is%3Aopen+is%3Aissue+label%3Asafari). -Если у вас возникли проблемы с использованием {% data variables.product.prodname_github_codespaces %} в браузере на основе Chromium, вы можете проверить, возникла ли другая известная проблема с {% data variables.product.prodname_vscode_shortname %} в репозитории[`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen). +При возникновении проблем с использованием {% data variables.product.prodname_github_codespaces %} в браузере на основе Chromium вы можете проверить, возникла ли другая известная проблема с {% data variables.product.prodname_vscode_shortname %} в репозитории[`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen). ### Отличия от локальной работы в {% data variables.product.prodname_vscode_shortname %} @@ -46,7 +46,7 @@ ms.locfileid: '148159901' Щелкните {% octicon "gear" aria-label="The manage icon" %} в левом нижнем углу редактора и выберите **Переключиться на стабильную версию...**. Если веб-клиент {% data variables.product.prodname_vscode_shortname %} не загружается или значок {% octicon "gear" aria-label="The manage icon" %} недоступен, можно принудительно переключиться на {% data variables.product.prodname_vscode %} Stable, добавив `?vscodeChannel=stable` к URL-адресу codespace и загрузив codespace по нему. -Если проблема не устранена в {% data variables.product.prodname_vscode %} Stable, проверьте наличие известных проблем и при необходимости зафиксировать новую проблему в интерфейсе {% data variables.product.prodname_vscode_shortname %} в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) . +Если проблема не устранена в {% data variables.product.prodname_vscode %} Stable, проверьте наличие известных проблем и при необходимости зайдите в журнал новой проблемы в интерфейсе {% data variables.product.prodname_vscode_shortname %} в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) . {% endwebui %} @@ -54,9 +54,9 @@ ms.locfileid: '148159901' ## Устранение неполадок с {% data variables.product.prodname_vscode_shortname %} -При открытии пространства кода в классическом приложении {% data variables.product.prodname_vscode_shortname %} вы можете заметить несколько различий по сравнению с работой в локальной рабочей области, но взаимодействие должно быть аналогичным. +При открытии codespace в классическом приложении {% data variables.product.prodname_vscode_shortname %} вы можете заметить несколько различий по сравнению с работой в локальной рабочей области, но взаимодействие должно быть аналогичным. -При возникновении проблем можно проверить наличие известных проблем и записать новые проблемы в {% data variables.product.prodname_vscode_shortname %} в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) . +При возникновении проблем можно проверить наличие известных проблем и записать новые проблемы в интерфейсе {% data variables.product.prodname_vscode_shortname %} в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) . ### {% data variables.product.prodname_vscode %} Insiders @@ -66,23 +66,23 @@ ms.locfileid: '148159901' Чтобы переключиться на {% data variables.product.prodname_vscode %} Stable, закройте приложение {% data variables.product.prodname_vscode %}, откройте приложение {% data variables.product.prodname_vscode %} Stable и снова откройте codespace. -Если проблема не устранена в {% data variables.product.prodname_vscode %} Stable, проверьте наличие известных проблем и при необходимости зафиксировать новую проблему в интерфейсе {% data variables.product.prodname_vscode_shortname %} в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) . +Если проблема не устранена в {% data variables.product.prodname_vscode %} Stable, проверьте наличие известных проблем и при необходимости зайдите в журнал новой проблемы в интерфейсе {% data variables.product.prodname_vscode_shortname %} в репозитории [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) . {% endvscode %} {% jetbrains %} -## Устранение неполадок с URI JetBrains +## Устранение неполадок с ИНДЕ JetBrains ### Проблемы с производительностью -Тип компьютера {% data variables.product.prodname_github_codespaces %} с по крайней мере 4 ядрами рекомендуется использовать для запуска любого из URI JetBrains. Дополнительные сведения см. в разделе [Изменение типа компьютера для кодового пространства](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace). +Тип компьютера {% data variables.product.prodname_github_codespaces %} с по крайней мере 4 ядрами рекомендуется использовать для выполнения любого из ИНДЕ JetBrains. Дополнительные сведения см. в разделе [Изменение типа компьютера для кодового пространства](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace). -Если вы используете компьютер с 4 или более ядрами и производительность JetBrains выглядит немного вялой, может потребоваться увеличить максимальный размер кучи Java. +Если вы используете компьютер с 4 или более ядрами и производительность JetBrains кажется немного вялой, может потребоваться увеличить максимальный размер кучи Java. Рекомендуется установить максимальный размер кучи в диапазоне от 2862 МиБ (3 ГБ) до 60 % ОЗУ удаленного узла. -Ниже приведены некоторые рекомендации в качестве начальной точки, которую можно настроить в зависимости от размера базы кода и памяти, необходимой для запуска приложения. Например, если у вас есть большая или сложная база кода, может потребоваться увеличить размер кучи. Если у вас есть приложение большего размера, можно задать меньший размер кучи, чтобы предоставить приложению больше памяти. +Ниже приведены некоторые рекомендации в качестве начальной отправной точки, которые можно настроить в зависимости от размера базы кода и памяти, необходимой для запуска приложения. Например, при наличии большой или сложной базы кода может потребоваться дополнительно увеличить размер кучи. Если у вас более крупное приложение, можно задать меньший размер кучи, чтобы предоставить приложению больший объем памяти. | Тип компьютера | Максимальный размер кучи | | -------------- | ----------------- | @@ -102,17 +102,41 @@ ms.locfileid: '148159901' ![Снимок экрана: параметр максимального размера кучи](/assets/images/help/codespaces/jetbrains-heap-setting.png) -1. Щелкните **Сохранить и перезапустить**. +1. Нажмите кнопку **Сохранить и перезапустить**. + +### Невозможно открыть клиент в MacOS Ventura + +В MacOS Ventura при первой попытке подключиться к codespace из шлюза JetBrains может появиться сообщение о том, что клиентское приложение JetBrains "повреждено и не может быть открыто". + +Screenshot of the 'cannot be opened' error message + +Если это происходит, выполните указанные ниже действия. + +1. Нажмите **кнопку Отмена** , чтобы закрыть это сообщение. +1. Щелкните значок Apple в левом верхнем углу экрана и щелкните **Параметры системы**. +1. Щелкните **Конфиденциальность & Безопасность** и прокрутите вниз до раздела "Безопасность". + + ![Снимок экрана: диалоговое окно "Безопасность & конфиденциальности"](/assets/images/help/codespaces/jetbrains-privacy-and-security.png) + + Вы увидите сообщение о том, что клиент JetBrains заблокирован. + +1. Нажмите кнопку **Открыть в любом случае** , чтобы добавить клиент JetBrains в распознанные приложения. + Сообщение отображается снова, но на этот раз с кнопкой **Открыть** . + + Screenshot of the error message with an 'Open' button + +1. Нажмите кнопку **Отмена** еще раз. +1. Назад к приложению шлюза JetBrains и снова подключитесь к требуемому пространству кода. + Клиент JetBrains откроется успешно. Авторизовать клиентское приложение для запуска на компьютере Mac вы не увидите сообщение при подключении к codespace в будущем. ### Проблемы с SSH-подключением -Чтобы подключиться через SSH-сервер, работающий в codespace, необходимо иметь ключ SSH в каталоге `~/.ssh` (MacOS и Linux) или `%HOMEPATH%\.ssh` каталоге (Windows), который уже был добавлен в учетную запись {% data variables.product.prodname_dotcom %}. Если в этом каталоге нет ключей, {% data variables.product.prodname_cli %} создаст ключи автоматически. Дополнительные сведения см. в разделе [Добавление адреса нового ключа SSH в учетную запись {% data variables.product.prodname_dotcom %}](/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account?platform=windows&tool=webui). +Для подключения через сервер SSH, работающий в codespace, необходимо иметь ключ SSH в каталоге `~/.ssh` (MacOS и Linux) или `%HOMEPATH%\.ssh` каталоге (Windows), который уже добавлен в учетную запись {% data variables.product.prodname_dotcom %}. Если в этом каталоге нет ключей, {% data variables.product.prodname_cli %} создаст ключи. Дополнительные сведения см. в разделе [Добавление адреса нового ключа SSH в учетную запись {% data variables.product.prodname_dotcom %}](/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account?platform=windows&tool=webui). При возникновении проблем с проверкой ключа попробуйте обновить версию {% data variables.product.prodname_cli %}. Дополнительные сведения см. в [инструкциях по обновлению](https://github.com/cli/cli#installation) в файле сведений для {% data variables.product.prodname_cli %}. ### Проблемы с интегрированной среды разработки JetBrains -Сведения о проблемах, связанных с используемой интегрированной среды разработки JetBrains или приложением шлюза JetBrains, см. в разделе Поддержка [продуктов](https://www.jetbrains.com/support/) на веб-сайте JetBrains. +Справку по проблемам, связанным с используемой интегрированной среды разработки JetBrains или приложением шлюза JetBrains, см. в разделе Поддержка [продуктов](https://www.jetbrains.com/support/) на веб-сайте JetBrains. {% endjetbrains %} - diff --git a/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md b/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md index fafd93d4dd..257f7823c2 100644 --- a/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md +++ b/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md @@ -1,123 +1,125 @@ --- -title: Getting started with GitHub Copilot in a JetBrains IDE +title: Начало работы с GitHub Copilot в интегрированной среде разработки JetBrains shortTitle: JetBrains IDE -intro: 'Learn how to install {% data variables.product.prodname_copilot %} in a JetBrains IDE, and start seeing suggestions as you write comments and code.' +intro: 'Узнайте, как установить {% data variables.product.prodname_copilot %} в интегрированной среде разработки JetBrains и начать видеть предложения при написании комментариев и кода.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot topics: - Copilot +ms.openlocfilehash: ae879b5834007a34ab0e3a7a45dcae4c1e31bc4f +ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67 +ms.translationtype: MT +ms.contentlocale: ru-RU +ms.lasthandoff: 11/29/2022 +ms.locfileid: '148185062' --- - {% data reusables.copilot.copilot-cta-button %} -## About {% data variables.product.prodname_copilot %} and JetBrains IDEs +## Сведения о {% data variables.product.prodname_copilot %} и интегрированной среде разработки JetBrains {% data reusables.copilot.procedural-intro %} -If you use a JetBrains IDE, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within a JetBrains IDE for macOS, Windows, or Linux. +Если вы используете интегрированную среду разработки JetBrains, вы можете просматривать и включать предложения из {% data variables.product.prodname_copilot %} непосредственно в редакторе. В этом руководстве описано, как использовать {% data variables.product.prodname_copilot %} в интегрированной среде разработки JetBrains для macOS, Windows или Linux. -## Prerequisites +## Предварительные требования {% data reusables.copilot.jetbrains-ides %} -## Installing the {% data variables.product.prodname_copilot %} extension in your JetBrains IDE +## Установка расширения {% data variables.product.prodname_copilot %} в интегрированной среде разработки JetBrains -To use {% data variables.product.prodname_copilot %} in a JetBrains IDE, you must install the {% data variables.product.prodname_copilot %} extension. The following procedure will guide you through installation of the {% data variables.product.prodname_copilot %} plugin in IntelliJ IDEA. Steps to install the plugin in another supported IDE may differ. +Чтобы настроить {% data variables.product.prodname_copilot %} в интегрированной среде разработки JetBrains, установите расширение {% data variables.product.prodname_copilot %}. Следующая процедура поможет вам установить подключаемый модуль {% data variables.product.prodname_copilot %} в IntelliJ IDEA. Шаги по установке подключаемого модуля в другой поддерживаемой интегрированной среде разработки могут отличаться. -1. In your JetBrains IDE, under the **File** menu for Windows or under the name of your IDE for Mac (for example, **PyCharm** or **IntelliJ**), click **Settings** for Windows or **Preferences** for Mac. -2. In the left-side menu of the **Settings/Preferences** dialog box, click **Plugins**. -3. At the top of the **Settings/Preferences** dialog box, click **Marketplace**. In the search bar, search for **{% data variables.product.prodname_copilot %}**, then click **Install**. - ![Screenshot of Marketplace search](/assets/images/help/copilot/jetbrains-marketplace.png) -1. After {% data variables.product.prodname_copilot %} is installed, click **Restart IDE**. -1. After your JetBrains IDE has restarted, click the **Tools** menu. Click **{% data variables.product.prodname_copilot %}**, then click **Login to {% data variables.product.prodname_dotcom %}**. - ![Screenshot of JetBrains tools menu](/assets/images/help/copilot/jetbrains-tools-menu.png) -1. In the "Sign in to {% data variables.product.prodname_dotcom %}" dialog box, to copy the device code and open the device activation window, click **Copy and Open**. - ![Screenshot of device code copy and open](/assets/images/help/copilot/device-code-copy-and-open.png) -1. A device activation window will open in your browser. Paste the device code, then click **Continue**. +1. В интегрированной среде разработки JetBrains в меню **Файл** для Windows или под именем интегрированной среды разработки для Mac (например, **PyCharm** или **IntelliJ**) щелкните **Параметры** для Windows или **Настройки** для Mac. +2. В левом меню диалогового окна **Параметры/Настройки** щелкните **"Подключаемые модули**. +3. В верхней части диалогового окна **Параметры/Настройки** щелкните **Marketplace**. В строке поиска введите **{% data variables.product.prodname_copilot %}** и нажмите кнопку **Установить**. + ![Снимок экрана: поиск на Marketplace](/assets/images/help/copilot/jetbrains-marketplace.png) +1. После установки {% data variables.product.prodname_copilot %} нажмите кнопку **Перезапустить интегрированную среду разработки**. +1. После перезапуска интегрированной среды разработки JetBrains щелкните меню **Сервис**. Щелкните **{% data variables.product.prodname_copilot %}** , а затем нажмите **Вход в {% data variables.product.prodname_dotcom %}** . + ![Снимок экрана: меню инструментов JetBrains](/assets/images/help/copilot/jetbrains-tools-menu.png) +1. В диалоговом окне "Вход в {% data variables.product.prodname_dotcom %}" нажмите кнопку **Копировать и открыть**, чтобы скопировать код устройства и открыть окно активации устройства. + ![Снимок экрана: "Копировать и открыть" для кода устройства](/assets/images/help/copilot/device-code-copy-and-open.png) +1. Окно активации устройства откроется в браузере. Вставьте код устройства и нажмите кнопку **Продолжить**. - - To paste the code in Windows or Linux, press Ctrl+v. - - To paste the code in macOS, press command+v. -1. {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_copilot %} Plugin**. -1. After the permissions have been approved, your JetBrains IDE will show a confirmation. To begin using {% data variables.product.prodname_copilot %}, click **OK**. - ![Screenshot of JetBrains IDE permissions confirmation](/assets/images/help/copilot/jetbrains-ide-confirmation.png) + - Чтобы вставить код в Windows или Linux, нажмите CTRL+V. + - Чтобы вставить код в macOS, нажмите COMMAND+V. +1. {% data variables.product.prodname_dotcom %} запросит необходимые разрешения для {% data variables.product.prodname_copilot %}. Чтобы одобрить эти разрешения, щелкните **Авторизовать подключаемый модуль {% data variables.product.prodname_copilot %}** . +1. После утверждения разрешений интегрированная среда разработки JetBrains отобразит подтверждение. Чтобы начать использование {% data variables.product.prodname_copilot %}, щелкните **OK**. + ![Снимок экрана: подтверждение разрешений интегрированной среды разработки JetBrains](/assets/images/help/copilot/jetbrains-ide-confirmation.png) -## Seeing your first suggestion +## Просмотр первого предложения {% data reusables.copilot.code-examples-limitations %} -{% data reusables.copilot.supported-languages %} The following samples are in Java, but other languages will work similarly. +{% data reusables.copilot.supported-languages %} Следующие примеры приводятся на Java, но будут работать аналогичным образом и для других языков. {% data reusables.copilot.create-java-file %} -1. In the Java file, create a class by typing `class Test`. - {% data variables.product.prodname_copilot %} will automatically suggest a class body in grayed text, as shown below. The exact suggestion may vary. - ![Screenshot of the Java class body suggestion](/assets/images/help/copilot/java-class-body-suggestion-jetbrains.png) -{% data reusables.copilot.accept-suggestion %} -1. To prompt {% data variables.product.prodname_copilot %} to suggest a function body, type the following line below the bracket of the `main` function. The exact suggestion may vary. +1. В файле Java создайте класс, введя `class Test`. + {% data variables.product.prodname_copilot %} автоматически предложит текст класса, выделенный серым цветом, как показано ниже. Точное предложение может отличаться. + ![Снимок экрана: предложение текста класса Java](/assets/images/help/copilot/java-class-body-suggestion-jetbrains.png) {% data reusables.copilot.accept-suggestion %} +1. Чтобы {% data variables.product.prodname_copilot %} мог предложить текст функции, введите следующую строку под скобкой функции `main`. Точное предложение может отличаться. {% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} - ![Screenshot of the Java function body suggestion](/assets/images/help/copilot/java-function-body-suggestion-jetbrains.png) -{% data reusables.copilot.accept-suggestion %} + ![Снимок экрана: предложение текста функции Java](/assets/images/help/copilot/java-function-body-suggestion-jetbrains.png) {% data reusables.copilot.accept-suggestion %} -{% data variables.product.prodname_copilot %} will attempt to match the context and style of your code. You can always edit the suggested code. +{% data variables.product.prodname_copilot %} попытается сопоставить контекст и стиль кода. Вы всегда можете изменить предлагаемый код. -## Seeing alternative suggestions +## Просмотр альтернативных предложений {% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-java-file %} -1. To prompt {% data variables.product.prodname_copilot %} to show you a suggestion, type the following line in the Java file. -{% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} -{% data reusables.copilot.see-alternative-suggestions %} +1. Чтобы {% data variables.product.prodname_copilot %} отобразил предложение, введите следующую строку в файле Java. +{% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} {% data reusables.copilot.see-alternative-suggestions %} - | OS | See next suggestion | See previous suggestion | + | OS | Смотреть следующее предложение | Смотреть предыдущее предложение | | :- | :- | :- | | macOS | Option+] | Option+[ | - | Windows | Alt+] | Alt+[ | - | Linux | Alt+] | Alt+[ | + | Windows | ALT+] | ALT+[ | + | Linux | ALT+] | ALT+[ | {% data reusables.copilot.accept-or-reject-suggestion %} -## Seeing multiple suggestions in a new tab +## Просмотр нескольких предложений на новой вкладке {% data reusables.copilot.suggestions-new-tab %} {% data reusables.copilot.create-java-file %} -1. To prompt {% data variables.product.prodname_copilot %} to show you a suggestion, type the following line in the Java file. +1. Чтобы {% data variables.product.prodname_copilot %} отобразил предложение, введите следующую строку в файле Java. {% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} -1. Open a new tab with multiple additional suggestions. - - On macOS, press Command+Shift+A, then click **Open GitHub Copilot**, or press Command+Shift+\ to open the new tab immediately. - - On Windows or Linux, press Ctrl+Enter, then click **Open GitHub Copilot**. - ![Screenshot of dialogue to open Copilot](/assets/images/help/copilot/open-copilot-tab-jetbrains.png) -1. To accept a suggestion, above the suggestion, click **Accept Solution**. To reject all suggestions, close the tab. +1. Откройте новую вкладку с несколькими дополнительными предложениями. + - В macOS нажмите клавиши COMMAND+SHIFT+A, а затем нажмите **Открыть GitHub Copilot** или нажмите клавиши COMMAND+SHIFT+\, чтобы сразу открыть новую вкладку. + - В Windows или Linux нажмите CTRL+ВВОД, а затем нажмите кнопку **Открыть GitHub Copilot**. + ![Снимок экрана: диалоговое окно для открытия Copilot](/assets/images/help/copilot/open-copilot-tab-jetbrains.png) +1. Чтобы принять предложение, над предложением нажмите кнопку **Принять решение**. Чтобы отклонить все предложения, закройте вкладку. -## Generating code suggestions from comments +## Создание предложений кода из комментариев {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-java-file %} -1. To prompt {% data variables.product.prodname_copilot %} to suggest an implementation of a function in the Java file, type the following lines. +1. Чтобы {% data variables.product.prodname_copilot %} предложил реализацию функции в файле Java, введите следующие строки. ```java{:copy} // find all images without alternate text // and give them a red border void process () { ``` - ![Screenshot of the Java function body suggestion](/assets/images/help/copilot/comment-suggestion-jetbrains.png) + ![Снимок экрана: предложение текста функции Java](/assets/images/help/copilot/comment-suggestion-jetbrains.png) -## Enabling and disabling {% data variables.product.prodname_copilot %} +## Включение и отключение {% data variables.product.prodname_copilot %} -You can enable or disable {% data variables.product.prodname_copilot %} for all languages, or for individual languages. The {% data variables.product.prodname_copilot %} status icon in the bottom panel of your JetBrains IDE window indicates whether {% data variables.product.prodname_copilot %} is enabled or disabled. When enabled, the icon is highlighted. When disabled, the icon is grayed out. +Вы можете включить или отключить {% data variables.product.prodname_copilot %} для всех языков или для отдельных языков. Значок состояния {% data variables.product.prodname_copilot %} на нижней панели окна интегрированной среды разработки JetBrains указывает, включен или отключен параметр {% data variables.product.prodname_copilot %}. Если этот параметр включен, значок выделен. Если он отключен, значок неактивен. -1. To enable or disable {% data variables.product.prodname_copilot %}, click the status icon in the bottom panel of the JetBrains window. - ![Screenshot of the status icon in IntelliJ IDEA](/assets/images/help/copilot/status-icon-jetbrains.png) -2. If you are disabling {% data variables.product.prodname_copilot %}, you will be asked whether you want to disable it globally, or for the language of the file you are currently editing. +1. Чтобы включить или отключить {% data variables.product.prodname_copilot %}, щелкните значок состояния на нижней панели окна JetBrains. + ![Снимок экрана: значок состояния в IntelliJ IDEA](/assets/images/help/copilot/status-icon-jetbrains.png) +2. Если вы отключаете {% data variables.product.prodname_copilot %}, появится запрос, следует ли отключить их глобально или для языка файла, который вы редактируете. - - To disable suggestions from {% data variables.product.prodname_copilot %} globally, click **Disable Completions**. - - To disable suggestions from {% data variables.product.prodname_copilot %} for the specified language, click **Disable Completions for _LANGUAGE_**. - ![Screenshot of option to disable {% data variables.product.prodname_copilot %} globally or for the current language](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) + - Чтобы отключить предложения от {% data variables.product.prodname_copilot %} глобально, нажмите кнопку **Отключить завершение**. + - Чтобы отключить предложения от {% data variables.product.prodname_copilot %} для указанного языка, нажмите кнопку **Отключить завершение для _ЯЗЫК_**. + ![Снимок экрана: отключить {% data variables.product.prodname_copilot %} глобально или для текущего языка](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) -## Further reading +## Дополнительные сведения -- [The {% data variables.product.prodname_copilot %} website](https://copilot.github.com/) -- [About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot#about-the-license-for-the-github-copilot-plugin-in-jetbrains-ides) +- [Веб-сайт {% data variables.product.prodname_copilot %}](https://copilot.github.com/) +- [Сведения о {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot#about-the-license-for-the-github-copilot-plugin-in-jetbrains-ides) diff --git a/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md b/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md index 9894db0413..c275037a16 100644 --- a/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md +++ b/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md @@ -1,105 +1,109 @@ --- -title: Getting started with GitHub Copilot in Visual Studio Code +title: Начало работы с GitHub Copilot в Visual Studio Code shortTitle: Visual Studio Code -intro: 'Learn how to install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, and start seeing suggestions as you write comments and code.' +intro: 'Узнайте, как установить {% data variables.product.prodname_copilot %} в {% data variables.product.prodname_vscode %} и начать видеть предложения при написании комментариев и кода.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot topics: - Copilot +ms.openlocfilehash: 63c670a7cd5263057f79b7761a960854ecac2dd6 +ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67 +ms.translationtype: MT +ms.contentlocale: ru-RU +ms.lasthandoff: 11/29/2022 +ms.locfileid: '148185141' --- - {% data reusables.copilot.copilot-cta-button %} -## About {% data variables.product.prodname_copilot %} and {% data variables.product.prodname_vscode %} +## Сведения о {% data variables.product.prodname_copilot %} и {% data variables.product.prodname_vscode %} {% data reusables.copilot.procedural-intro %} -If you use {% data variables.product.prodname_vscode %}, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within {% data variables.product.prodname_vscode %} for macOS, Windows, or Linux. +Если вы используете {% data variables.product.prodname_vscode %}, вы можете просматривать и включать предложения из {% data variables.product.prodname_copilot %} непосредственно в редакторе. В этом руководстве описано, как использовать {% data variables.product.prodname_copilot %} в {% data variables.product.prodname_vscode %} для macOS, Windows или Linux. -## Prerequisites +## Предварительные требования -To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must have {% data variables.product.prodname_vscode %} installed. For more information, see the [{% data variables.product.prodname_vscode %} download page](https://code.visualstudio.com/Download). +Чтобы использовать {% data variables.product.prodname_copilot %} в {% data variables.product.prodname_vscode %}, необходимо установить {% data variables.product.prodname_vscode %}. Дополнительные сведения см. на [странице загрузки {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/Download). -## Installing the {% data variables.product.prodname_vscode %} extension +## Установка расширения {% data variables.product.prodname_vscode %} -To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vscode %} extension. +Чтобы использовать {% data variables.product.prodname_copilot %}, сначала установите {% data variables.product.prodname_vscode %}. -1. In the {% data variables.product.prodname_vscode %} Marketplace, go to the [{% data variables.product.prodname_copilot %} extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) page and click **Install**. - ![Install {% data variables.product.prodname_copilot %} extension {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) -1. A popup will appear, asking to open {% data variables.product.prodname_vscode %}. Click **Open {% data variables.product.prodname_vscode %}**. -1. In the "Extension: {% data variables.product.prodname_copilot %}" tab in {% data variables.product.prodname_vscode %}, click **Install**. - ![Install button in {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) -1. If you have not previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, you will be prompted to sign in to {% data variables.product.prodname_dotcom %} in {% data variables.product.prodname_vscode %}. - - If you have previously authorized {% data variables.product.prodname_vscode %} for your account on {% data variables.product.prodname_dotcom %}, {% data variables.product.prodname_copilot %} will be automatically authorized. - ![Screen shot of {% data variables.product.prodname_vscode %} authorization screen](/assets/images/help/copilot/vsc-copilot-authorize.png) -1. In your browser, {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_vscode %}**. -1. In {% data variables.product.prodname_vscode %}, in the "{% data variables.product.prodname_vscode %}" dialog box, to confirm the authentication, click **Open**. +1. В {% data variables.product.prodname_vscode %} Marketplace перейдите на страницу [Расширение {% data variables.product.prodname_copilot %}](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) и щелкните **Установить**. + ![Установка расширения {% data variables.product.prodname_copilot %} {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) +1. Появится всплывающее окно с просьбой открыть {% data variables.product.prodname_vscode %}. Щелкните **Открыть {% data variables.product.prodname_vscode %}** . +1. На вкладке "Расширение: {% data variables.product.prodname_copilot %}" в {% data variables.product.prodname_vscode %} щелкните **Установить**. + ![Кнопка установки в {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) +1. Если вы еще не авторизовали {% data variables.product.prodname_vscode %} в учетной записи {% data variables.product.prodname_dotcom %}, появится запрос на вход в {% data variables.product.prodname_dotcom %} в {% data variables.product.prodname_vscode %}. + - Если вы уже авторизовали {% data variables.product.prodname_vscode %} для учетной записи на {% data variables.product.prodname_dotcom %}, {% data variables.product.prodname_copilot %} будет авторизован автоматически. + ![Снимок экрана: экран авторизации {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/vsc-copilot-authorize.png) +1. В браузере {% data variables.product.prodname_dotcom %} запросит необходимые разрешения для {% data variables.product.prodname_copilot %}. Чтобы одобрить эти разрешения, щелкните **Авторизовать {% data variables.product.prodname_vscode %}** . +1. В {% data variables.product.prodname_vscode %} в диалоговом окне "{% data variables.product.prodname_vscode %}" для подтверждения подлинности щелкните **Открыть**. -## Seeing your first suggestion +## Просмотр первого предложения {% data reusables.copilot.code-examples-limitations %} -{% data reusables.copilot.supported-languages %} The following samples are in JavaScript, but other languages will work similarly. +{% data reusables.copilot.supported-languages %} Следующие примеры находятся на JavaScript, но другие языки будут работать аналогичным образом. {% data reusables.copilot.create-js-file %} -1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. +1. В файле JavaScript введите следующий заголовок функции. {% data variables.product.prodname_copilot %} автоматически предложит весь текст функции, выделенный серым цветом, как показано ниже. Точное предложение может отличаться. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` - ![Screenshot of a first suggestion {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) -{% data reusables.copilot.accept-suggestion %} + ![Снимок экрана: первое предложение {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) {% data reusables.copilot.accept-suggestion %} -## Seeing alternative suggestions +## Просмотр альтернативных предложений {% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-js-file %} -1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will show you a suggestion. +1. В файле JavaScript введите следующий заголовок функции. {% data variables.product.prodname_copilot %} покажет предложение. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` {% data reusables.copilot.see-alternative-suggestions %} - | OS | See next suggestion | See previous suggestion | + | OS | Смотреть следующее предложение | Смотреть предыдущее предложение | | :- | :- | :- | - |macOS|Option (⌥) or Alt+]|Option (⌥) or Alt+[| - |Windows|Alt+]|Alt+[| - |Linux|Alt+]|Alt+[| -1. Alternatively, you can hover over the suggestion to see the {% data variables.product.prodname_copilot %} command palette for choosing suggestions. + |macOS|Option (⌥) или ALT+]|Option (⌥) или ALT+[| + |Windows|ALT+]|ALT+[| + |Linux|ALT+]|ALT+[| +1. Кроме того, можно навести указатель мыши на предложение, чтобы просмотреть палитру команд {% data variables.product.prodname_copilot %} для выбора предложений. {% data reusables.copilot.accept-or-reject-suggestion %} -## Seeing multiple suggestions in a new tab +## Просмотр нескольких предложений на новой вкладке {% data reusables.copilot.suggestions-new-tab %} {% data reusables.copilot.create-js-file %} -1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will show you a suggestion. +1. В файле JavaScript введите следующий заголовок функции. {% data variables.product.prodname_copilot %} покажет предложение. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` -1. To open a new tab with multiple additional options, press Ctrl+Enter. -1. To accept a suggestion, above the suggestion, click **Accept Solution**. To reject all suggestions, close the tab. +1. Чтобы открыть новую вкладку с несколькими дополнительными параметрами, нажмите CTRL+ВВОД. +1. Чтобы принять предложение, над предложением нажмите кнопку **Принять решение**. Чтобы отклонить все предложения, закройте вкладку. -## Generating code suggestions from comments +## Создание предложений кода из комментариев {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-js-file %} -1. In the JavaScript file, type the following comment. {% data variables.product.prodname_copilot %} will suggest an implementation of the function. +1. В файле JavaScript введите следующий комментарий. {% data variables.product.prodname_copilot %} предложит реализацию функции. ```javascript{:copy} // find all images without alternate text // and give them a red border function process() { ``` -## Using a framework +## Использование платформы -You can also use {% data variables.product.prodname_copilot %} to generate suggestions for APIs and frameworks. The following example uses {% data variables.product.prodname_copilot %} to create a simple Express server that returns the current time. +Вы также можете использовать {% data variables.product.prodname_copilot %} для создания предложений для API и платформ. В следующем примере для создания простого сервера Express, возвращающего текущее время, используется {% data variables.product.prodname_copilot %}. {% data reusables.copilot.create-js-file %} -1. In the JavaScript file, type the following comment and then press Enter. {% data variables.product.prodname_copilot %} will suggest an implementation of the Express app. +1. В файле JavaScript введите следующий комментарий и нажмите клавишу ВВОД. {% data variables.product.prodname_copilot %} предложит реализацию приложения Express. ```javascript{:copy} // Express server on port 3000 1. To accept each line, press Tab, then Enter. @@ -107,10 +111,10 @@ You can also use {% data variables.product.prodname_copilot %} to generate sugge ```javascript{:copy} // Return the current time ``` -1. To accept each line, press Tab. +1. Чтобы принять каждую строку, нажмите клавишу TAB. {% data reusables.copilot.enabling-or-disabling-in-vsc %} -## Further reading +## Дополнительные сведения - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md b/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md index 618bbdb98a..fd89715bbc 100644 --- a/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md +++ b/translations/ru-RU/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md @@ -1,84 +1,86 @@ --- -title: Getting started with GitHub Copilot in Visual Studio +title: Начало работы с GitHub Copilot в Visual Studio shortTitle: Visual Studio product: '{% data reusables.gated-features.copilot %}' -intro: 'Learn how to install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, and start seeing suggestions as you write comments and code.' +intro: 'Узнайте, как установить {% data variables.product.prodname_copilot %} в {% data variables.product.prodname_vs %} и начать видеть предложения при написании комментариев и кода.' versions: feature: copilot topics: - Copilot +ms.openlocfilehash: 353095b0b0490cd12da8d853754b524431605819 +ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67 +ms.translationtype: MT +ms.contentlocale: ru-RU +ms.lasthandoff: 11/29/2022 +ms.locfileid: '148185138' --- - {% data reusables.copilot.copilot-cta-button %} -## About {% data variables.product.prodname_copilot %} and Visual Studio +## Сведения о {% data variables.product.prodname_copilot %} and Visual Studio {% data reusables.copilot.procedural-intro %} -If you use {% data variables.product.prodname_vs %}, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within {% data variables.product.prodname_vs %} for Windows. +Если вы используете {% data variables.product.prodname_vs %}, вы можете просматривать и включать предложения из {% data variables.product.prodname_copilot %} непосредственно в редакторе. В этом руководстве описано, как использовать {% data variables.product.prodname_copilot %} в {% data variables.product.prodname_vs %} для Windows. -## Prerequisites +## Предварительные требования -To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, you must have {% data variables.product.prodname_vs %} 2022 17.2 or later installed. For more information, see the [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) documentation. +Чтобы использовать {% data variables.product.prodname_copilot %} в {% data variables.product.prodname_vs %}, необходимо установить {% data variables.product.prodname_vs %} 2022 17.2 или более поздней версии. Дополнительные сведения см. в [документации по интегрированной среде разработки Visual Studio](https://visualstudio.microsoft.com/vs/). {% note %} -**Note**: {% data variables.product.prodname_copilot %} is not currently available for use with Visual Studio for Mac. +**Примечание.** {% data variables.product.prodname_copilot %} в настоящее время недоступен для использования с Visual Studio для Mac. {% endnote %} -## Installing the {% data variables.product.prodname_vs %} extension +## Установка расширения {% data variables.product.prodname_vs %} -To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vs %} extension. -1. In the Visual Studio toolbar, click **Extensions**, then click **Manage Extensions**. - ![Screenshot of the Visual Studio toolbar](/assets/images/help/copilot/visual-studio-toolbar.png) -1. In the "Manage Extensions" window, click **Visual Studio Marketplace**, search for the {% data variables.product.prodname_copilot %} extension, then click **Download**. - ![Screenshot of GitHub Copilot extension for Visual Studio with the download button emphasized](/assets/images/help/copilot/install-copilot-extension-visual-studio.png) -1. Close the "Manage Extensions" window, then exit and relaunch {% data variables.product.prodname_vs %}. -1. Optionally, to check that {% data variables.product.prodname_copilot %} is installed and enabled, go back to **Manage Extensions**, click **Installed** to view your currently installed extensions, then click **{% data variables.product.prodname_copilot %}** to see status information. - ![Screenshot of installed extensions in Visual Studio with GitHub Copilot emphasized](/assets/images/help/copilot/installed-copilot-extension-visual-studio.png) -1. Open or create a new project in {% data variables.product.prodname_vs %}. -1. In the "Microsoft {% data variables.product.prodname_vs %}" dialog box, to copy your device activation code, click **OK**. - ![Screenshot of the Microsoft {% data variables.product.prodname_vs %} dialogue box](/assets/images/help/copilot/vs-auth-dialogue.png) -1. A device activation window will open in your browser. Paste the device code, then click **Continue**. +Чтобы использовать {% data variables.product.prodname_copilot %}, сначала установите {% data variables.product.prodname_vs %}. +1. На панели инструментов Visual Studio щелкните **Расширения**, а затем — **Управление расширениями**. + ![Снимок экрана: панель инструментов Visual Studio](/assets/images/help/copilot/visual-studio-toolbar.png) +1. В окне "Управление расширениями" щелкните **Visual Studio Marketplace**, найдите расширение {% data variables.product.prodname_copilot %}, а затем нажмите кнопку **Скачать**. + ![Снимок экрана: расширение Copilot GitHub для Visual Studio с выделенной кнопкой загрузки](/assets/images/help/copilot/install-copilot-extension-visual-studio.png) +1. Закройте окно "Управление расширениями", а затем закройте и повторно запустите {% data variables.product.prodname_vs %}. +1. При необходимости, чтобы убедиться, что {% data variables.product.prodname_copilot %} установлен и включен, вернитесь в раздел **Управление расширениями**, нажмите кнопку **Установлено**, чтобы просмотреть установленные расширения, а затем щелкните **{% data variables.product.prodname_copilot %}** , чтобы просмотреть сведения о состоянии. + ![Снимок экрана: установленные расширения в Visual Studio с выделенным элементом GitHub Copilot](/assets/images/help/copilot/installed-copilot-extension-visual-studio.png) +1. Откройте или создайте проект в {% data variables.product.prodname_vs %}. +1. В диалоговом окне "Microsoft {% data variables.product.prodname_vs %}" скопируйте код активации устройства, нажав кнопку **ОК**. + ![Снимок экрана: диалоговое окно Microsoft {% data variables.product.prodname_vs %}](/assets/images/help/copilot/vs-auth-dialogue.png) +1. Окно активации устройства откроется в браузере. Вставьте код устройства и нажмите кнопку **Продолжить**. - - To paste the code in Windows or Linux, press Ctrl+v. - - To paste the code in macOS, press command+v. -1. {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_copilot %} Plugin**. -1. After you approve the permissions, {% data variables.product.prodname_vs %} will show a confirmation. - ![Screenshot of {% data variables.product.prodname_vs %} permissions confirmation](/assets/images/help/copilot/vs-confirmation.png) + - Чтобы вставить код в Windows или Linux, нажмите CTRL+V. + - Чтобы вставить код в macOS, нажмите COMMAND+V. +1. {% data variables.product.prodname_dotcom %} запросит необходимые разрешения для {% data variables.product.prodname_copilot %}. Чтобы одобрить эти разрешения, щелкните **Авторизовать подключаемый модуль {% data variables.product.prodname_copilot %}** . +1. Когда вы одобрите разрешения, {% data variables.product.prodname_vs %} отобразит подтверждение. + ![Снимок экрана: подтверждение разрешений для {% data variables.product.prodname_vs %}](/assets/images/help/copilot/vs-confirmation.png) -## Seeing your first suggestion +## Просмотр первого предложения -{% data reusables.copilot.code-examples-limitations %} -{% data reusables.copilot.supported-languages %} The following samples are in C#, but other languages will work similarly. +{% data reusables.copilot.code-examples-limitations %} {% data reusables.copilot.supported-languages %} Приведенные ниже примеры используются на языке C#, но другие языки будут работать аналогичным образом. {% data reusables.copilot.create-c-file %} -1. In the C# file, type the following function signature. {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. +1. В файле C# введите следующую сигнатуру функции. {% data variables.product.prodname_copilot %} автоматически предложит весь текст функции, выделенный серым цветом, как показано ниже. Точное предложение может отличаться. ```csharp{:copy} int CalculateDaysBetweenDates( ``` - ![Screenshot of a first suggestion Visual Studio Code](/assets/images/help/copilot/first-suggestion-visual-studio.png) -{% data reusables.copilot.accept-suggestion %} + ![Снимок экрана: первое предложение Visual Studio Code](/assets/images/help/copilot/first-suggestion-visual-studio.png) {% data reusables.copilot.accept-suggestion %} -## Seeing alternative suggestions -{% data reusables.copilot.alternative-suggestions %} -{% data reusables.copilot.create-c-file %} -1. In the C# file, type the following function signature. {% data variables.product.prodname_copilot %} will show you a suggestion. +## Просмотр альтернативных предложений +{% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-c-file %} +1. В файле C# введите следующую сигнатуру функции. {% data variables.product.prodname_copilot %} покажет предложение. ```csharp{:copy} int CalculateDaysBetweenDates( ``` -1. If alternative suggestions are available, you can see these alternatives by pressing Alt+] (or Alt+[). -1. Optionally, you can hover over the suggestion to see the {% data variables.product.prodname_copilot %} command palette for choosing suggestions. +1. Если доступны альтернативные предложения, вы можете увидеть эти альтернативы, нажав клавиши ALT+] (или ALT+[). +1. Кроме того, можно навести указатель мыши на предложение, чтобы просмотреть палитру команд {% data variables.product.prodname_copilot %} для выбора предложений. {% data reusables.copilot.accept-or-reject-suggestion %} -## Generating code suggestions from comments +## Создание предложений кода из комментариев {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-c-file %} -1. In the C# file, type the following comment. {% data variables.product.prodname_copilot %} will suggest an implementation of the function. +1. В файле C# введите следующий комментарий. {% data variables.product.prodname_copilot %} предложит реализацию функции. ```csharp{:copy} using System.Xml.Linq; @@ -91,6 +93,6 @@ To use {% data variables.product.prodname_copilot %}, you must first install the {% data reusables.copilot.enabling-or-disabling-vs %} -## Further reading +## Дополнительные сведения - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/ru-RU/content/developers/github-marketplace/github-marketplace-overview/about-marketplace-badges.md b/translations/ru-RU/content/developers/github-marketplace/github-marketplace-overview/about-marketplace-badges.md index d0036720dd..0a2298976b 100644 --- a/translations/ru-RU/content/developers/github-marketplace/github-marketplace-overview/about-marketplace-badges.md +++ b/translations/ru-RU/content/developers/github-marketplace/github-marketplace-overview/about-marketplace-badges.md @@ -7,12 +7,12 @@ redirect_from: versions: fpt: '*' ghec: '*' -ms.openlocfilehash: bba9137fc39c1bc101a75650dcea03e651d37fff -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT +ms.openlocfilehash: 27f11aa4ae2693bcc336ecdf4cbfb68d8679d743 +ms.sourcegitcommit: 74c60a4564bcc17e47b5a67941ac6d9fe13b6a5c +ms.translationtype: MT ms.contentlocale: ru-RU -ms.lasthandoff: 09/05/2022 -ms.locfileid: '145089725' +ms.lasthandoff: 11/30/2022 +ms.locfileid: '148186166' --- ## Для приложений GitHub @@ -39,7 +39,7 @@ ms.locfileid: '145089725' ## Для GitHub Actions -Наличие значка {% octicon "verified" aria-label="The verified badge" %} (то есть подтвержденный создатель) у действия означает, что создатель действия является подтвержденной партнерской организацией на {% data variables.product.prodname_dotcom %}. +Действия с {% octicon "verified" aria-label="The verified badge" %} или verified creator badge указывают на то, что {% data variables.product.prodname_dotcom %} проверил создателя действия в качестве партнерской организации. Партнеры могут отправить запрос на получение эмблемы проверенного создателя по электронной почте partnerships@github.com . ![Значок подтвержденного создателя на GitHub Actions](/assets/images/marketplace/verified-creator-badge-for-actions.png) diff --git a/translations/ru-RU/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md b/translations/ru-RU/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md index 6cd0869e32..41b73a62fc 100644 --- a/translations/ru-RU/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md +++ b/translations/ru-RU/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md @@ -5,12 +5,12 @@ versions: fpt: '*' permissions: 'Organization owners who are admins for a classroom can connect learning management systems to {% data variables.product.prodname_classroom %}.' shortTitle: Register an LMS -ms.openlocfilehash: e1c1abed5ce4ebf82c19b29fef9a005fbe4c7a02 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 408126833cbf7fa8cd4a71d172f6550e82f795a2 +ms.sourcegitcommit: 1a77ceb9e20c002173dda983db9405bcd5be254a ms.translationtype: MT ms.contentlocale: ru-RU -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148106856' +ms.lasthandoff: 11/29/2022 +ms.locfileid: '148185172' --- ## Сведения о регистрации LMS в классе @@ -51,7 +51,7 @@ ms.locfileid: '148106856' | Раскрывающийся список **служб преимущества LTI** | Установите флажок "Может извлекать пользовательские данные, связанные с контекстом, в котором установлено средство". | | **Раскрывающийся список "Дополнительные параметры"** | В разделе "Уровень конфиденциальности" выберите `Public` | | **Размещения** | Выберите `Course Settings Sub Navigation`.

**Примечание**. Если для размещения задано другое значение, это должно быть сообщено преподавателям. В нашей документации предполагается, что это размещение кнопки. | -6. Выберите команду **Сохранить**. +6. Нажмите **Сохранить**. 7. В таблице на странице "Ключи разработчика" в строке ключа разработчика GitHub Classroom запишите значение идентификатора клиента в столбце "Сведения" - это необходимо сообщить преподавателям, чтобы они завершили настройку. 8. В таблице на странице "Ключи разработчика" в столбце "Состояние" переведите состояние ключа в положение "Вкл.". @@ -63,8 +63,8 @@ ms.locfileid: '148106856' - "Идентификатор издателя": `https://canvas.instructure.com` - "Domain": базовый URL-адрес экземпляра Canvas. - "Идентификатор клиента": "Идентификатор клиента" в разделе "Сведения" из созданного вами ключа разработчика. - - "Конечная точка авторизации OIDC": базовый URL-адрес экземпляра Canvas с `/login/oauth2/token` добавлением в конце. - - "URL-адрес извлечения маркера OAuth 2.0": базовый URL-адрес экземпляра Canvas с `/api/lti/authorize_redirect` добавлением в конце. + - "Конечная точка авторизации OIDC": базовый URL-адрес экземпляра Canvas с `/api/lti/authorize_redirect` добавлением в конце. + - "URL-адрес извлечения маркера OAuth 2.0": базовый URL-адрес экземпляра Canvas с `/login/oauth2/token` добавлением в конце. - "URL-адрес набора ключей": базовый URL-адрес экземпляра Canvas с `/api/lti/security/jwks` добавлением в конце. ![Регистрация экземпляра Canvas в GitHub Classroom](/assets/images/help/classroom/register-canvas-with-github-classroom.png) @@ -127,27 +127,27 @@ ms.locfileid: '148106856' ![Регистрация экземпляра Moodle в GitHub Classroom](/assets/images/help/classroom/register-moodle-with-github-classroom.png) 3. Щелкните **Зарегистрировать**. -4. В верхней части экрана должен появиться баннер "Успешно зарегистрировано LMS". Это означает, что вы зарегистрировали экземпляр LMS, а преподаватели теперь могут связать свои классы. +4. В верхней части экрана должен появиться баннер "Успешно зарегистрировано LMS". Это означает, что вы зарегистрировали экземпляр LMS, и преподаватели теперь могут связывать свои классы. ## Настройка Sakai для {% data variables.product.prodname_classroom %} ### 1. Регистрация {% data variables.product.prodname_classroom %} в качестве внешнего средства 1. Перейдите к Sakai и войдите в систему. -2. Перейдите в раздел "Рабочая область администрирования" и выберите **Внешние средства** на боковой панели слева. +2. Перейдите в раздел "Рабочая область администрирования" и выберите **Внешние инструменты** на левой боковой панели. 3. Щелкните **Install LTI 1.x Tool (Установить средство LTI 1.x).** 4. Введите в поля следующие значения: | Поле в конфигурации приложения Sakai | Значение или параметр | | :- | :- | - | **Имя средства** | GitHub Classroom — [имя вашего курса]

**Примечание.** Вы можете использовать любое имя, но если для этого параметра задано другое значение, убедитесь, что об этом сообщается преподавателям. | + | **Имя средства** | GitHub Classroom — [имя вашего курса]

**Примечание**. Вы можете использовать любое имя, но если для этого параметра задано другое значение, убедитесь, что оно передано преподавателям. | | **Текст кнопки** (текст в меню инструментов) | Что преподаватель увидит на кнопке для запуска {% data variables.product.prodname_classroom %}. Например, значением может быть `sync`. | | **Открытие URL-адреса** | `https://classroom.github.com/context-link` | | **Отправка имен пользователей во внешнее средство** | установите этот флажок. | - | **Предоставление списка внешнему средству** | установите этот флажок. | - | **Инструмент поддерживает LTI 1.3** | установите этот флажок. | - | **URL-адрес набора ключей средства LTI 1.3** | `https://classroom.github.com/.well-known/jwks.json` | - | **Средство LTI 1.3 OpenID Connect/конечная точка инициализации** | `https://classroom.github.com/lti1p3/openid-connect/auth` | + | **Предоставление списка внешнему инструменту** | установите этот флажок. | + | **Средство поддерживает LTI 1.3** | установите этот флажок. | + | **URL-адрес набора ключей инструмента LTI 1.3** | `https://classroom.github.com/.well-known/jwks.json` | + | **Инструмент LTI 1.3 OpenID Connect/Конечная точка инициализации** | `https://classroom.github.com/lti1p3/openid-connect/auth` | | **Конечная точка перенаправления средства LTI 1.3** | `https://classroom.github.com/lti1p3/openid-connect/redirect` | 5. После отправки Sakai отобразит сведения, необходимые для регистрации экземпляра Sakai в {% data variables.product.prodname_classroom %}. @@ -158,12 +158,12 @@ ms.locfileid: '148106856' - В разделе "Тип LMS" выберите "Sakai" в раскрывающемся меню. - "Издатель платформы LTI 1.3": поле "Издатель платформы LTI 1.3", предоставленное Sakai - "Domain": базовый URL-адрес экземпляра Sakai. - - "Идентификатор клиента LTI 1.3": поле "Идентификатор клиента LTI 1.3", предоставленное Sakai. - - "LTI 1.3 Platform OIDC Authentication URL": поле "LTI 1.3 Platform OIDC Authentication URL" (URL-адрес проверки подлинности платформы OIDC), предоставленное Sakai. - - "LTI 1.3 Platform OAuth2 Bearer Token Retrieval URL": поле "LTI 1.3 Platform OAuth2 Bearer Token Retrieval URL", предоставленное Sakai + - "Идентификатор клиента LTI 1.3": поле "Идентификатор клиента LTI 1.3", предоставленное Sakai + - "LTI 1.3 Platform OIDC Authentication URL": поле "LTI 1.3 Platform OIDC Authentication URL" (URL-адрес проверки подлинности платформы OIDC LTI 1.3), предоставленное Sakai + - "LTI 1.3 Platform OAuth2 Bearer Token Retrieval URL": поле "LTI 1.3 Platform OAuth2 Bearer Token Retrieval URL" (URL-адрес получения маркера носителя LTI 1.3), предоставленное Sakai. - "LTI 1.3 Platform OAuth2 Well-Known/KeySet URL": поле "LTI 1.3 Platform OAuth2 Well-Known/KeySet URL", предоставленное Sakai ![Регистрация экземпляра Sakai в GitHub Classroom](/assets/images/help/classroom/register-sakai-with-github-classroom.png) 3. Щелкните **Зарегистрировать**. -4. В верхней части экрана должен появиться баннер "Успешно зарегистрировано LMS". Это означает, что вы зарегистрировали экземпляр LMS, а преподаватели теперь могут связать свои классы. +4. В верхней части экрана должен появиться баннер "Успешно зарегистрировано LMS". Это означает, что вы зарегистрировали экземпляр LMS, и преподаватели теперь могут связывать свои классы. diff --git a/translations/ru-RU/content/graphql/guides/using-the-graphql-api-for-discussions.md b/translations/ru-RU/content/graphql/guides/using-the-graphql-api-for-discussions.md index 679b63823c..145a10936f 100644 --- a/translations/ru-RU/content/graphql/guides/using-the-graphql-api-for-discussions.md +++ b/translations/ru-RU/content/graphql/guides/using-the-graphql-api-for-discussions.md @@ -4,12 +4,12 @@ intro: 'Сведения об использовании API GraphQL {% data var versions: feature: discussions shortTitle: Use GraphQL for Discussions -ms.openlocfilehash: 1512082737df4c92942a40007d2c75897edb1061 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT +ms.openlocfilehash: fd296c4e9390cac3500ba7319cb602366a37e262 +ms.sourcegitcommit: 4d6d3735d32540cb6de3b95ea9a75b8b247c580d +ms.translationtype: MT ms.contentlocale: ru-RU -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147408846' +ms.lasthandoff: 11/30/2022 +ms.locfileid: '148185620' --- API GraphQL для {% data variables.product.prodname_discussions %} позволяет получать, создавать, изменять и удалять публикации обсуждений. Дополнительные сведения о {% data variables.product.prodname_discussions %} см. в разделе [Сведения об обсуждениях](/discussions/collaborating-with-your-community-using-discussions/about-discussions). @@ -72,7 +72,7 @@ enum DiscussionOrderField { ### Repository.discussionCategories -Возвращаются доступные категории обсуждений, определенные в этом репозитории. Каждый репозиторий может относиться к нескольким категориям (до 10). Дополнительные сведения о категориях обсуждений см. в разделе [Сведения об обсуждениях](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions). +Возвращаются доступные категории обсуждений, определенные в этом репозитории. Каждый репозиторий может содержать до 25 категорий. Дополнительные сведения о категориях обсуждений см. в разделе [Сведения об обсуждениях](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions). _Сигнатура:_ diff --git a/translations/ru-RU/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md b/translations/ru-RU/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md index d53071108b..151756761d 100644 --- a/translations/ru-RU/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md +++ b/translations/ru-RU/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md @@ -1,6 +1,6 @@ --- -title: Автоматическое создание заметок о выпуске -intro: Вы можете автоматически создавать заметки о выпуске для своих выпусков GitHub. +title: Automatically generated release notes +intro: You can automatically generate release notes for your GitHub releases permissions: Repository collaborators and people with write access to a repository can generate and customize automated release notes for a release. versions: fpt: '*' @@ -13,61 +13,71 @@ shortTitle: Automated release notes communityRedirect: name: Provide GitHub Feedback href: 'https://github.com/orgs/community/discussions/categories/general' -ms.openlocfilehash: a4adfa306873ef172950666756add7d0e67e168d -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ru-RU -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147432019' --- -## Сведения об автоматическом создании заметок о выпуске -Автоматическое создание заметок о выпуске — это альтернатива написанию заметок о выпуске на {% data variables.product.prodname_dotcom %} вручную. С помощью этой функции можно быстро создавать обзор содержимого выпуска. Автоматически созданные заметки о выпуске включают список объединенных запросов на вытягивание, список участников выпуска и ссылку на полный журнал изменений. +## About automatically generated release notes -Автоматические заметки о выпуске можно также настроить с помощью меток, который позволяют создать пользовательские категории для упорядочения включаемых запросов на вытягивание. Кроме того, можно исключить определенные метки и пользователей из выходных данных. +Automatically generated release notes provide an automated alternative to manually writing release notes for your {% data variables.product.prodname_dotcom %} releases. With automatically generated release notes, you can quickly generate an overview of the contents of a release. Automatically generated release notes include a list of merged pull requests, a list of contributors to the release, and a link to a full changelog. -## Автоматическое создание заметок о выпуске для нового выпуска +You can also customize your automated release notes, using labels to create custom categories to organize pull requests you want to include, and exclude certain labels and users from appearing in the output. -{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.releases %} -3. Нажмите кнопку **Создать черновик нового выпуска**. - ![Кнопка для создания черновика выпуска](/assets/images/help/releases/draft_release_button.png) -4. {% ifversion fpt or ghec %}Щелкните **Выбрать тег** и введите{% else %}Введите{% endif %} номер версии для выпуска. Можно также выбрать существующий тег. - {% ifversion fpt or ghec %} ![Ввод тега](/assets/images/help/releases/releases-tag-create.png) -5. Если вы создаете тег, нажмите кнопку **Создать тег**. -![Подтверждение создания тега](/assets/images/help/releases/releases-tag-create-confirm.png) {% else %} ![Версия выпуска с тегом](/assets/images/enterprise/releases/releases-tag-version.png) {% endif %} -6. Если вы создали новый тег, в раскрывающемся меню выберите ветвь с проектом, который необходимо выпустить. - {% ifversion fpt or ghec %}![Выбор ветви](/assets/images/help/releases/releases-choose-branch.png) {% else %}![Ветви с тегом](/assets/images/enterprise/releases/releases-tag-branch.png) {% endif %} {%- data reusables.releases.previous-release-tag %} -7. В правом верхнем углу текстового поля описания щелкните {% ifversion previous-release-tag %}**Создать заметки о выпуске**{% else %}**Автоматически создать заметки о выпуске**{% endif %}.{% ifversion previous-release-tag %} ![Создать заметки о выпуске](/assets/images/help/releases/generate-release-notes.png){% else %} ![Автоматически создать заметки о выпуске](/assets/images/enterprise/3.5/releases/auto-generate-release-notes.png){% endif %} -8. Проверьте созданные заметки, чтобы убедиться в том, что они содержат все сведения, которые необходимо включить, и ничего лишнего. -9. Если в выпуск необходимо включить двоичные файлы, например скомпилированные программы, перетащите или вручную выберите файлы в области двоичных файлов. - ![Предоставление DMG с выпуском](/assets/images/help/releases/releases_adding_binary.gif) -10. Чтобы уведомить пользователей о том, что выпуск не готов к использованию в рабочей среде и может быть нестабильным, установите флажок **Это предварительный выпуск**. - ![Флажок, помечающий выпуск как предварительный](/assets/images/help/releases/prerelease_checkbox.png) {%- ifversion fpt or ghec %} -11. При необходимости установите флажок **Создать обсуждение для этого выпуска**, а затем в раскрывающемся меню **Категория** выберите категорию для обсуждения выпуска. - ![Флажок для создания обсуждения выпуска и раскрывающееся меню для выбора категории](/assets/images/help/releases/create-release-discussion.png) {%- endif %} -12. Если вы готовы опубликовать выпуск, нажмите кнопку **Опубликовать выпуск**. Чтобы продолжить работу с выпуском позже, нажмите кнопку **Сохранить черновик**. - ![Кнопки "Опубликовать выпуск" и "Сохранить черновик"](/assets/images/help/releases/release_buttons.png) +## Creating automatically generated release notes for a new release + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.releases %} +3. Click **Draft a new release**. + ![Releases draft button](/assets/images/help/releases/draft_release_button.png) +4. {% ifversion fpt or ghec %}Click **Choose a tag** and type{% else %}Type{% endif %} a version number for your release. Alternatively, select an existing tag. + {% ifversion fpt or ghec %} + ![Enter a tag](/assets/images/help/releases/releases-tag-create.png) +5. If you are creating a new tag, click **Create new tag**. +![Confirm you want to create a new tag](/assets/images/help/releases/releases-tag-create-confirm.png) + {% else %} + ![Releases tagged version](/assets/images/enterprise/releases/releases-tag-version.png) +{% endif %} +6. If you have created a new tag, use the drop-down menu to select the branch that contains the project you want to release. + {% ifversion fpt or ghec %}![Choose a branch](/assets/images/help/releases/releases-choose-branch.png) + {% else %}![Releases tagged branch](/assets/images/enterprise/releases/releases-tag-branch.png) + {% endif %} +{%- data reusables.releases.previous-release-tag %} +7. To the top right of the description text box, click {% ifversion previous-release-tag %}**Generate release notes**{% else %}**Auto-generate release notes**{% endif %}.{% ifversion previous-release-tag %} + ![Generate release notes](/assets/images/help/releases/generate-release-notes.png){% else %} + ![Auto-generate release notes](/assets/images/enterprise/3.5/releases/auto-generate-release-notes.png){% endif %} +8. Check the generated notes to ensure they include all (and only) the information you want to include. +9. Optionally, to include binary files such as compiled programs in your release, drag and drop or manually select files in the binaries box. + ![Providing a DMG with the Release](/assets/images/help/releases/releases_adding_binary.gif) +10. To notify users that the release is not ready for production and may be unstable, select **This is a pre-release**. + ![Checkbox to mark a release as prerelease](/assets/images/help/releases/prerelease_checkbox.png) +{%- ifversion fpt or ghec %} +11. Optionally, select **Create a discussion for this release**, then select the **Category** drop-down menu and click a category for the release discussion. + ![Checkbox to create a release discussion and drop-down menu to choose a category](/assets/images/help/releases/create-release-discussion.png) +{%- endif %} +12. If you're ready to publicize your release, click **Publish release**. To work on the release later, click **Save draft**. + ![Publish release and Draft release buttons](/assets/images/help/releases/release_buttons.png) -## Настройка автоматически созданных заметок о выпуске +## Configuring automatically generated release notes -{% data reusables.repositories.navigate-to-repo %} {% data reusables.files.add-file %} -3. В поле имени файла введите `.github/release.yml`, чтобы создать файл `release.yml` в каталоге `.github`. - ![Создание файла](/assets/images/help/releases/release-yml.png) -4. Используя приведенные ниже параметры конфигурации, укажите в коде YAML файла метки запросов на вытягивание и авторов, которых следует исключить из этого выпуска. Вы также можете создать новые категории и перечислить метки запросов на вытягивание, которые должны быть включены в каждую из них. +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.files.add-file %} +3. In the file name field, type `.github/release.yml` to create the `release.yml` file in the `.github` directory. + ![Create new file](/assets/images/help/releases/release-yml.png) +4. In the file, using the configuration options below, specify in YAML the pull request labels and authors you want to exclude from this release. You can also create new categories and list the pull request labels to be included in each of them. -### Варианты настройки +### Configuration options -| Параметр | Описание | +| Parameter | Description | | :- | :- | -| `changelog.exclude.labels` | Список меток, исключающих запрос на вытягивание из заметок о выпуске. | -| `changelog.exclude.authors` | Список дескрипторов входа пользователей или ботов, запросы на вытягивание которых должны быть исключены из заметок о выпуске. | -| `changelog.categories[*].title` | **Обязательный.** Название категории изменений в заметках о выпуске. | -| `changelog.categories[*].labels`| **Обязательный.** Метки, которые относят запрос на вытягивание к этой категории. Символу `*` будут соответствовать все запросы на вытягивание, которые не относятся ни к одной из предыдущих категорий. | -| `changelog.categories[*].exclude.labels` | Список меток, исключающих запрос на вытягивание из данной категории. | -| `changelog.categories[*].exclude.authors` | Список дескрипторов входа пользователей или ботов, запросы на вытягивание которых должны быть исключены из данной категории. | +| `changelog.exclude.labels` | A list of labels that exclude a pull request from appearing in release notes. | +| `changelog.exclude.authors` | A list of user or bot login handles whose pull requests are to be excluded from release notes. | +| `changelog.categories[*].title` | **Required.** The title of a category of changes in release notes. | +| `changelog.categories[*].labels`| **Required.** Labels that qualify a pull request for this category. Use `*` as a catch-all for pull requests that didn't match any of the previous categories. | +| `changelog.categories[*].exclude.labels` | A list of labels that exclude a pull request from appearing in this category. | +| `changelog.categories[*].exclude.authors` | A list of user or bot login handles whose pull requests are to be excluded from this category. | -### Пример конфигурации +### Example configurations + +A configuration for a repository that labels semver releases {% raw %} ```yaml{:copy} @@ -94,6 +104,26 @@ changelog: ``` {% endraw %} -## Дополнительные материалы +A configuration for a repository that doesn't tag pull requests but where we want to separate out {% data variables.product.prodname_dependabot %} automated pull requests in release notes (`labels: '*'` is required to display a catchall category) -- [Управление метками](/issues/using-labels-and-milestones-to-track-work/managing-labels) +{% raw %} +```yaml{:copy} +# .github/release.yml + +changelog: + categories: + - title: 🏕 Features + labels: + - '*' + exclude: + labels: + - dependencies + - title: 👒 Dependencies + labels: + - dependencies +``` +{% endraw %} + +## Further reading + +- "[Managing labels](/issues/using-labels-and-milestones-to-track-work/managing-labels)" diff --git a/translations/ru-RU/data/reusables/copilot/copilot-cta-button.md b/translations/ru-RU/data/reusables/copilot/copilot-cta-button.md new file mode 100644 index 0000000000..55a963fe6e --- /dev/null +++ b/translations/ru-RU/data/reusables/copilot/copilot-cta-button.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 9f7ac09b688bbe2b74a5cba71d2605365b7e7366 +ms.sourcegitcommit: 7fb7ec2e665856fc5f7cd209b53bd0fb1c9bbc67 +ms.translationtype: MT +ms.contentlocale: ru-RU +ms.lasthandoff: 11/29/2022 +ms.locfileid: "148185135" +--- +Попробуйте {% data variables.product.prodname_copilot %} {% octicon "link-external" height:16 %} \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/discussions/repository-category-limit.md b/translations/ru-RU/data/reusables/discussions/repository-category-limit.md index edff7724b0..2bfc55a8fc 100644 --- a/translations/ru-RU/data/reusables/discussions/repository-category-limit.md +++ b/translations/ru-RU/data/reusables/discussions/repository-category-limit.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 7b782aa3d23143a62b07aedf0a07df3734173d44 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT +ms.openlocfilehash: f58fb9410d93c9e50d33de5f1b12b9d6441ea561 +ms.sourcegitcommit: 4d6d3735d32540cb6de3b95ea9a75b8b247c580d +ms.translationtype: MT ms.contentlocale: ru-RU -ms.lasthandoff: 09/05/2022 -ms.locfileid: "145137942" +ms.lasthandoff: 11/30/2022 +ms.locfileid: "148185619" --- -Каждый репозиторий или организация могут иметь до 10 категорий. +Каждый репозиторий или организация может иметь до 25 категорий.