From 925884c6afd34e2a3a7752aa33d044f144a2bf72 Mon Sep 17 00:00:00 2001 From: docubot <67483024+docubot@users.noreply.github.com> Date: Tue, 22 Nov 2022 08:44:19 -0800 Subject: [PATCH 1/3] New translation batch for es (#32861) --- ...roving-workflow-runs-from-private-forks.md | 21 ++ ...proving-workflow-runs-from-public-forks.md | 19 +- ...-migration-with-github-actions-importer.md | 240 ++++++++++++++ ...hing-dependencies-to-speed-up-workflows.md | 204 ++++++------ .../configuring-your-enterprise/index.md | 10 +- .../initializing-github-ae.md | 175 ++++++----- ...ting-network-traffic-to-your-enterprise.md | 77 ----- .../initializing-the-cluster.md | 58 ++-- ...bling-github-actions-with-minio-storage.md | 49 +++ ...ating-your-enterprise-to-github-actions.md | 85 ++--- translations/es-ES/content/admin/guides.md | 10 +- ...bout-authentication-for-your-enterprise.md | 140 +++++---- .../about-enterprise-managed-users.md | 140 ++++----- ...for-your-idps-conditional-access-policy.md | 15 +- ...uring-oidc-for-enterprise-managed-users.md | 6 +- ...le-sign-on-for-enterprise-managed-users.md | 5 +- .../migrating-from-saml-to-oidc.md | 2 +- .../about-saml-for-enterprise-iam.md | 6 +- ...ning-for-your-enterprise-using-azure-ad.md | 64 ++-- translations/es-ES/content/admin/index.md | 10 +- ...log-events-performed-by-an-access-token.md | 73 +++++ .../best-practices-for-enterprises.md | 53 ++++ ...inio-storage-bucket-for-github-packages.md | 67 ++-- ...or-security-settings-in-your-enterprise.md | 95 +----- ...-and-managing-your-active-saml-sessions.md | 34 +- .../index.md | 10 +- .../viewing-and-managing-your-sessions.md | 46 +++ .../telling-git-about-your-signing-key.md | 82 ++--- .../configuring-two-factor-authentication.md | 39 ++- .../index.md | 10 +- .../viewing-your-github-codespaces-usage.md | 65 ++-- .../about-billing-for-github-packages.md | 24 +- .../downgrading-your-github-subscription.md | 96 +++--- ...ing-license-usage-for-github-enterprise.md | 9 +- ...configuring-dependabot-security-updates.md | 2 +- ...-disclosure-of-security-vulnerabilities.md | 94 ++++++ ...ately-reported-security-vulnerabilities.md | 45 +++ .../configuring-dependency-review.md | 97 +++--- ...disaster-recovery-for-github-codespaces.md | 43 +-- .../codespaces/codespaces-reference/index.md | 1 + ...ing-github-copilot-in-github-codespaces.md | 73 +++-- ...-github-codespaces-plugin-for-jetbrains.md | 72 +++++ ...e-vs-code-command-palette-in-codespaces.md | 2 + ...ing-the-machine-type-for-your-codespace.md | 65 ++-- ...g-automatic-deletion-of-your-codespaces.md | 80 ++--- ...zing-github-codespaces-for-your-account.md | 89 +++--- .../renaming-a-codespace.md | 61 ++-- ...ur-default-editor-for-github-codespaces.md | 46 +-- .../connecting-to-a-private-network.md | 51 +-- .../creating-a-codespace-from-a-template.md | 102 ++++++ .../deleting-a-codespace.md | 79 ++--- .../developing-in-a-codespace.md | 122 ++++---- .../forwarding-ports-in-your-codespace.md | 93 +++--- ...-github-codespaces-for-machine-learning.md | 108 +++++++ .../opening-an-existing-codespace.md | 84 ++--- .../stopping-and-starting-a-codespace.md | 53 ++-- .../the-codespace-lifecycle.md | 67 ++++ ...github-codespaces-in-visual-studio-code.md | 81 ++--- ...github-codespaces-in-your-jetbrains-ide.md | 138 +++++++++ ...using-github-codespaces-with-github-cli.md | 161 +++++----- .../using-source-control-in-your-codespace.md | 91 +++--- .../codespaces/getting-started/deep-dive.md | 155 ++++----- .../codespaces/getting-started/quickstart.md | 117 +++---- .../index.md | 12 +- ...ccess-for-your-organizations-codespaces.md | 33 +- ...-github-codespaces-in-your-organization.md | 75 +++++ .../restricting-access-to-machine-types.md | 93 +++--- ...stricting-the-base-image-for-codespaces.md | 103 ++++++ .../restricting-the-idle-timeout-period.md | 87 +++--- ...ing-the-retention-period-for-codespaces.md | 89 +++--- ...cting-the-visibility-of-forwarded-ports.md | 83 ++--- ...ations-audit-logs-for-github-codespaces.md | 23 +- ...g-encrypted-secrets-for-your-codespaces.md | 113 ++++--- ...-gpg-verification-for-github-codespaces.md | 30 +- ...g-repository-access-for-your-codespaces.md | 92 +++--- ...our-security-logs-for-github-codespaces.md | 27 +- .../es-ES/content/codespaces/overview.md | 10 +- .../about-github-codespaces-prebuilds.md | 49 +-- .../managing-prebuilds.md | 103 +++--- .../adding-features-to-a-devcontainer-file.md | 79 +++++ .../introduction-to-dev-containers.md | 193 ++++++------ ...um-specification-for-codespace-machines.md | 37 ++- ...mplate-repository-for-github-codespaces.md | 88 ++++++ ...g-up-your-dotnet-project-for-codespaces.md | 206 ++++++------ ...ing-up-your-java-project-for-codespaces.md | 156 +++++----- ...g-up-your-nodejs-project-for-codespaces.md | 141 ++++----- ...g-up-your-python-project-for-codespaces.md | 192 ++++++------ .../exporting-changes-to-a-branch.md | 29 +- .../troubleshooting/github-codespaces-logs.md | 109 +++---- .../codespaces/troubleshooting/index.md | 10 +- ...ing-creation-and-deletion-of-codespaces.md | 97 +++--- ...oubleshooting-github-codespaces-clients.md | 118 +++++++ ...-gpg-verification-for-github-codespaces.md | 117 +++++++ ...g-port-forwarding-for-github-codespaces.md | 23 +- ...ng-your-connection-to-github-codespaces.md | 61 ++-- ...king-with-support-for-github-codespaces.md | 41 +-- .../blocking-a-user-from-your-organization.md | 101 +++--- ...about-github-global-campus-for-students.md | 52 ++-- ...about-github-global-campus-for-teachers.md | 40 +-- ...github-codespaces-with-github-classroom.md | 92 +++--- .../create-a-group-assignment.md | 2 + .../create-an-individual-assignment.md | 102 +++--- .../teach-with-github-classroom/index.md | 9 +- .../getting-started-with-github-ae.md | 2 +- ...-up-a-trial-of-github-enterprise-server.md | 65 ++-- .../using-github/github-command-palette.md | 257 +++++++-------- .../using-github/keyboard-shortcuts.md | 15 +- .../about-task-lists.md | 81 +++++ .../filtering-projects.md | 10 +- .../learning-about-projects/about-projects.md | 57 ++-- .../about-tracks-and-tracked-by-fields.md | 56 ++++ .../deleting-custom-fields.md | 25 ++ .../understanding-fields/index.md | 28 ++ .../renaming-custom-fields.md | 24 ++ .../about-insights-for-projects.md | 10 +- .../about-tasklists.md | 146 +++++++++ .../about-organizations.md | 50 +-- .../best-practices-for-organizations.md | 38 +++ ...owed-ip-addresses-for-your-organization.md | 94 +++--- ...ing-the-audit-log-for-your-organization.md | 5 +- .../roles-in-an-organization.md | 12 +- .../working-with-forks/about-forks.md | 32 +- .../about-repositories.md | 11 +- .../best-practices-for-repositories.md | 35 +++ .../about-readmes.md | 56 ++-- .../using-files/navigating-code-on-github.md | 72 +++-- .../es-ES/content/rest/overview/libraries.md | 10 +- .../about-searching-on-github.md | 83 ++--- .../about-github-code-search.md | 58 ++++ .../search-github/github-code-search/index.md | 26 ++ ...understanding-github-code-search-syntax.md | 293 ++++++++++++++++++ .../using-github-code-search.md | 81 +++++ .../searching-on-github/searching-code.md | 133 ++++---- .../features/ip-allow-list-address-check.yml | 3 - .../es-ES/data/learning-tracks/admin.yml | 2 +- .../ip-allow-list-self-hosted-runners.md | 2 +- .../private-repository-forks-configure.md | 16 +- .../private-repository-forks-options.md | 16 +- .../actions/ref_protected-description.md | 10 +- .../reusables/actions/ref_type-description.md | 10 +- .../reusables/actions/run_id_description.md | 10 +- .../actions/run_number_description.md | 10 +- .../actions/runner-arch-description.md | 10 +- .../actions/runner-debug-description.md | 10 +- .../actions/runner-name-description.md | 10 +- .../actions/runner-os-description.md | 10 +- .../runner-temp-directory-description.md | 10 +- .../actions/runner-tool-cache-description.md | 10 +- .../actions/supported-github-runners.md | 49 ++- ...re-information-about-enforcement-policy.md | 10 +- .../assignments-guide-choose-visibility.md | 12 +- ...s-repository-visibility-and-permissions.md | 11 + .../reusables/codespaces/about-features.md | 11 + .../codespaces/about-publishing-templates.md | 13 + .../application-installed-locally.md | 9 + .../reusables/codespaces/codespace-logs.md | 11 + .../codespaces-continue-by-paying.md | 9 + .../codespaces-free-for-personal-intro.md | 9 + .../codespaces-jetbrains-beta-note.md | 13 + .../codespaces-machine-type-availability.md | 10 +- .../codespaces/codespaces-machine-types.md | 10 +- .../codespaces-spending-limit-requirement.md | 12 +- .../configuration-choice-templates.md | 9 + .../reusables/codespaces/copilot-in-vscode.md | 17 + .../creating-a-codespace-in-vscode.md | 34 +- .../codespaces/developing-in-vscode.md | 26 ++ .../codespaces/edit-devcontainer-json.md | 10 +- .../reusables/codespaces/exporting-changes.md | 10 +- .../codespaces/gpg-in-active-codespaces.md | 9 + .../jetbrains-open-codespace-plugin.md | 11 + .../codespaces/jupyterlab-in-default-image.md | 9 + .../jupyterlab-installed-in-codespace.md | 9 + .../codespaces/links-to-get-started.md | 10 +- ...achine-types-for-unpublished-codespaces.md | 9 + .../monthly-spending-limit-codespaces.md | 11 + .../codespaces/navigating-to-a-codespace.md | 16 + .../open-template-in-codespace-step.md | 11 + .../opening-codespace-in-jetbrains.md | 34 ++ .../port-forwarding-adding-non-jetbrains.md | 17 + .../port-forwarding-labeling-non-jetbrains.md | 15 + .../prebuilds-permission-authorization.md | 10 +- .../publishing-template-codespaces.md | 34 ++ .../reusables/codespaces/rebuild-command.md | 14 +- .../codespaces/setting-up-project-intro.md | 9 + .../codespaces/setup-custom-devcontainer.md | 10 +- .../source-control-commit-changes.md | 8 +- .../codespaces/source-control-pull-request.md | 8 +- .../reusables/codespaces/source-control.md | 63 ++++ .../codespaces/ssh-server-installed.md | 19 ++ .../starting-new-project-template.md | 9 + .../codespaces/stopping-a-codespace.md | 12 +- .../template-codespaces-default-editor.md | 9 + .../codespaces/usage-report-download.md | 21 ++ .../data/reusables/codespaces/use-chrome.md | 10 +- .../codespaces/view-all-templates-step.md | 11 + .../codespaces/vscode-interface-annotation.md | 13 + .../dependabot/dependabot-alerts-filters.md | 14 + .../education/student-codespaces-benefit.md | 9 + .../emu-azure-admin-consent.md | 12 +- .../enterprise-accounts/oidc-beta-notice.md | 13 - .../enterprise-accounts/settings-tab.md | 9 +- .../reusables/enterprise/best-practices.md | 9 + .../image-urls-viewable-warning.md | 2 +- .../SAML-to-OIDC-migration-for-EMU.md | 9 + .../about-adding-ip-allow-list-entries.md | 12 +- .../about-editing-ip-allow-list-entries.md | 13 +- .../about-enabling-allowed-ip-addresses.md | 13 +- .../check-ip-address.md | 10 +- .../ip-allow-lists-enable.md | 12 +- .../ip-allow-lists-githubapps-enterprise.md | 24 +- .../org-ownership-recommendation.md | 10 +- .../reusables/projects/projects-filters.md | 28 +- .../projects/tasklists-release-stage.md | 13 + .../repositories/sidebar-advisories.md | 10 +- .../repositories/sidebar-security.md | 10 +- .../assert-the-administrator-attribute.md | 10 +- .../search/classic-search-code-search-note.md | 11 + .../search/code-search-code-view-beta-note.md | 9 + .../data/reusables/search/code-search-link.md | 9 + .../data/reusables/search/code-view-link.md | 9 + .../search/non-code-search-explanation.md | 9 + .../private-vulnerability-reporting-beta.md | 13 + .../private-vulnerability-reporting-enable.md | 10 + ...rivate-vulnerability-reporting-overview.md | 11 + .../about-the-security-overview.md | 9 + .../beta-org-risk-coverage.md | 13 + .../data/reusables/user-settings/sessions.md | 9 + translations/log/msft-es-resets.csv | 103 ++---- 228 files changed, 6953 insertions(+), 3652 deletions(-) create mode 100644 translations/es-ES/content/actions/managing-workflow-runs/approving-workflow-runs-from-private-forks.md create mode 100644 translations/es-ES/content/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer.md delete mode 100644 translations/es-ES/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md create mode 100644 translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md create mode 100644 translations/es-ES/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/identifying-audit-log-events-performed-by-an-access-token.md create mode 100644 translations/es-ES/content/admin/overview/best-practices-for-enterprises.md create mode 100644 translations/es-ES/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md create mode 100644 translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities.md create mode 100644 translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md create mode 100644 translations/es-ES/content/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains.md create mode 100644 translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template.md create mode 100644 translations/es-ES/content/codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning.md create mode 100644 translations/es-ES/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md create mode 100644 translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide.md create mode 100644 translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md create mode 100644 translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces.md create mode 100644 translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file.md create mode 100644 translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces.md create mode 100644 translations/es-ES/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md create mode 100644 translations/es-ES/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md create mode 100644 translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md create mode 100644 translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields.md create mode 100644 translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md create mode 100644 translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/index.md create mode 100644 translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md create mode 100644 translations/es-ES/content/issues/tracking-your-work-with-issues/about-tasklists.md create mode 100644 translations/es-ES/content/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations.md create mode 100644 translations/es-ES/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md create mode 100644 translations/es-ES/content/search-github/github-code-search/about-github-code-search.md create mode 100644 translations/es-ES/content/search-github/github-code-search/index.md create mode 100644 translations/es-ES/content/search-github/github-code-search/understanding-github-code-search-syntax.md create mode 100644 translations/es-ES/content/search-github/github-code-search/using-github-code-search.md delete mode 100644 translations/es-ES/data/features/ip-allow-list-address-check.yml create mode 100644 translations/es-ES/data/reusables/classroom/assignments-repository-visibility-and-permissions.md create mode 100644 translations/es-ES/data/reusables/codespaces/about-features.md create mode 100644 translations/es-ES/data/reusables/codespaces/about-publishing-templates.md create mode 100644 translations/es-ES/data/reusables/codespaces/application-installed-locally.md create mode 100644 translations/es-ES/data/reusables/codespaces/codespace-logs.md create mode 100644 translations/es-ES/data/reusables/codespaces/codespaces-continue-by-paying.md create mode 100644 translations/es-ES/data/reusables/codespaces/codespaces-free-for-personal-intro.md create mode 100644 translations/es-ES/data/reusables/codespaces/codespaces-jetbrains-beta-note.md create mode 100644 translations/es-ES/data/reusables/codespaces/configuration-choice-templates.md create mode 100644 translations/es-ES/data/reusables/codespaces/copilot-in-vscode.md create mode 100644 translations/es-ES/data/reusables/codespaces/developing-in-vscode.md create mode 100644 translations/es-ES/data/reusables/codespaces/gpg-in-active-codespaces.md create mode 100644 translations/es-ES/data/reusables/codespaces/jetbrains-open-codespace-plugin.md create mode 100644 translations/es-ES/data/reusables/codespaces/jupyterlab-in-default-image.md create mode 100644 translations/es-ES/data/reusables/codespaces/jupyterlab-installed-in-codespace.md create mode 100644 translations/es-ES/data/reusables/codespaces/machine-types-for-unpublished-codespaces.md create mode 100644 translations/es-ES/data/reusables/codespaces/monthly-spending-limit-codespaces.md create mode 100644 translations/es-ES/data/reusables/codespaces/navigating-to-a-codespace.md create mode 100644 translations/es-ES/data/reusables/codespaces/open-template-in-codespace-step.md create mode 100644 translations/es-ES/data/reusables/codespaces/opening-codespace-in-jetbrains.md create mode 100644 translations/es-ES/data/reusables/codespaces/port-forwarding-adding-non-jetbrains.md create mode 100644 translations/es-ES/data/reusables/codespaces/port-forwarding-labeling-non-jetbrains.md create mode 100644 translations/es-ES/data/reusables/codespaces/publishing-template-codespaces.md create mode 100644 translations/es-ES/data/reusables/codespaces/setting-up-project-intro.md create mode 100644 translations/es-ES/data/reusables/codespaces/source-control.md create mode 100644 translations/es-ES/data/reusables/codespaces/ssh-server-installed.md create mode 100644 translations/es-ES/data/reusables/codespaces/starting-new-project-template.md create mode 100644 translations/es-ES/data/reusables/codespaces/template-codespaces-default-editor.md create mode 100644 translations/es-ES/data/reusables/codespaces/usage-report-download.md create mode 100644 translations/es-ES/data/reusables/codespaces/view-all-templates-step.md create mode 100644 translations/es-ES/data/reusables/codespaces/vscode-interface-annotation.md create mode 100644 translations/es-ES/data/reusables/dependabot/dependabot-alerts-filters.md create mode 100644 translations/es-ES/data/reusables/education/student-codespaces-benefit.md delete mode 100644 translations/es-ES/data/reusables/enterprise-accounts/oidc-beta-notice.md create mode 100644 translations/es-ES/data/reusables/enterprise/best-practices.md create mode 100644 translations/es-ES/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md create mode 100644 translations/es-ES/data/reusables/projects/tasklists-release-stage.md create mode 100644 translations/es-ES/data/reusables/search/classic-search-code-search-note.md create mode 100644 translations/es-ES/data/reusables/search/code-search-code-view-beta-note.md create mode 100644 translations/es-ES/data/reusables/search/code-search-link.md create mode 100644 translations/es-ES/data/reusables/search/code-view-link.md create mode 100644 translations/es-ES/data/reusables/search/non-code-search-explanation.md create mode 100644 translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-beta.md create mode 100644 translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-enable.md create mode 100644 translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-overview.md create mode 100644 translations/es-ES/data/reusables/security-overview/about-the-security-overview.md create mode 100644 translations/es-ES/data/reusables/security-overview/beta-org-risk-coverage.md create mode 100644 translations/es-ES/data/reusables/user-settings/sessions.md diff --git a/translations/es-ES/content/actions/managing-workflow-runs/approving-workflow-runs-from-private-forks.md b/translations/es-ES/content/actions/managing-workflow-runs/approving-workflow-runs-from-private-forks.md new file mode 100644 index 0000000000..8375236452 --- /dev/null +++ b/translations/es-ES/content/actions/managing-workflow-runs/approving-workflow-runs-from-private-forks.md @@ -0,0 +1,21 @@ +--- +title: Aprobación de ejecuciones de flujo de trabajo desde bifurcaciones privadas +intro: 'Cuando alguien sin acceso de escritura emite una solicitud de incorporación de cambios a un repositorio privado, puede que un mantenedor tenga que aprobar cualquier ejecución de flujo de trabajo.' +permissions: Maintainers with write access to a repository can approve workflow runs. +versions: + feature: actions-private-fork-workflow-approvals +shortTitle: Approve private fork runs +ms.openlocfilehash: 79b486123b62ee590e833e5c39bb7333a38c49d2 +ms.sourcegitcommit: fdc4466e89467a7b13239e26c6042dc1428946b6 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163844' +--- +## Acerca de las ejecuciones de flujo de trabajo desde bifurcaciones privadas + +{% data reusables.actions.private-repository-forks-overview %} Para obtener más información, consulta ["Requerir una directiva para bifurcar solicitudes de incorporación de cambios en repositorios privados](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-fork-pull-requests-in-private-repositories)". + +## Aprobación de las ejecuciones de flujo de trabajo en una solicitud de incorporación de cambios de una bifurcación privada + +{% data reusables.actions.workflows.approve-workflow-runs %} diff --git a/translations/es-ES/content/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks.md b/translations/es-ES/content/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks.md index a706c1c012..14733ead57 100644 --- a/translations/es-ES/content/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks.md +++ b/translations/es-ES/content/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks.md @@ -1,20 +1,25 @@ --- -title: Approving workflow runs from public forks -intro: 'When an outside contributor submits a pull request to a public repository, a maintainer with write access may need to approve any workflow runs.' +title: Aprobar ejecuciones de flujo de trabajo desde bifurcaciones públicas +intro: 'Cuando un contribuyente externo emite una solicitud de cambios a un repositorio público, podría ser que un mantenedor con acceso de escritura tenga que aprobar cualquier ejecución de flujo de trabajo.' versions: fpt: '*' ghec: '*' shortTitle: Approve public fork runs +ms.openlocfilehash: 74918a7d2e0081d6332ab267ef18ae148a2cff5e +ms.sourcegitcommit: 73b91dd4cdf592eadec4252319379d6fbe92858e +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148164127' --- - -## About workflow runs from public forks +## Acerca de las ejecuciones de flujo de trabajo de las bifurcaciones públicas {% data reusables.actions.workflow-run-approve-public-fork %} -You can configure workflow approval requirements for a [repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-required-approval-for-workflows-from-public-forks), [organization](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#configuring-required-approval-for-workflows-from-public-forks), or [enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-fork-pull-requests-in-your-enterprise). +Puede configurar los requisitos de aprobación de flujo de trabajo para un [repositorio](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-required-approval-for-workflows-from-public-forks), una [organización](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#configuring-required-approval-for-workflows-from-public-forks) o una [empresa](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-fork-pull-requests-in-your-enterprise). -Workflow runs that have been awaiting approval for more than 30 days are automatically deleted. +Las ejecuciones de flujos de trabajo que hayan estado esperando una aprobación por más de 30 días se borrarán automáticamente. -## Approving workflow runs on a pull request from a public fork +## Aprobar las ejecuciones de flujo de trabajo en una solicitud de cambios de una bifurcación pública {% data reusables.actions.workflows.approve-workflow-runs %} diff --git a/translations/es-ES/content/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer.md b/translations/es-ES/content/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer.md new file mode 100644 index 0000000000..9ef8bc448b --- /dev/null +++ b/translations/es-ES/content/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer.md @@ -0,0 +1,240 @@ +--- +title: Automating migration with GitHub Actions Importer +intro: 'Use {% data variables.product.prodname_actions_importer %} to plan and automate your migration to {% data variables.product.prodname_actions %}.' +versions: + fpt: '*' + ghec: '*' + ghes: '*' + ghae: '*' +type: how_to +miniTocMaxHeadingLevel: 3 +topics: + - Migration + - CI + - CD +shortTitle: Automate migration with {% data variables.product.prodname_actions_importer %} +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +[Legal notice](#legal-notice) + +{% note %} + +**Note**: {% data variables.product.prodname_actions_importer %} is currently available as a public preview. Visit the [sign up page](https://github.com/features/actions-importer/signup) to request access to the preview. Once you are granted access you'll be able to use the `gh-actions-importer` CLI extension + +{% endnote %} + +## About {% data variables.product.prodname_actions_importer %} + +You can use {% data variables.product.prodname_actions_importer %} to plan and automatically migrate your CI/CD pipelines to {% data variables.product.prodname_actions %} from Azure DevOps, CircleCI, GitLab, Jenkins, and Travis CI. + +{% data variables.product.prodname_actions_importer %} is distributed as a Docker container, and uses a [{% data variables.product.prodname_dotcom %} CLI](https://cli.github.com) extension to interact with the container. + +Any workflow that is converted by the {% data variables.product.prodname_actions_importer %} should be inspected for correctness before using it as a production workload. The goal is to achieve an 80% conversion rate for every workflow, however, the actual conversion rate will depend on the makeup of each individual pipeline that is converted. + +## Supported CI platforms + +You can use {% data variables.product.prodname_actions_importer %} to migrate from the following platforms: + +- Azure DevOps +- CircleCI +- GitLab +- Jenkins +- Travis CI + +Once you are granted access to the preview, you will be able to access further reference documentation for each of the supported platforms. + +## Prerequisites + +{% data variables.product.prodname_actions_importer %} has the following requirements: + +- You must have been granted access to the public preview for the {% data variables.product.prodname_actions_importer %}. +{%- ifversion ghes < 3.5 or ghae %} +- Use a {% data variables.product.pat_generic %} with the `read:packages` scope enabled. +{%- else %} +- You must have credentials to authenticate to the {% data variables.product.prodname_registry %} {% data variables.product.prodname_container_registry %}. For more information, see "[Working with the Container registry](/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-to-the-container-registry)." +{% endif %} +- An environment where you can run Linux-based containers, and can install the necessary tools. + - Docker is [installed](https://docs.docker.com/get-docker/) and running. + - [{% data variables.product.prodname_dotcom %} CLI](https://cli.github.com) is installed. + + {% note %} + + **Note**: The {% data variables.product.prodname_actions_importer %} container and CLI do not need to be installed on the same server as your CI platform. + + {% endnote %} + +### Installing the {% data variables.product.prodname_actions_importer %} CLI extension + +1. Install the {% data variables.product.prodname_actions_importer %} CLI extension: + + ```bash + $ gh extension install github/gh-actions-importer + ``` +1. Verify that the extension is installed: + + ```bash + $ gh actions-importer -h + Options: + -?, -h, --help Show help and usage information + + Commands: + update Update to the latest version of the GitHub Actions Importer. + version Display the version of the GitHub Actions Importer. + configure Start an interactive prompt to configure credentials used to authenticate with your CI server(s). + audit Plan your CI/CD migration by analyzing your current CI/CD footprint. + forecast Forecast GitHub Actions usage from historical pipeline utilization. + dry-run Convert a pipeline to a GitHub Actions workflow and output its yaml file. + migrate Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes. + ``` + +### Updating the {% data variables.product.prodname_actions_importer %} CLI + +To ensure you're running the latest version of {% data variables.product.prodname_actions_importer %}, you should regularly run the `update` command: + +```bash +$ gh actions-importer update +``` + +You must be authenticated with the {% data variables.product.prodname_container_registry %} for this command to be successful. Alternatively, you can provide credentials using the `--username` and `--password-stdin` parameters: + +```bash +$ echo $GITHUB_TOKEN | gh actions-importer update --username $GITHUB_HANDLE --password-stdin +``` + +### Authenticating at the command line + +You must configure credentials that allow {% data variables.product.prodname_actions_importer %} to communicate with {% data variables.product.prodname_dotcom %} and your current CI server. You can configure these credentials using environment variables or a `.env.local` file. The environment variables can be configured in an interactive prompt, by running the following command: + +```bash +$ gh actions-importer configure +``` + +Once you are granted access to the preview, you will be able to access further reference documentation about using environment variables. + +## Using the {% data variables.product.prodname_actions_importer %} CLI + +Use the subcommands of `gh actions-importer` to begin your migration to {% data variables.product.prodname_actions %}, including `audit`, `forecast`, `dry-run`, and `migrate`. + +### Auditing your existing CI pipelines + +The `audit` subcommand can be used to plan your CI/CD migration by analyzing your current CI/CD footprint. This analysis can be used to plan a timeline for migrating to {% data variables.product.prodname_actions %}. + +To run an audit, use the following command to determine your available options: + +```bash +$ gh actions-importer audit -h +Description: + Plan your CI/CD migration by analyzing your current CI/CD footprint. + +[...] + +Commands: + azure-devops An audit will output a list of data used in an Azure DevOps instance. + circle-ci An audit will output a list of data used in a CircleCI instance. + gitlab An audit will output a list of data used in a GitLab instance. + jenkins An audit will output a list of data used in a Jenkins instance. + travis-ci An audit will output a list of data used in a Travis CI instance. +``` + +Once you are granted access to the preview, you will be able to access further reference documentation about running an audit. + +### Forecasting usage + +The `forecast` subcommand reviews historical pipeline usage to create a forecast of {% data variables.product.prodname_actions %} usage. + +To run a forecast, use the following command to determine your available options: + +```bash +$ gh actions-importer forecast -h +Description: + Forecasts GitHub Actions usage from historical pipeline utilization. + +[...] + +Commands: + azure-devops Forecasts GitHub Actions usage from historical Azure DevOps pipeline utilization. + jenkins Forecasts GitHub Actions usage from historical Jenkins pipeline utilization. + gitlab Forecasts GitHub Actions usage from historical GitLab pipeline utilization. + circle-ci Forecasts GitHub Actions usage from historical CircleCI pipeline utilization. + travis-ci Forecasts GitHub Actions usage from historical Travis CI pipeline utilization. + github Forecasts GitHub Actions usage from historical GitHub pipeline utilization. +``` + +Once you are granted access to the preview, you will be able to access further reference documentation about running a forecast. + +### Testing the migration process + +The `dry-run` subcommand can be used to convert a pipeline to its {% data variables.product.prodname_actions %} equivalent, and then write the workflow to your local filesystem. + +To perform a dry run, use the following command to determine your available options: + +```bash +$ gh actions-importer dry-run -h +Description: + Convert a pipeline to a GitHub Actions workflow and output its yaml file. + +[...] + +Commands: + azure-devops Convert an Azure DevOps pipeline to a GitHub Actions workflow and output its yaml file. + circle-ci Convert a CircleCI pipeline to GitHub Actions workflows and output the yaml file(s). + gitlab Convert a GitLab pipeline to a GitHub Actions workflow and output the yaml file. + jenkins Convert a Jenkins job to a GitHub Actions workflow and output its yaml file. + travis-ci Convert a Travis CI pipeline to a GitHub Actions workflow and output its yaml file. +``` + +Once you are granted access to the preview, you will be able to access further reference documentation about performing a dry run. + +### Migrating a pipeline to {% data variables.product.prodname_actions %} + +The `migrate` subcommand can be used to convert a pipeline to its GitHub Actions equivalent and then create a pull request with the contents. + +To run a migration, use the following command to determine your available options: + +```bash +$ gh actions-importer migrate -h +Description: + Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes. + +[...] + +Commands: + azure-devops Convert an Azure DevOps pipeline to a GitHub Actions workflow and open a pull request with the changes. + circle-ci Convert a CircleCI pipeline to GitHub Actions workflows and open a pull request with the changes. + gitlab Convert a GitLab pipeline to a GitHub Actions workflow and open a pull request with the changes. + jenkins Convert a Jenkins job to a GitHub Actions workflow and open a pull request with the changes. + travis-ci Convert a Travis CI pipeline to a GitHub Actions workflow and and open a pull request with the changes. +``` + +Once you are granted access to the preview, you will be able to access further reference documentation about running a migration. + +## Legal notice + +Portions have been adapted from https://github.com/github/gh-actions-importer/ under the MIT license: + +``` +MIT License + +Copyright (c) 2022 GitHub + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +``` diff --git a/translations/es-ES/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md b/translations/es-ES/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md index a2a833a1a3..c87d866f2f 100644 --- a/translations/es-ES/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md +++ b/translations/es-ES/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md @@ -1,7 +1,7 @@ --- -title: Caching dependencies to speed up workflows +title: Almacenar en caché las dependencias para agilizar los flujos de trabajo shortTitle: Cache dependencies -intro: 'To make your workflows faster and more efficient, you can create and use caches for dependencies and other commonly reused files.' +intro: 'Para hacer que tus flujos de trabajo sean más rápidos y eficientes, puedes crear y usar cachés para las dependencias y otros archivos comúnmente reutilizados.' redirect_from: - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows @@ -14,17 +14,22 @@ type: tutorial topics: - Workflows miniTocMaxHeadingLevel: 3 +ms.openlocfilehash: 380fe568e950a4dc388e8f811ecebd12f242c5df +ms.sourcegitcommit: 34d500fe45b362043b4b4685d6705a7bfb484d11 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/15/2022 +ms.locfileid: '148164384' --- +## Acerca de almacenar en caché las dependencias de flujo de trabajo -## About caching workflow dependencies +Las ejecuciones de flujo de trabajo a menudo reutilizan las mismas salidas o dependencias descargadas de una ejecución a otra. Por ejemplo, las herramientas de administración de paquetes y dependencias como Maven, Gradle, npm y Yarn mantienen una caché local de las dependencias descargadas. -Workflow runs often reuse the same outputs or downloaded dependencies from one run to another. For example, package and dependency management tools such as Maven, Gradle, npm, and Yarn keep a local cache of downloaded dependencies. +{% ifversion fpt or ghec %} Los trabajos en ejecutores hospedados en {% data variables.product.prodname_dotcom %} se inician en una imagen de ejecutor limpia y deben descargar dependencias cada vez, lo que provoca una mayor utilización de la red, un tiempo de ejecución más largo y un mayor costo. {% endif %}Para ayudar a acelerar el tiempo que se tarda en volver a crear archivos como dependencias, {% data variables.product.prodname_dotcom %} puede almacenar en caché los archivos que utilizas con frecuencia en los flujos de trabajo. -{% ifversion fpt or ghec %} Jobs on {% data variables.product.prodname_dotcom %}-hosted runners start in a clean runner image and must download dependencies each time, causing increased network utilization, longer runtime, and increased cost. {% endif %}To help speed up the time it takes to recreate files like dependencies, {% data variables.product.prodname_dotcom %} can cache files you frequently use in workflows. +Para almacenar en caché las dependencias de un trabajo, puedes usar la [acción `cache`](https://github.com/actions/cache) de {% data variables.product.prodname_dotcom %}. La acción crea y restaura una memoria caché que identifica una clave única. Como alternativa, si almacenas en caché los administradores de paquetes que se enumeran debajo, el uso de sus respectivas acciones setup-* requiere una configuración mínima, y creará y restaurará las cachés de dependencias automáticamente. -To cache dependencies for a job, you can use {% data variables.product.prodname_dotcom %}'s [`cache` action](https://github.com/actions/cache). The action creates and restores a cache identified by a unique key. Alternatively, if you are caching the package managers listed below, using their respective setup-* actions requires minimal configuration and will create and restore dependency caches for you. - -| Package managers | setup-* action for caching | +| Administradores de paquetes | acción de setup-* para almacenar en caché | |---|---| | npm, Yarn, pnpm | [setup-node](https://github.com/actions/setup-node#caching-global-packages-data) | | pip, pipenv, Poetry | [setup-python](https://github.com/actions/setup-python#caching-packages-dependencies) | @@ -34,45 +39,44 @@ To cache dependencies for a job, you can use {% data variables.product.prodname_ {% warning %} -**Warning**: {% ifversion fpt or ghec %}Be mindful of the following when using caching with {% data variables.product.prodname_actions %}: +**Advertencia**: {% ifversion fpt or ghec %}Ten en cuenta lo siguiente al usar el almacenamiento en caché con {% data variables.product.prodname_actions %}: -* {% endif %}We recommend that you don't store any sensitive information in the cache. For example, sensitive information can include access tokens or login credentials stored in a file in the cache path. Also, command line interface (CLI) programs like `docker login` can save access credentials in a configuration file. Anyone with read access can create a pull request on a repository and access the contents of a cache. Forks of a repository can also create pull requests on the base branch and access caches on the base branch. +* {% endif %}Se recomienda no almacenar ninguna información confidencial en la memoria caché. Por ejemplo, la información confidencial puede incluir tokens de acceso o credenciales de inicio de sesión almacenados en un archivo en la ruta de la caché. Además, los programas de interfaz de línea de comandos (CLI), como `docker login`, pueden guardar las credenciales de acceso en un archivo de configuración. Cualquier usuario con acceso de lectura puede crear una solicitud de incorporación de cambios en un repositorio y acceder a los contenidos de una caché. Las bifurcaciones de un repositorio también pueden crear solicitudes de extracción en la rama base y acceder a las cachés en la rama base. {%- ifversion fpt or ghec %} -* When using self-hosted runners, caches from workflow runs are stored on {% data variables.product.company_short %}-owned cloud storage. A customer-owned storage solution is only available with {% data variables.product.prodname_ghe_server %}. +* Al usar ejecutores autohospedados, las cachés de las ejecuciones de flujo de trabajo se almacenan en almacenamiento en la nube propiedad de {% data variables.product.company_short %}. Una solución de almacenamiento propiedad del cliente solo está disponible con {% data variables.product.prodname_ghe_server %}. {%- endif %} {% endwarning %} {% data reusables.actions.comparing-artifacts-caching %} -For more information on workflow run artifacts, see "[Persisting workflow data using artifacts](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." +Para más información sobre los artefactos de ejecución de flujo de trabajo, consulta "[Conservación de datos de flujo de trabajo mediante artefactos](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". -## Restrictions for accessing a cache +## Restricciones para acceder a una caché -Access restrictions provide cache isolation and security by creating a logical boundary between different branches or tags. -Workflow runs can restore caches created in either the current branch or the default branch (usually `main`). If a workflow run is triggered for a pull request, it can also restore caches created in the base branch, including base branches of forked repositories. For example, if the branch `feature-b` has the base branch `feature-a`, a workflow run triggered on a pull request would have access to caches created in the default `main` branch, the base `feature-a` branch, and the current `feature-b` branch. +Las restricciones de acceso proporcionan aislamiento y seguridad de caché al crear una frontera lógica entre las ramas o etiquetas diferentes. Las ejecuciones de flujo de trabajo pueden restaurar las memorias caché creadas en la rama actual o en la rama predeterminada (normalmente `main`). Si se desencadena una ejecución de flujo de trabajo para una solicitud de incorporación de cambios, también puede restaurar las memorias caché creadas en la rama base, incluidas las ramas base de repositorios bifurcados. Por ejemplo, si la rama `feature-b` tiene la rama base `feature-a`, una ejecución de flujo de trabajo desencadenada en una solicitud de incorporación de cambios tendría acceso a las memorias caché creadas en la rama predeterminada `main`, la rama base `feature-a` y la rama actual `feature-b`. -Workflow runs cannot restore caches created for child branches or sibling branches. For example, a cache created for the child `feature-b` branch would not be accessible to a workflow run triggered on the parent `main` branch. Similarly, a cache created for the `feature-a` branch with the base `main` would not be accessible to its sibling `feature-c` branch with the base `main`. Workflow runs also cannot restore caches created for different tag names. For example, a cache created for the tag `release-a` with the base `main` would not be accessible to a workflow run triggered for the tag `release-b` with the base `main`. +Las ejecuciones de flujo de trabajo no pueden restaurar las memorias caché creadas para ramas secundarias o ramas del mismo nivel. Por ejemplo, una memoria caché creada para la rama secundaria `feature-b` no sería accesible para una ejecución de flujo de trabajo desencadenada en la rama primaria `main`. De forma similar, una memoria caché creada para la rama `feature-a` con la rama `main` base no sería accesible para su la rama `feature-c` del mismo nivel con la rama base `main`. Las ejecuciones de flujo de trabajo tampoco pueden restaurar las memorias caché creadas para nombres de etiqueta diferentes. Por ejemplo, una memoria caché creada para la etiqueta `release-a` con la rama `main` no sería accesible para un flujo de trabajo desencadenado para la etiqueta `release-b` con la rama base `main`. -When a cache is created by a workflow run triggered on a pull request, the cache is created for the merge ref (`refs/pull/.../merge`). Because of this, the cache will have a limited scope and can only be restored by re-runs of the pull request. It cannot be restored by the base branch or other pull requests targeting that base branch. +Cuando se crea una memoria caché mediante una ejecución de flujo de trabajo desencadenada en una solicitud de incorporación de cambios, dicha memoria caché se crea para la referencia de combinación (`refs/pull/.../merge`). Por este motivo, la memoria caché tendrá un ámbito limitado y solo se puede restaurar mediante nuevas ejecuciones de la solicitud de incorporación de cambios. No se puede restaurar mediante la rama base u otras solicitudes de incorporación de cambios destinadas a esa rama base. -Multiple workflow runs in a repository can share caches. A cache created for a branch in a workflow run can be accessed and restored from another workflow run for the same repository and branch. +Varias ejecuciones de flujo de trabajo en un repositorio pueden compartir memorias caché. Se puede acceder a una memoria caché creada para una rama en una ejecución de flujo de trabajo y restaurarla desde otra ejecución de flujo de trabajo para el mismo repositorio y rama. -## Using the `cache` action +## Uso de la acción `cache` -The [`cache` action](https://github.com/actions/cache) will attempt to restore a cache based on the `key` you provide. When the action finds a cache that _exactly_ matches the key, the action restores the cached files to the `path` you configure. -You can optionally provide a list of `restore-keys` to use in case the `key` doesn't match an existing cache. A list of `restore-keys` is useful when you are restoring a cache from another branch because `restore-keys` can _partially_ match cache keys. For more information about matching `restore-keys`, see "[Matching a cache key](#matching-a-cache-key)." +La [acción `cache`](https://github.com/actions/cache) intentará restaurar una caché en función del `key` que proporciones. Cuando la acción encuentra una memoria caché que coincide _exactamente_ con la clave, la acción restaura los archivos almacenados en caché al `path` que configures. +Opcionalmente, puedes proporcionar una lista de `restore-keys` para que se usen cuando `key` no coincide con una memoria caché existente. Una lista de `restore-keys` resulta útil cuando se restaura una memoria caché desde otra rama porque `restore-keys` puede coincidir _parcialmente_ con claves de caché. Para obtener más información sobre la coincidencia con `restore-keys`, consulta "[Coincidencia con una clave de caché](#matching-a-cache-key)". -If there is an exact match to the provided `key`, this is considered a cache hit. If no cache exactly matches the provided `key`, this is considered a cache miss. On a cache miss, the action automatically creates a new cache if the job completes successfully. The new cache will use the `key` you provided and contains the files you specify in `path`. For more information about how this is handled, see "[Cache hits and misses](#cache-hits-and-misses)." +Si hay una coincidencia exacta con el elemento `key` proporcionado, se considera un acierto de caché. Si ninguna memoria caché coincide exactamente con el elemento `key` proporcionado, se considera un error de caché. En un error de caché, la acción crea automáticamente una nueva memoria caché si el trabajo se completa correctamente. La nueva caché usará el elemento `key` que proporcionaste y contiene los archivos que especificaste en `path`. Para obtener más información sobre cómo se controla esto, consulta "[Aciertos y errores de caché](#cache-hits-and-misses)". -You cannot change the contents of an existing cache. Instead, you can create a new cache with a new key. +No se puede cambiar el contenido de una memoria caché existente. En su lugar, puedes crear una nueva memoria caché con una nueva clave. -### Input parameters for the `cache` action +### Parámetros de entrada de la acción `cache` -- `key`: **Required** The key created when saving a cache and the key used to search for a cache. It can be any combination of variables, context values, static strings, and functions. Keys have a maximum length of 512 characters, and keys longer than the maximum length will cause the action to fail. -- `path`: **Required** The path(s) on the runner to cache or restore. - - You can specify a single path, or you can add multiple paths on separate lines. For example: +- `key`: **obligatorio** La clave creada al guardar una memoria caché y la clave usada para buscar una caché. Puede ser cualquier combinación de variables, valores de contexto, cadenas estáticas y funciones. Las claves tienen una longitud máxima de 512 caracteres y las claves más largas que la longitud máxima provocarán un error en la acción. +- `path`: **obligatorio** las rutas de acceso en el ejecutor para almacenar en caché o restaurar. + - Puedes especificar una única ruta de acceso o agregar varias rutas de acceso en líneas independientes. Por ejemplo: ``` - name: Cache Gradle packages @@ -82,9 +86,9 @@ You cannot change the contents of an existing cache. Instead, you can create a n ~/.gradle/caches ~/.gradle/wrapper ``` - - You can specify either directories or single files, and glob patterns are supported. - - You can specify absolute paths, or paths relative to the workspace directory. -- `restore-keys`: **Optional** A string containing alternative restore keys, with each restore key placed on a new line. If no cache hit occurs for `key`, these restore keys are used sequentially in the order provided to find and restore a cache. For example: + - Puedes especificar directorios o archivos únicos, y los patrones globales son compatibles. + - Puedes especificar rutas de acceso absolutas o rutas de acceso relativas al directorio del área de trabajo. +- `restore-keys`: **opcional** una cadena que contiene claves de restauración alternativas, con cada clave de restauración colocada en una nueva línea. Si no se produce ningún acierto de caché para `key`, estas claves de restauración se usan secuencialmente en el orden proporcionado para buscar y restaurar una caché. Por ejemplo: {% raw %} ```yaml @@ -95,28 +99,28 @@ You cannot change the contents of an existing cache. Instead, you can create a n ``` {% endraw %} -### Output parameters for the `cache` action +### Parámetros de salida de la acción `cache` -- `cache-hit`: A boolean value to indicate an exact match was found for the key. +- `cache-hit`: valor booleano para indicar que se encontró una coincidencia exacta para la clave. -### Cache hits and misses -When `key` exactly matches an existing cache, it's called a _cache hit_, and the action restores the cached files to the `path` directory. +### Aciertos y errores de caché +Cuando `key` coincide exactamente con una memoria caché existente, se denomina un _acierto de caché_ y la acción restaura los archivos almacenados en caché en el directorio `path`. -When `key` doesn't match an existing cache, it's called a _cache miss_, and a new cache is automatically created if the job completes successfully. +Cuando `key` no coincide con una caché existente, se denomina un _error de caché_ y se crea automáticamente una caché si el trabajo se completa correctamente. -When a cache miss occurs, the action also searches your specified `restore-keys` for any matches: +Cuando se produce un error de caché, la acción también busca los elementos `restore-keys` especificados en busca de coincidencias: -1. If you provide `restore-keys`, the `cache` action sequentially searches for any caches that match the list of `restore-keys`. - - When there is an exact match, the action restores the files in the cache to the `path` directory. - - If there are no exact matches, the action searches for partial matches of the restore keys. When the action finds a partial match, the most recent cache is restored to the `path` directory. -1. The `cache` action completes and the next step in the job runs. -1. If the job completes successfully, the action automatically creates a new cache with the contents of the `path` directory. +1. Si proporcionas `restore-keys`, la acción `cache` busca secuencialmente las memorias caché que coincidan con la lista de `restore-keys`. + - Cuando hay una coincidencia exacta, la acción restaura los archivos en la memoria caché al directorio `path`. + - Si no hay coincidencias exactas, la acción busca coincidencias parciales de las claves de restauración. Cuando la acción encuentra una coincidencia parcial, se restaura la caché más reciente al directorio `path`. +1. La acción `cache` se completa y se ejecuta el paso siguiente del flujo de trabajo. +1. Si el trabajo se completa correctamente, la acción crea automáticamente una caché con los contenidos del directorio `path`. -For a more detailed explanation of the cache matching process, see "[Matching a cache key](#matching-a-cache-key)." +Para obtener una explicación más detallada del proceso de coincidencia de caché, consulta "[Coincidencia de una clave de caché](#matching-a-cache-key)". -### Example using the `cache` action +### Ejemplo de uso de la acción `cache` -This example creates a new cache when the packages in `package-lock.json` file change, or when the runner's operating system changes. The cache key uses contexts and expressions to generate a key that includes the runner's operating system and a SHA-256 hash of the `package-lock.json` file. +En este ejemplo se crea una nueva memoria caché cuando cambian los paquetes del archivo `package-lock.json` o cuando cambia el sistema operativo del ejecutor. La clave de caché usa contextos y expresiones para generar una clave que incluye el sistema operativo del ejecutor y un hash SHA-256 del archivo `package-lock.json`. ```yaml{:copy} name: Caching with npm @@ -156,13 +160,13 @@ jobs: run: npm test ``` -### Using contexts to create cache keys +### Usar contextos para crear claves de caché -A cache key can include any of the contexts, functions, literals, and operators supported by {% data variables.product.prodname_actions %}. For more information, see "[Contexts](/actions/learn-github-actions/contexts)" and "[Expressions](/actions/learn-github-actions/expressions)." +Una clave de caché puede incluir cualquiera de los contextos, funciones, literales y operadores admitidos por {% data variables.product.prodname_actions %}. Para obtener más información, consulta "[Contextos](/actions/learn-github-actions/contexts)" y "[Expresiones](/actions/learn-github-actions/expressions)". -Using expressions to create a `key` allows you to automatically create a new cache when dependencies change. +Usar expresiones para crear un elemento `key` te permite crear automáticamente una caché cuando las dependencias cambian. -For example, you can create a `key` using an expression that calculates the hash of an npm `package-lock.json` file. So, when the dependencies that make up the `package-lock.json` file change, the cache key changes and a new cache is automatically created. +Por ejemplo, puedes crear una `key` mediante una expresión que calcule el hash de un archivo `package-lock.json` de npm. Por lo tanto, cuando cambian las dependencias que componen el cambio en el archivo `package-lock.json`, la clave de caché cambia y se crea automáticamente una caché. {% raw %} ```yaml @@ -170,17 +174,17 @@ npm-${{ hashFiles('package-lock.json') }} ``` {% endraw %} -{% data variables.product.prodname_dotcom %} evaluates the expression `hash "package-lock.json"` to derive the final `key`. +{% data variables.product.prodname_dotcom %} evalúa la expresión `hash "package-lock.json"` para generar el `key` final. ```yaml npm-d5ea0750 ``` -### Using the output of the `cache` action +### Uso de la salida de la acción `cache` -You can use the output of the `cache` action to do something based on whether a cache hit or miss occurred. When an exact match is found for a cache for the specified `key`, the `cache-hit` output is set to `true`. +Puedes usar la salida de la acción `cache` para hacer algo en función de si se ha producido un acierto o un error en la caché. Si se encuentra una coincidencia exacta para la caché en la `key` especificada, la salida `cache-hit` se establece en `true`. -In the example workflow above, there is a step that lists the state of the Node modules if a cache miss occurred: +En el flujo de trabajo de ejemplo anterior, hay un paso que enumera el estado de los módulos de Node si se ha producido un error en la caché: ```yaml - if: {% raw %}${{ steps.cache-npm.outputs.cache-hit != 'true' }}{% endraw %} @@ -189,15 +193,15 @@ In the example workflow above, there is a step that lists the state of the Node run: npm list ``` -## Matching a cache key +## Hacer coincidir una clave de caché -The `cache` action first searches for cache hits for `key` and the cache _version_ in the branch containing the workflow run. If there is no hit, it searches for `restore-keys` and the _version_. If there are still no hits in the current branch, the `cache` action retries same steps on the default branch. Please note that the scope restrictions apply during the search. For more information, see "[Restrictions for accessing a cache](#restrictions-for-accessing-a-cache)." +La acción `cache` busca primero los aciertos de caché para `key` y la _versión_ de la memoria caché en la rama que contiene la ejecución del flujo de trabajo. Si no hay ningún acierto, busca `restore-keys` y la _versión_. Si sigue sin haber aciertos en la rama actual, la acción `cache` reintenta los mismos pasos en la rama predeterminada. Ten en cuenta que se aplican las restricciones de ámbito durante la búsqueda. Para obtener más información, consulta "[Restricciones para acceder a una memoria caché](#restrictions-for-accessing-a-cache)". -Cache version is a way to stamp a cache with metadata of the `path` and the compression tool used while creating the cache. This ensures that the consuming workflow run uniquely matches a cache it can actually decompress and use. For more information, see [Cache Version](https://github.com/actions/cache#cache-version) in the Actions Cache documentation. +La versión de la memoria caché es una forma de marcar con un sello una memoria caché con metadatos de `path` y la herramienta de compresión que se usa al crear la memoria caché. Esto garantiza que la ejecución del flujo de trabajo de consumo coincida únicamente con una memoria caché que realmente puede descomprimir y usar. Para obtener más información, consulta [Versión de caché](https://github.com/actions/cache#cache-version) en la documentación de caché de Acciones. -`restore-keys` allows you to specify a list of alternate restore keys to use when there is a cache miss on `key`. You can create multiple restore keys ordered from the most specific to least specific. The `cache` action searches the `restore-keys` in sequential order. When a key doesn't match directly, the action searches for keys prefixed with the restore key. If there are multiple partial matches for a restore key, the action returns the most recently created cache. +`restore-keys` permite especificar una lista de claves de restauración alternativas que se usarán cuando se produce un error de caché en `key`. Puedes crear múltiples claves de restauración ordenadas desde las más específicas hasta las menos específicas. La acción `cache` busca `restore-keys` en orden secuencial. Cuando una clave no coincide directamente, la acción busca las claves prefijadas con la clave de restauración. Si hay múltiples coincidencias parciales para una clave de restauración, la acción devuelve la caché que se creó más recientemente. -### Example using multiple restore keys +### Ejemplo usando múltiples claves de restauración {% raw %} ```yaml @@ -208,7 +212,7 @@ restore-keys: | ``` {% endraw %} -The runner evaluates the expressions, which resolve to these `restore-keys`: +El ejecutor evalúa las expresiones, que se resuelven en estos `restore-keys`: {% raw %} ```yaml @@ -219,13 +223,13 @@ restore-keys: | ``` {% endraw %} -The restore key `npm-feature-` matches any key that starts with the string `npm-feature-`. For example, both of the keys `npm-feature-fd3052de` and `npm-feature-a9b253ff` match the restore key. The cache with the most recent creation date would be used. The keys in this example are searched in the following order: +La clave de restauración `npm-feature-` coincide con cualquier clave que comience por la cadena `npm-feature-`. Por ejemplo, las claves `npm-feature-fd3052de` y `npm-feature-a9b253ff` coinciden con la clave de restauración. Se utilizará la caché con la fecha de creación más reciente. Las claves en este ejemplo se buscan en el siguiente orden: -1. **`npm-feature-d5ea0750`** matches a specific hash. -1. **`npm-feature-`** matches cache keys prefixed with `npm-feature-`. -1. **`npm-`** matches any keys prefixed with `npm-`. +1. **`npm-feature-d5ea0750`** coincide con un hash específico. +1. **`npm-feature-`** coincide con las claves de caché con el prefijo `npm-feature-`. +1. **`npm-`** coincide con cualquier clave con el prefijo `npm-`. -#### Example of search priority +#### Ejemplo de prioridad de búsqueda ```yaml key: @@ -235,80 +239,76 @@ restore-keys: | npm- ``` -For example, if a pull request contains a `feature` branch and targets the default branch (`main`), the action searches for `key` and `restore-keys` in the following order: +Por ejemplo, si una solicitud de incorporación de cambios contiene una rama `feature` y tiene como destino la rama predeterminada (`main`), la acción busca `key` y `restore-keys` en el orden siguiente: -1. Key `npm-feature-d5ea0750` in the `feature` branch -1. Key `npm-feature-` in the `feature` branch -1. Key `npm-` in the `feature` branch -1. Key `npm-feature-d5ea0750` in the `main` branch -1. Key `npm-feature-` in the `main` branch -1. Key `npm-` in the `main` branch +1. Clave `npm-feature-d5ea0750` en la rama `feature` +1. Clave `npm-feature-` en la rama `feature` +1. Clave `npm-` en la rama `feature` +1. Clave `npm-feature-d5ea0750` en la rama `main` +1. Clave `npm-feature-` en la rama `main` +1. Clave `npm-` en la rama `main` -## Usage limits and eviction policy +## Límites de uso y política de desalojo -{% data variables.product.prodname_dotcom %} will remove any cache entries that have not been accessed in over 7 days. There is no limit on the number of caches you can store, but the total size of all caches in a repository is limited{% ifversion actions-cache-policy-apis %}. By default, the limit is 10 GB per repository, but this limit might be different depending on policies set by your enterprise owners or repository administrators.{% else %} to 10 GB.{% endif %} +{% data variables.product.prodname_dotcom %} eliminará todas las entradas de caché a las que no se haya accedido en más de 7 días. No hay límite en la cantidad de cachés que puedes almacenar, pero el tamaño total de todas las cachés de un repositorio es limitado{% ifversion actions-cache-policy-apis %}. De manera predeterminada, el límite es de 10 GB por repositorio, pero este límite puede ser diferente en función de las directivas que establezcan los propietarios de la empresa o los administradores del repositorio.{% else %} hasta 10 GB. {% endif %} -{% data reusables.actions.cache-eviction-process %} {% ifversion actions-cache-ui %}The cache eviction process may cause cache thrashing, where caches are created and deleted at a high frequency. To reduce this, you can review the caches for a repository and take corrective steps, such as removing caching from specific workflows. For more information, see "[Managing caches](#managing-caches)."{% endif %}{% ifversion actions-cache-admin-ui %} You can also increase the cache size limit for a repository. For more information, see "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository)." +{% data reusables.actions.cache-eviction-process %} {% ifversion actions-cache-ui %}El proceso de expulsión de caché puede provocar la paginación excesiva de caché, donde las memorias caché se crean y eliminan con una alta frecuencia. Para reducir esto, puedes revisar las memorias caché de un repositorio y tomar medidas correctivas, como quitar el almacenamiento en caché de flujos de trabajo específicos. Para obtener más información, consulta "[Administración de memorias caché](#managing-caches)".{% endif %}{% ifversion actions-cache-admin-ui %} También puedes aumentar el límite de tamaño de caché de un repositorio. Para más información, vea "[Administración de la configuración de {% data variables.product.prodname_actions %} para un repositorio](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository)". {% elsif actions-cache-policy-apis %} -For information on changing the policies for the repository cache size limit, see "[Enforcing policies for {% data variables.product.prodname_actions %} in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-cache-storage-in-your-enterprise)" and "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository)." +A fin de obtener información sobre cómo cambiar las directivas para el límite de tamaño de caché del repositorio, consulta "[Aplicación de directivas para {% data variables.product.prodname_actions %} en la empresa](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-cache-storage-in-your-enterprise)" y "[Administración de la configuración de {% data variables.product.prodname_actions %} para un repositorio](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository)". {% endif %} {% ifversion actions-cache-management %} -## Managing caches +## Administración de cachés {% ifversion actions-cache-ui %} -To manage caches created from your workflows, you can: +Para administrar las memorias caché creadas a partir de los flujos de trabajo, puedes: -- View a list of all cache entries for a repository. -- Filter and sort the list of caches using specific metadata such as cache size, creation time, or last accessed time. -- Delete cache entries from a repository. -- Monitor aggregate cache usage for repositories and organizations. +- Ver una lista de todas las entradas de caché de un repositorio. +- Filtrar y ordenar la lista de memorias cachés mediante metadatos específicos, como el tamaño de la memoria caché, la hora de creación o la hora a la que se accedió por última vez. +- Eliminar las entradas de caché de un repositorio. +- Supervisar el uso de caché agregada para repositorios y organizaciones. -There are multiple ways to manage caches for your repositories: +Hay varias maneras de administrar memorias cachés para los repositorios: -- Using the {% data variables.product.prodname_dotcom %} web interface, as shown below. -- Using the REST API. For more information, see the "[{% data variables.product.prodname_actions %} Cache](/rest/actions/cache)" REST API documentation. -- Installing a {% data variables.product.prodname_cli %} extension to manage your caches from the command line. For more information, see the [gh-actions-cache](https://github.com/actions/gh-actions-cache) extension. +- Mediante la interfaz web de {% data variables.product.prodname_dotcom %}, como se muestra a continuación. +- Mediante la API REST. Para más información, consulta la documentación de la API REST de "[Caché de {% data variables.product.prodname_actions %}](/rest/actions/cache)". +- Instalando una extensión de la {% data variables.product.prodname_cli %} para administrar las memorias caché desde la línea de comandos. Para obtener más información, consulta la extensión [gh-actions-cache](https://github.com/actions/gh-actions-cache). {% else %} -You can use the {% data variables.product.product_name %} REST API to manage your caches. {% ifversion actions-cache-list-delete-apis %}You can use the API to list and delete cache entries, and see your cache usage.{% elsif actions-cache-management %}At present, you can use the API to see your cache usage, with more functionality expected in future updates.{% endif %} For more information, see the "[{% data variables.product.prodname_actions %} Cache](/rest/actions/cache)" REST API documentation. +Puedes usar la API de REST de {% data variables.product.product_name %} para administrar las memorias caché. {% ifversion actions-cache-list-delete-apis %}Puedes usar la API para enumerar y eliminar entradas de caché y ver el uso de la caché.{% elsif actions-cache-management %}En la actualidad, puedes usar la API para ver el uso de la caché, con más funcionalidad esperada en actualizaciones futuras.{% endif %} Para más información, consulta la documentación de la API REST "[Caché de {% data variables.product.prodname_actions %}](/rest/actions/cache)". -You can also install a {% data variables.product.prodname_cli %} extension to manage your caches from the command line. For more information about the extension, see [the extension documentation](https://github.com/actions/gh-actions-cache#readme). For more information about {% data variables.product.prodname_cli %} extensions, see "[Using GitHub CLI extensions](/github-cli/github-cli/using-github-cli-extensions)." +También puedes instalar una extensión de {% data variables.product.prodname_cli %} para administrar las memorias caché desde la línea de comandos. Para obtener más información sobre la extensión, consulta [la documentación de la extensión](https://github.com/actions/gh-actions-cache#readme). Para más información sobre las extensiones de {% data variables.product.prodname_cli %}, consulta "[Uso de extensiones de la CLI de GitHub](/github-cli/github-cli/using-github-cli-extensions)". {% endif %} {% ifversion actions-cache-ui %} -### Viewing cache entries +### Visualización de entradas de caché -You can use the web interface to view a list of cache entries for a repository. In the cache list, you can see how much disk space each cache is using, when the cache was created, and when the cache was last used. +Puedes usar la interfaz web para ver una lista de entradas de caché de un repositorio. En la lista de caché, puedes ver cuánto espacio en disco usa cada memoria caché, cuándo se creó la memoria caché y cuándo se usó por última vez la memoria caché. -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-cache-list %} -1. Review the list of cache entries for the repository. +{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} {% data reusables.repositories.actions-cache-list %} +1. Revisa la lista de entradas de caché del repositorio. - * To search for cache entries used for a specific branch, click the **Branch** dropdown menu and select a branch. The cache list will display all of the caches used for the selected branch. - * To search for cache entries with a specific cache key, use the syntax `key: key-name` in the **Filter caches** field. The cache list will display caches from all branches where the key was used. + * Para buscar entradas de caché usadas para una rama específica, haz clic en el menú desplegable **Rama** y selecciona una rama. La lista de memorias caché mostrará todas las memorias caché usadas para la rama seleccionada. + * Para buscar entradas de caché con una clave de caché específica, usa la sintaxis `key: key-name` en el campo **Filtrar memorias cachés**. La lista de memorias caché mostrará las memorias caché de todas las ramas en las que se usó la clave. - ![Screenshot of the list of cache entries](/assets/images/help/repository/actions-cache-entry-list.png) + ![Captura de pantalla de la lista de entradas de caché](/assets/images/help/repository/actions-cache-entry-list.png) -### Deleting cache entries +### Eliminación de entradas de caché -Users with `write` access to a repository can use the {% data variables.product.prodname_dotcom %} web interface to delete cache entries. +Los usuarios con acceso `write` a un repositorio pueden usar la interfaz web de {% data variables.product.prodname_dotcom %} para eliminar entradas de caché. -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-cache-list %} -1. To the right of the cache entry you want to delete, click {% octicon "trash" aria-label="The trash icon" %}. +{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} {% data reusables.repositories.actions-cache-list %} +1. A la derecha de la entrada de caché que quieres eliminar, haz clic en {% octicon "trash" aria-label="The trash icon" %}. - ![Screenshot of the list of cache entries](/assets/images/help/repository/actions-cache-delete.png) + ![Captura de pantalla de la lista de entradas de caché](/assets/images/help/repository/actions-cache-delete.png) {% endif %} diff --git a/translations/es-ES/content/admin/configuration/configuring-your-enterprise/index.md b/translations/es-ES/content/admin/configuration/configuring-your-enterprise/index.md index 928633fb1b..207cfa8dcb 100644 --- a/translations/es-ES/content/admin/configuration/configuring-your-enterprise/index.md +++ b/translations/es-ES/content/admin/configuration/configuring-your-enterprise/index.md @@ -33,18 +33,18 @@ children: - /troubleshooting-tls-errors - /configuring-time-synchronization - /command-line-utilities - - /restricting-network-traffic-to-your-enterprise + - /restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list - /configuring-github-pages-for-your-enterprise - /configuring-host-keys-for-your-instance - /configuring-the-referrer-policy-for-your-enterprise - /configuring-custom-footers - /configuring-web-commit-signing shortTitle: Configure your enterprise -ms.openlocfilehash: 3cc7deccfdf71a0e339fca8055f0cd4b5027a32c -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a +ms.openlocfilehash: 4f19ba9cd3207c34b7eb679fb62481e04185ad2c +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/11/2022 -ms.locfileid: '147409253' +ms.lasthandoff: 11/22/2022 +ms.locfileid: '148180161' --- diff --git a/translations/es-ES/content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md b/translations/es-ES/content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md index e4f70c36cb..2ac265822e 100644 --- a/translations/es-ES/content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md +++ b/translations/es-ES/content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md @@ -1,6 +1,6 @@ --- -title: Initializing GitHub AE -intro: 'To get your enterprise ready to use, you can complete the initial configuration of {% data variables.product.product_name %}.' +title: Inicializar GitHub AE +intro: 'Para poner a tu empresa lista para operar, puedes completar la configuración inicial de {% data variables.product.product_name %}.' versions: ghae: '*' type: how_to @@ -9,122 +9,127 @@ topics: redirect_from: - /admin/configuration/initializing-github-ae - /enterprise-server@latest/admin/configuration/configuring-your-enterprise/initializing-github-ae +ms.openlocfilehash: a3c32a770bbf58be3589824302fe3a32be0e239a +ms.sourcegitcommit: ced661bdffebd0f96f6f76db109fbe31983448ba +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167056' --- -## About initialization +## Acerca de la inicialización -Before you can initialize your enterprise, you must purchase {% data variables.product.product_name %}. For more information, contact {% data variables.contact.contact_enterprise_sales %}. +Antes de que puedas inicializar tue mpresa, debes comprar {% data variables.product.product_name %}. Para obtener más información, contacta a {% data variables.contact.contact_enterprise_sales %}. -{% data reusables.github-ae.initialize-enterprise %} Make sure the information you provide matches the intended enterprise owner's information in the IdP. For more information about enterprise owners, see "[Roles in an enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owner)." +{% data reusables.github-ae.initialize-enterprise %} Asegúrate de que la información que proporcionas empate con la información destinada del propietario de la empresa en el IdP. Para obtener más información sobre los propietarios de empresas, consulta "[Roles en una empresa](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owner)". {% note %} -**Notes**: +**Notas**: -- If the initial password for {% data variables.product.prodname_ghe_managed %} expires before you finish initialization, you can request a password reset at any time from your invitation email. +- Si la contraseña inicial para {% data variables.product.prodname_ghe_managed %} vence antes de que finalices la instalación, puedes solicitar un restablecimiento de contraseña en cualquier momento desde tu correo electrónico de invitación. -- Store the initial username and password for {% data variables.product.prodname_ghe_managed %} securely in a password manager. {% data reusables.saml.contact-support-if-your-idp-is-unavailable %} +- Almacena de forma segura el nombre de usuario y contraseña iniciales para {% data variables.product.prodname_ghe_managed %} en un administrador de contraseñas. {% data reusables.saml.contact-support-if-your-idp-is-unavailable %} {% endnote %} -During initialization, the enterprise owner will name your enterprise, configure SAML SSO, create policies for all organizations in your enterprise, and configure a support contact for your users. +Durante la inicialización, el propietario de la empresa nombrará a tu empresa, configurará el SSO de SAML, creará políticas para todas las organizaciones dentro de la empresa y configurará un contacto de soporte para tus usuarios. -## Prerequisites +## Prerrequisitos -To begin initialization, you will receive an invitation email from {% data variables.product.company_short %}. Before you configure {% data variables.product.prodname_ghe_managed %}, review the following prerequisites. +Para comenzar la inicialización, recibirás un correo electrónico de invitación desde {% data variables.product.company_short %}. Antes de que configures {% data variables.product.prodname_ghe_managed %}, revisa los siguientes prerequisitos. -To initialize {% data variables.location.product_location %}, you must have a SAML identity provider (IdP). {% data reusables.saml.ae-uses-saml-sso %} To connect your IdP to your enterprise during initialization, you should have your IdP's Entity ID (SSO) URL, Issuer ID URL, and public signing certificate (Base64-encoded). For more information, see "[About identity and access management for your enterprise](/admin/authentication/about-identity-and-access-management-for-your-enterprise)." +Para inicializar {% data variables.location.product_location %}, debes tener un proveedor de identidad (IdP) de SAML. {% data reusables.saml.ae-uses-saml-sso %} Para conectar tu IdP a tu empresa durante la inicialización, debes tener tu URL de ID de entidad (SSO) del IdP, URL de ID emisora, y certificado de firma público (cifrado en Base64). Para más información, vea "[Acerca de la administración de identidades y acceso para la empresa](/admin/authentication/about-identity-and-access-management-for-your-enterprise)". {% note %} -**Note**: {% data reusables.saml.create-a-machine-user %} +**Nota**: {% data reusables.saml.create-a-machine-user %} {% endnote %} -## Signing in and naming your enterprise +## Iniciar sesión y nombrar a tu empresa -1. Follow the instructions in your welcome email to reach your enterprise. -2. Type your credentials under "Change password", then click **Change password**. -3. Under "What would you like your enterprise account to be named?", type the enterprise's name, then click **Save and continue**. - !["Save and continue" button for naming an enterprise](/assets/images/enterprise/configuration/ae-enterprise-configuration.png) +1. Sigue las instrucciones en tu correo electrónico de bienvenida para llegar a tu empresa. +2. Escriba sus credenciales en "Change password" (Cambiar contraseña) y, luego, haga clic en **Change password** (Cambiar contraseña). +3. Debajo de "What would you like your enterprise account to be named?" (¿Qué nombre quiere darle a su cuenta empresarial?), escriba el nombre de la empresa y luego haga clic en **Save and continue** (Guardar y continuar). + ![Botón "Guardar y continuar" para asignar un nombre a una empresa](/assets/images/enterprise/configuration/ae-enterprise-configuration.png) -## Connecting your IdP to your enterprise +## Conectar tu IdP a tu empresa -To configure authentication for {% data variables.product.product_name %}, you must provide {% data variables.product.product_name %} with the details for your SAML IdP. {% data variables.product.company_short %} recommends using Azure AD as your IdP. For more information, see "[Configuring authentication and provisioning with your identity provider](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider)." +Para configurar la autenticación para {% data variables.product.product_name %}, debes proporcionar a {% data variables.product.product_name %} los detalles de tu IdP de SAML. {% data variables.product.company_short %} te recomienda utilizar Azure AD como tu IdP. Para más información, vea "[Configuración de la autenticación y el aprovisionamiento con el proveedor de identidades](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider)". -1. To the right of "Set up your identity provider", click **Configure**. - !["Configure" button for IdP configuration](/assets/images/enterprise/configuration/ae-idp-configure.png) -1. Under "Sign on URL", copy and paste the URL for your SAML IdP. - ![Text field for SAML IdP's sign-on URL](/assets/images/enterprise/configuration/ae-idp-sign-on-url.png) -1. Under "Issuer", copy and paste the issuer URL for your SAML IdP. - ![Text field for SAML IdP's issuer URL](/assets/images/enterprise/configuration/ae-idp-issuer-url.png) -1. Under "Public certificate", copy and paste the public certificate for your SAML IdP. - ![Text field for SAML IdP's public certificate](/assets/images/enterprise/configuration/ae-idp-public-certificate.png) -1. Click **Test SAML configuration** to ensure that the information you've entered is correct. - !["Test SAML configuration" button](/assets/images/enterprise/configuration/ae-test-saml-configuration.png) -1. Click **Save**. - !["Save" button for IdP configuration](/assets/images/enterprise/configuration/ae-save.png) +1. A la derecha de "Set up your identity provider" (Configurar el proveedor de identidades), haga clic en **Configure** (Configurar). + ![Botón "Configurar" para la configuración del IdP](/assets/images/enterprise/configuration/ae-idp-configure.png) +1. Debajo de "URL de ingreso", copia y pega la URL de tu IdP de SAML. + ![Campo de texto para la URL de registro del IdP de SAML](/assets/images/enterprise/configuration/ae-idp-sign-on-url.png) +1. Debajo de "Emisor", copiay pega la URL emisora para tu IdP de SAML. + ![Campo de texto para la URL del emisor del IdP de SAML](/assets/images/enterprise/configuration/ae-idp-issuer-url.png) +1. Debajo de "Certificado público", copia y pega el certificado público para tu IdP de SAML. + ![Campo de texto para el certificado público del IdP de SAML](/assets/images/enterprise/configuration/ae-idp-public-certificate.png) +1. Para asegurarse de que la información especificada es correcta, haga clic en **Test SAML configuration** (Probar configuración de SAML). + ![Botón "Probar configuración de SAML"](/assets/images/enterprise/configuration/ae-test-saml-configuration.png) +1. Haga clic en **Save**(Guardar). + ![Botón "Guardar" para la configuración del IdP](/assets/images/enterprise/configuration/ae-save.png) 1. {% data reusables.saml.assert-the-administrator-attribute %} -## Setting your enterprise policies +## Configurar las políticas de tu empresa -Configuring policies will set limitations for repository and organization management for your enterprise. These can be reconfigured after the initialization process. +El configurar políticas pondrá limitaciones para la administración de repositorios y organizaciones en tu empresa. Estas pueden volver a configurarse después del proceso de inicialización. -1. To the right of "Set your enterprise policies", click **Configure**. - !["Configure" button for policies configuration](/assets/images/enterprise/configuration/ae-policies-configure.png) -2. Under "Default Repository Permissions", use the drop-down menu and click a default permissions level for repositories in your enterprise. If a person has multiple avenues of access to an organization, either individually, through a team, or as an organization member, the highest permission level overrides any lower permission levels. Optionally, to allow organizations within your enterprise to set their default repository permissions, click **No policy** - ![Drop-down menu for default repository permissions options](/assets/images/enterprise/configuration/ae-repository-permissions-menu.png) -3. Under "Repository creation", choose whether you want to allow members to create repositories. Optionally, to allow organizations within your enterprise to set permissions, click **No policy**. - !["Members can create repositories" button for enterprise policies configuration](/assets/images/enterprise/configuration/ae-repository-creation-permissions.png) -4. Under "Repository forking", choose whether to allow forking of private and internal repositories. Optionally, to allow organizations within your enterprise to set permissions, click **No policy** - ![Drop-down menu for repository forking permissions options](/assets/images/enterprise/configuration/ae-repository-forking-menu.png) -5. Under "Repository invitations", choose whether members or organization owners can invite collaborators to repositories. Optionally, to allow organizations within your enterprise to set permissions, click **No policy** - ![Drop-down menu for repository invitation permissions options](/assets/images/enterprise/configuration/ae-repository-invitations-menu.png) -6. Under "Default repository visibility", use the drop-down menu and click the default visibility setting for new repositories. - ![Drop-down menu for default repository visibility options](/assets/images/enterprise/configuration/ae-repository-visibility-menu.png) -7. Under "Users can create organizations", use the drop-down menu to enable or disable organization creation access for members of the enterprise. - ![Drop-down menu for organization creation permissions options](/assets/images/enterprise/configuration/ae-organization-creation-permissions-menu.png) -8. Under "Force pushes", use the drop-down menu and choose whether to allow or block force pushes. - ![Drop-down menu for force pushes configuration options](/assets/images/enterprise/configuration/ae-force-pushes-configuration-menu.png) -9. Under "Git SSH access", use the drop-down menu and choose whether to enable Git SSH access for all repositories in the enterprise. - ![Drop-down menu for Git SSH access options](/assets/images/enterprise/configuration/ae-git-ssh-access-menu.png) -10. Click **Save** - !["Save" button for enterprise policies configuration](/assets/images/enterprise/configuration/ae-save.png) -11. Optionally, to reset all selections, click "Reset to default policies". - ![Link to reset all default policies](/assets/images/enterprise/configuration/ae-reset-default-options.png) +1. A la derecha de "Set your enterprise policies" (Establecer las directivas empresariales), haga clic en **Configure** (Configurar). + ![Botón "Configurar" para la configuración de directivas](/assets/images/enterprise/configuration/ae-policies-configure.png) +2. Debajo de "Permisos Predeterminados de los Repositorios", utiliza el menú desplegable y da clci en un nivel de permisos predeterminado para los repositorios de tu empresa. Si alguien tiene varios medios de acceso a una organización, ya sea indiviudalmente, a través de un equipo, o como un miembro de la misma, el permiso más alto anulará los permisos más bajos. Opcionalmente, para permitir que las organizaciones de la empresa establezcan sus permisos de repositorio predeterminados, haga clic en **No policy** (Ninguna directiva) + .![Menú desplegable para las opciones predeterminadas de los permisos del repositorio](/assets/images/enterprise/configuration/ae-repository-permissions-menu.png) +3. Debajo de "Creación de repositorios", elige si quieres permitir que los miembros creen repositorios o no. Opcionalmente, para permitir que las organizaciones de su empresa establezcan permisos, haga clic en **No policy** (Ninguna directiva). + ![Botón "Los miembros pueden crear repositorios" para la configuración de las directivas de empresa](/assets/images/enterprise/configuration/ae-repository-creation-permissions.png) +4. Debajo de "Bifurcación de repositorios", elige si quieres permitir la bifurcación de repositorios privados e internos. Opcionalmente, para permitir que las organizaciones de la empresa establezcan sus permisos, haga clic en **No policy** (Ninguna directiva) + .![Menú desplegable para las opciones predeterminadas de bifurcación del repositorio](/assets/images/enterprise/configuration/ae-repository-forking-menu.png) +5. Debajo de "invitaciones a los repositorios", elige si los miembros o propietarios de la organización pueden invitar colaboradores a los repositorios. Opcionalmente, para permitir que las organizaciones de la empresa establezcan sus permisos, haga clic en **No policy** (Ninguna directiva) + .![Menú desplegable para las opciones predeterminadas de invitación del repositorio](/assets/images/enterprise/configuration/ae-repository-invitations-menu.png) +6. Debajo de "Visibilidad predeterminada de los repositorios", utiliza el menú desplegable y da clic en el ajuste de visibilidad predeterminada para los repositorios nuevos. + ![Menú desplegable para las opciones de visibilidad predeterminadas del repositorio](/assets/images/enterprise/configuration/ae-repository-visibility-menu.png) +7. Debajo de "Los usuarios pueden crear organizaciones", utiliza el menú desplegable para habilitar o inhabilitar el acceso para la creación de organizaciones para los miembros de la empresa. + ![Menú desplegable para las opciones de permisos de creación en las organizaciones](/assets/images/enterprise/configuration/ae-organization-creation-permissions-menu.png) +8. Debajo de "subidas forzadas", utiliza el menú desplegable y elige si quieres permitir o bloquear las subidas forzadas. + ![Menú desplegable para las opciones de configuración de inserciones forzadas](/assets/images/enterprise/configuration/ae-force-pushes-configuration-menu.png) +9. Debajo de "Acceso SSH a Git", utiliza el menú desplegable y elige si quieres habilitar el acceso por SSH a Git para todos los repositorios en la empresa. + ![Menú desplegable para las opciones de acceso SSH a Git](/assets/images/enterprise/configuration/ae-git-ssh-access-menu.png) +10. Haga clic en **Save** (Guardar). + ![Botón "Guardar" para la configuración de directivas empresariales](/assets/images/enterprise/configuration/ae-save.png) +11. Opcionalmente, para restablecer todas las selecciones, da clic en "Restablecer a las políticas predeterminadas". + ![Vínculo para restablecer todas las directivas predeterminadas](/assets/images/enterprise/configuration/ae-reset-default-options.png) -## Setting your internal support contact +## Configurar tu contacto de soporte interno -You can configure the method your users will use to contact your internal support team. This can be reconfigured after the initialization process. +Puedes configurar el método que tus usuarios utilizarán para contactar a tu equipo de soporte interno. Esto puede volver a configurarse después del proceso de inicialización. -1. To the right of "Internal support contact", click **Configure**. - !["Configure" button for internal support contact configuration](/assets/images/enterprise/configuration/ae-support-configure.png) -2. Under "Internal support contact", select the method for users of your enterprise to contact support, through a URL or an e-mail address. Then, type the support contact information. - ![Text field for internal support contact URL](/assets/images/enterprise/configuration/ae-support-link-url.png) -3. Click **Save**. - !["Save" button for enterprise support contact configuration](/assets/images/enterprise/configuration/ae-save.png) +1. A la derecha de "Internal support contact" (Contacto de soporte técnico interno), haga clic en **Configure** (Configurar). + ![Botón "Configurar" para la configuración de contacto de soporte técnico interno](/assets/images/enterprise/configuration/ae-support-configure.png) +2. Debajo de "Contacto de soporte interno", selecciona el método para que los usuarios de tu empresa contacten a soporte, a través de una URL o de una dirección de correo electrónico. Posteriormente, teclea la información de contacto para soporte. + ![Campo de texto para la URL de contacto de soporte técnico interno](/assets/images/enterprise/configuration/ae-support-link-url.png) +3. Haga clic en **Save**(Guardar). + ![Botón "Guardar" para la configuración de contacto de soporte técnico de empresa](/assets/images/enterprise/configuration/ae-save.png) -## Setting your email settings +## Configurar los ajustes de tu correo electrónico -Once this is initialized, you can reconfigure any settings after the initialization process. For more information, see "[Configuring email for notifications](/admin/configuration/configuring-email-for-notifications)." +Una vez que se inicialice, puedes reconfigurar cualquier ajuste después del proceso de inicialización. Para más información, vea "[Configuración del correo electrónico para notificaciones](/admin/configuration/configuring-email-for-notifications)". -1. To the right of "Configure email settings", click **Configure**. - !["Configure" button for email settings configuration](/assets/images/enterprise/configuration/ae-email-configure.png) -2. Select **Enable email**. This will enable both outbound and inbound email, however, for inbound email to work you will also need to configure your DNS settings. For more information, see "[Configuring DNS and firewall - settings to allow incoming emails](/admin/configuration/configuring-email-for-notifications#configuring-dns-and-firewall-settings-to-allow-incoming-emails)." - !["Enable" checkbox for email settings configuration](/assets/images/enterprise/configuration/ae-enable-email-configure.png) -3. Complete your email server settings: - - In the **Server address** field, type the address of your SMTP server. - - In the **Port** field, type the port that your SMTP server uses to send email. - - In the **Domain** field, type the domain name that your SMTP server will send with a HELO response, if any. - - In the **Authentication** dropdown, choose the type of encryption used by your SMTP server. - - In the **No-reply email address** field, type the email address to use in the From and To fields for all notification emails. +1. A la derecha de "Configure email settings" (Configurar opciones de correo electrónico), haga clic en **Configure** (Configurar). + ![Botón "Configurar" para la configuración de las opciones de correo electrónico](/assets/images/enterprise/configuration/ae-email-configure.png) +2. Seleccione **Enable email** (Habilitar correo electrónico). Esto habilitará el correo electrónico tanto entrante como saliente, sin embargo, para que funcione el entrante, también necesitarás configurar tus ajustes de DNS. Para obtener más información, vea "[Configuración de DNS y opciones de firewall para permitir correos electrónicos entrantes](/admin/configuration/configuring-email-for-notifications#configuring-dns-and-firewall-settings-to-allow-incoming-emails)". + ![Casilla "Habilitar" para la configuración de opciones de correo electrónico](/assets/images/enterprise/configuration/ae-enable-email-configure.png) +3. Completa tus ajustes de servidor de correo electrónico: + - En el campo **Server address** (Dirección del servidor), escriba la dirección del servidor SMTP. + - En el campo **Puerto**, escriba el puerto que usa el servidor SMTP para enviar correo electrónico. + - En el campo **Domain** (Dominio), escriba el nombre de dominio que enviará el servidor SMTP con una respuesta HELO, si existe. + - En la lista desplegable **Authentication** (Autenticación), elija el tipo de cifrado que usa el servidor SMTP. + - En el campo **No reply email address** (Dirección de correo electrónico sin respuesta), escriba la dirección de correo electrónico a fin de usar en los campos De y Para en todos los correos electrónicos para notificaciones. -4. If you want to discard all incoming emails that are addressed to the no-reply email address, select **Discard email addressed to the no-reply email address**. - !["Discard" checkbox for email settings configuration](/assets/images/enterprise/configuration/ae-discard-email.png) -5. Click **Test email settings**. - !["Test email settings" button for email settings configuration](/assets/images/enterprise/configuration/ae-test-email.png) -6. Under "Send test email to," type the email address where you want to send a test email, then click **Send test email**. - !["Send test email" button for email settings configuration](/assets/images/enterprise/configuration/ae-send-test-email.png) -7. Click **Save**. - !["Save" button for enterprise support contact configuration](/assets/images/enterprise/configuration/ae-save.png) +4. Si quiere descartar todos los correos electrónicos entrantes que estén dirigidos al correo electrónico sin respuesta, seleccione **Descartar correo electrónico dirigido a la dirección de correo electrónico sin respuesta**. + ![Casilla "Descartar" para la configuración de las opciones de correo electrónico](/assets/images/enterprise/configuration/ae-discard-email.png) +5. Haga clic en **Probar configuración de correo electrónico**. + ![Botón "Probar configuración de correo electrónico" para la configuración de las opciones de correo electrónico](/assets/images/enterprise/configuration/ae-test-email.png) +6. En "Enviar correo electrónico de prueba a", escriba la dirección de correo electrónico a la que quiera enviar un mensaje de prueba y haga clic en **Enviar correo electrónico de prueba**. + ![Botón "Enviar correo electrónico de prueba" para la configuración de las opciones de correo electrónico](/assets/images/enterprise/configuration/ae-send-test-email.png) +7. Haga clic en **Save**(Guardar). + ![Botón "Guardar" para la configuración de contacto de soporte técnico de empresa](/assets/images/enterprise/configuration/ae-save.png) diff --git a/translations/es-ES/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md b/translations/es-ES/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md deleted file mode 100644 index 930002f9d6..0000000000 --- a/translations/es-ES/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Restringir el tráfico de red en tu empresa -shortTitle: Restricting network traffic -intro: Puedes utilizar una lista de IP permitidas para restringir el acceso de conexiones de IP específicas a tu empresa. -versions: - ghae: '*' -type: how_to -topics: - - Access management - - Enterprise - - Fundamentals - - Networking - - Security -redirect_from: - - /admin/configuration/restricting-network-traffic-to-your-enterprise -ms.openlocfilehash: 67c7067362ac94e5cbc64be4704ba0ec3f6606e0 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/09/2022 -ms.locfileid: '147682856' ---- -## Acerca de las listas de IP permitidas - -Predeterminadamente, los usuarios autorizados pueden acceder a tu empresa desde cualquier dirección IP. Los propietarios de empresa pueden restringir el acceso a los activos que pertenezcan a las organizaciones dentro de la cuenta empresarial mediante la configuración de una lista de direcciones IP permitidas. {% data reusables.identity-and-permissions.ip-allow-lists-example-and-restrictions %} - -{% data reusables.identity-and-permissions.ip-allow-lists-cidr-notation %} - -{% data reusables.identity-and-permissions.ip-allow-lists-enable %} {% data reusables.identity-and-permissions.ip-allow-lists-enterprise %} - -También puedes configurar las direcciones IP permitidas para una organización individual. Para más información, vea "[Administración de las direcciones IP permitidas para la organización](/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization)". - -Predeterminadamente, las reglas del grupo de seguridad de redes (NSG) de Azure dejan todo el tráfico entrante abierto en los puertos 22, 80, 443 y 25. Los propietarios de las empresas pueden contactar a {% data variables.contact.github_support %} para configurar las restricciones de acceso para tu instancia. - -Para las restricciones a nivel de instancia que utilizan los NSG de Azure, contacta a {% data variables.contact.github_support %} enviando las direcciones IP que deberán poder acceder a tu instancia empresarial. Especifica los rangos de direcciones utilizando el formato estándar de CIDR (Enrutamiento sin Clases entre Dominios, por sus siglas en inglés). {% data variables.contact.github_support %} configurará las reglas de cortafuegos adecuadas para que tu empresa restrinja el acceso por HTTP, SSH, HTTPS, y SMTP. Para más información, vea "[Recepción de ayuda de {% data variables.contact.github_support %}](/admin/enterprise-support/receiving-help-from-github-support)". - -## Agregar una dirección IP permitida - -{% data reusables.identity-and-permissions.about-adding-ip-allow-list-entries %} - -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} {% data reusables.identity-and-permissions.ip-allow-lists-add-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-add-description %} {% data reusables.identity-and-permissions.ip-allow-lists-add-entry %} {% data reusables.identity-and-permissions.check-ip-address %} - -## Permitir el acceso mediante {% data variables.product.prodname_github_apps %} - -{% data reusables.identity-and-permissions.ip-allow-lists-githubapps-enterprise %} - -## Habilitar direcciones IP permitidas - -{% data reusables.identity-and-permissions.about-enabling-allowed-ip-addresses %} - -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} -1. En "IP allow list", seleccione **Enable IP allow list**. - ![Casilla para permitir direcciones IP](/assets/images/help/security/enable-ip-allowlist-enterprise-checkbox.png) -4. Haga clic en **Save**(Guardar). - -## Editar una dirección IP permitida - -{% data reusables.identity-and-permissions.about-editing-ip-allow-list-entries %} - -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-entry %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-description %} -8. Haga clic en **Update**(Actualizar). -{% data reusables.identity-and-permissions.check-ip-address %} - -{% ifversion ip-allow-list-address-check %} -## Comprobación de permiso para una dirección IP - -{% data reusables.identity-and-permissions.about-checking-ip-address %} - -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} {% data reusables.identity-and-permissions.check-ip-address-step %} {% endif %} - -## Eliminar una dirección IP permitida - -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} {% data reusables.identity-and-permissions.ip-allow-lists-delete-entry %} {% data reusables.identity-and-permissions.ip-allow-lists-confirm-deletion %} - -## Utilizar {% data variables.product.prodname_actions %} con un listado de direcciones IP permitidas - -{% data reusables.actions.ip-allow-list-self-hosted-runners %} diff --git a/translations/es-ES/content/admin/enterprise-management/configuring-clustering/initializing-the-cluster.md b/translations/es-ES/content/admin/enterprise-management/configuring-clustering/initializing-the-cluster.md index d9f9b98dbc..57b01828ff 100644 --- a/translations/es-ES/content/admin/enterprise-management/configuring-clustering/initializing-the-cluster.md +++ b/translations/es-ES/content/admin/enterprise-management/configuring-clustering/initializing-the-cluster.md @@ -1,6 +1,6 @@ --- -title: Initializing the cluster -intro: 'A {% data variables.product.prodname_ghe_server %} cluster must be set up with a license and initialized using the administrative shell (SSH).' +title: Inicializar la agrupación +intro: 'Una agrupación de {% data variables.product.prodname_ghe_server %} se debe configurar con una licencia y se debe inicializar mediante un shell administrativo (SSH).' redirect_from: - /enterprise/admin/clustering/initializing-the-cluster - /enterprise/admin/enterprise-management/initializing-the-cluster @@ -11,46 +11,50 @@ type: how_to topics: - Clustering - Enterprise +ms.openlocfilehash: 91394d1d39301f77bc49a87012e04c3d5e9c3b60 +ms.sourcegitcommit: ced661bdffebd0f96f6f76db109fbe31983448ba +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167088' --- {% data reusables.enterprise_clustering.clustering-requires-https %} -## Installing {% data variables.product.prodname_ghe_server %} +## Instalar {% data variables.product.prodname_ghe_server %} -1. On each cluster node, provision and install {% data variables.product.prodname_ghe_server %}. For more information, see "[Setting up a {% data variables.product.prodname_ghe_server %} instance](/enterprise/admin/guides/installation/setting-up-a-github-enterprise-server-instance)." -2. Using the administrative shell or DHCP, **only** configure the IP address of each node. Don't configure any other settings. +1. En cada nodo de agrupación, suministra e instala {% data variables.product.prodname_ghe_server %}. Para obtener más información, consulta "[Configuración de una instancia de {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/installation/setting-up-a-github-enterprise-server-instance)". +2. Mediante el shell administrativo o DHCP, configura **solo** la dirección IP de cada nodo. No configures los otros parámetros. -## Configuring the first node +## Configurar el primer nodo -1. Connect to the node that will be designated as MySQL primary in `cluster.conf`. For more information, see "[About the cluster configuration file](/enterprise/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)." -2. In your web browser, visit `https://:8443/setup/`. -{% data reusables.enterprise_installation.upload-a-license-file %} -{% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} -{% data reusables.enterprise_installation.instance-will-restart-automatically %} +1. Conéctate al nodo que se designará como principal de MySQL en `cluster.conf`. Para obtener más información, consulta "[Acerca del archivo de configuración del clúster](/enterprise/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)". +2. En el explorador web, ve a `https://:8443/setup/`. +{% data reusables.enterprise_installation.upload-a-license-file %} {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} {% data reusables.enterprise_installation.instance-will-restart-automatically %} -## Initializing the cluster +## Inicializar la agrupación -To initialize the cluster, you need a cluster configuration file (`cluster.conf`). For more information, see "[About the cluster configuration file](/enterprise/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)". +Para inicializar el clúster, necesitas un archivo de configuración del clúster (`cluster.conf`). Para obtener más información, consulta "[Acerca del archivo de configuración del clúster](/enterprise/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)". -1. From the first node that was configured, run `ghe-cluster-config-init`. This will initialize the cluster if there are nodes in the cluster configuration file that are not configured. -2. Run `ghe-cluster-config-apply`. This will validate the `cluster.conf` file, apply the configuration to each node file and bring up the configured services on each node. +1. Desde el primer nodo que se configuró, ejecuta `ghe-cluster-config-init`. De esta manera, se inicializará la agrupación si existen nodos en el archivo de configuración de la agrupación que no están configurados. +2. Ejecute `ghe-cluster-config-apply`. De esta manera se validará el archivo `cluster.conf`, se aplicará la configuración a cada archivo del nodo y se traerán los servicios configurados en cada nodo. -To check the status of a running cluster use the `ghe-cluster-status` command. +Para comprobar el estado de un clúster en ejecución, usa el comando `ghe-cluster-status`. -## About the cluster configuration file +## Acerca del archivo de configuración de la agrupación -The cluster configuration file (`cluster.conf`) defines the nodes in the cluster, and what services they run. -For more information, see "[About cluster nodes](/enterprise/admin/guides/clustering/about-cluster-nodes)." +El archivo de configuración del clúster (`cluster.conf`) define los nodos del clúster y qué servicios ejecutan. +Para obtener más información, consulta "[Acerca de los nodos de clúster](/enterprise/admin/guides/clustering/about-cluster-nodes)". -This example `cluster.conf` defines a cluster with 11 nodes. +En este ejemplo, `cluster.conf` define un clúster con 11 nodos. - - Two nodes called `ghes-front-end-node-\*` run services responsible for responding to client requests. - - Three nodes called `ghes-database-node-\*` run services responsible for storage, retrieval, and replication of database data. - - Three nodes called `ghes-search-node-\*` run services responsible for search functionality. - - Three nodes called `ghes-storage-node-\*` run services responsible for storage, retrieval, and replication of data. + - Dos nodos denominados`ghes-front-end-node-\*` ejecutan los servicios responsables de responder a las solicitudes de cliente. + - Tres nodos denominados `ghes-database-node-\*` ejecutan los servicios responsables del almacenamiento, recuperación y replicación de datos de una base de datos. + - Tres nodos denominados `ghes-search-node-\*` ejecutan los servicios responsables de la funcionalidad de búsqueda. + - Tres nodos denominados `ghes-storage-node-\*` ejecutan los servicios responsables del almacenamiento, recuperación y replicación de datos. -The names of the nodes can be any valid hostname you choose. The names are set as the hostname of each node, and will also be added to `/etc/hosts` on each node, so that the nodes are locally resolvable to each other. +Los nombres de los nodos pueden ser cualquier nombre de host válido que elijas. Los nombres se establecen como el nombre de host de cada nodo y también se agregarán a `/etc/hosts` en cada nodo, de manera que los nodos puedan ser resolubles localmente entre sí. -Specify the first cluster node you configured as the MySQL primary via `mysql-server` and `mysql-master`. +Especifica el primer nodo de clúster que configuraste como principal de MySQL mediante `mysql-server` y `mysql-master`. ```ini [cluster] @@ -155,7 +159,7 @@ Specify the first cluster node you configured as the MySQL primary via `mysql-se metrics-server = true ``` -Create the file `/data/user/common/cluster.conf` on the configured first node. For example, using `vim`: +Crea el archivo `/data/user/common/cluster.conf` en el primer nodo configurado. Por ejemplo, al usar `vim`: ```shell ghe-data-node-1:~$ sudo vim /data/user/common/cluster.conf diff --git a/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md b/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md new file mode 100644 index 0000000000..6336814ef8 --- /dev/null +++ b/translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md @@ -0,0 +1,49 @@ +--- +title: Enabling GitHub Actions with MinIO storage +intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use MinIO storage to store data generated by workflow runs.' +permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.' +versions: + ghes: '*' +type: how_to +topics: + - Actions + - Enterprise + - Infrastructure + - Storage +redirect_from: + - /admin/github-actions/enabling-github-actions-with-minio-gateway-for-nas-storage + - /admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-gateway-for-nas-storage +shortTitle: MinIO storage +--- + +## Prerequisites + +Before enabling {% data variables.product.prodname_actions %}, make sure you have completed the following steps: + +* Create your MinIO bucket for storing data generated by workflow runs. For more information about installing and configuring MinIO, see "[MinIO High Performance Object Storage](https://min.io/docs/minio/container/index.html)" and "[mc mb](https://min.io/docs/minio/linux/reference/minio-mc/mc-mb.html)" in the MinIO documentation. + + To avoid resource contention on the appliance, we recommend that MinIO be hosted separately from {% data variables.location.product_location %}. + + {% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %} +{% data reusables.actions.enterprise-common-prereqs %} + +## Enabling {% data variables.product.prodname_actions %} with MinIO storage + +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.management-console %} +{% data reusables.enterprise_management_console.actions %} +{% data reusables.actions.enterprise-enable-checkbox %} +1. Under "Artifact & Log Storage", select **Amazon S3**, and enter your storage bucket's details: + + * **AWS Service URL**: The URL to your MinIO service. For example, `https://my-minio.example:9000`. + * **AWS S3 Bucket**: The name of your S3 bucket. + * **AWS S3 Access Key** and **AWS S3 Secret Key**: The `MINIO_ACCESS_KEY` and `MINIO_SECRET_KEY` used for your MinIO instance. + + ![Radio button for selecting Amazon S3 Storage and fields for MinIO configuration](/assets/images/enterprise/management-console/actions-minio-s3-storage.png) +1. Under "Artifact & Log Storage", select **Force path style**. + + ![Checkbox to Force path style](/assets/images/enterprise/management-console/actions-minio-force-path-style.png) +{% data reusables.enterprise_management_console.test-storage-button %} +{% data reusables.enterprise_management_console.save-settings %} + +{% data reusables.actions.enterprise-postinstall-nextsteps %} diff --git a/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md b/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md index 58f812ba1b..2c7785574a 100644 --- a/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md +++ b/translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md @@ -1,7 +1,7 @@ --- -title: Migrating your enterprise to GitHub Actions +title: Migrar tu empresa a GitHub Actions shortTitle: Migrate to Actions -intro: 'Learn how to plan a migration to {% data variables.product.prodname_actions %} for your enterprise from another provider.' +intro: 'Aprende cómo planear una migración a {% data variables.product.prodname_actions %} para tu empresa desde otro proveedor.' versions: ghec: '*' ghes: '*' @@ -10,78 +10,83 @@ type: how_to topics: - Actions - Enterprise +ms.openlocfilehash: 332d8af7f1087626509a9c72751882ea11f3072f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160361' --- +## Acerca de las migraciones empresariales a {% data variables.product.prodname_actions %} -## About enterprise migrations to {% data variables.product.prodname_actions %} +Para migrar tu empresa a {% data variables.product.prodname_actions %} desde un sistema existente, puedes planear la migración, completarla y retirar los sistemas existentes. -To migrate your enterprise to {% data variables.product.prodname_actions %} from an existing system, you can plan the migration, complete the migration, and retire existing systems. +Esta guía dirige consideraciones específicas para las migraciones. Para obtener más información sobre cómo introducir {% data variables.product.prodname_actions %} en la empresa, vea "[Introducción de {% data variables.product.prodname_actions %} en la empresa](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise)". -This guide addresses specific considerations for migrations. For additional information about introducing {% data variables.product.prodname_actions %} to your enterprise, see "[Introducing {% data variables.product.prodname_actions %} to your enterprise](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise)." +## Planificación de la migración -## Planning your migration +Antes de que comiences a migrar tu empresa a {% data variables.product.prodname_actions %}, debes identificar qué flujos de trabajo se migrarán y cómo afectarán dichas migraciones a tus equipos, posteriormente, deberás planear cómo y cuándo completarás las migraciones. -Before you begin migrating your enterprise to {% data variables.product.prodname_actions %}, you should identify which workflows will be migrated and how those migrations will affect your teams, then plan how and when you will complete the migrations. +### Aprovechar los especialistas en migración -### Leveraging migration specialists +{% data variables.product.company_short %} puede ayudarte con la migración y también puedes sacar provecho de comprar los {% data variables.product.prodname_professional_services %}. Para obtener más información, contacta a tu representante dedicado o a {% data variables.contact.contact_enterprise_sales %}. -{% data variables.product.company_short %} can help with your migration, and you may also benefit from purchasing {% data variables.product.prodname_professional_services %}. For more information, contact your dedicated representative or {% data variables.contact.contact_enterprise_sales %}. +### Identificar e inventariar los destinos de migración -### Identifying and inventorying migration targets +Antes de que puedas migrarte a las {% data variables.product.prodname_actions %}, necesitarás tener un entendimiento total de los flujos de trabajo que utiliza tu empresa en tu sistema existente. -Before you can migrate to {% data variables.product.prodname_actions %}, you need to have a complete understanding of the workflows being used by your enterprise in your existing system. +Primero, crea un inventario de los flujos de trabajo de lanzamientos y de compilación existentes en tu empresa, juntando la información sobre qué flujos de trabajo se utilizan activamente y necesitan migrarse y cuáles pueden quedarse atrás. -First, create an inventory of the existing build and release workflows within your enterprise, gathering information about which workflows are being actively used and need to migrated and which can be left behind. +Después, conoce las diferencias entre tu proveedor actual y las {% data variables.product.prodname_actions %}. Esto te ayudará a evaluar cualquier dificultad para migrar cada flujo de trabajo y en dónde tu empresa podría experimentar diferencias en características. Para obtener más información, vea "[Migración a {% data variables.product.prodname_actions %}](/actions/migrating-to-github-actions)." -Next, learn the differences between your current provider and {% data variables.product.prodname_actions %}. This will help you assess any difficulties in migrating each workflow, and where your enterprise might experience differences in features. For more information, see "[Migrating to {% data variables.product.prodname_actions %}](/actions/migrating-to-github-actions)." +Con esta información, podrás determinar qué flujos de trabajo puedes y quieres migrar a {% data variables.product.prodname_actions %}. -With this information, you'll be able to determine which workflows you can and want to migrate to {% data variables.product.prodname_actions %}. +### Determinar los impactos de equipo a raíz de las migraciones -### Determine team impacts from migrations +Cuando cambias las herramientas que utilizas dentro de tu empresa, influencias la forma en la que funciona tu equipo. Necesitarás considerar cómo es que la migración de un flujo de trabajo desde tu sistema existente a {% data variables.product.prodname_actions %} afectará el trabajo diario de tus desarrolladores. -When you change the tools being used within your enterprise, you influence how your team works. You'll need to consider how moving a workflow from your existing systems to {% data variables.product.prodname_actions %} will affect your developers' day-to-day work. +Identifica cualquier proceso, integraciones y herramientas de terceros que se afectará con tu migración y haz un plan de cualquier actualización que necesites hacer. -Identify any processes, integrations, and third-party tools that will be affected by your migration, and make a plan for any updates you'll need to make. +Considera cómo la migración podría afectar tus inquietudes de cumplimiento. Por ejemplo, ¿acaso tus herramientas de análisis de seguridad y escaneo de credenciales existentes funcionarán con {% data variables.product.prodname_actions %} o necesitarás utilizar herramientas nuevas? -Consider how the migration may affect your compliance concerns. For example, will your existing credential scanning and security analysis tools work with {% data variables.product.prodname_actions %}, or will you need to use new tools? +Identifica las puertas y verificaciones en tu sistema existente y verifica que puedas implementarlas con {% data variables.product.prodname_actions %}. -Identify the gates and checks in your existing system and verify that you can implement them with {% data variables.product.prodname_actions %}. +### Identificar y validar las herramientas de migración -### Identifying and validating migration tools +Las herramientas de migración automatizadas pueden traducir los flujos de trabajo de tu empresa desde la sintaxis de sistema existente a aquella que requiere {% data variables.product.prodname_actions %}. Identifica las herramientas de terceros o contacta a tu representante dedicado o {% data variables.contact.contact_enterprise_sales %} para preguntar sobre las herramientas que puede proporcionar {% data variables.product.company_short %}. Por ejemplo, puedes usar {% data variables.product.prodname_actions_importer %} para planear, definir el ámbito y migrar las canalizaciones de CI a {% data variables.product.prodname_actions %} desde varios servicios admitidos. Para obtener más información, consulta "[Automatización de la migración con {% data variables.product.prodname_actions_importer %}](/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer)". -Automated migration tools can translate your enterprise's workflows from the existing system's syntax to the syntax required by {% data variables.product.prodname_actions %}. Identify third-party tooling or contact your dedicated representative or {% data variables.contact.contact_enterprise_sales %} to ask about tools that {% data variables.product.company_short %} can provide. For example, you can use the {% data variables.product.prodname_actions_importer %} to plan, scope, and migrate your CI pipelines to {% data variables.product.prodname_actions %} from various supported services. For more information, see "[Automating migration with {% data variables.product.prodname_actions_importer %}](/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer)." +Después de que hayas identificado una herramienta para automatizar tus migraciones, valídala ejecutándola en algunos flujos de trabajo de prueba y verifica que los resultados sean los esperados. -After you've identified a tool to automate your migrations, validate the tool by running the tool on some test workflows and verifying that the results are as expected. +Las herramientas automatizadas deberían poder migrar la mayoría de tus flujos de trabajo, pero es posible que necesites reescribir manualmente por lo menos un porcentaje pequeño de estos. Estima la cantidad de trabajo manual que necesitarás llevar a cabo. -Automated tooling should be able to migrate the majority of your workflows, but you'll likely need to manually rewrite at least a small percentage. Estimate the amount of manual work you'll need to complete. +### Decidir llevar a cabo un enfoque de migración -### Deciding on a migration approach +Determina el enfoque de migración que funcionará mejor para tu empresa. Los equipos más pequeños podrían ser capaces de migrar todos sus flujos de trabajo de una sola vez con un enfoque de tipo "quitar y reemplazar". Para las empresas más grandes, un enfoque iterativo podría ser más realista. Puedes elegir que un cuerpo central administre toda la migración o puedes pedirles a los equipos individuales que lo hagan ellos mismos y migren sus propios flujos de trabajo. -Determine the migration approach that will work best for your enterprise. Smaller teams may be able to migrate all their workflows at once, with a "rip-and-replace" approach. For larger enterprises, an iterative approach may be more realistic. You can choose to have a central body manage the entire migration or you can ask individual teams to self serve by migrating their own workflows. +Te recomendamos tener un enfoque iterativo que combine la administración activa con un autoservicio. Comience con un grupo pequeño de primeros participantes que actúen como campeones internos. Identifica un puñado de flujos de trabajo que sean suficientemente completos como para representar la amplitud de tu negocio. Trabaja con quienes primero adoptan esto para migrar esos flujos de trabajo a {% data variables.product.prodname_actions %}, iterando conforme sea necesario. Esto les dará a los otros equipos la confianza de que sus flujos de trabajo también pueden migrarse. -We recommend an iterative approach that combines active management with self service. Start with a small group of early adopters that can act as your internal champions. Identify a handful of workflows that are comprehensive enough to represent the breadth of your business. Work with your early adopters to migrate those workflows to {% data variables.product.prodname_actions %}, iterating as needed. This will give other teams confidence that their workflows can be migrated, too. +Posteriormente, haz que {% data variables.product.prodname_actions %} esté disponible para tu organización extendida. Proporciona recursos para ayudar a que estos equipos migren sus propios flujos de trabajo a {% data variables.product.prodname_actions %} e informa a los equipos cuando los sistemas existentes vayan a retirarse. -Then, make {% data variables.product.prodname_actions %} available to your larger organization. Provide resources to help these teams migrate their own workflows to {% data variables.product.prodname_actions %}, and inform the teams when the existing systems will be retired. +Finalmente, informa a todos los equipos que aún utilicen tus sistemas anteriores que deben completar sus migraciones en cierto tiempo. Puedes apuntar a los éxitos de otros equipos para asegurarles que la migración es posible y deseable. -Finally, inform any teams that are still using your old systems to complete their migrations within a specific timeframe. You can point to the successes of other teams to reassure them that migration is possible and desirable. +### Definir tu itinerario de migración -### Defining your migration schedule +Después de que decides tomar un enfoque de migración, crea un itinerario que defina cuándo cada uno de tus equipos migrarán sus flujos de trabajo a {% data variables.product.prodname_actions %}. -After you decide on a migration approach, build a schedule that outlines when each of your teams will migrate their workflows to {% data variables.product.prodname_actions %}. +Primero, decide la fecha en la que te gustaría completar tu migración. Por ejemplo, puedes planear completar tu migración en el momento en el que finalice tu contrato con tu proveedor actual. -First, decide the date you'd like your migration to be complete. For example, you can plan to complete your migration by the time your contract with your current provider ends. +Entonces, trabaja con tus equipos para crear un itinerario que cumpla con tu fecha límite sin sacrificar sus metas de equipo. Fíjate en la cadencia de tu negocio y en la carga de trabajo de cada equipo individual al que le pides migrarse. Coordínate con cada equipo para entender sus itinerarios de entrega y crea un plan que les permita migrar sus flujos de trabajo en un momento en el que no vaya a impactar su capacidad de entrega. -Then, work with your teams to create a schedule that meets your deadline without sacrificing their team goals. Look at your business's cadence and the workload of each individual team you're asking to migrate. Coordinate with each team to understand their delivery schedules and create a plan that allows the team to migrate their workflows at a time that won't impact their ability to deliver. +## Migrarse a {% data variables.product.prodname_actions %} -## Migrating to {% data variables.product.prodname_actions %} +Cuando estés listo para iniciar tu migración, traduce tus flujos existentes a {% data variables.product.prodname_actions %} utilizando las herramientas automatizadas y reescritura manual que ya planeaste para lo anterior. -When you're ready to start your migration, translate your existing workflows to {% data variables.product.prodname_actions %} using the automated tooling and manual rewriting you planned for above. +También podrías querer mantener artefactos de compilaciones anteriores de tu sistema existente, probablemente escribiendo un proceso con script para archivar los artefactos. -You may also want to maintain old build artifacts from your existing system, perhaps by writing a scripted process to archive the artifacts. +## Retirar los sistemas existentes -## Retiring existing systems +Después de que se complete tu migración, puedes pensar en retirar tu sistema existente. -After your migration is complete, you can think about retiring your existing system. +Tendrás que ejecutar ambos sistemas de lado a lado durante un tiempo mientras verificas que tu configuración de {% data variables.product.prodname_actions %} sea estable, sin delegación de experiencia para los desarrolladores. -You may want to run both systems side-by-side for some period of time, while you verify that your {% data variables.product.prodname_actions %} configuration is stable, with no degradation of experience for developers. - -Eventually, decommission and shut off the old systems, and ensure that no one within your enterprise can turn the old systems back on. +Con el tiempo, el retira y apaga los sistemas antiguos y asegúrate de que nadie en tu empresa los vuelva a activar. diff --git a/translations/es-ES/content/admin/guides.md b/translations/es-ES/content/admin/guides.md index cb6a32858c..523433c6fa 100644 --- a/translations/es-ES/content/admin/guides.md +++ b/translations/es-ES/content/admin/guides.md @@ -63,7 +63,7 @@ includeGuides: - /admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise - /admin/configuration/initializing-github-ae - /admin/configuration/network-ports - - /admin/configuration/restricting-network-traffic-to-your-enterprise + - /admin/configuration/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list - /admin/configuration/site-admin-dashboard - /admin/configuration/troubleshooting-ssl-errors - /admin/configuration/using-github-enterprise-server-with-a-load-balancer @@ -147,11 +147,11 @@ includeGuides: - /admin/user-management/suspending-and-unsuspending-users - /admin/overview/creating-an-enterprise-account - /admin/user-management/managing-organizations-in-your-enterprise/restoring-a-deleted-organization -ms.openlocfilehash: 832e990d9b1c30895fce286f1357ef540a96af6f -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 +ms.openlocfilehash: 88a0fe93a3c2784d81d81f91a3b1c0311cac84c7 +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/09/2022 -ms.locfileid: '147854128' +ms.lasthandoff: 11/22/2022 +ms.locfileid: '148180167' --- diff --git a/translations/es-ES/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise.md b/translations/es-ES/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise.md index c060a0b236..c17135c1fd 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise.md +++ b/translations/es-ES/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise.md @@ -1,7 +1,7 @@ --- -title: About authentication for your enterprise +title: Acerca de la autenticación para tu empresa shortTitle: About authentication -intro: 'You {% ifversion ghae %}must configure SAML single sign-on (SSO) so people can{% else %}can choose how people{% endif %} authenticate to access {% ifversion ghec %}your enterprise''s resources on {% data variables.product.product_name %}{% elsif ghes %}{% data variables.location.product_location %}{% elsif ghae %}your enterprise on {% data variables.product.product_name %}{% endif %}.' +intro: '{% ifversion ghae %}Debes configurar el inicio de sesión único (SSO) de SAML para que los usuarios se autentiquen{% else %}Puedes elegir la forma en que los usuarios se autentican{% endif %} para acceder a {% ifversion ghec %}los recursos de la empresa en {% data variables.product.product_name %}{% elsif ghes %}{% data variables.location.product_location %}{% elsif ghae %}la empresa en {% data variables.product.product_name %}{% endif %}.' versions: ghec: '*' ghes: '*' @@ -13,136 +13,140 @@ topics: - Enterprise - Identity - SSO +ms.openlocfilehash: 16b5bdd98e37db2eef6fe7e4e02da1a4ce8fd406 +ms.sourcegitcommit: 34d500fe45b362043b4b4685d6705a7bfb484d11 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/15/2022 +ms.locfileid: '148164376' --- - -## About authentication for your enterprise +## Acerca de la autenticación para tu empresa {% ifversion ghec %} -Enterprise owners on {% data variables.product.product_name %} can control the requirements for authentication and access to the enterprise's resources. +Los propietarios de la empresa en {% data variables.product.product_name %} pueden controlar los requisitos de autenticación y acceso a los recursos de la empresa. {% data reusables.enterprise.ghec-authentication-options %} -After learning more about these options, to determine which method is best for your enterprise, see "[Identifying the best authentication method for your enterprise](#identifying-the-best-authentication-method-for-your-enterprise)." +Después de obtener más información sobre estas opciones, para determinar qué método es mejor para tu empresa, consulta "[Identificación del mejor método de autenticación para la empresa](#identifying-the-best-authentication-method-for-your-enterprise)". -## Authentication methods for {% data variables.product.product_name %} +## Métodos de autenticación para {% data variables.product.product_name %} -The following options are available for account management and authentication on {% data variables.product.product_name %}. +Las siguientes opciones están disponibles para la administración de cuentas y la autenticación en {% data variables.product.product_name %}. -- [Authentication through {% data variables.location.product_location %}](#authentication-through-githubcom) -- [Authentication through {% data variables.location.product_location %} with additional SAML access restriction](#authentication-through-githubcom-with-additional-saml-access-restriction) -- [Authentication with {% data variables.product.prodname_emus %} and federation](#authentication-with-enterprise-managed-users-and-federation) +- [Autenticación a través de {% data variables.location.product_location %}](#authentication-through-githubcom) +- [Autenticación a través de {% data variables.location.product_location %} con restricción de acceso SAML adicional](#authentication-through-githubcom-with-additional-saml-access-restriction) +- [Autenticación con {% data variables.product.prodname_emus %} y federación](#authentication-with-enterprise-managed-users-and-federation) -### Authentication through {% data variables.location.product_location %} +### Autenticación a través de {% data variables.location.product_location %} -By default, each member must create a personal account on {% data variables.location.product_location %}. You grant access to your enterprise, and the member can access your enterprise's resources after signing into the account on {% data variables.location.product_location %}. The member manages the account, and can contribute to other enterprises, organizations, and repositories on {% data variables.location.product_location %}. +De forma predeterminada, cada miembro debe crear una cuenta personal en {% data variables.location.product_location %}. Concedes acceso a tu empresa y el miembro puede acceder a los recursos de esta después de iniciar sesión en la cuenta en {% data variables.location.product_location %}. El miembro administra la cuenta y puede contribuir a otras empresas, organizaciones y repositorios en {% data variables.location.product_location %}. -### Authentication through {% data variables.location.product_location %} with additional SAML access restriction +### Autenticación a través de {% data variables.location.product_location %} con restricción de acceso SAML adicional -If you configure additional SAML access restriction, each member must create and manage a personal account on {% data variables.location.product_location %}. You grant access to your enterprise, and the member can access your enterprise's resources after both signing into the account on {% data variables.location.product_location %} and successfully authenticating with your SAML identity provider (IdP). The member can contribute to other enterprises, organizations, and repositories on {% data variables.location.product_location %} using their personal account. For more information about requiring SAML authentication for all access your enterprise's resources, see "[About SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam)." +Si configuras una restricción de acceso SAML adicional, cada miembro debe crear y administrar una cuenta personal en {% data variables.location.product_location %}. Concedes acceso a la empresa y el miembro puede acceder a los recursos de esta después de iniciar sesión en la cuenta en {% data variables.location.product_location %} y autenticarse correctamente con el proveedor de identidades (IdP) de SAML. El miembro puede contribuir en otras empresas, organizaciones y repositorios en {% data variables.location.product_location %} mediante su cuenta personal. Para obtener más información sobre cómo requerir autenticación SAML para todos los recursos de la empresa, consulta "[Acerca de SAML para IAM empresarial](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam)". -If you use a standalone organization with {% data variables.product.product_name %}, or if you don't want to use SAML authentication for every organization in your enterprise, you can configure SAML for an individual organization. For more information, see "[About identity and access management with SAML single sign-on](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)." +Si usas una organización independiente con {% data variables.product.product_name %}, o si no deseas usar la autenticación SAML para cada organización de la empresa, puedes configurar SAML para una organización individual. Para más información, vea "[Acerca de la administración de identidades y acceso con el inicio de sesión único de SAML](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)". -### Authentication with {% data variables.product.prodname_emus %} and federation +### Autenticación con {% data variables.product.prodname_emus %} y federación -If you need more control of the accounts for your enterprise members on {% data variables.location.product_location %}, you can use {% data variables.product.prodname_emus %}. With {% data variables.product.prodname_emus %}, you provision and manage accounts for your enterprise members on {% data variables.location.product_location %} using your IdP. Each member signs into an account that you create, and your enterprise manages the account. Contributions to the rest of {% data variables.product.prodname_dotcom_the_website %} are restricted. For more information, see "[About {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users)." +Si necesitas más control de las cuentas de los miembros de la empresa en {% data variables.location.product_location %}, puedes usar {% data variables.product.prodname_emus %}. Con {% data variables.product.prodname_emus %}, aprovisionas y administras cuentas para los miembros de la empresa en {% data variables.location.product_location %} mediante el IdP. Cada miembro inicia sesión en una cuenta que creas y la empresa la administra. Las contribuciones al resto de {% data variables.product.prodname_dotcom_the_website %} están restringidas. Para más información, vea "[Acerca de {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users)". -## Identifying the best authentication method for your enterprise +## Identificación del mejor método de autenticación para la empresa -Both SAML SSO and {% data variables.product.prodname_emus %} increase security for your enterprise's resources. {% data variables.product.prodname_emus %} additionally allows you to control the user accounts for your enterprise members and restricts what the accounts are able to do. However, those restrictions may be unacceptable for your enterprise if they obstruct your developers' workflows. +Tanto el inicio de sesión único de SAML como {% data variables.product.prodname_emus %} aumentan la seguridad de los recursos de la empresa. Además, {% data variables.product.prodname_emus %} permite controlar las cuentas de usuario de los miembros de la empresa y restringe lo que pueden hacer las cuentas. Pero estas restricciones pueden ser inaceptables para tu empresa si obstruyen los flujos de trabajo de los desarrolladores. -To determine whether your enterprise would benefit more from SAML SSO or {% data variables.product.prodname_emus %}, ask yourself these questions. +Para determinar si tu empresa se beneficiaría más del inicio de sesión único de SAML o de {% data variables.product.prodname_emus %}, hazte estas preguntas. -- [Do you want to control the user accounts for your users?](#do-you-want-to-control-the-user-accounts-for-your-users) -- [Which identity provider does your enterprise use?](#which-identity-provider-does-your-enterprise-use) -- [Do your developers work in public repositories, gists, or {% data variables.product.prodname_pages %} sites?](#do-your-developers-work-in-public-repositories-gists-or-github-pages-sites) -- [Do your developers rely on collaboration outside of your enterprise?](#do-your-developers-rely-on-collaboration-outside-of-your-enterprise) -- [Does your enterprise rely on outside collaborators?](#does-your-enterprise-rely-on-outside-collaborators) -- [Can your enterprise tolerate migration costs?](#can-your-enterprise-tolerate-migration-costs) +- [¿Quieres controlar las cuentas de los usuarios?](#do-you-want-to-control-the-user-accounts-for-your-users) +- [¿Qué proveedor de identidades usa tu empresa?](#which-identity-provider-does-your-enterprise-use) +- [¿Los desarrolladores trabajan en repositorios públicos, gists o sitios de {% data variables.product.prodname_pages %}?](#do-your-developers-work-in-public-repositories-gists-or-github-pages-sites) +- [¿Los desarrolladores se basan en colaboraciones fuera de la empresa?](#do-your-developers-rely-on-collaboration-outside-of-your-enterprise) +- [¿La empresa depende de colaboradores externos?](#does-your-enterprise-rely-on-outside-collaborators) +- [¿Puede la empresa tolerar costes de migración?](#can-your-enterprise-tolerate-migration-costs) -### Do you want to control the user accounts for your users? +### ¿Quieres controlar las cuentas de los usuarios? -{% data variables.product.prodname_emus %} may be right for your enterprise if you don't want enterprise members to use their own personal accounts on {% data variables.product.prodname_dotcom_the_website %} to access your enterprise's resources. +{% data variables.product.prodname_emus %} puede ser adecuado para tu empresa si no quieres que los miembros de la empresa usen sus cuentas personales en {% data variables.product.prodname_dotcom_the_website %} para acceder a los recursos de la empresa. -With SAML SSO, developers create and manage their own personal accounts, and each account is linked to a SAML identity in your IdP. {% data variables.product.prodname_emus %} functions more like other familiar SSO solutions, as you will provision the accounts for your users. You can also ensure user accounts conform with your company identity, by controlling usernames and the email addresses associated with the accounts. +Con el inicio de sesión único de SAML, los desarrolladores crean y administran sus cuentas personales y cada cuenta está vinculada a una identidad de SAML en el IdP. {% data variables.product.prodname_emus %} funciona más bien como otras soluciones de inicio de sesión único conocidas, ya que serás tú quien aprovisione las cuentas de los usuarios. También puedes asegurarte de que las cuentas de usuario se adapten a la identidad de la empresa si controlas los nombres de usuario y las direcciones de correo electrónico asociadas a las cuentas. -If you currently require your users to create a new account on {% data variables.product.prodname_dotcom_the_website %} to use with your enterprise only, {% data variables.product.prodname_emus %} might be right for you. However, SAML SSO may be a better option if using your IdP as the source of truth for your user and access management would add too much complexity. For example, perhaps your enterprise does not have an established process for onboarding new users in your IdP. +Si actualmente obligas a los usuarios a crear una cuenta en {% data variables.product.prodname_dotcom_the_website %} para usarla solo con tu empresa, probablemente {% data variables.product.prodname_emus %} sea una solución adecuada para ti. En cambio, el inicio de sesión único de SAML puede ser una opción mejor si usas el IdP como origen de confianza para el usuario y si la administración de acceso agrega demasiada complejidad. Por ejemplo, quizás tu empresa no tenga un proceso establecido para incorporar nuevos usuarios en el IdP. -### Which identity provider does your enterprise use? +### ¿Qué proveedor de identidades usa tu empresa? -{% data variables.product.prodname_emus %} is supported for a limited number of IdPs, while SAML SSO offers full support for a larger number of IdPs, plus limited support for all IdPs that implement the SAML 2.0 standard. For the list of supported IdPs for each option, see "[About {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#identity-provider-support)" and "[About SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam#supported-idps)." +{% data variables.product.prodname_emus %} se admite para un número limitado de IdP, mientras que el inicio de sesión único de SAML ofrece compatibilidad completa con un mayor número de IdP, así como compatibilidad limitada con todos los IdP que implementan el estándar SAML 2.0. Para ver la lista de IdP admitidos para cada opción, consulta "[Acerca de {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#identity-provider-support)" y "[Acerca de SAML para IAM empresarial](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam#supported-idps)". -You can use {% data variables.product.prodname_emus %} with an unsupported IdP only if you federate the unsupported IdP to a supported IdP to use as an integration point. If you wish to avoid this extra complexity, SAML SSO may be a better solution for you. +Puedes usar {% data variables.product.prodname_emus %} con un IdP no admitido solo si federas el IdP no admitido en un IdP compatible para usarlo como punto de integración. Si quieres evitar esta complejidad adicional, el inicio de sesión único de SAML puede ser una mejor solución para ti. -### Do your developers work in public repositories, gists, or {% data variables.product.prodname_pages %} sites? +### ¿Los desarrolladores trabajan en repositorios públicos, gists o sitios de {% data variables.product.prodname_pages %}? -To prevent enterprise members from accidentally leaking corporate-owned content to the public on {% data variables.product.prodname_dotcom_the_website %}, {% data variables.product.prodname_emus %} imposes strong restrictions on what users can do. For example, {% data variables.enterprise.prodname_managed_users %} cannot create public repositories, gists of any visibility, or {% data variables.product.prodname_pages %} sites that are visible outside the enterprise. For a full list of restrictions, see "[Abilities and restrictions of {% data variables.enterprise.prodname_managed_users %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#abilities-and-restrictions-of-managed-users)." +Para impedir que los miembros de la empresa filtren accidentalmente al público contenido corporativo en {% data variables.product.prodname_dotcom_the_website %}, {% data variables.product.prodname_emus %} impone restricciones rigurosas a lo que pueden hacer los usuarios. Por ejemplo, las {% data variables.enterprise.prodname_managed_users %} no pueden crear repositorios públicos, gists con ningún tipo de visibilidad o sitios de {% data variables.product.prodname_pages %} que sean visibles fuera de la empresa. Para ver una lista completa de restricciones, consulta "[Capacidades y restricciones de las {% data variables.enterprise.prodname_managed_users %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#abilities-and-restrictions-of-managed-users)". -These restrictions are unacceptable for some enterprises. To determine whether {% data variables.product.prodname_emus %} will work for you, review the restrictions with your developers, and confirm whether any of the restrictions will hinder your existing workflows. If so, SAML SSO may be a better choice for your enterprise. +Estas restricciones son inaceptables para algunas empresas. Para determinar si {% data variables.product.prodname_emus %} es una opción adecuada para ti, revisa las restricciones con los desarrolladores y confirma si alguna de ellas dificultará los flujos de trabajo existentes. Si es así, el inicio de sesión único de SAML puede ser una mejor opción para tu empresa. -### Do your developers rely on collaboration outside of your enterprise? +### ¿Los desarrolladores se basan en colaboraciones fuera de la empresa? -{% data variables.enterprise.prodname_managed_users_caps %} can only contribute to repositories within your enterprise. If your developers must contribute to both repositories within and outside of your enterprise, including private repositories, {% data variables.product.prodname_emus %} may not be right for your enterprise. SAML SSO may be a better solution. +Las {% data variables.enterprise.prodname_managed_users_caps %} solo puede contribuir en repositorios de dentro de la empresa. Si los desarrolladores deben contribuir a repositorios dentro y fuera de la empresa, incluidos los repositorios privados, es posible que {% data variables.product.prodname_emus %} no sea adecuado para la empresa. El inicio de sesión único de SAML puede ser una mejor solución. -Some companies maintain repositories within an existing enterprise using SAML SSO on {% data variables.location.product_location %}, and also create an {% data variables.enterprise.prodname_emu_enterprise %}. Developers who contribute to repositories owned by both enterprises from a single workstation must switch between the accounts on {% data variables.location.product_location %} within a single browser, or use a different browser for each account. The developer may also need to customize the workstation's Git configuration to accommodate the two accounts. The complexity of this workflow can increase the risk of mistakenly leaking internal code to the public. +Algunas compañías mantienen repositorios en una empresa existente mediante el inicio de sesión único de SAML en {% data variables.location.product_location %}, y también crean una {% data variables.enterprise.prodname_emu_enterprise %}. Los desarrolladores que contribuyen a los repositorios que pertenecen a ambas empresas desde una única estación de trabajo deben cambiar entre las cuentas de {% data variables.location.product_location %} en un solo explorador, o bien usar un explorador diferente con cada cuenta. Es posible que el desarrollador también tenga que personalizar la configuración de Git de la estación de trabajo para dar cabida a las dos cuentas. La complejidad de este flujo de trabajo puede aumentar el riesgo de filtrar código interno al público de forma accidental. -If you decide to create an {% data variables.enterprise.prodname_emu_enterprise %} but require that developers contribute to resources outside of the enterprise from a single workstation, you can provide support for switching between the accounts in a developer's local Git configuration. For more information, see "[About {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users#supporting-developers-with-multiple-user-accounts-on-githubcom)." +Si decides crear una {% data variables.enterprise.prodname_emu_enterprise %}, pero requieres que los desarrolladores contribuyan en los recursos fuera de la empresa desde una única estación de trabajo, puedes proporcionar compatibilidad para cambiar entre las cuentas en la configuración de Git local de un desarrollador. Para más información, vea "[Acerca de {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users#supporting-developers-with-multiple-user-accounts-on-githubcom)". -### Does your enterprise rely on outside collaborators? +### ¿La empresa depende de colaboradores externos? -With SAML SSO, you can give access to specific repositories to people who are not members of your IdP's directory, by using the outside collaborator role. This can be especially useful for collaborators that are external to your business, such as contractors. For more information, see "[Adding outside collaborators to repositories in your organization](/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization)." +Con el inicio de sesión único de SAML, puedes conceder acceso a repositorios específicos a personas que no son miembros del directorio del IdP mediante el rol de colaborador externo. Esto puede ser especialmente útil para colaboradores externos del negocio, como contratistas. Para obtener más información, consulta "[Incorporación de colaboradores externos a repositorios de la organización](/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization)". -With {% data variables.product.prodname_emus %}, the outside collaborator role does not exist. Your enterprise's resources can only be accessed by {% data variables.enterprise.prodname_managed_users %}, which are always provisioned by your IdP. To give external collaborators access to your enterprise, you would have to use guest accounts in your IdP. If you're interested in {% data variables.product.prodname_emus %}, confirm with your developers whether this will hinder any of their existing workflows. If so, SAML SSO may be a better solution. +Con {% data variables.product.prodname_emus %}, el rol de colaborador externo no existe. Solo se puede acceder a los recursos de la empresa mediante {% data variables.enterprise.prodname_managed_users %}, que siempre aprovisiona el IdP. Para conceder a los colaboradores externos acceso a tu empresa, tendrías que usar cuentas de invitado en el IdP. Si la opción de {% data variables.product.prodname_emus %} te interesa, consulta a los desarrolladores si será un obstáculo para alguno de sus flujos de trabajo existentes. Si es así, el inicio de sesión único de SAML puede ser una mejor solución. -### Can your enterprise tolerate migration costs? +### ¿Puede la empresa tolerar costes de migración? -If your enterprise is new to {% data variables.product.prodname_dotcom_the_website %}, SAML SSO and {% data variables.product.prodname_emus %} are equally easy to adopt. +Si la empresa no está familiarizada con {% data variables.product.prodname_dotcom_the_website %}, el inicio de sesión único de SAML y {% data variables.product.prodname_emus %} son igual de fáciles de adoptar. -If you're already using {% data variables.product.prodname_dotcom_the_website %} with developers managing their own user accounts, adopting {% data variables.product.prodname_emus %} requires migrating to a new enterprise account. For more information, see "[About enterprises with {% data variables.enterprise.prodname_managed_users %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#about-enterprises-with-managed-users)." +Si ya usas {% data variables.product.prodname_dotcom_the_website %} y los desarrolladores administran sus cuentas de usuario, la adopción de {% data variables.product.prodname_emus %} requiere la migración a una nueva cuenta empresarial. Para obtener más información, consulta "[Acerca de las empresas con {% data variables.enterprise.prodname_managed_users %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#about-enterprises-with-managed-users)". -Although {% data variables.product.prodname_emus %} is free, the migration process may require time or cost from your team. Confirm that this migration process is acceptable to your business and your developers. If not, SAML SSO may be the better choice for you. +Aunque el uso de {% data variables.product.prodname_emus %} es gratuito, el proceso de migración puede requerir tiempo o imponer costes al equipo. Confirma que este proceso de migración es aceptable para la empresa y los desarrolladores. Si no es así, el inicio de sesión único de SAML puede ser la mejor opción. {% elsif ghes %} -Site administrators can decide how people authenticate to access a {% data variables.product.product_name %} instance. You can use {% data variables.product.product_name %}'s built-in authentication, or, if you want to centralize identity and access management for the web applications that your team uses, you can configure an external authentication method. +Los administradores del sitio pueden decidir cómo se autentican los usuarios para acceder a una instancia de {% data variables.product.product_name %}. Puedes usar la autenticación integrada de {% data variables.product.product_name %}, o bien, si quieres centralizar la administración de identidades y acceso para las aplicaciones web que usa el equipo, puedes configurar un método de autenticación externo. -## Authentication methods for {% data variables.product.product_name %} +## Métodos de autenticación para {% data variables.product.product_name %} -The following authentication methods are available for {% data variables.product.product_name %}. +Los siguientes métodos de autenticación están disponibles para {% data variables.product.product_name %}. -- [Built-in authentication](#built-in-authentication) -- [External authentication](#external-authentication) +- [Autenticación integrada](#built-in-authentication) +- [Autenticación externa](#external-authentication) -### Built-in authentication +### Autenticación integrada -{% data reusables.enterprise_user_management.built-in-authentication-new-accounts %} To access your instance, people authenticate with the credentials for the account. For more information, see "[Configuring built-in authentication](/admin/identity-and-access-management/using-built-in-authentication/configuring-built-in-authentication)." +{% data reusables.enterprise_user_management.built-in-authentication-new-accounts %} Para acceder a la instancia, los usuarios se autentican con las credenciales de la cuenta. Para obtener más información, consulta "[Configuración de la autenticación integrada](/admin/identity-and-access-management/using-built-in-authentication/configuring-built-in-authentication)". -### External authentication +### Autenticación externa -If you use an external directory or identity provider (IdP) to centralize access to multiple web applications, you may be able to configure external authentication for {% data variables.location.product_location %}. For more information, see the following articles. +Si usas un directorio externo o un proveedor de identidades (IdP) para centralizar el acceso a varias aplicaciones web, es posible que puedas configurar la autenticación externa para {% data variables.location.product_location %}. Para obtener más información, consulte los siguientes artículos. -- "[Using CAS for enterprise IAM](/admin/identity-and-access-management/using-cas-for-enterprise-iam)" -- "[Using LDAP for enterprise IAM](/admin/identity-and-access-management/using-ldap-for-enterprise-iam)" -- "[Using SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam)" +- "[Uso de CAS para IAM empresarial](/admin/identity-and-access-management/using-cas-for-enterprise-iam)" +- "[Uso de LDAP para IAM empresarial](/admin/identity-and-access-management/using-ldap-for-enterprise-iam)" +- "[Uso de SAML para IAM empresarial](/admin/identity-and-access-management/using-saml-for-enterprise-iam)" -If you choose to use external authentication, you can also configure fallback authentication for people who don't have an account on your external authentication provider. For example, you may want to grant access to a contractor or machine user. For more information, see "[Allowing built-in authentication for users outside your provider](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider)." +Si decides usar la autenticación externa, también puedes configurar la autenticación de reserva para los usuarios que no tienen una cuenta en el proveedor de autenticación externo. Por ejemplo, puede que desees conceder acceso a un contratista o usuario de máquina. Para obtener más información, consulta "[Permiso para la autenticación integrada para usuarios fuera del proveedor](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider)". {% ifversion scim-for-ghes %} -If you use SAML SSO for authentication, you can also provision users and map IdP groups to teams using SCIM. For more information, see "[Configuring user provisioning with SCIM for your enterprise](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise)." +Si usas el inicio de sesión único de SAML para la autenticación, también puedes aprovisionar usuarios y asignar grupos de IdP a equipos mediante SCIM. Para obtener más información, consulta "[Configuración del aprovisionamiento de usuarios con SCIM para la empresa](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise)". {% endif %} {% elsif ghae %} -{% data variables.product.product_name %} uses SAML SSO for authentication. Enterprise owners must configure SAML SSO with a SAML identity provider (IdP) during initialization. For more information, see "[About SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam)." +{% data variables.product.product_name %} utiliza el SSO de SAML para la autenticación. Los propietarios de empresas deben configurar el SSO de SAML con un proveedor de identidades (IdP) de SAML durante la inicialización. Para obtener más información, consulta "[Acerca de SAML para IAM empresarial](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam)". {% endif %} -## Further reading +## Información adicional -- "[Types of {% data variables.product.company_short %} accounts](/get-started/learning-about-github/types-of-github-accounts)" -- "[About enterprise accounts](/admin/overview/about-enterprise-accounts)" -{%- ifversion ghec %} -- "[Can I create accounts for people in my organization?](/organizations/managing-membership-in-your-organization/can-i-create-accounts-for-people-in-my-organization)" +- "[Tipos de cuentas {% data variables.product.company_short %}](/get-started/learning-about-github/types-of-github-accounts)" +- "[Acerca de las cuentas de empresa](/admin/overview/about-enterprise-accounts)" {%- ifversion ghec %} +- "[¿Puedo crear cuentas para personas en mi organización?](/organizations/managing-membership-in-your-organization/can-i-create-accounts-for-people-in-my-organization)" {% endif %} diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md index b5da6d4240..59f87dab08 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md @@ -1,7 +1,7 @@ --- -title: 'Acerca de {% data variables.product.prodname_emus %}' +title: About {% data variables.product.prodname_emus %} shortTitle: About managed users -intro: 'Puedes administrar centralmente la identidad y el acceso para los miembros de tu empresa en {% data variables.product.prodname_dotcom %} desde tu proveedor de identidad.' +intro: 'You can centrally manage identity and access for your enterprise members on {% data variables.product.prodname_dotcom %} from your identity provider.' redirect_from: - /early-access/github/articles/get-started-with-managed-users-for-your-enterprise - /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users @@ -17,55 +17,50 @@ topics: - Enterprise - SSO allowTitleToDifferFromFilename: true -ms.openlocfilehash: 82a8b8c29ea38d57f0481146f2a857c2dcba8413 -ms.sourcegitcommit: d82f268a6f0236d1f4d2bf3d049974ada0170402 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 11/10/2022 -ms.locfileid: '148160732' --- -## Acerca de {% data variables.product.prodname_emus %} -Con {% data variables.product.prodname_emus %}, puedes controlar las cuentas de usuario de los miembros de tu empresa a través de tu proveedor de identidad (IdP). Los usuarios que se asignen a la aplicación de {% data variables.product.prodname_emu_idp_application %} en tu IdP se aprovisionarán como cuentas de usuario nuevas en {% data variables.product.prodname_dotcom %} y se agregarán a tu empresa. Tú controlas los nombres de usuario, los datos de perfil, la pertenencia del equipo y el acceso de las cuentas de usuario al repositorio desde tu IdP. +## About {% data variables.product.prodname_emus %} -En tu IdP, puedes dar a cada {% data variables.enterprise.prodname_managed_user %} el rol de usuario, propietario de la empresa o gerente de facturación. {% data variables.enterprise.prodname_managed_users_caps %} puede ser propietario de organizaciones dentro de tu empresa y puede agregar a otros {% data variables.enterprise.prodname_managed_users %} a las organizaciones y equipos dentro de ella. Para obtener más información, vea "[Roles en una empresa](/github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise/roles-in-an-enterprise)" y "[Acerca de las organizaciones](/organizations/collaborating-with-groups-in-organizations/about-organizations)". +With {% data variables.product.prodname_emus %}, you can control the user accounts of your enterprise members through your identity provider (IdP). Users assigned to the {% data variables.product.prodname_emu_idp_application %} application in your IdP are provisioned as new user accounts on {% data variables.product.prodname_dotcom %} and added to your enterprise. You control usernames, profile data, team membership, and repository access for the user accounts from your IdP. + +In your IdP, you can give each {% data variables.enterprise.prodname_managed_user %} the role of user, enterprise owner, or billing manager. {% data variables.enterprise.prodname_managed_users_caps %} can own organizations within your enterprise and can add other {% data variables.enterprise.prodname_managed_users %} to the organizations and teams within. For more information, see "[Roles in an enterprise](/github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise/roles-in-an-enterprise)" and "[About organizations](/organizations/collaborating-with-groups-in-organizations/about-organizations)." {% ifversion oidc-for-emu %} -{% data reusables.enterprise-accounts.emu-cap-validates %} Para obtener más información, consulta "[Acerca de la compatibilidad con la directiva de acceso condicional del IdP](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy)". +{% data reusables.enterprise-accounts.emu-cap-validates %} For more information, see "[About support for your IdP's Conditional Access Policy](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy)." {% endif %} -Puedes conceder acceso a los {% data variables.enterprise.prodname_managed_users %} a repositorios de la empresa, así como la capacidad de contribuir en ellos, pero los {% data variables.enterprise.prodname_managed_users %} no pueden crear contenido público ni colaborar con otros usuarios, organizaciones y empresas del resto de {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta "[Habilidades y restricciones de los {% data variables.enterprise.prodname_managed_users %}](#abilities-and-restrictions-of-enterprise-managed-users)". +You can grant {% data variables.enterprise.prodname_managed_users %} access to and the ability to contribute to repositories within your enterprise, but {% data variables.enterprise.prodname_managed_users %} cannot create public content or collaborate with other users, organizations, and enterprises on the rest of {% data variables.product.prodname_dotcom %}. For more information, see "[Abilities and restrictions of {% data variables.enterprise.prodname_managed_users %}](#abilities-and-restrictions-of-enterprise-managed-users)." -El nombre de usuario de los {% data variables.enterprise.prodname_managed_users %} de tu empresa y su información de perfil, como los nombres y direcciones de correo electrónico que se muestran, se configuran mediante tu IdP y no pueden cambiarlos los propios usuarios. Para más información, vea "[Nombres de usuario e información de perfil](#usernames-and-profile-information)". +The usernames of your enterprise's {% data variables.enterprise.prodname_managed_users %} and their profile information, such as display names and email addresses, are set by through your IdP and cannot be changed by the users themselves. For more information, see "[Usernames and profile information](#usernames-and-profile-information)." -Los propietarios de las empresas pueden auditar todas las acciones de los {% data variables.enterprise.prodname_managed_users %} en {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta "[Eventos del registro de auditoría para la empresa](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise#about-audit-log-events-for-your-enterprise)". +Enterprise owners can audit all of the {% data variables.enterprise.prodname_managed_users %}' actions on {% data variables.product.prodname_dotcom %}. For more information, see "[Audit log events for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise#about-audit-log-events-for-your-enterprise)." -Para utilizar los {% data variables.product.prodname_emus %}, necesitas un tipo separado de cuenta empresarial con {% data variables.product.prodname_emus %} habilitados. Para obtener más información sobre cómo crear esta cuenta, consulte "[Acerca de las empresas con usuarios administrados](#about-enterprises-with-managed-users)". +To use {% data variables.product.prodname_emus %}, you need a separate type of enterprise account with {% data variables.product.prodname_emus %} enabled. For more information about creating this account, see "[About enterprises with managed users](#about-enterprises-with-managed-users)." {% note %} -**Nota**: Hay varias opciones para la administración de identidades y acceso con {% data variables.product.prodname_ghe_cloud %}, y la solución de {% data variables.product.prodname_emus %} no es la mejor para todos los clientes. Para obtener más información que te ayude a decidir si la opción de {% data variables.product.prodname_emus %} es adecuada para tu empresa, consulta "[Acerca de la autenticación de la empresa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#identifying-the-best-authentication-method-for-your-enterprise)". +**Note:** There are multiple options for identity and access management with {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_emus %} is not the best solution for every customer. For more information about whether {% data variables.product.prodname_emus %} is right for your enterprise, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#identifying-the-best-authentication-method-for-your-enterprise)." {% endnote %} -## Acerca de la administración de la pertenencia a una organización +## About organization membership management -Las pertenencias a una organización se pueden administrar manualmente o bien las puedes actualizar automáticamente mediante grupos de IdP. Para administrar las pertenencias a la organización mediante el IdP, los miembros deben agregarse a un grupo de IdP y este grupo debe estar conectado a un equipo en la organización. Para obtener más información sobre la administración automática de la organización y las pertenencias a equipos, consulta "[Administración de las pertenencias a equipos con grupos de proveedores de identidades](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/managing-team-memberships-with-identity-provider-groups)". +Organization memberships can be managed manually, or you can update memberships automatically using IdP groups. To manage organization memberships through your IdP, the members must be added to an IdP group, and the IdP group must be connected to a team within the organization. For more information about managing organization and team memberships automatically, see "[Managing team memberships with identity provider groups](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/managing-team-memberships-with-identity-provider-groups)." -La forma en que se agrega un miembro a una organización propiedad de tu empresa (mediante grupos de IdP o manualmente) determina cómo se deben quitar de una organización. +The way a member is added to an organization owned by your enterprise (through IdP groups or manually) determines how they must be removed from an organization. -- Si un miembro se agregó a una organización manualmente, debes quitarlo manualmente. La anulación de la asignación de la aplicación de {% data variables.product.prodname_emu_idp_application %} en tu IdP suspenderá al usuario pero no lo eliminará de la organización. -- Si un usuario se convirtió en miembro de una organización porque se agregó a grupos de IdP asignados a uno o varios equipos de la organización, quitarlo de _todos_ los grupos de IdP asignados asociados a la organización hará que se quite de la organización. +- If a member was added to an organization manually, you must remove them manually. Unassigning them from the {% data variables.product.prodname_emu_idp_application %} application on your IdP will suspend the user but not remove them from the organization. +- If a user became a member of an organization because they were added to IdP groups mapped to one or more teams in the organization, removing them from _all_ of the mapped IdP groups associated with the organization will remove them from the organization. -Para descubrir cómo se agregó un miembro a una organización, puedes filtrar la lista de miembros por tipo. Para más información, vea "[Visualización de personas en la empresa](/admin/user-management/managing-users-in-your-enterprise/viewing-people-in-your-enterprise#filtering-by-member-type-in-an-enterprise-with-managed-users)". +To discover how a member was added to an organization, you can filter the member list by type. For more information, see "[Viewing people in your enterprise](/admin/user-management/managing-users-in-your-enterprise/viewing-people-in-your-enterprise#filtering-by-member-type-in-an-enterprise-with-managed-users)." -## Soporte del proveedor de identidad +## Identity provider support -{% data variables.product.prodname_emus %} admite los siguientes IdP{% ifversion oidc-for-emu %} y métodos de autenticación: +{% data variables.product.prodname_emus %} supports the following IdPs{% ifversion oidc-for-emu %} and authentication methods: -| | SAML | OIDC (beta) | +| | SAML | OIDC | |----------------------------------|-----------------------------------------------|-----------------------------------------------| | Azure Active Directory | {% octicon "check" aria-label="Check icon" %} | {% octicon "check" aria-label="Check icon" %} | | Okta | {% octicon "check" aria-label="Check icon" %} | | @@ -75,36 +70,36 @@ Para descubrir cómo se agregó un miembro a una organización, puedes filtrar l {% endif %} -## Habilidades y restricciones de los {% data variables.enterprise.prodname_managed_users %} +## Abilities and restrictions of {% data variables.enterprise.prodname_managed_users %} -Los {% data variables.enterprise.prodname_managed_users_caps %} solo pueden colaborar en los repositorios privados e internos en su empresa y con los repositorios que pertenecen a su cuenta de usuario. Los {% data variables.enterprise.prodname_managed_users_caps %} tienen acceso de solo lectura al resto de la comunidad de {% data variables.product.prodname_dotcom %}. Estas restricciones de visibilidad y acceso para los usuarios, así como el contenido, aplican a todas las solicitudes, incluyendo a las de la API. +{% data variables.enterprise.prodname_managed_users_caps %} can only contribute to private and internal repositories within their enterprise and private repositories owned by their user account. {% data variables.enterprise.prodname_managed_users_caps %} have read-only access to the wider {% data variables.product.prodname_dotcom %} community. These visibility and access restrictions for users and content apply to all requests, including API requests. -* No se puede invitar a {% data variables.enterprise.prodname_managed_users_caps %} para que se unan a organizaciones o repositorios de fuera de la empresa, ni se puede invitar a {% data variables.enterprise.prodname_managed_users %} a otras empresas. -* Los colaboradores externos no son compatibles con los {% data variables.product.prodname_emus %}. -* Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden crear incidencias ni solicitudes de incorporación de cambios, comentar o agregar reacciones, ni marcar como favoritos u observar o bifurcar repositorios fuera de la empresa. -* Los {% data variables.enterprise.prodname_managed_users_caps %} pueden ver todos los repositorios públicos en {% data variables.product.prodname_dotcom_the_website %} pero no pueden insertar código a los repositorios fuera de la empresa. -* Solo otros miembros de la empresa pueden ver a los {% data variables.enterprise.prodname_managed_users_caps %} y el contenido que estos crean. -* Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden seguir a usuarios que estén fuera de la empresa. -* Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden crear gists o comentar en ellos. -* Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden crear flujos de trabajo de inicio para {% data variables.product.prodname_actions %}. -* Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden instalar {% data variables.product.prodname_github_apps %} en sus cuentas de usuario. -* Otros usuarios de {% data variables.product.prodname_dotcom %} no pueden ver, mencionar o invitar a {% data variables.enterprise.prodname_managed_user %} para colaborar. -* Puedes elegir si los {% data variables.enterprise.prodname_managed_users %} pueden crear repositorios propiedad de sus cuentas de usuario. Para más información, vea "[Aplicación de directivas de administración de repositorios en la empresa](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-repository-creation)". -* Si permites que {% data variables.enterprise.prodname_managed_users %} creen repositorios propiedad de sus cuentas de usuario, solo pueden poseer repositorios privados y únicamente pueden invitar a otros miembros de la empresa a colaborar en los repositorios propiedad del usuario. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot be invited to organizations or repositories outside of the enterprise, nor can the {% data variables.enterprise.prodname_managed_users %} be invited to other enterprises. +* Outside collaborators are not supported by {% data variables.product.prodname_emus %}. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot create issues or pull requests in, comment or add reactions to, nor star, watch, or fork repositories outside of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} can view all public repositories on {% data variables.product.prodname_dotcom_the_website %}, but cannot push code to repositories outside of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} and the content they create is only visible to other members of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot follow users outside of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot create gists or comment on gists. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot create starter workflows for {% data variables.product.prodname_actions %}. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot install {% data variables.product.prodname_github_apps %} on their user accounts. +* Other {% data variables.product.prodname_dotcom %} users cannot see, mention, or invite a {% data variables.enterprise.prodname_managed_user %} to collaborate. +* You can choose whether {% data variables.enterprise.prodname_managed_users %} are able to create repositories owned by their user accounts. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-repository-creation)." +* If you allow {% data variables.enterprise.prodname_managed_users %} to create repositories owned by their user accounts, they can only own private repositories and can only invite other enterprise members to collaborate on their user-owned repositories. * {% data reusables.enterprise-accounts.emu-forks %} -* Solo se pueden crear repositorios internos y privados en las organizaciones que pertenezcan a una {% data variables.enterprise.prodname_emu_enterprise %}, en función de la configuración de visibilidad del repositorio o la empresa. -* Los {% data variables.enterprise.prodname_managed_users_caps %} están limitados en su uso de {% data variables.product.prodname_pages %}. Para obtener más información, consulta [Acerca de {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users). +* Only private and internal repositories can be created in organizations owned by an {% data variables.enterprise.prodname_emu_enterprise %}, depending on organization and enterprise repository visibility settings. +* {% data variables.enterprise.prodname_managed_users_caps %} are limited in their use of {% data variables.product.prodname_pages %}. For more information, see "[About {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users)." * {% data reusables.copilot.emus-cannot-use-copilot %} -## Introducción a {% data variables.product.prodname_emus %} +## Getting started with {% data variables.product.prodname_emus %} -Para que los desarrolladores puedan usar la {% data variables.product.prodname_ghe_cloud %} con {% data variables.product.prodname_emus %}, debes llevar a cabo una serie de pasos de configuración. +Before your developers can use {% data variables.product.prodname_ghe_cloud %} with {% data variables.product.prodname_emus %}, you must follow a series of configuration steps. -1. Para utilizar los {% data variables.product.prodname_emus %}, necesitas un tipo separado de cuenta empresarial con {% data variables.product.prodname_emus %} habilitados. Para probar {% data variables.product.prodname_emus %} o para analizar las opciones para migrar desde su empresa existente, póngase en contacto con el [equipo de ventas de {% data variables.product.prodname_dotcom %}](https://enterprise.github.com/contact). +1. To use {% data variables.product.prodname_emus %}, you need a separate type of enterprise account with {% data variables.product.prodname_emus %} enabled. To try out {% data variables.product.prodname_emus %} or to discuss options for migrating from your existing enterprise, please contact [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact). - La persona de contacto en el equipo de ventas de GitHub trabajará contigo para crear tu {% data variables.enterprise.prodname_emu_enterprise %} nueva. Necesitarás proporcionar la dirección de correo electrónico del usuario que configurará tu empresa y un código corto que se utilizará como el sufijo de los nombres de usuario de los miembros. {% data reusables.enterprise-accounts.emu-shortcode %} Para más información, vea "[Nombres de usuario e información de perfil](#usernames-and-profile-information)". + Your contact on the GitHub Sales team will work with you to create your new {% data variables.enterprise.prodname_emu_enterprise %}. You'll need to provide the email address for the user who will set up your enterprise and a short code that will be used as the suffix for your enterprise members' usernames. {% data reusables.enterprise-accounts.emu-shortcode %} For more information, see "[Usernames and profile information](#usernames-and-profile-information)." -2. Después de crear tu empresa, recibirás un mensaje de correo electrónico de {% data variables.product.prodname_dotcom %}, el cual te invitará a elegir una contraseña para tu usuario de configuración de la empresa, quien será el primer propietario de esta. Utiliza una ventana de búsqueda privada o en modo incógnito al configurar la contraseña. El usuario de configuración solo se usa para configurar el inicio de sesión único y la integración de aprovisionamiento de SCIM para la empresa. Ya no tendrá acceso para administrar la cuenta empresarial una vez que se habilite correctamente el inicio de sesión único. El nombre de usuario del usuario de configuración es el código corto de la empresa con el sufijo `_admin`. +2. After we create your enterprise, you will receive an email from {% data variables.product.prodname_dotcom %} inviting you to choose a password for your enterprise's setup user, which will be the first owner in the enterprise. Use an incognito or private browsing window when setting the password. The setup user is only used to configure single sign-on and SCIM provisioning integration for the enterprise. It will no longer have access to administer the enterprise account once SSO is successfully enabled. The setup user's username is your enterprise's shortcode suffixed with `_admin`. {% note %} @@ -112,53 +107,54 @@ Para que los desarrolladores puedan usar la {% data variables.product.prodname_g {% endnote %} -3. Después de iniciar sesión como usuario de configuración, se recomienda habilitar la autenticación en dos fases. Para obtener más información, vea "[Configuración de autenticación en dos fases](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication)". +3. After you log in as the setup user, we recommend enabling two-factor authentication. For more information, see "[Configuring two-factor authentication](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication)." -1. Para empezar, configura {% ifversion oidc-for-emu %}cómo se autenticarán los miembros. Si usas Azure Active Directory como proveedor de identidades, puedes elegir entre OpenID Connect (OIDC) y el Lenguaje de marcado de aserción de seguridad (SAML). Ambas opciones proporcionan una experiencia de inicio de sesión sin problemas para los miembros, pero solo OIDC incluye compatibilidad con las directivas de acceso condicional (CAP). Si usas Okta como proveedor de identidades, puedes usar SAML para autenticar a los miembros. {% else %}SSO de SAML para tu empresa. Para obtener más información, consulta "[Configuración del inicio de sesión único de SAML para Usuarios Administrados de Enterprise](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)".{% endif %} +1. To get started, configure {% ifversion oidc-for-emu %}how your members will authenticate. If you are using Azure Active Directory as your identity provider, you can choose between OpenID Connect (OIDC) and Security Assertion Markup Language (SAML). We recommend OIDC, which includes support for Conditional Access Policies (CAP). If you require multiple enterprises with {% data variables.enterprise.prodname_managed_users %} provisioned from one tenant, you must use SAML for each enterprise after the first. If you are using Okta as your identity provider, you can use SAML to authenticate your members.{% else %}SAML SSO for your enterprise. For more information, see "[Configuring SAML single sign-on for Enterprise Managed Users](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)."{% endif %} {% ifversion oidc-for-emu %} - Para empezar, lea la guía del método de autenticación elegido. + To get started, read the guide for your chosen authentication method. - - "[Configuración de OIDC para Usuarios Administrados de Enterprise](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)". - - "[Configuración del inicio de sesión único de SAML para Usuarios Administrados de Enterprise](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)". + - "[Configuring OIDC for Enterprise Managed Users](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)." + - "[Configuring SAML single sign-on for Enterprise Managed Users](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)." {% endif %} -4. Una vez que hayas configurado el inicio de sesión único, puedes configurar el aprovisionamiento de SCIM. SCIM es cómo creará el proveedor de identidades {% data variables.enterprise.prodname_managed_users %} en los datos {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información sobre cómo configurar el aprovisionamiento de SCIM, consulta "[Configuración del aprovisionamiento de SCIM para Usuarios Administrados de Enterprise](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users)". +4. Once you have configured SSO, you can configure SCIM provisioning. SCIM is how your identity provider will create {% data variables.enterprise.prodname_managed_users %} on {% data variables.product.prodname_dotcom_the_website %}. For more information on configuring SCIM provisioning, see "[Configuring SCIM provisioning for enterprise managed users](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users)." -5. Una vez configurada la autenticación y el aprovisionamiento, puede empezar a administrar la pertenencia a la organización para los datos {% data variables.enterprise.prodname_managed_users %} mediante la sincronización de grupos de IdP con equipos. Para más información sobre cómo administrar equipos, vea "[Administración de pertenencias a equipos con grupos de proveedores de identidades](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups)". +5. Once authentication and provisioning are configured, you can start managing organization membership for your {% data variables.enterprise.prodname_managed_users %} by synchronizing IdP groups with teams. For more information, see "[Managing team memberships with identity provider groups](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups)." -Si los miembros de tu empresa deben usar una estación de trabajo para contribuir a los repositorios en {% data variables.location.product_location %} tanto de un {% data variables.enterprise.prodname_managed_user %} como de una cuenta personal, puedes proporcionar compatibilidad. Para obtener más información, consulta "[Compatibilidad con desarrolladores con varias cuentas de usuario en {% data variables.product.prodname_dotcom_the_website %}](#supporting-developers-with-multiple-user-accounts-on-githubcom)". +If members of your enterprise must use one workstation to contribute to repositories on {% data variables.location.product_location %} from both a {% data variables.enterprise.prodname_managed_user %} and a personal account, you can provide support. For more information, see "[Supporting developers with multiple user accounts on {% data variables.product.prodname_dotcom_the_website %}](#supporting-developers-with-multiple-user-accounts-on-githubcom)." -## Autenticación como {% data variables.enterprise.prodname_managed_user %} +## Authenticating as a {% data variables.enterprise.prodname_managed_user %} -Los {% data variables.enterprise.prodname_managed_users_caps %} se deben autenticar mediante su proveedor de identidad. Para autenticarse, un {% data variables.enterprise.prodname_managed_user %} puede visitar su portal de aplicación IdP o utilizar una página de inicio de sesión en el {% data variables.product.prodname_dotcom_the_website %}. +{% data variables.enterprise.prodname_managed_users_caps %} must authenticate through their identity provider. To authenticate, a {% data variables.enterprise.prodname_managed_user %} can visit their IdP application portal or use the login page on {% data variables.product.prodname_dotcom_the_website %}. -De manera predeterminada, cuando un usuario no autenticado intenta acceder a una empresa que usa {% data variables.product.prodname_emus %}, {% data variables.product.company_short %} muestra un error 404. Opcionalmente, un propietario de la empresa puede habilitar redirecciones automáticas al inicio de sesión único (SSO) en lugar de al error 404. Para más información, vea "[Aplicación de directivas de configuración de seguridad en la empresa](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-sso-for-unauthenticated-users)". +By default, when an unauthenticated user attempts to access an enterprise that uses {% data variables.product.prodname_emus %}, {% data variables.product.company_short %} displays a 404 error. An enterprise owner can optionally enable automatic redirects to single sign-on (SSO) instead of the 404. For more information, see "[Enforcing policies for security settings in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-sso-for-unauthenticated-users)." -{% data reusables.enterprise-accounts.about-recovery-codes %} Para más información, vea "[Administración de códigos de recuperación para la empresa](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)". +{% data reusables.enterprise-accounts.about-recovery-codes %} For more information, see "[Managing recovery codes for your enterprise](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)." -### Autenticarse como un {% data variables.enterprise.prodname_managed_user %} mediante el {% data variables.product.prodname_dotcom_the_website %} +### Authenticating as a {% data variables.enterprise.prodname_managed_user %} via {% data variables.product.prodname_dotcom_the_website %} -1. Vaya a [https://github.com/login](https://github.com/login). -1. En la caja de texto de "Nombre de usuario o dirección de correo electrónico", ingresa tu nombre de usuario incluyendo el guion bajo y código corto. - ![Captura de pantalla que muestra el formulario de inicio de sesión](/assets/images/help/enterprises/emu-login-username.png). Si el formulario reconoce el nombre de usuario, se actualizará. No necesitas ingresar tu contraseña en este formato. -1. Para continuar con el proveedor de identidades, haga clic en **Sign in with your identity provider** (Iniciar sesión con el proveedor de identidades). - ![Captura de pantalla que muestra el botón "Sign in with your identity provider" (Iniciar sesión con el proveedor de identidades)](/assets/images/help/enterprises/emu-login-submit.png) +1. Navigate to [https://github.com/login](https://github.com/login). +1. In the "Username or email address" text box, enter your username including the underscore and short code. + ![Screenshot showing login form](/assets/images/help/enterprises/emu-login-username.png) + When the form recognizes your username, the form will update. You do not need to enter your password on this form. +1. To continue to your identity provider, click **Sign in with your identity provider**. + ![Screenshot showing "Sign in with your identity provider" button](/assets/images/help/enterprises/emu-login-submit.png) -## Nombres de usuario e información de perfil +## Usernames and profile information -{% data variables.product.product_name %} crea automáticamente un nombre de usuario para cada persona mediante la normalización de un identificador proporcionado por el IdP. Para más información, consulta "[Consideraciones sobre el nombre de usuario para la autenticación externa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)". +{% data variables.product.product_name %} automatically creates a username for each person by normalizing an identifier provided by your IdP. For more information, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)." -Puede producirse un conflicto al aprovisionar usuarios si las partes únicas del identificador proporcionado por el IdP se quitan durante la normalización. Si no puedes aprovisionar un usuario debido a un conflicto con el nombre de usuario, debes modificar el nombre de usuario proporcionado por el IdP. Para obtener más información, consulta "[Resolución de problemas de nombre de usuario](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication#resolving-username-problems)". +A conflict may occur when provisioning users if the unique parts of the identifier provided by your IdP are removed during normalization. If you're unable to provision a user due to a username conflict, you should modify the username provided by your IdP. For more information, see "[Resolving username problems](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication#resolving-username-problems)." {% data reusables.enterprise-accounts.emu-only-emails-within-the-enterprise-can-conflict %} -El nombre de perfil y dirección de correo electrónico de un {% data variables.enterprise.prodname_managed_user %} también lo proporciona el IdP. Los {% data variables.enterprise.prodname_managed_users_caps %} no pueden cambiar su nombre de perfil ni la dirección de correo electrónico en {% data variables.product.prodname_dotcom %}, y el IdP solo puede proporcionar una dirección de correo electrónico. +The profile name and email address of a {% data variables.enterprise.prodname_managed_user %} is also provided by the IdP. {% data variables.enterprise.prodname_managed_users_caps %} cannot change their profile name or email address on {% data variables.product.prodname_dotcom %}, and the IdP can only provide a single email address. -## Compatibilidad con desarrolladores con varias cuentas de usuario en {% data variables.location.product_location %} +## Supporting developers with multiple user accounts on {% data variables.location.product_location %} -Es posible que personas del equipo necesiten contribuir a los recursos de {% data variables.location.product_location %} que están fuera de {% data variables.enterprise.prodname_emu_enterprise %}. Por ejemplo, puede que quieras mantener una empresa independiente para los proyectos de código abierto de la empresa. Dado que un {% data variables.enterprise.prodname_managed_user %} no puede contribuir a los recursos públicos, los usuarios deberán mantener una cuenta personal independiente para este trabajo. +People on your team may need to contribute to resources on {% data variables.location.product_location %} that are outside of your {% data variables.enterprise.prodname_emu_enterprise %}. For example, you may wish to maintain a separate enterprise for your company's open source projects. Because a {% data variables.enterprise.prodname_managed_user %} cannot contribute to public resources, users will need to maintain a separate, personal account for this work. -Las personas que deben contribuir desde dos cuentas de usuario en {% data variables.location.product_location %} con una estación de trabajo pueden configurar Git para simplificar el proceso. Para obtener más información, consulta "[Administración de varias cuentas](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts)". +People who must contribute from two user accounts on {% data variables.location.product_location %} using one workstation can configure Git to simplify the process. For more information, see "[Managing multiple accounts](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts)." diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy.md b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy.md index 74dd43ee44..33c6b16923 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy.md @@ -1,7 +1,7 @@ --- title: About support for your IdP's Conditional Access Policy shortTitle: Conditional access policy -intro: 'When your enterprise uses OIDC SSO, {% data variables.product.prodname_dotcom %} will validate access to your enterprise and its resources using your IdP''s Conditional Access Policy (CAP).' +intro: 'When your enterprise uses OIDC SSO, {% data variables.product.prodname_dotcom %} can validate access to your enterprise and its resources using your IdP''s Conditional Access Policy (CAP).' product: '{% data reusables.gated-features.emus %}' versions: feature: oidc-for-emu @@ -12,22 +12,17 @@ topics: - SSO --- -{% data reusables.enterprise-accounts.oidc-beta-notice %} +{% data reusables.enterprise-accounts.azure-emu-support-oidc %} ## About support for Conditional Access Policies {% data reusables.enterprise-accounts.emu-cap-validates %} -CAP support is enabled automatically for any {% data variables.enterprise.prodname_emu_enterprise %} that enables OIDC SSO and cannot be disabled. {% data variables.product.prodname_dotcom %} enforces your IdP's IP conditions but not device compliance conditions. +{% data variables.product.product_name %} supports CAP for any {% data variables.enterprise.prodname_emu_enterprise %} where OIDC SSO is enabled. {% data variables.product.product_name %} enforces your IdP's IP conditions but cannot enforce your device compliance conditions. Enterprise owners can choose to use this IP allow list configuration instead of {% data variables.product.product_name %}'s IP allow list, and can do so once OIDC SSO is configured. For more information about IP allow lists, see "[Restricting network traffic with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)" and "[Managing allowed IP addresses for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)." + For more information about using OIDC with {% data variables.product.prodname_emus %}, see "[Configuring OIDC for Enterprise Managed Users](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)" and "[Migrating from SAML to OIDC](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc)." -{% note %} - -**Note:** If you use Conditional Access (CA) network location policies in your Azure AD tenant, do not use the IP allow list feature on {% data variables.product.prodname_dotcom_the_website %}, with your enterprise account or with any of the organizations owned by the enterprise. Using both is unsupported and can result in the wrong policy applying. For more information about IP allow lists, see "[Enforcing security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-allowed-ip-addresses-for-organizations-in-your-enterprise)" and "[Managing allowed IP addresses for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)." - -{% endnote %} - ## Considerations for integrations and automations {% data variables.product.prodname_dotcom %} sends the originating IP address to your IdP for validation against your CAP. To make sure actions and apps are not blocked by your IdP's CAP, you will need to make changes to your configuration. @@ -46,4 +41,4 @@ When {% data variables.product.prodname_github_apps %} and {% data variables.pro You can contact the owners of the apps you want to use, ask for their IP ranges, and configure your IdP's CAP to allow access from those IP ranges. If you're unable to contact the owners, you can review your IdP sign-in logs to review the IP addresses seen in the requests, then allow-list those addresses. -You can also enable IP allow list configuration for installed {% data variables.product.prodname_github_apps %}. When enabled, all {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_apps %} will continue working regardless of the originating IP address. For more information, see "[Enforcing policies for security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#allowing-access-by-github-apps)." +If you do not wish to allow all of the IP ranges for all of your enterprise's apps, you can also exempt installed {% data variables.product.prodname_github_apps %} and authorized {% data variables.product.prodname_oauth_apps %} from the IdP allow list. If you do so, these apps will continue working regardless of the originating IP address. For more information, see "[Enforcing policies for security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#allowing-access-by-github-apps)." diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md index 66e9c9d84f..6812965089 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md @@ -12,7 +12,7 @@ topics: - SSO --- -{% data reusables.enterprise-accounts.oidc-beta-notice %} +{% data reusables.enterprise-accounts.azure-emu-support-oidc %} ## About OIDC for Enterprise Managed Users @@ -22,13 +22,13 @@ With {% data variables.product.prodname_emus %}, your enterprise uses your ident You can adjust the lifetime of a session, and how often a {% data variables.enterprise.prodname_managed_user %} needs to reauthenticate with your IdP, by changing the lifetime policy property of the ID tokens issued for {% data variables.product.prodname_dotcom %} from your IdP. The default lifetime is one hour. For more information, see "[Configurable token lifetimes in the Microsoft identity platform](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-configurable-token-lifetimes)" in the Azure AD documentation. -If you currently use SAML SSO for authentication and would prefer to use OIDC and benefit from CAP support, you can follow a migration path. For more information, see "[Migrating from SAML to OIDC](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc)." +{% data reusables.enterprise_user_management.SAML-to-OIDC-migration-for-EMU %} {% data reusables.enterprise-accounts.oidc-gei-warning %} ## Identity provider support -Support for OIDC is in public beta and available for customers using Azure Active Directory (Azure AD). +Support for OIDC is available for customers using Azure Active Directory (Azure AD). Each Azure AD tenant can support only one OIDC integration with {% data variables.product.prodname_emus %}. If you want to connect Azure AD to more than one enterprise on {% data variables.product.prodname_dotcom %}, use SAML instead. For more information, see "[Configuring SAML single sign-on for {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users)." diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md index fe4dde3d44..d5b35b288a 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md @@ -19,7 +19,7 @@ topics: ## About SAML single sign-on for {% data variables.product.prodname_emus %} -With {% data variables.product.prodname_emus %}, your enterprise uses SAML SSO to authenticate all members. Instead of signing in to {% data variables.product.prodname_dotcom %} with a {% data variables.product.prodname_dotcom %} username and password, members of your enterprise will sign in through your IdP. +With {% data variables.product.prodname_emus %}, your enterprise uses your corporate identity provider to authenticate all members. Instead of signing in to {% data variables.product.prodname_dotcom %} with a {% data variables.product.prodname_dotcom %} username and password, members of your enterprise will sign in through your IdP. {% data variables.product.prodname_emus %} supports the following IdPs: @@ -27,6 +27,9 @@ With {% data variables.product.prodname_emus %}, your enterprise uses SAML SSO t After you configure SAML SSO, we recommend storing your recovery codes so you can recover access to your enterprise in the event that your identity provider is unavailable. + +{% data reusables.enterprise_user_management.SAML-to-OIDC-migration-for-EMU %} + {% note %} **Note:** When SAML SSO is enabled, the only setting you can update on {% data variables.product.prodname_dotcom %} for your existing SAML configuration is the SAML certificate. If you need to update the Sign on URL or Issuer, you must first disable SAML SSO and then reconfigure SAML SSO with the new settings. diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md index 1d10031b84..8ec69251ad 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md @@ -12,7 +12,7 @@ topics: - SSO --- -{% data reusables.enterprise-accounts.oidc-beta-notice %} +{% data reusables.enterprise-accounts.azure-emu-support-oidc %} ## About migrating your {% data variables.enterprise.prodname_emu_enterprise %} from SAML to OIDC diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md index 6bbe5ad199..8ddb21e79d 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md @@ -124,5 +124,7 @@ If you use Okta as your IdP, you can map your Okta groups to teams on {% data va ## Further reading - [SAML Wiki](https://wiki.oasis-open.org/security) on the OASIS website -- [System for Cross-domain Identity Management: Protocol (RFC 7644)](https://tools.ietf.org/html/rfc7644) on the IETF website{% ifversion ghae %} -- [Restricting network traffic to your enterprise](/admin/configuration/restricting-network-traffic-to-your-enterprise){% endif %} +- [System for Cross-domain Identity Management: Protocol (RFC 7644)](https://tools.ietf.org/html/rfc7644) on the IETF website +{%- ifversion ghae %} +- "[Restricting network traffic to your enterprise with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)" +{%- endif %} diff --git a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md index ceebd276ec..7fe38c4bb7 100644 --- a/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md +++ b/translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md @@ -1,7 +1,7 @@ --- -title: Configuring authentication and provisioning for your enterprise using Azure AD +title: Configurar la autenticación y el aprovisionamiento para tu empresa utilizando Azure AD shortTitle: Configure with Azure AD -intro: 'You can use a tenant in Azure Active Directory (Azure AD) as an identity provider (IdP) to centrally manage authentication and user provisioning for {% data variables.location.product_location %}.' +intro: "Puedes usar un inquilino en Azure Active Directory (Azure\_AD) como proveedor de identidades (IdP) para administrar centralmente la autenticación y el aprovisionamiento de usuarios para {% data variables.location.product_location %}." permissions: 'Enterprise owners can configure authentication and provisioning for an enterprise on {% data variables.product.product_name %}.' versions: ghae: '*' @@ -17,65 +17,69 @@ redirect_from: - /admin/authentication/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad - /admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad - /admin/identity-and-access-management/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad +ms.openlocfilehash: bfd93814b11066d6da2d87a2e1f0a8bd5461e93f +ms.sourcegitcommit: ced661bdffebd0f96f6f76db109fbe31983448ba +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167064' --- +## Acerca de la autenticación y el aprovisionamiento de usuarios con Azure AD -## About authentication and user provisioning with Azure AD +Azure Active Directory (Azure AD) es un servicio de Microsoft que te permite administrar centralmente las cuentas de usuario y el acceso a las aplicaciones web. Para obtener más información, consulte [¿Qué Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) en Microsoft Docs. -Azure Active Directory (Azure AD) is a service from Microsoft that allows you to centrally manage user accounts and access to web applications. For more information, see [What is Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) in the Microsoft Docs. - -To manage identity and access for {% data variables.product.product_name %}, you can use an Azure AD tenant as a SAML IdP for authentication. You can also configure Azure AD to automatically provision accounts and access membership with SCIM, which allows you to create {% data variables.product.product_name %} users and manage team and organization membership from your Azure AD tenant. +Para administrar la identidad y el acceso para {% data variables.product.product_name %}, puedes utilizar un inquilino en Azure AD como un IdP de SAML para la autenticación. También puedes configurar Azure AD de modo que aprovisione automáticamente las cuentas y acceda a las pertenencias con SCIM, lo cual te permite crear usuarios de {% data variables.product.product_name %} y administrar las pertenencias de equipo y de organización desde tu inquilino de Azure AD. {% data reusables.scim.ghes-beta-note %} -After you enable SAML SSO and SCIM for {% data variables.product.product_name %} using Azure AD, you can accomplish the following from your Azure AD tenant. +Después de habilitar el inicio de sesión único de SAML y SCIM para {% data variables.product.product_name %} mediante Azure AD, puedes hacer lo siguiente desde tu inquilino de Azure AD. -* Assign the {% data variables.product.product_name %} application on Azure AD to a user account to automatically create and grant access to a corresponding user account on {% data variables.product.product_name %}. -* Unassign the {% data variables.product.product_name %} application to a user account on Azure AD to deactivate the corresponding user account on {% data variables.product.product_name %}. -* Assign the {% data variables.product.product_name %} application to an IdP group on Azure AD to automatically create and grant access to user accounts on {% data variables.product.product_name %} for all members of the IdP group. In addition, the IdP group is available on {% data variables.product.product_name %} for connection to a team and its parent organization. -* Unassign the {% data variables.product.product_name %} application from an IdP group to deactivate the {% data variables.product.product_name %} user accounts of all IdP users who had access only through that IdP group and remove the users from the parent organization. The IdP group will be disconnected from any teams on {% data variables.product.product_name %}. +* Asignar la aplicación de {% data variables.product.product_name %} en Azure AD a una cuenta de usuario para que cree y otorgue acceso automáticamente a una cuenta de usuario correspondiente en {% data variables.product.product_name %}. +* Desasignar la aplicación de {% data variables.product.product_name %} de una cuenta de usuario en Azure AD para desactivar la cuenta de usuario correspondiente en {% data variables.product.product_name %}. +* Asignar la aplicación de {% data variables.product.product_name %} a un grupo de IdP en Azure AD para que cree y otorgue acceso automáticamente a las cuentas de usuario en {% data variables.product.product_name %} para todos los miembros del grupo de IdP. Además, el grupo de IdP estará disponible en {% data variables.product.product_name %} para que se conecte a un equipo y a sus organizaciones primarias. +* Desasignar la aplicación de {% data variables.product.product_name %} desde un grupo de IdP para desactivar las cuentas de usuario de {% data variables.product.product_name %} de todos los usuarios de IdP que tuvieron acceso únicamente a través de este grupo de IdP y eliminar a los usuarios de la organización primaria. El grupo de IdP se desconectará de cualquier equipo en {% data variables.product.product_name %}. -For more information about managing identity and access for your enterprise on {% data variables.location.product_location %}, see "[Managing identity and access for your enterprise](/admin/authentication/managing-identity-and-access-for-your-enterprise)." For more information about synchronizing teams with IdP groups, see "[Synchronizing a team with an identity provider group](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group)." +Para obtener más información sobre cómo administrar la identidad y el acceso de la empresa en{% data variables.location.product_location %}, consulta "[Administración de la identidad y el acceso para la empresa](/admin/authentication/managing-identity-and-access-for-your-enterprise)". Para obtener más información sobre la sincronización de equipos con grupos de IdP, consulte "[Sincronizar un equipo con un grupo de proveedores de identidades](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group)". -## Prerequisites +## Requisitos previos -- To configure authentication and user provisioning for {% data variables.product.product_name %} using Azure AD, you must have an Azure AD account and tenant. For more information, see the [Azure AD website](https://azure.microsoft.com/free/active-directory) and [Quickstart: Create an Azure Active Directory tenant](https://docs.microsoft.com/azure/active-directory/develop/quickstart-create-new-tenant) in the Microsoft Docs. +- Para configurar la autenticación y el aprovisionamiento de usuarios para {% data variables.product.product_name %} utilizando Azure AD, debes tener una cuenta y un inquilino en Azure AD. Para obtener más información, consulte el [sitio web de Azure AD](https://azure.microsoft.com/free/active-directory) e [Inicio rápido: Creación de un inquilino de Azure Active Directory](https://docs.microsoft.com/azure/active-directory/develop/quickstart-create-new-tenant) en Microsoft Docs. {%- ifversion scim-for-ghes %} -- {% data reusables.saml.ghes-you-must-configure-saml-sso %} -{%- endif %} +- {% data reusables.saml.ghes-you-must-configure-saml-sso %} {%- endif %} - {% data reusables.saml.create-a-machine-user %} -## Configuring authentication and user provisioning with Azure AD +## Configurar la autenticación y el aprovisionamiento de usuarios con Azure AD -In your Azure AD tenant, add the application for {% data variables.product.product_name %}, then configure provisioning. +En el inquilino de Azure AD, agrega la aplicación para {% data variables.product.product_name %} y, luego, configura el aprovisionamiento. {% ifversion ghae %} -1. In Azure AD, add the {% data variables.enterprise.ae_azure_ad_app_link %} to your tenant and configure single sign-on. For more information, see [Tutorial: Azure Active Directory single sign-on (SSO) integration with {% data variables.product.product_name %}](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-tutorial) in the Microsoft Docs. +1. En Azure AD, agrega la {% data variables.enterprise.ae_azure_ad_app_link %} a tu inquilino y configura el inicio de sesión único. Para obtener más información, consulta [Tutorial: Integración del inicio de sesión único (SSO) de Azure Active Directory con {% data variables.product.product_name %}](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-tutorial) en Microsoft Docs. -1. In {% data variables.product.product_name %}, enter the details for your Azure AD tenant. +1. En {% data variables.product.product_name %}, especifica los detalles de tu inquilino de Azure AD. - {% data reusables.saml.ae-enable-saml-sso-during-bootstrapping %} - - If you've already configured SAML SSO for {% data variables.location.product_location %} using another IdP and you want to use Azure AD instead, you can edit your configuration. For more information, see "[Configuring SAML single sign-on for your enterprise](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise#editing-the-saml-sso-configuration)." + - Si ya configuraste el SSO de SAML para {% data variables.location.product_location %} con otro IdP y quieres usar Azure AD en su lugar, puedes editar la configuración. Para obtener más información, consulte "[Configuración del inicio de sesión único de SAML para la empresa](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise#editing-the-saml-sso-configuration)". -1. Enable user provisioning in {% data variables.product.product_name %} and configure user provisioning in Azure AD. For more information, see "[Configuring user provisioning for your enterprise](/admin/authentication/configuring-user-provisioning-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)." +1. Habilita el aprovisionamiento de usuarios en {% data variables.product.product_name %} y configura el aprovisionamiento de usurios en Azure AD. Para obtener más información, consulte "[Configuración del aprovisionamiento de usuarios para la empresa](/admin/authentication/configuring-user-provisioning-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)". {% elsif scim-for-ghes %} -1. In the Azure AD tenant, in the left sidebar, click **Provisioning**. +1. En el inquilino de Azure AD, en la barra lateral izquierda, haz clic en **Aprovisionamiento**. -1. Under "Tenant URL", type the full endpoint URL for SCIM on {% data variables.location.product_location %}. For more information, see "[SCIM](/rest/enterprise-admin/scim#scim-endpoint-urls)" in the REST API documentation. +1. En "URL de inquilino", escribe la dirección URL completa del punto de conexión para SCIM en {% data variables.location.product_location %}. Para obtener más información, consulta "[SCIM](/rest/enterprise-admin/scim#scim-endpoint-urls)" en la documentación de la API REST. -1. Under "Secret Token", type the {% data variables.product.pat_v1 %} that you created in step 4 of "[Configuring user provisioning with SCIM for your enterprise](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)." +1. En "Token secreto", escribe el {% data variables.product.pat_v1 %} que creaste en el paso 4 de "[Configuración del aprovisionamiento de usuarios con SCIM para la empresa](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)". -1. To ensure a successful connection from Azure AD to {% data variables.location.product_location %}, Click **Test Connection**. +1. Para garantizar una conexión correcta desde Azure AD con {% data variables.location.product_location %}, haz clic en **Probar conexión**. -1. After you ensure a successful connection, at the top of the page, click **Save**. +1. Después de asegurarte de que la conexión es correcta, en la parte superior de la página, haz clic en **Guardar**. {% endif %} -1. Assign an enterprise owner for {% data variables.product.product_name %} in Azure AD. The process you should follow depends on whether you configured provisioning. For more information about enterprise owners, see "[Roles in an enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owners)." - - If you configured provisioning, to grant the user enterprise ownership in {% data variables.product.product_name %}, assign the enterprise owner role to the user in Azure AD. - - If you did not configure provisioning, to grant the user enterprise ownership in {% data variables.product.product_name %}, include the `administrator` attribute in the SAML assertion for the user account on the IdP, with the value of `true`. For more information about including the `administrator` attribute in the SAML claim from Azure AD, see [How to: customize claims issued in the SAML token for enterprise applications](https://docs.microsoft.com/azure/active-directory/develop/active-directory-saml-claims-customization) in the Microsoft Docs. +1. Asigne un propietario de empresa para los datos {% data variables.product.product_name %} en Azure AD. El proceso que debes seguir depende de si configuraste el aprovisionamiento. Para obtener más información sobre los propietarios de empresas, consulta "[Roles en una empresa](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owners)". + - Si has configurado el aprovisionamiento, para conceder la propiedad empresarial del usuario en {% data variables.product.product_name %}, asigna el rol de propietario de empresa al usuario de Azure AD. + - Si no configuraste el aprovisionamiento, para conceder la propiedad empresarial del usuario en {% data variables.product.product_name %}, incluye el atributo `administrator` con el valor de `true` en la aserción de SAML para la cuenta de usuario en el IdP. Para obtener más información sobre la inclusión del atributo `administrator` en la notificación de SAML de Azure AD, consulta: [Procedimiento: personalización de las notificaciones emitidas en el token SAML para aplicaciones empresariales](https://docs.microsoft.com/azure/active-directory/develop/active-directory-saml-claims-customization) en Microsoft Docs. diff --git a/translations/es-ES/content/admin/index.md b/translations/es-ES/content/admin/index.md index 916f323282..6d3e11f4a2 100644 --- a/translations/es-ES/content/admin/index.md +++ b/translations/es-ES/content/admin/index.md @@ -73,7 +73,7 @@ featuredLinks: - '{% ifversion ghae %}/admin/user-management/auditing-users-across-your-enterprise{% endif %}' - /admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise - /admin/policies/enforcing-policies-for-your-enterprise/about-enterprise-policies - - '{% ifversion ghae %}/admin/configuration/restricting-network-traffic-to-your-enterprise{% endif %}' + - '{% ifversion ghae %}/admin/configuration/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list{% endif %}' - '{% ifversion ghes %}/admin/configuration/configuring-backups-on-your-appliance{% endif %}' - '{% ifversion ghes %}/admin/enterprise-management/creating-a-high-availability-replica{% endif %}' - '{% ifversion ghes %}/admin/overview/about-upgrades-to-new-releases{% endif %}' @@ -125,11 +125,11 @@ children: - /guides - /release-notes - /all-releases -ms.openlocfilehash: 3980ad01e56bf1e38dd6473c5e5246c6d45350eb -ms.sourcegitcommit: 3268914369fb29540e4d88ee5e56bc7a41f2a60e +ms.openlocfilehash: 0a84555b92c4645807d082f0d7f9348dfd3fc4bf +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 10/26/2022 -ms.locfileid: '148111316' +ms.lasthandoff: 11/22/2022 +ms.locfileid: '148179985' --- diff --git a/translations/es-ES/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/identifying-audit-log-events-performed-by-an-access-token.md b/translations/es-ES/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/identifying-audit-log-events-performed-by-an-access-token.md new file mode 100644 index 0000000000..4134968451 --- /dev/null +++ b/translations/es-ES/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/identifying-audit-log-events-performed-by-an-access-token.md @@ -0,0 +1,73 @@ +--- +title: Identificación de eventos de registro de auditoría que realiza un token de acceso +shortTitle: Identify events by token +intro: 'Puedes identificar las acciones que realiza un token de OAuth o específico de {% data variables.product.pat_generic %} en la empresa.' +versions: + feature: token-audit-log +ms.openlocfilehash: 4452e740e611ea3f903c5d122222b3cb575ba37d +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160315' +--- +## Acerca de los datos de token en el registro de auditoría + +En el registro de auditoría de la empresa, para las acciones que se realizaron mediante un {% data variables.product.pat_generic %} o una aplicación de OAuth para la autenticación, los datos del evento mostrarán el método de autenticación usado y el hash SHA-256 del token. + +Si descubres que un token se ha puesto en peligro, puedes comprender las acciones que realiza el token en peligro buscando en el registro de auditoría de la empresa todos los eventos asociados a ese token. + +Los valores de token con hash no se incluyen al exportar el registro de auditoría. + +## Búsqueda de eventos asociados a un token + +Al buscar eventos asociados a un token específico, puedes usar la interfaz de usuario o la API REST. En cualquier caso, primero deberás conocer el hash SHA-256 del token. + +### Generación de un valor hash SHA-256 para un token + +Si solo tienes un valor de token sin procesar, deberás generar un hash SHA-256 para poder buscar el token. + +En el caso de MacOS y Linux, puedes usar `echo -n TOKEN | openssl dgst -sha256 -binary | base64`, reemplazando TOKEN por el valor del token. + +En el caso de PowerShell, puedes usar el script siguiente a fin de devolver un hash SHA-256 para una cadena determinada. + +```shell{:copy} +Param ( + [Parameter(Mandatory=$true)] + [string] + $ClearString +) + +$hasher = [System.Security.Cryptography.HashAlgorithm]::Create('sha256') +$hash = $hasher.ComputeHash([System.Text.Encoding]::UTF8.GetBytes($ClearString)) + +$hashString = [System.BitConverter]::ToString($hash) +$hashString.Replace('-', '') +``` + +### Búsqueda en {% data variables.product.prodname_dotcom %} + +Al buscar el registro de auditoría en {% data variables.product.prodname_dotcom %}, incluye `hashed_token:"VALUE"` en la consulta de búsqueda, reemplazando `VALUE` por el hash SHA-256 del token. + +{% note %} + +**Nota**: Asegúrate de poner el valor del token con hash entre comillas. + +{% endnote %} + +### Búsqueda con la API REST + +Para poder buscar un token mediante la API REST, después de generar un hash SHA-256, también debes aplicar una secuencia de escape de URI al hash. La mayoría de los lenguajes de programación principales proporcionan una utilidad para el escape de URI. Por ejemplo, [encodeURIComponent()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) codifica una cadena para JavaScript. + +Después, incluye `hashed_token:"VALUE"` en la frase de búsqueda, reemplazando VALUE por el hash de escape de URI. + +Por ejemplo, si el nombre de la cuenta de empresa es `octo-corp`, el comando curl siguiente buscaría en el registro de auditoría @octo-corp todos los eventos asociados al token cuyo hash SHA-256 codificado en URI es `EH4L8o6PfCqipALbL%2BQT62lyqUtnI7ql0SPbkaQnjv8`. + +``` +curl --location --request GET 'https://api.github.com/enterprises/octo-corp/audit-log?phrase=hashed_token:"EH4L8o6PfCqipALbL%2BQT62lyqUtnI7ql0SPbkaQnjv8"' \ +--header 'Authorization: Basic TOKEN' \ +``` + +## Información adicional + +- "[Uso de la API de registro de auditoría para la empresa](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise)" diff --git a/translations/es-ES/content/admin/overview/best-practices-for-enterprises.md b/translations/es-ES/content/admin/overview/best-practices-for-enterprises.md new file mode 100644 index 0000000000..df2e3fa23a --- /dev/null +++ b/translations/es-ES/content/admin/overview/best-practices-for-enterprises.md @@ -0,0 +1,53 @@ +--- +title: Procedimientos recomendados para empresas +shortTitle: Best practices +intro: 'Obtén información sobre los procedimientos recomendados por {% data variables.product.company_short %} para la empresa.' +versions: + ghec: '*' + ghes: '*' + ghae: '*' +type: overview +topics: + - Accounts + - Enterprise + - Fundamentals +ms.openlocfilehash: 9c9ccfb0437b451188f8180dcf5ae29a6030f72d +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163455' +--- +{% ifversion ghec %} +## Identificar el mejor método de autenticación para la empresa + +{% data reusables.enterprise.ghec-authentication-options %} + +Para obtener ayuda para identificar el método de autenticación que mejor se adapte a tus necesidades, consulta "[Acerca de la autenticación para la empresa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise)". {% endif %} + +## Uso de directivas + +Se recomienda usar directivas para aplicar reglas de negocios y cumplimiento normativo. + +{% data reusables.enterprise.about-policies %} Para más información, consulta "[Acerca de las directivas empresariales](/admin/policies/enforcing-policies-for-your-enterprise/about-enterprise-policies)". + +## Minimizar el número de organizaciones + +A menudo, las grandes empresas necesitan varias organizaciones, pero intenta crear las menos posible para reflejar las divisiones corporativas de nivel superior. Un número menor de organizaciones fomenta las prácticas de recursos internos y permite que los debates impliquen a un público más amplio. + +En su lugar, puedes administrar los requisitos de acceso y seguridad del repositorio en un nivel más granular dentro de cada organización mediante equipos. Para más información, vea "[Acerca de los equipos](/organizations/organizing-members-into-teams/about-teams)". + +## Evitar una colaboración extensa en repositorios propiedad del usuario + +Se recomienda colaborar en repositorios propiedad de la organización siempre que sea posible y minimizar la colaboración en repositorios propiedad del usuario. Los repositorios propiedad de la organización tienen características administrativas y de seguridad más sofisticadas, y siguen siendo accesibles incluso cuando cambian las pertenencias a la empresa. + +## Usar nombres de usuario legibles + +{% ifversion ghec %}Si controlas los nombres de usuario para los miembros de la empresa, usa{% else %}Usa{% endif %} nombres de usuario legibles por personas y evita los id. generados por la máquina que sean difíciles de leer para los humanos. + +Puedes administrar la visualización de nombres de usuario en los repositorios privados de la empresa. Para obtener más información, consulta "[Administrar la visualización de los nombres de los miembros en tu organización](/organizations/managing-organization-settings/managing-the-display-of-member-names-in-your-organization)". + +## Información adicional + +- "[Procedimientos recomendados para repositorios](/repositories/creating-and-managing-repositories/best-practices-for-repositories)" +- "[Procedimientos recomendados para organizaciones](/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations)" diff --git a/translations/es-ES/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md b/translations/es-ES/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md index 935cf07d90..185483d91d 100644 --- a/translations/es-ES/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md +++ b/translations/es-ES/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md @@ -1,6 +1,6 @@ --- -title: Quickstart for configuring your MinIO storage bucket for GitHub Packages -intro: 'Configure your custom MinIO storage bucket for use with {% data variables.product.prodname_registry %}.' +title: Guía de inicio rápido para configurar tu bucket de almacenamiento de MinIO para GitHub Packages +intro: 'Configura tu bucket de almacenamiento de MinIO personalizado para utilizarlo con {% data variables.product.prodname_registry %}.' versions: ghes: '*' type: quick_start @@ -9,43 +9,48 @@ topics: - Enterprise - Storage shortTitle: Quickstart for MinIO +ms.openlocfilehash: 2d26aa879b0a59d8c6bd4d80a04ec2aa30f8c422 +ms.sourcegitcommit: 8f1801040a84ca9353899a2d1e6782c702aaed0d +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148166557' --- - {% data reusables.package_registry.packages-ghes-release-stage %} -Before you can enable and configure {% data variables.product.prodname_registry %} on {% data variables.location.product_location_enterprise %}, you need to prepare your third-party storage solution. +Antes de que puedas habilitar y configurar el {% data variables.product.prodname_registry %} en {% data variables.location.product_location_enterprise %}, deberás preparar tu solución de almacenamiento de terceros. -MinIO offers object storage with support for the S3 API and {% data variables.product.prodname_registry %} on your enterprise. +MinIO ofrece almacenamiento de objetos con soporte para la API de S3 y para {% data variables.product.prodname_registry %} en tu empresa. -This quickstart shows you how to set up MinIO using Docker for use with {% data variables.product.prodname_registry %} but you have other options for managing MinIO besides Docker. For more information about MinIO, see the official [MinIO docs](https://docs.min.io/). +Esta guía de inicio rápido te muestra cómo configurar MinIO utilizando Docker para usarlo con el {% data variables.product.prodname_registry %}, peto tienes otras opciones para administrar MinIO aparte de Docker. Para más información sobre MinIO, vea la [documentación oficial de MinIO](https://docs.min.io/). -## 1. Choose a MinIO mode for your needs +## 1. Elección de un modo de MinIO para las necesidades -| MinIO mode | Optimized for | Storage infrastructure required | +| Modo de MinIO | Optimizado para | Infraestructura de almacenamiento requerida | |----|----|----| -| Standalone MinIO (on a single host) | Fast setup | N/A | -| Clustered MinIO (also called Distributed MinIO)| Data security | Storage servers running in a cluster | +| MinIO Autónomo (en un solo host) | Configuración rápida | N/D | +| MinIO Agrupado (también conocido como MinIO distribuído)| Seguridad de los datos | Servidores de almacenamiento que se ejecutan en un agrupamiento | -For more information about your options, see the official [MinIO docs](https://docs.min.io/). +Para más información sobre las opciones, vea la [documentación oficial de MinIO](https://docs.min.io/). -## 2. Install, run, and sign in to MinIO +## 2. Instalación, ejecución e inicio de sesión en MinIO -1. Set up your preferred environment variables for MinIO. +1. Configura tus variables de ambiente preferidas para MinIO. - These examples use `MINIO_DIR`: + En estos ejemplos se usa `MINIO_DIR`: ```shell $ export MINIO_DIR=$(pwd)/minio $ mkdir -p $MINIO_DIR ``` -2. Install MinIO. +2. Instala MinIO. ```shell $ docker pull minio/minio ``` - For more information, see the official "[MinIO Quickstart Guide](https://docs.min.io/docs/minio-quickstart-guide)." + Para más información, vea la "[Guía de inicio rápido de MinIO](https://docs.min.io/docs/minio-quickstart-guide)" oficial. -3. Sign in to MinIO using your MinIO access key and secret. +3. Inicia sesión en MinIO utilizando tu llave de acceso y secreto de MinIO. {% linux %} ```shell @@ -63,16 +68,16 @@ For more information about your options, see the official [MinIO docs](https://d ``` {% endmac %} - You can access your MinIO keys using the environment variables: + Puedes acceder a tus llaves de MinIO utilizando las variables de ambiente: ```shell $ echo $MINIO_ACCESS_KEY $ echo $MINIO_SECRET_KEY ``` -4. Run MinIO in your chosen mode. +4. Ejecuta MinIO en el modo que hayas elegido. - * Run MinIO using Docker on a single host: + * Ejecuta MinIO utilizando Docker en un host único: ```shell $ docker run -p 9000:9000 \ @@ -82,42 +87,42 @@ For more information about your options, see the official [MinIO docs](https://d minio/minio server /data ``` - For more information, see "[MinIO Docker Quickstart guide](https://docs.min.io/docs/minio-docker-quickstart-guide.html)." + Para más información, vea la "[Guía de inicio rápido de Docker en MinIO](https://docs.min.io/docs/minio-docker-quickstart-guide.html)". - * Run MinIO using Docker as a cluster. This MinIO deployment uses several hosts and MinIO's erasure coding for the strongest data protection. To run MinIO in a cluster mode, see the "[Distributed MinIO Quickstart Guide](https://docs.min.io/docs/distributed-minio-quickstart-guide.html)." + * Ejecuta MinIO utilizando Docker como un agrupamiento. Este despliegue de MinIO utiliza diversos hosts y el código de borrado de MinIO para tener la mayor protección de los datos. Para ejecutar MinIO en modo de clúster, consulta la "[Guía de inicio rápido de MinIO distribuido](https://docs.min.io/docs/distributed-minio-quickstart-guide.html)". -## 3. Create your MinIO bucket for {% data variables.product.prodname_registry %} +## 3. Creación del cubo de MinIO para {% data variables.product.prodname_registry %} -1. Install the MinIO client. +1. Instala el cliente de MinIO. ```shell $ docker pull minio/mc ``` -2. Create a bucket with a host URL that {% data variables.product.prodname_ghe_server %} can access. +2. Crea un bucket con una URL de host a la que {% data variables.product.prodname_ghe_server %} pueda acceder. - * Local deployments example: + * Ejemplos de despliegues locales: ```shell $ export MC_HOST_minio="http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY} @localhost:9000" $ docker run minio/mc BUCKET-NAME ``` - This example can be used for MinIO standalone. + Este ejemplo se puede emplear para MinIO independiente. - * Clustered deployments example: + * Ejemplo de despliegues en agrupamiento: ```shell $ export MC_HOST_minio="http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY} @minioclustername.example.com:9000" $ docker run minio/mc mb packages ``` -## Next steps +## Pasos siguientes -To finish configuring storage for {% data variables.product.prodname_registry %}, you'll need to copy the MinIO storage URL: +Para terminar de configurar el almacenamiento para el {% data variables.product.prodname_registry %}, necesitarás copiar la URL de almacenamiento de MinIO: ``` echo "http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY}@minioclustername.example.com:9000" ``` -For the next steps, see "[Enabling {% data variables.product.prodname_registry %} with MinIO](/admin/packages/enabling-github-packages-with-minio)." +Para obtenerlos pasos siguientes, vea "[Habilitación de {% data variables.product.prodname_registry %} con MinIO](/admin/packages/enabling-github-packages-with-minio)". diff --git a/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md b/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md index bedf7001c2..c2227ba0ff 100644 --- a/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md +++ b/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md @@ -25,7 +25,7 @@ shortTitle: Policies for security settings ## About policies for security settings in your enterprise -You can enforce policies to control the security settings for organizations owned by your enterprise on {% data variables.product.product_name %}. By default, organization owners can manage security settings. For more information, see "[Keeping your organization secure](/organizations/keeping-your-organization-secure)." +You can enforce policies to control the security settings for organizations owned by your enterprise on {% data variables.product.product_name %}. By default, organization owners can manage security settings. {% ifversion ghec or ghes %} @@ -59,93 +59,6 @@ Before you require use of two-factor authentication, we recommend notifying orga {% endif %} -{% ifversion ghec or ghae %} - -## Managing allowed IP addresses for organizations in your enterprise - -{% ifversion ghae %} - -You can restrict network traffic to your enterprise on {% data variables.product.product_name %}. For more information, see "[Restricting network traffic to your enterprise](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise)." - -{% elsif ghec %} - -Enterprise owners can restrict access to private assets owned by organizations in an enterprise by configuring an allow list for specific IP addresses. {% data reusables.identity-and-permissions.ip-allow-lists-example-and-restrictions %} - -{% data reusables.identity-and-permissions.ip-allow-lists-cidr-notation %} - -{% data reusables.identity-and-permissions.ip-allow-lists-enable %} {% data reusables.identity-and-permissions.ip-allow-lists-enterprise %} - -You can also configure allowed IP addresses for an individual organization. For more information, see "[Managing allowed IP addresses for your organization](/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization)." - -### Adding an allowed IP address - -{% data reusables.identity-and-permissions.about-adding-ip-allow-list-entries %} - -{% data reusables.identity-and-permissions.ipv6-allow-lists %} - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.security-tab %} -{% data reusables.identity-and-permissions.ip-allow-lists-add-ip %} -{% data reusables.identity-and-permissions.ip-allow-lists-add-description %} -{% data reusables.identity-and-permissions.ip-allow-lists-add-entry %} -{% data reusables.identity-and-permissions.check-ip-address %} - -### Allowing access by {% data variables.product.prodname_github_apps %} - -{% data reusables.identity-and-permissions.ip-allow-lists-githubapps-enterprise %} - -### Enabling allowed IP addresses - -{% data reusables.identity-and-permissions.about-enabling-allowed-ip-addresses %} - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.security-tab %} -3. Under "IP allow list", select **Enable IP allow list**. - ![Checkbox to allow IP addresses](/assets/images/help/security/enable-ip-allowlist-enterprise-checkbox.png) -4. Click **Save**. - -### Editing an allowed IP address - -{% data reusables.identity-and-permissions.about-editing-ip-allow-list-entries %} - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.security-tab %} -{% data reusables.identity-and-permissions.ip-allow-lists-edit-entry %} -{% data reusables.identity-and-permissions.ip-allow-lists-edit-ip %} -{% data reusables.identity-and-permissions.ip-allow-lists-edit-description %} -8. Click **Update**. -{% data reusables.identity-and-permissions.check-ip-address %} - -{% ifversion ip-allow-list-address-check %} -### Checking if an IP address is permitted - -{% data reusables.identity-and-permissions.about-checking-ip-address %} - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.security-tab %} -{% data reusables.identity-and-permissions.check-ip-address-step %} -{% endif %} - -### Deleting an allowed IP address - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.security-tab %} -{% data reusables.identity-and-permissions.ip-allow-lists-delete-entry %} -{% data reusables.identity-and-permissions.ip-allow-lists-confirm-deletion %} - -### Using {% data variables.product.prodname_actions %} with an IP allow list - -{% data reusables.actions.ip-allow-list-self-hosted-runners %} - -{% endif %} - -{% endif %} - ## Managing SSH certificate authorities for your enterprise You can use a SSH certificate authorities (CA) to allow members of any organization owned by your enterprise to access that organization's repositories using SSH certificates you provide. {% data reusables.organizations.can-require-ssh-cert %} For more information, see "[About SSH certificate authorities](/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities)." @@ -197,5 +110,7 @@ To prevent confusion from your developers, you can change this behavior so that ## Further reading - "[About identity and access management for your enterprise](/admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise)"{% ifversion ghec %} -- "[Accessing compliance reports for your enterprise](/admin/overview/accessing-compliance-reports-for-your-enterprise)"{% endif %} -{% endif %} +- "[Accessing compliance reports for your enterprise](/admin/overview/accessing-compliance-reports-for-your-enterprise)"{%- endif %} +- "[Keeping your organization secure](/organizations/keeping-your-organization-secure)" +- "[Restricting network traffic with an IP allow list with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)" +{%- endif %} diff --git a/translations/es-ES/content/authentication/authenticating-with-saml-single-sign-on/viewing-and-managing-your-active-saml-sessions.md b/translations/es-ES/content/authentication/authenticating-with-saml-single-sign-on/viewing-and-managing-your-active-saml-sessions.md index cf62edb6c3..b937c55d8e 100644 --- a/translations/es-ES/content/authentication/authenticating-with-saml-single-sign-on/viewing-and-managing-your-active-saml-sessions.md +++ b/translations/es-ES/content/authentication/authenticating-with-saml-single-sign-on/viewing-and-managing-your-active-saml-sessions.md @@ -1,6 +1,6 @@ --- -title: Viewing and managing your active SAML sessions -intro: You can view and revoke your active SAML sessions in your settings. +title: Ver y administrar tus sesiones de SAML activas +intro: Puedes ver y revocar tus sesiones de SAML activas en configuración. redirect_from: - /articles/viewing-and-managing-your-active-saml-sessions - /github/authenticating-to-github/viewing-and-managing-your-active-saml-sessions @@ -11,29 +11,33 @@ topics: - SSO type: how_to shortTitle: Active SAML sessions +ms.openlocfilehash: e69ad366de7cdfb14b6a2a13ae3bdc134111616a +ms.sourcegitcommit: b2e5d14036a700b781e91158a552f8c0b1f04839 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/15/2022 +ms.locfileid: '148165595' --- +Puedes ver una lista de dispositivos que han iniciado sesión en tu cuenta y revocar las sesiones de SAML que no reconozcas. -You can view a list of devices that have logged into your account, and revoke any SAML sessions that you don't recognize. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.sessions %} +1. Debajo de "Sesiones web" puedes ver tus sesiones de SAML activas. -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.sessions %} -1. Under "Web sessions," you can see your active SAML sessions. + ![Captura de pantalla de la lista de sesiones de SAML activas](/assets/images/help/settings/saml-active-sessions.png) - ![Screenshot of the list of active SAML sessions](/assets/images/help/settings/saml-active-sessions.png) +1. Para ver los detalles de la sesión, haga clic en **See more** (Ver más). + ![Captura de pantalla de las sesiones de SAML activas con el botón para abrir los detalles de la sesión de SAML resaltado](/assets/images/help/settings/saml-expand-session-details.png) -1. To see the session details, click **See more**. - ![Screenshot of the active SAML sessions with the button to open SAML session details emphasized](/assets/images/help/settings/saml-expand-session-details.png) +1. Para revocar una sesión, haga clic en **Revoke SAML** (Revocar SAML). -1. To revoke a session, click **Revoke SAML**. - - ![Screenshot of the Session details page with the button to revoke a SAML session emphasized](/assets/images/help/settings/saml-revoke-session.png) + ![Captura de pantalla de la página Detalles de la sesión con el botón para revocar una sesión de SAML resaltado](/assets/images/help/settings/saml-revoke-session.png) {% note %} - **Note:** When you revoke a session, you remove your SAML authentication to that organization. To access the organization again, you will need to single sign-on through your identity provider. For more information, see "[About authentication with SAML SSO](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)." + **Nota:** Cuando revoca una sesión, quita su autenticación de SAML para esa organización. Para volver a acceder a la organización, tendrás que hacer un inicio de sesión único a través de tu proveedor de identidad. Para más información, vea "[Acerca de la autenticación con el inicio de sesión único de SAML](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)". {% endnote %} -## Further reading +## Información adicional -- "[About authentication with SAML SSO](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)" +- "[Acerca de la autenticación con el inicio de sesión único de SAML](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)" diff --git a/translations/es-ES/content/authentication/keeping-your-account-and-data-secure/index.md b/translations/es-ES/content/authentication/keeping-your-account-and-data-secure/index.md index b2431aab33..d86b0b31e6 100644 --- a/translations/es-ES/content/authentication/keeping-your-account-and-data-secure/index.md +++ b/translations/es-ES/content/authentication/keeping-your-account-and-data-secure/index.md @@ -1,6 +1,6 @@ --- -title: Keeping your account and data secure -intro: 'To protect your personal information, you should keep both your account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %} and any associated data secure.' +title: Mantener tu cuenta y tus datos seguros +intro: 'Para proteger tu información personal, deberías mantener seguros tanto tu cuenta de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %} como cualquier tipo de datos asociados.' redirect_from: - /articles/keeping-your-account-and-data-secure - /github/authenticating-to-github/keeping-your-account-and-data-secure @@ -34,5 +34,11 @@ children: - /preventing-unauthorized-access - /viewing-and-managing-your-sessions shortTitle: Account security +ms.openlocfilehash: ba88c5fcde2e1dcdcf7186c4e5d83bf854f9ff00 +ms.sourcegitcommit: b2e5d14036a700b781e91158a552f8c0b1f04839 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/15/2022 +ms.locfileid: '148165550' --- diff --git a/translations/es-ES/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md b/translations/es-ES/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md new file mode 100644 index 0000000000..32682537d9 --- /dev/null +++ b/translations/es-ES/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md @@ -0,0 +1,46 @@ +--- +title: Vista y gestión de tus sesiones +intro: Puedes ver y revocar tus sesiones activas en configuración. +versions: + feature: device-and-settings-management-page +type: how_to +topics: + - SSO +shortTitle: Viewing and managing sessions +ms.openlocfilehash: 15a0bdc17a913ceb6da27e8809610306adb1de25 +ms.sourcegitcommit: b2e5d14036a700b781e91158a552f8c0b1f04839 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/15/2022 +ms.locfileid: '148165589' +--- +Puedes ver una lista de los dispositivos que han iniciado sesión en tu cuenta y revocar las sesiones que no reconozcas. + +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.sessions %} +1. En "Sesiones web", puedes ver las sesiones web activas. + + ![Captura de pantalla de la lista de sesiones activas](/assets/images/help/settings/saml-active-sessions.png) {% ifversion fpt or ghec %} En "sesiones de {% data variables.product.prodname_mobile %}", puedes ver una lista de dispositivos que han iniciado sesión en tu cuenta mediante la aplicación {% data variables.product.prodname_mobile %}. + + ![Captura de pantalla de la lista de sesiones activas](/assets/images/help/settings/github-mobile-active-sessions.png){% endif %} + +1. Para ver los detalles de la sesión web, haz clic en **Ver más**. + + ![Captura de pantalla de la página Sesiones con el botón para abrir los detalles de la sesión resaltado](/assets/images/help/settings/saml-expand-session-details.png) + +1. Para revocar una sesión web, haz clic en **Revocar sesión**. + + ![Captura de pantalla de la página de detalles de Sesiones con el botón para revocar una sesión resaltado](/assets/images/help/settings/revoke-session.png) + +{% ifversion fpt or ghec %} +1. Opcionalmente, para revocar una sesión de {% data variables.product.prodname_mobile %}, vuelve a la página información general de Sesiones y haz clic en **Revocar** junto al dispositivo que quieres revocar. + + {% note %} + + **Nota:** Al revocar una sesión móvil, se cierra la sesión de la aplicación {% data variables.product.prodname_mobile %} en ese dispositivo y se quita como opción de segundo factor. + + {% endnote %} + + ![Captura de pantalla de la página Sesiones con el botón para revocar una sesión móvil resaltado](/assets/images/help/settings/revoke-mobile-session.png) + +{% endif %} + diff --git a/translations/es-ES/content/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key.md b/translations/es-ES/content/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key.md index 55d6721afd..15837294e8 100644 --- a/translations/es-ES/content/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key.md +++ b/translations/es-ES/content/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key.md @@ -1,6 +1,6 @@ --- -title: Informarle a Git acerca de tu clave de firma -intro: 'Para firmar las confirmaciones localmente, necesitas informar a Git que hay una clave de GPG{% ifversion ssh-commit-verification %}, SSH,{% endif %} o X.509 que quieres utilizar.' +title: Telling Git about your signing key +intro: 'To sign commits locally, you need to inform Git that there''s a GPG{% ifversion ssh-commit-verification %}, SSH,{% endif %} or X.509 key you''d like to use.' redirect_from: - /articles/telling-git-about-your-gpg-key - /articles/telling-git-about-your-signing-key @@ -15,39 +15,38 @@ topics: - Identity - Access management shortTitle: Tell Git your signing key -ms.openlocfilehash: e78306bb1519f2b7f51ab6bc039bff0b982e48cf -ms.sourcegitcommit: a0ad3bfe2a99c3092e76ca9b3d476cf30988ca55 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/28/2022 -ms.locfileid: '148118999' --- {% mac %} -## Informarle a Git acerca de tu llave GPG +## Telling Git about your GPG key -Si estás utilizando una clave GPG que coincide con tu identidad de confirmante y tu dirección de correo electrónico verificada asociada a tu cuenta de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, entonces puedes comenzar a firmar confirmaciones y etiquetas. +If you're using a GPG key that matches your committer identity and your verified email address associated with your account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, then you can begin signing commits and signing tags. {% note %} -Si no tienes una llave GPG que coincida con la identidad de la persona que confirma el cambio, debes asociar un correo electrónico a una llave existente. Para más información, vea "[Asociación de un correo electrónico con la clave de GPG](/articles/associating-an-email-with-your-gpg-key)". +If you don't have a GPG key that matches your committer identity, you need to associate an email with an existing key. For more information, see "[Associating an email with your GPG key](/articles/associating-an-email-with-your-gpg-key)". {% endnote %} -Si tienes múltiples llaves GPG, le debes decir a Git cuál utilizar. +If you have multiple GPG keys, you need to tell Git which one to use. -{% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.gpg.configure-gpg-signing %} {% data reusables.gpg.list-keys-with-note %} {% data reusables.gpg.copy-gpg-key-id %} {% data reusables.gpg.paste-gpg-key-id %} {% data reusables.gpg.set-auto-sign %} -1. Si no usa el conjunto de GPG, ejecute el comando siguiente en el shell de `zsh` para agregar la clave de GPG al archivo `.zshrc`, si existe, o bien al archivo `.zprofile`: +{% data reusables.command_line.open_the_multi_os_terminal %} +{% data reusables.gpg.configure-gpg-signing %} +{% data reusables.gpg.list-keys-with-note %} +{% data reusables.gpg.copy-gpg-key-id %} +{% data reusables.gpg.paste-gpg-key-id %} +{% data reusables.gpg.set-auto-sign %} +1. If you aren't using the GPG suite, run the following command in the `zsh` shell to add the GPG key to your `.zshrc` file, if it exists, or your `.zprofile` file: ```shell $ if [ -r ~/.zshrc ]; then echo 'export GPG_TTY=$(tty)' >> ~/.zshrc; \ else echo 'export GPG_TTY=$(tty)' >> ~/.zprofile; fi ``` - Como alternativa, si usa el shell de `bash`, ejecute este comando: + Alternatively, if you use the `bash` shell, run this command: ```shell $ if [ -r ~/.bash_profile ]; then echo 'export GPG_TTY=$(tty)' >> ~/.bash_profile; \ else echo 'export GPG_TTY=$(tty)' >> ~/.profile; fi ``` -1. Opcionalmente, para que se le solicite que escriba un PIN o una frase de contraseña cuando sea necesario, instale `pinentry-mac`. Por ejemplo, con [Homebrew](https://brew.sh/): +1. Optionally, to prompt you to enter a PIN or passphrase when required, install `pinentry-mac`. For example, using [Homebrew](https://brew.sh/): ```shell $ brew install pinentry-mac $ echo "pinentry-program $(which pinentry-mac)" >> ~/.gnupg/gpg-agent.conf @@ -58,56 +57,69 @@ Si tienes múltiples llaves GPG, le debes decir a Git cuál utilizar. {% windows %} -## Informarle a Git acerca de tu llave GPG +## Telling Git about your GPG key -Si estás utilizando una clave GPG que coincide con tu identidad de confirmante y tu dirección de correo electrónico verificada asociada a tu cuenta de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, entonces puedes comenzar a firmar confirmaciones y etiquetas. +If you're using a GPG key that matches your committer identity and your verified email address associated with your account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, then you can begin signing commits and signing tags. {% note %} -Si no tienes una llave GPG que coincida con la identidad de la persona que confirma el cambio, debes asociar un correo electrónico a una llave existente. Para más información, vea "[Asociación de un correo electrónico con la clave de GPG](/articles/associating-an-email-with-your-gpg-key)". +If you don't have a GPG key that matches your committer identity, you need to associate an email with an existing key. For more information, see "[Associating an email with your GPG key](/articles/associating-an-email-with-your-gpg-key)". {% endnote %} -Si tienes múltiples llaves GPG, le debes decir a Git cuál utilizar. +If you have multiple GPG keys, you need to tell Git which one to use. -{% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.gpg.configure-gpg-signing %} {% data reusables.gpg.list-keys-with-note %} {% data reusables.gpg.copy-gpg-key-id %} {% data reusables.gpg.paste-gpg-key-id %} {% data reusables.gpg.set-auto-sign %} +{% data reusables.command_line.open_the_multi_os_terminal %} +{% data reusables.gpg.configure-gpg-signing %} +{% data reusables.gpg.list-keys-with-note %} +{% data reusables.gpg.copy-gpg-key-id %} +{% data reusables.gpg.paste-gpg-key-id %} +{% data reusables.gpg.set-auto-sign %} {% endwindows %} {% linux %} -## Informarle a Git acerca de tu llave GPG +## Telling Git about your GPG key -Si estás utilizando una clave GPG que coincide con tu identidad de confirmante y tu dirección de correo electrónico verificada asociada a tu cuenta de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, entonces puedes comenzar a firmar confirmaciones y etiquetas. +If you're using a GPG key that matches your committer identity and your verified email address associated with your account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, then you can begin signing commits and signing tags. {% note %} -Si no tienes una llave GPG que coincida con la identidad de la persona que confirma el cambio, debes asociar un correo electrónico a una llave existente. Para más información, vea "[Asociación de un correo electrónico con la clave de GPG](/articles/associating-an-email-with-your-gpg-key)". +If you don't have a GPG key that matches your committer identity, you need to associate an email with an existing key. For more information, see "[Associating an email with your GPG key](/articles/associating-an-email-with-your-gpg-key)". {% endnote %} -Si tienes múltiples llaves GPG, le debes decir a Git cuál utilizar. +If you have multiple GPG keys, you need to tell Git which one to use. -{% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.gpg.configure-gpg-signing %} {% data reusables.gpg.list-keys-with-note %} {% data reusables.gpg.copy-gpg-key-id %} {% data reusables.gpg.paste-gpg-key-id %} {% data reusables.gpg.set-auto-sign %} -1. Para agregar la clave de GPG al archivo de inicio de `.bashrc`, ejecute el comando siguiente: +{% data reusables.command_line.open_the_multi_os_terminal %} +{% data reusables.gpg.configure-gpg-signing %} +{% data reusables.gpg.list-keys-with-note %} +{% data reusables.gpg.copy-gpg-key-id %} +{% data reusables.gpg.paste-gpg-key-id %} +{% data reusables.gpg.set-auto-sign %} +1. To add your GPG key to your `.bashrc` startup file, run the following command: ```bash $ [ -f ~/.bashrc ] && echo 'export GPG_TTY=$(tty)' >> ~/.bashrc ``` -{% endlinux %} {% ifversion ssh-commit-verification %} +{% endlinux %} +{% ifversion ssh-commit-verification %} -## Indicación a Git acerca de tu clave SSH +## Telling Git about your SSH key -Puedes usar una clave SSH existente para firmar confirmaciones y etiquetas, o generar una nueva específicamente para firmar. Para obtener más información, consulta "[Generación de una nueva clave SSH y adición a ssh-agent](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)". +You can use an existing SSH key to sign commits and tags, or generate a new one specifically for signing. For more information, see "[Generating a new SSH key and adding it to the ssh-agent](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)." {% data reusables.gpg.ssh-git-version %} -{% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.gpg.configure-ssh-signing %} {% data reusables.gpg.copy-ssh-public-key %} {% data reusables.gpg.paste-ssh-public-key %} +{% data reusables.command_line.open_the_multi_os_terminal %} +{% data reusables.gpg.configure-ssh-signing %} +{% data reusables.gpg.paste-ssh-public-key %} {% endif %} {% data reusables.gpg.x-509-key %} -## Información adicional +## Further reading -- "[incorporación de una clave SSH nueva a tu cuenta de GitHub](/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)". -- "[Firma de confirmaciones](/articles/signing-commits)" -- "[Firma de etiquetas](/articles/signing-tags)" +- "[Adding a new SSH key to your GitHub account](/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)." +- "[Signing commits](/articles/signing-commits)" +- "[Signing tags](/articles/signing-tags)" diff --git a/translations/es-ES/content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md b/translations/es-ES/content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md index ec06abf702..70d3938722 100644 --- a/translations/es-ES/content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md +++ b/translations/es-ES/content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md @@ -52,30 +52,24 @@ A time-based one-time password (TOTP) application automatically generates an aut {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.security %} {% data reusables.two_fa.enable-two-factor-authentication %} -{%- ifversion fpt or ghec or ghes %} +{%- ifversion fpt or ghec or ghes > 3.7 %} +5. Under "Setup authenticator app", do one of the following: + - Scan the QR code with your mobile device's app. After scanning, the app displays a six-digit code that you can enter on {% data variables.product.product_name %}. + - If you can't scan the QR code, click **enter this text code** to see a code that you can manually enter in your TOTP app instead. + ![Click enter this code](/assets/images/help/2fa/2fa_wizard_app_click_code.png) +6. The TOTP mobile application saves your account on {% data variables.location.product_location %} and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, type the code into the field under "Enter the six-digit code from the application". +![TOTP enter code field](/assets/images/help/2fa/2fa_wizard_app_enter_code.png) +{%- else %} 5. Under "Two-factor authentication", select **Set up using an app** and click **Continue**. 6. Under "Authentication verification", do one of the following: - Scan the QR code with your mobile device's app. After scanning, the app displays a six-digit code that you can enter on {% data variables.product.product_name %}. - If you can't scan the QR code, click **enter this text code** to see a code that you can manually enter in your TOTP app instead. ![Click enter this code](/assets/images/help/2fa/2fa_wizard_app_click_code.png) -7. The TOTP mobile application saves your account on {% data variables.location.product_location %} and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, type the code into the field under "Enter the six-digit code from the application". If your recovery codes are not automatically displayed, click **Continue**. +7. The TOTP mobile application saves your account on {% data variables.location.product_location %} and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, type the code into the field under "Enter the six-digit code from the application". ![TOTP enter code field](/assets/images/help/2fa/2fa_wizard_app_enter_code.png) -{% data reusables.two_fa.save_your_recovery_codes_during_2fa_setup %} -{%- else %} -5. On the Two-factor authentication page, click **Set up using an app**. -6. Save your recovery codes in a safe place. Your recovery codes can help you get back into your account if you lose access. - - To save your recovery codes on your device, click **Download**. - - To save a hard copy of your recovery codes, click **Print**. - - To copy your recovery codes for storage in a password manager, click **Copy**. - ![List of recovery codes with option to download, print, or copy the codes](/assets/images/help/2fa/download-print-or-copy-recovery-codes-before-continuing.png) -7. After saving your two-factor recovery codes, click **Next**. -8. On the Two-factor authentication page, do one of the following: - - Scan the QR code with your mobile device's app. After scanning, the app displays a six-digit code that you can enter on {% data variables.product.product_name %}. - - If you can't scan the QR code, click **enter this text code** to see a code you can copy and manually enter on {% data variables.product.product_name %} instead. - ![Click enter this code](/assets/images/help/2fa/totp-click-enter-code.png) -9. The TOTP mobile application saves your account on {% data variables.location.product_location %} and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, on the 2FA page, type the code and click **Enable**. - ![TOTP Enable field](/assets/images/help/2fa/totp-enter-code.png) {%- endif %} +{% data reusables.two_fa.save_your_recovery_codes_during_2fa_setup %} +{% data reusables.two_fa.backup_options_during_2fa_enrollment %} {% data reusables.two_fa.test_2fa_immediately %} {% ifversion fpt or ghec %} @@ -95,8 +89,11 @@ Before using this method, be sure that you can receive text messages. Carrier ra {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.security %} {% data reusables.two_fa.enable-two-factor-authentication %} -4. Under "Two-factor authentication", select **Set up using SMS** and click **Continue**. -5. Under "Authentication verification", select your country code and type your mobile phone number, including the area code. When your information is correct, click **Send authentication code**. +4. Below "Setup authenticator app", select **SMS authentication** + + ![2FA SMS alternative option](/assets/images/help/2fa/2fa_sms_alt_option.png) + +5. Under "Setup SMS authentication", select your country code and type your mobile phone number, including the area code. When your information is correct, click **Send authentication code**. ![2FA SMS screen](/assets/images/help/2fa/2fa_wizard_sms_send.png) @@ -104,6 +101,7 @@ Before using this method, be sure that you can receive text messages. Carrier ra ![2FA SMS continue field](/assets/images/help/2fa/2fa_wizard_sms_enter_code.png) {% data reusables.two_fa.save_your_recovery_codes_during_2fa_setup %} +{% data reusables.two_fa.backup_options_during_2fa_enrollment %} {% data reusables.two_fa.test_2fa_immediately %} {% endif %} @@ -128,8 +126,7 @@ Authentication with a security key is *secondary* to authentication with a TOTP ![Providing a nickname for a security key](/assets/images/help/2fa/security-key-nickname.png) 8. Activate your security key, following your security key's documentation. ![Prompt for a security key](/assets/images/help/2fa/security-key-prompt.png) -9. Confirm that you've downloaded and can access your recovery codes. If you haven't already, or if you'd like to generate another set of codes, download your codes and save them in a safe place. If you lose access to your account, you can use your recovery codes to get back into your account. For more information, see "[Recovering your account if you lose your 2FA credentials](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)." - ![Download recovery codes button](/assets/images/help/2fa/2fa-recover-during-setup.png) +9. Confirm that you've downloaded and can access your recovery codes. If you haven't already, or if you'd like to generate another set of codes, download your codes and save them in a safe place. For more information, see "[Downloading your 2FA recovery codes](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods#downloading-your-two-factor-authentication-recovery-codes)." {% data reusables.two_fa.test_2fa_immediately %} {% ifversion fpt or ghec %} diff --git a/translations/es-ES/content/billing/managing-billing-for-github-codespaces/index.md b/translations/es-ES/content/billing/managing-billing-for-github-codespaces/index.md index d38eeec17c..64670e38d8 100644 --- a/translations/es-ES/content/billing/managing-billing-for-github-codespaces/index.md +++ b/translations/es-ES/content/billing/managing-billing-for-github-codespaces/index.md @@ -1,7 +1,7 @@ --- -title: Managing billing for GitHub Codespaces +title: Administrar la facturación para GitHub Codespaces shortTitle: Codespaces -intro: 'You can view your usage and set a spending limit for {% data variables.product.prodname_github_codespaces %}.' +intro: 'Puedes ver el uso y configurar un límite de gastos para {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -9,5 +9,11 @@ children: - /about-billing-for-github-codespaces - /viewing-your-github-codespaces-usage - /managing-the-spending-limit-for-github-codespaces +ms.openlocfilehash: 869239aefd5a2d244e7ff70735ad814802ed2616 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159097' --- diff --git a/translations/es-ES/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md b/translations/es-ES/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md index ad11575bec..2d1ce9136b 100644 --- a/translations/es-ES/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md +++ b/translations/es-ES/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md @@ -1,7 +1,7 @@ --- -title: Viewing your GitHub Codespaces usage +title: Visualización del uso de GitHub Codespaces shortTitle: Viewing your usage -intro: 'You can view the compute hours and storage used by {% data variables.product.prodname_github_codespaces %}.' +intro: 'Puedes ver las horas de proceso y almacenamiento que utilizan los {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -11,63 +11,64 @@ topics: - Billing redirect_from: - /billing/managing-billing-for-github-codespaces/viewing-your-codespaces-usage +ms.openlocfilehash: 67e29ee71b1881ee2ae6e9ca872fd7969f86afca +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158745' --- +## Visualización del uso de {% data variables.product.prodname_github_codespaces %} para la cuenta personal -## Viewing {% data variables.product.prodname_github_codespaces %} usage for your personal account +Puedes ver la cantidad de uso incluida en su cuenta personal que has usado hasta ahora en el ciclo de facturación mensual actual. Si has configurado un método de pago, establecido un límite de gasto y has usado todo el uso incluido, también puedes comprobar la factura del mes actual. -You can see how much of the usage included in your personal account you have used so far in the current monthly billing cycle. If you have set up a payment method, set a spending limit, and used all of your included usage, you can also check your bill for the current month. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.billing_plans %} +1. En "{% data variables.product.prodname_codespaces %}", puedes ver cuántas horas del uso de núcleo del proceso de {% data variables.product.prodname_github_codespaces %} y los GB-meses de almacenamiento que has usado hasta ahora en el mes de facturación actual. -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.billing_plans %} -1. Under "{% data variables.product.prodname_codespaces %}," you can see how many core hours of {% data variables.product.prodname_github_codespaces %} compute usage and GB-months of storage you have used so far in the current billing month. + ![Captura de pantalla de la vista inicial del uso personal](/assets/images/help/codespaces/view-personal-usage-collapsed.png) - ![Screenshot of the initial view of personal usage](/assets/images/help/codespaces/view-personal-usage-collapsed.png) + Para obtener información sobre "horas del uso de núcleos" y "GB-meses", consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/enterprise-cloud@latest/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". - For information about "core hours" and "GB-months," see "[About billing for {% data variables.product.prodname_github_codespaces %}](/enterprise-cloud@latest/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." +1. Opcionalmente, haz clic en **Horas de uso** y **Almacenamiento** para ver más detalles. -1. Optionally, click **Usage hours** and **Storage** to see more details. + ![Captura de pantalla de la vista expandida del uso personal](/assets/images/help/codespaces/view-personal-usage-expanded.png) - ![Screenshot of the expanded view of personal usage](/assets/images/help/codespaces/view-personal-usage-expanded.png) + En la columna **Incluido** se muestra el número de horas de uso de núcleos de proceso, o GB-meses de almacenamiento, incluidos gratis con tu cuenta, que has usado hasta ahora. La columna **Pago** muestra cuántas horas de uso de núcleo facturadas o GB-meses de almacenamiento has usado. Las cifras actualizan una vez cada hora. - The **Included** column shows how many of the core hours of compute usage, or GB-months of storage, included free with your account, you have used so far this month. The **Paid** column shows how many billed core hours of usage, or GB-months of storage, you have used. The figures are updated once every hour. - - In the screenshot above, the entire quota of included storage for the month has been used. When you've used all of either the included compute usage or storage (whichever is reached first), you must set up a payment method and a spending limit to continue using {% data variables.product.prodname_github_codespaces %} during the current billing month. For more information, see "[Adding or editing a payment method](/enterprise-cloud@latest/billing/managing-your-github-billing-settings/adding-or-editing-a-payment-method)" and "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces#managing-the-github-codespaces-spending-limit-for-your-personal-account)." + En la captura de pantalla anterior, se ha usado toda la cuota de almacenamiento incluido para el mes. Cuando hayas usado todo el uso de proceso o el almacenamiento incluidos (lo que se alcance primero), debes configurar un método de pago y un límite de gasto para seguir usando {% data variables.product.prodname_github_codespaces %} durante el mes de facturación actual. Para obtener más información, consulta "[Adición o edición de un método de pago](/enterprise-cloud@latest/billing/managing-your-github-billing-settings/adding-or-editing-a-payment-method)" y "[Administración de límites de gasto de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces#managing-the-github-codespaces-spending-limit-for-your-personal-account)". {% data reusables.codespaces.usage-report-download %} -## Viewing {% data variables.product.prodname_github_codespaces %} usage for your organization account +## Visualización del uso de {% data variables.product.prodname_github_codespaces %} para la cuenta de la organización -Organization owners and billing managers can view {% data variables.product.prodname_github_codespaces %} usage for the organization. +Los propietarios de la organización y los administradores de facturación pueden ver el uso de {% data variables.product.prodname_github_codespaces %} de la organización. {% data reusables.organizations.billing-settings %} -1. Under "{% data variables.product.prodname_codespaces %}", view the details of the compute hours and storage used so far this month. +1. En "{% data variables.product.prodname_codespaces %}", consulta los detalles de las horas de proceso y el almacenamiento usados hasta ahora. - ![Screenshot of compute usage and storage details](/assets/images/help/billing/codespaces-compute-storage.png) + ![Captura de pantalla de los detalles de uso y almacenamiento de proceso](/assets/images/help/billing/codespaces-compute-storage.png) - You can also see and update your current spending limit. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces)." + También puedes ver y actualizar el límite de gasto actual. Para más información, consulta "[Administración de los límites de gasto para {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces)". {% note %} - **Notes**: - * The costs shown here are the cumulative costs within the current monthly billing period. The metered costs for {% data variables.product.prodname_github_codespaces %} shown on this page are reset to zero at the start of each monthly billing period. Outstanding costs from previous months are not shown. - * The figures on this page are updated every hour. + **Notas**: + * Los costos que se muestran aquí son los costos acumulados en el periodo de facturación mensual actual. Los costos medidos de {% data variables.product.prodname_github_codespaces %} que se muestran en esta página se restablecen a cero al principio de cada periodo de facturación mensual. Los costos pendientes de los meses anteriores no se muestran. + * Las cifras de esta página se actualizan cada hora. {% endnote %} {% data reusables.codespaces.usage-report-download %} {% ifversion ghec %} -## Viewing {% data variables.product.prodname_codespaces %} usage for your enterprise account +## Visualización del uso de {% data variables.product.prodname_codespaces %} para la cuenta de empresa -Enterprise owners and billing managers can view {% data variables.product.prodname_github_codespaces %} usage for an enterprise account. +Los propietarios de empresas y los administradores de facturación pueden ver el uso de {% data variables.product.prodname_github_codespaces %} para una cuenta de empresa. -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -1. Under "{% data variables.product.prodname_codespaces %} monthly usage", view the usage details of each organization in your enterprise account. -{% data reusables.codespaces.usage-report-download %} -{% endif %} +{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} +1. En "Uso mensual de {% data variables.product.prodname_codespaces %}", puedes ver los detalles de uso de cada organización en tu cuenta empresarial. +{% data reusables.codespaces.usage-report-download %} {% endif %} -## Further reading +## Información adicional -- "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)" +- "[Enumeración de codespaces en la organización](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)" diff --git a/translations/es-ES/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md b/translations/es-ES/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md index dcdfa5e6df..7ce4b006b3 100644 --- a/translations/es-ES/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md +++ b/translations/es-ES/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md @@ -57,15 +57,25 @@ For example, if your organization uses {% data variables.product.prodname_team % At the end of the month, {% data variables.product.prodname_dotcom %} rounds your data transfer to the nearest GB. -{% data variables.product.prodname_dotcom %} calculates your storage usage for each month based on hourly usage during that month. For example, if you use 3 GB of storage for 10 days of March and 12 GB for 21 days of March, your storage usage would be: +{% data variables.product.prodname_dotcom %} calculates your storage usage for each month based on hourly usage per GB during that month. For example, if you use 3 GB of storage for 10 days of March and 12 GB for 21 days of March, your storage usage would be: - 3 GB x 10 days x (24 hours per day) = 720 GB-Hours - 12 GB x 21 days x (24 hours per day) = 6,048 GB-Hours -- 720 GB-Hours + 6,048 GB-Hours = 6,768 GB-Hours +- 720 GB-Hours + 6,048 GB-Hours = 6,768 total GB-Hours - 6,768 GB-Hours / (744 hours per month) = 9.0967 GB-Months At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB. Therefore, your storage usage for March would be 9.097 GB. +You can also use this calculation in the middle of a billing cycle, to estimate what your total usage might be for the month. For example, if you have an organization that uses {% data variables.product.prodname_team %}, which provides 2 GB of free storage, and you use 0 GB for the first 5 days of April, 1.5 GB for the following 10 days, and you plan to use 3 GB for the last 15 days of the billing cycle, your projected storage usage for the month would be: + +- 0 GB x 5 days x (24 hours per day) = 0 GB-Hours +- 0.5 GB x 10 days x (24 hours per day) = 120 GB-Hours +- 3 GB x 15 days x (24 hours per day) = 1080 GB-Hours +- 0 GB-Hours + 120 GB-Hours + 1080 GB-Hours = 1200 total GB-Hours +- 1200 GB-Hours / (744 hours per month) = 1.6 GB-Months + +The projected 1.6 GB of storage usage for the month would not exceed your 2 GB limit, even though your actual storage amount briefly exceeded 2 GB. + Your {% data variables.product.prodname_registry %} usage shares your account's existing billing date, payment method, and receipt. {% data reusables.dotcom_billing.view-all-subscriptions %} {% data reusables.user-settings.context_switcher %} @@ -74,6 +84,12 @@ Your {% data variables.product.prodname_registry %} usage shares your account's {% data reusables.package_registry.packages-spending-limit-detailed %} -For information on managing and changing your account's spending limit, see "[Managing your spending limit for {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/managing-your-spending-limit-for-github-packages)." +To prevent exceeding your spending limit, {% data variables.product.prodname_dotcom %} checks your storage consumption continuously throughout the month by looking at your current usage and calculating what your projected usage will be at the end of the month if no changes are made before that time. If at any point during the billing cycle your projected monthly usage exceeds your spending limit, both {% data variables.product.prodname_registry %} and {% data variables.product.prodname_actions %} will be disabled to prevent overages. -{% data reusables.dotcom_billing.actions-packages-unpaid-account %} +You should set a spending limit that will cover your maximum projected storage usage at any given point in the billing cycle. For example, imagine you have an organization that uses {% data variables.product.prodname_team %}, and you set a spending limit of $50 USD. {% data variables.product.prodname_team %} provides 2 GB of free storage. For any storage you use over that amount, {% data variables.product.prodname_dotcom %} will charge $0.008 USD per GB per day, or approximately $0.25 USD per GB for a 31-day month. That means the $50 spending limit you set will pay for an extra 200 GB of storage in that period. If on day ten of the billing cycle you reach 202 GB of storage, the next push of a package or {% data variables.product.prodname_actions %} artifact will fail, because you have reached the maximum storage amount that can be paid for by your spending limit in this billing cycle, even if your average consumption for the period is below 202 GB. + +To avoid reaching your spending limit in the current billing cycle, you can delete some of your current storage usage to free up projected usage for the rest of the month. This method is more effective toward the beginning of a billing cycle. The closer you get to the end of a billing cycle, the less impact this method will have on projected monthly usage. + +For more information about managing and changing your account's spending limit, see "[Managing your spending limit for {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/managing-your-spending-limit-for-github-packages)." + +{% data reusables.dotcom_billing.actions-packages-unpaid-account %} \ No newline at end of file diff --git a/translations/es-ES/content/billing/managing-billing-for-your-github-account/downgrading-your-github-subscription.md b/translations/es-ES/content/billing/managing-billing-for-your-github-account/downgrading-your-github-subscription.md index 28bbd81e9b..88dbd39dad 100644 --- a/translations/es-ES/content/billing/managing-billing-for-your-github-account/downgrading-your-github-subscription.md +++ b/translations/es-ES/content/billing/managing-billing-for-your-github-account/downgrading-your-github-subscription.md @@ -1,6 +1,6 @@ --- -title: Downgrading your GitHub subscription -intro: 'You can downgrade the subscription for any type of account on {% data variables.location.product_location %} at any time.' +title: Bajar de categoría tu suscripción de GitHub +intro: 'Puedes bajar tu suscripción de nivel en cualquier tipo de cuenta de {% data variables.location.product_location %} y en cualquier momento.' redirect_from: - /github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription - /articles/downgrading-your-personal-account-s-billing-plan @@ -27,79 +27,83 @@ topics: - Repositories - User account shortTitle: Downgrade subscription +ms.openlocfilehash: e302fb715fc2937c7ed056b813b073a66a7cc1fa +ms.sourcegitcommit: fdc4466e89467a7b13239e26c6042dc1428946b6 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163788' --- -## Downgrading your {% data variables.product.product_name %} subscription +## Bajar de nivel tu suscripción de {% data variables.product.product_name %} -When you downgrade your personal account or organization's subscription, pricing and account feature changes take effect on your next billing date. Changes to your paid personal account or organization subscription does not affect subscriptions or payments for other paid {% data variables.product.prodname_dotcom %} features. For more information, see "[How does upgrading or downgrading affect the billing process?](/articles/how-does-upgrading-or-downgrading-affect-the-billing-process)." +Cuando bajas de nivel tu suscripción de cuenta personal o de organización, los cambios de precios y características toman efecto en la fecha de facturación siguiente. Los cambios a tu suscripción de cuenta personal u organización no afectan a las suscripciones o pagos de otras características pagadas de {% data variables.product.prodname_dotcom %}. Para obtener más información, consulte "[¿Cómo afecta el cambio a una categoría inferior o superior al proceso de facturación?](/articles/how-does-upgrading-or-downgrading-affect-the-billing-process)". -## Downgrading your personal account's subscription +## Bajar de categoría la suscripción de tu cuenta personal -If you downgrade your personal account from {% data variables.product.prodname_pro %} to {% data variables.product.prodname_free_user %}, the account will lose access to advanced code review tools on private repositories. {% data reusables.gated-features.more-info %} +Si bajas de nivel tu cuenta personal desde {% data variables.product.prodname_pro %} a {% data variables.product.prodname_free_user %}, ésta perderá acceso a las herramientas avanzadas de revisión de código en los repositorios privados. {% data reusables.gated-features.more-info %} -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.billing_plans %} -1. Under "Current plan", use the **Edit** drop-down and click **Downgrade to Free**. - ![Downgrade to free button](/assets/images/help/billing/downgrade-to-free.png) -5. Read the information about the features your personal account will no longer have access to on your next billing date, then click **I understand. Continue with downgrade**. - ![Continue with downgrade button](/assets/images/help/billing/continue-with-downgrade.png) +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.billing_plans %} +1. En "Current plan", use la lista desplegable **Edit** y haga clic en **Downgrade to Free**. + ![Botón Downgrade to free](/assets/images/help/billing/downgrade-to-free.png) +5. Lee la información sobre las características a las que tu cuenta personal ya no tendrá acceso en la próxima fecha de facturación y, después, haz clic en **Entiendo. Continuar para bajar de nivel**. + ![Botón para continuar con el cambio a una categoría inferior](/assets/images/help/billing/continue-with-downgrade.png) -If you published a {% data variables.product.prodname_pages %} site in a private repository and added a custom domain, remove or update your DNS records before downgrading from {% data variables.product.prodname_pro %} to {% data variables.product.prodname_free_user %}, to avoid the risk of a domain takeover. For more information, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)." +Si publicaste un sitio de {% data variables.product.prodname_pages %} en un repositorio privado y añadiste un dominio personalizado, retira o actualiza tus registros de DNS antes de bajarlo de nivel desde {% data variables.product.prodname_pro %} a {% data variables.product.prodname_free_user %}, para evitar el riesgo de que te ganen el dominio. Para obtener más información, consulte "[Administración de un dominio personalizado para el sitio de {% data variables.product.prodname_pages %}](/articles/managing-a-custom-domain-for-your-github-pages-site)". -## Downgrading your organization's subscription +## Bajar de nivel tu suscripción de orgnización {% data reusables.dotcom_billing.org-billing-perms %} -If you downgrade your organization from {% data variables.product.prodname_team %} to {% data variables.product.prodname_free_team %} for an organization, the account will lose access to advanced collaboration and management tools for teams. +Si bajas tu organización de nivel desde {% data variables.product.prodname_team %} a {% data variables.product.prodname_free_team %} para organizaciones, la cuenta perderá acceso a las herramientas de administración y colaboración para equipos. -If you downgrade your organization from {% data variables.product.prodname_ghe_cloud %} to {% data variables.product.prodname_team %} or {% data variables.product.prodname_free_team %}, the account will lose access to advanced security, compliance, and deployment controls. {% data reusables.gated-features.more-info %} +Si bajas a tu organización de nivel desde {% data variables.product.prodname_ghe_cloud %} a {% data variables.product.prodname_team %} o {% data variables.product.prodname_free_team %}, la cuenta perderá acceso a los controles avanzados de seguridad, cumplimiento y despliegue. {% data reusables.gated-features.more-info %} {% note %} -**Notes:** - - If your organization is owned by an enterprise account, billing cannot be managed at the organization level. To downgrade, you must remove the organization from the enterprise account first. For more information, see "[Removing organizations from your enterprise](/enterprise-cloud@latest/admin/user-management/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise)." - - If you're currently trialing {% data variables.product.prodname_ghe_cloud %}, and you don't purchase {% data variables.product.prodname_enterprise %} before the trial ends, your organization will be automatically downgraded to {% data variables.product.prodname_free_team %} or {% data variables.product.prodname_team %}. For more information, see "[Setting up a trial of {% data variables.product.prodname_ghe_cloud %}](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud#finishing-your-trial)." +**Notas:** + - Si tu organización pertenece a una cuenta empresarial, la facturación no se podrá administrar en el nivel de la organización. Para bajar de categoría, primero debes quitar la organización de la cuenta de empresa. Para obtener más información, consulta "[Eliminación de las organizaciones de tu empresa](/enterprise-cloud@latest/admin/user-management/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise)". + - Si actualmente estás probando {% data variables.product.prodname_ghe_cloud %} y no compras {% data variables.product.prodname_enterprise %} antes de que termine la evaluación gratuita, la organización bajará de categoría automáticamente a {% data variables.product.prodname_free_team %} o a {% data variables.product.prodname_team %}. Para obtener más información, consulte "[Configuración de una evaluación gratuita de {% data variables.product.prodname_ghe_cloud %}](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud#finishing-your-trial)". {% endnote %} {% data reusables.organizations.billing-settings %} -1. Under "Current plan", use the **Edit** drop-down and click the downgrade option you want. - ![Downgrade button](/assets/images/help/billing/downgrade-option-button.png) -{% data reusables.dotcom_billing.confirm_cancel_org_plan %} +1. En "Current plan", use la lista desplegable **Edit** y haga clic en la opción de disminución de categoría que desee. + ![Downgrade button](/assets/images/help/billing/downgrade-option-button.png) {% data reusables.dotcom_billing.confirm_cancel_org_plan %} -## Downgrading an organization's subscription with legacy per-repository pricing +## Bajar de nivel la suscripción de una organización con precios tradicionales por repositorio {% data reusables.dotcom_billing.org-billing-perms %} -{% data reusables.dotcom_billing.switch-legacy-billing %} For more information, see "[Switching your organization from per-repository to per-user pricing](/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription#switching-your-organization-from-per-repository-to-per-user-pricing)." +{% data reusables.dotcom_billing.switch-legacy-billing %} Para obtener más información, consulte "[Cambiar la organización de una tarifa por repositorios a una tarifa por usuarios](/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription#switching-your-organization-from-per-repository-to-per-user-pricing)." {% data reusables.organizations.billing-settings %} -5. Under "Subscriptions", select the "Edit" drop-down, and click **Edit plan**. - ![Edit Plan dropdown](/assets/images/help/billing/edit-plan-dropdown.png) -1. Under "Billing/Plans", next to the plan you want to change, click **Downgrade**. - ![Downgrade button](/assets/images/help/billing/downgrade-plan-option-button.png) -1. Enter the reason you're downgrading your account, then click **Downgrade plan**. - ![Text box for downgrade reason and downgrade button](/assets/images/help/billing/downgrade-plan-button.png) +5. En "Subscriptions", seleccione la lista desplegable "Edit" y haga clic en **Edit plan**. + ![Menú desplegable Edit Plan](/assets/images/help/billing/edit-plan-dropdown.png) +1. En "Billing/Plans", junto al plan que desea cambiar, haga clic en **Downgrade**. + ![Botón Downgrade](/assets/images/help/billing/downgrade-plan-option-button.png) +1. Escriba el motivo por el que va a disminuir la categoría de su cuenta y, a continuación, haga clic en **Downgrade plan**. + ![Cuadro de texto para escribir el motivo de la disminución de categoría y botón Downgrade](/assets/images/help/billing/downgrade-plan-button.png) -## Removing paid seats from your organization +## Eliminar asientos pagos de tu organización -To reduce the number of paid seats your organization uses, you can remove members from your organization or convert members to outside collaborators and give them access to only public repositories. For more information, see: -- "[Removing a member from your organization](/articles/removing-a-member-from-your-organization)" -- "[Converting an organization member to an outside collaborator](/articles/converting-an-organization-member-to-an-outside-collaborator)" -- "[Managing an individual's access to an organization repository](/articles/managing-an-individual-s-access-to-an-organization-repository)" +Para reducir el número de asientos pagos que usa tu organización, puedes eliminar miembros de tu organización o convertirlos en colaboradores externos y darles acceso únicamente a los repositorios públicos. Para más información, consulte: +- "[Eliminar a un miembro de la organización](/articles/removing-a-member-from-your-organization)" +- "[Convertir un miembro de la organización en un colaborador externo](/articles/converting-an-organization-member-to-an-outside-collaborator)" +- "[Administración del acceso de un individuo a un repositorio de la organización](/articles/managing-an-individual-s-access-to-an-organization-repository)" {% data reusables.organizations.billing-settings %} -1. Under "Current plan", use the **Edit** drop-down and click **Remove seats**. - ![remove seats dropdown](/assets/images/help/billing/remove-seats-dropdown.png) -1. Under "Remove seats", select the number of seats you'd like to downgrade to. - ![remove seats option](/assets/images/help/billing/remove-seats-amount.png) -1. Review the information about your new payment on your next billing date, then click **Remove seats**. - ![remove seats button](/assets/images/help/billing/remove-seats-button.png) +1. En "Current plan", use la lista desplegable **Edit** y haga clic en **Remove seats**. + ![menú desplegable remove seats](/assets/images/help/billing/remove-seats-dropdown.png) +1. En "Eliminar asientos" selecciona el número de asientos pagos de la categoría a la que deseas bajar. + ![opción remove seats](/assets/images/help/billing/remove-seats-amount.png) +1. Revise la información sobre el nuevo pago en la siguiente fecha de facturación y, a continuación, haga clic en **Remove seats**. + ![botón remove seats](/assets/images/help/billing/remove-seats-button.png) -## Further reading +## Información adicional -- "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)" -- "[How does upgrading or downgrading affect the billing process?](/articles/how-does-upgrading-or-downgrading-affect-the-billing-process)" -- "[About billing on {% data variables.product.prodname_dotcom %}](/articles/about-billing-on-github)." -- "[About per-user pricing](/articles/about-per-user-pricing)" +- "[Productos de {% data variables.product.prodname_dotcom %}](/articles/github-s-products)" +- "[¿Cómo afecta el cambio a una versión posterior o anterior al proceso de facturación?](/articles/how-does-upgrading-or-downgrading-affect-the-billing-process)" +- "[Acerca de la facturación en {% data variables.product.prodname_dotcom %}](/articles/about-billing-on-github)" +- "[Acerca de los precios por usuario](/articles/about-per-user-pricing)" diff --git a/translations/es-ES/content/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise.md b/translations/es-ES/content/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise.md index 7bc6979232..7a52a681b0 100644 --- a/translations/es-ES/content/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise.md +++ b/translations/es-ES/content/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise.md @@ -22,7 +22,14 @@ For privacy reasons, enterprise owners cannot directly access the details of use ## About the calculation of consumed licenses -{% data variables.product.company_short %} bills for each person who uses deployments of {% data variables.product.prodname_ghe_server %}, is a member of one of your organizations on {% data variables.product.prodname_ghe_cloud %}, or is a {% data variables.visual_studio.prodname_vs_subscriber %}. For more information about the people in your enterprise who consume a license, see "[About per-user pricing](/billing/managing-billing-for-your-github-account/about-per-user-pricing)." +If a user meets one or more of the following conditions, {% data variables.product.company_short %} bills for the user. + +- The user utilizes deployments of {% data variables.product.prodname_ghe_server %}. +- The user is a member of one of your organizations on {% data variables.product.prodname_ghe_cloud %}. +- The user has write access to one of your organization's private repositories. +- The user is a {% data variables.visual_studio.prodname_vs_subscriber %}. + +Invitations for these roles will consume a license until the invitation is accepted or expires. For more information about the people in your enterprise who consume a license, see "[About per-user pricing](/billing/managing-billing-for-your-github-account/about-per-user-pricing)." For each user to consume a single seat regardless of how many deployments they use, you must synchronize license usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Syncing license usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}](/billing/managing-your-license-for-github-enterprise/syncing-license-usage-between-github-enterprise-server-and-github-enterprise-cloud)." diff --git a/translations/es-ES/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md b/translations/es-ES/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md index 0e0910c214..f4241ca377 100644 --- a/translations/es-ES/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md +++ b/translations/es-ES/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md @@ -62,7 +62,7 @@ You can also enable or disable {% data variables.product.prodname_dependabot_sec You can override the default behavior of {% data variables.product.prodname_dependabot_security_updates %} by adding a dependabot.yml file to your repository. For more information, see "[Configuration options for the dependabot.yml file](/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file)." -If you only require security updates and want to exclude version updates, you can set `open-pull-request-limit` to `0` in order to prevent version updates for a given `package-ecosystem`. For more information, see "[`open-pull-request-limit`](/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file#open-pull-requests-limit)." +If you only require security updates and want to exclude version updates, you can set `open-pull-requests-limit` to `0` in order to prevent version updates for a given `package-ecosystem`. For more information, see "[`open-pull-requests-limit`](/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file#open-pull-requests-limit)." ``` # Example configuration file that: diff --git a/translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities.md b/translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities.md new file mode 100644 index 0000000000..c0015f7d0a --- /dev/null +++ b/translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities.md @@ -0,0 +1,94 @@ +--- +title: About coordinated disclosure of security vulnerabilities +intro: Vulnerability disclosure is a coordinated effort between security reporters and repository maintainers. +redirect_from: + - /code-security/security-advisories/about-coordinated-disclosure-of-security-vulnerabilities + - /code-security/repository-security-advisories/about-coordinated-disclosure-of-security-vulnerabilities + - /code-security/security-advisories/repository-security-advisories/about-coordinated-disclosure-of-security-vulnerabilities +miniTocMaxHeadingLevel: 3 +versions: + fpt: '*' + ghec: '*' +type: overview +topics: + - Security advisories + - Vulnerabilities +shortTitle: Coordinated disclosure +--- + +## About disclosing vulnerabilities in the industry + +{% data reusables.security-advisory.disclosing-vulnerabilities %} + +The initial report of a vulnerability is made privately, and the full details are only published once the maintainer has acknowledged the issue, and ideally made remediations or a patch available, sometimes with a delay to allow more time for the patches to be installed. For more information, see the "[OWASP Cheat Sheet Series about vulnerability disclosure](https://cheatsheetseries.owasp.org/cheatsheets/Vulnerability_Disclosure_Cheat_Sheet.html#commercial-and-open-source-software)" on the OWASP Cheat Sheet Series website. + +### Best practices for vulnerability reporters + +It's good practice to report vulnerabilities privately to maintainers. When possible, as a vulnerability reporter, we recommend you avoid: +- Disclosing the vulnerability publicly without giving maintainers a chance to remediate. +- Bypassing the maintainers. +- Disclosing the vulnerability before a fixed version of the code is available. +- Expecting to be compensated for reporting an issue, where no public bounty program exists. + +It's acceptable for vulnerability reporters to disclose a vulnerability publicly after a period of time, if they have tried to contact the maintainers and not received a response, or contacted them and been asked to wait too long to disclose it. + +We recommend vulnerability reporters clearly state the terms of their disclosure policy as part of their reporting process. Even if the vulnerability reporter does not adhere to a strict policy, it's a good idea to set clear expectations for maintainers in terms of timelines on intended vulnerability disclosures. For an example of disclosure policy, see the "[Security Lab's disclosure policy](https://securitylab.github.com/advisories#policy)" on the GitHub Security Lab website. + +### Best practices for maintainers + +As a maintainer, it's good practice to clearly indicate how and where you want to receive reports for vulnerabilities. If this information is not clearly available, vulnerability reporters don't know how to contact you, and may resort to extracting developer email addresses from git commit histories to try to find an appropriate security contact. This can lead to friction, lost reports, or the publication of unresolved reports. + +Maintainers should disclose vulnerabilities in a timely manner. If there is a security vulnerability in your repository, we recommend you: +- Treat the vulnerability as a security issue rather than a simple bug, both in your response and your disclosure. For example, you'll need to explicitly mention that the issue is a security vulnerability in the release notes. +- Acknowledge receipt of the vulnerability report as quickly as possible, even if no immediate resources are available for investigation. This sends the message that you are quick to respond and act, and it sets a positive tone for the rest of the interaction between you and the vulnerability reporter. +- Involve the vulnerability reporter when you verify the impact and veracity of the report. It's likely the vulnerability reporter has already spent time considering the vulnerability in a variety of scenarios, some of which you may have not considered yourself. +- Remediate the issue in a way that you see fit, taking any concerns and advice provided by the vulnerability reporter into careful consideration. Often the vulnerability reporter will have knowledge of certain corner cases and remediation bypasses that are easy to miss without a security research background. +- Always acknowledge the vulnerability reporter when you credit the discovery. +- Aim to publish a fix as soon as you can. +- Ensure that you make the wider ecosystem aware of the issue and its remediation when you disclose the vulnerability. It is not uncommon to see cases where a recognized security issue is fixed in the current development branch of a project, but the commit or subsequent release is not explicitly marked as a security fix or release. This can cause problems with downstream consumers. + +Publishing the details of a security vulnerability doesn't make maintainers look bad. Security vulnerabilities are present everywhere in software, and users will trust maintainers who have a clear and established process for disclosing security vulnerabilities in their code. + +## About reporting and disclosing vulnerabilities in projects on {% data variables.product.prodname_dotcom %} + +There are two processes available on {% data variables.product.prodname_dotcom %}: + +- The standard process: Vulnerability reporters get in touch with the repository maintainers, using contact information located in the security policy for the repository. The repository maintainers then create a draft repository advisory if required. +- Private vulnerability reporting: Vulnerability reporters disclose vulnerability details directly and privately to the repository maintainers by proposing a draft repository advisory and providing details of their findings. + +### Standard process + +The process for reporting and disclosing vulnerabilities for projects on {% data variables.product.prodname_dotcom_the_website %} is as follows: + + If you are a vulnerability reporter (for example, a security researcher) who would like report a vulnerability, first check if there is a security policy for the related repository. For more information, see "[About security policies](/code-security/getting-started/adding-a-security-policy-to-your-repository#about-security-policies)." If there is one, follow it to understand the process before contacting the security team for that repository. + + If there isn't a security policy in place, the most efficient way to establish a private means of communication with maintainers is to create an issue asking for a preferred security contact. It's worth noting that the issue will be immediately publicly visible, so it should not include any information about the bug. Once communication is established, you can suggest the maintainers define a security policy for future use. + +{% note %} + +**Note**: _For npm only_ - If we receive a report of malware in an npm package, we try to contact you privately. If you don't address the issue in a timely manner, we will disclose it. For more information, see "[Reporting malware in an npm package](https://docs.npmjs.com/reporting-malware-in-an-npm-package)" on the npm Docs website. + +{% endnote %} + + If you've found a security vulnerability in {% data variables.product.prodname_dotcom_the_website %}, please report the vulnerability through our coordinated disclosure process. For more information, see the [{% data variables.product.prodname_dotcom %} Security Bug Bounty](https://bounty.github.com/) website. + + If you are a maintainer, you can take ownership of the process at the very beginning of the pipeline by setting up a security policy for your repository, or otherwise making security reporting instructions clearly available, for example in your project’s README file. For information about adding a security policy, see "[About security policies](/code-security/getting-started/adding-a-security-policy-to-your-repository#about-security-policies)." If there is no security policy, it's likely that a vulnerability reporter will try to email you or otherwise privately contact you. Alternatively, someone may open a (public) issue with details of a security issue. + + As a maintainer, to disclose a vulnerability in your code, you first create a draft security advisory in the package's repository in {% data variables.product.prodname_dotcom %}. {% data reusables.security-advisory.security-advisory-overview %} For more information, see "[About repository security advisories](/code-security/repository-security-advisories/about-github-security-advisories-for-repositories)." + + To get started, see "[Creating a repository security advisory](/code-security/repository-security-advisories/creating-a-repository-security-advisory)." + +### Private vulnerability reporting + +{% data reusables.security-advisory.private-vulnerability-reporting-beta %} + +{% data reusables.security-advisory.private-vulnerability-reporting-enable %} + + Private vulnerability reporting provides an easy way for vulnerability reporters to privately disclose security risks to repository maintainers, within {% data variables.product.prodname_dotcom %}, and in a way that immediately notifies the repository maintainers of the issue. For more information for security researchers and repository maintainers, see "[Privately reporting a security vulnerability](/code-security/security-advisories/guidance-on-reporting-and-writing/privately-reporting-a-security-vulnerability)" and "[Managing privately reported security vulnerabilities](/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities)", respectively. + +{% note %} + +**Note**: +If the repository containing the vulnerability doesn't have private vulnerability reporting enabled, both security researchers and repository maintainers need to follow the instructions described in the "[Standard process](#standard-process)" section above. + +{% endnote %} diff --git a/translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md b/translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md new file mode 100644 index 0000000000..d6daeb7614 --- /dev/null +++ b/translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md @@ -0,0 +1,45 @@ +--- +title: Managing privately reported security vulnerabilities +intro: Repository maintainers can manage security vulnerabilities that have been privately reported to them by security reseachers for repositories where private vulnerability reporting is enabled. +permissions: 'Anyone with admin permissions to a repository can see, review, and manage privately-reported vulnerabilities for the repository.' +versions: + fpt: '*' + ghec: '*' +type: how_to +miniTocMaxHeadingLevel: 3 +topics: + - Security advisories + - Vulnerabilities +shortTitle: Manage vulnerability reports +--- + +{% data reusables.security-advisory.private-vulnerability-reporting-beta %} + +{% data reusables.security-advisory.private-vulnerability-reporting-enable %} + +## About privately reporting a security vulnerability + +Private vulnerability reporting makes it easy for security researchers to report vulnerabilities directly to you using a simple form. + +When a security researcher reports a vulnerability privately, you are notified and can choose to either accept it, ask more questions, or reject it. If you accept the report, you're ready to collaborate on a fix for the vulnerability in private with the security researcher. + +## Managing security vulnerabilities that are privately reported + +{% data variables.product.prodname_dotcom %} notifies repository maintainers when security researchers privately report vulnerabilities in their repository, and sends notifications if maintainers watch the repository or if they have notifications enabled for the repository. For more information, see "[Configuring notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-advisories %} +1. Click the advisory you want to review. An advisory that is privately reported will have a status of `Needs triage`. + + ![Screenshot showing an example of advisory list](/assets/images/help/security/advisory-list.png) + +2. Carefully review the report. You can: + - Collaborate with the security researcher on a patch in private, by clicking **Start a temporary private fork**. This gives you a place for further discussions with the contributor without changing the status of the proposed advisory from `Needs triage`. + - Accept the vulnerability report as a draft advisory on {% data variables.product.prodname_dotcom %}, by clicking **Accept and open as draft**. If you choose this option: + - This doesn't make the report public. + - The report becomes a draft repository security advisory and you can work on it in the same way as any draft advisory that you create. + For more information on security advisories, see "[About repository security advisories](/code-security/security-advisories/repository-security-advisories/about-repository-security-advisories)." + - Reject the report by clicking **Close security advisory**. Where possible, you should add a comment explaining why you don't consider the report a security risk before you close the advisory. + + ![Screenshot showing the options available to the repository maintainer when reviewing an externally submitted vulnerability report](/assets/images/help/security/advisory-maintainer-options.png) \ No newline at end of file diff --git a/translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review.md b/translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review.md index 0f6307553b..42002b8748 100644 --- a/translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review.md +++ b/translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review.md @@ -1,6 +1,6 @@ --- -title: Configuring dependency review -intro: You can use dependency review to catch vulnerabilities before they are added to your project. +title: Configuración de la revisión de dependencias +intro: Puedes usar la revisión de dependencias para detectar vulnerabilidades antes de que se agreguen al proyecto. miniTocMaxHeadingLevel: 3 shortTitle: Configure dependency review versions: @@ -15,80 +15,71 @@ topics: - Vulnerabilities - Dependencies - Pull requests +ms.openlocfilehash: b5e5ccb5107cd96d1a88f896fd46d5b948a365cd +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163356' --- - -## About dependency review +## Acerca de la revisión de dependencias {% data reusables.dependency-review.feature-overview %} -For more information, see "[About dependency review](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)" and "[Reviewing dependency changes in a pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request)." +Para obtener más información, consulta «[Acerca de la revisión de dependencias](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)» y «[Revisión de los cambios de dependencia en una solicitud de incorporación de cambios](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request)». -## About configuring dependency review +## Acerca de la configuración de la revisión de dependencias -{% ifversion fpt %} -Dependency review is available in all public repositories in all products and cannot be disabled. Dependency review is available in private repositories owned by organizations that use GitHub Enterprise Cloud and have a license for [{% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security). For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review). +{% ifversion fpt %} La revisión de dependencias está disponible en todos los repositorios públicos de todos los productos y no puede deshabilitarse. La revisión de dependencias está disponible en repositorios privados propiedad de las organizaciones que usan GitHub Enterprise Cloud y que tienen una licencia para [{% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security). Para más información, vea la [documentación de {% data variables.product.prodname_ghe_cloud %}](/enterprise-cloud@latest/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review). -{% elsif ghec %} -Dependency review is included in {% data variables.product.product_name %} for public repositories. To use dependency review in private repositories owned by organizations, you must have a license for [{% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security) and have the dependency graph enabled. +{% elsif ghec %} La revisión de dependencias se incluye en {% data variables.product.product_name %} para los repositorios públicos. Para usar la revisión de dependencias en repositorios privados propiedad de las organizaciones, debes tener una licencia para [{% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security) y tener habilitado el gráfico de dependencias. {% data reusables.dependabot.enabling-disabling-dependency-graph-private-repo %} -1. If "{% data variables.product.prodname_GH_advanced_security %}" is not enabled, click **Enable** next to the feature. - ![Screenshot of GitHub Advanced Security feature with "Enable" button emphasized](/assets/images/help/security/enable-ghas-private-repo.png) +1. Si «{% data variables.product.prodname_GH_advanced_security %}» no está habilitado, haz clic en **Habilitar** junto a la característica. + ![Captura de pantalla de la característica de seguridad avanzada de GitHub con el botón «Habilitar» resaltado](/assets/images/help/security/enable-ghas-private-repo.png) {% elsif ghes or ghae %} -Dependency review is available when dependency graph is enabled for {% data variables.location.product_location %} and {% data variables.product.prodname_advanced_security %} is enabled for the organization or repository.{% ifversion ghes %} For more information, see "[Enabling {% data variables.product.prodname_GH_advanced_security %} for your enterprise](/admin/code-security/managing-github-advanced-security-for-your-enterprise/enabling-github-advanced-security-for-your-enterprise)."{% endif %} +La revisión de dependencias está disponible cuando el gráfico de dependencias está habilitado para {% data variables.location.product_location %} y {% data variables.product.prodname_advanced_security %} está habilitado para la organización o el repositorio.{% ifversion ghes %} Para obtener más información, consulta "[Habilitación de {% data variables.product.prodname_GH_advanced_security %} para la empresa](/admin/code-security/managing-github-advanced-security-for-your-enterprise/enabling-github-advanced-security-for-your-enterprise)".{% endif %} -### Checking if the dependency graph is enabled +### Comprobación de si el gráfico de dependencias está habilitado -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-code-security-and-analysis %} -1. Under "Configure security and analysis features", check if the dependency graph is enabled. -1. If dependency graph is enabled, click **Enable** next to "{% data variables.product.prodname_GH_advanced_security %}" to enable {% data variables.product.prodname_advanced_security %}, including dependency review. The enable button is disabled if your enterprise has no available licenses for {% data variables.product.prodname_advanced_security %}.{% ifversion ghes %} - ![Screenshot of "Code security and analysis" features"](/assets/images/enterprise/3.4/repository/code-security-and-analysis-enable-ghas-3.4.png){% endif %} +{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.navigate-to-code-security-and-analysis %} +1. En «Configurar características de seguridad y análisis», comprueba si el gráfico de dependencias está habilitado. +1. Si el gráfico de dependencias está habilitado, haz clic en **Habilitar** junto a «{% data variables.product.prodname_GH_advanced_security %}» para habilitar {% data variables.product.prodname_advanced_security %}, incluida la revisión de dependencias. El botón Habilitar está deshabilitado si tu empresa no tiene licencias disponibles para{% data variables.product.prodname_advanced_security %}.{% ifversion ghes %} ![Captura de pantalla de la configuración de características de seguridad y análisis.](/assets/images/enterprise/3.4/repository/code-security-and-analysis-enable-ghas-3.4.png){% endif %} {% endif %} {% ifversion dependency-review-action-configuration %} -## About configuring the {% data variables.product.prodname_dependency_review_action %} +## Acerca de la configuración de la {% data variables.product.prodname_dependency_review_action %} {% data reusables.dependency-review.dependency-review-action-overview %} -The following configuration options are available. +Están disponibles las siguientes opciones de configuración. -| Option | Required | Usage | +| Opción | Obligatorio | Uso | |------------------|-------------------------------|--------| -| `fail-on-severity` | Optional | Defines the threshold for level of severity (`low`, `moderate`, `high`, `critical`).
The action will fail on any pull requests that introduce vulnerabilities of the specified severity level or higher. | -{%- ifversion dependency-review-action-licenses %} -| `allow-licenses` | Optional | Contains a list of allowed licenses. You can find the possible values for this parameter in the [Licenses](/rest/licenses) page of the API documentation.
The action will fail on pull requests that introduce dependencies with licenses that do not match the list.|{% endif %} -{%- ifversion dependency-review-action-licenses %} -| `deny-licenses` | Optional | Contains a list of prohibited licenses. You can find the possible values for this parameter in the [Licenses](/rest/licenses) page of the API documentation.
The action will fail on pull requests that introduce dependencies with licenses that match the list.|{% endif %}{% ifversion dependency-review-action-fail-on-scopes %} -| `fail-on-scopes` | Optional | Contains a list of strings representing the build environments you want to support (`development`, `runtime`, `unknown`).
The action will fail on pull requests that introduce vulnerabilites in the scopes that match the list.|{% endif %} -| `allow-ghsas` | Optional | Contains a list of {% data variables.product.prodname_advisory_database %} IDs that can be skipped during detection. You can find the possible values for this parameter in the [{% data variables.product.prodname_advisory_database %}](https://github.com/advisories). | -| `config-file` | Optional | Specifies a path to a configuration file. The configuration file can be local to the repository or a file located in an external repository.| -| `external-repo-token` | Optional | Specifies a token for fetching the configuration file, if the file resides in a private external repository. The token must have read access to the repository.| +| `fail-on-severity` | Opcionales | Define el umbral del nivel de gravedad (`low`, `moderate`, `high` y `critical`).
La acción generará un error en las solicitudes de incorporación de cambios que introduzcan vulnerabilidades del nivel de gravedad especificado o superior. | +{%- ifversion dependency-review-action-licenses %} | `allow-licenses` | Opcional | Contiene una lista de licencias permitidas. Encontrarás los valores posibles para este parámetro en la página [Licencias](/rest/licenses) de la documentación de la API.
La acción producirá un error en las solicitudes de incorporación de cambios que introducen dependencias con licencias que no coinciden con la lista.{% endif %} {%- ifversion dependency-review-action-licenses %} | `deny-licenses` | Opcional | Contiene una lista de licencias prohibidas. Encontrarás los valores posibles para este parámetro en la página [Licencias](/rest/licenses) de la documentación de la API.
La acción producirá un error en las solicitudes de incorporación de cambios que introducen dependencias con licencias que coinciden con la lista.|{% endif %}{% ifversion dependency-review-action-fail-on-scopes %} | `fail-on-scopes` | Opcional | Contiene una lista de cadenas que representan los entornos de compilación que desea admitir (`development`, `runtime`, `unknown`).
La acción producirá un error en las solicitudes de incorporación de cambios que introducen vulnerabilidades en los ámbitos que coinciden con la lista.| {% endif %} | `allow-ghsas` | Opcional | Contiene una lista de {% data variables.product.prodname_advisory_database %} Identificadores que se pueden omitir durante la detección. Puedes encontrar los valores posibles para este parámetro en los [{% data variables.product.prodname_advisory_database %}](https://github.com/advisories). | | `config-file` | Opcional | Especifica una ruta de acceso a un archivo de configuración. El archivo de configuración puede ser local en el repositorio o en un archivo ubicado en un repositorio externo.| | `external-repo-token` | Optional | Especifica un token para capturar el archivo de configuración, si este reside en un repositorio externo privado. El token debe tener acceso de lectura al repositorio.| -{% ifversion dependency-review-action-licenses %} -{% tip %} +{% ifversion dependency-review-action-licenses %} {% tip %} -**Tip:** The `allow-licenses` and `deny-licenses` options are mutually exclusive. +**Sugerencia**: Las opciones `allow-licenses` y `deny-licenses` se excluyen mutuamente. -{% endtip %} -{% endif %} +{% endtip %} {% endif %} -## Configuring the {% data variables.product.prodname_dependency_review_action %} +## Configuración de la {% data variables.product.prodname_dependency_review_action %} -There are two methods of configuring the {% data variables.product.prodname_dependency_review_action %}: -- Inlining the configuration options in your workflow file. -- Referencing a configuration file in your workflow file. +Hay dos métodos para configurar la {% data variables.product.prodname_dependency_review_action %}: +- Insertar las opciones de configuración en el archivo de flujo de trabajo. +- Hacer referencia a un archivo de configuración en el archivo de flujo de trabajo. -Notice that all of the examples use a short version number for the action (`v3`) instead of a semver release number (for example, `v3.0.8`). This ensures that you use the most recent minor version of the action. -### Using inline configuration to set up the {% data variables.product.prodname_dependency_review_action %} +Observa que en todos los ejemplos se usa un número de versión corto para la acción (`v3`) en lugar de un número de versión SemVer (por ejemplo, `v3.0.8`). Esto garantiza que uses la versión secundaria más reciente de la acción. +### Usar la configuración insertada para configurar la {% data variables.product.prodname_dependency_review_action %} -1. Add a new YAML workflow to your `.github/workflows` folder. +1. Agrega un nuevo flujo de trabajo YAML a la carpeta `.github/workflows`. - {% ifversion ghes %}For `runs-on`, the default label is `self-hosted`. You can replace the default label with the label of any of your runners.{% endif %} + {% ifversion ghes %}Para `runs-on`, la etiqueta predeterminada es `self-hosted`. Puedes reemplazar la etiqueta predeterminada por la etiqueta de cualquiera de los ejecutores.{% endif %} ```yaml{:copy} name: 'Dependency Review' on: [pull_request] @@ -106,9 +97,9 @@ Notice that all of the examples use a short version number for the action (`v3`) - name: Dependency Review uses: actions/dependency-review-action@v3 ``` -1. Specify your settings. +1. Especifique su configuración. - This {% data variables.product.prodname_dependency_review_action %} example file illustrates how you can use the available configuration options. + En este archivo de ejemplo de {% data variables.product.prodname_dependency_review_action %} se muestra cómo se pueden usar las opciones de configuración disponibles. ```yaml{:copy} name: 'Dependency Review' on: [pull_request] @@ -146,11 +137,11 @@ Notice that all of the examples use a short version number for the action (`v3`) fail-on-scopes: development, runtime {% endif %} ``` -### Using a configuration file to set up {% data variables.product.prodname_dependency_review_action %} +### Uso de un archivo de configuración para configurar la {% data variables.product.prodname_dependency_review_action %} -1. Add a new YAML workflow to your `.github/workflows` folder and use `config-file` to specify that you are using a configuration file. +1. Agrega un nuevo flujo de trabajo YAML a la carpeta `.github/workflows` y usa `config-file` para especificar que usas un archivo de configuración. - {% ifversion ghes %}For `runs-on`, the default label is `self-hosted`. You can replace the default label with the label of any of your runners.{% endif %} + {% ifversion ghes %}Para `runs-on`, la etiqueta predeterminada es `self-hosted`. Puedes reemplazar la etiqueta predeterminada por la etiqueta de cualquiera de los ejecutores.{% endif %} ```yaml{:copy} name: 'Dependency Review' on: [pull_request] @@ -178,9 +169,9 @@ Notice that all of the examples use a short version number for the action (`v3`) # Possible values: Any GitHub token with read access to the private external repository. external-repo-token: 'ghp_123456789abcde' ``` -1. Create the configuration file in the path you have specified. +1. Crea el archivo de configuración en la ruta de acceso especificada. - This YAML example file illustrates how you can use the available configuration options. + En este archivo de ejemplo YAML se ilustra cómo puedes usar las opciones de configuración disponibles. ```yaml{:copy} # Possible values: "critical", "high", "moderate", "low" fail-on-severity: critical @@ -211,5 +202,5 @@ Notice that all of the examples use a short version number for the action (`v3`) - runtime {% endif %} ``` -For further details about the configuration options, see [`dependency-review-action`](https://github.com/actions/dependency-review-action#readme). +Para obtener más información sobre las opciones de configuración, consulta [`dependency-review-action`](https://github.com/actions/dependency-review-action#readme). {% endif %} diff --git a/translations/es-ES/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md b/translations/es-ES/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md index 0f6bc73866..9eed9e4337 100644 --- a/translations/es-ES/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md +++ b/translations/es-ES/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Disaster recovery for GitHub Codespaces -intro: 'This article describes guidance for a disaster recovery scenario, when a whole region experiences an outage due to major natural disaster or widespread service interruption.' +title: Recuperación de desastres en GitHub Codespaces +intro: 'Este artículo describe la guía para una situación de recuperación de desastres, cuando toda una región experimenta una interrupción debido a un desastre natural mayor o una interrupción de servicios extendida.' versions: fpt: '*' ghec: '*' @@ -9,44 +9,49 @@ topics: shortTitle: Disaster recovery redirect_from: - /codespaces/codespaces-reference/disaster-recovery-for-codespaces +ms.openlocfilehash: 9b892d6a24332e01174c819e2e88a91d1cdf9d65 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158817' --- +Nos esforzamos para asegurarnos de que {% data variables.product.prodname_github_codespaces %} siempre esté disponible. Sin embargo, por causas de fuerza mayor que salen de nuestro control, algunas veces se impacta el servicio en formas qeu pueden causar interrupciones de servicio no planeadas. -We work hard to make sure that {% data variables.product.prodname_github_codespaces %} is always available to you. However, forces beyond our control sometimes impact the service in ways that can cause unplanned service disruptions. +Aunque los casos de recuperación de desastres son ocurrencias extraordinarias, te recomendamos que te prepares para la posibilidad de que exista una interrupción en una región entera. Si una región completa experimenta una interrupción de servicio, las copias locales redundantes de tus datos se encontrarán temporalmente no disponibles. -Although disaster recovery scenarios are rare occurrences, we recommend that you prepare for the possibility that there is an outage of an entire region. If an entire region experiences a service disruption, the locally redundant copies of your data would be temporarily unavailable. - -The following guidance provides options on how to handle service disruption to the entire region where your codespace is deployed. +La siguiente orientación proporciona opciones sobre cómo manejar la interrupción del servicio para toda la región en donde se desplegó tu codespace. {% note %} -**Note:** You can reduce the potential impact of service-wide outages by pushing to remote repositories frequently. +**Nota:** Para reducir el posible impacto de las interrupciones del servicio, realice inserciones en los repositorios remotos con frecuencia. {% endnote %} -## Option 1: Create a new codespace in another region +## Opción 1: Crea un codespace nuevo en otra región -In the case of a regional outage, we suggest you recreate your codespace in an unaffected region to continue working. This new codespace will have all of the changes as of your last push to {% data variables.product.prodname_dotcom %}. For information on manually setting another region, see "[Setting your default region for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)." +En caso de que haya una interrupción regional, te sugerimos volver a crear tu codespace en una región no afectada para seguir trabajando. Este codespace nuevo tendrá todos los cambios desde tu última subida en {% data variables.product.prodname_dotcom %}. Para información sobre cómo configurar manualmente otra región, consulta "[Configuración de la región predeterminada para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)". -You can optimize recovery time by configuring a `devcontainer.json` in the project's repository, which allows you to define the tools, runtimes, frameworks, editor settings, extensions, and other configuration necessary to restore the development environment automatically. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project)." +Puede optimizar el tiempo de recuperación si configura un `devcontainer.json` en el repositorio de un proyecto, lo que le permite definir las herramientas, los tiempos de ejecución, la configuración del editor, las extensiones y otros tipos de configuración necesarios para restablecer el entorno de desarrollo automáticamente. Para obtener más información, consulte "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project)". -## Option 2: Wait for recovery +## Opción 2: espera para recuperación -In this case, no action on your part is required. Know that we are working diligently to restore service availability. +En este caso, no se requieren acciones por su parte. Sabe que trabajaremos con rapidez para que el servicio de Azure vuelva a estar disponible. -You can check the current service status on the [Status Dashboard](https://www.githubstatus.com/). +Puede comprobar el estado actual del servicio en [Status Dashboard](https://www.githubstatus.com/). -## Option 3: Clone the repository locally or edit in the browser +## Opción 3: Clone el repositorio localmente o edítelo en el explorador -While {% data variables.product.prodname_github_codespaces %} provides the benefit of a pre-configured developer environmnent, your source code should always be accessible through the repository hosted on {% data variables.product.prodname_dotcom_the_website %}. In the event of a {% data variables.product.prodname_github_codespaces %} outage, you can still clone the repository locally or edit files in the {% data variables.product.company_short %} browser editor. For more information, see "[Editing files](/repositories/working-with-files/managing-files/editing-files)." +Aunque {% data variables.product.prodname_github_codespaces %} proporciona la ventaja de un entorno de desarrollador preconfigurado, tu código fuente siempre debe ser accesible mediante el repositorio hospedado en {% data variables.product.prodname_dotcom_the_website %}. En caso de que haya una interrupción del servicio de {% data variables.product.prodname_github_codespaces %}, todavía podrás clonar el repositorio localmente o editar archivos en el editor del explorador de {% data variables.product.company_short %}. Para obtener más información, consulte "[Edición de archivos](/repositories/working-with-files/managing-files/editing-files)". -While this option does not configure a development environment for you, it will allow you to make changes to your source code as needed while you wait for the service disruption to resolve. +Si bien esta opción no te configura un ambiente de desarrollo, te permitirá hacer cambios a tu código fuente conforme los necesites mientras esperas a que se resuelva la interrupción del servicio. -## Option 4: Use the Dev Containers extension and Docker for a local containerized environment +## Opción 4: Uso de la extensión Dev Containers y de Docker para un entorno local contenedorizado -If your repository has a `devcontainer.json`, consider using the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) in {% data variables.product.prodname_vscode %} to build and attach to a local development container for your repository. The setup time for this option will vary depending on your local specifications and the complexity of your dev container setup. For more information, see "[Developing inside a container](https://code.visualstudio.com/docs/remote/containers#_quick-start-open-a-git-repository-or-github-pr-in-an-isolated-container-volume)" in the {% data variables.product.prodname_vscode_shortname %} documentation. +Si el repositorio tiene un archivo `devcontainer.json`, considera la posibilidad de usar la [extensión Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) en {% data variables.product.prodname_vscode %} a fin de crear y adjuntar un contenedor de desarrollo local para el repositorio. El tiempo de configuración para esta opción variará dependiendo de tus especificaciones locales y de la complejidad de tu configuración de contenedor dev. Para obtener más información, consulta "[Desarrollo dentro de un contenedor](https://code.visualstudio.com/docs/remote/containers#_quick-start-open-a-git-repository-or-github-pr-in-an-isolated-container-volume)" en la documentación de {% data variables.product.prodname_vscode_shortname %}. {% note %} -**Note:** Be sure your local setup meets the [minimum requirements](https://code.visualstudio.com/docs/remote/containers#_system-requirements) before attempting this option. +**Nota:** Asegúrese de que la configuración local cumpla los [requisitos mínimos](https://code.visualstudio.com/docs/remote/containers#_system-requirements) antes de probar esta opción. {% endnote %} diff --git a/translations/es-ES/content/codespaces/codespaces-reference/index.md b/translations/es-ES/content/codespaces/codespaces-reference/index.md index 0d53f5e509..33bb8629a0 100644 --- a/translations/es-ES/content/codespaces/codespaces-reference/index.md +++ b/translations/es-ES/content/codespaces/codespaces-reference/index.md @@ -10,6 +10,7 @@ children: - /using-the-github-codespaces-plugin-for-jetbrains - /using-the-vs-code-command-palette-in-codespaces - /security-in-github-codespaces + - /performing-a-full-rebuild-of-a-container - /disaster-recovery-for-github-codespaces ms.openlocfilehash: 87692cd862e791f3e6ffa2be2b07f34c6158e617 ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 diff --git a/translations/es-ES/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md b/translations/es-ES/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md index 48607d15d9..48254e4f70 100644 --- a/translations/es-ES/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md +++ b/translations/es-ES/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Using GitHub Copilot in GitHub Codespaces -intro: 'You can use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_github_codespaces %} by adding the extension.' +title: Uso de GitHub Copilot en GitHub Codespaces +intro: 'Puedes usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_github_codespaces %} si agregas la extensión.' versions: fpt: '*' ghec: '*' @@ -13,8 +13,13 @@ shortTitle: Copilot in Codespaces redirect_from: - /codespaces/codespaces-reference/using-copilot-in-codespaces - /codespaces/codespaces-reference/using-github-copilot-in-codespaces +ms.openlocfilehash: 6615df6930fa8f27dd8f50c4588d8182b8602549 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158729' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} @@ -23,7 +28,7 @@ redirect_from: {% webui %} -## Using {% data variables.product.prodname_copilot %} in the {% data variables.product.prodname_vscode_shortname %} web client +## Uso de {% data variables.product.prodname_copilot %} en el cliente web de {% data variables.product.prodname_vscode_shortname %} {% data reusables.codespaces.copilot-in-vscode %} @@ -31,7 +36,7 @@ redirect_from: {% vscode %} -## Using {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %} +## Uso de {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %} {% data reusables.codespaces.copilot-in-vscode %} @@ -39,57 +44,57 @@ redirect_from: {% jetbrains %} -## Installing {% data variables.product.prodname_copilot %} in your JetBrains IDE +## Instalación de {% data variables.product.prodname_copilot %} en el IDE de JetBrains -[{% data variables.product.prodname_copilot %}](https://copilot.github.com/), an AI pair programmer, can be used in any codespace. For more information, see "[About GitHub Copilot](/copilot/overview-of-github-copilot/about-github-copilot)." +[{% data variables.product.prodname_copilot %}](https://copilot.github.com/), un programador de pares de IA, se puede usar en cualquier codespace. Para obtener más información, consulta "[Acerca de GitHub Copilot](/copilot/overview-of-github-copilot/about-github-copilot)". -To use {% data variables.product.prodname_copilot %} in a codespace in your JetBrains IDE, install the [{% data variables.product.prodname_copilot %} plugin](https://plugins.jetbrains.com/plugin/17718-github-copilot) from within your codespace. +Para usar {% data variables.product.prodname_copilot %} en un codespace en el IDE de JetBrains, instala el [complemento de {% data variables.product.prodname_copilot %}](https://plugins.jetbrains.com/plugin/17718-github-copilot) desde el codespace. {% note %} -**Note**: You must install the {% data variables.product.prodname_copilot %} plugin each time you create a new codespace. +**Nota**: Debes instalar el complemento de {% data variables.product.prodname_copilot %} cada vez que crees un codespace. {% endnote %} -1. In the JetBrains client application, open the Settings (Windows/Linux) or Preferences (Mac) dialog box: +1. En la aplicación cliente JetBrains, abre el cuadro de diálogo Configuración (Windows/Linux) o Preferencias (Mac): - - **Windows/Linux**: Click **File** and then **Settings** (or press Ctrl+Alt+S) - - **Mac**: Click **JetBrains Client** in the MacOS menu bar, then click **Preferences** (or press command+,) + - **Windows/Linux**: haz clic en **Archivo** y, luego, en **Configuración** (o presiona CTRL+Alt+S). + - **Mac**: haz clic en **Cliente JetBrains** en la barra de menús de MacOS y, luego, en **Preferencias** (o presiona comando+,). -1. In the left-side menu of the Settings/Preferences dialog box, click **Plugins On Host**. Then click the **Marketplace** tab. +1. En el menú izquierdo del cuadro de diálogo Configuración/Preferencias, haz clic en **Complementos en el host**. Después, haz clic en la pestaña **Marketplace**. - ![Screenshot of the Marketplace tab for 'Plugins On Host'](/assets/images/help/codespaces/jetbrains-preferences-plugins.png) + ![Captura de pantalla de la pestaña Marketplace para "Complementos en el host"](/assets/images/help/codespaces/jetbrains-preferences-plugins.png) -1. In the search box, type "copilot" then click the **Install** button for the {% data variables.product.prodname_copilot %} plugin. +1. En el cuadro de búsqueda, escribe "copilot" y haz clic en el botón **Instalar** del complemento de {% data variables.product.prodname_copilot %}. - ![Screenshot of the {% data variables.product.prodname_copilot %} plugin](/assets/images/help/codespaces/jetbrains-copilot-plugin.png) + ![Captura de pantalla del complemento de {% data variables.product.prodname_copilot %}](/assets/images/help/codespaces/jetbrains-copilot-plugin.png) -1. Click **Accept** on the "Third-Party Plugins Privacy Note" dialog box. -1. Click **Restart IDE**. +1. Haz clic en **Aceptar** en el cuadro de diálogo "Nota de privacidad de complementos de terceros". +1. Haga clic en **Restart IDE** (Reiniciar IDE). - ![Screenshot of the {% data variables.product.prodname_copilot %} plugin](/assets/images/help/codespaces/jetbrains-copilot-restart.png) + ![Captura de pantalla del complemento de {% data variables.product.prodname_copilot %}](/assets/images/help/codespaces/jetbrains-copilot-restart.png) -1. Click **Restart** when prompted to confirm that you want to restart the backend IDE that's running remotely. The JetBrains client application will close when you do this. -1. Open the codespace again from the JetBrains Gateway application. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide#opening-a-codespace-in-your-jetbrains-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 %}**. +1. Haz clic en **Reiniciar** cuando se te pida que confirmes que quieres reiniciar el IDE de back-end que se ejecuta de forma remota. La aplicación cliente JetBrains se cerrará cuando lo hagas. +1. Vuelve a abrir el codespace desde la aplicación JetBrains Gateway. Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} en el IDE de JetBrains](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide#opening-a-codespace-in-your-jetbrains-ide)". +1. Una vez reiniciado el IDE de JetBrains, haz clic en el menú **Herramientas**. Haz clic en **{% data variables.product.prodname_copilot %}** y, a continuación, haz clic en **Iniciar sesión en {% data variables.product.prodname_dotcom %}** . - ![Screenshot of the JetBrains Tools menu](/assets/images/help/codespaces/jetbrains-tools-menu.png) + ![Captura de pantalla del menú de herramientas de JetBrains](/assets/images/help/codespaces/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**. +1. En el cuadro de diálogo "Iniciar sesión en {% data variables.product.prodname_dotcom %}", para copiar el código del dispositivo y abrir la ventana de activación del dispositivo, haz clic en **Copiar y abrir**. - ![Screenshot of the device code copy and open](/assets/images/help/copilot/device-code-copy-and-open.png) + ![Captura de pantalla de la copia y apertura del código del dispositivo](/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. Se abrirá una ventana de activación del dispositivo en el explorador. Pega el código del dispositivo y haz clic en **Continuar**. - - 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**. + - Para pegar el código en Windows o Linux, presiona Ctrl+v. + - Para pegar el código en macOS, presiona command+v. +1. {% data variables.product.prodname_dotcom %} solicitará los permisos necesarios para {% data variables.product.prodname_copilot %}. Para aprobar estos permisos, haz clic en **Autorizar complemento {% data variables.product.prodname_copilot %}** . +1. Una vez aprobados los permisos, el IDE de JetBrains mostrará una confirmación. Para empezar a usar {% data variables.product.prodname_copilot %}, haz clic en **Aceptar**. - ![Screenshot of the JetBrains IDE permissions confirmation](/assets/images/help/copilot/jetbrains-ide-confirmation.png) + ![Captura de pantalla de la confirmación de permisos del IDE de JetBrains](/assets/images/help/copilot/jetbrains-ide-confirmation.png) -## Further reading +## Información adicional -- "[Getting started with GitHub Copilot in a JetBrains IDE](/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide)" +- "[Introducción a GitHub Copilot en un IDE de JetBrains](/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide)" -{% endjetbrains %} \ No newline at end of file +{% endjetbrains %} diff --git a/translations/es-ES/content/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains.md b/translations/es-ES/content/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains.md new file mode 100644 index 0000000000..bd2f131da3 --- /dev/null +++ b/translations/es-ES/content/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains.md @@ -0,0 +1,72 @@ +--- +title: Uso del complemento de GitHub Codespaces para JetBrains +shortTitle: Plugin for JetBrains +intro: 'Puedes usar el complemento de {% data variables.product.prodname_github_codespaces %} para la aplicación cliente JetBrains con el fin de obtener información sobre el codespace o detenerlo cuando acabes de trabajar.' +versions: + fpt: '*' + ghec: '*' +type: reference +topics: + - Codespaces +ms.openlocfilehash: 8ffd48856a2653f3db3c871122d3acd23c246d7a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159939' +--- +{% data reusables.codespaces.codespaces-jetbrains-beta-note %} + +## Acerca del complemento de {% data variables.product.prodname_github_codespaces %} + +La aplicación cliente JetBrains se inicia cuando te conectas a un codespace desde la aplicación JetBrains Gateway. Te ofrece la posibilidad de usar {% data variables.product.prodname_github_codespaces %} con tu IDE de JetBrains favorito. Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} en el IDE de JetBrains](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)". + +El complemento de {% data variables.product.prodname_github_codespaces %} ya está instalado en el cliente JetBrains cuando te conectas a un codespace desde JetBrains Gateway. El complemento agrega la ventana de herramientas de {% data variables.product.prodname_github_codespaces %} a la interfaz de usuario. + +Haz clic en **{% data variables.product.prodname_github_codespaces %}** en la parte inferior izquierda de la ventana de la aplicación cliente JetBrains para abrir la ventana de herramientas de {% data variables.product.prodname_github_codespaces %}. + +![Captura de pantalla de la ventana de herramientas de {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/jetbrains-codespaces-tool-window.png) + +## Uso de la ventana de herramientas de {% data variables.product.prodname_github_codespaces %} + +En la ventana de herramientas de {% data variables.product.prodname_github_codespaces %} se muestra lo siguiente: +* El repositorio desde el que creaste este codespace. +* El nombre para mostrar del codespace. +* La rama actual. +* Las especificaciones de la máquina. +* El tiempo durante el cual este codespace puede permanecer inactivo antes de que se detenga automáticamente. +* La antigüedad del codespace. +* El período durante el cual se conservará un codespace detenido antes de que se elimine automáticamente. + +Los iconos de la parte superior de la ventana de herramientas de {% data variables.product.prodname_github_codespaces %} proporcionan las funciones que se indican a continuación. + +* **Actualizar codespace activo** + + ![Captura de pantalla del botón Actualizar](/assets/images/help/codespaces/jetbrains-plugin-icon-refresh-BAK.png) + + Actualiza los detalles de la ventana de herramientas de {% data variables.product.prodname_github_codespaces %}. Por ejemplo, si usaste la {% data variables.product.prodname_cli %} para cambiar el nombre para mostrar, podrías hacer clic en este botón para que aparezca el nuevo nombre. + +* **Desconectar y detener** + + ![Captura de pantalla del botón Detener](/assets/images/help/codespaces/jetbrains-plugin-icon-stop.png) + + Detén el codespace, detén el IDE de back-end de la máquina remota y cierra el cliente JetBrains local. + +* **Administrar los codespaces desde la web** + + ![Captura de pantalla del botón Lista](/assets/images/help/codespaces/jetbrains-plugin-icon-index.png) + + Abre la lista de codespaces en https://github.com/codespaces. + +* **Ver el registro de creación de codespaces** + + ![Captura de pantalla del botón Registro](/assets/images/help/codespaces/jetbrains-plugin-icon-log.png) + + Abre el registro de creación de codespaces en la ventana del editor. Para más información, consulta "[Registros de {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/github-codespaces-logs)". + +* **Recompilar el contenedor de desarrollo** + + ![Captura de pantalla del botón Recompilar](/assets/images/help/codespaces/jetbrains-plugin-icon-rebuild.png) + + Recompile el codespace para aplicar los cambios que has realizado en la configuración del contenedor de desarrollo. El cliente JetBrains se cerrará y deberás volver a abrir el codespace. Para obtener más información, consulta "[Ciclo de vida de un codespace](/codespaces/developing-in-codespaces/the-codespace-lifecycle#rebuilding-a-codespace)". + diff --git a/translations/es-ES/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md b/translations/es-ES/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md index b46863bb7f..1ae7d23c67 100644 --- a/translations/es-ES/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md +++ b/translations/es-ES/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md @@ -58,6 +58,8 @@ To rebuild your container, [access the {% data variables.product.prodname_vscode ![Command to rebuild a codespace](/assets/images/help/codespaces/codespaces-rebuild.png) +{% data reusables.codespaces.full-rebuild-tip %} + ### Codespaces logs You can use the {% data variables.product.prodname_vscode_command_palette_shortname %} to access the codespace creation logs, or you can use it export all logs. diff --git a/translations/es-ES/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md b/translations/es-ES/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md index 5ee22758aa..87fec232e7 100644 --- a/translations/es-ES/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md +++ b/translations/es-ES/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md @@ -1,7 +1,7 @@ --- -title: Changing the machine type for your codespace +title: Cambiar el tipo de máquina de tu codespace shortTitle: Change the machine type -intro: 'You can change the type of machine that''s running your codespace, so that you''re using resources appropriate for the work you''re doing.' +intro: Puedes cambiar el tipo de máquina que ejecuta tu codespace para usar los recursos adecuados para el trabajo que estás llevando a cabo. versions: fpt: '*' ghec: '*' @@ -10,21 +10,26 @@ redirect_from: topics: - Codespaces type: how_to +ms.openlocfilehash: b8614e9389aa617b3bfcfa3444f5a60aa7dd3c2e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159089' --- +## Acerca de los tipos de máquina -## About machine types +{% data reusables.codespaces.codespaces-machine-types %} Puedes elegir un tipo de máquina alternativo al crear un codespace o en cualquier momento después de crearlo. -{% data reusables.codespaces.codespaces-machine-types %} You can choose an alternative machine type either when you create a codespace or at any time after you've created a codespace. +Para obtener información sobre cómo elegir un tipo de máquina al crear un codespace, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)". -For information on choosing a machine type 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)." +{% data reusables.codespaces.machine-types-for-unpublished-codespaces %} Para obtener más información, consulta "[Creación de un codespace a partir de una plantilla](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)". -{% data reusables.codespaces.machine-types-for-unpublished-codespaces %} For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)." - -## Changing the machine type +## Cambio del tipo de máquina {% note %} -**Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} +**Nota**: {% data reusables.codespaces.codespaces-machine-type-availability %} {% endnote %} @@ -32,18 +37,18 @@ For information on choosing a machine type when you create a codespace, see "[Cr {% data reusables.codespaces.your-codespaces-procedure-step %} - The current machine type for each of your codespaces is displayed. + Se mostrará el tipo de máquina actual para cada uno de tus codespaces. - !['Your codespaces' list](/assets/images/help/codespaces/your-codespaces-list.png) + ![Lista de 'Tus codespaces'](/assets/images/help/codespaces/your-codespaces-list.png) {% data reusables.codespaces.ellipsis-settings %} -1. Click **Change machine type**. +1. Haga clic en **Cambiar tipo de máquina**. - !['Change machine type' menu option](/assets/images/help/codespaces/change-machine-type-menu-option.png) -1. If multiple machine types are available for your codespace, choose the type of machine you want to use. + ![Opción de menú 'Cambiar tipo de máquina'](/assets/images/help/codespaces/change-machine-type-menu-option.png) +1. Si hay varios tipos de máquina disponibles para tu codespace, elige aquella que quieras utilizar. - ![Dialog box showing available machine types to choose](/assets/images/help/codespaces/change-machine-type-choice.png) -1. Click **Update codespace**. + ![La caja de diálogo que muestra los tipos de máquina disponibles para elegir](/assets/images/help/codespaces/change-machine-type-choice.png) +1. Haga clic en **Actualizar codespace**. {% endwebui %} @@ -55,39 +60,39 @@ For information on choosing a machine type when you create a codespace, see "[Cr {% cli %} -You can use the `gh codespace edit --machine MACHINE-TYPE-NAME` {% data variables.product.prodname_cli %} command to change the machine type of a codespace. To use this command, you'll first need to find out the available machine types for your codespace. +Puedes usar el comando `gh codespace edit --machine MACHINE-TYPE-NAME` {% data variables.product.prodname_cli %} para cambiar el tipo de equipo de un codespace. Para usar este comando, primero deberás averiguar cuáles son los tipos de máquina disponibles para el codespace. -1. To view your list of codespaces, in a terminal, enter the following command. +1. Para ver la lista de codespaces, escribe el comando siguiente en un terminal. ``` gh codespace list ``` -1. Optionally, to find the current machine type for a codespace, enter the following command. +1. Opcionalmente, puedes escribir el comando siguiente para buscar el tipo de máquina actual para un codespace. ``` gh api /user/codespaces/CODESPACE-NAME ``` - Replace `CODESPACE-NAME` with the permanent name of the codespace, for example `octocat-literate-space-parakeet-mld5`. The permanent names are listed under the **NAME** column in the list returned by `gh codespace list`. + Reemplaza `CODESPACE-NAME` por el nombre permanente del codespace, por ejemplo, `octocat-literate-space-parakeet-mld5`. Los nombres permanentes aparecen en la columna **NAME** de la lista que devuelve `gh codespace list`. - If you're prompted to request the `codespace` scope, follow the instructions in the terminal. + Si se te pide que solicites el ámbito `codespace`, sigue las instrucciones del terminal. - Details for the current machine are listed under the `machine` field. -1. To find the available machine types for a codespace, enter the following command. + Los detalles de la máquina actual aparecen en el campo `machine`. +1. Para buscar los tipos de máquina disponibles para un codespace, escribe el comando siguiente. ``` gh api /user/codespaces/CODESPACE-NAME/machines ``` - Replace `CODESPACE-NAME` with the permanent name of the codespace, for example `octocat-literate-space-parakeet-mld5`. -1. To change the machine type for a codespace, enter the following command. + Reemplaza `CODESPACE-NAME` por el nombre permanente del codespace, por ejemplo, `octocat-literate-space-parakeet-mld5`. +1. Para cambiar el tipo de máquina de un codespace, escribe el comando siguiente. ``` gh codespace edit --machine MACHINE-TYPE-NAME ``` - Replace `MACHINE-TYPE-NAME` with the name of an available machine type for your codespace, for example `standardLinux32gb`. -1. Using the arrow keys, navigate to the codespace you want to change, then press Enter. + Reemplaza `MACHINE-TYPE-NAME` por el nombre de un tipo de máquina disponible para el codespace, por ejemplo, `standardLinux32gb`. +1. Con las teclas de dirección, ve al codespace que quieres cambiar y presione ENTRAR. {% endcli %} @@ -95,9 +100,9 @@ You can use the `gh codespace edit --machine MACHINE-TYPE-NAME` {% data variable {% cli %} -## Further reading +## Información adicional -- "[Codespaces machines](/rest/codespaces/machines)" in the REST API documentation -- [`gh codespace edit`](https://cli.github.com/manual/gh_codespace_edit) in the {% data variables.product.prodname_cli %} manual +- "[Máquinas de codespaces](/rest/codespaces/machines)" en la documentación de la API REST +- [`gh codespace edit`](https://cli.github.com/manual/gh_codespace_edit) en el manual de {% data variables.product.prodname_cli %} {% endcli %} diff --git a/translations/es-ES/content/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces.md b/translations/es-ES/content/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces.md index f0b5bc7897..8f79ee984d 100644 --- a/translations/es-ES/content/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces.md +++ b/translations/es-ES/content/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces.md @@ -1,85 +1,89 @@ --- -title: Configuring automatic deletion of your codespaces +title: Configuración de la eliminación automática de los codespaces shortTitle: Configure automatic deletion -intro: 'Inactive codespaces are automatically deleted. You can choose how long your stopped codespaces are retained, up to a maximum of 30 days.' +intro: "Los codespaces inactivos se eliminan automáticamente. Puedes elegir cuánto tiempo se conservan los codespaces detenidos, hasta un máximo de 30\_días." versions: fpt: '*' ghec: '*' topics: - Codespaces type: how_to +ms.openlocfilehash: 5414d2223f490638f27475840a25883e9c353e77 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160307' --- +De forma predeterminada, los {% data variables.product.prodname_github_codespaces %} se eliminan automáticamente una vez que se hayan detenido y hayan permanecido inactivos durante 30 días. -By default, {% data variables.product.prodname_github_codespaces %} are automatically deleted after they have been stopped and have remained inactive for 30 days. - -However, because {% data variables.product.prodname_github_codespaces %} incurs storage charges, you may prefer to reduce the retention period by changing your default period in your personal settings for {% data variables.product.prodname_github_codespaces %}. For more information about storage charges, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)." +Sin embargo, dado que {% data variables.product.prodname_github_codespaces %} incurre en cargos de almacenamiento, es posible que prefieras reducir el período de retención cambiando el período predeterminado en la configuración personal de {% data variables.product.prodname_github_codespaces %}. Para obtener más información sobre los cargos de almacenamiento, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)". {% note %} -**Note**: Whether or not you have set a personal codespace retention period, it's a good idea to get into the habit of deleting codespaces that you no longer need. For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)." +**Nota**: Independientemente de si has establecido o no un período de retención de codespace personal, es una buena idea adquirir el hábito de eliminar codespaces que ya no necesite. Para más información, vea "[Eliminación de un codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)". {% endnote %} -Automatic deletion happens irrespective of whether a codespace contains unpushed changes. To prevent automatic deletion of a codespace, just open the codespace again. The retention period is reset every time you connect to a codespace, and the retention countdown restarts when the codespace is stopped. +La eliminación automática se produce independientemente de si un codespace contiene cambios no subidos. Para evitar la eliminación automática de un codespace, simplemente abre el codespace de nuevo. El período de retención se restablece cada vez que te conectas a un codespace y la cuenta atrás de retención se reinicia cuando se detiene el codespace. -If a repository belongs to an organization, the organization admin may have set a retention period for the whole organization. If this period is less than the default retention period in your personal settings then the organization retention period will apply to codespaces you create for this repository. For more information, see "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)." +Si un repositorio pertenece a una organización, es posible que el administrador de la organización haya establecido un período de retención para toda la organización. Si este período es menor que el período de retención predeterminado en la configuración personal, el período de retención de la organización se aplicará a los codespaces que cree para este repositorio. Para obtener más información, consulta "[Restringir el período de retención para los codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)". -Each codespace has its own retention period. You may, therefore, have codespaces with different rentention periods. For example, if: -* You created a codespace, changed your default retention period, then created another codespace. -* You created a codespace using {% data variables.product.prodname_cli %} and specified a different retention period. -* You created a codespace from an organization-owned repository that has a retention period configured for the organization. +Cada codespace tiene su propio período de retención. Por lo tanto, puedes tener codespaces con diferentes periodos de retención. Por ejemplo, si: +* Has creado un codespace, has cambiado el período de retención predeterminado y, a continuación, has creado otro codespace. +* Has creado un codespace con {% data variables.product.prodname_cli %} y has especificado un período de retención diferente. +* Has creado un codespace a partir de un repositorio propiedad de la organización que tiene un período de retención configurado para la organización. {% note %} -**Note**: The retention period is specified in days. A day represents a 24-hour period, beginning at the time of day when you stop a codespace. +**Nota**: El período de retención se especifica en días. Un día representa un período de 24 horas, comenzando en la hora del día en que se detiene un codespace. {% endnote %} {% webui %} -## Setting a default retention period for your codespaces +## Establecimiento de un período de retención predeterminado para los codespaces -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Default retention period", enter the number of days for which you want your codespaces to be retained, by default, after they have been stopped. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. En "Período de retención predeterminado", escribe el número de días para los que deseas que se conserven los codespaces, de forma predeterminada, una vez detenidos. - ![Selecting your retention period](/assets/images/help/codespaces/setting-default-retention.png) + ![Selección del período de retención](/assets/images/help/codespaces/setting-default-retention.png) - You can set your default retention period between `0` and `30` days. + Puedes establecer el período de retención predeterminado entre `0` y `30` días. {% warning %} - **Warning**: Setting the period to `0` will result in your codespaces being immediately deleted when you stop them, or when they timeout due to inactivity. For more information, see "[Setting your timeout period for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)." + **Advertencia**: establecer el período en `0` dará lugar a que los codespaces se eliminen inmediatamente cuando los detengas, o cuando se haya agotado el tiempo de espera debido a la inactividad. Para obtener más información, consulta "[Establecimiento del período de tiempo de espera para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)." {% endwarning %} -1. Click **Save**. +1. Haga clic en **Save**(Guardar). -When you create a codespace using {% data variables.product.prodname_cli %} you can override this default. If you create a codespace in an organization that specifies a shorter retention period, the organization-level value overrides your personal setting. +Al crear un codespace con {% data variables.product.prodname_cli %}, puedes invalidar este valor predeterminado. Si creas un codespace en una organización que especifica un período de retención más corto, el valor de nivel de organización invalida la configuración personal. -If you set a retention period of more than a day, you'll be sent an email notification one day prior to its deletion. +Si estableces un período de retención de más de un día, se te enviará una notificación por correo electrónico un día antes de su eliminación. -## Checking the remaining time until autodeletion +## Comprobación del tiempo restante hasta la eliminación automática -You can check whether a codespace is due to be automatically deleted soon. +Puedes comprobar si un codespace se va a eliminar automáticamente en breve. -When an inactive codespace is approaching the end of its retention period, this is indicated in your list of codespaces on {% data variables.product.prodname_dotcom %} at [https://github.com/codespaces](https://github.com/codespaces). +Cuando un codespace inactivo se aproxima al final de su período de retención, se indica en la lista de codespaces en {% data variables.product.prodname_dotcom %} en [https://github.com/codespaces](https://github.com/codespaces). -![The pre-deletion message in the codespaces list on {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/retention-deletion-message.png) +![El mensaje previo a la eliminación en la lista de codespaces en {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/retention-deletion-message.png) {% endwebui %} {% cli %} -## Setting a retention period for a codespace +## Establecimiento de un período de retención para un codespace -To set the codespace retention period when you create a codespace, use the `--retention-period` flag with the `codespace create` subcommand. Specify the period in days. The period must be between 0 and 30 days. +Para establecer el período de tiempo del codespace, usa la marca `--retention-period` con el subcomando `codespace create`. Especifica el período en días. El período debe estar comprendido entre 0 y 30 días. ```shell gh codespace create --retention-period DAYS ``` -If you don't specify a retention period when you create a codespace, then either your default retention period, or an organization retention period, will be used, depending on which is lower. For information about setting your default retention period, click the "Web browser" tab on this page. +Si no especificas un período de retención al crear un codespace, se usará el período de retención predeterminado o un período de retención de la organización, dependiendo de cuál sea menor. Para obtener información sobre la configuración del periodo de retención predeterminado, haz clic en la pestaña "Explorador web" de esta página. {% data reusables.cli.cli-learn-more %} @@ -87,20 +91,20 @@ If you don't specify a retention period when you create a codespace, then either {% vscode %} -## Setting the retention period +## Configuración del período de retención -You can set your default retention period in your web browser, on {% data variables.product.prodname_dotcom_the_website %}. Alternatively, if you use {% data variables.product.prodname_cli %} to create a codespace you can set a retention period for that particular codespace. For more information, click the appropriate tab above. +Puedes establecer el período de retención predeterminado en el explorador web, en {% data variables.product.prodname_dotcom_the_website %}. De manera alternativa, si usas {% data variables.product.prodname_cli %} para crear un codespace, puedes establecer un período de retención para ese codespace determinado. Para más información, haz clic en la pestaña correspondiente arriba. -## Checking whether codespaces will be autodeleted soon +## Comprobación de si los codespaces se eliminarán automáticamente pronto -You can check, in the {% data variables.product.prodname_vscode %} desktop application, whether a codespace is due to be automatically deleted soon. +Puede comprobar, en la aplicación de escritorio {% data variables.product.prodname_vscode %}, si un codespace se va a eliminar automáticamente pronto. {% data reusables.codespaces.click-remote-explorer-icon-vscode %} -1. Choose **{% data variables.product.prodname_github_codespaces %}** from the dropdown menu at the top right of the Remote Explorer, if it is not already selected. -1. Under "GITHUB CODESPACES," position the mouse pointer over the codespace that you're interested in. A pop-up box is displayed showing you information about the codespace. +1. Elige **{% data variables.product.prodname_github_codespaces %}** en el menú desplegable situado en la parte superior derecha del explorador remoto, si aún no está seleccionado. +1. En "GITHUB CODESPACES", coloca el puntero sobre el codespace que te interesa. Se muestra un cuadro emergente que informa sobre el codespace. - If the codespace is nearing the end of its retention period, a line is included telling you when the codespace will be deleted. + Si el codespace está cerca del final de su período de retención, se incluye una línea que indica cuándo se eliminará el codespace. - ![Codespace information showing the time until deletion](/assets/images/help/codespaces/vscode-deleting-in-5-days.png) + ![Información del codespace que muestra el tiempo hasta la eliminación](/assets/images/help/codespaces/vscode-deleting-in-5-days.png) {% endvscode %} diff --git a/translations/es-ES/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md b/translations/es-ES/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md index ccd3cdb369..bb0ffccfd4 100644 --- a/translations/es-ES/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md +++ b/translations/es-ES/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md @@ -1,7 +1,7 @@ --- -title: Personalizing GitHub Codespaces for your account +title: Personalización de GitHub Codespaces para la cuenta shortTitle: Personalize your codespaces -intro: 'You can personalize {% data variables.product.prodname_github_codespaces %} by using a `dotfiles` repository on {% data variables.product.product_name %} or by using Settings Sync.' +intro: 'Puedes personalizar {% data variables.product.prodname_github_codespaces %} mediante un repositorio `dotfiles` en {% data variables.product.product_name %} o por medio de la sincronización de la configuración.' redirect_from: - /github/developing-online-with-github-codespaces/personalizing-github-codespaces-for-your-account - /github/developing-online-with-codespaces/personalizing-codespaces-for-your-account @@ -15,39 +15,43 @@ topics: - Codespaces - Set up - Fundamentals +ms.openlocfilehash: 80b6cd1ee982150c1b3c0a66e1247f6098a97bcb +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160350' --- +## Acerca de personalizar los {% data variables.product.prodname_codespaces %} +Cuando utilizas cualquier ambiente de desarrollo, personalizar las configuraciones y herramientas de acuerdo con tus preferencias y flujos de trabajo es un paso importante. {% data variables.product.prodname_github_codespaces %} permite dos formas principales de personalizar tus codespaces. -## About personalizing {% data variables.product.prodname_codespaces %} +- [Sincronización de ajustes](#settings-sync): puedes sincronizar los ajustes de {% data variables.product.prodname_vscode %} entre la aplicación de escritorio y el cliente web de {% data variables.product.prodname_vscode_shortname %}. +- [Dotfiles](#dotfiles): puede usar un repositorio `dotfiles` para especificar scripts, preferencias de shell y otras configuraciones. -When using any development environment, customizing the settings and tools to your preferences and workflows is an important step. {% data variables.product.prodname_github_codespaces %} allows for two main ways of personalizing your codespaces. +La personalización de {% data variables.product.prodname_github_codespaces %} se aplica a cualquier codespace que crees. -- [Settings Sync](#settings-sync) - You can synchronize your {% data variables.product.prodname_vscode %} settings between the desktop application and the {% data variables.product.prodname_vscode_shortname %} web client. -- [Dotfiles](#dotfiles) – You can use a `dotfiles` repository to specify scripts, shell preferences, and other configurations. +Los mantenendores de proyecto también pueden definir una configuración predeterminada que aplique a cada codespace para un repositorio que cree alguien más. Para obtener más información, consulte "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". -{% data variables.product.prodname_github_codespaces %} personalization applies to any codespace you create. +## Sincronización de ajustes -Project maintainers can also define a default configuration that applies to every codespace for a repository, created by anyone. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." +La sincronización de ajustes te permite sincronizar configuraciones tales como configuraciones, métodos abreviados de teclado, fragmentos de código, extensiones y estados de IU entre máquinas e instancias de {% data variables.product.prodname_vscode_shortname %}. -## Settings Sync +Para habilitar la sincronización de ajustes, en la esquina inferior izquierda de la barra de actividad de {% data variables.product.prodname_vscode %}, selecciona {% octicon "gear" aria-label="The gear icon" %} y haz clic en **Activar la sincronización de ajustes…** . En la caja de diálogo, selecciona los ajustes que te gustaría sincronizar. -Settings Sync allows you to synchronize configurations such as settings, keyboard shortcuts, snippets, extensions, and UI state across machines and instances of {% data variables.product.prodname_vscode_shortname %}. +![La opción de sincronización de ajustes en el menú de administración](/assets/images/help/codespaces/codespaces-manage-settings-sync.png) -To enable Settings Sync, in the bottom-left corner of {% data variables.product.prodname_vscode %}'s Activity Bar, select {% octicon "gear" aria-label="The gear icon" %} and click **Turn on Settings Sync…**. In the dialog box, select the settings you'd like to sync. - -![Setting Sync option in manage menu](/assets/images/help/codespaces/codespaces-manage-settings-sync.png) - -For more information, see the [Settings Sync guide](https://code.visualstudio.com/docs/editor/settings-sync) in the {% data variables.product.prodname_vscode_shortname %} documentation. +Para obtener más información, consulta la "[Guía de sincronización de ajustes](https://code.visualstudio.com/docs/editor/settings-sync)" en la documentación de {% data variables.product.prodname_vscode_shortname %}. ## Dotfiles -Dotfiles are files and folders on Unix-like systems starting with `.` that control the configuration of applications and shells on your system. You can store and manage your dotfiles in a repository on {% data variables.product.prodname_dotcom %}. For advice and tutorials about what to include in your dotfiles repository, see [GitHub does dotfiles](https://dotfiles.github.io/). +Los dotfile son archivos y carpetas de sistemas similares a Unix que comienzan con `.` y que controlan la configuración de aplicaciones y shells en el sistema. Puedes alamacenar y administrar tus dotfiles en un repositorio en {% data variables.product.prodname_dotcom %}. Para obtener consejos y tutoriales sobre qué incluir en el repositorio de dotfile, vea [Dotfile en GitHub](https://dotfiles.github.io/). -Your dotfiles repository might include your shell aliases and preferences, any tools you want to install, or any other codespace personalization you want to make. +Tu repositorio dotfiles puede incluir los alias de tu shell y tus preferencias, cualquier herramienta que quieras instalar o cualquier otra personalización del codespace que quieras hacer. -You can configure {% data variables.product.prodname_github_codespaces %} to use dotfiles from any repository you own by selecting that repository in your [personal {% data variables.product.prodname_github_codespaces %} settings](https://github.com/settings/codespaces). +Puedes configurar {% data variables.product.prodname_github_codespaces %} para usar dotfiles desde cualquier repositorio que poseas si seleccionas ese repositorio en la [configuración personal de {% data variables.product.prodname_github_codespaces %}](https://github.com/settings/codespaces). -When you create a new codespace, {% data variables.product.prodname_dotcom %} clones your selected dotfiles repository to the codespace environment, and looks for one of the following files to set up the environment. +Cuando crea un codespace nuevo, {% data variables.product.prodname_dotcom %} clona su repositorio de dotfiles seleccionado hacia el ambiente del codespace, y busca uno de los siguientes archivos para configurar el ambiente. * _install.sh_ * _install_ @@ -58,48 +62,47 @@ When you create a new codespace, {% data variables.product.prodname_dotcom %} cl * _setup_ * _script/setup_ -If none of these files are found, then any files or folders in your selected dotfiles repository starting with `.` are symlinked to the codespace's `~` or `$HOME` directory. +Si no se encuentra ninguno de estos archivos, los archivos o carpetas del repositorio dotfiles seleccionado que empiezan por `.` se enlazan de forma simbólica al directorio `~` o `$HOME` del codespace. -Any changes to your selected dotfiles repository will apply only to each new codespace, and do not affect any existing codespace. +Cualquier cambio al repositorio de dotfiles que seleccionaste se aplicará únicamente a cada codespace nuevo y no afectará a ningún codespace existente. {% note %} -**Note:** Currently, {% data variables.product.prodname_codespaces %} does not support personalizing the User-scoped settings for {% data variables.product.prodname_vscode_shortname %} with your `dotfiles` repository. You can set default Workspace and Remote [Codespaces] settings for a specific project in the project's repository. For more information, see "[Introduction to dev containers](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project#creating-a-custom-dev-container-configuration)." +**Nota:** Actualmente, en {% data variables.product.prodname_codespaces %} no se admite la personalización de la configuración con ámbito de usuario para {% data variables.product.prodname_vscode_shortname %} con el repositorio `dotfiles`. Puede establecer la configuración predeterminada Área de trabajo y Repositorio remoto [Codespaces] para un proyecto específico en el repositorio del proyecto. Para obtener más información, consulte "[Introducción a los contenedores de desarrollo](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project#creating-a-custom-dev-container-configuration)". {% endnote %} -### Enabling your dotfiles repository for {% data variables.product.prodname_codespaces %} +### Habilitar tu repositorio de dotfiles para {% data variables.product.prodname_codespaces %} -You can use your selected dotfiles repository to personalize your {% data variables.product.prodname_github_codespaces %} environment. Once you choose your dotfiles repository, you can add your scripts, preferences, and configurations to it. You then need to enable your dotfiles from your personal {% data variables.product.prodname_github_codespaces %} settings page. +Puedes utilizar el repositorio de dotfiles seleccionado para personalizar tu entorno de {% data variables.product.prodname_github_codespaces %}. Una vez que elijas tu repositorio de dotfiles, puedes agregar tus scripts, preferencias y configuraciones a este. Después, necesitarás habilitar tus dotfiles desde tu página personal de ajustes de {% data variables.product.prodname_github_codespaces %}. {% warning %} -**Warning:** Dotfiles have the ability to run arbitrary scripts, which may contain unexpected or malicious code. Before installing a dotfiles repo, we recommend checking scripts to ensure they don't perform any unexpected actions. +**Advertencia:** Los dotfile tienen la capacidad de ejecutar scripts arbitrarios, que podrían contener código malicioso o inesperado. Antes de instalar un repositorio de dotfiles, te recomendamos verificar los scripts para asegurarte de que no realicen acciones inesperadas. {% endwarning %} -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Dotfiles", select **Automatically install dotfiles** so that {% data variables.product.prodname_github_codespaces %} automatically installs your dotfiles into every new codespace you create. - ![Installing dotfiles](/assets/images/help/codespaces/install-custom-dotfiles.png) -2. Choose the repository you want to install dotfiles from. - ![Selecting a dotfiles repo](/assets/images/help/codespaces/select-dotfiles-repo.png) +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. En "Dotfiles", selecciona **Instalar dotfiles automáticamente** para que {% data variables.product.prodname_github_codespaces %} instale los dotfiles de forma automática en cada codespace que crees. + ![Instalación de dotfiles](/assets/images/help/codespaces/install-custom-dotfiles.png) +2. Elige el repositorio desde el cual quieras instalar dotfiles. + ![Selección de un repositorio de dotfiles](/assets/images/help/codespaces/select-dotfiles-repo.png) -You can add further script, preferences, configuration files to your dotfiles repository or edit existing files whenever you want. Changes to settings will only be picked up by new codespaces. +Puedes agregar más scripts, preferencias o archivos de configuración a tu repositorio de dotfiles o editar los archivos existentes cuando lo desees. Solo los codespaces nuevos tomarán los cambios a los ajustes. -If your codespace fails to pick up configuration settings from dotfiles, see "[Troubleshooting dotfiles for {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces)." +Si el codespace no puede seleccionar las opciones de configuración de los dotfiles, consulta "[Solución de problemas de dotfiles para {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces)". -## Other available settings +## Otros ajustes disponibles -You can also personalize {% data variables.product.prodname_github_codespaces %} using additional options in [your personal settings](https://github.com/settings/codespaces): +También puedes personalizar {% data variables.product.prodname_github_codespaces %} con opciones adicionales en [tu configuración personal](https://github.com/settings/codespaces): -- To enable GPG verification, see "[Managing GPG verification for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)." -- To set your editor, see "[Setting your default editor for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)." -- To set how long a codespace can remain unused before it is automatically stopped, see "[Setting your timeout period for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)." -- To set the period for which your unused codespaces are retained, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)." -- To set your default region, see "[Setting your default region for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)." +- Para habilitar la comprobación de GPG, consulta "[Administración de la comprobación de GPG para {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)". +- Para establecer el editor, consulta "[Configuración del editor predeterminado para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)". +- Para establecer cuánto tiempo puede permanecer un codespace sin usar antes de que se detenga automáticamente, consulta "[Establecimiento del periodo de tiempo de espera para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)". +- Para establecer el periodo durante el que se conservan los codespaces sin usar, consulta "[Configuración de la eliminación automática de los codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)". +- Para configurar la región predeterminada, consulta "[Configuración de la región predeterminada para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)". -## Further reading +## Información adicional -* "[Creating a new repository](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)" -* "[Deep dive into {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive#personalizing-your-codespace-with-extensions-or-plugins)" \ No newline at end of file +* "[Creación de un repositorio](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)" +* "[Análisis en profundidad de {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive#personalizing-your-codespace-with-extensions-or-plugins)" diff --git a/translations/es-ES/content/codespaces/customizing-your-codespace/renaming-a-codespace.md b/translations/es-ES/content/codespaces/customizing-your-codespace/renaming-a-codespace.md index 04b0d5b52f..1960ef1420 100644 --- a/translations/es-ES/content/codespaces/customizing-your-codespace/renaming-a-codespace.md +++ b/translations/es-ES/content/codespaces/customizing-your-codespace/renaming-a-codespace.md @@ -1,6 +1,6 @@ --- -title: Renaming a codespace -intro: 'You can change the codespace display name to one of your choice through {% data variables.product.prodname_dotcom_the_website %} or the {% data variables.product.prodname_cli %}.' +title: Cambio del nombre de un codespace +intro: 'Puedes cambiar el nombre para mostrar del codespace a uno de tu elección mediante {% data variables.product.prodname_dotcom_the_website %} o la {% data variables.product.prodname_cli %}.' versions: fpt: '*' ghec: '*' @@ -10,69 +10,74 @@ topics: - Fundamentals - Developer shortTitle: Rename a codespace +ms.openlocfilehash: dcb4558cce7ca0768524917a46cde2a49bacd1ce +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158721' --- +## Acerca del cambio del nombre de un codespace -## About renaming a codespace +A cada codespace se le asigna un nombre para mostrar generado automáticamente. Si tienes varios codespaces, el nombre para mostrar te ayuda a diferenciar entre ellos. Por ejemplo: `literate space parakeet`. Puedes cambiar el nombre para mostrar del codespace. -Each codespace is assigned an auto-generated display name. If you have multiple codespaces, the display name helps you to differentiate between codespaces. For example: `literate space parakeet`. You can change the display name for your codespace. +Para encontrar el nombre para mostrar de un codespace: -To find the display name of a codespace: +- En {% data variables.product.product_name %}, consulta la lista de codespaces en https://github.com/codespaces. -- On {% data variables.product.product_name %}, view your list of codespaces at https://github.com/codespaces. + ![Captura de pantalla de la lista de codespaces en GitHub](/assets/images/help/codespaces/codespaces-list-display-name.png) - ![Screenshot of the list of codespaces in GitHub](/assets/images/help/codespaces/codespaces-list-display-name.png) +- En la aplicación de escritorio {% data variables.product.prodname_vscode %} o el cliente web {% data variables.product.prodname_vscode_shortname %}, haz clic en el Explorador remoto. El nombre para mostrar es el segundo elemento de la lista. Por ejemplo: `symmetrical space telegram` en la captura de pantalla siguiente. -- In the {% data variables.product.prodname_vscode %} desktop application, or the {% data variables.product.prodname_vscode_shortname %} web client, click the Remote Explorer. The display name is the second item in the list. For example: `symmetrical space telegram` in the screenshot below. - - ![Screenshot of the Remote Explorer in VS Code](/assets/images/help/codespaces/codespaces-remote-explorer.png) + ![Captura de pantalla del Explorador remoto en VS Code](/assets/images/help/codespaces/codespaces-remote-explorer.png) {% indented_data_reference reusables.codespaces.remote-explorer spaces=2 %} -- In a terminal window on your local machine, use this {% data variables.product.prodname_cli %} command: `gh codespace list`. +- En una ventana de terminal de la máquina local, usa este comando de {% data variables.product.prodname_cli %}: `gh codespace list`. -### Permanent codespace names +### Nombres permanentes de codespace -In addition to the display name, when you create a codespace, a permanent name is also assigned to the codespace. The name is a combination of your {% data variables.product.company_short %} handle, and the auto-generated display name. For example: `octocat-literate-space-parakeet-mld5`. You can't change the permanent name. +Además del nombre para mostrar, al crear un codespace, también se le asigna un nombre permanente. El nombre es una combinación de tu identificador de {% data variables.product.company_short %} y el nombre para mostrar autogenerado. Por ejemplo: `octocat-literate-space-parakeet-mld5`. No se puede cambiar el nombre permanente. -To find the permanent name of a codespace: +Para encontrar el nombre de un codespace: -* On {% data variables.product.product_name %}, the permanent name is shown in a pop-up when you hover over the display name of a codespace on https://github.com/codespaces. +* En {% data variables.product.product_name %}, el nombre permanente se muestra en un elemento emergente al mantener el puntero sobre el nombre para mostrar de un codespace en https://github.com/codespaces. - ![Screenshot of the codespace name shown on hover over](/assets/images/help/codespaces/find-codespace-name-github.png) + ![Captura de pantalla del nombre del codespace que se muestra al mantener el puntero](/assets/images/help/codespaces/find-codespace-name-github.png) -* In a codespace, use this command in the terminal: `echo $CODESPACE_NAME`. -* In a terminal window on your local machine, use this {% data variables.product.prodname_cli %} command: `gh codespace list`. +* En un codespace, use este comando en el terminal: `echo $CODESPACE_NAME`. +* En una ventana de terminal de la máquina local, usa este comando de {% data variables.product.prodname_cli %}: `gh codespace list`. -## Renaming a codespace +## Cambio del nombre de un codespace -Changing the display name of a codespace can be useful if you have multiple codespaces that you will be using for an extended period. An appropriate name helps you identify a codespace that you use for a particular purpose. +Cambiar el nombre para mostrar de un codespace puede ser útil si tienes varios codespaces que vas a usar durante un período prolongado. Un nombre adecuado te ayuda a identificar un codespace que se usa para un propósito determinado. {% cli %} -You can change the display name for your codespace by using the {% data variables.product.prodname_cli %}. +Puedes cambiar el nombre para mostrar de tu codespace mediante {% data variables.product.prodname_cli %}. -To rename a codespace, use the `gh codespace edit` subcommand: +Para cambiar el nombre de un codespace, usa el subcomando `gh codespace edit`: ```shell gh codespace edit -c PERMANENT-CODESPACE-NAME -d NEW-DISPLAY-NAME ``` -In this example, replace `PERMANENT-CODESPACE-NAME` with the permanent name of the codespace whose display name you want to change. Replace `NEW-DISPLAY-NAME` with the display name you want to use for this codespace. +En este ejemplo, reemplaza `PERMANENT-CODESPACE-NAME` por el nombre permanente del codespace cuyo nombre para mostrar quieres cambiar. Reemplaza `NEW-DISPLAY-NAME` por el nombre para mostrar que quieres usar para este codespace. -For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli#rename-a-codespace)." +Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} con la {% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli#rename-a-codespace)". {% endcli %} {% webui %} -You can change the display name for your codespace on {% data variables.product.prodname_dotcom_the_website %}. +Puedes cambiar el nombre para mostrar de tu codespace en {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.codespaces.your-codespaces-procedure-step %} The current display name for each of your codespaces is displayed. {% data reusables.codespaces.ellipsis-settings %} -1. Click **Rename**. +1. Haga clic en **Rename**. -1. In the prompt, under "Change display name to..." type your desired display name and click **OK**. +1. En el símbolo del sistema, en "Cambiar el nombre para mostrar a…", escribe el nombre para mostrar que quieras y haz clic en **Aceptar**. -{% endwebui %} \ No newline at end of file +{% endwebui %} diff --git a/translations/es-ES/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md b/translations/es-ES/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md index ad415c4536..af3f39af06 100644 --- a/translations/es-ES/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md +++ b/translations/es-ES/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md @@ -1,5 +1,5 @@ --- -title: Setting your default editor for GitHub Codespaces +title: Configuración del editor predeterminado para GitHub Codespaces shortTitle: Set the default editor intro: '{% data reusables.codespaces.about-changing-default-editor %}' versions: @@ -11,40 +11,44 @@ redirect_from: topics: - Codespaces type: how_to +ms.openlocfilehash: 5c286ffe8f96d275dc0b20949a87b7ced411c9af +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159932' --- - -On the settings page, you can set your editor preference so that when you create a codespace, or open an existing codespace, it is opened in your choice of: -* {% data variables.product.prodname_vscode %} (desktop application) -* {% data variables.product.prodname_vscode %} (web client application) -* JetBrains Gateway - for opening codespaces in a JetBrains IDE -* JupyterLab - the web interface for Project Jupyter +En la página de configuración, puedes establecer la preferencia del editor de modo que, al crear un codespace o abrir uno existente, se abra en lo que hayas elegido: +* {% data variables.product.prodname_vscode %} (aplicación de escritorio) +* {% data variables.product.prodname_vscode %} (aplicación cliente web) +* JetBrains Gateway (para abrir codespaces en un IDE de JetBrains) +* JupyterLab (interfaz web para Project Jupyter) {% data reusables.codespaces.template-codespaces-default-editor %} -If you want to use {% data variables.product.prodname_vscode %} as your default editor for {% data variables.product.prodname_github_codespaces %}, you need to install {% data variables.product.prodname_vscode %} and the {% data variables.product.prodname_github_codespaces %} extension for {% data variables.product.prodname_vscode %}. For more information, see the [download page for {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/download/) and the [{% data variables.product.prodname_github_codespaces %} extension on the {% data variables.product.prodname_vscode %} marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). +Si quieres usar {% data variables.product.prodname_vscode %} como editor predeterminado para {% data variables.product.prodname_github_codespaces %}, necesitas instalar {% data variables.product.prodname_vscode %} y la extensión de {% data variables.product.prodname_github_codespaces %} para {% data variables.product.prodname_vscode %}. Para más información, vea la [página de descarga de {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/download/) y la [extensión {% data variables.product.prodname_github_codespaces %} en el marketplace de {% data variables.product.prodname_vscode %}](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). -If you want to work on a codespace in a JetBrains IDE you must install the JetBrains Gateway. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)." +Si quieres trabajar en un codespace en un IDE de JetBrains, debes instalar la puerta de enlace de JetBrains. Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} en el IDE de JetBrains](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)". -## Setting your default editor +## Configurar tu editor predeterminado -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Editor preference", select the option you want. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. Debajo de "Preferencia de editor", selecciona la opción que desees. - ![Setting your editor](/assets/images/help/codespaces/select-default-editor.png) + ![Configuración del editor](/assets/images/help/codespaces/select-default-editor.png) * {% data reusables.codespaces.application-installed-locally %}

- * If you choose **{% data variables.product.prodname_vscode %}**, {% data variables.product.prodname_github_codespaces %} will automatically open in the desktop application when you next create or open a codespace. + * Si eliges **{% data variables.product.prodname_vscode %}** , {% data variables.product.prodname_github_codespaces %} se abrirá automáticamente en la aplicación de escritorio la próxima vez que crees o abras un codespace. - You may need to allow access to both your browser and {% data variables.product.prodname_vscode %} for it to open successfully.

+ Podrías necesitar permitir acceso tanto a tu buscador como a {% data variables.product.prodname_vscode %} para que abra con éxito.

- * If you choose **JetBrains Gateway**, the Gateway application will automatically open when you next create or open a codespace. + * Si eliges **JetBrains Gateway**, la aplicación Gateway se abrirá automáticamente al crear o abrir un codespace. - The first time you open a codespace this way you must give permission to open the application. + La primera vez que abras un codespace de esta manera, deberás conceder permiso para abrir la aplicación. - The Gateway application will open and the codespace will then be automatically selected. You can then choose a JetBrains IDE, if you have not previously done so, and click **Connect** to open the codespace in the JetBrains client. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)." + La aplicación Gateway se abrirá y el codespace se seleccionará automáticamente. Después, puedes elegir un IDE de JetBrains, si todavía no lo has hecho, y hacer clic en **Conectar** para abrir el codespace en el cliente de JetBrains. Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} en el IDE de JetBrains](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)". - To connect to a codespace from the Gateway application, you must have an SSH server running on the codespace. {% indented_data_reference reusables.codespaces.ssh-server-installed spaces=5 %} + Para conectarte a un codespace desde la aplicación Gateway, debes tener un servidor SSH que se ejecute en el codespace. {% indented_data_reference reusables.codespaces.ssh-server-installed spaces=5 %} - * If you choose **JupyterLab**, the JupyterLab application must be installed in the codespaces you open. {% data reusables.codespaces.jupyterlab-in-default-image %} + * Si eliges **JupyterLab**, la aplicación JupyterLab debe estar instalada en los codespaces que abras. {% data reusables.codespaces.jupyterlab-in-default-image %} diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/connecting-to-a-private-network.md b/translations/es-ES/content/codespaces/developing-in-codespaces/connecting-to-a-private-network.md index bdaddaa45e..42b074d4ee 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/connecting-to-a-private-network.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/connecting-to-a-private-network.md @@ -1,6 +1,6 @@ --- -title: Connecting to a private network -intro: 'You can connect {% data variables.product.prodname_github_codespaces %} to resources on a private network, including package registries, license servers, and on-premises databases.' +title: Conectarse a una red privada +intro: 'Puedes conectar {% data variables.product.prodname_github_codespaces %} a los recursos de una red privada, incluyendo los registros de paquetes, servidores de licencias y bases de datos en las instalaciones.' versions: fpt: '*' ghec: '*' @@ -9,51 +9,56 @@ topics: - Codespaces - Fundamentals - Developer +ms.openlocfilehash: 92b8f2b9ea438a4cc799aec1969ff6773f90c298 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159924' --- +## Acerca de la creación de redes en los codespaces -## About codespace networking +Predeterminadamente, tus codespaces tienen acceso a todos los recursos en el internet público, incluyendo los administradores de paquetes, servidores de licencias, bases de datos y API de plataforma en la nube, pero no tienen acceso a aquellos de las redes privadas. -By default, your codespaces have access to all resources on the public internet, including package managers, license servers, databases, and cloud platform APIs, but they have no access to resources on private networks. +## Conectar los recursos a una red privada -## Connecting to resources on a private network +Actualmente hay dos métodos de acceso a los recursos en una red privada dentro de {% data variables.product.prodname_github_codespaces %}. +- Con una extensión {% data variables.product.prodname_cli %} para configurar la máquina local como puerta de enlace a recursos remotos. +- Mediante una VPN. -There are currently two methods of accessing resources on a private network within {% data variables.product.prodname_github_codespaces %}. -- Using a {% data variables.product.prodname_cli %} extension to configure your local machine as a gateway to remote resources. -- Using a VPN. - -### Using the GitHub CLI extension to access remote resources +### Mediante la extensión de la CLI de GitHub para acceder a recursos remotos {% note %} -**Note**: The {% data variables.product.prodname_cli %} extension is currently in beta and subject to change. +**Nota**: La extensión {% data variables.product.prodname_cli %} se encuentra actualmente en versión beta pública y está sujeta a cambios. {% endnote %} -The {% data variables.product.prodname_cli %} extension allows you to create a bridge between a codespace and your local machine, so that the codespace can access any remote resource that is accessible from your machine. The codespace uses your local machine as a network gateway to reach those resources. For more information, see "[Using {% data variables.product.prodname_cli %} to access remote resources](https://github.com/github/gh-net#codespaces-network-bridge)." +La extensión {% data variables.product.prodname_cli %} permite crear un puente entre un codespace y la máquina local, de modo que el codespace pueda acceder a cualquier recurso remoto al que se pueda acceder desde la máquina. El codespace usa la máquina local como puerta de enlace de red para llegar a esos recursos. Para obtener más información, vea "[Uso de {% data variables.product.prodname_cli %} para acceder a recursos remotos](https://github.com/github/gh-net#codespaces-network-bridge)". -### Using a VPN to access resources behind a private network +### Utilizar una VPN para acceder a los recursos detrás de una red privada -As an alternative to the {% data variables.product.prodname_cli %} extension, you can use a VPN to access resources behind a private network from within your codespace. +Como alternativa a la extensión {% data variables.product.prodname_cli %}, puede usar una VPN para acceder a los recursos detrás de una red privada desde el espacio de código. -We recommend VPN tools like [OpenVPN](https://openvpn.net/) to access resources on a private network. For more information, see "[Using the OpenVPN client from {% data variables.product.prodname_github_codespaces %}](https://github.com/codespaces-contrib/codespaces-openvpn)." +Se recomiendan herramientas de VPN como [OpenVPN](https://openvpn.net/) para acceder a los recursos de una red privada. Para obtener más información, consulta "[Uso del cliente OpenVPN desde {% data variables.product.prodname_github_codespaces %}](https://github.com/codespaces-contrib/codespaces-openvpn)". -There are also a number of third party solutions that, while not explicitly endorsed by {% data variables.product.prodname_dotcom %}, have provided examples of how to integrate with {% data variables.product.prodname_github_codespaces %}. +También hay muchas soluciones de terceros que, si bien {% data variables.product.prodname_dotcom %} no las respalda explícitamente, han proporcionado ejemplos de cómo integrarse con los {% data variables.product.prodname_github_codespaces %}. -These third party solutions include: +Estas soluciones de terceros incluyen: - [Tailscale](https://tailscale.com/kb/1160/github-codespaces/) -### Allowlisting private resources for codespaces +### Poner los recursos privados en listas de IP permitidas para los codespaces -While {% data variables.product.prodname_dotcom %} publishes IP ranges for several products on its Meta API, codespaces IPs are dynamically assigned, meaning your codespace is not guaranteed to have the same IP address day to day. We highly discourage users from allowlisting an entire IP range, as this would give overly broad access to all codespaces (including users not affiliated with your codespaces). +Si bien {% data variables.product.prodname_dotcom %} publica rangos de IP para diversos productos en su API Meta, las IP de los codespaces se asignan dinámicamente, lo cual significa que no hay garantía de que tu Codespace tenga la misma dirección IP todos los días. Desalentamos enormemente que los usuarios pongan todo un rango de IP en una lista de IP permitidas, ya que esto otorgaría un acceso demasiado amplio a todos ellos (incluyendo a los usuarios que no están afiliados con tus codespaces). -For more information about the Meta API, see "[Meta](/rest/reference/meta)." +Para más información sobre Meta API, vea "[Meta](/rest/reference/meta)". -## Restricting access to the public internet +## Restringir el acceso al internet público -At present, there is no way to restrict codespaces from accessing the public internet, or to restrict appropriately authenticated users from accessing a forwarded port. +En la actualidad, no hay forma de restringir los codespaces para que no accedan al internet público ni de restringir a los usuarios autenticados adecuadamente para que no accedan a un puerto reenviado. -For more information on how to secure your codespaces, see "[Security in {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/security-in-github-codespaces)." +Para obtener más información sobre cómo proteger los codespaces, consulta "[Seguridad en {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/security-in-github-codespaces)." diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template.md b/translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template.md new file mode 100644 index 0000000000..1f90ae0e98 --- /dev/null +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template.md @@ -0,0 +1,102 @@ +--- +title: Creating a codespace from a template +intro: If you're starting a new project, you can create a codespace from a blank template or choose a template specially designed for the type of work you want to do. +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Fundamentals + - Developer +shortTitle: Create a codespace from a template +miniTocMaxHeadingLevel: 3 +--- + +## About templates for {% data variables.product.prodname_github_codespaces %} + +If you're starting a new project, you can get started with development work quickly by creating a codespace from a template. You'll be able to work on your project in a cloud-based development environment, save your files in the cloud, and publish your work to a new remote repository that you can share with others or clone to your local machine. + +{% note %} + +**Note**: Codespaces created from a template, rather than from a repository, are always billed to your personal account. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." + +{% endnote %} + +You can start from a blank template, choose from templates maintained by {% data variables.product.company_short %} for popular technologies such as React or Jupyter Notebook, or launch a codespace from any template repository on {% data variables.product.prodname_dotcom %}. With a blank template, you'll start with an empty directory, with access to cloud-based compute resources and the tools, languages, and runtime environments that come preinstalled with the default codespace image. With other templates, you'll get starter files for the technology you're working with, plus typically some extra files such as a README file, a `.gitignore` file, and dev container configuration files containing some custom environment configuration. For more information on dev containers and the default image, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." + +As an example, if you create a codespace from {% data variables.product.company_short %}'s React template, you'll arrive in a workspace containing template files for a simple application, such as `index.js`, `app.js`, and `package.json`. Shortly after the codespace opens, a development server will start up automatically, and you will be able to view the running application in a simple browser tab within the {% data variables.product.prodname_vscode_shortname %} web client. + +![Screenshot of the React template running in a codespace](/assets/images/help/codespaces/react-template.png) + +The files and configuration included in templates are defined in template repositories. The template repository is cloned into your codespace when you create the codespace. After that, the link is severed, and your codespace won't be linked to a remote repository until you publish to one. + +{% tip %} + +**Tip:** To help people get started with your framework, library, or other project, you can set up a template repository for use with {% data variables.product.prodname_github_codespaces %}. 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)." + +{% endtip %} + +## Creating a codespace from a {% data variables.product.company_short %} template + +Templates maintained by {% data variables.product.company_short %}, including the blank template, are available from the "Your codespaces" page. + +{% data reusables.codespaces.your-codespaces-procedure-step %} +{% data reusables.codespaces.view-all-templates-step %} +1. Optionally, to view the template repository containing the files for a template, click the name of the template. + + ![Screenshot of the "Explore quick start templates" section, with "React" highlighted](/assets/images/help/codespaces/react-template-name.png) + +1. Under the template you want to launch, click **Use this template**. + + ![Screenshot of the quick start templates, with the "Use this template" button highlighted under the React template](/assets/images/help/codespaces/react-template-button.png) + +{% data reusables.codespaces.template-codespaces-default-editor %} + +## Creating a codespace from a template repository + +You can create a codespace from any template repository, then publish your work to a new repository when you are ready. For more information on template repositories, see "[Creating a repository from a template](/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template#about-repository-templates)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.codespaces.open-template-in-codespace-step %} + + {% note %} + + **Note:** If you're a maintainer of the template repository, and want to commit changes to the template repository itself, you should create a codespace from the **{% octicon "code" aria-label="The code icon" %} Code** dropdown. 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)." + + {% endnote %} + +{% data reusables.codespaces.template-codespaces-default-editor %} + +## Publishing to a repository on {% data variables.product.product_name %} + +{% data reusables.codespaces.about-publishing-templates %} + +### Publishing from {% data variables.product.prodname_vscode_shortname %} + +{% data reusables.codespaces.publishing-template-codespaces %} + +When a codespace is published, you have access to a greater range of options to customize your {% data variables.product.prodname_github_codespaces %} experience. For example, you can: + +- Change the machine type of your codespace to make sure you're using resources appropriate for the work you're doing (see "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)"). +- Allow {% data variables.product.prodname_dotcom %} to automatically use GPG to sign commits you make in your codespace (see "[Managing GPG verification for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)"). +- Share encrypted secrets with your codespace (see "[Managing encrypted secrets for your codespaces](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)"). + +### Publishing from {% data variables.product.prodname_dotcom_the_website %} + +You can publish an unpublished codespace from the "Your codespaces" page on {% data variables.product.prodname_dotcom_the_website %}. This is useful if you want to publish a codespace that you don't currently have open in your browser. If you do this, your work will be preserved in a repository, but there won't be a link between your existing codespace and the new repository. However, you can navigate to the new repository and create a codespace from there, and this codespace will be connected to the repository. + +{% data reusables.codespaces.your-codespaces-procedure-step %} +1. Next to the unpublished codespace, click the ellipsis (**...**), then select **Publish to a new repository**. + + ![Screenshot of the "Publish to a new repository" button](/assets/images/help/codespaces/publish-to-new-repository.png) +1. Choose a name for your new repository, set it as **Public** or **Private**, and click **Create repository**. + + ![Screenshot of the "Publish to a new repository" dropdown](/assets/images/help/codespaces/template-new-repository-settings.png) +1. Optionally, to view the new repository, click **See repository**. + +## Further reading + +- "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)" +- "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" +- "[Using source control in your codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)" \ No newline at end of file diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/deleting-a-codespace.md b/translations/es-ES/content/codespaces/developing-in-codespaces/deleting-a-codespace.md index c004006e66..f7e1b10ebb 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/deleting-a-codespace.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/deleting-a-codespace.md @@ -1,6 +1,6 @@ --- -title: Deleting a codespace -intro: You can delete a codespace you no longer need. +title: Borrar un codespace +intro: Puedes borrar un codespace que ya no necesites. redirect_from: - /github/developing-online-with-github-codespaces/deleting-a-codespace - /github/developing-online-with-codespaces/deleting-a-codespace @@ -13,28 +13,33 @@ topics: - Fundamentals - Developer shortTitle: Delete a codespace +ms.openlocfilehash: c9f1f6eb407c985d8981504de28e39a4bf742f7a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158665' --- - -You can delete a codespace in a variety of ways: in the terminal by using {% data variables.product.prodname_cli %}, in {% data variables.product.prodname_vscode %}, or in your web browser. Use the tabs in this article to display instructions for each of these ways of deleting a codespace. +Puedes eliminar un codespace de varias maneras: en el terminal mediante la {% data variables.product.prodname_cli %}, en {% data variables.product.prodname_vscode %} o en el explorador web. Usa las pestañas de este artículo para ver las instrucciones de cada una de estas formas de eliminar un codespace. {% note %} -**Note**: You can't delete a codespace from within the JetBrains Gateway, or the JetBrains client application, or from within JupyterLab. +**Nota**: No se puede eliminar un codespace desde JetBrains Gateway, la aplicación cliente JetBrains o JupyterLab. {% endnote %} -There are costs associated with storing codespaces. You should therefore delete any codespaces you no longer need. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." +Hay costos asociados al almacenamiento de codespaces. Por lo tanto, debes eliminar los codespaces que ya no necesites. Para más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". {% data reusables.codespaces.max-number-codespaces %} -## Deleting a codespace +## Borrar un codespace {% webui %} {% data reusables.codespaces.your-codespaces-procedure-step %} -1. To the right of the codespace you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **{% octicon "trash" aria-label="The trash icon" %} Delete** +1. A la derecha del codespace que quiera eliminar, haga clic en {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} y después en **{% octicon "trash" aria-label="The trash icon" %} Eliminar** - ![Delete button](/assets/images/help/codespaces/delete-codespace.png) + ![Botón Eliminar](/assets/images/help/codespaces/delete-codespace.png) {% endwebui %} @@ -49,48 +54,48 @@ There are costs associated with storing codespaces. You should therefore delete {% data reusables.cli.cli-learn-more %} -To delete a codespace use the `gh codespace delete` subcommand and then choose a codespace from the list that's displayed. +Para eliminar un codespace, use el subcomando `gh codespace delete` y, después, elija un codespace en la lista que se muestra. ```shell gh codespace delete ``` -If you have unsaved changes, you'll be prompted to confirm deletion. You can use the `--force` flag to force deletion, avoiding this prompt. +Si tienes cambios sin guardar, se te pedirá confirmar el borrado. Puede usar la marca `--force` para forzar la eliminación y evitar este aviso. -For more information about this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_delete). +Para más información sobre este comando, vea [el manual de {% data variables.product.prodname_cli %}](https://cli.github.com/manual/gh_codespace_delete). {% endcli %} -## Bulk deleting codespaces +## Eliminación masiva de codespaces {% webui %} -You can use {% data variables.product.prodname_cli %} to delete several or all of your codespaces with a single command. For more information, click the "{% data variables.product.prodname_cli %}" tab near the top of this page. +Puedes usar {% data variables.product.prodname_cli %} para eliminar varios o todos los codespaces con un solo comando. Para obtener más información, haz clic en la pestaña "{% data variables.product.prodname_cli %}" que se encuentra cerca de la parte superior de esta página. {% endwebui %} {% vscode %} -You can use {% data variables.product.prodname_cli %} to delete several or all of your codespaces with a single command. For more information, click the "{% data variables.product.prodname_cli %}" tab near the top of this page. +Puedes usar {% data variables.product.prodname_cli %} para eliminar varios codespaces con un solo comando, o todos ellos. Para obtener más información, haz clic en la pestaña "{% data variables.product.prodname_cli %}" que se encuentra cerca de la parte superior de esta página. {% endvscode %} {% cli %} -You can delete several or all of your codespaces with a single command, using `gh codespace delete` followed by one of these flags: +Puedes eliminar varios codespaces, o todos ellos, con un solo comando mediante `gh codespace delete` seguido de una de estas marcas: -`--all` - Delete all of your codespaces. +`--all`: elimina todos los codespaces. -`--repo REPOSITORY` - Delete all of your codespaces for this repository. Or use together with the `--days` flag to filter by age of the codespace. +`--repo REPOSITORY`: elimina todos los codespaces de este repositorio. O bien, úsalo junto con la marca `--days` para filtrar por antigüedad del codespace. -`--days NUMBER` - Delete all of your codespaces that are older than the specified number of days. Can be used together with the `--repo` flag. +`--days NUMBER`: elimina todos los codespaces anteriores al número de días especificado. Se puede usar junto con la marca `--repo`. -By default you are prompted to confirm deletion of any codespaces that contain unsaved changes. You can use the `--force` flag to skip this confirmation. +De manera predeterminada, se te pedirá que confirmes la eliminación de los codespaces que contengan cambios no guardados. Puedes usar la marca `--force` para omitir esta confirmación. -### Example +### Ejemplo -Delete all of the codespaces for the `octo-org/octo-repo` repository that you created more than 7 days ago. +Elimina todos los codespaces del repositorio `octo-org/octo-repo` que has creado hace más de 7 días. ``` gh codespace delete --repo octo-org/octo-repo --days 7 @@ -98,37 +103,37 @@ gh codespace delete --repo octo-org/octo-repo --days 7 {% endcli %} -## Deleting codespaces in your organization +## Eliminación de codespaces en la organización -As an organization owner, you can use {% data variables.product.prodname_cli %} to delete any codespace in your organization. +Como propietario de la organización, puedes usar {% data variables.product.prodname_cli %} para eliminar cualquier codespace de la organización. {% webui %} -For more information, click the "{% data variables.product.prodname_cli %}" tab near the top of this page. +Para obtener más información, haz clic en la pestaña "{% data variables.product.prodname_cli %}" que se encuentra cerca de la parte superior de esta página. {% endwebui %} {% vscode %} -For more information, click the "{% data variables.product.prodname_cli %}" tab near the top of this page. +Para obtener más información, haz clic en la pestaña "{% data variables.product.prodname_cli %}" que se encuentra cerca de la parte superior de esta página. {% endvscode %} {% cli %} -1. Enter one of these commands to display a list of codespaces. - * `gh codespace delete --org ORGANIZATION` - Lists the current codespaces in the specified organization. - * `gh codespace delete --org ORGANIZATION --user USER` - Lists only those codespaces created by the specified user. - You must be an owner of the specified organization. -1. In the list of codespaces, navigate to the codespace you want to delete. -1. To delete the selected codespace press Enter. +1. Escribe uno de estos comandos para mostrar una lista de codespaces. + * `gh codespace delete --org ORGANIZATION` : enumera los codespaces actuales de la organización especificada. + * `gh codespace delete --org ORGANIZATION --user USER` : enumera solo los codespaces creados por el usuario especificado. + Debes ser un propietario de la organización especificada. +1. En la lista de codespaces, ve al codespace que desees eliminar. +1. Para eliminar el codespace seleccionado, presiona Entrar. - If the codespace contains unsaved changes you will be prompted to confirm deletion. + Si el codespace contiene cambios no guardados, se te pedirá que confirmes la eliminación. {% endcli %} -You can also use the REST API to delete codespaces for your organization. For more information, see "[Codespaces organizations](/rest/codespaces/organizations#delete-a-codespace-from-the-organization)." +También puedes usar la API de REST para eliminar codespaces para tu organización. Para más información, consulta "[Organizaciones de Codespaces](/rest/codespaces/organizations#delete-a-codespace-from-the-organization)". -## Further reading -- "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" -- "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)" +## Información adicional +- "[Ciclo de vida de un codespace](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" +- "[Configuración de la eliminación automática de los codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)" diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/developing-in-a-codespace.md b/translations/es-ES/content/codespaces/developing-in-codespaces/developing-in-a-codespace.md index 0de2f28409..c5d1e57403 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/developing-in-a-codespace.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/developing-in-a-codespace.md @@ -1,6 +1,6 @@ --- -title: Developing in a codespace -intro: 'You can work in a codespace using your browser, {% data variables.product.prodname_vscode %}, a JetBrains IDE, or in a command shell.' +title: Desarrollar en un codespace +intro: 'Puedes trabajar en un codespace mediante el explorador, {% data variables.product.prodname_vscode %}, un IDE de JetBrains o en un shell de comandos.' redirect_from: - /github/developing-online-with-github-codespaces/developing-in-a-codespace - /github/developing-online-with-codespaces/developing-in-a-codespace @@ -13,127 +13,129 @@ topics: - Fundamentals - Developer shortTitle: Develop in a codespace +ms.openlocfilehash: e941373ade8c2f8365e7b654733b7ee029a6a7dd +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159073' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -## About development with {% data variables.product.prodname_github_codespaces %} +## Acerca del desarrollo con {% data variables.product.prodname_github_codespaces %} -You can develop code in a codespace using your choice of tool: +Puedes desarrollar código en un codespace con la herramienta que prefieras: -* A command shell, via an SSH connection initiated using {% data variables.product.prodname_cli %}. -* One of the JetBrains IDEs, via the JetBrains Gateway. -* The {% data variables.product.prodname_vscode %} desktop application. -* A browser-based version of {% data variables.product.prodname_vscode %}. +* Un shell de comandos, a través de una conexión SSH iniciada mediante {% data variables.product.prodname_cli %}. +* Uno de los IDE de JetBrains, a través de la puerta de enlace de JetBrains. +* Aplicación de escritorio {% data variables.product.prodname_vscode %}. +* Una versión basada en explorador de {% data variables.product.prodname_vscode %}. {% webui %} -The tabs in this article allow you to switch between information for each of these ways of working. You're currently on the tab for the web browser version of {% data variables.product.prodname_vscode %}. +Las pestañas de este artículo te permiten cambiar de información para cada una de estas formas de trabajo. Actualmente estás en la pestaña de la versión del explorador web de {% data variables.product.prodname_vscode %}. -## Working in a codespace in the browser +## Trabajo en un codespace en el explorador -Using {% data variables.product.prodname_codespaces %} in the browser provides you with a fully featured development experience. You can edit code, debug, use Git commands, and run your application. +El uso de {% data variables.product.prodname_codespaces %} en el explorador proporciona una experiencia de desarrollo completa. Puedes editar código, depurar, usar comandos de Git y ejecutar la aplicación. -![Annotated screenshot of a codespace in the browser](/assets/images/help/codespaces/codespace-overview-annotated.png) +![Captura de pantalla anotada de un codespace en el explorador](/assets/images/help/codespaces/codespace-overview-annotated.png) -{% data reusables.codespaces.vscode-interface-annotation %} -{% data reusables.codespaces.use-chrome %} For more information, see "[Troubleshooting {% data variables.product.prodname_github_codespaces %} clients](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)." -{% data reusables.codespaces.developing-in-vscode %} -{% data reusables.codespaces.navigating-to-a-codespace %} +{% data reusables.codespaces.vscode-interface-annotation %} {% data reusables.codespaces.use-chrome %} Para obtener más información, consulta "[Solución de problemas de clientes de {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)". +{% data reusables.codespaces.developing-in-vscode %} {% data reusables.codespaces.navigating-to-a-codespace %} {% endwebui %} {% vscode %} -The tabs in this article allow you to switch between information for each of these ways of working. You're currently on the tab for {% data variables.product.prodname_vscode %}. +Las pestañas de este artículo te permiten cambiar de información para cada una de estas formas de trabajo. Actualmente estás en la pestaña de {% data variables.product.prodname_vscode %}. -## Working in a codespace in {% data variables.product.prodname_vscode_shortname %} +## Trabajo en un codespace en {% data variables.product.prodname_vscode_shortname %} -{% data variables.product.prodname_github_codespaces %} provides you with the full development experience of {% data variables.product.prodname_vscode %}. {% data reusables.codespaces.use-visual-studio-features %} +{% data variables.product.prodname_github_codespaces %} te proporciona la experiencia completa de desarrollo de {% data variables.product.prodname_vscode %}. {% data reusables.codespaces.use-visual-studio-features %} -![Annotated screenshot of a codespace in VS Code](/assets/images/help/codespaces/codespace-annotated-vscode.png) +![Captura de pantalla anotada de un codespace en VS Code](/assets/images/help/codespaces/codespace-annotated-vscode.png) {% data reusables.codespaces.vscode-interface-annotation %} -For more information on using {% data variables.product.prodname_vscode_shortname %}, see the [User Interface guide](https://code.visualstudio.com/docs/getstarted/userinterface) in the {% data variables.product.prodname_vscode_shortname %} documentation. +Para obtener más información sobre el uso de {% data variables.product.prodname_vscode_shortname %}, consulta la [guía de la interfaz de usuario](https://code.visualstudio.com/docs/getstarted/userinterface) en la documentación de {% data variables.product.prodname_vscode_shortname %}. {% data reusables.codespaces.connect-to-codespace-from-vscode %} -For troubleshooting information, see "[Troubleshooting Codespaces clients](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)." -{% data reusables.codespaces.developing-in-vscode %} -{% data reusables.codespaces.navigating-to-a-codespace %} +Para obtener información de solución de problemas, consulta "[Solución de problemas de clientes de codespaces](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)". +{% data reusables.codespaces.developing-in-vscode %} {% data reusables.codespaces.navigating-to-a-codespace %} {% endvscode %} {% jetbrains %} -The tabs in this article allow you to switch between information for each of these ways of working. You're currently on the tab for JetBrains IDEs. +Las pestañas de este artículo te permiten cambiar de información para cada una de estas formas de trabajo. Actualmente estás en la pestaña de los IDE de JetBrains. -## Working in a codespace in a JetBrains IDE +## Trabajo en un codespace en un IDE de JetBrains -To use {% data variables.product.prodname_github_codespaces %} with a JetBrains IDE you must have already installed JetBrains Gateway. For information about installing JetBrains Gateway, see [the JetBrains website](https://www.jetbrains.com/remote-development/gateway/). +Para usar {% data variables.product.prodname_github_codespaces %} con un IDE de JetBrains, debes tener ya instalada la puerta de enlace de JetBrains. Para obtener información sobre cómo instalar JetBrains Gateway, consulta [el sitio web de JetBrains](https://www.jetbrains.com/remote-development/gateway/). -You can work in a codespace using your choice of JetBrains IDE. After creating a codespace, you can use the JetBrains Gateway application to open the codespace in your preferred IDE. +Puedes trabajar en un codespace mediante el IDE de JetBrains que prefieras. Después de crear un codespace, puedes usar la aplicación puerta de enlace de JetBrains para abrir el codespace en el IDE que prefieras. -You can edit code, debug, and use Git commands while developing in a codespace with your JetBrains IDE. For more information about the various JetBrains IDEs, see the [JetBrains documentation](https://www.jetbrains.com/help/). +Puedes editar código, depurar y usar comandos de Git mientras desarrollas en un codespace con la IDE de JetBrains. Para obtener más información sobre los distintos IDE de JetBrains, consulta la [documentación de JetBrains](https://www.jetbrains.com/help/). -### IntelliJ IDEA user interface +### Interfaz de usuario de IntelliJ IDEA -Within the {% data variables.product.prodname_github_codespaces %} documentation we use IntelliJ IDEA as a representative JetBrains IDE. Different JetBrains IDEs may have different layouts. +En la documentación de {% data variables.product.prodname_github_codespaces %}, usamos IntelliJ IDEA como un IDE de JetBrains representativo. Los diferentes IDE de JetBrains pueden tener diseños diferentes. -![Annotated screenshot of a codespace in JetBrains IntelliJ IDEA](/assets/images/help/codespaces/jetbrains-gui-with-callouts.png) +![Captura de pantalla anotada de un codespace en JetBrains IntelliJ IDEA](/assets/images/help/codespaces/jetbrains-gui-with-callouts.png) -1. **Navigation bar** - This displays the path to the currently selected file or directory. Use the buttons to the right of the navigation bar to perform various actions, including building, running, or debugging the project, or running Git commands to commit and push your changes. -2. **Project tool window** - This shows you the structure of your project and allows you to open files in the editor. -3. **{% data variables.product.prodname_github_codespaces %} tool window** - This is displayed by clicking the {% data variables.product.prodname_github_codespaces %} plugin in the bar to the left of the tool window. It displays information about your codespace, including its display name and machine type. The buttons at the top of this tool window allow you to: - * Stop the codespace and disconnect - * Display the "Your codespaces" web page - * View the codespace creation logs - * Rebuild the dev container -4. **Editor** - This is where you edit your files. You can right-click the tab for a file to access options such as moving the tab to a new window. -5. **Terminal** - This is displayed by clicking **Terminal** in the tool window bar at the bottom of the main window (just above the status bar). The integrated terminal allows you to perform command-line tasks without having to switch to a dedicated terminal application. -6. **Status bar** - Hover over the icon at the left of the status bar to see a list of tools. Click the icon to hide or show the tool window bars. The right side of the status bar shows information about the project, including the current Git branch. +1. **Barra de navegación**: muestra la ruta de acceso al archivo o directorio seleccionado actualmente. Usa los botones situados a la derecha de la barra de navegación para realizar diversas acciones, como compilar, ejecutar o depurar el proyecto, o ejecutar comandos de Git para confirmar e insertar los cambios. +2. **Ventana de herramientas del proyecto**: muestra la estructura del proyecto y permite abrir archivos en el editor. +3. **Ventana de herramientas de {% data variables.product.prodname_github_codespaces %}** : se muestra al hacer clic en el complemento de {% data variables.product.prodname_github_codespaces %} de la barra a la izquierda de la ventana de herramientas. Muestra información sobre el codespace, incluido su nombre para mostrar y el tipo de equipo. Los botones de la parte superior de esta ventana de herramientas permiten: + * Detener el codespace y desconectarse + * Mostrar la página web "Tus codespaces" + * Ver los registros de creación de codespaces + * Recompilar el contenedor de desarrollo +4. **Editor**: aquí es donde editas tus archivos. Puedes hacer clic con el botón derecho en la pestaña de un archivo para acceder a opciones como mover la pestaña a una nueva ventana. +5. **Terminal**: se muestra al hacer clic en **Terminal** en la barra de la ventana de herramientas de la parte inferior de la ventana principal (encima de la barra de estado). El terminal integrado permite realizar tareas de línea de comandos sin tener que cambiar a una aplicación de terminal dedicada. +6. **Barra de estado**: mantén el puntero sobre el icono situado a la izquierda de la barra de estado para ver una lista de herramientas. Haz clic en el icono para ocultar o mostrar las barras de la ventana de herramientas. En el lado derecho de la barra de estado se muestra información sobre el proyecto, incluida la rama de Git actual. -For more information about the IntelliJ IDEA user interface, see the [JetBrains documentation for IntelliJ IDEA](https://www.jetbrains.com/help/idea/guided-tour-around-the-user-interface.html). +Para obtener más información sobre la interfaz de usuario de IntelliJ IDEA, consulta la [documentación de JetBrains para IntelliJ IDEA](https://www.jetbrains.com/help/idea/guided-tour-around-the-user-interface.html). -### Customizing the codespaces for a repository +### Personalización de los codespaces para un repositorio -You can customize the codespaces that are created for a repository by creating or updating the dev container configuration for the repository. You can do this from within a codespace. After you change a dev container configuration, you can apply the changes to the current codespace by rebuilding the Docker container for the codespace. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." +Puedes personalizar los codespaces creados para un repositorio mediante la creación o actualización de la configuración del contenedor de desarrollo para el repositorio. Puedes hacerlo desde un codespace. Después de cambiar una configuración de contenedor de desarrollo, puedes aplicar los cambios en el codespace actual si recompilas el contenedor de Docker para el codespace. Para obtener más información, consulte "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". -### Personalizing your codespace +### Personalizar tu codespace -You can use a [dotfiles](https://dotfiles.github.io/tutorials/) repository to personalize aspects of the codespace environment for any codespace that you create. For more information, see "[Personalizing {% data variables.product.prodname_github_codespaces %} for your account](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#dotfiles)." +Puedes usar un repositorio [dotfiles](https://dotfiles.github.io/tutorials/) para personalizar aspectos del entorno de codespace para cualquier codespace que crees. Para más información, consulta "[Personalización de {% data variables.product.prodname_github_codespaces %} para la cuenta](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#dotfiles)". -### Committing your changes +### Configramr tus cambios -Once you've made changes to your codespace, either new code or configuration changes, you'll want to commit and push your changes. Pushing changes to a repository ensures that anyone else who creates a codespace from this repository has the same configuration. This also means that any customization you do, to modify the configuration of codespaces created for a repository, will be available to everybody who uses the repository. +Después de hacer cambios en el codespace, ya sea introducir código nuevo o cambiar la configuración, tendrás que confirmar y enviar los cambios. Enviar los cambios al repositorio garantiza que cualquiera que cree un codespace desde este repositorio tendrá la misma configuración. Esto también significa que cualquier personalización que hagas para modificar la configuración de los codespaces creados para un repositorio estará disponible para todos los usuarios que usen el repositorio. -For more information, see "[Using source control in your codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace#committing-your-changes)." +Para más información, vea "[Uso del control de código fuente en el codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace#committing-your-changes)". -## Further reading +## Información adicional -* "[Using {% data variables.product.prodname_github_codespaces %} in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)" -* "[Using the {% data variables.product.prodname_github_codespaces %} plugin for JetBrains](/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains)" -* "[Troubleshooting {% data variables.product.prodname_github_codespaces %} clients](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)" +* "[Uso de {% data variables.product.prodname_github_codespaces %} en el IDE de JetBrains](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)" +* "[Uso del complemento de {% data variables.product.prodname_github_codespaces %} para JetBrains](/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains)" +* "[Solución de problemas de clientes de {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)" {% endjetbrains %} {% cli %} -The tabs in this article allow you to switch between information for each of these ways of working. You're currently on the tab for {% data variables.product.prodname_cli %}. +Las pestañas de este artículo te permiten cambiar de información para cada una de estas formas de trabajo. Actualmente estás en la pestaña de {% data variables.product.prodname_cli %}. -## Working in a codespace in a command shell +## Trabajo en un codespace en un shell de comandos {% data reusables.cli.cli-learn-more %} -You can use {% data variables.product.prodname_cli %} to create a new codespace, or start an existing codespace, and then SSH to it. Once connected, you can work on the command line using your preferred command-line tools. +Puedes usar {% data variables.product.prodname_cli %} para crear un codespace o iniciar uno existente y, luego, conectarte mediante SSH a él. Una vez que te hayas conectado, puedes trabajar en la línea de comandos con tus herramientas de línea de comandos preferidas. -After installing {% data variables.product.prodname_cli %} and authenticating with your {% data variables.product.prodname_dotcom %} account you can use the command `gh codespace [...] --help` to browse the help information. Alternatively, you can view the same reference information at [https://cli.github.com/manual/gh_codespace](https://cli.github.com/manual/gh_codespace). +Después de instalar la {% data variables.product.prodname_cli %} y autenticarte con tu cuenta de {% data variables.product.prodname_dotcom %}, puedes usar el comando `gh codespace [...] --help` para examinar la información de ayuda. Como alternativa, puedes ver la misma información de referencia en [https://cli.github.com/manual/gh_codespace](https://cli.github.com/manual/gh_codespace). -For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with GitHub CLI](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli)." +Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} con la CLI de GitHub](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli)". {% endcli %} diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace.md b/translations/es-ES/content/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace.md index 260ee1be7e..72d9961c8e 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace.md @@ -1,5 +1,5 @@ --- -title: Forwarding ports in your codespace +title: Reenviar puertos en tu codespace intro: '{% data reusables.codespaces.about-port-forwarding %}' versions: fpt: '*' @@ -12,76 +12,77 @@ topics: - Fundamentals - Developer shortTitle: Forward ports +ms.openlocfilehash: 320a2e42d647452056961d4f0f987c3c5db49476 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158913' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -## About forwarded ports +## Acerca de los puertos reenviados -Port forwarding gives you access to TCP ports running within your codespace. For example, if you're running a web application on a particular port in your codespace, you can forward that port. This allows you to access the application from the browser on your local machine for testing and debugging. +La redirección de puertos te otorga acceso a los puertos CRP dentro de tu codespace. Por ejemplo, si estás ejecutando una aplicación web en un puerto específico en tu codespace, puedes reenviar dicho puerto. Esto te permite acceder a la aplicación desde el buscador en tu máquina local para hacer pruebas y correcciones de errores. {% webui %} -{% data reusables.codespaces.port-forwarding-intro-non-jetbrains %} -{% data reusables.codespaces.navigate-to-ports-tab %} -1. Under the list of ports, click **Add port**. +{% data reusables.codespaces.port-forwarding-intro-non-jetbrains %} {% data reusables.codespaces.navigate-to-ports-tab %} +1. En la lista de puertos, haga clic en **Agregar puerto**. - ![Add port button](/assets/images/help/codespaces/add-port-button.png) + ![Botón de agregar puerto](/assets/images/help/codespaces/add-port-button.png) -1. Type the port number or address, then press enter. +1. Teclea el número de puerto o de dirección y luego presiona enter. - ![Text box to type port button](/assets/images/help/codespaces/port-number-text-box.png) + ![Botón de caja de texto para teclear el puerto](/assets/images/help/codespaces/port-number-text-box.png) -## Using HTTPS forwarding +## Utilizar el reenvío HTTPS -By default, {% data variables.product.prodname_github_codespaces %} forwards ports using HTTP but you can update any port to use HTTPS, as needed. If you update a port with public visibility to use HTTPS, the port's visibility will automatically change to private. +De manera predeterminada, {% data variables.product.prodname_github_codespaces %} reenvía los puertos mediante HTTP, pero puedes actualizar cualquier puerto para que utilice HTTPS según sea necesario. Si actualizas un puerto con visibilidad pública para usar HTTPS, la visibilidad del puerto cambiará automáticamente a privada. {% data reusables.codespaces.navigate-to-ports-tab %} -1. Right click the port you want to update, then hover over **Change Port Protocol**. - ![Option to change port protocol](/assets/images/help/codespaces/update-port-protocol.png) -1. Select the protocol needed for this port. The protocol that you select will be remembered for this port for the lifetime of the codespace. +1. Haga clic con el botón derecho en el puerto que quiera actualizar y, después, mantenga el mouse sobre **Cambiar protocolo de puerto**. + ![Opción para cambiar el protocolo del puerto](/assets/images/help/codespaces/update-port-protocol.png) +1. Selecciona el protocolo necesario para este puerto. El protocolo que selecciones se recordará para este puerto durante toda la vida útil del codespace. {% data reusables.codespaces.port-forwarding-sharing-non-jetbrains %} {% data reusables.codespaces.navigate-to-ports-tab %} -1. Right click the port that you want to share, select the "Port Visibility" menu, then click **Private to Organization** or **Public**. - ![Option to select port visibility in right-click menu](/assets/images/help/codespaces/make-public-option.png) -1. To the right of the local address for the port, click the copy icon. - ![Copy icon for port URL](/assets/images/help/codespaces/copy-icon-port-url.png) -1. Send the copied URL to the person you want to share the port with. +1. Haga clic con el botón derecho en el puerto que quiere compartir, seleccione el menú "Visibilidad del puerto" y, después, haga clic en **Privado para la organización** o **Público**. + ![Opción para seleccionar la visibilidad del puerto en el menú contextual](/assets/images/help/codespaces/make-public-option.png) +1. A la derecha de la dirección local del puerto, haz clic en el icono de copiar. + ![Icono Copiar para la URL del puerto](/assets/images/help/codespaces/copy-icon-port-url.png) +1. Envía la URL copiada a la persona con la que quieras compartir el puerto. -{% data reusables.codespaces.port-forwarding-labeling-non-jetbrains %} -{% data reusables.codespaces.port-forwarding-adding-non-jetbrains %} +{% data reusables.codespaces.port-forwarding-labeling-non-jetbrains %} {% data reusables.codespaces.port-forwarding-adding-non-jetbrains %} {% endwebui %} {% vscode %} -{% data reusables.codespaces.port-forwarding-intro-non-jetbrains %} -{% data reusables.codespaces.navigate-to-ports-tab %} -1. Under the list of ports, click **Add port**. +{% data reusables.codespaces.port-forwarding-intro-non-jetbrains %} {% data reusables.codespaces.navigate-to-ports-tab %} +1. En la lista de puertos, haga clic en **Agregar puerto**. - ![Add port button](/assets/images/help/codespaces/add-port-button.png) + ![Botón de agregar puerto](/assets/images/help/codespaces/add-port-button.png) -1. Type the port number or address, then press enter. +1. Teclea el número de puerto o de dirección y luego presiona enter. - ![Text box to type port button](/assets/images/help/codespaces/port-number-text-box.png) + ![Botón de caja de texto para teclear el puerto](/assets/images/help/codespaces/port-number-text-box.png) {% data reusables.codespaces.port-forwarding-sharing-non-jetbrains %} {% data reusables.codespaces.navigate-to-ports-tab %} -1. Right click the port that you want to share, select the "Port Visibility" menu, then click **Private to Organization** or **Public**. - ![Option to make port public in right-click menu](/assets/images/help/codespaces/make-public-option.png) -1. To the right of the local address for the port, click the copy icon. - ![Copy icon for port URL](/assets/images/help/codespaces/copy-icon-port-url.png) -1. Send the copied URL to the person you want to share the port with. +1. Haga clic con el botón derecho en el puerto que quiere compartir, seleccione el menú "Visibilidad del puerto" y, después, haga clic en **Privado para la organización** o **Público**. + ![Opción para convertir el puerto en público en el menú contextual](/assets/images/help/codespaces/make-public-option.png) +1. A la derecha de la dirección local del puerto, haz clic en el icono de copiar. + ![Icono Copiar para la URL del puerto](/assets/images/help/codespaces/copy-icon-port-url.png) +1. Envía la URL copiada a la persona con la que quieras compartir el puerto. -{% data reusables.codespaces.port-forwarding-labeling-non-jetbrains %} -{% data reusables.codespaces.port-forwarding-adding-non-jetbrains %} +{% data reusables.codespaces.port-forwarding-labeling-non-jetbrains %} {% data reusables.codespaces.port-forwarding-adding-non-jetbrains %} {% endvscode %} @@ -90,37 +91,37 @@ By default, {% data variables.product.prodname_github_codespaces %} forwards por {% data reusables.cli.cli-learn-more %} -To forward a port use the `gh codespace ports forward` subcommand. Replace `codespace-port:local-port` with the remote and local ports that you want to connect. After entering the command choose from the list of codespaces that's displayed. +Para reenviar un puerto, use el subcomando `gh codespace ports forward`. Reemplace `codespace-port:local-port` por los puertos remotos y locales que quiera conectar. Después de ingresar el comando, elige de la lista de codespaces que se muestra. ```shell gh codespace ports forward CODESPACE-PORT:LOCAL-PORT ``` -For more information about this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_ports_forward). +Para más información sobre este comando, vea [el manual de {% data variables.product.prodname_cli %}](https://cli.github.com/manual/gh_codespace_ports_forward). -To see details of forwarded ports enter `gh codespace ports` and then choose a codespace. +Para ver detalles de los puertos reenviados, escriba `gh codespace ports` y elija un codespace. {% data reusables.codespaces.port-forwarding-sharing-non-jetbrains %} -To change the visibility of a forwarded port, use the `gh codespace ports visibility` subcommand. {% data reusables.codespaces.port-visibility-settings %} +Para cambiar la visibilidad de un puerto reenviado, use el subcomando `gh codespace ports visibility`. {% data reusables.codespaces.port-visibility-settings %} -Replace `codespace-port` with the forwarded port number. Replace `setting` with `private`, `org`, or `public`. After entering the command choose from the list of codespaces that's displayed. +Reemplace `codespace-port` por el número de puerto reenviado. Reemplace `setting` por `private`, `org` o `public`. Después de ingresar el comando, elige de la lista de codespaces que se muestra. ```shell gh codespace ports visibility CODESPACE-PORT:SETTINGS ``` -You can set the visibility for multiple ports with one command. For example: +Puedes configurar la visibilidad para varios puertos con un solo comando. Por ejemplo: ```shell gh codespace ports visibility 80:private 3000:public 3306:org ``` -For more information about this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_ports_visibility). +Para más información sobre este comando, vea [el manual de {% data variables.product.prodname_cli %}](https://cli.github.com/manual/gh_codespace_ports_visibility). {% data reusables.codespaces.port-forwarding-labeling-non-jetbrains %} -You can see the port labels when you list the forwarded ports for a codespace. To do this, use the `gh codespace ports` command and then select a codespace. +Puedes ver las etiquetas de puerto al enumerar los puertos reenviados de un codespace. Para ello, usa el comando `gh codespace ports` y, después, selecciona un codespace. {% data reusables.codespaces.port-forwarding-adding-non-jetbrains %} @@ -128,10 +129,10 @@ You can see the port labels when you list the forwarded ports for a codespace. T {% jetbrains %} -## Forwarding a port +## Reenviar un puerto -For information on how to forward a port in a codespace to a port on your local machine, see the "Port forwarding" section of the "[Security model](https://www.jetbrains.com/help/idea/security-model.html#port_forwarding)" article in the JetBrains documentation. +Para obtener información sobre cómo reenviar un puerto en un codespace a un puerto en el equipo local, consulta la sección "Reenvío de puertos" del artículo "[Modelo de seguridad](https://www.jetbrains.com/help/idea/security-model.html#port_forwarding)" en la documentación de JetBrains. -Alternatively, you can use {% data variables.product.prodname_cli %} to forward a port. For more information, click the "{% data variables.product.prodname_cli %}" tab at the top of this page. +Como alternativa, puedes usar {% data variables.product.prodname_cli %} para reenviar un puerto. Para obtener más información, haz clic en la pestaña "{% data variables.product.prodname_cli %}" que se encuentra cerca de la parte superior de esta página. {% endjetbrains %} diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning.md b/translations/es-ES/content/codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning.md new file mode 100644 index 0000000000..5f9e5fb422 --- /dev/null +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning.md @@ -0,0 +1,108 @@ +--- +title: Introducción a codespaces de GitHub para el aprendizaje automático +shortTitle: Machine learning +intro: 'Obtén información sobre cómo trabajar en proyectos de aprendizaje automático con {% data variables.product.prodname_github_codespaces %} y sus herramientas de fábrica.' +versions: + fpt: '*' + ghec: '*' +type: tutorial +topics: + - Codespaces + - Developer +ms.openlocfilehash: 905d5b14bfba5e47d1fdfdd7f0be75b16750652d +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158921' +--- +## Introducción + +En esta guía se presenta el aprendizaje automático con {% data variables.product.prodname_github_codespaces %}. Crearás un clasificador de imágenes simple, obtendrás información sobre algunas de las herramientas que vienen preinstaladas en {% data variables.product.prodname_github_codespaces %}, configurarás el entorno de desarrollo para NVIDIA CUDA y abrirás el codespace en JupyterLab. + +## Creación de un clasificador de imágenes simple + +Usaremos un cuaderno de Jupyter Notebook para crear un clasificador de imágenes simple. + +Los cuadernos de Jupyter son conjuntos de celdas que se pueden ejecutar una después de otra. El cuaderno que usaremos incluye una serie de celdas que crean un clasificador de imágenes mediante [PyTorch](https://pytorch.org/). Cada celda es una fase diferente de ese proceso: descarga un conjunto de datos, configura una red neuronal, entrena un modelo y, a continuación, prueba ese modelo. + +Ejecutaremos todas las celdas, en secuencia, para realizar todas las fases de creación del clasificador de imágenes. Cuando hacemos esto, Jupyter vuelve a guardar la salida en el cuaderno para que pueda examinar los resultados. + +### Crear un codespace + +1. Vaya al repositorio de plantillas [github/codespaces-jupyter](https://github.com/github/codespaces-jupyter). +{% data reusables.codespaces.open-template-in-codespace-step %} + +Se abre un codespace para esta plantilla en una versión basada en web de {% data variables.product.prodname_vscode %}. + +### Apertura del cuaderno clasificador de imágenes + +La imagen de contenedor predeterminada que usan los datos {% data variables.product.prodname_github_codespaces %} incluye un conjunto de bibliotecas de aprendizaje automático preinstaladas en el codespace. Por ejemplo, Numpy, Pandas, SciPy, Matplotlib, seaborn, scikit-learn, Keras, PyTorch, Requests y Plotly. Para obtener más información sobre la imagen predeterminada, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#using-the-default-dev-container-configuration)" y [el `devcontainers/images` repositorio](https://github.com/devcontainers/images/tree/main/src/universal). + +1. En el editor de {% data variables.product.prodname_vscode_shortname %}, cierra las pestañas "Introducción" que se muestran. +1. Apertura del archivo del cuaderno `notebooks/image-classifier.ipynb`. + +### Creación de un clasificador de imágenes + +El cuaderno clasificador de imágenes contiene todo el código que necesitas para descargar un conjunto de datos, entrenar una red neuronal y evaluar su rendimiento. + +1. Haz clic en **Ejecutar todo** para ejecutar todas las celdas del cuaderno. + + ![Captura de pantalla del botón Ejecutar todo](/assets/images/help/codespaces/jupyter-run-all.png) + +1. Desplázate hacia abajo para ver la salida de cada celda. + + ![Captura de pantalla del paso 3 en el editor](/assets/images/help/codespaces/jupyter-notebook-step3.png) + +## Configuración de NVIDIA CUDA para el codespace + +Algunos software requieren que instales NVIDIA CUDA para usar la GPU del codespace. En este caso, puedes crear tu propia configuración personalizada, mediante un archivo `devcontainer.json` y especificar que CUDA debe instalarse. Para obtener más información sobre las configuraciones personalizadas, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#creating-a-custom-dev-container-configuration)". + +{% note %} + +**Nota**: Para obtener detalles completos del script que se ejecuta al agregar la característica `nvidia-cuda`, consulta [el repositorio de características/contenedores de desarrollo](https://github.com/devcontainers/features/tree/main/src/nvidia-cuda). + +{% endnote %} + +1. En un codespace, abre el archivo `.devcontainer/devcontainer.json` en el editor. +1. Agrega un objeto de nivel `features` superior con el siguiente contenido: + + ```json{:copy} + "features": { + "ghcr.io/devcontainers/features/nvidia-cuda:1": { + "installCudnn": true + } + } + ``` + + Para obtener más información sobre el objeto `features`, consulta [Especificación de contenedores de desarrollo](https://containers.dev/implementors/features/#devcontainer-json-properties). + + Si usas el archivo `devcontainer.json` del repositorio clasificador de imágenes que creaste para este tutorial, el archivo `devcontainer.json` tendrá el siguiente aspecto: + + ```json + { + "customizations": { + "vscode": { + "extensions": [ + "ms-python.python", + "ms-toolsai.jupyter" + ] + } + }, + "features": { + "ghcr.io/devcontainers/features/nvidia-cuda:1": { + "installCudnn": true + } + } + } + ``` + +1. Guarde el cambio. +{% data reusables.codespaces.rebuild-command %} Se volverá a generar el contenedor de codespace. Esto tardará varios minutos. Cuando se completa la recompilación, el codespace se vuelve a abrir automáticamente. +1. Publica el cambio en un repositorio para que CUDA se instale en los nuevos codespaces que crees a partir de este repositorio en el futuro. Para obtener más información, consulta "[Creación de un codespace a partir de una plantilla](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-from-vs-code)". + +## Apertura de un codespace en JupyterLab + +Puedes abrir el codespace en JupyterLab desde la página "Tus codespaces" en [github.com/codespaces](https://github.com/codespaces) o mediante {% data variables.product.prodname_cli %}. Para obtener más información, consulta "[Apertura de un codespece existente](/codespaces/developing-in-codespaces/opening-an-existing-codespace)". + +{% data reusables.codespaces.jupyterlab-installed-in-codespace %} diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md b/translations/es-ES/content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md index cc463fbc81..0f9f630eef 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md @@ -1,6 +1,6 @@ --- -title: Opening an existing codespace -intro: 'You can reopen a codespace that you have closed or stopped and return to your work.' +title: Apertura de un codespace existente +intro: Puedes volver a abrir un codespace que hayas cerrado o detenido y volver al trabajo. versions: fpt: '*' ghec: '*' @@ -10,46 +10,51 @@ topics: - Fundamentals - Developer shortTitle: Open an existing codespace +ms.openlocfilehash: e7a35c1a7b3a251094bf69fcd401291b69d03eae +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159009' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -You can reopen any of your active or stopped codespaces on {% data variables.product.prodname_dotcom_the_website %}, in a JetBrains IDE, in {% data variables.product.prodname_vscode %}, or by using {% data variables.product.prodname_cli %}. You can't reopen a codespace that has been deleted. For more information, see "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)." +Puedes volver a abrir cualquiera de los codespaces activos o detenidos en {% data variables.product.prodname_dotcom_the_website %}, en un IDE de JetBrains, en {% data variables.product.prodname_vscode %} o mediante la {% data variables.product.prodname_cli %}. No se puede volver a abrir un codespace que se haya eliminado. Para obtener más información, consulta "[Ciclo de vida de un codespace](/codespaces/developing-in-codespaces/the-codespace-lifecycle)". -You can view all your codespaces on the "Your codespaces" page at [github.com/codespaces](https://github.com/codespaces). From this page, you can: +Puedes ver todos tus codespaces en la página "Tus codespaces" en [github.com/codespaces](https://github.com/codespaces). En esta página puede realizar las siguientes acciones: -- Open, stop, or delete your codespaces. -- See who owns (and may be billed for) your codespaces: your personal account, or organizations you belong to. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." -- Create a new codespace, either by choosing one of {% data variables.product.company_short %}'s templates or by clicking **New codespace**. For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)" and "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)." +- Abrir, detener o eliminar los codespaces. +- Ver quién posee (y a quién es posible que se le facturen) los codespaces: tu cuenta personal o las organizaciones a las que perteneces. Para más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". +- Crear un nuevo codespace, ya sea con una de las plantillas de {% data variables.product.company_short %} o haciendo clic en **Nuevo codespace**. Para obtener más información, consulta "[Creación de un codespace a partir de una plantilla](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)" o "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)". -## Opening an existing codespace +## Apertura de un codespace existente {% webui %} {% data reusables.codespaces.your-codespaces-procedure-step %} -1. To open a codespace in your default editor, click the name of the codespace. {% data reusables.codespaces.about-changing-default-editor %} For more information, see "[Setting your default editor for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)." +1. Para abrir un codespace en el editor predeterminado, haz clic en su nombre. {% data reusables.codespaces.about-changing-default-editor %} Para obtener más información, consulta "[Configuración del editor predeterminado para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)". - To open the codespace in an editor other than your default: + Para abrir el codespace en un editor distinto del predeterminado: - 1. Click the ellipsis (**...**) to the right of the codespace you want to open. - 1. Click **Open in**. - 1. Click **Open in APPLICATION**. + 1. Haz clic en los puntos suspensivos ( **…** ) situados a la derecha del codespace que quieres abrir. + 1. Haz clic en **Abrir en**. + 1. Haz clic en **Abrir en la APLICACIÓN**. - ![Screenshot of the "Open in" dialog box, with "Open in Visual Studio Code" highlighted](/assets/images/help/codespaces/open-codespace-in-another-editor.png) + ![Captura de pantalla del cuadro de diálogo "Abrir en" , con la opción "Abrir en Visual Studio Code" resaltada](/assets/images/help/codespaces/open-codespace-in-another-editor.png) - You can open the codespace in: - * Your browser + Puedes abrir el codespace en: + * El explorador * {% data variables.product.prodname_vscode %} - * JetBrains Gateway + * La puerta de enlace de JetBrains * JupyterLab {% data reusables.codespaces.application-installed-locally %} - If you choose **JupyterLab**, the JupyterLab application must be installed in the codespace. {% data reusables.codespaces.jupyterlab-in-default-image %} + Si eliges **JupyterLab**, la aplicación JupyterLab debe estar instalada en el codespace. {% data reusables.codespaces.jupyterlab-in-default-image %} {% endwebui %} @@ -57,29 +62,28 @@ You can view all your codespaces on the "Your codespaces" page at [github.com/co {% note %} -**Note:** {% data reusables.codespaces.using-codespaces-in-vscode %} For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)." +**Nota**: {% data reusables.codespaces.using-codespaces-in-vscode %} Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} en {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)." {% endnote %} -1. In the {% data variables.product.prodname_vscode_shortname %} desktop application, open the Command Palette with Command+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux). -1. Type "Codespaces" and select one of the following commands. - - To open a codespace in a new window of {% data variables.product.prodname_vscode_shortname %}, select **Codespaces: Open Codespace in New Window** - - To open a codespace in the web editor, select **Codespaces: Open in Browser** -1. Click the codespace that you want to open. +1. En la aplicación de escritorio {% data variables.product.prodname_vscode_shortname %}, abre la paleta de comandos con Comando+Mayús+P (Mac) o Ctrl+Mayús+P (Windows/Linux). +1. Escribe "Codespaces" y selecciona uno de los comandos siguientes. + - Para abrir un codespace en una ventana nueva de {% data variables.product.prodname_vscode_shortname %}, selecciona **Codespaces: Abrir codespace en nueva ventana**. + - Para abrir un codespace en el editor web, selecciona **Codespaces: Abrir en el explorador**. +1. Haz clic en el codespace que quieras abrir. - ![Screenshot of a list of codespaces in Visual Studio Code](/assets/images/help/codespaces/open-codespace-from-vscode.png) + ![Captura de pantalla de una lista de codespaces en Visual Studio Code](/assets/images/help/codespaces/open-codespace-from-vscode.png) -You can also access the commands listed above by navigating to the Remote Explorer view in {% data variables.product.prodname_vscode_shortname %} and right-clicking the codespace that you want to open. +También puedes acceder a los comandos enumerados anteriormente; para ello, ves a la vista Explorador remoto en {% data variables.product.prodname_vscode_shortname %} y haz clic con el botón derecho en el codespace que quieras abrir. -![Screenshot of a codespace selected in the Remote Explorer, with "Open in Browser" highlighted](/assets/images/help/codespaces/open-codespace-remote-explorer.png) +![Captura de pantalla de un codespace seleccionado en el Explorador remoto, con la opción "Abrir en el explorador" resaltada](/assets/images/help/codespaces/open-codespace-remote-explorer.png) -{% data reusables.codespaces.remote-explorer %} -{% endvscode %} +{% data reusables.codespaces.remote-explorer %} {% endvscode %} {% cli %} -1. In a terminal, enter one of the following {% data variables.product.prodname_cli %} commands. - - To open a codespace in {% data variables.product.prodname_vscode_shortname %}, enter: +1. En un terminal, escribe uno de los comandos de la {% data variables.product.prodname_cli %} siguientes. + - Para abrir un codespace en {% data variables.product.prodname_vscode_shortname %}, escribe lo siguiente: ```shell{:copy} gh codespace code @@ -87,17 +91,17 @@ You can also access the commands listed above by navigating to the Remote Explor {% note %} - **Note**: You must have {% data variables.product.prodname_vscode_shortname %} installed on your local machine. For more information, see "[Setting up Visual Studio Code](https://code.visualstudio.com/docs/setup/setup-overview)" in the {% data variables.product.prodname_vscode_shortname %} documentation. + **Nota**: Debes tener {% data variables.product.prodname_vscode_shortname %} instalado en la máquina local. Para obtener más información, consulta "[Configuración de Visual Studio Code](https://code.visualstudio.com/docs/setup/setup-overview)" en la documentación de {% data variables.product.prodname_vscode_shortname %}. {% endnote %} - - To open a codespace in the browser, enter: + - Para abrir un codespace en el explorador, escribe lo siguiente: ```shell{:copy} gh codespace code --web ``` - - To open a codespace in JupyterLab, enter: + - Para abrir un codespace en JupyterLab, escribe lo siguiente: ```shell{:copy} gh codespace code --jupyter @@ -105,14 +109,14 @@ You can also access the commands listed above by navigating to the Remote Explor {% note %} - **Note**: {% data reusables.codespaces.jupyterlab-installed-in-codespace %} + **Nota**: {% data reusables.codespaces.jupyterlab-installed-in-codespace %} {% endnote %} -1. Using the arrow keys, navigate to the codespace that you want to open. -1. To open the codespace, press Enter. +1. Con las teclas de dirección, ves al codespace que quieres abrir. +1. Para abrir el codespace, presiona Entrar. -For more information, see [`gh codespace code`](https://cli.github.com/manual/gh_codespace_code) in the {% data variables.product.prodname_cli %} manual. +Para obtener más información, consulta [`gh codespace code`](https://cli.github.com/manual/gh_codespace_code) en el manual de la {% data variables.product.prodname_cli %}. {% endcli %} @@ -120,4 +124,4 @@ For more information, see [`gh codespace code`](https://cli.github.com/manual/gh {% data reusables.codespaces.opening-codespace-in-jetbrains %} -{% endjetbrains %} \ No newline at end of file +{% endjetbrains %} diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md b/translations/es-ES/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md index 879021588c..dea650cffc 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md @@ -1,6 +1,6 @@ --- -title: Stopping and starting a codespace -intro: 'You can stop and start your codespace to save resources and to pause work.' +title: Detención e inicio de un codespace +intro: Puedes detener e iniciar el codespace para guardar recursos y pausar el trabajo. versions: fpt: '*' ghec: '*' @@ -10,28 +10,33 @@ topics: - Fundamentals - Developer shortTitle: Stop a codespace +ms.openlocfilehash: 290a39d9d60420230bd9b11d5e2d10119ccc1c72 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158809' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -## About stopping and starting a codespace +## Acerca de la detención y el inicio de un codespace {% data reusables.codespaces.stopping-a-codespace %} -Regardless of where you created or access your codespaces, you can view and manage them in your browser at https://github.com/codespaces. +Independientemente de dónde hayas creado los codespaces o accedido a estos, puedes verlos y administrarlos en el explorador en https://github.com/codespaces. -## Stopping a codespace +## Detener un codespace {% webui %} {% data reusables.codespaces.navigate-to-codespaces-page %} - 1. To the right of the codespace you want to stop, click the elipsis (**...**). - 1. Click **Stop codespace**. - ![Screenshot of option to stop a codespace](/assets/images/help/codespaces/stop-codespace-webui.png) + 1. Haz clic en los puntos suspensivos ( **…** ) situados a la derecha del codespace que quieras detener. + 1. Haz clic en **Detener codespace**. + ![Captura de pantalla de la opción para detener un codespace](/assets/images/help/codespaces/stop-codespace-webui.png) {% endwebui %} @@ -39,7 +44,7 @@ Regardless of where you created or access your codespaces, you can view and mana {% data reusables.cli.cli-learn-more %} - To stop a codespace use the `gh codespace stop` subcommand and then choose the codespace you want to stop from the list that's displayed. + Para detener un codespace, usa el subcomando `gh codespace stop` y, después, elige el codespace que quieras detener de la lista que se muestra. ```shell{:copy} gh codespace stop @@ -50,41 +55,41 @@ Regardless of where you created or access your codespaces, you can view and mana {% vscode %} {% data reusables.vs-code.open-command-palette %} -1. Type `stop` and select **Codespaces: Stop Codespace** from the list of options. -1. In the list of codespaces, select the codespace you want to stop. +1. Escribe `stop` y selecciona **Codespaces: Detención de un codespace** en la lista de opciones. +1. En la lista de codespaces, selecciona el que quieras detener. {% endvscode %} {% jetbrains %} {% data reusables.codespaces.jetbrains-open-codespace-plugin %} -1. In the {% data variables.product.prodname_github_codespaces %} tool window, click the stop icon. +1. En la ventana de herramientas de {% data variables.product.prodname_github_codespaces %}, haz clic en el icono Detener. - ![Screenshot of the log button](/assets/images/help/codespaces/jetbrains-plugin-icon-stop.png) + ![Captura de pantalla del botón Registro](/assets/images/help/codespaces/jetbrains-plugin-icon-stop.png) {% endjetbrains %} -## Restarting a codespace +## Reinicio de un codespace {% webui %} {% data reusables.codespaces.navigate-to-codespaces-page %} -1. Click the name of the codespace you want to restart. -![Screenshot of stopped codespaces](/assets/images/help/codespaces/restart-codespace-webui.png) +1. Haz clic en el nombre del codespace que quieras reiniciar. +![Captura de pantalla de los codespaces detenidos](/assets/images/help/codespaces/restart-codespace-webui.png) {% endwebui %} {% cli %} -When you restart a codespace you can choose to open it in {% data variables.product.prodname_vscode %} or in your browser. +Al reiniciar un codespace, puedes elegir abrirlo en {% data variables.product.prodname_vscode %} o en el explorador. - - To restart a codespace and open it in {% data variables.product.prodname_vscode %}, use the `gh codespace code` subcommand and then choose the codespace you want to restart from the list that's displayed. + - Para reiniciar un codespace y abrirlo en {% data variables.product.prodname_vscode %}, usa el subcomando `gh codespace code` y, después, elige el codespace que quieras reiniciar en la lista que se muestra. ```shell{:copy} gh codespace code ``` - - To restart a codespace and open it in your browser, use the `gh codespace open --web` subcommand and then choose the codespace you want to restart from the list that's displayed. + - Para reiniciar un codespace y abrirlo en el explorador, usa el subcomando `gh codespace open --web` y, después, elige el codespace que quieras reiniciar en la lista que se muestra. ```shell{:copy} gh codespace open --web @@ -95,8 +100,8 @@ When you restart a codespace you can choose to open it in {% data variables.prod {% vscode %} {% data reusables.vs-code.open-command-palette %} -1. Type `connect` and select **Codespaces: Connect to Codespace** from the list of options. -1. In the list of codespaces, select the codespace you want to restart. +1. Escribe `connect` y selecciona **Codespaces: Conexión a un codespace** en la lista de opciones. +1. En la lista de codespaces, selecciona el que quieras reiniciar. {% endvscode %} @@ -106,6 +111,6 @@ When you restart a codespace you can choose to open it in {% data variables.prod {% endjetbrains %} -## Further reading +## Información adicional -- "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" +- "[Ciclo de vida de un codespace](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md b/translations/es-ES/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md new file mode 100644 index 0000000000..1d1af74da9 --- /dev/null +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md @@ -0,0 +1,67 @@ +--- +title: The codespace lifecycle +intro: 'You can develop in a {% data variables.product.prodname_github_codespaces %} environment and maintain your data throughout the entire codespace lifecycle.' +versions: + fpt: '*' + ghec: '*' +type: overview +topics: + - Codespaces + - Developer +redirect_from: + - /codespaces/developing-in-codespaces/codespaces-lifecycle +--- + +## About the lifecycle of a codespace + +The lifecycle of a codespace begins when you create a codespace and ends when you delete it. You can disconnect and reconnect to an active codespace without affecting its running processes. You may stop and restart a codespace without losing changes that you have made to your project. + +## Creating a codespace + +When you want to work on a project, you can choose to create a new codespace or open an existing codespace. You might want to create a new codespace from a branch of your repository each time you develop in {% data variables.product.prodname_github_codespaces %} or keep a long-running codespace for a feature. {% data reusables.codespaces.starting-new-project-template %} For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)" and "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)." + +{% data reusables.codespaces.max-number-codespaces %} Similarly, if you reach the maximum number of active codespaces and you try to start another, you are prompted to stop one of your active codespaces. + +If you choose to create a new codespace each time you work on a project, you should regularly push your changes so that any new commits are on {% data variables.product.prodname_dotcom %}. If you choose to use a long-running codespace for your project, you should pull from your repository's default branch each time you start working in your codespace so that your environment has the latest commits. This workflow is very similar to if you were working with a project on your local machine. + +{% data reusables.codespaces.prebuilds-crossreference %} + +## Saving changes in a codespace + +When you connect to a codespace through the web, auto-save is enabled automatically for the web editor and configured to save changes after a delay. When you connect to a codespace through {% data variables.product.prodname_vscode %} running on your desktop, you must enable auto-save. For more information, see [Save/Auto Save](https://code.visualstudio.com/docs/editor/codebasics#_save-auto-save) in the {% data variables.product.prodname_vscode %} documentation. + +Your work will be saved on a virtual machine in the cloud. You can close and stop a codespace and return to the saved work later. If you have unsaved changes, your editor will prompt you to save them before exiting. However, if your codespace is deleted, then your work will be deleted too. To persist your work, you will need to commit your changes and push them to your remote repository, or publish your work to a new remote repository if you created your codespace from a template. For more information, see "[Using source control in your codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)." + +## Timeouts for {% data variables.product.prodname_github_codespaces %} + +If you leave your codespace running without interaction, or if you exit your codespace without explicitly stopping it, the codespace will timeout after a period of inactivity and stop running. By default, a codespace will timeout after 30 minutes of inactivity, but you can customize the duration of the timeout period for new codespaces that you create. For more information about setting the default timeout period for your codespaces, see "[Setting your timeout period for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)." For more information about stopping a codespace, see "[Stopping a codespace](#stopping-a-codespace)." + +When a codespace times out, your data is preserved from the last time your changes were saved. For more information, see "[Saving changes in a codespace](#saving-changes-in-a-codespace)." + +## Rebuilding a codespace + +You can rebuild your codespace to implement changes to your dev container configuration. For most uses, you can create a new codespace as an alternative to rebuilding a codespace. By default, when you rebuild your codespace, {% data variables.product.prodname_github_codespaces %} will reuse images from your cache to speed up the rebuild process. Alternatively, you can perform a full rebuild, which clears your cache and rebuilds the container with fresh images. + +For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)" and "[Performing a full rebuild of a container](/codespaces/codespaces-reference/performing-a-full-rebuild-of-a-container)." + +## Stopping a codespace + +{% data reusables.codespaces.stopping-a-codespace %} For more information, see "[Stopping and starting a codespace](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)." + +## Deleting a codespace + +You can create a codespace for a particular task and then safely delete the codespace after you push your changes to a remote branch. + +If you try to delete a codespace with unpushed git commits, your editor will notify you that you have changes that have not been pushed to a remote branch. You can push any desired changes and then delete your codespace, or continue to delete your codespace and any uncommitted changes. You can also export your code to a new branch without creating a new codespace. For more information, see "[Exporting changes to a branch](/codespaces/troubleshooting/exporting-changes-to-a-branch)." + +Codespaces that have been stopped and remain inactive for a specified period of time will be deleted automatically. By default, inactive codespaces are deleted after 30 days, but you can customize your codespace retention period. For more information, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)." + +If you create a codespace, it will continue to accrue storage charges until it is deleted, irrespective of whether it is active or stopped. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-storage-usage)." Deleting a codespace does not reduce the current billable amount for {% data variables.product.prodname_github_codespaces %}, which accumulates during each monthly billing cycle. For more information, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." + +For more information on deleting a codespace, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)." + +## Losing the connection while using {% data variables.product.prodname_github_codespaces %} + +{% data variables.product.prodname_github_codespaces %} is a cloud-based development environment and requires an internet connection. If you lose connection to the internet while working in a codespace, you will not be able to access your codespace. However, any uncommitted changes will be saved. When you have access to an internet connection again, you can connect to your codespace in the exact same state that it was left in. If you have an unstable internet connection, you should commit and push your changes often. + +If you know that you will often be working offline, you can use your `devcontainer.json` file with the ["Dev Containers" extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) for {% data variables.product.prodname_vscode_shortname %} to build and attach to a local development container for your repository. For more information, see [Developing inside a container](https://code.visualstudio.com/docs/remote/containers) in the {% data variables.product.prodname_vscode %} documentation. diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md b/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md index 74635bca2b..781d52f54d 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md @@ -1,7 +1,7 @@ --- -title: Using GitHub Codespaces in Visual Studio Code +title: "Uso de GitHub Codespaces en Visual\_Studio Code" shortTitle: Visual Studio Code -intro: 'You can develop in your codespace directly in {% data variables.product.prodname_vscode %} by connecting the {% data variables.product.prodname_github_codespaces %} extension with your account on {% data variables.product.product_name %}.' +intro: 'Puedes realizar tareas de desarrollo en tu codespace directamente en {% data variables.product.prodname_vscode %} conectando la extensión {% data variables.product.prodname_github_codespaces %} con tu cuenta de {% data variables.product.product_name %}.' redirect_from: - /github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code - /github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code @@ -15,70 +15,75 @@ topics: - Codespaces - Visual Studio Code - Developer +ms.openlocfilehash: c651620e2795fb29f2b995f745ad3880e99c0f4e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159923' --- - -## About {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %} +## Acerca de {% data variables.product.prodname_github_codespaces %} en {% data variables.product.prodname_vscode %} -You can use your local install of {% data variables.product.prodname_vscode %} to create, manage, work in, and delete codespaces. {% data reusables.codespaces.using-codespaces-in-vscode %} For more information on setting up {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode_shortname %}, see "[Prerequisites](#prerequisites)." +Puedes utilizar tu instalación local de {% data variables.product.prodname_vscode %} para crear, administrar, trabajar en y borrar codespaces. {% data reusables.codespaces.using-codespaces-in-vscode %} Para obtener más información sobre la configuración de {% data variables.product.prodname_github_codespaces %} en {% data variables.product.prodname_vscode_shortname %}, consulta "[Requisitos previos](#prerequisites)". -By default, if you create a new codespace on {% data variables.product.prodname_dotcom_the_website %}, it will open in the browser. If you would prefer to open any new codespaces in {% data variables.product.prodname_vscode_shortname %} automatically, you can set your default editor to be {% data variables.product.prodname_vscode_shortname %}. For more information, see "[Setting your default editor for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)." +Predeterminadamente, si creas un codespace nuevo en {% data variables.product.prodname_dotcom_the_website %}, este se abrirá en el buscador. Si prefieres que cualquier codespace nuevo se abra en {% data variables.product.prodname_vscode_shortname %} automáticamente, puedes configurar que {% data variables.product.prodname_vscode_shortname %} sea tu editor predeterminado. Para más información, consulta "[Configuración del editor predeterminado para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)". -If you prefer to work in the browser, but want to continue using your existing {% data variables.product.prodname_vscode_shortname %} extensions, themes, and shortcuts, you can turn on 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#settings-sync)." +Si prefieres trabajar en el explorador, pero quieres seguir usando las extensiones, los temas y los accesos directos existentes de {% data variables.product.prodname_vscode_shortname %}, puedes activar la sincronización de la configuración. Para más información, consulta "[Personalización de {% data variables.product.prodname_github_codespaces %} para la cuenta](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#settings-sync)". -## Prerequisites +## Requisitos previos -To develop in a codespace directly in {% data variables.product.prodname_vscode_shortname %}, you must install and sign into the {% data variables.product.prodname_github_codespaces %} extension with your {% data variables.product.product_name %} credentials. The {% data variables.product.prodname_github_codespaces %} extension requires {% data variables.product.prodname_vscode_shortname %} October 2020 Release 1.51 or later. +Para hacer desarrollos en un codespace directamente desde {% data variables.product.prodname_vscode_shortname %}, debes instalar e iniciar sesión en la extensión de {% data variables.product.prodname_github_codespaces %} con tus credenciales de {% data variables.product.product_name %}. La extensión de {% data variables.product.prodname_github_codespaces %} requiere el lanzamiento 1.51 de octubre de 2020 de {% data variables.product.prodname_vscode_shortname %} o superior. -Use the {% data variables.product.prodname_vscode_marketplace %} to install the [{% data variables.product.prodname_github_codespaces %}](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces) extension. For more information, see [Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery) in the {% data variables.product.prodname_vscode_shortname %} documentation. +Usa{% data variables.product.prodname_vscode_marketplace %} para instalar la extensión [{% data variables.product.prodname_github_codespaces %}](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). Para obtener más información, consulta [Marketplace de extensiones](https://code.visualstudio.com/docs/editor/extension-gallery) en la documentación de {% data variables.product.prodname_vscode_shortname %}. {% mac %} {% data reusables.codespaces.click-remote-explorer-icon-vscode %} -1. Click **Sign in to {% data variables.product.prodname_dotcom %}...**. +1. Haz clic en **Iniciar sesión en {% data variables.product.prodname_dotcom %}...** . - ![Signing in to {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode-mac.png) + ![Inicio de sesión en {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode-mac.png) -2. To authorize {% data variables.product.prodname_vscode_shortname %} to access your account on {% data variables.product.product_name %}, click **Allow**. -3. Sign in to {% data variables.product.product_name %} to approve the extension. +2. A fin de autorizar a {% data variables.product.prodname_vscode_shortname %} para acceder a la cuenta en {% data variables.product.product_name %}, haz clic en **Permitir**. +3. Regístrate en {% data variables.product.product_name %} para aprobar la extensión. {% endmac %} {% windows %} {% data reusables.codespaces.click-remote-explorer-icon-vscode %} -1. Use the "REMOTE EXPLORER" drop-down, then click **{% data variables.product.prodname_github_codespaces %}**. +1. Use el menú desplegable "EXPLORADOR REMOTO" y, después, haga clic en **{% data variables.product.prodname_github_codespaces %}** . - ![The {% data variables.product.prodname_github_codespaces %} header](/assets/images/help/codespaces/codespaces-header-vscode.png) + ![El encabezado de {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/codespaces-header-vscode.png) -1. Click **Sign in to view {% data variables.product.prodname_codespaces %}**. +1. Haz clic en **Iniciar sesión para ver {% data variables.product.prodname_codespaces %}** . - ![Signing in to view {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) + ![Registrarse para ver {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) -1. To authorize {% data variables.product.prodname_vscode_shortname %} to access your account on {% data variables.product.product_name %}, click **Allow**. -1. Sign in to {% data variables.product.product_name %} to approve the extension. +1. A fin de autorizar a {% data variables.product.prodname_vscode_shortname %} para acceder a la cuenta en {% data variables.product.product_name %}, haz clic en **Permitir**. +1. Regístrate en {% data variables.product.product_name %} para aprobar la extensión. {% endwindows %} -## Creating a codespace in {% data variables.product.prodname_vscode_shortname %} +## Creación de un codespace en {% data variables.product.prodname_vscode_shortname %} {% data reusables.codespaces.creating-a-codespace-in-vscode %} -## Opening a codespace in {% data variables.product.prodname_vscode_shortname %} +## Apertura de un codespace en {% data variables.product.prodname_vscode_shortname %} {% data reusables.codespaces.click-remote-explorer-icon-vscode %} -1. Under "Codespaces", click the codespace you want to develop in. -1. Click the Connect to Codespace icon. +1. Debajo de "Codespaces", da clic en el codespace en el que quieras desarrollar. +1. Da clic en en el icono de conexión al codespace. - ![The Connect to Codespace icon in {% data variables.product.prodname_vscode_shortname %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) + ![Icono de conectarse al codespace en {% data variables.product.prodname_vscode_shortname %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) -## Changing the machine type in {% data variables.product.prodname_vscode_shortname %} +## Cambio del tipo de máquina en {% data variables.product.prodname_vscode_shortname %} -{% data reusables.codespaces.codespaces-machine-types %} You can change the machine type of your codespace at any time. +{% data reusables.codespaces.codespaces-machine-types %} Puedes cambiar el tipo de máquina del codespace en cualquier momento. {% note %} -**Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} +**Nota**: {% data reusables.codespaces.codespaces-machine-type-availability %} {% endnote %} @@ -86,22 +91,22 @@ Use the {% data variables.product.prodname_vscode_marketplace %} to install the {% data reusables.codespaces.about-changing-storage-size %} -## Deleting a codespace in {% data variables.product.prodname_vscode_shortname %} +## Eliminación de un codespace en {% data variables.product.prodname_vscode_shortname %} {% data reusables.codespaces.deleting-a-codespace-in-vscode %} -## Switching to the Insiders build of {% data variables.product.prodname_vscode_shortname %} +## Cambio a la compilación para usuarios expertos de {% data variables.product.prodname_vscode_shortname %} -You can use the [Insiders Build of {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/setup/setup-overview#_insiders-nightly-build) within {% data variables.product.prodname_github_codespaces %}. +Puedes usar la [versión para expertos de {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/setup/setup-overview#_insiders-nightly-build) en {% data variables.product.prodname_github_codespaces %}. -1. In bottom left of your {% data variables.product.prodname_github_codespaces %} window, select **{% octicon "gear" aria-label="The settings icon" %} Settings**. -2. From the list, select "Switch to Insiders Version". +1. En la esquina inferior izquierda de la ventana {% data variables.product.prodname_github_codespaces %}, selecciona Configuración de **{% octicon "gear" aria-label="The settings icon" %}** . +2. Desde la lista, selecciona "Cambiar a la versión para expertos". - ![Clicking on "Insiders Build" in {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/codespaces-insiders-vscode.png) + ![Clic en "Versión para expertos" en {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/codespaces-insiders-vscode.png) -3. Once selected, {% data variables.product.prodname_github_codespaces %} will continue to open in Insiders Version. +3. Una vez seleccionado, {% data variables.product.prodname_github_codespaces %} seguirá abriéndose en la Versión para Expertos. -## Further reading +## Información adicional -- "[Using the {% data variables.product.prodname_vscode_command_palette %} in {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces)" -- "[Using {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces)" \ No newline at end of file +- "[Uso de {% data variables.product.prodname_vscode_command_palette %} en {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces)" +- "[Uso de {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces)" diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide.md b/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide.md new file mode 100644 index 0000000000..0560be062f --- /dev/null +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide.md @@ -0,0 +1,138 @@ +--- +title: Uso de GitHub Codespaces en el IDE de JetBrains +shortTitle: JetBrains IDEs +intro: Puedes usar la puerta de enlace de JetBrains para conectarte al codespace y trabajar en tu IDE de JetBrains favorito. +miniTocMaxHeadingLevel: 3 +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Developer +ms.openlocfilehash: f522bf481e932f9735560ee4a1fec21944ced2e7 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160323' +--- +{% data reusables.codespaces.codespaces-jetbrains-beta-note %} + +## Acerca del {% data variables.product.prodname_codespaces %} en IDE de JetBrains + +Si usas un IDE de JetBrains para trabajar en el código, puedes aprovechar las ventajas de trabajar en un codespace. Para ello, usa la aplicación de puerta de enlace de JetBrains. + +Después de instalar la puerta de enlace de JetBrains, puedes establecer JetBrains como editor predeterminado y, después, siempre que abras un codespace desde {% data variables.product.prodname_dotcom_the_website %} se iniciará la puerta de enlace de JetBrains para permitirte elegir el IDE de JetBrains y conectarse al codespace. + +{% note %} + +**Nota**: Solo los codespaces existentes están disponibles en la puerta de enlace de JetBrains. Puedes crear codespaces en {% data variables.product.prodname_dotcom_the_website %} o utilizando la {% data variables.product.prodname_cli %}. Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)". + +{% endnote %} + +### Proceso de conexión de desarrollo remoto de JetBrains + +El proceso básico que hay detrás del uso de un codespace en el IDE de JetBrains es el siguiente. + +* En la aplicación de puerta de enlace de JetBrains, selecciona uno de los codespaces activos o detenidos. +* Después, elige el IDE de JetBrains que quieras usar. +* Luego, el IDE de JetBrains seleccionado se descarga en la máquina virtual remota que hospeda el codespace y el código fuente. +* La aplicación cliente ligera de JetBrains se descarga en el equipo local y se inicia. +* La aplicación cliente se conecta al IDE de back-end completo. +* Puedes trabajar en el código de la aplicación cliente de la misma manera que lo harías en un entorno local. + +## Requisitos previos + +Para trabajar en un codespace en un IDE de JetBrains, necesitas lo siguiente: + +* Una licencia válida de JetBrains +* La aplicación de puerta de enlace de JetBrains +* {% data variables.product.prodname_cli %}, versión 2.18.0 o posterior +* Un codespace existente que ejecute un servidor SSH + +### Licencia de JetBrains + +Debes tener una licencia para al menos uno de los IDE de JetBrains admitidos a fin de conectarse a un codespace desde la puerta de enlace de JetBrains. + +### Puerta de enlace de JetBrains + +Puedes instalar y actualizar la puerta de enlace de JetBrains desde la aplicación de Cuadro de herramientas de JetBrains. + +1. Descarga e instala el [Cuadro de herramientas de JetBrains](https://www.jetbrains.com/toolbox-app). +1. Abre el Cuadro de herramientas de JetBrains. +1. Busca **Puerta de enlace** en la lista de herramientas disponibles y haz clic en **Instalar**. + + ![Captura de pantalla del Cuadro de herramientas de JetBrains](/assets/images/help/codespaces/jetbrains-toolbox.png) + +### {% data variables.product.prodname_cli %} + +El complemento {% data variables.product.prodname_github_codespaces %} para la puerta de enlace de JetBrains requiere que hayas instalado y configurado la {% data variables.product.prodname_cli %}, versión 2.18.0 o posterior, antes de abrir un codespace desde la puerta de enlace de JetBrains. + +Usa este comando para comprobar la versión de la {% data variables.product.prodname_cli %}: + +```shell{:copy} +gh --version +``` + +Para obtener más información, consulta "[Acerca de la CLI de GitHub](/github-cli/github-cli/about-github-cli)". + +### Codespace que ejecuta un servidor SSH + +Debes tener un codespace existente al que conectarse. {% data reusables.codespaces.ways-to-create-a-codespace %} Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)". + +{% data reusables.codespaces.ssh-server-installed %} + +Para obtener más información sobre el archivo `devcontainer.json` y la imagen de contenedor predeterminada, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". + +{% note %} + +**Nota**: Para obtener ayuda a fin de conectarse al codespace mediante SSH, consulta "[Solución de problemas de clientes de {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients?tool=jetbrains#ssh-connection-issues)". + +{% endnote %} + +## Configuración de la Puerta de enlace de JetBrains + +La primera vez que uses la Puerta de enlace de JetBrains para {% data variables.product.prodname_github_codespaces %}, debes instalar el complemento de {% data variables.product.prodname_codespaces %}. También debes permitir que la Puerta de enlace de JetBrains acceda a {% data variables.product.prodname_dotcom_the_website %} mediante la cuenta de {% data variables.product.prodname_dotcom %}. + +1. Abre la aplicación de Puerta de enlace de JetBrains. +1. En **Instalar más proveedores**, haz clic en el vínculo **Instalar** para {% data variables.product.prodname_github_codespaces %}. + + ![Captura de pantalla de la vista inicial de la Puerta de enlace de JetBrains](/assets/images/help/codespaces/jetbrains-gateway-initial-view.png) + +1. Haz clic en **Conectar a codespace**. + + ![Captura de pantalla de la Puerta de enlace con el botón "Conectar a Codespace"](/assets/images/help/codespaces/jetbrains-gateway-connect.png) + +1. En el cuadro de diálogo "Bienvenido a la Puerta de enlace de JetBrains", haz clic en **Iniciar sesión con {% data variables.product.prodname_dotcom %}** . + + ![Captura de pantalla del botón de inicio de sesión](/assets/images/help/codespaces/jetbrains-gateway-sign-in.png) + +1. Haz clic en el icono situado junto al código único para copiarlo y, después, en el vínculo de inicio de sesión. + + ![Captura de pantalla del código de inicio de sesión único](/assets/images/help/codespaces/jetbrains-gateway-login-code.png) + +1. Si no has iniciado sesión actualmente en {% data variables.product.prodname_dotcom %}, se muestra la página de inicio de sesión. + * Escribe la información y haz clic en **Iniciar sesión**. + * Comprueba la autenticación, por ejemplo, escribiendo un código de autenticación en dos fases. +1. En la página "Activación del dispositivo", pega el código copiado y haz clic en **Continuar**. +1. Si perteneces a organizaciones, se muestra la página "Inicio de sesión único en tus organizaciones". Haz clic en **Autorizar** junto a las organizaciones a las que quieres autorizar el acceso a la Puerta de enlace de JetBrains y, después, haz clic en **Continuar**. +1. En la página "Autorizar {% data variables.product.prodname_github_codespaces %} para JetBrains", haz clic en **Autorizar {% data variables.product.prodname_dotcom %}** . +1. Vuelve a la aplicación de Puerta de enlace de JetBrains y abre un codespace de la lista de codespaces activos o detenidos actualmente; consulta el paso 3 del procedimiento siguiente. + +## Apertura de un codespace en el IDE de JetBrains + +{% data reusables.codespaces.opening-codespace-in-jetbrains %} + + La primera vez que te conectes a un codespace, el IDE de back-end se descargará en la máquina remota. Esta operación puede tardar unos minutos. La próxima vez que te conectes al mismo codespace, este paso no será necesario, lo que hace que el proceso de conexión sea más rápido. + + Después, se inicia el IDE de back-end. De nuevo, este paso no será necesario en el futuro si vuelves a conectarte a un IDE de back-end que hayas dejado en ejecución. + + Luego, se inicia la aplicación cliente. + +## Información adicional + +- "[Desarrollo en un codespace](/codespaces/developing-in-codespaces/developing-in-a-codespace)" +- "[Uso del complemento de {% data variables.product.prodname_github_codespaces %} para JetBrains](/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains)" +- "[Uso de {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces)" +- "[Solución de problemas de clientes de {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients?tool=jetbrains)" diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md b/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md index 78bca1ff88..e30459c131 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md @@ -1,7 +1,7 @@ --- -title: Using GitHub Codespaces with GitHub CLI +title: Uso de GitHub Codespaces con la CLI de GitHub shortTitle: GitHub CLI -intro: 'You can work with {% data variables.product.prodname_github_codespaces %} directly from your command line by using `gh`, the {% data variables.product.product_name %} command line interface.' +intro: 'Puedes trabajar con {% data variables.product.prodname_github_codespaces %} directamente desde la línea de comandos mediante `gh`, la interfaz de línea de comandos de {% data variables.product.product_name %}.' miniTocMaxHeadingLevel: 3 versions: fpt: '*' @@ -13,105 +13,110 @@ topics: - Developer redirect_from: - /codespaces/developing-in-codespaces/using-codespaces-with-github-cli +ms.openlocfilehash: e9a268273e0a6d85a17a795f593e7bd3a7885718 +ms.sourcegitcommit: 0a6e3eee6eea9b1e445aea1e4461d64cf6b63218 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163501' --- +## Acerca de la {% data variables.product.prodname_cli %} -## About {% data variables.product.prodname_cli %} +{% data reusables.cli.about-cli %} Para más información, vea "[Acerca de {% data variables.product.prodname_cli %}](/github-cli/github-cli/about-github-cli)". -{% data reusables.cli.about-cli %} For more information, see "[About {% data variables.product.prodname_cli %}](/github-cli/github-cli/about-github-cli)." +Puedes trabajar con los {% data variables.product.prodname_github_codespaces %} en el {% data variables.product.prodname_cli %} para: + - [Lista todos tus codespaces](#list-all-of-your-codespaces) + - [Crea un codespace nuevo](#create-a-new-codespace) + - [Detención de un codespace](#stop-a-codespace) + - [Eliminación de un codespace](#delete-a-codespace) + - [Cambiar el nombre de un codespace](#rename-a-codespace) + - [Ejecución de SSH en un codespace](#ssh-into-a-codespace) + - [Apertura de un codespace en {% data variables.product.prodname_vscode %}](#open-a-codespace-in--data-variablesproductprodname_vscode-) + - [Apertura de un codespace en JupyterLab](#open-a-codespace-in-jupyterlab) + - [Copia un archivo de/hacia un codespace](#copy-a-file-tofrom-a-codespace) + - [Modificación de los puertos en un codespace](#modify-ports-in-a-codespace) + - [Acceso a los registros de codespace](#access-codespace-logs) + - [Acceso remoto a recursos](#access-remote-resources) + - [Cambiar el tipo de máquina de un codespace](#change-the-machine-type-of-a-codespace) -You can work with {% data variables.product.prodname_github_codespaces %} in the {% data variables.product.prodname_cli %} to: - - [List all of your codespaces](#list-all-of-your-codespaces) - - [Create a new codespace](#create-a-new-codespace) - - [Stop a codespace](#stop-a-codespace) - - [Delete a codespace](#delete-a-codespace) - - [Rename a codespace](#rename-a-codespace) - - [SSH into a codespace](#ssh-into-a-codespace) - - [Open a codespace in {% data variables.product.prodname_vscode %}](#open-a-codespace-in--data-variablesproductprodname_vscode-) - - [Open a codespace in JupyterLab](#open-a-codespace-in-jupyterlab) - - [Copy a file to/from a codespace](#copy-a-file-tofrom-a-codespace) - - [Modify ports in a codespace](#modify-ports-in-a-codespace) - - [Access codespace logs](#access-codespace-logs) - - [Access remote resources](#access-remote-resources) - - [Change the machine type of a codespace](#change-the-machine-type-of-a-codespace) - -## Installing {% data variables.product.prodname_cli %} +## Instalación de {% data variables.product.prodname_cli %} {% data reusables.cli.cli-installation %} -## Using {% data variables.product.prodname_cli %} +## Uso de {% data variables.product.prodname_cli %} -If you have not already done so, run `gh auth login` to authenticate with your {% data variables.product.prodname_dotcom %} account. +Si todavía no lo ha hecho, ejecute `gh auth login` para autenticarse con la cuenta de {% data variables.product.prodname_dotcom %}. -To use `gh` to work with {% data variables.product.prodname_github_codespaces %}, type `gh codespace SUBCOMMAND` or its alias `gh cs SUBCOMMAND`. +Para usar `gh` a fin de trabajar con {% data variables.product.prodname_github_codespaces %}, escribe `gh codespace SUBCOMMAND` o su alias `gh cs SUBCOMMAND`. -As an example of a series of commands you might use to work with {% data variables.product.prodname_github_codespaces %}, you could: +Como ejemplo de una serie de comandos que podrías utilizar para trabajar con los {% data variables.product.prodname_github_codespaces %}, podrías: -* List your current codespaces, to check whether you have a codespace for a particular repository:
+* Enumere los codespaces actuales a fin de comprobar si tiene uno para un repositorio determinado:
`gh codespace list` -* Create a new codespace for the required repository branch:
+* Cree un codespace para la rama de repositorio necesaria:
`gh codespace create -r github/docs -b main` -* SSH into the new codespace:
+* Ejecute SSH en el nuevo codespace:
`gh codespace ssh -c octocat-literate-space-parakeet-7gwrqp9q9jcx4vq` -* Forward a port to your local machine:
+* Reenvíe un puerto a la máquina local:
`gh codespace ports forward 8000:8000 -c octocat-literate-space-parakeet-7gwrqp9q9jcx4vq` -## `gh` commands for {% data variables.product.prodname_github_codespaces %} +## Comandos `gh` para {% data variables.product.prodname_github_codespaces %} -The sections below give example commands for each of the available operations. +La siguiente sección proporciona comandos de ejemplo para cada una de las operaciones disponibles. -For a complete reference of `gh` commands for {% data variables.product.prodname_github_codespaces %}, including details of all available options for each command, see the {% data variables.product.prodname_cli %} online help for "[gh codespace](https://cli.github.com/manual/gh_codespace)." Alternatively, on the command line, use `gh codespace --help` for general help or `gh codespace SUBCOMMAND --help` for help with a specific subcommand. +Para obtener una referencia completa de los comandos `gh` para {% data variables.product.prodname_github_codespaces %}, incluidos los detalles de todas las opciones disponibles para cada comando, vea "[gh codespace](https://cli.github.com/manual/gh_codespace)" en la ayuda en línea de {% data variables.product.prodname_cli %}. Como alternativa, en la línea de comandos, usa `gh codespace --help` para obtener ayuda general o `gh codespace SUBCOMMAND --help` para obtener ayuda con un subcomando específico. {% note %} -**Note**: The `-c CODESPACE_NAME` flag, used with many commands, is optional. If you omit it a list of codespaces is displayed for you to choose from. +**Nota**: La marca `-c CODESPACE_NAME`, que se usa con muchos comandos, es opcional. Si lo omites, se mostrará una lista de codespaces para que elijas de ella. {% endnote %} -### List all of your codespaces +### Lista todos tus codespaces ```shell gh codespace list ``` -The list includes the unique name of each codespace, which you can use in other `gh codespace` commands. +La lista incluye el nombre único de cada codespace, que puede usar en otros comandos `gh codespace`. -An asterisk at the end of the branch name for a codespace indicates that there are uncommitted or unpushed changes in that codespace. +Un asterisco al final del nombre de la rama de un codespace indica que hay cambios no confirmados o no insertados en ese codespace. -### Create a new codespace +### Crea un codespace nuevo ```shell gh codespace create -r OWNER/REPO_NAME [-b BRANCH] ``` -For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)." +Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)". -### Stop a codespace +### Detener un codespace ```shell gh codespace stop -c CODESPACE-NAME ``` -For more information, see "[Deep dive into {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive#closing-or-stopping-your-codespace)." +Para más información, consulta "[Profundización en {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive#closing-or-stopping-your-codespace)". -### Delete a codespace +### Borrar un codespace ```shell gh codespace delete -c CODESPACE-NAME ``` -For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)." +Para más información, vea "[Eliminación de un codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)". -### Rename a codespace +### Cambiar el nombre de un codespace ```shell gh codespace edit -c CODESPACE-NAME -d DISPLAY-NAME ``` -For more information, see "[Renaming a codespace](/codespaces/customizing-your-codespace/renaming-a-codespace)." +Para obtener más información, consulta "[Cambio del nombre de un codespace](/codespaces/customizing-your-codespace/renaming-a-codespace)". -### SSH into a codespace +### Ingresar por SSH a un codespace -To run commands on the remote codespace machine, from your terminal, you can SSH into the codespace. +Para ejecutar comandos en la máquina remota del codespace, desde tu terminal, puedes ingresar por SSH al codespace. ```shell gh codespace ssh -c CODESPACE-NAME @@ -119,25 +124,25 @@ gh codespace ssh -c CODESPACE-NAME {% note %} -**Note**: {% data reusables.codespaces.ssh-server-installed %} +**Nota**: {% data reusables.codespaces.ssh-server-installed %} -
For more information about the `devcontainer.json` file and the default container image, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." +
Para obtener más información sobre el archivo `devcontainer.json` y la imagen de contenedor predeterminada, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". {% endnote %} -{% data variables.product.prodname_github_codespaces %} copies your GitHub SSH keys into the codespace on creation for a seamless authentication experience. You may be asked to enter the passphrase for your SSH key, after which you will get a command prompt from the remote codespace machine. +{% data variables.product.prodname_github_codespaces %} copia tus llaves SSH de GitHub en el codespace cuando lo creas para tener una experiencia de autenticación sin problemas. Puede que se te pida ingresar la frase de acceso para tu llave SSH, después de lo cual se te mostrará un símbolo de sistema desde la máquina remota del codespace. -If you don't have any SSH keys, follow the instructions in "[Generating a new SSH key and adding it to the ssh-agent](/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)." +Si no tiene ninguna clave SSH, siga las instrucciones de "[Generación de una nueva clave SSH y agregación al agente ssh](/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)". -### Open a codespace in {% data variables.product.prodname_vscode %} +### Abrir un codespace en {% data variables.product.prodname_vscode %} ```shell gh codespace code -c CODESPACE-NAME ``` -You must have {% data variables.product.prodname_vscode_shortname %} installed on your local machine. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)." +Debes tener {% data variables.product.prodname_vscode_shortname %} instalados en la máquina local. Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} en {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)". -### Open a codespace in JupyterLab +### Apertura de un codespace en JupyterLab ```shell gh codespace jupyter -c CODESPACE-NAME @@ -145,95 +150,95 @@ gh codespace jupyter -c CODESPACE-NAME {% data reusables.codespaces.jupyterlab-installed-in-codespace %} -### Copy a file to/from a codespace +### Copia un archivo de/hacia un codespace ```shell gh codespace cp [-r] SOURCE(S) DESTINATION ``` -Use the prefix `remote:` on a file or directory name to indicate that it's on the codespace. As with the UNIX `cp` command, the first argument specifies the source and the last specifies the destination. If the destination is a directory, you can specify multiple sources. Use the `-r` (recursive) flag if any of the sources is a directory. +Use el prefijo `remote:` en un nombre de archivo o directorio para indicar que está en el codespace. Como sucede con el comando `cp` de UNIX, el primer argumento especifica el origen y, el último, el destino. Si el destino es un directorio, puedes especificar fuentes múltiples. Use la marca `-r` (recursiva) si alguno de los orígenes es un directorio. -The location of files and directories on the codespace is relative to the home directory of the remote user. +La ubicación de los archivos y directorios en el codespace es relativa al directorio principal del usuario remoto. -#### Examples +#### Ejemplos -* Copy a file from the local machine to the `$HOME` directory of a codespace: +* Copie un archivo de la máquina local en el directorio `$HOME` de un codespace: `gh codespace cp myfile.txt remote:` -* Copy a file to the directory in which a repository is checked out in a codespace: +* Copia un archivo al directorio en el que un repositorio esté marcado en un codespace: `gh codespace cp myfile.txt remote:/workspaces/REPOSITORY-NAME` -* Copy a file from a codespace to the current directory on the local machine: +* Copia un archivo desde un codespace hacia el directorio actual en la máquina local: `gh codespace cp remote:myfile.txt .` -* Copy three local files to the `$HOME/temp` directory of a codespace: +* Copie tres archivos locales en el directorio `$HOME/temp` de un codespace: `gh codespace cp a1.txt a2.txt a3.txt remote:temp` -* Copy three files from a codespace to the current working directory on the local machine: +* Copia tres archivos desde un codespace hacia el directorio de trabajo actual en la máquina local: `gh codespace cp remote:a1.txt remote:a2.txt remote:a3.txt .` -* Copy a local directory into the `$HOME` directory of a codespace: +* Copie un directorio local en el directorio `$HOME` de un codespace: `gh codespace cp -r mydir remote:` -* Copy a directory from a codespace to the local machine, changing the directory name: +* Copia un directorio de un codespace a la máquina local, cambiando el nombre de directorio: `gh codespace cp -r remote:mydir mydir-localcopy` -For more information about the `gh codespace cp` command, including additional flags you can use, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_cp). +Para más información sobre el comando `gh codespace cp`, incluidas las marcas adicionales que puede usar, vea [el manual de {% data variables.product.prodname_cli %}](https://cli.github.com/manual/gh_codespace_cp). -### Modify ports in a codespace +### Modificar los puertos en un codespace -You can forward a port on a codespace to a local port. The port remains forwarded as long as the process is running. To stop forwarding the port, press Control+C. +Puedes reenviar un puerto en un codespace a un puerto local. El puerto permanece reenviado siempre que el proceso se esté ejecutando. Para detener el reenvío del puerto, presione Control+C. ```shell gh codespace ports forward CODESPACE-PORT_NAME:LOCAL-PORT-NAME -c CODESPACE-NAME ``` -To see details of forwarded ports enter `gh codespace ports` and then choose a codespace. +Para ver detalles de los puertos reenviados, escriba `gh codespace ports` y elija un codespace. -You can set the visibility of a forwarded port. {% data reusables.codespaces.port-visibility-settings %} +Puedes configurar la visibilidad de un puerto reenviado. {% data reusables.codespaces.port-visibility-settings %} ```shell gh codespace ports visibility CODESPACE-PORT:private|org|public -c CODESPACE-NAME ``` -You can set the visibility for multiple ports with one command. For example: +Puedes configurar la visibilidad para varios puertos con un solo comando. Por ejemplo: ```shell gh codespace ports visibility 80:private 3000:public 3306:org -c CODESPACE-NAME ``` -For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." +Para más información, vea "[Reenvío de puertos en el codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)". -### Access codespace logs +### Acceder a las bitácoras de un codespace -You can see the creation log for a codespace. After entering this command you will be asked to enter the passphrase for your SSH key. +Puedes ver la bitácora de creación de un codespace. Después de ingresar este comando, se te pedirá ingresar la frase de acceso de tu llave SSH. ```shell gh codespace logs -c CODESPACE-NAME ``` -For more information about the creation log, see "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs#creation-logs)." +Para más información sobre el registro de creación, consulta "[Registros de {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/github-codespaces-logs#creation-logs)". -### Access remote resources -You can use the {% data variables.product.prodname_cli %} extension to create a bridge between a codespace and your local machine, so that the codespace can access any remote resource that is accessible from your machine. For more information on using the extension, see "[Using {% data variables.product.prodname_cli %} to access remote resources](https://github.com/github/gh-net#codespaces-network-bridge)." +### Acceso remoto a recursos +Puede usar la extensión {% data variables.product.prodname_cli %} para crear un puente entre un codespace y la máquina local, de modo que el codespace pueda acceder a cualquier recurso remoto al que se pueda acceder desde la máquina. Para obtener más información sobre el uso de la extensión, vea "[Uso de {% data variables.product.prodname_cli %} para acceder a recursos remotos](https://github.com/github/gh-net#codespaces-network-bridge)". {% note %} -**Note**: The {% data variables.product.prodname_cli %} extension is currently in beta and subject to change. +**Nota**: La extensión {% data variables.product.prodname_cli %} se encuentra actualmente en versión beta pública y está sujeta a cambios. {% endnote %} -### Change the machine type of a codespace +### Cambiar el tipo de máquina de un codespace ```shell gh codespace edit -m MACHINE-TYPE-NAME ``` -For more information, see the "{% data variables.product.prodname_cli %}" tab of "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)." +Para obtener más información, consulta la pestaña "{% data variables.product.prodname_cli %}" de "[Cambio del tipo de máquina para el codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)". diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md b/translations/es-ES/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md index 4765a8908e..28cda30061 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md @@ -1,6 +1,6 @@ --- -title: Using source control in your codespace -intro: After making changes to a file in your codespace you can quickly commit the changes and push your update to the remote repository. +title: Utilizar el control de código fuente en tu codespace +intro: 'Después de hacer cambios en un archivo de tu codespace, puedes confirmar los cambios rápidamente y subir tu actualización al repositorio remoto.' versions: fpt: '*' ghec: '*' @@ -10,37 +10,42 @@ topics: - Fundamentals - Developer shortTitle: Source control +ms.openlocfilehash: 513bf0729e1f04bf93f45999b2fa9e45231add5c +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160003' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -## About source control in {% data variables.product.prodname_github_codespaces %} +## Sobre el control de código fuente en {% data variables.product.prodname_github_codespaces %} -You can perform all the Git actions you need directly within your codespace. For example, you can fetch changes from a remote repository, switch branches, create a new branch, commit and push changes, and create a pull request. You can use the integrated terminal within your codespace to enter Git commands, or you can click icons and menu options to complete all the most common Git tasks. This guide explains how to use the graphical user interface for source control. +Puedes llevar a cabo todas las acciones de Git que necesites directamente dentro de tu codespace. Por ejemplo, puedes recuperar cambios del repositorio remoto, cambiar de rama, crear una rama nueva, confirmar y subir cambios y crear solicitudes de cambios. Puedes utilizar la terminal integrada dentro de tu codespace para ingresar comandos de Git o puedes hacer clic en los iconos u opciones de menú para completar las tareas más comunes de Git. Esta guía te explica cómo utilizar la interface de usuario gráfica para el control de código fuente. {% vscode %} -For more information about Git support in {% data variables.product.prodname_vscode %}, see "[Using Version Control in VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support)" in the {% data variables.product.prodname_vscode %} documentation. +Para obtener más información sobre la compatibilidad con Git en {% data variables.product.prodname_vscode %}, consulta "[Uso del control de versiones en VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support)" en la documentación de {% data variables.product.prodname_vscode %}. {% endvscode %} {% webui %} -Source control in the {% data variables.product.prodname_vscode %} web client uses the same workflow as the {% data variables.product.prodname_vscode %} desktop application. For more information, see "[Using Version Control in VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support)" in the {% data variables.product.prodname_vscode %} documentation. +El control de código fuente del cliente web de {% data variables.product.prodname_vscode %} usa el mismo flujo de trabajo que la aplicación de escritorio de {% data variables.product.prodname_vscode %}. Para obtener más información, consulta "[Uso del control de versiones en VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support)" en la documentación de {% data variables.product.prodname_vscode %}. {% endwebui %} -A typical workflow for updating a file using {% data variables.product.prodname_github_codespaces %} would be: +Un flujo de trabajo típico para actualizar un archivo utilizando {% data variables.product.prodname_github_codespaces %} sería: -* From the default branch of your repository on {% data variables.product.prodname_dotcom %}, create a codespace. See "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)." -* In your codespace, create a new branch to work on. -* Make your changes and save them. -* Commit the change. -* Raise a pull request. +* Desde la rama predeterminada de tu repositorio en {% data variables.product.prodname_dotcom %}, crea un codespace. Consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)". +* En tu codespace, crea una rama nueva para trabajar en ella. +* Haz tus cambios y guárdalos. +* Confirme el cambio. +* Levanta una solicitud de cambios. {% webui %} @@ -56,67 +61,67 @@ A typical workflow for updating a file using {% data variables.product.prodname_ {% jetbrains %} -## Creating or switching branches +## Crear o cambiar de rama -1. Click the branch name at the right side of the status bar. +1. Haz clic en el nombre de la rama en el lado derecho de la barra de estado. - ![Screenshot of the branch name in the status bar](/assets/images/help/codespaces/jetbrains-branch-button.png) + ![Captura de pantalla del nombre de la rama en la barra de estado](/assets/images/help/codespaces/jetbrains-branch-button.png) -1. In the pop-up menu, do one of the following: - * To create a new branch based on the current branch, click the name of the current branch, then choose **New Branch**. +1. En el menú emergente, realiza una de las acciones siguientes: + * Para crear una nueva rama basada en la rama actual, haz clic en el nombre de la rama actual y, a continuación, elige **Nueva rama**. - ![Screenshot of the new branch option](/assets/images/help/codespaces/jetbrains-new-branch-option.png) + ![Captura de pantalla de la opción de nueva rama](/assets/images/help/codespaces/jetbrains-new-branch-option.png) - Enter a name for the new branch and click **Create**. + Escribe un nombre para la nueva rama y haz clic en **Crear**. - ![Screenshot of the create branch dialog box](/assets/images/help/codespaces/jetbrains-create-branch-dialog.png) + ![Captura de pantalla del cuadro de diálogo Crear rama](/assets/images/help/codespaces/jetbrains-create-branch-dialog.png) - * To check out an existing branch, start typing the name of the branch you want to check out. Click the branch from the list, then click **Checkout**. + * Para desactivar una rama existente, empieza escribiendo el nombre de la rama que quieres extraer del repositorio. Haz clic en la rama de la lista y, a continuación, haz clic en **Extraer del repositorio**. - ![Screenshot of the checkout option](/assets/images/help/codespaces/jetbrains-checkout-submenu.png) + ![Captura de pantalla de la opción extraer del repositorio](/assets/images/help/codespaces/jetbrains-checkout-submenu.png) {% tip %} - **Tip**: If someone has recently changed a file on the remote repository, in the branch you switched to, you may not see those changes until you pull the changes into your codespace. + **Sugerencia**: Si alguien ha modificado recientemente un archivo en el repositorio remoto, en la rama a la que hayas cambiado quizá no veas estos cambios hasta que los extraigas en el codespace. {% endtip %} -## Committing your changes +## Configramr tus cambios -1. At the right side of the navigation bar, click the check mark. +1. En el lado derecho de la barra de navegación, haz clic en la marca de verificación. - ![Screenshot of the commit check mark](/assets/images/help/codespaces/jetbrains-commit-button.png) + ![Captura de pantalla de la marca de verificación de confirmación](/assets/images/help/codespaces/jetbrains-commit-button.png) -1. In the Commit Changes dialog box, enter a commit message. -1. Click **Commit**. +1. En el cuadro de diálogo Confirmar cambios, escribe un mensaje de confirmación. +1. Haga clic en **Confirmar**. - Alternatively, click the down arrow beside **Commit** and click **Commit and Push**. + Como alternativa, haz clic en la flecha abajo situada junto a **Confirmar** y haz clic en **Confirmar e Insertar**. - ![Screenshot of the commit and push button](/assets/images/help/codespaces/jetbrains-commit-and-push.png) + ![Captura de pantalla del botón de Confirmar e Insertar](/assets/images/help/codespaces/jetbrains-commit-and-push.png) -## Pulling changes from the remote repository +## Extraer cambios del repositorio remoto -You can pull changes from the same branch on the remote repository and apply those changes to the copy of the repository you are working on in your codespace. +Puedes extraer cambios de la misma rama en el repositorio remoto y aplicar esos cambios a la copia del repositorio en el que estás trabajando en el codespace. -1. At the right side of the navigation bar, click the downward pointing arrow. +1. En el lado derecho de la barra de navegación, haz clic en la flecha que apunta hacia abajo. - ![Screenshot of the update project downward arrow button](/assets/images/help/codespaces/jetbrains-update-project-button.png) + ![Captura de pantalla del botón de flecha hacia abajo de actualización de proyecto](/assets/images/help/codespaces/jetbrains-update-project-button.png) -1. In the Update Project dialog box, choose whether you want to merge or rebase the incoming changes. +1. En el cuadro de diálogo Actualizar proyecto, elige si quieres combinar o fusionar mediante cambio de base los cambios entrantes. - ![Screenshot of the Update Project dialog box](/assets/images/help/codespaces/jetbrains-update-options.png) + ![Captura de pantalla del cuadro de diálogo Actualizar proyecto](/assets/images/help/codespaces/jetbrains-update-options.png) -1. Click **OK**. +1. Haga clic en **OK**. -## Pushing changes to your remote repository +## Subir cambios a tu repositorio remoto -You can push changes you've saved and committed. This applies those changes to the upstream branch on the remote repository. You might want to do this if you're not yet ready to create a pull request, or if you prefer to create a pull request on {% data variables.product.prodname_dotcom %}. +Puedes insertar cambios que hayas guardado y confirmado. Esto aplica a aquellos de la rama ascendente en el repositorio remoto. Puede que necesites hacer eso si aún no estás listo para crear una solicitud de cambios o si prefieres crearla en {% data variables.product.prodname_dotcom %}. -1. At the right side of the navigation bar, click the upward pointing arrow. +1. En el lado derecho de la barra de navegación, haz clic en la flecha hacia arriba. - ![Screenshot of the push commits upward arrow](/assets/images/help/codespaces/jetbrains-push-button.png) + ![Captura de pantalla de la flecha hacia arriba de Insertar confirmaciones](/assets/images/help/codespaces/jetbrains-push-button.png) -1. In the Push Commits dialog box, click **Push**. +1. En el cuadro de diálogo Insertar confirmaciones, haz clic en **Insertar**. {% endjetbrains %} diff --git a/translations/es-ES/content/codespaces/getting-started/deep-dive.md b/translations/es-ES/content/codespaces/getting-started/deep-dive.md index 48c9c1004b..34eba4bf49 100644 --- a/translations/es-ES/content/codespaces/getting-started/deep-dive.md +++ b/translations/es-ES/content/codespaces/getting-started/deep-dive.md @@ -1,7 +1,7 @@ --- -title: 'Deep dive into {% data variables.product.prodname_github_codespaces %}' +title: 'Análisis en profundidad de {% data variables.product.prodname_github_codespaces %}' shortTitle: 'Deep dive into {% data variables.product.prodname_codespaces %}' -intro: 'Understand how {% data variables.product.prodname_github_codespaces %} works.' +intro: 'Comprende el funcionamiento de {% data variables.product.prodname_github_codespaces %}.' allowTitleToDifferFromFilename: true versions: fpt: '*' @@ -9,151 +9,156 @@ versions: type: quick_start topics: - Codespaces +ms.openlocfilehash: 5f97a137ec09191d5cbaa9c10aa280e10f11bbc0 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158649' --- +{% data variables.product.prodname_github_codespaces %} es un entorno de desarrollo instantáneo basado en la nube que usa un contenedor para proporcionar lenguajes comunes, herramientas y utilidades para el desarrollo. {% data variables.product.prodname_github_codespaces %} también es configurable, lo cual te permite crear un entorno de desarrollo personalizado para tu proyecto. Al configurar un ambiente de desarrollo personalizado para tu proyecto, puedes tener una configuración de codespace repetible para todos los usuarios de dicho proyecto. -{% data variables.product.prodname_github_codespaces %} is an instant, cloud-based development environment that uses a container to provide you with common languages, tools, and utilities for development. {% data variables.product.prodname_github_codespaces %} is also configurable, allowing you to create a customized development environment for your project. By configuring a custom development environment for your project, you can have a repeatable codespace configuration for all users of your project. +## Crea tu codespace -## Creating your codespace +Hay varios puntos de entrada para crear un codespace. -There are a number of entry points to create a codespace. - -- From a {% data variables.product.company_short %} template or any template repository on {% data variables.product.prodname_dotcom_the_website %} to start a new project -- From a branch in your repository for new feature work -- From an open pull request to explore work-in-progress -- From a commit in a repository's history to investigate a bug at a specific point in time +- Desde una plantilla de {% data variables.product.company_short %} o desde cualquier repositorio de plantilla en {% data variables.product.prodname_dotcom_the_website %} para iniciar un nuevo proyecto +- Desde una rama del repositorio para el nuevo trabajo destacado +- Desde una solicitud de incorporación de cambios abierta para explorar el trabajo en curso +- Desde una confirmación en el historial de un repositorio para investigar un error en un punto específico del tiempo {% data reusables.codespaces.ways-to-create-a-codespace %} -Your codespace can be ephemeral if you need to test something or you can return to the same codespace to work on long-running feature work. +Tu codespace puede ser efímero si necesitas probar algo o puedes volver al mismo codespace para trabajar en trabajo destacado a largo plazo. -For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)," "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)," and "[Opening an existing codespace](/codespaces/developing-in-codespaces/opening-an-existing-codespace)." +Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)", "[Creación de un codespace a partir de una plantilla](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)" o "[Apertura de un codespace existente](/codespaces/developing-in-codespaces/opening-an-existing-codespace)". {% note %} -**Note**: You can create more than one codespace per repository or even per branch. However, there are limits to the number of codespaces you can create, and the number of codespaces you can run at the same time. If you reach the maximum number of codespaces and try to create another, a message is displayed telling you that you must remove an existing codespace before you can create a new one. +**Nota**: Puedes crear más de un codespace por repositorio o incluso por rama. Sin embargo, hay límites para el número de codespaces que puede crear y el número de codespaces que puede ejecutar al mismo tiempo. Si alcanza el número máximo de codespaces e intenta crear otro, se muestra un mensaje que indica que debe quitar un codespace existente para poder crear uno nuevo. {% endnote %} -### The codespace creation process +### Proceso de creación de un codespace -When you create a codespace, various steps happen in the background before the codespace is available to you. +Al crear un codespace, se producen varios pasos en segundo plano antes de que el codespace esté disponible para ti. -### Step 1: VM and storage are assigned to your codespace +### Paso 1: Se asigna una MV y un almacenamiento a tu codespace -When you create a codespace, a [shallow clone](https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/) is made of your repository, or of the template repository if you're creating a codespace from a template. The repository is cloned to a Linux virtual machine that is both dedicated and private to you. Having a dedicated VM ensures that you have the entire set of compute resources from that machine available to you. If necessary, this also allows you to have full root access to your container. +Al crear un codespace, se genera un [clon superficial](https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/) del repositorio o del repositorio de plantilla si vas a crear un codespace a partir de una plantilla. El repositorio se clona en una máquina virtual de Linux dedicada y privada para ti. El tener una MV dedicada garantiza que tengas un conjunto completo de recursos de cómputo disponibles para ti desde esa máquina. Si es necesario, esto también te permitirá tener acceso de raíz total a tu contenedor. -### Step 2: Container is created +### Paso 2: Se crea el contenedor -{% data variables.product.prodname_github_codespaces %} uses a container as the development environment. This container is created based on configurations that you can define in a `devcontainer.json` file and, optionally, a Dockerfile. If you create a codespace from {% data variables.product.company_short %}'s blank template, or from a repository with no `devcontainer.json` file, {% data variables.product.prodname_github_codespaces %} uses a default image, which has many languages and runtimes available. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." For details of what the default image contains, see the [`microsoft/vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers/tree/main/containers/codespaces-linux) repository. +{% data variables.product.prodname_github_codespaces %} utiliza un contenedor como el ambiente de desarrollo. Este contenedor se crea en función de las configuraciones que puedes definir en un archivo `devcontainer.json` u, opcionalmente, en un Dockerfile. Si creas un codespace a partir de la plantilla en blanco de {% data variables.product.company_short %} o desde un repositorio sin el archivo `devcontainer.json`, {% data variables.product.prodname_github_codespaces %} usa una imagen predeterminada, que tiene muchos lenguajes y tiempos de ejecución disponibles. Para obtener más información, consulte "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". Para obtener detalles sobre lo que contiene la imagen predeterminada, consulta el repositorio [`microsoft/vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers/tree/main/containers/codespaces-linux). {% note %} -**Note:** If you want to use Git hooks in your codespace and apply anything in the [git template directory](https://git-scm.com/docs/git-init#_template_directory) to your codespace, then you must set up hooks during step 4 after the container is created. +**Nota:** Si quiere usar enlaces de Git en el codespace y aplicar cualquier cosa en el [directorio de plantillas de Git](https://git-scm.com/docs/git-init#_template_directory) al codespace, tendrá que configurar enlaces durante el paso 4 después de crear el contenedor. -Since your repository is cloned onto the host VM before the container is created, anything in the [git template directory](https://git-scm.com/docs/git-init#_template_directory) will not apply in your codespace unless you set up hooks in your `devcontainer.json` configuration file using the `postCreateCommand` in step 4. For more information, see "[Step 4: Post-creation setup](#step-4-post-creation-setup)." +Como el repositorio se clona en la máquina virtual host antes de crear el contenedor, todo lo que se encuentra en el [directorio de plantillas de Git](https://git-scm.com/docs/git-init#_template_directory) no se aplicará en el codespace a menos que configure enlaces en el archivo de configuración `devcontainer.json` mediante `postCreateCommand` en el paso 4. Para más información, vea "[Paso 4: Configuración posterior a la creación](#step-4-post-creation-setup)". {% endnote %} -### Step 3: Connecting to the codespace +### Paso 3: Conectarse al codespace -When your container has been created and any other initialization has run, you'll be connected to your codespace. You can connect to it by using: +Cuando tu contenedor se crea y se ejecuta cualquier otra inicialización, estarás conectado a tu codespace. Puedes conectarse a él mediante lo siguiente: -* Your web browser +* El explorador web * [Visual Studio Code](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code) -* [A JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide) +* [Un IDE de JetBrains](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide) * [{% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli) -### Step 4: Post-creation setup +### Paso 4: Ajustes post-creación -Once you are connected to your codespace, your automated setup may continue to build based on the configuration specified in your `devcontainer.json` file. You may see `postCreateCommand` and `postAttachCommand` run. +Una vez que te conectes al codespace, la configuración automatizada podría continuar la compilación en función de la configuración especificada en el archivo `devcontainer.json`. Es posible que vea que se ejecutan `postCreateCommand` y `postAttachCommand`. -If you want to use Git hooks in your codespace, set up hooks using the [`devcontainer.json` lifecycle scripts](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts), such as `postCreateCommand`. For more information, see the [`devcontainer.json` reference](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) in the {% data variables.product.prodname_vscode_shortname %} documentation. +Si quieres usar enlaces de Git en el codespace, configura enlaces mediante los [`devcontainer.json`scripts de ciclo de vida ](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts), como `postCreateCommand`. Para más información, consulta la [referencia de `devcontainer.json`](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) en la documentación de {% data variables.product.prodname_vscode_shortname %}. -If you have a public dotfiles repository for {% data variables.product.prodname_github_codespaces %}, you can enable it for use with new codespaces. When enabled, your dotfiles will be cloned to the container and the install script will be invoked. For more information, see "[Personalizing {% data variables.product.prodname_github_codespaces %} for your account](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#dotfiles)." +Si tienes un repositorio público de dotfiles para {% data variables.product.prodname_github_codespaces %}, puedes habilitarlo para utilizarlo con nuevos codespaces. Cuando lo habilitas, tus dotfiles se clonarán en el contenedor y se invocará el script de instalación. Para más información, consulta "[Personalización de {% data variables.product.prodname_github_codespaces %} para la cuenta](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#dotfiles)". -Finally, if you created the codespace from a repository, the entire history of the repository is copied down with a full clone. If you created the codespace from a template, the full history of the template repository is not preserved; instead, unless you are using the blank template, you will start with an initial commit for the contents of the template repository. +Por último, si has creado el codespace desde un repositorio, todo el historial del repositorio se copiará con un clon integral. Si has creado el codespace a partir de una plantilla, no se conservará el historial completo del repositorio de plantilla. En su lugar, a menos que uses la plantilla en blanco, empezarás con una confirmación inicial para el contenido del repositorio de plantilla. -During post-creation setup you'll still be able to use the integrated terminal and make edits to your files, but take care to avoid any race conditions between your work and the commands that are running. -## {% data variables.product.prodname_codespaces %} lifecycle +Durante la configuración post-creación, aún podrás utilizar la terminal integrada y editar tus archivos, pero ten cuidado de evitar cualquier condiciones de carrera entre tu trabajo y los comandos que se están ejecutando. +## Ciclo de vida de los {% data variables.product.prodname_codespaces %} -### Saving files in your codespace +### Guardar archivos en tu codespace -Save changes to files in the normal way, depending on the editor you are using. +Guarda los cambios en los archivos de la manera habitual, según el editor que estés usando. -If you work on codespaces in {% data variables.product.prodname_vscode %}, you can enable [Auto Save](https://code.visualstudio.com/docs/editor/codebasics#_save-auto-save) to ensure that your changes are always saved. +Si trabajas en codespaces en {% data variables.product.prodname_vscode %}, puedes habilitar el [Guardado automático](https://code.visualstudio.com/docs/editor/codebasics#_save-auto-save) para asegurarte de que los cambios siempre se guardan. -### Closing or stopping your codespace +### Cerrar o detener tu codespace -Your codespace will keep running while you are using it, but will time out after a period of inactivity. File changes from the editor and terminal output are counted as activity, so your codespace will not time out if terminal output is continuing. The default inactivity timeout period is 30 minutes. You can define your personal timeout setting for codespaces you create, but this may be overruled by an organization timeout policy. For more information, see "[Setting your timeout period for Codespaces](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces)." +El codespace seguirá ejecutándose mientras lo usas, pero se agotará el tiempo de espera después de un período de inactividad. Los cambios de archivo del editor y de la salida del terminal se cuentan como actividad. Por lo tanto, no se agotará el tiempo de espera de tu codespace si la salida del terminal sigue. El período de tiempo de espera de inactividad predeterminado es de 30 minutos. Puedes definir un configuración de tiempo de espera personal para los codespaces que crees, pero una directiva de tiempo de espera de la organización puede invalidarla. Para obtener más información, consulta "[Configuración del tiempo de espera para los codespaces](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces)". -If a codespace times out it will stop running, but you can restart it from the browser tab (if you were using the codespace in the browser), from within {% data variables.product.prodname_vscode_shortname %}, or from your list of codespaces at [https://github.com/codespaces](https://github.com/codespaces). +Si se agota el tiempo de espera de un codespace, dejará de ejecutarse, pero puedes reiniciarlo desde la pestaña del explorador (si estabas usando el codespace en el explorador), desde {% data variables.product.prodname_vscode_shortname %} o desde tu lista de codespaces en [https://github.com/codespaces](https://github.com/codespaces). -To stop your codespace you can +Para detener un codespace, puedes hacer lo siguiente: -* In the browser: on your list of codespaces at [https://github.com/codespaces](https://github.com/codespaces), click the ellipsis (**...**) to the right of the codespace you want to stop and click **Stop codespace**. -* In {% data variables.product.prodname_vscode_shortname %}: open [the {% data variables.product.prodname_vscode_command_palette %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces#suspending-or-stopping-a-codespace) - for example, by pressing Ctrl+Shift+Enter (Windows/Linux) or Shift+Command+P (Mac) - type `Codespaces: stop` then press Enter. -* In the JetBrains client, click the stop button at the top of the {% data variables.product.prodname_github_codespaces %} tool window. For more information, see the "JetBrains IDEs" tab of "[Stopping and starting a codespace](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)." -* In a terminal window: use the {% data variables.product.prodname_cli %} command `gh codespace stop`. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli#gh-commands-for-github-codespaces)." +* En el explorador: en tu lista de codespaces de [https://github.com/codespaces](https://github.com/codespaces), haz clic en los puntos suspensivos ( **...** ) situados a la derecha del codespace que deseas detener y haz clic en **Detener codespace**. +* En {% data variables.product.prodname_vscode_shortname %}: abre [la {% data variables.product.prodname_vscode_command_palette %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces#suspending-or-stopping-a-codespace) (por ejemplo, presiona Ctrl+Mayús+Entrar (Windows/Linux) o Mayús+Comando+P (Mac)), escribe `Codespaces: stop` y presiona Entrar. +* En el cliente de JetBrains, haz clic en el botón de detener situado en la parte superior de la ventana de herramientas de {% data variables.product.prodname_github_codespaces %}. Para obtener más información, consulta la pestaña "IDE de JetBrains" de "[Detención e inicio de un codespace](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)". +* En una ventana del terminal: usa el comando `gh codespace stop` de la {% data variables.product.prodname_cli %}. Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} con la {% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli#gh-commands-for-github-codespaces)". -If you exit your codespace without running the stop command (for example, by closing the browser tab), or if you leave the codespace running without interaction, the codespace and its running processes will continue for the duration of the inactivity timeout period. +Si sales de tu codespace sin ejecutar el comando para detenerlo (por ejemplo, cerrando la pestaña del explorador) o si dejas el codespace ejecutándose sin interacción, este y sus procesos en ejecución seguirán durante el período de tiempo de espera de inactividad. -When you close or stop your codespace, all uncommitted changes are preserved until you connect to the codespace again. +Cuando cierras o detienes tu codespace, todos los cambios sin confirmar se preservan hasta que te conectes al codespace nuevamente. -## Running your application +## Ejecutar tu aplicación -Port forwarding gives you access to TCP ports running within your codespace. For example, if you're running a web application on port 4000 within your codespace, you can automatically forward that port to make the application accessible from your browser. +La redirección de puertos te otorga acceso a los puertos CRP dentro de tu codespace. Por ejemplo, si estás ejecutando una aplicación web por el puerto 4000 dentro de tu codespace, puedes reenviar ese puerto automáticamente para hacer la aplicación accesible desde tu buscador. -Port forwarding determines which ports are made accessible to you from the remote machine. Even if you do not forward a port, that port is still accessible to other processes running inside the codespace itself. +El reenvío de puertos determina cuáles de ellos se hicieron accesibles para ti desde la máquina remota. Incluso si no reenvías un puerto, este será accesible para otros procesos que se ejecuten dentro del mismo codespace. -![Diagram showing how port forwarding works in a codespace](/assets/images/help/codespaces/port-forwarding.png) +![Diagrama que muestra cómo funciona el reenvío de puertos en un codespace](/assets/images/help/codespaces/port-forwarding.png) -When an application running inside {% data variables.product.prodname_github_codespaces %} outputs a port to the console, {% data variables.product.prodname_github_codespaces %} detects the localhost URL pattern and automatically forwards the port. You can click on the URL in the terminal, or the link in the "toast" notification message that pops up at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, to open the port in a browser. By default, {% data variables.product.prodname_github_codespaces %} forwards the port using HTTP. For more information on port forwarding, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." +Cuando una aplicación que se ejecuta dentro de {% data variables.product.prodname_github_codespaces %} da salida a un puerto hacia la consola, {% data variables.product.prodname_github_codespaces %} detecta el patrón de URL del localhost y reenvía el puerto automáticamente. Puedes hacer clic en la dirección URL del terminal o en el vínculo del mensaje de notificación del sistema que aparece en la esquina inferior derecha de {% data variables.product.prodname_vscode_shortname %} para abrir el puerto en un explorador. De manera predeterminada, {% data variables.product.prodname_github_codespaces %} reenvía el puerto utilizando HTTP. Para más información sobre el reenvío de puertos, vea "[Reenvío de puertos en el codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)". -While ports can be forwarded automatically, they are not publicly accessible to the internet. By default, all ports are private, but you can manually make a port available to your organization or public, and then share access through a URL. For more information, see "[Sharing a port](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace#sharing-a-port)." +Si bien los puertos pueden reenviarse automáticamente, no son accesibles públicamente en la internet. Predeterminadamente, todos los puertos son privados, pero puedes poner a un puerto como disponible para tu organización o como público manualmente y luego compartir el acceso a través de una URL. Para más información, vea "[Uso compartido de un puerto](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace#sharing-a-port)". -Running your application when you first land in your codespace can make for a fast inner dev loop. As you edit, your changes are automatically saved and available on your forwarded port. To view changes, go back to the running application tab in your browser and refresh it. +El ejecutar tu aplicación cuando llegas por primera vez a tu codespace puede convertirse en un bucle de desarrollador interno rápido. Mientras editas, tus cambios se guardan automáticamente y se ponen disponibles en tu puerto reenviado. Para ver los cambios, regresa a la pestaña de la aplicación en ejecución en tu buscador y actualízala. -## Committing and pushing your changes +## Confirmar y subir tus cambios -Git is installed by default in your codespace and so you can rely on your existing Git workflow. You can work with Git in your codespace either via the Terminal or by using the source control features of {% data variables.product.prodname_vscode_shortname %} or JetBrains. +Git está instalado de manera predeterminada en tu codespace, por lo que puedes confiar en tu flujo de trabajo existente de Git. Puedes trabajar con Git en el codespace mediante el terminal o con las características de control de código fuente de {% data variables.product.prodname_vscode_shortname %} o JetBrains. -If you're working with an existing repository, you can create a codespace from any branch, commit, or pull request in the repository, or you can switch to a new or existing branch from within your active codespace. Because {% data variables.product.prodname_github_codespaces %} is designed to be ephemeral, you can use it as an isolated environment to experiment, check a teammate's pull request, or fix merge conflicts. +Si estás trabajando con un repositorio existente, puedes crear un codespace desde cualquier rama, confirmación o solicitud de incorporación de cambios en el repositorio o puedes cambiar a una rama existente o nueva desde dentro de tu codespace activo. Ya que {% data variables.product.prodname_github_codespaces %} está diseñado para ser efímero, puedes utilizarlo como un ambiente aislado para experimentar, verificar la solicitud de incorporación de cambios de un compañero o arreglar conflictos de fusión. -If you're working in a codespace created from a template, Git will be installed by default, but you will need to publish your codespace to a remote repository to persist your work and to share it with others. If you start from {% data variables.product.company_short %}'s blank template, you will first need to initialize your workspace as a Git repository (for example by entering `git init`) to start using source control within the codespace. +Si estás trabajando en un codespace creado a partir de una plantilla, Git se instalará de manera predeterminada, pero tendrás que publicar el codespace en un repositorio remoto para conservar el trabajo y compartirlo con otros usuarios. Si empiezas a partir de la plantilla en blanco de {% data variables.product.company_short %}, primero deberás inicializar el área de trabajo como repositorio de Git (por ejemplo, escribiendo `git init`) para comenzar a usar el control de código fuente en el codespace. -For more information, see "[Using source control in your codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)." +Para más información, vea "[Uso del control de código fuente en el codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)". {% note %} -**Note:** Commits from your codespace will be attributed to the name and public email configured at https://github.com/settings/profile. A token scoped to the repository, included in the environment as `GITHUB_TOKEN`, and your GitHub credentials will be used to authenticate. +**Nota:** Las confirmaciones desde el codespace se atribuirán al nombre y al correo electrónico público configurados en https://github.com/settings/profile. Para la autenticación, se usará un token con ámbito en el repositorio, incluido en el entorno como `GITHUB_TOKEN`, y las credenciales de GitHub. {% endnote %} -## Personalizing your codespace with extensions or plugins +## Personalización de un codespace con extensiones o complementos -You can add plugins and extensions within a codespace to personalize your experience in JetBrains and {% data variables.product.prodname_vscode_shortname %} respectively. +Puedes agregar complementos y extensiones en un codespace para personalizar tu experiencia en JetBrains y {% data variables.product.prodname_vscode_shortname %} respectivamente. -### {% data variables.product.prodname_vscode_shortname %} extensions +### Extensiones de {% data variables.product.prodname_vscode_shortname %} -If you work on your codespaces in the {% data variables.product.prodname_vscode_shortname %} desktop application, or the web client, you can add any extensions you need from the {% data variables.product.prodname_vscode_marketplace %}. For information on how extensions run in {% data variables.product.prodname_github_codespaces %}, see [Supporting Remote Development and {% data variables.product.prodname_github_codespaces %}](https://code.visualstudio.com/api/advanced-topics/remote-extensions) in the {% data variables.product.prodname_vscode_shortname %} documentation. +Si trabajas con los codespaces en la aplicación de escritorio de {% data variables.product.prodname_vscode_shortname %} o en el cliente web, puedes agregar las extensiones que necesites desde {% data variables.product.prodname_vscode_marketplace %}. Para obtener información sobre cómo se ejecutan las extensiones en {% data variables.product.prodname_github_codespaces %}, consulta [Compatibilidad con el desarrollo remoto y {% data variables.product.prodname_github_codespaces %}](https://code.visualstudio.com/api/advanced-topics/remote-extensions) en la documentación de {% data variables.product.prodname_vscode_shortname %}. -If you already use {% data variables.product.prodname_vscode_shortname %}, you can use [Settings Sync](https://code.visualstudio.com/docs/editor/settings-sync) to automatically sync extensions, settings, themes, and keyboard shortcuts between your local instance and any codespaces you create. +Si ya usas {% data variables.product.prodname_vscode_shortname %}, puedes usar [Sincronización de ajustes](https://code.visualstudio.com/docs/editor/settings-sync) para sincronizar automáticamente extensiones, configuraciones, temas y métodos abreviados de teclado entre la instancia local y los codespaces que crees. -### JetBrains plugins +### Complementos de JetBrains -If you work on your codespaces in a JetBrains IDE, you can add plugins from the JetBrains Marketplace. +Si trabajas con los codespaces en un IDE de JetBrains, puedes agregar complementos desde JetBrains Marketplace. -1. Click **JetBrains Client**, then click **Preferences**. -1. In the Preferences dialog box, click either **Plugins On Host** to install a plugin in the full JetBrains IDE that's running remotely, or **Plugins** to install a plugin on the local client, for example to change the user interface theme. -1. Click the **Marketplace** tab. +1. Haz clic en el **Cliente JetBrains** y, después, en **Preferencias**. +1. En el cuadro de diálogo Preferencias, haz clic en **Complementos en el host** para instalar un complemento en el IDE de JetBrains completo que se ejecuta de forma remota o en **Complementos** para instalar un complemento en el cliente local, por ejemplo, para cambiar el tema de la interfaz de usuario. +1. Haz clic en la pestaña **Marketplace**. - ![Screenshot of the Marketplace tab for 'Plugins On Host'](/assets/images/help/codespaces/jetbrains-preferences-plugins.png) + ![Captura de pantalla de la pestaña Marketplace de "Complementos en host"](/assets/images/help/codespaces/jetbrains-preferences-plugins.png) -1. Click **Install** beside the required plugin. +1. Haz clic en **Instalar** junto al complemento necesario. -## Further reading +## Información adicional -- "[Enabling {% data variables.product.prodname_github_codespaces %} for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)" -- "[Managing the cost of {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization)" -- "[Add a dev container configuration to your repository](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)" -- "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" +- "[Habilitación de {% data variables.product.prodname_github_codespaces %} en la organización](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)" +- "[Administración del costo de {% data variables.product.prodname_github_codespaces %} en la organización](/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization)" +- "[Adición de una configuración de contenedor de desarrollo al repositorio](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)" +- "[Ciclo de vida de un codespace](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" diff --git a/translations/es-ES/content/codespaces/getting-started/quickstart.md b/translations/es-ES/content/codespaces/getting-started/quickstart.md index c432de015c..c206ab7d90 100644 --- a/translations/es-ES/content/codespaces/getting-started/quickstart.md +++ b/translations/es-ES/content/codespaces/getting-started/quickstart.md @@ -1,7 +1,7 @@ --- -title: 'Quickstart for {% data variables.product.prodname_github_codespaces %}' +title: 'Inicio rápido de {% data variables.product.prodname_github_codespaces %}' shortTitle: 'Quickstart for {% data variables.product.prodname_codespaces %}' -intro: 'Try out {% data variables.product.prodname_github_codespaces %} in 5 minutes.' +intro: "Prueba {% data variables.product.prodname_github_codespaces %} en 5\_minutos." allowTitleToDifferFromFilename: true versions: fpt: '*' @@ -11,103 +11,108 @@ topics: - Codespaces redirect_from: - /codespaces/codespaces-quickstart +ms.openlocfilehash: f35fa87711ff3a7c33ed252d0d1e87865af619bc +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158657' --- +## Introducción -## Introduction +En esta guía, creará un codespace a partir de un repositorio de plantillas y explorará algunas de las características esenciales disponibles en el codespace. Trabajarás en la versión web de {% data variables.product.prodname_vscode %}, que es inicialmente el editor predeterminado para {% data variables.product.prodname_github_codespaces %}. Después de probar esta guía de inicio rápido, puedes usar {% data variables.product.prodname_codespaces %} en otros editores y cambiar el editor predeterminado. Los vínculos se proporcionan al final de esta guía. -In this guide, you'll create a codespace from a template repository and explore some of the essential features available to you within the codespace. You'll work in the browser version of {% data variables.product.prodname_vscode %}, which is initially the default editor for {% data variables.product.prodname_github_codespaces %}. After trying out this quickstart you can use {% data variables.product.prodname_codespaces %} in other editors, and you can change the default editor. Links are provided at the end of this guide. +Desde esta guía de inicio rápido, aprenderás cómo crear un codespace, cómo conectarte a un puerto reenviado para ver tu aplicación ejecutándose, cómo publicar tu codespace en un nuevo repositorio y cómo personalizar tu configuración con extensiones. -From this quickstart, you'll learn how to create a codespace, connect to a forwarded port to view your running application, publish your codespace to a new repository, and personalize your setup with extensions. +Para más información sobre cómo funcionan exactamente {% data variables.product.prodname_github_codespaces %}, ve la guía complementaria "[Profundización en {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive)". -For more information on exactly how {% data variables.product.prodname_github_codespaces %} works, see the companion guide "[Deep dive into {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive)." +## Crea tu codespace -## Creating your codespace - -1. Navigate to the [github/haikus-for-codespaces](https://github.com/github/haikus-for-codespaces) template repository. +1. Ve al repositorio de plantillas [github/haikus-for-codespaces](https://github.com/github/haikus-for-codespaces). {% data reusables.codespaces.open-template-in-codespace-step %} -## Running the application +## Ejecución de la aplicación -Once your codespace is created, the template repository will be automatically cloned into it. Now you can run the application and launch it in a browser. +Una vez que se cree tu codespace, el repositorio de plantillas se clonará automáticamente en él. Ahora puedes ejecutar la aplicación y lanzarla en un buscador. -1. When the terminal becomes available, enter the command `npm run dev`. This example uses a Node.js project, and this command runs the script labeled "dev" in the `package.json` file, which starts up the web application defined in the sample repository. +1. Cuando el terminal esté disponible, escribe el comando `npm run dev`. En este ejemplo se usa un proyecto de Node.js y este comando ejecuta el script con la etiqueta "dev" en el archivo `package.json`, que inicia la aplicación web definida en el repositorio de muestra. - ![npm run dev in terminal](/assets/images/help/codespaces/codespaces-npm-run-dev.png) + ![npm run dev en la temrinal](/assets/images/help/codespaces/codespaces-npm-run-dev.png) - If you're following along with a different application type, enter the corresponding start command for that project. + Si estás siguiendo la guía con un tipo de aplicación diferente, ingresa el comando de incio correspondiente para este. -2. When your application starts, the codespace recognizes the port the application is running on and displays a prompt to let you know it has been forwarded. +2. Cuando se inicia la aplicación, el codespace reconoce el puerto en el que se ejecuta la aplicación y muestra un mensaje para informarle de que se ha reenviado. - ![Port forwarding "toast" notification](/assets/images/help/codespaces/quickstart-port-toast.png) + ![Notificación del sistema de enrutamiento de puerto](/assets/images/help/codespaces/quickstart-port-toast.png) -3. Click **Open in Browser** to view your running application in a new tab. +3. Haga clic en **Abrir en el explorador** para ver la aplicación en ejecución en una pestaña nueva. -## Edit the application and view changes +## Editar la aplicación y ver los cambios -1. Switch back to your codespace and open the `haikus.json` file by clicking it in the Explorer. +1. Vuelve al codespace y haz clic en el archivo `haikus.json` para abrirlo en el Explorador. -2. Edit the `text` field of the first haiku to personalize the application with your own haiku. +2. Edite el campo `text` del primer haiku para personalizar la aplicación con un haiku propio. -3. Go back to the running application tab in your browser and refresh to see your changes. +3. Regresa a la pestaña de la aplicación en ejecución dentro de tu buscador y actualiza para ver los cambios. - {% octicon "light-bulb" aria-label="The lightbulb icon" %} If you've closed the tab, open the Ports panel and click the **Open in browser** icon for the running port. + {% octicon "light-bulb" aria-label="The lightbulb icon" %} Si has cerrado la pestaña, abre el panel Puertos y haz clic en el icono **Abrir en el explorador** del puerto en ejecución. - ![Port Forwarding Panel](/assets/images/help/codespaces/quickstart-forward-port.png) + ![Panel de reenvío de puertos](/assets/images/help/codespaces/quickstart-forward-port.png) -## Committing and pushing your changes +## Confirmar y subir tus cambios -Now that you've made a few changes, you can use the integrated terminal or the source view to publish your work to a new repository. +Ahora que has hecho algunos cambios, puedes usar el terminal integrado o la vista de código fuente para publicar tu trabajo en un nuevo repositorio. {% data reusables.codespaces.source-control-display-dark %} -1. To stage your changes, click **+** next to the `haikus.json` file, or next to **Changes** if you've changed multiple files and you want to stage them all. +1. Para agregar los cambios al "stage", haz clic en **+** junto al archivo `haikus.json` o junto a **Cambios** si has cambiado varios archivos y quieres agregarlos todos. - ![Source control side bar with staging button highlighted](/assets/images/help/codespaces/codespaces-commit-stage.png) + ![Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado](/assets/images/help/codespaces/codespaces-commit-stage.png) -2. To commit your staged changes, type a commit message describing the change you've made, then click **Commit**. +2. Para confirmar los cambios "staged", escribe un mensaje de confirmación que describa el cambio realizado y, después, haz clic en **Confirmar**. - ![Source control side bar with a commit message](/assets/images/help/codespaces/vscode-commit-button.png) + ![Barra de control de código fuente con un mensaje de confirmación](/assets/images/help/codespaces/vscode-commit-button.png) -3. Click **Publish Branch**. +3. Haz clic en **Publicar rama**. - ![Screenshot of the "Publish branch" button in VS Code](/assets/images/help/codespaces/vscode-publish-branch-button.png) + ![Captura de pantalla del botón "Publicar rama" en VS Code](/assets/images/help/codespaces/vscode-publish-branch-button.png) -4. In the "Repository Name" dropdown, type a name for your new repository, then select **Publish to {% data variables.product.company_short %} private repository** or **Publish to {% data variables.product.company_short %} public repository**. +4. En la lista desplegable "Nombre del repositorio", escribe un nombre para el nuevo repositorio y selecciona **Publicar en el repositorio privado de {% data variables.product.company_short %}** o **Publicar en el repositorio público de {% data variables.product.company_short %}** . - ![Screenshot of the "Repository Name" dropdown in VS Code](/assets/images/help/codespaces/choose-new-repository.png) + ![Captura de pantalla de la lista desplegable "Nombre del repositorio" en VS Code](/assets/images/help/codespaces/choose-new-repository.png) - The owner of the new repository will be the {% data variables.product.prodname_dotcom %} account with which you created the codespace. -5. In the pop-up that appears in the lower right corner of the editor, click **Open on {% data variables.product.company_short %}** to view the new repository on {% data variables.product.prodname_dotcom_the_website %}. In the new repository, view the `haikus.json` file and check that the change you made in your codespace has been successfully pushed to the repository. + El propietario del nuevo repositorio será la cuenta de {% data variables.product.prodname_dotcom %} con la que creaste el codespace. +5. En el elemento emergente que aparece en la esquina inferior derecha del editor, haz clic en **Abrir en {% data variables.product.company_short %}** para ver el nuevo repositorio en {% data variables.product.prodname_dotcom_the_website %}. En el nuevo repositorio, consulta el archivo `haikus.json` y comprueba que el cambio realizado en el codespace se haya enviado correctamente al repositorio. - ![Screenshot of the "Open in GitHub" pop-up in VS Code](/assets/images/help/codespaces/open-on-github.png) + ![Captura de pantalla del elemento emergente "Abrir en GitHub" en VS Code](/assets/images/help/codespaces/open-on-github.png) -## Personalizing with an extension +## Personalizar con una extensión -When you connect to a codespace using the browser, or the {% data variables.product.prodname_vscode %} desktop application, you can access the Visual Studio Code Marketplace directly from the editor. For this example, you'll install a {% data variables.product.prodname_vscode_shortname %} extension that alters the theme, but you can install any extension that's useful for your workflow. +Cuando te conectas a un codespace mediante el explorador o la aplicación de escritorio de {% data variables.product.prodname_vscode %}, puedes acceder a la Visual Studio Code Marketplace directamente desde el editor. En este ejemplo, instalarás una extensión {% data variables.product.prodname_vscode_shortname %} que alterará el tema, pero puedes instalar cualquier extensión que sea útil para tu flujo de trabajo. -1. In the left sidebar, click the Extensions icon. -1. In the search bar, type `fairyfloss` and click **Install**. +1. En la barra lateral, haz clic en el icono de extensiones. +1. En la barra de búsqueda, escribe `fairyfloss` y haz clic en **Instalar**. - ![Add an extension](/assets/images/help/codespaces/add-extension.png) + ![Agregar una extensión](/assets/images/help/codespaces/add-extension.png) -1. Select the `fairyfloss` theme by selecting it from the list. +1. Seleccione el tema `fairyfloss` en la lista. - ![Select the fairyfloss theme](/assets/images/help/codespaces/fairyfloss.png) + ![Seleccionar el tema de fairyfloss](/assets/images/help/codespaces/fairyfloss.png) -If you are using a codespace in the browser, or in the {% data variables.product.prodname_vscode %} desktop application, and you have [Settings Sync](https://code.visualstudio.com/docs/editor/settings-sync) turned on, any changes you make to your editor setup in the current codespace, such as changing your theme or keyboard bindings, are automatically synced to any instances of {% data variables.product.prodname_vscode %} that are signed into your {% data variables.product.prodname_dotcom %} account and to any other codespaces you create. +Si estás usando un codespace en el explorador o en la aplicación de escritorio de {% data variables.product.prodname_vscode %} y has activado[ Sincronización de ajustes](https://code.visualstudio.com/docs/editor/settings-sync), cualquier cambio que realices en la configuración del editor en el codespace actual, como cambiar el tema o los enlaces de teclado, se sincroniza automáticamente con cualquier instancia de {% data variables.product.prodname_vscode %} que esté registrada en tu cuenta de {% data variables.product.prodname_dotcom %} y con cualquier otro codespace que crees. -## Next steps +## Pasos siguientes -You've successfully created, personalized, and run your first application within a codespace but there's so much more to explore! Here are some helpful resources for taking your next steps with {% data variables.product.prodname_github_codespaces %}. +Creaste, personalizaste y ejecutaste exitosamente tu primer aplicación dentro de un codespace, pero ¡hay mucho más que explorar! Estos son algunos recursos útiles para que completes los siguientes pasos con {% data variables.product.prodname_github_codespaces %}. -* "[Deep dive](/codespaces/getting-started/deep-dive)": This quickstart presented some of the features of {% data variables.product.prodname_github_codespaces %}. The deep dive looks at these areas from a technical standpoint. -* "[Add a dev container configuration to your repository](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)": These guides provide information on setting up your repository to use {% data variables.product.prodname_github_codespaces %} with specific languages. -* "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)": This guide provides details on creating a custom configuration for {% data variables.product.prodname_codespaces %} for your project. +* "[Análisis en profundidad](/codespaces/getting-started/deep-dive)": en este inicio rápido se presentan algunas de las características de {% data variables.product.prodname_github_codespaces %}. La guía a fondo ve estas áreas desde un punto de vista técnico. +* "[Adición de una configuración de contenedor de desarrollo al repositorio](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)": estas guías proporcionan información sobre cómo configurar tu repositorio para usar {% data variables.product.prodname_github_codespaces %} con idiomas específicos. +* "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)": en esta guía se proporcionan detalles sobre cómo crear una configuración personalizada de {% data variables.product.prodname_codespaces %} para el proyecto. -## Further reading +## Información adicional -* "[Enabling {% data variables.product.prodname_github_codespaces %} for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)" -* "[Using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)" -* "[Using {% data variables.product.prodname_github_codespaces %} in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)" -* "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli)" -* "[Setting your default editor for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)." -* "[Managing the cost of {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization)" +* "[Habilitación de {% data variables.product.prodname_github_codespaces %} en la organización](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)" +* "[Uso de {% data variables.product.prodname_github_codespaces %} en {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)" +* "[Uso de {% data variables.product.prodname_github_codespaces %} en el IDE de JetBrains](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)" +* "[Uso de {% data variables.product.prodname_github_codespaces %} con la {% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli)" +* "[Configuración del editor predeterminado para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)" +* "[Administración del costo para {% data variables.product.prodname_github_codespaces %} en la organización](/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization)" diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/index.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/index.md index 05bf754d62..8e641bc5f1 100644 --- a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/index.md +++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/index.md @@ -1,8 +1,8 @@ --- -title: Managing GitHub Codespaces for your organization +title: Administración de GitHub Codespaces en una organización allowTitleToDifferFromFilename: true shortTitle: Managing your organization -intro: 'You can manage and review how users in your organization can use {% data variables.product.prodname_github_codespaces %}.' +intro: 'Puedes administrar y revisar la forma en que los usuarios de tu organización pueden utilizar {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -20,5 +20,11 @@ children: - /restricting-the-visibility-of-forwarded-ports - /restricting-the-idle-timeout-period - /restricting-the-retention-period-for-codespaces +ms.openlocfilehash: 7b8b9211a8bcafdcfb3fb2b037ea6362e8ecb27f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158641' --- - + diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md index 639cc2acac..bbed7dc0ac 100644 --- a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md +++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md @@ -1,7 +1,7 @@ --- -title: Managing repository access for your organization's codespaces +title: Administrar el acceso de los codespaces de tu organización a los repositorios shortTitle: Repository access -intro: 'You can manage the repositories in your organization that {% data variables.product.prodname_github_codespaces %} can access.' +intro: 'Puedes administrar los repositorios de tu organización a los cuales pueden acceder a {% data variables.product.prodname_github_codespaces %}.' permissions: 'To manage access and security for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner.' versions: fpt: '*' @@ -15,26 +15,29 @@ redirect_from: - /codespaces/managing-codespaces-for-your-organization/managing-access-and-security-for-your-organizations-codespaces - /github/developing-online-with-codespaces/managing-access-and-security-for-codespaces - /codespaces/working-with-your-codespace/managing-access-and-security-for-codespaces +ms.openlocfilehash: 9fdec24104a61170977053195446db0b4cf0a62f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160344' --- - {% warning %} -**Deprecation note**: The access and security setting described below is now deprecated and is documented here for reference only. To enable expanded access to other repositories, add the requested permissions to your `devcontainer.json` configuration file. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)." +**Nota de desuso**: La configuración de acceso y seguridad que se describe a continuación está en desuso y se documentada aquí solo como referencia. Para habilitar el acceso expandido a otros repositorios, agrega los permisos solicitados al archivo de configuración `devcontainer.json`. Para obtener más información, consulta "[Administración del acceso a otros repositorios del codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)". {% endwarning %} -By default, a codespace can only access the repository where it was created. When you enable access and security for a repository owned by your organization, any codespaces that are created for that repository will also have read permissions to all other repositories the organization owns and the codespace creator has permissions to access. If you want to restrict the repositories a codespace can access, you can limit it to either the repository where the codespace was created, or to specific repositories. You should only enable access and security for repositories you trust. +Predeterminadamente, un codespace solo puede acceer al repositorio en donde se creó. Cuando habilitas el acceso y la seguridad de un repositorio que pertenece a tu organización, cualquier codespace que se cree para dicho repositorio también tendrá permisos de lectura en el resto de los repositorios que pertenezcan a esa misma organización y a los cuales pueda acceder el creador de dicho codespace. Si quieres restringir los repositorios a los cuales puede acceder un codespace, puedes limitarlos a ya sea el repositorio en donde se creó el codespace o a algunos repositorios específicos. Solo debes habilitar el acceso y la seguridad para los repositorios en los cuales confíes. -To manage which users in your organization can use {% data variables.product.prodname_github_codespaces %}, see "[Enabling {% data variables.product.prodname_github_codespaces %} for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#enable-codespaces-for-users-in-your-organization)." +Para administrar qué usuarios de tu organización pueden usar {% data variables.product.prodname_github_codespaces %}, consulta "[Habilitación de {% data variables.product.prodname_github_codespaces %} en la organización](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#enable-codespaces-for-users-in-your-organization)". -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.organizations.click-codespaces %} -1. Under "Access and security", select the setting you want for your organization. - ![Radio buttons to manage trusted repositories](/assets/images/help/settings/codespaces-org-access-and-security-radio-buttons.png) -1. If you chose "Selected repositories", select the dropdown menu, then click a repository to allow the repository's codespaces to access other repositories owned by your organization. Repeat for all repositories whose codespaces you want to access other repositories. - !["Selected repositories" dropdown menu](/assets/images/help/settings/codespaces-access-and-security-repository-drop-down.png) +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.click-codespaces %} +1. Debajo de "Acceso y seguridad", selecciona la configuración que quieras para tu organización. + ![Botones de radio para administrar los repositorios de confianza](/assets/images/help/settings/codespaces-org-access-and-security-radio-buttons.png) +1. Si eliges "Repositorios seleccionados", selecciona el menú desplegable y haz clic en un repositorio para permitir que los codespaces de este accedan al resto de los repositorios que pertenecen a la organización. Repite esto para todos los repositorios cuyos codespaces quieras que accedan al resto de los repositorios. + ![Menú desplegable "Repositorios seleccionados"](/assets/images/help/settings/codespaces-access-and-security-repository-drop-down.png) -## Further reading +## Información adicional -- "[Managing repository access for your codespaces](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)" +- "[Administración del acceso a los repositorios para los codespaces](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)" diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md new file mode 100644 index 0000000000..216c4dd2ff --- /dev/null +++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md @@ -0,0 +1,75 @@ +--- +title: Administración del costo de GitHub Codespaces en la organización +shortTitle: Manage Codespaces costs +intro: 'Puedes comprobar el uso de {% data variables.product.prodname_github_codespaces %} y configurar los límites de uso.' +permissions: 'To manage billing for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner or a billing manager.' +versions: + fpt: '*' + ghec: '*' +type: reference +topics: + - Codespaces + - Billing +redirect_from: + - /codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization + - /codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization +ms.openlocfilehash: f11c6e22fa8a233fd4429b91390d25471ad17e6d +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158713' +--- +## Información general + +Se factura a tu organización según su uso de proceso y almacenamiento de {% data variables.product.prodname_github_codespaces %}. En este artículo se explican las formas en que puedes administrar estos costos, como propietario de la organización. + +Para obtener información sobre los precios de {% data variables.product.prodname_github_codespaces %}, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)". + +## Límites de gasto + +Puedes establecer un límite de gasto de {% data variables.product.prodname_github_codespaces %} para tu organización. Este límite se aplica al costo total de proceso y almacenamiento de {% data variables.product.prodname_github_codespaces %}. Para más información, consulta "[Administración de los límites de gasto para {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces)". + +- **Uso de proceso:** este es el tiempo total durante el que todas las instancias de {% data variables.product.prodname_github_codespaces %} (llamadas "codespaces") han estado activas en un mes de facturación. + +- **Uso de almacenamiento:** con fines de facturación de {% data variables.product.prodname_github_codespaces %}, esto incluye todos los archivos que usan todos los codespaces y las precompilaciones de la cuenta. Esto incluye todos los recursos, tales como los repositorios clonados, archivos de configuración y extensiones, entre otros. + +Puedes comprobar el uso de proceso y almacenamiento de {% data variables.product.prodname_github_codespaces %} para el mes de facturación actual. Para más información, consulta "[Visualización del uso de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)". + +{% note %} + +**Nota:** Los precompilaciones de {% data variables.product.prodname_github_codespaces %} se crean y actualizan mediante {% data variables.product.prodname_actions %}. Esto puede conllevar costos facturables de {% data variables.product.prodname_actions %}. Puedes configurar un límite de gasto para {% data variables.product.prodname_actions %}. Para obtener más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-codespaces-prebuilds)" y "[Administración del límite de gasto para {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)". El almacenamiento de las precompilaciones generadas se cobra a la misma tarifa que los codespaces y se incluye en tu límite de gasto de {% data variables.product.prodname_github_codespaces %}. + +{% endnote %} + +## Inhabilitar o limitar los {% data variables.product.prodname_codespaces %} + +Puedes deshabilitar todo el uso de {% data variables.product.prodname_github_codespaces %} que se facturarían a tu organización. También puedes especificar qué miembros o colaboradores de la organización pueden usar {% data variables.product.prodname_codespaces %} con cargo a la organización. Para más información, consulta ["Habilitación de {% data variables.product.prodname_github_codespaces %} para la organización](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)". + +{% data reusables.codespaces.codespaces-disabling-org-billing %} + +Puedes configurar a qué repositorios se puede acceder desde codespaces creados para un repositorio determinado. Para obtener más información, consulta "[Administración del acceso a otros repositorios del codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)". + +Puedes limitar la elección de tipos de máquina que se encuentra disponible para los codespaces creados a partir de repositorios que pertenecen a tu organización. Esto te permite prevenir que las personas utilicen máquinas con recursos excesivos para sus codespaces e incurrir en cargos innecesarios. Para obtener más información, consulte "[Restringir el acceso a los tipos de máquina](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)". + +Puedes establecer una restricción de tiempo de espera de inactividad máximo para limitar el tiempo de espera máximo que los usuarios pueden establecer para los codespaces facturables a tu organización. Esto puede reducir los cargos por el uso de proceso que generan los codespaces que continúan ejecutándose en un estado inactivo, deteniendo el codespace activo después de un tiempo de espera más corto. Para obtener más información, consulta "[Restricción del periodo de tiempo de espera de inactividad](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)". + +También puedes restringir cuánto tiempo pueden permanecer sin usar los codespaces detenidos antes de que se eliminen automáticamente. Esto puede ayudar a reducir los costos de almacenamiento de {% data variables.product.prodname_codespaces %}. Para obtener más información, consulta "[Restringir el período de retención para los codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)". + +Los propietarios de repositorios que configuran precompilaciones para su repositorio pueden reducir los costos de almacenamiento de dichas precompilaciones configurándolas para que solo se puedan crear en determinadas regiones. Para obtener más información, consulta "[Configuración de precompilaciones](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)". + +## Borrar los codespaces sin utilizar + +Los usuarios pueden eliminar manualmente sus propios codespaces en https://github.com/codespaces y desde {% data variables.product.prodname_vscode %}. Para reducir el tamaño de un codespace, los usuarios pueden eliminar manualmente archivos mediante el terminal o desde {% data variables.product.prodname_vscode_shortname %}. + +Como propietario de la organización, puede eliminar cualquier codespace de la organización. Para más información, vea "[Eliminación de un codespace](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)". + +{% note %} + +**Nota:** Los codespaces se eliminan automáticamente una vez detenidos y permanecen inactivos durante un número de días definible por el usuario. Para más información, consulta "[Configuración de la eliminación automática de los codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)". Como propietario de una organización, puedes establecer un período de retención máximo para los codespaces que pertenezcan a tu organización. Esto invalidará la configuración de retención personal de un usuario. Para obtener más información, consulta "[Restringir el período de retención para los codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)". + +{% endnote %} + +## Información adicional + +- "[Enumeración de codespaces en la organización](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)" diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md index 6d19604ad4..36792903a3 100644 --- a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md +++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md @@ -1,7 +1,7 @@ --- -title: Restricting access to machine types +title: Restringir el acceso a los tipos de máquina shortTitle: Restrict machine types -intro: You can set constraints on the types of machines users can choose when they create codespaces in your organization. +intro: Puedes configurar restricciones sobre los tipos de máquina que los usuarios pueden elegir cuando crean codespaces en la organización. permissions: 'To manage access to machine types for the repositories in an organization, you must be an owner of the organization.' versions: fpt: '*' @@ -9,82 +9,85 @@ versions: type: how_to topics: - Codespaces +ms.openlocfilehash: 202a2cf9f28a55514450415230686c0c0e94600f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159161' --- +## Información general -## Overview +Habitualmente, cuando creas un codespace, se te ofrece una selección de especificaciones para la máquina que lo ejecutará. Puedes elegir el tipo de máquina que se acople mejor a tus necesidades. Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)". -Typically, when you create a codespace you are offered a choice of specifications for the machine that will run your codespace. You can choose the machine type that best suits your needs. 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)." +Si pagas por utilizar {% data variables.product.prodname_github_codespaces %}, entonces tu elección de tipo de máquina afectará cuánto se te factura. El coste del proceso de un codespace es proporcional al número de núcleos de procesador del tipo de máquina que elijas. Por ejemplo, el coste del proceso de usar un codespace durante una hora en una máquina de 16 núcleos es ocho veces mayor que en una máquina de dos núcleos. Para más información sobre los precios, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". -If you pay for using {% data variables.product.prodname_github_codespaces %} then your choice of machine type will affect how much your are billed. The compute cost for a codespace is proportional to the number of processor cores in the machine type you choose. For example, the compute cost of using a codespace for an hour on a 16-core machine is eight times greater than a 2-core machine. For more information about pricing, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." +Como propietario de organización, podrías querer configurar restricciones en los tipos de máquina que están disponibles. Por ejemplo, si el trabajo en tu organización no requiere de una potencia de cómputo o espacio de almacenamiento significativos, puedes eliminar las máquinas con muchos recursos de la lista de opciones que las personas pueden elegir. Para ello, define una o más políticas en la configuración de {% data variables.product.prodname_github_codespaces %} de la organización. -As an organization owner, you may want to configure constraints on the types of machine that are available. For example, if the work in your organization doesn't require significant compute power or storage space, you can remove the highly resourced machines from the list of options that people can choose from. You do this by defining one or more policies in the {% data variables.product.prodname_github_codespaces %} settings for your organization. +### Comportamiento cuando configuras una restricción de tipo de máquina -### Behavior when you set a machine type constraint +Si hay espacios de codespaces que ya no se ajustan a una directiva definida, estos codespaces seguirán funcionando hasta que se detengan o agoten el tiempo de espera. Cuando el usuario intenta reanudar el codespace, se muestra un mensaje que le indica que el tipo de máquina seleccionado actualmente ya no está permitido para esta organización y le pide que elija un tipo de máquina alternativo. -If there are existing codespaces that no longer conform to a policy you have defined, these codespaces will continue to operate until they are stopped or time out. When the user attempts to resume the codespace they are shown a message telling them that the currenly selected machine type is no longer allowed for this organization and prompting them to choose an alternative machine type. - -If you remove higher specification machine types that are required by the {% data variables.product.prodname_github_codespaces %} configuration for an individual repository in your organization, then it won't be possible to create a codespace for that repository. When someone attempts to create a codespace they will see a message telling them that there are no valid machine types available that meet the requirements of the repository's {% data variables.product.prodname_github_codespaces %} configuration. +Si eliminas tipos de máquina con especificaciones más altas que la configuración de {% data variables.product.prodname_github_codespaces %} requiere para un repositorio individual de tu organización, no se podrá crear un codespace en dicho repositorio. Cuando alguien intente crear un codespace, verá un mensaje que indica que no hay tipos de máquina válidos disponibles que cumplan los requisitos de la configuración de {% data variables.product.prodname_github_codespaces %} del repositorio. {% note %} -**Note**: Anyone who can edit the `devcontainer.json` configuration file in a repository can set a minimum specification for machines that can be used for codespaces for that repository. For more information, see "[Setting a minimum specification for codespace machines](/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines)." +**Nota**: Cualquiera que pueda editar el archivo de configuración `devcontainer.json` en un repositorio puede establecer una especificación mínima para las máquinas que se pueden usar para los codespaces. Para obtener más información, consulte "[Configurar una especificación mínima para las máquinas de los codespaces](/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines)". {% endnote %} -If setting a policy for machine types prevents people from using {% data variables.product.prodname_github_codespaces %} for a particular repository there are two options: +Si el hecho de configurar una política para los tipos de máquina impide el uso de {% data variables.product.prodname_github_codespaces %} para un repositorio en particular, hay dos opciones: -* You can adjust your policies to specifically remove the restrictions from the affected repository. -* Anyone who has a codespace that they can no longer access, because of the new policy, can export their codespace to a branch. This branch will contain all of their changes from the codespace. They can then open a new codespace on this branch with a compliant machine type or work on this branch locally. For more information, see "[Exporting changes to a branch](/codespaces/troubleshooting/exporting-changes-to-a-branch)." +* Puedes ajustar tus políticas para que eliminen específicamente las restricciones del repositorio afectado. +* Cualquiera que tenga un codespace al cuál ya no puedan acceder debido a la política nueva puede exportar su codespace a una rama. Esta rama contendrá todos los cambios de su codespace. Pueden abrir un codespace nuevo en esta rama con un tipo de máquina compatible o trabajar en ella localmente. Para obtener más información, consulte "[Exportación de cambios a una rama](/codespaces/troubleshooting/exporting-changes-to-a-branch)". -### Setting organization-wide and repository-specific policies +### Configurar políticas específicas para los repositorios y a lo largo de la organización -When you create a policy you choose whether it applies to all repositories in your organization, or only to specified repositories. If you set an organization-wide policy then any policies you set for individual repositories must fall within the restriction set at the organization level. Adding policies makes the choice of machine more, not less, restrictive. +Cuando creas una política, eliges si esta aplica a todos los repositorios de tu organización o solo a algunos específicos. Si configuras una política a lo largo de la organización, entonces cualquier política que configures para los repositorios individuales debe de caer dentro de las restricciones que se configuraron a nivel organizacional. El agregar políticas hace que la elección de máquinas sea más restrictiva, no menos. -For example, you could create an organization-wide policy that restricts the machine types to either 2 or 4 cores. You can then set a policy for Repository A that restricts it to just 2-core machines. Setting a policy for Repository A that restricted it to machines with 2, 4, or 8 cores would result in a choice of 2-core and 4-core machines only, because the organization-wide policy prevents access to 8-core machines. +Por ejemplo, podrías crear una política en toda la organización, la cual restrinja los tipos de máquina a aquellos de 2 o 4 núcleos. Entonces podrás configurar una política para el repositorio "A" que lo restrinja a máquinas de 2 núcleos. El configurar una política para un repositorio "A", la cual lo restrinja a máquinas de 2, 4 u 8 núcleos, daría como resultado una elección de solo máquinas de 2 y 4 núcleos, ya que la política organizacional previene el acceso a máquinas de 8 núcleos. -If you add an organization-wide policy, you should set it to the largest choice of machine types that will be available for any repository in your organization. You can then add repository-specific policies to further restrict the choice. +Si agregas una política a nivel organizacional, deberías configurarla en la elección de tipos de máquina más grande que deberá estar disponible para cualquier repositorio de tu organización. Entonces podrás agregar las políticas específicas para los repositorios y así restringir aún más la elección. {% data reusables.codespaces.codespaces-org-policies-note %} -## Adding a policy to limit the available machine types +## Agregar una política para limitar los tipos de máquina disponibles -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.codespaces.codespaces-org-policies %} -1. Click **Add constraint** and choose **Machine types**. +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.codespaces.codespaces-org-policies %} +1. Haga clic en **Add constraint** y elija **Machine types**. - ![Screenshot of the 'Add constraint' dropdown menu](/assets/images/help/codespaces/add-constraint-dropdown.png) + ![Captura de pantalla del menú desplegable "Agregar restricción"](/assets/images/help/codespaces/add-constraint-dropdown.png) -1. Click {% octicon "pencil" aria-label="The edit icon" %} to edit the constraint, then clear the selection of any machine types that you don't want to be available. +1. Haz clic en {% octicon "pencil" aria-label="The edit icon" %} para editar la restricción y luego borra la selección de cualquier tipo de máquina que no quieras que estén disponibles. - ![Screenshot of the pencil icon for editing the constraint](/assets/images/help/codespaces/edit-machine-constraint.png) + ![Captura de pantalla del icono de lápiz para editar la restricción](/assets/images/help/codespaces/edit-machine-constraint.png) {% data reusables.codespaces.codespaces-policy-targets %} -1. If you want to add another constraint to the policy, click **Add constraint** and choose another constraint. For information about other constraints, see: - * "[Restricting the base image for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces)" - * "[Restricting the visibility of forwarded ports](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)" - * "[Restricting the idle timeout period](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)" - * "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)" -1. After you've finished adding constraints to your policy, click **Save**. +1. Si quieres agregar otra restricción a la directiva, haz clic en **Agregar restricción** y elige otra restricción. Para obtener información sobre otras restricciones, consulta: + * "[Restricción de la imagen base para codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces)" + * "[Restricción de la visibilidad de los puertos reenviados](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)" + * "[Restricción del período de tiempo de espera de inactividad](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)" + * "[Restricción del período de retención para codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)" +1. Cuando hayas terminado de agregar restricciones a la directiva, haz clic en **Guardar**. -The policy will be applied to all new codespaces that are billable to your organization. The machine type constraint is also applied to existing codespaces when someone attempts to restart a stopped codespace or reconnect to an active codespace. +La directiva se aplicará a todos los codespaces nuevos que se facturen a tu organización. La restricción de tipo de máquina también se aplica a los codespaces existentes cuando alguien intenta reiniciar un codespace detenido o volver a conectarse a un codespace activo. -## Editing a policy +## Editar una política -You can edit an existing policy. For example, you may want to add or remove constraints to or from a policy. +Puedes editar una directiva existente. Por ejemplo, puede que te interese agregar restricciones a una directiva o quitarlas. -1. Display the "Codespace policies" page. For more information, see "[Adding a policy to limit the available machine types](#adding-a-policy-to-limit-the-available-machine-types)." -1. Click the name of the policy you want to edit. -1. Click the pencil icon ({% octicon "pencil" aria-label="The edit icon" %}) beside the "Machine types" constraint. -1. Make the required changes then click **Save**. +1. Muestra la página de "Políticas del Codespace". Para obtener más información, consulte "[Agregar una política para limitar los tipos de máquina disponibles](#adding-a-policy-to-limit-the-available-machine-types)". +1. Haz clic en el nombre de la política que quieres editar. +1. Haz clic en el icono de lápiz ({% octicon "pencil" aria-label="The edit icon" %}) situado junto a la restricción "Tipos de máquina". +1. Realice los cambios necesarios y haga clic en **Save**. -## Deleting a policy +## Borrar una política -1. Display the "Codespace policies" page. For more information, see "[Adding a policy to limit the available machine types](#adding-a-policy-to-limit-the-available-machine-types)." -1. Click the delete button to the right of the policy you want to delete. +1. Muestra la página de "Políticas del Codespace". Para obtener más información, consulte "[Agregar una política para limitar los tipos de máquina disponibles](#adding-a-policy-to-limit-the-available-machine-types)". +1. Haz clic en el botón de borrar a la derecha de la política que quieras borrar. - ![Screenshot of the delete button for a policy](/assets/images/help/codespaces/policy-delete.png) + ![Captura de pantalla del botón de eliminación de una directiva](/assets/images/help/codespaces/policy-delete.png) -## Further reading +## Información adicional -- "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces)" +- "[Administración de límites de gasto para {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces)" diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces.md new file mode 100644 index 0000000000..c1647b5c6f --- /dev/null +++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces.md @@ -0,0 +1,103 @@ +--- +title: Restricción de la imagen base para codespaces +shortTitle: Restrict base image +intro: Puedes especificar qué imágenes base se pueden usar para los nuevos codespaces creados en tu organización. +permissions: 'To manage image constraints for an organization''s codespaces, you must be an owner of the organization.' +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces +ms.openlocfilehash: 1da438a680dd3e60c1deeec46a98fbcf48f84e5b +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159001' +--- +## Información general + +Al crear un codespace, se crea automáticamente un contenedor Docker en una máquina virtual remota. El contenedor Docker se crea a partir de una imagen de Docker. La imagen es básicamente una plantilla para los contenedores Docker y determina muchos aspectos del entorno resultante proporcionado por el codespace. + +Puedes elegir qué imagen quieres usar para tus codespaces especificándola en la configuración del contenedor de desarrollo de un repositorio. Puedes hacerlo, por ejemplo, mediante la propiedad `image` del archivo `devcontainer.json`. + +```json{:copy} +"image": "mcr.microsoft.com/vscode/devcontainers/javascript-node:18", +``` + +Para obtener más información, consulta la [especificación de contenedores de desarrollo](https://containers.dev/implementors/json_reference/) en containers.dev. + +Si no especificas una imagen en la configuración del contenedor de desarrollo de un repositorio, se usa la imagen predeterminada. La imagen predeterminada contiene una serie de versiones en tiempo de ejecución de lenguajes populares y herramientas de uso frecuente. Para obtener más información, consulte "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#using-the-default-dev-container-configuration)". + +Como propietario de la organización, puedes agregar una directiva para restringir qué imágenes se pueden usar para los codespaces creados en tu organización. + +Si la imagen especificada en la configuración del contenedor de desarrollo no coincide con una de las imágenes permitidas, se muestra el siguiente mensaje cuando alguien intenta crear un codespace para el repositorio: + +> No se puede crear el codespace: la imagen base "DETALLES DE LA CONFIGURACIÓN DEL CONTENEDOR DE DESARROLLO" no está permitida de acuerdo con una directiva de la organización establecida por el administrador de tu organización. + +{% note %} + +**Notas**: +* La directiva de imagen base solo se aplica cuando se crea un codespace. Actualmente no se aplica cuando se recompila un contenedor. Esto se modificará en una versión futura. Para obtener más información, consulta "[Ciclo de vida de un codespace](/codespaces/developing-in-codespaces/the-codespace-lifecycle#rebuilding-a-codespace)". +* La directiva de imagen base no se aplica a la imagen predeterminada ni a la imagen que se usa para recuperar un codespace si se introduce un error en la configuración de un contenedor de desarrollo que impide que se recompile el contenedor. + +{% endnote %} + +### Configurar políticas específicas para los repositorios y a lo largo de la organización + +Cuando creas una política, eliges si esta aplica a todos los repositorios de tu organización o solo a algunos específicos. Si configuras una política a lo largo de la organización, entonces cualquier política que configures para los repositorios individuales debe de caer dentro de las restricciones que se configuraron a nivel organizacional. La adición de directivas hace que la elección de imágenes sea más restrictiva, no menos. + +Por ejemplo, podrías crear una directiva para toda la organización que restrinja la imagen base a una de las 10 imágenes especificadas. Después, puedes establecer una directiva para el repositorio A que restrinja la imagen a un subconjunto compuesto por tan solo dos de las imágenes especificadas a nivel de la organización. Especificar imágenes adicionales para el repositorio A no tendrá ningún efecto, porque estas imágenes no están especificadas en la directiva para toda la organización. Si agregas una directiva a nivel organizacional, deberás establecerla en la mayor selección de imágenes que estará disponible para cualquier repositorio de tu organización. Entonces podrás agregar las políticas específicas para los repositorios y así restringir aún más la elección. + +{% data reusables.codespaces.codespaces-org-policies-note %} + +## Adición de una directiva para definir las imágenes permitidas + +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.codespaces.codespaces-org-policies %} +1. Haz clic en **Agregar restricción** y elige **Imágenes base**. + + ![Captura de pantalla del menú desplegable "Agregar restricción"](/assets/images/help/codespaces/add-constraint-dropdown-image.png) + +1. Haz clic en {% octicon "pencil" aria-label="The edit icon" %} para editar la restricción. + + ![Captura de pantalla del icono de lápiz para editar la restricción](/assets/images/help/codespaces/edit-image-constraint.png) + +1. En el campo "Valores permitidos", escribe la dirección URL completa de una imagen que quieras permitir. + + ![Captura de pantalla de una entrada en el campo "Valores permitidos"](/assets/images/help/codespaces/image-allowed-values.png) + + {% note %} + + **Nota:** Debes especificar una URL de imagen que coincida exactamente con el valor especificado en una configuración de contenedor de desarrollo. + + {% endnote %} + +1. Haz clic el botón más ({% octicon "plus" aria-label="The plus icon" %}) para agregar el valor. +1. Si es necesario, repite los dos pasos anteriores para agregar más direcciones URL de imágenes. +{% data reusables.codespaces.codespaces-policy-targets %} +1. Si quieres agregar otra restricción a la directiva, haz clic en **Agregar restricción** y elige otra restricción. Para obtener información sobre otras restricciones, consulta: + * "[Restricción del acceso a los tipos de máquina](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" + * "[Restricción de la visibilidad de los puertos reenviados](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)" + * "[Restricción del período de tiempo de espera de inactividad](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)" + * "[Restricción del período de retención para codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)" +1. Cuando hayas terminado de agregar restricciones a la directiva, haz clic en **Guardar**. + +La directiva se aplica cuando alguien intenta crear un nuevo codespace que se puede facturar a tu organización. La restricción de la imagen base no afecta a los codespaces existentes, ya estén activos o detenidos. + +## Editar una política + +Puedes editar una directiva existente. Por ejemplo, puede que te interese agregar restricciones a una directiva o quitarlas. + +1. Muestra la página de "Políticas del Codespace". Para obtener más información, consulta "[Adición de una directiva para definir las imágenes permitidas](#adding-a-policy-to-define-the-allowed-images)". +1. Haz clic en el nombre de la política que quieres editar. +1. Haz clic en el icono de lápiz ({% octicon "pencil" aria-label="The edit icon" %}) situado junto a la restricción "Imágenes base". +1. Agrega o quita direcciones URL de imágenes. +1. Haga clic en **Save**(Guardar). + +## Borrar una política + +1. Muestra la página de "Políticas del Codespace". Para obtener más información, consulta "[Adición de una directiva para definir las imágenes permitidas](#adding-a-policy-to-define-the-allowed-images)". +1. Haz clic en el botón de borrar a la derecha de la política que quieras borrar. + + ![Captura de pantalla del botón de eliminación de una directiva](/assets/images/help/codespaces/policy-delete.png) diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md index 28aec3606f..84021c65b3 100644 --- a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md +++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md @@ -1,7 +1,7 @@ --- -title: Restricting the idle timeout period +title: Restricción del período de tiempo de espera de inactividad shortTitle: Restrict timeout periods -intro: You can set a maximum timeout period for any codespaces owned by your organization. +intro: Puedes establecer un período de tiempo de espera máximo para cualquier codespace propiedad de tu organización. permissions: 'To manage timeout constraints for an organization''s codespaces, you must be an owner of the organization.' versions: fpt: '*' @@ -9,77 +9,80 @@ versions: type: how_to topics: - Codespaces +ms.openlocfilehash: b07d1834078b065eee89acdb84e0e80a2db1e8a6 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158993' --- +## Información general -## Overview +De forma predeterminada, el tiempo de espera de los codespaces se agota al cabo de 30 minutos de inactividad. Cuando se agota el tiempo de espera de un codespace, ya no incurrirá en cargos por el uso de procesos. -By default, codespaces time out after 30 minutes of inactivity. When a codespace times out it is stopped and will no longer incur charges for compute usage. +La configuración personal de un usuario de {% data variables.product.prodname_dotcom %} le permite definir su propio período de tiempo de espera para los codespaces que cree. Podría ser superior al período predeterminado de 30 minutos. Para más información, consulta "[Configuración del período de tiempo de espera para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)." -The personal settings of a {% data variables.product.prodname_dotcom %} user allow them to define their own timeout period for codespaces they create. This may be longer than the default 30-minute period. For more information, see "[Setting your timeout period for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)." - -As an organization owner, you may want to configure constraints on the maximum idle timeout period for codespaces created for repositories owned by your organization. This can help you to limit costs associated with codespaces that are left to timeout after long periods of inactivity. You can set a maximum timeout for the codespaces for all repositories owned by your organization, or for the codespaces of specific repositories. +Como propietario de la organización, es posible que te interese configurar restricciones sobre el período máximo de tiempo de espera de inactividad de los codespaces creados para los repositorios propiedad de la organización. Esto puede ayudarte a limitar los costos asociados a los codespaces que se dejan que agoten el tiempo de espera tras largos períodos de inactividad. Puedes establecer un tiempo de espera máximo para los codespaces de todos los repositorios propiedad de la organización o para los codespaces de repositorios específicos. {% note %} -**Note**: Maximum idle timeout constraints only apply to codespaces that are owned by your organization. +**Nota**: Las restricciones del tiempo de espera máximo de inactividad solo se aplican a los codespaces que pertenecen a la organización. {% endnote %} -For more information about pricing for {% data variables.product.prodname_github_codespaces %} compute usage, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)." +Para más información sobre los precios de uso de proceso de {% data variables.product.prodname_github_codespaces %}, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)". -### Behavior when you set a maximum idle timeout constraint +### Comportamiento al establecer una restricción del tiempo de espera máximo de inactividad -If someone sets the default idle timeout to 90 minutes in their personal settings and they then start a codespace for a repository with a maximum idle timeout constraint of 60 minutes, the codespace will time out after 60 minutes of inactivity. When codespace creation completes, a message explaining this will be displayed: +Si una persona establece el tiempo de espera de inactividad predeterminado en 90 minutos en su configuración personal y, luego, inicia un codespace para un repositorio con una restricción del tiempo de espera máximo de inactividad de 60 minutos, el tiempo de espera del codespace se agotará al cabo de 60 minutos de inactividad. Cuando se complete la creación del codespace, se mostrará un mensaje con la información siguiente: -> Idle timeout for this codespace is set to 60 minutes in compliance with your organization’s policy. +> El tiempo de espera de inactividad de este codespace está establecido en 60 minutos de conformidad con la directiva de la organización. -### Setting organization-wide and repository-specific policies +### Configurar políticas específicas para los repositorios y a lo largo de la organización -When you create a policy, you choose whether it applies to all repositories in your organization, or only to specified repositories. If you create an organization-wide policy with a timeout constraint, then the timeout constraints in any policies that are targeted at specific repositories must fall within the restriction configured for the entire organization. The shortest timeout period - in an organization-wide policy, a policy targeted at specified repositories, or in someone's personal settings - is applied. +Cuando crees una política, decide si se aplica a todos los repositorios de la organización o solo a algunos específicos. Si creas una directiva para toda la organización con una restricción del tiempo de espera, las restricciones de tiempo de espera de las directivas destinadas a repositorios específicos deben encontrarse dentro de la restricción configurada para toda la organización. Se aplicará el período de tiempo de espera más corto (en una directiva de toda la organización, en una directiva destinada a repositorios específicos o en la configuración personal de un usuario). -If you add an organization-wide policy with a timeout constraint, you should set the timeout to the longest acceptable period. You can then add separate policies that set the maximum timeout to a shorter period for specific repositories in your organization. +Si agregas una directiva para toda la organización con una restricción del tiempo de espera, debes establecer el tiempo de espera en el período más largo que sea aceptable. Después, puedes agregar directivas independientes que establezcan el tiempo de espera máximo en un período más corto para repositorios específicos de la organización. {% data reusables.codespaces.codespaces-org-policies-note %} -## Adding a policy to set a maximum idle timeout period +## Adición de una directiva para establecer el período de tiempo de espera máximo de inactividad -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.codespaces.codespaces-org-policies %} -1. Click **Add constraint** and choose **Maximum idle timeout**. +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.codespaces.codespaces-org-policies %} +1. Haz clic en **Agregar restricción** y selecciona **Tiempo de espera máximo de inactividad**. - ![Screenshot of the 'Add constraint' dropdown menu](/assets/images/help/codespaces/add-constraint-dropdown-timeout.png) + ![Captura de pantalla del menú desplegable "Agregar restricción"](/assets/images/help/codespaces/add-constraint-dropdown-timeout.png) -1. Click {% octicon "pencil" aria-label="The edit icon" %} to edit the constraint. +1. Haz clic en {% octicon "pencil" aria-label="The edit icon" %} para editar la restricción. - ![Screenshot of the pencil icon for editing the constraint](/assets/images/help/codespaces/edit-timeout-constraint.png) + ![Captura de pantalla del icono de lápiz para editar la restricción](/assets/images/help/codespaces/edit-timeout-constraint.png) -1. Enter the maximum number of minutes codespaces can remain inactive before they time out, then click **Save**. +1. Escribe el número máximo de minutos que los codespaces pueden permanecer inactivos antes de que se agote el tiempo de espera y, luego, haz clic en **Guardar**. - ![Screenshot of setting the maximum timeout in minutes](/assets/images/help/codespaces/maximum-minutes-timeout.png) + ![Captura de pantalla de la configuración del tiempo de espera máximo en minutos](/assets/images/help/codespaces/maximum-minutes-timeout.png) {% data reusables.codespaces.codespaces-policy-targets %} -1. If you want to add another constraint to the policy, click **Add constraint** and choose another constraint. For information about other constraints, see: - * "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" - * "[Restricting the base image for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces)" - * "[Restricting the visibility of forwarded ports](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)" - * "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)" -1. After you've finished adding constraints to your policy, click **Save**. +1. Si quieres agregar otra restricción a la directiva, haz clic en **Agregar restricción** y elige otra restricción. Para obtener información sobre otras restricciones, consulta: + * "[Restricción del acceso a los tipos de máquina](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" + * "[Restricción de la imagen base para codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces)" + * "[Restricción de la visibilidad de los puertos reenviados](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)" + * "[Restricción del período de retención para codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)" +1. Cuando hayas terminado de agregar restricciones a la directiva, haz clic en **Guardar**. -The policy will be applied to all new codespaces that are billable to your organization. The timeout constraint is also applied to existing codespaces the next time they are started. +La directiva se aplicará a todos los codespaces nuevos que se facturen a tu organización. La restricción de tiempo de espera también se aplicará a los codespaces existentes la próxima vez que se inicien. -## Editing a policy +## Editar una política -You can edit an existing policy. For example, you may want to add or remove constraints to or from a policy. +Puedes editar una directiva existente. Por ejemplo, puede que te interese agregar restricciones a una directiva o quitarlas. -1. Display the "Codespace policies" page. For more information, see "[Adding a policy to set a maximum idle timeout period](#adding-a-policy-to-set-a-maximum-idle-timeout-period)." -1. Click the name of the policy you want to edit. -1. Click the pencil icon ({% octicon "pencil" aria-label="The edit icon" %}) beside the "Maximum idle timeout" constraint. -1. Make the required changes then click **Save**. +1. Muestra la página de "Políticas del Codespace". Para obtener más información, consulta "[Agregar una directiva para establecer un período de tiempo de espera máximo de inactividad](#adding-a-policy-to-set-a-maximum-idle-timeout-period)". +1. Haz clic en el nombre de la política que quieres editar. +1. Haz clic en el icono de lápiz ({% octicon "pencil" aria-label="The edit icon" %}) situado junto a la restricción "Tiempo de espera de inactividad máximo". +1. Realice los cambios necesarios y haga clic en **Save**. -## Deleting a policy +## Borrar una política -1. Display the "Codespace policies" page. For more information, see "[Adding a policy to set a maximum idle timeout period](#adding-a-policy-to-set-a-maximum-idle-timeout-period)." -1. Click the delete button to the right of the policy you want to delete. +1. Muestra la página de "Políticas del Codespace". Para obtener más información, consulta "[Agregar una directiva para establecer un período de tiempo de espera máximo de inactividad](#adding-a-policy-to-set-a-maximum-idle-timeout-period)". +1. Haz clic en el botón de borrar a la derecha de la política que quieras borrar. - ![Screenshot of the delete button for a policy](/assets/images/help/codespaces/policy-delete.png) + ![Captura de pantalla del botón de eliminación de una directiva](/assets/images/help/codespaces/policy-delete.png) diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces.md index 37668e6931..6e8f53a5e2 100644 --- a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces.md +++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces.md @@ -1,7 +1,7 @@ --- -title: Restricting the retention period for codespaces +title: Restricción del período de retención para codespaces shortTitle: Restrict the retention period -intro: You can set a maximum retention period for any codespaces owned by your organization. +intro: Puedes establecer un período de retención máximo para los codespaces que pertenezcan a tu organización. permissions: 'To manage retention constraints for an organization''s codespaces, you must be an owner of the organization.' versions: fpt: '*' @@ -9,76 +9,79 @@ versions: type: how_to topics: - Codespaces +ms.openlocfilehash: 3c114fe41b06176899f9dd11a6dcd51c038c88e5 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158985' --- +## Información general -## Overview +Los {% data variables.product.prodname_github_codespaces %} se eliminan automáticamente una vez que se hayan detenido y hayan permanecido inactivos durante un número definido de días. El período de retención de cada codespace se establece cuando se crea el codespace y no cambia. -{% data variables.product.prodname_github_codespaces %} are automatically deleted after they have been stopped and have remained inactive for a defined number of days. The retention period for each codespace is set when the codespace is created and does not change. +Todos los usuarios que tengan acceso a {% data variables.product.prodname_github_codespaces %} pueden configurar un período de retención para los codespaces que creen. La configuración inicial de este período de retención predeterminado es de 30 días. Cada usuario puede establecer este período dentro del intervalo de 0 a 30 días. Para más información, consulta "[Configuración de la eliminación automática de los codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)". -Everyone who has access to {% data variables.product.prodname_github_codespaces %} can configure a retention period for the codespaces they create. The initial setting for this default retention period is 30 days. Individual users can set this period within the range 0-30 days. For more information, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)." +Como propietario de la organización, es posible que te interese configurar restricciones sobre el período máximo de retención de los codespaces creados para los repositorios propiedad de la organización. Esto puede ayudarte a limitar los costos de almacenamiento asociados a los codespaces que se detienen y se dejan sin usar hasta que se eliminan automáticamente. Para más información sobre los cargos de almacenamiento, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)". Puedes establecer un período de retención máximo para todos o algunos repositorios específicos propiedad de tu organización. -As an organization owner, you may want to configure constraints on the maximum retention period for codespaces created for the repositories owned by your organization. This can help you to limit the storage costs associated with codespaces that are stopped and then left unused until they are automatically deleted. For more information about storage charges, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)." You can set a maximum retention period for all, or for specific, repositories owned by your organization. +### Configurar políticas específicas para los repositorios y a lo largo de la organización -### Setting organization-wide and repository-specific policies +Cuando crees una política, decide si se aplica a todos los repositorios de la organización o solo a algunos específicos. Si creas una directiva para toda la organización con una restricción de retención de codespace, las restricciones de retención de las directivas dirigidas a repositorios específicos deben ser más cortas que la restricción configurada para toda la organización o no tendrán ningún efecto. Se aplica el periodo de retención más corto, en una directiva para toda la organización, una directiva dirigida a repositorios específicos o el periodo de retención predeterminado en la configuración personal de alguien. -When you create a policy, you choose whether it applies to all repositories in your organization, or only to specified repositories. If you create an organization-wide policy with a codespace retention constraint, then the retention constraints in any policies that are targeted at specific repositories should be shorter than the restriction configured for the entire organization, or they will have no effect. The shortest retention period - in an organization-wide policy, a policy targeted at specified repositories, or the default retention period in someone's personal settings - is applied. - -If you add an organization-wide policy with a retention constraint, you should set the retention period to the longest acceptable period. You can then add separate policies that set the maximum retention to a shorter period for specific repositories in your organization. +Si agregas una directiva para toda la organización con una restricción de retención, debes establecer el período de retención en el más largo que sea aceptable. Después, puedes agregar otras directivas que establezcan la retención máxima en un período más corto para repositorios concretos de la organización. {% data reusables.codespaces.codespaces-org-policies-note %} -## Adding a policy to set a maximum codespace retention period +## Adición de una directiva para establecer el período de retención máximo de codespace -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.codespaces.codespaces-org-policies %} -1. Click **Add constraint** and choose **Retention period**. +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.codespaces.codespaces-org-policies %} +1. Haz clic en **Agregar restricción** y elige **Período de retención**. - ![Screenshot of the 'Add constraint' dropdown menu](/assets/images/help/codespaces/add-constraint-dropdown-retention.png) + ![Captura de pantalla del menú desplegable "Agregar restricción"](/assets/images/help/codespaces/add-constraint-dropdown-retention.png) -1. Click {% octicon "pencil" aria-label="The edit icon" %} to edit the constraint. +1. Haz clic en {% octicon "pencil" aria-label="The edit icon" %} para editar la restricción. - ![Screenshot of the pencil icon for editing the constraint](/assets/images/help/codespaces/edit-timeout-constraint.png) + ![Captura de pantalla del icono del lápiz para editar la restricción](/assets/images/help/codespaces/edit-timeout-constraint.png) -1. Enter the maximum number of days codespaces can remain stopped before they are automatically deleted, then click **Save**. +1. Escribe el número máximo de días que los codespaces pueden permanecer detenidos antes de que se eliminen automáticamente y, luego, haz clic en **Guardar**. - ![Screenshot of setting the retention period in days](/assets/images/help/codespaces/maximum-days-retention.png) + ![Captura de pantalla de la configuración del período de retención en días](/assets/images/help/codespaces/maximum-days-retention.png) {% note %} - **Notes**: - * A day, in this context, is a 24-hour period, beginning at the time of day when the codespace was stopped. - * The valid range is 0-30 days. - * Setting the period to `0` will result in codespaces being immediately deleted when they are stopped, or when they timeout due to inactivity. + **Notas**: + * Un día, en este contexto, es un período de 24 horas, comenzando en la hora del día en que se detuvo el codespace. + * El intervalo válido es de 0 a 30 días. + * Establecer el período en `0` dará lugar a que los codespaces se eliminen inmediatamente cuando se detengan o cuando se haya agotado el tiempo de espera debido a la inactividad. {% endnote %} {% data reusables.codespaces.codespaces-policy-targets %} -1. If you want to add another constraint to the policy, click **Add constraint** and choose another constraint. For information about other constraints, see: - * "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" - * "[Restricting the base image for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces)" - * "[Restricting the visibility of forwarded ports](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)" - * "[Restricting the idle timeout period](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)" -1. After you've finished adding constraints to your policy, click **Save**. +1. Si quieres agregar otra restricción a la directiva, haz clic en **Agregar restricción** y elige otra restricción. Para obtener información sobre otras restricciones, consulta: + * "[Restricción del acceso a los tipos de máquina](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" + * "[Restricción de la imagen base para codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces)" + * "[Restricción de la visibilidad de los puertos reenviados](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)" + * "[Restricción del período de tiempo de espera de inactividad](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)" +1. Cuando hayas terminado de agregar restricciones a la directiva, haz clic en **Guardar**. -The policy will be applied to all new codespaces that are billable to your organization. The retention period constraint is only applied on codespace creation. +La directiva se aplicará a todos los nuevos codespaces que se puedan facturar a tu organización. La restricción del período de retención solo se aplica a la creación del codespace. -## Editing a policy +## Editar una política -You can edit an existing policy. For example, you may want to add or remove constraints to or from a policy. +Puedes editar una directiva existente. Por ejemplo, puede que te interese agregar restricciones a una directiva o quitarlas. -The retention period constraint is only applied to codespaces when they are created. Editing a policy has no effect on existing codespaces. +La restricción de período de retención solo se aplica a los codespaces cuando se crean. La edición de una directiva no tiene ningún efecto sobre los codespaces existentes. -1. Display the "Codespace policies" page. For more information, see "[Adding a policy to set a maximum codespace retention period](#adding-a-policy-to-set-a-maximum-codespace-retention-period)." -1. Click the name of the policy you want to edit. -1. Click the pencil icon ({% octicon "pencil" aria-label="The edit icon" %}) beside the "Retention period" constraint. -1. Make the required changes then click **Save**. +1. Muestra la página de "Políticas del Codespace". Para más información, consulta "[Adición de una directiva para establecer un período máximo de retención de codespace](#adding-a-policy-to-set-a-maximum-codespace-retention-period)". +1. Haz clic en el nombre de la política que quieres editar. +1. Haz clic en el icono del lápiz ({% octicon "pencil" aria-label="The edit icon" %}) situado junto a la restricción "Período de retención". +1. Realice los cambios necesarios y haga clic en **Save**. -## Deleting a policy +## Borrar una política -You can delete a policy at any time. Deleting a policy has no effect on existing codespaces. +Puedes eliminar una directiva en cualquier momento. La eliminación de una directiva no tiene ningún efecto sobre los codespaces existentes. -1. Display the "Codespace policies" page. For more information, see "[Adding a policy to set a maximum codespace retention period](#adding-a-policy-to-set-a-maximum-codespace-retention-period)." -1. Click the delete button to the right of the policy you want to delete. +1. Muestra la página de "Políticas del Codespace". Para más información, consulta "[Adición de una directiva para establecer un período máximo de retención de codespace](#adding-a-policy-to-set-a-maximum-codespace-retention-period)". +1. Haz clic en el botón de borrar a la derecha de la política que quieras borrar. - ![Screenshot of the delete button for a policy](/assets/images/help/codespaces/policy-delete.png) + ![Captura de pantalla del botón de eliminación de una directiva](/assets/images/help/codespaces/policy-delete.png) diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports.md index a6e15aa254..a0bcc79fd7 100644 --- a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports.md +++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports.md @@ -1,7 +1,7 @@ --- -title: Restricting the visibility of forwarded ports +title: Restricción de la visibilidad de los puertos reenviados shortTitle: Restrict port visibility -intro: You can set constraints on the visibility options users can choose when they forward ports from codespaces in your organization. +intro: Puedes establecer restricciones en las opciones de visibilidad que los usuarios pueden elegir al reenviar puertos desde los codespaces de la organización. permissions: 'To manage access to port visibility constraints for the repositories in an organization, you must be an owner of the organization.' versions: fpt: '*' @@ -9,73 +9,76 @@ versions: type: how_to topics: - Codespaces +ms.openlocfilehash: ad670b43e0ac2a80e43048ffa61e0c83a8d12130 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158977' --- +## Información general -## Overview +Normalmente, dentro de un codespace, puede reenviar puertos de forma privada (solo a sí mismo), a los miembros de la organización o públicamente (a cualquiera que tenga la dirección URL). Para más información, vea "[Reenvío de puertos en el codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)". -Typically, within a codespace you are able to forward ports privately (only to yourself), to members of your organization, or publicly (to anyone with the URL). For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." +Como propietario de la organización, es posible que quiera configurar restricciones en las opciones de visibilidad que los usuarios pueden establecer al reenviar puertos. Por ejemplo, por motivos de seguridad, es posible que quiera denegar el reenvío de puertos públicos. Para ello, define una o más políticas en la configuración de {% data variables.product.prodname_github_codespaces %} de la organización. -As an organization owner, you may want to configure constraints on the visibility options users can set when forwarding ports. For example, for security reasons, you may want to disallow public port forwarding. You do this by defining one or more policies in the {% data variables.product.prodname_github_codespaces %} settings for your organization. +### Comportamiento al establecer una restricción de visibilidad de puerto -### Behavior when you set a port visibility constraint - -If there are existing codespaces that no longer conform to a policy you have defined, these codespaces will continue to operate until they are stopped or time out. When the user resumes the codespace, it will be subject to the policy constraints. +Si hay codespaces existentes que ya no se ajustan a una directiva que ha definido, seguirán funcionando hasta que se detengan o agoten el tiempo de espera. Cuando el usuario reanude el codespace, estará sujeto a las restricciones de directiva. {% note %} -**Note**: You can't disable private port forwarding, as private port forwarding is required by {% data variables.product.prodname_github_codespaces %} to continue working as designed, for example to forward SSH on port 22. +**Nota**: No se puede deshabilitar el enrutamiento de puertos privados, ya que {% data variables.product.prodname_github_codespaces %} lo necesita para funcionar según su diseño, por ejemplo, para reenviar SSH en el puerto 22. {% endnote %} -### Setting organization-wide and repository-specific policies +### Configurar políticas específicas para los repositorios y a lo largo de la organización -When you create a policy you choose whether it applies to all repositories in your organization, or only to specified repositories. If you set an organization-wide policy then any policies you set for individual repositories must fall within the restriction set at the organization level. Adding policies makes the choice of visibility options more, not less, restrictive. +Cuando creas una política, eliges si esta aplica a todos los repositorios de tu organización o solo a algunos específicos. Si configuras una política a lo largo de la organización, entonces cualquier política que configures para los repositorios individuales debe de caer dentro de las restricciones que se configuraron a nivel organizacional. La adición de directivas hace que la elección de opciones de visibilidad sea más restrictiva, no menos. -For example, you could create an organization-wide policy that restricts the visibility options to organization only. You can then set a policy for Repository A that disallows both public and organization visibility, which would result in only private port forwarding being available for this repository. Setting a policy for Repository A that allowed both public and organization would result in only organization visibility, because the organization-wide policy does not allow public visibility. +Por ejemplo, podría crear una directiva para toda la organización que restrinja las opciones de visibilidad solo para la organización. Después, puede establecer una directiva para el repositorio A que no permite la visibilidad pública y de la organización, lo que provocaría que solo el reenvío de puertos privado esté disponible para este repositorio. Establecer una directiva para el repositorio A que permita tanto la visibilidad pública como la de la organización solo daría lugar a visibilidad de la organización, ya que la directiva para toda la organización no permite la visibilidad pública. -If you add an organization-wide policy, you should set it to the most lenient visibility option that will be available for any repository in your organization. You can then add repository-specific policies to further restrict the choice. +Si agrega una directiva para toda la organización, debe establecerla en la opción de visibilidad más permisiva disponible para cualquier repositorio de la organización. Entonces podrás agregar las políticas específicas para los repositorios y así restringir aún más la elección. {% data reusables.codespaces.codespaces-org-policies-note %} -## Adding a policy to limit the port visibility options +## Adición de una directiva para limitar las opciones de visibilidad de puertos -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.codespaces.codespaces-org-policies %} -1. Click **Add constraint** and choose **Port visibility**. +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.codespaces.codespaces-org-policies %} +1. Haga clic en **Agregar restricción** y elija **Visibilidad de puertos**. - ![Screenshot of the 'Add constraint' dropdown menu](/assets/images/help/codespaces/add-constraint-dropdown-ports.png) + ![Captura de pantalla del menú desplegable "Agregar restricción"](/assets/images/help/codespaces/add-constraint-dropdown-ports.png) -1. Click {% octicon "pencil" aria-label="The edit icon" %} to edit the constraint. +1. Haz clic en {% octicon "pencil" aria-label="The edit icon" %} para editar la restricción. - ![Screenshot of the pencil icon for editing the constraint](/assets/images/help/codespaces/edit-port-visibility-constraint.png) + ![Captura de pantalla del icono de lápiz para editar la restricción](/assets/images/help/codespaces/edit-port-visibility-constraint.png) -1. Clear the selection of the port visibility options (**Org** or **Public**) that you don't want to be available. +1. Borre la selección de las opciones de visibilidad de puertos (**Organización** o **Pública**) que no quiere que estén disponibles. - ![Screenshot of clearing a port visibility option](/assets/images/help/codespaces/choose-port-visibility-options.png) + ![Captura de pantalla de la desactivación de una opción de visibilidad de puertos](/assets/images/help/codespaces/choose-port-visibility-options.png) {% data reusables.codespaces.codespaces-policy-targets %} -1. If you want to add another constraint to the policy, click **Add constraint** and choose another constraint. For information about other constraints, see: - * "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" - * "[Restricting the base image for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces)" - * "[Restricting the idle timeout period](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)" - * "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)" -1. After you've finished adding constraints to your policy, click **Save**. +1. Si quieres agregar otra restricción a la directiva, haz clic en **Agregar restricción** y elige otra restricción. Para obtener información sobre otras restricciones, consulta: + * "[Restricción del acceso a los tipos de máquina](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" + * "[Restricción de la imagen base para codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces)" + * "[Restricción del período de tiempo de espera de inactividad](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)" + * "[Restricción del período de retención para codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)" +1. Cuando hayas terminado de agregar restricciones a la directiva, haz clic en **Guardar**. -The policy will be applied to all new codespaces that are billable to your organization. The port visibility constraint is also applied to existing codespaces the next time they are started. +La directiva se aplicará a todos los codespaces nuevos que se facturen a tu organización. La restricción de visibilidad de puertos también se aplicará a los codespaces existentes la próxima vez que se inicien. -## Editing a policy +## Editar una política -You can edit an existing policy. For example, you may want to add or remove constraints to or from a policy. +Puedes editar una directiva existente. Por ejemplo, puede que te interese agregar restricciones a una directiva o quitarlas. -1. Display the "Codespace policies" page. For more information, see "[Adding a policy to limit the port visibility options](#adding-a-policy-to-limit-the-port-visibility-options)." -1. Click the name of the policy you want to edit. -1. Click the pencil icon ({% octicon "pencil" aria-label="The edit icon" %}) beside the "Port visibility" constraint. -1. Make the required changes then click **Save**. +1. Muestra la página de "Políticas del Codespace". Para más información, vea "[Adición de una directiva para limitar las opciones de visibilidad de puertos](#adding-a-policy-to-limit-the-port-visibility-options)". +1. Haz clic en el nombre de la política que quieres editar. +1. Haz clic en el icono de lápiz ({% octicon "pencil" aria-label="The edit icon" %}) situado junto a la restricción "Visibilidad de puertos". +1. Realice los cambios necesarios y haga clic en **Save**. -## Deleting a policy +## Borrar una política -1. Display the "Codespace policies" page. For more information, see "[Adding a policy to limit the port visibility options](#adding-a-policy-to-limit-the-port-visibility-options)." -1. Click the delete button to the right of the policy you want to delete. +1. Muestra la página de "Políticas del Codespace". Para más información, vea "[Adición de una directiva para limitar las opciones de visibilidad de puertos](#adding-a-policy-to-limit-the-port-visibility-options)". +1. Haz clic en el botón de borrar a la derecha de la política que quieras borrar. - ![Screenshot of the delete button for a policy](/assets/images/help/codespaces/policy-delete.png) + ![Captura de pantalla del botón de eliminación de una directiva](/assets/images/help/codespaces/policy-delete.png) diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md index 4dc53ccac7..644ab4b3b8 100644 --- a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md +++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md @@ -1,7 +1,7 @@ --- -title: Reviewing your organization's audit logs for GitHub Codespaces +title: Revisión de los registros de auditoría de la organización para GitHub Codespaces shortTitle: Audit logs -intro: 'You can use the audit log to review all actions related to {% data variables.product.prodname_github_codespaces %}.' +intro: 'Puedes utilizar el registro de auditoría para revisar todas las acciones relacionadas con {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -12,17 +12,20 @@ topics: - Administrator redirect_from: - /codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-codespaces +ms.openlocfilehash: 81fbf92217c704ece2f1076de03e1f0445ded2c5 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160322' --- +Cuando algún miembro de tu organización lleva a cabo una acción relacionada con {% data variables.product.prodname_github_codespaces %}, puedes revisar las acciones en el registro de auditoría. Para obtener información sobre cómo acceder al registro, vea "[Revisión del registro de auditoría](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#accessing-the-audit-log)". - +![Bitácora de auditoría con información de los codespaces](/assets/images/help/settings/codespaces-audit-log-org.png) -When any member of your organization performs an action related to {% data variables.product.prodname_github_codespaces %}, you can review the actions in the audit log. For information about accessing the log, see "[Reviewing your audit log](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#accessing-the-audit-log)." +La bitácora de auditoría incluye detalles tales como quién realizó la acción, qué fue esa acción y cuándo se llevó a cabo. Para obtener información sobre las acciones de {% data variables.product.prodname_github_codespaces %}, consulta "[Acciones de categoría de `codespaces`](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#codespaces-category-actions)". -![Audit log with Codespaces information](/assets/images/help/settings/codespaces-audit-log-org.png) +## Información adicional -The audit log includes details such as who performed the action, what the action was, and when the action was performed. For information on {% data variables.product.prodname_github_codespaces %} actions, see "[`codespaces` category actions](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#codespaces-category-actions)." - -## Further reading - -- "[Reviewing your security logs for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)" +- "[Revisión de los registros de seguridad de {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)" - "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)" diff --git a/translations/es-ES/content/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces.md b/translations/es-ES/content/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces.md index 6a2cc72fd6..74d86756ab 100644 --- a/translations/es-ES/content/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces.md +++ b/translations/es-ES/content/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces.md @@ -1,6 +1,6 @@ --- -title: Managing encrypted secrets for your codespaces -intro: 'You can store sensitive information, like tokens, that you want to access in your codespaces via environment variables.' +title: Administrar secretos cifrados para tus codespaces +intro: 'Puedes almacenar información sensible, como los tokens, a la cual quieras acceder en tus codespaces en forma de variables de ambiente.' versions: fpt: '*' ghec: '*' @@ -14,89 +14,84 @@ topics: - Security - Secret store shortTitle: Encrypted secrets +ms.openlocfilehash: f2ef60c9311a81ea59ec4f71cb7c1a432102b063 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160446' --- +## Acerca de los secretos cifrados de {% data variables.product.prodname_github_codespaces %} - +Puedes agregar a tu cuenta personal los secretos cifrados que quieras utilizar en tus codespaces. Por ejemplo, puede que quieras almacenar y acceder a la siguiente información sensible en forma de un secreto cifrado. +- Tokens de acceso para los servicios en la nube +- Entidades de servicio +- Identificadores de suscripción +- [Credenciales para un registro de imagen privada](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry) -## About encrypted secrets for {% data variables.product.prodname_github_codespaces %} - -You can add encrypted secrets to your personal account that you want to use in your codespaces. For example, you may want to store and access the following sensitive information as encrypted secrets. - -- Access tokens to cloud services -- Service principals -- Subscription identifiers -- [Credentials for a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry) - -You can choose which repositories should have access to each secret. Then, you can use the secret in any codespace you create for a repository that has access to the secret. To share a secret with a codespace created from a template, you will need to publish the codespace to a repository on {% data variables.product.prodname_dotcom %}, then give that repository access to the secret. +Puedes elegir qué repositorios deben tener acceso a cada secreto. Posteriormente, puedes utilizar el secreto en cualquier codespace que crees para un repositorio que tenga acceso a él. Para compartir un secreto con un codespace creado a partir de una plantilla, deberás publicar el codespace en un repositorio de {% data variables.product.prodname_dotcom %} y, después, conceder a ese repositorio acceso al secreto. {% data reusables.codespaces.secrets-on-start %} -### Naming secrets +### Nombrar secretos -{% data reusables.codespaces.secrets-naming %} For example, a secret created at the repository level must have a unique name in that repository. +{% data reusables.codespaces.secrets-naming %} Por ejemplo, un secreto que se crea a nivel de repositorio debe tener un nombre único en este. {% data reusables.codespaces.secret-precedence %} -### Limits for secrets +### Límites para los secretos -You can store up to 100 secrets for {% data variables.product.prodname_github_codespaces %}. +Puedes almacenar hasta 100 secretos para {% data variables.product.prodname_github_codespaces %}. -Secrets are limited to 64 KB in size. +Los secretos tienen un tamaño máximo de 64 KB. -## Adding a secret +## Agregar un secreto -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. To the right of "Codespaces secrets", click **New secret**. - !["New secret" button](/assets/images/help/settings/codespaces-new-secret-button.png) -1. Under "Name", type a name for your secret. - !["Name" text box](/assets/images/help/settings/codespaces-secret-name-field.png) -{% data reusables.user-settings.codespaces-secret-value %} -{% data reusables.user-settings.codespaces-secret-repository-access %} -1. Click **Add secret**. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. A la derecha de "Codespaces secrets", haga clic en **New secret**. + ![Botón "New secret"](/assets/images/help/settings/codespaces-new-secret-button.png) +1. Debajo de "Nombre", teclea un nombre para tu secreto. + ![Cuadro de texto "Name"](/assets/images/help/settings/codespaces-secret-name-field.png) {% data reusables.user-settings.codespaces-secret-value %} {% data reusables.user-settings.codespaces-secret-repository-access %} +1. Haga clic en **Add Secret**. -## Editing a secret +## Editar un secreto -You can update the value of an existing secret, and you can change which repositories can access a secret. +Puedes actualizar el valor de un secreto existente y puedes cambiar qué repositorios pueden acceder a un secreto. -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Codespaces secrets", to the right of the secret you want to edit, click **Update**. - !["Update" button](/assets/images/help/settings/codespaces-secret-update-button.png) -1. Under "Value", click **enter a new value**. - !["enter a new value" link](/assets/images/help/settings/codespaces-secret-update-value-text.png) -{% data reusables.user-settings.codespaces-secret-value %} -{% data reusables.user-settings.codespaces-secret-repository-access %} -1. Optionally, to remove the secret's access to a repository, deselect the repository. - ![Checkboxes to remove access to repositories](/assets/images/help/settings/codespaces-secret-repository-checkboxes.png) -1. Click **Save changes**. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. En "Codespaces secrets", a la derecha del secreto que quiera editar, haga clic en **Update**. + ![Botón "Update"](/assets/images/help/settings/codespaces-secret-update-button.png) +1. En "Value", haga clic en **enter a new value**. + ![vínculo "enter a new value"](/assets/images/help/settings/codespaces-secret-update-value-text.png) {% data reusables.user-settings.codespaces-secret-value %} {% data reusables.user-settings.codespaces-secret-repository-access %} +1. Opcionalmente, para eliminar el acceso del secreto a un repositorio, deselecciona el repositorio. + ![Casillas para eliminar el acceso a los repositorios](/assets/images/help/settings/codespaces-secret-repository-checkboxes.png) +1. Haga clic en **Guardar cambios**. -## Deleting a secret +## Borrar un secreto -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Codespaces secrets", to the right of the secret you want to delete, click **Delete**. - !["Delete" button](/assets/images/help/settings/codespaces-secret-delete-button.png) -1. Read the warning, then click **OK**. - ![Confirmation to delete secret](/assets/images/help/settings/codespaces-secret-delete-warning.png) +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. En "Codespaces secrets", a la derecha del secreto que quiera eliminar, haga clic en **Delete**. + ![Botón "Delete"](/assets/images/help/settings/codespaces-secret-delete-button.png) +1. Lea la advertencia y haga clic en **Aceptar**. + ![Confirmación para eliminar un secreto](/assets/images/help/settings/codespaces-secret-delete-warning.png) -## Using secrets +## Uso de secretos -A secret is exported as an environment variable into the user's terminal session. +Un secreto se exporta como una variable de entorno a la sesión de terminal del usuario. - ![Displaying the value of an exported secret in the terminal](/assets/images/help/codespaces/exported-codespace-secret.png) + ![Representación del valor de un secreto exportado en el terminal](/assets/images/help/codespaces/exported-codespace-secret.png) -You can use secrets in a codespace after the codespace is built and is running. For example, a secret can be used: +Puedes usar secretos en un codespace una vez que se compile y esté en ejecución. Por ejemplo, un secreto se puede usar: -* When launching an application from the integrated terminal or ssh session. -* Within a dev container lifecycle script that is run after the codespace is running. For more information about dev container lifecycle scripts, see the documentation on containers.dev: [Specification](https://containers.dev/implementors/json_reference/#lifecycle-scripts). +* Al iniciar una aplicación desde el terminal integrado o la sesión ssh. +* Dentro de un script de ciclo de vida del contenedor de desarrollo que se ejecuta después de ejecutar el codespace. Para más información sobre los scripts de ciclo de vida del contenedor de desarrollo, consulta la documentación sobre containers.dev: [Especificación](https://containers.dev/implementors/json_reference/#lifecycle-scripts). -Codespace secrets cannot be used: +Los secretos de codespace no se pueden usar: -* During codespace build time (that is, within a Dockerfile or custom entry point). -* Within a dev container feature. For more information, see the `features` property in the [dev containers specification](https://containers.dev/implementors/json_reference/#general-properties) on containers.dev. +* Durante el tiempo de compilación del codespace (es decir, dentro de un Dockerfile o un punto de entrada personalizado). +* Dentro de una característica de contenedor de desarrollo. Para obtener más información, consulta la propiedad `features` en la [especificación de contenedores de desarrollo](https://containers.dev/implementors/json_reference/#general-properties) de containers.dev. -## Further reading +## Información adicional -- "[Managing encrypted secrets for your repository and organization for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces)" +- "[Administración de secretos cifrados para el repositorio y la organización en {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces)" diff --git a/translations/es-ES/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md b/translations/es-ES/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md index 692b4c28a6..b3253aec05 100644 --- a/translations/es-ES/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md +++ b/translations/es-ES/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Managing GPG verification for GitHub Codespaces -intro: 'You can allow {% data variables.product.company_short %} to automatically use GPG to sign commits you make in your codespaces, so other people can be confident that the changes come from a trusted source.' +title: Administración de la comprobación de GPG para GitHub Codespaces +intro: 'Puedes permitir que {% data variables.product.company_short %} utilice automáticamente GPG para firmar las confirmaciones que haces en tus codespaces para que otras personas puedan tener la confianza de que los cambios vienen de una fuente confiable.' versions: fpt: '*' ghec: '*' @@ -14,26 +14,28 @@ redirect_from: - /codespaces/working-with-your-codespace/managing-gpg-verification-for-codespaces - /codespaces/managing-your-codespaces/managing-gpg-verification-for-codespaces shortTitle: GPG verification +ms.openlocfilehash: ff83eba1720a2841747536ec04bfc0b3db055669 +ms.sourcegitcommit: 47e03737d09bed84dfedb7be5924d893d34ea1a8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167105' --- - - - -After you enable GPG verification, {% data variables.product.company_short %} will automatically sign commits you make in {% data variables.product.prodname_github_codespaces %}, and the commits will have a verified status on {% data variables.product.product_name %}. By default, GPG verification is disabled for codespaces you create. You can choose to allow GPG verification for all repositories or specific repositories. Only enable GPG verification for repositories that you trust. For more information about {% data variables.product.product_name %}-signed commits, see "[About commit signature verification](/github/authenticating-to-github/about-commit-signature-verification)." +Después de habilitar la comprobación de GPG, {% data variables.product.company_short %} firmará automáticamente las confirmaciones que hagas en {% data variables.product.prodname_github_codespaces %} y estas tendrán un estado verificado en {% data variables.product.product_name %}. Predeterminadamente, la verificación GPG se encuentra inhabilitada para los codespaces que creas. Puedes elegir permitir la verificación de GPG para todos los repositorios o para repositorios específicos. Habilita la verificación GPG únicamente para los repositorios en los cuales confías. Para más información sobre las confirmaciones firmadas por {% data variables.product.product_name %}, vea "[Acerca de la comprobación de firma de confirmación](/github/authenticating-to-github/about-commit-signature-verification)". {% data reusables.codespaces.gpg-in-active-codespaces %} {% note %} -**Note:** If you have linked a dotfiles repository with {% data variables.product.prodname_github_codespaces %}, the Git configuration in your dotfiles may conflict with the configuration that {% data variables.product.prodname_github_codespaces %} requires to sign commits. For more information, see "[Troubleshooting GPG verification for {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces)." +**Nota:** Si has vinculado un repositorio de dotfiles con {% data variables.product.prodname_github_codespaces %}, la configuración de Git en los dotfiles puede entrar en conflicto con la configuración que {% data variables.product.prodname_github_codespaces %} requiere para firmar confirmaciones. Para más información, consulta: "[Solución de problemas de la comprobación de GPG para {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces)." {% endnote %} -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "GPG verification", select the setting you want for GPG verification. - ![Radio buttons to manage GPG verification](/assets/images/help/settings/codespaces-gpg-verification-radio-buttons.png) -1. If you chose "Selected repositories", select the dropdown menu, then click a repository you want enable GPG verification for. Repeat for all repositories you want to enable GPG verification for. - !["Selected repositories" dropdown menu](/assets/images/help/settings/codespaces-gpg-verification-repository-drop-down.png) +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. Debajo de "verificación GPG", selecciona la configuración que quieras para la verificación de GPG. + ![Botones de radio para administrar la comprobación de GPG](/assets/images/help/settings/codespaces-gpg-verification-radio-buttons.png) +1. Si eliges "Repositorios seleccionados"; selecciona el menú desplegable y luego haz clic en el repositorio para el cual quieras habilitar la verificación de GPG. Repite esto para todos los repositorios en los cuales quieras habilitar la verificación GPG. + ![Menú desplegable "Repositorios seleccionados"](/assets/images/help/settings/codespaces-gpg-verification-repository-drop-down.png) -Once you have enabled GPG verification for {% data variables.product.prodname_github_codespaces %}, all commits are signed by default in your codespaces. \ No newline at end of file +Una vez que hayas habilitado la comprobación de GPG para {% data variables.product.prodname_github_codespaces %}, todas las confirmaciones se firman de forma predeterminada en los espacios de código. diff --git a/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md b/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md index 4519c40fd5..7240e6c4e2 100644 --- a/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md +++ b/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md @@ -1,8 +1,8 @@ --- -title: Managing access to other repositories within your codespace +title: Administración del acceso a otros repositorios dentro del codespace allowTitleToDifferFromFilename: true shortTitle: Repository access -intro: 'You can manage the repositories that {% data variables.product.prodname_github_codespaces %} can access.' +intro: 'Puedes administrar los repositorios a los cuales puede acceder {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -11,26 +11,31 @@ topics: - Security redirect_from: - /codespaces/managing-your-codespaces/managing-access-and-security-for-your-codespaces +ms.openlocfilehash: 3f8379c322bd7ccd9ff7d31e17da90a77461536d +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160306' --- +## Información general -## Overview +De manera predeterminada, al codespace se le asigna un token con ámbito en el repositorio desde el que se creó. Al publicar un codespace creado a partir de una plantilla en un nuevo repositorio en {% data variables.product.product_name %}, se le asigna al codespace un token que se limita al nuevo repositorio. Para más información, consulta "[Seguridad en {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/security-in-github-codespaces#authentication)". Si el proyecto necesita permisos adicionales para otros repositorios, puedes configurarlo en el archivo `devcontainer.json` y asegurarte de que otros colaboradores tengan el conjunto adecuado de permisos. -By default, your codespace is assigned a token scoped to the repository from which it was created. When you publish a codespace that you created from a template to a new repository on {% data variables.product.product_name %}, the codespace is assigned a token scoped to the new repository. For more information, see "[Security in {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/security-in-github-codespaces#authentication)." If your project needs additional permissions for other repositories, you can configure this in the `devcontainer.json` file and ensure other collaborators have the right set of permissions. +Cuando se muestren permisos en el archivo `devcontainer.json`, se te pedirá que revises y autorices los permisos adicionales como parte de la creación del codespace para ese repositorio. Cuando hayas autorizado los permisos enumerados, {% data variables.product.prodname_github_codespaces %} recordará tu elección y no te pedirá autorización a menos que cambien los permisos del archivo `devcontainer.json`. -When permissions are listed in the `devcontainer.json` file, you will be prompted to review and authorize the additional permissions as part of codespace creation for that repository. Once you've authorized the listed permissions, {% data variables.product.prodname_github_codespaces %} will remember your choice and will not prompt you for authorization unless the permissions in the `devcontainer.json` file change. +## Prerrequisitos -## Prerequisites +Para crear codespaces con permisos personalizados definidos, debes usar uno de los siguientes: +* La interfaz de usuario web de {% data variables.product.prodname_dotcom %} +* [La CLI de {% data variables.product.prodname_dotcom %}](https://github.com/cli/cli/releases/latest) 2.5.2 o posterior +* [La extensión de {% data variables.product.prodname_github_codespaces %}{% data variables.product.prodname_vscode %}](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces) 1.5.3 o superior. -To create codespaces with custom permissions defined, you must use one of the following: -* The {% data variables.product.prodname_dotcom %} web UI -* [{% data variables.product.prodname_dotcom %} CLI](https://github.com/cli/cli/releases/latest) 2.5.2 or later -* [{% data variables.product.prodname_github_codespaces %} {% data variables.product.prodname_vscode %} extension](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces) 1.5.3 or later +## Establecimiento de permisos de repositorio adicionales -## Setting additional repository permissions +1. Los permisos del repositorio se configuran para {% data variables.product.prodname_github_codespaces %} en el archivo `devcontainer.json`. Si el repositorio aún no contiene un archivo `devcontainer.json`, agregue uno ahora. Para obtener más información, "[Incorporación de un contenedor de desarrollo al proyecto](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)". -1. You configure repository permissions for {% data variables.product.prodname_github_codespaces %} in the `devcontainer.json` file. If your repository does not already contain a `devcontainer.json` file, add one now. For more information, "[Add a dev container to your project](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)." - -1. Edit the `devcontainer.json` file, adding the repository name and permissions needed to the `repositories` object: +1. Edita el archivo `devcontainer.json` y agrega el nombre del repositorio y los permisos necesarios para el objeto `repositories`: ```json{:copy} { @@ -50,25 +55,25 @@ To create codespaces with custom permissions defined, you must use one of the fo {% note %} - **Note:** You can only reference repositories that belong to the same personal account or organization as the repository you are currently working in. + **Nota**: Solo puedes hacer referencia a repositorios que pertenezcan a la misma cuenta personal u organización que el repositorio en el que estés trabajando actualmente. {% endnote %} - You can grant as many or as few of the following permissions for each repository listed: - * `actions` - read / write - * `checks` - read / write - * `contents` - read / write - * `deployments` - read / write - * `discussions` - read / write - * `issues` - read / write - * `packages` - read - * `pages` - read / write - * `pull_requests` - read / write - * `repository_projects` - read / write - * `statuses` - read / write - * `workflows` - write + Puedes conceder los permisos que quieras, ya sean muchos o pocos, para cada repositorio que se muestra: + * `actions`: lectura/escritura + * `checks`: lectura/escritura + * `contents`: lectura/escritura + * `deployments`: lectura/escritura + * `discussions`: lectura/escritura + * `issues`: lectura/escritura + * `packages`: lectura + * `pages`: lectura/escritura + * `pull_requests`: lectura/escritura + * `repository_projects`: lectura/escritura + * `statuses`: lectura/escritura + * `workflows`: escritura - To set a permission for all repositories in an organization, use the `*` wildcard following your organization name in the `repositories` object. + A fin de establecer un permiso para todos los repositorios de una organización, usa el carácter comodín `*` que sigue al nombre de la organización en el objeto `repositories`. ```json { @@ -86,7 +91,7 @@ To create codespaces with custom permissions defined, you must use one of the fo } ``` - To set all permissions for a given repository, use `"permissions": "read-all"` or `"permissions": "write-all"` in the repository object. + Para establecer todos los permisos de un repositorio determinado, usa `"permissions": "read-all"` o `"permissions": "write-all"` en el objeto de repositorio. ```json { @@ -102,32 +107,31 @@ To create codespaces with custom permissions defined, you must use one of the fo } ``` -## Authorizing requested permissions +## Autorización de permisos solicitados -If additional repository permissions are defined in the `devcontainer.json` file, you will be prompted to review and optionally authorize the permissions when you create a codespace or a prebuild configuration for this repository. When you authorize permissions for a repository, {% data variables.product.prodname_github_codespaces %} will not re-prompt you unless the set of requested permissions has changed for the repository. +Si se definen permisos de repositorio adicionales en el archivo `devcontainer.json`, se te pedirá que revises y, opcionalmente, autorices los permisos al crear un codespace o una configuración de precompilación para este repositorio. Al autorizar permisos para un repositorio, {% data variables.product.prodname_github_codespaces %} no se te volverá a pedir a menos que el conjunto de permisos solicitados haya cambiado para el repositorio. -![The requested permissions page](/assets/images/help/codespaces/codespaces-accept-permissions.png) +![Página de permisos solicitados](/assets/images/help/codespaces/codespaces-accept-permissions.png) -You should only authorize permissions for repositories you know and trust. If you don't trust the set of requested permissions, click **Continue without authorizing** to create the codespace with the base set of permissions. Rejecting additional permissions may impact the functionality of your project within the codespace as the codespace will only have access to the repository from which it was created. +Solo debes autorizar los permisos para los repositorios que conoces y en los que confías. Si no confías en el conjunto de permisos solicitados, haz clic en **Continue without authorizing** (Continuar sin autorizar) para crear el codespace con el conjunto base de permisos. Rechazar permisos adicionales puede afectar a la función del proyecto dentro del codespace, ya que codespace solo tendrá acceso al repositorio desde el que se creó. -You can only authorize permissions that your personal account already possesses. If a codespace requests permissions for repositories that you don't currently have access to, contact an owner or admin of the repository to obtain sufficient access and then try to create a codespace again. +Solo puedes autorizar los permisos que tu cuenta personal ya posee. Si un codespace solicita permisos para repositorios a los que no tienes acceso actualmente, ponte en contacto con un propietario o administrador del repositorio para obtener acceso suficiente e intenta crear de nuevo un codespace. -## Access and security +## Acceso y seguridad {% warning %} -**Deprecation note**: The access and security setting described below is now deprecated and is documented here for reference only. To enable expanded access to other repositories, add the requested permissions to your dev container definition for your codespace, as described above. +**Nota de desuso**: La configuración de acceso y seguridad que se describe a continuación está en desuso y se documentada aquí solo como referencia. Para habilitar el acceso expandido a otros repositorios, agrega los permisos solicitados a la definición del contenedor de desarrollo del codespace, tal como se ha descrito anteriormente. {% endwarning %} -When you enable access and security for a repository owned by your personal account, any codespaces that are created for that repository will have read permissions to all other repositories you own. If you want to restrict the repositories a codespace can access, you can limit to it to either the repository the codespace was opened for or specific repositories. You should only enable access and security for repositories you trust. +Cuando habilitas el acceso y la seguridad de un repositorio que pertenezca a tu cuenta personal, cualquier codespace que se cree para este tendrá permisos de lectura en el resto de los repositorios de tu propiedad. Si quieres restringir los repositorios a los que puede acceder un codespace, puedes limitarlos a ya sea el repositorio para el cual se abrió el codespace o a repositorios específicos. Solo debes habilitar el acceso y la seguridad para los repositorios en los cuales confíes. -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Access and security", select the setting you want for your personal account. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. En "Access and security" (Acceso y seguridad); selecciona la configuración que quieras para tu cuenta personal. - ![Radio buttons to manage trusted repositories](/assets/images/help/settings/codespaces-access-and-security-radio-buttons.png) + ![Botones radiales para adminsitrar los repositorios confiables](/assets/images/help/settings/codespaces-access-and-security-radio-buttons.png) -1. If you chose "Selected repositories", select the dropdown menu, then click a repository to allow the repository's codespaces to access other repositories you own. Repeat for all repositories whose codespaces you want to access other repositories you own. +1. Si eliges "Repositorios seleccionados", selecciona el menú desplegable y luego haz clic en un repositorio para permitir que los codespaces de este accedan al resto de los repositorios que te pertenecen. Repite esto para todos los repositorios cuyos codespaces quieras que accedan al resto de tus repositorios. - !["Selected repositories" dropdown menu](/assets/images/help/settings/codespaces-access-and-security-repository-drop-down.png) + ![Menú desplegable "Repositorios seleccionados"](/assets/images/help/settings/codespaces-access-and-security-repository-drop-down.png) diff --git a/translations/es-ES/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md b/translations/es-ES/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md index 475292c833..4cb549103b 100644 --- a/translations/es-ES/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md +++ b/translations/es-ES/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md @@ -1,7 +1,7 @@ --- -title: Reviewing your security logs for GitHub Codespaces +title: Revisión de los registros de seguridad de GitHub Codespaces shortTitle: Security logs -intro: 'You can use the security log to review all actions related to {% data variables.product.prodname_github_codespaces %}.' +intro: 'Puedes utilizar el registro de seguridad para revisar todas las acciones relacionadas con {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -11,19 +11,22 @@ topics: - Security redirect_from: - /codespaces/managing-your-codespaces/reviewing-your-security-logs-for-codespaces +ms.openlocfilehash: 51cd11f123cbc2b6b67e089d65bc68d3441aa5b8 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160075' --- +## Acerca de los registros de seguridad de {% data variables.product.prodname_github_codespaces %} - +Cuando realizas una acción relacionada con {% data variables.product.prodname_github_codespaces %} en los repositorios que pertenecen a tu cuenta personal, puedes revisar las acciones en el registro de seguridad. Para obtener información sobre cómo acceder al registro, vea "[Revisión del registro de seguridad](/github/authenticating-to-github/reviewing-your-security-log#accessing-your-security-log)". -## About security logs for {% data variables.product.prodname_github_codespaces %} +![bitácora de seguridad con información sobre los codespaces](/assets/images/help/settings/codespaces-audit-log.png) -When you perform an action related to {% data variables.product.prodname_github_codespaces %} in repositories owned by your personal account, you can review the actions in the security log. For information about accessing the log, see "[Reviewing your security log](/github/authenticating-to-github/reviewing-your-security-log#accessing-your-security-log)." +La bitácora de seguridad incluye detalles de qué acción ocurrió y cuándo la realizaste. Para obtener información sobre las acciones de {% data variables.product.prodname_github_codespaces %}, consulta "[Categorías de acciones de {% data variables.product.prodname_codespaces %}](/github/authenticating-to-github/reviewing-your-security-log#codespaces-category-actions)". -![security log with Codespaces information](/assets/images/help/settings/codespaces-audit-log.png) +## Información adicional -The security log includes details on what action occurred and when you performed it. For information about {% data variables.product.prodname_github_codespaces %} actions, see "[{% data variables.product.prodname_codespaces %} category actions](/github/authenticating-to-github/reviewing-your-security-log#codespaces-category-actions)". - -## Further reading - -- "[Reviewing your organization's audit logs for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)" -- "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)" \ No newline at end of file +- "[Revisión de los registros de auditoría de la organización para {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)" +- "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)" diff --git a/translations/es-ES/content/codespaces/overview.md b/translations/es-ES/content/codespaces/overview.md index f690aa5106..3a1d018c54 100644 --- a/translations/es-ES/content/codespaces/overview.md +++ b/translations/es-ES/content/codespaces/overview.md @@ -15,12 +15,12 @@ versions: type: overview topics: - Codespaces -ms.openlocfilehash: a1618c86671bc5b06474c41803c6b34576a897aa -ms.sourcegitcommit: 2e1852bcdd690cb66b9b5d69cb056a2bb2b9a6b4 +ms.openlocfilehash: 9d01df3f8dae7ceb788e2dd57b02fb3cc977400d +ms.sourcegitcommit: 1529de77bfcbe45519131b5f5fb3ab319758c2d2 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 11/10/2022 -ms.locfileid: '148160804' +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148164327' --- ## ¿Qué es un codespace? @@ -50,7 +50,7 @@ Puedes crear y usar un codespace para cualquier repositorio que puedas clonar. T Los propietarios de la organización pueden habilitar el uso de {% data variables.product.prodname_github_codespaces %}, facturables a la organización o a la cuenta de empresa. Esto se aplica a codespaces creados a partir de repositorios propiedad de la organización. Para más información, consulta ["Habilitación de {% data variables.product.prodname_github_codespaces %} para la organización](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)". Puedes establecer un límite de gasto para el uso de {% data variables.product.prodname_github_codespaces %} en tu organización o cuenta empresarial. Para más información, consulta "[Administración de los límites de gasto para {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces)". -Si el uso de un codespace va a facturarse a una organización o empresa, se muestra cuando se crea el codespace. Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)". Los codespaces que se facturan a una organización, o a su empresa matriz, son propiedad de la organización y pueden ser eliminados por un propietario de la organización. Para más información, vea "[Eliminación de un codespace](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)". +Si el uso de un codespace va a facturarse a una organización o empresa, se muestra cuando se crea el codespace. Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)". Los codespaces que se facturan a una organización, o a su empresa matriz, son propiedad de la organización y pueden ser eliminados por un propietario de esta. Para más información, vea "[Eliminación de un codespace](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)". ### Personalización de {% data variables.product.prodname_github_codespaces %} diff --git a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md index 45f4bd4c6b..08539897ad 100644 --- a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md +++ b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md @@ -1,7 +1,7 @@ --- -title: About GitHub Codespaces prebuilds +title: Acerca de las precompilaciones de GitHub Codespaces shortTitle: About prebuilds -intro: '{% data variables.product.prodname_github_codespaces %} prebuilds help to speed up the creation of new codespaces for large or complex repositories.' +intro: 'Las precompilaciones de {% data variables.product.prodname_github_codespaces %} ayudan a acelerar la creación de codespaces para repositorios grandes o complejos.' versions: fpt: '*' ghec: '*' @@ -9,43 +9,48 @@ topics: - Codespaces redirect_from: - /codespaces/prebuilding-your-codespaces/about-codespaces-prebuilds +ms.openlocfilehash: e0962e410f2227a23ff98c8a3e7995ea8ec8a914 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158801' --- - -## Overview +## Información general {% data reusables.codespaces.prebuilds-definition %} -If it currently takes more than 2 minutes to create a codespace for a repository, you are likely to benefit from using prebuilds. This is because, with a prebuild, any source code, editor extensions, project dependencies, commands, and configurations have already been downloaded, installed, and applied before you create a codespace. +Si la creación de un codespace para un repositorio actualmente tarda más de 2 minutos, es probable que el uso de precompilaciones te beneficie. Esto se debe a que, con una precompilación, cualquier código fuente, extensiones del editor, dependencias del proyecto, comandos y configuraciones ya se han descargado, instalado y aplicado antes de crear un codespace. -By default, whenever you push changes to your repository, {% data variables.product.prodname_github_codespaces %} uses {% data variables.product.prodname_actions %} to automatically update your prebuilds. +De manera predeterminada, siempre que insertes cambios en el repositorio, {% data variables.product.prodname_github_codespaces %} usa {% data variables.product.prodname_actions %} para actualizar automáticamente las precompilaciones. -When prebuilds are available for a particular branch of a repository, a particular dev container configuration file, and for your region, you'll see the "{% octicon "zap" aria-label="The zap icon" %} Prebuild ready" label in the list of machine type options when you create a codespace. If a prebuild is still being created, you will see the "{% octicon "history" aria-label="The history icon" %} Prebuild in progress" label. 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)." +Cuando las precompilaciones estén disponibles para una rama determinada de un repositorio, un archivo de configuración de contenedor de desarrollo determinado y para la región, verás la etiqueta "{% octicon "zap" aria-label="The zap icon" %} Listo para precompilación" en la lista de opciones de tipos de máquinas al crear un codespace. Si todavía se está creando una precompilación, verás la etiqueta "{% octicon "history" aria-label="The history icon" %} Precompilación en curso". Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)". -![The dialog box for choosing a machine type](/assets/images/help/codespaces/choose-custom-machine-type.png) +![La caja de diálogo para elegir un tipo de máquina](/assets/images/help/codespaces/choose-custom-machine-type.png) -When you create a codespace from a template on the "Your codespaces" page, {% data variables.product.prodname_dotcom %} may automatically use a prebuild to speed up creation time. For more information on templates, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)." +Al crear un codespace a partir de una plantilla en la página "Tus codespaces", {% data variables.product.prodname_dotcom %} puedes usar automáticamente una precompilación para acelerar el tiempo de creación. Para obtener más información sobre las plantillas, consulta "[Creación de un codespace a partir de una plantilla](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)". -## The prebuild process +## Proceso de precompilación -To create a prebuild you set up a prebuild configuration. When you save the configuration, a {% data variables.product.prodname_actions %} workflow runs to create each of the required prebuilds; one workflow per prebuild. Workflows also run whenever the prebuilds for your configuration need to be updated. This can happen at scheduled intervals, on pushes to a prebuild-enabled repository, or when you change the dev container configuration. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)." +Para crear una precompilación, establezca una configuración de precompilación. Al guardar la configuración, se ejecuta un flujo de trabajo de {% data variables.product.prodname_actions %} para crear cada una de las precompilaciones necesarias; con un flujo de trabajo por precompilación. Los flujos de trabajo también se ejecutan cada vez que es necesario actualizar las precompilaciones de la configuración. Esto puede ocurrir a intervalos programados, en inserciones en un repositorio habilitado para precompilación o al cambiar la configuración del contenedor de desarrollo. Para obtener más información, consulta "[Configuración de precompilaciones](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)". -When a prebuild configuration workflow runs, {% data variables.product.prodname_dotcom %} creates a temporary codespace, performing setup operations up to and including any `onCreateCommand` and `updateContentCommand` commands in the `devcontainer.json` file. No `postCreateCommand` commands are run during the creation of a prebuild. For more information about these commands, see the [`devcontainer.json` reference](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) in the {% data variables.product.prodname_vscode_shortname %} documentation. A snapshot of the generated container is then taken and stored. +Cuando se ejecuta un flujo de trabajo de configuración de precompilación, {% data variables.product.prodname_dotcom %} crea un codespace temporal, realizando operaciones de configuración hasta e incluyendo los comandos `onCreateCommand` y `updateContentCommand` en el archivo `devcontainer.json`. No se ejecutan comandos `postCreateCommand` durante la creación de un precompilación. Para obtener más información sobre estos comandos, consulte la [`devcontainer.json` referencia](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) en la documentación de {% data variables.product.prodname_vscode_shortname %}. Después, se toma y almacena una instantánea del contenedor generado. -As with other {% data variables.product.prodname_actions %} workflows, running a prebuild configuration workflow will either consume some of the {% data variables.product.prodname_actions %} minutes included with your account, if you have any, or it will incur charges for {% data variables.product.prodname_actions %} minutes. Storage of codespace prebuilds is billed in the same way as storage of active or stopped codespaces. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-codespaces-prebuilds)." +Al igual que con otros flujos de trabajo de {% data variables.product.prodname_actions %}, la ejecución de flujo de trabajo de configuración de precompilación consumirá algunos de los minutos de {% data variables.product.prodname_actions %} incluidos en la cuenta, si tienes alguno, o incurrirá en cargos por minutos de {% data variables.product.prodname_actions %}. El almacenamiento de precompilaciones de codespace se factura de la misma manera que el almacenamiento de codespaces activos o detenidos. Para más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-codespaces-prebuilds)". -When you create a codespace from a prebuild, {% data variables.product.prodname_dotcom %} downloads the existing container snapshot from storage and deploys it on a fresh virtual machine, completing the remaining commands specified in the dev container configuration. Since many operations have already been performed, such as cloning the repository, creating a codespace from a prebuild can be substantially quicker than creating one without a prebuild. This is true where the repository is large and/or `onCreateCommand` commands take a long time to run. +Al crear un codespace a partir de una precompilación, {% data variables.product.prodname_dotcom %} descarga la instantánea de contenedor existente del almacenamiento y la implementa en una máquina virtual nueva, completando los comandos restantes especificados en la configuración del contenedor de desarrollo. Dado que ya se han realizado muchas operaciones, como clonar el repositorio, la creación de un codespace a partir de una precompilación puede ser considerablemente más rápida que la creación de uno sin una precompilación. Esto se aplica cuando el repositorio es grande o los comandos `onCreateCommand` tardan mucho tiempo en ejecutarse. -## About pushing changes to prebuild-enabled branches +## Acerca de la inserción de cambios en ramas habilitadas para precompilación -By default, each push to a branch that has a prebuild configuration results in a {% data variables.product.prodname_dotcom %}-managed {% data variables.product.prodname_actions %} workflow run to update the prebuild. The prebuild workflow has a concurrency limit of one workflow run at a time for a given prebuild configuration, unless changes were made that affect the dev container configuration for the associated repository. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." If a run is already in progress, the workflow run that was queued most recently queued will run next, after the current run completes. +De manera predeterminada, cada inserción en una rama que tiene una configuración de precompilación da como resultado una ejecución de flujo de trabajo de {% data variables.product.prodname_actions %} administrada por {% data variables.product.prodname_dotcom %} para actualizar la precompilación. El flujo de trabajo de precompilación tiene un límite de simultaneidad de una ejecución de flujo de trabajo a la vez para una configuración de precompilación determinada, a menos que se realicen cambios que afecten a la configuración del contenedor de desarrollo para el repositorio asociado. Para más información, vea "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". Si una ejecución ya está en curso, la ejecución del flujo de trabajo que se ha puesto en cola más recientemente se ejecutará después, una vez que se complete la ejecución actual. -With the prebuild set to be updated on each push, it means that if there are very frequent pushes to your repository, prebuild updates will occur at least as often as it takes to run the prebuild workflow. That is, if your workflow run typically takes one hour to complete, prebuilds will be created for your repository roughly hourly, if the run succeeds, or more often if there were pushes that change the dev container configuration on the branch. +Con la precompilación establecida para actualizarse en cada inserción, si hay inserciones muy frecuentes en el repositorio, las actualizaciones de precompilación se producirá al menos con la misma frecuencia con la que se tarda en ejecutar el flujo de trabajo de precompilación. Es decir, si la ejecución del flujo de trabajo suele tardar una hora en completarse, se crearán precompilaciones para el repositorio aproximadamente cada hora, si la ejecución se ejecuta correctamente, o con más frecuencia si se han realizado inserciones que cambian la configuración del contenedor de desarrollo en la rama. -For example, let's imagine 5 pushes are made, in quick succession, against a branch that has a prebuild configuration. In this situation: +Por ejemplo, imagine que se realizan cinco inserciones consecutivas en una rama que tiene una configuración de precompilación. En esta situación: -* A workflow run is started for the first push, to update the prebuild. -* If the 4 remaining pushes do not affect the dev container configuration, the workflow runs for these are queued in a "pending" state. +* Se inicia una ejecución de flujo de trabajo para la primera inserción, a fin de actualizar la precompilación. +* Si las cuatro inserciones restantes no afectan a la configuración del contenedor de desarrollo, sus ejecuciones de flujo de trabajo se ponen en cola en un estado "pendiente". - If any of the remaining 4 pushes change the dev container configuration, then the service will not skip that one and will immediately run the prebuild creation workflow, updating the prebuild accordingly if it succeeds. + Si alguna de las cuatro inserciones restantes cambia la configuración del contenedor de desarrollo, el servicio no la omitirá y ejecutará inmediatamente el flujo de trabajo de creación de la precompilación, y la actualizará en consecuencia si se realiza correctamente. -* Once the first run completes, workflow runs for pushes 2, 3, and 4 will be canceled, and the last queued workflow (for push 5) will run and update the prebuild. +* Una vez que se complete la primera ejecución, las ejecuciones de flujo de trabajo para las inserciones 2, 3 y 4 se cancelarán, y el último flujo de trabajo en cola (para la inserción 5) se ejecutará y actualizará la precompilación. diff --git a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md index d8302ff3d2..1f77046eb4 100644 --- a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md +++ b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md @@ -1,7 +1,7 @@ --- -title: Managing prebuilds +title: Administración de precompilaciones shortTitle: Manage prebuilds -intro: 'You can review, modify, and delete the prebuild configurations for your repository.' +intro: 'Puedes revisar, modificar y eliminar las configuraciones de precompilación del repositorio.' versions: fpt: '*' ghec: '*' @@ -9,90 +9,95 @@ type: how_to topics: - Codespaces miniTocMaxHeadingLevel: 3 +ms.openlocfilehash: f39c46d91193db4c1c44ab336d86024b40adcea4 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160333' --- +## Comprobación, cambio y eliminación de las configuraciones de precompilación -## Checking, changing, and deleting your prebuild configurations +Los precompilaciones que configuras para un repositorio se crean y actualizan mediante un flujo de trabajo de {% data variables.product.prodname_actions %}, administrado por el servicio {% data variables.product.prodname_github_codespaces %}. -The prebuilds that you configure for a repository are created and updated using a {% data variables.product.prodname_actions %} workflow, managed by the {% data variables.product.prodname_github_codespaces %} service. +Según los valores de una configuración de precompilación, el flujo de trabajo para actualizar la precompilación se puede desencadenar mediante estos eventos: -Depending on the settings in a prebuild configuration, the workflow to update the prebuild may be triggered by these events: +* Creación o actualización de la configuración de precompilación +* Inserción de una confirmación o una solicitud de incorporación de cambios en una rama configurada para tener precompilaciones +* Cambio de cualquiera de los archivos de configuración del contenedor de desarrollo +* Una programación definida en la configuración de precompilación +* Desencadenamiento manual del flujo de trabajo -* Creating or updating the prebuild configuration -* Pushing a commit or a pull request to a branch that's configured to have prebuilds -* Changing any of the dev container configuration files -* A schedule that you've defined in the prebuild configuration -* Manually triggering the workflow +Los valores de la configuración de precompilación determinan qué eventos desencadenan automáticamente una actualización de la precompilación. Para más información, consulta "[Configuración de precompilaciones](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)". -The settings in the prebuild configuration determine which events automatically trigger an update of the prebuild. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)." +Los usuarios con acceso de administrador a un repositorio pueden comprobar el progreso de las configuraciones de precompilaciones, editarlas y eliminarlas. -People with admin access to a repository can check the progress of prebuilds, edit, and delete prebuild configurations. +### Visualización del progreso de las precompilaciones +Puedes ver el estado actual de la ejecución de flujo de trabajo más reciente para cada configuración de precompilación que haya configurado en la página {% data variables.product.prodname_github_codespaces %} de la configuración del repositorio. Por ejemplo, "Actualmente en ejecución" o "Última ejecución hace 1 hora". -### Viewing the progress of prebuilds -You can view the current status of the latest workflow run for each prebuild configuration you've set up on the {% data variables.product.prodname_github_codespaces %} page of your repository settings. For example, "Currently running" or "Last run 1 hour ago." +A fin de ver la salida del registro para la ejecución más reciente del flujo de trabajo de precompilación, haga clic en **Ver salida**. -To see the log output for the latest prebuild workflow run, click **See output**. +![El botón "Ver salida"](/assets/images/help/codespaces/prebuilds-see-output.png) -![The 'See output' button](/assets/images/help/codespaces/prebuilds-see-output.png) +Esto muestra la salida de la ejecución más reciente del flujo de trabajo en la pestaña **Acciones**. -This displays the output of the most recent run of the workflow in the **Actions** tab. +![Salida del flujo de trabajo de precompilación](/assets/images/help/codespaces/prebuilds-log-output.png) -![The prebuild workflow output](/assets/images/help/codespaces/prebuilds-log-output.png) +Como alternativa, para ver todas las ejecuciones de flujo de trabajo de precompilación asociadas a la rama especificada, haga clic en el botón de puntos suspensivos y elija **Ver ejecuciones** en el menú desplegable. -Alternatively, to view all prebuild workflow runs associated with the specified branch, click the ellipsis button and choose **View runs** from the dropdown menu. +![La opción "Ver ejecuciones" en el menú desplegable](/assets/images/help/codespaces/prebuilds-view-runs.png) -![The 'View runs' option in the dropdown menu](/assets/images/help/codespaces/prebuilds-view-runs.png) +Esto muestra el historial de ejecución de flujo de trabajo para las precompilaciones de la rama asociada. -This displays the workflow run history for prebuilds for the associated branch. +![Historial de ejecución de flujo de trabajo](/assets/images/help/codespaces/prebuilds-workflow-runs.png) -![The workflow run history](/assets/images/help/codespaces/prebuilds-workflow-runs.png) +### Edición de una configuración de precompilación -### Editing a prebuild configuration - -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to edit. -1. In the dropdown menu, click **Edit**. +1. En la página {% data variables.product.prodname_codespaces %} de la configuración del repositorio, haga clic en los puntos suspensivos situados a la derecha de la configuración de precompilación que quiera editar. +1. En el menú desplegable, haga clic en **Editar**. - ![The 'Edit' option in the dropdown menu](/assets/images/help/codespaces/prebuilds-edit.png) + ![La opción "Editar" en el menú desplegable](/assets/images/help/codespaces/prebuilds-edit.png) -1. Make the required changes to the prebuild configuration, then click **Update**. +1. Realice los cambios necesarios en la configuración de precompilación y, después, haga clic en **Actualizar**. {% data reusables.codespaces.prebuilds-permission-authorization %} -### Disabling a prebuild configuration +### Deshabilitación de una configuración de precompilación -To pause the update of prebuilds for a configuration, you can disable workflow runs for the configuration. Disabling the workflow runs for a prebuild configuration does not delete any previously created prebuilds for that configuration and, as a result, codespaces will continue to be generated from an existing prebuild. +Si desea pausar la actualización de precompilaciones para una configuración, puede deshabilitar las ejecuciones de flujos de trabajo para la configuración. Deshabilitar las ejecuciones de flujos de trabajo para una configuración de precompilación no elimina ninguna precompilación creada previamente para dicha configuración y, como resultado, se seguirán generando codespaces a partir de una precompilación existente. -Disabling the workflow runs for a prebuild configuration is useful if you need to investigate prebuild creation failures. +Deshabilitar las ejecuciones de flujos de trabajo para una configuración de precompilación resulta útil si necesitas investigar errores en la creación de precompilaciones. -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to disable. -1. In the dropdown menu, click **Disable runs**. +1. En la página {% data variables.product.prodname_codespaces %} de la configuración del repositorio, haz clic en los puntos suspensivos situados a la derecha de la configuración de precompilación que quieres deshabilitar. +1. En el menú desplegable, haz clic en **Deshabilitar ejecuciones**. - ![The 'Disable runs' option in the dropdown menu](/assets/images/help/codespaces/prebuilds-disable.png) + ![La opción "Deshabilitar ejecuciones" en el menú desplegable](/assets/images/help/codespaces/prebuilds-disable.png) -1. To confirm that you want to disable this configuration, click **OK**. +1. Para confirmar que quieres deshabilitar esta configuración, haz clic en **Aceptar**. -### Deleting a prebuild configuration +### Eliminación de una configuración de precompilación -Deleting a prebuild configuration also deletes all previously created prebuilds for that configuration. As a result, shortly after you delete a configuration, prebuilds generated by that configuration will no longer be available when you create a new codespace. +Al eliminar una configuración de precompilación también se eliminan todas las precompilaciones creadas anteriormente para esa configuración. Como resultado, poco después de eliminar una configuración, las precompilaciones generadas por esa configuración ya no estarán disponibles al crear un codespace. -After you delete a prebuild configuration, workflow runs for that configuration that have been queued or started will still run. They will be listed in the workflow run history, along with previously completed workflow runs. +Después de eliminar una configuración de precompilación, las ejecuciones de flujo de trabajo para esa configuración que se han puesto en cola o que se han iniciado se seguirán ejecutando. Se mostrarán en el historial de ejecución de flujo de trabajo, junto con las ejecuciones de flujo de trabajo completadas anteriormente. -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to delete. -1. In the dropdown menu, click **Delete**. +1. En la página {% data variables.product.prodname_codespaces %} de la configuración del repositorio, haga clic en los puntos suspensivos situados a la derecha de la configuración de precompilación que quiera eliminar. +1. En el menú desplegable, haga clic en **Eliminar**. - ![The 'Delete' option in the dropdown menu](/assets/images/help/codespaces/prebuilds-delete.png) + ![La opción "Eliminar" en el menú desplegable](/assets/images/help/codespaces/prebuilds-delete.png) -1. Click **OK** to confirm the deletion. +1. Haga clic en **Aceptar** para confirmar la eliminación. -### Manually trigger prebuilds +### Desencadenamiento manual de precompilaciones -It may be useful to manually trigger a workflow run for a prebuild configuration. Generally this is only necessary if you are debugging a problem with the workflow for a prebuild configuration. +Puede ser útil desencadenar manualmente una ejecución de flujo de trabajo para una configuración de precompilación. Por lo general, esto solo es necesario si va a depurar un problema con el flujo de trabajo para una configuración de precompilación. -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration whose workflow you want to trigger. -1. In the dropdown menu, click **Manually trigger**. +1. En la página {% data variables.product.prodname_codespaces %} de la configuración del repositorio, haga clic en los puntos suspensivos situados a la derecha de la configuración de precompilación cuyo flujo de trabajo quiera desencadenar. +1. En el menú desplegable, haga clic en **Desencadenador manual**. - ![The 'Manually trigger' option in the dropdown menu](/assets/images/help/codespaces/prebuilds-manually-trigger.png) + ![La opción "Desencadenador manual" en el menú desplegable](/assets/images/help/codespaces/prebuilds-manually-trigger.png) -## Further reading +## Información adicional -- "[Troubleshooting prebuilds](/codespaces/troubleshooting/troubleshooting-prebuilds)" +- "[Solución de problemas de precompilaciones](/codespaces/troubleshooting/troubleshooting-prebuilds)" diff --git a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file.md b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file.md new file mode 100644 index 0000000000..f14fd52369 --- /dev/null +++ b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file.md @@ -0,0 +1,79 @@ +--- +title: Adding features to a devcontainer.json file +shortTitle: Adding features +intro: With features, you can quickly add tools, runtimes, or libraries to your dev container configuration. +allowTitleToDifferFromFilename: true +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Set up +--- + +{% data reusables.codespaces.about-features %} Use the tabs in this article to display instructions for each of these ways of adding features. + +## Adding features to a `devcontainer.json` file + +{% webui %} + +1. Navigate to your repository on {% data variables.product.prodname_dotcom_the_website %}, find your `devcontainer.json` file, and click {% octicon "pencil" aria-label="The edit icon" %} to edit the file. + + If you don't already have a `devcontainer.json` file, you can create one now. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#creating-a-custom-dev-container-configuration)." +1. To the right of the file editor, in the **Marketplace** tab, browse or search for the feature you want to add, then click the name of the feature. + + ![Screenshot of the Terraform feature in the Marketplace tab, with "Terra" in the search bar](/assets/images/help/codespaces/feature-marketplace.png) +3. Under "Installation," click the code snippet to copy it to your clipboard, then paste the snippet into the `features` object in your `devcontainer.json` file. + + ![Screenshot of a code block in the Installation section of the Marketplace tab](/assets/images/help/codespaces/feature-installation-code.png) + + ```JSON + "features": { + ... + "ghcr.io/devcontainers/features/terraform:1": {}, + ... + } + ``` +1. By default, the latest version of the feature will be used. To choose a different version, or configure other options for the feature, expand the properties listed under "Options" to view the available values, then add the options by manually editing the object in your `devcontainer.json` file. + + ![Screenshot of the Options section of the Marketplace tab, with "version" and "tflint" expanded](/assets/images/help/codespaces/feature-options.png) + + ```JSON + "features": { + ... + "ghcr.io/devcontainers/features/terraform:1": { + "version": "1.1", + "tflint": "latest" + }, + ... + } + ``` +1. Commit the changes to your `devcontainer.json` file. + +The configuration changes will take effect in new codespaces created from the repository. To make the changes take effect in existing codespaces, you will need to pull the updates to the `devcontainer.json` file into your codespace, then rebuild the container for the codespace. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)." + +{% endwebui %} + +{% vscode %} + +{% note %} + +To add features 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). + +{% endnote %} + +{% data reusables.codespaces.command-pallette %} +2. Start typing "Configure" and select **Codespaces: Configure Dev Container Features**. + + ![The Configure Devcontainer Features command in the Command Palette](/assets/images/help/codespaces/codespaces-configure-features.png) + +3. Update your feature selections, then click **OK**. + + ![The select additional features menu during container configuration](/assets/images/help/codespaces/select-additional-features.png) + +4. If you're working in a codespace, a prompt will appear in the lower-right corner. To rebuild the container and apply the changes to the codespace you're working in, click **Rebuild Now**. + + !["Codespaces: Rebuild Container" in the Command Palette](/assets/images/help/codespaces/rebuild-prompt.png) + +{% endvscode %} \ No newline at end of file diff --git a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md index 70f431a081..b489a836ba 100644 --- a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md +++ b/translations/es-ES/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: Introducción a los contenedores dev +intro: 'Cuando trabajas en un codespace, el entorno en el que trabajas se crea mediante un contenedor de desarrollo hospedado en una máquina virtual.' 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: 0b47f0292eb3a13467a8227ac323d289f9712223 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158777' --- +## Acerca de los contenedores dev -## About dev containers +Los contenedores de desarrollo son contenedores de Docker que están configurados específicamente para proporcionar un entorno de desarrollo completo. Siempre que trabajes en un codespace, estarás usando un contenedor de desarrollo en una máquina virtual. -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. +Puedes configurar el contenedor de desarrollo para un repositorio a fin de que los codespaces creados para ese repositorio te proporcionen un entorno de desarrollo personalizado, completo con todas las herramientas y entornos de ejecución que necesitas para trabajar en un proyecto específico. Si no defines una configuración en el repositorio, {% data variables.product.prodname_github_codespaces %} usa una configuración predeterminada, que incluye muchas de las herramientas comunes que el equipo podría necesitar para el desarrollo con el proyecto. Para obtener más información, consulta "[Uso de la configuración predeterminada del contenedor de desarrollo](#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)." +Los archivos de configuración de un contenedor de desarrollo se incluyen en un directorio `.devcontainer` del repositorio. Puedes usar {% data variables.product.prodname_vscode %} para agregar archivos de configuración automáticamente. Puedes elegir entre una selección de configuraciones predefinidas para varios tipos de proyecto. Puedes usarlos sin ninguna configuración adicional, o bien puedes editar las configuraciones para refinar el entorno de desarrollo que producen. Para obtener más información, consulta "[Uso de una configuración predefinida del contenedor de desarrollo](#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)." +Como alternativa, puedes agregar tus propios archivos de configuración personalizados. Para obtener más información, consulta "[Creación de una configuración personalizada de contenedor de desarrollo](#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)." +Puedes definir una única configuración de contenedor de desarrollo para un repositorio, configuraciones diferentes para distintas ramas o varias configuraciones. Cuando hay varias configuraciones disponibles, los usuarios pueden elegir su configuración preferida cuando crean un codespace. Esto es especialmente útil para repositorios de gran tamaño que contienen código fuente en diferentes lenguajes de programación o para proyectos diferentes. Puedes crear una selección de configuraciones que permitan a los distintos equipos trabajar en un codespace configurado adecuadamente para el trabajo que están realizando. -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)." +Al crear un codespace a partir de una plantilla, puedes empezar con uno o varios archivos de configuración de contenedor de desarrollo en el área de trabajo. Para configurar aún más el entorno, puedes agregar o quitar la configuración de estos archivos y recompilar el contenedor para aplicar los cambios en el espacio de código en el que estás trabajando. Si publicas el codespace en un repositorio en {% data variables.product.product_name %}, los codespaces creados a partir de ese repositorio compartirán la configuración que hayas definido. Para obtener más información, consulta "[Aplicación de cambios de configuración a un codespace](#applying-configuration-changes-to-a-codespace)" y "[Creación de un codespace a partir de una plantilla](/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. +El archivo principal de una configuración de contenedor de desarrollo es el archivo `devcontainer.json`. Puedes usar este archivo a fin de determinar el entorno de los codespaces creados para el repositorio. El contenido de este archivo define un contenedor de desarrollo que puede incluir marcos, herramientas, extensiones y desvío de puertos. El archivo `devcontainer.json` normalmente contiene una referencia a un Dockerfile, que normalmente se encuentra junto con el archivo `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)." +Si creas un codespace desde un repositorio sin un archivo `devcontainer.json`, o si empiezas desde la plantilla en blanco de {% data variables.product.company_short %}, se usa la configuración predeterminada del contenedor de desarrollo. Para obtener más información, consulta "[Uso de la configuración predeterminada del contenedor de desarrollo](#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`. +El archivo `devcontainer.json` se encuentra normalmente en el directorio `.devcontainer` del repositorio. Como alternativa, puedes localizarlo directamente en la raíz del repositorio, en cuyo caso el nombre de archivo debe comenzar con un punto: `.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: +Si quieres tener una selección de configuraciones de contenedor de desarrollo en el repositorio, cualquier alternativa al archivo `.devcontainer/devcontainer.json` (o `.devcontainer.json`) debe encontrarse en su propio subdirectorio en la ruta de acceso `.devcontainer/SUBDIRECTORY/devcontainer.json`. Por ejemplo, podrías tener una selección de dos configuraciones: * `.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. +Cuando tienes varios archivos `devcontainer.json` en el repositorio, cada codespace se crea a partir de una de las configuraciones únicamente. La configuración no se puede importar ni heredar entre archivos `devcontainer.json`. Si un archivo `devcontainer.json` de un subdirectorio personalizado tiene archivos dependientes, como Dockerfile o scripts que se ejecutan mediante comandos en el archivo `devcontainer.json`, se recomienda colocar estos archivos en el mismo subdirectorio. -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)." +Para obtener información sobre cómo elegir la configuración de contenedor de desarrollo preferida al crear un codespace, consulta "[Creación de un codespace para un repositorio](/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 +#### Procedimientos para usar 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. +Es útil pensar en `devcontainer.json` como un archivo que proporciona "customization" (personalización) en lugar de "personalization" (personalización). Solo debes incluir cosas que todos los usuarios que trabajan en el código base necesitan como elementos estándar del entorno de desarrollo, no como cosas que sean preferencias personales. Las cosas como linters son buenas para estandarizar y exigir que todos los usuarios lo tengan instalado, por lo que son buenas para incluir en tu archivo `devcontainer.json`. Las cosas como los decoradores de la interfaz de usuario o los temas son opciones personales que no deben colocarse en el archivo `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)." +Puedes personalizar los codespaces mediante dotfiles y la sincronización de la configuración. Para más información, consulta "[Personalización de {% data variables.product.prodname_github_codespaces %} para tu cuenta](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account)". ### Dockerfile -You can add a Dockerfile as part of your dev container configuration. +Puedes agregar un Dockerfile como parte de la configuración del contenedor de desarrollo. -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 es un archivo de texto que contiene las instrucciones necesarias para crear una imagen de contenedor de Docker. Esta imagen se usa para generar un contenedor de desarrollo cada vez que alguien crea un codespace mediante el archivo `devcontainer.json` que hace referencia a este Dockerfile. Normalmente, las instrucciones del Dockerfile comienzan haciendo referencia a una imagen primaria en la que se basa la imagen que se creará. Esto va seguido de comandos que se ejecutan durante el proceso de creación de imágenes, por ejemplo, para instalar paquetes de software. -The Dockerfile for a dev container is typically located in the `.devcontainer` folder, alongside the `devcontainer.json` in which it is referenced. +El Dockerfile de un contenedor de desarrollo se encuentra normalmente en la carpeta `.devcontainer`, junto con el elemento `devcontainer.json` en el que se hace referencia al mismo. {% 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)." +**Nota**: Como alternativa al uso de un Dockerfile, puede usar la propiedad `image` en el archivo `devcontainer.json` para hacer referencia directamente a una imagen existente que quieras usar. La imagen que especifiques aquí debe estar permitida por cualquier directiva de imagen de la organización que se haya establecido. Para obtener más información, consulta "[Restringir la imagen base para los codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces)". Si no se encuentra un Dockerfile ni una imagen, se usará la imagen de contenedor predeterminada. Para obtener más información, consulta "[Uso de la configuración predeterminada del contenedor de desarrollo](#using-the-default-dev-container-configuration)". {% endnote %} -#### Simple Dockerfile example +#### Ejemplo de Dockerfile sencillo -The following example uses four instructions: +En el ejemplo siguiente se usan cuatro instrucciones: -`ARG` defines a build-time variable. +`ARG` define una variable en tiempo de compilación. -`FROM` specifies the parent image on which the generated Docker image will be based. +`FROM` especifica la imagen primaria en la que se basará la imagen de Docker generada. -`COPY` copies a file and adds it to the filesystem. +`COPY` copia un archivo y lo agrega al sistema de archivos. -`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` actualiza las listas de paquetes y ejecuta un script. También puedes usar una instrucción `RUN` para instalar software, tal como se muestra en las instrucciones comentadas. Para ejecutar varios comandos, usa `&&` a fin de combinar los comandos en una sola instrucción `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. +Para obtener más información sobre las instrucciones compatibles con Docker, consulta "[Referencia de Dockerfile](https://docs.docker.com/engine/reference/builder)" en la documentación de Docker. -#### Using a Dockerfile +#### Uso de un Dockerfile -To use a Dockerfile as part of a dev container configuration, reference it in your `devcontainer.json` file by using the `dockerfile` property. +Para usar un Dockerfile como parte de una configuración de contenedor de desarrollo, haz referencia a él en el archivo `devcontainer.json` mediante la propiedad `dockerfile`. ```json{:copy} { @@ -111,130 +116,130 @@ 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. +Hay varias opciones disponibles si quieres usar la orquestación de contenedores existente en el contenedor de desarrollo. Para obtener más información, consulta la sección "Opciones de orquestación" de la [especificación](https://containers.dev/implementors/spec/#orchestration-options) en el sitio web de contenedores de desarrollo. -## Using the default dev container configuration +## Uso de la configuración predeterminada del contenedor de desarrollo -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. +Si no defines una configuración en tu repositorio, {% data variables.product.prodname_dotcom %} creará un codespace con una imagen predeterminada de Linux. Esta imagen de Linux incluye varias versiones en tiempo de ejecución para lenguajes populares como Python, Node, PHP, Java, Go, C++, Ruby y .NET Core/C#. Se usan las versiones LTS o más recientes de estos lenguajes. También hay herramientas para admitir la ciencia de datos y el aprendizaje automático, como JupyterLab y Conda. La imagen también incluye otras herramientas y utilidades para desarrolladores como Git, la CLI de GitHub, yarn, openssh y vim. Para ver todos los lenguajes, tiempos de ejecución y herramientas que se incluyen, usa el comando `devcontainer-info content-url` dentro del terminal de codespace y sigue la dirección URL que genera el comando. -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. +Para obtener información sobre lo que se incluye en la imagen de Linux predeterminada, consulta el repositorio [`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. +La configuración predeterminada es una buena opción si estás trabajando en un proyecto pequeño que utiliza los lenguajes y herramientas que proporciona {% data variables.product.prodname_github_codespaces %}. -## Using a predefined dev container configuration +## Uso de una configuración predefinida de contenedor de desarrollo -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. +Si usas {% data variables.product.prodname_codespaces %} en {% data variables.product.prodname_vscode %}, o en un explorador web, puedes crear una configuración de contenedor de desarrollo para el repositorio eligiendo una lista de configuraciones predefinidas. Estas configuraciones proporcionan una configuración común para tipos de proyecto en particular, y pueden ayudarte a comenzar rápidamente con una configuración que ya tenga las opciones adecuadas para el contenedor, la configuración de {% data variables.product.prodname_vscode %}, y las extensiones de {% data variables.product.prodname_vscode %} que deben estar instaladas. -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. +Utilizar una configuración predefinida es una gran idea si necesitas extensibilidad adicional. También puedes iniciar con una configuración predefinida y modificarla conforme lo requieras de acuerdo con el proyecto. Para obtener más información sobre las definiciones de contenedores de desarrollo predefinidos, consulta el repositorio [`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. +Puedes agregar una configuración predefinida de contenedor de desarrollo mientras trabajas en un codespace o en un repositorio localmente. Para hacerlo en {% data variables.product.prodname_vscode_shortname %} mientras trabajas localmente y no estás conectado a un espacio de código, debes tener la extensión "Contenedores de desarrollo" instalada y habilitada. Para obtener más información sobre esta extensión, consulta [{% data variables.product.prodname_vs_marketplace_shortname %}](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers). En el procedimiento siguiente se describe el proceso cuando se usa un codespace. Los pasos de {% data variables.product.prodname_vscode_shortname %} cuando no estás conectado a un codespace son muy similares. {% data reusables.codespaces.command-palette-container %} -1. Click the definition you want to use. +1. Haz clic en la definición que quieras utilizar. - ![Screenshot of a list of predefined container definitions](/assets/images/help/codespaces/predefined-container-definitions-list.png) + ![Captura de pantalla de una lista de definiciones de contenedores predefinidas](/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. Sigue los mensajes para personalizar tu definición. Para obtener más información sobre las opciones disponibles para personalizar la definición, consulte "[Agregar características adicionales al archivo `devcontainer.json`](#adding-additional-features-to-your-devcontainerjson-file)". +1. Haga clic en **OK**. - ![Screenshot of the OK button](/assets/images/help/codespaces/prebuilt-container-ok-button.png) + ![Captura de pantalla del botón Aceptar](/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. Si estás trabajando en un codespace, aplica los cambios; para ello, haz clic en **Rebuild now** (Recompilar ahora) en el mensaje situado en la parte inferior derecha de la ventana. Para obtener más información sobre cómo recompilar el contenedor, consulte "[Aplicación de cambios a la configuración](#applying-configuration-changes-to-a-codespace)". - ![Screenshot of a prompt to 'Rebuild now'](/assets/images/help/codespaces/rebuild-prompt.png) + ![Captura de pantalla de un mensaje para 'Recompilar ahora'](/assets/images/help/codespaces/rebuild-prompt.png) -### Adding additional features to your `devcontainer.json` file +### Agregar características adicionales al archivo `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 %} Para obtener más información, consulta "[Agregar características a un archivo `devcontainer.json`](/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file?tool=vscode)". -## Creating a custom dev container configuration +## Creación de una configuración personalizada de contenedor de desarrollo -If none of the predefined configurations meets your needs, you can create a custom configuration by writing your own `devcontainer.json` file. +Si no hay ninguna de las configuraciones predefinidas que satisfaga tus necesidades, puedes crear una configuración personalizada escribiendo tu propio archivo `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. +* Si vas a agregar un único archivo `devcontainer.json` que usarán todos los usuarios que creen un codespace desde el repositorio, crea el archivo en un directorio `.devcontainer` en la raíz del repositorio. +* Si quieres ofrecer a los usuarios una opción de configuración, puedes crear varios archivos personalizados `devcontainer.json`, cada uno ubicado en un subdirectorio independiente del directorio `.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)." + **Notas**: + - No se pueden encontrar los archivos `devcontainer.json` en directorios de más de un nivel por debajo de `.devcontainer`. Por ejemplo, un archivo en `.devcontainer/teamA/devcontainer.json` funcionará, pero en `.devcontainer/teamA/testing/devcontainer.json` no. + - {% data reusables.codespaces.configuration-choice-templates %} Para obtener más información, consulta "[Configuración de un repositorio de plantillas para {% 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)." + Si se encuentran varios archivos `devcontainer.json` en el repositorio, se mostrarán en la página de opciones de creación del codespace. Para obtener más información, consulta "[Creación de un codespace para un repositorio](/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) + ![Captura de pantalla de una selección de archivos de configuración](/assets/images/help/codespaces/configuration-file-choice.png) -### Adding a `devcontainer.json` file +### Adición de un archivo `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**. +Si aún no tienes un archivo `devcontainer.json` en el repositorio, puedes agregar rápidamente uno de {% data variables.product.prodname_dotcom_the_website %}. +1. Ve al repositorio y haz clic en la lista desplegable **{% octicon "code" aria-label="The code icon" %} de código**. +1. En la pestaña **Codespaces**, haz clic en los puntos suspensivos ( **...** ) y selecciona **Configurar contenedor de desarrollo**. - ![Screenshot of the Code dropdown, with "Configure dev container" highlighted](/assets/images/help/codespaces/configure-dev-container.png) + ![Captura de pantalla de la lista desplegable Código, con "Configurar contenedor de desarrollo" resaltado](/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)." +Se abrirá un nuevo archivo `.devcontainer/devcontainer.json` en el editor. El archivo contendrá algunas propiedades iniciales, incluido un objeto `features` al que puedes agregar nuevas herramientas, bibliotecas o entornos de ejecución. Para obtener más información, consulta "[Agregar características a un archivo `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. +Si el repositorio ya contiene uno o varios archivos `devcontainer.json`, al hacer clic en **Configurar contenedor de desarrollo** se abrirá el archivo `devcontainer.json` existente con la prioridad más alta según la [especificación](https://containers.dev/implementors/spec/#devcontainerjson) de containers.dev. -### Default configuration selection during codespace creation +### Selección de configuración predeterminada durante la creación del codespace -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. +Si `.devcontainer/devcontainer.json` o `.devcontainer.json` existen, uno de los dos será la selección predeterminada en la lista de archivos de configuración disponibles al crear un codespace. Si no existe ningún archivo, la configuración predeterminada del contenedor de desarrollo se seleccionará de manera predeterminada. -![Screenshot of the default configuration choice selected](/assets/images/help/codespaces/configuration-file-choice-default.png) +![Captura de pantalla de la opción de configuración predeterminada seleccionada](/assets/images/help/codespaces/configuration-file-choice-default.png) -### Editing the devcontainer.json file +### Edición del archivo 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 %} +Puedes agregar y editar las claves de configuración compatibles en el archivo `devcontainer.json` para especificar aspectos del entorno del codespace, como por ejemplo, qué extensiones de {% data variables.product.prodname_vscode_shortname %} se instalarán. {% 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. +El archivo `devcontainer.json` se escribe con el formato JSONC (JSON con comentarios). Esto permite incluir comentarios en el archivo de configuración. Para obtener más información, consulta la documentación de {% data variables.product.prodname_vscode_shortname %} "[Edición de JSON con {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/languages/json#_json-with-comments)". {% 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. +**Nota**: Si usas un linter para validar el archivo `devcontainer.json`, asegúrate de que está establecido en JSONC y no en JSON; de lo contrario, los comentarios se notificarán como errores. {% endnote %} -### Interface settings for {% data variables.product.prodname_vscode_shortname %} +### Opciones de la interfaz de {% 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. +Puedes configurar las opciones de interfaz de {% data variables.product.prodname_vscode_shortname %}, con tres ámbitos: Área de trabajo, Remoto [Codespaces] y Usuario. Puedes ver estos ámbitos en el editor de configuración de {% data variables.product.prodname_vscode_shortname %}. -![Screenshot showing the choice of scopes in the Settings editor](/assets/images/help/codespaces/scopes-for-vscode.png) +![Captura de pantalla que muestra la elección de ámbitos en el editor de configuración](/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. +Si se define un valor en varios ámbitos, el valor Área de trabajo tiene prioridad, después Remoto [Codespaces] y después Usuario. -You can define default interface settings for {% data variables.product.prodname_vscode_shortname %} in two places. +Puedes definir la configuración predeterminada del editor de {% data variables.product.prodname_vscode_shortname %} en dos lugares. -* 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. +* La configuración de la interfaz definida en el archivo `.vscode/settings.json` del repositorio se aplica como configuración con ámbito de área de trabajo en el codespace. +* La configuración de la interfaz definida en la clave `settings` del archivo `devcontainer.json` se aplica como configuración con ámbito de [Codespaces] remotos en el codespace. -## Applying configuration changes to a codespace +## Aplicación de cambios de configuración a un codespace -Changes to a configuration will be applied the next time you create a codespace. However, if you're using a codespace in a web browser, in {% data variables.product.prodname_vscode_shortname %}, or in a JetBrains IDE, you can apply configuration changes to the current codespace by rebuilding the container. +Los cambios en una configuración se aplicarán la próxima vez que crees un codespace. Sin embargo, si usas un codespace en un explorador web, en {% data variables.product.prodname_vscode_shortname %}, o en un IDE de JetBrains, puedes aplicar cambios de configuración al codespace actual mediante la regeneración del contenedor. -### Rebuilding the dev container in the {% data variables.product.prodname_vscode_shortname %} web client or desktop application +### Recompilación del contenedor de desarrollo en el cliente web o aplicación de escritorio de {% 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) + ![Captura de pantalla del mensaje de error sobre el modo de recuperación](/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. + - Para diagnosticar el error revisando los registros de creación, haga clic en **View creation log**. + - Para corregir los errores identificados en los registros, actualice el archivo `devcontainer.json`. + - Para aplicar los cambios, vuelve a crear tu contenedor. -### Rebuilding the dev container in a JetBrains IDE +### Recompilación del contenedor de desarrollo en un IDE de JetBrains {% data reusables.codespaces.jetbrains-open-codespace-plugin %} -1. In the {% data variables.product.prodname_github_codespaces %} tool window, click the rebuild icon. +1. En la ventana de herramientas de {% data variables.product.prodname_github_codespaces %}, haz clic en el icono de recompilación. - ![Screenshot of the rebuild button](/assets/images/help/codespaces/jetbrains-plugin-icon-rebuild.png) + ![Captura de pantalla del botón recompilar](/assets/images/help/codespaces/jetbrains-plugin-icon-rebuild.png) -1. Click **Rebuild** when prompted to confirm that you want to rebuild the dev container. -1. Reopen the codespace in your JetBrains IDE. +1. Haz clic en **Recompilar** cuando se te pida que confirmes que quieres recompilar el contenedor de desarrollo. +1. Vuelve a abrir el codespace en el IDE de JetBrains. -## Further reading +## Información adicional -- "[Prebuilding your codespaces](/codespaces/prebuilding-your-codespaces)" +- "[Precompilación de los codespaces](/codespaces/prebuilding-your-codespaces)" diff --git a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines.md b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines.md index e5659b2dc7..39c4f9152a 100644 --- a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines.md +++ b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines.md @@ -1,7 +1,7 @@ --- -title: Setting a minimum specification for codespace machines +title: Configurar una especificación mínima para las máquinas de los codespaces shortTitle: Set a minimum machine spec -intro: 'You can avoid under-resourced machine types being used for {% data variables.product.prodname_github_codespaces %} for your repository.' +intro: 'Puedes evitar que los tipos de máquina con recursos insuficientes se usen en los {% data variables.product.prodname_github_codespaces %} de tu repositorio.' permissions: People with write permissions to a repository can create or edit the codespace configuration. versions: fpt: '*' @@ -10,26 +10,31 @@ type: how_to topics: - Codespaces - Set up +ms.openlocfilehash: b7eeaac84721ff1d9ceab663957b1615952b0623 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159169' --- +## Información general -## Overview +Cada codespace que creas se hospeda en una máquina virtual independiente. Al crear un codespace a partir de un repositorio, normalmente puedes elegir entre diferentes tipos de máquinas virtuales. Cada tipo de máquina tiene recursos diferentes (núcleos de procesador, memoria, almacenamiento) y, de forma predeterminada, se usa el tipo de máquina con los recursos mínimos. Para obtener más información, consulte "[Cambio del tipo de máquina para el codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)". -Each codespace that you create is hosted on a separate virtual machine. When you create a codespace from a repository, you can usually choose from different types of virtual machines. Each machine type has different resources (processor cores, memory, storage) and, by default, the machine type with the least resources is used. For more information, see "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)." - -If your project needs a certain level of compute power, you can configure {% data variables.product.prodname_github_codespaces %} so that only machine types that meet these requirements can be used by default, or selected by users. You configure this in a `devcontainer.json` file. +Si tu proyecto necesita cierto nivel de potencia de cómputo, puedes configurar {% data variables.product.prodname_github_codespaces %} para que solo los tipos de máquina que cumplan con estos requisitos se puedan usar de forma predeterminada o los puedan seleccionar los usuarios. Esta configuración se realiza en un archivo `devcontainer.json`. {% data reusables.codespaces.machine-types-for-unpublished-codespaces %} {% note %} -**Important:** Access to some machine types may be restricted at the organization level. Typically this is done to prevent people choosing higher resourced machines that are billed at a higher rate. If your repository is affected by an organization-level policy for machine types you should make sure you don't set a minimum specification that would leave no available machine types for people to choose. For more information, see "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)." +**Importante:** El acceso a algunos tipos de máquina puede estar restringido en el nivel de organización. Habitualmente, esto se hace para prevenir que las personas elijan máquinas con recursos superiores, las cuales se cobran en tazas más altas. Si tu repositorio se ve afectado por la política de tipos de máquina a nivel organizacional, debes asegurarte de que no configures una especificación mínima que impida que las personas seleccionen los tipos de máquina disponibles que necesitan. Para obtener más información, consulte "[Restringir el acceso a los tipos de máquina](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)". {% endnote %} -## Setting a minimum machine specification +## Configurar una especificación de máquina mínima {% data reusables.codespaces.edit-devcontainer-json %} -1. Edit the `devcontainer.json` file, adding the `hostRequirements` property at the top level of the file, within the enclosing JSON object. For example: +1. Edita el archivo `devcontainer.json`, agregando la propiedad `hostRequirements` en el nivel superior del archivo, dentro del objeto JSON envolvente. Por ejemplo: ```json{:copy} "hostRequirements": { @@ -39,16 +44,16 @@ If your project needs a certain level of compute power, you can configure {% dat } ``` - You can specify any or all of the options: `cpus`, `memory`, and `storage`. + Puede especificar una de las opciones o todas: `cpus`, `memory` y `storage`. - To check the specifications of the {% data variables.product.prodname_github_codespaces %} machine types that are currently available for your repository, step through the process of creating a codespace until you see the choice of machine types. 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)." + Para verificar las especificaciones de los tipos de máquina de {% data variables.product.prodname_github_codespaces %} que actualmente están disponibles para tu repositorio, realiza el proceso de crear un codespace hasta que veas la elección de tipos de máquina. Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)". -1. Save the file and commit your changes to the required branch of the repository. +1. Guarda el archivo y confirma tus cambios a la rama requerida del repositorio. - Now when you create a codespace for that branch of the repository, and you go to the creation configuration options, you will only be able to select machine types that match or exceed the resources you've specified. + Ahora, cuando crees un codespace para esta rama del repositorio y vayas a las opciones de configuración de creación, solo podrás seleccionar tipos de máquina que coincidan con los recursos que especificaste o los excedan. - ![Dialog box showing a limited choice of machine types](/assets/images/help/codespaces/machine-types-limited-choice.png) + ![Caja de diálogo que muestra una selección limitada de tipos de máquina](/assets/images/help/codespaces/machine-types-limited-choice.png) -## Further reading +## Información adicional -- "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)" +- "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)" diff --git a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces.md b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces.md new file mode 100644 index 0000000000..974c949370 --- /dev/null +++ b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces.md @@ -0,0 +1,88 @@ +--- +title: Configuración de un repositorio de plantilla para GitHub Codespaces +shortTitle: Set up a template repo +intro: 'Puedes ayudar a los usuarios a empezar a trabajar en un proyecto configurando un repositorio de plantilla para utilizarlo con {% data variables.product.prodname_github_codespaces %}.' +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Set up +ms.openlocfilehash: 155aa9bf839301439d2746b4b6f0f0575d2e60ff +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159915' +--- +## Introducción + +Al configurar un repositorio de plantilla, puedes ayudar a los usuarios a empezar a trabajar con el marco, la biblioteca u otro proyecto en {% data variables.product.prodname_github_codespaces %}. Los usuarios podrán empezar a trabajar con los archivos de plantilla inmediatamente en un entorno de desarrollo basado en la nube, sin tener que preocuparse por clonar el repositorio ni por instalar herramientas u otras dependencias. Con cierto grado de configuración, podrás configurar usuarios en un codespace con archivos importantes que ya están abiertos para su edición y con una aplicación que ya se ejecuta en una pestaña del explorador de vista previa en el editor web de {% data variables.product.prodname_vscode_shortname %}. + +Cualquier persona con acceso de lectura al repositorio de plantilla puede crear un codespace desde la página del repositorio en {% data variables.product.product_name %}. Puedes convertir cualquier repositorio existente en una plantilla y no tienes que cambiar ninguna opción de configuración para permitir a los usuarios crear un codespace desde el repositorio de plantilla. Para obtener más información sobre cómo convertir un repositorio en una plantilla, consulta "[Crear un repositorio desde una plantilla](/repositories/creating-and-managing-repositories/creating-a-template-repository)". + +Puedes proporcionar un vínculo con el formato `https://github.com/codespaces/new?template_repository=OWNER/TEMPLATE-REPO` para llevar a los usuarios directamente a una página "Crea un codespace nuevo" de la plantilla. + +![Captura de pantalla de la página "Crea un codespace nuevo"](/assets/images/help/codespaces/create-a-new-codespace-page.png) + +Por ejemplo, podrías proporcionar este vínculo en un tutorial para empezar a trabajar con el marco. En el vínculo, reemplaza `OWNER/TEMPLATE-REPO` por el nombre del repositorio de plantilla. Por ejemplo, `monalisa/octo-template`. + +Cuando alguien cree un codespace a partir de tu plantilla, el contenido del repositorio de plantilla se clonará en su codespace. Cuando el usuario esté a punto, podrá publicar su trabajo en un nuevo repositorio en {% data variables.product.product_name %} que pertenezca a su cuenta personal. Los cargos de uso del codespace se facturarán al usuario que lo creó. Para obtener más información, consulta "[Creación de un codespace a partir de una plantilla](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)". + +## Descripción de la plantilla + +Si no tienes uno, crea un archivo Léame para el repositorio de plantilla en el que se describa el propósito de la plantilla y cómo empezar a trabajar con ella. Para más información, vea "[Acerca de los archivos Léame](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)". + +Se muestra una breve descripción de la plantilla en la página "Crea un codespace nuevo", a la que los usuarios llegan cuando siguen el vínculo `https://github.com/codespaces/new?template_repository=OWNER/TEMPLATE-REPO`. Esta descripción procede del campo **Descripción** que puedes establecer al crear un repositorio. Para editar esta descripción en cualquier momento, ve a la página del repositorio y haz clic en el icono **{% octicon "gear" aria-label="The Settings gear" %}** situado junto a la sección **Acerca de**, en la parte derecha de la página. + +![Captura de pantalla de la sección "Acerca de" en una página del repositorio](/assets/images/help/repository/repository-settings-icon.png) + +## Adición de archivos de inicio + +Los repositorios de plantilla suelen contener archivos de inicio con código reutilizable para que los usuarios puedan empezar a trabajar rápidamente con una biblioteca, un marco u otra tecnología. + +Para obtener instrucciones sobre los tipos de archivos que se deben incluir, puedes consultar los archivos de inicio incluidos en las plantillas oficiales de {% data variables.product.company_short %} para {% data variables.product.prodname_github_codespaces %}, como se indica a continuación. + +{% data reusables.codespaces.your-codespaces-procedure-step %} {% data reusables.codespaces.view-all-templates-step %} +1. Para ver el repositorio de plantilla que contiene los archivos de la plantilla, haz clic en el nombre de la plantilla. + + ![Captura de pantalla de la sección "Explorar plantillas de inicio rápido", con la opción "React" resaltada](/assets/images/help/codespaces/react-template-name.png) + +## Configuración de la imagen de contenedor + +Puedes agregar archivos de configuración de contenedor de desarrollo al repositorio de plantilla a fin de personalizar el entorno de desarrollo para los usuarios que usan la plantilla con {% data variables.product.prodname_github_codespaces %}. Puedes elegir entre una lista de opciones de configuración predefinidas en {% data variables.product.prodname_vscode %} o puedes crear una configuración personalizada escribiendo tu propio archivo `devcontainer.json`. Si no agregas archivos de configuración, se usará la imagen de contenedor predeterminada. Para obtener más información, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)" y "[Adición de una configuración de contenedor de desarrollo al repositorio](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)". + +{% note %} + +**Nota:** {% data reusables.codespaces.configuration-choice-templates %} + +{% endnote %} + +Debes configurar el contenedor de desarrollo con las herramientas y la personalización necesarias para ofrecer a los usuarios la mejor experiencia con la plantilla. Por ejemplo, en el archivo `devcontainer.json`: +- Puedes usar la propiedad `openFiles` para definir una lista de archivos que se abrirán automáticamente en el cliente web de {% data variables.product.prodname_vscode_shortname %} cuando se cree un codespace a partir de tu plantilla. +- Si la plantilla contiene archivos para una aplicación web, puedes hacer que la aplicación se ejecute automáticamente en el codespace del usuario. Para ello, usa la propiedad `postAttachCommand` para ejecutar un script que inicie la aplicación en un servidor local tan pronto como el cliente web de {% data variables.product.prodname_vscode_shortname %} se conecte al codespace y establece la propiedad `onAutoForward` de un puerto en `openPreview` para mostrar la aplicación que se ejecuta en ese puerto en un explorador simple insertado en el cliente web de {% data variables.product.prodname_vscode_shortname %}. + +Las siguientes opciones de configuración para una plantilla de React abrirán el archivo `app.js` en el editor del usuario, ejecutarán `npm start` (definido en un archivo `package.json`) para iniciar un servidor local y reenviarán el puerto `3000` a una pestaña del explorador de vista previa en el codespace. + +```JSON +{ + "postAttachCommand": { + "server": "npm start", + }, + + "portsAttributes": { + "3000": { + "label": "Application", + "onAutoForward": "openPreview" + } + }, + + "customizations": { + "codespaces": { + "openFiles": ["src/App.js"] + } + } +} +``` +Para obtener más información, consulta "[Apertura automática de archivos en los codespaces de un repositorio](/codespaces/setting-up-your-project-for-codespaces/automatically-opening-files-in-the-codespaces-for-a-repository)" y la [especificación de contenedores de desarrollo](https://containers.dev/implementors/json_reference/#general-properties) en containers.dev. diff --git a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md index 43cbbf8871..a626dce15e 100644 --- a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md +++ b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md @@ -1,8 +1,8 @@ --- -title: Setting up your C# (.NET) project for GitHub Codespaces +title: Configuración de un proyecto de C# (.NET) para GitHub Codespaces shortTitle: Setting up your C# (.NET) project allowTitleToDifferFromFilename: true -intro: 'Get started with your C# (.NET) project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container.' +intro: 'Crea un contenedor de desarrollo personalizado para empezar a trabajar con tu proyecto de C# (.NET) en {% data variables.product.prodname_github_codespaces %}.' redirect_from: - /codespaces/getting-started-with-codespaces/getting-started-with-your-dotnet-project versions: @@ -12,122 +12,126 @@ topics: - Codespaces hasExperimentalAlternative: true hidden: true +ms.openlocfilehash: 10282aedf3bdb239fa238e546c2fc6280787a6a0 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158617' --- +## Introducción -## Introduction +En esta guía se muestra cómo configurar un proyecto de C# (.NET) en {% data reusables.codespaces.setting-up-project-intro %}. -This guide shows you how to set up your C# (.NET) project {% data reusables.codespaces.setting-up-project-intro %} +### Requisitos previos -### Prerequisites +- Debes tener un proyecto existente de C# (.NET) en un repositorio de {% data variables.product.prodname_dotcom_the_website %}. Si no tiene un proyecto, puede probar este tutorial con el ejemplo siguiente: https://github.com/2percentsilk/dotnet-quickstart. +- Debes tener {% data variables.product.prodname_github_codespaces %} habilitado en tu organización. -- You should have an existing C# (.NET) project in a repository on {% data variables.product.prodname_dotcom_the_website %}. If you don't have a project, you can try this tutorial with the following example: https://github.com/2percentsilk/dotnet-quickstart. -- You must have {% data variables.product.prodname_github_codespaces %} enabled for your organization. +## Paso 1: Abre tu proyecto en un codespace -## Step 1: Open your project in a codespace +1. Debajo del nombre del repositorio, usa el menú desplegable **{% octicon "code" aria-label="The code icon" %} Código** y, en la pestaña **Codespaces**, haz clic en el signo más ({% octicon "plus" aria-label="The plus icon" %}). -1. Under the repository name, use the **{% octicon "code" aria-label="The code icon" %} Code** dropdown menu, and in the **Codespaces** tab, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}). + ![Botón de codespace nuevo](/assets/images/help/codespaces/new-codespace-button.png) - ![New codespace button](/assets/images/help/codespaces/new-codespace-button.png) - -When you create a codespace, your project is created on a remote VM that is dedicated to you. By default, the container for your codespace has many languages and runtimes including .NET. It also includes a common set of tools like git, wget, rsync, openssh, and nano. +Cuando creas un codespace, tu proyecto se crea en una MV remota dedicada a ti. Predeterminadamente, el contenedor de tu codespace tiene muchos lenguajes de programación y tiempos de ejecución, incluyendo a .NET. También incluye un conjunto de herramientas comunes como git, wget, rsync, openssh y nano. {% data reusables.codespaces.customize-vcpus-and-ram %} -## Step 2: Add a dev container configuration to your repository from a template +## Paso 2: agregar una configuración de contenedor de desarrollo al repositorio desde una plantilla -The default development container, or "dev container," for {% data variables.product.prodname_github_codespaces %} comes with the latest .NET version and common tools preinstalled. However, we recommend that you configure your own dev container to include all of the tools and scripts that your project needs. This will ensure a fully reproducible environment for all {% data variables.product.prodname_github_codespaces %} users in your repository. +El contenedor de desarrollo predeterminado, o «contenedor de desarrollo», para {% data variables.product.prodname_github_codespaces %} viene con la versión más reciente de Java, los administradores de paquetes (Maven, Gradle) y otras herramientas comunes preinstaladas. Sin embargo, recomendamos que configures tu propio contenedor de desarrollo para incluir todas las herramientas y scripts que necesita el proyecto. Esto garantizará un entorno totalmente reproducible para todos los usuarios de {% data variables.product.prodname_github_codespaces %} en el repositorio. {% data reusables.codespaces.setup-custom-devcontainer %} {% data reusables.codespaces.command-palette-container %} -1. For this example, click **C# (.NET)**. If you need additional features you can select any container that’s specific to C# (.NET) or a combination of tools such as C# (.NET) and MS SQL. - ![Select C# (.NET) option from the list](/assets/images/help/codespaces/add-dotnet-prebuilt-container.png) -1. Click the recommended version of .NET. - ![.NET version selection](/assets/images/help/codespaces/add-dotnet-version.png) -1. Accept the default option to add Node.js to your customization. - ![Add Node.js selection](/assets/images/help/codespaces/dotnet-options.png) -{% data reusables.codespaces.rebuild-command %} +1. Para este ejemplo, haga clic en **C# (.NET)** . Si necesitas características adicionales puedes seleccionar cualquier contenedor que sea específico para C# (.NET) o una combinación de herramientas tales como C# (.NET) y MS SQL. + ![Selección de la opción C# (.NET) en la lista](/assets/images/help/codespaces/add-dotnet-prebuilt-container.png) +1. Haz clic en la versión recomendada de .NET. + ![Selección de la versión de .NET](/assets/images/help/codespaces/add-dotnet-version.png) +1. Acepta la opción predeterminada para agregar a Node.js a tu personalización. + ![Selección de agregar Node.js](/assets/images/help/codespaces/dotnet-options.png) {% data reusables.codespaces.rebuild-command %} -### Anatomy of your dev container +### Anatomía de tu contenedor dev -Adding the C# (.NET) dev container template adds a `.devcontainer` folder to the root of your project's repository with the following files: +Al agregar la plantilla de contenedor de desarrollo de C# (.NET), se agrega una carpeta `.devcontainer` a la raíz del repositorio del proyecto con los siguientes archivos: - `devcontainer.json` - Dockerfile -The newly added `devcontainer.json` file defines a few properties that are described after the sample. +En el archivo `devcontainer.json` recién agregado se definen varias propiedades que se describen después del ejemplo. #### devcontainer.json ```json { - "name": "C# (.NET)", - "build": { - "dockerfile": "Dockerfile", - "args": { - // Update 'VARIANT' to pick a .NET Core version: 2.1, 3.1, 5.0 - "VARIANT": "5.0", - // Options - "INSTALL_NODE": "true", - "NODE_VERSION": "lts/*", - "INSTALL_AZURE_CLI": "false" - } - }, + "name": "C# (.NET)", + "build": { + "dockerfile": "Dockerfile", + "args": { + // Update 'VARIANT' to pick a .NET Core version: 2.1, 3.1, 5.0 + "VARIANT": "5.0", + // Options + "INSTALL_NODE": "true", + "NODE_VERSION": "lts/*", + "INSTALL_AZURE_CLI": "false" + } + }, - // Set *default* container specific settings.json values on container create. - "settings": { - "terminal.integrated.shell.linux": "/bin/bash" - }, + // Set *default* container specific settings.json values on container create. + "settings": { + "terminal.integrated.shell.linux": "/bin/bash" + }, - // Add the IDs of extensions you want installed when the container is created. - "extensions": [ - "ms-dotnettools.csharp" - ], + // Add the IDs of extensions you want installed when the container is created. + "extensions": [ + "ms-dotnettools.csharp" + ], - // Use 'forwardPorts' to make a list of ports inside the container available locally. - // "forwardPorts": [5000, 5001], + // Use 'forwardPorts' to make a list of ports inside the container available locally. + // "forwardPorts": [5000, 5001], - // [Optional] To reuse of your local HTTPS dev cert: - // - // 1. Export it locally using this command: - // * Windows PowerShell: - // dotnet dev-certs https --trust; dotnet dev-certs https -ep "$env:USERPROFILE/.aspnet/https/aspnetapp.pfx" -p "SecurePwdGoesHere" - // * macOS/Linux terminal: - // dotnet dev-certs https --trust; dotnet dev-certs https -ep "${HOME}/.aspnet/https/aspnetapp.pfx" -p "SecurePwdGoesHere" - // - // 2. Uncomment these 'remoteEnv' lines: - // "remoteEnv": { - // "ASPNETCORE_Kestrel__Certificates__Default__Password": "SecurePwdGoesHere", - // "ASPNETCORE_Kestrel__Certificates__Default__Path": "/home/vscode/.aspnet/https/aspnetapp.pfx", - // }, - // - // 3. Start the container. - // - // 4. Drag ~/.aspnet/https/aspnetapp.pfx into the root of the file explorer. - // - // 5. Open a terminal in VS Code and run "mkdir -p /home/vscode/.aspnet/https && mv aspnetapp.pfx /home/vscode/.aspnet/https". - // + // [Optional] To reuse of your local HTTPS dev cert: + // + // 1. Export it locally using this command: + // * Windows PowerShell: + // dotnet dev-certs https --trust; dotnet dev-certs https -ep "$env:USERPROFILE/.aspnet/https/aspnetapp.pfx" -p "SecurePwdGoesHere" + // * macOS/Linux terminal: + // dotnet dev-certs https --trust; dotnet dev-certs https -ep "${HOME}/.aspnet/https/aspnetapp.pfx" -p "SecurePwdGoesHere" + // + // 2. Uncomment these 'remoteEnv' lines: + // "remoteEnv": { + // "ASPNETCORE_Kestrel__Certificates__Default__Password": "SecurePwdGoesHere", + // "ASPNETCORE_Kestrel__Certificates__Default__Path": "/home/vscode/.aspnet/https/aspnetapp.pfx", + // }, + // + // 3. Start the container. + // + // 4. Drag ~/.aspnet/https/aspnetapp.pfx into the root of the file explorer. + // + // 5. Open a terminal in VS Code and run "mkdir -p /home/vscode/.aspnet/https && mv aspnetapp.pfx /home/vscode/.aspnet/https". + // - // Use 'postCreateCommand' to run commands after the container is created. - // "postCreateCommand": "dotnet restore", + // Use 'postCreateCommand' to run commands after the container is created. + // "postCreateCommand": "dotnet restore", - // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. - "remoteUser": "vscode" + // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. + "remoteUser": "vscode" } ``` -- **name** - You can name our dev container anything, this is just the default. -- **build** - The build properties. - - **dockerfile** - In the `build` object, `dockerfile` contains the path to the Dockerfile that was also added from the template. +- **name**: puedes asignar el nombre que quieras al contenedor de desarrollo, este es solo el nombre predeterminado. +- **build**: las propiedades de compilación. + - **dockerfile**: en el objeto `build`, `dockerfile` contiene la ruta de acceso al Dockerfile que también se ha agregado desde la plantilla. - **args** - - **variant**: This file only contains one build argument, which is the .NET Core version that we want to use. -- **settings** - These are {% data variables.product.prodname_vscode %} settings. - - **terminal.integrated.shell.linux** - While bash is the default here, you could use other terminal shells by modifying this. -- **extensions** - These are extensions included by default. - - **ms-dotnettools.csharp** - The Microsoft C# extension provides rich support for developing in C#, including features such as IntelliSense, linting, debugging, code navigation, code formatting, refactoring, variable explorer, test explorer, and more. -- **forwardPorts** - Any ports listed here will be forwarded automatically. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." -- **postCreateCommand** - Use this to run commands that aren't defined in the Dockerfile, after your codespace is created. -- **remoteUser** - By default, you’re running as the vscode user, but you can optionally set this to root. + - **variant**: este archivo solo contiene un argumento de compilación, la versión de .NET Core que queremos usar. +- **settings**: la configuración de {% data variables.product.prodname_vscode %}. + - **terminal.integrated.shell.linux**: aunque aquí bash sea el shell de terminal predeterminado, puedes modificarlo y usar otros. +- **extensions**: las extensiones incluidas de forma predeterminada. + - **ms-dotnettools.csharp**: la extensión C# de Microsoft proporciona soporte enriquecido para desarrollar en C#, incluidas características como IntelliSense, linting, depuración, navegación y formato de código, refactorización, explorador de variables, explorador de pruebas y mucho más. +- **forwardPorts**: cualquier puerto que se incluya aquí se reenviará de forma automática. Para más información, vea "[Reenvío de puertos en el codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)". +- **postCreateCommand**: después de crear el codespace, usa esta opción para ejecutar comandos que no están definidos en el Dockerfile. +- **remoteUser**: de manera predeterminada, la ejecución se realiza como el usuario vscode, pero opcionalmente se puede establecer en root. #### Dockerfile @@ -155,26 +159,26 @@ RUN if [ "$INSTALL_AZURE_CLI" = "true" ]; then bash /tmp/library-scripts/azcli-d # RUN su vscode -c "source /usr/local/share/nvm/nvm.sh && npm install -g " 2>&1 ``` -You can use the Dockerfile to add additional container layers to specify OS packages, node versions, or global packages we want included in our container. +Puedes utilizar este Dockerfile para agregar capas de contenedor adicionales y especificar paquetes de SO, versiones de nodo o paquetes globales que queremos incluir en nuestro contenedor. -## Step 3: Modify your devcontainer.json file +## Paso 3: Modifica tu archivo devcontainer.json -With your dev container configuration added and a basic understanding of what everything does, you can now make changes to customize your environment further. In this example, you'll add properties to install extensions and your project dependencies when your codespace launches. +Con la configuración del contenedor de desarrollo agregada y un conocimiento básico de lo que hace cada elemento, ya puedes realizar cambios para personalizar aún más el entorno. En este ejemplo, agregarás porpiedades para instalar extensiones y tus dependencias de pryecto cuando se lance tu codespace. -1. In the Explorer, select the `devcontainer.json` file from the tree to open it. You might have to expand the `.devcontainer` folder to see it. +1. En el Explorador, seleccione el archivo `devcontainer.json` del árbol para abrirlo. Es posible que tenga que expandir la carpeta `.devcontainer` para verlo. - ![devcontainer.json file in the Explorer](/assets/images/help/codespaces/devcontainers-options.png) + ![Archivo de devcontainer.json en el explorador](/assets/images/help/codespaces/devcontainers-options.png) -2. Update your the `extensions` list in your `devcontainer.json` file to add a few extensions that are useful when working with your project. +2. Actualice la lista `extensions` del archivo `devcontainer.json` para agregar algunas extensiones que son útiles al trabajar con el proyecto. ```json{:copy} "extensions": [ - "ms-dotnettools.csharp", - "streetsidesoftware.code-spell-checker", - ], + "ms-dotnettools.csharp", + "streetsidesoftware.code-spell-checker", + ], ``` -3. Uncomment the `postCreateCommand` to restore dependencies as part of the codespace setup process. +3. Quite la marca de comentario de `postCreateCommand` para restaurar las dependencias como parte del proceso de configuración del codespace. ```json{:copy} // Use 'postCreateCommand' to run commands after the container is created. @@ -187,26 +191,26 @@ With your dev container configuration added and a basic understanding of what ev {% data reusables.codespaces.rebuild-reason %} -5. Check your changes were successfully applied by verifying the "Code Spell Checker" extension was installed. +5. Verifica que tus cambios se hayan aplicado con éxito verificando que se haya instalado la extensión "Code Spell Checker". - ![Extensions list](/assets/images/help/codespaces/dotnet-extensions.png) + ![Lista de extensiones](/assets/images/help/codespaces/dotnet-extensions.png) -## Step 4: Run your application +## Paso 4: Ejecución de la aplicación -In the previous section, you used the `postCreateCommand` to install a set of packages via the `dotnet restore` command. With our dependencies now installed, we can run our application. +En la sección anterior, ha usado `postCreateCommand` para instalar un conjunto de paquetes mediante el comando `dotnet restore`. Ahora que instalamos nuestras dependencias, podemos ejecutar nuestra aplicación. -1. Run your application by pressing `F5` or entering `dotnet watch run` in your terminal. +1. Para ejecutar la aplicación, presione `F5` o escriba `dotnet watch run` en el terminal. -2. When your project starts, you should see a "toast" notification message at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, containing a prompt to connect to the port your project uses. +2. Cuando se inicie el proyecto, deberías ver un mensaje de notificación del sistema en la esquina inferior derecha de {% data variables.product.prodname_vscode_shortname %}, que contiene un mensaje para conectarse al puerto que usa el proyecto. - ![Port forwarding "toast" notification](/assets/images/help/codespaces/python-port-forwarding.png) + ![Notificación del sistema sobre el reenvío de puertos](/assets/images/help/codespaces/python-port-forwarding.png) -## Step 5: Commit your changes +## Paso 5: Confirma tus cambios {% data reusables.codespaces.committing-link-to-procedure %} -## Next steps +## Pasos siguientes -You should now be ready start developing your C# (.NET) project in {% data variables.product.prodname_github_codespaces %}. Here are some additional resources for more advanced scenarios. +Ahora deberías estar a punto para empezar a desarrollar tu proyecto de C# (.NET) en {% data variables.product.prodname_github_codespaces %}. Aquí tienes algunos recursos adicionales para situaciones más avanzadas. {% data reusables.codespaces.next-steps-adding-devcontainer %} diff --git a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md index 954d74025b..01f0bace2c 100644 --- a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md +++ b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md @@ -1,8 +1,8 @@ --- -title: Setting up your Java project for GitHub Codespaces +title: Configuración de un proyecto de Java para GitHub Codespaces allowTitleToDifferFromFilename: true shortTitle: Setting up with your Java project -intro: 'Get started with your Java project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container.' +intro: 'Crea un contenedor de desarrollo personalizado para empezar a trabajar con tu proyecto de Java en {% data variables.product.prodname_github_codespaces %}.' redirect_from: - /codespaces/getting-started-with-codespaces/getting-started-with-your-java-project-in-codespaces versions: @@ -12,48 +12,52 @@ topics: - Codespaces hasExperimentalAlternative: true hidden: true +ms.openlocfilehash: b861744483f61bc01e8069188c1ce6298411d57e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158769' --- +## Introducción -## Introduction +En esta guía se muestra cómo configurar un proyecto de Java en {% data reusables.codespaces.setting-up-project-intro %}. -This guide shows you how to set up your Java project {% data reusables.codespaces.setting-up-project-intro %} +### Requisitos previos -### Prerequisites +- Debes tener un proyecto de Java existente en un repositorio de {% data variables.product.prodname_dotcom_the_website %}. Si no tiene un proyecto, puede probar este tutorial con el ejemplo siguiente: https://github.com/microsoft/vscode-remote-try-java. +- Debes tener {% data variables.product.prodname_github_codespaces %} habilitado en tu organización. -- You should have an existing Java project in a repository on {% data variables.product.prodname_dotcom_the_website %}. If you don't have a project, you can try this tutorial with the following example: https://github.com/microsoft/vscode-remote-try-java -- You must have {% data variables.product.prodname_github_codespaces %} enabled for your organization. +## Paso 1: Abre tu proyecto en un codespace -## Step 1: Open your project in a codespace +1. Debajo del nombre del repositorio, usa el menú desplegable **{% octicon "code" aria-label="The code icon" %} Código** y, en la pestaña **Codespaces**, haz clic en el signo más ({% octicon "plus" aria-label="The plus icon" %}). -1. Under the repository name, use the **{% octicon "code" aria-label="The code icon" %} Code** dropdown menu, and in the **Codespaces** tab, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}). + ![Botón de codespace nuevo](/assets/images/help/codespaces/new-codespace-button.png) - ![New codespace button](/assets/images/help/codespaces/new-codespace-button.png) - -When you create a codespace, your project is created on a remote VM that is dedicated to you. By default, the container for your codespace has many languages and runtimes including Java, nvm, npm, and Yarn. It also includes a set of commonly used tools such as git, wget, rsync, openssh, and nano. +Cuando creas un codespace, tu proyecto se crea en una MV remota dedicada a ti. Predeterminadamente, el contenedor para tu codespace tiene muchos lenguajes y tiempos de ejecución, incluyendo Java, nvm, npm y Yarn. También incluye un conjunto de herramientas de uso común como git, wget, rsync, openssh y nano. {% data reusables.codespaces.customize-vcpus-and-ram %} -## Step 2: Add a dev container configuration to your repository from a template +## Paso 2: agregar una configuración de contenedor de desarrollo al repositorio desde una plantilla -The default development container, or "dev container," for {% data variables.product.prodname_github_codespaces %} comes with the latest Java version, package managers (Maven, Gradle), and other common tools preinstalled. However, we recommend that you configure your own dev container to include all of the tools and scripts that your project needs. This will ensure a fully reproducible environment for all {% data variables.product.prodname_github_codespaces %} users in your repository. +El contenedor de desarrollo predeterminado, o «contenedor de desarrollo», para {% data variables.product.prodname_github_codespaces %} viene con la versión más reciente de Java, los administradores de paquetes (Maven, Gradle) y otras herramientas comunes preinstaladas. Sin embargo, recomendamos que configures tu propio contenedor de desarrollo para incluir todas las herramientas y scripts que necesita el proyecto. Esto garantizará un entorno totalmente reproducible para todos los usuarios de {% data variables.product.prodname_github_codespaces %} en el repositorio. {% data reusables.codespaces.setup-custom-devcontainer %} {% data reusables.codespaces.command-palette-container %} -1. For this example, click **Java**. In practice, you could select any container that’s specific to Java or a combination of tools such as Java and Azure Functions. - ![Select Java option from the list](/assets/images/help/codespaces/add-java-prebuilt-container.png) -1. Click the recommended version of Java. - ![Java version selection](/assets/images/help/codespaces/add-java-version.png) -{% data reusables.codespaces.rebuild-command %} +1. Para este ejemplo, haga clic en **Java**. En la práctica, podrías seleccionar cualquier contenedor que sea específico de Java o una combinación de herramientas tales como Java y Azure Functions. + ![Selección de la opción de Java de la lista](/assets/images/help/codespaces/add-java-prebuilt-container.png) +1. Haz clic en la versión recomendada de Java. + ![Selección de la versión de Java](/assets/images/help/codespaces/add-java-version.png) {% data reusables.codespaces.rebuild-command %} -### Anatomy of your dev container +### Anatomía de tu contenedor dev -Adding the Java dev container template adds a `.devcontainer` directory to the root of your project's repository with the following files: +Al agregar la plantilla de contenedor de desarrollo de Java, se agrega un directorio `.devcontainer` a la raíz del repositorio del proyecto con los archivos siguientes: - `devcontainer.json` - Dockerfile -The newly added `devcontainer.json` file defines a few properties that are described after the sample. +En el archivo `devcontainer.json` recién agregado se definen varias propiedades que se describen después del ejemplo. #### devcontainer.json @@ -61,55 +65,55 @@ The newly added `devcontainer.json` file defines a few properties that are descr // For format details, see https://aka.ms/vscode-remote/devcontainer.json or this file's README at: // https://github.com/microsoft/vscode-dev-containers/tree/v0.159.0/containers/java { - "name": "Java", - "build": { - "dockerfile": "Dockerfile", - "args": { - // Update the VARIANT arg to pick a Java version: 11, 14 - "VARIANT": "11", - // Options - "INSTALL_MAVEN": "true", - "INSTALL_GRADLE": "false", - "INSTALL_NODE": "false", - "NODE_VERSION": "lts/*" - } - }, + "name": "Java", + "build": { + "dockerfile": "Dockerfile", + "args": { + // Update the VARIANT arg to pick a Java version: 11, 14 + "VARIANT": "11", + // Options + "INSTALL_MAVEN": "true", + "INSTALL_GRADLE": "false", + "INSTALL_NODE": "false", + "NODE_VERSION": "lts/*" + } + }, - // Set *default* container specific settings.json values on container create. - "settings": { - "terminal.integrated.shell.linux": "/bin/bash", - "java.home": "/docker-java-home", - "maven.executable.path": "/usr/local/sdkman/candidates/maven/current/bin/mvn" - }, + // Set *default* container specific settings.json values on container create. + "settings": { + "terminal.integrated.shell.linux": "/bin/bash", + "java.home": "/docker-java-home", + "maven.executable.path": "/usr/local/sdkman/candidates/maven/current/bin/mvn" + }, - // Add the IDs of extensions you want installed when the container is created. - "extensions": [ - "vscjava.vscode-java-pack" - ], + // Add the IDs of extensions you want installed when the container is created. + "extensions": [ + "vscjava.vscode-java-pack" + ], - // Use 'forwardPorts' to make a list of ports inside the container available locally. - // "forwardPorts": [], + // Use 'forwardPorts' to make a list of ports inside the container available locally. + // "forwardPorts": [], - // Use 'postCreateCommand' to run commands after the container is created. - // "postCreateCommand": "java -version", + // Use 'postCreateCommand' to run commands after the container is created. + // "postCreateCommand": "java -version", - // Uncomment to connect as a non-root user. See https://aka.ms/vscode-remote/containers/non-root. - "remoteUser": "vscode" + // Uncomment to connect as a non-root user. See https://aka.ms/vscode-remote/containers/non-root. + "remoteUser": "vscode" } ``` -- **name** - You can name your dev container anything, this is just the default. -- **build** - The build properties. - - **dockerfile** - In the `build` object, `dockerfile` contains the path to the Dockerfile that was also added from the template. +- **name**: puedes asignar cualquier nombre al contenedor de desarrollo; este es solo el valor predeterminado. +- **build**: las propiedades de compilación. + - **dockerfile**: en el objeto `build`, `dockerfile` contiene la ruta de acceso al Dockerfile que también se ha agregado desde la plantilla. - **args** - - **variant**: This file only contains one build argument, which is the Java version that is passed into the Dockerfile. -- **settings** - These are {% data variables.product.prodname_vscode %} settings that you can set. - - **terminal.integrated.shell.linux** - While bash is the default here, you could use other terminal shells by modifying this. -- **extensions** - These are extensions included by default. - - **vscjava.vscode-java-pack** - The Java Extension Pack provides popular extensions for Java development to get you started. -- **forwardPorts** - Any ports listed here will be forwarded automatically. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." -- **postCreateCommand** - Use this to run commands that aren't defined in the Dockerfile, after your codespace is created. -- **remoteUser** - By default, you’re running as the `vscode` user, but you can optionally set this to `root`. + - **variant**: este archivo solo contiene un argumento de compilación, que es la versión de Java que se pasa al Dockerfile. +- **settings**: se trata de la configuración de {% data variables.product.prodname_vscode %} que puedes establecer. + - **terminal.integrated.shell.linux**: aunque aquí bash sea el shell de terminal predeterminado, puedes modificarlo y usar otros. +- **extensions**: extensiones incluidas de forma predeterminada. + - **vscjava.vscode-java-pack**: el paquete de extensiones de Java proporciona extensiones populares para comenzar con el desarrollo en Java. +- **forwardPorts**: cualquier puerto que se incluya aquí se reenviará de forma automática. Para más información, vea "[Reenvío de puertos en el codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)". +- **postCreateCommand**: después de crear el codespace, usa esta opción para ejecutar comandos que no están definidos en el Dockerfile. +- **remoteUser**: de manera predeterminada, la ejecución se realiza como el usuario `vscode`, pero opcionalmente se puede establecer en `root`. #### Dockerfile @@ -139,17 +143,17 @@ RUN if [ "${INSTALL_NODE}" = "true" ]; then su vscode -c "source /usr/local/shar # RUN su vscode -c "source /usr/local/share/nvm/nvm.sh && npm install -g " 2>&1 ``` -You can use the Dockerfile to add additional container layers to specify OS packages, Java versions, or global packages we want included in our container. +Puedes usar el Dockerfile para agregar capas de contenedor adicionales para especificar paquetes de sistema operativo, versiones de Java o paquetes globales que quieras incluir en nuestro contenedor. -## Step 3: Modify your devcontainer.json file +## Paso 3: Modifica tu archivo devcontainer.json -With your dev container configuration added and a basic understanding of what everything does, you can now make changes to customize your environment further. In this example, you'll add properties to install extensions and your project dependencies when your codespace launches. +Con la configuración del contenedor de desarrollo agregada y un conocimiento básico de lo que hace cada elemento, ya puedes realizar cambios para personalizar aún más el entorno. En este ejemplo, agregarás porpiedades para instalar extensiones y tus dependencias de pryecto cuando se lance tu codespace. -1. In the Explorer, select the `devcontainer.json` file from the tree to open it. You might have to expand the `.devcontainer` folder to see it. +1. En el Explorador, seleccione el archivo `devcontainer.json` del árbol para abrirlo. Es posible que tenga que expandir la carpeta `.devcontainer` para verlo. - ![devcontainer.json file in the Explorer](/assets/images/help/codespaces/devcontainers-options.png) + ![Archivo de devcontainer.json en el explorador](/assets/images/help/codespaces/devcontainers-options.png) -2. Add the following lines to your `devcontainer.json` file after `extensions`. +2. Agregue las siguientes líneas al archivo `devcontainer.json` después de `extensions`. ```json{:copy} "postCreateCommand": "npm install", @@ -162,22 +166,22 @@ With your dev container configuration added and a basic understanding of what ev {% data reusables.codespaces.rebuild-reason %} -## Step 4: Run your application +## Paso 4: Ejecución de la aplicación -In the previous section, you used the `postCreateCommand` to install a set of packages via npm. You can now use this to run our application with npm. +En la sección anterior, ha usado `postCreateCommand` para instalar un conjunto de paquetes mediante npm. Ahora puedes utilizar esto para ejecutar nuestra aplicación con npm. -1. Run your application by pressing `F5`. +1. Presione `F5` para ejecutar la aplicación. -2. When your project starts, you should see a "toast" notification message at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, containing a prompt to connect to the port your project uses. +2. Cuando se inicie el proyecto, deberías ver un mensaje de notificación del sistema en la esquina inferior derecha de {% data variables.product.prodname_vscode_shortname %}, que contiene un mensaje para conectarse al puerto que usa el proyecto. - ![Port forwarding "toast" notification](/assets/images/help/codespaces/codespaces-port-toast.png) + ![Notificación del sistema de enrutamiento de puerto](/assets/images/help/codespaces/codespaces-port-toast.png) -## Step 5: Commit your changes +## Paso 5: Confirma tus cambios {% data reusables.codespaces.committing-link-to-procedure %} -## Next steps +## Pasos siguientes -You should now be ready start developing your Java project in {% data variables.product.prodname_github_codespaces %}. Here are some additional resources for more advanced scenarios. +Ahora ya deberías poder empezar a desarrollar tu proyecto de Java en {% data variables.product.prodname_github_codespaces %}. Aquí tienes algunos recursos adicionales para situaciones más avanzadas. {% data reusables.codespaces.next-steps-adding-devcontainer %} diff --git a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md index b46287cc47..9218cfe9ee 100644 --- a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md +++ b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md @@ -1,8 +1,8 @@ --- -title: Setting up your Node.js project for GitHub Codespaces +title: Configuración de un proyecto de Node.js para GitHub Codespaces allowTitleToDifferFromFilename: true shortTitle: Setting up your Node.js project -intro: 'Get started with your JavaScript, Node.js, or TypeScript project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container.' +intro: 'Crea un contenedor de desarrollo personalizado para empezar a trabajar con tu proyecto de JavaScript, Node.js o TypeScript en {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -16,54 +16,57 @@ topics: - JavaScript hasExperimentalAlternative: true hidden: true +ms.openlocfilehash: 19c29f7d3c8110d1c671a9af46227a399a467800 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159907' --- +## Introducción +En esta guía se muestra cómo configurar un proyecto de JavaScript, Node.js o TypeScript en {% data reusables.codespaces.setting-up-project-intro %}. +### Requisitos previos -## Introduction +- Debes tener un proyecto existente de JavaScript, Node.js, TypeScript en un repositorio de {% data variables.product.prodname_dotcom_the_website %}. Si no tiene un proyecto, puede probar este tutorial con el ejemplo siguiente: https://github.com/microsoft/vscode-remote-try-node. +- Debes tener {% data variables.product.prodname_github_codespaces %} habilitado en tu organización. -This guide shows you how to set up your JavaScript, Node.js, or TypeScript project {% data reusables.codespaces.setting-up-project-intro %} +## Paso 1: Abre tu proyecto en un codespace -### Prerequisites +1. Debajo del nombre del repositorio, usa el menú desplegable **{% octicon "code" aria-label="The code icon" %} Código** y, en la pestaña **Codespaces**, haz clic en el signo más ({% octicon "plus" aria-label="The plus icon" %}). -- You should have an existing JavaScript, Node.js, or TypeScript project in a repository on {% data variables.product.prodname_dotcom_the_website %}. If you don't have a project, you can try this tutorial with the following example: https://github.com/microsoft/vscode-remote-try-node -- You must have {% data variables.product.prodname_github_codespaces %} enabled for your organization. + ![Botón de codespace nuevo](/assets/images/help/codespaces/new-codespace-button.png) -## Step 1: Open your project in a codespace - -1. Under the repository name, use the **{% octicon "code" aria-label="The code icon" %} Code** dropdown menu, and in the **Codespaces** tab, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}). - - ![New codespace button](/assets/images/help/codespaces/new-codespace-button.png) - -When you create a codespace, your project is created on a remote VM that is dedicated to you. By default, the container for your codespace has many languages and runtimes including Node.js, JavaScript, Typescript, nvm, npm, and yarn. It also includes a common set of tools like git, wget, rsync, openssh, and nano. +Cuando creas un codespace, tu proyecto se crea en una MV remota dedicada a ti. Predeterminadamente, el contenedor para tu codespace tiene muchos lenguajes y tiempos de ejecución, incluyendo a Node.js, JavaScript, TypeScript, nvm, npm y yarn. También incluye un conjunto de herramientas comunes como git, wget, rsync, openssh y nano. {% data reusables.codespaces.customize-vcpus-and-ram %} -## Step 2: Add a dev container configuration to your repository from a template +## Paso 2: agregar una configuración de contenedor de desarrollo al repositorio desde una plantilla -The default development container, or "dev container," for {% data variables.product.prodname_github_codespaces %} will support running Node.js projects like [vscode-remote-try-node](https://github.com/microsoft/vscode-remote-try-node) out of the box. However, we recommend that you configure your own dev container, as this allows you to define any particular tools and scripts your project needs. This will ensure a fully reproducible environment for all {% data variables.product.prodname_github_codespaces %} users in your repository. +El contenedor de desarrollo predeterminado, o «contenedor de desarrollo», para {% data variables.product.prodname_github_codespaces %} admitirá la ejecución de proyectos de Node.js como [vscode-remote-try-node](https://github.com/microsoft/vscode-remote-try-node) listo para usar. Sin embargo, recomendamos que configures tu propio contenedor de desarrollo, ya que esto permite definir todas las herramientas y scripts específicos que necesite el proyecto. Esto garantizará un entorno totalmente reproducible para todos los usuarios de {% data variables.product.prodname_github_codespaces %} en el repositorio. {% data reusables.codespaces.setup-custom-devcontainer %} {% data reusables.codespaces.command-palette-container %} -1. For this example, click **Node.js**. If you need additional features you can select any container that’s specific to Node or a combination of tools such as Node and MongoDB. +1. Para este ejemplo, haga clic en **Node.js**. Si necesitas características adicionales, puedes seleccionar cualquier contenedor que sea específico para Node o una combinación de herramientas tales como Node y MongoDB. - ![Select Node option from the list](/assets/images/help/codespaces/add-node-prebuilt-container.png) + ![Selecciona la opción Node de la lista](/assets/images/help/codespaces/add-node-prebuilt-container.png) -1. Click the recommended version of Node.js. +1. Haz clic en la versión recomendada de Node.js. - ![Node.js version selection](/assets/images/help/codespaces/add-node-version.png) + ![Selección de la versión de Node.js](/assets/images/help/codespaces/add-node-version.png) {% data reusables.codespaces.rebuild-command %} -### Anatomy of your dev container +### Anatomía de tu contenedor dev -Adding the Node.js dev container template adds a `.devcontainer` directory to the root of your project's repository with the following files: +Al agregar la plantilla de contenedor de desarrollo de Node.js, se agrega un directorio `.devcontainer` a la raíz del repositorio del proyecto con los archivos siguientes: - `devcontainer.json` - Dockerfile -The newly added `devcontainer.json` file defines a few properties that are described after the sample. +En el archivo `devcontainer.json` recién agregado se definen varias propiedades que se describen después del ejemplo. #### devcontainer.json @@ -71,46 +74,46 @@ The newly added `devcontainer.json` file defines a few properties that are descr // For format details, see https://aka.ms/devcontainer.json. For config options, see the README at: // https://github.com/microsoft/vscode-dev-containers/tree/v0.162.0/containers/javascript-node { - "name": "Node.js", - "build": { - "dockerfile": "Dockerfile", - // Update 'VARIANT' to pick a Node version: 10, 12, 14 - "args": { "VARIANT": "14" } - }, + "name": "Node.js", + "build": { + "dockerfile": "Dockerfile", + // Update 'VARIANT' to pick a Node version: 10, 12, 14 + "args": { "VARIANT": "14" } + }, - // Set *default* container specific settings.json values on container create. - "settings": { - "terminal.integrated.shell.linux": "/bin/bash" - }, + // Set *default* container specific settings.json values on container create. + "settings": { + "terminal.integrated.shell.linux": "/bin/bash" + }, - // Add the IDs of extensions you want installed when the container is created. - "extensions": [ - "dbaeumer.vscode-eslint" - ], + // Add the IDs of extensions you want installed when the container is created. + "extensions": [ + "dbaeumer.vscode-eslint" + ], - // Use 'forwardPorts' to make a list of ports inside the container available locally. - // "forwardPorts": [], + // Use 'forwardPorts' to make a list of ports inside the container available locally. + // "forwardPorts": [], - // Use 'postCreateCommand' to run commands after the container is created. - // "postCreateCommand": "yarn install", + // Use 'postCreateCommand' to run commands after the container is created. + // "postCreateCommand": "yarn install", - // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. - "remoteUser": "node" + // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. + "remoteUser": "node" } ``` -- **name** - You can name your dev container anything, this is just the default. -- **build** - The build properties. - - **dockerfile** - In the `build` object, `dockerfile` contains the path to the Dockerfile that was also added from the template. +- **name**: puedes asignar cualquier nombre al contenedor de desarrollo; este es solo el valor predeterminado. +- **build**: las propiedades de compilación. + - **dockerfile**: en el objeto `build`, `dockerfile` contiene la ruta de acceso al Dockerfile que también se ha agregado desde la plantilla. - **args** - - **variant**: This file only contains one build argument, which is the node variant we want to use that is passed into the Dockerfile. -- **settings** - These are {% data variables.product.prodname_vscode %} settings that you can set. - - **terminal.integrated.shell.linux** - While bash is the default here, you could use other terminal shells by modifying this. -- **extensions** - These are extensions included by default. - - **dbaeumer.vscode-eslint** - ES lint is a great extension for linting, but for JavaScript there are a number of great Marketplace extensions you could also include. -- **forwardPorts** - Any ports listed here will be forwarded automatically. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." -- **postCreateCommand** - Use this to run commands that aren't defined in the Dockerfile, after your codespace is created. -- **remoteUser** - By default, you’re running as the vscode user, but you can optionally set this to root. + - **variant**: este archivo solo contiene un argumento de compilación, que es la variante de nodo que queremos usar y que se pasa al Dockerfile. +- **settings**: son las opciones {% data variables.product.prodname_vscode %} que puedes establecer. + - **terminal.integrated.shell.linux**: aunque aquí bash sea el shell de terminal predeterminado, puedes modificarlo y usar otros. +- **extensions**: extensiones incluidas de forma predeterminada. + - **dbaeumer.vscode-eslint**: ES lint es una muy buena extensión para linting, pero para JavaScript hay una serie de extensiones excelentes de Marketplace que también puedes incluir. +- **forwardPorts**: cualquier puerto que se incluya aquí se reenviará de forma automática. Para más información, vea "[Reenvío de puertos en el codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)". +- **postCreateCommand**: después de crear el codespace, usa esta opción para ejecutar comandos que no están definidos en el Dockerfile. +- **remoteUser**: de manera predeterminada, la ejecución se realiza como el usuario vscode, pero opcionalmente se puede establecer en root. #### Dockerfile @@ -131,17 +134,17 @@ FROM mcr.microsoft.com/vscode/devcontainers/javascript-node:0-${VARIANT} # RUN su node -c "npm install -g " ``` -You can use the Dockerfile to add additional container layers to specify OS packages, node versions, or global packages we want included in our container. +Puedes utilizar este Dockerfile para agregar capas de contenedor adicionales y especificar paquetes de SO, versiones de nodo o paquetes globales que queremos incluir en nuestro contenedor. -## Step 3: Modify your devcontainer.json file +## Paso 3: Modifica tu archivo devcontainer.json -With your dev container configuration added and a basic understanding of what everything does, you can now make changes to customize your environment further. In this example, you'll add properties to install npm when your codespace launches and make a list of ports inside the container available locally. +Con la configuración del contenedor de desarrollo agregada y tu conocimiento básico de lo que hace cada cosa, ahora puedes realizar cambios para personalizar aún más el entorno. En este ejemplo, agregarás propiedades para instalar npm cuando tu codespace se lance y haga una lista de puertos dentro del contenedor que está disponible localmente. -1. In the Explorer, select the `devcontainer.json` file from the tree to open it. You might have to expand the `.devcontainer` folder to see it. +1. En el Explorador, seleccione el archivo `devcontainer.json` del árbol para abrirlo. Es posible que tenga que expandir la carpeta `.devcontainer` para verlo. - ![devcontainer.json file in the Explorer](/assets/images/help/codespaces/devcontainers-options.png) + ![Archivo de devcontainer.json en el explorador](/assets/images/help/codespaces/devcontainers-options.png) -2. Add the following lines to your `devcontainer.json` file after `extensions`: +2. Agregue las siguientes líneas al archivo `devcontainer.json` después de `extensions`: ```json{:copy} "postCreateCommand": "npm install", @@ -154,24 +157,24 @@ With your dev container configuration added and a basic understanding of what ev {% data reusables.codespaces.rebuild-reason %} -## Step 4: Run your application +## Paso 4: Ejecución de la aplicación -In the previous section, you used the `postCreateCommand` to installing a set of packages via npm. You can now use this to run our application with npm. +En la sección anterior, ha usado `postCreateCommand` para instalar un conjunto de paquetes mediante npm. Ahora puedes utilizar esto para ejecutar nuestra aplicación con npm. -1. Run your start command in the terminal with`npm start`. +1. Ejecute el comando start en el terminal con`npm start`. - ![npm start in terminal](/assets/images/help/codespaces/codespaces-npmstart.png) + ![npm start en la terminal](/assets/images/help/codespaces/codespaces-npmstart.png) -2. When your project starts, you should see a "toast" notification message at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, containing a prompt to connect to the port your project uses. +2. Cuando se inicie el proyecto, deberías ver un mensaje de notificación del sistema en la esquina inferior derecha de {% data variables.product.prodname_vscode_shortname %}, que contiene un mensaje para conectarse al puerto que usa el proyecto. - ![Port forwarding "toast" notification](/assets/images/help/codespaces/codespaces-port-toast.png) + ![Notificación del sistema de enrutamiento de puerto](/assets/images/help/codespaces/codespaces-port-toast.png) -## Step 5: Commit your changes +## Paso 5: Confirma tus cambios {% data reusables.codespaces.committing-link-to-procedure %} -## Next steps +## Pasos siguientes -You should now be ready start developing your JavaScript project in {% data variables.product.prodname_github_codespaces %}. Here are some additional resources for more advanced scenarios. +Ahora ya deberías poder empezar a desarrollar tu proyecto de JavaScript en {% data variables.product.prodname_github_codespaces %}. Aquí tienes algunos recursos adicionales para situaciones más avanzadas. {% data reusables.codespaces.next-steps-adding-devcontainer %} diff --git a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces.md b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces.md index 6b6e352488..87231c9454 100644 --- a/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces.md +++ b/translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces.md @@ -1,8 +1,8 @@ --- -title: Setting up your Python project for GitHub Codespaces +title: Configuración de un proyecto de Python para GitHub Codespaces allowTitleToDifferFromFilename: true shortTitle: Setting up your Python project -intro: 'Get started with your Python project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container.' +intro: 'Crea un contenedor de desarrollo personalizado para empezar a trabajar con tu proyecto de Python en {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -15,113 +15,117 @@ topics: - Python hasExperimentalAlternative: true hidden: true +ms.openlocfilehash: 2d9c627907f447a3efd873fceba963b899b57c39 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159851' --- +## Introducción -## Introduction +En esta guía se muestra cómo configurar un proyecto de Python en {% data reusables.codespaces.setting-up-project-intro %}. -This guide shows you how to set up your Python project {% data reusables.codespaces.setting-up-project-intro %} +### Prerrequisitos -### Prerequisites +- Debes tener un proyecto existente de Python en un repositorio de {% data variables.product.prodname_dotcom_the_website %}. Si no tiene un proyecto, puede probar este tutorial con el ejemplo siguiente: https://github.com/2percentsilk/python-quickstart. +- Debes tener {% data variables.product.prodname_github_codespaces %} habilitado en tu organización. -- You should have an existing Python project in a repository on {% data variables.product.prodname_dotcom_the_website %}. If you don't have a project, you can try this tutorial with the following example: https://github.com/2percentsilk/python-quickstart. -- You must have {% data variables.product.prodname_github_codespaces %} enabled for your organization. +## Paso 1: Abre tu proyecto en un codespace -## Step 1: Open your project in a codespace +1. Debajo del nombre del repositorio, usa el menú desplegable **Código de {% octicon "code" aria-label="The code icon" %}** y, en la pestaña **Codespaces**, haz clic en el signo más ({% octicon "plus" aria-label="The plus icon" %}). -1. Under the repository name, use the **{% octicon "code" aria-label="The code icon" %} Code** dropdown menu, and in the **Codespaces** tab, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}). + ![Botón de codespace nuevo](/assets/images/help/codespaces/new-codespace-button.png) - ![New codespace button](/assets/images/help/codespaces/new-codespace-button.png) - -When you create a codespace, your project is created on a remote VM that is dedicated to you. By default, the container for your codespace has many languages and runtimes including Node.js, JavaScript, Typescript, nvm, npm, and yarn. It also includes a common set of tools like git, wget, rsync, openssh, and nano. +Cuando creas un codespace, tu proyecto se crea en una MV remota dedicada a ti. Predeterminadamente, el contenedor para tu codespace tiene muchos lenguajes y tiempos de ejecución, incluyendo a Node.js, JavaScript, TypeScript, nvm, npm y yarn. También incluye un conjunto de herramientas comunes como git, wget, rsync, openssh y nano. {% data reusables.codespaces.customize-vcpus-and-ram %} -## Step 2: Add a dev container configuration to your repository from a template +## Paso 2: agregar una configuración de contenedor de desarrollo al repositorio desde una plantilla -The default development container, or "dev container," for {% data variables.product.prodname_github_codespaces %} comes with the latest Python version, package managers (pip, Miniconda), and other common tools preinstalled. However, we recommend that you configure your own dev container to include all of the tools and scripts that your project needs. This will ensure a fully reproducible environment for all {% data variables.product.prodname_github_codespaces %} users in your repository. +El contenedor de desarrollo predeterminado, o "contenedor de desarrollo", para {% data variables.product.prodname_github_codespaces %} viene con la versión más reciente de Python, los administradores de paquetes (pip, Miniconda) y otras herramientas comunes preinstaladas. Sin embargo, recomendamos que configures tu propio contenedor de desarrollo para incluir todas las herramientas y scripts que necesita el proyecto. Esto garantizará un entorno totalmente reproducible para todos los usuarios de {% data variables.product.prodname_github_codespaces %} en el repositorio. {% data reusables.codespaces.setup-custom-devcontainer %} {% data reusables.codespaces.command-palette-container %} -1. For this example, click **Python 3**. If you need additional features you can select any container that’s specific to Python or a combination of tools such as Python 3 and PostgreSQL. - ![Select Python option from the list](/assets/images/help/codespaces/add-python-prebuilt-container.png) -1. Click the recommended version of Python. - ![Python version selection](/assets/images/help/codespaces/add-python-version.png) -1. Accept the default option to add Node.js to your customization. - ![Add Node.js selection](/assets/images/help/codespaces/add-nodejs-selection.png) -{% data reusables.codespaces.rebuild-command %} +1. Para este ejemplo, haga clic en **Python 3**. Si necesitas características adicionales, puedes seleccionar cualquier contenedor que sea específico para Python o una combinación de herramientas tales como Python 3 y PostgreSQL. + ![Selección de la opción Python en la lista](/assets/images/help/codespaces/add-python-prebuilt-container.png) +1. Haz clic en la versión recomendada de Python. + ![Selección de la versión Python](/assets/images/help/codespaces/add-python-version.png) +1. Acepta la opción predeterminada para agregar a Node.js a tu personalización. + ![Selección de agregar Node.js](/assets/images/help/codespaces/add-nodejs-selection.png) {% data reusables.codespaces.rebuild-command %} -### Anatomy of your dev container +### Anatomía de tu contenedor dev -Adding the Python dev container template adds a `.devcontainer` directory to the root of your project's repository with the following files: +Al agregar la plantilla de contenedor de desarrollo de Python, se agrega un directorio `.devcontainer` a la raíz del repositorio del proyecto con los archivos siguientes: - `devcontainer.json` - Dockerfile -The newly added `devcontainer.json` file defines a few properties that are described after the sample. +En el archivo `devcontainer.json` recién agregado se definen varias propiedades que se describen después del ejemplo. #### devcontainer.json ```json { - "name": "Python 3", - "build": { - "dockerfile": "Dockerfile", - "context": "..", - "args": { - // Update 'VARIANT' to pick a Python version: 3, 3.6, 3.7, 3.8, 3.9 - "VARIANT": "3", - // Options - "INSTALL_NODE": "true", - "NODE_VERSION": "lts/*" - } - }, + "name": "Python 3", + "build": { + "dockerfile": "Dockerfile", + "context": "..", + "args": { + // Update 'VARIANT' to pick a Python version: 3, 3.6, 3.7, 3.8, 3.9 + "VARIANT": "3", + // Options + "INSTALL_NODE": "true", + "NODE_VERSION": "lts/*" + } + }, - // Set *default* container specific settings.json values on container create. - "settings": { - "terminal.integrated.shell.linux": "/bin/bash", - "python.pythonPath": "/usr/local/bin/python", - "python.linting.enabled": true, - "python.linting.pylintEnabled": true, - "python.formatting.autopep8Path": "/usr/local/py-utils/bin/autopep8", - "python.formatting.blackPath": "/usr/local/py-utils/bin/black", - "python.formatting.yapfPath": "/usr/local/py-utils/bin/yapf", - "python.linting.banditPath": "/usr/local/py-utils/bin/bandit", - "python.linting.flake8Path": "/usr/local/py-utils/bin/flake8", - "python.linting.mypyPath": "/usr/local/py-utils/bin/mypy", - "python.linting.pycodestylePath": "/usr/local/py-utils/bin/pycodestyle", - "python.linting.pydocstylePath": "/usr/local/py-utils/bin/pydocstyle", - "python.linting.pylintPath": "/usr/local/py-utils/bin/pylint" - }, + // Set *default* container specific settings.json values on container create. + "settings": { + "terminal.integrated.shell.linux": "/bin/bash", + "python.pythonPath": "/usr/local/bin/python", + "python.linting.enabled": true, + "python.linting.pylintEnabled": true, + "python.formatting.autopep8Path": "/usr/local/py-utils/bin/autopep8", + "python.formatting.blackPath": "/usr/local/py-utils/bin/black", + "python.formatting.yapfPath": "/usr/local/py-utils/bin/yapf", + "python.linting.banditPath": "/usr/local/py-utils/bin/bandit", + "python.linting.flake8Path": "/usr/local/py-utils/bin/flake8", + "python.linting.mypyPath": "/usr/local/py-utils/bin/mypy", + "python.linting.pycodestylePath": "/usr/local/py-utils/bin/pycodestyle", + "python.linting.pydocstylePath": "/usr/local/py-utils/bin/pydocstyle", + "python.linting.pylintPath": "/usr/local/py-utils/bin/pylint" + }, - // Add the IDs of extensions you want installed when the container is created. - "extensions": [ - "ms-python.python" - ], + // Add the IDs of extensions you want installed when the container is created. + "extensions": [ + "ms-python.python" + ], - // Use 'forwardPorts' to make a list of ports inside the container available locally. - // "forwardPorts": [], + // Use 'forwardPorts' to make a list of ports inside the container available locally. + // "forwardPorts": [], - // Use 'postCreateCommand' to run commands after the container is created. - // "postCreateCommand": "pip3 install --user -r requirements.txt", + // Use 'postCreateCommand' to run commands after the container is created. + // "postCreateCommand": "pip3 install --user -r requirements.txt", - // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. - "remoteUser": "vscode" + // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. + "remoteUser": "vscode" } ``` -- **name** - You can name our dev container anything, this is just the default. -- **build** - The build properties. - - **dockerfile** - In the `build` object, `dockerfile` contains the path to the Dockerfile that was also added from the template. +- **name**: puedes asignar el nombre que quieras al contenedor de desarrollo, este es solo el nombre predeterminado. +- **build**: las propiedades de compilación. + - **dockerfile**: en el objeto `build`, `dockerfile` contiene la ruta de acceso al Dockerfile que también se ha agregado desde la plantilla. - **args** - - **variant**: This file only contains one build argument, which is the node variant we want to use that is passed into the Dockerfile. -- **settings** - These are {% data variables.product.prodname_vscode %} settings. - - **terminal.integrated.shell.linux** - While bash is the default here, you could use other terminal shells by modifying this. -- **extensions** - These are extensions included by default. - - **ms-python.python** - The Microsoft Python extension provides rich support for the Python language (for all actively supported versions of the language: >=3.6), including features such as IntelliSense, linting, debugging, code navigation, code formatting, refactoring, variable explorer, test explorer, and more. -- **forwardPorts** - Any ports listed here will be forwarded automatically. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." -- **postCreateCommand** - Use this to run commands that aren't defined in the Dockerfile, like `pip3 install -r requirements`, after your codespace is created. -- **remoteUser** - By default, you’re running as the `vscode` user, but you can optionally set this to `root`. + - **variant**: este archivo solo contiene un argumento de compilación, que es la variante del nodo que queremos usar que se pasa al Dockerfile. +- **settings**: la configuración de {% data variables.product.prodname_vscode %}. + - **terminal.integrated.shell.linux**: aunque aquí bash sea el shell de terminal predeterminado, puedes modificarlo y usar otros. +- **extensions**: las extensiones incluidas de forma predeterminada. + - **ms-python.python**: la extensión de Python de Microsoft te proporciona una compatibilidad enriquecida para el lenguaje Python (para todas las versiones compatibles del lenguaje: >=3.6), incluidas las características tales como IntelliSense, linting, depuración, navegación de código, formato de código, refactorización, explorador de variables, explorador de pruebas y mucho más. +- **forwardPorts**: cualquier puerto que se incluya aquí se reenviará de forma automática. Para más información, vea "[Reenvío de puertos en el codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)". +- **postCreateCommand**: después de crear el codespace, usa esta opción para ejecutar comandos que no están definidos en el Dockerfile, como `pip3 install -r requirements`. +- **remoteUser**: de manera predeterminada, la ejecución se realiza como el usuario `vscode`, pero opcionalmente se puede establecer en `root`. #### Dockerfile @@ -148,27 +152,27 @@ RUN if [ "${INSTALL_NODE}" = "true" ]; then su vscode -c "umask 0002 && . /usr/l # RUN su vscode -c "source /usr/local/share/nvm/nvm.sh && npm install -g " 2>&1 ``` -You can use the Dockerfile to add additional container layers to specify OS packages, node versions, or global packages we want included in our container. +Puedes utilizar este Dockerfile para agregar capas de contenedor adicionales y especificar paquetes de SO, versiones de nodo o paquetes globales que queremos incluir en nuestro contenedor. -## Step 3: Modify your devcontainer.json file +## Paso 3: Modifica tu archivo devcontainer.json -With your dev container configuration added and a basic understanding of what everything does, you can now make changes to customize your environment further. In this example, you'll add properties to install extensions and your project dependencies when your codespace launches. +Con la configuración del contenedor de desarrollo agregada y un conocimiento básico de lo que hace cada elemento, ya puedes realizar cambios para personalizar aún más el entorno. En este ejemplo, agregarás porpiedades para instalar extensiones y tus dependencias de pryecto cuando se lance tu codespace. -1. In the Explorer, expand the `.devcontainer` folder and select the `devcontainer.json` file from the tree to open it. +1. En el Explorador, expanda la carpeta `.devcontainer` y seleccione el archivo `devcontainer.json` del árbol para abrirlo. - ![devcontainer.json file in the Explorer](/assets/images/help/codespaces/devcontainers-options.png) + ![Archivo de devcontainer.json en el explorador](/assets/images/help/codespaces/devcontainers-options.png) -2. Update the `extensions` list in your `devcontainer.json` file to add a few extensions that are useful when working with your project. +2. Actualice la lista `extensions` del archivo `devcontainer.json` para agregar algunas extensiones que son útiles al trabajar con el proyecto. ```json{:copy} "extensions": [ - "ms-python.python", - "cstrap.flask-snippets", - "streetsidesoftware.code-spell-checker" - ], + "ms-python.python", + "cstrap.flask-snippets", + "streetsidesoftware.code-spell-checker" + ], ``` -3. Uncomment the `postCreateCommand` to auto-install requirements as part of the codespaces setup process. +3. Quite la marca de comentario de `postCreateCommand` para instalar automáticamente los requisitos como parte del proceso de instalación de los codespaces. ```json{:copy} // Use 'postCreateCommand' to run commands after the container is created. @@ -179,26 +183,26 @@ With your dev container configuration added and a basic understanding of what ev {% data reusables.codespaces.rebuild-reason %} -5. Check your changes were successfully applied by verifying the Code Spell Checker and Flask Snippet extensions were installed. +5. Verifica tus cambios en donde se aplicaron con éxito verificando que se hayan instalado las extensiones "Code Spell Checker" y "Flask Snippet". - ![Extensions list](/assets/images/help/codespaces/python-extensions.png) + ![Lista de extensiones](/assets/images/help/codespaces/python-extensions.png) -## Step 4: Run your application +## Paso 4: Ejecución de la aplicación -In the previous section, you used the `postCreateCommand` to install a set of packages via pip3. With your dependencies now installed, you can run your application. +En la sección anterior, ha usado `postCreateCommand` para instalar un conjunto de paquetes mediante pip3. Ahora que instalaste tus dependencias, puedes ejecutar tu aplicación. -1. Run your application by pressing `F5` or entering `python -m flask run` in the codespace terminal. +1. Para ejecutar la aplicación, presione `F5` o escriba `python -m flask run` en el terminal del codespace. -2. When your project starts, you should see a "toast" notification message at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, containing a prompt to connect to the port your project uses. +2. Cuando se inicie el proyecto, deberías ver un mensaje de notificación del sistema en la esquina inferior derecha de {% data variables.product.prodname_vscode_shortname %}, que contendrá un mensaje para conectarse al puerto que usa el proyecto. - ![Port forwarding "toast" notification](/assets/images/help/codespaces/python-port-forwarding.png) + ![Notificación del sistema de enrutamiento de puerto](/assets/images/help/codespaces/python-port-forwarding.png) -## Step 5: Commit your changes +## Paso 5: Confirma tus cambios {% data reusables.codespaces.committing-link-to-procedure %} -## Next steps +## Pasos siguientes -You should now be ready start developing your Python project in {% data variables.product.prodname_github_codespaces %}. Here are some additional resources for more advanced scenarios. +Ahora ya deberías poder empezar a desarrollar tu proyecto de Python en {% data variables.product.prodname_github_codespaces %}. Aquí tienes algunos recursos adicionales para situaciones más avanzadas. {% data reusables.codespaces.next-steps-adding-devcontainer %} diff --git a/translations/es-ES/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md b/translations/es-ES/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md index d8f3a8ecd5..e6ff8b7a89 100644 --- a/translations/es-ES/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md +++ b/translations/es-ES/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md @@ -1,6 +1,6 @@ --- -title: Exporting changes to a branch -intro: This article provides steps for exporting your codespace changes to a branch. +title: Exportar los cambios a una rama +intro: Este artículo proporciona los pasos para exportar los cambios de tu codespace a una rama. versions: fpt: '*' ghec: '*' @@ -8,20 +8,25 @@ type: reference topics: - Codespaces shortTitle: Exporting changes +ms.openlocfilehash: 2a7dee4725af31f3983e753b4202f94be1742556 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159908' --- +## Exportar los cambios a una rama -## Exporting changes to a branch +Al utilizar {% data variables.product.prodname_github_codespaces %}, podrías querer exportar tus cambios a una rama sin iniciar el codespace. Esto puede ser útil cuando se ha alcanzado un [límite de gasto](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces) o se tiene un problema general para acceder al codespace. -While using {% data variables.product.prodname_github_codespaces %}, you may want to export your changes to a branch without launching your codespace. This can be useful when you have hit a [spending limit](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces) or have a general issue accessing your codespace. +Si el codespace no está publicado (creado a partir de una plantilla y no asociado a un repositorio en {% data variables.product.product_name %}), no podrás exportar los cambios a una rama, pero puedes publicar el codespace en un nuevo repositorio sin iniciar el codespace. Para obtener más información, consulta "[Creación de un codespace a partir de una plantilla](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-from-githubcom)". -If your codespace is unpublished (created from a template and not associated with a repository on {% data variables.product.product_name %}), then you won't be able to export changes to a branch, but you can publish the codespace to a new repository without launching the codespace. For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-from-githubcom)." +Para exportar los cambios a una rama: -To export your changes to a branch: +{% data reusables.codespaces.your-codespaces-procedure-step %} o, en el caso de un repositorio individual, haz clic en el menú **{% octicon "code" aria-label="The code icon" %} Code** (Código). +1. Haga clic en los puntos suspensivos ( **…** ) situados a la derecha del codespace desde el que quiere realizar la exportación. +2. Seleccione **{% octicon "git-branch" aria-label="The git branch icon" %} Export changes to branch** (Exportar los cambios a una rama). -{% data reusables.codespaces.your-codespaces-procedure-step %} Or, for an individual repository, click the **{% octicon "code" aria-label="The code icon" %} Code** menu. -1. Click the ellipsis (**...**) to the right of the codespace you want to export from. -2. Select **{% octicon "git-branch" aria-label="The git branch icon" %} Export changes to branch**. + ![Exportar cambios a una rama](/assets/images/help/codespaces/export-changes-to-a-branch.png) - ![Export changes to a branch](/assets/images/help/codespaces/export-changes-to-a-branch.png) - -1. From the popover, select **Create branch**. +1. En la ventana emergente, seleccione **Create branch** (Crear rama). diff --git a/translations/es-ES/content/codespaces/troubleshooting/github-codespaces-logs.md b/translations/es-ES/content/codespaces/troubleshooting/github-codespaces-logs.md index e5acb48518..9d06d8cd39 100644 --- a/translations/es-ES/content/codespaces/troubleshooting/github-codespaces-logs.md +++ b/translations/es-ES/content/codespaces/troubleshooting/github-codespaces-logs.md @@ -1,6 +1,6 @@ --- -title: GitHub Codespaces logs -intro: 'Overview of the logs used by {% data variables.product.prodname_github_codespaces %}.' +title: Registros de GitHub Codespaces +intro: 'Información general de los registros que utiliza {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -11,50 +11,55 @@ topics: shortTitle: Codespaces logs redirect_from: - /codespaces/troubleshooting/codespaces-logs +ms.openlocfilehash: f5cd482888f58f85a051bb9b6e2c5d7c026ed9a9 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160304' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -Information on {% data variables.product.prodname_github_codespaces %} is output to various logs: +La información sobre {% data variables.product.prodname_github_codespaces %} se genera en varios registros: {% webui %} -- Codespace logs -- Creation logs -- Browser console logs (for the {% data variables.product.prodname_vscode_shortname %} web client) +- Bitácoras de Codespace +- Bitácoras de creación +- Registros de la consola del explorador (para el cliente web de {% data variables.product.prodname_vscode_shortname %}) -Extension logs are available if you are using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode_shortname %}. Click the "{% data variables.product.prodname_vscode %}" tab above for details. +Los registros de extensión están disponibles si usas {% data variables.product.prodname_github_codespaces %} en {% data variables.product.prodname_vscode_shortname %}. Haz clic en la pestaña "{% data variables.product.prodname_vscode %}" anterior para obtener más información. {% endwebui %} {% vscode %} -- Codespace logs -- Creation logs -- Extension logs (for the {% data variables.product.prodname_vscode_shortname %} desktop application) +- Bitácoras de Codespace +- Bitácoras de creación +- Registros de extensión (para la aplicación de escritorio de {% data variables.product.prodname_vscode_shortname %}) -Browser logs are available if you are using {% data variables.product.prodname_github_codespaces %} in your browser. Click the "Web browser" tab above for details. +Los registros del explorador están disponibles si usas {% data variables.product.prodname_github_codespaces %} en el explorador. Haz clic en la pestaña "Explorador web" anterior para obtener más información. {% endvscode %} {% cli %} -- Codespace logs -- Creation logs +- Bitácoras de Codespace +- Bitácoras de creación -Other logs are available if you are using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode_shortname %} or in your web browser. Click the tabs above for details. +Hay otros registros disponibles si usas {% data variables.product.prodname_github_codespaces %} en {% data variables.product.prodname_vscode_shortname %} o en el explorador web. Haz clic en las pestañas anteriores para obtener más información. {% endcli %} {% jetbrains %} -- Creation logs +- Bitácoras de creación -Other logs are available if you are using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode_shortname %} or in your web browser. Click the tabs above for details. +Hay otros registros disponibles si usas {% data variables.product.prodname_github_codespaces %} en {% data variables.product.prodname_vscode_shortname %} o en el explorador web. Haz clic en las pestañas anteriores para obtener más información. {% endjetbrains %} @@ -62,10 +67,10 @@ Other logs are available if you are using {% data variables.product.prodname_git {% data reusables.codespaces.codespace-logs %} -1. If you are using {% data variables.product.prodname_github_codespaces %} in the browser, ensure that you are connected to the codespace you want to debug. -1. Open the {% data variables.product.prodname_vscode_command_palette_shortname %} (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)) and type **Export logs**. Select **Codespaces: Export Logs** from the list to download the logs. -1. Define where to save the zip archive of logs then click **Save** (desktop) or click **OK** (web). -1. If you are using {% data variables.product.prodname_github_codespaces %} in the browser, right-click on the zip archive of logs from the Explorer view and select **Download…** to download them to your local machine. +1. Si estás utilizando {% data variables.product.prodname_github_codespaces %} en el explorador, asegúrate de que estés conectado al codespace que quieres depurar. +1. Abre el {% data variables.product.prodname_vscode_command_palette_shortname %} (Comando+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux)) y escribe **Exportar registros**. Seleccione **Codespaces: Exportar registros** en la lista para descargar los registros. +1. Defina dónde guardar el archivo ZIP de registros y, después, haga clic en **Guardar** (escritorio) o en **Aceptar** (web). +1. Si usas {% data variables.product.prodname_github_codespaces %} en el explorador, haz clic con el botón derecho en el archivo ZIP de registros en la vista Explorador y selecciona **Descargar...** para descargarlos en la máquina local. {% endwebui %} @@ -73,8 +78,8 @@ Other logs are available if you are using {% data variables.product.prodname_git {% data reusables.codespaces.codespace-logs %} -1. Open the {% data variables.product.prodname_vscode_command_palette_shortname %} (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)) and type **Export logs**. Select **Codespaces: Export Logs** from the list to download the logs. -1. Define where to save the zip archive of logs then click **Save** (desktop) or click **OK** (web). +1. Abre el {% data variables.product.prodname_vscode_command_palette_shortname %} (Comando+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux)) y escribe **Exportar registros**. Seleccione **Codespaces: Exportar registros** en la lista para descargar los registros. +1. Defina dónde guardar el archivo ZIP de registros y, después, haga clic en **Guardar** (escritorio) o en **Aceptar** (web). {% endvscode %} @@ -82,28 +87,28 @@ Other logs are available if you are using {% data variables.product.prodname_git {% data reusables.codespaces.codespace-logs %} -Currently you can't use {% data variables.product.prodname_cli %} to access these logs. To access them, open your codespace in {% data variables.product.prodname_vscode_shortname %} or in a browser. +Actualmente, no puedes utilizar el {% data variables.product.prodname_cli %} para acceder a estas bitácoras. Para acceder a ellas, abre tu codespace en {% data variables.product.prodname_vscode_shortname %} o en un explorador. {% endcli %} -## Creation logs +## Bitácoras de creación -These logs contain information about the container, dev container, and their configuration. They are useful for debugging configuration and setup problems. +Estas bitácoras contienen información sobre el contenedor, el contenedor dev y sus configuraciones. Son útiles para depurar la configuración y solucionar problemas. {% webui %} -1. Connect to the codespace you want to debug. -2. Open the {% data variables.product.prodname_vscode_command_palette_shortname %} (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)) and type **Creation logs**. Select **Codespaces: View Creation Log** from the list to open the `creation.log` file. +1. Conéctate al codespace que quieras depurar. +2. Abre el {% data variables.product.prodname_vscode_command_palette_shortname %} (Comando+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux)) y escribe **Registros de creación**. Seleccione **Codespaces: Ver registro de creación** en la lista para abrir el archivo `creation.log`. -If you want to share the log with support, you can copy the text from the creation log into a text editor and save the file locally. +Si quieres compartir la bitácora con soporte, puedes copiar el texto de la bitácora de creación en un editor de texto y guardar el archivo localmente. {% endwebui %} {% vscode %} -Open the {% data variables.product.prodname_vscode_command_palette_shortname %} (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)) and type **Creation logs**. Select **Codespaces: View Creation Log** from the list to open the `creation.log` file. +Abre el {% data variables.product.prodname_vscode_command_palette_shortname %} (Comando+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux)) y escribe **Registros de creación**. Seleccione **Codespaces: Ver registro de creación** en la lista para abrir el archivo `creation.log`. -If you want to share the log with support, you can copy the text from the creation log into a text editor and save the file locally. +Si quieres compartir la bitácora con soporte, puedes copiar el texto de la bitácora de creación en un editor de texto y guardar el archivo localmente. {% endvscode %} @@ -111,15 +116,15 @@ If you want to share the log with support, you can copy the text from the creati {% data reusables.cli.cli-learn-more %} -To see the creation log use the `gh codespace logs` subcommand. After entering the command choose from the list of codespaces that's displayed. +Para ver el registro de creación, use el subcomando `gh codespace logs`. Después de ingresar el comando, elige de la lista de codespaces que se muestra. ```shell gh codespace logs ``` -For more information about this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_logs). +Para más información sobre este comando, vea [el manual de {% data variables.product.prodname_cli %}](https://cli.github.com/manual/gh_codespace_logs). -If you want to share the log with support, you can save the output to a file: +Si quieres compartir la bitácora con el personal de soporte, puedes guardar el resultado en un archivo: ```shell gh codespace logs -c > /path/to/logs.txt @@ -129,44 +134,44 @@ gh codespace logs -c > /path/to/logs.txt {% vscode %} -## Extension logs +## Bitácoras de extensión -These logs are available for {% data variables.product.prodname_vscode_shortname %} desktop users only. They are useful if it seems like the {% data variables.product.prodname_github_codespaces %} extension or {% data variables.product.prodname_vscode_shortname %} editor are having issues that prevent creation or connection. +Estos registros se encuentran disponibles únicamente para los usuarios de escritorio de {% data variables.product.prodname_vscode_shortname %}. Son útiles en caso de que parezca que la extensión de {% data variables.product.prodname_github_codespaces %} o el editor de {% data variables.product.prodname_vscode_shortname %} estén teniendo problemas que impidan la creación o conexión. -1. In {% data variables.product.prodname_vscode_shortname %}, open the Command Palette. -1. Type **Logs** and select **Developer: Open Extension Logs Folder** from the list to open the extension log folder in your system's file explorer. +1. En {% data variables.product.prodname_vscode_shortname %}, abre la paleta de comandos. +1. Escriba **Registros** y seleccione **Desarrollador: Abrir la carpeta Registros de extensiones** en la lista para abrir la carpeta de registros de extensiones en el explorador de archivos del sistema. -From this view, you can access logs generated by the various extensions that you use in {% data variables.product.prodname_vscode_shortname %}. You will see logs for {% data variables.product.prodname_github_codespaces %}, {% data variables.product.prodname_dotcom %} Authentication, and Git, in addition to any other extensions you have enabled. +Desde esta vista, puedes acceder a los registros que generan las diversas extensiones que utilizas en {% data variables.product.prodname_vscode_shortname %}. Verás registros de {% data variables.product.prodname_github_codespaces %}, Autenticación de {% data variables.product.prodname_dotcom %}, Git y de cualquier otra extensión que hayas habilitado. {% endvscode %} {% webui %} -## Browser console logs +## Bitácoras de consola de buscador -These logs are useful only if you want to debug problems with using {% data variables.product.prodname_github_codespaces %} in the browser. They are useful for debugging problems creating and connecting to {% data variables.product.prodname_github_codespaces %}. +Estos registros son útiles únicamente si quieres depurar problemas con el uso de {% data variables.product.prodname_github_codespaces %} en el explorador. Son útiles para depurar problemas creando y conectándose a {% data variables.product.prodname_github_codespaces %}. -1. In the browser window for the codespace you want to debug, open the developer tools window. -1. Display the "Console" tab and click **errors** in the left sidebar to show only the errors. -1. In the log area on the right, right-click and select **Save as** to save a copy of the errors to your local machine. - ![Save errors](/assets/images/help/codespaces/browser-console-log-save.png) +1. En la ventana del buscador del codespace que quieres depurar, abre la ventana de herramientas de desarrollador. +1. Muestra la pestaña "Consola" y haz clic en **errores** en la barra lateral izquierda para mostrar solo los errores. +1. En el área de registro de la derecha, haga clic con el botón derecho y seleccione **Guardar como** para guardar una copia de los errores en la máquina local. + ![Guardar errores](/assets/images/help/codespaces/browser-console-log-save.png) {% endwebui %} {% jetbrains %} {% data reusables.codespaces.jetbrains-open-codespace-plugin %} -1. In the {% data variables.product.prodname_github_codespaces %} tool window, click the log icon. +1. En la ventana de herramientas de {% data variables.product.prodname_github_codespaces %}, haz clic en el icono del registro. - ![Screenshot of the log button](/assets/images/help/codespaces/jetbrains-plugin-icon-log.png) + ![Captura de pantalla del botón del registro](/assets/images/help/codespaces/jetbrains-plugin-icon-log.png) -## JetBrains logs +## Registros de JetBrains -You can download logs for the remote JetBrains IDE and the local client application by going to the **Help** menu in the JetBrains client application and clicking **Collect Host and Client Logs**. +Puedes descargar registros para el IDE remoto de JetBrains y la aplicación cliente local. Para ello, ve al menú **Ayuda** de la aplicación cliente de JetBrains y haz clic en **Recopilar registros de cliente y host**. {% endjetbrains %} -## Further reading +## Información adicional -- "[Reviewing your organization's audit logs for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)" -- "[Reviewing your security logs for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)" \ No newline at end of file +- "[Revisión de los registros de auditoría de la organización para {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)" +- "[Revisión de los registros de seguridad de {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)" diff --git a/translations/es-ES/content/codespaces/troubleshooting/index.md b/translations/es-ES/content/codespaces/troubleshooting/index.md index cabc8b2247..7ffbfbf616 100644 --- a/translations/es-ES/content/codespaces/troubleshooting/index.md +++ b/translations/es-ES/content/codespaces/troubleshooting/index.md @@ -1,7 +1,7 @@ --- -title: Troubleshooting GitHub Codespaces +title: Solución de problemas de GitHub Codespaces shortTitle: Troubleshooting -intro: 'These guides provide information for troubleshooting {% data variables.product.prodname_github_codespaces %}' +intro: 'Estas guías te proporcionan información para solucionar los problemas de {% data variables.product.prodname_github_codespaces %}' versions: fpt: '*' ghec: '*' @@ -21,5 +21,11 @@ children: - /troubleshooting-github-codespaces-clients - /troubleshooting-gpg-verification-for-github-codespaces - /working-with-support-for-github-codespaces +ms.openlocfilehash: 8704695a9ae39750bcc94229a62bb7eabcc6cdbe +ms.sourcegitcommit: 47e03737d09bed84dfedb7be5924d893d34ea1a8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167097' --- diff --git a/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md index e9c7c4560c..ea59795811 100644 --- a/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md +++ b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md @@ -1,6 +1,6 @@ --- -title: Troubleshooting creation and deletion of codespaces -intro: 'This article provides troubleshooting steps for common issues you may experience when creating or deleting a codespace, including storage and configuration issues.' +title: Solucionar problemas de creación y borrado de codespaces +intro: 'Este artículo te muestra los pasos para la solución de problemas comunes que podrías experimentar al crear o borrar un codespace, incluyendo los de almacenamiento y configuración.' versions: fpt: '*' ghec: '*' @@ -8,89 +8,94 @@ type: reference topics: - Codespaces shortTitle: Creation and deletion +ms.openlocfilehash: 09c3a73ec5e41f0170f1d3cd66df139bb2a497e5 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158697' --- +## Crear codespaces -## Creating codespaces +### Sin acceso para crear un codespace +Los {% data variables.product.prodname_github_codespaces %} no están disponibles para todos los repositorios. Si no se muestran las opciones para crear un codespace, es posible que {% data variables.product.prodname_github_codespaces %} no esté disponible para ese repositorio. Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#access-to-codespaces)". -### No access to create a codespace -{% data variables.product.prodname_github_codespaces %} is not available for all repositories. If the options for creating a codespace are not displayed, {% data variables.product.prodname_github_codespaces %} may not be available for that repository. For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#access-to-codespaces)." +Siempre y cuando te quede uso incluido mensual de {% data variables.product.prodname_github_codespaces %} en tu cuenta personal, o hayas configurado un método de pago y un límite de gasto, podrás crear codespaces para repositorios públicos. De todos modos, solo puedes crear un codespace para un repositorio privado si puedes insertar cambios en el repositorio o si puedes bifurcarlo. -Provided you have remaining monthly included usage of {% data variables.product.prodname_github_codespaces %} on your personal account, or you have set up a payment method and a spending limit, you will be able to create codespaces for public repositories. However, you can only create a codespace for a private repository if you can push changes to the repository, or you can fork the repository. +Si quieres obtener más información sobre el uso incluido para las cuentas personales y la configuración de un límite de gasto, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)" y "[Administración de límites de gasto para {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)". -For more information about included usage for personal accounts, and setting a spending limit, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)" and "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." +### El Codespace no abre cuando se crea -### Codespace does not open when created +Si creas un codespace y este no abre: -If you create a codespace and it does not open: +1. Intenta volver a cargar la página en caso de que hubiera un error de caché o problema reportado. +2. Ve a la página de {% data variables.product.prodname_github_codespaces %}: https://github.com/codespaces y comprueba si aparece el codespace nuevo. El proceso podría haber creado el codespace con éxito pero falló en reportarlo de vuelta a tu buscador. Si el codespace nuevo se ve listado, puedes abrirlo directamente desde esta página. +3. Reintenta crear el codespace para que el repositorio descarte un fallo de comunicación transitorio. -1. Try reloading the page in case there was a caching or reporting problem. -2. Go to your {% data variables.product.prodname_github_codespaces %} page: https://github.com/codespaces and check whether the new codespace is listed there. The process may have successfully created the codespace but failed to report back to your browser. If the new codespace is listed, you can open it directly from that page. -3. Retry creating the codespace for the repository to rule out a transient communication failure. +Si sigues sin poder crear un codespace para un repositorio en el que {% data variables.product.prodname_github_codespaces %} está disponible, {% data reusables.codespaces.contact-support %}. -If you still cannot create a codespace for a repository where {% data variables.product.prodname_github_codespaces %} is available, {% data reusables.codespaces.contact-support %} +### Error al crear un codespace -### Codespace creation fails - -If the creation of a codespace fails, it's likely to be due to a temporary infrastructure issue in the cloud - for example, a problem provisioning a virtual machine for the codespace. A less common reason for failure is if it takes longer than an hour to build the container. In this case, the build is cancelled and codespace creation will fail. +Si se produce un error al crear un codespace, es probable que se deba a una incidencia temporal de la infraestructura en la nube (por ejemplo, un problema al aprovisionar una máquina virtual para el codespace). Una razón menos común de este error es que el contenedor tarda más de una hora en compilarse. En este caso, se cancela la compilación y se producirá un error en la creación del codespace. {% note %} -**Note:** A codespace that was not successfully created is never going to be usable and should be deleted. For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)." +**Nota**: Un codespace que no se haya creado correctamente nunca podrá usarse y debe eliminarse. Para más información, vea "[Eliminación de un codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)". {% endnote %} -If you create a codespace and the creation fails: +Si creas un codespace y se produce un error en la creación: -1. Check {% data variables.product.prodname_dotcom %}'s [Status page](https://githubstatus.com) for any active incidents. -1. Go to [your {% data variables.product.prodname_github_codespaces %} page](https://github.com/codespaces), delete the codespace, and create a new codespace. -1. If the container is building, look at the logs that are streaming and make sure the build is not stuck. A container build that takes longer than one hour will be canceled, resulting in a failed creation. +1. Consulta la [página de estado](https://githubstatus.com) de {% data variables.product.prodname_dotcom %} para ver los incidentes activos. +1. Ve a [tu página de {% data variables.product.prodname_github_codespaces %}](https://github.com/codespaces), elimina el codespace y crea uno nuevo. +1. Si el contenedor se está compilando, examina los registros que se están transmitiendo y asegúrate de que la compilación no está bloqueada. Si la compilación de un contenedor tarda más de una hora, se cancelará y se producirá un error en la creación. - One common scenario where this could happen is if you have a script running that is prompting for user input and waiting for an answer. If this is the case, remove the interactive prompt so that the build can complete non-interactively. + Generalmente, esto puede ocurrir cuando hay un script en ejecución que solicita una entrada de usuario y espera una respuesta. Si este es el caso, quita el símbolo del sistema interactivo para que la compilación pueda completarse de forma no interactiva. {% note %} - **Note**: To view the logs during a build: - * In the browser, click **View logs.** + **Nota**: Para ver los registros durante una compilación: + * En el explorador, haz clic en **Ver registros**. - ![Screenshot of the Codespaces web UI with the View logs link emphasized](/assets/images/help/codespaces/web-ui-view-logs.png) + ![Captura de pantalla de la interfaz de usuario web de Codespaces con el vínculo Ver registros resaltado](/assets/images/help/codespaces/web-ui-view-logs.png) - * In the VS Code desktop application, click **Building codespace** in the "Setting up remote connection" that's displayed. + * En la aplicación de escritorio de VS Code, haz clic en **Compilar codespace** en la sección "Configurar conexión remota" que se muestra. - ![Screenshot of VS Code with the Building codespace link emphasized](/assets/images/help/codespaces/vs-code-building-codespace.png) + ![Captura de pantalla de VS Code con el vínculo Compilar codespace resaltado](/assets/images/help/codespaces/vs-code-building-codespace.png) {% endnote %} -2. If you have a container that takes a long time to build, consider using prebuilds to speed up codespace creations. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)." +2. Si tienes un contenedor que tarda mucho en compilarse, considera la posibilidad de usar precompilaciones para acelerar la creación de codespaces. Para obtener más información, consulta "[Configuración de precompilaciones](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)". -## Deleting codespaces +## Borrar codespaces -A codespace can only be deleted by: -* The person who created the codespace. -* An organization owner for an organization-owned codespace. -* Automatic deletion at the end of a retention period. +Solo pueden eliminar un codespace: +* La persona que creó el codespace. +* Un propietario de la organización en el caso de un codespace propiedad de la organización. +* La eliminación automática tras un período de retención. -For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)" and "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)." +Para obtener más información, consulta "[Eliminación de un codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)" y "[Configuración de la eliminación automática de los codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)". -## Container storage +## Almacenamiento de contenedores -When you create a codespace, it has a finite amount of storage and over time it may be necessary for you to free up space. Try running any of the following commands in the {% data variables.product.prodname_github_codespaces %} terminal to free up storage space. +Cuando creas un codespace, este tiene una cantidad de almacenamiento finita y, con el tiempo, podría que necesites liberar espacio. Intenta ejecutar cualquiera de los comandos siguientes en la terminal de {% data variables.product.prodname_github_codespaces %} para liberar espacio de almacenamiento. -- Remove packages that are no longer used by using `sudo apt autoremove`. -- Clean the apt cache by using `sudo apt clean`. -- See the top 10 largest files in the codespace with`sudo find / -printf '%s %p\n'| sort -nr | head -10`. -- Delete unneeded files, such as build artifacts and logs. +- Quita los paquetes que ya no se usan mediante `sudo apt autoremove`. +- Limpia la memoria caché apt mediante `sudo apt clean`. +- Consulta los 10 archivos más grandes del codespace mediante `sudo find / -printf '%s %p\n'| sort -nr | head -10`. +- Borra los archivos innecesarios, tales como los artefactos y bitácoras de compilación. -Some more destructive options: +Algunas opciones más destructivas: -- Remove unused Docker images, networks, and containers by using `docker system prune` (append `-a` if you want to remove all images, and `--volumes` if you want to remove all volumes). -- Remove untracked files from working tree: `git clean -i`. +- Quita imágenes de Docker, redes y contenedores sin usar mediante `docker system prune` (anexa `-a` si quieres quitar todas las imágenes y `--volumes` si quieres quitar todos los volúmenes). +- Quita los archivos sin seguimiento del árbol de trabajo: `git clean -i`. -## Configuration +## Configuración {% data reusables.codespaces.recovery-mode %} ``` This codespace is currently running in recovery mode due to a container error. ``` -Review the creation logs and update the dev container configuration as needed. For more information, see "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)." +Revisa los registros de creación y actualiza la configuración del contenedor de desarrollo según sea necesario. Para más información, consulta "[Registros de {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/github-codespaces-logs)". -You can then try restarting the codespace, or rebuilding the container. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)." +Después, puedes intentar reiniciar el codespace o recompilar el contenedor. Para obtener más información, consulte "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)". diff --git a/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md new file mode 100644 index 0000000000..e4f8a02a2a --- /dev/null +++ b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md @@ -0,0 +1,118 @@ +--- +title: Solución de problemas de clientes de GitHub Codespaces +shortTitle: Codespaces clients +intro: 'En este artículo se proporciona información para solucionar problemas que puedes encontrar con el cliente que usas para {% data variables.product.prodname_github_codespaces %}.' +miniTocMaxHeadingLevel: 3 +versions: + fpt: '*' + ghec: '*' +type: reference +topics: + - Codespaces +redirect_from: + - /codespaces/troubleshooting/troubleshooting-codespaces-clients +ms.openlocfilehash: 682160b3b92960487c0709fc411fc2143d18f415 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159900' +--- +{% jetbrains %} + +{% data reusables.codespaces.codespaces-jetbrains-beta-note %} + +{% endjetbrains %} + +{% webui %} + +## Solución de problemas del cliente web de {% data variables.product.prodname_vscode %} + +Si tienes problemas al usar {% data variables.product.prodname_github_codespaces %} en un explorador que no está basado en Chromium, intenta cambiar a un explorador basado en Chromium, como Google Chrome o Microsoft Edge. De forma alternativa, puedes buscar incidencias conocidas con el explorador en el repositorio [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen); para ello, busca incidencias etiquetadas con el nombre del explorador, como [`firefox`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+label%3Afirefox) o [`safari`](https://github.com/Microsoft/vscode/issues?q=is%3Aopen+is%3Aissue+label%3Asafari). + +Si tienes problemas al usar {% data variables.product.prodname_github_codespaces %} en un explorador basado en Chromium, puedes comprobar si experimenta otra incidencia conocida con {% data variables.product.prodname_vscode_shortname %} en el repositorio [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen). + +### Diferencias al trabajar en {% data variables.product.prodname_vscode_shortname %} localmente + +Al abrir un codespace en el explorador, con el cliente web de {% data variables.product.prodname_vscode_shortname %}, observarás algunas diferencias con respecto a trabajar en un área de trabajo local en la aplicación de escritorio de {% data variables.product.prodname_vscode_shortname %}. Por ejemplo, algunas uniones de teclas serán diferentes o no estarán y algunas extensiones podrían comportarse de forma diferente. Para obtener un resumen, consulta: "[Limitaciones conocidas y adaptaciones](https://code.visualstudio.com/docs/remote/codespaces#_known-limitations-and-adaptations)" en la documentación de {% data variables.product.prodname_vscode_shortname %}. + +Puedes comprobar si hay incidencias conocidas y registrar nuevas incidencias con la experiencia de {% data variables.product.prodname_vscode_shortname %} en el repositorio [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces). + +### {% data variables.product.prodname_vscode %} Insiders + +{% data variables.product.prodname_vscode %} Insiders es el lanzamiento más frecuente de {% data variables.product.prodname_vscode_shortname %}. Tiene todas las características y correcciones de errores más recientes, pero también podría contener, ocasionalmente, problemas nuevos que podrían dar como resultado una compilación rota. + +Si estás utilizando una compilación de Insiders y notas un comportamiento anormal, te recomendamos cambiar a la versión estable de {% data variables.product.prodname_vscode %} e intentarlo de nuevo. + +Haz clic en {% octicon "gear" aria-label="The manage icon" %} en la parte inferior izquierda del editor y selecciona **Cambiar a versión estable...** . Si el cliente web de {% data variables.product.prodname_vscode_shortname %} no se carga o el icono {% octicon "gear" aria-label="The manage icon" %} no está disponible, puedes forzar el cambio a {% data variables.product.prodname_vscode %} Estable si anexas `?vscodeChannel=stable` a la dirección URL del codespace y lo cargas en esa dirección URL. + +Si la incidencia no se ha corregido en {% data variables.product.prodname_vscode %} Estable, comprueba si hay incidencias conocidas y, si es necesario, registra una nueva incidencia con la experiencia de {% data variables.product.prodname_vscode_shortname %}, en el repositorio [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces). + +{% endwebui %} + +{% vscode %} + +## Solución de problemas de {% data variables.product.prodname_vscode_shortname %} + +Al abrir un codespace en la aplicación de escritorio de {% data variables.product.prodname_vscode_shortname %}, es posible que observes algunas diferencias en comparación con trabajar en un área de trabajo local, pero la experiencia debe ser similar. + +Si encuentras incidencias, puedes comprobar si hay incidencias conocidas y registrar nuevas incidencias con la experiencia de {% data variables.product.prodname_vscode_shortname %} en el repositorio [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces). + +### {% data variables.product.prodname_vscode %} Insiders + +{% data variables.product.prodname_vscode %} Insiders es el lanzamiento más frecuente de {% data variables.product.prodname_vscode_shortname %}. Tiene todas las características y correcciones de errores más recientes, pero también podría contener, ocasionalmente, problemas nuevos que podrían dar como resultado una compilación rota. + +Si estás utilizando una compilación de Insiders y notas un comportamiento anormal, te recomendamos cambiar a la versión estable de {% data variables.product.prodname_vscode %} e intentarlo de nuevo. + +Para cambiar a {% data variables.product.prodname_vscode %} Estable, cierra la aplicación de {% data variables.product.prodname_vscode %} Insiders, abre la aplicación de {% data variables.product.prodname_vscode %} Estable y vuelve a abrir el codespace. + +Si la incidencia no se ha corregido en {% data variables.product.prodname_vscode %} Estable, comprueba si hay incidencias conocidas y, si es necesario, registra una nueva incidencia con la experiencia de {% data variables.product.prodname_vscode_shortname %}, en el repositorio [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces). + +{% endvscode %} + +{% jetbrains %} + +## Solución de problemas de los IDE de JetBrains + +### Problemas de rendimiento + +Se recomienda un tipo de máquina de {% data variables.product.prodname_github_codespaces %} con al menos 4 núcleos para ejecutar cualquiera de los IDE de JetBrains. Para obtener más información, consulte "[Cambio del tipo de máquina para el codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)". + +Si usas una máquina con 4 o más núcleos y el rendimiento que experimentas en JetBrains es un poco lento, es posible que tengas que aumentar el tamaño máximo del montón de Java. + +Se recomienda establecer el tamaño máximo del montón a una cifra entre 2862 MiB (3 GB) y el 60 % de la RAM del host remoto. + +A continuación se proporcionan algunas instrucciones como punto de partida inicial, que puedes ajustar en función del tamaño del código base y la memoria necesaria para ejecutar la aplicación. Por ejemplo, si tienes un código base grande o complicado, es posible que tengas que aumentar aún más el tamaño del montón. Si tienes una aplicación más grande, puedes establecer un tamaño de montón inferior para permitir que la aplicación tenga más memoria. + +| Tipo de máquina | Tamaño máximo del montón | +| -------------- | ----------------- | +| 4 núcleos | 3 GB | +| 8 núcleos | 4 GB | +| 16 o 32 núcleos | 8 GB | + +1. A la izquierda de la barra de navegación, en la parte superior de la ventana de la aplicación, haz clic en el nombre del codespace. + + ![Captura de pantalla del botón de recursos en JetBrains](/assets/images/help/codespaces/jetbrains-resources-button.png) + +1. En la pestaña Rendimiento, observa los detalles de carga de CPU y memoria. Estos indicarán si la máquina está sobrecargada. + + ![Captura de pantalla del botón Localhost en JetBrains](/assets/images/help/codespaces/jetbrains-performance.png) + +1. Haz clic en la pestaña Configuración y edita el tamaño del montón, no lo aumentes a más del 60 % de la memoria disponible para el codespace. + + ![Captura de pantalla de la configuración de tamaño máximo del montón](/assets/images/help/codespaces/jetbrains-heap-setting.png) + +1. Haz clic en **Guardar y reiniciar**. + +### Problemas de conexión SSH + +Para conectarse a través del servidor SSH que se ejecuta en el codespace, debes tener una clave SSH en el directorio `~/.ssh` (MacOS y Linux) o en el directorio `%HOMEPATH%\.ssh` (Windows) que ya se haya agregado a la cuenta de {% data variables.product.prodname_dotcom %}. Si no tienes ninguna clave en este directorio, {% data variables.product.prodname_cli %} generará claves automáticamente. Para obtener más información, consulta "[Adición de una clave SSHa tu cuenta de {% data variables.product.prodname_dotcom %}](/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account?platform=windows&tool=webui)". + +Si tienes problemas con la validación de claves, prueba a actualizar la versión de {% data variables.product.prodname_cli %}. Para obtener información, consulta las [instrucciones de actualización](https://github.com/cli/cli#installation) del archivo Léame de {% data variables.product.prodname_cli %}. + +### Problemas del IDE de JetBrains + +Para obtener ayuda con problemas específicos del IDE de JetBrains que usas o la aplicación de puerta de enlace de JetBrains, consulta "[Soporte técnico del producto](https://www.jetbrains.com/support/)" en el sitio web de JetBrains. + +{% endjetbrains %} + diff --git a/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md new file mode 100644 index 0000000000..23b8b6f86c --- /dev/null +++ b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md @@ -0,0 +1,117 @@ +--- +title: Solución de problemas de la comprobación de GPG para GitHub Codespaces +shortTitle: GPG verification +intro: En este artículo se proporcionan consejos para solucionar problemas de errores relacionados con la firma de las confirmaciones en los espacios de código. +versions: + fpt: '*' + ghec: '*' +type: reference +topics: + - Codespaces +ms.openlocfilehash: f3a6537d1ee9087803054347689591c2b217e42e +ms.sourcegitcommit: 47e03737d09bed84dfedb7be5924d893d34ea1a8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167121' +--- +Si habilitas la comprobación de GPG, {% data variables.product.prodname_github_codespaces %} firma automáticamente las confirmaciones en los espacios de código creados a partir de repositorios seleccionados. Para más información, consulta: "[Administración de la comprobación de GPG para {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)." + +{% data reusables.codespaces.gpg-in-active-codespaces %} + +Si {% data variables.product.prodname_github_codespaces %} no puede firmar una confirmación, es posible que veas un error similar al siguiente. + +```Shell +$ git commit -m 'Initial commit' +error: gpg failed to sign the data +fatal: failed to write commit object +``` + +Puede encontrar este error si: + +- Has deshabilitado la comprobación de GPG e intentas realizar una confirmación normal sin firmar en un espacio de código existente. +- Has habilitado la comprobación de GPG, pero has reemplazado la configuración de Git necesaria para que los datos {% data variables.product.prodname_github_codespaces %} firmen las confirmaciones, por ejemplo, al vincular {% data variables.product.prodname_github_codespaces %} con un repositorio de dotfiles que contiene archivos de configuración de Git. + +## Errores después de deshabilitar la comprobación de GPG + +Al habilitar la comprobación de GPG, {% data variables.product.prodname_github_codespaces %} firma todas las confirmaciones que realices en los espacios de código de forma predeterminada. Esto ocurre al establecer el `commit.gpgsign` valor de configuración de Git a `true`. + +Si ha deshabilitado la comprobación de GPG y está trabajando en un espacio de código existente, este valor seguirá estando establecido en `true`. Esto significa que {% data variables.product.prodname_github_codespaces %} intentará firmar las confirmaciones, pero no podrá hacerlo, ya que has deshabilitado la configuración de comprobación de GPG. + +Para seguir realizando confirmaciones normales sin firmar en el espacio de código, restablece `commit.gpgsign` al valor predeterminado de `false` al escribir el siguiente comando en el terminal. + +```Shell{:copy} +git config --unset commit.gpgsign +``` + +Para comprobar que el valor se ha eliminado correctamente de la configuración, escribe `git config --list`. No deberías ver un valor para `commit.gpgsign` en la lista. + +## Errores causados por configuraciones en conflicto + +Para firmar automáticamente las confirmaciones, {% data variables.product.prodname_github_codespaces %} establece unos valores de configuración de Git determinados en el espacio de código. Si invalidas los valores establecidos por {% data variables.product.prodname_github_codespaces %}, es posible que no puedas firmar las confirmaciones. + +Es posible que invalides accidentalmente estos valores si has vinculado {% data variables.product.prodname_github_codespaces %} con un repositorio dotfiles que contiene archivos de configuración de Git. Para obtener más información sobre el uso de dotfiles con {% data variables.product.prodname_github_codespaces %}, consulta: "[Personalización de {% data variables.product.prodname_github_codespaces %} para tu cuenta](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#dotfiles)." + +### Comprobación de configuraciones en conflicto + +Para firmar las confirmaciones con GPG, {% data variables.product.prodname_github_codespaces %} establece automáticamente los siguientes valores de configuración de Git en el nivel del sistema. + +| Opción de configuración | Valor obligatorio | +| --------------------- | -------------- | +| `user.name` | Debe coincidir con el nombre completo establecido en tu perfil de {% data variables.product.prodname_dotcom %} | +| `credential.helper` | Se debe establecer en `/.codespaces/bin/gitcredential_github.sh` | +| `gpg.program` | Se debe establecer en `/.codespaces/bin/gh-gpgsign` | + +Para comprobar que estos valores se establecen correctamente en un espacio de código, puedes usar el comando `git config --list --show-origin`. Dado que {% data variables.product.prodname_github_codespaces %} establece esta configuración en el nivel del sistema, los valores de configuración necesarios deben proceder de `/usr/local/etc/gitconfig`. + +```Shell +$ git config --list --show-origin +file:/usr/local/etc/gitconfig credential.helper=/.codespaces/bin/gitcredential_github.sh +file:/usr/local/etc/gitconfig user.name=Mona Lisa +file:/usr/local/etc/gitconfig gpg.program=/.codespaces/bin/gh-gpgsign +``` + +Además de los valores enumerados anteriormente, pueden producirse errores si los dotfiles usados en los espacios de código contienen cualquiera de los valores siguientes. + +- El valor de configuración de Git `user.signingkey` +- El valor de configuración de Git `commit.gpgsign` +- Un `GITHUB_TOKEN` establecido manualmente + +### Eliminación de configuraciones en conflicto + +Si deseas mantener habilitada la comprobación automática de GPG para {% data variables.product.prodname_github_codespaces %}, deberás eliminar cualquier tipo de configuraciones en conflicto de los dotfiles usados en los espacios de código. + +Por ejemplo, si el archivo global `.gitconfig` del equipo local contiene un valor `gpg.program` y lo has insertado en un repositorio de dotfiles que está vinculado a {% data variables.product.prodname_github_codespaces %}, probablemente desearás eliminar `gpg.program` de este archivo y establecerlo en su lugar en el nivel del sistema del equipo local. + +{% note %} + +**Nota:** los cambios realizados en el repositorio de dotfiles se aplicarán a los nuevos espacios de código que crees, pero no a los espacios de código existentes. + +{% endnote %} + +1. En el equipo local, abra un terminal. +2. Para quitar el valor en conflicto de `~/.gitconfig` (Mac/Linux) o `C:\Users\YOUR-USER\.gitconfig` (Windows), usa el comando `git config --global --unset`. + + ```Shell + $ git config --global --unset gpg.program + ``` +3. Inserta el cambio en el repositorio de dotfiles en {% data variables.product.prodname_dotcom %}. +4. Opcionalmente, para mantener la configuración local, establece el valor de nuevo en un archivo de configuración de Git que no insertes en el repositorio de dotfiles. + + Por ejemplo, puedes usar la marca `--system` para establecer la configuración en el archivo de nivel de sistema en `PATH/etc/gitconfig`, donde `PATH` es el directorio en el que está instalado Git en el sistema. + + ```Shell + $ git config --system gpg.program gpg2 + ``` + +Como alternativa, si el repositorio de dotfiles contiene un script de instalación en un archivo reconocido como `install.sh`, puedes usar la variable de entorno `$CODESPACES` para agregar lógica condicional, como por ejemplo establecer únicamente `gpg.program` si no te encuentras en un espacio de código. En el ejemplo siguiente, `-z "$CODESPACES"` devuelve `true` si no estás ubicado en un espacio de código. + +```Shell{:copy} +if [ -z "$CODESPACES" ]; then + git config --global gpg.program gpg2 +fi +``` + +## Información adicional +- "[Acerca de la verificación de firma de confirmación](/authentication/managing-commit-signature-verification/about-commit-signature-verification)" +- [`git config`](https://git-scm.com/docs/git-config) en la documentación oficial de Git diff --git a/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md index 2264e6432e..5f9e656e1d 100644 --- a/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md +++ b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Troubleshooting port forwarding for GitHub Codespaces -intro: Troubleshooting steps for common port forwarding issues. +title: Solución de problemas de reenvío de puertos en GitHub Codespaces +intro: Pasos de solución de problemas para los problemas comunes del reenvío de puertos. versions: fpt: '*' ghec: '*' @@ -10,17 +10,22 @@ topics: shortTitle: Port forwarding redirect_from: - /codespaces/troubleshooting/troubleshooting-port-forwarding-for-codespaces +ms.openlocfilehash: 828150ca05c18cb1106f5a3c883331785b6bce2e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159153' --- +Cuando una aplicación que se ejecuta en un codespace genera un puerto para la consola, {% data variables.product.prodname_github_codespaces %} detecta el patrón de la dirección URL del host local y reenvía el puerto automáticamente. Para obtener más información, consulta "[Reenvío de puertos en el codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)". -When an application running inside a codespace outputs a port to the console, {% data variables.product.prodname_github_codespaces %} detects the localhost URL pattern and automatically forwards the port. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." +Si un puerto no se reenvía automáticamente, puedes reenviarlo manualmente. Para obtener más información, consulta "[Reenvío de un puerto](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace#forwarding-a-port)". -If a port is not automatically forwarded, you can forward it manually. For more information, see "[Forwarding a port](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace#forwarding-a-port)." +Si se configura el reenvío de puertos, verifica lo siguiente: -If port forwarding is set up, check the following: +- Usa el vínculo incluido en el mensaje de notificación del sistema, que aparece en la esquina inferior derecha de {% data variables.product.prodname_vscode_shortname %}, o haz clic en la dirección URL del Terminal, para abrir el puerto reenviado. No funcionará teclear `localhost:8000` (como ejemplo) en tu equipo local si estás conectado al codespace a través del explorador. +- Asegúrate de verificar que tu aplicación aún se esté ejecutando desde dentro de tu codespace. Si tu codespace paró después de un periodo de inactividad, necesitarás garantizar que tu aplicación reinicie una vez que se reinició el codespace. -- Use the link in the notification "toast" message, that pops up in the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, or click the URL in Terminal, to open the forwarded port. Typing in `localhost:8000` (as an example) to your local machine will not work if you're connected to the codespace via the browser. -- Make sure to check that your application is still running from within your codespace. If your codespace has stopped after a period of inactivity, you'll need to ensure to restart your application once the codespace has restarted. - -Typically, you can make a forwarded port accessible publicly, or within the organization that owns a repository. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." If either, or both, of the options for public or organization visibility are not available, this indicates that an organization-level policy has been configured. For more information, see "[Restricting the visibility of forwarded ports](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)." +Normalmente, puedes hacer que un puerto reenviado sea accesible públicamente o dentro de la organización que posee un repositorio. Para obtener más información, consulta "[Reenvío de puertos en el codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)". Si las opciones de visibilidad pública o de la organización no están disponibles, esto indica que se ha configurado una directiva de nivel de organización. Para más información, vea "[Restricción de la visibilidad de los puertos reenviados](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)". {% data reusables.codespaces.forwarded-ports-environment-variable %} diff --git a/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md index c403cf9f6c..f7b07593bc 100644 --- a/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md +++ b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Troubleshooting your connection to GitHub Codespaces -intro: 'Troubleshooting help for connecting to {% data variables.product.prodname_github_codespaces %}.' +title: Solución de problemas de la conexión a GitHub Codespaces +intro: 'Ayuda para resolver problemas para conectarse a {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -10,49 +10,54 @@ topics: shortTitle: Connection redirect_from: - /codespaces/troubleshooting/troubleshooting-your-connection-to-codespaces +ms.openlocfilehash: 75632e73b689ed7fe1df95027f6e5170136c7935 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160068' --- - ## 503 codespace service unavailable -Codespaces are set to stop after 30 minutes without any activity. If you try to interact with a codespace after it has stopped, you may see a `503 service unavailable` error. +Los codespaces están configurados para detenerse después de pasar 30 minutos sin actividad. Si intenta interactuar con un codespace después de que se haya detenido, es posible que vea un error `503 service unavailable`. -- If a **Start** button is shown in {% data variables.product.prodname_vscode %} or in your browser window, click **Start** to reconnect to the codespace. -- Reset your codespace by reloading the window. From the [Command Palette](/codespaces/codespaces-reference/using-the-command-palette-in-codespaces#accessing-the-command-palette) in {% data variables.product.prodname_vscode %}, click **Developer: Reload Window**. +- Si se muestra un botón **Iniciar** en {% data variables.product.prodname_vscode %} o en la ventana del explorador, haga clic en **Iniciar** para volver a conectarse al codespace. +- Restablece tu codespace volviendo a cargar la ventana. Desde la [paleta de comandos](/codespaces/codespaces-reference/using-the-command-palette-in-codespaces#accessing-the-command-palette) de {% data variables.product.prodname_vscode %}, haz clic en **Desarrollador: Volver a cargar Windows**. -## Browser cannot connect +## El buscador no se puede conectar -Sometimes you may not be able to access a codespace from your browser. If this happens, go to https://github.com/codespaces and try connecting to the codespace from that page. +Es posible que en ocasiones no puedas acceder a un codespace desde tu buscador. Si esto sucede, vaya a https://github.com/codespaces e intente conectarse al codespace desde esa página. - - If the codespace is not listed on that page, check that you are the owner of the codespace you are trying to connect to. You can only open a codespace that you created. The URLs for your codespaces always include your {% data variables.product.company_short %} handle. - - If the codespace is listed but you cannot connect from that page, check whether you can connect using a different browser. + - Si el codespce no se lista en esa página, verifica que seas el propietario del codespace al cual intentas conectarte. Solo puedes abrir un codespace que tú mismo hayas creado. Las URL de tus codespaces siempre incluyen tu manejo de {% data variables.product.company_short %}. + - Si el codespace se enlista pero no puedes conectarte desde esa página, revisa si puedes conectarte utilizando un buscador diferente. -Your company network may be blocking the connection. If possible, check any logging for rejected connections on your device. +Tu red empresarial puede estar bloqueando la conección. De ser posible, revisa cualquier registro en bitácora para ver si hay conexiones rechazadas en tu dispositivo. -If you still cannot connect, {% data reusables.codespaces.contact-support %} +Si aún no puedes conectarte, {% data reusables.codespaces.contact-support %} -## Unable to connect to your codespace in JupyterLab +## No se puede conectar al codespace en JupyterLab -To be able to use a codespace in JupyterLab, you must ensure that your codespace has it installed. The default container image that's used by {% data variables.product.prodname_github_codespaces %} includes JupyterLab, but if you have customized your dev container configuration you will have to manually install JupyterLab. +Para poder usar un codespace en JupyterLab, debes asegurarte de que el codespace lo tiene instalado. La imagen de contenedor predeterminada que usa {% data variables.product.prodname_github_codespaces %} incluye JupyterLab, pero si has personalizado la configuración del contenedor de desarrollo, tendrás que instalar manualmente JupyterLab. -If your codespace uses a Debian-based image, you can install JupyterLab in the dev container by adding the `python` feature to your `devcontainer.json` file, with the `installJupyterlab` option set to `true`. Otherwise, install it directly in your Dockerfile. For installation instructions, see "[Installation](https://jupyterlab.readthedocs.io/en/stable/getting_started/installation.html)" in the JupyterLab documentation. +Si el codespace usa una imagen basada en Debian, puedes instalar JupyterLab en el contenedor de desarrollo agregando la característica `python` al archivo `devcontainer.json`, con la opción `installJupyterlab` establecida en `true`. De lo contrario, instálalo directamente en el archivo Dockerfile. Para obtener instrucciones de instalación, consulta "[Instalación](https://jupyterlab.readthedocs.io/en/stable/getting_started/installation.html)" en la documentación de JupyterLab. -For more information about the `python` feature, see the README page in the [`devcontainers/features` repository](https://github.com/devcontainers/features/tree/main/src/python). For more information about the `devcontainer.json` file and the Dockerfile, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)." +Para obtener más información sobre la característica `python`, consulta la página Léame en el [repositorio `devcontainers/features`](https://github.com/devcontainers/features/tree/main/src/python). Para obtener más información sobre el archivo `devcontainer.json` y el archivo Dockerfile, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)". -If you still cannot connect, {% data reusables.codespaces.contact-support %} +Si aún no puedes conectarte, {% data reusables.codespaces.contact-support %} -## {% data variables.product.prodname_github_codespaces %} extension for {% data variables.product.prodname_vscode %} cannot connect +## La extensión de {% data variables.product.prodname_github_codespaces %} para {% data variables.product.prodname_vscode %} no puede conectarse -If you cannot connect to a codespace from {% data variables.product.prodname_vscode %} desktop, use the following troubleshooting steps. +Si no puedes conectarte a un codespace desde la versión de escritorio de {% data variables.product.prodname_vscode %}, utiliza los siguientes pasos de solución de problemas. -1. Check that you have the latest version of the {% data variables.product.prodname_github_codespaces %} extension installed. The extension is a preview release and frequent updates are released. - 1. In {% data variables.product.prodname_vscode %}, display the "Extensions" tab. - 2. Select the {% data variables.product.prodname_github_codespaces %} extension to display the extension's overview page. - 3. If an update is available, a button is shown, click **Update to X.X.X** to upgrade to the latest version. -2. Check whether you are using the stable build of {% data variables.product.prodname_vscode %} or the [{% data variables.product.prodname_vscode %} Insiders](https://code.visualstudio.com/insiders/) release (nightly updates). If you are using the insiders release, try installing the [stable build](https://code.visualstudio.com/). -3. Your company network may be blocking the connection. If possible, check any logging for rejected connections on your device. +1. Verifica que tengas instalada la última versión de {% data variables.product.prodname_github_codespaces %}. La extensión es un lanzamiento de vista previa y se lanzan actualizaciones frecuentemente. + 1. En {% data variables.product.prodname_vscode %}, muestra la pestaña de "Extensiones". + 2. Selecciona la extensión de {% data variables.product.prodname_github_codespaces %} para mostrar la página de resumen de extensiones. + 3. Si hay una actualización disponible, se muestra un botón; haga clic en **Actualizar a X.X.X** para actualizar a la versión más reciente. +2. Compruebe si usa la compilación estable de {% data variables.product.prodname_vscode %} o la versión [{% data variables.product.prodname_vscode %} Insiders](https://code.visualstudio.com/insiders/) (actualizaciones nocturnas). Si usa la versión Insiders, pruebe a instalar la [compilación estable](https://code.visualstudio.com/). +3. Tu red empresarial puede estar bloqueando la conección. De ser posible, revisa cualquier registro en bitácora para ver si hay conexiones rechazadas en tu dispositivo. -If you still cannot connect, {% data reusables.codespaces.contact-support %} +Si aún no puedes conectarte, {% data reusables.codespaces.contact-support %} -### The codespace has latency issues +### El codespace tiene problemas de latencia -If the codespace seems particularly slow or has latency issues, it is possible that it has been created in a region that is far from you. To resolve this, you can [manually set your {% data variables.product.prodname_github_codespaces %} region](/codespaces/managing-your-codespaces/setting-your-default-region-for-codespaces). +Si el codespace se ve particularmente lento o tiene problemas de latencia, es posible que se haya creado en una región lejos de ti. Para resolverlo, puede [establecer manualmente la región de {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/setting-your-default-region-for-codespaces). diff --git a/translations/es-ES/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md b/translations/es-ES/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md index c75eb6ab59..55c2878b80 100644 --- a/translations/es-ES/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md +++ b/translations/es-ES/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Working with support for GitHub Codespaces -intro: 'Tips on getting the best help from support for {% data variables.product.prodname_github_codespaces %}.' +title: Trabajar con el soporte técnico de GitHub Codespaces +intro: 'Sugerencias para obtener la mejor ayuda del soporte técnico de {% data variables.product.prodname_github_codespaces %}.' versions: fpt: '*' ghec: '*' @@ -10,29 +10,34 @@ topics: shortTitle: Working with support redirect_from: - /codespaces/troubleshooting/working-with-support-for-codespaces +ms.openlocfilehash: a4db589cb5d8de71e6e8c7d109e0156885c33848 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159899' --- +Antes de que soporte pueda ayudarte con los problemas de los codespaces, necesitas saber el nombre permanente del codespace y su ID de codespaces (identificador). Adicionalmente, soporte podría pedirte que le compartas algunas bitácoras. Para más información, consulta "[Registros de {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/github-codespaces-logs)" y "[Acerca del soporte técnico de GitHub](/github/working-with-github-support/about-github-support)". -Before support can help you with problems with codespaces, you need to know the permanent name of the codespace and its codespaces ID (identifier). In addition, support may ask you to share some logs with them. For more information, see "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)" and "[About GitHub Support](/github/working-with-github-support/about-github-support)." +## Nombres de los codespaces -## Codespace names +Cada codespace tiene un nombre único que es una combinación de tu manejo de {% data variables.product.company_short %}, dos o tres palabras generadas automáticamente y algunos caracteres aleatorios. Por ejemplo: `octocat-literate-space-parakeet-mld5`. Las dos o tres palabras generadas automáticamente también forman el nombre para mostrar inicial del codespace, en este caso, `literate-space-parakeet`. Puedes cambiar el nombre para mostrar de un codespace, pero esto no afectará al nombre permanente. Para obtener más información, consulta "[Cambio del nombre de un codespace](/codespaces/customizing-your-codespace/renaming-a-codespace)". -Each codespace has a unique name that is a combination of your {% data variables.product.company_short %} handle, two or three automatically generated words, and some random characters. For example: `octocat-literate-space-parakeet-mld5`. The two or three automatically generated words also form the initial display name of your codespace, in this case, `literate-space-parakeet`. You can change the display name for a codespace, but this will not affect the permanent name. For more information, see "[Renaming a codespace](/codespaces/customizing-your-codespace/renaming-a-codespace)." +Para encontrar el nombre de un codespace: -To find the name of a codespace: +- Abre el codespace en el buscador. El subdominio de la URL es el nombre del codespace. Por ejemplo: `https://octocat-literate-space-parakeet-mld5.github.dev` es la dirección URL del URL `octocat-literate-space-parakeet-mld5`. +- Si no puede abrir un codespace, puedes acceder al nombre en {% data variables.product.product_name %} en https://github.com/codespaces. El nombre se muestra en un elemento emergente al mantener el puntero sobre el nombre para mostrar de un codespace en https://github.com/codespaces. + ![Nombre del codespace que se muestra al pasar el puntero del mouse](/assets/images/help/codespaces/find-codespace-name-github.png) -- Open the codespace in the browser. The subdomain of the URL is the name of the codespace. For example: `https://octocat-literate-space-parakeet-mld5.github.dev` is the URL for the `octocat-literate-space-parakeet-mld5` codespace. -- If you cannot open a codespace, you can access the name in {% data variables.product.product_name %} on https://github.com/codespaces. The name is shown in a pop-up when you hover over the display name of a codespace on https://github.com/codespaces. - ![Codespace name shown on hover over](/assets/images/help/codespaces/find-codespace-name-github.png) +El nombre del codespace también se incluye en muchos otros archivos de bitácora. Por ejemplo, en el codespace se registra como el valor de `friendlyName`, en el registro de extensión {% data variables.product.prodname_github_codespaces %} después de `making GET request for` y en el registro de consola del explorador después de `clientUrl`. Para más información, consulta "[Registros de {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/github-codespaces-logs)". -The name the codespace is also included in many of the log files. For example, in the codespace logs as the value of `friendlyName`, in the {% data variables.product.prodname_github_codespaces %} extension log after `making GET request for`, and in the browser console log after `clientUrl`. For more information, see "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)." +## ID de los codespaces -## Codespaces IDs +Cada codespace también tiene un ID (identificador). Este no se muestra predeterminadamente en {% data variables.product.prodname_vscode %}, así que podrías tener que actualizar los ajustes para la extensión de {% data variables.product.prodname_github_codespaces %} antes de que puedas acceder a la ID. -Every codespace also has an ID (identifier). This is not shown by default in {% data variables.product.prodname_vscode %} so you may need to update the settings for the {% data variables.product.prodname_github_codespaces %} extension before you can access the ID. - -1. In {% data variables.product.prodname_vscode %}, browser or desktop, in the Activity Bar on the left, click **Remote Explorer** to show details for the codespace. +1. En el explorador o el escritorio de {% data variables.product.prodname_vscode %}, en la barra de actividad a la izquierda, haga clic en **Explorador remoto** para mostrar los detalles del codespace. {% indented_data_reference reusables.codespaces.remote-explorer spaces=3 %} -1. If the sidebar includes a "Codespace Performance" section, hover over the "Codespace ID" and click the clipboard icon to copy the ID. -1. If the information is not shown, click {% octicon "gear" aria-label="The gear icon" %}, in the bottom-left corner of the Activity Bar, to display the "Settings" tab. -1. Expand **Extensions** and click **{% data variables.product.prodname_github_codespaces %}** to display the settings for the extension. Then enable **Show Performance Explorer** to display the "Codespace Performance" section in the sidebar. - ![Codespace ID and settings required to display performance information](/assets/images/help/codespaces/find-codespace-id.png) +1. Si la barra lateral incluye una sección de "Rendimiento del Codespace", pasa el puntero del mouse sobre "ID del Codespace" y haz clic en el icono de portapapeles para copiar la ID. +1. Si no se muestra la información, haz clic en {% octicon "gear" aria-label="The gear icon" %} en la esquina inferior izquierda de la barra de actividad para mostrar la pestaña de "Ajustes". +1. Expanda **Extensiones** y haga clic en **{% data variables.product.prodname_github_codespaces %}** para mostrar la configuración de la extensión. Después, habilite **Mostrar Explorador de rendimiento** para mostrar la sección "Rendimiento de Codespace" en la barra lateral. + ![Id. y valores del codespace necesarios para mostrar la información de rendimiento](/assets/images/help/codespaces/find-codespace-id.png) diff --git a/translations/es-ES/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization.md b/translations/es-ES/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization.md index 0c62ef4329..8dd1d5fd89 100644 --- a/translations/es-ES/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization.md +++ b/translations/es-ES/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization.md @@ -1,6 +1,6 @@ --- -title: Blocking a user from your organization -intro: Organization owners and moderators can block anyone who is not a member of the organization from collaborating on the organization's repositories. +title: Bloquear a un usuario de tu organización +intro: Los propietarios y moderadores de la organización pueden impedir que cualquier persona que no sea miembro de la organización colabore en los repositorios de la organización. redirect_from: - /articles/blocking-a-user-from-your-organization - /github/building-a-strong-community/blocking-a-user-from-your-organization @@ -10,68 +10,71 @@ versions: topics: - Community shortTitle: Block from your org +ms.openlocfilehash: 527ce4fcf92946836f7a3d93e5caf07193561d4b +ms.sourcegitcommit: 1529de77bfcbe45519131b5f5fb3ab319758c2d2 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148164359' --- - -You can block non-members from within your organization's settings or from a specific comment made by a user. When you block a user in a comment, you can choose to send the user a notification explaining that they were blocked and why. Otherwise, the user is not directly notified that you've blocked them. Blocked users can still delete their existing content. +Puede bloquear a los usuarios que no son miembros desde la configuración de la organización o desde un comentario específico que realice un usuario. Al bloquear a un usuario en un comentario, puedes elegir si deseas enviar una notificación al usuario explicando que fue bloqueado y por qué. De lo contrario, el usuario no será notificado directamente que ha sido bloqueado. Los usuarios bloqueados aún podrán borrar el contenido existente. {% data reusables.organizations.blocking-a-user %} {% tip %} -**Tip:** If you're blocking a user because of a heated conversation, consider locking the conversation so only collaborators can comment. For more information, see "[Locking conversations](/communities/moderating-comments-and-conversations/locking-conversations)." +**Sugerencia**: Si bloquea a un usuario debido a una conversación acalorada, considere bloquear dicha conversación para que solo puedan comentar los colaboradores. Para obtener más información, consulte "[Bloqueo de conversaciones](/communities/moderating-comments-and-conversations/locking-conversations)". {% endtip %} -At the time that you block a user from your organization: -- The user stops watching your organization's repositories -- The user's stars and issue assignments are removed from your repositories -- The user's votes on discussions or comments in your organization's repositories are deleted -- The user is removed as a collaborator on your organization's repositories -- The user's contributions to your organization's repositories are no longer counted as contributions for them -- Any pending repository or organization invitations to the blocked user are cancelled +Al momento en que bloqueas a un usuario de tu organización: +- El usuario deja de ver los repositorios de la organización +- Las asignaciones con estrella y las propuestas del usuario se eliminarán de tus repositorios +- Se borrarán los votos del usuario sobre los comentarios y debates en los repositorios de tu organización +- El usuario será eliminado como colaborador en los repositorios de tu organización +- Las contribuciones del usuario ya no contarán como tales para ellos en los repositorios de tu organización +- Cualquier repositorio o invitación de la organización pendientes para el usuario bloqueado se cancelará -After you've blocked a user from your organization, they cannot: -- Cross-reference your organization's repositories in comments -- Fork, watch, pin, or star your organization's repositories +Una vez que has bloqueado a un usuario de tu organización, no podrá: +- Realizar referencias cruzadas con repositorios de la organización en comentarios +- Bifurca, observa, fija, o marca con una estrella los repositorios de tu organización -In your organization's repositories, blocked users also cannot: -- Open issues -- Send, close, or merge pull requests -- Comment on issues, pull requests, or commits -- Add or edit wiki pages +En los repositorios de tu organización, los usuarios bloqueados tampoco podrán: +- Abrir propuestas +- Envía, cierra, o fusiona las solicitudes de extracción +- Comentar propuestas, solicitudes de extracción o confirmaciones +- Agregar o editar páginas wiki -## Blocking a user in a comment +## Bloquear a un usuario en un comentario -1. Navigate to the comment whose author you would like to block. -2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Block user**. -![The horizontal kebab icon and comment moderation menu showing the block user option](/assets/images/help/repository/comment-menu-block-user.png) -3. If you'd like to set a time limit for the block, use the Block user drop-down menu, and select the amount of time you'd like to block the user. -![Block time limit in the block user drop-down menu](/assets/images/help/organizations/org-block-options-menu-from-comment.png) -4. If you'd like to hide all of the comments the user has made in the organization, select **Hide this user's comments** and choose a reason. -![Send a notification in the block user drop-down menu](/assets/images/help/organizations/org-block-options-menu-hide-user-comments.png) -5. If you'd like to notify the user why they're being blocked, select **Send a notification to this user**. -![Send a notification in the block user drop-down menu](/assets/images/help/organizations/org-block-options-menu-send-notification.png) -6. To block the user, click **Block user from organization** or **Block user from organization and send message**. -![Block user button](/assets/images/help/organizations/org-block-user-button-in-comment.png) +1. Desplázate hasta el comentario cuyo autor deseas bloquear. +2. En la esquina superior derecha del comentario, haga clic en {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} y luego en **Block user**. (Bloquear usuario). +![El icono de kebab horizontal y el menú de moderación de comentario que muestra la opción de bloqueo del usuario](/assets/images/help/repository/comment-menu-block-user.png) +3. Si deseas establecer un límite de tiempo para el bloqueo, usa el menú desplegable Block user (Bloquear usuario), y selecciona el período que deseas bloquear al usuario. +![Bloquear límite de tiempo en el menú desplegable para bloquear al usuario](/assets/images/help/organizations/org-block-options-menu-from-comment.png) +4. Si quiere ocultar todos los comentarios que realizó el usuario en la organización, seleccione **Hide this user's comments** (Ocultar los comentarios de este usuario) y elija un motivo. +![Enviar una notificación en el menú desplegable para bloquear al usuario](/assets/images/help/organizations/org-block-options-menu-hide-user-comments.png) +5. Si quiere notificar al usuario el motivo por el que se le ha bloqueado, seleccione **Send a notification to this user** (Enviar una notificación a este usuario). +![Enviar una notificación en el menú desplegable para bloquear al usuario](/assets/images/help/organizations/org-block-options-menu-send-notification.png) +6. Para bloquear al usuario, haga clic en **Block user from organization** (Bloquear usuario de la organización) o **Block user from organization and send message** (Bloquear usuario de la organización y enviar un mensaje). +![Botón Block user (Bloquear usuario)](/assets/images/help/organizations/org-block-user-button-in-comment.png) -## Blocking a user in the organization settings +## Bloquear a un usuario en los parámetros de la organización -1. To block an organization member, first [remove the user](/articles/removing-a-member-from-your-organization) from the organization. +1. Para bloquear a un miembro de la organización, en primer lugar [quite el usuario](/articles/removing-a-member-from-your-organization) de la organización. -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.organizations.block_users %} -6. Under "Block a user", type the username of the user you'd like to block. -![Username field](/assets/images/help/organizations/org-block-username-field.png) -7. If you'd like to set a time limit for the block, use the Block options drop-down menu, and select the amount of time you'd like to block the user. -![Block options drop-down menu](/assets/images/help/organizations/org-block-options-menu.png) -8. Click **Block user**. -![Block button](/assets/images/help/organizations/org-block-user-button.png) +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.block_users %} +6. En "Block a user" (Bloquear a un usuario), escribe el nombre de usuario del usuario que deseas bloquear. +![Campo Username (Nombre de usuario)](/assets/images/help/organizations/org-block-username-field.png) +7. Si deseas establecer un límite de tiempo para el bloqueo, usa el menú desplegable Block options (Bloquear opciones), y selecciona el período que deseas bloquear al usuario. +![Menú desplegable con las opciones de bloqueo](/assets/images/help/organizations/org-block-options-menu.png) +8. Haga clic en **Block user** (Bloquear usuario). +![Botón Block (Bloquear)](/assets/images/help/organizations/org-block-user-button.png) -## Further reading +## Información adicional -- "[Viewing users who are blocked from your organization](/communities/maintaining-your-safety-on-github/viewing-users-who-are-blocked-from-your-organization)" -- "[Unblocking a user from your organization](/communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-organization)" -- "[Blocking a user from your personal account](/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account)" -- "[Unblocking a user from your personal account](/communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-personal-account)" -- "[Reporting abuse or spam](/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam)" +- "[Ver usuarios bloqueados de su organización](/communities/maintaining-your-safety-on-github/viewing-users-who-are-blocked-from-your-organization)" +- "[Bloquear a un usuario de su organización](/communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-organization)" +- "[Bloquear a un usuario desde su cuenta personal](/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account)" +- "[Desbloquear a un usuario desde su cuenta personal](/communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-personal-account)" +- "[Notificar un abuso o correo no deseado](/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam)" diff --git a/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md b/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md index d7164d372a..66534676dd 100644 --- a/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md +++ b/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md @@ -1,6 +1,6 @@ --- -title: About GitHub Global Campus for students -intro: '{% data variables.product.prodname_education %} offers students real-world experience with free access to various developer tools from {% data variables.product.prodname_dotcom %}''s partners.' +title: Acerca del campus global de GitHub para alumnos +intro: '{% data variables.product.prodname_education %} le ofrece a los estudiantes experiencia práctica con acceso gratuito a diversas herramientas de programadores de los socios de {% data variables.product.prodname_dotcom %}.' redirect_from: - /education/teach-and-learn-with-github-education/about-github-education-for-students - /github/teaching-and-learning-with-github-education/about-github-education-for-students @@ -10,40 +10,46 @@ redirect_from: versions: fpt: '*' shortTitle: For students +ms.openlocfilehash: 198f0354e63721a4763e8fa32f832a19b2dac9d9 +ms.sourcegitcommit: 3abdbdbb47a9319f20e11845e9c2d8a7fce63422 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/15/2022 +ms.locfileid: '148165101' --- -Using {% data variables.product.prodname_dotcom %} for your school projects is a practical way to collaborate with others and build a portfolio that showcases real-world experience. +Usar {% data variables.product.prodname_dotcom %} para tus proyectos escolares es un modo práctico de colaborar con otros y crear un portfolio que exhiba experiencia práctica. -Everyone with a {% data variables.product.prodname_dotcom %} account can collaborate in unlimited public and private repositories with {% data variables.product.prodname_free_user %}. As a student, you can also apply for {% data variables.product.prodname_education %} student benefits. Your {% data variables.product.prodname_education %} student benefits and resources are all included in {% data variables.product.prodname_global_campus %}, a portal that allows you to access your education benefits, all in one place. For more information, see "[Apply to GitHub Global Campus as a student](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/apply-to-github-global-campus-as-a-student)" and [{% data variables.product.prodname_education %}](https://education.github.com/). +Cualquiera con una cuenta de {% data variables.product.prodname_dotcom %} puede colaborar en repositorios públicos y privados ilimitados con {% data variables.product.prodname_free_user %}. Como alumno, también puedes solicitar los beneficios de {% data variables.product.prodname_education %} para los alumnos. Los beneficios y recursos para los alumnos de {% data variables.product.prodname_education %} se incluyen en el {% data variables.product.prodname_global_campus %}, un portal que te permite acceder a sus beneficios educativos, todo en un solo lugar. Para obtener más información, consulta «[Solicitar acceso al campus global de GitHub como alumno](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/apply-to-github-global-campus-as-a-student)» y [{% data variables.product.prodname_education %}](https://education.github.com/). -Before applying for Global Campus, check if your learning community is already partnered with us as a {% data variables.product.prodname_campus_program %} school. For more information, see "[About {% data variables.product.prodname_campus_program %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)." +Antes de solicitar un descuento individual, comprueba si la comunidad de aprendizaje ya está asociada con nosotros como una escuela del {% data variables.product.prodname_campus_program %}. Para más información, vea "[Acerca de {% data variables.product.prodname_campus_program %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)". -If you're a member of a school club, a teacher can apply for {% data variables.product.prodname_global_campus %} so your team can collaborate using {% data variables.product.prodname_team %}, which allows unlimited users and private repositories, for free. For more information, see "[Apply to {% data variables.product.prodname_global_campus %} as a teacher](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)." +Si eres miembro de un club de la escuela, un profesor puede solicitar acceso al {% data variables.product.prodname_global_campus %} para que tu equipo pueda colaborar con {% data variables.product.prodname_team %}, lo que permite repositorios privados y usuarios ilimitados de forma gratuita. Para obtener más información, consulta «[Solicitar acceso al {% data variables.product.prodname_global_campus %} como profesor](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)». -Once you are a verified {% data variables.product.prodname_global_campus %} student, you can access {% data variables.product.prodname_global_campus %} anytime by going to the [{% data variables.product.prodname_education %} website](https://education.github.com). +Una vez que se seas un alumno verificado del {% data variables.product.prodname_global_campus %}, puedes acceder al {% data variables.product.prodname_global_campus %} en cualquier momento yendo al [sitio web de {% data variables.product.prodname_education %}](https://education.github.com). -![{% data variables.product.prodname_global_campus %} portal for students](/assets/images/help/education/global-campus-portal-students.png) +![Portal del {% data variables.product.prodname_global_campus %} para los alumnos](/assets/images/help/education/global-campus-portal-students.png) -## {% data variables.product.prodname_global_campus %} features for students +## Características del {% data variables.product.prodname_global_campus %} para los alumnos -{% data variables.product.prodname_global_campus %} is a portal from which you can access your {% data variables.product.prodname_education %} benefits and resources, all in one place. On the {% data variables.product.prodname_global_campus %} portal, students can: -- Connect with a local Campus Expert. For more information on campus experts, see "[About Campus Experts](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-campus-experts)." -- Explore and claim offers for free industry tools from the [Student Developer Pack](https://education.github.com/pack). -- See upcoming in-person and virtual events for students, curated by {% data variables.product.prodname_education %} and student leaders. -- View assignments from [GitHub Classroom](https://classroom.github.com/) with upcoming due dates. -- Stay in the know on what the community is interested in by rewatching recent [Campus TV](https://www.twitch.tv/githubeducation) episodes. Campus TV is created by {% data variables.product.prodname_dotcom %} and student community leaders and can be watched live or on demand. -- Discover student-created repositories from GitHub Community Exchange. For more information, see "[About GitHub Community Exchange](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)." +{% data variables.product.prodname_global_campus %} es un portal desde el que puedes acceder a tus ventajas y a los recursos de {% data variables.product.prodname_education %}, todo en un solo lugar. En el portal del {% data variables.product.prodname_global_campus %}, los alumnos pueden: +- Conectarse con un experto local del campus. Para obtener más información sobre los expertos del campus, consulta «[Acerca de los expertos del campus](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-campus-experts)». +- Explorar y reclamar ofertas para herramientas del sector gratuitas en el [Paquete para desarrolladores para los alumnos](https://education.github.com/pack). +- Consultar los próximos eventos en persona y virtuales para los alumnos, mantenidos por {% data variables.product.prodname_education %} y por los líderes del alumnado. +- Consultar las asignaciones del [Aula de GitHub](https://classroom.github.com/) con las próximas fechas de vencimiento. +- Mantenerte al corriente de lo que interesa a la comunidad con los episodios recientes de [Campus TV](https://www.twitch.tv/githubeducation). Campus TV está creado por {% data variables.product.prodname_dotcom %} y por los líderes de la comunidad de alumnos y se puede ver en vivo o a petición. +- Descubrir los repositorios creados por alumnos desde GitHub Community Exchange. Para obtener más información, consulta «[Acerca de GitHub Community Exchange](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)». -{% data variables.product.prodname_global_campus %} students also receive the following {% data variables.product.prodname_dotcom %} benefits. -- **{% data variables.product.prodname_copilot %}**: Verified students receive a free subscription for {% data variables.product.prodname_copilot %}. You will be automatically notified about the free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page in your account settings. For more information about subscribing to and using {% data variables.product.prodname_copilot %}, see "[Managing your {% data variables.product.prodname_copilot %} subscription](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)" and "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." -- **{% data variables.product.prodname_github_codespaces %}**: {% data reusables.education.student-codespaces-benefit %} For more information on getting started with {% data variables.product.prodname_github_codespaces %}, see "[{% data variables.product.prodname_github_codespaces %} overview](/codespaces/overview)." +Los alumnos de {% data variables.product.prodname_global_campus %} también reciben las siguientes ventajas de {% data variables.product.prodname_dotcom %}. +- **{% data variables.product.prodname_copilot %}** : Los alumnos verificados reciben una suscripción gratuita de {% data variables.product.prodname_copilot %}. Recibirás una notificación automática sobre la suscripción gratuita cuando visites la página de suscripción de {% data variables.product.prodname_copilot %} en la configuración de la cuenta. Para obtener más información sobre la suscripción a {% data variables.product.prodname_copilot %} y su uso, consulta "[Administración de la suscripción de {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)" y "[Acerca de {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)". +- **{% data variables.product.prodname_github_codespaces %}** : {% data reusables.education.student-codespaces-benefit %} Para obtener más información sobre cómo empezar a trabajar con {% data variables.product.prodname_github_codespaces %}, consulta "[Introducción a {% data variables.product.prodname_github_codespaces %}](/codespaces/overview)". {% note %} -**Note:** {% data reusables.education.note-on-student-codespaces-usage %} For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom)." +**Nota:** {% data reusables.education.note-on-student-codespaces-usage %} Para obtener más información, consulta "[Uso de {% data variables.product.prodname_github_codespaces %} con {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom)". {% endnote %} -## Further reading +## Información adicional -- "[About {% data variables.product.prodname_global_campus %} for teachers](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers)" -- "[About {% data variables.product.prodname_community_exchange %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)" +- «[Acerca del {% data variables.product.prodname_global_campus %} para profesores](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers)» +- "[Acerca de {% data variables.product.prodname_community_exchange %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)" diff --git a/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md b/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md index dc7a203cd0..b16c6517d2 100644 --- a/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md +++ b/translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md @@ -1,6 +1,6 @@ --- -title: About GitHub Global Campus for teachers -intro: '{% data variables.product.prodname_global_campus %} offers teachers a central place to access tools and resources for working more effectively inside and outside of the classroom.' +title: Acerca del campus global de GitHub para alumnos +intro: '{% data variables.product.prodname_global_campus %} ofrece a los profesores un lugar central para acceder a herramientas y recursos para trabajar de forma más eficaz dentro y fuera del aula.' redirect_from: - /education/teach-and-learn-with-github-education/about-github-education-for-educators-and-researchers - /github/teaching-and-learning-with-github-education/about-github-education-for-educators-and-researchers @@ -10,28 +10,32 @@ redirect_from: versions: fpt: '*' shortTitle: For teachers +ms.openlocfilehash: 2a93f87df67d1694bd93888d29a582afa9c749e4 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158969' --- +Como alumno o miembro del profesorado en una institución educativa acreditada, puedes solicitar acceso al {% data variables.product.prodname_global_campus %}, que incluye acceso a las ventajas y los recursos de {% data variables.product.prodname_education %}. Para obtener más información, consulta «[Solicitar acceso al {% data variables.product.prodname_global_campus %} como profesor](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)». -As a faculty member at an accredited educational institution, you can apply for {% data variables.product.prodname_global_campus %}, which includes {% data variables.product.prodname_education %} benefits and resources. For more information, see "[Apply to {% data variables.product.prodname_global_campus %} as a teacher](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)." +{% data variables.product.prodname_global_campus %} es un portal que permite a la comunidad educativa de GitHub acceder a las ventajas de educación, y todo en un solo lugar. Una vez que se seas un profesor verificado del {% data variables.product.prodname_global_campus %}, puedes acceder al {% data variables.product.prodname_global_campus %} en cualquier momento yendo al [sitio web de {% data variables.product.prodname_education %}](https://education.github.com). -{% data variables.product.prodname_global_campus %} is a portal that allows the GitHub Education Community to access their education benefits, all in one place. Once you are a verified {% data variables.product.prodname_global_campus %} teacher, you can access {% data variables.product.prodname_global_campus %} anytime by going to the [{% data variables.product.prodname_education %} website](https://education.github.com). +![Portal del {% data variables.product.prodname_global_campus %} para los profesores](/assets/images/help/education/global-campus-portal-teachers.png) -![{% data variables.product.prodname_global_campus %} portal for teachers](/assets/images/help/education/global-campus-portal-teachers.png) +Antes de solicitar un descuento individual, compruebe si la comunidad de aprendizaje ya está asociada con nosotros como escuela de {% data variables.product.prodname_campus_program %}. Para más información, vea "[Acerca de {% data variables.product.prodname_campus_program %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)". -Before applying for an individual discount, check if your learning community is already partnered with us as a {% data variables.product.prodname_campus_program %} school. For more information, see "[About {% data variables.product.prodname_campus_program %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)." +## Características del {% data variables.product.prodname_global_campus %} para los profesores -## {% data variables.product.prodname_global_campus %} features for teachers +{% data variables.product.prodname_global_campus %} es un portal desde el que puedes acceder a tus ventajas y a los recursos de {% data variables.product.prodname_education %}, todo en un solo lugar. En el portal del {% data variables.product.prodname_global_campus %}, los profesores de todos los niveles pueden: {% data reusables.education.apply-for-team %} + - Ver información general sobre tus [{% data variables.product.prodname_classroom %}](https://classroom.github.com), incluidas las asignaciones recientes y el progreso de la clase de un vistazo, así como vínculos a {% data variables.product.prodname_classroom %}. + - Consultar e interactuar con las [{% data variables.product.prodname_discussions %}](https://github.com/orgs/community/discussions/categories/github-education) publicadas por sus compañeros de todo el mundo para analizar las tendencias actuales en la educación tecnológica, y encuentra las entradas más recientes de nuestro [blog {% data variables.product.prodname_education %}](https://github.blog/category/education/). + - Consultar los eventos de los alumnos mantenidos por {% data variables.product.prodname_education %} y los líderes de los alumnos. + - Mantenerte al corriente de lo que interesa a la comunidad de alumnos con los episodios recientes de [Campus TV](https://www.twitch.tv/githubeducation). Campus TV está creado por {% data variables.product.prodname_dotcom %} y por los líderes de la comunidad de alumnos y se puede ver en vivo o a petición. + - Solicite una bolsa de productos de {% data variables.product.prodname_dotcom %} con materiales educativos y productos para los alumnos. -{% data variables.product.prodname_global_campus %} is a portal from which you can access your {% data variables.product.prodname_education %} benefits and resources, all in one place. On the {% data variables.product.prodname_global_campus %} portal, teachers of all levels can: - {% data reusables.education.apply-for-team %} - - View an overview of your active [{% data variables.product.prodname_classroom %}](https://classroom.github.com), including recent assignments and your class's progress at a glance, as well as links to {% data variables.product.prodname_classroom %}. - - View and interact with [{% data variables.product.prodname_discussions %}](https://github.com/orgs/community/discussions/categories/github-education) posted by your peers from around the world to discuss current trends in technology education, and see the latest posts from our [{% data variables.product.prodname_education %} blog](https://github.blog/category/education/). - - See student events curated by {% data variables.product.prodname_education %} and student leaders. - - Stay in the know on what the student community is interested in by rewatching recent [Campus TV](https://www.twitch.tv/githubeducation) episodes. Campus TV is created by {% data variables.product.prodname_dotcom %} and student community leaders and can be watched live or on demand. - - Request a {% data variables.product.prodname_dotcom %} swag bag with educational materials and goodies for your students. +Hay disponible una suscripción gratuita de {% data variables.product.prodname_copilot %} para profesores verificados con {% data variables.product.prodname_education %}. Recibirás una notificación automática sobre la suscripción gratuita cuando visites la página de suscripción de {% data variables.product.prodname_copilot %} en la configuración de la cuenta. Para obtener más información sobre la suscripción a {% data variables.product.prodname_copilot %} y su uso, consulta "[Administración de la suscripción de {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)" y "[Acerca de {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)". -A free subscription for {% data variables.product.prodname_copilot %} is available to verified teachers with {% data variables.product.prodname_education %}. You will be automatically notified about the free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page in your account settings. For more information about subscribing to and using {% data variables.product.prodname_copilot %}, see "[Managing your {% data variables.product.prodname_copilot %} subscription](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)" and "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." +## Información adicional -## Further reading - -- "[About {% data variables.product.prodname_global_campus %} for students](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students)" +- «[Acerca del {% data variables.product.prodname_global_campus %} para los alumnos](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students)» diff --git a/translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md b/translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md index 34a57ee0e7..d310dcee70 100644 --- a/translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md +++ b/translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md @@ -1,27 +1,33 @@ --- -title: Using GitHub Codespaces with GitHub Classroom +title: Uso de GitHub Codespaces con GitHub Classroom shortTitle: Using Codespaces with GitHub Classroom product: '{% data reusables.gated-features.codespaces-classroom-articles %}' -intro: 'You can use {% data variables.product.prodname_github_codespaces %} as the preferred editor in your assignments to give students access to a browser-based Visual Studio Code environment with one-click setup.' +intro: "Puedes usar {% data variables.product.prodname_github_codespaces %} como editor preferido en tus asignaciones para dar a los alumnos acceso a un entorno de Visual\_Studio Code basado en explorador con una configuración con un solo clic." versions: fpt: '*' permissions: 'Organization owners who are admins for a classroom can enable {% data variables.product.prodname_github_codespaces %} for their organization and integrate {% data variables.product.prodname_github_codespaces %} as the supported editor for an assignment. {% data reusables.classroom.classroom-admins-link %}' +ms.openlocfilehash: 6794d20b9ea0153b3baf4bee1a08c68b2ba17456 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158881' --- -## About {% data variables.product.prodname_github_codespaces %} +## Acerca de {% data variables.product.prodname_github_codespaces %} -{% data variables.product.prodname_github_codespaces %} is an instant, cloud-based development environment that uses a container to provide you with common languages, tools, and utilities for development. {% data variables.product.prodname_github_codespaces %} is also configurable, allowing you to create a customized development environment that is the same for all users of your project. For more information, see "[{% data variables.product.prodname_github_codespaces %} overview](/codespaces/overview)." +{% data variables.product.prodname_github_codespaces %} es un entorno de desarrollo instantáneo basado en la nube que usa un contenedor para proporcionar lenguajes comunes, herramientas y utilidades para el desarrollo. {% data variables.product.prodname_github_codespaces %} también es configurable, lo cual te permite crear un entorno de desarrollo personalizado que sea igual para todos los usuarios del proyecto. Para obtener más información, consulta "[Introducción a {% data variables.product.prodname_github_codespaces %}](/codespaces/overview)". -Once {% data variables.product.prodname_github_codespaces %} is enabled in an organization or enterprise, users can create a codespace from any branch or commit in an organization or enterprise repository and begin developing using cloud-based compute resources. You can connect to a codespace from the browser or locally using Visual Studio Code. +Una vez que {% data variables.product.prodname_github_codespaces %} esté habilitado en una organización o empresa, los usuarios podrán crear un codespace desde cualquier rama o confirmación de un repositorio de la organización o empresa y empezar a desarrollar mediante el uso de recursos de proceso basados en la nube. Puedes conectarte a un codespace desde el explorador o localmente mediante Visual Studio Code. {% data reusables.codespaces.links-to-get-started %} -Setting {% data variables.product.prodname_github_codespaces %} as the preferred editor for an assignment in GitHub Classroom assignments, is beneficial for both students and teachers. {% data variables.product.prodname_github_codespaces %} is a good option for students using loaned devices or without access to a local IDE setup, since each codespace is cloud-based and requires no local setup. Students can launch a codespace for an assignment repository in Visual Studio Code directly in their browser, and begin developing right away without needing any further configuration. +El establecimiento de {% data variables.product.prodname_github_codespaces %} como editor preferido para una asignación de GitHub Classroom resulta beneficioso tanto para los alumnos como para los profesores. {% data variables.product.prodname_github_codespaces %} es una buena opción para los alumnos que usan dispositivos prestados o sin acceso a una configuración del IDE local, ya que cada codespace está basado en la nube y no requiere ninguna configuración local. Los alumnos pueden iniciar un codespace para un repositorio de tareas en Visual Studio Code directamente en el explorador y empezar a desarrollar inmediatamente sin necesidad de ninguna configuración adicional. -For assignments with complex setup environments, teachers can customize the dev container configuration for a repository's codespaces. This ensures that when a student creates a codespace, it automatically opens with the development environment configured by the teacher. For more information on dev containers, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." +En el caso de las tareas con entornos de configuración complejos, los profesores pueden personalizar la configuración del contenedor de desarrollo para los codespaces de un repositorio. Esto garantiza que, cuando un alumno cree un codespace, se abra automáticamente con el entorno de desarrollo que haya configurado el profesor. Para obtener más información sobre los contenedores de desarrollo, vea "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". {% note %} -**Note**: Individual codespaces are automatically deleted if they are stopped and left unused for a prolonged period. For more information, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)." +**Nota**: Los codespaces individuales se eliminan automáticamente si se detienen y dejan sin usar durante un período prolongado. Para más información, consulta "[Configuración de la eliminación automática de los codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)". {% endnote %} @@ -29,74 +35,72 @@ For assignments with complex setup environments, teachers can customize the dev {% note %} -**Note:** {% data reusables.education.note-on-student-codespaces-usage %} +**Nota**: {% data reusables.education.note-on-student-codespaces-usage %} {% endnote %} -## About the {% data variables.product.prodname_codespaces %} Education benefit for verified teachers +## Acerca de la ventaja {% data variables.product.prodname_codespaces %} Education para profesores verificados -The {% data variables.product.prodname_codespaces %} Education benefit gives verified teachers a free monthly allowance of {% data variables.product.prodname_github_codespaces %} hours to use in {% data variables.product.prodname_classroom %}. The free allowance is estimated to be enough for a class of 50 with 5 assignments per month, on a 2 core machine with 1 codespace stored per student. +La ventaja {% data variables.product.prodname_codespaces %} Education proporciona a los profesores verificados una asignación mensual gratuita de {% data variables.product.prodname_github_codespaces %} horas para su uso en {% data variables.product.prodname_classroom %}. Se estima que la asignación gratuita es suficiente para una clase de 50 alumnos con cinco tareas al mes, en una máquina de dos núcleos con un codespace almacenado por alumno. {% data reusables.classroom.free-limited-codespaces-for-verified-teachers-beta-note %} -To become a verified teacher, you need to be approved for an educator or teacher benefit. For more information, see "[Apply to {% data variables.product.prodname_global_campus %} as a teacher](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)." +Si quieres convertirte en un profesor verificado, debes contar con aprobación para obtener una ventaja para educadores o profesores. Para obtener más información, consulta «[Solicitar acceso al {% data variables.product.prodname_global_campus %} como profesor](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)». -After you have confirmation that you are a verified teacher, visit [{% data variables.product.prodname_global_campus %} for Teachers](https://education.github.com/globalcampus/teacher) to upgrade the organization to GitHub Team. For more information, see [GitHub's products](/get-started/learning-about-github/githubs-products#github-team). +Una vez que hayas confirmado que eres un profesor verificado, visita [{% data variables.product.prodname_global_campus %} para profesores](https://education.github.com/globalcampus/teacher) con el fin de actualizar la organización a GitHub Team. Para obtener más información, consulta "[Productos de GitHub](/get-started/learning-about-github/githubs-products#github-team)". -If you are eligible for the {% data variables.product.prodname_codespaces %} Education benefit, when you enable {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_classroom %} for your organization, GitHub automatically adds a Codespace policy to restrict machine types for all codespaces in the organization to 2 core machines. This helps you make the most of the free {% data variables.product.prodname_github_codespaces %} usage. However, you can change or remove these policies in your organization settings. For more information, see "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)." +Si cumples los requisitos para obtener la ventaja {% data variables.product.prodname_codespaces %} Education al habilitar {% data variables.product.prodname_github_codespaces %} en {% data variables.product.prodname_classroom %} para la organización, GitHub agrega automáticamente una directiva de codespace para restringir los tipos de máquina de todos los codespaces de la organización a dos máquinas principales. Esto ayuda a aprovechar al máximo el uso gratuito de{% data variables.product.prodname_github_codespaces %}. De todos modos, puedes cambiar o quitar estas directivas en la configuración de la organización. Para obtener más información, consulte "[Restringir el acceso a los tipos de máquina](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)". -When the {% data variables.product.prodname_codespaces %} Education benefit moves out of beta, if your organization exceeds their free allowance for {% data variables.product.prodname_github_codespaces %} usage, your organization will be billed for additional usage. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." +Cuando la ventaja {% data variables.product.prodname_codespaces %} Education deje de estar en versión beta, si tu organización supera su asignación gratuita para el uso de {% data variables.product.prodname_github_codespaces %}, se te facturará por el uso adicional. Para más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". -## Enabling {% data variables.product.prodname_codespaces %} for your organization +## Habilitar los {% data variables.product.prodname_codespaces %} para tu organización -{% data variables.product.prodname_github_codespaces %} is available to use with {% data variables.product.prodname_classroom %} for organizations that use {% data variables.product.prodname_team %}. If you are eligible for the {% data variables.product.prodname_codespaces %} Education benefit, you must enable {% data variables.product.prodname_github_codespaces %} through {% data variables.product.prodname_classroom %}, instead of enabling it directly in your organization settings. Otherwise, your organization will be billed directly for all usage of {% data variables.product.prodname_github_codespaces %}. +{% data variables.product.prodname_github_codespaces %} está disponible para su uso con {% data variables.product.prodname_classroom %} para las organizaciones que usan {% data variables.product.prodname_team %}. Si cumples los requisitos para obtener la ventaja {% data variables.product.prodname_codespaces %} Education, debes habilitar {% data variables.product.prodname_github_codespaces %} mediante {% data variables.product.prodname_classroom %}, en lugar de hacerlo directamente en la configuración de la organización. De lo contrario, se facturará a la organización directamente por todo el uso de {% data variables.product.prodname_github_codespaces %}. -### Enabling Codespaces for an organization when creating a new classroom +### Habilitación de Codespaces para una organización al crear un aula {% data reusables.classroom.sign-into-github-classroom %} -1. Click **New classroom**. +1. Haga clic en **New classroom**. - !["New classroom" button](/assets/images/help/classroom/click-new-classroom-button.png) + ![Botón "Aula nueva"](/assets/images/help/classroom/click-new-classroom-button.png) -1. In the list of organizations, click the organization you'd like to use for your classroom. Organizations that are eligible for {% data variables.product.prodname_github_codespaces %} will have a note showing that they are eligible. Optionally, you can create a new organization. For more information, see "[Creating a new organization from scratch](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)." +1. En la lista de organizaciones, da clic en aquella que te gustaría utilizar para tu aula. Las organizaciones que cumplan los requisitos de {% data variables.product.prodname_github_codespaces %} incluirán una nota en la que se indique. Opcionalmente, puedes crear una organizción nueva. Para más información, vea consulte "[Creación de una organización desde cero](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)". - ![Choose organization for classroom with codespaces eligibility](/assets/images/help/classroom/org-view-codespaces-eligibility.png) + ![Selección de una organización para el aula que cumple los requisitos de Codespaces](/assets/images/help/classroom/org-view-codespaces-eligibility.png) -1. In the "Name your classroom" page, under "{% data variables.product.prodname_codespaces %} in your Classroom", click **Enable**. Note that this will enable {% data variables.product.prodname_github_codespaces %} for all repositories and users in the organization. +1. En la página "Asigna un nombre al aula", en "{% data variables.product.prodname_codespaces %} en el aula", haz clic en **Habilitar**. Ten en cuenta que esto habilitará {% data variables.product.prodname_github_codespaces %} para todos los repositorios y usuarios de la organización. - ![Enable Codespaces for org in "Setup classroom basics" page](/assets/images/help/classroom/setup-classroom-enable-codespaces-button.png) + ![Habilitación de Codespaces para la organización en la página "Configuración de los aspectos básicos del aula"](/assets/images/help/classroom/setup-classroom-enable-codespaces-button.png) -1. When you are ready to create the new classroom, click **Create classroom**. +1. Cuando esté todo listo para la creación del aula, haz clic en **Crear aula**. -### Enabling Codespaces for an organization via an existing classroom +### Habilitación de Codespaces para una organización mediante un aula existente -{% data reusables.classroom.sign-into-github-classroom %} -{% data reusables.classroom.click-classroom-in-list %} -{% data reusables.classroom.click-settings %} -1. Under "{% data variables.product.prodname_github_codespaces %}", click **Enable**. This will enable {% data variables.product.prodname_github_codespaces %} for all repositories and users in the organization. A new Codespace policy is also added to restrict machine types for all codespaces in the organization to 2 core machines. +{% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-settings %} +1. En "{% data variables.product.prodname_github_codespaces %}", haz clic en **Habilitar**. Esto habilitará {% data variables.product.prodname_github_codespaces %} para todos los repositorios y usuarios de la organización. También se agrega una nueva directiva de Codespaces para restringir los tipos de máquina de todos los codespaces de la organización a dos máquinas principales. - ![Enable Codespaces for org in existing classroom settings](/assets/images/help/classroom/classroom-settings-enable-codespaces-button.png) + ![Habilitación de Codespaces para la organización en la configuración del aula existente](/assets/images/help/classroom/classroom-settings-enable-codespaces-button.png) -You can use the same methods as above to disable {% data variables.product.prodname_github_codespaces %} for your organization as well. Note that this will disable {% data variables.product.prodname_github_codespaces %} for all users and repositories in the organization. +También puedes usar los mismos métodos que antes para deshabilitar {% data variables.product.prodname_github_codespaces %} para la organización. Ten en cuenta que esto deshabilitará {% data variables.product.prodname_github_codespaces %} para todos los usuarios y repositorios de la organización. -## Configuring an assignment to use {% data variables.product.prodname_codespaces %} -To make {% data variables.product.prodname_github_codespaces %} available to students for an assignment, you can choose {% data variables.product.prodname_github_codespaces %} as the supported editor for the assignment. When creating a new assignment, in the "Add your starter code and choose your optional online IDE" page, under "Add a supported editor", select **{% data variables.product.prodname_github_codespaces %}** from the dropdown menu. +## Configuración de una tarea para usar {% data variables.product.prodname_codespaces %} +Si quieres que los alumnos tengan {% data variables.product.prodname_github_codespaces %} disponible para una asignación, puedes seleccionar {% data variables.product.prodname_github_codespaces %} como editor compatible para la asignación. Al crear una tarea, en la página "Agregar el código de inicio y elegir el IDE en línea opcional", en "Agregar un editor compatible", selecciona **{% data variables.product.prodname_github_codespaces %}** en el menú desplegable. -![Select Codespaces as supported editor for assignment](/assets/images/help/classroom/select-supported-editor-including-codespaces.png) +![Selección de Codespaces como editor compatible para la tarea](/assets/images/help/classroom/select-supported-editor-including-codespaces.png) -If you use a template repository for an assignment, you can define a dev container in the repository to customize the tools and runtimes available to students when they launch a codespace to work on the assignment. If you do not define a dev container, {% data variables.product.prodname_github_codespaces %} will use a default configuration, which contains many of the common tools that your students might need for development. For more information on defining a dev container, see "[Add a dev container configuration to your repository](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)." +Si usas un repositorio de plantillas para una tarea, puedes definir un contenedor de desarrollo en el repositorio para personalizar las herramientas y los entornos de ejecución disponibles para los alumnos cuando inician un codespace para trabajar en la tarea. Si no defines un contenedor de desarrollo, {% data variables.product.prodname_github_codespaces %} usará una configuración predeterminada, que contiene muchas de las herramientas comunes que los alumnos podrían necesitar para el desarrollo. Para obtener más información sobre cómo definir un contenedor de desarrollo, consulta "[Incorporación de una configuración de contenedor de desarrollo en el repositorio](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)". -## Launching an assignment using {% data variables.product.prodname_github_codespaces %} +## Inicio de una asignación mediante {% data variables.product.prodname_github_codespaces %} -When a student opens an assignment, the repository's README file includes their teacher's recommendation of the IDE they should use for the work. +Cuando un alumno abre una tarea, el archivo LÉAME del repositorio indica qué IDE recomienda el profesor para el trabajo. -![Screenshot of the Codespaces note in the README for a student assignment repository](/assets/images/help/classroom/student-codespaces-readme-link.png) +![Captura de pantalla de la nota de Codespaces en el archivo LÉAME sobre el repositorio de la tarea de los alumnos](/assets/images/help/classroom/student-codespaces-readme-link.png) -Students can launch a new or existing codespace by clicking the **Open in GitHub Codespace** button in the README, or by clicking the **{% octicon "code" aria-label="The code icon" %} Code** button on the main page of the assignment repository, then selecting the **Codespaces** tab. From the **Codespaces** tab you can select an existing codespace or create a new one. 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)." +Los alumnos pueden iniciar un codespace nuevo o existente haciendo clic en el botón **Abrir en GitHub Codespace** en el archivo LÉAME, o haciendo clic en el botón **{% octicon "code" aria-label="The code icon" %} Código** en la página principal del repositorio de asignaciones, luego seleccione la pestaña **Codespaces**. En la pestaña **Codespaces** puede seleccionar un codespace existente o crear uno nuevo. Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)". -![Launch new codespace in assignment repository](/assets/images/help/classroom/student-launch-new-codespace.png) +![Inicio de un nuevo codespace en el repositorio de tareas](/assets/images/help/classroom/student-launch-new-codespace.png) -Teachers can view each student's codespace for an assignment in the assignment overview page. You can click on the Codespaces icon on the right side of each student row to launch the codespace. +Los profesores pueden ver el codespace de cada alumno para una tarea en la página de información general de la tarea. Puedes hacer clic en el icono Codespaces a la derecha de la fila de cada alumno para iniciar el codespace. -![Teacher assignment overview with student's codespaces](/assets/images/help/classroom/teacher-assignment-view-with-codespaces.png) +![Información general de tareas del profesor con los codespaces de los alumnos](/assets/images/help/classroom/teacher-assignment-view-with-codespaces.png) -When you connect to a codespace through a browser, auto-save is enabled automatically. If you want to save changes to the repository, you will need to commit the changes and push them to a remote branch. If you leave your codespace running without interaction for 30 minutes by default, the codespace will timeout and stop running. Your data will be preserved from the last time you made a change. For more information on the lifecycle of a codespace, see "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)." +Cuando te conectes a un codespace a través de un explorador, se habilitará automáticamente el guardado automático. Si quieres guardar los cambios en el repositorio, deberás confirmar los cambios e insertarlos en una rama remota. Si dejas que el codespace se ejecute sin interacción durante 30 minutos de forma predeterminada, el tiempo de espera se agotará y el codespace dejará de ejecutarse. Los datos se conservarán desde la última vez que hayas realizado un cambio. Para obtener más información sobre el ciclo de vida de un codespace, consulta "[Ciclo de vida de un codespace](/codespaces/developing-in-codespaces/the-codespace-lifecycle)". diff --git a/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md b/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md index 66cdb5d8b3..ffef0a4aba 100644 --- a/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md +++ b/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md @@ -74,6 +74,8 @@ If you've already created a group assignment for the classroom, you can reuse a ### Choosing a visibility for assignment repositories +{% data reusables.classroom.assignments-repository-visibility-and-permissions %} + {% data reusables.classroom.assignments-guide-choose-visibility %} {% data reusables.classroom.assignments-guide-click-continue-after-basics %} diff --git a/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment.md b/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment.md index a90c4428f4..8161608b81 100644 --- a/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment.md +++ b/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment.md @@ -1,6 +1,6 @@ --- -title: Crear una tarea individual -intro: Puedes crear una tarea individual para que los alumnos de tu curso la completen individualmente. +title: Create an individual assignment +intro: You can create an assignment for students in your course to complete individually. versions: fpt: '*' permissions: 'Organization owners who are admins for a classroom can create and manage individual assignments for a classroom. {% data reusables.classroom.classroom-admins-link %}' @@ -8,14 +8,8 @@ redirect_from: - /education/manage-coursework-with-github-classroom/creating-an-individual-assignment - /education/manage-coursework-with-github-classroom/create-an-individual-assignment shortTitle: Individual assignment -ms.openlocfilehash: 4f5fab2f63ff686762a4fb6ccd5964b7f4d9cb3c -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147573872' --- -## Acerca de las tareas individuales +## About individual assignments {% data reusables.classroom.assignments-individual-definition %} @@ -23,82 +17,84 @@ ms.locfileid: '147573872' {% data reusables.classroom.about-assignments %} -Para obtener una demostración en vídeo de la creación de una asignación individual, vea "[Conceptos básicos de la configuración de {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)". +For a video demonstration of the creation of an individual assignment, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)." {% data reusables.classroom.reuse-assignment-link %} -## Requisitos previos +## Prerequisites {% data reusables.classroom.assignments-classroom-prerequisite %} -## Crear una tarea +## Creating an assignment {% data reusables.classroom.assignments-guide-create-the-assignment %} -## Configurar lo básico para una tarea +## Setting up the basics for an assignment -Nombra tu tarea, decide si quieres asignar una fecha límite y elige la visibilidad de los repositorios de la misma. +Name your assignment, decide whether to assign a deadline, and choose the visibility of assignment repositories. -- [Denominación de una asignación](#naming-an-assignment) -- [Asignación de una fecha límite para una asignación](#assigning-a-deadline-for-an-assignment) -- [Elección de un tipo de asignación](#choosing-an-assignment-type) -- [Elección de un tipo de visibilidad para los repositorios de asignación](#choosing-a-visibility-for-assignment-repositories) +- [Naming an assignment](#naming-an-assignment) +- [Assigning a deadline for an assignment](#assigning-a-deadline-for-an-assignment) +- [Choosing an assignment type](#choosing-an-assignment-type) +- [Choosing a visibility for assignment repositories](#choosing-a-visibility-for-assignment-repositories) -### Nombrar una tarea +### Naming an assignment -Para una tarea individual, {% data variables.product.prodname_classroom %} nombra los repositorios de acuerdo con su prefijo y con el nombre de usuario de {% data variables.product.product_name %} del alumno. Predeterminadamente, el prefijo del repositorio es el título de la tarea. Por ejemplo, si asigna el nombre "assingment-1" a una asignación y el nombre de usuario del alumno en {% data variables.product.product_name %} es @octocat, el nombre del repositorio de la asignación para @octocat será `assignment-1-octocat`. +For an individual assignment, {% data variables.product.prodname_classroom %} names repositories by the repository prefix and the student's {% data variables.product.product_name %} username. By default, the repository prefix is the assignment title. For example, if you name an assignment "assignment-1" and the student's username on {% data variables.product.product_name %} is @octocat, the name of the assignment repository for @octocat will be `assignment-1-octocat`. {% data reusables.classroom.assignments-type-a-title %} -### Asignar una fecha límita para una tarea +### Assigning a deadline for an assignment {% data reusables.classroom.assignments-guide-assign-a-deadline %} -### Elegir un tipo de tarea +### Choosing an assignment type -En "Individual or group assignment", seleccione el menú desplegable y haga clic en **Individual assignment**. No puedes cambiar el tipo de tarea después de crearla. Si prefiere crear una asignación de grupo, vea "[Creación de una asignación de grupo](/education/manage-coursework-with-github-classroom/create-a-group-assignment)". +Under "Individual or group assignment", select the drop-down menu, and click **Individual assignment**. You can't change the assignment type after you create the assignment. If you'd rather create a group assignment, see "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." -### Elegir un tipo de visibilidad para los repositorios de la tarea +### Choosing a visibility for assignment repositories + +{% data reusables.classroom.assignments-repository-visibility-and-permissions %} {% data reusables.classroom.assignments-guide-choose-visibility %} {% data reusables.classroom.assignments-guide-click-continue-after-basics %} -## Agergar un código de inicio y configurar un ambiente de desarrollo +## Adding starter code and configuring a development environment {% data reusables.classroom.assignments-guide-intro-for-environment %} -- [Elección de un repositorio de plantilla](#choosing-a-template-repository) -- [Elección de un entorno de desarrollo integrado (IDE)](#choosing-an-integrated-development-environment-ide) +- [Choosing a template repository](#choosing-a-template-repository) +- [Choosing an integrated development environment (IDE)](#choosing-an-integrated-development-environment-ide) -### Elegir un repositorio de plantilla +### Choosing a template repository -Predeterminadamente, una tarea nueva creará un repositorio en blanco para cada alumno del registro de alumnos del aula. {% data reusables.classroom.you-can-choose-a-template-repository %} +By default, a new assignment will create an empty repository for each student on the roster for the classroom. {% data reusables.classroom.you-can-choose-a-template-repository %} {% data reusables.classroom.assignments-guide-choose-template-repository %} {% data reusables.classroom.assignments-guide-click-continue-after-starter-code-and-feedback %} -### Elegir un ambiente de desarrollo integrado (IDE) +### Choosing an integrated development environment (IDE) -{% data reusables.classroom.about-online-ides %} Para más información, vea "[Integración de {% data variables.product.prodname_classroom %} con un IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)". +{% data reusables.classroom.about-online-ides %} For more information, see "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)." {% data reusables.classroom.classroom-codespaces-link %} {% data reusables.classroom.assignments-guide-choose-an-online-ide %} -## Proporcionar retroalimentación para una tarea +## Providing feedback for an assignment -Opcionalmente, puedes calificar tareas automáticamente y crear un espacio para debatir cada entrega con el alumno. +Optionally, you can automatically grade assignments and create a space for discussing each submission with the student. -- [Prueba automática de las tareas](#testing-assignments-automatically) -- [Creación de una solicitud de incorporación de cambios para comentarios](#creating-a-pull-request-for-feedback) +- [Testing assignments automatically](#testing-assignments-automatically) +- [Creating a pull request for feedback](#creating-a-pull-request-for-feedback) -### Probar las tareas automáticamente +### Testing assignments automatically {% data reusables.classroom.assignments-guide-using-autograding %} -### Crear una solicitud de cambios para retroalimentación +### Creating a pull request for feedback {% data reusables.classroom.you-can-create-a-pull-request-for-feedback %} @@ -106,34 +102,34 @@ Opcionalmente, puedes calificar tareas automáticamente y crear un espacio para {% data reusables.classroom.assignments-guide-click-create-assignment-button %} -## Invitar a los alumnos a una tarea +## Inviting students to an assignment {% data reusables.classroom.assignments-guide-invite-students-to-assignment %} -Puede ver si un alumno se ha unido a la clase y ha aceptado o enviado una asignación en la pestaña **Classroom roster** para la asignación. También puede vincular los alias de {% data variables.product.prodname_dotcom %} de los alumnos a sus listas de identificadores asociadas y viceversa en esta pestaña. {% data reusables.classroom.assignments-to-prevent-submission %} +You can see whether a student has joined the classroom and accepted or submitted an assignment in the **Classroom roster** tab for the assignment. You can also link students' {% data variables.product.prodname_dotcom %} aliases to their associated roster identifier and vice versa in this tab. {% data reusables.classroom.assignments-to-prevent-submission %}
Individual assignment
-## Monitorear el progreso de los alumnos -La página de vista general de la tarea te proporciona una vista general de las aceptaciones de tu tarea y del progreso de los alumnos. Podrías tener información de resumen diferente con base en las configuraciones de tus tareas. +## Monitoring students' progress +The assignment overview page provides an overview of your assignment acceptances and student progress. You may have different summary information based on the configurations of your assignments. -- **Alumnos en la lista**: cantidad de alumnos en la lista del aula. -- **Alumnos agregados**: cantidad de cuentas de {% data variables.product.prodname_dotcom %} que han aceptado la asignación y no están asociadas con un identificador de lista. -- **Alumnos aceptados**: cantidad de cuentas que han aceptado esta asignación. -- **Envíos de asignación**: cantidad de alumnos que han enviado la asignación. Las emisiones se activan en la fecha límite de la tarea. -- **Alumnos aprobados**: cantidad de alumnos que actualmente han superado las pruebas de autoevaluación de esta asignación. +- **Rostered students**: The number of students on the Classroom's roster. +- **Added students**: The number of {% data variables.product.prodname_dotcom %} accounts that have accepted the assignment and are not associated with a roster identifier. +- **Accepted students**: The number of accounts have accepted this assignment. +- **Assignment submissions**: The number of students that have submitted the assignment. Submission is triggered at the assignment deadline. +- **Passing students**: The number of students currently passing the autograding tests for this assignment. -## Pasos siguientes +## Next steps -- Después de que creas la tarea, los alumnos pueden comenzar a trabajar en ella utilizando las características de Git y {% data variables.product.product_name %}. Los alumnos pueden clonar el repositorio, subir confirmaciones, administrar ramas, crear y revisar solicitudes de cambio, tratar los confluctos de fusión y debatir los cambios con propuestas. Tanto tú como el alumno pueden revisar el historial de confirmaciones del repositorio. Para más información, vea "[Introducción a {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)", "[Repositorios](/repositories)" y "[Colaboración con incidencias y solicitudes de incorporación de cambios](/github/collaborating-with-issues-and-pull-requests)". +- Once you create the assignment, students can start work on the assignment using Git and {% data variables.product.product_name %}'s features. Students can clone the repository, push commits, manage branches, create and review pull requests, address merge conflicts, and discuss changes with issues. Both you and student can review the commit history for the repository. For more information, see "[Getting started with {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)," "[Repositories](/repositories)," and "[Collaborating with issues and pull requests](/github/collaborating-with-issues-and-pull-requests)." -- Cuando un alumno termina una tarea, puedes revisar los archivos en el repositorio, o puedes revisar el historial y las visualizaciones del repositorio para entender mejor su trabajo. Para más información, vea "[Visualización de datos del repositorio con gráficos](/github/visualizing-repository-data-with-graphs)". +- When a student finishes an assignment, you can review the files in the repository, or you can review the history and visualizations for the repository to better understand the student's work. For more information, see "[Visualizing repository data with graphs](/github/visualizing-repository-data-with-graphs)." -- Puedes proporcionar retroalimentación para una tarea si comentas en confirmaciones o líneas individuales dentro de una solicitud de cambios. Para más información, vea "[Comentarios sobre una solicitud de incorporación de cambios](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)" y "[Apertura de una incidencia desde el código](/github/managing-your-work-on-github/opening-an-issue-from-code)". Para más información sobre cómo crear respuestas guardadas para proporcionar comentarios sobre errores comunes, vea "[Acerca de las respuestas guardadas](/github/writing-on-github/about-saved-replies)". +- You can provide feedback for an assignment by commenting on individual commits or lines in a pull request. For more information, see "[Commenting on a pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)" and "[Opening an issue from code](/github/managing-your-work-on-github/opening-an-issue-from-code)." For more information about creating saved replies to provide feedback for common errors, see "[About saved replies](/github/writing-on-github/about-saved-replies)." -## Información adicional +## Further reading -- «[{% data variables.product.prodname_global_campus %} para profesores](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers)» -- "[Conexión de un sistema de administración de aprendizaje a {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)" +- "[{% data variables.product.prodname_global_campus %} for teachers](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers)" +- "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom)" diff --git a/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md b/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md index c5448aa9bc..415ff82605 100644 --- a/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md +++ b/translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md @@ -11,6 +11,7 @@ children: - /use-the-git-and-github-starter-assignment - /create-an-individual-assignment - /create-a-group-assignment + - /editing-an-assignment - /reuse-an-assignment - /create-an-assignment-from-a-template-repository - /leave-feedback-with-pull-requests @@ -18,11 +19,11 @@ children: - /register-a-learning-management-system-with-github-classroom - /connect-a-learning-management-system-course-to-a-classroom shortTitle: Teach -ms.openlocfilehash: 8d2c7eb41a233af9ef331ae30daf97387a80b522 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 291aac6523c5df876e7e327aad962711cc82b003 +ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: '145112161' +ms.lasthandoff: 11/21/2022 +ms.locfileid: '148179754' --- diff --git a/translations/es-ES/content/get-started/onboarding/getting-started-with-github-ae.md b/translations/es-ES/content/get-started/onboarding/getting-started-with-github-ae.md index 0717b20b76..7a247d6c1c 100644 --- a/translations/es-ES/content/get-started/onboarding/getting-started-with-github-ae.md +++ b/translations/es-ES/content/get-started/onboarding/getting-started-with-github-ae.md @@ -19,7 +19,7 @@ You will first need to purchase {% data variables.product.product_name %}. For m After {% data variables.product.company_short %} creates the owner account for {% data variables.location.product_location %} on {% data variables.product.product_name %}, you will receive an email to sign in and complete the initialization. During initialization, you, as the enterprise owner, will name {% data variables.location.product_location %}, configure SAML SSO, create policies for all organizations in {% data variables.location.product_location %}, and configure a support contact for your enterprise members. For more information, see "[Initializing {% data variables.product.prodname_ghe_managed %}](/admin/configuration/configuring-your-enterprise/initializing-github-ae)." ### 3. Restricting network traffic -You can configure an allow list for specific IP addresses to restrict access to assets owned by organizations in your enterprise account. For more information, see "[Restricting network traffic to your enterprise](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise)." +You can configure an allow list for specific IP addresses to restrict access to assets owned by organizations in your enterprise account. For more information, see "[Restricting network traffic to your enterprise with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)." ### 4. Managing identity and access for {% data variables.location.product_location %} You can centrally manage access to {% data variables.location.product_location %} on {% data variables.product.product_name %} from an identity provider (IdP) using SAML single sign-on (SSO) for user authentication and System for Cross-domain Identity Management (SCIM) for user provisioning. Once you configure provisioning, you can assign or unassign users to the application from the IdP, creating or disabling user accounts in the enterprise. For more information, see "[About identity and access management for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-identity-and-access-management-for-your-enterprise)." diff --git a/translations/es-ES/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server.md b/translations/es-ES/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server.md index 56ce427eb4..530a791308 100644 --- a/translations/es-ES/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server.md +++ b/translations/es-ES/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server.md @@ -1,6 +1,6 @@ --- -title: Setting up a trial of GitHub Enterprise Server -intro: 'You can try {% data variables.product.prodname_ghe_server %} for free.' +title: Configurar una prueba del servidor de GitHub Enterprise +intro: 'Puedes probar {% data variables.product.prodname_ghe_server %} de manera gratuita.' redirect_from: - /articles/requesting-a-trial-of-github-enterprise - /articles/setting-up-a-trial-of-github-enterprise-server @@ -13,45 +13,50 @@ versions: topics: - Accounts shortTitle: Enterprise Server trial +ms.openlocfilehash: 9beee350488bdf27beb7107deda3c44f560d29e9 +ms.sourcegitcommit: 0a6e3eee6eea9b1e445aea1e4461d64cf6b63218 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163566' --- +## Acerca de las pruebas de {% data variables.product.prodname_ghe_server %} -## About trials of {% data variables.product.prodname_ghe_server %} +Puedes solicitar una prueba de 45 días para evaluar {% data variables.product.prodname_ghe_server %}. La prueba se instalará a modo de aparato virtual, con opciones para la implementación en el entorno local o en la nube. Para más información sobre {% data variables.product.prodname_ghe_server %}, y para obtener una lista de plataformas de virtualización admitidas, consulta "[Acerca de {% data variables.product.prodname_ghe_server %}](/enterprise-server/admin/overview/about-github-enterprise-server)". -You can request a 45-day trial to evaluate {% data variables.product.prodname_ghe_server %}. Your trial will be installed as a virtual appliance, with options for on-premises or cloud deployment. For more information about {% data variables.product.prodname_ghe_server %}, and for a list of supported virtualization platforms, see "[About {% data variables.product.prodname_ghe_server %}](/enterprise-server/admin/overview/about-github-enterprise-server)." +{% ifversion ghes %}{% data variables.product.prodname_dependabot %}{% else %}Las alertas de seguridad {% endif %} y {% data variables.product.prodname_github_connect %} no están disponibles en este momento en las evaluaciones gratuitas de {% data variables.product.prodname_ghe_server %}. Para obtener una demostración de estas características, contacta a {% data variables.contact.contact_enterprise_sales %}. Para obtener más información sobre estas características, consulte ["Acerca de {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" y "[Conexión de la cuenta empresarial a {% data variables.product.prodname_ghe_cloud %}](/enterprise-server@latest/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud)." -{% ifversion ghes %}{% data variables.product.prodname_dependabot %}{% else %}Security{% endif %} alerts and {% data variables.product.prodname_github_connect %} are not currently available in trials of {% data variables.product.prodname_ghe_server %}. For a demonstration of these features, contact {% data variables.contact.contact_enterprise_sales %}. For more information about these features, see "[About {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" and "[Connecting your enterprise account to {% data variables.product.prodname_ghe_cloud %}](/enterprise-server@latest/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud)." - -Trials are also available for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Setting up a trial of {% data variables.product.prodname_ghe_cloud %}](/articles/setting-up-a-trial-of-github-enterprise-cloud)." +También hay pruebas disponibles para {% data variables.product.prodname_ghe_cloud %}. Para obtener más información, consulte "[Configuración de una evaluación gratuita de {% data variables.product.prodname_ghe_cloud %}](/articles/setting-up-a-trial-of-github-enterprise-cloud)". {% data reusables.products.which-product-to-use %} -## Setting up your trial of {% data variables.product.prodname_ghe_server %} +## Configurar tu prueba de {% data variables.product.prodname_ghe_server %} -{% data variables.product.prodname_ghe_server %} is installed as a virtual appliance. Determine the best person in your organization to set up a virtual machine, and ask that person to submit a [trial request](https://enterprise.github.com/trial). You can begin your trial immediately after submitting a request. +{% data variables.product.prodname_ghe_server %} está instalado como aparato virtual. Determine quién es la mejor persona de su organización para configurar una máquina virtual y pida a esa persona que envíe una [solicitud de evaluación gratuita](https://enterprise.github.com/trial). Puedes comenzar tu prueba de forma inmediata después de enviar una solicitud. -To set up an account for the {% data variables.product.prodname_enterprise %} Web portal, click the link in the email you received after submitting your trial request, and follow the prompts. Then, download your license file. For more information, see "[Managing your license for {% data variables.product.prodname_enterprise %}](/enterprise-server@latest/billing/managing-your-license-for-github-enterprise)." +Para configurar una cuenta para el {% data variables.product.prodname_enterprise %} portal web, haz clic en el enlace del correo electrónico que recibiste después de enviar tu solicitud de prueba y sigue las instrucciones. A continuación, descarga tu archivo de licencia. Para obtener más información, consulte "[Administración de la licencia de {% data variables.product.prodname_enterprise %}](/enterprise-server@latest/billing/managing-your-license-for-github-enterprise)". -To install {% data variables.product.prodname_ghe_server %}, download the necessary components and upload your license file. For more information, see the instructions for your chosen visualization platform in "[Setting up a {% data variables.product.prodname_ghe_server %} instance](/enterprise-server@latest/admin/installation/setting-up-a-github-enterprise-server-instance)." +Para instalar {% data variables.product.prodname_ghe_server %}, descarga los elementos necesarios y carga tu archivo de licencia. Para obtener más información, consulte las instrucciones de la plataforma de visualización elegida en "[Configuración de una instancia de {% data variables.product.prodname_ghe_server %}](/enterprise-server@latest/admin/installation/setting-up-a-github-enterprise-server-instance)". -## Next steps +## Pasos siguientes -To get the most out of your trial, follow these steps: +Para sacar el mejor provecho de tu prueba, sigue los siguientes pasos: -1. [Create an organization](/enterprise-server@latest/admin/user-management/creating-organizations). -2. To learn the basics of using {% data variables.product.prodname_dotcom %}, see: - - [Intro to {% data variables.product.prodname_dotcom %}](https://resources.github.com/devops/methodology/maximizing-devops-roi/) webcast - - [Understanding the {% data variables.product.prodname_dotcom %} flow](https://guides.github.com/introduction/flow/) in {% data variables.product.prodname_dotcom %} Guides - - [Hello World](https://guides.github.com/activities/hello-world/) in {% data variables.product.prodname_dotcom %} Guides - - "[About versions of {% data variables.product.prodname_docs %}](/get-started/learning-about-github/about-versions-of-github-docs)" -3. To configure your instance to meet your organization's needs, see "[Configuring your enterprise](/enterprise-server@latest/admin/configuration/configuring-your-enterprise)." -4. To integrate {% data variables.product.prodname_ghe_server %} with your identity provider, see "[Using SAML](/enterprise-server@latest/admin/user-management/using-saml)" and "[Using LDAP](/enterprise-server@latest/admin/authentication/using-ldap)." -5. Invite an unlimited number of people to join your trial. - - Add users to your {% data variables.product.prodname_ghe_server %} instance using built-in authentication or your configured identity provider. For more information, see "[Using built in authentication](/enterprise-server@latest/admin/user-management/using-built-in-authentication)." - - To invite people to become account administrators, visit the [{% data variables.product.prodname_enterprise %} Web portal](https://enterprise.github.com/login). +1. [Cree una organización](/enterprise-server@latest/admin/user-management/creating-organizations). +2. Para aprender lo básico para usar {% data variables.product.prodname_dotcom %}, consulta lo siguiente: + - Webcast [Introducción a {% data variables.product.prodname_dotcom %}](https://resources.github.com/devops/methodology/maximizing-devops-roi/) + - Guías de [descripción del flujo de {% data variables.product.prodname_dotcom %}](https://guides.github.com/introduction/flow/) en {% data variables.product.prodname_dotcom %} + - Guías de [Hola mundo](https://guides.github.com/activities/hello-world/) en {% data variables.product.prodname_dotcom %} + - "[Acerca de las versiones de {% data variables.product.prodname_docs %}](/get-started/learning-about-github/about-versions-of-github-docs)" +3. Para configurar la instancia a fin de satisfacer las necesidades de su organización, consulte "[Configuración de la empresa](/enterprise-server@latest/admin/configuration/configuring-your-enterprise)". +4. Para integrar {% data variables.product.prodname_ghe_server %} con el proveedor de identidades, consulte "[Uso de SAML](/enterprise-server@latest/admin/user-management/using-saml)" y "[Uso de LDAP](/enterprise-server@latest/admin/authentication/using-ldap)". +5. Invita a una cantidad ilimitada de personas a unirse a tu prueba. + - Agregar usuarios a tu instancia {% data variables.product.prodname_ghe_server %} utilizando la autenticación incorporada o tu proveedor de identidad configurado. Para obtener más información, consulte "[Uso de la autenticación integrada](/enterprise-server@latest/admin/user-management/using-built-in-authentication)". + - Para invitar a los usuarios a convertirse en administradores de cuentas, visite el [portal web de {% data variables.product.prodname_enterprise %}](https://enterprise.github.com/login). {% note %} - **Note:** People you invite to become account administrators will receive an email with a link to accept your invitation. + **Nota:** Las personas a las que invite a convertirse en administradores de cuenta recibirán un correo electrónico con un vínculo para aceptar la invitación. {% endnote %} @@ -59,12 +64,12 @@ To get the most out of your trial, follow these steps: {% data reusables.products.product-roadmap %} -## Finishing your trial +## Terminar tu prueba -You can upgrade to full licenses in the [{% data variables.product.prodname_enterprise %} Web portal](https://enterprise.github.com/login) at any time during the trial period. +Puede actualizar a licencias completas en el [portal web de {% data variables.product.prodname_enterprise %}](https://enterprise.github.com/login) en cualquier momento durante el periodo de evaluación gratuita. -If you haven't upgraded by the last day of your trial, you'll receive an email notifying you that your trial had ended. If you need more time to evaluate {% data variables.product.prodname_enterprise %}, contact {% data variables.contact.contact_enterprise_sales %} to request an extension. +Si no has subido la categoría para el último día de tu prueba, recibirás un correo electrónico notificando que tu prueba ha terminado. Si necesitas más tiempo para evaluar {% data variables.product.prodname_enterprise %}, contacta a {% data variables.contact.contact_enterprise_sales %} para solicitar una extensión. -## Further reading +## Información adicional -- "[Setting up a trial of {% data variables.product.prodname_ghe_cloud %}](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud)" +- "[Configuración de una evaluación gratuita de {% data variables.product.prodname_ghe_cloud %}](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud)" diff --git a/translations/es-ES/content/get-started/using-github/github-command-palette.md b/translations/es-ES/content/get-started/using-github/github-command-palette.md index c169b3d97e..985bd59068 100644 --- a/translations/es-ES/content/get-started/using-github/github-command-palette.md +++ b/translations/es-ES/content/get-started/using-github/github-command-palette.md @@ -1,229 +1,234 @@ --- -title: GitHub Command Palette -intro: 'Use the command palette in {% data variables.product.product_name %} to navigate, search, and run commands directly from your keyboard.' +title: Paleta de Comandos de GitHub +intro: 'Utiliza la paleta de comandos en {% data variables.product.product_name %} para navegar, buscar y ejecutar comandos directamente desde tu teclado.' versions: feature: command-palette shortTitle: GitHub Command Palette +ms.openlocfilehash: 5c6b739f2422be780cef6fa0e44e5d75663cc036 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159057' --- - {% data reusables.command-palette.beta-note %} -## About the {% data variables.product.prodname_command_palette %} +## Acerca de la {% data variables.product.prodname_command_palette %} -You can navigate, search, and run commands on {% data variables.product.product_name %} with the {% data variables.product.prodname_command_palette %}. The command palette is an on-demand way to show suggestions based on your current context and resources you've used recently. You can open the command palette with a keyboard shortcut from anywhere on {% data variables.product.product_name %}, which saves you time and keeps your hands on the keyboard. +Puedes navegar, buscar y ejecutar comandos en {% data variables.product.product_name %} con la {% data variables.product.prodname_command_palette %}. La paleta de comandos es una forma popular de mostrar sugerencias con base en el contexto y recursos actuales que hayas utilizado recientemente. Puedes abrir la paleta de comandos con un atajo de teclado desde cualquier parte en {% data variables.product.product_name %}, lo cual te ahorra tiempo y mantiene tus manos en el teclado. -### Fast navigation +### Navegación rápida -When you open the command palette, the suggestions are optimized to give you easy access from anywhere in a repository, personal account, or organization to top-level pages like the Issues page. If the location you want isn't listed, start entering the name or number for the location to refine the suggestions. +Al abrir la paleta de comandos, las sugerencias están optimizadas para facilitar el acceso desde cualquier lugar de un repositorio, cuenta personal u organización a páginas de nivel superior, como la página Incidencias. Si la ubicación que buscas no está listada, comienza a introducir el nombre o número de la ubicación para refinar las sugerencias. -![Command palette repository suggestions](/assets/images/help/command-palette/command-palette-navigation-repo-default.png) +![Sugerencias de repositorio para la paleta de comandos](/assets/images/help/command-palette/command-palette-navigation-repo-default.png) -### Easy access to commands +### Acceso fácil a los comandos -The ability to run commands directly from your keyboard, without navigating through a series of menus, may change the way you use {% data variables.product.prodname_dotcom %}. For example, you can switch themes with a few keystrokes, making it easy to toggle between themes as your needs change. +La capacidad de ejecutar comandos directamente desde tu teclado, sin necesidad de navegar a través de varios menús, podría cambiar la forma en la que utilizas {% data variables.product.prodname_dotcom %}. Por ejemplo, puedes cambiar de tema presionando un par de teclas, lo cual facilita alternar entre estos temas conforme cambien tus necesidades. -![Command palette change theme](/assets/images/help/command-palette/command-palette-command-change-theme.png) +![Cambio de tema para la paleta de comandos](/assets/images/help/command-palette/command-palette-command-change-theme.png) -## Opening the {% data variables.product.prodname_command_palette %} +## Apertura de la {% data variables.product.prodname_command_palette %} -Open the command palette using one of the following default keyboard shortcuts: -- Windows and Linux: Ctrl+K or Ctrl+Alt+K -- Mac: Command+K or Command+Option+K +Abre la paleta de comandos utilizando uno de los siguientes atajos de teclado predeterminados: +- Windows y Linux: Ctrl+K o Ctrl+Alt+K +- Mac: Comando+K o Comando+Opción+K -You can customize the keyboard shortcuts you use to open the command palette in the [Accessibility section](https://github.com/settings/accessibility) of your user settings. For more information, see "[Customizing your {% data variables.product.prodname_command_palette %} keyboard shortcuts](#customizing-your-github-command-palette-keyboard-shortcuts)." +Puede personalizar los métodos abreviados de teclado que usa para abrir la paleta de comandos en la [sección Accesibilidad](https://github.com/settings/accessibility) de la configuración de usuario. Para más información, vea "[Personalización de los métodos abreviados de teclado de {% data variables.product.prodname_command_palette %}](#customizing-your-github-command-palette-keyboard-shortcuts)". -When you open the command palette, it shows your location at the top left and uses it as the scope for suggestions (for example, the `mashed-avocado` organization). +Al abrir la paleta de comandos, muestra la ubicación en la esquina superior izquierda y la usa como ámbito para las sugerencias (por ejemplo, la organización `mashed-avocado`). -![Command palette launch](/assets/images/help/command-palette/command-palette-launch.png) +![Lanzamiento de la paleta de comandos](/assets/images/help/command-palette/command-palette-launch.png) {% note %} -**Notes:** -- If you are editing Markdown text, open the command palette with Ctrl+Alt+K (Windows and Linux) or Command+Option+K (Mac).{% ifversion projects-v2 %} -- If you are working on a {% data variables.projects.project_v2 %}, a project-specific command palette is displayed instead. For more information, see "[Customizing a view](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)."{% endif %} +**Notas:** +- Si vas a editar texto de Markdown, abre la paleta de comandos con Ctrl+Alt+K (Windows t Linux) o Comando+Opción+K (Mac).{% ifversion projects-v2 %} +- Si trabajas en una instancia de {% data variables.projects.project_v2 %}, en su lugar se muestra una paleta de comandos específica del proyecto. Para más información, consulta "[Personalización de una vista](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)".{% endif %} {% endnote %} -### Customizing your {% data variables.product.prodname_command_palette %} keyboard shortcuts +### Personalizar tus atajos de teclado para la {% data variables.product.prodname_command_palette %} -The default keyboard shortcuts used to open the command palette may conflict with your default OS and browser keyboard shortcuts. You have the option to customize your keyboard shortcuts in the [Accessibility section](https://github.com/settings/accessibility) of your account settings. In the command palette settings, you can customize the keyboard shortcuts for opening the command palette in both search mode and command mode. +Los atajos de teclado predeterminados que se utilizan para abrir la paleta de comandos pueden entrar en conflicto con aquellos de tu buscador y SO. Tiene la opción de personalizar los métodos abreviados de teclado en la [sección Accesibilidad](https://github.com/settings/accessibility) de la configuración de la cuenta. En los ajustes de la paleta de comandos, puedes personalizar los ajustes de teclado para abrirla tanto en modo de búsqueda como en modo de comando. -![Command palette keyboard shortcut settings](/assets/images/help/command-palette/command-palette-keyboard-shortcut-settings.png) -## Navigating with the {% data variables.product.prodname_command_palette %} +![Configuración de atajos de teclado para la paleta de comandos](/assets/images/help/command-palette/command-palette-keyboard-shortcut-settings.png) +## Navegar con la {% data variables.product.prodname_command_palette %} -You can use the command palette to navigate to any page that you have access to on {% data variables.product.product_name %}. +Puedes utilizar la paleta de comandos para navegar a cualquier página a la que tengas acceso en {% data variables.product.product_name %}. {% data reusables.command-palette.open-palette %} -2. Start typing the path you want to navigate to. The suggestions in the command palette change to match your text. +2. Comienza a teclear la ruta a la cual quieras navegar. Las sugerencias en la paleta de comandos cambian para empatar con tu texto. - ![Command palette navigation current scope](/assets/images/help/command-palette/command-palette-navigation-current-scope.png) + ![Alcance actual de navegación de la paleta de comandos](/assets/images/help/command-palette/command-palette-navigation-current-scope.png) {% data reusables.command-palette.change-scope %} - You can also use keystrokes to narrow your search. For more information, see "[Keystroke functions](#keystroke-functions)." + También puedes teclear algunos caracteres para reducir tu búsqueda. Para más información, vea "[Funciones de pulsación de teclas](#keystroke-functions)". -4. Finish entering the path, or use the arrow keys to highlight the path you want from the list of suggestions. +4. Termina de ingresar la ruta o utiliza las flechas del teclado para resaltar la ruta que quieres desde la lista de sugerenicas. -5. Use Enter to jump to your chosen location. Alternatively, use Ctrl+Enter (Windows and Linux) or Command+Enter (Mac) to open the location in a new browser tab. +5. Presione Entrar para saltar a la ubicación elegida. Como alternativa, presione Ctrl+Entrar (Windows y Linux) o Comando+Entrar (Mac) para abrir la ubicación en una nueva pestaña del explorador. -## Searching with the {% data variables.product.prodname_command_palette %} +## Buscar con la {% data variables.product.prodname_command_palette %} -You can use the command palette to search for anything on {% data variables.location.product_location %}. +Puedes utilizar la paleta de comandos para buscar lo que sea en {% data variables.location.product_location %}. {% data reusables.command-palette.open-palette %} {% data reusables.command-palette.change-scope %} -3. Optionally, use keystrokes to find specific types of resource: +3. Opcionalmente, utiliza las teclas para encontrar tipos específicos de recursos: - - # Search for issues, pull requests, discussions, and projects - - ! Search for projects - - @ Search for users, organizations, and repositories - - / Search for files within a repository scope + - # Búsqueda de incidencias, solicitudes de incorporación de cambios, debates y proyectos + - ! Búsqueda de proyectos + - @ Búsqueda de usuarios, organizaciones y repositorios + - / Búsqueda de archivos dentro del ámbito de un repositorio - ![Command palette search files](/assets/images/help/command-palette/command-palette-search-files.png) + ![Archivos de búsqueda de la paleta de comandos](/assets/images/help/command-palette/command-palette-search-files.png) -4. Begin entering your search terms. The command palette will offer you a range of suggested searches based on your search scope. +4. Comienza a ingresar tus términos de búsqueda. La paleta de comandos te ofrecerá un rango de búsquedas sugeridas con base en el alcance de tu búsqueda. {% tip %} - You can also use the full syntax of {% data variables.product.prodname_dotcom %}'s integrated search within the command palette. For more information, see "[Searching for information on {% data variables.product.prodname_dotcom %}](/search-github)." + También puedes utilizar toda la sintaxis de la búsqueda integrada de {% data variables.product.prodname_dotcom %} dentro de la paleta de comandos. Par más información, vea "[Búsqueda de información sobre {% data variables.product.prodname_dotcom %}](/search-github)". {% endtip %} -5. Use the arrow keys to highlight the search result you want and use Enter to jump to your chosen location. Alternatively, use Ctrl+Enter (Windows and Linux) or Command+Enter (Mac) to open the location in a new browser tab. +5. Use las teclas de dirección para resaltar el resultado de la búsqueda que quiera y presione Entrar para saltar a la ubicación elegida. Como alternativa, presione Ctrl+Entrar (Windows y Linux) o Comando+Entrar (Mac) para abrir la ubicación en una nueva pestaña del explorador. -## Running commands from the {% data variables.product.prodname_command_palette %} +## Ejecutar comandos desde la {% data variables.product.prodname_command_palette %} -You can use the {% data variables.product.prodname_command_palette %} to run commands. For example, you can create a new repository or issue, or change your theme. When you run a command, the location for its action is determined by either the underlying page or the scope shown in the command palette. +Puedes utilizar la {% data variables.product.prodname_command_palette %} para ejecutar comandos. Por ejemplo, puedes crear un repositorio o propuesta nuevos o cambiar tu tema. Cuando ejecutas un comando, la ubicación de su acción se determina ya sea por la página subyacente o por el alcance que se muestra en la paleta de comandos. -- Pull request and issue commands always run on the underlying page. -- Higher-level commands, for example, repository commands, run in the scope shown in the command palette. +- Los comandos de solicitudes de cambios y propuestas siempre se ejecutan en la página subyacente. +- Los comandos de nivel superior, por ejemplo los de repositorio, se ejecutan en el alcance que se muestra en la paleta de comandos. -For a full list of supported commands, see "[{% data variables.product.prodname_command_palette %} reference](#github-command-palette-reference)." +Para obtener una lista completa de los comandos admitidos, vea "[Referencia de {% data variables.product.prodname_command_palette %}](#github-command-palette-reference)". -1. The default keyboard shortcuts to open the command palette in command mode are Ctrl+Shift+K (Windows and Linux) or Command+Shift+K (Mac). If you already have the command palette open, press > to switch to command mode. {% data variables.product.prodname_dotcom %} suggests commands based on your location. +1. Los métodos abreviados de teclado predeterminados para abrir la paleta de comandos en modo de comandos son Ctrl+Mayús+K (Windows y Linux) o Comando+Mayús+K (Mac). Si ya ha abierto la paleta de comandos, presione > para cambiar al modo de comandos. {% data variables.product.prodname_dotcom %} sugiere comandos con base en tu ubicación. - ![Command palette command mode](/assets/images/help/command-palette/command-palette-command-mode.png) + ![Modo de comandos de la paleta de comandos](/assets/images/help/command-palette/command-palette-command-mode.png) {% data reusables.command-palette.change-scope %} -3. If the command you want is not displayed, check your scope then start entering the command name in the text box. +3. Si no se muestra el comando que quieres, verifica tu alcance y luego comienza a ingresar el nombre del comando en la caja de texto. -4. Use the arrow keys to highlight the command you want and use Enter to run it. +4. Use las teclas de dirección para resaltar el comando que quiera y presione Entrar para ejecutarlo. -## Closing the command palette +## Cerrar la paleta de comandos -When the command palette is active, you can use one of the following keyboard shortcuts to close the command palette: +Cuando la paleta de comandos está activa, puedes utilizar uno de los siguientes atajos de teclado para cerrarla: -- Search and navigation mode: Esc or Ctrl+K (Windows and Linux) Command+K (Mac) -- Command mode: Esc or Ctrl+Shift+K (Windows and Linux) Command+Shift+K (Mac) +- Modo de búsqueda y navegación: Esc o Ctrl+K (Windows y Linux) Comando+K (Mac) +- Modo de comandos: Esc o Ctrl+Mayús+K (Windows y Linux) Comando+Mayús+K (Mac) -If you have customized the command palette keyboard shortcuts in the Accessibility settings, your customized keyboard shortcuts will be used for both opening and closing the command palette. +Si personalizaste los atajos de teclado para la paleta de comandos en los ajustes de accesibilidad, tus atajos personalizados se utilizarán tanto para abrirla como para cerrarla. -## {% data variables.product.prodname_command_palette %} reference +## Referencia de la {% data variables.product.prodname_command_palette %} -### Keystroke functions +### Funciones de las teclas -These keystrokes are available when the command palette is in navigation and search modes, that is, they are not available in command mode. +Estas teclas están disponibles cuando la paleta de comandos se encuentra en los modos de búsqueda y navegación, es decir, no están disponibles en el modo de comandos. -| Keystroke | Function | +| Pulsación de tecla | Función | | :- | :- | -|>| Enter command mode. For more information, see "[Running commands from the {% data variables.product.prodname_command_palette %}](#running-commands-from-the-github-command-palette)." | -|#| Search for issues, pull requests, discussions, and projects. For more information, see "[Searching with the {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)."| -|@| Search for users, organizations, and repositories. For more information, see "[Searching with the {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)."| -|/| Search for files within a repository scope or repositories within an organization scope. For more information, see "[Searching with the {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)." | -|!| Search just for projects. For more information, see "[Searching with the {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)."| -|Ctrl+C or Command+C| Copy the search or navigation URL for the highlighted result to the clipboard.| -|Enter| Jump to the highlighted result or run the highlighted command.| -|Ctrl+Enter or Command+Enter| Open the highlighted search or navigation result in a new brower tab.| -|?| Display help within the command palette.| +|>| Modo de ingreso de comandos. Para más información, vea "[Ejecución de comandos desde {% data variables.product.prodname_command_palette %}](#running-commands-from-the-github-command-palette)". | +|#| Busca propuestas, solicitudes de cambio, debates y proyectos. Para más información, vea "[Búsqueda con {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)".| +|@| Busca usuarios, organizaciones y repositorios. Para más información, vea "[Búsqueda con {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)".| +|/| Busca archivos dentro del alcance de un repositorio o repositorios dentro del alcance de una organización. Para más información, vea "[Búsqueda con {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)". | +|!| Busca solo proyectos. Para más información, vea "[Búsqueda con {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)".| +|Ctrl+C o Comando+C| Copia al portapapeles la URL de navegación o de búsqueda para el resultado resaltado.| +|Entrar| Salta al resultado resaltado o ejecuta el comando resaltado.| +|Ctrl+Entrar o Comando+Entrar| Abre la búsqueda resaltada o resultado de navegación en una pestaña nueva del buscador.| +|?| Muestra la ayuda dentro de la paleta de comandos.| -### Global commands +### Comandos globales -These commands are available from all scopes. +Estos comandos se encuentran disponibles en todos los alcances. -| Command | Behavior| +| Get-Help | Comportamiento| | :- | :- | :- | -|`Import repository`|Create a new repository by importing a project from another version control system. For more information, see "[Importing a repository with GitHub importer](/get-started/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer)." | -|`New gist`|Open a new gist. For more information, see "[Creating a gist](/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists)." | -|`New organization`|Create a new organization. For more information, see "[Creating a new organization from scratch](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)." | -|`New project`|Create a new project board. For more information, see "[Creating a project](/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project)." | -|`New repository`|Create a new repository from scratch. For more information, see "[Creating a new repository](/repositories/creating-and-managing-repositories/creating-a-new-repository)." | -|`Switch theme to `|Change directly to a different theme for the UI. For more information, see "[Managing your theme settings](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-your-theme-settings)." | +|`Import repository`|Crea un repositorio nuevo importando un proyecto desde otro sistema de control de versiones. Para más información, vea "[Importación de un repositorio con el importador de GitHub](/get-started/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer)". | +|`New gist`|Abre un gist nuevo. Para más información, vea "[Creación de un gist](/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists)". | +|`New organization`|Crea una organización nueva. Para más información, vea "[Creación de una organización desde cero](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)". | +|`New project`|Crea un tablero de proyecto nuevo. Para más información, vea "[Creación de un proyecto](/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project)". | +|`New repository`|Crea un repositorio nuevo desde cero. Para más información, vea "[Creación de un repositorio](/repositories/creating-and-managing-repositories/creating-a-new-repository)". | +|`Switch theme to `|Cambia directamente a un tema diferente para la IU. Para más información, vea "[Administración de la configuración de temas](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-your-theme-settings)". | -### Organization commands +### Comandos de organización -These commands are available only within the scope of an organization. +Estos comandos se encuentran disponibles únicamente dentro del alcance de una organización. -| Command | Behavior| +| Get-Help | Comportamiento| | :- | :- | -| `New team`| Create a new team in the current organization. For more information, see "[Creating a team](/organizations/organizing-members-into-teams/creating-a-team)." +| `New team`| Crea un equipo nuevo en la organización actual. Para más información, vea "[Creación de un equipo](/organizations/organizing-members-into-teams/creating-a-team)". -### Repository commands +### Comandos de repositorio -Most of these commands are available only on the home page of the repository. If a command is also available on other pages, this is noted in the behavior column. +La mayoría de estos comandos se encuentran disponibles únicamente en la página principal del repositorio. Si un comando también está disponible en otras páginas, esto se nota en la columna de comportamiento. -| Command | Behavior| +| Get-Help | Comportamiento| | :- | :- | -|`Clone repository: `|Copy the URL needed to clone the repository using {% data variables.product.prodname_cli %}, HTTPS, or SSH to the clipboard. For more information, see "[Cloning a repository](/repositories/creating-and-managing-repositories/cloning-a-repository)."| -|`New discussion`|Create a new discussion in the repository. For more information, see "[Creating a new discussion](/discussions/quickstart#creating-a-new-discussion)."| -|`New file`|Create a new file from any page in the repository. For more information, see "[Adding a file to a repository](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository)." -|`New issue`|Open a new issue from any page in the repository. For more information, see "[Creating an issue](/issues/tracking-your-work-with-issues/creating-an-issue)."| -|`Open in new codespace`|Create and open a codespace for this repository. For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)."| -|`Open in github.dev editor`|Open the current repository in the github.dev editor. For more information, see "[Opening the web based editor](/codespaces/the-githubdev-web-based-editor#opening-the-web-based-editor)."| +|`Clone repository: `|Copia al portapapeles la URL que necesitas para clonar el repositorio utilizando el {% data variables.product.prodname_cli %}, HTTPS o SSH. Para más información, vea "[Clonación de un repositorio](/repositories/creating-and-managing-repositories/cloning-a-repository)".| +|`New discussion`|Crea un debate nuevo en el repositorio. Para más información, vea "[Creación de un debate](/discussions/quickstart#creating-a-new-discussion)".| +|`New file`|Crea un archivo nuevo desde cualquier página en el repositorio. Para más información, vea "[Adición de un archivo a un repositorio](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository)". +|`New issue`|Abre una propuesta nueva desde cualquier página en el repositorio. Para más información, vea "[Creación de una incidencia](/issues/tracking-your-work-with-issues/creating-an-issue)".| +|`Open in new codespace`|Crea y abre un codespace para este repositorio. Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)".| +|`Open in github.dev editor`|Abre el repositorio actual en el editor github.dev. Para más información, vea "[Apertura del editor basado en web](/codespaces/the-githubdev-web-based-editor#opening-the-web-based-editor)".| -### File commands +### Comandos de archivo -These commands are available only when you open the command palette from a file in a repository. +Estos comandos se encuentran disponibles únicamente cuando abres la paleta de comandos desde un archivo en un repositorio. -| Command | Behavior| +| Get-Help | Comportamiento| | :- | :- | -|`Copy permalink`|Create a link to the file that includes the current commit SHA and copy the link to the clipboard. For more information, see "[Getting permanent links to files](/repositories/working-with-files/using-files/getting-permanent-links-to-files#press-y-to-permalink-to-a-file-in-a-specific-commit)." -|`Open in github.dev editor`|Open the currently displayed file in github.dev editor. For more information, see "[Opening the web based editor](/codespaces/the-githubdev-web-based-editor#opening-the-web-based-editor)."| +|`Copy permalink`|Crea un enlace al archivo que incluye el SHA de la confirmación actual y copia el enlace al portapapeles. Para más información, vea "[Obtención de vínculos permanentes en archivos](/repositories/working-with-files/using-files/getting-permanent-links-to-files#press-y-to-permalink-to-a-file-in-a-specific-commit)". +|`Open in github.dev editor`|Abre el archivo que se muestra actualmente en el editor github.dev. Para más información, vea "[Apertura del editor basado en web](/codespaces/the-githubdev-web-based-editor#opening-the-web-based-editor)".| -### Discussion commands +### Comandos de debate -These commands are available only when you open the command palette from a discussion. They act on your current page and are not affected by the scope set in the command palette. +Estos comandos se encuentran disponibles únicamente cuando abres la paleta de comandos desde un debate. Estos actúan en tu página actual y no se ven afectados por el alcance que se configuró en la paleta de comandos. -| Command | Behavior| +| Get-Help | Comportamiento| | :- | :- | -|`Delete discussion...`|Permanently delete the discussion. For more information, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)." -|`Edit discussion body`|Open the main body of the discussion ready for editing. -|`Subscribe`/`unsubscribe`|Opt in or out of notifications for additions to the discussion. For more information, see "[About notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)." -|`Transfer discussion...`|Move the discussion to a different repository. For more information, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions#transferring-a-discussion)." +|`Delete discussion...`|Borra el debate permanentemente. Para obtener más información, consulta "[Administración de debates](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)". +|`Edit discussion body`|Abre el cuerpo principal del debate listo para editar. +|`Subscribe`/`unsubscribe`|Decide ingresar o salir de las notificaciones para adiciones al debate. Para más información, vea "[Acerca de las notificaciones](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)". +|`Transfer discussion...`|Mueve el debate a un repositorio distinto. Para obtener más información, consulta "[Administración de debates](/discussions/managing-discussions-for-your-community/managing-discussions#transferring-a-discussion)". -### Issue commands +### Comandos de propuesta -These commands are available only when you open the command palette from an issue. They act on your current page and are not affected by the scope set in the command palette. +Estos comandos se encuentran disponibles únicamente cuando abres la paleta de comandos desde una propuesta. Estos actúan en tu página actual y no se ven afectados por el alcance que se configuró en la paleta de comandos. -| Command | Behavior| +| Get-Help | Comportamiento| | :- | :- | -|`Close`/`reopen issue`|Close or reopen the current issue. For more information, see "[About issues](/issues/tracking-your-work-with-issues/about-issues)."| -|`Convert issue to discussion...`|Convert the current issue into a discussion. For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)." -|`Delete issue...`|Delete the current issue. For more information, see "[Deleting an issue](/issues/tracking-your-work-with-issues/deleting-an-issue)."| -|`Edit issue body`|Open the main body of the issue ready for editing. -|`Edit issue title`|Open the title of the issue ready for editing. -|`Lock issue`|Limit new comments to users with write access to the repository. For more information, see "[Locking conversations](/communities/moderating-comments-and-conversations/locking-conversations)." -|`Pin`/`unpin issue`|Change whether or not the issue is shown in the pinned issues section for the repository. For more information, see "[Pinning an issue to your repository](/issues/tracking-your-work-with-issues/pinning-an-issue-to-your-repository)."| -|`Subscribe`/`unsubscribe`|Opt in or out of notifications for changes to this issue. For more information, see "[About notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)." -|`Transfer issue...`|Transfer the issue to another repository. For more information, see "[Transferring an issue to another repository](/issues/tracking-your-work-with-issues/transferring-an-issue-to-another-repository)."| +|`Close`/`reopen issue`|Cierra o vuelve a abrir la propuesta actual. Para más información, vea "[Acerca de las incidencias](/issues/tracking-your-work-with-issues/about-issues)".| +|`Convert issue to discussion...`|Convierte la propuesta actual en un debate. Para más información, vea "[Moderación de debates](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)". +|`Delete issue...`|Borra la propuesta actual. Para más información, vea "[Eliminación de una incidencia](/issues/tracking-your-work-with-issues/deleting-an-issue)".| +|`Edit issue body`|Abre el cuerpo principal de la propuesta listo para su edición. +|`Edit issue title`|Abre el título de la propuesta listo para su edición. +|`Lock issue`|Limita los comentarios nuevos a los usuarios con acceso de escritura en el repositorio. Para más información, vea "[Bloqueo de conversaciones](/communities/moderating-comments-and-conversations/locking-conversations)". +|`Pin`/`unpin issue`|Cambia entre si la propuesta se muestra en la sección de propuestas fijadas del repositorio o no. Para más información, vea "[Anclaje de una incidencia al repositorio](/issues/tracking-your-work-with-issues/pinning-an-issue-to-your-repository)".| +|`Subscribe`/`unsubscribe`|Decide recibir o no recibir notificaciones para los cambios a esta propuesta. Para más información, vea "[Acerca de las notificaciones](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)". +|`Transfer issue...`|Transfiere la propuesta a otro repositorio. Para más información, vea "[Transferencia de una incidencia a otro repositorio](/issues/tracking-your-work-with-issues/transferring-an-issue-to-another-repository)".| -### Pull request commands +### Comandos de las solicitudes de cambios -These commands are available only when you open the command palette from a pull request. They act on your current page and are not affected by the scope set in the command palette. +Estos comandos están disponibles únicamente cuando abres la paleta de comandos desde una solicitud de cambios. Estos actúan en tu página actual y no se ven afectados por el alcance que se configuró en la paleta de comandos. -| Command | Behavior| +| Get-Help | Comportamiento| | :- | :- | -|`Close`/`reopen pull request`|Close or reopen the current pull request. For more information, see "[About pull requests](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)."| -|`Convert to draft`/`Mark pull request as ready for review`|Change the state of the pull request to show it as ready, or not ready, for review. For more information, see "[Changing the state of a pull request](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request)."| -|`Copy current branch name`| Add the name of the head branch for the pull request to the clipboard. -|`Edit pull request body`|Open the main body of the pull request ready for editing. -|`Edit pull request title`|Open the title of the pull request ready for editing. -|`Open in new codespace`|Create and open a codespace for the head branch of the pull request. For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)." -|`Subscribe`/`unsubscribe`|Opt in or out of notifications for changes to this pull request. For more information, see "[About notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)." -|`Update current branch`|Update the head branch of the pull request with changes from the base branch. This is available only for pull requests that target the default branch of the repository. For more information, see "[About branches](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches)."| +|`Close`/`reopen pull request`|Cierra o vuelve a abrir la solicitud de cambios actual. Para más información, vea "[Acerca de las solicitudes de incorporación de cambios](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)".| +|`Convert to draft`/`Mark pull request as ready for review`|Cambia el estado de la solicitud de cambios para mostrarla como lista, o no lista, para su revisión. Para más información, vea "[Cambio del estado de una solicitud de incorporación de cambios](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request)".| +|`Copy current branch name`| Agrega al portapapeles el nombre de la rama de encabezado para la solicitud de cambios. +|`Edit pull request body`|Abre el cuerpo principal de la solicitud de cambios, listo para su edición. +|`Edit pull request title`|Abre el título de la solicitud de cambios, listo para su edición. +|`Open in new codespace`|Crea y abre un codespace par ala rama de encabezado de la solicitud de cambios. Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)". +|`Subscribe`/`unsubscribe`|Decide recibir o no recibir notificaciones para los cambios a esta solicitud de cambios. Para más información, vea "[Acerca de las notificaciones](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)". +|`Update current branch`|Actualiza la rama de encabezado de la solicitud de cambios con los cambios a la rama base. Esto está disponible únicamente para las solicitudes de cambios que apuntan a la rama predeterminada del repositorio. Para más información, vea "[Acerca de las ramas](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches)".| diff --git a/translations/es-ES/content/get-started/using-github/keyboard-shortcuts.md b/translations/es-ES/content/get-started/using-github/keyboard-shortcuts.md index 416cf4f6d1..86dec80403 100644 --- a/translations/es-ES/content/get-started/using-github/keyboard-shortcuts.md +++ b/translations/es-ES/content/get-started/using-github/keyboard-shortcuts.md @@ -21,10 +21,11 @@ Typing ? on {% data variables.product.prodname_dotcom %} brings up a {% ifversion keyboard-shortcut-accessibility-setting %} You can disable character key shortcuts, while still allowing shortcuts that use modifier keys, in your accessibility settings. For more information, see "[Managing accessibility settings](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-accessibility-settings)."{% endif %} -Below is a list of some of the available keyboard shortcuts. {% ifversion command-palette %} The {% data variables.product.prodname_command_palette %} also gives you quick access to a wide range of actions, without the need to remember keyboard shortcuts. For more information, see "[{% data variables.product.prodname_command_palette %}](/get-started/using-github/github-command-palette)."{% endif %} +The following sections list some of the available keyboard shortcuts, organized by the pages where you can use them on {% data variables.location.product_location %}. + ## Site wide shortcuts | Keyboard shortcut | Description @@ -130,16 +131,14 @@ For more keyboard shortcuts, see the [CodeMirror documentation](https://codemirr |Shift and click | When creating an issue from a task list, open the new issue form in a new tab by holding Shift and clicking the {% octicon "issue-opened" aria-label="The issue opened icon" %} in the upper-right corner of the task. For more information, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)." |Command and click (Mac) or
Ctrl+Shift and click (Windows/Linux) | When creating an issue from a task list, open the new issue form in the new window by holding Command or Ctrl+Shift and clicking the {% octicon "issue-opened" aria-label="The issue opened icon" %} in the upper-right corner of the task. For more information, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)."{% endif %} -## Changes in pull requests +## "Files changed" tab in pull requests | Keyboard shortcut | Description |-----------|------------ -|C | Open the list of commits in the pull request -|T | Open the list of changed files in the pull request -|J | Move selection down in the list -|K | Move selection up in the list -|Command+Shift+Enter | Add a single comment on a pull request diff | -|Alt and click | Toggle between collapsing and expanding all outdated review comments in a pull request by holding down Alt and clicking **Show outdated** or **Hide outdated**.| +|C | Open the **Commits** dropdown menu to filter which commits are shown in the diffs +|T | Move your cursor to the "Filter changed files" field +|Command+Shift+Enter (Mac) or Ctrl+Shift+Enter (Windows/Linux) | Submit a review comment | +|Option and click (Mac) or Alt and click (Windows/Linux) | Toggle between collapsing and expanding all outdated or resolved review comments in a pull request (for example, by holding down Alt and clicking **Show outdated** or **Hide outdated**) | |Click, then Shift and click | Comment on multiple lines of a pull request by clicking a line number, holding Shift, then clicking another line number. For more information, see "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request)."| {% ifversion projects-v2 %} diff --git a/translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md b/translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md new file mode 100644 index 0000000000..2b4495efc3 --- /dev/null +++ b/translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md @@ -0,0 +1,81 @@ +--- +title: About task lists +intro: 'You can use task lists to break the work for an issue or pull request into smaller tasks, then track the full set of work to completion.' +redirect_from: + - /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/about-task-lists + - /articles/about-task-lists + - /github/managing-your-work-on-github/about-task-lists + - /issues/tracking-your-work-with-issues/creating-issues/about-task-lists + - /issues/tracking-your-work-with-issues/about-task-lists +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - Pull requests + - Issues +--- + +{% ifversion projects-v2-tasklists %} +{% note %} + +**Note:** For more information about the new iteration of Tasklists, which is currently in a private beta, see "[About Tasklists](/issues/tracking-your-work-with-issues/about-tasklists)." + +{% endnote %} +{% endif %} + +## About task lists + +A task list is a set of tasks that each render on a separate line with a clickable checkbox. You can select or deselect the checkboxes to mark the tasks as complete or incomplete. + +You can use Markdown to create a task list in any comment on {% data variables.product.product_name %}. {% ifversion fpt or ghec %}If you reference an issue, pull request, or discussion in a task list, the reference will unfurl to show the title and state.{% endif %} + +{% ifversion not fpt or ghec %} +You can view task list summary information in issue and pull request lists, when the task list is in the initial comment. +{% else %} + +## About issue task lists + +If you add a task list to the body of an issue, the list has added functionality. + +- To help you track your team's work on an issue, the progress of an issue's task list appears in various places on {% data variables.product.product_name %}, such as a repository's list of issues. +- If a task references another issue and someone closes that issue, the task's checkbox will automatically be marked as complete. +- If a task requires further tracking or discussion, you can convert the task to an issue by hovering over the task and clicking {% octicon "issue-opened" aria-label="The issue opened icon" %} in the upper-right corner of the task. To add more details before creating the issue, you can use keyboard shortcuts to open the new issue form. For more information, see "[Keyboard shortcuts](/github/getting-started-with-github/using-github/keyboard-shortcuts#issues-and-pull-requests)." +- Any issues referenced in the task list will specify that they are tracked in the referencing issue. + +![Rendered task list](/assets/images/help/writing/task-list-rendered.png) + +{% endif %} + +## Creating task lists + +{% data reusables.repositories.task-list-markdown %} + +{% tip %} + +**Tip:** You cannot create task list items within closed issues or issues with linked pull requests. + +{% endtip %} + +## Reordering tasks + +You can reorder the items in a task list by clicking to the left of a task's checkbox, dragging the task to a new location, and dropping the task. You can reorder tasks across different lists in the same comment, but you can not reorder tasks across different comments. + +{% ifversion fpt %} ![Reordered task list](/assets/images/help/writing/task-list-reordered.gif) +{% else %} ![Reordered task list](/assets/images/enterprise/writing/task-lists-reorder.gif) {% endif %} + +{% ifversion fpt %} + +## Navigating tracked issues + +Any issues that are referenced in a task list specify that they are tracked by the issue that contains the task list. To navigate to the tracking issue from the tracked issue, click on the tracking issue number in the **Tracked in** section next to the issue status. + +![Tracked in example](/assets/images/help/writing/task_list_tracked.png) + +{% endif %} + +## Further reading + +{% ifversion code-scanning-task-lists %} +* "[Tracking {% data variables.product.prodname_code_scanning %} alerts in issues using task lists](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists)"{% endif %} diff --git a/translations/es-ES/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md b/translations/es-ES/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md index b077b066d4..2d589523ff 100644 --- a/translations/es-ES/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md +++ b/translations/es-ES/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md @@ -10,12 +10,12 @@ type: tutorial topics: - Projects allowTitleToDifferFromFilename: true -ms.openlocfilehash: b1c04738a3c03d892b360c3b23def694d202ee0c -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 680d6cff10dfc063ebaef0ebc9f8f7d0c15ba2e7 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148109889' +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158945' --- Puede personalizar las vistas mediante filtros para los metadatos de elementos, como los usuarios asignados y las etiquetas aplicadas a incidencias, así como por los campos del proyecto. Puede combinar filtros y guardarlos como vistas. Para más información, vea "[Personalización de las vistas del proyecto](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)". @@ -25,6 +25,8 @@ El uso de varios filtros actuará como un filtro AND lógico. Por ejemplo, `labe Los mismos filtros están disponibles para los gráficos que se crean mediante conclusiones para {% data variables.product.prodname_projects_v2 %}, lo que te permite filtrar los datos usados para crear los gráficos. Para más información, vea "[Uso de conclusiones con proyectos](/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects)". +Al filtrar una vista y, luego, agregar un elemento, los metadatos filtrados se aplicarán al elemento agregado. Por ejemplo, si vas a filtrar por `status:"In progress"` y agregas un elemento, el nuevo elemento tendrá su estado establecido en "En curso". + ## Filtrar elementos Haz clic en el {% octicon "filter" aria-label="the filter icon" %} en la parte superior de la tabla para mostrar la barra de "Filtrar por palabra clave o por campo". Comienza a teclear el nombre de campo y valor por el cuál quieras filtrar. Conforme teclees, se mostrarán los posibles valores. diff --git a/translations/es-ES/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md b/translations/es-ES/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md index 2b8dd52bd8..dd8527a7f1 100644 --- a/translations/es-ES/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md +++ b/translations/es-ES/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md @@ -1,6 +1,6 @@ --- -title: 'About {% data variables.product.prodname_projects_v2 %}' -intro: '{% data variables.product.prodname_projects_v2 %} is an adaptable, flexible tool for planning and tracking work on {% data variables.product.company_short %}.' +title: 'Acerca de {% data variables.product.prodname_projects_v2 %}' +intro: '{% data variables.product.prodname_projects_v2 %} es una herramienta adaptable y flexible para la planificación y el seguimiento del trabajo en {% data variables.product.company_short %}.' allowTitleToDifferFromFilename: true miniTocMaxHeadingLevel: 3 versions: @@ -10,52 +10,57 @@ redirect_from: type: overview topics: - Projects +ms.openlocfilehash: 768234aa5e6c9cfbca6a6144a80ac2868f3316ce +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158865' --- +## Acerca de {% data variables.product.prodname_projects_v2 %} -## About {% data variables.product.prodname_projects_v2 %} +Un proyecto es una hoja de cálculo adaptable que se integra con las incidencias y solicitudes de incorporación de cambios en {% data variables.product.company_short %} para ayudarte a planear y realizar el seguimiento del trabajo de forma eficaz. Puedes crear y personalizar varias vistas mediante el filtrado, la ordenación y la agrupación de las incidencias y solicitudes de incorporación de cambios, la adición de campos personalizados para realizar el seguimiento de metadatos específicos del equipo y visualizar el trabajo con gráficos configurables. En lugar de aplicar una metodología específica, un proyecto proporciona características flexibles que puedes personalizar en función de las necesidades y los procesos del equipo. -A project is an adaptable spreadsheet that integrates with your issues and pull requests on {% data variables.product.company_short %} to help you plan and track your work effectively. You can create and customize multiple views by filtering, sorting, grouping your issues and pull requests, adding custom fields to track metadata specific to your team, and visualize work with configurable charts. Rather than enforcing a specific methodology, a project provides flexible features you can customize to your team’s needs and processes. +### Mantenerse actualizado -### Staying up-to-date +Los proyectos se crean a partir de las incidencias y las solicitudes de incorporación de cambios que agregas, lo que crea referencias directas entre el proyecto y el trabajo. La información se sincroniza automáticamente con el proyecto a medida que realizas cambios, y se actualizan las vistas y los gráficos. Esta integración es bidireccional, por lo que, cuando cambies la información sobre una solicitud de incorporación de cambios o incidencia del proyecto, la solicitud de incorporación de cambios o la incidencia reflejará la información. Por ejemplo, si cambias un usuario asignado en el proyecto, ese cambio se muestra en la incidencia. Puedes ampliar aún más esta integración, agrupar el proyecto por usuario asignado y realizar cambios en la asignación de incidencias si las arrastras a los distintos grupos. -Your projects are built from the issues and pull requests you add, creating direct references between your project and your work. Information is synced automatically to your project as you make changes, updating your views and charts. This integration works both ways, so that when you change information about a pull request or issue in your project, the pull request or issue reflects that information. For example, change an assignee in your project and that change is shown in your issue. You can take this integration even further, group your project by assignee, and make changes to issue assignment by dragging issues into the different groups. +### Adición de metadatos a los elementos -### Adding metadata to your items +Puedes usar campos personalizados para agregar metadatos a incidencias, solicitudes de incorporación de cambios y borradores de incidencias, y crear una vista más completa de los atributos de los elementos. No estás limitado a los metadatos integrados (usuarios asignados, hitos, etiquetas, etc.) que existen actualmente para las incidencias y las solicitudes de incorporación de cambios. Por ejemplo, puedes agregar los siguientes metadatos como campos personalizados: -You can use custom fields to add metadata to your issues, pull requests, and draft issues and build a richer view of item attributes. You’re not limited to the built-in metadata (assignee, milestone, labels, etc.) that currently exists for issues and pull requests. For example, you can add the following metadata as custom fields: - -- A date field to track target ship dates. -- A number field to track the complexity of a task. -- A single select field to track whether a task is Low, Medium, or High priority. -- A text field to add a quick note. -- An iteration field to plan work week-by-week, including support for breaks. +- Campo de fecha para realizar un seguimiento de las fechas de envío de destino. +- Campo numérico para realizar un seguimiento de la complejidad de una tarea. +- Un único campo de selección para realizar un seguimiento de si una tarea es baja, media o alta prioridad. +- Un campo de texto para agregar una nota rápida. +- Un campo de iteración para planear el trabajo semana a semana, incluida la compatibilidad con interrupciones. {% ifversion projects-v2-tasklists %} -### Exploring the relationships between issues +### Exploración de las relaciones entre incidencias {% data reusables.projects.tasklists-release-stage %} -You can use Tasklists to build hierarchies of issues, dividing your issues into smaller subtasks, and creating new relationships between your issues. For more information, see "[About Tasklists](/issues/tracking-your-work-with-issues/about-tasklists)." +Puedes usar listas de tareas para crear jerarquías de incidencias, dividir las incidencias en subtareas más pequeñas y crear nuevas relaciones entre las incidencias. Para obtener más información, consulta "[Acerca de las listas de tareas](/issues/tracking-your-work-with-issues/about-tasklists)". -These relationships are displayed on the issue, as well as the Tracked-by and Tracks fields in your projects. You can filter by issues which are tracked by another issue, and you can also group your table views by the Tracked-by field to show all parent issues with a list of their subtasks. +Estas relaciones se muestran en la incidencia, así como los campos Seguido por y Siguiendo de los proyectos. Puedes filtrar por incidencias cuyo seguimiento realiza otra incidencia y también puedes agrupar las vistas de tabla por el campo Seguido por para mostrar todas las incidencias primarias con una lista de sus subtareas. {% endif %} -### Viewing your project from different perspectives +### Visualizar tu proyecto desde perspectivas diferentes -Quickly answer your most pressing questions by tailoring your project view to give you the information you need. You can save these views, allowing you to quickly return to them as needed and make them available to your team. Views not only let you scope down the items listed but also offer two different layout options. +Responde rápidamente a las preguntas más urgentes mediante la adaptación de la vista del proyecto para que proporcione la información que necesitas. Puedes guardar estas vistas, lo que te permite volver rápidamente a ellas según sea necesario y ponerlas a disposición del equipo. Las vistas no solo permiten limitar el ámbito de los elementos enumerados, sino que también ofrecen dos opciones de diseño diferentes. -You can view your project as a high density table layout: +Puedes ver tu proyecto como un diseño de tabla de densidad alta: -![Project table](/assets/images/help/issues/projects_table.png) +![Tabla de proyectos](/assets/images/help/issues/projects_table.png) -Or as a board: +O como un tablero: -![Project board](/assets/images/help/issues/projects_board.png) +![Tablero de proyectos](/assets/images/help/issues/projects_board.png) -To help you focus on specific aspects of your project, you can group, sort, or filter items: +Para ayudar a que te enfoques en aspectos específicos de tu proyecto, puedes agrupar, clasificar o filtrar elementos: -![Project view](/assets/images/help/issues/project_view.png) +![Vista de proyecto](/assets/images/help/issues/project_view.png) -For more information, see "[Customizing a view](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)." +Para más información, consulta "[Personalización de una vista](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)". diff --git a/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields.md b/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields.md new file mode 100644 index 0000000000..79fa72ac02 --- /dev/null +++ b/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields.md @@ -0,0 +1,56 @@ +--- +title: Acerca de los campos Sigue a y Seguido por +shortTitle: About Tracks and Tracked-by fields +intro: Puedes ver las subtareas de las incidencias de los proyectos. +miniTocMaxHeadingLevel: 3 +versions: + feature: projects-v2-tasklists +type: tutorial +topics: + - Projects +ms.openlocfilehash: 74cd26d20882a00ac8c7ac1d109cc6810286cec6 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160036' +--- +{% data reusables.projects.tasklists-release-stage %} + +Puedes habilitar los campos Sigue a y Seguido por en los proyectos para ver las relaciones entre las incidencias a medida que agregas subtareas en listas de tareas. Para obtener más información sobre cómo crear jerarquías de incidencias en listas de tareas, consulta "[Acerca de las listas de tareas](/issues/tracking-your-work-with-issues/about-tasklists)". + +El campo Seguido por se puede usar para agrupar elementos, creando una vista que muestre claramente las subtareas de cada incidencia y el trabajo necesario para completarlas. Para obtener más información, consulta "[Agrupar por valores de campo en el diseño de tabla](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view#grouping-by-field-values-in-table-layout)". + +También puedes filtrar por el campo Seguido por para mostrar solo los elementos de los que se realiza un seguimiento por incidencias específicas. Empieza escribiendo "tracked-by" y selecciona una incidencia de la lista o, si conoces el repositorio y el número de incidencia, puedes escribir el filtro siguiente en su totalidad. + +``` +tracked-by:"/#" +``` + +Para usar el filtro, reemplaza `` por el propietario del repositorio, `` por el nombre del repositorio y `` por el número de incidencia. Para obtener más información, consulta "[Filtrar proyectos](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects)". + +### Habilitación del campo Seguido por + +Puedes habilitar el campo Seguido por para ver qué incidencias están realizando un seguimiento de un elemento en el proyecto. + +1. En la vista de tabla, en el encabezado de campo del extremo derecho, haz clic en {% octicon "plus" aria-label="the plus icon" %}. + + ![Captura de pantalla en la que se muestra el botón Nuevo campo](/assets/images/help/projects-v2/new-field-button.png) + +1. En "Campos ocultos", haz clic en **Seguido por**. + + ![Captura de pantalla en la que se muestra el menú del campo](/assets/images/help/projects-v2/select-tracked-by-field.png) + + +### Habilitación del campo Sigue a + +Puede habilitar el campo Sigue a para ver a qué otras incidencias realiza un seguimiento un elemento del proyecto. + +1. En la vista de tabla, en el encabezado de campo del extremo derecho, haz clic en {% octicon "plus" aria-label="the plus icon" %}. + + ![Captura de pantalla en la que se muestra el botón Nuevo campo](/assets/images/help/projects-v2/new-field-button.png) + +1. En "Campos ocultos", haz clic en **Sigue a**. + + ![Captura de pantalla en la que se muestra el menú del campo](/assets/images/help/projects-v2/select-tracks-field.png) + diff --git a/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md b/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md new file mode 100644 index 0000000000..ec92904ec1 --- /dev/null +++ b/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md @@ -0,0 +1,25 @@ +--- +title: Eliminación de campos personalizados +intro: 'Descubre cómo eliminar un campo personalizado de tu {% data variables.projects.project_v2 %}.' +miniTocMaxHeadingLevel: 3 +versions: + feature: projects-v2 +type: tutorial +topics: + - Projects +redirect_from: + - /issues/planning-and-tracking-with-projects/understanding-field-types/deleting-fields +ms.openlocfilehash: b4a0c070b92b3b28c684c9e3b2f7388b9d7b517a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159828' +--- +{% data reusables.projects.project-settings %} +1. Haz clic en el nombre del campo personalizado que quieras eliminar. + ![Captura de pantalla en la que se muestra un campo de iteración](/assets/images/help/projects-v2/select-single-select.png) +1. Junto al nombre del campo, haz clic en {% octicon "kebab-horizontal" aria-label="The menu icon" %} para abrir el menú. + ![Captura de pantalla en la que se muestra el nombre del campo](/assets/images/help/projects-v2/field-options.png) +1. Haz clic en **Eliminar campo**. + ![Captura de pantalla en la que se muestra el nombre del campo](/assets/images/help/projects-v2/delete-field.png) diff --git a/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/index.md b/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/index.md new file mode 100644 index 0000000000..b08340088f --- /dev/null +++ b/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/index.md @@ -0,0 +1,28 @@ +--- +title: Descripción de los campos +shortTitle: Understanding fields +intro: 'Obtén información sobre los diferentes campos y los tipos de campo personalizados, cómo agregar campos al proyecto y cómo administrar los campos personalizados.' +versions: + feature: projects-v2 +topics: + - Issues + - Projects +children: + - /about-text-and-number-fields + - /about-date-fields + - /about-single-select-fields + - /about-iteration-fields + - /about-tracks-and-tracked-by-fields + - /renaming-custom-fields + - /deleting-custom-fields +allowTitleToDifferFromFilename: true +redirect_from: + - /issues/planning-and-tracking-with-projects/understanding-field-types +ms.openlocfilehash: ed15d18adff2e51c6f5d9ce41f4af701f71354ed +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160035' +--- + diff --git a/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md b/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md new file mode 100644 index 0000000000..1d45038a8e --- /dev/null +++ b/translations/es-ES/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md @@ -0,0 +1,24 @@ +--- +title: Cambio de nombre de los de campos personalizados +intro: 'Obtén información sobre cómo cambiar el nombre de los campos personalizados existentes de tus instancias de {% data variables.projects.project_v2 %}.' +miniTocMaxHeadingLevel: 3 +versions: + feature: projects-v2 +type: tutorial +topics: + - Projects +redirect_from: + - /issues/planning-and-tracking-with-projects/understanding-field-types/renaming-fields +ms.openlocfilehash: 45520fab579af228685443e0aa9ab563289325f1 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160329' +--- +{% data reusables.projects.project-settings %} +1. Haz clic en el nombre del campo personalizado que quieras cambiar de nombre. + ![Captura de pantalla en la que se muestra un campo de iteración](/assets/images/help/projects-v2/select-single-select.png) +1. En "Nombre de campo", escribe el nuevo nombre para el campo. + ![Captura de pantalla en la que se muestra el nombre del campo](/assets/images/help/projects-v2/field-rename.png) +1. Para guardar los cambios, presiona Intro. diff --git a/translations/es-ES/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md b/translations/es-ES/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md index 942f464816..c1d1721544 100644 --- a/translations/es-ES/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md +++ b/translations/es-ES/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md @@ -11,12 +11,12 @@ product: '{% data reusables.gated-features.historical-insights-for-projects %}' topics: - Projects allowTitleToDifferFromFilename: true -ms.openlocfilehash: 89f93ace53547fccd69ffb7e6d7b666a6cb48991 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 809d8492bb1ec7c8cd4eb051b1eaefb00d29097e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148109912' +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158577' --- {% ifversion fpt %} @@ -30,6 +30,8 @@ ms.locfileid: '148109912' Puedes usar conclusiones {% data variables.product.prodname_projects_v2 %} a fin de ver, crear y personalizar gráficos que usan como datos de origen los elementos agregados al proyecto. Puedes aplicar filtros al gráfico predeterminado y también crear tus propios gráficos. Al crear un gráfico, se establecen los filtros, el tipo de gráfico y la información mostrada, y el gráfico está disponible para cualquiera que pueda ver el proyecto. Puedes generar dos tipos de gráficos: gráficos actuales y gráficos históricos. + Con las conclusiones, se realiza un seguimiento de los elementos que has archivado o eliminado. + ### Acerca de los gráficos actuales Puedes crear gráficos actuales para visualizar los elementos del proyecto. Por ejemplo, puedes crear gráficos para mostrar cuántos elementos se asignan a cada individuo o cuántas incidencias se asignan a cada iteración futura. diff --git a/translations/es-ES/content/issues/tracking-your-work-with-issues/about-tasklists.md b/translations/es-ES/content/issues/tracking-your-work-with-issues/about-tasklists.md new file mode 100644 index 0000000000..cbc407e153 --- /dev/null +++ b/translations/es-ES/content/issues/tracking-your-work-with-issues/about-tasklists.md @@ -0,0 +1,146 @@ +--- +title: Acerca de las listas de tareas +intro: Puedes usar listas de tareas para dividir las propuestas en subtareas más pequeñas. +versions: + feature: projects-v2-tasklists +miniTocMaxHeadingLevel: 3 +redirect_from: + - /early-access/issues/about-tasklists +ms.openlocfilehash: e35065ae4de634bb7a2da815e0a860c7c0b92234 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160313' +--- +{% data reusables.projects.tasklists-release-stage %} + +## Acerca de las listas de tareas + +Las listas de tareas agregan compatibilidad con jerarquías de propuestas en {% data variables.product.product_name %}, lo que te ayuda a realizar un seguimiento de las propuestas, dividirlas en subtareas más pequeñas y crear nuevas relaciones entre ellas. + +Las listas de tareas se basan en la iteración anterior de las [listas de tareas beta](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists), y conservan la capacidad de convertir elementos en propuestas, mostrar el progreso de una lista de tareas y crear una relación de "Sigue/Seguido por" entre las propuestas. + +Las propuestas que agregues a las listas de tareas se rellenarán automáticamente para mostrar sus asignados y las etiquetas aplicadas. + +![Imagen que muestra Listas de tareas en acción](/assets/images/help/issues/tasklist-hero.png) + +### Acerca de la integración con {% data variables.projects.projects_v2 %} + + El panel lateral del proyecto muestra el lugar de una propuesta en la jerarquía en un menú de ruta de navegación, lo que te permite navegar por las propuestas incluidas en las Listas de tareas. También puedes agregar los campos Sigue y Seguido por a las vistas del proyecto para ver rápidamente las relaciones entre tus propuestas. Para obtener información, consulta "[Acerca de los campos Sigue y Seguido por ](/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields)". + +## Creación de listas de tareas + +Para crear una lista de tareas, puedes usar el botón "Agregar lista de tareas" o editar el markdown de la propuesta. + +### Creación de una lista de tareas mediante el botón "Agregar lista de tareas" + +Haz clic en el botón **Agregar lista de tareas de {% octicon "checklist" aria-label="The checklist icon" %}** en la parte inferior de cualquier descripción de la propuesta que puedas editar para crear una lista de tareas. + +![Captura de pantalla en la que se muestra el botón "Agregar lista de tareas".](/assets/images/help/issues/tasklist-add-tasklist-button.png) + +### Creación de una lista de tareas mediante Markdown + +Puedes usar Markdown en una descripción de una propuesta para crear una lista de tareas. Crea un bloque de código cercado e incluye `[tasklist]` junto a las comillas inversas de apertura. Antepón `- [ ]` a cada elemento e incluye vínculos a otras propuestas o texto. Opcionalmente, puedes incluir un título como encabezado de Markdown en la parte superior de la lista. + +```` +```[tasklist] +### Tasks +- [ ] https://github.com/octo-org/octo-repo/issues/45 +- [ ] Draft issue title +``` +```` + +El markdown se representará mediante {% data variables.product.product_name %} como lista de tareas. Después, puedes realizar cambios y agregar y redactar propuestas mediante la interfaz de usuario. Si editas la descripción de la propuesta, podrás modificar el markdown directamente o copiarlo para duplicar la lista de tareas en otras propuestas. + + + +## Adición de propuestas a una lista de tareas + +1. En la parte inferior de la lista de tareas, haz clic en **Agregar elemento a tareas**. + + ![Captura de pantalla que muestra el botón "Agregar elemento a tareas"](/assets/images/help/issues/add-new-tasklist-button.png) + +1. Selecciona la propuesta que se va a agregar a la lista de tareas. + + * Para agregar una propuesta actualizada recientemente desde el repositorio, haz clic en la propuesta en la lista desplegable o usa las teclas de dirección para seleccionarla y, después, presiona Entrar. + + ![Captura de pantalla que muestra propuestas recientes](/assets/images/help/issues/select-recent-issue.png) + + * Para buscar una propuesta en el repositorio, empieza a escribir el título de una propuesta o su número y haz clic en el resultado, o usa las teclas de dirección para seleccionarla y presiona Entrar. + + ![Captura de pantalla en la que se muestra la búsqueda de una propuesta](/assets/images/help/issues/search-for-issue.png) + + * Para agregar una propuesta directamente mediante su dirección URL, pega la dirección URL de la propuesta y presiona Entrar. + + ![Captura de pantalla que muestra una dirección URL de la propuesta pegada](/assets/images/help/issues/paste-issue-url.png) + + +## Creación de borradores de propuestas en una lista de tareas + +Los borradores de propuestas son útiles para capturar rápidamente ideas que más adelante puedes convertir en propuestas. A diferencia de las propuestas y las solicitudes de incorporación de cambios a las que se hace referencia desde los repositorios, los borradores de propuestas solo existen en el proyecto. + +1. En la parte inferior de la lista de tareas, haz clic en **Agregar elemento a tareas**. + + ![Captura de pantalla que muestra el botón "Agregar elemento a tareas"](/assets/images/help/issues/add-new-tasklist-button.png) + +1. Escribe el título del borrador de propuesta y presiona Entrar. + + ![Captura de pantalla que muestra un título del borrador de propuesta](/assets/images/help/issues/add-draft-issue-to-tasklist.png) + + +## Conversión de borradores de propuestas a propuestas en una lista de tareas + +Puedes convertir los borradores de propuestas en propuestas. Las propuestas se crean en el mismo repositorio que la propuesta primaria de la lista de tareas. + +1. Junto al borrador de propuesta que quieras convertir, haz clic en el {% octicon "kebab-horizontal" aria-label="The kebab menu icon" %}. + + ![Captura de pantalla en la que se muestra el icono de menú](/assets/images/help/issues/tasklist-item-kebab.png) + +1. Haz clic en **Convertir en propuesta**. + + ![Captura de pantalla en la que se muestra la opción "Convertir en propuesta"](/assets/images/help/issues/tasklist-convert-to-issue.png) + + +## Eliminación de una propuesta o un borrador de propuesta de una lista de tareas + +Puedes quitar propuestas y borradores de propuesta de la lista de tareas. Las propuestas quitadas de una lista de tareas no se quitan del repositorio. + +1. Junto al borrador de propuesta que quieras quitar, haz clic en el {% octicon "kebab-horizontal" aria-label="The kebab menu icon" %}. + + ![Captura de pantalla en la que se muestra el icono de menú](/assets/images/help/issues/tasklist-item-kebab.png) + +1. En el menú, haz clic en **Quitar**. + + ![Captura de pantalla que muestra la opción "Quitar"](/assets/images/help/issues/tasklist-remove.png) + +## Cambio del título de una lista de tareas + +Al crear una nueva lista de tareas, el título predeterminado es "Tareas". Para modificarlo, edita el markdown de la propuesta. + +1. En la parte superior derecha del cuerpo de la propuesta, haz clic en el {% octicon "kebab-horizontal" aria-label="The kebab menu icon" %}. + + ![Captura de pantalla que muestra la ubicación del icono del menú](/assets/images/help/issues/comment-menu.png) + +1. En el menú, haz clic en **Editar**. + + ![Captura de pantalla que muestra la opción de edición](/assets/images/help/issues/comment-menu-edit.png) + +1. Modifica el encabezado del bloque de código cercado al nuevo título. Por ejemplo, cambie `### Tasks` a `### My new title`. + + ![Captura de pantalla que muestra la opción de edición](/assets/images/help/issues/edit-tasklist-title.png) + +1. Haga clic en **Update comment** (Actualizar comentario). + +## Copiado de una lista de tareas + +Al copiar la lista de tareas con la opción "Copiar markdown", {% data variables.product.product_name %} copia el markdown en el Portapapeles e incluye el nombre de la propuesta para que puedas pegar la lista de tareas fuera de GitHub sin perder contexto. + +1. En la parte superior derecha de la lista de tareas, haz clic en el {% octicon "kebab-horizontal" aria-label="The kebab menu icon" %}. + + ![Captura de pantalla en la que se muestra el icono de menú](/assets/images/help/issues/tasklist-kebab.png) + +1. En el menú, haz clic en **Copiar markdown**. + + ![Captura de pantalla que muestra la opción "Copiar markdown"](/assets/images/help/issues/tasklist-copy-markdown.png) + diff --git a/translations/es-ES/content/organizations/collaborating-with-groups-in-organizations/about-organizations.md b/translations/es-ES/content/organizations/collaborating-with-groups-in-organizations/about-organizations.md index 52fc0b96ca..c7caa6ec8e 100644 --- a/translations/es-ES/content/organizations/collaborating-with-groups-in-organizations/about-organizations.md +++ b/translations/es-ES/content/organizations/collaborating-with-groups-in-organizations/about-organizations.md @@ -1,6 +1,6 @@ --- -title: About organizations -intro: 'Organizations are shared accounts where businesses and open-source projects can collaborate across many projects at once, with sophisticated security and administrative features.' +title: Acerca de las organizaciones +intro: 'Las organizaciones son cuentas compartidas en las que las empresas y los proyectos de código abierto pueden colaborar en muchos proyectos a la vez, con características sofisticadas de seguridad y administrativas.' redirect_from: - /articles/about-organizations - /github/setting-up-and-managing-organizations-and-teams/about-organizations @@ -12,48 +12,48 @@ versions: topics: - Organizations - Teams +ms.openlocfilehash: 0269554568c8781706a8d79600f5b6191d0b9598 +ms.sourcegitcommit: 1529de77bfcbe45519131b5f5fb3ab319758c2d2 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148164335' --- +## Acerca de las organizaciones -## About organizations +{% data reusables.organizations.about-organizations %} Para obtener más información sobre los tipos de cuenta, vea "[Tipos de cuentas de {% data variables.product.prodname_dotcom %}](/get-started/learning-about-github/types-of-github-accounts)". -{% data reusables.organizations.about-organizations %} For more information about account types, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/get-started/learning-about-github/types-of-github-accounts)." +Puedes invitar a un número ilimitado de personas a unirse a tu organización y, después, proporcionar a estos miembros una variedad de roles que conceden distintos niveles de acceso a la organización y sus datos. Para más información, vea "[Roles en una organización](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)". -You can invite an unlimited number of people to join your organization, then give these organization members a variety of roles that grant different levels of access to the organization and its data. For more information, see "[Roles in an organization](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)." +Además de administrar el acceso a la propia organización, puedes administrar por separado el acceso a los repositorios, paneles de proyecto y aplicaciones de la organización. Para obtener más información, consulta "[Roles de repositorio para una organización](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)", "[Permisos de panel de proyecto para una organización](/organizations/managing-access-to-your-organizations-project-boards/project-board-permissions-for-an-organization)" y "[Administración del acceso a las aplicaciones de la organización](/organizations/managing-access-to-your-organizations-apps)". -In addition to managing access to the organization itself, you can separately manage access to your organization's repositories, project boards, and apps. For more information, see "[Repository roles for an organization](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)", "[Project board permissions for an organization](/organizations/managing-access-to-your-organizations-project-boards/project-board-permissions-for-an-organization)", and "[Managing access to your organization's apps](/organizations/managing-access-to-your-organizations-apps)." +Para simplificar la administración de acceso y mejorar la colaboración, puedes crear equipos anidados que reflejen la estructura del grupo, con permisos de acceso en cascada y menciones. Para más información, vea "[Acerca de los equipos](/organizations/organizing-members-into-teams/about-teams)". -To simplify access management and enhance collaboration, you can create nested teams that reflect your group's structure, with cascading access permissions and mentions. For more information, see "[About teams](/organizations/organizing-members-into-teams/about-teams)." +Puedes configurar la organización para satisfacer las necesidades únicas del grupo administrando la configuración, como restringir los tipos de repositorios que los miembros pueden crear. Para obtener más información, consulta "[Administración de la configuración de una organización](/organizations/managing-organization-settings)". -You can configure the organization to meet the unique needs of your group by managing settings, such as restricting the types of repositories that members can create. For more information, see "[Managing organization settings](/organizations/managing-organization-settings)." +Para proteger la seguridad de la organización, puedes aplicar los requisitos de seguridad y revisar el registro de auditoría de esta. Para obtener más información, consulte "[Protección de la organización](/organizations/keeping-your-organization-secure)". -To harden your organization's security, you can enforce security requirements and review the organization's audit log. For more information, see "[Keeping your organization secure](/organizations/keeping-your-organization-secure)." - -To learn how to use organizations most effectively, see "[Best practices for organizations](/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations)." +Para obtener información sobre cómo usar organizaciones de forma más eficaz, consulta "[Procedimientos recomendados para organizaciones](/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations)". {% ifversion fpt or ghec %} -## About feature availability +## Acerca de la disponibilidad de características -{% data reusables.organizations.organization-plans %} -{% endif %} +{% data reusables.organizations.organization-plans %} {% endif %} -## Organizations and enterprise accounts +## Organizaciones y cuentas de empresa -{% ifversion fpt %} -Enterprise accounts are a feature of {% data variables.product.prodname_ghe_cloud %} that allow owners to centrally manage policy and billing for multiple organizations. For more information, see [the {% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/organizations/collaborating-with-groups-in-organizations/about-organizations). -{% else %} -{% ifversion ghec %}For organizations that belong to an enterprise account, billing is managed at the enterprise account level, and billing settings are not available at the organization level.{% endif %} Enterprise owners can set policy for all organizations in the enterprise account or allow organization owners to set the policy at the organization level. Organization owners cannot change settings enforced for your organization at the enterprise account level. If you have questions about a policy or setting for your organization, contact the owner of your enterprise account. +{% ifversion fpt %} Las cuentas de empresa son una característica de {% data variables.product.prodname_ghe_cloud %} que permiten a los propietarios administrar de forma centralizada la directiva y la facturación de varias organizaciones. Para obtener más información, vea la [documentación de {% data variables.product.prodname_ghe_cloud %}](/enterprise-cloud@latest/organizations/collaborating-with-groups-in-organizations/about-organizations). +{% else %} {% ifversion ghec %}En el caso de las organizaciones que pertenecen a una cuenta de empresa, la facturación se administra en el nivel de cuenta de empresa y la configuración de facturación no está disponible en el nivel de organización.{% endif %} Los propietarios de empresas pueden establecer la directiva para todas las organizaciones de la cuenta de empresa o permitir que los propietarios de la organización establezcan la directiva en el nivel de organización. Los propietarios de la organización no pueden cambiar los parámetros implementados para tu organización en el nivel de cuenta de empresa. Si tienes consultas sobre una política o la configuración para tu organización, comunícate con el propietario de tu cuenta de empresa. -{% ifversion ghec %} -{% data reusables.enterprise.create-an-enterprise-account %} For more information, see "[Creating an enterprise account](/admin/overview/creating-an-enterprise-account)." +{% ifversion ghec %} {% data reusables.enterprise.create-an-enterprise-account %} Para obtener más información, vea "[Crear una cuenta de empresa](/admin/overview/creating-an-enterprise-account)". {% data reusables.enterprise-accounts.invite-organization %} -{% endif %} -{% endif %} +{% endif %} {% endif %} {% ifversion fpt or ghec %} -## Terms of service and data protection for organizations +## Términos de servicio y protección de datos para organizaciones -An entity, such as a company, non-profit, or group, can agree to the Standard Terms of Service or the Corporate Terms of Service for their organization. For more information, see "[Upgrading to the Corporate Terms of Service](/articles/upgrading-to-the-corporate-terms-of-service)." +Una entidad, como una empresa, una organización sin fines de lucro o un grupo, puede aceptar los Términos de servicio estándar o los Términos de servicio corporativos para su organización. Para obtener más información, vea "[Actualizar a los términos del servicio corporativos](/articles/upgrading-to-the-corporate-terms-of-service)". {% endif %} diff --git a/translations/es-ES/content/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations.md b/translations/es-ES/content/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations.md new file mode 100644 index 0000000000..94a830aea1 --- /dev/null +++ b/translations/es-ES/content/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations.md @@ -0,0 +1,38 @@ +--- +title: Procedimientos recomendados para organizaciones +shortTitle: Best practices +intro: 'Aprende los procedimientos recomendados por {% data variables.product.prodname_dotcom %} para tu organización.' +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - Organizations + - Teams +ms.openlocfilehash: 015c74d7a69a1feb5c8ff9467a4219753f2cb5eb +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163462' +--- +## Asignación de varios propietarios + +{% data reusables.organizations.org-ownership-recommendation %} Para obtener más información, vea "[Mantener la continuidad de la propiedad para su organización](/organizations/managing-peoples-access-to-your-organization-with-roles/maintaining-ownership-continuity-for-your-organization)". + +## Uso de equipos + +Se recomienda usar equipos para facilitar la colaboración en la organización. Para más información, vea "[Acerca de los equipos](/organizations/organizing-members-into-teams/about-teams)". + +{% ifversion ghec %} Se recomienda encarecidamente administrar la pertenencia al equipo a través del proveedor de identidades (IdP). Para más información, vea "[Administración de la sincronización de equipos para la organización](/organizations/managing-saml-single-sign-on-for-your-organization/managing-team-synchronization-for-your-organization)". + +{% data reusables.enterprise-accounts.emu-scim-note %} {% endif %} + +Se recomienda mantener visibles los equipos siempre que sea posible y reservar equipos secretos para situaciones confidenciales. Para más información, vea "[Cambio de la visibilidad del equipo](/organizations/organizing-members-into-teams/changing-team-visibility)". + +{% ifversion ghec or ghes or ghae %} +## Uso de la información general sobre seguridad + +{% data reusables.security-overview.about-the-security-overview %} Para más información, consulta "[Acerca de la información general de seguridad](/code-security/security-overview/about-the-security-overview)". +{% endif %} diff --git a/translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md b/translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md index a789fa3577..859f0341a9 100644 --- a/translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md +++ b/translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md @@ -1,6 +1,6 @@ --- -title: Administrar las direcciones IP permitidas en tu organización -intro: Puedes restringir el acceso a los activos privados de tu organización si configuras una lista de direcciones IP que se pueden conectar a ella. +title: Managing allowed IP addresses for your organization +intro: You can restrict access to your organization's private assets by configuring a list of IP addresses that are allowed to connect. redirect_from: - /github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization - /organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization @@ -12,82 +12,100 @@ topics: - Teams shortTitle: Manage allowed IP addresses permissions: Organization owners can manage allowed IP addresses for an organization. -ms.openlocfilehash: 5d0a9bbc9b2207e088e2051025a8844e7cf0dbec -ms.sourcegitcommit: 80842b4e4c500daa051eff0ccd7cde91c2d4bb36 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/12/2022 -ms.locfileid: '147888094' --- -## Acerca de las direcciones IP permitidas -Puedes restringir el acceso a los recursos privados de la organización configurando un listado de direcciones IP específicas permitidas. {% data reusables.identity-and-permissions.ip-allow-lists-example-and-restrictions %} +## About allowed IP addresses -{% ifversion ghec %} {% note %} +You can restrict access to private organization assets by configuring an allow list for specific IP addresses. {% data reusables.identity-and-permissions.ip-allow-lists-example-and-restrictions %} -**Nota**: Solo las organizaciones que usan {% data variables.product.prodname_ghe_cloud %} pueden usar listas de direcciones IP permitidas. {% data reusables.enterprise.link-to-ghec-trial %} +{% ifversion ghec %} +{% note %} -{% endnote %} {% endif %} +**Note:** Only organizations that use {% data variables.product.prodname_ghe_cloud %} can use IP allow lists. {% data reusables.enterprise.link-to-ghec-trial %} + +{% endnote %} +{% endif %} {% data reusables.identity-and-permissions.ip-allow-lists-cidr-notation %} {% data reusables.identity-and-permissions.ip-allow-lists-enable %} -Si configuras una lista de direcciones permitidas, también puedes elegir agregar automáticamente a ella cualquier dirección IP que hayas configurado para las {% data variables.product.prodname_github_apps %} que instales en tu organización. El creador de una {% data variables.product.prodname_github_app %} puede configurar una lista de direcciones permitidas para su aplicación, las cuales especifiquen las direcciones IP en las cuales se ejecuta esta. Al heredar la lista de direcciones permitidas en la tuya, estás evitando las solicitudes de conexión de la aplicación que se está rehusando. Para obtener más información, vea "[Habilitación del acceso por {% data variables.product.prodname_github_apps %}](#allowing-access-by-github-apps)". +If you set up an allow list you can also choose to automatically add to your allow list any IP addresses configured for {% data variables.product.prodname_github_apps %} that you install in your organization. The creator of a {% data variables.product.prodname_github_app %} can configure an allow list for their application, specifying the IP addresses at which the application runs. By inheriting their allow list into yours, you avoid connection requests from the application being refused. For more information, see "[Allowing access by {% data variables.product.prodname_github_apps %}](#allowing-access-by-github-apps)." -También puedes configurar las direcciones IP permitidas para las organizaciones en una cuenta empresarial. Para más información, vea "[Aplicación de directivas de configuración de seguridad en la empresa](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-allowed-ip-addresses-for-organizations-in-your-enterprise)". +You can also configure allowed IP addresses for the organizations in an enterprise account. For more information, see "[Enforcing policies for security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-allowed-ip-addresses-for-organizations-in-your-enterprise)." -## Agregar una dirección IP permitida +## Adding an allowed IP address {% data reusables.identity-and-permissions.about-adding-ip-allow-list-entries %} {% data reusables.identity-and-permissions.ipv6-allow-lists %} -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} {% data reusables.identity-and-permissions.ip-allow-lists-add-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-add-description %} {% data reusables.identity-and-permissions.ip-allow-lists-add-entry %} {% data reusables.identity-and-permissions.check-ip-address %} +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +{% data reusables.identity-and-permissions.ip-allow-lists-add-ip %} +{% data reusables.identity-and-permissions.ip-allow-lists-add-description %} +{% data reusables.identity-and-permissions.ip-allow-lists-add-entry %} +{% data reusables.identity-and-permissions.check-ip-address %} -## Habilitar direcciones IP permitidas +## Enabling allowed IP addresses {% data reusables.identity-and-permissions.about-enabling-allowed-ip-addresses %} -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} -1. En "IP allow list" (Lista de direcciones IP permitidas), seleccione **Enable IP allow list** (Habilitar lista de direcciones IP permitidas). - ![Casilla para permitir direcciones IP](/assets/images/help/security/enable-ip-allowlist-organization-checkbox.png) -1. Haga clic en **Save**(Guardar). +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +1. Under "IP allow list", select **Enable IP allow list**. + ![Checkbox to allow IP addresses](/assets/images/help/security/enable-ip-allowlist-organization-checkbox.png) +1. Click **Save**. -## Permitir el acceso mediante {% data variables.product.prodname_github_apps %} +## Allowing access by {% data variables.product.prodname_github_apps %} -Si estás utilizando una lista de direcciones permitidas, también puedes elegir agregar automáticamente a ella cualquier dirección IP que hayas configurado para las {% data variables.product.prodname_github_apps %} que instales en tu organización. +If you're using an allow list, you can also choose to automatically add to your allow list any IP addresses configured for {% data variables.product.prodname_github_apps %} that you install in your organization. {% data reusables.identity-and-permissions.ip-allow-lists-address-inheritance %} {% data reusables.apps.ip-allow-list-only-apps %} -Para más información sobre cómo crear una lista de permitidos para una {% data variables.product.prodname_github_app %} que ha creado, vea "[Administración de direcciones IP permitidas para una aplicación de GitHub](/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app)". +For more information about how to create an allow list for a {% data variables.product.prodname_github_app %} you have created, see "[Managing allowed IP addresses for a GitHub App](/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app)." -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} -1. En "Lista de direcciones IP permitidas", seleccione **Habilitar la configuración de lista de direcciones IP permitidas para las aplicaciones de GitHub instaladas**. - ![Casilla para permitir las direcciones IP de la aplicación de GitHub](/assets/images/help/security/enable-ip-allowlist-githubapps-checkbox.png) -1. Haga clic en **Save**(Guardar). +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +1. Under "IP allow list", select **Enable IP allow list configuration for installed GitHub Apps**. + ![Checkbox to allow GitHub App IP addresses](/assets/images/help/security/enable-ip-allowlist-githubapps-checkbox.png) +1. Click **Save**. -## Editar una dirección IP permitida +## Editing an allowed IP address {% data reusables.identity-and-permissions.about-editing-ip-allow-list-entries %} -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-entry %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-description %} -1. Haga clic en **Update**(Actualizar). +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +{% data reusables.identity-and-permissions.ip-allow-lists-edit-entry %} +{% data reusables.identity-and-permissions.ip-allow-lists-edit-ip %} +{% data reusables.identity-and-permissions.ip-allow-lists-edit-description %} +1. Click **Update**. {% data reusables.identity-and-permissions.check-ip-address %} -{% ifversion ip-allow-list-address-check %} -## Comprobación de permiso para una dirección IP +## Checking if an IP address is permitted {% data reusables.identity-and-permissions.about-checking-ip-address %} -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} {% data reusables.identity-and-permissions.check-ip-address-step %} {% endif %} +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +{% data reusables.identity-and-permissions.check-ip-address-step %} -## Eliminar una dirección IP permitida +## Deleting an allowed IP address -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} {% data reusables.identity-and-permissions.ip-allow-lists-delete-entry %} {% data reusables.identity-and-permissions.ip-allow-lists-confirm-deletion %} +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +{% data reusables.identity-and-permissions.ip-allow-lists-delete-entry %} +{% data reusables.identity-and-permissions.ip-allow-lists-confirm-deletion %} -## Utilizar {% data variables.product.prodname_actions %} con un listado de direcciones IP permitidas +## Using {% data variables.product.prodname_actions %} with an IP allow list {% data reusables.actions.ip-allow-list-self-hosted-runners %} diff --git a/translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md b/translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md index ddcbcd53d1..743dcf7071 100644 --- a/translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md +++ b/translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md @@ -486,8 +486,9 @@ For more information, see "[Managing the publication of {% data variables.produc | `oauth_app_access_approved` | Triggered when an owner [grants organization access to an {% data variables.product.prodname_oauth_app %}](/articles/approving-oauth-apps-for-your-organization/). | `oauth_app_access_denied` | Triggered when an owner [disables a previously approved {% data variables.product.prodname_oauth_app %}'s access](/articles/denying-access-to-a-previously-approved-oauth-app-for-your-organization) to your organization. | `oauth_app_access_requested` | Triggered when an organization member requests that an owner grant an {% data variables.product.prodname_oauth_app %} access to your organization.{% endif %} -{% ifversion ghec %} -| `org.transfer` | Triggered when an organization is transferred between enterprise accounts. For more information, see "[Transferring an organization between enterprise accounts](/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise#transferring-an-organization-between-enterprise-accounts)."{% endif %} +{%- ifversion ghec %} +| `org.transfer` | Triggered when an organization is transferred between enterprise accounts. For more information, see "[Transferring an organization between enterprise accounts](/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise#transferring-an-organization-between-enterprise-accounts)." +{%- endif %} | `register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an organization](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)." | `remove_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is removed.{% ifversion fpt or ghec %} | `remove_billing_manager` | Triggered when an [owner removes a billing manager from an organization](/articles/removing-a-billing-manager-from-your-organization/) or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and a billing manager doesn't use 2FA or disables 2FA. |{% endif %} diff --git a/translations/es-ES/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md b/translations/es-ES/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md index 15bde5c536..9aaa8f4cde 100644 --- a/translations/es-ES/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md +++ b/translations/es-ES/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md @@ -15,12 +15,12 @@ topics: - Organizations - Teams shortTitle: Roles in an organization -ms.openlocfilehash: 960f6f701ad524220e9e79ada04fa9e4d30b8e9f -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: c6c345e3d1f0fb2c49aa55e79346bc4ac6567885 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148109815' +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159177' --- ## Acerca de los roles {% data reusables.organizations.about-roles %} @@ -121,7 +121,7 @@ Para mantener seguros los datos de su organización y, al mismo tiempo, permitir | Atribuir los patrocinios a otra organización (consulte "[Atribución de patrocinios a la organización](/sponsors/sponsoring-open-source-contributors/attributing-sponsorships-to-your-organization)" para obtener más información) | **X** | | | | | | Administrar la publicación de sitios de {% data variables.product.prodname_pages %} desde los repositorios de la organización (consulte "[Administración de la publicación de sitios de {% data variables.product.prodname_pages %} para la organización](/organizations/managing-organization-settings/managing-the-publication-of-github-pages-sites-for-your-organization)") | **X** | | | | | | Administrar la configuración de seguridad y análisis (consulte "[Administración de la configuración de seguridad y análisis de la organización](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization)") | **X** | | | | **X** | -| Consultar la información general sobre seguridad de la organización (consulte "[Acerca de la información general sobre seguridad](/code-security/security-overview/about-the-security-overview)") | **X** | | | | **X** |{% ifversion ghec %} +| Consultar la información general sobre la seguridad de la organización (consulta "[Acerca de la información general de seguridad](/code-security/security-overview/about-the-security-overview)") | **X** | | | | **X** |{% ifversion ghec %} | Habilitar y aplicar el [inicio de sesión único de SAML](/articles/about-identity-and-access-management-with-saml-single-sign-on) | **X** | | | | | | [Administrar el acceso de SAML de un usuario a la organización](/organizations/granting-access-to-your-organization-with-saml-single-sign-on/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | | | | Administrar las entidades de certificación SSH de una organización (consulte "[Administración de las entidades de certificación SSH de la organización](/articles/managing-your-organizations-ssh-certificate-authorities)") | **X** | | | | |{% endif %} @@ -167,7 +167,7 @@ Para mantener seguros los datos de su organización y, al mismo tiempo, permitir | Puede ser *mantenedor de equipo* | **X** | **X** | **X** | | Transferir repositorios | **X** | | | | Administrar la configuración de seguridad y análisis (consulte "[Administración de la configuración de seguridad y análisis de la organización](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization)") | **X** | | **X** |{% ifversion ghes %} -| Consultar la información general sobre seguridad de la organización (consulte "[Acerca de la información general sobre seguridad](/code-security/security-overview/about-the-security-overview)") | **X** | | **X** |{% endif %}{% ifversion ghes %} +| Consultar la información general sobre la seguridad de la organización (consulta "[Acerca de la información general de seguridad](/code-security/security-overview/about-the-security-overview)") | **X** | | **X** |{% endif %}{% ifversion ghes %} | Administrar las {% data variables.product.prodname_dependabot_security_updates %} (consulte ["Acerca de {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)") | **X** | | **X** |{% endif %} | Administrar las entidades de certificación SSH de una organización (consulte "[Administración de las entidades de certificación SSH de la organización](/articles/managing-your-organizations-ssh-certificate-authorities)") | **X** | | | | Crear paneles de proyecto (consulte "[Permisos de panel de proyecto para una organización](/articles/project-board-permissions-for-an-organization)") | **X** | **X** | **X** | diff --git a/translations/es-ES/content/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks.md b/translations/es-ES/content/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks.md index d167d9caa8..d3307e9927 100644 --- a/translations/es-ES/content/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks.md +++ b/translations/es-ES/content/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks.md @@ -1,6 +1,6 @@ --- -title: About forks -intro: A fork is a copy of a repository that you manage. Forks let you make changes to a project without affecting the original repository. You can fetch updates from or submit changes to the original repository with pull requests. +title: Acerca de las bifurcaciones +intro: Una bifurcación es una copia de un repositorio que administras. Las bifurcaciones te permiten realizar cambios a un proyecto sin afectar el repositorio original. Puedes recuperar actualizaciones o enviar cambios al repositorio original con solicitudes de extracción. redirect_from: - /github/collaborating-with-issues-and-pull-requests/working-with-forks/about-forks - /articles/about-forks @@ -13,33 +13,39 @@ versions: ghec: '*' topics: - Pull requests +ms.openlocfilehash: 83372d27f052ee8c22730f5ce5d22e9efbf04fbb +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158753' --- -Forking a repository is similar to copying a repository, with two major differences: +Bifurcar un repositorio es similar a copiar un repositorio, con dos diferencias principales: -* You can use a pull request to suggest changes from your user-owned fork to the original repository in its GitHub instance, also known as the *upstream* repository. -* You can bring changes from the upstream repository to your local fork by synchronizing your fork with the upstream repository. +* Puede usar una solicitud de incorporación de cambios para sugerir cambios desde la bifurcación propiedad del usuario hacia el repositorio original en su instancia de GitHub, que también se conoce como repositorio *ascendente*. +* Puedes llevar cambios desde tu repositorio ascendente a tu bifurcación local sincronizando tu bifurcación con el repositorio ascendente. {% data reusables.repositories.you-can-fork %} {% ifversion fpt or ghec %} -If you're a member of an {% data variables.enterprise.prodname_emu_enterprise %}, there are further restrictions on the repositories you can fork. {% data reusables.enterprise-accounts.emu-forks %} For more information, see "[About {% data variables.product.prodname_emus %}](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %} +Si eres un miembro de una {% data variables.enterprise.prodname_emu_enterprise %}, hay más restricciones sobre los repositorios que puedes bifurcar. {% data reusables.enterprise-accounts.emu-forks %} Para más información, vea "[Acerca de {% data variables.product.prodname_emus %}](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users){% ifversion fpt %}" en la documentación de {% data variables.product.prodname_ghe_cloud %}.{% else %}".{% endif %} {% endif %} {% data reusables.repositories.desktop-fork %} -Deleting a fork will not delete the original upstream repository. You can make any changes you want to your fork—add collaborators, rename files, generate {% data variables.product.prodname_pages %}—with no effect on the original.{% ifversion fpt or ghec %} You cannot restore a deleted forked repository. For more information, see "[Restoring a deleted repository](/articles/restoring-a-deleted-repository)."{% endif %} +Eliminar una bifurcación no eliminará el repositorio ascendente original. Puede realizar todos los cambios que quiera en la bifurcación, como añadir colaboradores, cambiar archivos de nombre, generar {% data variables.product.prodname_pages %}, sin que esto afecte el repositorio original.{% ifversion fpt or ghec %} No puede restaurar un repositorio bifurcado eliminado. Para más información, vea "[Restauración de un repositorio eliminado](/articles/restoring-a-deleted-repository)".{% endif %} -In open source projects, forks are often used to iterate on ideas or changes before they are offered back to the upstream repository. When you make changes in your user-owned fork and open a pull request that compares your work to the upstream repository, you can give anyone with push access to the upstream repository permission to push changes to your pull request branch (including deleting the branch). This speeds up collaboration by allowing repository maintainers the ability to make commits or run tests locally to your pull request branch from a user-owned fork before merging. You cannot give push permissions to a fork owned by an organization. +En proyectos de código abierto, las bifurcaciones suelen iterar en ideas o cambios antes de que se presenten al repositorio ascendente. Cuando haces cambios en la bifurcación que pertenece a tu usuario y abres una solicitud de cambios que compara tu trabajo con el repositorio ascendente, puedes otorgar permisos para subir cambios a tu rama de solicitud de cambios a cualquiera que tenga acceso de subida (incluyendo el borrar la rama). Esto agiliza la colaboración permitiendo que los mantenedores del repositorio puedan hacer confirmaciones de cambios o ejecutar pruebas locales a tu rama de solicitud de extracción desde una bifurcación propiedad de un usuario antes de fusionarlas. No puedes otorgar permisos de escritura a una bifurcación que sea propiedad de una organización. {% data reusables.repositories.private_forks_inherit_permissions %} -If you want to create a new repository from the contents of an existing repository but don't want to merge your changes to the upstream in the future, you can duplicate the repository or, if the repository is a template, you can use the repository as a template. For more information, see "[Duplicating a repository](/articles/duplicating-a-repository)" and "[Creating a repository from a template](/articles/creating-a-repository-from-a-template)". +Si quieres crear un repositorio nuevo desde el contenido de uno existente pero no quieres fusionar tus cambios ascendentemente en ocasiones futuras, puedes duplicar el repositorio o, si éste es una plantilla, utilizarlo como tal. Para más información, vea "[Duplicación de un repositorio](/articles/duplicating-a-repository)" y "[Creación de un repositorio a partir de una plantilla](/articles/creating-a-repository-from-a-template)". -## Further reading +## Información adicional -- "[About collaborative development models](/pull-requests/collaborating-with-pull-requests/getting-started/about-collaborative-development-models)" -- "[Creating a pull request from a fork](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)" -- [Open Source Guides](https://opensource.guide/){% ifversion fpt or ghec %} +- "[Acerca de los modelos de desarrollo colaborativo](/pull-requests/collaborating-with-pull-requests/getting-started/about-collaborative-development-models)" +- "[Creación de una solicitud de incorporación de cambios desde una bifurcación](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)" +- [Guías de código abierto](https://opensource.guide/){% ifversion fpt or ghec %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/es-ES/content/repositories/creating-and-managing-repositories/about-repositories.md b/translations/es-ES/content/repositories/creating-and-managing-repositories/about-repositories.md index 7ce3a269df..dd67b9806c 100644 --- a/translations/es-ES/content/repositories/creating-and-managing-repositories/about-repositories.md +++ b/translations/es-ES/content/repositories/creating-and-managing-repositories/about-repositories.md @@ -18,12 +18,12 @@ versions: ghec: '*' topics: - Repositories -ms.openlocfilehash: af0b8eb9f8bd7a98c246a0806a8bc60f59ba147f -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 95e4033aa41f7920b5447554773dc61a181f5861 +ms.sourcegitcommit: 0a6e3eee6eea9b1e445aea1e4461d64cf6b63218 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148107289' +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163509' --- ## Acerca de los repositorios @@ -44,6 +44,8 @@ Puedes utilizar repositorios para administrar tu trabajo y colaborar con otros. {% data reusables.repositories.repo-size-limit %} +Para obtener información sobre cómo usar repositorios de forma más eficaz, consulta "[Procedimientos recomendados para repositorios](/repositories/creating-and-managing-repositories/best-practices-for-repositories)". + ## Acerca de la visibilidad de un repositorio Puede restringir quién tiene acceso a un repositorio eligiendo la visibilidad de este: {% ifversion ghes or ghec %}público, interno o privado{% elsif ghae %}privado o interno{% else %} público o privado{% endif %}. @@ -132,7 +134,6 @@ Las páginas de vistas de comparación y solicitudes de incorporación de cambio ## Información adicional -- "[Creación de un repositorio](/articles/creating-a-new-repository)" - "[Acerca de las bifurcaciones](/github/collaborating-with-pull-requests/working-with-forks/about-forks)" - "[Colaboración con incidencias y solicitudes de incorporación de cambios](/categories/collaborating-with-issues-and-pull-requests)" - "[Administración del trabajo en {% data variables.product.prodname_dotcom %}](/categories/managing-your-work-on-github/)" diff --git a/translations/es-ES/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md b/translations/es-ES/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md new file mode 100644 index 0000000000..6889428199 --- /dev/null +++ b/translations/es-ES/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md @@ -0,0 +1,35 @@ +--- +title: Procedimientos recomendados para repositorios +shortTitle: Best practices +intro: Aprende a usar repositorios de forma más eficaz. +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - Repositories +ms.openlocfilehash: f14bef158431c8251f26a4d917f4207d8e7dbc8a +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163483' +--- +## Creación de una archivo LÉAME + +Para facilitar que los usuarios comprendan el trabajo y naveguen por él, se recomienda crear un archivo LÉAME para cada repositorio. + +{% data reusables.repositories.about-READMEs %} Para más información, consulta "[Acerca de los archivos LÉAME](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)". + +## Favorecer la ramificación por encima de la bifurcación + +Para simplificar la colaboración, se recomienda que los colaboradores habituales trabajen desde un único repositorio, creando solicitudes de incorporación de cambios entre ramas en lugar de entre repositorios. La bifurcación es más adecuada para aceptar contribuciones de personas que no están afiliadas a un proyecto, como colaboradores de código abierto. + +Para mantener la calidad de las ramas importantes, como `main`, mientras se usa un flujo de trabajo de ramificación, puedes usar ramas protegidas con comprobaciones de estado necesarias y revisiones de solicitudes de incorporación de cambios. Para más información, vea "[Acerca de las ramas protegidas](/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches)". + +## Use {% data variables.large_files.product_name_long %} + +Para optimizar el rendimiento, {% data variables.location.product_location %} limita los tamaños de los archivos permitidos en los repositorios. Para obtener más información, consulta "[Acerca de los archivos grandes en {% data variables.product.prodname_dotcom %}](/repositories/working-with-files/managing-large-files/about-large-files-on-github)". + +Para realizar un seguimiento de archivos grandes en un repositorio de Git, se recomienda usar {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}). Para obtener más información, consulte "[Acerca de {% data variables.large_files.product_name_long %}](/repositories/working-with-files/managing-large-files/about-git-large-file-storage)". diff --git a/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md b/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md index 5450d81b0a..00e538c494 100644 --- a/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md +++ b/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md @@ -1,6 +1,6 @@ --- -title: About READMEs -intro: 'You can add a README file to your repository to tell other people why your project is useful, what they can do with your project, and how they can use it.' +title: Acerca de los archivos README +intro: 'Puedes agregar un archivo README a tu repositorio para comentarle a otras personas por qué tu proyecto es útil, qué pueden hacer con tu proyecto y cómo lo pueden usar.' redirect_from: - /articles/section-links-on-readmes-and-blob-pages - /articles/relative-links-in-readmes @@ -14,25 +14,31 @@ versions: ghec: '*' topics: - Repositories +ms.openlocfilehash: 146f1a33eb4de224625b9603b27d2f383e55c54d +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163340' --- -## About READMEs +## Acerca de los archivos README {% data reusables.repositories.about-READMEs %} -For more information about providing guidelines for your project, see {% ifversion fpt or ghec %}"[Adding a code of conduct to your project](/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project)" and {% endif %}"[Setting up your project for healthy contributions](/communities/setting-up-your-project-for-healthy-contributions)." +Para obtener más información sobre cómo proporcionar instrucciones para el proyecto, consulta {% ifversion fpt or ghec %}"[Adición de un código de conducta al proyecto](/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project)" y {% endif %}"[Configuración del proyecto para contribuciones correctas](/communities/setting-up-your-project-for-healthy-contributions)". -A README is often the first item a visitor will see when visiting your repository. README files typically include information on: -- What the project does -- Why the project is useful -- How users can get started with the project -- Where users can get help with your project -- Who maintains and contributes to the project +Un archivo README suele ser el primer elemento que verá un visitante cuando entre a tu repositorio. Los archivos README habitualmente incluyen información sobre: +- Qué hace el proyecto. +- Por qué el proyecto es útil. +- Cómo pueden comenzar los usuarios con el proyecto. +- Dónde pueden recibir ayuda los usuarios con tu proyecto +- Quién mantiene y contribuye con el proyecto. -If you put your README file in your repository's hidden `.github`, root, or `docs` directory, {% data variables.product.product_name %} will recognize and automatically surface your README to repository visitors. +Si colocas tu archivo README en el directorio `.github`, raíz o `docs` oculto de tu repositorio, {% data variables.product.product_name %} lo reconocerá y automáticamente expondrá tu archivo README a los visitantes del repositorio. -If a repository contains more than one README file, then the file shown is chosen from locations in the following order: the `.github` directory, then the repository's root directory, and finally the `docs` directory. +Si un repositorio contiene más de un archivo README, el archivo que se muestra se elige de las ubicaciones en el siguiente orden: el directorio `.github`, luego el directorio raíz del repositorio y finalmente el directorio `docs`. -![Main page of the github/scientist repository and its README file](/assets/images/help/repository/repo-with-readme.png) +![Página principal del repositorio github/scientist y su archivo README](/assets/images/help/repository/repo-with-readme.png) {% ifversion fpt or ghes or ghec %} @@ -40,30 +46,28 @@ If a repository contains more than one README file, then the file shown is chose {% endif %} -![README file on your username/username repository](/assets/images/help/repository/username-repo-with-readme.png) +![El archivo de README en tu nombre de usuario/repositorio de nombre de usuario](/assets/images/help/repository/username-repo-with-readme.png) -## Auto-generated table of contents for README files +## Índice auto-generado de los archivos README -For the rendered view of any Markdown file in a repository, including README files, {% data variables.product.product_name %} will automatically generate a table of contents based on section headings. You can view the table of contents for a README file by clicking the {% octicon "list-unordered" aria-label="The unordered list icon" %} menu icon at the top left of the rendered page. +Para la versión interpretada de cualquier archivo de lenguaje de marcado en un repositorio, incluyendo los archivos README, {% data variables.product.product_name %} generará un índice automáticamente con base en los encabezados de sección. Puedes ver el índice de un archivo README si haces clic en el icono de menú {% octicon "list-unordered" aria-label="The unordered list icon" %} en la parte superior izquierda de la página interpretada. -![README with automatically generated TOC](/assets/images/help/repository/readme-automatic-toc.png) +![README con TOC generado automáticamente](/assets/images/help/repository/readme-automatic-toc.png) -## Section links in README files and blob pages +## Enlaces de sección en los archivos README y las páginas blob {% data reusables.repositories.section-links %} -## Relative links and image paths in README files +## Enlaces relativos y rutas con imágenes en los archivos README {% data reusables.repositories.relative-links %} ## Wikis -A README should contain only the necessary information for developers to get started using and contributing to your project. Longer documentation is best suited for wikis. For more information, see "[About wikis](/communities/documenting-your-project-with-wikis/about-wikis)." +Un archivo README debe contener solo la información necesaria para que los desarrolladores comiencen a hacer contribuciones en tu proyecto. La documentación más grande es mejor para los wikis. Para obtener más información, consulta "[Acerca de las wikis](/communities/documenting-your-project-with-wikis/about-wikis)". -## Further reading +## Información adicional -- "[Adding a file to a repository](/articles/adding-a-file-to-a-repository)" -- 18F's "[Making READMEs readable](https://github.com/18F/open-source-guide/blob/18f-pages/pages/making-readmes-readable.md)" -{%- ifversion fpt or ghec %} -- "[Adding an 'Open in GitHub Codespaces' badge](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)" -{%- endif %} +- "[Agregar un archivo a un repositorio](/articles/adding-a-file-to-a-repository)" +- 18F's "[Convertir en legible archivos READMEs](https://github.com/18F/open-source-guide/blob/18f-pages/pages/making-readmes-readable.md)" {%- ifversion fpt or ghec %} +- "[Adición de un distintivo "Abrir en GitHub Codespaces"](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)" {%- endif %} diff --git a/translations/es-ES/content/repositories/working-with-files/using-files/navigating-code-on-github.md b/translations/es-ES/content/repositories/working-with-files/using-files/navigating-code-on-github.md index 6b3d53ac1f..6335327ab6 100644 --- a/translations/es-ES/content/repositories/working-with-files/using-files/navigating-code-on-github.md +++ b/translations/es-ES/content/repositories/working-with-files/using-files/navigating-code-on-github.md @@ -1,6 +1,6 @@ --- -title: Navigating code on GitHub -intro: 'You can understand the relationships within and across repositories by navigating code directly in {% data variables.product.product_name %}.' +title: Código de navegación en GitHub +intro: 'Puedes comprender las relaciones dentro y a través de los repositorios al navegar directamente por código en {% data variables.product.product_name %}.' redirect_from: - /articles/navigating-code-on-github - /github/managing-files-in-a-repository/navigating-code-on-github @@ -10,18 +10,24 @@ versions: ghec: '*' topics: - Repositories +ms.openlocfilehash: 89fc5092468d50484cfcad71824870b6456d9ac7 +ms.sourcegitcommit: 1529de77bfcbe45519131b5f5fb3ab319758c2d2 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148164167' --- -## About navigating code on {% data variables.product.prodname_dotcom %} +## Acerca de la navegación de código en {% data variables.product.prodname_dotcom %} -Code navigation helps you to read, navigate, and understand code by showing and linking definitions of a named entity corresponding to a reference to that entity, as well as references corresponding to an entity's definition. +La navegación de código te ayuda a leer, navegar y entender el código al mostrarte y enlazar las definiciones de una entidad nombrada que corresponda a la referencia de la misma, así como mostrando referencias que corresponden a la definición de dicha entidad. -![Code navigation display](/assets/images/help/repository/code-navigation-popover.png) +![Pantalla de navegación de código](/assets/images/help/repository/code-navigation-popover.png) -Code navigation uses the open source [`tree-sitter`](https://github.com/tree-sitter/tree-sitter) library. The following languages and navigation strategies are supported: +La navegación por el código usa la biblioteca de código abierto [`tree-sitter`](https://github.com/tree-sitter/tree-sitter). Los siguientes lenguajes y estrategias de navegación son compatibles: -| Language | Search-based code navigation | Precise code navigation | +| Idioma | Navegación de código basada en la búsqueda | Navegación de código precisa | |:----------:|:----------------------------:|:-----------------------:| | C# | ✅ | | | CodeQL | ✅ | | @@ -36,49 +42,49 @@ Code navigation uses the open source [`tree-sitter`](https://github.com/tree-sit | TypeScript | ✅ | | -You do not need to configure anything in your repository to enable code navigation. We will automatically extract search-based and precise code navigation information for these supported languages in all repositories and you can switch between the two supported code navigation approaches if your programming language is supported by both. +No necesitas configurar nada en tu repositorio para habilitar la navegación de código. Extraeremos información de navegación de código precisa y basada en búsquedas automáticamente para estos lenguajes compatibles en todos los repositorios y puedes cambiar entre estos dos acercamientos compatibles de navegación de código si tu lenguaje de programación es compatible con ambos. -{% data variables.product.prodname_dotcom %} has developed two code navigation approaches based on the open source [`tree-sitter`](https://github.com/tree-sitter/tree-sitter) and [`stack-graphs`](https://github.com/github/stack-graphs) library: - - Search-based - searches all definitions and references across a repository to find entities with a given name - - Precise - resolves definitions and references based on the set of classes, functions, and imported definitions at a given point in your code +{% data variables.product.prodname_dotcom %} ha desarrollado dos enfoques de navegación por el código basados en las bibliotecas de código abierto [`tree-sitter`](https://github.com/tree-sitter/tree-sitter) y [`stack-graphs`](https://github.com/github/stack-graphs): + - Basada en búsquedas: busca todas las definiciones y referencias a lo largo de un repositorio para encontrar las entidades con un nombre específico. + - Precisa: resuelve las definiciones y referencias con base en el conjunto de clases, funciones y definiciones importadas en algún punto específico de tu código -To learn more about these approaches, see "[Precise and search-based navigation](#precise-and-search-based-navigation)." +Para obtener más información sobre estos enfoques, consulta "[Navegación precisa y basada en búsqueda](#precise-and-search-based-navigation)". -Future releases will add *precise code navigation* for more languages, which is a code navigation approach that can give more accurate results. +Las futuras versiones agregarán la *navegación de código precisa* para más lenguajes, lo cual es un acercamiento de navegación de código que puede otorgar resultados más precisos. -## Jumping to the definition of a function or method +## Saltar a la definición de una función o método -You can jump to a function or method's definition within the same repository by clicking the function or method call in a file. +Puedes saltar a una definición de función o de método dentro del mismo repositorio si das clic en la llamada a dicha función o método dentro de un archivo. -![Jump-to-definition tab](/assets/images/help/repository/jump-to-definition-tab.png) +![Pestaña Jump-to-definition](/assets/images/help/repository/jump-to-definition-tab.png) -## Finding all references of a function or method +## Buscar todas las referencias de una función o método -You can find all references for a function or method within the same repository by clicking the function or method call in a file, then clicking the **References** tab. +Puedes encontrar todas las referencias para una función o método dentro del mismo repositorio si haces clic en la función o la llamada de método de un archivo y posteriormente haces clic en la pestaña **Referencias**. -![Find all references tab](/assets/images/help/repository/find-all-references-tab.png) +![Pestaña Find all references (Buscar todas las referencias)](/assets/images/help/repository/find-all-references-tab.png) -## Precise and search-based navigation +## Navegación precisa y basada en búsqueda -Certain languages supported by {% data variables.product.prodname_dotcom %} have access to *precise code navigation*, which uses an algorithm (based on the open source [`stack-graphs`](https://github.com/github/stack-graphs) library) that resolves definitions and references based on the set of classes, functions, and imported definitions that are visible at any given point in your code. Other languages use *search-based code navigation*, which searches all definitions and references across a repository to find entities with a given name. Both strategies are effective at finding results and both make sure to avoid inappropriate results such as comments, but precise code navigation can give more accurate results, especially when a repository contains multiple methods or functions with the same name. +Algunos idiomas admitidos por {% data variables.product.prodname_dotcom %} tienen acceso a la *navegación de código precisa*, que usa un algoritmo (basado en la biblioteca código abierto [`stack-graphs`](https://github.com/github/stack-graphs)) que resuelve definiciones y referencias basadas en el conjunto de clases, funciones y definiciones importadas visibles en cualquier punto determinado del código. Otros lenguajes utilizan la *navegación de código basada en búsquedas*, la cual busca todas las definiciones y referencias a lo largo de un repositorio para encontrar entidades con un nombre específico. Ambas estrategias son efectivas para encontrar resultados y ambas se aseguran de evitar resultados inadecuados, tales como los comentarios, pero la navegación de código precisa puede arrojar resultados más exactos, especialmente cuando un repositorio contiene métodos múltiples o funciones con el mismo nombre. -If you don't see the results you expect from a precise code navigation query, you can click on the "search-based" link in the displayed popover to perform search-based navigation. +Si no ves los resultados que esperas de una consulta de navegación de código precisa, puedes hacer clic en el enlace de "basada en búsqueda" en el mensaje emergente que se muestra para realizar una navegación basada en búsqueda. -![Search-based code navigation link](/assets/images/help/repository/search-based-code-navigation-link.png) +![Enlace de navegación de código basada en búsqueda](/assets/images/help/repository/search-based-code-navigation-link.png) -If your precise results appear inaccurate, you can file a support request. +Si tus resultados precisos te parecen inexactos, puedes enviar una solicitud de soporte. -## Cross-repository precise code navigation +## Navegación de código precisa entre repositorios -Cross-repo code navigation is available for languages that are supported by precise code navigation and the dependency graph. For more information, see "[About the dependency graph](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph)." With cross-repo code navigation, you can jump to the definition of functions or variables defined in dependencies imported by your project if that dependency is a repository hosted by {% data variables.product.prodname_dotcom %}. Cross-repo code navigation does not support find-all-references requests at this time. +La navegación de código entre repositorios está disponible para los idiomas admitidos por la navegación de código precisa y el gráfico de dependencias. Para más información, vea "[Acerca del gráfico de dependencias](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph)". Con la navegación de código entre repositorios, puedes saltar a la definición de funciones o variables definidas en dependencias importadas por el proyecto si esa dependencia es un repositorio hospedado por {% data variables.product.prodname_dotcom %}. La navegación por código entre repositorios no admite solicitudes de búsqueda de todas las referencias en este momento. -![Screenshot of cross-repository code navigation](/assets/images/help/repository/cross-repository-code-navigation.png) +![Captura de pantalla de la navegación de código entre repositorios](/assets/images/help/repository/cross-repository-code-navigation.png) -## Troubleshooting code navigation +## Solución de problemas en la navegación de código -If code navigation is enabled for you but you don't see links to the definitions of functions and methods: -- Code navigation only works for active branches. Push to the branch and try again. -- Code navigation only works for repositories with fewer than 100,000 files. +Si se habilitó la navegación de código pero no ves los enlaces a las definiciones de las funciones y métodos: +- La navegación de código solo funciona para las ramas activas. Sube a la rama e intenta de nuevo. +- La navegación de código funciona únicamente para los repositorios que tienen menos de 100,000 archivos. -## Further reading -- "[Searching code](/github/searching-for-information-on-github/searching-code)" +## Información adicional +- "[Búsquedas en código](/github/searching-for-information-on-github/searching-code)" diff --git a/translations/es-ES/content/rest/overview/libraries.md b/translations/es-ES/content/rest/overview/libraries.md index f0b2703ecc..e7d5334841 100644 --- a/translations/es-ES/content/rest/overview/libraries.md +++ b/translations/es-ES/content/rest/overview/libraries.md @@ -11,12 +11,12 @@ versions: ghec: '*' topics: - API -ms.openlocfilehash: aa139c0d25354260ccf688079f3e15a871b627bd -ms.sourcegitcommit: 0ed77777360ec29eee7cd4fc212ae36fdd97c0bc +ms.openlocfilehash: 4560ae5e63f8a607f068bb24e84f1a014f44885c +ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 11/11/2022 -ms.locfileid: '148160966' +ms.lasthandoff: 11/21/2022 +ms.locfileid: '148179740' --- ![El Gundamcat](/assets/images/gundamcat.png) @@ -35,7 +35,7 @@ Utiliza la biblioteca oficial de Octokit, o elige entre cualquiera de las biblio | Nombre de la biblioteca | Repositorio | |---|---| -|**Tentacles**| [Raynes/tentacles](https://github.com/Raynes/tentacles)| +|**Tentacles**| [Raynes/tentacles](https://github.com/clj-commons/tentacles)| ### Dart diff --git a/translations/es-ES/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md b/translations/es-ES/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md index 86af4520c6..db702c04f7 100644 --- a/translations/es-ES/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md +++ b/translations/es-ES/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md @@ -1,6 +1,6 @@ --- -title: About searching on GitHub -intro: 'Our integrated search covers the many repositories, users, and lines of code on {% data variables.product.product_name %}.' +title: Acerca de la búsqueda en GitHub +intro: 'Nuestra búsqueda integrada cubre los diversos repositorios, usuarios y líneas de código en {% data variables.product.product_name %}.' redirect_from: - /articles/using-the-command-bar - /articles/github-search-basics @@ -17,79 +17,82 @@ versions: ghec: '*' topics: - GitHub search +ms.openlocfilehash: 58ecec218d8f8f0ee3d11afbf65debf7df72e811 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159105' --- +{% ifversion github-code-search %} {% note %} -{% ifversion github-code-search %} - {% note %} + **Nota:** {% data reusables.search.classic-search-code-search-note %} - **Note:** {% data reusables.search.classic-search-code-search-note %} - - {% endnote %} -{% endif %} + {% endnote %} {% endif %} {% data reusables.search.you-can-search-globally %} -- To search globally across all of {% data variables.product.product_name %}, type what you're looking for into the search field at the top of any page, and choose "All {% data variables.product.prodname_dotcom %}" in the search drop-down menu. -- To search within a particular repository or organization, navigate to the repository or organization page, type what you're looking for into the search field at the top of the page, and press **Enter**. +- Para hacer una búsqueda global en todo {% data variables.product.product_name %}, escribe lo que estás buscando en el campo de búsqueda en la parte superior de cualquier página y elige "Todo {% data variables.product.prodname_dotcom %}" en el menú de búsqueda desplegable. +- Para buscar dentro de un repositorio o una organización en particular, vaya a la página del repositorio o de la organización, escribe lo que está buscando en el campo de búsqueda de la parte superior de la página y pulse **Enter**. {% note %} -**Notes:** +**Notas:** {% ifversion fpt or ghes or ghec %} - {% data reusables.search.required_login %}{% endif %} -- {% data variables.product.prodname_pages %} sites are not searchable on {% data variables.product.product_name %}. However you can search the source content if it exists in the default branch of a repository, using code search. For more information, see "[Searching code](/search-github/searching-on-github/searching-code)." For more information about {% data variables.product.prodname_pages %}, see "[What is GitHub Pages?](/articles/what-is-github-pages/)" -- Currently our search doesn't support exact matching. -- Whenever you are searching in code files, only the first two results in each file will be returned. +- Los sitios {% data variables.product.prodname_pages %} no se pueden buscar en {% data variables.product.product_name %}. Sin embargo, puedes buscar el contenido fuente si existe en la rama por defecto de un repositorio, usando la búsqueda de código. Para obtener más información, consulte "[Búsqueda de código](/search-github/searching-on-github/searching-code)". Para obtener más información sobre {% data variables.product.prodname_pages %}, consulte ["¿Qué son las páginas de GitHub?](/articles/what-is-github-pages/)" +- Actualmente, nuestra búsqueda no es compatible con las coincidencias exactas. +- Cuando estés buscando dentro de archivos de código, únicamente se devolverán los primeros dos resultados de cada archivo. {% endnote %} -After running a search on {% data variables.product.product_name %}, you can sort the results, or further refine them by clicking one of the languages in the sidebar. For more information, see "[Sorting search results](/search-github/getting-started-with-searching-on-github/sorting-search-results)." +Después de ejecutar una búsqueda en {% data variables.product.product_name %}, puedes clasificar los resultados o refinarlos más haciendo clic en uno de los idiomas de la barra lateral. Para obtener más información, consulte "[Ordenar resultados de búsqueda](/search-github/getting-started-with-searching-on-github/sorting-search-results)". -{% data variables.product.product_name %} search uses an ElasticSearch cluster to index projects every time a change is pushed to {% data variables.product.product_name %}. Issues and pull requests are indexed when they are created or modified. +La búsqueda de {% data variables.product.product_name %} usa una agrupación ElasticSearch para indexar los proyectos cada vez que se sube un cambio a {% data variables.product.product_name %}. Las propuestas y las solicitudes de extracción son indexadas cuando son creadas o modificadas. -## Types of searches on {% data variables.product.prodname_dotcom %} +## Tipos de búsquedas en {% data variables.product.prodname_dotcom %} -You can search for the following information across all repositories you can access on {% data variables.location.product_location %}. +Puedes buscar la siguiente información a través de todos los repositorios a los que puedes acceder en {% data variables.location.product_location %}. -- [Repositories](/search-github/searching-on-github/searching-for-repositories) -- [Topics](/search-github/searching-on-github/searching-topics) -- [Issues and pull requests](/search-github/searching-on-github/searching-issues-and-pull-requests){% ifversion fpt or ghec %} -- [Discussions](/search-github/searching-on-github/searching-discussions){% endif %} -- [Code](/search-github/searching-on-github/searching-code) -- [Commits](/search-github/searching-on-github/searching-commits) -- [Users](/search-github/searching-on-github/searching-users) -- [Packages](/search-github/searching-on-github/searching-for-packages) +- [Repositorios](/search-github/searching-on-github/searching-for-repositories) +- [Temas](/search-github/searching-on-github/searching-topics) +- [Incidencias y solicitudes de incorporación de cambios](/search-github/searching-on-github/searching-issues-and-pull-requests){% ifversion fpt or ghec %} +- [Debates](/search-github/searching-on-github/searching-discussions){% endif %} +- [Código](/search-github/searching-on-github/searching-code) +- [Confirmaciones](/search-github/searching-on-github/searching-commits) +- [Usuarios](/search-github/searching-on-github/searching-users) +- [Paquetes](/search-github/searching-on-github/searching-for-packages) - [Wikis](/search-github/searching-on-github/searching-wikis) -## Searching using a visual interface +## Buscar usando una interfaz visual -You can search {% data variables.product.product_name %} using the {% data variables.search.search_page_url %} or {% data variables.search.advanced_url %}. {% ifversion command-palette %}Alternatively, you can use the interactive search in the {% data variables.product.prodname_command_palette %} to search your current location in the UI, a specific user, repository or organization, and globally across all of {% data variables.product.product_name %}, without leaving the keyboard. For more information, see "[{% data variables.product.prodname_command_palette %}](/get-started/using-github/github-command-palette)."{% endif %} +Puedes buscar en {% data variables.product.product_name %} utilizando la {% data variables.search.search_page_url %} o la {% data variables.search.advanced_url %}. {% ifversion command-palette %}Como alternativa, puedes utilizar la búsqueda interactiva en la {% data variables.product.prodname_command_palette %} para buscar tu ubicación actual en la IU, un usuario, repositorio u organización específicos y globalmente en todo {% data variables.product.product_name %} al alcance de tu teclado. Para obtener más información, consulte "[{% data variables.product.prodname_command_palette %}](/get-started/using-github/github-command-palette)."{% endif %} -The {% data variables.search.advanced_url %} provides a visual interface for constructing search queries. You can filter your searches by a variety of factors, such as the number of stars or number of forks a repository has. As you fill in the advanced search fields, your query will automatically be constructed in the top search bar. +{% data variables.search.advanced_url %} ofrece una interfaz visual para construir consultas de búsqueda. Puedes filtrar tus búsquedas por diferentes factores, como la cantidad de estrellas o la cantidad de bifurcaciones que tiene un repositorio. A medida que completas los campos de búsqueda de avanzada, tu consulta se construirá automáticamente en la barra de búsqueda superior. -![Advanced Search](/assets/images/help/search/advanced_search_demo.gif) +![Búsqueda avanzada](/assets/images/help/search/advanced_search_demo.gif) -## Searching repositories on {% data variables.product.prodname_dotcom_the_website %} from your private enterprise environment +## Buscar repositorios en {% data variables.product.prodname_dotcom_the_website %} desde tu ambiente de empresa privada {% ifversion fpt or ghec %} -If you use both {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_ghe_server %} or {% data variables.product.prodname_ghe_managed %}, and an enterprise owner has enabled {% data variables.enterprise.prodname_unified_search %}, you can search across both environments at the same time from {% data variables.product.prodname_ghe_server %} or {% data variables.product.prodname_ghe_managed %}. For more information, see [the {% data variables.product.prodname_ghe_server %} documentation](/enterprise-server@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment) or [the {% data variables.product.prodname_ghe_managed %} documentation](/github-ae@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment). +Si usas {% data variables.product.prodname_dotcom_the_website %} y {% data variables.product.prodname_ghe_server %} o {% data variables.product.prodname_ghe_managed %}, y un propietario de la empresa ha habilitado {% data variables.enterprise.prodname_unified_search %}, puedes buscar en ambos entornos al mismo tiempo desde {% data variables.product.prodname_ghe_server %} o {% data variables.product.prodname_ghe_managed %}. Para obtener más información, consulta la [documentación de {% data variables.product.prodname_ghe_server %}](/enterprise-server@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment) o la [documentación de {% data variables.product.prodname_ghe_managed %}](/github-ae@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment). {% else %} -If you use both {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.product_name %}, and an enterprise owner has enabled {% data variables.enterprise.prodname_unified_search %}, you can search across both environments at the same time from {% data variables.product.product_name %}. For more information about how enterprise owners can enable {% data variables.enterprise.prodname_unified_search %}, see "[Enabling {% data variables.enterprise.prodname_unified_search %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)." +Si usas {% data variables.product.prodname_dotcom_the_website %} y {% data variables.product.product_name %}, y un propietario de la empresa ha habilitado {% data variables.enterprise.prodname_unified_search %}, puedes buscar en ambos entornos al mismo tiempo desde {% data variables.product.product_name %}. Para obtener más información sobre cómo los propietarios de empresas pueden habilitar {% data variables.enterprise.prodname_unified_search %}, consulta "[Habilitación de {% data variables.enterprise.prodname_unified_search %} para la empresa](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)". -Your enterprise owner on {% data variables.product.product_name %} can separately enable {% data variables.enterprise.prodname_unified_search %} for all public repositories on {% data variables.product.prodname_dotcom_the_website %} and for private repositories owned by the organization or enterprise on {% data variables.product.prodname_dotcom_the_website %} that is connected to {% data variables.product.product_name %} through {% data variables.product.prodname_github_connect %}. +El propietario de la empresa en {% data variables.product.product_name %} puede habilitar por separado {% data variables.enterprise.prodname_unified_search %} para todos los repositorios públicos en {% data variables.product.prodname_dotcom_the_website %} y para repositorios privados que pertenecen a la organización o empresa en {% data variables.product.prodname_dotcom_the_website %} conectado a {% data variables.product.product_name %} mediante {% data variables.product.prodname_github_connect %}. -Before you can use {% data variables.enterprise.prodname_unified_search %} for private repositories, you must connect your personal accounts on {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.product_name %}. For more information, see "[Enabling {% data variables.product.prodname_dotcom_the_website %} repository search from your private enterprise environment](/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment)." +Para poder usar {% data variables.enterprise.prodname_unified_search %} para repositorios privados, debes conectar tus cuentas personales en {% data variables.product.prodname_dotcom_the_website %} y {% data variables.product.product_name %}. Para obtener más información, consulte "[Habilitación de la búsqueda de repositorios de {% data variables.product.prodname_dotcom_the_website %} desde su entorno empresarial privado](/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment)". -When you search from {% data variables.product.product_name %}, only private repositories that you have access to and that are owned by the connected organization or enterprise account will be included in search results. Neither you nor anyone else will be able to search private repositories owned by your personal account on {% data variables.product.prodname_dotcom_the_website %} from {% data variables.product.product_name %}. +Al buscar desde{% data variables.product.product_name %}, solo se incluirán en los resultados de la búsqueda los repositorios privados a los que tengas acceso y que sean propiedad de la cuenta conectada de la organización o empresa. Ni tú ni nadie más podrá buscar repositorios privados propiedad de tu cuenta personal en {% data variables.product.prodname_dotcom_the_website %} desde {% data variables.product.product_name %}. -To limit your search to one environment, you can use a filter option on the {% data variables.search.advanced_url %} or you can use the `environment:` search prefix. To only search for content on {% data variables.product.product_name %}, use the search syntax `environment:local`. To only search for content on {% data variables.product.prodname_dotcom_the_website %}, use `environment:github`. +Para limitar la búsqueda a un entorno, puedes usar una opción de filtro en la {% data variables.search.advanced_url %} o usar el prefijo de búsqueda `environment:`. Para buscar solo contenido en {% data variables.product.product_name %}, use la sintaxis de búsqueda `environment:local`. Para buscar solo contenido en {% data variables.product.prodname_dotcom_the_website %}, use `environment:github`. {% endif %} -## Further reading +## Información adicional -- "[Understanding the search syntax](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax)" -- "[Searching on GitHub](/articles/searching-on-github)" +- "[Entender la sintaxis de búsqueda](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax)" +- "[Buscar en GitHub](/articles/searching-on-github)" diff --git a/translations/es-ES/content/search-github/github-code-search/about-github-code-search.md b/translations/es-ES/content/search-github/github-code-search/about-github-code-search.md new file mode 100644 index 0000000000..79afa47a74 --- /dev/null +++ b/translations/es-ES/content/search-github/github-code-search/about-github-code-search.md @@ -0,0 +1,58 @@ +--- +title: Acerca de GitHub Code Search (versión beta) +intro: 'Puedes buscar, explorar y consultar código en GitHub con la nueva búsqueda de código (versión beta).' +allowTitleToDifferFromFilename: true +versions: + feature: github-code-search +topics: + - GitHub search +ms.openlocfilehash: 8bf3232e87de2fc773f69bf5047e75ab0e52c7e2 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160342' +--- +{% note %} + +**Nota:** {% data reusables.search.code-search-code-view-beta-note %} + +{% data reusables.search.code-view-link %} + +{% endnote %} + +## Acerca de la nueva búsqueda de código (versión beta) + +La nueva búsqueda de código (versión beta) te permite buscar, explorar y consultar rápidamente tu código, el del equipo y el de la comunidad de código abierto, todo desde {% data variables.product.prodname_dotcom_the_website %}. Este motor de búsqueda está diseñado para ser escalable, tener en cuenta el código y admitir la búsqueda de código en GitHub mediante expresiones regulares, operaciones booleanas, calificadores especializados y búsqueda de símbolos. Para obtener más información sobre la sintaxis de la nueva búsqueda de código (versión beta), consulta "[Descripción de la sintaxis de GitHub Code Search (versión beta)](/search-github/github-code-search/understanding-github-code-search-syntax)". + +Además del nuevo motor de búsqueda de código, la búsqueda de código (versión beta) incluye nuevas características en la interfaz de búsqueda de {% data variables.product.prodname_dotcom_the_website %}, como sugerencias, finalizaciones y la posibilidad de guardar las búsquedas. La nueva interfaz de búsqueda te permite encontrar de forma más rápida y fácil lo que buscas. Para obtener más información, consulta "[Uso de GitHub Code Search (versión beta)](/search-github/github-code-search/using-github-code-search)". + +{% data reusables.search.non-code-search-explanation %} + +La nueva búsqueda de código (versión beta) está estrechamente integrada con una vista de código rediseñada (versión beta) en {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.search.code-view-link %} + +Para obtener acceso a la nueva búsqueda de código (versión beta), así como a la nueva vista de código, puedes registrarte en la [lista de espera](https://github.com/features/code-search-code-view/signup). + +## Habilitación y deshabilitación de la nuevas búsqueda de código y vista de código (versión beta) + +{% data reusables.search.enabling-and-disabling-code-search-and-view-beta %} + +## Limitaciones + +Hemos indexado muchos repositorios públicos para la nueva búsqueda de código (versión beta) y seguimos indexando más. Además, los repositorios privados de los usuarios de GitHub en la versión beta están indexados y pueden buscarlos los participantes de la versión beta que ya tengan acceso a esos repositorios privados en GitHub.com. Sin embargo, es posible que ni los repositorios muy grandes ni todo el código se indexen. + +Las limitaciones actuales del código indexado son las siguientes: + - Se excluye el código generado y delegado a proveedores (según lo que determina [Enry](https://github.com/go-enry/go-enry)) + - Se excluyen los archivos vacíos y los de más de 350 KiB + - Solo se incluyen los archivos con codificación UTF-8 + - Es posible que los repositorios muy grandes no se indexen + +Actualmente solo se admite la búsqueda de código en la rama predeterminada de un repositorio. + +Los resultados de cualquier búsqueda con la nueva búsqueda de código (versión beta) están restringidos a 100 resultados (10 páginas). La ordenación no se admite para los resultados de búsqueda de código en este momento. Esta limitación solo se aplica a la nueva búsqueda de código (versión beta) y no se aplica a otros tipos de búsquedas. + +La nueva búsqueda de código (versión beta) admite la búsqueda de definiciones de símbolos en el código, como definiciones de función o clase, mediante el calificador `symbol:`. Sin embargo, ten en cuenta que el calificador `symbol:` solo busca definiciones y no referencias, y todavía no se admiten totalmente todos los tipos de símbolos y lenguajes. Para obtener una lista de los idiomas que se admiten, consulta "[Calificador de símbolos](/search-github/github-code-search/understanding-github-code-search-syntax#symbol-qualifier)". + +## Comentarios y soporte técnico + +Puedes ver y compartir comentarios sobre la nueva búsqueda de código (versión beta) en nuestro [foro de discusión](https://github.com/orgs/community/discussions/categories/code-search-and-navigation). diff --git a/translations/es-ES/content/search-github/github-code-search/index.md b/translations/es-ES/content/search-github/github-code-search/index.md new file mode 100644 index 0000000000..a0d376819d --- /dev/null +++ b/translations/es-ES/content/search-github/github-code-search/index.md @@ -0,0 +1,26 @@ +--- +title: Búsqueda de código de GitHub (beta) +intro: 'Puedes usar una sintaxis amplia para buscar en {% data variables.product.product_name %}. Puedes ajustar el ámbito de tus consultas de búsqueda, compilación y solución de problemas y restringir los resultados con calificadores.' +allowTitleToDifferFromFilename: true +versions: + feature: github-code-search +topics: + - GitHub search +children: + - /about-github-code-search + - /using-github-code-search + - /understanding-github-code-search-syntax +ms.openlocfilehash: a2420a27a7026b61dff0d05650d4b525f9d55adb +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160028' +--- +{% note %} + +**Nota**: {% data reusables.search.code-search-code-view-beta-note %} + +{% data reusables.search.code-search-link %} {% data reusables.search.code-view-link %} + +{% endnote %} diff --git a/translations/es-ES/content/search-github/github-code-search/understanding-github-code-search-syntax.md b/translations/es-ES/content/search-github/github-code-search/understanding-github-code-search-syntax.md new file mode 100644 index 0000000000..41256fe96a --- /dev/null +++ b/translations/es-ES/content/search-github/github-code-search/understanding-github-code-search-syntax.md @@ -0,0 +1,293 @@ +--- +title: Descripción de la sintaxis de GitHub Code Search (beta) +intro: 'Puedes crear consultas de búsqueda para los resultados que quieras con calificadores de código especializados, expresiones regulares y operaciones booleanas.' +allowTitleToDifferFromFilename: true +versions: + feature: github-code-search +topics: + - GitHub search +ms.openlocfilehash: 098da2b7fe8a8c5466805c583e6b029b5b9b58c1 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160067' +--- +{% note %} + +**Nota:** {% data reusables.search.code-search-code-view-beta-note %} + +{% data reusables.search.code-search-link %} {% data reusables.search.code-view-link %} + +{% endnote %} + +## Acerca de la nueva estructura de consultas de búsqueda de código (beta) + +La sintaxis de búsqueda de este artículo solo se aplica a la búsqueda de código con la nueva búsqueda de código (beta) habilitada. {% data reusables.search.non-code-search-explanation %} + +Las consultas de búsqueda constan de términos de búsqueda, que incluyen el texto que quieres buscar y calificadores, que limitan la búsqueda. + +Un término sin calificadores coincidirá con el contenido de un archivo o la ruta de acceso del archivo. + +Por ejemplo, la consulta siguiente: + +``` +http-push +``` + +La consulta anterior coincidirá con el archivo `docs/http-push.txt`, incluso si no contiene el término `http-push`. También coincidirá con un archivo llamado `example.txt` si contiene el término `http-push`. + +Puedes introducir varios términos separados por espacios en blanco para buscar documentos que cumplan ambos términos. + +Por ejemplo, la consulta siguiente: + +``` +sparse index +``` + +Los resultados de la búsqueda incluirían todos los documentos que contienen los términos `sparse` y `index`, en cualquier orden. Como ejemplos, coincidiría con un archivo que contenga `SparseIndexVector`, un archivo con la frase `index for sparse trees` e incluso un archivo denominado `index.txt` que contenga el término `sparse`. + +La búsqueda de varios términos separados por espacios en blanco es equivalente a la búsqueda `hello AND world`. Otras operaciones booleanas, como `hello OR world`, también se admiten en la nueva búsqueda de código (beta). Para obtener más información sobre las operaciones booleanas, consulta "[Uso de operaciones booleanas](#using-boolean-operations)". + +La nueva búsqueda de código (beta) también admite la búsqueda de una cadena exacta, incluido el espacio en blanco. Para obtener más información, consulta "[Consulta de una coincidencia exacta](#query-for-an-exact-match)". + +Puedes restringir la búsqueda de código con calificadores especializados, como `repo:`, `language:` y `path:`. Para obtener más información sobre los calificadores que puede usar en la nueva búsqueda de código (beta), consulta "[Uso de calificadores](#using-qualifiers)". + +También puedes usar expresiones regulares en las búsquedas rodeando la expresión con barras diagonales inversas. Para obtener más información sobre el uso de expresiones regulares, consulta "[Uso de expresiones regulares](#using-regular-expressions)". + +## Consulta de una coincidencia exacta + +Para buscar una cadena exacta, incluido el espacio en blanco, puedes rodear la cadena con comillas. Por ejemplo: + +``` +"sparse index" +``` + +Para buscar una frase que contenga comillas, puedes establecer la comilla mediante una barra diagonal inversa. Por ejemplo, para buscar la cadena exacta `name = "tensorflow"`, puedes buscar: + +``` +"name = \"tensorflow\"" +``` + +También puedes usar cadenas entre comillas en calificadores, por ejemplo: + +``` +path: git language: "protocol buffers" +``` + +## Uso de operaciones booleanas + +La nueva búsqueda de código (beta) admite expresiones booleanas. Puedes usar los operadores `AND`, `OR` y `NOT` para combinar términos de búsqueda. + +De forma predeterminada, los términos adyacentes separados por espacios en blanco son equivalentes al uso del operador `AND`. Por ejemplo, la consulta de búsqueda `sparse index` es la misma que `sparse AND index`, lo que significa que los resultados de la búsqueda incluirán todos los documentos que contengan los términos `sparse` y `index`, en cualquier orden. + +Para buscar documentos que contengan un término u otro, puedes usar el operador `OR`. Por ejemplo, la consulta siguiente coincidirá con los documentos que contengan `sparse` o `index`: + +``` +sparse OR index +``` + +Para excluir archivos de los resultados de búsqueda, puedes usar el operador `NOT`. Por ejemplo, para excluir el archivo en el directorio `__testing__`, puedes buscar: + +``` +"fatal error" NOT path:__testing__ +``` + +Puedes usar paréntesis para expresar expresiones booleanas más complicadas. Por ejemplo: + +``` +(language:ruby OR language:python) AND NOT path:"/tests/" +``` + +## Uso de calificadores + +Puedes usar palabras clave especializadas para calificar la búsqueda. +- [Calificador de repositorio](#repository-qualifier) +- [Calificadores de organización y usuario](#organization-and-user-qualifiers) +- [Calificador de lenguaje](#language-qualifier) +- [Calificador de ruta de acceso](#path-qualifier) +- [Calificador de símbolos](#symbol-qualifier) +- [Calificador de contenido](#content-qualifier) +- [Calificador IS](#is-qualifier) + +### Calificador de repositorio + +Para buscar dentro de un repositorio, usa el calificador `repo:`. Debes proporcionar el nombre completo del repositorio, incluido el propietario. Por ejemplo: + +``` +repo:github/linguist +``` + +Para buscar en un conjunto de repositorios, puedes combinar varios calificadores `repo:` con el operador booleano `OR`. Por ejemplo: + +``` +repo:github/linguist OR repo:tree-sitter/tree-sitter +``` + +{% note %} + +**Nota:** La nueva versión beta de búsqueda de código no admite actualmente expresiones regulares o coincidencias parciales para los nombres de repositorio, por lo que tendrás que escribir todo el nombre del repositorio (incluido el prefijo de usuario) para que el calificador `repo:` funcione. + +{% endnote %} + +### Calificadores de organización y usuario + +Para buscar archivos dentro de una organización, usa el calificador `org:`. Por ejemplo: + +``` +org:github +``` + +Para buscar archivos dentro de una cuenta personal, usa el calificador `user:`. Por ejemplo: + +``` +user:octocat +``` + +{% note %} + +**Nota:** La nueva versión beta de búsqueda de código no admite actualmente expresiones regulares o coincidencias parciales para los nombres de la organización o usuario, por lo que tendrás que escribir todo el nombre de la organización o nombre de usuario para que el calificador funcione. + +{% endnote %} + + +### Calificador de lenguaje + +Para reducir a un lenguaje específico, usa el calificador `language:`. Por ejemplo: + +``` +language: ruby OR language:cpp OR language:csharp +``` + +Para obtener una lista completa de los nombres de lenguajes admitidos, consulta [languages.yaml](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml) en [github/linguist](https://github.com/github/linguist). Si su lenguaje preferido no está en la lista, puedes abrir una solicitud de incorporación de cambios para agregarlo. + +### Calificador de ruta de acceso + +Para buscar en rutas de acceso de archivo, usa el calificador `path:`. Esto coincidirá con los archivos que contienen el término en cualquier lugar de la ruta de acceso del archivo. Por ejemplo, para buscar archivos que contengan el término `unit_tests` en su ruta de acceso, usa: + +``` +path:unit_tests +``` + La consulta anterior coincidirá con `src/unit_tests/my_test.py` y `src/docs/unit_tests.md`, ya que ambas contienen `unit_test` en algún lugar de su ruta de acceso. + + Para que solo coincida con un nombre de archivo específico (y no parte de la ruta de acceso), puedes usar una expresión regular: + + ``` + path:/(^|\/)README\.md$/ + ``` +Ten en cuenta que `.` en el nombre de archivo tiene escape, ya que `.` tiene un significado especial para las expresiones regulares. Para obtener más información sobre el uso de expresiones regulares, consulta "[Uso de expresiones regulares](#using-regular-expressions)". + +
+ +También puedes usar algunas expresiones globales limitadas en el calificador `path:`. + +Por ejemplo, para buscar archivos con la extensión `txt`, puedes usar: + +``` +path:*.txt +``` +
+Para buscar archivos de JavaScript en un directorio `src`, puedes usar: + +``` +path:src/*.js +``` + +- De forma predeterminada, las expresiones globales no están ancladas al inicio de la ruta de acceso, por lo que la expresión anterior seguiría coincidiendo con una ruta de acceso como `app/src/main.js`. Pero si prefijas la expresión con `/`, se delimitará al inicio. Por ejemplo: + + ``` + path:/src/*.js + ``` +- Ten en cuenta que `*` no coincide con el carácter `/`, por lo que, para el ejemplo anterior, todos los resultados serán descendientes directos del directorio `src`. Para buscar coincidencias en subdirectorios, de modo que los resultados incluyan archivos profundamente anidados como `/src/app/testing/utils/example.js`, puedes usar `**`. Por ejemplo: + + ``` + path:/src/**/*.js + ``` +
+ +También puedes usar el carácter global `?`. Por ejemplo, para que coincida con la ruta de acceso `file.aac` o `file.abc`, puedes usar: + +``` +path:*.a?c +``` +
+Para buscar un nombre de archivo que contenga un carácter especial como `*` o `?`, simplemente usa una cadena entre comillas: + +``` +path:"file?" +``` + +Como las expresiones globales están deshabilitadas para las cadenas entre comillas, la consulta anterior solo coincidirá con las rutas de acceso que contienen la cadena literal `file?`. + +### Calificador de símbolos + +Puedes buscar definiciones de símbolos en el código, como definiciones de función o de clase, mediante el calificador `symbol:`. La búsqueda de símbolos se basa en el análisis del código mediante el ecosistema del analizador de [árboles](https://github.com/tree-sitter) de código abierto, por lo que no se requiere ninguna configuración adicional ni integración de la herramienta de compilación. + +Por ejemplo, para buscar un símbolo denominado `WithContext`: + +``` +language:go symbol:WithContext +``` + +En algunos lenguajes, puedes buscar símbolos mediante un prefijo (por ejemplo, un prefijo de su nombre de clase). Por ejemplo, para un método `deleteRows` en una estructura `Maint`, podrías buscar `symbol:Maint.deleteRows` si usas Go o `symbol:Maint::deleteRows` en Rust. + +También puedes usar expresiones regulares con el calificador de símbolo. Por ejemplo, la consulta siguiente encontraría conversiones que las personas han implementado en Rust para el tipo `String`: + +``` +language:rust symbol:/^String::to_.*/ +``` + +Ten en cuenta que este calificador solo busca definiciones y no referencias, y no todos los tipos de símbolos o lenguajes son totalmente compatibles todavía. La extracción de símbolos es compatible con los siguientes lenguajes. + +- C# +- Python +- Go +- Java +- JavaScript +- TypeScript +- PHP +- Búferes de protocolo +- Ruby +- Rust + +Estamos trabajando en agregar compatibilidad con más lenguajes. Si quieres ayudar a contribuir a este esfuerzo, puedes agregar compatibilidad con su lenguaje en el ecosistema de [analizadores de árboles](https://github.com/tree-sitter) de código abierto, en el que se basa la búsqueda de símbolos. + +### Calificador de contenido + +De forma predeterminada, los términos sin sistema buscan en las rutas de acceso y el contenido del archivo. Para restringir una búsqueda para que coincida estrictamente con el contenido de un archivo y no las rutas de acceso de archivo, usa el calificador `content:`. Por ejemplo: + +``` +content:README.md +``` + +Esta consulta solo coincidiría con los archivos que contienen el término `README.md`, en lugar de los archivos coincidentes denominados `README.md`. + +### Calificador IS + +Para filtrar en función de las propiedades del documento, puede usar el calificador `is:`. En este momento, el único valor admitido en este calificador es `archived`, que restringe la búsqueda a repositorios archivados. Por ejemplo: + +``` +path:/MIT.txt is:archived +``` + +Ten en cuenta que el calificador `is:` se puede invertir con el operador `NOT`. Para buscar repositorios no archivados, puedes buscar: + +``` +log4j NOT is:archived +``` + +## Uso de expresiones regulares + +La nueva búsqueda de código (beta) admite expresiones regulares para buscar patrones en el código. Puedes usar expresiones regulares en términos de búsqueda sin sistema operativo, así como en muchos calificadores, rodeando la expresión regular en barras diagonales inversas. + +Por ejemplo, para buscar la expresión regular `sparse.*index`, usarías: + +``` +/sparse.*index/ +``` + +Ten en cuenta que tendrá que escapar las barras diagonales dentro de la expresión regular. Por ejemplo, para buscar archivos dentro del directorio `App/src`, usarías: + +``` +/^App\/src\// +``` diff --git a/translations/es-ES/content/search-github/github-code-search/using-github-code-search.md b/translations/es-ES/content/search-github/github-code-search/using-github-code-search.md new file mode 100644 index 0000000000..7069d190d0 --- /dev/null +++ b/translations/es-ES/content/search-github/github-code-search/using-github-code-search.md @@ -0,0 +1,81 @@ +--- +title: Uso de la búsqueda de código de GitHub (beta) +intro: 'Puedes usar sugerencias, finalizaciones y búsquedas guardadas en la interfaz de búsqueda actualizada para encontrar rápidamente lo que buscas en {% data variables.product.prodname_dotcom_the_website %}.' +allowTitleToDifferFromFilename: true +versions: + feature: github-code-search +topics: + - GitHub search +ms.openlocfilehash: 7578dd05f251b1df23fbd64c63d04e533f7fa9ef +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160336' +--- +{% note %} + +**Nota:** {% data reusables.search.code-search-code-view-beta-note %} + +{% data reusables.search.code-search-link %} {% data reusables.search.code-view-link %} + +{% endnote %} + +## Acerca del uso de la nueva búsqueda de código (beta) + +Al acceder a la nueva versión beta de la búsqueda de código, GitHub indexará los repositorios que posees y los de las organizaciones de las que eres miembro (ya sean públicos, privados o internos). Esto significa que puedes buscar en todos tus repositorios, así como en los repositorios públicos de {% data variables.product.prodname_dotcom_the_website %} que ya están indexados. Solo los usuarios con permiso para ver tu código en {% data variables.product.prodname_dotcom_the_website %} podrán verlo en los resultados de las búsquedas. Las bifurcaciones se indexan y permiten realizar búsquedas de la misma manera que otros repositorios. + +No todo el código se indexa. Además, actualmente solo puedes realizar búsquedas en las ramas predeterminadas de los repositorios. Para más información sobre las limitaciones conocidas, consulta "[Acerca de la búsqueda de código de GitHub (beta)](/search-github/github-code-search/about-github-code-search#limitations)". + +La nueva búsqueda de código beta está integrada en la nueva vista de código beta. {% data reusables.search.code-view-link %} + +## Uso de la barra de búsqueda + +Además del nuevo motor de búsqueda de código, la versión beta incluye una interfaz de búsqueda actualizada en {% data variables.product.prodname_dotcom_the_website %}. Puedes encontrar rápidamente lo que estás buscando con sugerencias, finalizaciones y búsquedas guardadas, a menudo sin tener que escribir completamente una consulta ni consultar la página de resultados de la búsqueda. + +Para obtener más información sobre la sintaxis de búsqueda de la nueva búsqueda de código (beta), consulta "[Descripción de la sintaxis de la búsqueda de código de GitHub (beta)](/search-github/github-code-search/understanding-github-code-search-syntax)". + +{% data reusables.search.non-code-search-explanation %} + +1. En la barra de navegación superior de {% data variables.product.prodname_dotcom_the_website %}, haz clic en la barra de búsqueda. +1. Bajo la barra de búsqueda, verás una lista de sugerencias organizadas por categoría, incluidas tus búsquedas recientes y los repositorios, equipos y proyectos a los que tienes acceso. También podrás ver una lista de las búsquedas guardadas que hayas creado. Para obtener más información sobre las búsquedas guardadas, consulta "[Creación y administración de búsquedas guardadas](#creating-and-managing-saved-searches)". + + ![Barra de búsqueda con sugerencias y búsquedas guardadas](/assets/images/help/search/code-search-beta-search-bar.png) + + Al hacer clic en una de las sugerencias que se muestran, se te dirigirá directamente a la página de esa sugerencia (por ejemplo, el repositorio o la página del proyecto). Por otro lado, si haces clic en una búsqueda reciente o una búsqueda guardada, según el tipo de búsqueda en cuestión, la consulta de búsqueda aparecerá en la barra de búsqueda o bien se te dirigirá a la página de resultados de la búsqueda para ese término de búsqueda. + +1. Cuando empieces a escribir una consulta de búsqueda, verás una lista de finalizaciones y sugerencias que coinciden con tu consulta. Puedes hacer clic en cualquier sugerencia para ir a una ubicación específica. A medida que escribas más calificadores, verás sugerencias más específicas, como archivos de código a los que puedes ir directamente. + + ![Barra de búsqueda con una consulta y sugerencias de código](/assets/images/help/search/code-search-beta-search-bar-code-suggestions.png) + +1. También puedes presionar Entrar después de escribir una consulta para ir a la vista completa de resultados de la búsqueda, donde puedes ver todas las coincidencias y una interfaz visual para aplicar filtros. Para obtener más información, consulta "[Uso de la vista de resultados de la búsqueda](#using-the-search-results-view)". + +## Creación y administración de búsquedas guardadas + +1. En la barra de navegación superior de {% data variables.product.prodname_dotcom_the_website %}, haz clic en la barra de búsqueda y empieza a escribir una consulta de búsqueda (o cualquier letra). +1. Debajo de la barra de búsqueda, debería aparecer la sección "Búsquedas guardadas". Haz clic en {% octicon "plus-circle" aria-label="The plus-circle icon" %} **Crear búsqueda guardada**. + + ![Botón "Crear búsqueda guardada" en la barra de búsqueda](/assets/images/help/search/code-search-beta-create-saved-search.png) + +1. En la ventana emergente, escribe un nombre para la consulta y la consulta que quieres guardar. Haz clic en **Crear búsqueda guardada**. + + ![Ventana "Crear búsqueda guardada"](/assets/images/help/search/code-search-beta-create-saved-search-window.png) + +1. Si vuelves a hacer clic en la barra de búsqueda, ahora verás tu búsqueda guardada en la sección "Búsquedas guardadas" bajo la barra de búsqueda. Al hacer clic en una búsqueda guardada, se agregará la consulta a la barra de búsqueda y se filtrarán las sugerencias en consecuencia. + + ![Uso de una búsqueda guardada en la barra de búsqueda](/assets/images/help/search/code-search-beta-saved-search-in-search-bar.png) + + - Para editar una búsqueda guardada, en la sección "Búsquedas guardadas", haz clic en {% octicon "pencil" aria-label="The pencil icon" %} a la derecha de la búsqueda guardada. + - Para eliminar una búsqueda guardada, haz clic en {% octicon "trash" aria-label="The trash icon" %} a la derecha de la búsqueda guardada. + + ![Botones para editar o eliminar una búsqueda guardada](/assets/images/help/search/code-search-beta-edit-or-delete-saved-search.png) + +## Uso de la vista de resultados de la búsqueda + +La vista de resultados de la búsqueda ya existe para la búsqueda clásica en GitHub y la funciona de igual para la mayoría de los tipos de búsquedas, excepto para las búsquedas de código. Con la nueva versión beta de búsqueda de código habilitada, la página de resultados de la búsqueda tiene una interfaz de usuario rediseñada e incluye filtros compatibles con el nuevo motor de búsqueda de código, como los filtros de ruta de acceso y de símbolos. + +Para construir una consulta de búsqueda, así como para ver y filtrar los resultados, mediante una interfaz visual, puedes usar la {% data variables.search.search_page_url %} o la {% data variables.search.advanced_url %}. Si presionas Entrar después de escribir una consulta de búsqueda en la barra de búsqueda, también se te dirigirá a la vista de resultados de la búsqueda. + +En la vista de resultados de la búsqueda, puedes navegar entre diferentes tipos de resultados de búsqueda, como código, incidencias, solicitudes de incorporación de cambios, repositorios, etc. También puedes ver y usar filtros. + +![Vista de resultados de la búsqueda](/assets/images/help/search/code-search-beta-results-view.png) diff --git a/translations/es-ES/content/search-github/searching-on-github/searching-code.md b/translations/es-ES/content/search-github/searching-on-github/searching-code.md index 3ac136a456..f91a645bde 100644 --- a/translations/es-ES/content/search-github/searching-on-github/searching-code.md +++ b/translations/es-ES/content/search-github/searching-on-github/searching-code.md @@ -1,6 +1,6 @@ --- -title: Searching code -intro: 'You can search for code on {% data variables.product.product_name %} and narrow the results using these code search qualifiers in any combination.' +title: Código de búsqueda +intro: 'Puedes buscar código en {% data variables.product.product_name %} y acotar los resultados utilizando estos calificadores de búsqueda de código en cualquier combinación.' redirect_from: - /articles/searching-code - /github/searching-for-information-on-github/searching-files-in-a-repository-for-exact-matches @@ -14,108 +14,111 @@ versions: ghec: '*' topics: - GitHub search +ms.openlocfilehash: 125c17f1050cdb6d1b1d5a3d58d3e513eddce40f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160341' --- +{% ifversion github-code-search %} {% note %} -{% ifversion github-code-search %} - {% note %} + **Nota:** {% data reusables.search.classic-search-code-search-note %} - **Note:** {% data reusables.search.classic-search-code-search-note %} + {% endnote %} {% endif %} - {% endnote %} -{% endif %} +{% data reusables.search.you-can-search-globally %} Para obtener más información, vea "[Acerca de la búsqueda en GitHub](/search-github/getting-started-with-searching-on-github/about-searching-on-github)". -{% data reusables.search.you-can-search-globally %} For more information, see "[About searching on GitHub](/search-github/getting-started-with-searching-on-github/about-searching-on-github)." - -You can only search code using these code search qualifiers. Search qualifiers specifically for repositories, users, or commits, will not work when searching for code. +Únicamente puedes buscar código utilizando estos calificadores de búsqueda de código. Los calificadores de búsqueda especialmente para repositorios, usuarios o confirmaciones de cambios, no funcionarán cuando busques código. {% data reusables.search.syntax_tips %} -## Considerations for code search +## Consideraciones para la búsqueda de código -Due to the complexity of searching code, there are some restrictions on how searches are performed: +Debido a la complejidad de la búsqueda de código, hay algunas restricciones sobre cómo se realizan las búsquedas: {% ifversion fpt or ghes or ghec %} - {% data reusables.search.required_login %}{% endif %} -- Code in [forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks) is only searchable if the fork has more stars than the parent repository. Forks with fewer stars than the parent repository are **not** indexed for code search. To include forks with more stars than their parent in the search results, you will need to add `fork:true` or `fork:only` to your query. For more information, see "[Searching in forks](/search-github/searching-on-github/searching-in-forks)." -- Only the _default branch_ is indexed for code search.{% ifversion fpt or ghec %} -- Only files smaller than 384 KB are searchable.{% else %}* Only files smaller than 5 MB are searchable. -- Only the first 500 KB of each file is searchable.{% endif %} -- Up to 4,000 private{% ifversion ghec or ghes or ghae %} and internal{% endif %} repositories are searchable. These 4,000 repositories will be the most recently updated of the first 10,000 private{% ifversion ghec or ghes or ghae %} and internal{% endif %} repositories that you have access to. -- Only repositories with fewer than 500,000 files are searchable.{% ifversion fpt or ghec %} -- Only repositories that have had activity or have been returned in search results in the last year are searchable.{% endif %} -- Except with [`filename`](#search-by-filename) searches, you must always include at least one search term when searching source code. For example, searching for [`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) is not valid, while [`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) is. -- At most, search results can show two fragments from the same file, but there may be more results within the file. -- You can't use the following wildcard characters as part of your search query: . , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ] @. The search will simply ignore these symbols. +- El código en las [bifurcaciones](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks) solo se puede buscar si estas tienen más estrellas que el repositorio primario. Las bifurcaciones con menos estrellas que el repositorio primario **no** se indexan para la búsqueda de código. Para incluir bifurcaciones con más estrellas que sus elementos primarios en los resultados de búsqueda, deberá agregar `fork:true` o `fork:only` a la consulta. Para obtener más información, vea "[Buscar en bifurcaciones](/search-github/searching-on-github/searching-in-forks)". +- Para la búsqueda de código solo se indexa la _rama predeterminada_.{% ifversion fpt or ghec %} +- Solo los archivos menores de 384 KB son indexados.{% else %}* Solo los archivos menores de 5 MB son indexados. +- Solo los primeros 500 KB de cada archivo son indexados.{% endif %} +- Se pueden buscar hasta 4000 repositorios privados{% ifversion ghec or ghes or ghae %} e internos{% endif %}. Estos 4000 repositorios serán los que se han actualizado más recientemente de los primeros 10 000 repositorios privados{% ifversion ghec or ghes or ghae %} e internos{% endif %} a los que tienes acceso. +- Solo se pueden buscar repositorios con menos de 500 000 archivos.{% ifversion fpt or ghec %} +- Solo se pueden hacer búsquedas en los repositorios que han tenido actividad o que se han devuelto en los resultados de búsqueda dentro del último año.{% endif %} +- Con la excepción de las búsquedas de [`filename`](#search-by-filename), siempre debe incluir por lo menos un término de búsqueda cuando busque en el código fuente. Por ejemplo, la búsqueda de [`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) no es válida, mientras que la de [`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) sí lo es. +- A lo sumo, los resultados de búsqueda pueden mostrar dos fragmentos del mismo archivo, pero puede haber más resultados dentro del archivo. +- No puede utilizar los siguientes caracteres comodines como parte de la consulta de búsqueda: . , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ] @. La búsqueda simplemente ignorará estos símbolos. -## Search by the file contents or file path +## Buscar según los contenidos del archivo o la ruta de archivo -With the `in` qualifier you can restrict your search to the contents of the source code file, the file path, or both. When you omit this qualifier, only the file contents are searched. +Con el calificador `in` puede restringir la búsqueda a los contenidos del archivo del código fuente, de la ruta del archivo o de ambos. Cuando omites este calificador, únicamente se busca el contenido del archivo. -| Qualifier | Example +| Calificador: | Ejemplo | ------------- | ------------- -| `in:file` | [**octocat in:file**](https://github.com/search?q=octocat+in%3Afile&type=Code) matches code where "octocat" appears in the file contents. -| `in:path` | [**octocat in:path**](https://github.com/search?q=octocat+in%3Apath&type=Code) matches code where "octocat" appears in the file path. -| | [**octocat in:file,path**](https://github.com/search?q=octocat+in%3Afile%2Cpath&type=Code) matches code where "octocat" appears in the file contents or the file path. +| `in:file` | [**octocat in:file**](https://github.com/search?q=octocat+in%3Afile&type=Code) coincide con el código donde "octocat" aparece en el contenido del archivo. +| `in:path` | [**octocat in:path**](https://github.com/search?q=octocat+in%3Apath&type=Code) coincide con el código donde "octocat" aparece en el contenido de la ruta de acceso. +| | [**octocat in:file, path**](https://github.com/search?q=octocat+in%3Afile%2Cpath&type=Code) coincide con el código donde "octocat" aparece en el contenido del archivo o de la ruta de acceso del archivo. -## Search within a user's or organization's repositories +## Buscar dentro de los repositorios de un usuario u organización -To search the code in all repositories owned by a certain user or organization, you can use the `user` or `org` qualifier. To search the code in a specific repository, you can use the `repo` qualifier. +Para buscar el código en todos los repositorios que son propiedad de una determinada organización o usuario, puede utilizar el calificador `user` o `org`. Para buscar el código en un repositorio específico, puede utilizar el calificador `repo`. -| Qualifier | Example +| Calificador: | Ejemplo | ------------- | ------------- -| user:USERNAME | [**user:defunkt extension:rb**](https://github.com/search?q=user%3Agithub+extension%3Arb&type=Code) matches code from @defunkt that ends in .rb. -| org:ORGNAME |[**org:github extension:js**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+extension%3Ajs&type=Code) matches code from GitHub that ends in .js. -| repo:USERNAME/REPOSITORY | [**repo:mozilla/shumway extension:as**](https://github.com/search?q=repo%3Amozilla%2Fshumway+extension%3Aas&type=Code) matches code from @mozilla's shumway project that ends in .as. +| user:USERNAME | [**user:defunkt extension:rb**](https://github.com/search?q=user%3Agithub+extension%3Arb&type=Code) coincide con el código de @defunkt que termina en .rb. +| org:ORGNAME |[**org:github extension:js**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+extension%3Ajs&type=Code) coincide con el código de GitHub que termina en .js. +| repo:USERNAME/REPOSITORY | [**repo:mozilla/shumway extension:as**](https://github.com/search?q=repo%3Amozilla%2Fshumway+extension%3Aas&type=Code) coincide con el código del proyecto shumway de @mozilla que termina en .as. -## Search by file location +## Buscar por ubicación del archivo -You can use the `path` qualifier to search for source code that appears at a specific location in a repository. Use `path:/` to search for files that are located at the root level of a repository. Or specify a directory name or the path to a directory to search for files that are located within that directory or any of its subdirectories. +Puede utilizar el calificador `path` para buscar el código fuente que aparece en una ubicación específica en un repositorio. Utilice `path:/` para buscar archivos que se encuentren en el nivel raíz de un repositorio. O especifica un nombre de directorio o ruta a un directorio para buscar archivos que estén ubicados dentro de ese directorio o alguno de sus subdirectorios. -| Qualifier | Example +| Calificador: | Ejemplo | ------------- | ------------- -| path:/ | [**octocat filename:readme path:/**](https://github.com/search?utf8=%E2%9C%93&q=octocat+filename%3Areadme+path%3A%2F&type=Code) matches _readme_ files with the word "octocat" that are located at the root level of a repository. -| path:DIRECTORY | [**form path:cgi-bin language:perl**](https://github.com/search?q=form+path%3Acgi-bin+language%3Aperl&type=Code) matches Perl files with the word "form" in the cgi-bin directory, or in any of its subdirectories. -| path:PATH/TO/DIRECTORY | [**`console path:app/public language:javascript`**](https://github.com/search?q=console+path%3A%22app%2Fpublic%22+language%3Ajavascript&type=Code) matches JavaScript files with the word "console" in the app/public directory, or in any of its subdirectories (even if they reside in app/public/js/form-validators). +| path:/ | [**octocat filename:readme path:/**](https://github.com/search?utf8=%E2%9C%93&q=octocat+filename%3Areadme+path%3A%2F&type=Code) coincide con los archivos _léame_ con la palabra "octocat" que se encuentran en el nivel raíz de un repositorio. +| path:DIRECTORY | [**form path:cgi-bin language:perl**](https://github.com/search?q=form+path%3Acgi-bin+language%3Aperl&type=Code) coincide con los archivos Perl con la palabra "form" en el directorio cgi-bin, o en cualquiera de sus subdirectorios. +| path:PATH/TO/DIRECTORY | [ **`console path:app/public language:javascript`**](https://github.com/search?q=console+path%3A%22app%2Fpublic%22+language%3Ajavascript&type=Code) coincide con los archivos de JavaScript con la palabra "console" en el directorio app/public, o en cualquiera de sus subdirectorios (incluso si están en app/public/js/form-validators). -## Search by language +## Buscar por lenguaje -You can search for code based on what language it's written in. The `language` qualifier can be the language name or alias. For a full list of supported languages with their names and aliases, see the [github/linguist repository](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml). +Puedes buscar el código basado en el lenguaje en que está escrito. El calificador `language` puede ser el nombre o alias del lenguaje. Para obtener una lista completa de los lenguajes admitidos con sus nombres y alias, vea el [repositorio github/linguist](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml). -| Qualifier | Example +| Calificador: | Ejemplo | ------------- | ------------- -| language:LANGUAGE | [**element language:xml size:100**](https://github.com/search?q=element+language%3Axml+size%3A100&type=Code) matches code with the word "element" that's marked as being XML and has exactly 100 bytes. -| | [**display language:scss**](https://github.com/search?q=display+language%3Ascss&type=Code) matches code with the word "display," that's marked as being SCSS. -| | [**org:mozilla language:markdown**](https://github.com/search?utf8=%E2%9C%93&q=org%3Amozilla+language%3Amarkdown&type=Code) matches code from all @mozilla's repositories that's marked as Markdown. +| language:LANGUAGE | [**element language:xml size:100**](https://github.com/search?q=element+language%3Axml+size%3A100&type=Code) coincide con el código con la palabra "element" que se marca como XML y tiene exactamente 100 bytes. +| | [**display language:scss**](https://github.com/search?q=display+language%3Ascss&type=Code) coincide con el código con la palabra "display", que se marca como SCSS. +| | [**org:mozilla language:Markdown**](https://github.com/search?utf8=%E2%9C%93&q=org%3Amozilla+language%3Amarkdown&type=Code) coincide con el código de todos los repositorios de @mozilla marcados como Markdown. -## Search by file size +## Buscar por tamaño de archivo -You can use the `size` qualifier to search for source code based on the size of the file where the code exists. The `size` qualifier uses [greater than, less than, and range qualifiers](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax) to filter results based on the byte size of the file in which the code is found. +Puede utilizar el calificador `size` para buscar código fuente en base al tamaño del archivo donde existe el código. El calificador `size` usa [calificadores mayor que, menor que y de rango](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax) para filtrar los resultados en función del tamaño en bytes del archivo en el que se encuentra el código. -| Qualifier | Example +| Calificador: | Ejemplo | ------------- | ------------- -| size:n | [**function size:>10000 language:python**](https://github.com/search?q=function+size%3A%3E10000+language%3Apython&type=Code) matches code with the word "function," written in Python, in files that are larger than 10 KB. +| size:n | [**function size:>10000 language:python**](https://github.com/search?q=function+size%3A%3E10000+language%3Apython&type=Code) coincide con el código con la palabra "function", escrita en Python, en archivos que tienen más de 10 KB. -## Search by filename +## Buscar por nombre de archivo -The `filename` qualifier matches code files with a certain filename. You can also find a file in a repository using the file finder. For more information, see "[Finding files on GitHub](/search-github/searching-on-github/finding-files-on-github)." +El calificador `filename` coincide con archivos de código con un determinado nombre de archivo. También puedes encontrar un archivo en un repositorio utilizando el buscador de archivo. Para obtener más información, vea "[Buscar archivos en GitHub](/search-github/searching-on-github/finding-files-on-github)". -| Qualifier | Example +| Calificador: | Ejemplo | ------------- | ------------- -| filename:FILENAME | [**filename:linguist**](https://github.com/search?utf8=%E2%9C%93&q=filename%3Alinguist&type=Code) matches files named "linguist." -| | [**filename:.vimrc commands**](https://github.com/search?q=filename%3A.vimrc+commands&type=Code) matches *.vimrc* files with the word "commands." -| | [**filename:test_helper path:test language:ruby**](https://github.com/search?q=minitest+filename%3Atest_helper+path%3Atest+language%3Aruby&type=Code) matches Ruby files named *test_helper* within the *test* directory. +| filename:FILENAME | [**filename:linguist**](https://github.com/search?utf8=%E2%9C%93&q=filename%3Alinguist&type=Code) coincide con los archivos denominados "linguist". +| | [**los comandos filename:.vimrc**](https://github.com/search?q=filename%3A.vimrc+commands&type=Code) coinciden con los archivos *.vimrc* con la palabra "commands". +| | [**filename:test_helper path:test language:ruby**](https://github.com/search?q=minitest+filename%3Atest_helper+path%3Atest+language%3Aruby&type=Code) coincide con los archivos Ruby denominados *test_helper* en el directorio de *prueba*. -## Search by file extension +## Buscar por extensión de archivo -The `extension` qualifier matches code files with a certain file extension. +El calificador `extension` coincide con archivos de código con una determinada extensión de archivo. -| Qualifier | Example +| Calificador: | Ejemplo | ------------- | ------------- -| extension:EXTENSION | [**form path:cgi-bin extension:pm**](https://github.com/search?q=form+path%3Acgi-bin+extension%3Apm&type=Code) matches code with the word "form," under cgi-bin, with the .pm file extension. -| | [**icon size:>200000 extension:css**](https://github.com/search?utf8=%E2%9C%93&q=icon+size%3A%3E200000+extension%3Acss&type=Code) matches files larger than 200 KB that end in .css and have the word "icon." +| extension:EXTENSION | [**form path:cgi-bin extension:pm**](https://github.com/search?q=form+path%3Acgi-bin+extension%3Apm&type=Code) coincide con el código con la palabra "form", en cgi-bin, con la extensión de archivo .pm. +| | [**icon size:>200000 extension:css**](https://github.com/search?utf8=%E2%9C%93&q=icon+size%3A%3E200000+extension%3Acss&type=Code) coincide con los archivos de más de 200 KB que terminan en .css y tienen la palabra "icon". -## Further reading +## Información adicional -- "[Sorting search results](/search-github/getting-started-with-searching-on-github/sorting-search-results/)" -- "[Searching in forks](/search-github/searching-on-github/searching-in-forks)"{% ifversion fpt or ghec %} -- "[Navigating code on {% data variables.product.prodname_dotcom %}](/github/managing-files-in-a-repository/navigating-code-on-github)"{% endif %} +- "[Ordenar los resultados de la búsqueda](/search-github/getting-started-with-searching-on-github/sorting-search-results/)" +- "[Buscar bifurcaciones](/search-github/searching-on-github/searching-in-forks)"{% ifversion fpt or ghec %} +- "[Navegar por el código en {% data variables.product.prodname_dotcom %}](/github/managing-files-in-a-repository/navigating-code-on-github)"{% endif %} diff --git a/translations/es-ES/data/features/ip-allow-list-address-check.yml b/translations/es-ES/data/features/ip-allow-list-address-check.yml deleted file mode 100644 index c4dda87a70..0000000000 --- a/translations/es-ES/data/features/ip-allow-list-address-check.yml +++ /dev/null @@ -1,3 +0,0 @@ -versions: - ghec: '*' - ghae: 'issue-7818' diff --git a/translations/es-ES/data/learning-tracks/admin.yml b/translations/es-ES/data/learning-tracks/admin.yml index 6c84460f88..9f45bbaca7 100644 --- a/translations/es-ES/data/learning-tracks/admin.yml +++ b/translations/es-ES/data/learning-tracks/admin.yml @@ -9,7 +9,7 @@ get_started_with_github_ae: - /admin/overview/about-data-residency - /admin/configuration/configuring-your-enterprise/deploying-github-ae - /admin/configuration/initializing-github-ae - - /admin/configuration/restricting-network-traffic-to-your-enterprise + - /admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list - /admin/github-actions/getting-started-with-github-actions-for-github-ae deploy_an_instance: diff --git a/translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md b/translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md index 4cb42a307d..8bc127db04 100644 --- a/translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md +++ b/translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md @@ -7,5 +7,5 @@ To allow your self-hosted runners to communicate with {% data variables.product. {% endwarning %} -To allow your self-hosted {% ifversion actions-hosted-runners %}or larger hosted{% endif %} runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your runners to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." +To allow your self-hosted {% ifversion actions-hosted-runners %}or larger hosted{% endif %} runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your runners to the IP allow list that you have configured for your enterprise. {% endif %} diff --git a/translations/es-ES/data/reusables/actions/private-repository-forks-configure.md b/translations/es-ES/data/reusables/actions/private-repository-forks-configure.md index 7ff3731a54..7f0f970247 100644 --- a/translations/es-ES/data/reusables/actions/private-repository-forks-configure.md +++ b/translations/es-ES/data/reusables/actions/private-repository-forks-configure.md @@ -1,7 +1,13 @@ -1. Under **Fork pull request workflows**, select your options. For example: - {% ifversion actions-private-fork-workflow-approvals %} - ![Enable, disable, or limits actions for this repository](/assets/images/help/settings/actions-fork-pull-request-workflows-require-approval.png){% else %} +--- +ms.openlocfilehash: dc48389e4e331c52d67017151cf599747cc006ee +ms.sourcegitcommit: fdc4466e89467a7b13239e26c6042dc1428946b6 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: "148163841" +--- +1. En **Fork pull request workflows** (Bifurcar flujos de trabajo de solicitud de incorporación de cambios), seleccione las opciones. Por ejemplo: {% ifversion actions-private-fork-workflow-approvals %} ![Habilitación, deshabilitación o limitación de acciones para este repositorio](/assets/images/help/settings/actions-fork-pull-request-workflows-require-approval.png){% else %} - ![Enable, disable, or limits actions for this repository](/assets/images/help/settings/actions-fork-pull-request-workflows.png){% endif %} + ![Habilitación, deshabilitación o limitación de acciones para este repositorio](/assets/images/help/settings/actions-fork-pull-request-workflows.png){% endif %} -1. Click **Save** to apply the settings. +1. Haga clic en **Save** (Guardar) para aplicar los valores. diff --git a/translations/es-ES/data/reusables/actions/private-repository-forks-options.md b/translations/es-ES/data/reusables/actions/private-repository-forks-options.md index 7e7219bd70..c3db5d42b1 100644 --- a/translations/es-ES/data/reusables/actions/private-repository-forks-options.md +++ b/translations/es-ES/data/reusables/actions/private-repository-forks-options.md @@ -1,4 +1,12 @@ -- **Run workflows from fork pull requests** - Allows users to run workflows from fork pull requests, using a `GITHUB_TOKEN` with read-only permission, and with no access to secrets. -- **Send write tokens to workflows from pull requests** - Allows pull requests from forks to use a `GITHUB_TOKEN` with write permission. -- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.{% ifversion actions-private-fork-workflow-approvals %} -- **Require approval for fork pull request workflows** - Workflow runs on pull requests from collaborators without write permission will require approval from someone with write permission before they will run.{% endif %} +--- +ms.openlocfilehash: d9874c3884e3191a0296272fbead8f30b7630e5a +ms.sourcegitcommit: fdc4466e89467a7b13239e26c6042dc1428946b6 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: "148163837" +--- +- **Ejecutar flujos de trabajo desde solicitudes de incorporación de cambios de bifurcación**: permite a los usuarios ejecutar flujos de trabajo desde solicitudes de incorporación de cambios de bifurcación, utilizando un `GITHUB_TOKEN` con permiso de solo lectura y sin acceso a secretos. +- **Enviar tokens de escritura a flujos de trabajo desde solicitudes de incorporación de cambios**: permite que las solicitudes de incorporación de cambios de bifurcaciones usen un `GITHUB_TOKEN` con permiso de escritura. +- **Enviar secretos a flujos de trabajo desde solicitudes de incorporación de cambios**: hace que todos los secretos estén disponibles para la solicitud de incorporación de cambios.{% ifversion actions-private-fork-workflow-approvals %} +- **Requerir aprobación para flujos de trabajo de solicitud de incorporación de cambios de bifurcación**: las ejecuciones de flujo de trabajo en solicitudes de incorporación de cambios de colaboradores sin permiso de escritura requerirá la aprobación de alguien con permiso de escritura antes de que se ejecuten. {% endif %} diff --git a/translations/es-ES/data/reusables/actions/ref_protected-description.md b/translations/es-ES/data/reusables/actions/ref_protected-description.md index 009979a247..8203c66b7f 100644 --- a/translations/es-ES/data/reusables/actions/ref_protected-description.md +++ b/translations/es-ES/data/reusables/actions/ref_protected-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: e3a5d34c1e7fa7964296417f959e02f7d25322d1 -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a +ms.openlocfilehash: aa83ecff715eed06bc0b455344b227e8676ee4e3 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/11/2022 -ms.locfileid: "145069510" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179636" --- -`true` si se han configurado protecciones de rama para la referencia que ha desencadenado la ejecución de flujo de trabajo. +`true` si se han configurado protecciones de rama para la referencia que ha desencadenado la ejecución de flujo de trabajo. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/actions/ref_type-description.md b/translations/es-ES/data/reusables/actions/ref_type-description.md index 503df22282..606d78aa9a 100644 --- a/translations/es-ES/data/reusables/actions/ref_type-description.md +++ b/translations/es-ES/data/reusables/actions/ref_type-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: eb37287768f8539b10e549b5407c9aeb1170d1eb -ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d +ms.openlocfilehash: efa01b1ee2415e7b0aa1cc919fec24801839d2db +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/11/2022 -ms.locfileid: "145092043" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179629" --- -El tipo de ref que activó la ejecución de flujo de trabajo. Los valores válidos son `branch` y `tag`. +El tipo de ref que activó la ejecución de flujo de trabajo. Los valores válidos son `branch` y `tag`. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/actions/run_id_description.md b/translations/es-ES/data/reusables/actions/run_id_description.md index 1ae6ce40c4..4726d1e8cf 100644 --- a/translations/es-ES/data/reusables/actions/run_id_description.md +++ b/translations/es-ES/data/reusables/actions/run_id_description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: d2eb1d49e6bb3057ce347b8bdd37f7f1a66014fa -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 3ceb785289a3b263eebda76d766bab52d6cec3c3 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145069490" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179623" --- -Un número único para cada ejecución de flujo de trabajo dentro de un repositorio. Este número no cambia si vuelves a ejecutar el flujo de trabajo. +Un número único para cada ejecución de flujo de trabajo dentro de un repositorio. Este número no cambia si vuelves a ejecutar el flujo de trabajo. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/actions/run_number_description.md b/translations/es-ES/data/reusables/actions/run_number_description.md index bb01adb904..c09f4fafd1 100644 --- a/translations/es-ES/data/reusables/actions/run_number_description.md +++ b/translations/es-ES/data/reusables/actions/run_number_description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 4e92d27887f94b524e0e5d9c2d007b29e2dbb28b -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 +ms.openlocfilehash: d3a31b63ff15fefd904ffeb91bb195e24cbafe19 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147879317" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179647" --- -Un número único para cada ejecución de un flujo de trabajo particular en un repositorio. Este número comienza por 1 para la primera ejecución del flujo de trabajo y aumenta con cada nueva ejecución. Este número no cambia si vuelves a ejecutar el flujo de trabajo. +Un número único para cada ejecución de un flujo de trabajo particular en un repositorio. Este número comienza por 1 para la primera ejecución del flujo de trabajo y aumenta con cada nueva ejecución. Este número no cambia si vuelves a ejecutar el flujo de trabajo. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/actions/runner-arch-description.md b/translations/es-ES/data/reusables/actions/runner-arch-description.md index 94b93fd922..dfa025085e 100644 --- a/translations/es-ES/data/reusables/actions/runner-arch-description.md +++ b/translations/es-ES/data/reusables/actions/runner-arch-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: af8eda15fb2efa1997bec460be9f8d9549171c71 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 +ms.openlocfilehash: 217ff84c9edd02f476d3f25f01d384f46ab05e0c +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: "145092028" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179642" --- -La arquitectura del ejecutor que ejecuta el job. Los valores posibles son `X86`, `X64`, `ARM` o `ARM64`. +La arquitectura del ejecutor que ejecuta el job. Los valores posibles son `X86`, `X64`, `ARM` o `ARM64`. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/actions/runner-debug-description.md b/translations/es-ES/data/reusables/actions/runner-debug-description.md index 1d049c6c49..6e37658589 100644 --- a/translations/es-ES/data/reusables/actions/runner-debug-description.md +++ b/translations/es-ES/data/reusables/actions/runner-debug-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: e97366a49253e628513ace9247bb7f4c9301aa80 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 +ms.openlocfilehash: 1b97b54e74b57343a5bc824c86e2849f99c5f6a8 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/09/2022 -ms.locfileid: "147614557" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179655" --- -Esto solo se establece si el [registro de depuración](/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging) está habilitado y siempre tiene el valor de `1`. Puede ser útil como indicador para habilitar la depuración adicional o el registro detallado en tus propios pasos de trabajo. +Esto solo se establece si el [registro de depuración](/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging) está habilitado y siempre tiene el valor de `1`. Puede ser útil como indicador para habilitar la depuración adicional o el registro detallado en tus propios pasos de trabajo. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/actions/runner-name-description.md b/translations/es-ES/data/reusables/actions/runner-name-description.md index b99a4e6c33..43cb226d8b 100644 --- a/translations/es-ES/data/reusables/actions/runner-name-description.md +++ b/translations/es-ES/data/reusables/actions/runner-name-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 92f9c6962ced87f0075e67d91920b4262d376bbe -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 +ms.openlocfilehash: 99093fe4bc8da22d7507cd16ffdbf5c3756ae83f +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147879322" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179641" --- -El nombre del ejecutor que ejecuta el job. +El nombre del ejecutor que ejecuta el job. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/actions/runner-os-description.md b/translations/es-ES/data/reusables/actions/runner-os-description.md index 2582411139..397027449f 100644 --- a/translations/es-ES/data/reusables/actions/runner-os-description.md +++ b/translations/es-ES/data/reusables/actions/runner-os-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 4bf3f1a9bd94d5faf665ceab4c30925162bf2977 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 78f1e2366d4ae9645f335439efa2bb040194bea9 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145092025" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179618" --- -El sistema operativo del ejecutor que ejecuta el trabajo. Los valores posibles son `Linux`, `Windows` o `macOS`. +El sistema operativo del ejecutor que ejecuta el trabajo. Los valores posibles son `Linux`, `Windows` o `macOS`. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/actions/runner-temp-directory-description.md b/translations/es-ES/data/reusables/actions/runner-temp-directory-description.md index dfec8d81b8..71bf865d64 100644 --- a/translations/es-ES/data/reusables/actions/runner-temp-directory-description.md +++ b/translations/es-ES/data/reusables/actions/runner-temp-directory-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 2e1561ff6bfee56d135e4897fbc6d42e252a7809 -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a +ms.openlocfilehash: b29e97e5613dbe28ac0769e4f814027d581a93a2 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/11/2022 -ms.locfileid: "145069471" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179635" --- -La ruta a un directorio temporal en el ejecutor. Este directorio se vacía al inicio y al final de cada job. Nota que los archivos no se eliminarán si la cuenta de usuario del ejecutor no tiene permisos para borrarlos. +La ruta a un directorio temporal en el ejecutor. Este directorio se vacía al inicio y al final de cada job. Nota que los archivos no se eliminarán si la cuenta de usuario del ejecutor no tiene permisos para borrarlos. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/actions/runner-tool-cache-description.md b/translations/es-ES/data/reusables/actions/runner-tool-cache-description.md index c21836d1bf..5f215e8c4a 100644 --- a/translations/es-ES/data/reusables/actions/runner-tool-cache-description.md +++ b/translations/es-ES/data/reusables/actions/runner-tool-cache-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 6945058380431dbf753ad8dd9ce03c032193a46a -ms.sourcegitcommit: 76b840f45ba85fb79a7f0c1eb43bc663b3eadf2b +ms.openlocfilehash: b0adac22b7786fb4e5b712d86b4a0379611ab2ec +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/12/2022 -ms.locfileid: "145092024" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179617" --- -La ruta al directorio que contiene las herramientas preinstaladas para los ejecutores hospedados en {% data variables.product.prodname_dotcom %}. Para más información, vea "[Acerca de los ejecutores hospedados en {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". +La ruta al directorio que contiene las herramientas preinstaladas para los ejecutores hospedados en {% data variables.product.prodname_dotcom %}. Para más información, vea "[Acerca de los ejecutores hospedados en {% data variables.product.prodname_dotcom %}](/actions/reference/specifications-for-github-hosted-runners/#supported-software)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/actions/supported-github-runners.md b/translations/es-ES/data/reusables/actions/supported-github-runners.md index 884fdb2bbf..2599a33141 100644 --- a/translations/es-ES/data/reusables/actions/supported-github-runners.md +++ b/translations/es-ES/data/reusables/actions/supported-github-runners.md @@ -1,29 +1,21 @@ ---- -ms.openlocfilehash: c30f6000486156f1995f0f05ff27fc173b893de5 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147529276" ---- - - - + + + @@ -38,7 +30,7 @@ Windows Server 2019 + @@ -100,12 +95,12 @@ Realiza la migración a macOS-11 o macOS-12. Para obte {% note %} -**Nota:** Las imágenes de ejecutores `-latest` son las últimas imágenes estables que proporciona {% data variables.product.prodname_dotcom %} y puede que no sean las versiones más recientes de los sistemas operativos disponibles desde los proveedores de estos. +**Note:** The `-latest` runner images are the latest stable images that {% data variables.product.prodname_dotcom %} provides, and might not be the most recent version of the operating system available from the operating system vendor. {% endnote %} {% warning %} -Nota: Las imágenes beta y en desuso se proporcionan "tal cual", "con todos sus fallos" y "conforme estén disponibles" y están excluidas del acuerdo de nivel de servicio y de la garantía. El soporte al cliente podría no cubrir las imágenes beta. +**Warning:** Beta and Deprecated Images are provided "as-is", "with all faults" and "as available" and are excluded from the service level agreement and warranty. Beta Images may not be covered by customer support. {% endwarning %} diff --git a/translations/es-ES/data/reusables/advanced-security/more-information-about-enforcement-policy.md b/translations/es-ES/data/reusables/advanced-security/more-information-about-enforcement-policy.md index 7984960256..3f672e2dfd 100644 --- a/translations/es-ES/data/reusables/advanced-security/more-information-about-enforcement-policy.md +++ b/translations/es-ES/data/reusables/advanced-security/more-information-about-enforcement-policy.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 1b37f350d1a16509df7b661fcde678b6599b3f09 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 1da05f80c01813e53ccdb66c877587e3b2268d34 +ms.sourcegitcommit: 8d9e10685cfb2556fba0ce07484a3b9579808703 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147879465" +ms.lasthandoff: 11/18/2022 +ms.locfileid: "148172158" --- -Para más información, vea "[Aplicación de directivas para {% data variables.product.prodname_advanced_security %} en la empresa]({% ifversion fpt %}/enterprise-cloud@latest{% endif %}/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)". +Para más información, vea "[Aplicación de directivas para {% data variables.product.prodname_advanced_security %} en la empresa]({% ifversion fpt %}/enterprise-cloud@latest{% endif %}/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/classroom/assignments-guide-choose-visibility.md b/translations/es-ES/data/reusables/classroom/assignments-guide-choose-visibility.md index 2f68906487..7d06e33319 100644 --- a/translations/es-ES/data/reusables/classroom/assignments-guide-choose-visibility.md +++ b/translations/es-ES/data/reusables/classroom/assignments-guide-choose-visibility.md @@ -1,15 +1,11 @@ --- -ms.openlocfilehash: 66fdbca75762848fce18a18321fd082a844cfa3f -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: ec67345b92fb3aba571c6932ccc3b67d77473726 +ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145115809" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179732" --- -Los repositorios de una tarea pueden ser públicos o privados. Si utilizas repositorios privados, solo el alumno o equipo puede ver la retroalimentación que proporciones. - -También puedes decidir si quieres otorgar a los alumnos permisos administrativos en el repositorio para una tarea. Otorga permisos administrativos si es que el alumno debe realizar tareas administrativas en el repositorio de tareas. Para más información, vea "[Acerca de los repositorios](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)" y "[Roles de repositorio para una organización](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)". - Selecciona una visibilidad debajo de "Visibilidad del repositorio". Opcionalmente, seleccione **Conceder a los alumnos acceso administrativo a su repositorio**.
diff --git a/translations/es-ES/data/reusables/classroom/assignments-repository-visibility-and-permissions.md b/translations/es-ES/data/reusables/classroom/assignments-repository-visibility-and-permissions.md new file mode 100644 index 0000000000..85a2e1ba8c --- /dev/null +++ b/translations/es-ES/data/reusables/classroom/assignments-repository-visibility-and-permissions.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: f5dc693751e91ffe9b472a5c99c1f359902873a0 +ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179853" +--- +Los repositorios de una tarea pueden ser públicos o privados. Si utilizas repositorios privados, solo el alumno o equipo puede ver la retroalimentación que proporciones. + +También puedes decidir si quieres otorgar a los alumnos permisos administrativos en el repositorio para una tarea. Otorga permisos administrativos si es que el alumno debe realizar tareas administrativas en el repositorio de tareas. Para más información, vea "[Acerca de los repositorios](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)" y "[Roles de repositorio para una organización](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/about-features.md b/translations/es-ES/data/reusables/codespaces/about-features.md new file mode 100644 index 0000000000..22a4e144d6 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/about-features.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 55348a01f34b4eb85873a075b637bdff802fcef3 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159987" +--- +Las características son unidades independientes de código de instalación y configuración del contenedor de desarrollo diseñadas para funcionar en una amplia gama de imágenes de contenedor base. Puedes usar características para agregar rápidamente herramientas, runtimes o bibliotecas a la imagen de codespace. Para obtener más información, consulta las [características disponibles](https://containers.dev/features) y la [especificación de las características](https://containers.dev/implementors/features/) en containers.dev. + +Puedes agregar características a un archivo `devcontainer.json` desde {% data variables.product.prodname_vscode_shortname %} o desde tu repositorio en {% data variables.product.prodname_dotcom_the_website %}. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/about-publishing-templates.md b/translations/es-ES/data/reusables/codespaces/about-publishing-templates.md new file mode 100644 index 0000000000..93fe1ca7c5 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/about-publishing-templates.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: 88adaa8f671dd9eb805301c3e659bcdba76f24cc +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160334" +--- +Cuando trabajas en un codespace creado a partir de una plantilla, el trabajo se guarda en una máquina virtual en la nube, pero no se almacena en un repositorio en {% data variables.product.prodname_dotcom %}. + +Puedes guardar tus archivos, cerrar y detener el codespace y retomar el trabajo más adelante. Normalmente, Git viene preinstalado y el directorio de trabajo se inicializará automáticamente como repositorio de Git a menos hayas empezado desde la plantilla en blanco de {% data variables.product.company_short %}. Esto significa que puedes usar Git de inmediato para el control de código fuente local, como la adición y la confirmación de archivos. + +Sin embargo, si eliminas un codespace no publicado o si se elimina automáticamente al no usarse durante el período de retención, tu trabajo también se eliminará. Para conservar el trabajo y permitir que otros usuarios trabajen en el proyecto, deberás publicar el codespace en un repositorio en {% data variables.product.prodname_dotcom %}. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/application-installed-locally.md b/translations/es-ES/data/reusables/codespaces/application-installed-locally.md new file mode 100644 index 0000000000..99ea4a46e4 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/application-installed-locally.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: cdcd2ca433a74eef0f9a768c6db21b9ac708ccd1 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159812" +--- +Si eliges **{% data variables.product.prodname_vscode %}** o **Puerta de enlace de JetBrains**, debes asegurarse de haber instalado la aplicación seleccionada en el equipo local. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/codespace-logs.md b/translations/es-ES/data/reusables/codespaces/codespace-logs.md new file mode 100644 index 0000000000..d074ac4484 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/codespace-logs.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 945a4c8f9249f6153a4fe51e4f53c2b4b16cf060 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160343" +--- +## Bitácoras de Codespace + +Estos registros contienen información detallada sobre el codespace, el contenedor, la sesión y el entorno de {% data variables.product.prodname_vscode_shortname %}. Son útiles para diagnosticar los problemas de conexión y otros comportamientos inesperados. Por ejemplo, el codespace se congela pero la opción de "Recargar Windows" lo descongela por algunos minutos, o se te desconecta aleatoriamente del codespace, pero te puedes volver a conectar de inmediato. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/codespaces-continue-by-paying.md b/translations/es-ES/data/reusables/codespaces/codespaces-continue-by-paying.md new file mode 100644 index 0000000000..2d412ce5f6 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/codespaces-continue-by-paying.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 73174295d5ab0a8f7b5fb9cebc3dbb4412409c3a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159820" +--- +Para seguir usando {% data variables.product.prodname_github_codespaces %} más allá del almacenamiento y del uso de proceso mensuales incluidos, proporciona la información de pago y establece un límite de gasto. Para más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/codespaces-free-for-personal-intro.md b/translations/es-ES/data/reusables/codespaces/codespaces-free-for-personal-intro.md new file mode 100644 index 0000000000..2a2be9dba1 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/codespaces-free-for-personal-intro.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 1f6226c3fdf40ed1108934afd16966a9696a154d +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160310" +--- +La facturación de {% data variables.product.prodname_github_codespaces %} la paga una organización, una empresa o una cuenta personal. Los planes Gratis y Pro para cuentas personales incluyen el uso gratuito de {% data variables.product.prodname_github_codespaces %} hasta una cantidad fija de uso cada mes. diff --git a/translations/es-ES/data/reusables/codespaces/codespaces-jetbrains-beta-note.md b/translations/es-ES/data/reusables/codespaces/codespaces-jetbrains-beta-note.md new file mode 100644 index 0000000000..d4266b7de4 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/codespaces-jetbrains-beta-note.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: 7c6428ee82232f9609978bbb6f166623b1de6a6c +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159884" +--- +{% note %} + +**Nota**: El uso de {% data variables.product.prodname_github_codespaces %} con un IDE de JetBrains se encuentra actualmente en versión beta pública y está sujeto a cambios. + +{% endnote %} diff --git a/translations/es-ES/data/reusables/codespaces/codespaces-machine-type-availability.md b/translations/es-ES/data/reusables/codespaces/codespaces-machine-type-availability.md index c2ee725789..1fa74abaa6 100644 --- a/translations/es-ES/data/reusables/codespaces/codespaces-machine-type-availability.md +++ b/translations/es-ES/data/reusables/codespaces/codespaces-machine-type-availability.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: bde9df5c980a7448c30645675dc13086c1094fdc -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 32a0269159f5f1556cd96d10ef75915fe84b05c0 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147882887" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159875" --- -Tu elección de los tipos de máquina disponibles podría estar limitada por una directiva configurada para la organización o por una especificación mínima del tipo de máquina para el repositorio. Para más información, vea "[Restricción del acceso a los tipos de máquina](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" y "[Configuración de una especificación mínima para las máquinas de los codespaces](/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines)". +La elección de los tipos de máquina disponibles puede estar limitada por varios factores. Estos pueden incluir una directiva configurada para la organización o una especificación mínima del tipo de máquina para el repositorio. Para más información, vea "[Restricción del acceso a los tipos de máquina](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" y "[Configuración de una especificación mínima para las máquinas de los codespaces](/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines)". diff --git a/translations/es-ES/data/reusables/codespaces/codespaces-machine-types.md b/translations/es-ES/data/reusables/codespaces/codespaces-machine-types.md index ba141e5b7a..55c434f9fe 100644 --- a/translations/es-ES/data/reusables/codespaces/codespaces-machine-types.md +++ b/translations/es-ES/data/reusables/codespaces/codespaces-machine-types.md @@ -1,11 +1,11 @@ --- -ms.openlocfilehash: 2a61633813730ae2a55d43d2d2cf976fda95784f -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a +ms.openlocfilehash: 9e66c56694869bc5479af2930548104fe373ec12 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147111118" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160339" --- -Normalmente, puedes ejecutar tu codespace en la máquina remota de tu elección, desde 2 hasta 32 núcleos. Cada una de estas tiene un nivel de recursos y de facturación diferentes. Para obtener información, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". +Normalmente, puedes ejecutar tu codespace en los tipos de máquina remota de tu elección. Estos tipos de máquina ofrecen una selección de especificaciones de hardware que van desde 2 núcleos a 32 núcleos, aunque es posible que la gama completa de tipos de máquina no siempre esté disponible. Cada uno de los tipos de máquina tiene un nivel de recursos y de facturación diferente. Para obtener información, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". De forma predeterminada, al crear un codespace se utiliza el tipo de máquina con los recursos válidos más bajos. diff --git a/translations/es-ES/data/reusables/codespaces/codespaces-spending-limit-requirement.md b/translations/es-ES/data/reusables/codespaces/codespaces-spending-limit-requirement.md index 9c886492a7..7cacf1c2c0 100644 --- a/translations/es-ES/data/reusables/codespaces/codespaces-spending-limit-requirement.md +++ b/translations/es-ES/data/reusables/codespaces/codespaces-spending-limit-requirement.md @@ -1,7 +1,15 @@ +--- +ms.openlocfilehash: 7d64df6146c09aa6cd5fc997ccb96022fab29501 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159233" +--- {% note %} -**Note:** You must set a non-zero spending limit on your personal, organization, or enterprise account before the account can be billed for use of {% data variables.product.prodname_github_codespaces %}. +**Nota:** Debes establecer un límite de gasto distinto de cero en tu cuenta personal, de organización o de empresa para que se pueda facturar a la cuenta por el uso de {% data variables.product.prodname_github_codespaces %}. {% endnote %} -By default, all accounts have a {% data variables.product.prodname_github_codespaces %} spending limit of $0 USD. This prevents new codespaces being created, or existing codespaces being opened, if doing so would incur a billable cost to your personal, organization, or enterprise account. For personal accounts, codespaces can always be created and used if the account has not reached the limit of its monthly included usage. For organizations and enterprises, the default spending limit means that, to allow people to create codespaces that are billed to the organization, or its parent enterprise, the limit must be changed to a value above $0 USD. +De forma predeterminada, todas las cuentas tienen un límite de gasto de {% data variables.product.prodname_github_codespaces %} de 0 USD. Esto impide que se creen codespaces o que se abran codespaces existentes, si esto supone que se incurra en un costo facturable para la cuenta personal, de organización o de empresa. En el caso de las cuentas personales, siempre se pueden crear y usar codespaces si la cuenta no ha alcanzado el límite de uso mensual incluido. En el caso de las organizaciones y las empresas, el límite de gasto predeterminado significa que, para que los usuarios puedan crear codespaces que se facturan a la organización, o a su empresa matriz, el límite debe cambiarse a un valor superior a 0 USD. diff --git a/translations/es-ES/data/reusables/codespaces/configuration-choice-templates.md b/translations/es-ES/data/reusables/codespaces/configuration-choice-templates.md new file mode 100644 index 0000000000..d91bacd273 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/configuration-choice-templates.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 9a7f2eacb54b6133ec322f00ced9c0325747838c +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159819" +--- +Cuando los usuarios crean codespaces con el botón **Usar esta plantilla** de un repositorio de plantillas, no se les permitirá elegir entre varias configuraciones. El codespace se compilará en función de la configuración predeterminada definida en `.devcontainer/devcontainer.json`, o bien en `.devcontainer.json` en la raíz del repositorio. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/copilot-in-vscode.md b/translations/es-ES/data/reusables/codespaces/copilot-in-vscode.md new file mode 100644 index 0000000000..518271f5b2 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/copilot-in-vscode.md @@ -0,0 +1,17 @@ +--- +ms.openlocfilehash: 56d362df2d0dc32b709c6e6d9cc1b8910ac81be5 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159843" +--- +[{% data variables.product.prodname_copilot %}](https://copilot.github.com/), un programador de pares de IA, se puede usar en cualquier codespace. Para obtener más información, consulta "[Acerca de GitHub Copilot](/copilot/overview-of-github-copilot/about-github-copilot)". + +Para empezar a usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_github_codespaces %}, instala la [extensión de {% data variables.product.prodname_copilot %} desde {% data variables.product.prodname_vscode_marketplace %}](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot). + +Para incluir {% data variables.product.prodname_copilot %}, u otras extensiones, en todos los codespaces, habilita la sincronización de la configuración. Para más información, consulta "[Personalización de {% data variables.product.prodname_github_codespaces %} para la cuenta](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#settings-sync)". Además, para incluir {% data variables.product.prodname_copilot %} en un proyecto determinado para todos los usuarios, puedes especificar `GitHub.copilot` como una extensión en el archivo `devcontainer.json`. Para obtener información sobre cómo configurar un archivo `devcontainer.json`, consulta "[Introducción a los contenedores de desarrollo](/codespaces/customizing-your-codespace/configuring-codespaces-for-your-project#creating-a-custom-dev-container-configuration)". + +## Información adicional + +- "[Introducción a GitHub Copilot en Visual Studio Code](/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code)" \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/creating-a-codespace-in-vscode.md b/translations/es-ES/data/reusables/codespaces/creating-a-codespace-in-vscode.md index 3dafc1ad37..ce308e938a 100644 --- a/translations/es-ES/data/reusables/codespaces/creating-a-codespace-in-vscode.md +++ b/translations/es-ES/data/reusables/codespaces/creating-a-codespace-in-vscode.md @@ -1,30 +1,38 @@ -After you connect your account on {% data variables.product.prodname_dotcom_the_website %} to the {% data variables.product.prodname_github_codespaces %} extension, you can create a new codespace. For more information about the {% data variables.product.prodname_github_codespaces %} extension, see the [{% data variables.product.prodname_vs_marketplace_shortname %}](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). +--- +ms.openlocfilehash: d8f0e4e19ba362881f261a214aa56666f5902979 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148158585" +--- +Después de conectar tu cuenta de {% data variables.product.prodname_dotcom_the_website %} a la extensión de {% data variables.product.prodname_github_codespaces %}, puedes crear un codespace. Para obtener más información sobre la extensión de {% data variables.product.prodname_github_codespaces %}, consulta el [{% data variables.product.prodname_vs_marketplace_shortname %}](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). {% data reusables.codespaces.click-remote-explorer-icon-vscode %} -2. Click the Add icon: {% octicon "plus" aria-label="The plus icon" %}. +2. Haz clic el icono de Agregar: {% octicon "plus" aria-label="The plus icon" %}. - ![The Create new Codespace option in {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/create-codespace-vscode.png) + ![Opción para crear un codespace en {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/create-codespace-vscode.png) -3. Type the name of the repository you want to develop in, then select it. +3. Escribe el nombre del repositorio en el que quieres desarrollar y selecciónalo. - ![Searching for repository to create a new codespace](/assets/images/help/codespaces/choose-repository-vscode.png) + ![Búsqueda de un repositorio para crear un codespace](/assets/images/help/codespaces/choose-repository-vscode.png) - If the repository you choose is owned by an organization, and the organization has configured codespaces for this repository to be billable to the organization, or its parent enterprise, a message will be displayed in subsequent prompts telling you who will pay for the codespace. + Si el repositorio que eliges es propiedad de una organización y esta ha configurado los codespaces de este repositorio de modo que se facturen a la organización o a su empresa principal, en los mensajes posteriores se indicará quién paga el codespace. -4. Click the branch you want to develop on. +4. Da clic en la rama en la que quieras desarrollar. - ![Searching for a branch to create a new codespace](/assets/images/help/codespaces/choose-branch-vscode.png) + ![Búsqueda de una rama para crear un codespace](/assets/images/help/codespaces/choose-branch-vscode.png) -5. If prompted to choose a dev container configuration file, choose a file from the list. +5. Si se te pide que elijas un archivo de configuración de contenedor de desarrollo, selecciona un archivo en la lista. - ![Choosing a dev container configuration file for {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/choose-dev-container-vscode.png) + ![Selección del archivo de configuración de un contenedor de desarrollo para {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/choose-dev-container-vscode.png) -6. Click the machine type you want to use. +6. Elige el tipo de máquina que quieres utilizar. - ![Instance types for a new codespace](/assets/images/help/codespaces/choose-sku-vscode.png) + ![Tipos de instancia para un nuevo codespace](/assets/images/help/codespaces/choose-sku-vscode.png) {% note %} - **Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} + **Nota**: {% data reusables.codespaces.codespaces-machine-type-availability %} {% endnote %} diff --git a/translations/es-ES/data/reusables/codespaces/developing-in-vscode.md b/translations/es-ES/data/reusables/codespaces/developing-in-vscode.md new file mode 100644 index 0000000000..77ae2d1a5d --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/developing-in-vscode.md @@ -0,0 +1,26 @@ +--- +ms.openlocfilehash: 71aea4a0d9c72885e56e7aef5a20b36bf817fec5 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160060" +--- +### Personalización de los codespaces para un repositorio + +Puedes personalizar los codespaces creados para un repositorio creando o actualizando la configuración del contenedor de desarrollo para el repositorio. Puedes hacerlo desde un codespace. Después de cambiar una configuración de contenedor de desarrollo, puedes aplicar los cambios en el codespace actual si recompilas el contenedor de Docker para el codespace. Para obtener más información, consulte "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". + +### Personalizar tu codespace + +Puedes usar un repositorio [dotfiles](https://dotfiles.github.io/tutorials/) y [Sincronización de ajustes](https://code.visualstudio.com/docs/editor/settings-sync) para personalizar aspectos del entorno de codespace para cualquier codespace que crees. La personalización puede incluir preferencias de shell y herramientas adicionales. Para más información, vea "[Personalización de {% data variables.product.prodname_codespaces %} para la cuenta](/codespaces/setting-up-your-codespace/personalizing-codespaces-for-your-account)". + +### Ejecutar tu app desde un codespace +{% data reusables.codespaces.about-port-forwarding %} Para obtener más información, consulte "[Reenvío de puertos en su codespace](/github/developing-online-with-codespaces/forwarding-ports-in-your-codespace)". + +### Configramr tus cambios + +{% data reusables.codespaces.committing-link-to-procedure %} + +### Utilizar la {% data variables.product.prodname_vscode_command_palette %} + +La {% data variables.product.prodname_vscode_command_palette %} te permite acceder y administrar muchas de las características para {% data variables.product.prodname_codespaces %} y {% data variables.product.prodname_vscode %}. Para obtener más información, consulte "[Uso de {% data variables.product.prodname_vscode_command_palette %} en {% data variables.product.prodname_codespaces %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/edit-devcontainer-json.md b/translations/es-ES/data/reusables/codespaces/edit-devcontainer-json.md index f05caca292..2b60d84fb4 100644 --- a/translations/es-ES/data/reusables/codespaces/edit-devcontainer-json.md +++ b/translations/es-ES/data/reusables/codespaces/edit-devcontainer-json.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 38208812f73fda89c12d251955a1eee327ceb8db -ms.sourcegitcommit: 27882d9b3f19979c817c25952a2fb4dc4c6f0a65 +ms.openlocfilehash: 363a170cc5f062ac400e868eb920e1e035ac8fd8 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 10/27/2022 -ms.locfileid: "148114118" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159145" --- -1. Los {% data variables.product.prodname_github_codespaces %} del repositorio se configuran en un archivo `devcontainer.json`. Si el repositorio aún no contiene un archivo `devcontainer.json`, agregue uno ahora. Consulta "[Adición de una configuración de contenedor de desarrollo al repositorio](/free-pro-team@latest/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)". \ No newline at end of file +1. Los {% data variables.product.prodname_github_codespaces %} del repositorio se pueden configurar en un archivo `devcontainer.json`. Si el repositorio aún no contiene un archivo `devcontainer.json`, puedes agregar uno ahora. Consulta "[Adición de una configuración de contenedor de desarrollo al repositorio](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/exporting-changes.md b/translations/es-ES/data/reusables/codespaces/exporting-changes.md index acf3e17ee4..8e357438c4 100644 --- a/translations/es-ES/data/reusables/codespaces/exporting-changes.md +++ b/translations/es-ES/data/reusables/codespaces/exporting-changes.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: dbfc559ca9be38d03d5bcd7c884687f098025ea9 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 63705338500bed176d013288ee7b091e593300ec +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/11/2022 -ms.locfileid: "145115354" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148158609" --- -Si llegas a un límite de gastos, ya no podrás crear o reanudar tus codespaces. Todavía puede [exportar cualquier cambio del trabajo en curso a una nueva rama](/codespaces/troubleshooting/exporting-changes-to-a-branch). +Si tu cuenta personal, de organización o de empresa alcanza su límite de gasto, ya no podrás crear ni reanudar los codespaces facturables a esa cuenta. Sin embargo, todavía puedes exportar cualquier cambio en curso del trabajo a una nueva rama. Para obtener más información, vea "[Exportación de cambios a una rama](/codespaces/troubleshooting/exporting-changes-to-a-branch)". diff --git a/translations/es-ES/data/reusables/codespaces/gpg-in-active-codespaces.md b/translations/es-ES/data/reusables/codespaces/gpg-in-active-codespaces.md new file mode 100644 index 0000000000..e7050980b7 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/gpg-in-active-codespaces.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 9f5ba15be4cbdf524f825469d291bd3df970f974 +ms.sourcegitcommit: 47e03737d09bed84dfedb7be5924d893d34ea1a8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/16/2022 +ms.locfileid: "148167120" +--- +Una vez habilites la comprobación de GPG, surtirá efecto automáticamente en los nuevos espacios de código que crees a partir de los repositorios pertinentes. Para que la comprobación de GPG surta efecto en un espacio de código activo existente, deberás detener y reiniciar el espacio de código. Para más información, consulta: "[Detención e inicio de un espacio de código](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)." \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/jetbrains-open-codespace-plugin.md b/translations/es-ES/data/reusables/codespaces/jetbrains-open-codespace-plugin.md new file mode 100644 index 0000000000..07e3579eaf --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/jetbrains-open-codespace-plugin.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: f9f3e238032c9256fa1d6e5432c79e2736a5a30a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160335" +--- +1. En el cliente de JetBrains, haz clic en el complemento de {% data variables.product.prodname_github_codespaces %} para mostrar la ventana de herramientas de {% data variables.product.prodname_github_codespaces %}. + + ![Captura de pantalla de la ventana de herramientas de {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/jetbrains-codespaces-tool-window.png) diff --git a/translations/es-ES/data/reusables/codespaces/jupyterlab-in-default-image.md b/translations/es-ES/data/reusables/codespaces/jupyterlab-in-default-image.md new file mode 100644 index 0000000000..d3ae5ad4ce --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/jupyterlab-in-default-image.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: c3900e59c91a3d0afd192b5ff948b612bfe0ba64 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160052" +--- +La imagen de contenedor predeterminada incluye JupyterLab, por lo que los codespaces creados a partir de la imagen predeterminada siempre lo tendrán instalado. Para obtener más información sobre la imagen predeterminada, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#using-the-default-dev-container-configuration)" y [el `devcontainers/images` repositorio](https://github.com/devcontainers/images/tree/main/src/universal). Si no usa la imagen predeterminada en la configuración del contenedor de desarrollo, puedes instalar JupyterLab agregando la característica `ghcr.io/devcontainers/features/python` al archivo `devcontainer.json`. Debes incluir la opción `"installJupyterlab": true`. Para obtener más información, consulta [el archivo Léame de la característica `python`](https://github.com/devcontainers/features/tree/main/src/python#python-python), en el repositorio `devcontainers/features`. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/jupyterlab-installed-in-codespace.md b/translations/es-ES/data/reusables/codespaces/jupyterlab-installed-in-codespace.md new file mode 100644 index 0000000000..c911a32c63 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/jupyterlab-installed-in-codespace.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 1e6e9e375bb024561c279007909ab7a46f47b8a9 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160308" +--- +La aplicación JupyterLab debe estar instalada en el codespace que estás abriendo. {% data reusables.codespaces.jupyterlab-in-default-image %} \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/links-to-get-started.md b/translations/es-ES/data/reusables/codespaces/links-to-get-started.md index 5f5456a524..afcbee07b3 100644 --- a/translations/es-ES/data/reusables/codespaces/links-to-get-started.md +++ b/translations/es-ES/data/reusables/codespaces/links-to-get-started.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 6d1607f3c2d1c775f5328d13ff4cb458d82037a0 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: b942594848833f5ccdeba0f4f6388e463591eac6 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109945" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148158953" --- -Para empezar a trabajar con {% data variables.product.prodname_github_codespaces %}, consulta "[Inicio rápido de {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/quickstart)". Para obtener más información sobre cómo crear o volver a abrir un codespace, consulta "[Creación de un codespace](/codespaces/developing-in-codespaces/creating-a-codespace)" y "[Apertura de un codespace existente](/codespaces/developing-in-codespaces/opening-an-existing-codespace)". Para obtener más información sobre cómo funciona {% data variables.product.prodname_github_codespaces %}, consulta "[Profundización en {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive)". +Para empezar a trabajar con {% data variables.product.prodname_github_codespaces %}, consulta "[Inicio rápido de {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/quickstart)". Para obtener más información sobre cómo crear un codespace, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)" o "[Creación de un codespace a partir de una plantilla](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)". Si quieres volver a un codespace que has creado, consulta "[Apertura de un codespace existente](/codespaces/developing-in-codespaces/opening-an-existing-codespace)". Para obtener más información sobre cómo funciona {% data variables.product.prodname_github_codespaces %}, consulta "[Profundización en {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive)". diff --git a/translations/es-ES/data/reusables/codespaces/machine-types-for-unpublished-codespaces.md b/translations/es-ES/data/reusables/codespaces/machine-types-for-unpublished-codespaces.md new file mode 100644 index 0000000000..0338db1ee9 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/machine-types-for-unpublished-codespaces.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 2511362f6aa19d917b5cf8488a368c9dd52b09a1 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159988" +--- +Los codespaces no publicados (codespaces creados a partir de una plantilla que no estén vinculados a un repositorio de {% data variables.product.product_name %}) siempre se ejecutarán en una máquina virtual con las mismas especificaciones. No se puede cambiar el tipo de máquina de un codespace no publicado. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/monthly-spending-limit-codespaces.md b/translations/es-ES/data/reusables/codespaces/monthly-spending-limit-codespaces.md new file mode 100644 index 0000000000..367112c0b3 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/monthly-spending-limit-codespaces.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 78eee4151cf6c88b83875b990e895707127e5421 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160084" +--- +1. En "Codespaces", elige entre limitar los gastos o permitir gastos ilimitados. + + ![Captura de pantalla de los botones de radio para limitar los gastos o permitir gastos ilimitados](/assets/images/help/billing/limit-or-unlimited-codespaces.png) diff --git a/translations/es-ES/data/reusables/codespaces/navigating-to-a-codespace.md b/translations/es-ES/data/reusables/codespaces/navigating-to-a-codespace.md new file mode 100644 index 0000000000..e64d6d1853 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/navigating-to-a-codespace.md @@ -0,0 +1,16 @@ +--- +ms.openlocfilehash: 3263bcf4439cdee99cbf589dde18dcb92af1ec00 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160337" +--- +## Navegar a un codespace existente + +1. {% data reusables.codespaces.you-can-see-all-your-codespaces %} +1. Da clic en el nombre del codespace en el cual quieras desarrollar. + + ![Nombre del codespace](/assets/images/help/codespaces/click-name-codespace.png) + +También puedes ver cualquiera de tus codespaces en un repositorio específico si navegas hasta ese repositorio y seleccionas **{% octicon "code" aria-label="The code icon" %} Código**. El menú desplegable mostrará todos los codespaces activos en un repositorio. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/open-template-in-codespace-step.md b/translations/es-ES/data/reusables/codespaces/open-template-in-codespace-step.md new file mode 100644 index 0000000000..f66ad322f5 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/open-template-in-codespace-step.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 0193cb7b3950276f157e8ef2a84a958278cfc800 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160328" +--- +1. Encima de la lista de archivos, haz clic en **Usar esta plantilla** y, después, selecciona **Abrir en un codespace**. + + ![Botón Usar esta plantilla](/assets/images/help/repository/use-this-template-button.png) \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/opening-codespace-in-jetbrains.md b/translations/es-ES/data/reusables/codespaces/opening-codespace-in-jetbrains.md new file mode 100644 index 0000000000..3f76988d56 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/opening-codespace-in-jetbrains.md @@ -0,0 +1,34 @@ +--- +ms.openlocfilehash: 52206649d45bd9d76bcc593adeffa47318a70880 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160327" +--- +Si has establecido la puerta de enlace de JetBrains como editor predeterminado, la puerta de enlace se iniciará automáticamente al abrir un espacio de código desde {% data variables.product.prodname_dotcom_the_website %}. + +Si la puerta de enlace de JetBrains no es el editor predeterminado, todavía puedes abrir un codespace en JetBrains; para ello, ve a la página "Sus codespaces" en [github.com/codespaces](https://github.com/codespaces) y haz clic en los puntos suspensivos (...) a la derecha del espacio de código que quieres abrir. Para obtener más información, consulta "[Apertura de un espacio de código existente](/codespaces/developing-in-codespaces/opening-an-existing-codespace?tool=webui)". + +Como alternativa, también puedes abrir la puerta de enlace de JetBrains y seleccionar un espacio de código existente, como se describe en el procedimiento siguiente. + +1. Abre la aplicación de Puerta de enlace de JetBrains. +1. Haz clic en **Conectar con {% data variables.product.prodname_codespaces %}** . + + ![Captura de pantalla de la vista inicial de la Puerta de enlace de JetBrains](/assets/images/help/codespaces/jetbrains-gateway-connect.png) + +1. En la lista "Your Codespaces", haz clic en el codespace en el que quieres trabajar. + + ![Captura de pantalla de la lista de codespaces de puerta de enlace de JetBrains](/assets/images/help/codespaces/jetbrains-gateway-codespaces.png) + +1. En la lista "IDE disponibles", haz clic en el IDE de JetBrains que quieres usar. La puerta de enlace recordará tu elección la próxima vez que te conectes a un codespace. + + ![Captura de pantalla de la lista de codespaces de puerta de enlace de JetBrains](/assets/images/help/codespaces/jetbrains-gateway-ides.png) + +1. Haga clic en **Conectar**. + + {% note %} + + **Nota**: _Si ejecuta un firewall:_ la primera vez que te conectas a un recurso remoto, es posible que se te pida que permitas que la puerta de enlace de JetBrains se comunique a través de la red. + + {% endnote %} diff --git a/translations/es-ES/data/reusables/codespaces/port-forwarding-adding-non-jetbrains.md b/translations/es-ES/data/reusables/codespaces/port-forwarding-adding-non-jetbrains.md new file mode 100644 index 0000000000..adfa110487 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/port-forwarding-adding-non-jetbrains.md @@ -0,0 +1,17 @@ +--- +ms.openlocfilehash: 5aef043edaeaf981964defece5a3a008a89ee5b8 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160321" +--- +## Agregar el peurto a la configuración del codespace + +Puedes agregar un puerto reenviado a la configuración de {% data variables.product.prodname_github_codespaces %} del repositorio para que este pueda reenviarse automáticamente a todos los codespaces que se crearon desde el repositorio. Después de que actualizas la configuración, cualquier codespace creado debe reconstruirse para que el cambio se aplique. Para obtener más información, consulte "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)". + +Puedes configurar manualmente los puertos reenviados en un archivo `.devcontainer.json` mediante la propiedad `forwardPorts` o puedes usar el panel "Puertos" en un codespace que hayas abierto en el explorador o en la aplicación de escritorio de {% data variables.product.prodname_vscode_shortname %}. + +{% data reusables.codespaces.navigate-to-ports-tab %} +1. Haga clic con el botón derecho en el puerto que quiera agregar a la configuración del codespace y, después, haga clic en **Configurar etiqueta y actualizar devcontainer.json**. + ![Opción para establecer la etiqueta y agregar un puerto a devcontainer.json en el menú contextual](/assets/images/help/codespaces/update-devcontainer-to-add-port-option.png) {% data reusables.codespaces.type-port-label %} \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/port-forwarding-labeling-non-jetbrains.md b/translations/es-ES/data/reusables/codespaces/port-forwarding-labeling-non-jetbrains.md new file mode 100644 index 0000000000..8be45c1471 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/port-forwarding-labeling-non-jetbrains.md @@ -0,0 +1,15 @@ +--- +ms.openlocfilehash: b85601bfdb4f5333e435878cba013882ed9c7f74 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160027" +--- +## Etiquetar un puerto + +Al abrir un codespace en el explorador o en la aplicación de escritorio {% data variables.product.prodname_vscode_shortname %}, puedes etiquetar un puerto reenviado para facilitar la identificación en una lista. + +{% data reusables.codespaces.navigate-to-ports-tab %} +1. Pasa el mouse sobre el puerto que quieras etiquetar y luego haz clic en el icono de etiqueta. + ![Icono de etiqueta para el puerto](/assets/images/help/codespaces/label-icon.png) {% data reusables.codespaces.type-port-label %} \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/prebuilds-permission-authorization.md b/translations/es-ES/data/reusables/codespaces/prebuilds-permission-authorization.md index 304f321401..16de037c80 100644 --- a/translations/es-ES/data/reusables/codespaces/prebuilds-permission-authorization.md +++ b/translations/es-ES/data/reusables/codespaces/prebuilds-permission-authorization.md @@ -1,10 +1,10 @@ --- -ms.openlocfilehash: c32a9f6f6a799c3653cb17fe89721090fc01d155 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: bb81ad72418e81366595d963296493a7a3b55202 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109942" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148158681" --- Si la configuración del contenedor de desarrollo para el repositorio especifica permisos para acceder a otros repositorios, se te mostrará una página de autorización. Para obtener más información sobre cómo se especifica esto en el archivo `devcontainer.json`, consulta "[Administración del acceso a otros repositorios del codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)". @@ -12,7 +12,7 @@ ms.locfileid: "148109942" ![Captura de pantalla de la página de autorización para precompilaciones](/assets/images/help/codespaces/prebuild-authorization-page.png) - Haz clic en **Autorizar y continuar** para conceder estos permisos para la creación de la precompilación. Como alternativa, puedes hacer clic en **Continuar sin autorizar**, pero, si lo haces, es posible que los espacios de código creados a partir de la precompilación resultante no funcionen correctamente. + Haz clic en **Autorizar y continuar** para conceder estos permisos para la creación de precompilaciones. Como alternativa, puedes hacer clic en **Continuar sin autorizar**, pero, si lo haces, es posible que los codespaces creados a partir de las precompilaciones resultantes no funcionen correctamente. {% note %} diff --git a/translations/es-ES/data/reusables/codespaces/publishing-template-codespaces.md b/translations/es-ES/data/reusables/codespaces/publishing-template-codespaces.md new file mode 100644 index 0000000000..4750aacadf --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/publishing-template-codespaces.md @@ -0,0 +1,34 @@ +--- +ms.openlocfilehash: a78c61511f0daa225bc27576a2ab57e8e1bea939 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160320" +--- +Si estás trabajando en un codespace, podrás publicarlo desde la aplicación de escritorio o el cliente web de {% data variables.product.prodname_vscode_shortname %}. + +{% data reusables.codespaces.source-control-display-dark %} +1. Para agregar los cambios al "stage", haz clic en **+** junto al archivo que hayas añadido o cambiado o junto a **Cambios** si has cambiado varios archivos y quieres agregarlos todos al "stage". + + ![Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado](/assets/images/help/codespaces/codespaces-commit-stage.png) + + {% note %} + + **Nota:** Si empiezas desde una plantilla en blanco de {% data variables.product.company_short %}, no verás una lista de cambios a menos que ya hayas inicializado el directorio como repositorio de Git. Para publicar codespaces creados a partir de la plantilla en blanco, haz clic en **Publicar en {% data variables.product.company_short %}** en la vista Control de código fuente y, luego, ve al paso 5. + + {% endnote %} +2. Para confirmar los cambios agregados al "stage", escribe un mensaje de confirmación en el que se describa el cambio realizado y, a continuación, haz clic en **Confirmar**. + + ![Barra de control de código fuente con un mensaje de confirmación](/assets/images/help/codespaces/vscode-commit-button.png) +3. Haz clic en **Publicar rama**. + + ![Captura de pantalla del botón "Publicar rama" en VS Code](/assets/images/help/codespaces/vscode-publish-branch-button.png) +4. En la lista desplegable "Nombre del repositorio", escribe un nombre para el nuevo repositorio y selecciona **Publicar en el repositorio privado {% data variables.product.company_short %}** o **Publicar en el repositorio público {% data variables.product.company_short %}** . + + ![Captura de pantalla de la lista desplegable "Nombre del repositorio" en VS Code](/assets/images/help/codespaces/choose-new-repository.png) + + El propietario del nuevo repositorio será la cuenta {% data variables.product.prodname_dotcom %} con la que creaste el codespace. +5. También puedes hacer clic en **Abrir en {% data variables.product.company_short %}** en el elemento emergente que aparece en la esquina inferior derecha del editor para ver el nuevo repositorio en {% data variables.product.prodname_dotcom_the_website %}. + + ![Captura de pantalla del elemento emergente "Abrir en GitHub" en VS Code](/assets/images/help/codespaces/open-on-github.png) \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/rebuild-command.md b/translations/es-ES/data/reusables/codespaces/rebuild-command.md index fc2b9867c9..e60ef5447f 100644 --- a/translations/es-ES/data/reusables/codespaces/rebuild-command.md +++ b/translations/es-ES/data/reusables/codespaces/rebuild-command.md @@ -1,11 +1,5 @@ ---- -ms.openlocfilehash: 2a9a8aec377e545ba9eecac42e61e9cdff9c4bfd -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/09/2022 -ms.locfileid: "147760883" ---- -1. Accede a {% data variables.product.prodname_vscode_command_palette_shortname %} (Comando+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux)) y, a continuación, empieza a escribir "recompilar". Seleccione **Codespaces: Rebuild Container**. +1. Access the {% data variables.product.prodname_vscode_command_palette_shortname %} (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)), then start typing "rebuild". Select **Codespaces: Rebuild Container**. - ![Opción de recompilar contenedor](/assets/images/help/codespaces/codespaces-rebuild.png) + ![Screenshot of Rebuild Container command in the Command Pallette](/assets/images/help/codespaces/codespaces-rebuild.png) + + {% indented_data_reference reusables.codespaces.full-rebuild-tip %} diff --git a/translations/es-ES/data/reusables/codespaces/setting-up-project-intro.md b/translations/es-ES/data/reusables/codespaces/setting-up-project-intro.md new file mode 100644 index 0000000000..9c5963c758 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/setting-up-project-intro.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 21daaf99777a364391eb83e7c9addbd0d1947265 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159876" +--- +en {% data variables.product.prodname_codespaces %} mediante la aplicación de escritorio {% data variables.product.prodname_vscode %} o el cliente web {% data variables.product.prodname_vscode_shortname %}. Te mostrará un ejemplo de cómo abrir tu proyecto en un codespace y cómo agregar y modificar una configuración de contenedor de dev predeterminada. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/setup-custom-devcontainer.md b/translations/es-ES/data/reusables/codespaces/setup-custom-devcontainer.md index ca9a195c45..311f6c6179 100644 --- a/translations/es-ES/data/reusables/codespaces/setup-custom-devcontainer.md +++ b/translations/es-ES/data/reusables/codespaces/setup-custom-devcontainer.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 8fce179b1aa62f79737c46329d11f3e375dc375c -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 7c8d446316e97bed4e63b3eb5ae7b8f9b1e4da40 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147060302" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159867" --- -Para configurar el repositorio a fin de usar un contenedor de desarrollo personalizado, deberás crear uno o varios archivos `devcontainer.json`. Puedes agregarlos desde una plantilla, en {% data variables.product.prodname_vscode %}, o bien puedes escribir los tuyos propios. Para obtener más información sobre las configuraciones de los contenedores de desarrollo, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project)". +Para configurar el repositorio a fin de usar un contenedor de desarrollo personalizado, deberás crear uno o varios archivos `devcontainer.json`. Puedes agregarlos desde una plantilla de configuración predefinida, en {% data variables.product.prodname_vscode %}, o bien puedes escribir los tuyos propios. Para obtener más información sobre las configuraciones de los contenedores de desarrollo, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". diff --git a/translations/es-ES/data/reusables/codespaces/source-control-commit-changes.md b/translations/es-ES/data/reusables/codespaces/source-control-commit-changes.md index 3882a3446d..d128b05f2c 100644 --- a/translations/es-ES/data/reusables/codespaces/source-control-commit-changes.md +++ b/translations/es-ES/data/reusables/codespaces/source-control-commit-changes.md @@ -1,10 +1,10 @@ --- -ms.openlocfilehash: 8cb17c6661826a0d46c37436b05b9f694541dab1 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 0591199ee1d92622aaef5c89e7dcc3d1eab89bfe +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145139146" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160326" --- {% data reusables.codespaces.source-control-display-dark %} 1. Para agregar los cambios al "stage", haga clic en **+** junto al archivo que ha cambiado, o junto a **Cambios** si ha cambiado varios archivos y quiere agregarlos todos. diff --git a/translations/es-ES/data/reusables/codespaces/source-control-pull-request.md b/translations/es-ES/data/reusables/codespaces/source-control-pull-request.md index f0fa01ae6c..2a80706444 100644 --- a/translations/es-ES/data/reusables/codespaces/source-control-pull-request.md +++ b/translations/es-ES/data/reusables/codespaces/source-control-pull-request.md @@ -1,10 +1,10 @@ --- -ms.openlocfilehash: 32ab6120ced32f068eda9d9b9b1823352685f4ed -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 +ms.openlocfilehash: fe4475ec888b22062f49db7a8e87034125a35c94 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: "145139125" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159804" --- 1. Después de haber confirmado los cambios en la copia local del repositorio, haga clic en el icono **Create Pull Request**. ![Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado](/assets/images/help/codespaces/codespaces-commit-pr-button.png) diff --git a/translations/es-ES/data/reusables/codespaces/source-control.md b/translations/es-ES/data/reusables/codespaces/source-control.md new file mode 100644 index 0000000000..bf33e23220 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/source-control.md @@ -0,0 +1,63 @@ +--- +ms.openlocfilehash: c760b3f26f89437d485cc222de4fbc54fa907735 +ms.sourcegitcommit: f464cc9bfc41132f315ea172c591bfd145a06736 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/15/2022 +ms.locfileid: "148165464" +--- +## Publicación de un codespace creado a partir de una plantilla + +Al crear un codespace a partir de un repositorio de plantillas o una plantilla en la página "Tus codespaces", el trabajo que realices no se almacenará en un repositorio de {% data variables.product.prodname_dotcom %} hasta que no publiques el codespace. Para obtener más información, consulta "[Creación de un codespace a partir de una plantilla](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-to-a-repository-on-github)". + +{% data reusables.codespaces.publishing-template-codespaces %} + +## Crear o cambiar de rama + +{% data reusables.codespaces.create-or-switch-branch %} + +{% tip %} + +**Sugerencia**: Si alguien ha modificado recientemente un archivo en el repositorio remoto, en la rama a la que hayas cambiado quizá no veas estos cambios hasta que los extraigas en el codespace. + +{% endtip %} + +## Configramr tus cambios + +{% data reusables.codespaces.source-control-commit-changes %} + +## Extraer cambios del repositorio remoto + +Puedes extraer cambios del repositorio remoto hacia tu codespace en cualquier momento. + +{% data reusables.codespaces.source-control-display-dark %} +1. En la parte superior de la barra lateral, haz clic en los puntos suspensivos ( **...** ). ![Botón de puntos suspensivos para las opciones Ver y Más acciones](/assets/images/help/codespaces/source-control-ellipsis-button.png) +1. En el menú desplegable, haz clic en **Extraer**. + +Si el la configuración del contenedor dev cambió desde que creaste el codespace, puedes aplicar los cambios si recompilas el contenedor para el codespace. Para más información, vea "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project#applying-changes-to-your-configuration)". + +## Configurar tu codespace para que recupere los cambios nuevos automáticamente + +Puedes configurar tu codespace para que recupere automáticamente los detalles de cualquier confirmación nueva que se haya hecho al repositorio remoto. Esto te permite ver si tu copia local del repositorio está desactualizada, en cuyo caso, podrías elegir extraer los cambios nuevos. + +Si la operación de búsqueda detecta cambios nuevos en el repositorio remoto, verás la cantidad de confirmaciones nuevas en la barra de estado. Luego podrás extraer los cambios en tu copia local. + +1. Haga clic en el botón **Administrar** en la parte inferior de la barra de actividad. +![Botón Administrar](/assets/images/help/codespaces/manage-button.png) +1. En el menú, haga clic en **Configuración**. +1. En la página Configuración, busque: `autofetch`. +![Búsqueda de captura automática](/assets/images/help/codespaces/autofetch-search.png) +1. Para capturar detalles de las actualizaciones de todos los remotos registrados para el repositorio actual, establezca **Captura automática de Git** en `all`. +![Habilitación de la captura automática de Git](/assets/images/help/codespaces/autofetch-all.png) +1. Si quiere cambiar la cantidad de segundos entre cada captura automática, edite el valor de **Git: Periodo de captura automática**. + +## Levantar una solicitud de cambios + +{% data reusables.codespaces.source-control-pull-request %} + +## Subir cambios a tu repositorio remoto + +Puedes insertar los cambios que hayas guardado y confirmado. Esto aplica a aquellos de la rama ascendente en el repositorio remoto. Puede que necesites hacer eso si aún no estás listo para crear una solicitud de cambios o si prefieres crearla en {% data variables.product.prodname_dotcom %}. + +1. En la parte superior de la barra lateral, haz clic en los puntos suspensivos ( **...** ). ![Botón de puntos suspensivos para las opciones Ver y Más acciones](/assets/images/help/codespaces/source-control-ellipsis-button-nochanges.png) +1. En el menú desplegable, haz clic en **Insertar**. diff --git a/translations/es-ES/data/reusables/codespaces/ssh-server-installed.md b/translations/es-ES/data/reusables/codespaces/ssh-server-installed.md new file mode 100644 index 0000000000..3beaa0af51 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/ssh-server-installed.md @@ -0,0 +1,19 @@ +--- +ms.openlocfilehash: 8c155db26d97e1f845638c790dd3cf1114eac47a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160340" +--- +El codespace al que te conectes debe ejecutar un servidor SSH. La imagen de contenedor predeterminada incluye un servidor SSH, que se inicia automáticamente. Si los codespaces no se crean a partir de la imagen predeterminada, puedes instalar e iniciar un servidor SSH agregando lo siguiente al objeto `features` en el archivo `devcontainer.json`. + +```json +"features": { + ... + "ghcr.io/devcontainers/features/sshd:1": { + "version": "latest" + }, + ... +} +``` \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/starting-new-project-template.md b/translations/es-ES/data/reusables/codespaces/starting-new-project-template.md new file mode 100644 index 0000000000..31b69a334a --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/starting-new-project-template.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 175259e6863efa78d746eef4f78de4acfa3bc6c7 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160020" +--- +Si vas a iniciar un nuevo proyecto, es posible que desees crear un codespace a partir de una plantilla y publicar en un repositorio en {% data variables.product.product_name %} más tarde. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/stopping-a-codespace.md b/translations/es-ES/data/reusables/codespaces/stopping-a-codespace.md index 6d4688e6cb..577e59cac5 100644 --- a/translations/es-ES/data/reusables/codespaces/stopping-a-codespace.md +++ b/translations/es-ES/data/reusables/codespaces/stopping-a-codespace.md @@ -1,13 +1,13 @@ --- -ms.openlocfilehash: 5431cd0a877d3a87e4dd22fc3503bb9f67058b76 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 4bdcc6ff93e7671d4dc368fc44784c963f549aae +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109941" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159049" --- -Puedes detener un codespace en cualquier momento. Cuando detienes un codespace, cualquier proceso en ejecución se detendrá y el historial de la terminal se limpiará. Cualquier cambio que hayas guardado en tu codespace aún estará disponible cuando lo vuelvas a iniciar. Si no detienes un codespace explícitamente, este seguirá ejecutándose hasta que se detenga por inactividad. Para más información, vea "[Tiempos de espera de Codespaces](/codespaces/developing-in-codespaces/codespaces-lifecycle#codespaces-timeouts)". +Puedes detener un codespace en cualquier momento. Cuando detienes un codespace, cualquier proceso en ejecución se detendrá y el historial de la terminal se limpiará. Cualquier cambio que hayas guardado en tu codespace aún estará disponible cuando lo vuelvas a iniciar. Si no detienes un codespace explícitamente, este seguirá ejecutándose hasta que se detenga por inactividad. Para obtener más información, consulta "[El ciclo de vida del espacio de código](/codespaces/developing-in-codespaces/the-codespace-lifecycle#timeouts-for-github-codespaces)". -Solo los codespaces en ejecución incurren en cargos por uso de CPU; un codespace que se haya detenido solo incurrirá en costos de almacenamiento. +Solo los codespaces en ejecución incurren en cargos de CPU. Un espacio de código detenido solo conlleva costes de almacenamiento. Es posible que debas detener y reiniciar un codespace para que se apliquen los cambios a este. Por ejemplo, si cambias el tipo de máquina que utilizas para tu codespace, necesitarás detenerlo y reiniciarlo para que el cambio tome efecto. También puedes detener tu codespace y elegir restablecerlo o borrarlo si encuentras un error o algo inesperado. diff --git a/translations/es-ES/data/reusables/codespaces/template-codespaces-default-editor.md b/translations/es-ES/data/reusables/codespaces/template-codespaces-default-editor.md new file mode 100644 index 0000000000..756e289411 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/template-codespaces-default-editor.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 56dc7f61a1ed68ffdb7e90f7edae615a8e428cad +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159956" +--- +Al crear un nuevo codespace a partir de una plantilla, siempre se abre en el cliente web de {% data variables.product.prodname_vscode %}. Puedes volver a abrir un codespace existente en cualquier editor compatible. Para obtener más información, consulta "[Apertura de un codespace existente](/codespaces/developing-in-codespaces/opening-an-existing-codespace)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/usage-report-download.md b/translations/es-ES/data/reusables/codespaces/usage-report-download.md new file mode 100644 index 0000000000..ba76daae2b --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/usage-report-download.md @@ -0,0 +1,21 @@ +--- +ms.openlocfilehash: c03f2677064bae6362b21c172725d334a2b22994 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160318" +--- +1. Opcionalmente, junto a "Uso este mes", haz clic en **Obtener informe de uso** para recibir un correo electrónico que contenga un vínculo para descargar un informe CSV de uso de almacenamiento de {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %} y {% data variables.product.prodname_github_codespaces %}. El correo electrónico se envía a la dirección de correo electrónico principal de la cuenta. Puedes elegir si el informe debe abarcar los últimos 7, 30, 90 o 180 días. + + ![Descarga del informe CSV](/assets/images/help/billing/actions-packages-report-download.png) + + Los datos que se usan para este informe se actualizan a diario. + + Para ver los costes del uso de proceso y almacenamiento de {% data variables.product.prodname_github_codespaces %}, filtra el informe de modo que muestre solo las filas que mencionan "Codespaces" en la columna `Product`. + + ![Captura de pantalla de un informe de uso filtrado para {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/CSV-usage-report.png) + + Para ver solo los costes de crear, actualizar y almacenar precompilaciones, filtra el informe de modo que muestre solo las filas que mencionan "Crear precompilaciones de Codespaces" en la columna `Actions Workflow`. + + ![Captura de pantalla de un informe de uso filtrado para precompilaciones](/assets/images/help/codespaces/CSV-usage-report-prebuilds.png) diff --git a/translations/es-ES/data/reusables/codespaces/use-chrome.md b/translations/es-ES/data/reusables/codespaces/use-chrome.md index 6f841fb0a5..705838a3df 100644 --- a/translations/es-ES/data/reusables/codespaces/use-chrome.md +++ b/translations/es-ES/data/reusables/codespaces/use-chrome.md @@ -1,2 +1,10 @@ +--- +ms.openlocfilehash: 28b050801ea07a3ef9a6644f45e9e987c9ed21a9 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160316" +--- -For the best experience with {% data variables.product.prodname_github_codespaces %}, we recommend using a Chromium-based browser, like Google Chrome or Microsoft Edge. +Para una mejor experiencia con {% data variables.product.prodname_github_codespaces %}, te recomendamos utilizar un explorador basado en Chromium, como Google Chrome o Microsoft Edge. diff --git a/translations/es-ES/data/reusables/codespaces/view-all-templates-step.md b/translations/es-ES/data/reusables/codespaces/view-all-templates-step.md new file mode 100644 index 0000000000..0e9d7de1c7 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/view-all-templates-step.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 97424b3eef10bea63f1cb8006fc600107ab1a57b +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159868" +--- +1. Para ver la lista completa de plantillas, en "Explorar plantillas de inicio rápido", haz clic en **Ver todo**. + + ![Captura de pantalla de la sección "Explorar plantillas de inicio rápido", con la opción "Ver todo" resaltada](/assets/images/help/codespaces/codespace-templates-see-all.png) \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/vscode-interface-annotation.md b/translations/es-ES/data/reusables/codespaces/vscode-interface-annotation.md new file mode 100644 index 0000000000..3d6d9e4938 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/vscode-interface-annotation.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: e534b88265d2daba3b103080c5ed050adfb89459 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160317" +--- +1. **Barra lateral**: de manera predeterminada, en esta área se muestran los archivos del proyecto en Explorer. +2. **Barra de actividades**: muestra las vistas y proporciona una manera de cambiar entre ellas. Puedes volver a ordenar las vistas si las arrastras y las sueltas. +3. **Editor**: aquí es donde se editan los archivos. Puedes hacer clic con el botón derecho en la pestaña de un archivo para acceder a opciones como la de buscar el archivo en Explorer. +4. **Paneles**: aquí es donde puedes ver la información de salida y depuración, así como el lugar predeterminado para el terminal integrado. +5. **Barra de estado**: esta área te proporciona información útil sobre el codespace y el proyecto. Por ejemplo, el nombre de rama, los puertos configurados y más. diff --git a/translations/es-ES/data/reusables/dependabot/dependabot-alerts-filters.md b/translations/es-ES/data/reusables/dependabot/dependabot-alerts-filters.md new file mode 100644 index 0000000000..30e694b7a7 --- /dev/null +++ b/translations/es-ES/data/reusables/dependabot/dependabot-alerts-filters.md @@ -0,0 +1,14 @@ +You can sort and filter {% data variables.product.prodname_dependabot_alerts %} by typing filters as `key:value` pairs into the search bar. + +| Option | Description | Example | +|:---|:---|:---| +| `ecosystem` | Displays alerts for the selected ecosystem | Use `ecosystem:npm` to show {% data variables.product.prodname_dependabot_alerts %} for npm |{% ifversion fpt or ghec or ghes > 3.5 or ghae > 3.5 %} +| `has` | Displays alerts meeting the selected filter criteria | Use `has:patch` to show alerts related to advisories that have a patch{% ifversion dependabot-alerts-vulnerable-calls %}
Use `has:vulnerable-calls` to show alerts relating to calls to vulnerable functions{% endif %} |{% endif %} +| `is` | Displays alerts based on their state | Use `is:open` to show open alerts | +| `manifest` | Displays alerts for the selected manifest | Use `manifest:webwolf/pom.xml` to show alerts on the pom.xml file of the webwolf application | +| `package` | Displays alerts for the selected package | Use `package:django` to show alerts for django | +| `resolution` | Displays alerts of the selected resolution status | Use `resolution:no-bandwidth` to show alerts previously parked due to lack of resources or time to fix them | +| `repo` | Displays alerts based on the repository they relate to
Note that this filter is only available on the security overview. For more information, see "[About the security overview](/code-security/security-overview/about-the-security-overview)" | Use `repo:octocat-repo` to show alerts in the repository called `octocat-repo` |{%- ifversion dependabot-alerts-development-label %} +| `scope` | Displays alerts based on the scope of the dependency they relate to | Use `scope:development` to show alerts for dependencies that are only used during development |{% endif %} +| `severity` | Displays alerts based on their level of severity | Use `severity:high` to show alerts with a severity of High |{%- ifversion dependabot-most-important-sort-option %} +| `sort` | Displays alerts according to the selected sort order | The default sorting option for alerts is `sort:most-important`, which ranks alerts by importance
Use `sort:newest` to show the latest alerts reported by {% data variables.product.prodname_dependabot %} |{% endif %} diff --git a/translations/es-ES/data/reusables/education/student-codespaces-benefit.md b/translations/es-ES/data/reusables/education/student-codespaces-benefit.md new file mode 100644 index 0000000000..5eeeef7033 --- /dev/null +++ b/translations/es-ES/data/reusables/education/student-codespaces-benefit.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 3d5f9723fc9c1778d8e98d24b3997710a468c12b +ms.sourcegitcommit: aa67bb5ad7aa6804c5def4390e30adcc7cf96ea1 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/15/2022 +ms.locfileid: "148165197" +--- +Los alumnos verificados obtienen el uso gratuito de {% data variables.product.prodname_github_codespaces %} hasta 180 horas básicas cada mes para sus cuentas personales. La cantidad mensual de almacenamiento y horas de uso del núcleo disponibles para los alumnos equivale a la cantidad incluida en las cuentas {% data variables.product.prodname_pro %}. Para más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/enterprise-accounts/emu-azure-admin-consent.md b/translations/es-ES/data/reusables/enterprise-accounts/emu-azure-admin-consent.md index 8c99fbabec..1b68756a7d 100644 --- a/translations/es-ES/data/reusables/enterprise-accounts/emu-azure-admin-consent.md +++ b/translations/es-ES/data/reusables/enterprise-accounts/emu-azure-admin-consent.md @@ -1,14 +1,6 @@ ---- -ms.openlocfilehash: 75ac89c3c50225b0c930c6d603acf0d5c331597d -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147067862" ---- -1. Cuando se te redirija, inicia sesión en el proveedor de identidades y sigue las instrucciones para dar tu consentimiento e instalar la aplicación {% data variables.product.prodname_emu_idp_oidc_application %}. +1. After {% data variables.product.product_name %} redirects you to your IdP, sign in, then follow the instructions to give consent and install the {% data variables.product.prodname_emu_idp_oidc_application %} application. After Azure AD asks for permissions for {% data variables.product.company_short %} {% data variables.product.prodname_emus %} with OIDC, enable **Consent on behalf of your organization**, then click **Accept**. {% warning %} - **Advertencia:** Debes iniciar sesión en Azure AD como usuario con derechos de administrador global para dar tu consentimiento a la instalación de la aplicación {% data variables.product.prodname_emu_idp_oidc_application %}. + **Warning:** You must sign in to Azure AD as a user with global admin rights in order to consent to the installation of the {% data variables.product.prodname_emu_idp_oidc_application %} application. {% endwarning %} diff --git a/translations/es-ES/data/reusables/enterprise-accounts/oidc-beta-notice.md b/translations/es-ES/data/reusables/enterprise-accounts/oidc-beta-notice.md deleted file mode 100644 index ee84559306..0000000000 --- a/translations/es-ES/data/reusables/enterprise-accounts/oidc-beta-notice.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -ms.openlocfilehash: 212811ec85eac69f0a197bdd7b5002848a30a889 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147059886" ---- -{% note %} - -**Nota:** La compatibilidad de OpenID Connect (OIDC) y la directiva de acceso condicional (CAP) con {% data variables.product.prodname_emus %} está en versión beta pública y solo está disponible para Azure AD. - -{% endnote %} diff --git a/translations/es-ES/data/reusables/enterprise-accounts/settings-tab.md b/translations/es-ES/data/reusables/enterprise-accounts/settings-tab.md index 43201eefc4..eb62e1752c 100644 --- a/translations/es-ES/data/reusables/enterprise-accounts/settings-tab.md +++ b/translations/es-ES/data/reusables/enterprise-accounts/settings-tab.md @@ -1,10 +1,11 @@ --- -ms.openlocfilehash: 2ca0b407c0a2da2784d555031fd4257384ea3839 -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 +ms.openlocfilehash: 55d1e3fd84a0d13fabb3d1b8f6543055a897ed83 +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147879358" +ms.lasthandoff: 11/22/2022 +ms.locfileid: "148180172" --- 1. En la barra lateral de la cuenta de empresa, haga clic en {% octicon "gear" aria-label="The Settings gear" %} **Configuración**. ![Pestaña Configuración en la barra lateral de la cuenta de empresa](/assets/images/help/business-accounts/enterprise-account-settings-tab.png) + \ No newline at end of file diff --git a/translations/es-ES/data/reusables/enterprise/best-practices.md b/translations/es-ES/data/reusables/enterprise/best-practices.md new file mode 100644 index 0000000000..f39c6b8394 --- /dev/null +++ b/translations/es-ES/data/reusables/enterprise/best-practices.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 22e809fc1161b294cac04d68a232c28453aa6352 +ms.sourcegitcommit: 0a6e3eee6eea9b1e445aea1e4461d64cf6b63218 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: "148163589" +--- +Para obtener información sobre cómo la empresa puede usar {% data variables.product.product_name %} de forma más eficaz, consulta "[Procedimientos recomendados para empresas](/admin/overview/best-practices-for-enterprises)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/enterprise_installation/image-urls-viewable-warning.md b/translations/es-ES/data/reusables/enterprise_installation/image-urls-viewable-warning.md index ecff795df4..d4ad4ce937 100644 --- a/translations/es-ES/data/reusables/enterprise_installation/image-urls-viewable-warning.md +++ b/translations/es-ES/data/reusables/enterprise_installation/image-urls-viewable-warning.md @@ -1,5 +1,5 @@ {% warning %} -**Warning:** If you add an image attachment to a pull request or issue comment, anyone can view the anonymized image URL without authentication{% ifversion ghes %}, even if the pull request is in a private repository, or if private mode is enabled. To prevent unauthorized access to the images, ensure that you restrict network access to the systems that serve the images, including {% data variables.location.product_location %}{% endif %}.{% ifversion ghae %} To prevent unauthorized access to image URLs on {% data variables.product.product_name %}, consider restricting network traffic to your enterprise. For more information, see "[Restricting network traffic to your enterprise](/admin/configuration/restricting-network-traffic-to-your-enterprise)."{% endif %} +**Warning:** If you add an image attachment to a pull request or issue comment, anyone can view the anonymized image URL without authentication{% ifversion ghes %}, even if the pull request is in a private repository, or if private mode is enabled. To prevent unauthorized access to the images, ensure that you restrict network access to the systems that serve the images, including {% data variables.location.product_location %}{% endif %}.{% ifversion ghae %} To prevent unauthorized access to image URLs on {% data variables.product.product_name %}, consider restricting network traffic to your enterprise. For more information, see "[Restricting network traffic to your enterprise with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)."{% endif %} {% endwarning %} diff --git a/translations/es-ES/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md b/translations/es-ES/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md new file mode 100644 index 0000000000..bc91258e75 --- /dev/null +++ b/translations/es-ES/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 303172b12f23dc26668c3ac8a09c3b943eb64fbb +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/22/2022 +ms.locfileid: "148180155" +--- +Si actualmente utilizas el inicio de sesión único de SAML para la autenticación y prefieres usar OIDC y beneficiarte de la compatibilidad con CAP, puedes seguir una ruta de migración. Para obtener más información, consulta "[Migración de SAML a OIDC](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/identity-and-permissions/about-adding-ip-allow-list-entries.md b/translations/es-ES/data/reusables/identity-and-permissions/about-adding-ip-allow-list-entries.md index 45514932b7..af9e2e65e5 100644 --- a/translations/es-ES/data/reusables/identity-and-permissions/about-adding-ip-allow-list-entries.md +++ b/translations/es-ES/data/reusables/identity-and-permissions/about-adding-ip-allow-list-entries.md @@ -1,11 +1,3 @@ ---- -ms.openlocfilehash: db4c80c49c4e3effe99073f29010147f3a1efc08 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109858" ---- -Puedes crear una lista de direcciones IP permitidas agregando entradas que incluyan una dirección IP o un intervalo de direcciones.{% ifversion ip-allow-list-address-check %} Cuando hayas terminado de agregar entradas, puedes comprobar si cualquiera de las entradas habilitadas de la lista permitiría una dirección IP determinada.{% endif %} +You can create an IP allow list by adding entries that each contain an IP address or address range. After you finish adding entries, you can check whether a particular IP address would be allowed by any of the enabled entries in your list. -Antes de que la lista restrinja el acceso a {% ifversion ghae %}tu empresa{% else %}los activos privados propiedad de las organizaciones de tu empresa{% endif %}, también debes habilitar las direcciones IP permitidas. +Before the list restricts access to {% ifversion ghae %}your enterprise{% else %}private assets owned by organizations in your enterprise{% endif %}, you must also enable allowed IP addresses. diff --git a/translations/es-ES/data/reusables/identity-and-permissions/about-editing-ip-allow-list-entries.md b/translations/es-ES/data/reusables/identity-and-permissions/about-editing-ip-allow-list-entries.md index 9eb1ce2c4a..f8c5490631 100644 --- a/translations/es-ES/data/reusables/identity-and-permissions/about-editing-ip-allow-list-entries.md +++ b/translations/es-ES/data/reusables/identity-and-permissions/about-editing-ip-allow-list-entries.md @@ -1,12 +1,3 @@ ---- -ms.openlocfilehash: 8f78a77c83ea498d8d41a0deff20903062542479 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109856" ---- -Puedes editar una entrada en la lista de IP permitidas. Si editas una entrada habilitada, los cambios se aplicarán inmediatamente. +You can edit an entry in your IP allow list. If you edit an enabled entry, changes are enforced immediately. -{% ifversion ip-allow-list-address-check %} Una vez finalizada la edición de entradas, puedes comprobar si cualquiera de las entradas habilitadas de la lista permitiría una dirección IP determinada. -{% endif %} +After you finish editing entries, you can check whether your allow list will permit a connection from a particular IP address after you enable the list. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md b/translations/es-ES/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md index 61a4610e48..25129e468e 100644 --- a/translations/es-ES/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md +++ b/translations/es-ES/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md @@ -1,12 +1,3 @@ ---- -ms.openlocfilehash: 095556009ed66ca0b687734f62f21c70fd87699a -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109855" ---- -Después de crear una lista de direcciones IP permitidas, puedes habilitar las direcciones IP permitidas. Al habilitar las direcciones IP permitidas, {% data variables.product.company_short %} aplica inmediatamente las entradas habilitadas en la lista de direcciones IP permitidas. +After you create an IP allow list, you can enable allowed IP addresses. When you enable allowed IP addresses, {% data variables.product.company_short %} immediately enforces any enabled entries in your IP allow list. -{% ifversion ip-allow-list-address-check %} Antes de habilitar las direcciones IP permitidas, puedes comprobar si cualquiera de las entradas habilitadas de la lista permitiría una dirección IP determinada. Para obtener más información, consulta "[Comprobación de permiso para una dirección IP](#checking-if-an-ip-address-is-permitted)". -{% endif %} +Before you enable your IP allow list, you can check whether your allow list will permit a connection from a particular IP address. For more information, see "[Checking if an IP address is permitted](#checking-if-an-ip-address-is-permitted)." \ No newline at end of file diff --git a/translations/es-ES/data/reusables/identity-and-permissions/check-ip-address.md b/translations/es-ES/data/reusables/identity-and-permissions/check-ip-address.md index 863644d674..61daf830eb 100644 --- a/translations/es-ES/data/reusables/identity-and-permissions/check-ip-address.md +++ b/translations/es-ES/data/reusables/identity-and-permissions/check-ip-address.md @@ -1,11 +1,9 @@ --- -ms.openlocfilehash: 7b848e4c3bb4a9a4578e3f1ff92f6249dd20c699 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 18467aadad6c07acc5efc9080626cd5c1bec2a6d +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148110047" +ms.lasthandoff: 11/22/2022 +ms.locfileid: "148180009" --- -{%- ifversion ip-allow-list-address-check %} 1. Opcionalmente, comprueba si cualquiera de las entradas habilitadas de la lista permitiría una dirección IP determinada. Para obtener más información, consulta "[Comprobación de permiso para una dirección IP](#checking-if-an-ip-address-is-permitted)". -{%- endif %} diff --git a/translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-enable.md b/translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-enable.md index d0224c3d3e..6990c62b23 100644 --- a/translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-enable.md +++ b/translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-enable.md @@ -1,11 +1,3 @@ ---- -ms.openlocfilehash: abbbdeeb76eb7a1312105eb1319c808514893c30 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/09/2022 -ms.locfileid: "147682800" ---- -Para aplicar la lista de IP permitidas, primero debes agregar direcciones IP a la lista y, después, habilitar la lista de direcciones IP permitidas.{% ifversion ip-allow-list-address-check %} Después de completar la lista, puedes comprobar si cualquiera de las entradas habilitadas de la lista permitiría una dirección IP determinada.{% endif %} +To enforce the IP allow list, you must first add IP addresses to the list, then enable the IP allow list. After you complete your list, you can check whether a particular IP address would be allowed by any of the enabled entries in the list. -Debes agregar tu dirección IP actual o un rango coincidente antes de habilitar la lista de permisos de IP. +You must add your current IP address, or a matching range, before you enable the IP allow list. diff --git a/translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md b/translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md index 5296735324..1b0ced7720 100644 --- a/translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md +++ b/translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md @@ -1,22 +1,16 @@ ---- -ms.openlocfilehash: 130c705dad9367dbecb144ac281e8e58fa6d6cb7 -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147880376" ---- -Si estás utilizando una lista de direcciones permitidas, también puedes elegir agregar automáticamente a ella cualquier dirección IP que hayas configurado para las {% data variables.product.prodname_github_apps %} que hayas instalado en tu empresa. +If you're using an allow list, you can also choose to automatically add to your allow list any IP addresses configured for {% data variables.product.prodname_github_apps %} that are installed in your enterprise. {% data reusables.identity-and-permissions.ip-allow-lists-address-inheritance %} {% data reusables.apps.ip-allow-list-only-apps %} -Para más información sobre cómo crear una lista de permitidos para una {% data variables.product.prodname_github_app %} que ha creado, vea "[Administración de direcciones IP permitidas para una aplicación de GitHub](/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app)". +For more information about how to create an allow list for a {% data variables.product.prodname_github_app %} you have created, see "[Managing allowed IP addresses for a GitHub App](/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app)." -Para habilitar la adición automática de direcciones IP para las {% data variables.product.prodname_github_apps %}: +To enable automatic addition of IP addresses for {% data variables.product.prodname_github_apps %}: -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} -1. En "Lista de direcciones IP permitidas", seleccione **Habilitar la configuración de lista de direcciones IP permitidas para las aplicaciones de GitHub instaladas**. - ![Casilla para permitir las direcciones IP de la aplicación de GitHub](/assets/images/help/security/enable-ip-allowlist-githubapps-checkbox.png) -1. Haga clic en **Save**(Guardar). +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.security-tab %} +1. Select **Enable IP allow list configuration for installed GitHub Apps**. If you are using {% data variables.product.prodname_emus %} with OIDC, first select **GitHub** as your IP allow list configuration, then select **Enable IP allow list configuration for installed GitHub Apps**. + ![Checkbox to allow GitHub App IP addresses](/assets/images/help/security/enable-ip-allowlist-githubapps-checkbox.png) +1. Click **Save**. diff --git a/translations/es-ES/data/reusables/organizations/org-ownership-recommendation.md b/translations/es-ES/data/reusables/organizations/org-ownership-recommendation.md index d42eab7632..ed7b71e5f6 100644 --- a/translations/es-ES/data/reusables/organizations/org-ownership-recommendation.md +++ b/translations/es-ES/data/reusables/organizations/org-ownership-recommendation.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 0a42d7b90fd6973a0d52e7cff8dfc3082de11135 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 64c92d2427b9be166d820bf3fcb23d39d449a295 +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145122553" +ms.lasthandoff: 11/14/2022 +ms.locfileid: "148163471" --- -Los proyectos mantenidos y admnistrados por un solo propietario de organización pueden llegar a ser inaccesibles con facilidad si no se puede contactar a dicho propietario. Es recomendable que una organización tenga al menos dos personas con permisos de *propietario* para garantizar que nadie pierda el acceso al proyecto. +Si una organización solo tiene un propietario, los proyectos de la misma pueden ser inaccesibles si el propietario no es accesible. Para asegurarse de que nadie perderá el acceso a un proyecto, se recomienda que al menos dos personas de cada organización tengan el rol de propietario. diff --git a/translations/es-ES/data/reusables/projects/projects-filters.md b/translations/es-ES/data/reusables/projects/projects-filters.md index 0fa8f3b743..9cb2ce713f 100644 --- a/translations/es-ES/data/reusables/projects/projects-filters.md +++ b/translations/es-ES/data/reusables/projects/projects-filters.md @@ -1,10 +1,18 @@ -- To filter for any match of multiple values (an OR query), separate the values with a comma. For example `label:"good first issue",bug` will list all issues labelled `good first issue` or `bug`. -- To filter for the absence of a specific value, place `-` before your filter. For example, `-label:"bug"` will only show items that do not have the label `bug`. -- To filter for the absence of all values, enter `no:` followed by the field name. For example, `no:assignee` will only show items that do not have an assignee. -- To filter by state, enter `is:`. For example, `is: issue` or `is:open`. -- Separate multiple filters with a space. For example, `status:"In progress" -label:"bug" no:assignee` will show only items that have a status of `In progress`, do not have the label `bug`, and do not have an assignee. -- To filter for the previous, current, or next iteration of an iteration field, use `@previous`, `@current`, or `@next`. For example, `iteration:@current`. -- To filter for items assigned to the viewer, use `@me`. For example, `assignee:@me`. Anyone using this view will see items assigned to themselves. -- To filter by when an item was last updated, use `last-updated:` followed by the number of days. This filter only supports `{number}days` (or `1day` for a single day) as a unit. For example, `last-updated:7days` will only show items that were last updated 7 or more days ago. -- To filter date and number fields, use `>`, `>=`, `<`, `<=`, and `..` range queries. For example: `target:2022-03-01..2022-03-15`. For more information, see "[Understanding the search syntax](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax)." {% ifversion projects-v2-tasklists %} -- To filter for issues tracked by a specified issue, use `tracked-by:"/#"` and replace `` with the repository owner, `` with the repository name, and `` with the issue number. {% endif %} +--- +ms.openlocfilehash: 9106c4a2e538e62d23cd0aa2e417758376f6ffcd +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148158857" +--- +- Para filtrar por cualquier coincidencia de varios valores (una consulta OR), separe los valores con una coma. Por ejemplo, `label:"good first issue",bug` mostrará todas las incidencias etiquetadas con `good first issue` o `bug`. +- Para filtrar la ausencia de un valor específico, coloque `-` por delante del filtro. Por ejemplo, `-label:"bug"` solo mostrará los elementos que no tienen la etiqueta `bug`. +- Para filtrar por la ausencia de todos los valores, escriba `no:` seguido del nombre del campo. Por ejemplo, `no:assignee` solo mostrará los elementos que no tienen un usuario asignado. +- Para filtrar por estado, escriba `is:`. Por ejemplo, `is: issue` o `is:open`. +- Separa los filtros múltiples con un espacio. Por ejemplo, `status:"In progress" -label:"bug" no:assignee` solo mostrará los elementos que tienen un estado de `In progress`, no tienen la etiqueta `bug` y no tienen un usuario asignado. +- Para filtrar por la iteración anterior, actual o siguiente de un campo de iteración, use `@previous`, `@current` o `@next`. Por ejemplo, `iteration:@current`. +- Para filtrar por los elementos asignados al visor, use `@me`. Por ejemplo, `assignee:@me`. Cualquiera que use esta vista verá los elementos asignados a ellos mismos. +- Para filtrar por cuándo se actualizó por última vez un elemento, usa `last-updated:` seguido del número de días. Este filtro solo admite `{number}days` (o `1day` para un solo día) como unidad. Por ejemplo, `last-updated:7days` solo mostrará los elementos que se hayan actualizado por última vez hace 7 días o más. +- Para filtrar los campos de fecha y número, use las consultas de intervalo `>`, `>=`, `<`, `<=` y `..`. Por ejemplo: `target:2022-03-01..2022-03-15`. Para más información, vea "[Descripción de la sintaxis de búsqueda](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax)". {% ifversion projects-v2-tasklists %} +- Para filtrar los problemas supervisados mediante un problema especificado, usa `tracked-by:"/#"` y reemplaza `` por el propietario del repositorio, `` por el nombre del repositorio y `` por el número de problema. {% endif %} diff --git a/translations/es-ES/data/reusables/projects/tasklists-release-stage.md b/translations/es-ES/data/reusables/projects/tasklists-release-stage.md new file mode 100644 index 0000000000..99849eb55b --- /dev/null +++ b/translations/es-ES/data/reusables/projects/tasklists-release-stage.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: 989d63ee95229407cd3c3b05f5cfb41bd9038aee +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159963" +--- +{% note %} + +**Nota:** Las listas de tareas y los campos Seguimientos y Seguido por de los proyectos están disponibles actualmente en versión beta privada y sujetos a cambios. Si te interesa probar las listas de tareas y usar los nuevos campos, puedes unirte a la [lista de espera](https://aka.ms/tasklist-roadmap-signup). + +{% endnote %} \ No newline at end of file diff --git a/translations/es-ES/data/reusables/repositories/sidebar-advisories.md b/translations/es-ES/data/reusables/repositories/sidebar-advisories.md index de3d5866a4..d04bc6dfe0 100644 --- a/translations/es-ES/data/reusables/repositories/sidebar-advisories.md +++ b/translations/es-ES/data/reusables/repositories/sidebar-advisories.md @@ -1,10 +1,10 @@ --- -ms.openlocfilehash: 309963c78d20d0ae2bb067deed484e5eb45dc43c -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 +ms.openlocfilehash: b598a0f5e8e2d131e5381f0f867518de344084c9 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147879419" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159972" --- -1. En la barra lateral izquierda, haga clic en **Security advisories** (Avisos de seguridad). +1. En la barra lateral izquierda, en "Informes", haz clic en **Avisos**. ![Pestaña Security advisories (Avisos de seguridad)](/assets/images/help/security/advisories-tab.png) diff --git a/translations/es-ES/data/reusables/repositories/sidebar-security.md b/translations/es-ES/data/reusables/repositories/sidebar-security.md index 49a5f20a98..87cb392513 100644 --- a/translations/es-ES/data/reusables/repositories/sidebar-security.md +++ b/translations/es-ES/data/reusables/repositories/sidebar-security.md @@ -1,10 +1,10 @@ --- -ms.openlocfilehash: 8a30be469d4a74efc97849e83e825f619c585036 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 88f9918556730cd1d87c09c72a032d15a149d220 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145091580" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159948" --- -1. En el nombre del repositorio, haga clic en **{% octicon "shield" aria-label="The shield symbol" %} Security**. +1. En el nombre del repositorio, haz clic en **{% octicon "shield" aria-label="The shield symbol" %} Seguridad**. ![Pestaña Seguridad](/assets/images/help/repository/security-tab.png) diff --git a/translations/es-ES/data/reusables/saml/assert-the-administrator-attribute.md b/translations/es-ES/data/reusables/saml/assert-the-administrator-attribute.md index b42e238d56..0b151927e5 100644 --- a/translations/es-ES/data/reusables/saml/assert-the-administrator-attribute.md +++ b/translations/es-ES/data/reusables/saml/assert-the-administrator-attribute.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: bb28859183eee48b1c16f8e309ec2d3f839d2e4e -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a +ms.openlocfilehash: e26318e1b0d86ee5ec0c486ccaba4f7dbb8e2ed9 +ms.sourcegitcommit: ced661bdffebd0f96f6f76db109fbe31983448ba ms.translationtype: HT ms.contentlocale: es-ES -ms.lasthandoff: 09/11/2022 -ms.locfileid: "145137682" +ms.lasthandoff: 11/16/2022 +ms.locfileid: "148167083" --- -Para convertir a una persona en propietario de la empresa, debes delegar el permiso de propiedad en tu IdP. Incluye el atributo `administrator` en la aserción de SAML para la cuenta de usuario en el IdP, con el valor de `true`. Para obtener más información sobre los propietarios de empresas, consulta "[Roles en una empresa](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)". +Para convertir a una persona en propietario de la empresa, debes delegar el permiso de propiedad en tu IdP. Si usas Azure AD y SCIM, asigna el rol de propietario de empresa al usuario. Para otros proveedores de identidades, incluye el atributo `administrator` en la aserción de SAML para la cuenta de usuario en el IdP con el valor de `true`. Para obtener más información sobre los propietarios de empresas, consulta "[Roles en una empresa](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)". Para más información sobre la autenticación y el aprovisionamiento mediante Azure AD, consulta: "[Configuración de la autenticación y el aprovisionamiento para la empresa mediante Azure AD](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad)." diff --git a/translations/es-ES/data/reusables/search/classic-search-code-search-note.md b/translations/es-ES/data/reusables/search/classic-search-code-search-note.md new file mode 100644 index 0000000000..7c30564ba9 --- /dev/null +++ b/translations/es-ES/data/reusables/search/classic-search-code-search-note.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 838274ec284192127269b9f56d68452cf2962133 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159795" +--- +En este artículo se hace referencia a la experiencia de búsqueda clásica de GitHub. Si participas en la nueva búsqueda de código y la beta de la vista de código y has habilitado la nueva funcionalidad, la sintaxis para buscar código y la interfaz de búsqueda GitHub.com serán distintas, pero la sintaxis de búsqueda para los tipos de búsqueda que no son de código seguirá siendo la misma. + +Para obtener información sobre la nueva búsqueda de código y la vista de código, actualmente en versión beta pública limitada, consulta "[Acerca de la búsqueda de código de GitHub (beta)](/search-github/github-code-search/about-github-code-search)". Para probar la nueva búsqueda de código y la vista de código beta, únete a la [lista de espera](https://github.com/features/code-search-code-view/signup). \ No newline at end of file diff --git a/translations/es-ES/data/reusables/search/code-search-code-view-beta-note.md b/translations/es-ES/data/reusables/search/code-search-code-view-beta-note.md new file mode 100644 index 0000000000..1750ee5107 --- /dev/null +++ b/translations/es-ES/data/reusables/search/code-search-code-view-beta-note.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 92a49c10ee87f1b8b076946d8b638144d7f24c5f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160019" +--- +La nueva búsqueda de código y vista de código están disponibles en una versión beta de acceso público limitado. Para unirte a la lista de espera para acceder, visita https://github.com/features/code-search-code-view/signup. diff --git a/translations/es-ES/data/reusables/search/code-search-link.md b/translations/es-ES/data/reusables/search/code-search-link.md new file mode 100644 index 0000000000..f76611f7aa --- /dev/null +++ b/translations/es-ES/data/reusables/search/code-search-link.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 47117b97072b09f605c68d17be3a5fc350053862 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160309" +--- +Para obtener más información sobre la nueva búsqueda de código, consulta "[Acerca de GitHub Code Search (versión beta)](/search-github/github-code-search/about-github-code-search)". diff --git a/translations/es-ES/data/reusables/search/code-view-link.md b/translations/es-ES/data/reusables/search/code-view-link.md new file mode 100644 index 0000000000..6f0fa17119 --- /dev/null +++ b/translations/es-ES/data/reusables/search/code-view-link.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: fc1fa9b6a29ae3e58d822d9379ba004a0196b054 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160311" +--- +Para obtener más información sobre la nueva vista de código, consulta "[Navegación por los archivos con la nueva vista de código (beta)](/repositories/working-with-files/managing-files/navigating-files-with-the-new-code-view)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/search/non-code-search-explanation.md b/translations/es-ES/data/reusables/search/non-code-search-explanation.md new file mode 100644 index 0000000000..ad991794fb --- /dev/null +++ b/translations/es-ES/data/reusables/search/non-code-search-explanation.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: c1ebccb91c4ab8257429c582ab6c42e6583f823b +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160324" +--- +Ten en cuenta que la sintaxis y los calificadores para buscar contenido que no sea código, como problemas, usuarios y discusiones, funcionan igual que antes. Para obtener más información sobre la búsqueda de contenido que no sea código, consulta "[Acerca de la búsqueda en GitHub](/search-github/getting-started-with-searching-on-github/about-searching-on-github)" y "[Búsqueda en GitHub](/search-github/searching-on-github)". \ No newline at end of file diff --git a/translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-beta.md b/translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-beta.md new file mode 100644 index 0000000000..4b43a86063 --- /dev/null +++ b/translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-beta.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: 3a6ce7caed12668a49728186aa2d3911d4f90668 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159796" +--- +{% note %} + +**Nota:** La notificación privada de vulnerabilidades se encuentra actualmente en versión beta y está sujeta a cambios. + +{% endnote %} \ No newline at end of file diff --git a/translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-enable.md b/translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-enable.md new file mode 100644 index 0000000000..c370aee192 --- /dev/null +++ b/translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-enable.md @@ -0,0 +1,10 @@ +--- +ms.openlocfilehash: e4d1f38bc3b4f5c0ac9efbe78084116696d2ee34 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159811" +--- +Los propietarios y administradores de repositorios públicos pueden habilitar informes de vulnerabilidades privados en sus repositorios. Para obtener más información, consulta "[Configuración de informes de vulnerabilidades privados para un repositorio](/code-security/security-advisories/repository-security-advisories/configuring-private-vulnerability-reporting-for-a-repository)". + diff --git a/translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-overview.md b/translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-overview.md new file mode 100644 index 0000000000..e433dec3f7 --- /dev/null +++ b/translations/es-ES/data/reusables/security-advisory/private-vulnerability-reporting-overview.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 76133fe9416c92282de821d12e88432cdc1b5452 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159835" +--- +Los informes de vulnerabilidades privados facilitan a los investigadores de seguridad notificar las vulnerabilidades directamente mediante un formulario sencillo. + +Cuando un investigador de seguridad notifica una vulnerabilidad de forma privada, se te notifica y puedes optar por aceptarla, formular más preguntas o rechazarla. Si aceptas el informe, estás a punto para colaborar en una corrección de la vulnerabilidad en privado con el investigador de seguridad. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/security-overview/about-the-security-overview.md b/translations/es-ES/data/reusables/security-overview/about-the-security-overview.md new file mode 100644 index 0000000000..7d4bcf5289 --- /dev/null +++ b/translations/es-ES/data/reusables/security-overview/about-the-security-overview.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 3cb6c82081c33d45d039fef92162f4061287f14e +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/14/2022 +ms.locfileid: "148163463" +--- +La información general sobre seguridad proporciona resúmenes generales del estado de seguridad de una organización o empresa y facilita la identificación de repositorios problemáticos que requieren intervención. También puedes utilizar la información general sobre seguridad para ver qué repositorios tienen habilitadas características de seguridad específicas y configurar cualquier característica de seguridad disponible que no se encuentre en uso actualmente. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/security-overview/beta-org-risk-coverage.md b/translations/es-ES/data/reusables/security-overview/beta-org-risk-coverage.md new file mode 100644 index 0000000000..6a6fc6498c --- /dev/null +++ b/translations/es-ES/data/reusables/security-overview/beta-org-risk-coverage.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: a6449876cc0f409f9c5d6ea4f72268299fea9818 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159947" +--- +{% ifversion security-overview-org-risk-coverage %} {% note %} + +**Nota:** Las vistas "Riesgo de seguridad" y "Cobertura de seguridad" están actualmente disponibles en versión beta y están sujetas a cambios. + +{% endnote %} {% endif %} diff --git a/translations/es-ES/data/reusables/user-settings/sessions.md b/translations/es-ES/data/reusables/user-settings/sessions.md new file mode 100644 index 0000000000..ba0e0cb2a2 --- /dev/null +++ b/translations/es-ES/data/reusables/user-settings/sessions.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: bd35cf7047bb22a5c41ba794a5fb02317f9f705f +ms.sourcegitcommit: b2e5d14036a700b781e91158a552f8c0b1f04839 +ms.translationtype: HT +ms.contentlocale: es-ES +ms.lasthandoff: 11/15/2022 +ms.locfileid: "148165590" +--- +1. En la sección "Acceso" de la barra lateral, haz clic en **Sesiones de {% octicon "broadcast" aria-label="The broadcast icon" %}** . \ No newline at end of file diff --git a/translations/log/msft-es-resets.csv b/translations/log/msft-es-resets.csv index 22eee4d4e7..a090111673 100644 --- a/translations/log/msft-es-resets.csv +++ b/translations/log/msft-es-resets.csv @@ -54,6 +54,7 @@ translations/es-ES/content/actions/automating-builds-and-tests/building-and-test translations/es-ES/content/actions/using-jobs/using-a-build-matrix-for-your-jobs.md,file deleted because it no longer exists in main translations/es-ES/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/deploying-github-advanced-security-in-your-enterprise.md,file deleted because it no longer exists in main translations/es-ES/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/overview-of-github-advanced-security-deployment.md,file deleted because it no longer exists in main +translations/es-ES/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md,file deleted because it no longer exists in main translations/es-ES/content/admin/configuration/configuring-your-enterprise/troubleshooting-ssl-errors.md,file deleted because it no longer exists in main translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-gateway-for-nas-storage.md,file deleted because it no longer exists in main translations/es-ES/content/admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/allowing-built-in-authentication-for-users-outside-your-identity-provider.md,file deleted because it no longer exists in main @@ -232,6 +233,7 @@ translations/es-ES/content/rest/reference/users.md,file deleted because it no lo translations/es-ES/content/rest/reference/webhooks.md,file deleted because it no longer exists in main translations/es-ES/content/site-policy/privacy-policies/github-data-protection-agreement.md,file deleted because it no longer exists in main translations/es-ES/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-user-account.md,file deleted because it no longer exists in main +translations/es-ES/data/features/ip-allow-list-address-check.yml,file deleted because it no longer exists in main translations/es-ES/data/features/security-overview-views.yml,file deleted because it no longer exists in main translations/es-ES/data/glossaries/internal.yml,file deleted because it no longer exists in main translations/es-ES/data/graphql/ghes-3.1/graphql_previews.enterprise.yml,file deleted because it no longer exists in main @@ -393,6 +395,7 @@ translations/es-ES/data/reusables/dotcom_billing/monthly-spending-limit-codespac translations/es-ES/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/education/upgrade-organization.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/education/upgrade-page.md,file deleted because it no longer exists in main +translations/es-ES/data/reusables/enterprise-accounts/oidc-beta-notice.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/enterprise-accounts/repository-visibility-policy.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/enterprise-licensing/you-can-sync-for-a-combined-view.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/enterprise_management_console/username_normalization.md,file deleted because it no longer exists in main @@ -506,10 +509,10 @@ translations/es-ES/content/actions/learn-github-actions/finding-and-customizing- translations/es-ES/content/actions/learn-github-actions/understanding-github-actions.md,rendering error translations/es-ES/content/actions/learn-github-actions/usage-limits-billing-and-administration.md,rendering error translations/es-ES/content/actions/managing-issues-and-pull-requests/moving-assigned-issues-on-project-boards.md,broken liquid tags -translations/es-ES/content/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks.md,broken liquid tags translations/es-ES/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md,rendering error translations/es-ES/content/actions/managing-workflow-runs/manually-running-a-workflow.md,rendering error translations/es-ES/content/actions/managing-workflow-runs/re-running-workflows-and-jobs.md,rendering error +translations/es-ES/content/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer.md,rendering error translations/es-ES/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md,rendering error translations/es-ES/content/actions/publishing-packages/publishing-docker-images.md,rendering error translations/es-ES/content/actions/publishing-packages/publishing-nodejs-packages.md,broken liquid tags @@ -520,7 +523,6 @@ translations/es-ES/content/actions/security-guides/security-hardening-for-github translations/es-ES/content/actions/using-github-hosted-runners/controlling-access-to-larger-runners.md,rendering error translations/es-ES/content/actions/using-github-hosted-runners/using-larger-runners.md,rendering error translations/es-ES/content/actions/using-workflows/about-workflows.md,rendering error -translations/es-ES/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md,broken liquid tags translations/es-ES/content/actions/using-workflows/creating-starter-workflows-for-your-organization.md,rendering error translations/es-ES/content/actions/using-workflows/events-that-trigger-workflows.md,rendering error translations/es-ES/content/actions/using-workflows/reusing-workflows.md,rendering error @@ -558,7 +560,6 @@ translations/es-ES/content/admin/configuration/configuring-your-enterprise/confi translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-web-commit-signing.md,rendering error translations/es-ES/content/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode.md,rendering error translations/es-ES/content/admin/configuration/configuring-your-enterprise/enabling-private-mode.md,rendering error -translations/es-ES/content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md,rendering error translations/es-ES/content/admin/configuration/configuring-your-enterprise/managing-github-mobile-for-your-enterprise.md,rendering error translations/es-ES/content/admin/configuration/configuring-your-enterprise/site-admin-dashboard.md,rendering error translations/es-ES/content/admin/configuration/configuring-your-enterprise/troubleshooting-tls-errors.md,rendering error @@ -567,7 +568,6 @@ translations/es-ES/content/admin/enterprise-management/caching-repositories/conf translations/es-ES/content/admin/enterprise-management/caching-repositories/index.md,rendering error translations/es-ES/content/admin/enterprise-management/configuring-clustering/cluster-network-configuration.md,broken liquid tags translations/es-ES/content/admin/enterprise-management/configuring-clustering/configuring-high-availability-replication-for-a-cluster.md,broken liquid tags -translations/es-ES/content/admin/enterprise-management/configuring-clustering/initializing-the-cluster.md,broken liquid tags translations/es-ES/content/admin/enterprise-management/monitoring-your-appliance/accessing-the-monitor-dashboard.md,rendering error translations/es-ES/content/admin/enterprise-management/monitoring-your-appliance/configuring-collectd.md,rendering error translations/es-ES/content/admin/enterprise-management/monitoring-your-appliance/generating-a-health-check-for-your-enterprise.md,rendering error @@ -580,15 +580,14 @@ translations/es-ES/content/admin/enterprise-management/updating-the-virtual-mach translations/es-ES/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md,rendering error translations/es-ES/content/admin/github-actions/advanced-configuration-and-troubleshooting/troubleshooting-github-actions-for-your-enterprise.md,rendering error translations/es-ES/content/admin/github-actions/advanced-configuration-and-troubleshooting/using-a-staging-environment.md,rendering error +translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md,rendering error translations/es-ES/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates.md,rendering error translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises.md,rendering error translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md,rendering error translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md,rendering error translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md,rendering error -translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md,broken liquid tags translations/es-ES/content/admin/github-actions/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise.md,rendering error translations/es-ES/content/admin/identity-and-access-management/index.md,broken liquid tags -translations/es-ES/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/changing-authentication-methods.md,rendering error translations/es-ES/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/index.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication.md,rendering error @@ -598,6 +597,7 @@ translations/es-ES/content/admin/identity-and-access-management/using-built-in-a translations/es-ES/content/admin/identity-and-access-management/using-built-in-authentication/inviting-people-to-use-your-instance.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-cas-for-enterprise-iam/index.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-cas-for-enterprise-iam/using-cas.md,rendering error +translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md,rendering error @@ -605,7 +605,6 @@ translations/es-ES/content/admin/identity-and-access-management/using-enterprise translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-ldap-for-enterprise-iam/index.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md,broken liquid tags -translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise.md,broken liquid tags translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/enabling-encrypted-assertions.md,rendering error translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference.md,broken liquid tags @@ -634,7 +633,6 @@ translations/es-ES/content/admin/packages/enabling-github-packages-with-azure-bl translations/es-ES/content/admin/packages/enabling-github-packages-with-minio.md,rendering error translations/es-ES/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md,rendering error translations/es-ES/content/admin/packages/migrating-your-enterprise-to-the-container-registry-from-the-docker-registry.md,rendering error -translations/es-ES/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md,rendering error translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/about-enterprise-policies.md,broken liquid tags translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md,rendering error translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md,rendering error @@ -656,7 +654,6 @@ translations/es-ES/content/admin/user-management/migrating-data-to-and-from-your translations/es-ES/content/admin/user-management/migrating-data-to-and-from-your-enterprise/migrating-data-to-your-enterprise.md,rendering error translations/es-ES/content/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on.md,rendering error translations/es-ES/content/authentication/authenticating-with-saml-single-sign-on/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md,rendering error -translations/es-ES/content/authentication/authenticating-with-saml-single-sign-on/viewing-and-managing-your-active-saml-sessions.md,rendering error translations/es-ES/content/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account.md,rendering error translations/es-ES/content/authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys.md,rendering error translations/es-ES/content/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md,rendering error @@ -665,7 +662,6 @@ translations/es-ES/content/authentication/keeping-your-account-and-data-secure/a translations/es-ES/content/authentication/keeping-your-account-and-data-secure/authorizing-oauth-apps.md,rendering error translations/es-ES/content/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token.md,rendering error translations/es-ES/content/authentication/keeping-your-account-and-data-secure/creating-a-strong-password.md,rendering error -translations/es-ES/content/authentication/keeping-your-account-and-data-secure/index.md,rendering error translations/es-ES/content/authentication/keeping-your-account-and-data-secure/preventing-unauthorized-access.md,rendering error translations/es-ES/content/authentication/keeping-your-account-and-data-secure/removing-sensitive-data-from-a-repository.md,rendering error translations/es-ES/content/authentication/keeping-your-account-and-data-secure/reviewing-your-deploy-keys.md,rendering error @@ -678,6 +674,7 @@ translations/es-ES/content/authentication/managing-commit-signature-verification translations/es-ES/content/authentication/managing-commit-signature-verification/associating-an-email-with-your-gpg-key.md,rendering error translations/es-ES/content/authentication/managing-commit-signature-verification/displaying-verification-statuses-for-all-of-your-commits.md,rendering error translations/es-ES/content/authentication/managing-commit-signature-verification/index.md,broken liquid tags +translations/es-ES/content/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key.md,broken liquid tags translations/es-ES/content/authentication/securing-your-account-with-two-factor-authentication-2fa/about-two-factor-authentication.md,rendering error translations/es-ES/content/authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication.md,broken liquid tags translations/es-ES/content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md,rendering error @@ -692,15 +689,12 @@ translations/es-ES/content/billing/managing-billing-for-github-actions/about-bil translations/es-ES/content/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security.md,broken liquid tags translations/es-ES/content/billing/managing-billing-for-github-advanced-security/viewing-your-github-advanced-security-usage.md,rendering error translations/es-ES/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md,rendering error -translations/es-ES/content/billing/managing-billing-for-github-codespaces/index.md,broken liquid tags -translations/es-ES/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md,broken liquid tags translations/es-ES/content/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot.md,broken liquid tags translations/es-ES/content/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription.md,broken liquid tags translations/es-ES/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md,rendering error translations/es-ES/content/billing/managing-billing-for-your-github-account/about-billing-for-your-enterprise.md,broken liquid tags translations/es-ES/content/billing/managing-billing-for-your-github-account/about-per-user-pricing.md,rendering error translations/es-ES/content/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise.md,broken liquid tags -translations/es-ES/content/billing/managing-billing-for-your-github-account/downgrading-your-github-subscription.md,rendering error translations/es-ES/content/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription.md,rendering error translations/es-ES/content/billing/managing-billing-for-your-github-account/viewing-the-subscription-and-usage-for-your-enterprise-account.md,broken liquid tags translations/es-ES/content/billing/managing-your-license-for-github-enterprise/about-licenses-for-github-enterprise.md,rendering error @@ -750,6 +744,8 @@ translations/es-ES/content/code-security/secret-scanning/managing-alerts-from-se translations/es-ES/content/code-security/secret-scanning/protecting-pushes-with-secret-scanning.md,rendering error translations/es-ES/content/code-security/secret-scanning/pushing-a-branch-blocked-by-push-protection.md,rendering error translations/es-ES/content/code-security/security-advisories/global-security-advisories/about-the-github-advisory-database.md,rendering error +translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities.md,rendering error +translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md,rendering error translations/es-ES/content/code-security/security-advisories/repository-security-advisories/configuring-private-vulnerability-reporting-for-a-repository.md,rendering error translations/es-ES/content/code-security/security-overview/about-the-security-overview.md,rendering error translations/es-ES/content/code-security/security-overview/filtering-alerts-in-the-security-overview.md,rendering error @@ -758,66 +754,23 @@ translations/es-ES/content/code-security/supply-chain-security/end-to-end-supply translations/es-ES/content/code-security/supply-chain-security/end-to-end-supply-chain/securing-code.md,rendering error translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review.md,rendering error translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph.md,rendering error -translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review.md,broken liquid tags translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-the-dependency-graph.md,broken liquid tags -translations/es-ES/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md,broken liquid tags translations/es-ES/content/codespaces/codespaces-reference/security-in-github-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md,broken liquid tags translations/es-ES/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md,broken liquid tags -translations/es-ES/content/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md,broken liquid tags -translations/es-ES/content/codespaces/customizing-your-codespace/renaming-a-codespace.md,broken liquid tags -translations/es-ES/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/developing-in-codespaces/connecting-to-a-private-network.md,broken liquid tags translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository.md,rendering error -translations/es-ES/content/codespaces/developing-in-codespaces/deleting-a-codespace.md,broken liquid tags -translations/es-ES/content/codespaces/developing-in-codespaces/developing-in-a-codespace.md,broken liquid tags -translations/es-ES/content/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace.md,broken liquid tags -translations/es-ES/content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md,broken liquid tags -translations/es-ES/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md,broken liquid tags -translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md,rendering error -translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md,broken liquid tags -translations/es-ES/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md,broken liquid tags -translations/es-ES/content/codespaces/getting-started/deep-dive.md,broken liquid tags -translations/es-ES/content/codespaces/getting-started/quickstart.md,broken liquid tags +translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template.md,rendering error +translations/es-ES/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md,broken liquid tags translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md,broken liquid tags -translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/index.md,broken liquid tags translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md,broken liquid tags translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces.md,rendering error -translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md,broken liquid tags -translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md,broken liquid tags -translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports.md,broken liquid tags -translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md,broken liquid tags translations/es-ES/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md,rendering error -translations/es-ES/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md,broken liquid tags translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge.md,rendering error -translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md,broken liquid tags -translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines.md,broken liquid tags -translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces.md,broken liquid tags +translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file.md,broken liquid tags translations/es-ES/content/codespaces/the-githubdev-web-based-editor.md,rendering error -translations/es-ES/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md,broken liquid tags -translations/es-ES/content/codespaces/troubleshooting/github-codespaces-logs.md,broken liquid tags -translations/es-ES/content/codespaces/troubleshooting/index.md,broken liquid tags -translations/es-ES/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/troubleshooting/troubleshooting-prebuilds.md,broken liquid tags -translations/es-ES/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md,broken liquid tags -translations/es-ES/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md,broken liquid tags +translations/es-ES/content/codespaces/troubleshooting/troubleshooting-prebuilds.md,rendering error translations/es-ES/content/communities/documenting-your-project-with-wikis/about-wikis.md,rendering error translations/es-ES/content/communities/documenting-your-project-with-wikis/changing-access-permissions-for-wikis.md,rendering error translations/es-ES/content/communities/documenting-your-project-with-wikis/editing-wiki-content.md,rendering error -translations/es-ES/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization.md,broken liquid tags translations/es-ES/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account.md,rendering error translations/es-ES/content/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors.md,rendering error translations/es-ES/content/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema.md,broken liquid tags @@ -851,14 +804,12 @@ translations/es-ES/content/discussions/guides/finding-your-discussions.md,render translations/es-ES/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions.md,rendering error translations/es-ES/content/discussions/managing-discussions-for-your-community/managing-discussions.md,rendering error translations/es-ES/content/discussions/managing-discussions-for-your-community/moderating-discussions.md,rendering error -translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md,broken liquid tags -translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/glossary.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/about-using-makecode-arcade-with-github-classroom.md,rendering error translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide.md,broken liquid tags -translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/learn-with-github-classroom/view-autograding-results.md,rendering error translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md,rendering error +translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/manage-classrooms.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/use-the-git-and-github-starter-assignment.md,broken liquid tags translations/es-ES/content/get-started/customizing-your-github-workflow/exploring-integrations/github-extensions-and-integrations.md,rendering error @@ -889,16 +840,15 @@ translations/es-ES/content/get-started/quickstart/fork-a-repo.md,rendering error translations/es-ES/content/get-started/quickstart/git-and-github-learning-resources.md,broken liquid tags translations/es-ES/content/get-started/quickstart/github-glossary.md,broken liquid tags translations/es-ES/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud.md,rendering error -translations/es-ES/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server.md,broken liquid tags translations/es-ES/content/get-started/signing-up-for-github/verifying-your-email-address.md,rendering error translations/es-ES/content/get-started/using-git/about-git-rebase.md,rendering error translations/es-ES/content/get-started/using-git/splitting-a-subfolder-out-into-a-new-repository.md,rendering error -translations/es-ES/content/get-started/using-github/github-command-palette.md,rendering error translations/es-ES/content/get-started/using-github/github-mobile.md,rendering error translations/es-ES/content/get-started/using-github/keyboard-shortcuts.md,rendering error translations/es-ES/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md,broken liquid tags translations/es-ES/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md,rendering error translations/es-ES/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github.md,rendering error +translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md,rendering error translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md,broken liquid tags translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions.md,rendering error translations/es-ES/content/github-cli/github-cli/quickstart.md,rendering error @@ -916,14 +866,13 @@ translations/es-ES/content/graphql/reference/unions.md,rendering error translations/es-ES/content/issues/organizing-your-work-with-project-boards/managing-project-boards/changing-project-board-visibility.md,rendering error translations/es-ES/content/issues/organizing-your-work-with-project-boards/managing-project-boards/copying-a-project-board.md,rendering error translations/es-ES/content/issues/organizing-your-work-with-project-boards/managing-project-boards/creating-a-project-board.md,rendering error -translations/es-ES/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md,broken liquid tags translations/es-ES/content/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue.md,rendering error translations/es-ES/content/issues/tracking-your-work-with-issues/planning-and-tracking-work-for-your-team-or-project.md,broken liquid tags -translations/es-ES/content/organizations/collaborating-with-groups-in-organizations/about-organizations.md,broken liquid tags translations/es-ES/content/organizations/collaborating-with-groups-in-organizations/about-your-organizations-news-feed.md,rendering error translations/es-ES/content/organizations/granting-access-to-your-organization-with-saml-single-sign-on/about-two-factor-authentication-and-saml-single-sign-on.md,rendering error translations/es-ES/content/organizations/granting-access-to-your-organization-with-saml-single-sign-on/viewing-and-managing-a-members-saml-access-to-your-organization.md,rendering error translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/accessing-compliance-reports-for-your-organization.md,rendering error +translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md,broken liquid tags translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization.md,rendering error translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md,rendering error translations/es-ES/content/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities.md,broken liquid tags @@ -972,7 +921,6 @@ translations/es-ES/content/pull-requests/collaborating-with-pull-requests/propos translations/es-ES/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/keeping-your-pull-request-in-sync-with-the-base-branch.md,rendering error translations/es-ES/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request.md,rendering error translations/es-ES/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md,rendering error -translations/es-ES/content/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks.md,broken liquid tags translations/es-ES/content/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork.md,rendering error translations/es-ES/content/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/changing-a-commit-message.md,rendering error translations/es-ES/content/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-on-behalf-of-an-organization.md,rendering error @@ -999,7 +947,6 @@ translations/es-ES/content/repositories/creating-and-managing-repositories/creat translations/es-ES/content/repositories/creating-and-managing-repositories/restoring-a-deleted-repository.md,rendering error translations/es-ES/content/repositories/creating-and-managing-repositories/transferring-a-repository.md,rendering error translations/es-ES/content/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors.md,rendering error -translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md,broken liquid tags translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository.md,rendering error translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md,rendering error translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository.md,rendering error @@ -1013,7 +960,6 @@ translations/es-ES/content/repositories/releasing-projects-on-github/managing-re translations/es-ES/content/repositories/working-with-files/managing-files/adding-a-file-to-a-repository.md,rendering error translations/es-ES/content/repositories/working-with-files/managing-large-files/about-large-files-on-github.md,rendering error translations/es-ES/content/repositories/working-with-files/using-files/getting-permanent-links-to-files.md,rendering error -translations/es-ES/content/repositories/working-with-files/using-files/navigating-code-on-github.md,broken liquid tags translations/es-ES/content/rest/activity/notifications.md,broken liquid tags translations/es-ES/content/rest/apps/oauth-applications.md,rendering error translations/es-ES/content/rest/codespaces/codespaces.md,broken liquid tags @@ -1048,9 +994,7 @@ translations/es-ES/content/rest/projects/projects.md,broken liquid tags translations/es-ES/content/rest/quickstart.md,broken liquid tags translations/es-ES/content/rest/scim.md,rendering error translations/es-ES/content/rest/teams/team-sync.md,rendering error -translations/es-ES/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md,rendering error translations/es-ES/content/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment.md,rendering error -translations/es-ES/content/search-github/searching-on-github/searching-code.md,broken liquid tags translations/es-ES/content/search-github/searching-on-github/searching-for-repositories.md,rendering error translations/es-ES/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-sponsorship-tiers.md,broken liquid tags translations/es-ES/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-organization.md,rendering error @@ -1095,8 +1039,6 @@ translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md,b translations/es-ES/data/reusables/actions/jobs/section-defining-outputs-for-jobs.md,broken liquid tags translations/es-ES/data/reusables/actions/more-resources-for-ghes.md,rendering error translations/es-ES/data/reusables/actions/moving-a-runner-to-a-group.md,rendering error -translations/es-ES/data/reusables/actions/private-repository-forks-configure.md,broken liquid tags -translations/es-ES/data/reusables/actions/private-repository-forks-options.md,broken liquid tags translations/es-ES/data/reusables/actions/ref_name-description.md,broken liquid tags translations/es-ES/data/reusables/actions/reusable-workflow-artifacts.md,rendering error translations/es-ES/data/reusables/actions/reusable-workflow-calling-syntax.md,rendering error @@ -1112,6 +1054,7 @@ translations/es-ES/data/reusables/actions/settings-ui/settings-actions-pages-cus translations/es-ES/data/reusables/actions/settings-ui/settings-actions-runner-groups.md,rendering error translations/es-ES/data/reusables/actions/settings-ui/settings-actions-runners.md,rendering error translations/es-ES/data/reusables/actions/sidebar-secret.md,rendering error +translations/es-ES/data/reusables/actions/supported-github-runners.md,broken liquid tags translations/es-ES/data/reusables/actions/upgrade-runners-before-upgrade-ghes.md,rendering error translations/es-ES/data/reusables/actions/workflow-basic-example-and-explanation.md,rendering error translations/es-ES/data/reusables/actions/workflow-dispatch-inputs.md,rendering error @@ -1135,18 +1078,17 @@ translations/es-ES/data/reusables/code-scanning/enterprise-enable-code-scanning- translations/es-ES/data/reusables/code-scanning/enterprise-enable-code-scanning.md,broken liquid tags translations/es-ES/data/reusables/code-scanning/what-is-codeql-cli.md,rendering error translations/es-ES/data/reusables/codespaces/codespaces-disabling-org-billing.md,broken liquid tags -translations/es-ES/data/reusables/codespaces/codespaces-spending-limit-requirement.md,broken liquid tags -translations/es-ES/data/reusables/codespaces/creating-a-codespace-in-vscode.md,rendering error translations/es-ES/data/reusables/codespaces/customize-vcpus-and-ram.md,broken liquid tags translations/es-ES/data/reusables/codespaces/next-steps-adding-devcontainer.md,broken liquid tags translations/es-ES/data/reusables/codespaces/prebuilds-crossreference.md,broken liquid tags +translations/es-ES/data/reusables/codespaces/rebuild-command.md,broken liquid tags translations/es-ES/data/reusables/codespaces/secrets-on-start.md,broken liquid tags -translations/es-ES/data/reusables/codespaces/use-chrome.md,broken liquid tags translations/es-ES/data/reusables/command_line/provide-an-access-token.md,broken liquid tags translations/es-ES/data/reusables/copilot/install-copilot-in-neovim.md,broken liquid tags translations/es-ES/data/reusables/dependabot/beta-security-and-version-updates.md,rendering error translations/es-ES/data/reusables/dependabot/default-dependencies-allow-ignore.md,broken liquid tags translations/es-ES/data/reusables/dependabot/dependabot-alerts-dependency-scope.md,broken liquid tags +translations/es-ES/data/reusables/dependabot/dependabot-alerts-filters.md,rendering error translations/es-ES/data/reusables/dependabot/enabling-disabling-dependency-graph-private-repo.md,rendering error translations/es-ES/data/reusables/dependabot/sidebar-secret.md,rendering error translations/es-ES/data/reusables/dependabot/supported-package-managers.md,rendering error @@ -1159,6 +1101,7 @@ translations/es-ES/data/reusables/dotcom_billing/view-all-subscriptions.md,rende translations/es-ES/data/reusables/enterprise-accounts/actions-packages-report-download-enterprise-accounts.md,broken liquid tags translations/es-ES/data/reusables/enterprise-accounts/billing-microsoft-ea-overview.md,broken liquid tags translations/es-ES/data/reusables/enterprise-accounts/dormant-user-activity.md,rendering error +translations/es-ES/data/reusables/enterprise-accounts/emu-azure-admin-consent.md,broken liquid tags translations/es-ES/data/reusables/enterprise-accounts/emu-cap-validates.md,broken liquid tags translations/es-ES/data/reusables/enterprise-accounts/emu-forks.md,rendering error translations/es-ES/data/reusables/enterprise-accounts/emu-permission-follow.md,broken liquid tags @@ -1201,6 +1144,11 @@ translations/es-ES/data/reusables/getting-started/enterprise-advanced-security.m translations/es-ES/data/reusables/getting-started/managing-enterprise-members.md,rendering error translations/es-ES/data/reusables/git/git-push.md,rendering error translations/es-ES/data/reusables/git/provide-credentials.md,rendering error +translations/es-ES/data/reusables/identity-and-permissions/about-adding-ip-allow-list-entries.md,broken liquid tags +translations/es-ES/data/reusables/identity-and-permissions/about-editing-ip-allow-list-entries.md,broken liquid tags +translations/es-ES/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md,broken liquid tags +translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-enable.md,broken liquid tags +translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md,broken liquid tags translations/es-ES/data/reusables/identity-and-permissions/vigilant-mode-beta-note.md,rendering error translations/es-ES/data/reusables/large_files/storage_assets_location.md,broken liquid tags translations/es-ES/data/reusables/large_files/use_lfs_tip.md,rendering error @@ -1228,7 +1176,6 @@ translations/es-ES/data/reusables/pages/sidebar-pages.md,rendering error translations/es-ES/data/reusables/policies/abuse.md,rendering error translations/es-ES/data/reusables/projects/enable-basic-workflow.md,broken liquid tags translations/es-ES/data/reusables/projects/graphql-ghes.md,rendering error -translations/es-ES/data/reusables/projects/projects-filters.md,broken liquid tags translations/es-ES/data/reusables/pull_requests/configure_pull_request_merges_intro.md,rendering error translations/es-ES/data/reusables/pull_requests/default_merge_option.md,rendering error translations/es-ES/data/reusables/pull_requests/pull_request_merges_and_contributions.md,rendering error From a14353cb97b17227a01f38879e49542015e82820 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 22 Nov 2022 17:45:22 +0100 Subject: [PATCH 2/3] unbreak typo in sync-search-elasticsearch.yml (#32833) --- .github/workflows/sync-search-elasticsearch.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/sync-search-elasticsearch.yml b/.github/workflows/sync-search-elasticsearch.yml index c156869cfb..51cd597f3e 100644 --- a/.github/workflows/sync-search-elasticsearch.yml +++ b/.github/workflows/sync-search-elasticsearch.yml @@ -131,7 +131,7 @@ jobs: env: FASTLY_TOKEN: ${{ secrets.FASTLY_TOKEN }} FASTLY_SERVICE_ID: ${{ secrets.FASTLY_SERVICE_ID }} - FASTLY_SURROGATE_KEY: api-search:${{ matrix-language }} + FASTLY_SURROGATE_KEY: api-search:${{ matrix.language }} run: .github/actions-scripts/purge-fastly-edge-cache.js - name: Send Slack notification if workflow fails From 17030f8442a25a9e10fe984ba70d825a48d848de Mon Sep 17 00:00:00 2001 From: docubot <67483024+docubot@users.noreply.github.com> Date: Tue, 22 Nov 2022 08:51:48 -0800 Subject: [PATCH 3/3] New translation batch for ja (#32863) --- ...roving-workflow-runs-from-private-forks.md | 21 ++ ...proving-workflow-runs-from-public-forks.md | 19 +- ...-migration-with-github-actions-importer.md | 240 ++++++++++++++ ...hing-dependencies-to-speed-up-workflows.md | 210 ++++++------- .../configuring-your-enterprise/index.md | 10 +- .../initializing-github-ae.md | 175 ++++++----- ...ting-network-traffic-to-your-enterprise.md | 77 ----- .../initializing-the-cluster.md | 58 ++-- ...bling-github-actions-with-minio-storage.md | 49 +++ ...ating-your-enterprise-to-github-actions.md | 85 ++--- translations/ja-JP/content/admin/guides.md | 10 +- ...bout-authentication-for-your-enterprise.md | 140 +++++---- .../about-enterprise-managed-users.md | 140 ++++----- ...for-your-idps-conditional-access-policy.md | 15 +- ...uring-oidc-for-enterprise-managed-users.md | 6 +- ...le-sign-on-for-enterprise-managed-users.md | 5 +- .../migrating-from-saml-to-oidc.md | 2 +- .../about-saml-for-enterprise-iam.md | 6 +- ...ning-for-your-enterprise-using-azure-ad.md | 64 ++-- translations/ja-JP/content/admin/index.md | 10 +- ...log-events-performed-by-an-access-token.md | 73 +++++ .../best-practices-for-enterprises.md | 53 ++++ ...inio-storage-bucket-for-github-packages.md | 67 ++-- ...or-security-settings-in-your-enterprise.md | 95 +----- .../viewing-and-managing-your-sessions.md | 46 +++ .../telling-git-about-your-signing-key.md | 82 ++--- .../configuring-two-factor-authentication.md | 39 ++- .../index.md | 10 +- ...he-spending-limit-for-github-codespaces.md | 86 +++++ .../about-billing-for-github-packages.md | 24 +- .../downgrading-your-github-subscription.md | 96 +++--- ...ing-license-usage-for-github-enterprise.md | 9 +- ...configuring-dependabot-security-updates.md | 2 +- ...-disclosure-of-security-vulnerabilities.md | 98 ++++++ ...ately-reported-security-vulnerabilities.md | 45 +++ .../configuring-dependency-review.md | 97 +++--- ...disaster-recovery-for-github-codespaces.md | 43 +-- .../codespaces/codespaces-reference/index.md | 1 + ...ing-github-copilot-in-github-codespaces.md | 73 +++-- ...e-vs-code-command-palette-in-codespaces.md | 2 + ...ing-the-machine-type-for-your-codespace.md | 65 ++-- ...g-automatic-deletion-of-your-codespaces.md | 80 ++--- ...zing-github-codespaces-for-your-account.md | 87 +++--- .../renaming-a-codespace.md | 61 ++-- ...ur-default-editor-for-github-codespaces.md | 42 +-- ...ur-timeout-period-for-github-codespaces.md | 40 +-- .../connecting-to-a-private-network.md | 51 +-- .../creating-a-codespace-for-a-repository.md | 145 +++++++++ .../creating-a-codespace-from-a-template.md | 102 ++++++ .../deleting-a-codespace.md | 79 ++--- .../developing-in-a-codespace.md | 122 ++++---- .../forwarding-ports-in-your-codespace.md | 93 +++--- ...-github-codespaces-for-machine-learning.md | 76 ++--- .../opening-an-existing-codespace.md | 82 ++--- .../stopping-and-starting-a-codespace.md | 53 ++-- .../the-codespace-lifecycle.md | 67 ++++ ...ing-github-codespaces-for-pull-requests.md | 61 ++-- ...github-codespaces-in-visual-studio-code.md | 81 ++--- ...github-codespaces-in-your-jetbrains-ide.md | 138 +++++++++ ...using-github-codespaces-with-github-cli.md | 161 +++++----- .../using-source-control-in-your-codespace.md | 91 +++--- .../codespaces/getting-started/deep-dive.md | 155 ++++----- .../codespaces/getting-started/quickstart.md | 117 +++---- ...github-codespaces-for-your-organization.md | 79 +++-- .../index.md | 12 +- ...ing-the-codespaces-in-your-organization.md | 43 +-- ...ccess-for-your-organizations-codespaces.md | 33 +- ...-github-codespaces-in-your-organization.md | 75 +++++ ...ations-audit-logs-for-github-codespaces.md | 25 +- ...g-encrypted-secrets-for-your-codespaces.md | 113 ++++--- ...-gpg-verification-for-github-codespaces.md | 30 +- ...g-repository-access-for-your-codespaces.md | 92 +++--- ...our-security-logs-for-github-codespaces.md | 27 +- .../ja-JP/content/codespaces/overview.md | 10 +- .../about-github-codespaces-prebuilds.md | 49 +-- .../managing-prebuilds.md | 103 +++--- .../adding-features-to-a-devcontainer-file.md | 79 +++++ .../introduction-to-dev-containers.md | 193 ++++++------ ...um-specification-for-codespace-machines.md | 37 ++- ...mplate-repository-for-github-codespaces.md | 88 ++++++ ...g-up-your-dotnet-project-for-codespaces.md | 206 ++++++------ ...ing-up-your-java-project-for-codespaces.md | 156 +++++----- ...g-up-your-nodejs-project-for-codespaces.md | 141 ++++----- ...g-up-your-python-project-for-codespaces.md | 192 ++++++------ .../exporting-changes-to-a-branch.md | 29 +- .../troubleshooting/github-codespaces-logs.md | 109 +++---- .../codespaces/troubleshooting/index.md | 10 +- ...ing-creation-and-deletion-of-codespaces.md | 97 +++--- ...-gpg-verification-for-github-codespaces.md | 117 +++++++ ...g-port-forwarding-for-github-codespaces.md | 23 +- ...ng-your-connection-to-github-codespaces.md | 63 ++-- ...king-with-support-for-github-codespaces.md | 41 +-- .../blocking-a-user-from-your-organization.md | 101 +++--- ...about-github-global-campus-for-students.md | 52 ++-- ...about-github-global-campus-for-teachers.md | 40 +-- ...github-codespaces-with-github-classroom.md | 92 +++--- .../create-a-group-assignment.md | 2 + .../create-an-individual-assignment.md | 102 +++--- .../teach-with-github-classroom/index.md | 9 +- .../getting-started-with-github-ae.md | 2 +- ...-up-a-trial-of-github-enterprise-server.md | 65 ++-- .../using-github/github-command-palette.md | 257 +++++++-------- .../using-github/keyboard-shortcuts.md | 15 +- .../about-task-lists.md | 81 +++++ .../using-the-api-to-manage-projects.md | 10 +- .../filtering-projects.md | 10 +- .../learning-about-projects/about-projects.md | 57 ++-- .../about-tracks-and-tracked-by-fields.md | 56 ++++ .../deleting-custom-fields.md | 25 ++ .../understanding-fields/index.md | 28 ++ .../renaming-custom-fields.md | 24 ++ .../about-insights-for-projects.md | 10 +- .../about-tasklists.md | 146 +++++++++ .../about-organizations.md | 50 +-- .../best-practices-for-organizations.md | 38 +++ ...owed-ip-addresses-for-your-organization.md | 94 +++--- ...ing-the-audit-log-for-your-organization.md | 5 +- .../roles-in-an-organization.md | 12 +- .../working-with-forks/about-forks.md | 32 +- .../about-repositories.md | 11 +- .../best-practices-for-repositories.md | 35 +++ .../about-readmes.md | 58 ++-- .../using-files/navigating-code-on-github.md | 72 +++-- .../ja-JP/content/rest/overview/libraries.md | 10 +- .../about-searching-on-github.md | 85 ++--- .../about-github-code-search.md | 58 ++++ .../search-github/github-code-search/index.md | 26 ++ ...understanding-github-code-search-syntax.md | 293 ++++++++++++++++++ .../using-github-code-search.md | 81 +++++ .../searching-on-github/searching-code.md | 133 ++++---- .../features/ip-allow-list-address-check.yml | 3 - .../ja-JP/data/learning-tracks/admin.yml | 2 +- .../ip-allow-list-self-hosted-runners.md | 2 +- .../private-repository-forks-configure.md | 16 +- .../private-repository-forks-options.md | 16 +- .../actions/ref_protected-description.md | 10 +- .../reusables/actions/ref_type-description.md | 10 +- .../reusables/actions/run_id_description.md | 10 +- .../actions/run_number_description.md | 10 +- .../actions/runner-arch-description.md | 10 +- .../actions/runner-debug-description.md | 10 +- .../actions/runner-name-description.md | 10 +- .../actions/runner-os-description.md | 10 +- .../runner-temp-directory-description.md | 10 +- .../actions/runner-tool-cache-description.md | 10 +- .../actions/supported-github-runners.md | 39 +-- ...re-information-about-enforcement-policy.md | 10 +- .../assignments-guide-choose-visibility.md | 12 +- ...s-repository-visibility-and-permissions.md | 11 + .../reusables/codespaces/about-features.md | 11 + .../codespaces/about-publishing-templates.md | 13 + .../application-installed-locally.md | 9 + .../reusables/codespaces/codespace-logs.md | 11 + .../codespaces-continue-by-paying.md | 9 + .../codespaces-disabling-org-billing.md | 10 +- .../codespaces-free-for-personal-intro.md | 9 + .../codespaces-jetbrains-beta-note.md | 13 + .../codespaces-machine-type-availability.md | 10 +- .../codespaces/codespaces-machine-types.md | 10 +- .../codespaces-spending-limit-requirement.md | 12 +- .../configuration-choice-templates.md | 9 + .../reusables/codespaces/copilot-in-vscode.md | 17 + .../creating-a-codespace-in-vscode.md | 34 +- .../codespaces/developing-in-vscode.md | 26 ++ .../codespaces/edit-devcontainer-json.md | 10 +- .../reusables/codespaces/exporting-changes.md | 10 +- .../codespaces/gpg-in-active-codespaces.md | 9 + .../jetbrains-open-codespace-plugin.md | 11 + .../codespaces/jupyterlab-in-default-image.md | 9 + .../jupyterlab-installed-in-codespace.md | 9 + .../codespaces/links-to-get-started.md | 10 +- ...achine-types-for-unpublished-codespaces.md | 9 + .../monthly-spending-limit-codespaces.md | 11 + .../codespaces/navigating-to-a-codespace.md | 16 + .../open-template-in-codespace-step.md | 11 + .../opening-codespace-in-jetbrains.md | 34 ++ .../port-forwarding-adding-non-jetbrains.md | 17 + .../port-forwarding-labeling-non-jetbrains.md | 15 + .../prebuilds-permission-authorization.md | 8 +- .../publishing-template-codespaces.md | 34 ++ .../reusables/codespaces/rebuild-command.md | 14 +- .../codespaces/setting-up-project-intro.md | 9 + .../codespaces/setup-custom-devcontainer.md | 10 +- .../source-control-commit-changes.md | 14 +- .../codespaces/source-control-pull-request.md | 12 +- .../reusables/codespaces/source-control.md | 63 ++++ .../codespaces/ssh-server-installed.md | 19 ++ .../starting-new-project-template.md | 9 + .../codespaces/stopping-a-codespace.md | 12 +- .../template-codespaces-default-editor.md | 9 + .../codespaces/usage-report-download.md | 21 ++ .../data/reusables/codespaces/use-chrome.md | 10 +- .../codespaces/view-all-templates-step.md | 11 + .../codespaces/vscode-interface-annotation.md | 13 + .../note-on-student-codespaces-usage.md | 9 + .../education/student-codespaces-benefit.md | 9 + .../emu-azure-admin-consent.md | 12 +- .../enterprise-accounts/oidc-beta-notice.md | 13 - .../enterprise-accounts/settings-tab.md | 9 +- .../reusables/enterprise/best-practices.md | 9 + .../image-urls-viewable-warning.md | 2 +- .../SAML-to-OIDC-migration-for-EMU.md | 9 + .../about-adding-ip-allow-list-entries.md | 12 +- .../about-editing-ip-allow-list-entries.md | 13 +- .../about-enabling-allowed-ip-addresses.md | 13 +- .../check-ip-address.md | 10 +- .../ip-allow-lists-enable.md | 12 +- .../ip-allow-lists-githubapps-enterprise.md | 24 +- .../org-ownership-recommendation.md | 10 +- .../reusables/projects/projects-filters.md | 28 +- .../projects/tasklists-release-stage.md | 13 + .../repositories/sidebar-advisories.md | 10 +- .../repositories/sidebar-security.md | 10 +- .../assert-the-administrator-attribute.md | 10 +- .../search/classic-search-code-search-note.md | 11 + .../search/code-search-code-view-beta-note.md | 9 + .../data/reusables/search/code-search-link.md | 9 + .../data/reusables/search/code-view-link.md | 9 + ...and-disabling-code-search-and-view-beta.md | 14 + .../search/non-code-search-explanation.md | 9 + .../private-vulnerability-reporting-beta.md | 13 + .../private-vulnerability-reporting-enable.md | 10 + ...rivate-vulnerability-reporting-overview.md | 11 + ...urity-researcher-cannot-create-advisory.md | 12 +- .../about-the-security-overview.md | 9 + .../beta-org-risk-coverage.md | 13 + .../data/reusables/user-settings/sessions.md | 9 + translations/log/msft-ja-resets.csv | 101 ++---- 228 files changed, 6733 insertions(+), 3587 deletions(-) create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/approving-workflow-runs-from-private-forks.md create mode 100644 translations/ja-JP/content/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer.md delete mode 100644 translations/ja-JP/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md create mode 100644 translations/ja-JP/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md create mode 100644 translations/ja-JP/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/identifying-audit-log-events-performed-by-an-access-token.md create mode 100644 translations/ja-JP/content/admin/overview/best-practices-for-enterprises.md create mode 100644 translations/ja-JP/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md create mode 100644 translations/ja-JP/content/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces.md create mode 100644 translations/ja-JP/content/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities.md create mode 100644 translations/ja-JP/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md create mode 100644 translations/ja-JP/content/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository.md create mode 100644 translations/ja-JP/content/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template.md create mode 100644 translations/ja-JP/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md create mode 100644 translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide.md create mode 100644 translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md create mode 100644 translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file.md create mode 100644 translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces.md create mode 100644 translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md create mode 100644 translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md create mode 100644 translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields.md create mode 100644 translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md create mode 100644 translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/index.md create mode 100644 translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md create mode 100644 translations/ja-JP/content/issues/tracking-your-work-with-issues/about-tasklists.md create mode 100644 translations/ja-JP/content/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations.md create mode 100644 translations/ja-JP/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md create mode 100644 translations/ja-JP/content/search-github/github-code-search/about-github-code-search.md create mode 100644 translations/ja-JP/content/search-github/github-code-search/index.md create mode 100644 translations/ja-JP/content/search-github/github-code-search/understanding-github-code-search-syntax.md create mode 100644 translations/ja-JP/content/search-github/github-code-search/using-github-code-search.md delete mode 100644 translations/ja-JP/data/features/ip-allow-list-address-check.yml create mode 100644 translations/ja-JP/data/reusables/classroom/assignments-repository-visibility-and-permissions.md create mode 100644 translations/ja-JP/data/reusables/codespaces/about-features.md create mode 100644 translations/ja-JP/data/reusables/codespaces/about-publishing-templates.md create mode 100644 translations/ja-JP/data/reusables/codespaces/application-installed-locally.md create mode 100644 translations/ja-JP/data/reusables/codespaces/codespace-logs.md create mode 100644 translations/ja-JP/data/reusables/codespaces/codespaces-continue-by-paying.md create mode 100644 translations/ja-JP/data/reusables/codespaces/codespaces-free-for-personal-intro.md create mode 100644 translations/ja-JP/data/reusables/codespaces/codespaces-jetbrains-beta-note.md create mode 100644 translations/ja-JP/data/reusables/codespaces/configuration-choice-templates.md create mode 100644 translations/ja-JP/data/reusables/codespaces/copilot-in-vscode.md create mode 100644 translations/ja-JP/data/reusables/codespaces/developing-in-vscode.md create mode 100644 translations/ja-JP/data/reusables/codespaces/gpg-in-active-codespaces.md create mode 100644 translations/ja-JP/data/reusables/codespaces/jetbrains-open-codespace-plugin.md create mode 100644 translations/ja-JP/data/reusables/codespaces/jupyterlab-in-default-image.md create mode 100644 translations/ja-JP/data/reusables/codespaces/jupyterlab-installed-in-codespace.md create mode 100644 translations/ja-JP/data/reusables/codespaces/machine-types-for-unpublished-codespaces.md create mode 100644 translations/ja-JP/data/reusables/codespaces/monthly-spending-limit-codespaces.md create mode 100644 translations/ja-JP/data/reusables/codespaces/navigating-to-a-codespace.md create mode 100644 translations/ja-JP/data/reusables/codespaces/open-template-in-codespace-step.md create mode 100644 translations/ja-JP/data/reusables/codespaces/opening-codespace-in-jetbrains.md create mode 100644 translations/ja-JP/data/reusables/codespaces/port-forwarding-adding-non-jetbrains.md create mode 100644 translations/ja-JP/data/reusables/codespaces/port-forwarding-labeling-non-jetbrains.md create mode 100644 translations/ja-JP/data/reusables/codespaces/publishing-template-codespaces.md create mode 100644 translations/ja-JP/data/reusables/codespaces/setting-up-project-intro.md create mode 100644 translations/ja-JP/data/reusables/codespaces/source-control.md create mode 100644 translations/ja-JP/data/reusables/codespaces/ssh-server-installed.md create mode 100644 translations/ja-JP/data/reusables/codespaces/starting-new-project-template.md create mode 100644 translations/ja-JP/data/reusables/codespaces/template-codespaces-default-editor.md create mode 100644 translations/ja-JP/data/reusables/codespaces/usage-report-download.md create mode 100644 translations/ja-JP/data/reusables/codespaces/view-all-templates-step.md create mode 100644 translations/ja-JP/data/reusables/codespaces/vscode-interface-annotation.md create mode 100644 translations/ja-JP/data/reusables/education/note-on-student-codespaces-usage.md create mode 100644 translations/ja-JP/data/reusables/education/student-codespaces-benefit.md delete mode 100644 translations/ja-JP/data/reusables/enterprise-accounts/oidc-beta-notice.md create mode 100644 translations/ja-JP/data/reusables/enterprise/best-practices.md create mode 100644 translations/ja-JP/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md create mode 100644 translations/ja-JP/data/reusables/projects/tasklists-release-stage.md create mode 100644 translations/ja-JP/data/reusables/search/classic-search-code-search-note.md create mode 100644 translations/ja-JP/data/reusables/search/code-search-code-view-beta-note.md create mode 100644 translations/ja-JP/data/reusables/search/code-search-link.md create mode 100644 translations/ja-JP/data/reusables/search/code-view-link.md create mode 100644 translations/ja-JP/data/reusables/search/enabling-and-disabling-code-search-and-view-beta.md create mode 100644 translations/ja-JP/data/reusables/search/non-code-search-explanation.md create mode 100644 translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-beta.md create mode 100644 translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-enable.md create mode 100644 translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-overview.md create mode 100644 translations/ja-JP/data/reusables/security-overview/about-the-security-overview.md create mode 100644 translations/ja-JP/data/reusables/security-overview/beta-org-risk-coverage.md create mode 100644 translations/ja-JP/data/reusables/user-settings/sessions.md diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/approving-workflow-runs-from-private-forks.md b/translations/ja-JP/content/actions/managing-workflow-runs/approving-workflow-runs-from-private-forks.md new file mode 100644 index 0000000000..acaa1977c1 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/approving-workflow-runs-from-private-forks.md @@ -0,0 +1,21 @@ +--- +title: プライベート フォークからのワークフロー実行を承認する +intro: 書き込みアクセス許可を持たない誰かが pull request をプライベート リポジトリに送信したとき、メンテナがワークフローの実行を承認する必要がある場合があります。 +permissions: Maintainers with write access to a repository can approve workflow runs. +versions: + feature: actions-private-fork-workflow-approvals +shortTitle: Approve private fork runs +ms.openlocfilehash: 79b486123b62ee590e833e5c39bb7333a38c49d2 +ms.sourcegitcommit: fdc4466e89467a7b13239e26c6042dc1428946b6 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163832' +--- +## プライベート フォークからのワークフロー実行について + +{% data reusables.actions.private-repository-forks-overview %} 詳しくは、「[プライベート リポジトリでのフォーク pull request のポリシーを適用する](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-fork-pull-requests-in-private-repositories)」を参照してください。 + +## プライベート フォークからの pull request でワークフロー実行を承認する + +{% data reusables.actions.workflows.approve-workflow-runs %} diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks.md b/translations/ja-JP/content/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks.md index a706c1c012..b590b38ca6 100644 --- a/translations/ja-JP/content/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks.md +++ b/translations/ja-JP/content/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks.md @@ -1,20 +1,25 @@ --- -title: Approving workflow runs from public forks -intro: 'When an outside contributor submits a pull request to a public repository, a maintainer with write access may need to approve any workflow runs.' +title: パブリックフォークで実行されるワークフローの実行を承認する +intro: 外部の共同作成者が pull request をパブリック リポジトリに送信するとき、書き込みアクセスを持つメンテナはワークフローの実行を承認する必要がある場合があります。 versions: fpt: '*' ghec: '*' shortTitle: Approve public fork runs +ms.openlocfilehash: 74918a7d2e0081d6332ab267ef18ae148a2cff5e +ms.sourcegitcommit: 73b91dd4cdf592eadec4252319379d6fbe92858e +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148164124' --- - -## About workflow runs from public forks +## パブリック フォークからのワークフロー実行について {% data reusables.actions.workflow-run-approve-public-fork %} -You can configure workflow approval requirements for a [repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-required-approval-for-workflows-from-public-forks), [organization](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#configuring-required-approval-for-workflows-from-public-forks), or [enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-fork-pull-requests-in-your-enterprise). +[リポジトリ](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-required-approval-for-workflows-from-public-forks)、[Organization](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#configuring-required-approval-for-workflows-from-public-forks)、または [Enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-fork-pull-requests-in-your-enterprise) のワークフロー承認要件を構成できます。 -Workflow runs that have been awaiting approval for more than 30 days are automatically deleted. +30 日を超えて承認を待っているワークフローの実行は自動的に削除されます。 -## Approving workflow runs on a pull request from a public fork +## パブリック フォークからの pull request でワークフロー実行を承認する {% data reusables.actions.workflows.approve-workflow-runs %} diff --git a/translations/ja-JP/content/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer.md b/translations/ja-JP/content/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer.md new file mode 100644 index 0000000000..9ef8bc448b --- /dev/null +++ b/translations/ja-JP/content/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer.md @@ -0,0 +1,240 @@ +--- +title: Automating migration with GitHub Actions Importer +intro: 'Use {% data variables.product.prodname_actions_importer %} to plan and automate your migration to {% data variables.product.prodname_actions %}.' +versions: + fpt: '*' + ghec: '*' + ghes: '*' + ghae: '*' +type: how_to +miniTocMaxHeadingLevel: 3 +topics: + - Migration + - CI + - CD +shortTitle: Automate migration with {% data variables.product.prodname_actions_importer %} +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +[Legal notice](#legal-notice) + +{% note %} + +**Note**: {% data variables.product.prodname_actions_importer %} is currently available as a public preview. Visit the [sign up page](https://github.com/features/actions-importer/signup) to request access to the preview. Once you are granted access you'll be able to use the `gh-actions-importer` CLI extension + +{% endnote %} + +## About {% data variables.product.prodname_actions_importer %} + +You can use {% data variables.product.prodname_actions_importer %} to plan and automatically migrate your CI/CD pipelines to {% data variables.product.prodname_actions %} from Azure DevOps, CircleCI, GitLab, Jenkins, and Travis CI. + +{% data variables.product.prodname_actions_importer %} is distributed as a Docker container, and uses a [{% data variables.product.prodname_dotcom %} CLI](https://cli.github.com) extension to interact with the container. + +Any workflow that is converted by the {% data variables.product.prodname_actions_importer %} should be inspected for correctness before using it as a production workload. The goal is to achieve an 80% conversion rate for every workflow, however, the actual conversion rate will depend on the makeup of each individual pipeline that is converted. + +## Supported CI platforms + +You can use {% data variables.product.prodname_actions_importer %} to migrate from the following platforms: + +- Azure DevOps +- CircleCI +- GitLab +- Jenkins +- Travis CI + +Once you are granted access to the preview, you will be able to access further reference documentation for each of the supported platforms. + +## Prerequisites + +{% data variables.product.prodname_actions_importer %} has the following requirements: + +- You must have been granted access to the public preview for the {% data variables.product.prodname_actions_importer %}. +{%- ifversion ghes < 3.5 or ghae %} +- Use a {% data variables.product.pat_generic %} with the `read:packages` scope enabled. +{%- else %} +- You must have credentials to authenticate to the {% data variables.product.prodname_registry %} {% data variables.product.prodname_container_registry %}. For more information, see "[Working with the Container registry](/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-to-the-container-registry)." +{% endif %} +- An environment where you can run Linux-based containers, and can install the necessary tools. + - Docker is [installed](https://docs.docker.com/get-docker/) and running. + - [{% data variables.product.prodname_dotcom %} CLI](https://cli.github.com) is installed. + + {% note %} + + **Note**: The {% data variables.product.prodname_actions_importer %} container and CLI do not need to be installed on the same server as your CI platform. + + {% endnote %} + +### Installing the {% data variables.product.prodname_actions_importer %} CLI extension + +1. Install the {% data variables.product.prodname_actions_importer %} CLI extension: + + ```bash + $ gh extension install github/gh-actions-importer + ``` +1. Verify that the extension is installed: + + ```bash + $ gh actions-importer -h + Options: + -?, -h, --help Show help and usage information + + Commands: + update Update to the latest version of the GitHub Actions Importer. + version Display the version of the GitHub Actions Importer. + configure Start an interactive prompt to configure credentials used to authenticate with your CI server(s). + audit Plan your CI/CD migration by analyzing your current CI/CD footprint. + forecast Forecast GitHub Actions usage from historical pipeline utilization. + dry-run Convert a pipeline to a GitHub Actions workflow and output its yaml file. + migrate Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes. + ``` + +### Updating the {% data variables.product.prodname_actions_importer %} CLI + +To ensure you're running the latest version of {% data variables.product.prodname_actions_importer %}, you should regularly run the `update` command: + +```bash +$ gh actions-importer update +``` + +You must be authenticated with the {% data variables.product.prodname_container_registry %} for this command to be successful. Alternatively, you can provide credentials using the `--username` and `--password-stdin` parameters: + +```bash +$ echo $GITHUB_TOKEN | gh actions-importer update --username $GITHUB_HANDLE --password-stdin +``` + +### Authenticating at the command line + +You must configure credentials that allow {% data variables.product.prodname_actions_importer %} to communicate with {% data variables.product.prodname_dotcom %} and your current CI server. You can configure these credentials using environment variables or a `.env.local` file. The environment variables can be configured in an interactive prompt, by running the following command: + +```bash +$ gh actions-importer configure +``` + +Once you are granted access to the preview, you will be able to access further reference documentation about using environment variables. + +## Using the {% data variables.product.prodname_actions_importer %} CLI + +Use the subcommands of `gh actions-importer` to begin your migration to {% data variables.product.prodname_actions %}, including `audit`, `forecast`, `dry-run`, and `migrate`. + +### Auditing your existing CI pipelines + +The `audit` subcommand can be used to plan your CI/CD migration by analyzing your current CI/CD footprint. This analysis can be used to plan a timeline for migrating to {% data variables.product.prodname_actions %}. + +To run an audit, use the following command to determine your available options: + +```bash +$ gh actions-importer audit -h +Description: + Plan your CI/CD migration by analyzing your current CI/CD footprint. + +[...] + +Commands: + azure-devops An audit will output a list of data used in an Azure DevOps instance. + circle-ci An audit will output a list of data used in a CircleCI instance. + gitlab An audit will output a list of data used in a GitLab instance. + jenkins An audit will output a list of data used in a Jenkins instance. + travis-ci An audit will output a list of data used in a Travis CI instance. +``` + +Once you are granted access to the preview, you will be able to access further reference documentation about running an audit. + +### Forecasting usage + +The `forecast` subcommand reviews historical pipeline usage to create a forecast of {% data variables.product.prodname_actions %} usage. + +To run a forecast, use the following command to determine your available options: + +```bash +$ gh actions-importer forecast -h +Description: + Forecasts GitHub Actions usage from historical pipeline utilization. + +[...] + +Commands: + azure-devops Forecasts GitHub Actions usage from historical Azure DevOps pipeline utilization. + jenkins Forecasts GitHub Actions usage from historical Jenkins pipeline utilization. + gitlab Forecasts GitHub Actions usage from historical GitLab pipeline utilization. + circle-ci Forecasts GitHub Actions usage from historical CircleCI pipeline utilization. + travis-ci Forecasts GitHub Actions usage from historical Travis CI pipeline utilization. + github Forecasts GitHub Actions usage from historical GitHub pipeline utilization. +``` + +Once you are granted access to the preview, you will be able to access further reference documentation about running a forecast. + +### Testing the migration process + +The `dry-run` subcommand can be used to convert a pipeline to its {% data variables.product.prodname_actions %} equivalent, and then write the workflow to your local filesystem. + +To perform a dry run, use the following command to determine your available options: + +```bash +$ gh actions-importer dry-run -h +Description: + Convert a pipeline to a GitHub Actions workflow and output its yaml file. + +[...] + +Commands: + azure-devops Convert an Azure DevOps pipeline to a GitHub Actions workflow and output its yaml file. + circle-ci Convert a CircleCI pipeline to GitHub Actions workflows and output the yaml file(s). + gitlab Convert a GitLab pipeline to a GitHub Actions workflow and output the yaml file. + jenkins Convert a Jenkins job to a GitHub Actions workflow and output its yaml file. + travis-ci Convert a Travis CI pipeline to a GitHub Actions workflow and output its yaml file. +``` + +Once you are granted access to the preview, you will be able to access further reference documentation about performing a dry run. + +### Migrating a pipeline to {% data variables.product.prodname_actions %} + +The `migrate` subcommand can be used to convert a pipeline to its GitHub Actions equivalent and then create a pull request with the contents. + +To run a migration, use the following command to determine your available options: + +```bash +$ gh actions-importer migrate -h +Description: + Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes. + +[...] + +Commands: + azure-devops Convert an Azure DevOps pipeline to a GitHub Actions workflow and open a pull request with the changes. + circle-ci Convert a CircleCI pipeline to GitHub Actions workflows and open a pull request with the changes. + gitlab Convert a GitLab pipeline to a GitHub Actions workflow and open a pull request with the changes. + jenkins Convert a Jenkins job to a GitHub Actions workflow and open a pull request with the changes. + travis-ci Convert a Travis CI pipeline to a GitHub Actions workflow and and open a pull request with the changes. +``` + +Once you are granted access to the preview, you will be able to access further reference documentation about running a migration. + +## Legal notice + +Portions have been adapted from https://github.com/github/gh-actions-importer/ under the MIT license: + +``` +MIT License + +Copyright (c) 2022 GitHub + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +``` diff --git a/translations/ja-JP/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md b/translations/ja-JP/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md index a2a833a1a3..2b26deffe8 100644 --- a/translations/ja-JP/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md +++ b/translations/ja-JP/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md @@ -1,7 +1,7 @@ --- -title: Caching dependencies to speed up workflows +title: 依存関係をキャッシュしてワークフローのスピードを上げる shortTitle: Cache dependencies -intro: 'To make your workflows faster and more efficient, you can create and use caches for dependencies and other commonly reused files.' +intro: ワークフローを高速化して効率を上げるために、依存関係や広く再利用されるファイルに対するキャッシュを作成して利用できます。 redirect_from: - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows @@ -14,65 +14,69 @@ type: tutorial topics: - Workflows miniTocMaxHeadingLevel: 3 +ms.openlocfilehash: 380fe568e950a4dc388e8f811ecebd12f242c5df +ms.sourcegitcommit: 34d500fe45b362043b4b4685d6705a7bfb484d11 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/15/2022 +ms.locfileid: '148164381' --- +## ワークフローの依存関係のキャッシングについて -## About caching workflow dependencies +ワークフローの実行は、しばしば他の実行と同じ出力あるいはダウンロードされた依存関係を再利用します。 たとえばMaven、Gradle、npm、Yarnといったパッケージ及び依存関係管理ツールは、ダウンロードされた依存関係のローカルキャッシュを保持します。 -Workflow runs often reuse the same outputs or downloaded dependencies from one run to another. For example, package and dependency management tools such as Maven, Gradle, npm, and Yarn keep a local cache of downloaded dependencies. +{% ifversion fpt or ghec %} {% data variables.product.prodname_dotcom %} ホステッド ランナー上のジョブは、クリーンなランナー イメージで開始されますが、依存関係を毎回ダウンロードする必要があるため、ネットワークの利用率が増大し、実行時間が長くなり、コストが高くなります。 {% endif %}依存関係などのファイルの再生成にかかる時間を短縮しやすくするために、{% data variables.product.prodname_dotcom %} ではワークフロー内で頻繁に使われるファイルをキャッシュできます。 -{% ifversion fpt or ghec %} Jobs on {% data variables.product.prodname_dotcom %}-hosted runners start in a clean runner image and must download dependencies each time, causing increased network utilization, longer runtime, and increased cost. {% endif %}To help speed up the time it takes to recreate files like dependencies, {% data variables.product.prodname_dotcom %} can cache files you frequently use in workflows. +ジョブの依存関係をキャッシュするには、{% data variables.product.prodname_dotcom %} の [`cache` アクション](https://github.com/actions/cache)を使用できます。 このアクションは、一意のキーによって識別されるキャッシュを作成し、復元します。 なお、以下に示すパッケージ マネージャーをキャッシュする場合、それぞれの setup-* アクションを使用するには、最小構成が必要となります。これにより、依存関係キャッシュが作成され、復元されます。 -To cache dependencies for a job, you can use {% data variables.product.prodname_dotcom %}'s [`cache` action](https://github.com/actions/cache). The action creates and restores a cache identified by a unique key. Alternatively, if you are caching the package managers listed below, using their respective setup-* actions requires minimal configuration and will create and restore dependency caches for you. - -| Package managers | setup-* action for caching | +| パッケージ マネージャー | キャッシュの setup-* アクション | |---|---| -| npm, Yarn, pnpm | [setup-node](https://github.com/actions/setup-node#caching-global-packages-data) | -| pip, pipenv, Poetry | [setup-python](https://github.com/actions/setup-python#caching-packages-dependencies) | -| Gradle, Maven | [setup-java](https://github.com/actions/setup-java#caching-packages-dependencies) | +| npm、Yarn、pnpm | [setup-node](https://github.com/actions/setup-node#caching-global-packages-data) | +| pip、pipenv、Poetry | [setup-python](https://github.com/actions/setup-python#caching-packages-dependencies) | +| Gradle、Maven | [setup-java](https://github.com/actions/setup-java#caching-packages-dependencies) | | RubyGems | [setup-ruby](https://github.com/ruby/setup-ruby#caching-bundle-install-automatically) | | Go `go.sum` | [setup-go](https://github.com/actions/setup-go#caching-dependency-files-and-build-outputs) | {% warning %} -**Warning**: {% ifversion fpt or ghec %}Be mindful of the following when using caching with {% data variables.product.prodname_actions %}: +**警告**: {% ifversion fpt or ghec %}{% data variables.product.prodname_actions %} でキャッシュを使用する場合は、次の点に注意してください。 -* {% endif %}We recommend that you don't store any sensitive information in the cache. For example, sensitive information can include access tokens or login credentials stored in a file in the cache path. Also, command line interface (CLI) programs like `docker login` can save access credentials in a configuration file. Anyone with read access can create a pull request on a repository and access the contents of a cache. Forks of a repository can also create pull requests on the base branch and access caches on the base branch. +* {% endif %}キャッシュには、機密情報を保存しないことをお勧めします。 たとえばキャッシュパス内のファイルに保存されたアクセストークンあるいはログインクレデンシャルなどがセンシティブな情報です。 また、`docker login` のようなコマンド ライン インターフェイス (CLI) プログラムでは、アクセス資格情報を構成ファイルに保存できます。 読み取りアクセスを持つ人は誰でも、リポジトリに pull request を作成し、キャッシュの内容にアクセスできます。 リポジトリのフォークも、ベースブランチ上にPull Requestを作成し、ベースブランチ上のキャッシュにアクセスできます。 {%- ifversion fpt or ghec %} -* When using self-hosted runners, caches from workflow runs are stored on {% data variables.product.company_short %}-owned cloud storage. A customer-owned storage solution is only available with {% data variables.product.prodname_ghe_server %}. +* セルフホステッド ランナーを使用する場合、ワークフロー実行のキャッシュは、{% data variables.product.company_short %} 所有のクラウド ストレージに保存されます。 顧客所有のストレージ ソリューションは、{% data variables.product.prodname_ghe_server %} でのみ使用できます。 {%- endif %} {% endwarning %} {% data reusables.actions.comparing-artifacts-caching %} -For more information on workflow run artifacts, see "[Persisting workflow data using artifacts](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." +ワークフロー実行のアーティファクトについて詳しくは、「[アーティファクトを使用してワークフロー データを永続化する](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 -## Restrictions for accessing a cache +## キャッシュへのアクセスについての制限 -Access restrictions provide cache isolation and security by creating a logical boundary between different branches or tags. -Workflow runs can restore caches created in either the current branch or the default branch (usually `main`). If a workflow run is triggered for a pull request, it can also restore caches created in the base branch, including base branches of forked repositories. For example, if the branch `feature-b` has the base branch `feature-a`, a workflow run triggered on a pull request would have access to caches created in the default `main` branch, the base `feature-a` branch, and the current `feature-b` branch. +アクセス制限を使用すると、さまざまなブランチまたはタグ間に論理境界を作成することで、キャッシュを分離しセキュリティで保護することができます。 ワークフロー実行では、現在のブランチまたは既定のブランチ (通常は `main`) で作成されたキャッシュを復元できます。 pull request に対してワークフロー実行がトリガーされた場合は、ベース ブランチで作成されたキャッシュを復元することもできます (フォークされたリポジトリのベース ブランチも含む)。 たとえば、ブランチ `feature-b` にベース ブランチ `feature-a` がある場合、pull request でトリガーされたワークフロー実行では、既定のブランチ `main`、ベース ブランチ `feature-a`、および現在のブランチ `feature-b` で作成されたキャッシュにアクセスできます。 -Workflow runs cannot restore caches created for child branches or sibling branches. For example, a cache created for the child `feature-b` branch would not be accessible to a workflow run triggered on the parent `main` branch. Similarly, a cache created for the `feature-a` branch with the base `main` would not be accessible to its sibling `feature-c` branch with the base `main`. Workflow runs also cannot restore caches created for different tag names. For example, a cache created for the tag `release-a` with the base `main` would not be accessible to a workflow run triggered for the tag `release-b` with the base `main`. +ワークフロー実行では、子ブランチまたは兄弟ブランチ用に作成されたキャッシュを復元することはできません。 たとえば、子ブランチ `feature-b` 用に作成されたキャッシュに、親ブランチ `main` でトリガーされたワークフロー実行からアクセスすることはできません。 同様に、ベース `main` を持つブランチ `feature-a` 用に作成されたキャッシュに、ベース `main` を持つその兄弟ブランチ `feature-c` からアクセスすることはできません。 また、ワークフロー実行では、異なるタグ名に対して作成されたキャッシュを復元することもできません。 たとえば、タグ `release-a` に対してベース `main` で作成されたキャッシュに、タグ `release-b` に対してベース `main` でトリガーされたワークフロー実行からアクセスすることはできません。 -When a cache is created by a workflow run triggered on a pull request, the cache is created for the merge ref (`refs/pull/.../merge`). Because of this, the cache will have a limited scope and can only be restored by re-runs of the pull request. It cannot be restored by the base branch or other pull requests targeting that base branch. +pull request でトリガーされたワークフロー実行によってキャッシュが作成される場合、そのキャッシュは merge ref (`refs/pull/.../merge`) に対して作成されます。 このため、このキャッシュのスコープは制限され、pull request の再実行によってのみ復元できます。 ベース ブランチ、またはそのベース ブランチを対象とする他の pull request では、復元できません。 -Multiple workflow runs in a repository can share caches. A cache created for a branch in a workflow run can be accessed and restored from another workflow run for the same repository and branch. +リポジトリ内の複数のワークフロー実行で、キャッシュを共有できます。 あるワークフロー実行でブランチ用に作成されたキャッシュは、同じリポジトリとブランチの別のワークフロー実行からアクセスおよび復元できます。 -## Using the `cache` action +## `cache` アクションの使用 -The [`cache` action](https://github.com/actions/cache) will attempt to restore a cache based on the `key` you provide. When the action finds a cache that _exactly_ matches the key, the action restores the cached files to the `path` you configure. -You can optionally provide a list of `restore-keys` to use in case the `key` doesn't match an existing cache. A list of `restore-keys` is useful when you are restoring a cache from another branch because `restore-keys` can _partially_ match cache keys. For more information about matching `restore-keys`, see "[Matching a cache key](#matching-a-cache-key)." +[`cache` action](https://github.com/actions/cache) アクションは、指定した `key` に基づいてキャッシュの復元を試みます。 アクションがそのキーと "_厳密に_" 一致するキャッシュを見つけた場合、構成した `path` にキャッシュされたファイルが復元されます。 +必要に応じて、`key` が既存のキャッシュと一致しない場合に使用する `restore-keys` のリストを指定できます。 `restore-keys` のリストは、別のブランチからキャッシュを復元する場合に便利です。`restore-keys` はキャッシュ キーと "_部分的に_" 一致する可能性があるためです。 `restore-keys` の照合の詳細については、「[キャッシュ キーのマッチング](#matching-a-cache-key)」を参照してください。 -If there is an exact match to the provided `key`, this is considered a cache hit. If no cache exactly matches the provided `key`, this is considered a cache miss. On a cache miss, the action automatically creates a new cache if the job completes successfully. The new cache will use the `key` you provided and contains the files you specify in `path`. For more information about how this is handled, see "[Cache hits and misses](#cache-hits-and-misses)." +指定した `key` との完全な一致があった場合は、キャッシュ ヒットと見なされます。 指定した `key` と完全に一致するキャッシュがなかった場合は、キャッシュ ミスと見なされます。 キャッシュ ミスの場合は、ジョブが正常に完了すると、このアクションによって新しいキャッシュが自動的に作成されます。 新しいキャッシュでは、指定した `key` が使用され、`path` で指定したファイルが含められます。 この処理方法について詳しくは、「[キャッシュ ヒットとキャッシュ ミス](#cache-hits-and-misses)」を参照してください。 -You cannot change the contents of an existing cache. Instead, you can create a new cache with a new key. +既存のキャッシュの内容を変更することはできません。 代わりに、新しいキーを使って新しいキャッシュを作成できます。 -### Input parameters for the `cache` action +### `cache` アクションの入力パラメーター -- `key`: **Required** The key created when saving a cache and the key used to search for a cache. It can be any combination of variables, context values, static strings, and functions. Keys have a maximum length of 512 characters, and keys longer than the maximum length will cause the action to fail. -- `path`: **Required** The path(s) on the runner to cache or restore. - - You can specify a single path, or you can add multiple paths on separate lines. For example: +- `key`: **必須** キャッシュの保存時に作成されたキーと、キャッシュの検索に使用されるキー。 変数、コンテキスト値、静的な文字列、関数の任意の組み合わせが使えます。 キーの長さは最大で512文字であり、キーが最大長よりも長いとアクションは失敗します。 +- `path`: **必須** キャッシュまたは復元するランナー上のパス。 + - 1 つのパスを指定することも、複数のパスを別々の行に追加することもできます。 たとえば次のような点です。 ``` - name: Cache Gradle packages @@ -82,9 +86,9 @@ You cannot change the contents of an existing cache. Instead, you can create a n ~/.gradle/caches ~/.gradle/wrapper ``` - - You can specify either directories or single files, and glob patterns are supported. - - You can specify absolute paths, or paths relative to the workspace directory. -- `restore-keys`: **Optional** A string containing alternative restore keys, with each restore key placed on a new line. If no cache hit occurs for `key`, these restore keys are used sequentially in the order provided to find and restore a cache. For example: + - ディレクトリまたは単一ファイルのいずれかを指定できます。glob パターンがサポートされています。 + - 絶対パス、またはワークスペース ディレクトリに対する相対パスを指定できます。 +- `restore-keys`: **オプション** 代替の復元キーを含んだ文字列。各復元キーは新しい行に配置されます。 `key` に対するキャッシュ ヒットが発生しない場合は、キャッシュを検索して復元するために、これらの復元キーが指定された順序で使用されます。 たとえば次のような点です。 {% raw %} ```yaml @@ -95,28 +99,28 @@ You cannot change the contents of an existing cache. Instead, you can create a n ``` {% endraw %} -### Output parameters for the `cache` action +### `cache` アクションの出力パラメーター -- `cache-hit`: A boolean value to indicate an exact match was found for the key. +- `cache-hit`: キーに対して完全一致が見つかったかどうかを示すブール値。 -### Cache hits and misses -When `key` exactly matches an existing cache, it's called a _cache hit_, and the action restores the cached files to the `path` directory. +### キャッシュ ヒットとキャッシュ ミス +`key` が既存のキャッシュと厳密に一致した場合、それは "_キャッシュ ヒット_" と呼ばれ、アクションによってキャッシュされたファイルが `path` ディレクトリに復元されます。 -When `key` doesn't match an existing cache, it's called a _cache miss_, and a new cache is automatically created if the job completes successfully. +`key` が既存のキャッシュと一致しない場合 (これは _キャッシュ ミス_ と呼ばれます)、ジョブが正常に完了すると、新しいキャッシュが作成されます。 -When a cache miss occurs, the action also searches your specified `restore-keys` for any matches: +キャッシュ ミスが発生した場合、アクションはユーザーが指定した `restore-keys` の一致も検索します。 -1. If you provide `restore-keys`, the `cache` action sequentially searches for any caches that match the list of `restore-keys`. - - When there is an exact match, the action restores the files in the cache to the `path` directory. - - If there are no exact matches, the action searches for partial matches of the restore keys. When the action finds a partial match, the most recent cache is restored to the `path` directory. -1. The `cache` action completes and the next step in the job runs. -1. If the job completes successfully, the action automatically creates a new cache with the contents of the `path` directory. +1. `restore-keys` を指定した場合、`cache` アクションは `restore-keys` のリストに一致するすべてのキャッシュを順次検索します。 + - 完全に一致する場合、アクションはキャッシュ内のファイルを `path` ディレクトリに復元します。 + - 完全なマッチがなかった場合、アクションはリストアキーに対する部分一致を検索します。 アクションで部分的な一致が見つかると、最新のキャッシュが `path` ディレクトリに復元されます。 +1. `cache` アクションが完了し、ジョブの次のステップが実行されます。 +1. ジョブが正常に完了すると、アクションは `path` ディレクトリのコンテンツを含んだ新しいキャッシュを自動的に作成します。 -For a more detailed explanation of the cache matching process, see "[Matching a cache key](#matching-a-cache-key)." +キャッシュ照合プロセスの詳細については、「[キャッシュキーのマッチング](#matching-a-cache-key)」を参照してください。 -### Example using the `cache` action +### `cache` アクションの使用例 -This example creates a new cache when the packages in `package-lock.json` file change, or when the runner's operating system changes. The cache key uses contexts and expressions to generate a key that includes the runner's operating system and a SHA-256 hash of the `package-lock.json` file. +次の例では、`package-lock.json` ファイル内のパッケージが変更されたとき、またはランナーのオペレーティング システムが変更されたときに、新しいキャッシュを作成します。 キャッシュ キーは、コンテキストと式を使用して、ランナーのオペレーティング システムと `package-lock.json` ファイルの SHA-256 ハッシュを含むキーを生成します。 ```yaml{:copy} name: Caching with npm @@ -156,13 +160,13 @@ jobs: run: npm test ``` -### Using contexts to create cache keys +### コンテキストを使ったキャッシュキーの作成 -A cache key can include any of the contexts, functions, literals, and operators supported by {% data variables.product.prodname_actions %}. For more information, see "[Contexts](/actions/learn-github-actions/contexts)" and "[Expressions](/actions/learn-github-actions/expressions)." +キャッシュキーには、コンテキスト、関数、リテラル、{% data variables.product.prodname_actions %}がサポートする演算子を含めることができます。 詳細については、「[コンテキスト](/actions/learn-github-actions/contexts)」および「[式](/actions/learn-github-actions/expressions)」を参照してください。 -Using expressions to create a `key` allows you to automatically create a new cache when dependencies change. +式を使用して `key` を作成すると、依存関係が変更されたときに新しいキャッシュを自動的に作成できます。 -For example, you can create a `key` using an expression that calculates the hash of an npm `package-lock.json` file. So, when the dependencies that make up the `package-lock.json` file change, the cache key changes and a new cache is automatically created. +たとえば、npm `package-lock.json` ファイルのハッシュを計算する式を使用して `key` を作成できます。 その場合、`package-lock.json` ファイルを構成する依存関係が変更されると、キャッシュ キーが変更され、新しいキャッシュが自動的に作成されます。 {% raw %} ```yaml @@ -170,17 +174,17 @@ npm-${{ hashFiles('package-lock.json') }} ``` {% endraw %} -{% data variables.product.prodname_dotcom %} evaluates the expression `hash "package-lock.json"` to derive the final `key`. +{% data variables.product.prodname_dotcom %} は、式 `hash "package-lock.json"` を評価して最終的な `key` を導き出します。 ```yaml npm-d5ea0750 ``` -### Using the output of the `cache` action +### `cache` アクションの出力の使用 -You can use the output of the `cache` action to do something based on whether a cache hit or miss occurred. When an exact match is found for a cache for the specified `key`, the `cache-hit` output is set to `true`. +`cache` アクションの出力を使用すると、キャッシュ ヒットやキャッシュ ミスが発生したどうかに基づいて操作を実行することができます。 指定した `key` のキャッシュに完全一致が見つかった場合、`cache-hit` の出力は `true` に設定されます。 -In the example workflow above, there is a step that lists the state of the Node modules if a cache miss occurred: +上記のワークフロー例では、キャッシュ ミスが発生した場合に、Node モジュールの状態をリストする手順があります。 ```yaml - if: {% raw %}${{ steps.cache-npm.outputs.cache-hit != 'true' }}{% endraw %} @@ -189,15 +193,15 @@ In the example workflow above, there is a step that lists the state of the Node run: npm list ``` -## Matching a cache key +## キャッシュキーのマッチング -The `cache` action first searches for cache hits for `key` and the cache _version_ in the branch containing the workflow run. If there is no hit, it searches for `restore-keys` and the _version_. If there are still no hits in the current branch, the `cache` action retries same steps on the default branch. Please note that the scope restrictions apply during the search. For more information, see "[Restrictions for accessing a cache](#restrictions-for-accessing-a-cache)." +`cache` アクションは、最初にワークフロー実行を含むブランチで、`key` とキャッシュ "_バージョン_" のキャッシュ ヒットを検索します。 ヒットがない場合は、`restore-keys` と "_バージョン_" を検索します。 それでも現在のブランチにヒットがない場合、`cache` アクションは既定のブランチに対して同じ手順を再試行します。 検索中はスコープの制限が適用されることに注意してください。 詳しくは、「[キャッシュへのアクセスについての制限](#restrictions-for-accessing-a-cache)」を参照してください。 -Cache version is a way to stamp a cache with metadata of the `path` and the compression tool used while creating the cache. This ensures that the consuming workflow run uniquely matches a cache it can actually decompress and use. For more information, see [Cache Version](https://github.com/actions/cache#cache-version) in the Actions Cache documentation. +キャッシュ バージョンは、キャッシュの作成時に使用された `path` と圧縮ツールのメタデータを使って、キャッシュにスタンプを付ける方法です。 これにより、使用するワークフロー実行が、実際に圧縮を解除して使用できるキャッシュと一意に一致することが保証されます。 詳しくは、Actions Cache に関するドキュメントの「[Cache Version (キャッシュ バージョン)](https://github.com/actions/cache#cache-version)」を参照してください。 -`restore-keys` allows you to specify a list of alternate restore keys to use when there is a cache miss on `key`. You can create multiple restore keys ordered from the most specific to least specific. The `cache` action searches the `restore-keys` in sequential order. When a key doesn't match directly, the action searches for keys prefixed with the restore key. If there are multiple partial matches for a restore key, the action returns the most recently created cache. +`restore-keys` では、`key` でキャッシュ ミスが発生した場合に使用する代替復元キーのリストを指定できます。 特定の度合いが強いものから弱いものへ並べて複数のリストアキーを作成できます。 `cache` アクションは `restore-keys` を順番に検索します。 キーが直接マッチしなかった場合、アクションはリストアキーでプレフィックスされたキーを検索します。 リストアキーに対して複数の部分一致があった場合、アクションは最も最近に作成されたキャッシュを返します。 -### Example using multiple restore keys +### 複数のリストアキーの利用例 {% raw %} ```yaml @@ -208,7 +212,7 @@ restore-keys: | ``` {% endraw %} -The runner evaluates the expressions, which resolve to these `restore-keys`: +ランナーは式を評価し、次の `restore-keys` に解決します。 {% raw %} ```yaml @@ -219,13 +223,13 @@ restore-keys: | ``` {% endraw %} -The restore key `npm-feature-` matches any key that starts with the string `npm-feature-`. For example, both of the keys `npm-feature-fd3052de` and `npm-feature-a9b253ff` match the restore key. The cache with the most recent creation date would be used. The keys in this example are searched in the following order: +復元キー `npm-feature-` は、文字列 `npm-feature-` で始まるすべてのキーと一致します。 たとえば、`npm-feature-fd3052de` および `npm-feature-a9b253ff` の両方のキーと復元キーが一致します。 最も最近の期日に作成されたキャッシュが使われます。 この例でのキーは、以下の順序で検索されます。 -1. **`npm-feature-d5ea0750`** matches a specific hash. -1. **`npm-feature-`** matches cache keys prefixed with `npm-feature-`. -1. **`npm-`** matches any keys prefixed with `npm-`. +1. **`npm-feature-d5ea0750`** は特定のハッシュと一致します。 +1. **`npm-feature-`** は `npm-feature-` というプレフィックスが付いたキャッシュ キーと一致します。 +1. **`npm-`** は `npm-` というプレフィックスが付いたすべてのキーと一致します。 -#### Example of search priority +#### 検索の優先度の例 ```yaml key: @@ -235,80 +239,76 @@ restore-keys: | npm- ``` -For example, if a pull request contains a `feature` branch and targets the default branch (`main`), the action searches for `key` and `restore-keys` in the following order: +たとえば、pull request が `feature` ブランチを含んでいて、既定のブランチ (`main`) をターゲットとしている場合、アクションは `key` と `restore-keys` を次の順序で検索します。 -1. Key `npm-feature-d5ea0750` in the `feature` branch -1. Key `npm-feature-` in the `feature` branch -1. Key `npm-` in the `feature` branch -1. Key `npm-feature-d5ea0750` in the `main` branch -1. Key `npm-feature-` in the `main` branch -1. Key `npm-` in the `main` branch +1. `feature` ブランチ内のキー `npm-feature-d5ea0750` +1. `feature` ブランチ内のキー `npm-feature-` +1. `feature` ブランチ内のキー `npm-` +1. `main` ブランチ内のキー `npm-feature-d5ea0750` +1. `main` ブランチ内のキー `npm-feature-` +1. `main` ブランチ内のキー `npm-` -## Usage limits and eviction policy +## 利用制限と退去のポリシー -{% data variables.product.prodname_dotcom %} will remove any cache entries that have not been accessed in over 7 days. There is no limit on the number of caches you can store, but the total size of all caches in a repository is limited{% ifversion actions-cache-policy-apis %}. By default, the limit is 10 GB per repository, but this limit might be different depending on policies set by your enterprise owners or repository administrators.{% else %} to 10 GB.{% endif %} +{% data variables.product.prodname_dotcom %}は、7日間以上アクセスされていないキャッシュエントリを削除します。 保存できるキャッシュの数に制限はありませんが、リポジトリ内のすべてのキャッシュの合計サイズは制限されています{% ifversion actions-cache-policy-apis %}。 既定では、リポジトリあたり 10 GB の制限ですが、この制限は、エンタープライズ所有者やリポジトリ管理者が設定したポリシーによって変わる場合があります。{% else %} (最大 10 GB)。{% endif %} -{% data reusables.actions.cache-eviction-process %} {% ifversion actions-cache-ui %}The cache eviction process may cause cache thrashing, where caches are created and deleted at a high frequency. To reduce this, you can review the caches for a repository and take corrective steps, such as removing caching from specific workflows. For more information, see "[Managing caches](#managing-caches)."{% endif %}{% ifversion actions-cache-admin-ui %} You can also increase the cache size limit for a repository. For more information, see "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository)." +{% data reusables.actions.cache-eviction-process %} {% ifversion actions-cache-ui %}キャッシュの削除プロセスが原因で、キャッシュのスラッシングが発生する場合があります。その場合は、キャッシュが高い頻度で作成および削除されます。 これを軽減するには、リポジトリのキャッシュを確認し、修正手順を実行できます (特定のワークフローからキャッシュを削除するなど)。 詳細については、「[キャッシュの管理](#managing-caches)」を参照してください。{% endif %}{% ifversion actions-cache-admin-ui %}リポジトリのキャッシュ サイズ制限を増やすこともできます。 詳細については、「[リポジトリの {% data variables.product.prodname_actions %} 設定の管理](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository)」を参照してください。 {% elsif actions-cache-policy-apis %} -For information on changing the policies for the repository cache size limit, see "[Enforcing policies for {% data variables.product.prodname_actions %} in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-cache-storage-in-your-enterprise)" and "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository)." +リポジトリのキャッシュ サイズ制限のポリシー変更については、「[エンタープライズで {% data variables.product.prodname_actions %} のポリシーを適用する](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-cache-storage-in-your-enterprise)」および「[リポジトリの {% data variables.product.prodname_actions %} の設定を管理する](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository)」を参照してください。 {% endif %} {% ifversion actions-cache-management %} -## Managing caches +## キャッシュの管理 {% ifversion actions-cache-ui %} -To manage caches created from your workflows, you can: +ワークフローから作成されたキャッシュを管理する場合、次の操作を実行できます。 -- View a list of all cache entries for a repository. -- Filter and sort the list of caches using specific metadata such as cache size, creation time, or last accessed time. -- Delete cache entries from a repository. -- Monitor aggregate cache usage for repositories and organizations. +- リポジトリの全キャッシュ エントリの一覧を表示する。 +- 特定のメタデータを使って、キャッシュの一覧のフィルター処理と並べ替えを行う (キャッシュ サイズ、作成日時、最終アクセス日時など)。 +- リポジトリからキャッシュ エントリを削除する。 +- リポジトリと組織の集計されたキャッシュ使用状況を監視する。 -There are multiple ways to manage caches for your repositories: +リポジトリのキャッシュを管理する方法は複数あります。 -- Using the {% data variables.product.prodname_dotcom %} web interface, as shown below. -- Using the REST API. For more information, see the "[{% data variables.product.prodname_actions %} Cache](/rest/actions/cache)" REST API documentation. -- Installing a {% data variables.product.prodname_cli %} extension to manage your caches from the command line. For more information, see the [gh-actions-cache](https://github.com/actions/gh-actions-cache) extension. +- 以下に示すように、{% data variables.product.prodname_dotcom %} Web インターフェイスを使う。 +- REST API を使う。 詳しくは、「[{% data variables.product.prodname_actions %} Cache](/rest/actions/cache)」REST API ドキュメントを参照してください。 +- {% data variables.product.prodname_cli %} 拡張機能をインストールして、コマンド ラインからキャッシュを管理する。 詳細については、「[gh-actions-cache](https://github.com/actions/gh-actions-cache)」拡張機能を参照してください。 {% else %} -You can use the {% data variables.product.product_name %} REST API to manage your caches. {% ifversion actions-cache-list-delete-apis %}You can use the API to list and delete cache entries, and see your cache usage.{% elsif actions-cache-management %}At present, you can use the API to see your cache usage, with more functionality expected in future updates.{% endif %} For more information, see the "[{% data variables.product.prodname_actions %} Cache](/rest/actions/cache)" REST API documentation. +{% data variables.product.product_name %} REST API を使用してキャッシュを管理できます。 {% ifversion actions-cache-list-delete-apis %}API を使って、キャッシュ エントリの一覧表示と削除を行い、キャッシュの使用状況を確認できます。{% elsif actions-cache-management %}現時点では、API を使ってキャッシュの使用状況を確認できます。今後の更新で、さらに多くの機能が追加される予定です。{% endif %}詳しくは、REST API のドキュメント「[{% data variables.product.prodname_actions %} キャッシュ](/rest/actions/cache)」をご覧ください。 -You can also install a {% data variables.product.prodname_cli %} extension to manage your caches from the command line. For more information about the extension, see [the extension documentation](https://github.com/actions/gh-actions-cache#readme). For more information about {% data variables.product.prodname_cli %} extensions, see "[Using GitHub CLI extensions](/github-cli/github-cli/using-github-cli-extensions)." +{% data variables.product.prodname_cli %} 拡張機能をインストールして、コマンド ラインからキャッシュを管理することもできます。 拡張機能について詳しくは、[拡張機能のドキュメント](https://github.com/actions/gh-actions-cache#readme)を参照してください。 {% data variables.product.prodname_cli %} 拡張機能について詳しくは、「[GitHub CLI 拡張機能を使用する](/github-cli/github-cli/using-github-cli-extensions)」を参照してください。 {% endif %} {% ifversion actions-cache-ui %} -### Viewing cache entries +### キャッシュ エントリの表示 -You can use the web interface to view a list of cache entries for a repository. In the cache list, you can see how much disk space each cache is using, when the cache was created, and when the cache was last used. +Web インターフェイスを使って、リポジトリのキャッシュ エントリの一覧を表示できます。 キャッシュの一覧では、各キャッシュで使用されているディスク領域の量、キャッシュが作成された日時、キャッシュが最後に使用された日時を確認できます。 -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-cache-list %} -1. Review the list of cache entries for the repository. +{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} {% data reusables.repositories.actions-cache-list %} +1. リポジトリのキャッシュ エントリの一覧を確認します。 - * To search for cache entries used for a specific branch, click the **Branch** dropdown menu and select a branch. The cache list will display all of the caches used for the selected branch. - * To search for cache entries with a specific cache key, use the syntax `key: key-name` in the **Filter caches** field. The cache list will display caches from all branches where the key was used. + * 特定のブランチ用に使用されるキャッシュ エントリを検索するには、 **[Branch]** ドロップダウン メニューをクリックして、ブランチを選択します。 キャッシュの一覧に、選択したブランチ用に使用されるすべてのキャッシュが表示されます。 + * 特定のキャッシュ キーを持つキャッシュ エントリを検索するには、 **[Filter caches]** フィールドで構文 `key: key-name` を使用します。 キャッシュの一覧に、そのキーが使用されたすべてのブランチのキャッシュが表示されます。 - ![Screenshot of the list of cache entries](/assets/images/help/repository/actions-cache-entry-list.png) + ![キャッシュ エントリの一覧のスクリーンショット](/assets/images/help/repository/actions-cache-entry-list.png) -### Deleting cache entries +### キャッシュ エントリの削除 -Users with `write` access to a repository can use the {% data variables.product.prodname_dotcom %} web interface to delete cache entries. +リポジトリへの `write` アクセス権を持つユーザーは、{% data variables.product.prodname_dotcom %} Web インターフェイスを使ってキャッシュ エントリを削除できます。 -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-cache-list %} -1. To the right of the cache entry you want to delete, click {% octicon "trash" aria-label="The trash icon" %}. +{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} {% data reusables.repositories.actions-cache-list %} +1. 削除するキャッシュ エントリの右側にある {% octicon "trash" aria-label="The trash icon" %} をクリックします。 - ![Screenshot of the list of cache entries](/assets/images/help/repository/actions-cache-delete.png) + ![キャッシュ エントリの一覧のスクリーンショット](/assets/images/help/repository/actions-cache-delete.png) {% endif %} diff --git a/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/index.md b/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/index.md index 7309d994a2..1b6d900d5d 100644 --- a/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/index.md +++ b/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/index.md @@ -33,18 +33,18 @@ children: - /troubleshooting-tls-errors - /configuring-time-synchronization - /command-line-utilities - - /restricting-network-traffic-to-your-enterprise + - /restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list - /configuring-github-pages-for-your-enterprise - /configuring-host-keys-for-your-instance - /configuring-the-referrer-policy-for-your-enterprise - /configuring-custom-footers - /configuring-web-commit-signing shortTitle: Configure your enterprise -ms.openlocfilehash: 3cc7deccfdf71a0e339fca8055f0cd4b5027a32c -ms.sourcegitcommit: 80842b4e4c500daa051eff0ccd7cde91c2d4bb36 +ms.openlocfilehash: 4f19ba9cd3207c34b7eb679fb62481e04185ad2c +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/12/2022 -ms.locfileid: '147409240' +ms.lasthandoff: 11/22/2022 +ms.locfileid: '148180126' --- diff --git a/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md b/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md index e4f70c36cb..7e3508e9eb 100644 --- a/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md +++ b/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md @@ -1,6 +1,6 @@ --- -title: Initializing GitHub AE -intro: 'To get your enterprise ready to use, you can complete the initial configuration of {% data variables.product.product_name %}.' +title: GitHub AE を初期化する +intro: '{% data variables.product.product_name %} の初期設定を完了して Enterprise で使用できるようにします。' versions: ghae: '*' type: how_to @@ -9,122 +9,127 @@ topics: redirect_from: - /admin/configuration/initializing-github-ae - /enterprise-server@latest/admin/configuration/configuring-your-enterprise/initializing-github-ae +ms.openlocfilehash: a3c32a770bbf58be3589824302fe3a32be0e239a +ms.sourcegitcommit: ced661bdffebd0f96f6f76db109fbe31983448ba +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167053' --- -## About initialization +## 初期化について -Before you can initialize your enterprise, you must purchase {% data variables.product.product_name %}. For more information, contact {% data variables.contact.contact_enterprise_sales %}. +Enterprise を初期化する前に、{% data variables.product.product_name %} を購入する必要があります。 詳細については、{% data variables.contact.contact_enterprise_sales %} にお問い合わせください。 -{% data reusables.github-ae.initialize-enterprise %} Make sure the information you provide matches the intended enterprise owner's information in the IdP. For more information about enterprise owners, see "[Roles in an enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owner)." +{% data reusables.github-ae.initialize-enterprise %} 指定した情報が、ID プロバイダーの目的の Enterprise 所有者の情報と一致していることを確認します。 Enterprise 所有者の詳細については、「[Enterprise におけるロール](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owner)」を参照してください。 {% note %} -**Notes**: +**注**: -- If the initial password for {% data variables.product.prodname_ghe_managed %} expires before you finish initialization, you can request a password reset at any time from your invitation email. +- 初期化を完了する前に {% data variables.product.prodname_ghe_managed %} の初期パスワードの有効期限が切れた場合は、招待メールからいつでもパスワード リセットを要求できます。 -- Store the initial username and password for {% data variables.product.prodname_ghe_managed %} securely in a password manager. {% data reusables.saml.contact-support-if-your-idp-is-unavailable %} +- パスワード マネージャーで {% data variables.product.prodname_ghe_managed %} の初期ユーザー名とパスワードを安全に保存します。 {% data reusables.saml.contact-support-if-your-idp-is-unavailable %} {% endnote %} -During initialization, the enterprise owner will name your enterprise, configure SAML SSO, create policies for all organizations in your enterprise, and configure a support contact for your users. +初期化中に、Enterprise オーナーは Enterprise に名前を付け、SAML SSO を設定し、Enterprise 内のすべての Organization のポリシーを作成して、ユーザのサポート連絡先を設定します。 -## Prerequisites +## 前提条件 -To begin initialization, you will receive an invitation email from {% data variables.product.company_short %}. Before you configure {% data variables.product.prodname_ghe_managed %}, review the following prerequisites. +初期化を開始するにあたり、{% data variables.product.company_short %} から招待メールを受け取ります。 {% data variables.product.prodname_ghe_managed %} を構成する前に、次の前提条件を確認してください。 -To initialize {% data variables.location.product_location %}, you must have a SAML identity provider (IdP). {% data reusables.saml.ae-uses-saml-sso %} To connect your IdP to your enterprise during initialization, you should have your IdP's Entity ID (SSO) URL, Issuer ID URL, and public signing certificate (Base64-encoded). For more information, see "[About identity and access management for your enterprise](/admin/authentication/about-identity-and-access-management-for-your-enterprise)." +{% data variables.location.product_location %} を初期化するには、SAML ID プロバイダー (IdP) が必要です。 {% data reusables.saml.ae-uses-saml-sso %} 初期化中に IdP を Enterprise に接続するには、IdP のエンティティ ID (SSO) URL、発行者 ID URL、公開署名証明書 (Base64 エンコード) が必要です。 詳細については、[Enterprise の ID およびアクセス管理](/admin/authentication/about-identity-and-access-management-for-your-enterprise)に関するページを参照してください。 {% note %} -**Note**: {% data reusables.saml.create-a-machine-user %} +**注**: {% data reusables.saml.create-a-machine-user %} {% endnote %} -## Signing in and naming your enterprise +## サインインして Enterprise に名前を付ける -1. Follow the instructions in your welcome email to reach your enterprise. -2. Type your credentials under "Change password", then click **Change password**. -3. Under "What would you like your enterprise account to be named?", type the enterprise's name, then click **Save and continue**. - !["Save and continue" button for naming an enterprise](/assets/images/enterprise/configuration/ae-enterprise-configuration.png) +1. ようこそメールの指示に従って、Enterprise にアクセスします。 +2. パスワードの変更 の下に資格情報を入力し、**パスワードの変更** をクリックします。 +3. [Enterprise アカウントの名前を入力してください] の下に会社の名前を入力し、 **[保存して続行]** をクリックします。 + ![Enterprise に名前を付けるための [保存して続行] ボタン](/assets/images/enterprise/configuration/ae-enterprise-configuration.png) -## Connecting your IdP to your enterprise +## IdP を Enterprise に接続する -To configure authentication for {% data variables.product.product_name %}, you must provide {% data variables.product.product_name %} with the details for your SAML IdP. {% data variables.product.company_short %} recommends using Azure AD as your IdP. For more information, see "[Configuring authentication and provisioning with your identity provider](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider)." +{% data variables.product.product_name %} の認証を設定するには、{% data variables.product.product_name %} に SAML IdP の詳細を提供する必要があります。 {% data variables.product.company_short %} は、IdP として Azure AD を使用することを推奨しています。 詳細については、「[ID プロバイダーで認証とプロビジョニングを設定する](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider)」を参照してください。 -1. To the right of "Set up your identity provider", click **Configure**. - !["Configure" button for IdP configuration](/assets/images/enterprise/configuration/ae-idp-configure.png) -1. Under "Sign on URL", copy and paste the URL for your SAML IdP. - ![Text field for SAML IdP's sign-on URL](/assets/images/enterprise/configuration/ae-idp-sign-on-url.png) -1. Under "Issuer", copy and paste the issuer URL for your SAML IdP. - ![Text field for SAML IdP's issuer URL](/assets/images/enterprise/configuration/ae-idp-issuer-url.png) -1. Under "Public certificate", copy and paste the public certificate for your SAML IdP. - ![Text field for SAML IdP's public certificate](/assets/images/enterprise/configuration/ae-idp-public-certificate.png) -1. Click **Test SAML configuration** to ensure that the information you've entered is correct. - !["Test SAML configuration" button](/assets/images/enterprise/configuration/ae-test-saml-configuration.png) -1. Click **Save**. - !["Save" button for IdP configuration](/assets/images/enterprise/configuration/ae-save.png) +1. [ID プロバイダーの設定] の右側にある **[構成]** をクリックします。 + ![IdP 構成の [構成] ボタン](/assets/images/enterprise/configuration/ae-idp-configure.png) +1. [Sign on URL] で、SAML IdP の URL をコピーして貼り付けます。 + ![SAML IdP のサインオン URL のテキスト フィールド](/assets/images/enterprise/configuration/ae-idp-sign-on-url.png) +1. [Issuer] の下に、SAML IdP の発行者 URL をコピーして貼り付けます。 + ![SAML IdP の発行者 URL のテキスト フィールド](/assets/images/enterprise/configuration/ae-idp-issuer-url.png) +1. [Public certificate] の下で、SAML IdP の公開証明書をコピーして貼り付けます。 + ![SAML IdP の公開証明書のテキスト フィールド](/assets/images/enterprise/configuration/ae-idp-public-certificate.png) +1. **[SAML 構成のテスト]** をクリックして、入力した情報が正しいことを確認します。 + ![[SAML 構成のテスト] ボタン](/assets/images/enterprise/configuration/ae-test-saml-configuration.png) +1. **[保存]** をクリックします。 + ![IdP 構成の [保存] ボタン](/assets/images/enterprise/configuration/ae-save.png) 1. {% data reusables.saml.assert-the-administrator-attribute %} -## Setting your enterprise policies +## Enterprise のポリシーを設定する -Configuring policies will set limitations for repository and organization management for your enterprise. These can be reconfigured after the initialization process. +ポリシーを設定すると、Enterprise のリポジトリと Organization の管理に制限が設定されます。 これらは、初期化プロセスの後に再設定できます。 -1. To the right of "Set your enterprise policies", click **Configure**. - !["Configure" button for policies configuration](/assets/images/enterprise/configuration/ae-policies-configure.png) -2. Under "Default Repository Permissions", use the drop-down menu and click a default permissions level for repositories in your enterprise. If a person has multiple avenues of access to an organization, either individually, through a team, or as an organization member, the highest permission level overrides any lower permission levels. Optionally, to allow organizations within your enterprise to set their default repository permissions, click **No policy** - ![Drop-down menu for default repository permissions options](/assets/images/enterprise/configuration/ae-repository-permissions-menu.png) -3. Under "Repository creation", choose whether you want to allow members to create repositories. Optionally, to allow organizations within your enterprise to set permissions, click **No policy**. - !["Members can create repositories" button for enterprise policies configuration](/assets/images/enterprise/configuration/ae-repository-creation-permissions.png) -4. Under "Repository forking", choose whether to allow forking of private and internal repositories. Optionally, to allow organizations within your enterprise to set permissions, click **No policy** - ![Drop-down menu for repository forking permissions options](/assets/images/enterprise/configuration/ae-repository-forking-menu.png) -5. Under "Repository invitations", choose whether members or organization owners can invite collaborators to repositories. Optionally, to allow organizations within your enterprise to set permissions, click **No policy** - ![Drop-down menu for repository invitation permissions options](/assets/images/enterprise/configuration/ae-repository-invitations-menu.png) -6. Under "Default repository visibility", use the drop-down menu and click the default visibility setting for new repositories. - ![Drop-down menu for default repository visibility options](/assets/images/enterprise/configuration/ae-repository-visibility-menu.png) -7. Under "Users can create organizations", use the drop-down menu to enable or disable organization creation access for members of the enterprise. - ![Drop-down menu for organization creation permissions options](/assets/images/enterprise/configuration/ae-organization-creation-permissions-menu.png) -8. Under "Force pushes", use the drop-down menu and choose whether to allow or block force pushes. - ![Drop-down menu for force pushes configuration options](/assets/images/enterprise/configuration/ae-force-pushes-configuration-menu.png) -9. Under "Git SSH access", use the drop-down menu and choose whether to enable Git SSH access for all repositories in the enterprise. - ![Drop-down menu for Git SSH access options](/assets/images/enterprise/configuration/ae-git-ssh-access-menu.png) -10. Click **Save** - !["Save" button for enterprise policies configuration](/assets/images/enterprise/configuration/ae-save.png) -11. Optionally, to reset all selections, click "Reset to default policies". - ![Link to reset all default policies](/assets/images/enterprise/configuration/ae-reset-default-options.png) +1. [Enterprise ポリシーの設定] の右側にある **[構成]** をクリックします。 + ![ポリシー構成の [構成] ボタン](/assets/images/enterprise/configuration/ae-policies-configure.png) +2. [Default Repository Permissions] の下で、ドロップダウンメニューを使用して、Enterprise 内のリポジトリのデフォルトの権限レベルをクリックします。 個人、チーム、または Organization のメンバーとして、Organization への複数のアクセス手段がある場合、最上位の権限レベルが下位の権限レベルよりも優先されます。 必要に応じて、Enterprise 内の組織が既定のリポジトリのアクセス許可を設定できるようにするには、 **[ポリシーなし]** をクリックします。 + ![既定のリポジトリ アクセス許可オプションのドロップダウン メニュー](/assets/images/enterprise/configuration/ae-repository-permissions-menu.png) +3. [Repository creation] の下で、メンバーにリポジトリの作成を許可するかどうかを選択します。 必要に応じて、Enterprise 内の組織がアクセス許可を設定できるようにするには、 **[ポリシーなし]** をクリックします。 + ![Enterprise ポリシー構成用の [メンバーがリポジトリを作成できるようにする] ボタン](/assets/images/enterprise/configuration/ae-repository-creation-permissions.png) +4. [Repository forking] の下で、プライベートリポジトリと内部リポジトリのフォークを許可するかどうかを選択します。 必要に応じて、Enterprise 内の組織にアクセス許可の設定を許可するには、 **[ポリシーなし]** をクリックします。 + ![リポジトリのフォーク アクセス許可オプションのドロップダウン メニュー](/assets/images/enterprise/configuration/ae-repository-forking-menu.png) +5. [Repository invitations] の下で、メンバーまたは Organization のオーナーがコラボレータをリポジトリに招待できるかどうかを選択します。 必要に応じて、Enterprise 内の組織にアクセス許可の設定を許可するには、 **[ポリシーなし]** をクリックします。 + ![リポジトリの招待アクセス許可オプションのドロップダウン メニュー](/assets/images/enterprise/configuration/ae-repository-invitations-menu.png) +6. [Default repository visibility] で、ドロップダウンメニューを使用して、新しいリポジトリのデフォルトの可視性設定をクリックします。 + ![既定のリポジトリ可視性オプションのドロップダウン メニュー](/assets/images/enterprise/configuration/ae-repository-visibility-menu.png) +7. [Users can create organizations] の下で、ドロップダウンメニューを使用して、Enterprise のメンバーの Organization 作成アクセスを有効または無効にします。 + ![組織の作成アクセス許可オプションのドロップダウン メニュー](/assets/images/enterprise/configuration/ae-organization-creation-permissions-menu.png) +8. [Force pushes] の下で、ドロップダウンメニューを使用して、フォースプッシュを許可するかブロックするかを選択します。 + ![強制プッシュ構成オプションのドロップダウン メニュー](/assets/images/enterprise/configuration/ae-force-pushes-configuration-menu.png) +9. [Git SSH access] の下で、ドロップダウンメニューを使用して、Enterprise 内のすべてのリポジトリに対して Git SSH アクセスを有効にするかどうかを選択します。 + ![Git SSH アクセス オプションのドロップダウン メニュー](/assets/images/enterprise/configuration/ae-git-ssh-access-menu.png) +10. **[保存]** ボタンをクリックします。 + ![Enterprise ポリシー構成の [保存] ボタン](/assets/images/enterprise/configuration/ae-save.png) +11. 必要に応じて、すべての選択をリセットするには、[Reset to default policies] をクリックします。 + ![すべての既定のポリシーをリセットするためのリンク](/assets/images/enterprise/configuration/ae-reset-default-options.png) -## Setting your internal support contact +## 内部のサポート連絡先を設定する -You can configure the method your users will use to contact your internal support team. This can be reconfigured after the initialization process. +ユーザが内部のサポートチームに連絡する方法を設定できます。 これは、初期化プロセスの後に再設定できます。 -1. To the right of "Internal support contact", click **Configure**. - !["Configure" button for internal support contact configuration](/assets/images/enterprise/configuration/ae-support-configure.png) -2. Under "Internal support contact", select the method for users of your enterprise to contact support, through a URL or an e-mail address. Then, type the support contact information. - ![Text field for internal support contact URL](/assets/images/enterprise/configuration/ae-support-link-url.png) -3. Click **Save**. - !["Save" button for enterprise support contact configuration](/assets/images/enterprise/configuration/ae-save.png) +1. [内部サポート連絡先] の右側にある **[構成]** をクリックします。 + ![内部サポート連絡先構成の [構成] ボタン](/assets/images/enterprise/configuration/ae-support-configure.png) +2. [Internal support contact] の下で、Enterprise のユーザが URL またはメールアドレスを使用してサポートに連絡する方法を選択します。 次に、サポートの連絡先情報を入力します。 + ![内部サポート連絡先 URL のテキスト フィールド](/assets/images/enterprise/configuration/ae-support-link-url.png) +3. **[保存]** をクリックします。 + ![Enterprise サポート連絡先構成の [保存] ボタン](/assets/images/enterprise/configuration/ae-save.png) -## Setting your email settings +## メール設定 -Once this is initialized, you can reconfigure any settings after the initialization process. For more information, see "[Configuring email for notifications](/admin/configuration/configuring-email-for-notifications)." +これを初期化すると、初期化プロセス後に再設定できます。 詳細については、「[通知のためのメールを設定する](/admin/configuration/configuring-email-for-notifications)」を参照してください。 -1. To the right of "Configure email settings", click **Configure**. - !["Configure" button for email settings configuration](/assets/images/enterprise/configuration/ae-email-configure.png) -2. Select **Enable email**. This will enable both outbound and inbound email, however, for inbound email to work you will also need to configure your DNS settings. For more information, see "[Configuring DNS and firewall - settings to allow incoming emails](/admin/configuration/configuring-email-for-notifications#configuring-dns-and-firewall-settings-to-allow-incoming-emails)." - !["Enable" checkbox for email settings configuration](/assets/images/enterprise/configuration/ae-enable-email-configure.png) -3. Complete your email server settings: - - In the **Server address** field, type the address of your SMTP server. - - In the **Port** field, type the port that your SMTP server uses to send email. - - In the **Domain** field, type the domain name that your SMTP server will send with a HELO response, if any. - - In the **Authentication** dropdown, choose the type of encryption used by your SMTP server. - - In the **No-reply email address** field, type the email address to use in the From and To fields for all notification emails. +1. [メール設定の構成] の右側にある **[構成]** をクリックします。 + ![メール設定の構成の [構成] ボタン](/assets/images/enterprise/configuration/ae-email-configure.png) +2. **[メールを有効にする]** を選択します。 これにより、アウトバウンドメールとインバウンドメールの両方が有効になりますが、インバウンドメールが動作するようにするには、DNS 設定を行う必要があります。 詳細については、「[受信メールを許可するための DNS とファイアウォールの設定の構成](/admin/configuration/configuring-email-for-notifications#configuring-dns-and-firewall-settings-to-allow-incoming-emails)」を参照してください。 + ![メール設定の [有効にする] チェックボックス](/assets/images/enterprise/configuration/ae-enable-email-configure.png) +3. メールサーバーの設定を完了します。 + - **[サーバー アドレス]** フィールドに SMTP サーバーのアドレスを入力します。 + - **[ポート]** フィールドに、SMTP サーバーがメールの送信に使用するポートを入力します。 + - **[ドメイン]** フィールドに、SMTP サーバーから HELO 応答が送信されるドメイン名 (存在する場合) を入力します。 + - **[認証]** ドロップダウンで SMTP サーバーで使用される暗号化の種類を選択します。 + - **[No-reply メール アドレス]** フィールドに、すべての通知メールの [送信元] フィールドと [宛先] フィールドに使用するメール アドレスを入力します。 -4. If you want to discard all incoming emails that are addressed to the no-reply email address, select **Discard email addressed to the no-reply email address**. - !["Discard" checkbox for email settings configuration](/assets/images/enterprise/configuration/ae-discard-email.png) -5. Click **Test email settings**. - !["Test email settings" button for email settings configuration](/assets/images/enterprise/configuration/ae-test-email.png) -6. Under "Send test email to," type the email address where you want to send a test email, then click **Send test email**. - !["Send test email" button for email settings configuration](/assets/images/enterprise/configuration/ae-send-test-email.png) -7. Click **Save**. - !["Save" button for enterprise support contact configuration](/assets/images/enterprise/configuration/ae-save.png) +4. no-reply メール アドレスへの着信メールをすべて破棄したい場合には、 **[no-reply メール アドレスへのメールの破棄]** を選択してください。 + ![メール設定の [破棄] チェック ボックス](/assets/images/enterprise/configuration/ae-discard-email.png) +5. **[メール設定のテスト]** をクリックします。 + ![メール設定の [メール設定のテスト] ボタン](/assets/images/enterprise/configuration/ae-test-email.png) +6. [テスト メールの送信先] で、テスト用メールを送信するメール アドレスを入力し、 **[テスト メールの送信]** をクリックします。 + ![メール設定の [テスト メールの送信] ボタン](/assets/images/enterprise/configuration/ae-send-test-email.png) +7. **[保存]** をクリックします。 + ![Enterprise サポート連絡先構成の [保存] ボタン](/assets/images/enterprise/configuration/ae-save.png) diff --git a/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md b/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md deleted file mode 100644 index 83ddf7c56e..0000000000 --- a/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Enterprise へのネットワークトラフィックを制限する -shortTitle: Restricting network traffic -intro: IP 許可リストを使用して、Enterprise へのアクセスを指定された IP アドレスからの接続に制限できます。 -versions: - ghae: '*' -type: how_to -topics: - - Access management - - Enterprise - - Fundamentals - - Networking - - Security -redirect_from: - - /admin/configuration/restricting-network-traffic-to-your-enterprise -ms.openlocfilehash: 67c7067362ac94e5cbc64be4704ba0ec3f6606e0 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147682853' ---- -## IP 許可リストについて - -デフォルトでは、許可されたユーザは任意の IP アドレスから Enterprise にアクセスできます。 Enterprise のオーナーは、特定の IP アドレスに対する許可リストを設定することで、Enterprise アカウントの Organization が所有するアセットへのアクセスを制限できます。 {% data reusables.identity-and-permissions.ip-allow-lists-example-and-restrictions %} - -{% data reusables.identity-and-permissions.ip-allow-lists-cidr-notation %} - -{% data reusables.identity-and-permissions.ip-allow-lists-enable %} {% data reusables.identity-and-permissions.ip-allow-lists-enterprise %} - -許可 IP アドレスを、Organization ごとに設定することもできます。 詳しくは、「[Organization で許可される IP アドレスの管理](/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization)」を参照してください。 - -既定では、Azure ネットワークセキュリティグループ (NSG) ルールで、ポート 22、80、443、および 25 ですべてのインバウンドトラフィックが開いたままになります。 Enterprise オーナーは {% data variables.contact.github_support %} に問い合わせて、インスタンスのアクセス制限を設定できます。 - -Azure NSG を使用したインスタンスレベルの制限については、Enterprise インスタンスへのアクセスを許可する必要がある IP アドレスを {% data variables.contact.github_support %} に問い合わせてください。 標準の CIDR (Classless Inter-Domain Routing) 形式を使用してアドレス範囲を指定します。 {% data variables.contact.github_support %} は、HTTP、SSH、HTTPS、SMTP を介したネットワークアクセスを制限するために、Enterprise に適切なファイアウォールルールを設定します。 詳細については、「[{% data variables.contact.github_support %} からのヘルプの受信](/admin/enterprise-support/receiving-help-from-github-support)」を参照してください。 - -## 許可 IP アドレスを追加する - -{% data reusables.identity-and-permissions.about-adding-ip-allow-list-entries %} - -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} {% data reusables.identity-and-permissions.ip-allow-lists-add-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-add-description %} {% data reusables.identity-and-permissions.ip-allow-lists-add-entry %} {% data reusables.identity-and-permissions.check-ip-address %} - -## {% data variables.product.prodname_github_apps %}によるアクセスの許可 - -{% data reusables.identity-and-permissions.ip-allow-lists-githubapps-enterprise %} - -## 許可 IP アドレスを有効化する - -{% data reusables.identity-and-permissions.about-enabling-allowed-ip-addresses %} - -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} -1. [IP 許可リスト] で、 **[IP 許可リストを有効にする]** を選択します。 - ![IP アドレスを許可するチェックボックス](/assets/images/help/security/enable-ip-allowlist-enterprise-checkbox.png) -4. **[保存]** をクリックします。 - -## 許可 IP アドレスを編集する - -{% data reusables.identity-and-permissions.about-editing-ip-allow-list-entries %} - -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-entry %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-description %} -8. **[Update]** をクリックします。 -{% data reusables.identity-and-permissions.check-ip-address %} - -{% ifversion ip-allow-list-address-check %} -## IP アドレスが許可されているかどうかを確認する - -{% data reusables.identity-and-permissions.about-checking-ip-address %} - -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} {% data reusables.identity-and-permissions.check-ip-address-step %} {% endif %} - -## 許可 IP アドレスを削除する - -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} {% data reusables.identity-and-permissions.ip-allow-lists-delete-entry %} {% data reusables.identity-and-permissions.ip-allow-lists-confirm-deletion %} - -## IP許可リストで {% data variables.product.prodname_actions %} を使用する - -{% data reusables.actions.ip-allow-list-self-hosted-runners %} diff --git a/translations/ja-JP/content/admin/enterprise-management/configuring-clustering/initializing-the-cluster.md b/translations/ja-JP/content/admin/enterprise-management/configuring-clustering/initializing-the-cluster.md index d9f9b98dbc..f8f4e42a5d 100644 --- a/translations/ja-JP/content/admin/enterprise-management/configuring-clustering/initializing-the-cluster.md +++ b/translations/ja-JP/content/admin/enterprise-management/configuring-clustering/initializing-the-cluster.md @@ -1,6 +1,6 @@ --- -title: Initializing the cluster -intro: 'A {% data variables.product.prodname_ghe_server %} cluster must be set up with a license and initialized using the administrative shell (SSH).' +title: クラスタの初期化 +intro: '{% data variables.product.prodname_ghe_server %} クラスタはライセンスを使用して設定し、管理シェル (SSH) を使用して初期化する必要があります。' redirect_from: - /enterprise/admin/clustering/initializing-the-cluster - /enterprise/admin/enterprise-management/initializing-the-cluster @@ -11,46 +11,50 @@ type: how_to topics: - Clustering - Enterprise +ms.openlocfilehash: 91394d1d39301f77bc49a87012e04c3d5e9c3b60 +ms.sourcegitcommit: ced661bdffebd0f96f6f76db109fbe31983448ba +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167089' --- {% data reusables.enterprise_clustering.clustering-requires-https %} -## Installing {% data variables.product.prodname_ghe_server %} +## {% data variables.product.prodname_ghe_server %}のインストール -1. On each cluster node, provision and install {% data variables.product.prodname_ghe_server %}. For more information, see "[Setting up a {% data variables.product.prodname_ghe_server %} instance](/enterprise/admin/guides/installation/setting-up-a-github-enterprise-server-instance)." -2. Using the administrative shell or DHCP, **only** configure the IP address of each node. Don't configure any other settings. +1. 各クラスタノードで {% data variables.product.prodname_ghe_server %} をプロビジョニングしてインストールします。 詳細については、「[{% data variables.product.prodname_ghe_server %} インスタンスをセットアップする](/enterprise/admin/guides/installation/setting-up-a-github-enterprise-server-instance)」を参照してください。 +2. 管理シェルまたは DHCP を使用し、各ノードの IP アドレス **のみ** を構成します。 その他の設定は行わないでください。 -## Configuring the first node +## 最初のノードの設定 -1. Connect to the node that will be designated as MySQL primary in `cluster.conf`. For more information, see "[About the cluster configuration file](/enterprise/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)." -2. In your web browser, visit `https://:8443/setup/`. -{% data reusables.enterprise_installation.upload-a-license-file %} -{% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} -{% data reusables.enterprise_installation.instance-will-restart-automatically %} +1. `cluster.conf` で MySQL プライマリとして指定されるノードに接続します。 詳しくは、「[クラスター構成ファイルについて](/enterprise/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)」を参照してください。 +2. Web ブラウザーで `https://:8443/setup/` に移動します。 +{% data reusables.enterprise_installation.upload-a-license-file %} {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} {% data reusables.enterprise_installation.instance-will-restart-automatically %} -## Initializing the cluster +## クラスタの初期化 -To initialize the cluster, you need a cluster configuration file (`cluster.conf`). For more information, see "[About the cluster configuration file](/enterprise/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)". +クラスターを初期化するためには、クラスター設定ファイル (`cluster.conf`) が必要です。 詳しくは、「[クラスター構成ファイルについて](/enterprise/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)」を参照してください。 -1. From the first node that was configured, run `ghe-cluster-config-init`. This will initialize the cluster if there are nodes in the cluster configuration file that are not configured. -2. Run `ghe-cluster-config-apply`. This will validate the `cluster.conf` file, apply the configuration to each node file and bring up the configured services on each node. +1. 構成された最初のノードから `ghe-cluster-config-init` を実行します。 実行すると、クラスタ設定ファイルに設定されていないノードがある場合にクラスタを初期化します。 +2. `ghe-cluster-config-apply` を実行する。 これにより、`cluster.conf` ファイルを検証して各ノードファイルに設定を適用し、各ノードで設定されたサービスを起動します。 -To check the status of a running cluster use the `ghe-cluster-status` command. +実行中のクラスターの状態を確認するには、`ghe-cluster-status` コマンドを使います。 -## About the cluster configuration file +## クラスタ設定ファイルについて -The cluster configuration file (`cluster.conf`) defines the nodes in the cluster, and what services they run. -For more information, see "[About cluster nodes](/enterprise/admin/guides/clustering/about-cluster-nodes)." +クラスタ設定ファイル (`cluster.conf`) は、クラスター中のノードと、その上で動作するサービスを定義します。 +詳しくは、「[クラスター ノードについて](/enterprise/admin/guides/clustering/about-cluster-nodes)」を参照してください。 -This example `cluster.conf` defines a cluster with 11 nodes. +この例 `cluster.conf` では、11 のノードでクラスターを定義します。 - - Two nodes called `ghes-front-end-node-\*` run services responsible for responding to client requests. - - Three nodes called `ghes-database-node-\*` run services responsible for storage, retrieval, and replication of database data. - - Three nodes called `ghes-search-node-\*` run services responsible for search functionality. - - Three nodes called `ghes-storage-node-\*` run services responsible for storage, retrieval, and replication of data. + - `ghes-front-end-node-\*` と呼ばれる 2 つのノードによって、クライアント要求に応答するサービスが実行されます。 + - `ghes-database-node-\*` と呼ばれる 3 つのノードによって、データベース データのストレージ、取得、レプリケーションを行うサービスが実行されます。 + - `ghes-search-node-\*` と呼ばれる 3 つのノードによって、検索機能を行うサービスが実行されます。 + - `ghes-storage-node-\*` と呼ばれる 3 つのノードによって、データのストレージ、取得、レプリケーションを行うサービスが実行されます。 -The names of the nodes can be any valid hostname you choose. The names are set as the hostname of each node, and will also be added to `/etc/hosts` on each node, so that the nodes are locally resolvable to each other. +ノードの名前には、ホスト名として有効な任意の名前を選択できます。 この名前は各ノードのホスト名として設定され、各ノードの `/etc/hosts` に追加され、各ノードがローカルでお互いを解決できるようにします。 -Specify the first cluster node you configured as the MySQL primary via `mysql-server` and `mysql-master`. +`mysql-server` と `mysql-master` 経由で MySQL プライマリとして構成した最初のクラスター ノードを指定します。 ```ini [cluster] @@ -155,7 +159,7 @@ Specify the first cluster node you configured as the MySQL primary via `mysql-se metrics-server = true ``` -Create the file `/data/user/common/cluster.conf` on the configured first node. For example, using `vim`: +構成された最初のノードでファイル `/data/user/common/cluster.conf` を作成します。 たとえば、`vim` を使用する場合は次のようになります。 ```shell ghe-data-node-1:~$ sudo vim /data/user/common/cluster.conf diff --git a/translations/ja-JP/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md b/translations/ja-JP/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md new file mode 100644 index 0000000000..6336814ef8 --- /dev/null +++ b/translations/ja-JP/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md @@ -0,0 +1,49 @@ +--- +title: Enabling GitHub Actions with MinIO storage +intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use MinIO storage to store data generated by workflow runs.' +permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.' +versions: + ghes: '*' +type: how_to +topics: + - Actions + - Enterprise + - Infrastructure + - Storage +redirect_from: + - /admin/github-actions/enabling-github-actions-with-minio-gateway-for-nas-storage + - /admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-gateway-for-nas-storage +shortTitle: MinIO storage +--- + +## Prerequisites + +Before enabling {% data variables.product.prodname_actions %}, make sure you have completed the following steps: + +* Create your MinIO bucket for storing data generated by workflow runs. For more information about installing and configuring MinIO, see "[MinIO High Performance Object Storage](https://min.io/docs/minio/container/index.html)" and "[mc mb](https://min.io/docs/minio/linux/reference/minio-mc/mc-mb.html)" in the MinIO documentation. + + To avoid resource contention on the appliance, we recommend that MinIO be hosted separately from {% data variables.location.product_location %}. + + {% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %} +{% data reusables.actions.enterprise-common-prereqs %} + +## Enabling {% data variables.product.prodname_actions %} with MinIO storage + +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.management-console %} +{% data reusables.enterprise_management_console.actions %} +{% data reusables.actions.enterprise-enable-checkbox %} +1. Under "Artifact & Log Storage", select **Amazon S3**, and enter your storage bucket's details: + + * **AWS Service URL**: The URL to your MinIO service. For example, `https://my-minio.example:9000`. + * **AWS S3 Bucket**: The name of your S3 bucket. + * **AWS S3 Access Key** and **AWS S3 Secret Key**: The `MINIO_ACCESS_KEY` and `MINIO_SECRET_KEY` used for your MinIO instance. + + ![Radio button for selecting Amazon S3 Storage and fields for MinIO configuration](/assets/images/enterprise/management-console/actions-minio-s3-storage.png) +1. Under "Artifact & Log Storage", select **Force path style**. + + ![Checkbox to Force path style](/assets/images/enterprise/management-console/actions-minio-force-path-style.png) +{% data reusables.enterprise_management_console.test-storage-button %} +{% data reusables.enterprise_management_console.save-settings %} + +{% data reusables.actions.enterprise-postinstall-nextsteps %} diff --git a/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md b/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md index 58f812ba1b..7f15208817 100644 --- a/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md +++ b/translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md @@ -1,7 +1,7 @@ --- -title: Migrating your enterprise to GitHub Actions +title: GitHub Actions への Enterprise の移行 shortTitle: Migrate to Actions -intro: 'Learn how to plan a migration to {% data variables.product.prodname_actions %} for your enterprise from another provider.' +intro: '別のプロバイダーから Enterprise の {% data variables.product.prodname_actions %} への移行を計画する方法について学びます。' versions: ghec: '*' ghes: '*' @@ -10,78 +10,83 @@ type: how_to topics: - Actions - Enterprise +ms.openlocfilehash: 332d8af7f1087626509a9c72751882ea11f3072f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160300' --- +## {% data variables.product.prodname_actions %} への Enterprise の移行について -## About enterprise migrations to {% data variables.product.prodname_actions %} +既存のシステムから {% data variables.product.prodname_actions %} に Enterprise を移行するために、移行を計画し、移行を完了し、既存のシステムを廃止します。 -To migrate your enterprise to {% data variables.product.prodname_actions %} from an existing system, you can plan the migration, complete the migration, and retire existing systems. +このガイドでは、移行に関する具体的な考慮事項について説明します。 {% data variables.product.prodname_actions %} を Enterprise に導入する方法の詳細については、「[Enterprise への {% data variables.product.prodname_actions %} の導入](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise)」を参照してください。 -This guide addresses specific considerations for migrations. For additional information about introducing {% data variables.product.prodname_actions %} to your enterprise, see "[Introducing {% data variables.product.prodname_actions %} to your enterprise](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise)." +## 移行を計画する -## Planning your migration +Enterprise を {% data variables.product.prodname_actions %} に移行する前に、移行するワークフローとその移行がチームにどのように影響するかを特定し、移行を完了する方法とタイミングを計画する必要があります。 -Before you begin migrating your enterprise to {% data variables.product.prodname_actions %}, you should identify which workflows will be migrated and how those migrations will affect your teams, then plan how and when you will complete the migrations. +### 移行スペシャリストの活用 -### Leveraging migration specialists +{% data variables.product.company_short %} が移行に役立つ場合があります。また、{% data variables.product.prodname_professional_services %} を購入する利点が得られる場合もあります。 詳細については、専任の担当者または {% data variables.contact.contact_enterprise_sales %} にお問い合わせください。 -{% data variables.product.company_short %} can help with your migration, and you may also benefit from purchasing {% data variables.product.prodname_professional_services %}. For more information, contact your dedicated representative or {% data variables.contact.contact_enterprise_sales %}. +### 移行ターゲットの特定とインベントリ作成 -### Identifying and inventorying migration targets +{% data variables.product.prodname_actions %} に移行する前に、既存のシステムで Enterprise によって使用されているワークフローを完全に理解しておく必要があります。 -Before you can migrate to {% data variables.product.prodname_actions %}, you need to have a complete understanding of the workflows being used by your enterprise in your existing system. +まず、Enterprise 内の既存のビルドおよびリリース ワークフローのインベントリを作成し、どのワークフローがアクティブに使用されていて移行する必要があるかと、取り残されている可能性があるのはどれかに関する情報を収集します。 -First, create an inventory of the existing build and release workflows within your enterprise, gathering information about which workflows are being actively used and need to migrated and which can be left behind. +次に、現在のプロバイダーと {% data variables.product.prodname_actions %} の違いを確認します。 これは、各ワークフローの移行に関する問題や、Enterprise で機能の違いが生じる可能性がある場所を評価するのに役立ちます。 詳細については、「[{% data variables.product.prodname_actions %} への移行](/actions/migrating-to-github-actions)」を参照してください。 -Next, learn the differences between your current provider and {% data variables.product.prodname_actions %}. This will help you assess any difficulties in migrating each workflow, and where your enterprise might experience differences in features. For more information, see "[Migrating to {% data variables.product.prodname_actions %}](/actions/migrating-to-github-actions)." +この情報を使用すると、{% data variables.product.prodname_actions %} への移行が可能で必要であるワークフローを判断できます。 -With this information, you'll be able to determine which workflows you can and want to migrate to {% data variables.product.prodname_actions %}. +### 移行によるチームへの影響を特定する -### Determine team impacts from migrations +Enterprise 内で使用されているツールを変更すると、チームの作業に影響します。 既存のシステムから {% data variables.product.prodname_actions %} にワークフローを移行すると、開発者の日常業務にどのような影響を与えるかを考える必要があります。 -When you change the tools being used within your enterprise, you influence how your team works. You'll need to consider how moving a workflow from your existing systems to {% data variables.product.prodname_actions %} will affect your developers' day-to-day work. +移行の影響を受けるプロセス、統合、サード パーティ製のツールを特定し、行う必要がある更新の計画を立てます。 -Identify any processes, integrations, and third-party tools that will be affected by your migration, and make a plan for any updates you'll need to make. +移行がコンプライアンスに関する問題にどのように影響するかを考えます。 たとえば、既存の資格情報スキャンとセキュリティ分析ツールは {% data variables.product.prodname_actions %} で動作しますか? それとも、新しいツールを使用する必要がありますか? -Consider how the migration may affect your compliance concerns. For example, will your existing credential scanning and security analysis tools work with {% data variables.product.prodname_actions %}, or will you need to use new tools? +既存のシステムのゲートとチェックを特定し、{% data variables.product.prodname_actions %} で実装できることを確認します。 -Identify the gates and checks in your existing system and verify that you can implement them with {% data variables.product.prodname_actions %}. +### 移行ツールの特定と検証 -### Identifying and validating migration tools +自動移行ツールを使用すると、Enterprise のワークフローを既存のシステムの構文から、{% data variables.product.prodname_actions %} で必要な構文に変換できます。 サードパーティ製のツールを特定するか、専任の担当者または {% data variables.contact.contact_enterprise_sales %} に問い合わせて、{% data variables.product.company_short %} が提供できるツールについて確認します。 たとえば、{% data variables.product.prodname_actions_importer %} を使用して、サポートされているさまざまなサービスから CI パイプラインの計画、スコープ設定を行い、{% data variables.product.prodname_actions %} に移行することができます。 詳しくは、「[{% data variables.product.prodname_actions_importer %} を使用した移行の自動化](/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer)」をご覧ください。 -Automated migration tools can translate your enterprise's workflows from the existing system's syntax to the syntax required by {% data variables.product.prodname_actions %}. Identify third-party tooling or contact your dedicated representative or {% data variables.contact.contact_enterprise_sales %} to ask about tools that {% data variables.product.company_short %} can provide. For example, you can use the {% data variables.product.prodname_actions_importer %} to plan, scope, and migrate your CI pipelines to {% data variables.product.prodname_actions %} from various supported services. For more information, see "[Automating migration with {% data variables.product.prodname_actions_importer %}](/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer)." +移行を自動化するツールを特定した後、一部のテスト ワークフローでツールを実行し、結果が期待どおりであることを確認することで、ツールを検証します。 -After you've identified a tool to automate your migrations, validate the tool by running the tool on some test workflows and verifying that the results are as expected. +自動化されたツールではほとんどのワークフローを移行できるはずですが、少なくともごく一部は手動で書き換える必要がある可能性があります。 完了する必要がある手動の作業量を見積もります。 -Automated tooling should be able to migrate the majority of your workflows, but you'll likely need to manually rewrite at least a small percentage. Estimate the amount of manual work you'll need to complete. +### 移行アプローチの決定 -### Deciding on a migration approach +Enterprise に最適な移行アプローチを決定します。 小規模なチームでは、"完全な置き換え" アプローチを使用して、すべてのワークフローを一度に移行できる場合があります。 大規模な Enterprise では、反復的なアプローチの方がより現実的な場合があります。 移行全体を中央で管理することも、個々のチームに独自のワークフローを移行してセルフ サービスを依頼することもできます。 -Determine the migration approach that will work best for your enterprise. Smaller teams may be able to migrate all their workflows at once, with a "rip-and-replace" approach. For larger enterprises, an iterative approach may be more realistic. You can choose to have a central body manage the entire migration or you can ask individual teams to self serve by migrating their own workflows. +アクティブな管理とセルフ サービスを組み合わせた反復的なアプローチをお勧めします。 内部チャンピオンとしての役割を果たせる早期導入者の小規模なグループから始めます。 ビジネスの幅を表すのに十分に包括的な一部のワークフローを特定します。 早期導入者と協力して、これらのワークフローを {% data variables.product.prodname_actions %} に移行し、必要に応じて反復処理します。 これにより、他のチームもワークフローを移行できることを確信できます。 -We recommend an iterative approach that combines active management with self service. Start with a small group of early adopters that can act as your internal champions. Identify a handful of workflows that are comprehensive enough to represent the breadth of your business. Work with your early adopters to migrate those workflows to {% data variables.product.prodname_actions %}, iterating as needed. This will give other teams confidence that their workflows can be migrated, too. +その後、より大規模な Organization で {% data variables.product.prodname_actions %} を使用できるようにします。 これらのチームが独自のワークフローを {% data variables.product.prodname_actions %} に移行するのに役立つリソースを提供し、既存のシステムが廃止されるタイミングをチームに知らせます。 -Then, make {% data variables.product.prodname_actions %} available to your larger organization. Provide resources to help these teams migrate their own workflows to {% data variables.product.prodname_actions %}, and inform the teams when the existing systems will be retired. +最後に、特定の期間内に移行を完了するために古いシステムをまだ使用しているチームに知らせます。 他のチームの成功を示し、移行が可能で望ましいことを伝えて安心させます。 -Finally, inform any teams that are still using your old systems to complete their migrations within a specific timeframe. You can point to the successes of other teams to reassure them that migration is possible and desirable. +### 移行スケジュールの定義 -### Defining your migration schedule +移行アプローチを決定した後、各チームがワークフローを {% data variables.product.prodname_actions %} に移行するタイミングを示すスケジュールを作成します。 -After you decide on a migration approach, build a schedule that outlines when each of your teams will migrate their workflows to {% data variables.product.prodname_actions %}. +まず、移行を完了する日付を決定します。 たとえば、現在のプロバイダーとの契約が終了するまでに移行を完了することを計画できます。 -First, decide the date you'd like your migration to be complete. For example, you can plan to complete your migration by the time your contract with your current provider ends. +その後、チームと協力して、チームの目標を犠牲にすることなく、期限に間に合うスケジュールを作成します。 移行を求める個々のチームのビジネスの周期とワークロードを確認します。 各チームと連携して、配信スケジュールを理解し、チームが配信能力に影響を与えない時間帯にワークフローを移行できるようにする計画を作成します。 -Then, work with your teams to create a schedule that meets your deadline without sacrificing their team goals. Look at your business's cadence and the workload of each individual team you're asking to migrate. Coordinate with each team to understand their delivery schedules and create a plan that allows the team to migrate their workflows at a time that won't impact their ability to deliver. +## {% data variables.product.prodname_actions %} への移行 -## Migrating to {% data variables.product.prodname_actions %} +移行を開始する準備ができたら、上記で計画した自動ツールと手動書き換えを使用して、既存のワークフローを {% data variables.product.prodname_actions %} に変換します。 -When you're ready to start your migration, translate your existing workflows to {% data variables.product.prodname_actions %} using the automated tooling and manual rewriting you planned for above. +また、おそらく成果物をアーカイブするスクリプト化されたプロセスを記述することで、既存のシステムからの古いビルド成果物を維持することもできます。 -You may also want to maintain old build artifacts from your existing system, perhaps by writing a scripted process to archive the artifacts. +## 既存のシステムの廃止 -## Retiring existing systems +移行が完了した後、既存のシステムの廃止について考えることができます。 -After your migration is complete, you can think about retiring your existing system. +一定期間、両方のシステムをサイド バイ サイドで実行しながら、{% data variables.product.prodname_actions %} 構成が安定しており、開発者のエクスペリエンスを低下させていないことを確認できます。 -You may want to run both systems side-by-side for some period of time, while you verify that your {% data variables.product.prodname_actions %} configuration is stable, with no degradation of experience for developers. - -Eventually, decommission and shut off the old systems, and ensure that no one within your enterprise can turn the old systems back on. +最終的に、古いシステムの使用を停止して切り離し、確実に Enterprise 内の誰も古いシステムを再び有効にできないようにします。 diff --git a/translations/ja-JP/content/admin/guides.md b/translations/ja-JP/content/admin/guides.md index 8dea20ba3c..421a537d68 100644 --- a/translations/ja-JP/content/admin/guides.md +++ b/translations/ja-JP/content/admin/guides.md @@ -63,7 +63,7 @@ includeGuides: - /admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise - /admin/configuration/initializing-github-ae - /admin/configuration/network-ports - - /admin/configuration/restricting-network-traffic-to-your-enterprise + - /admin/configuration/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list - /admin/configuration/site-admin-dashboard - /admin/configuration/troubleshooting-ssl-errors - /admin/configuration/using-github-enterprise-server-with-a-load-balancer @@ -147,11 +147,11 @@ includeGuides: - /admin/user-management/suspending-and-unsuspending-users - /admin/overview/creating-an-enterprise-account - /admin/user-management/managing-organizations-in-your-enterprise/restoring-a-deleted-organization -ms.openlocfilehash: 832e990d9b1c30895fce286f1357ef540a96af6f -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 +ms.openlocfilehash: 88a0fe93a3c2784d81d81f91a3b1c0311cac84c7 +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/09/2022 -ms.locfileid: '147854125' +ms.lasthandoff: 11/22/2022 +ms.locfileid: '148180131' --- diff --git a/translations/ja-JP/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise.md b/translations/ja-JP/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise.md index c060a0b236..5717ed907b 100644 --- a/translations/ja-JP/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise.md +++ b/translations/ja-JP/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise.md @@ -1,7 +1,7 @@ --- -title: About authentication for your enterprise +title: Enterprise の認証について shortTitle: About authentication -intro: 'You {% ifversion ghae %}must configure SAML single sign-on (SSO) so people can{% else %}can choose how people{% endif %} authenticate to access {% ifversion ghec %}your enterprise''s resources on {% data variables.product.product_name %}{% elsif ghes %}{% data variables.location.product_location %}{% elsif ghae %}your enterprise on {% data variables.product.product_name %}{% endif %}.' +intro: '{% ifversion ghec %}{% data variables.product.product_name %} 上にある Enterprise のリソース{% elsif ghes %}{% data variables.location.product_location %}{% elsif ghae %} 上にある Enterprise {% endif %}にユーザーがアクセスできるように{% ifversion ghae %} SAML シングル サインオン (SSO) を構成する必要があります{% else %}ユーザーを認証する方法を選ぶことができます{% data variables.product.product_name %}{% endif %}。' versions: ghec: '*' ghes: '*' @@ -13,136 +13,140 @@ topics: - Enterprise - Identity - SSO +ms.openlocfilehash: 16b5bdd98e37db2eef6fe7e4e02da1a4ce8fd406 +ms.sourcegitcommit: 34d500fe45b362043b4b4685d6705a7bfb484d11 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/15/2022 +ms.locfileid: '148164373' --- - -## About authentication for your enterprise +## Enterprise の認証について {% ifversion ghec %} -Enterprise owners on {% data variables.product.product_name %} can control the requirements for authentication and access to the enterprise's resources. +{% data variables.product.product_name %} の Enterprise 所有者は、Enterprise のリソースに対する認証とアクセスに関する要件を制御できます。 {% data reusables.enterprise.ghec-authentication-options %} -After learning more about these options, to determine which method is best for your enterprise, see "[Identifying the best authentication method for your enterprise](#identifying-the-best-authentication-method-for-your-enterprise)." +これらのオプションの詳しい情報を学習した後、Enterprise に最適な方法を決定するには、「[Enterprise に最適な認証方法を特定する](#identifying-the-best-authentication-method-for-your-enterprise)」を参照してください。 -## Authentication methods for {% data variables.product.product_name %} +## {% data variables.product.product_name %} の認証方法 -The following options are available for account management and authentication on {% data variables.product.product_name %}. +{% data variables.product.product_name %} のアカウント管理と認証には、次のオプションを使用できます。 -- [Authentication through {% data variables.location.product_location %}](#authentication-through-githubcom) -- [Authentication through {% data variables.location.product_location %} with additional SAML access restriction](#authentication-through-githubcom-with-additional-saml-access-restriction) -- [Authentication with {% data variables.product.prodname_emus %} and federation](#authentication-with-enterprise-managed-users-and-federation) +- [{% data variables.location.product_location %} による認証](#authentication-through-githubcom) +- [追加の SAML アクセス制限を使用した {% data variables.location.product_location %} による認証](#authentication-through-githubcom-with-additional-saml-access-restriction) +- [{% data variables.product.prodname_emus %} とフェデレーションを使用した認証](#authentication-with-enterprise-managed-users-and-federation) -### Authentication through {% data variables.location.product_location %} +### {% data variables.location.product_location %} による認証 -By default, each member must create a personal account on {% data variables.location.product_location %}. You grant access to your enterprise, and the member can access your enterprise's resources after signing into the account on {% data variables.location.product_location %}. The member manages the account, and can contribute to other enterprises, organizations, and repositories on {% data variables.location.product_location %}. +既定では、各メンバーは {% data variables.location.product_location %} に個人アカウントを作成する必要があります。 Enterprise へのアクセス権を付与すると、メンバーは {% data variables.location.product_location %} のアカウントにサインインした後、Enterprise のリソースにアクセスできます。 メンバーはアカウントを管理し、{% data variables.location.product_location %} の他の Enterprise、Organization、リポジトリに投稿できます。 -### Authentication through {% data variables.location.product_location %} with additional SAML access restriction +### 追加の SAML アクセス制限を使用した {% data variables.location.product_location %} による認証 -If you configure additional SAML access restriction, each member must create and manage a personal account on {% data variables.location.product_location %}. You grant access to your enterprise, and the member can access your enterprise's resources after both signing into the account on {% data variables.location.product_location %} and successfully authenticating with your SAML identity provider (IdP). The member can contribute to other enterprises, organizations, and repositories on {% data variables.location.product_location %} using their personal account. For more information about requiring SAML authentication for all access your enterprise's resources, see "[About SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam)." +追加の SAML アクセス制限を構成する場合は、各メンバーが {% data variables.location.product_location %} の個人アカウントを作成して管理する必要があります。 Enterprise へのアクセス権を付与すると、メンバーは {% data variables.location.product_location %} のアカウントにサインインし、SAML ID プロバイダー (IdP) で正常に認証した後に、Enterprise のリソースにアクセスできます。 メンバーは個人アカウントを使用して、{% data variables.location.product_location %} の他の Enterprise、Organization、リポジトリに投稿できます。 Enterprise のリソースへのすべてのアクセスに SAML 認証を要求する方法について詳しくは、「[Enterprise IAM の SAML について](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam)」を参照してください。 -If you use a standalone organization with {% data variables.product.product_name %}, or if you don't want to use SAML authentication for every organization in your enterprise, you can configure SAML for an individual organization. For more information, see "[About identity and access management with SAML single sign-on](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)." +{% data variables.product.product_name %} でスタンドアロン Organization を使用する場合、または Enterprise 内のすべての Organization に対して SAML 認証を使用しない場合は、個々の Organization に対して SAML を構成できます。 詳細については、「[SAML シングル サインオンを使うアイデンティティおよびアクセス管理について](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)」を参照してください。 -### Authentication with {% data variables.product.prodname_emus %} and federation +### {% data variables.product.prodname_emus %} とフェデレーションを使用した認証 -If you need more control of the accounts for your enterprise members on {% data variables.location.product_location %}, you can use {% data variables.product.prodname_emus %}. With {% data variables.product.prodname_emus %}, you provision and manage accounts for your enterprise members on {% data variables.location.product_location %} using your IdP. Each member signs into an account that you create, and your enterprise manages the account. Contributions to the rest of {% data variables.product.prodname_dotcom_the_website %} are restricted. For more information, see "[About {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users)." +{% data variables.location.product_location %} の Enterprise メンバーのアカウントをより細かく制御する必要がある場合は、{% data variables.product.prodname_emus %} を使用できます。 {% data variables.product.prodname_emus %} では、IdP を使用し、{% data variables.location.product_location %} の Enterprise メンバーのアカウントをプロビジョニングして管理します。 作成されたアカウントに各メンバーがサインインすると、Enterprise でそのアカウントが管理されます。 {% data variables.product.prodname_dotcom_the_website %} の残りの部分への投稿は制限されています。 詳細については、「[{% data variables.product.prodname_emus %} について](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users)」を参照してください。 -## Identifying the best authentication method for your enterprise +## Enterprise に最適な認証方法を特定する -Both SAML SSO and {% data variables.product.prodname_emus %} increase security for your enterprise's resources. {% data variables.product.prodname_emus %} additionally allows you to control the user accounts for your enterprise members and restricts what the accounts are able to do. However, those restrictions may be unacceptable for your enterprise if they obstruct your developers' workflows. +SAML SSO と {% data variables.product.prodname_emus %} の両方で、Enterprise のリソースのセキュリティが強化されます。 さらに、{% data variables.product.prodname_emus %} を使用すると、Enterprise メンバーのユーザー アカウントを管理し、アカウントで実行できる操作を制限できます。 ただし、これらの制限によって開発者のワークフローが妨げられる場合、Enterprise ではそれらを受け入れられないことがあります。 -To determine whether your enterprise would benefit more from SAML SSO or {% data variables.product.prodname_emus %}, ask yourself these questions. +Enterprise が SAML SSO と {% data variables.product.prodname_emus %} のどちらから、より多くのメリットを得られるかを判断するには、これらの質問を自問してください。 -- [Do you want to control the user accounts for your users?](#do-you-want-to-control-the-user-accounts-for-your-users) -- [Which identity provider does your enterprise use?](#which-identity-provider-does-your-enterprise-use) -- [Do your developers work in public repositories, gists, or {% data variables.product.prodname_pages %} sites?](#do-your-developers-work-in-public-repositories-gists-or-github-pages-sites) -- [Do your developers rely on collaboration outside of your enterprise?](#do-your-developers-rely-on-collaboration-outside-of-your-enterprise) -- [Does your enterprise rely on outside collaborators?](#does-your-enterprise-rely-on-outside-collaborators) -- [Can your enterprise tolerate migration costs?](#can-your-enterprise-tolerate-migration-costs) +- [ユーザーのユーザー アカウントを自分で管理したいか?](#do-you-want-to-control-the-user-accounts-for-your-users) +- [Enterprise でどの ID プロバイダーを使用するか?](#which-identity-provider-does-your-enterprise-use) +- [開発者はパブリック リポジトリ、gist、{% data variables.product.prodname_pages %} サイトのどれで作業するか?](#do-your-developers-work-in-public-repositories-gists-or-github-pages-sites) +- [開発者は Enterprise 外部のコラボレーションに依存しているか?](#do-your-developers-rely-on-collaboration-outside-of-your-enterprise) +- [Enterprise は外部のコラボレーターに依存しているか?](#does-your-enterprise-rely-on-outside-collaborators) +- [会社が移行コストを許容できるか?](#can-your-enterprise-tolerate-migration-costs) -### Do you want to control the user accounts for your users? +### ユーザーのユーザー アカウントを自分で管理したいか? -{% data variables.product.prodname_emus %} may be right for your enterprise if you don't want enterprise members to use their own personal accounts on {% data variables.product.prodname_dotcom_the_website %} to access your enterprise's resources. +{% data variables.product.prodname_emus %} は、Enterprise メンバーが {% data variables.product.prodname_dotcom_the_website %} で自分の個人アカウントを使って Enterprise のリソースにアクセスすることを望まない場合に、適している可能性があります。 -With SAML SSO, developers create and manage their own personal accounts, and each account is linked to a SAML identity in your IdP. {% data variables.product.prodname_emus %} functions more like other familiar SSO solutions, as you will provision the accounts for your users. You can also ensure user accounts conform with your company identity, by controlling usernames and the email addresses associated with the accounts. +SAML SSO を使用すると、開発者は自分の個人アカウントを作成して管理でき、各アカウントは IdP の SAML ID にリンクされます。 {% data variables.product.prodname_emus %} は、ご自身でユーザーのアカウントをプロビジョニングするため、他の使い慣れた SSO ソリューションと同様に機能します。 また、ユーザー名とアカウントに関連付けられるメール アドレスを管理することで、ユーザー アカウントが会社の ID に準拠していることを確実にすることもできます。 -If you currently require your users to create a new account on {% data variables.product.prodname_dotcom_the_website %} to use with your enterprise only, {% data variables.product.prodname_emus %} might be right for you. However, SAML SSO may be a better option if using your IdP as the source of truth for your user and access management would add too much complexity. For example, perhaps your enterprise does not have an established process for onboarding new users in your IdP. +現在、ユーザーに対して、{% data variables.product.prodname_dotcom_the_website %} で新しいアカウントを作成して Enterprise でのみ使用するように要求している場合は、{% data variables.product.prodname_emus %} が適している可能性があります。 ただし、IdP をユーザー向けの信頼できるソースとして使用し、アクセス管理が複雑すぎる場合は、SAML SSO の方が適切なオプションである可能性があります。 たとえば、IdP で新しいユーザーをオンボードするための確立されたプロセスが Enterprise にない場合があります。 -### Which identity provider does your enterprise use? +### Enterprise でどの ID プロバイダーを使用するか? -{% data variables.product.prodname_emus %} is supported for a limited number of IdPs, while SAML SSO offers full support for a larger number of IdPs, plus limited support for all IdPs that implement the SAML 2.0 standard. For the list of supported IdPs for each option, see "[About {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#identity-provider-support)" and "[About SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam#supported-idps)." +{% data variables.product.prodname_emus %} がサポートされている IdP の数は限られています。SAML SSO を使用すると、多数の IdP に対する完全なサポートと、SAML 2.0 標準を実装しているすべての IdP に対する制限付きサポートが提供されます。 各オプションでサポートされている IdP の一覧については、「[{% data variables.product.prodname_emus %} について](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#identity-provider-support)」および「[Enterprise IAM の SAML について](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam#supported-idps)」を参照してください。 -You can use {% data variables.product.prodname_emus %} with an unsupported IdP only if you federate the unsupported IdP to a supported IdP to use as an integration point. If you wish to avoid this extra complexity, SAML SSO may be a better solution for you. +サポートされていない IdP で {% data variables.product.prodname_emus %} を使用できるのは、サポートされていない IdP をサポートされている IdP にフェデレーションして統合ポイントとして使用する場合のみです。 このような余分な複雑さを避けたい場合は、SAML SSO の方が優れたソリューションになる可能性があります。 -### Do your developers work in public repositories, gists, or {% data variables.product.prodname_pages %} sites? +### 開発者はパブリック リポジトリ、gist、{% data variables.product.prodname_pages %} サイトのどれで作業するか? -To prevent enterprise members from accidentally leaking corporate-owned content to the public on {% data variables.product.prodname_dotcom_the_website %}, {% data variables.product.prodname_emus %} imposes strong restrictions on what users can do. For example, {% data variables.enterprise.prodname_managed_users %} cannot create public repositories, gists of any visibility, or {% data variables.product.prodname_pages %} sites that are visible outside the enterprise. For a full list of restrictions, see "[Abilities and restrictions of {% data variables.enterprise.prodname_managed_users %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#abilities-and-restrictions-of-managed-users)." +Enterprise メンバーが誤って {% data variables.product.prodname_dotcom_the_website %} で Enterprise 所有のコンテンツを一般に漏洩させることがないように、{% data variables.product.prodname_emus %} では、ユーザーが実行できる操作に対して強力な制限が課されます。 たとえば、{% data variables.enterprise.prodname_managed_users %} では、パブリック リポジトリ、任意の可視性を持つ gist、または Enterprise 外部で閲覧できる {% data variables.product.prodname_pages %} サイトを作成することはできません。 制限の完全な一覧については、「[{% data variables.enterprise.prodname_managed_users %} の機能と制限](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#abilities-and-restrictions-of-managed-users)」を参照してください。 -These restrictions are unacceptable for some enterprises. To determine whether {% data variables.product.prodname_emus %} will work for you, review the restrictions with your developers, and confirm whether any of the restrictions will hinder your existing workflows. If so, SAML SSO may be a better choice for your enterprise. +これらの制限が受け入れらない Enterprise もあります。 {% data variables.product.prodname_emus %} がご自身に適しているかどうかを判断するには、開発者と共に制限事項を確認し、いずれかの制限によって既存のワークフローが妨げられるかどうかを確認します。 該当する場合は、お使いの Enterprise には SAML SSO が適している可能性があります。 -### Do your developers rely on collaboration outside of your enterprise? +### 開発者は Enterprise 外部のコラボレーションに依存しているか? -{% data variables.enterprise.prodname_managed_users_caps %} can only contribute to repositories within your enterprise. If your developers must contribute to both repositories within and outside of your enterprise, including private repositories, {% data variables.product.prodname_emus %} may not be right for your enterprise. SAML SSO may be a better solution. +{% data variables.enterprise.prodname_managed_users_caps %} では、Enterprise 内部のリポジトリにのみ投稿できます。 開発者がプライベート リポジトリを含め、エンタープライズ内と外部の両方のリポジトリに投稿する必要がある場合、{% data variables.product.prodname_emus %}はエンタープライズに適していない可能性があります。 SAML SSO の方が優れたソリューションになる可能性があります。 -Some companies maintain repositories within an existing enterprise using SAML SSO on {% data variables.location.product_location %}, and also create an {% data variables.enterprise.prodname_emu_enterprise %}. Developers who contribute to repositories owned by both enterprises from a single workstation must switch between the accounts on {% data variables.location.product_location %} within a single browser, or use a different browser for each account. The developer may also need to customize the workstation's Git configuration to accommodate the two accounts. The complexity of this workflow can increase the risk of mistakenly leaking internal code to the public. +一部の会社では、{% data variables.location.product_location %} に SAML SSO を使用して既存の Enterprise 内のリポジトリを保持し、{% data variables.enterprise.prodname_emu_enterprise %}も作成します。 1 つのワークステーションから両方の Enterprise によって所有されるリポジトリに投稿する開発者は、1 つのブラウザー内で {% data variables.location.product_location %} のアカウントを切り替えるか、アカウントごとに異なるブラウザーを使用する必要があります。 開発者は、2 つのアカウントに対応するようにワークステーションの Git 構成をカスタマイズする必要がある場合もあります。 このワークフローの複雑さは、内部コードを誤って一般に漏洩させるリスクを高める可能性があります。 -If you decide to create an {% data variables.enterprise.prodname_emu_enterprise %} but require that developers contribute to resources outside of the enterprise from a single workstation, you can provide support for switching between the accounts in a developer's local Git configuration. For more information, see "[About {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users#supporting-developers-with-multiple-user-accounts-on-githubcom)." +{% data variables.enterprise.prodname_emu_enterprise %}を作成する場合に、開発者が 1 つのワークステーションから Enterprise 外のリソースに投稿する必要がある場合は、開発者のローカル Git 構成でアカウントを切り替えるためのサポートを提供できます。 詳細については、「[{% data variables.product.prodname_emus %} について](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users#supporting-developers-with-multiple-user-accounts-on-githubcom)」を参照してください。 -### Does your enterprise rely on outside collaborators? +### Enterprise は外部のコラボレーターに依存しているか? -With SAML SSO, you can give access to specific repositories to people who are not members of your IdP's directory, by using the outside collaborator role. This can be especially useful for collaborators that are external to your business, such as contractors. For more information, see "[Adding outside collaborators to repositories in your organization](/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization)." +SAML SSO を使用すると、外部コラボレーター ロールを使用して、IdP のディレクトリのメンバーではないユーザーに特定のリポジトリへのアクセスを許可できます。 これは、社外のコラボレーター (請負業者など) に対して特に役立ちます。 詳しい情報については、「[外部のコラボレーターを Organization のリポジトリに追加する](/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization)」を参照してください。 -With {% data variables.product.prodname_emus %}, the outside collaborator role does not exist. Your enterprise's resources can only be accessed by {% data variables.enterprise.prodname_managed_users %}, which are always provisioned by your IdP. To give external collaborators access to your enterprise, you would have to use guest accounts in your IdP. If you're interested in {% data variables.product.prodname_emus %}, confirm with your developers whether this will hinder any of their existing workflows. If so, SAML SSO may be a better solution. +{% data variables.product.prodname_emus %} の場合、外部コラボレーター ロールは存在しません。 Enterprise のリソースには、常に IdP によってプロビジョニングされる {% data variables.enterprise.prodname_managed_users %} のみがアクセスできます。 外部コラボレーターに Enterprise へのアクセスを許可するには、IdP でゲスト アカウントを使用する必要があります。 {% data variables.product.prodname_emus %} に関心がある場合は、開発者に、これによって既存のワークフローが妨げられるかどうかを確認してください。 該当する場合は、SAML SSO の方が優れたソリューションになる可能性があります。 -### Can your enterprise tolerate migration costs? +### 会社が移行コストを許容できるか? -If your enterprise is new to {% data variables.product.prodname_dotcom_the_website %}, SAML SSO and {% data variables.product.prodname_emus %} are equally easy to adopt. +会社で {% data variables.product.prodname_dotcom_the_website %} を初めて使用する場合、SAML SSO と {% data variables.product.prodname_emus %} は同じように簡単に導入できます。 -If you're already using {% data variables.product.prodname_dotcom_the_website %} with developers managing their own user accounts, adopting {% data variables.product.prodname_emus %} requires migrating to a new enterprise account. For more information, see "[About enterprises with {% data variables.enterprise.prodname_managed_users %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#about-enterprises-with-managed-users)." +既に {% data variables.product.prodname_dotcom_the_website %} を使用していて、開発者が各自のユーザー アカウントを管理している場合は、{% data variables.product.prodname_emus %} を導入するには、新しい Enterprise アカウントに移行する必要があります。 詳しい情報については、「[{% data variables.enterprise.prodname_managed_users %} を含む Enterprise について](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users#about-enterprises-with-managed-users)」を参照してください。 -Although {% data variables.product.prodname_emus %} is free, the migration process may require time or cost from your team. Confirm that this migration process is acceptable to your business and your developers. If not, SAML SSO may be the better choice for you. +{% data variables.product.prodname_emus %} は無料ですが、移行プロセスにはチームの時間またはコストが必要になる場合があります。 この移行プロセスが、ご自身のビジネスと開発者に許容されることを確認してください。 そうでない場合は、SAML SSO が適している可能性があります。 {% elsif ghes %} -Site administrators can decide how people authenticate to access a {% data variables.product.product_name %} instance. You can use {% data variables.product.product_name %}'s built-in authentication, or, if you want to centralize identity and access management for the web applications that your team uses, you can configure an external authentication method. +サイト管理者は、ユーザーが {% data variables.product.product_name %} インスタンスにアクセスするための認証方法を決定できます。 {% data variables.product.product_name %} のビルトイン認証を使用することができます。チームで使用される Web アプリケーションの ID とアクセス管理を一元化する場合は、外部認証方法を構成できます。 -## Authentication methods for {% data variables.product.product_name %} +## {% data variables.product.product_name %} の認証方法 -The following authentication methods are available for {% data variables.product.product_name %}. +{% data variables.product.product_name %} では、次の認証方法を使用できます。 -- [Built-in authentication](#built-in-authentication) -- [External authentication](#external-authentication) +- [ビルトイン認証](#built-in-authentication) +- [外部認証](#external-authentication) -### Built-in authentication +### ビルトイン認証 -{% data reusables.enterprise_user_management.built-in-authentication-new-accounts %} To access your instance, people authenticate with the credentials for the account. For more information, see "[Configuring built-in authentication](/admin/identity-and-access-management/using-built-in-authentication/configuring-built-in-authentication)." +{% data reusables.enterprise_user_management.built-in-authentication-new-accounts %} インスタンスにアクセスするために、ユーザーはアカウントの資格情報を使用して認証します。 詳しくは、「[ビルトイン認証の設定](/admin/identity-and-access-management/using-built-in-authentication/configuring-built-in-authentication)」を参照してください。 -### External authentication +### 外部認証 -If you use an external directory or identity provider (IdP) to centralize access to multiple web applications, you may be able to configure external authentication for {% data variables.location.product_location %}. For more information, see the following articles. +外部ディレクトリまたは ID プロバイダー (IdP) を使用して複数の Web アプリケーションへのアクセスを一元化する場合は、{% data variables.location.product_location %} の外部認証を構成できる可能性があります。 詳細については、次の記事を参照してください。 -- "[Using CAS for enterprise IAM](/admin/identity-and-access-management/using-cas-for-enterprise-iam)" -- "[Using LDAP for enterprise IAM](/admin/identity-and-access-management/using-ldap-for-enterprise-iam)" -- "[Using SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam)" +- [Enterprise IAM での CAS の使用](/admin/identity-and-access-management/using-cas-for-enterprise-iam) +- 「[Enterprise IAM での LDAP の使用](/admin/identity-and-access-management/using-ldap-for-enterprise-iam)」 +- [Enterprise IAM での SAML の使用](/admin/identity-and-access-management/using-saml-for-enterprise-iam) -If you choose to use external authentication, you can also configure fallback authentication for people who don't have an account on your external authentication provider. For example, you may want to grant access to a contractor or machine user. For more information, see "[Allowing built-in authentication for users outside your provider](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider)." +外部認証を使用することにした場合は、外部認証プロバイダーにアカウントを持っていないユーザーのフォールバック認証を構成することもできます。 たとえば、請負業者またはコンピューター ユーザーにアクセス権を付与できます。 詳しくは、「[プロバイダー外のユーザーのためのビルトイン認証の許可](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider)」を参照してください。 {% ifversion scim-for-ghes %} -If you use SAML SSO for authentication, you can also provision users and map IdP groups to teams using SCIM. For more information, see "[Configuring user provisioning with SCIM for your enterprise](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise)." +認証に SAML SSO を使用する場合は、SCIM を使用してユーザーをプロビジョニングし、IdP グループをチームにマップすることもできます。 詳しくは、「[Enterprise 用の SCIM を使用したユーザーのプロビジョニングを構成する](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise)」を参照してください。 {% endif %} {% elsif ghae %} -{% data variables.product.product_name %} uses SAML SSO for authentication. Enterprise owners must configure SAML SSO with a SAML identity provider (IdP) during initialization. For more information, see "[About SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam)." +{% data variables.product.product_name %}では認証に SAML SSO が使用されます。 Enterprise 所有者は、初期化中に SAML ID プロバイダー (IdP) で SAML SSO を構成する必要があります。 詳しくは、「[Enterprise IAM の SAML について](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam)」を参照してください。 {% endif %} -## Further reading +## 参考資料 -- "[Types of {% data variables.product.company_short %} accounts](/get-started/learning-about-github/types-of-github-accounts)" -- "[About enterprise accounts](/admin/overview/about-enterprise-accounts)" -{%- ifversion ghec %} -- "[Can I create accounts for people in my organization?](/organizations/managing-membership-in-your-organization/can-i-create-accounts-for-people-in-my-organization)" +- [{% data variables.product.company_short %} アカウントの種類](/get-started/learning-about-github/types-of-github-accounts) +- [Enterprise アカウントについて](/admin/overview/about-enterprise-accounts){%- ifversion ghec %} +- [私の Organization に所属する人のためにアカウントを作成できますか?](/organizations/managing-membership-in-your-organization/can-i-create-accounts-for-people-in-my-organization) {% endif %} diff --git a/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md b/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md index 8987f3178f..59f87dab08 100644 --- a/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md +++ b/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md @@ -1,7 +1,7 @@ --- -title: '{% data variables.product.prodname_emus %} について' +title: About {% data variables.product.prodname_emus %} shortTitle: About managed users -intro: 'ID プロバイダーから {% data variables.product.prodname_dotcom %} 上のエンタープライズ メンバーの ID とアクセスを一元管理することができます。' +intro: 'You can centrally manage identity and access for your enterprise members on {% data variables.product.prodname_dotcom %} from your identity provider.' redirect_from: - /early-access/github/articles/get-started-with-managed-users-for-your-enterprise - /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users @@ -17,55 +17,50 @@ topics: - Enterprise - SSO allowTitleToDifferFromFilename: true -ms.openlocfilehash: 82a8b8c29ea38d57f0481146f2a857c2dcba8413 -ms.sourcegitcommit: d82f268a6f0236d1f4d2bf3d049974ada0170402 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 11/10/2022 -ms.locfileid: '148160729' --- -## {% data variables.product.prodname_emus %} について -{% data variables.product.prodname_emus %} を使用すると、ID プロバイダー (IdP) を使用して Enterprise メンバーのユーザー アカウントを制御できます。 IdP で {% data variables.product.prodname_emu_idp_application %} アプリケーションに割り当てられたユーザーは、{% data variables.product.prodname_dotcom %} の新しいユーザー アカウントとしてプロビジョニングされ、Enterprise に追加されます。 IdP からユーザー アカウントのユーザー名、プロファイル データ、チーム メンバーシップ、リポジトリへのアクセスを制御します。 +## About {% data variables.product.prodname_emus %} -IdP では、各{% data variables.enterprise.prodname_managed_user %}に、ユーザー、Enterprise 所有者、または課金マネージャーのロールを付与できます。 {% data variables.enterprise.prodname_managed_users_caps %}は、Enterprise 内の Organization を所有でき、他の{% data variables.enterprise.prodname_managed_users %}を Organization とその中の Team に追加できます。 詳細については、「[Enterprise におけるロール](/github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise/roles-in-an-enterprise)」および「[Organization について](/organizations/collaborating-with-groups-in-organizations/about-organizations)」を参照してください。 +With {% data variables.product.prodname_emus %}, you can control the user accounts of your enterprise members through your identity provider (IdP). Users assigned to the {% data variables.product.prodname_emu_idp_application %} application in your IdP are provisioned as new user accounts on {% data variables.product.prodname_dotcom %} and added to your enterprise. You control usernames, profile data, team membership, and repository access for the user accounts from your IdP. + +In your IdP, you can give each {% data variables.enterprise.prodname_managed_user %} the role of user, enterprise owner, or billing manager. {% data variables.enterprise.prodname_managed_users_caps %} can own organizations within your enterprise and can add other {% data variables.enterprise.prodname_managed_users %} to the organizations and teams within. For more information, see "[Roles in an enterprise](/github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise/roles-in-an-enterprise)" and "[About organizations](/organizations/collaborating-with-groups-in-organizations/about-organizations)." {% ifversion oidc-for-emu %} -{% data reusables.enterprise-accounts.emu-cap-validates %}詳細については、「[IdP の条件付きアクセス ポリシー](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy)」を参照してください。 +{% data reusables.enterprise-accounts.emu-cap-validates %} For more information, see "[About support for your IdP's Conditional Access Policy](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy)." {% endif %} -{% data variables.enterprise.prodname_managed_users %}に、Enterprise 内のリポジトリへのアクセス権と、そこに投稿する機能を付与できますが、{% data variables.enterprise.prodname_managed_users %}では、パブリック コンテンツを作成したり、残りの {% data variables.product.prodname_dotcom %} で他のユーザー、Organization、Enterprise と共同作業を行ったりすることはできません。 詳しい情報については、「[{% data variables.enterprise.prodname_managed_users %}の機能と制限](#abilities-and-restrictions-of-enterprise-managed-users)」を参照してください。 +You can grant {% data variables.enterprise.prodname_managed_users %} access to and the ability to contribute to repositories within your enterprise, but {% data variables.enterprise.prodname_managed_users %} cannot create public content or collaborate with other users, organizations, and enterprises on the rest of {% data variables.product.prodname_dotcom %}. For more information, see "[Abilities and restrictions of {% data variables.enterprise.prodname_managed_users %}](#abilities-and-restrictions-of-enterprise-managed-users)." -Enterprise の{% data variables.enterprise.prodname_managed_users %}のユーザー名とそのプロファイル情報 (表示名やメール アドレスなど) は、IdP によって設定され、ユーザー自身が変更することはできません。 詳細については、「[ユーザー名とプロファイル情報](#usernames-and-profile-information)」を参照してください。 +The usernames of your enterprise's {% data variables.enterprise.prodname_managed_users %} and their profile information, such as display names and email addresses, are set by through your IdP and cannot be changed by the users themselves. For more information, see "[Usernames and profile information](#usernames-and-profile-information)." -Enterprise 所有者は、{% data variables.product.prodname_dotcom %} に対する{% data variables.enterprise.prodname_managed_users %}のすべてのアクションを監査できます。 詳細については、「[エンタープライズの監査ログ イベント](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise#about-audit-log-events-for-your-enterprise)」を参照してください。 +Enterprise owners can audit all of the {% data variables.enterprise.prodname_managed_users %}' actions on {% data variables.product.prodname_dotcom %}. For more information, see "[Audit log events for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise#about-audit-log-events-for-your-enterprise)." -{% data variables.product.prodname_emus %} を使用するには、{% data variables.product.prodname_emus %} を有効にした別の種類の Enterprise アカウントが必要です。 このアカウントの作成の詳細については、「[Managed User を含む Enterprise について](#about-enterprises-with-managed-users)」を参照してください。 +To use {% data variables.product.prodname_emus %}, you need a separate type of enterprise account with {% data variables.product.prodname_emus %} enabled. For more information about creating this account, see "[About enterprises with managed users](#about-enterprises-with-managed-users)." {% note %} -**注:** {% data variables.product.prodname_ghe_cloud %} を使った ID とアクセスの管理には複数のオプションがあるので、{% data variables.product.prodname_emus %} はすべてのお客様にとって最適なソリューションではありません。 {% data variables.product.prodname_emus %} がお客様の企業に適しているかどうかについては、「[企業の認証について](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#identifying-the-best-authentication-method-for-your-enterprise)」を参照してください。 +**Note:** There are multiple options for identity and access management with {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_emus %} is not the best solution for every customer. For more information about whether {% data variables.product.prodname_emus %} is right for your enterprise, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#identifying-the-best-authentication-method-for-your-enterprise)." {% endnote %} -## Organization メンバーシップの管理について +## About organization membership management -Organization メンバーシップは、手動で管理することも、IdP グループを使用して自動的に更新することもできます。 IdP を使用して Organization メンバーシップを管理するには、メンバーを IdP グループに追加し、IdP グループを Organization 内の Team に接続する必要があります。 Organization および Team のメンバーシップの管理に関する詳しい情報については、「[ID プロバイダー グループによる Team メンバーシップの管理](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/managing-team-memberships-with-identity-provider-groups)」を参照してください。 +Organization memberships can be managed manually, or you can update memberships automatically using IdP groups. To manage organization memberships through your IdP, the members must be added to an IdP group, and the IdP group must be connected to a team within the organization. For more information about managing organization and team memberships automatically, see "[Managing team memberships with identity provider groups](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/managing-team-memberships-with-identity-provider-groups)." -Enterprise によって所有されている Organization にメンバーを追加する方法によって、Organization からメンバーを削除する方法が決定されます。 +The way a member is added to an organization owned by your enterprise (through IdP groups or manually) determines how they must be removed from an organization. -- メンバーを手動で Organization に追加した場合、手動で削除する必要があります。 IdP 上の {% data variables.product.prodname_emu_idp_application %} アプリケーションからユーザーの割り当て解除を行うと、ユーザーは停止されますが、Organization から削除されません。 -- Organization 内の 1 つ以上の Team にマップされた IdP グループに追加されたために、ユーザーが Organization のメンバーになった場合、Organization に関連付けられている "すべて" のマップされた IdP グループからユーザーを削除すると、ユーザーは Organization から削除されます。 +- If a member was added to an organization manually, you must remove them manually. Unassigning them from the {% data variables.product.prodname_emu_idp_application %} application on your IdP will suspend the user but not remove them from the organization. +- If a user became a member of an organization because they were added to IdP groups mapped to one or more teams in the organization, removing them from _all_ of the mapped IdP groups associated with the organization will remove them from the organization. -メンバーが Organization に追加された方法を確認するには、メンバー リストを種類でフィルター処理できます。 詳細については、「[Viewing people in your enterprise](/admin/user-management/managing-users-in-your-enterprise/viewing-people-in-your-enterprise#filtering-by-member-type-in-an-enterprise-with-managed-users)」 (Enterprise のメンバーを表示する) を参照してください。 +To discover how a member was added to an organization, you can filter the member list by type. For more information, see "[Viewing people in your enterprise](/admin/user-management/managing-users-in-your-enterprise/viewing-people-in-your-enterprise#filtering-by-member-type-in-an-enterprise-with-managed-users)." -## ID プロバイダーのサポート +## Identity provider support -{% data variables.product.prodname_emus %} は、以下の IdP{% ifversion oidc-for-emu %} と認証方法をサポートしています。 +{% data variables.product.prodname_emus %} supports the following IdPs{% ifversion oidc-for-emu %} and authentication methods: -| | SAML | OIDC (ベータ) | +| | SAML | OIDC | |----------------------------------|-----------------------------------------------|-----------------------------------------------| | Azure Active Directory | {% octicon "check" aria-label="Check icon" %} | {% octicon "check" aria-label="Check icon" %} | | Okta | {% octicon "check" aria-label="Check icon" %} | | @@ -75,36 +70,36 @@ Enterprise によって所有されている Organization にメンバーを追 {% endif %} -## {% data variables.enterprise.prodname_managed_users %}の機能と制限 +## Abilities and restrictions of {% data variables.enterprise.prodname_managed_users %} -{% data variables.enterprise.prodname_managed_users_caps %}で投稿できるのは、その Enterprise 内のプライベートおよび内部リポジトリと、そのユーザー アカウントによって所有されているプライベート リポジトリのみです。 {% data variables.enterprise.prodname_managed_users_caps %}には、より広範な {% data variables.product.prodname_dotcom %} コミュニティへの読み取り専用アクセス権が必要です。 ユーザーとコンテンツに対するこれらの可視性とアクセスの制限は、API 要求を含むすべての要求に適用されます。 +{% data variables.enterprise.prodname_managed_users_caps %} can only contribute to private and internal repositories within their enterprise and private repositories owned by their user account. {% data variables.enterprise.prodname_managed_users_caps %} have read-only access to the wider {% data variables.product.prodname_dotcom %} community. These visibility and access restrictions for users and content apply to all requests, including API requests. -* {% data variables.enterprise.prodname_managed_users_caps %}を Enterprise 外部の Organization またはリポジトリに招待することも、{% data variables.enterprise.prodname_managed_users %}を他の Enterprise に招待することもできません。 -* 外部のコラボレーターは、{% data variables.product.prodname_emus %} ではサポートされていません。 -* {% data variables.enterprise.prodname_managed_users_caps %}では、Enterprise 外部のリポジトリでの Issue または pull request の作成、Enterprise 外部のリポジトリへのリアクションの追加、Enterprise 外部のリポジトリに対する Star、Watch または Fork 操作を行うことはできません。 -* {% data variables.enterprise.prodname_managed_users_caps %}で {% data variables.product.prodname_dotcom_the_website %} のすべてのパブリック リポジトリを表示することはできますが、Enterprise 外部のリポジトリにコードをプッシュすることはできません。 -* {% data variables.enterprise.prodname_managed_users_caps %}と作成されたコンテンツは、その Enterprise の他のメンバーにのみ表示されます。 -* {% data variables.enterprise.prodname_managed_users_caps %}では、Enterprise 外部のユーザーをフォローできません。 -* {% data variables.enterprise.prodname_managed_users_caps %}では、gists を作成したり、gists に対してコメントしたりすることはできません。 -* {% data variables.enterprise.prodname_managed_users_caps %}では、{% data variables.product.prodname_actions %} のスターター ワークフローを作成できません。 -* {% data variables.enterprise.prodname_managed_users_caps %}では、そのユーザー アカウントに {% data variables.product.prodname_github_apps %} をインストールできません。 -* 他の {% data variables.product.prodname_dotcom %} ユーザーは、{% data variables.enterprise.prodname_managed_user %}を表示またはメンションしたり、共同作業に招待したりすることはできません。 -* ユーザー アカウントによって所有されるリポジトリを{% data variables.enterprise.prodname_managed_users %}で作成できるかどうかを選ぶことができます。 詳細については、「[Enterprise でリポジトリ管理ポリシーを適用する](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-repository-creation)」を参照してください。 -* ユーザー アカウントによって所有されるリポジトリの作成を{% data variables.enterprise.prodname_managed_users %}に許可した場合、所有できるのはプライベート リポジトリのみであり、他のエンタープライズ メンバーを招待して共同作業を行うことができるのは、ユーザー所有のリポジトリのみです。 +* {% data variables.enterprise.prodname_managed_users_caps %} cannot be invited to organizations or repositories outside of the enterprise, nor can the {% data variables.enterprise.prodname_managed_users %} be invited to other enterprises. +* Outside collaborators are not supported by {% data variables.product.prodname_emus %}. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot create issues or pull requests in, comment or add reactions to, nor star, watch, or fork repositories outside of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} can view all public repositories on {% data variables.product.prodname_dotcom_the_website %}, but cannot push code to repositories outside of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} and the content they create is only visible to other members of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot follow users outside of the enterprise. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot create gists or comment on gists. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot create starter workflows for {% data variables.product.prodname_actions %}. +* {% data variables.enterprise.prodname_managed_users_caps %} cannot install {% data variables.product.prodname_github_apps %} on their user accounts. +* Other {% data variables.product.prodname_dotcom %} users cannot see, mention, or invite a {% data variables.enterprise.prodname_managed_user %} to collaborate. +* You can choose whether {% data variables.enterprise.prodname_managed_users %} are able to create repositories owned by their user accounts. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-repository-creation)." +* If you allow {% data variables.enterprise.prodname_managed_users %} to create repositories owned by their user accounts, they can only own private repositories and can only invite other enterprise members to collaborate on their user-owned repositories. * {% data reusables.enterprise-accounts.emu-forks %} -* {% data variables.enterprise.prodname_emu_enterprise %} が所有する Organization では、Organization および Enterprise リポジトリの可視性の設定に応じて、プライベートおよび内部リポジトリのみを作成できます。 -* {% data variables.enterprise.prodname_managed_users_caps %}は、{% data variables.product.prodname_pages %} の使用が制限されます。 詳細については、「[{% data variables.product.prodname_pages %} について](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users)」を参照してください。 +* Only private and internal repositories can be created in organizations owned by an {% data variables.enterprise.prodname_emu_enterprise %}, depending on organization and enterprise repository visibility settings. +* {% data variables.enterprise.prodname_managed_users_caps %} are limited in their use of {% data variables.product.prodname_pages %}. For more information, see "[About {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users)." * {% data reusables.copilot.emus-cannot-use-copilot %} -## {% data variables.product.prodname_emus %} の概要 +## Getting started with {% data variables.product.prodname_emus %} -お客様の開発者が {% data variables.product.prodname_ghe_cloud %} と {% data variables.product.prodname_emus %} を使用できるようにするには、お客様が一連の構成手順を実行する必要があります。 +Before your developers can use {% data variables.product.prodname_ghe_cloud %} with {% data variables.product.prodname_emus %}, you must follow a series of configuration steps. -1. {% data variables.product.prodname_emus %} を使用するには、{% data variables.product.prodname_emus %} を有効にした別の種類の Enterprise アカウントが必要です。 {% data variables.product.prodname_emus %} を試用するか、既存の Enterprise から移行するためのオプションについて検討するには、[{% data variables.product.prodname_dotcom %} の営業チーム](https://enterprise.github.com/contact)にお問い合わせください。 +1. To use {% data variables.product.prodname_emus %}, you need a separate type of enterprise account with {% data variables.product.prodname_emus %} enabled. To try out {% data variables.product.prodname_emus %} or to discuss options for migrating from your existing enterprise, please contact [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact). - GitHub セールス チームの担当者が、新しい {% data variables.enterprise.prodname_emu_enterprise %} を作成するために協力します。 Enterprise を設定するユーザーのメール アドレスと、Enterprise メンバーのユーザー名のサフィックスとして使用されるショートコードを指定する必要があります。 {% data reusables.enterprise-accounts.emu-shortcode %} 詳細については、「[ユーザー名とプロファイル情報](#usernames-and-profile-information)」を参照してください。 + Your contact on the GitHub Sales team will work with you to create your new {% data variables.enterprise.prodname_emu_enterprise %}. You'll need to provide the email address for the user who will set up your enterprise and a short code that will be used as the suffix for your enterprise members' usernames. {% data reusables.enterprise-accounts.emu-shortcode %} For more information, see "[Usernames and profile information](#usernames-and-profile-information)." -2. Enterprise を作成すると、{% data variables.product.prodname_dotcom %} からメールが届き、Enterprise のセットアップ ユーザーのパスワードを選択するよう求められます。このユーザーは、Enterprise の最初の所有者になります。 パスワードを設定する際は、Incognito ウィンドウまたはプライベート ブラウズ ウィンドウを使用します。 セットアップ ユーザーは、エンタープライズのシングル サインオンと SCIM プロビジョニング統合を構成するためにのみ使用されます。 SSO が正常に有効になると、エンタープライズ アカウントを管理するためのアクセス権はなくなります。 セットアップ ユーザーのユーザー名は、Enterprise のショートコードにサフィックス `_admin` が付きます。 +2. After we create your enterprise, you will receive an email from {% data variables.product.prodname_dotcom %} inviting you to choose a password for your enterprise's setup user, which will be the first owner in the enterprise. Use an incognito or private browsing window when setting the password. The setup user is only used to configure single sign-on and SCIM provisioning integration for the enterprise. It will no longer have access to administer the enterprise account once SSO is successfully enabled. The setup user's username is your enterprise's shortcode suffixed with `_admin`. {% note %} @@ -112,53 +107,54 @@ Enterprise によって所有されている Organization にメンバーを追 {% endnote %} -3. セットアップ ユーザーとしたログインしたら、2 要素認証を有効にすることをお勧めします。 詳細については、「[2 要素認証の構成](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication)」を参照してください。 +3. After you log in as the setup user, we recommend enabling two-factor authentication. For more information, see "[Configuring two-factor authentication](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication)." -1. まず、{% ifversion oidc-for-emu %}メンバーが認証する方法を構成します。 Azure Active Directory を ID プロバイダーとして使っている場合、OpenID Connect (OIDC) と Security Assertion Markup Language (SAML) のいずれかを選択できます。 どちらのオプションでもメンバーにシームレスなサインイン エクスペリエンスを提供できますが、条件付きアクセス ポリシー (CAP) のサポートが含まれているの OIDC のみです。 ID プロバイダーとして Okta を使っている場合、SAML を使ってメンバーを認証することができます。{% else %}エンタープライズ用に SAML SSO を構成します。 詳細については、「[エンタープライズ マネージド ユーザーの SAML シングル サインオンの構成](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)」を参照してください。{% endif %} +1. To get started, configure {% ifversion oidc-for-emu %}how your members will authenticate. If you are using Azure Active Directory as your identity provider, you can choose between OpenID Connect (OIDC) and Security Assertion Markup Language (SAML). We recommend OIDC, which includes support for Conditional Access Policies (CAP). If you require multiple enterprises with {% data variables.enterprise.prodname_managed_users %} provisioned from one tenant, you must use SAML for each enterprise after the first. If you are using Okta as your identity provider, you can use SAML to authenticate your members.{% else %}SAML SSO for your enterprise. For more information, see "[Configuring SAML single sign-on for Enterprise Managed Users](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)."{% endif %} {% ifversion oidc-for-emu %} - まず、選択した認証方法のガイドを参照してください。 + To get started, read the guide for your chosen authentication method. - - 「[エンタープライズ マネージド ユーザーの OIDC の構成](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)」 - - 「[エンタープライズ マネージド ユーザーの SAML シングル サインオンの構成](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)」 + - "[Configuring OIDC for Enterprise Managed Users](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)." + - "[Configuring SAML single sign-on for Enterprise Managed Users](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)." {% endif %} -4. SSO を構成したら、SCIM のプロビジョニングを構成できます。 SCIM は、ID プロバイダーを使って {% data variables.product.prodname_dotcom_the_website %} に{% data variables.enterprise.prodname_managed_users %}を作成する方法です。 SCIM のプロビジョニングを構成する場合の詳細については、「[エンタープライズ マネージド ユーザーの SCIM プロビジョニングの構成](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users)」を参照してください。 +4. Once you have configured SSO, you can configure SCIM provisioning. SCIM is how your identity provider will create {% data variables.enterprise.prodname_managed_users %} on {% data variables.product.prodname_dotcom_the_website %}. For more information on configuring SCIM provisioning, see "[Configuring SCIM provisioning for enterprise managed users](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users)." -5. 認証とプロビジョニングが構成されたら、IdP グループを Team と同期することで、{% data variables.enterprise.prodname_managed_users %}の Organization メンバーシップの管理を開始できます。 詳細については、「[Managing team memberships with identity provider groups](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups)」 (ID プロバイダー グループを使用して Team のメンバーシップを管理する) を参照してください。 +5. Once authentication and provisioning are configured, you can start managing organization membership for your {% data variables.enterprise.prodname_managed_users %} by synchronizing IdP groups with teams. For more information, see "[Managing team memberships with identity provider groups](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups)." -Enterprise のメンバーが 1 つのワークステーションを使って、{% data variables.enterprise.prodname_managed_user %}と個人アカウントの両方から、{% data variables.location.product_location %} のリポジトリに投稿する必要がある場合は、サポートを提供できます。 詳しくは、「[{% data variables.product.prodname_dotcom_the_website %} で複数のユーザー アカウントを持つ開発者をサポートする](#supporting-developers-with-multiple-user-accounts-on-githubcom)」をご覧ください。 +If members of your enterprise must use one workstation to contribute to repositories on {% data variables.location.product_location %} from both a {% data variables.enterprise.prodname_managed_user %} and a personal account, you can provide support. For more information, see "[Supporting developers with multiple user accounts on {% data variables.product.prodname_dotcom_the_website %}](#supporting-developers-with-multiple-user-accounts-on-githubcom)." -## {% data variables.enterprise.prodname_managed_user %}として認証を行う +## Authenticating as a {% data variables.enterprise.prodname_managed_user %} -{% data variables.enterprise.prodname_managed_users_caps %}は、ID プロバイダーを介して認証を行う必要があります。 {% data variables.enterprise.prodname_managed_user %}は、認証を行うために、IdP アプリケーション ポータルにアクセスするか、{% data variables.product.prodname_dotcom_the_website %} のログイン ページを使用できます。 +{% data variables.enterprise.prodname_managed_users_caps %} must authenticate through their identity provider. To authenticate, a {% data variables.enterprise.prodname_managed_user %} can visit their IdP application portal or use the login page on {% data variables.product.prodname_dotcom_the_website %}. -既定では、認証されていないユーザーが {% data variables.product.prodname_emus %} を使用する Enterprise にアクセスしようとすると、{% data variables.product.company_short %} によって 404 エラーが表示されます。 Enterprise 所有者は、必要に応じて、404 の代わりにシングル サインオン (SSO) への自動リダイレクトを有効にすることができます。 詳細については、「[エンタープライズでのセキュリティ設定のポリシーの適用](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-sso-for-unauthenticated-users)」を参照してください。 +By default, when an unauthenticated user attempts to access an enterprise that uses {% data variables.product.prodname_emus %}, {% data variables.product.company_short %} displays a 404 error. An enterprise owner can optionally enable automatic redirects to single sign-on (SSO) instead of the 404. For more information, see "[Enforcing policies for security settings in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-sso-for-unauthenticated-users)." -{% data reusables.enterprise-accounts.about-recovery-codes %} 詳細については、「[Managing recovery codes for your enterprise](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)」 (Enterprise の復旧コードの管理) を参照してください。 +{% data reusables.enterprise-accounts.about-recovery-codes %} For more information, see "[Managing recovery codes for your enterprise](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)." -### {% data variables.product.prodname_dotcom_the_website %} を介して{% data variables.enterprise.prodname_managed_user %}として認証を行う +### Authenticating as a {% data variables.enterprise.prodname_managed_user %} via {% data variables.product.prodname_dotcom_the_website %} -1. [https://github.com/login](https://github.com/login) に移動します。 -1. [Username or email address] テキスト ボックスに、アンダースコアとショートコードを含むユーザー名を入力します。 - ![ログイン フォームを示すスクリーンショット](/assets/images/help/enterprises/emu-login-username.png) このフォームでユーザー名が認識されると、フォームは更新されます。 このフォームでパスワードを入力する必要はありません。 -1. ID プロバイダーに進むには、 **[Sign in with your identity provider]** をクリックします。 - ![[Sign in with your identity provider] ボタンを示すスクリーンショット](/assets/images/help/enterprises/emu-login-submit.png) +1. Navigate to [https://github.com/login](https://github.com/login). +1. In the "Username or email address" text box, enter your username including the underscore and short code. + ![Screenshot showing login form](/assets/images/help/enterprises/emu-login-username.png) + When the form recognizes your username, the form will update. You do not need to enter your password on this form. +1. To continue to your identity provider, click **Sign in with your identity provider**. + ![Screenshot showing "Sign in with your identity provider" button](/assets/images/help/enterprises/emu-login-submit.png) -## ユーザー名とプロファイル情報 +## Usernames and profile information -{% data variables.product.product_name %} は、IdP から提供された識別子を正規化することにより、各自のユーザー名を自動的に作成します。 詳細については、「[外部認証におけるユーザー名の考慮事項](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)」を参照してください。 +{% data variables.product.product_name %} automatically creates a username for each person by normalizing an identifier provided by your IdP. For more information, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)." -IdP から提供された識別子の一意の部分が正規化中に削除されると、ユーザーをプロビジョニングするときに競合が発生する場合があります。 ユーザー名の競合が原因でユーザーをプロビジョニングできない場合は、IdP によって提供されるユーザー名を変更する必要があります。 詳しい情報については、「[ユーザー名の問題の解決](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication#resolving-username-problems)」を参照してください。 +A conflict may occur when provisioning users if the unique parts of the identifier provided by your IdP are removed during normalization. If you're unable to provision a user due to a username conflict, you should modify the username provided by your IdP. For more information, see "[Resolving username problems](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication#resolving-username-problems)." {% data reusables.enterprise-accounts.emu-only-emails-within-the-enterprise-can-conflict %} -{% data variables.enterprise.prodname_managed_user %}のプロファイル名とメール アドレスも IdP によって提供されます。 {% data variables.enterprise.prodname_managed_users_caps %}では、{% data variables.product.prodname_dotcom %} 上のプロファイル名またはメール アドレスを変更できません。IdP が提供できるメール アドレスは 1 つのみです。 +The profile name and email address of a {% data variables.enterprise.prodname_managed_user %} is also provided by the IdP. {% data variables.enterprise.prodname_managed_users_caps %} cannot change their profile name or email address on {% data variables.product.prodname_dotcom %}, and the IdP can only provide a single email address. -## {% data variables.location.product_location %} で複数のユーザー アカウントを持つ開発者をサポートする +## Supporting developers with multiple user accounts on {% data variables.location.product_location %} -Team のユーザーは、{% data variables.enterprise.prodname_emu_enterprise %} の外部にある {% data variables.location.product_location %} のリソースに投稿することが必要になる場合があります。 たとえば、会社のオープンソース プロジェクト用に別のエンタープライズを保持したい場合があります。 {% data variables.enterprise.prodname_managed_user %}ではパブリック リソースに投稿できないため、ユーザーはこの作業のために個別の個人アカウントを維持する必要があります。 +People on your team may need to contribute to resources on {% data variables.location.product_location %} that are outside of your {% data variables.enterprise.prodname_emu_enterprise %}. For example, you may wish to maintain a separate enterprise for your company's open source projects. Because a {% data variables.enterprise.prodname_managed_user %} cannot contribute to public resources, users will need to maintain a separate, personal account for this work. -1 つのワークステーションを使用して {% data variables.location.product_location %} で 2 つのユーザー アカウントから投稿する必要があるユーザーは、Git を設定してプロセスを簡略化できます。 詳しくは、「[複数のアカウントの管理](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts)」をご覧ください。 +People who must contribute from two user accounts on {% data variables.location.product_location %} using one workstation can configure Git to simplify the process. For more information, see "[Managing multiple accounts](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts)." diff --git a/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy.md b/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy.md index 74dd43ee44..33c6b16923 100644 --- a/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy.md +++ b/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy.md @@ -1,7 +1,7 @@ --- title: About support for your IdP's Conditional Access Policy shortTitle: Conditional access policy -intro: 'When your enterprise uses OIDC SSO, {% data variables.product.prodname_dotcom %} will validate access to your enterprise and its resources using your IdP''s Conditional Access Policy (CAP).' +intro: 'When your enterprise uses OIDC SSO, {% data variables.product.prodname_dotcom %} can validate access to your enterprise and its resources using your IdP''s Conditional Access Policy (CAP).' product: '{% data reusables.gated-features.emus %}' versions: feature: oidc-for-emu @@ -12,22 +12,17 @@ topics: - SSO --- -{% data reusables.enterprise-accounts.oidc-beta-notice %} +{% data reusables.enterprise-accounts.azure-emu-support-oidc %} ## About support for Conditional Access Policies {% data reusables.enterprise-accounts.emu-cap-validates %} -CAP support is enabled automatically for any {% data variables.enterprise.prodname_emu_enterprise %} that enables OIDC SSO and cannot be disabled. {% data variables.product.prodname_dotcom %} enforces your IdP's IP conditions but not device compliance conditions. +{% data variables.product.product_name %} supports CAP for any {% data variables.enterprise.prodname_emu_enterprise %} where OIDC SSO is enabled. {% data variables.product.product_name %} enforces your IdP's IP conditions but cannot enforce your device compliance conditions. Enterprise owners can choose to use this IP allow list configuration instead of {% data variables.product.product_name %}'s IP allow list, and can do so once OIDC SSO is configured. For more information about IP allow lists, see "[Restricting network traffic with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)" and "[Managing allowed IP addresses for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)." + For more information about using OIDC with {% data variables.product.prodname_emus %}, see "[Configuring OIDC for Enterprise Managed Users](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)" and "[Migrating from SAML to OIDC](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc)." -{% note %} - -**Note:** If you use Conditional Access (CA) network location policies in your Azure AD tenant, do not use the IP allow list feature on {% data variables.product.prodname_dotcom_the_website %}, with your enterprise account or with any of the organizations owned by the enterprise. Using both is unsupported and can result in the wrong policy applying. For more information about IP allow lists, see "[Enforcing security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-allowed-ip-addresses-for-organizations-in-your-enterprise)" and "[Managing allowed IP addresses for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)." - -{% endnote %} - ## Considerations for integrations and automations {% data variables.product.prodname_dotcom %} sends the originating IP address to your IdP for validation against your CAP. To make sure actions and apps are not blocked by your IdP's CAP, you will need to make changes to your configuration. @@ -46,4 +41,4 @@ When {% data variables.product.prodname_github_apps %} and {% data variables.pro You can contact the owners of the apps you want to use, ask for their IP ranges, and configure your IdP's CAP to allow access from those IP ranges. If you're unable to contact the owners, you can review your IdP sign-in logs to review the IP addresses seen in the requests, then allow-list those addresses. -You can also enable IP allow list configuration for installed {% data variables.product.prodname_github_apps %}. When enabled, all {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_apps %} will continue working regardless of the originating IP address. For more information, see "[Enforcing policies for security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#allowing-access-by-github-apps)." +If you do not wish to allow all of the IP ranges for all of your enterprise's apps, you can also exempt installed {% data variables.product.prodname_github_apps %} and authorized {% data variables.product.prodname_oauth_apps %} from the IdP allow list. If you do so, these apps will continue working regardless of the originating IP address. For more information, see "[Enforcing policies for security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#allowing-access-by-github-apps)." diff --git a/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md b/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md index 66e9c9d84f..6812965089 100644 --- a/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md +++ b/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md @@ -12,7 +12,7 @@ topics: - SSO --- -{% data reusables.enterprise-accounts.oidc-beta-notice %} +{% data reusables.enterprise-accounts.azure-emu-support-oidc %} ## About OIDC for Enterprise Managed Users @@ -22,13 +22,13 @@ With {% data variables.product.prodname_emus %}, your enterprise uses your ident You can adjust the lifetime of a session, and how often a {% data variables.enterprise.prodname_managed_user %} needs to reauthenticate with your IdP, by changing the lifetime policy property of the ID tokens issued for {% data variables.product.prodname_dotcom %} from your IdP. The default lifetime is one hour. For more information, see "[Configurable token lifetimes in the Microsoft identity platform](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-configurable-token-lifetimes)" in the Azure AD documentation. -If you currently use SAML SSO for authentication and would prefer to use OIDC and benefit from CAP support, you can follow a migration path. For more information, see "[Migrating from SAML to OIDC](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc)." +{% data reusables.enterprise_user_management.SAML-to-OIDC-migration-for-EMU %} {% data reusables.enterprise-accounts.oidc-gei-warning %} ## Identity provider support -Support for OIDC is in public beta and available for customers using Azure Active Directory (Azure AD). +Support for OIDC is available for customers using Azure Active Directory (Azure AD). Each Azure AD tenant can support only one OIDC integration with {% data variables.product.prodname_emus %}. If you want to connect Azure AD to more than one enterprise on {% data variables.product.prodname_dotcom %}, use SAML instead. For more information, see "[Configuring SAML single sign-on for {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users)." diff --git a/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md b/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md index fe4dde3d44..d5b35b288a 100644 --- a/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md +++ b/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md @@ -19,7 +19,7 @@ topics: ## About SAML single sign-on for {% data variables.product.prodname_emus %} -With {% data variables.product.prodname_emus %}, your enterprise uses SAML SSO to authenticate all members. Instead of signing in to {% data variables.product.prodname_dotcom %} with a {% data variables.product.prodname_dotcom %} username and password, members of your enterprise will sign in through your IdP. +With {% data variables.product.prodname_emus %}, your enterprise uses your corporate identity provider to authenticate all members. Instead of signing in to {% data variables.product.prodname_dotcom %} with a {% data variables.product.prodname_dotcom %} username and password, members of your enterprise will sign in through your IdP. {% data variables.product.prodname_emus %} supports the following IdPs: @@ -27,6 +27,9 @@ With {% data variables.product.prodname_emus %}, your enterprise uses SAML SSO t After you configure SAML SSO, we recommend storing your recovery codes so you can recover access to your enterprise in the event that your identity provider is unavailable. + +{% data reusables.enterprise_user_management.SAML-to-OIDC-migration-for-EMU %} + {% note %} **Note:** When SAML SSO is enabled, the only setting you can update on {% data variables.product.prodname_dotcom %} for your existing SAML configuration is the SAML certificate. If you need to update the Sign on URL or Issuer, you must first disable SAML SSO and then reconfigure SAML SSO with the new settings. diff --git a/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md b/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md index 1d10031b84..8ec69251ad 100644 --- a/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md +++ b/translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md @@ -12,7 +12,7 @@ topics: - SSO --- -{% data reusables.enterprise-accounts.oidc-beta-notice %} +{% data reusables.enterprise-accounts.azure-emu-support-oidc %} ## About migrating your {% data variables.enterprise.prodname_emu_enterprise %} from SAML to OIDC diff --git a/translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md b/translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md index 6bbe5ad199..8ddb21e79d 100644 --- a/translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md +++ b/translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md @@ -124,5 +124,7 @@ If you use Okta as your IdP, you can map your Okta groups to teams on {% data va ## Further reading - [SAML Wiki](https://wiki.oasis-open.org/security) on the OASIS website -- [System for Cross-domain Identity Management: Protocol (RFC 7644)](https://tools.ietf.org/html/rfc7644) on the IETF website{% ifversion ghae %} -- [Restricting network traffic to your enterprise](/admin/configuration/restricting-network-traffic-to-your-enterprise){% endif %} +- [System for Cross-domain Identity Management: Protocol (RFC 7644)](https://tools.ietf.org/html/rfc7644) on the IETF website +{%- ifversion ghae %} +- "[Restricting network traffic to your enterprise with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)" +{%- endif %} diff --git a/translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md b/translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md index ceebd276ec..6b092c1cb6 100644 --- a/translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md +++ b/translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md @@ -1,7 +1,7 @@ --- -title: Configuring authentication and provisioning for your enterprise using Azure AD +title: Azure AD を使用して Enterprise の認証とプロビジョニングを設定する shortTitle: Configure with Azure AD -intro: 'You can use a tenant in Azure Active Directory (Azure AD) as an identity provider (IdP) to centrally manage authentication and user provisioning for {% data variables.location.product_location %}.' +intro: 'Azure Active Directory (Azure AD) のテナントを ID プロバイダー (IdP) として使って、{% data variables.location.product_location %} の認証とユーザー プロビジョニングを一元管理できます。' permissions: 'Enterprise owners can configure authentication and provisioning for an enterprise on {% data variables.product.product_name %}.' versions: ghae: '*' @@ -17,65 +17,69 @@ redirect_from: - /admin/authentication/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad - /admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad - /admin/identity-and-access-management/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad +ms.openlocfilehash: bfd93814b11066d6da2d87a2e1f0a8bd5461e93f +ms.sourcegitcommit: ced661bdffebd0f96f6f76db109fbe31983448ba +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167061' --- +## Azure AD を使用した認証とユーザプロビジョニングについて -## About authentication and user provisioning with Azure AD +Azure Active Directory (Azure AD) は、ユーザアカウントと Web アプリケーションへのアクセスを一元管理できる Microsoft のサービスです。 詳細については、Microsoft Docs の「[Azure Active Directory とは](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis)」を参照してください。 -Azure Active Directory (Azure AD) is a service from Microsoft that allows you to centrally manage user accounts and access to web applications. For more information, see [What is Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) in the Microsoft Docs. - -To manage identity and access for {% data variables.product.product_name %}, you can use an Azure AD tenant as a SAML IdP for authentication. You can also configure Azure AD to automatically provision accounts and access membership with SCIM, which allows you to create {% data variables.product.product_name %} users and manage team and organization membership from your Azure AD tenant. +{% data variables.product.product_name %} のアイデンティティとアクセスを管理するために、Azure AD テナントを認証用の SAML IdP として使用できます。 アカウントを自動的にプロビジョニングし、SCIM でメンバーシップにアクセスするように、Azure AD を構成することもできます。これにより、{% data variables.product.product_name %} のユーザーを作成し、Azure AD テナントから Team と Organization のメンバーシップを管理できます。 {% data reusables.scim.ghes-beta-note %} -After you enable SAML SSO and SCIM for {% data variables.product.product_name %} using Azure AD, you can accomplish the following from your Azure AD tenant. +Azure AD を使って {% data variables.product.product_name %} に対して SAML SSO と SCIM を有効にした後、Azure AD テナントから以下を実行できます。 -* Assign the {% data variables.product.product_name %} application on Azure AD to a user account to automatically create and grant access to a corresponding user account on {% data variables.product.product_name %}. -* Unassign the {% data variables.product.product_name %} application to a user account on Azure AD to deactivate the corresponding user account on {% data variables.product.product_name %}. -* Assign the {% data variables.product.product_name %} application to an IdP group on Azure AD to automatically create and grant access to user accounts on {% data variables.product.product_name %} for all members of the IdP group. In addition, the IdP group is available on {% data variables.product.product_name %} for connection to a team and its parent organization. -* Unassign the {% data variables.product.product_name %} application from an IdP group to deactivate the {% data variables.product.product_name %} user accounts of all IdP users who had access only through that IdP group and remove the users from the parent organization. The IdP group will be disconnected from any teams on {% data variables.product.product_name %}. +* Azure AD の {% data variables.product.product_name %} アプリケーションをユーザー アカウントに割り当て、{% data variables.product.product_name %} 上に対応するユーザー アカウントを自動的に作成して、アクセスを許可します。 +* Azure AD 上のユーザー アカウントへの {% data variables.product.product_name %} アプリケーションの割り当てを解除し、{% data variables.product.product_name %} の対応するユーザー アカウントを非アクティブ化します。 +* {% data variables.product.product_name %} アプリケーションを Azure AD の IdP グループに割り当てて、IdP グループのすべてのメンバーに対する {% data variables.product.product_name %} 上のユーザー アカウントを自動的に作成して、アクセスを許可します。 さらに、Team とその親 Organization に接続するために、{% data variables.product.product_name %} で IdP グループを利用できます。 +* IdP グループから {% data variables.product.product_name %} アプリケーションの割り当てを解除すると、その IdP グループを介してのみアクセスしていたすべての IdP ユーザーの {% data variables.product.product_name %} ユーザー アカウントが非アクティブ化され、親 Organization からユーザーが削除されます。 IdP グループは {% data variables.product.product_name %} のどの Team からも切断されます -For more information about managing identity and access for your enterprise on {% data variables.location.product_location %}, see "[Managing identity and access for your enterprise](/admin/authentication/managing-identity-and-access-for-your-enterprise)." For more information about synchronizing teams with IdP groups, see "[Synchronizing a team with an identity provider group](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group)." +{% data variables.location.product_location %} での Enterprise の ID とアクセスの管理について詳しくは、「[Enterprise の ID とアクセスを管理する](/admin/authentication/managing-identity-and-access-for-your-enterprise)」をご覧ください。 IdP グループとのチームの同期の詳細については、「[チームを ID プロバイダー グループと同期する](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group)」を参照してください。 -## Prerequisites +## 前提条件 -- To configure authentication and user provisioning for {% data variables.product.product_name %} using Azure AD, you must have an Azure AD account and tenant. For more information, see the [Azure AD website](https://azure.microsoft.com/free/active-directory) and [Quickstart: Create an Azure Active Directory tenant](https://docs.microsoft.com/azure/active-directory/develop/quickstart-create-new-tenant) in the Microsoft Docs. +- Azure AD を使用して {% data variables.product.product_name %} の認証とユーザプロビジョニングを設定するには、Azure AD アカウントとテナントが必要です。 詳細については、[Azure AD Web サイト](https://azure.microsoft.com/free/active-directory)および Microsoft Docs の「[クイックスタート: Azure Active Directory テナントを作成する](https://docs.microsoft.com/azure/active-directory/develop/quickstart-create-new-tenant)」を参照してください。 {%- ifversion scim-for-ghes %} -- {% data reusables.saml.ghes-you-must-configure-saml-sso %} -{%- endif %} +- {% data reusables.saml.ghes-you-must-configure-saml-sso %}{%- endif %} - {% data reusables.saml.create-a-machine-user %} -## Configuring authentication and user provisioning with Azure AD +## Azure AD を使用して認証とユーザプロビジョニングを設定する -In your Azure AD tenant, add the application for {% data variables.product.product_name %}, then configure provisioning. +Azure AD テナントで、{% data variables.product.product_name %} 用のアプリケーションを追加してから、プロビジョニングを構成します。 {% ifversion ghae %} -1. In Azure AD, add the {% data variables.enterprise.ae_azure_ad_app_link %} to your tenant and configure single sign-on. For more information, see [Tutorial: Azure Active Directory single sign-on (SSO) integration with {% data variables.product.product_name %}](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-tutorial) in the Microsoft Docs. +1. Azure AD で、{% data variables.enterprise.ae_azure_ad_app_link %} をテナントに追加し、シングル サインオンを構成します。 詳しくは、Microsoft Docs の[チュートリアル: Azure Active Directory シングル サインオン (SSO) と {% data variables.product.product_name %} の統合](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-tutorial)に関する記事をご覧ください。 -1. In {% data variables.product.product_name %}, enter the details for your Azure AD tenant. +1. {% data variables.product.product_name %} で、Azure AD テナントの詳細を入力します。 - {% data reusables.saml.ae-enable-saml-sso-during-bootstrapping %} - - If you've already configured SAML SSO for {% data variables.location.product_location %} using another IdP and you want to use Azure AD instead, you can edit your configuration. For more information, see "[Configuring SAML single sign-on for your enterprise](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise#editing-the-saml-sso-configuration)." + - 別の IdP を使って {% data variables.location.product_location %} の SAML SSO を既に設定しており、その代わりに Azure AD を使う場合は、構成を編集できます。 詳細については、「[エンタープライズ向けの SAML シングル サインオンの構成](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise#editing-the-saml-sso-configuration)」を参照してください。 -1. Enable user provisioning in {% data variables.product.product_name %} and configure user provisioning in Azure AD. For more information, see "[Configuring user provisioning for your enterprise](/admin/authentication/configuring-user-provisioning-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)." +1. {% data variables.product.product_name %} でユーザプロビジョニングを有効化し、Azure AD でユーザプロビジョニングを設定します。 詳細については、「[エンタープライズ向けのユーザー プロビジョニングの構成](/admin/authentication/configuring-user-provisioning-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)」を参照してください。 {% elsif scim-for-ghes %} -1. In the Azure AD tenant, in the left sidebar, click **Provisioning**. +1. Azure AD テナントの左側のサイドバーで、 **[プロビジョニング]** をクリックします。 -1. Under "Tenant URL", type the full endpoint URL for SCIM on {% data variables.location.product_location %}. For more information, see "[SCIM](/rest/enterprise-admin/scim#scim-endpoint-urls)" in the REST API documentation. +1. [テナント URL] に、{% data variables.location.product_location %} での SCIM の完全なエンドポイント URL を入力します。 詳しくは、REST API のドキュメントの「[SCIM](/rest/enterprise-admin/scim#scim-endpoint-urls)」をご覧ください。 -1. Under "Secret Token", type the {% data variables.product.pat_v1 %} that you created in step 4 of "[Configuring user provisioning with SCIM for your enterprise](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)." +1. [シークレット トークン] に、「[Enterprise 用の SCIM を使用したユーザーのプロビジョニングを構成する](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise#enabling-user-provisioning-for-your-enterprise)」のステップ 4 で作成した {% data variables.product.pat_v1 %} を入力します。 -1. To ensure a successful connection from Azure AD to {% data variables.location.product_location %}, Click **Test Connection**. +1. Azure AD から {% data variables.location.product_location %} への正常な接続を確認するには、 **[テスト接続]** をクリックします。 -1. After you ensure a successful connection, at the top of the page, click **Save**. +1. 接続が成功したことを確認したら、ページの上部にある **[保存]** をクリックします。 {% endif %} -1. Assign an enterprise owner for {% data variables.product.product_name %} in Azure AD. The process you should follow depends on whether you configured provisioning. For more information about enterprise owners, see "[Roles in an enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owners)." - - If you configured provisioning, to grant the user enterprise ownership in {% data variables.product.product_name %}, assign the enterprise owner role to the user in Azure AD. - - If you did not configure provisioning, to grant the user enterprise ownership in {% data variables.product.product_name %}, include the `administrator` attribute in the SAML assertion for the user account on the IdP, with the value of `true`. For more information about including the `administrator` attribute in the SAML claim from Azure AD, see [How to: customize claims issued in the SAML token for enterprise applications](https://docs.microsoft.com/azure/active-directory/develop/active-directory-saml-claims-customization) in the Microsoft Docs. +1. Azure AD で {% data variables.product.product_name %} のエンタープライズ所有者を割り当てます。 従う必要があるプロセスは、プロビジョニングを構成したかどうかによって異なります。 Enterprise 所有者の詳細については、「[Enterprise におけるロール](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owners)」を参照してください。 + - プロビジョニングを構成した場合、{% data variables.product.product_name %} でユーザーにエンタープライズ所有権を付与するには、Azure AD のユーザーにエンタープライズ所有者ロールを割り当てます。 + - プロビジョニングを構成しなかった場合は、{% data variables.product.product_name %} でユーザーにエンタープライズ所有権を付与するには、IdP のユーザー アカウントに対して、SAML アサーションの `administrator` 属性を、`true` の値を指定して含めます。 Azure AD からの SAML 要求に `administrator` 属性を含める方法の詳細については、Microsoft Docs の「[エンタープライズ アプリケーションの SAML トークンで発行された要求のカスタマイズ](https://docs.microsoft.com/azure/active-directory/develop/active-directory-saml-claims-customization)」を参照してください。 diff --git a/translations/ja-JP/content/admin/index.md b/translations/ja-JP/content/admin/index.md index f9430e64fa..c3dd3264d6 100644 --- a/translations/ja-JP/content/admin/index.md +++ b/translations/ja-JP/content/admin/index.md @@ -73,7 +73,7 @@ featuredLinks: - '{% ifversion ghae %}/admin/user-management/auditing-users-across-your-enterprise{% endif %}' - /admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise - /admin/policies/enforcing-policies-for-your-enterprise/about-enterprise-policies - - '{% ifversion ghae %}/admin/configuration/restricting-network-traffic-to-your-enterprise{% endif %}' + - '{% ifversion ghae %}/admin/configuration/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list{% endif %}' - '{% ifversion ghes %}/admin/configuration/configuring-backups-on-your-appliance{% endif %}' - '{% ifversion ghes %}/admin/enterprise-management/creating-a-high-availability-replica{% endif %}' - '{% ifversion ghes %}/admin/overview/about-upgrades-to-new-releases{% endif %}' @@ -125,11 +125,11 @@ children: - /guides - /release-notes - /all-releases -ms.openlocfilehash: 3980ad01e56bf1e38dd6473c5e5246c6d45350eb -ms.sourcegitcommit: 3268914369fb29540e4d88ee5e56bc7a41f2a60e +ms.openlocfilehash: 0a84555b92c4645807d082f0d7f9348dfd3fc4bf +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/26/2022 -ms.locfileid: '148111313' +ms.lasthandoff: 11/22/2022 +ms.locfileid: '148179982' --- diff --git a/translations/ja-JP/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/identifying-audit-log-events-performed-by-an-access-token.md b/translations/ja-JP/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/identifying-audit-log-events-performed-by-an-access-token.md new file mode 100644 index 0000000000..372adbda30 --- /dev/null +++ b/translations/ja-JP/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/identifying-audit-log-events-performed-by-an-access-token.md @@ -0,0 +1,73 @@ +--- +title: アクセス トークンによって実行される監査ログ イベントの識別 +shortTitle: Identify events by token +intro: 'エンタープライズ内の特定の{% data variables.product.pat_generic %}または OAuth トークンによって実行されるアクションを特定できます。' +versions: + feature: token-audit-log +ms.openlocfilehash: 4452e740e611ea3f903c5d122222b3cb575ba37d +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160133' +--- +## 監査ログのトークン データについて + +エンタープライズの監査ログで、認証に{% data variables.product.pat_generic %}または OAuth アプリケーションを使用して実行されたアクションの場合、イベント データには、使用される認証方法とトークンの SHA-256 ハッシュが表示されます。 + +トークンが侵害されたことを知った場合は、そのトークンに関連付けられているすべてのイベントについてエンタープライズの監査ログを検索することで、侵害されたトークンによって実行されたアクションを把握できます。 + +監査ログをエクスポートするときにハッシュされたトークン値は含まれません。 + +## トークンに関連付けられているイベントの検索 + +特定のトークンに関連付けられているイベントを検索する場合は、UI または REST API を使用できます。 どちらの場合も、最初にトークンの SHA-256 ハッシュを把握する必要があります。 + +### トークンの SHA-256 ハッシュ値の生成 + +未加工のトークン値しかない場合は、トークンを検索する前に SHA-256 ハッシュを生成する必要があります。 + +MacOS と Linux の場合は、`echo -n TOKEN | openssl dgst -sha256 -binary | base64` を使用して TOKEN をトークン値に置き換えることができます。 + +Powershell では、次のスクリプトを使用して、指定された文字列の SHA-256 ハッシュを返すことができます。 + +```shell{:copy} +Param ( + [Parameter(Mandatory=$true)] + [string] + $ClearString +) + +$hasher = [System.Security.Cryptography.HashAlgorithm]::Create('sha256') +$hash = $hasher.ComputeHash([System.Text.Encoding]::UTF8.GetBytes($ClearString)) + +$hashString = [System.BitConverter]::ToString($hash) +$hashString.Replace('-', '') +``` + +### {% data variables.product.prodname_dotcom %} での検索 + +{% data variables.product.prodname_dotcom %} で監査ログを検索するときに、検索クエリに `hashed_token:"VALUE"` を含めて、`VALUE` をトークンの SHA-256 ハッシュに置き換えます。 + +{% note %} + +**注:** ハッシュされたトークン値を引用符で囲んでください。 + +{% endnote %} + +### REST API を使用した検索 + +REST API を使用してトークンを検索する前に、SHA-256 ハッシュを生成した後、ハッシュを URI エスケープする必要もあります。 ほとんどの主要なプログラミング言語で、URI エスケープのためのユーティリティが提供されます。 たとえば、[encodeURIComponent()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) は JavaScript の文字列をエンコードします。 + +次に、検索語句に `hashed_token:"VALUE"` を含め、VALUE を URI エスケープ ハッシュに置き換えます。 + +たとえば、エンタープライズ アカウントの名前が `octo-corp` の場合、次の curl コマンドは、URI でエンコードされた SHA-256 ハッシュが `EH4L8o6PfCqipALbL%2BQT62lyqUtnI7ql0SPbkaQnjv8` であるトークンに関連付けられているすべてのイベントで @octo-corp の監査ログを検索します。 + +``` +curl --location --request GET 'https://api.github.com/enterprises/octo-corp/audit-log?phrase=hashed_token:"EH4L8o6PfCqipALbL%2BQT62lyqUtnI7ql0SPbkaQnjv8"' \ +--header 'Authorization: Basic TOKEN' \ +``` + +## 参考資料 + +- 「[エンタープライズの監査ログ API を使う](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise)」 diff --git a/translations/ja-JP/content/admin/overview/best-practices-for-enterprises.md b/translations/ja-JP/content/admin/overview/best-practices-for-enterprises.md new file mode 100644 index 0000000000..ad24e1fc5c --- /dev/null +++ b/translations/ja-JP/content/admin/overview/best-practices-for-enterprises.md @@ -0,0 +1,53 @@ +--- +title: エンタープライズのベスト プラクティス +shortTitle: Best practices +intro: 'エンタープライズ向けに {% data variables.product.company_short %} が推奨するプラクティスについて説明します。' +versions: + ghec: '*' + ghes: '*' + ghae: '*' +type: overview +topics: + - Accounts + - Enterprise + - Fundamentals +ms.openlocfilehash: 9c9ccfb0437b451188f8180dcf5ae29a6030f72d +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163458' +--- +{% ifversion ghec %} +## エンタープライズに最適な認証方法を特定する + +{% data reusables.enterprise.ghec-authentication-options %} + +ニーズに最適な認証方法を特定するためのサポートについては、「[エンタープライズの認証について](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise)」を参照してください。 {% endif %} + +## ポリシーの使用 + +ポリシーを使って、ビジネス ルールと規制コンプライアンスを強制することをお勧めします。 + +{% data reusables.enterprise.about-policies %} 詳細については、「[エンタープライズ ポリシーについて](/admin/policies/enforcing-policies-for-your-enterprise/about-enterprise-policies)」を参照してください。 + +## 組織の数を最小限に抑える + +多くの場合、大規模なエンタープライズは複数の組織を必要としますが、最上位の企業部門を反映するように、その数はできるだけ少なくなるようにします。 組織の数が少なければ、インナーソースのプラクティスが促進され、より多くのユーザーがディスカッションに参加できるようになります。 + +代わりに、各組織内でチームを使用して、より詳細なレベルでリポジトリのアクセスとセキュリティ要件を管理できます。 詳細については、「[Team について](/organizations/organizing-members-into-teams/about-teams)」を参照してください。 + +## ユーザー所有のリポジトリで大規模なコラボレーションを行わない + +可能であれば組織所有のリポジトリでコラボレーションを行い、ユーザー所有のリポジトリでのコラボレーションは最小限に抑えることをおすすめします。 組織所有のリポジトリにはより高度なセキュリティと管理機能が備わっており、エンタープライズのメンバーシップが変更されても引き続きアクセスできます。 + +## 人間が判読できるユーザー名を使う + +{% ifversion ghec %}エンタープライズ メンバーのユーザー名を制御する場合は、{% else %}{% endif %}人間が判読できるユーザー名を使い、マシンによって生成された人間が判読しにくい ID は使わないようにします。 + +エンタープライズのプライベート リポジトリ内でユーザー名の表示を管理できます。 詳細については、「[組織のメンバー名表示を管理する](/organizations/managing-organization-settings/managing-the-display-of-member-names-in-your-organization)」を参照してください。 + +## 参考資料 + +- [リポジトリのベスト プラクティス](/repositories/creating-and-managing-repositories/best-practices-for-repositories) +- [組織のベスト プラクティス](/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations) diff --git a/translations/ja-JP/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md b/translations/ja-JP/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md index 935cf07d90..0f1353aec5 100644 --- a/translations/ja-JP/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md +++ b/translations/ja-JP/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md @@ -1,6 +1,6 @@ --- -title: Quickstart for configuring your MinIO storage bucket for GitHub Packages -intro: 'Configure your custom MinIO storage bucket for use with {% data variables.product.prodname_registry %}.' +title: GitHub Packages の MinIO ストレージバケットを設定するためのクイックスタート +intro: '{% data variables.product.prodname_registry %} で使用するためにカスタム MinIO ストレージバケットを設定します。' versions: ghes: '*' type: quick_start @@ -9,43 +9,48 @@ topics: - Enterprise - Storage shortTitle: Quickstart for MinIO +ms.openlocfilehash: 2d26aa879b0a59d8c6bd4d80a04ec2aa30f8c422 +ms.sourcegitcommit: 8f1801040a84ca9353899a2d1e6782c702aaed0d +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148166554' --- - {% data reusables.package_registry.packages-ghes-release-stage %} -Before you can enable and configure {% data variables.product.prodname_registry %} on {% data variables.location.product_location_enterprise %}, you need to prepare your third-party storage solution. +{% data variables.location.product_location_enterprise %} で {% data variables.product.prodname_registry %} を有効にして設定する前に、サードパーティのストレージ ソリューションを準備する必要があります。 -MinIO offers object storage with support for the S3 API and {% data variables.product.prodname_registry %} on your enterprise. +MinIO は、Enterprise で S3 API と {% data variables.product.prodname_registry %} をサポートするオブジェクトストレージを提供します。 -This quickstart shows you how to set up MinIO using Docker for use with {% data variables.product.prodname_registry %} but you have other options for managing MinIO besides Docker. For more information about MinIO, see the official [MinIO docs](https://docs.min.io/). +このクイックスタートでは、Docker を使用して {% data variables.product.prodname_registry %} で使用するように MinIO をセットアップする方法を説明していますが、Docker 以外に MinIO を管理するオプションがあります。 MinIO の詳細については、公式の [MinIO ドキュメント](https://docs.min.io/)を参照してください。 -## 1. Choose a MinIO mode for your needs +## 1. ニーズに合わせて MinIO モードを選択する -| MinIO mode | Optimized for | Storage infrastructure required | +| MinIO モード | 最適化の対象 | 必要なストレージインフラストラクチャ | |----|----|----| -| Standalone MinIO (on a single host) | Fast setup | N/A | -| Clustered MinIO (also called Distributed MinIO)| Data security | Storage servers running in a cluster | +| スタンドアロン MinIO (シングルホスト) | 高速セットアップ | 該当なし | +| クラスタ型 MinIO (分散型 MinIO)| データのセキュリティ | クラスタ内で実行中のストレージサーバー | -For more information about your options, see the official [MinIO docs](https://docs.min.io/). +オプションに関する詳細については、[MinIO ドキュメント](https://docs.min.io/)を参照してください。 -## 2. Install, run, and sign in to MinIO +## 2. MinIO をインストール、実行、サインインする -1. Set up your preferred environment variables for MinIO. +1. MinIO のお好みの環境変数を設定します。 - These examples use `MINIO_DIR`: + これらの例では `MINIO_DIR` が使用されます。 ```shell $ export MINIO_DIR=$(pwd)/minio $ mkdir -p $MINIO_DIR ``` -2. Install MinIO. +2. MinIO をインストールします。 ```shell $ docker pull minio/minio ``` - For more information, see the official "[MinIO Quickstart Guide](https://docs.min.io/docs/minio-quickstart-guide)." + 詳細については、公式の「[MinIO クイック スタート ガイド](https://docs.min.io/docs/minio-quickstart-guide)」を参照してください。 -3. Sign in to MinIO using your MinIO access key and secret. +3. MinIO アクセスキーとシークレットを使用して MinIO にサインインします。 {% linux %} ```shell @@ -63,16 +68,16 @@ For more information about your options, see the official [MinIO docs](https://d ``` {% endmac %} - You can access your MinIO keys using the environment variables: + 環境変数を使用して MinIO キーにアクセスできます。 ```shell $ echo $MINIO_ACCESS_KEY $ echo $MINIO_SECRET_KEY ``` -4. Run MinIO in your chosen mode. +4. 選択したモードで MinIO を実行します。 - * Run MinIO using Docker on a single host: + * 単一のホストで Docker を使用して MinIO を実行します。 ```shell $ docker run -p 9000:9000 \ @@ -82,42 +87,42 @@ For more information about your options, see the official [MinIO docs](https://d minio/minio server /data ``` - For more information, see "[MinIO Docker Quickstart guide](https://docs.min.io/docs/minio-docker-quickstart-guide.html)." + 詳細については、「[MinIO Docker クイックスタート ガイド](https://docs.min.io/docs/minio-docker-quickstart-guide.html)」を参照してください。 - * Run MinIO using Docker as a cluster. This MinIO deployment uses several hosts and MinIO's erasure coding for the strongest data protection. To run MinIO in a cluster mode, see the "[Distributed MinIO Quickstart Guide](https://docs.min.io/docs/distributed-minio-quickstart-guide.html)." + * Docker をクラスタとして使用して MinIO を実行します。 この MinIO デプロイメントでは、複数のホストと MinIO のイレイジャーコーディングを使用して、最強のデータ保護を実現します。 クラスター モードで MinIO を実行するには、「[分散 MinIO クイック スタート ガイド](https://docs.min.io/docs/distributed-minio-quickstart-guide.html)」を参照してください。 -## 3. Create your MinIO bucket for {% data variables.product.prodname_registry %} +## 3. {% data variables.product.prodname_registry %} の MinIO バケットを作成する -1. Install the MinIO client. +1. MinIO クライアントをインストールします。 ```shell $ docker pull minio/mc ``` -2. Create a bucket with a host URL that {% data variables.product.prodname_ghe_server %} can access. +2. {% data variables.product.prodname_ghe_server %} がアクセスできるホスト URL を使用してバケットを作成します。 - * Local deployments example: + * ローカルデプロイメントの例: ```shell $ export MC_HOST_minio="http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY} @localhost:9000" $ docker run minio/mc BUCKET-NAME ``` - This example can be used for MinIO standalone. + この例は、MinIO スタンドアロンに使用できます。 - * Clustered deployments example: + * クラスタ型デプロイメントの例: ```shell $ export MC_HOST_minio="http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY} @minioclustername.example.com:9000" $ docker run minio/mc mb packages ``` -## Next steps +## 次の手順 -To finish configuring storage for {% data variables.product.prodname_registry %}, you'll need to copy the MinIO storage URL: +{% data variables.product.prodname_registry %} のストレージの設定を完了するには、MinIO ストレージ URL をコピーする必要があります。 ``` echo "http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY}@minioclustername.example.com:9000" ``` -For the next steps, see "[Enabling {% data variables.product.prodname_registry %} with MinIO](/admin/packages/enabling-github-packages-with-minio)." +次の手順については、「[MinIO で {% data variables.product.prodname_registry %} を有効にする](/admin/packages/enabling-github-packages-with-minio)」を参照してください。 diff --git a/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md b/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md index bedf7001c2..c2227ba0ff 100644 --- a/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md +++ b/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md @@ -25,7 +25,7 @@ shortTitle: Policies for security settings ## About policies for security settings in your enterprise -You can enforce policies to control the security settings for organizations owned by your enterprise on {% data variables.product.product_name %}. By default, organization owners can manage security settings. For more information, see "[Keeping your organization secure](/organizations/keeping-your-organization-secure)." +You can enforce policies to control the security settings for organizations owned by your enterprise on {% data variables.product.product_name %}. By default, organization owners can manage security settings. {% ifversion ghec or ghes %} @@ -59,93 +59,6 @@ Before you require use of two-factor authentication, we recommend notifying orga {% endif %} -{% ifversion ghec or ghae %} - -## Managing allowed IP addresses for organizations in your enterprise - -{% ifversion ghae %} - -You can restrict network traffic to your enterprise on {% data variables.product.product_name %}. For more information, see "[Restricting network traffic to your enterprise](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise)." - -{% elsif ghec %} - -Enterprise owners can restrict access to private assets owned by organizations in an enterprise by configuring an allow list for specific IP addresses. {% data reusables.identity-and-permissions.ip-allow-lists-example-and-restrictions %} - -{% data reusables.identity-and-permissions.ip-allow-lists-cidr-notation %} - -{% data reusables.identity-and-permissions.ip-allow-lists-enable %} {% data reusables.identity-and-permissions.ip-allow-lists-enterprise %} - -You can also configure allowed IP addresses for an individual organization. For more information, see "[Managing allowed IP addresses for your organization](/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization)." - -### Adding an allowed IP address - -{% data reusables.identity-and-permissions.about-adding-ip-allow-list-entries %} - -{% data reusables.identity-and-permissions.ipv6-allow-lists %} - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.security-tab %} -{% data reusables.identity-and-permissions.ip-allow-lists-add-ip %} -{% data reusables.identity-and-permissions.ip-allow-lists-add-description %} -{% data reusables.identity-and-permissions.ip-allow-lists-add-entry %} -{% data reusables.identity-and-permissions.check-ip-address %} - -### Allowing access by {% data variables.product.prodname_github_apps %} - -{% data reusables.identity-and-permissions.ip-allow-lists-githubapps-enterprise %} - -### Enabling allowed IP addresses - -{% data reusables.identity-and-permissions.about-enabling-allowed-ip-addresses %} - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.security-tab %} -3. Under "IP allow list", select **Enable IP allow list**. - ![Checkbox to allow IP addresses](/assets/images/help/security/enable-ip-allowlist-enterprise-checkbox.png) -4. Click **Save**. - -### Editing an allowed IP address - -{% data reusables.identity-and-permissions.about-editing-ip-allow-list-entries %} - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.security-tab %} -{% data reusables.identity-and-permissions.ip-allow-lists-edit-entry %} -{% data reusables.identity-and-permissions.ip-allow-lists-edit-ip %} -{% data reusables.identity-and-permissions.ip-allow-lists-edit-description %} -8. Click **Update**. -{% data reusables.identity-and-permissions.check-ip-address %} - -{% ifversion ip-allow-list-address-check %} -### Checking if an IP address is permitted - -{% data reusables.identity-and-permissions.about-checking-ip-address %} - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.security-tab %} -{% data reusables.identity-and-permissions.check-ip-address-step %} -{% endif %} - -### Deleting an allowed IP address - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.security-tab %} -{% data reusables.identity-and-permissions.ip-allow-lists-delete-entry %} -{% data reusables.identity-and-permissions.ip-allow-lists-confirm-deletion %} - -### Using {% data variables.product.prodname_actions %} with an IP allow list - -{% data reusables.actions.ip-allow-list-self-hosted-runners %} - -{% endif %} - -{% endif %} - ## Managing SSH certificate authorities for your enterprise You can use a SSH certificate authorities (CA) to allow members of any organization owned by your enterprise to access that organization's repositories using SSH certificates you provide. {% data reusables.organizations.can-require-ssh-cert %} For more information, see "[About SSH certificate authorities](/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities)." @@ -197,5 +110,7 @@ To prevent confusion from your developers, you can change this behavior so that ## Further reading - "[About identity and access management for your enterprise](/admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise)"{% ifversion ghec %} -- "[Accessing compliance reports for your enterprise](/admin/overview/accessing-compliance-reports-for-your-enterprise)"{% endif %} -{% endif %} +- "[Accessing compliance reports for your enterprise](/admin/overview/accessing-compliance-reports-for-your-enterprise)"{%- endif %} +- "[Keeping your organization secure](/organizations/keeping-your-organization-secure)" +- "[Restricting network traffic with an IP allow list with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)" +{%- endif %} diff --git a/translations/ja-JP/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md b/translations/ja-JP/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md new file mode 100644 index 0000000000..a27af752a1 --- /dev/null +++ b/translations/ja-JP/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md @@ -0,0 +1,46 @@ +--- +title: セッションの表示と管理 +intro: 設定でアクティブなセッションを表示および取り消すことができます。 +versions: + feature: device-and-settings-management-page +type: how_to +topics: + - SSO +shortTitle: Viewing and managing sessions +ms.openlocfilehash: 15a0bdc17a913ceb6da27e8809610306adb1de25 +ms.sourcegitcommit: b2e5d14036a700b781e91158a552f8c0b1f04839 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/15/2022 +ms.locfileid: '148165581' +--- +アカウントにログインしているデバイスの一覧を表示し、認識できないセッションを取り消すことができます。 + +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.sessions %} +1. [Web セッション] の下で、アクティブな Web セッションを確認できます。 + + ![アクティブなセッション一覧のスクリーンショット](/assets/images/help/settings/saml-active-sessions.png) {% ifversion fpt or ghec %} [{% data variables.product.prodname_mobile %} セッション] の下で、{% data variables.product.prodname_mobile %} アプリを使用してアカウントにログインしているデバイスの一覧を確認できます。 + + ![アクティブなセッションの一覧のスクリーンショット](/assets/images/help/settings/github-mobile-active-sessions.png){% endif %} + +1. Web セッションの詳細を表示するには、 **[詳細情報]** をクリックします。 + + ![セッションの詳細を開くボタンが強調された [セッション] ページのスクリーンショット](/assets/images/help/settings/saml-expand-session-details.png) + +1. Web セッションを取り消すには、 **[セッションの取り消し]** をクリックします。 + + ![セッションを取り消すボタンが強調されたセッションの詳細ページのスクリーンショット](/assets/images/help/settings/revoke-session.png) + +{% ifversion fpt or ghec %} +1. {% data variables.product.prodname_mobile %} セッションを取り消す場合、セッションの概要ページに戻り、取り消すデバイスの横の **[取り消し]** をクリックして取り消すオプションもあります。 + + {% note %} + + **メモ:** モバイル セッションを取り消すと、そのデバイス上で {% data variables.product.prodname_mobile %} アプリケーションからサインアウトされ、2 要素のオプションとして削除されます。 + + {% endnote %} + + ![モバイル セッションを取り消すボタンが強調されたセッション ページのスクリーンショット](/assets/images/help/settings/revoke-mobile-session.png) + +{% endif %} + diff --git a/translations/ja-JP/content/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key.md b/translations/ja-JP/content/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key.md index ced8fa545f..15837294e8 100644 --- a/translations/ja-JP/content/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key.md +++ b/translations/ja-JP/content/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key.md @@ -1,6 +1,6 @@ --- -title: Git へ署名キーを伝える -intro: 'ローカル環境でコミットに署名するには、使う GPG{% ifversion ssh-commit-verification %}、SSH、{% endif %} または X.509 キーがあることを Git に知らせる必要があります。' +title: Telling Git about your signing key +intro: 'To sign commits locally, you need to inform Git that there''s a GPG{% ifversion ssh-commit-verification %}, SSH,{% endif %} or X.509 key you''d like to use.' redirect_from: - /articles/telling-git-about-your-gpg-key - /articles/telling-git-about-your-signing-key @@ -15,39 +15,38 @@ topics: - Identity - Access management shortTitle: Tell Git your signing key -ms.openlocfilehash: e78306bb1519f2b7f51ab6bc039bff0b982e48cf -ms.sourcegitcommit: a0ad3bfe2a99c3092e76ca9b3d476cf30988ca55 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 10/28/2022 -ms.locfileid: '148118996' --- {% mac %} -## Git へ GPG キーを伝える +## Telling Git about your GPG key -コミッター ID と、{% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %} でのアカウントに関連付けられた検証済みのメール アドレスに一致する GPG キーを使っている場合、コミットやタグへの署名を始めることができます。 +If you're using a GPG key that matches your committer identity and your verified email address associated with your account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, then you can begin signing commits and signing tags. {% note %} -コミッターアイデンティティにマッチする GPG キーを持っていない場合、既存のキーとメールアドレスを関連付ける必要があります。 詳細については、「[メールと GPG キーの関連付け](/articles/associating-an-email-with-your-gpg-key)」を参照してください。 +If you don't have a GPG key that matches your committer identity, you need to associate an email with an existing key. For more information, see "[Associating an email with your GPG key](/articles/associating-an-email-with-your-gpg-key)". {% endnote %} -複数の GPG キーを持っている場合、どれを使うかを Git に伝える必要があります。 +If you have multiple GPG keys, you need to tell Git which one to use. -{% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.gpg.configure-gpg-signing %} {% data reusables.gpg.list-keys-with-note %} {% data reusables.gpg.copy-gpg-key-id %} {% data reusables.gpg.paste-gpg-key-id %} {% data reusables.gpg.set-auto-sign %} -1. GPG スイートを使用していない場合は、`zsh` シェルで次のコマンドを実行して、存在する場合は `.zshrc` ファイル、または `.zprofile` ファイルに GPG キーを追加します。 +{% data reusables.command_line.open_the_multi_os_terminal %} +{% data reusables.gpg.configure-gpg-signing %} +{% data reusables.gpg.list-keys-with-note %} +{% data reusables.gpg.copy-gpg-key-id %} +{% data reusables.gpg.paste-gpg-key-id %} +{% data reusables.gpg.set-auto-sign %} +1. If you aren't using the GPG suite, run the following command in the `zsh` shell to add the GPG key to your `.zshrc` file, if it exists, or your `.zprofile` file: ```shell $ if [ -r ~/.zshrc ]; then echo 'export GPG_TTY=$(tty)' >> ~/.zshrc; \ else echo 'export GPG_TTY=$(tty)' >> ~/.zprofile; fi ``` - または、`bash` シェルを使用する場合は、次のコマンドを実行します。 + Alternatively, if you use the `bash` shell, run this command: ```shell $ if [ -r ~/.bash_profile ]; then echo 'export GPG_TTY=$(tty)' >> ~/.bash_profile; \ else echo 'export GPG_TTY=$(tty)' >> ~/.profile; fi ``` -1. 必要に応じて、PIN またはパスフレーズの入力を求めるメッセージを表示するには、`pinentry-mac` をインストールします。 たとえば、[Homebrew](https://brew.sh/) を使用すると、次のようになります。 +1. Optionally, to prompt you to enter a PIN or passphrase when required, install `pinentry-mac`. For example, using [Homebrew](https://brew.sh/): ```shell $ brew install pinentry-mac $ echo "pinentry-program $(which pinentry-mac)" >> ~/.gnupg/gpg-agent.conf @@ -58,56 +57,69 @@ ms.locfileid: '148118996' {% windows %} -## Git へ GPG キーを伝える +## Telling Git about your GPG key -コミッター ID と、{% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %} でのアカウントに関連付けられた検証済みのメール アドレスに一致する GPG キーを使っている場合、コミットやタグへの署名を始めることができます。 +If you're using a GPG key that matches your committer identity and your verified email address associated with your account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, then you can begin signing commits and signing tags. {% note %} -コミッターアイデンティティにマッチする GPG キーを持っていない場合、既存のキーとメールアドレスを関連付ける必要があります。 詳細については、「[メールと GPG キーの関連付け](/articles/associating-an-email-with-your-gpg-key)」を参照してください。 +If you don't have a GPG key that matches your committer identity, you need to associate an email with an existing key. For more information, see "[Associating an email with your GPG key](/articles/associating-an-email-with-your-gpg-key)". {% endnote %} -複数の GPG キーを持っている場合、どれを使うかを Git に伝える必要があります。 +If you have multiple GPG keys, you need to tell Git which one to use. -{% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.gpg.configure-gpg-signing %} {% data reusables.gpg.list-keys-with-note %} {% data reusables.gpg.copy-gpg-key-id %} {% data reusables.gpg.paste-gpg-key-id %} {% data reusables.gpg.set-auto-sign %} +{% data reusables.command_line.open_the_multi_os_terminal %} +{% data reusables.gpg.configure-gpg-signing %} +{% data reusables.gpg.list-keys-with-note %} +{% data reusables.gpg.copy-gpg-key-id %} +{% data reusables.gpg.paste-gpg-key-id %} +{% data reusables.gpg.set-auto-sign %} {% endwindows %} {% linux %} -## Git へ GPG キーを伝える +## Telling Git about your GPG key -コミッター ID と、{% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %} でのアカウントに関連付けられた検証済みのメール アドレスに一致する GPG キーを使っている場合、コミットやタグへの署名を始めることができます。 +If you're using a GPG key that matches your committer identity and your verified email address associated with your account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, then you can begin signing commits and signing tags. {% note %} -コミッターアイデンティティにマッチする GPG キーを持っていない場合、既存のキーとメールアドレスを関連付ける必要があります。 詳細については、「[メールと GPG キーの関連付け](/articles/associating-an-email-with-your-gpg-key)」を参照してください。 +If you don't have a GPG key that matches your committer identity, you need to associate an email with an existing key. For more information, see "[Associating an email with your GPG key](/articles/associating-an-email-with-your-gpg-key)". {% endnote %} -複数の GPG キーを持っている場合、どれを使うかを Git に伝える必要があります。 +If you have multiple GPG keys, you need to tell Git which one to use. -{% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.gpg.configure-gpg-signing %} {% data reusables.gpg.list-keys-with-note %} {% data reusables.gpg.copy-gpg-key-id %} {% data reusables.gpg.paste-gpg-key-id %} {% data reusables.gpg.set-auto-sign %} -1. GPG キーを `.bashrc` スタートアップ ファイルに追加するには、次のコマンドを実行します。 +{% data reusables.command_line.open_the_multi_os_terminal %} +{% data reusables.gpg.configure-gpg-signing %} +{% data reusables.gpg.list-keys-with-note %} +{% data reusables.gpg.copy-gpg-key-id %} +{% data reusables.gpg.paste-gpg-key-id %} +{% data reusables.gpg.set-auto-sign %} +1. To add your GPG key to your `.bashrc` startup file, run the following command: ```bash $ [ -f ~/.bashrc ] && echo 'export GPG_TTY=$(tty)' >> ~/.bashrc ``` -{% endlinux %} {% ifversion ssh-commit-verification %} +{% endlinux %} +{% ifversion ssh-commit-verification %} -## Git に SSH キーについて知らせる +## Telling Git about your SSH key -既存の SSH キーを使ってコミットとタグに署名することも、署名専用に新しいキーを生成することもできます。 詳細については、「[新しい SSH キーを生成して ssh-agent に追加する](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)」を参照してください。 +You can use an existing SSH key to sign commits and tags, or generate a new one specifically for signing. For more information, see "[Generating a new SSH key and adding it to the ssh-agent](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)." {% data reusables.gpg.ssh-git-version %} -{% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.gpg.configure-ssh-signing %} {% data reusables.gpg.copy-ssh-public-key %} {% data reusables.gpg.paste-ssh-public-key %} +{% data reusables.command_line.open_the_multi_os_terminal %} +{% data reusables.gpg.configure-ssh-signing %} +{% data reusables.gpg.paste-ssh-public-key %} {% endif %} {% data reusables.gpg.x-509-key %} -## 関連項目 +## Further reading -- [GitHub アカウントへの新しい SSH キーの追加](/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) -- 「[コミットに署名する](/articles/signing-commits)」 -- [タグに署名する](/articles/signing-tags) +- "[Adding a new SSH key to your GitHub account](/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)." +- "[Signing commits](/articles/signing-commits)" +- "[Signing tags](/articles/signing-tags)" diff --git a/translations/ja-JP/content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md b/translations/ja-JP/content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md index ec06abf702..70d3938722 100644 --- a/translations/ja-JP/content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md +++ b/translations/ja-JP/content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md @@ -52,30 +52,24 @@ A time-based one-time password (TOTP) application automatically generates an aut {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.security %} {% data reusables.two_fa.enable-two-factor-authentication %} -{%- ifversion fpt or ghec or ghes %} +{%- ifversion fpt or ghec or ghes > 3.7 %} +5. Under "Setup authenticator app", do one of the following: + - Scan the QR code with your mobile device's app. After scanning, the app displays a six-digit code that you can enter on {% data variables.product.product_name %}. + - If you can't scan the QR code, click **enter this text code** to see a code that you can manually enter in your TOTP app instead. + ![Click enter this code](/assets/images/help/2fa/2fa_wizard_app_click_code.png) +6. The TOTP mobile application saves your account on {% data variables.location.product_location %} and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, type the code into the field under "Enter the six-digit code from the application". +![TOTP enter code field](/assets/images/help/2fa/2fa_wizard_app_enter_code.png) +{%- else %} 5. Under "Two-factor authentication", select **Set up using an app** and click **Continue**. 6. Under "Authentication verification", do one of the following: - Scan the QR code with your mobile device's app. After scanning, the app displays a six-digit code that you can enter on {% data variables.product.product_name %}. - If you can't scan the QR code, click **enter this text code** to see a code that you can manually enter in your TOTP app instead. ![Click enter this code](/assets/images/help/2fa/2fa_wizard_app_click_code.png) -7. The TOTP mobile application saves your account on {% data variables.location.product_location %} and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, type the code into the field under "Enter the six-digit code from the application". If your recovery codes are not automatically displayed, click **Continue**. +7. The TOTP mobile application saves your account on {% data variables.location.product_location %} and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, type the code into the field under "Enter the six-digit code from the application". ![TOTP enter code field](/assets/images/help/2fa/2fa_wizard_app_enter_code.png) -{% data reusables.two_fa.save_your_recovery_codes_during_2fa_setup %} -{%- else %} -5. On the Two-factor authentication page, click **Set up using an app**. -6. Save your recovery codes in a safe place. Your recovery codes can help you get back into your account if you lose access. - - To save your recovery codes on your device, click **Download**. - - To save a hard copy of your recovery codes, click **Print**. - - To copy your recovery codes for storage in a password manager, click **Copy**. - ![List of recovery codes with option to download, print, or copy the codes](/assets/images/help/2fa/download-print-or-copy-recovery-codes-before-continuing.png) -7. After saving your two-factor recovery codes, click **Next**. -8. On the Two-factor authentication page, do one of the following: - - Scan the QR code with your mobile device's app. After scanning, the app displays a six-digit code that you can enter on {% data variables.product.product_name %}. - - If you can't scan the QR code, click **enter this text code** to see a code you can copy and manually enter on {% data variables.product.product_name %} instead. - ![Click enter this code](/assets/images/help/2fa/totp-click-enter-code.png) -9. The TOTP mobile application saves your account on {% data variables.location.product_location %} and generates a new authentication code every few seconds. On {% data variables.product.product_name %}, on the 2FA page, type the code and click **Enable**. - ![TOTP Enable field](/assets/images/help/2fa/totp-enter-code.png) {%- endif %} +{% data reusables.two_fa.save_your_recovery_codes_during_2fa_setup %} +{% data reusables.two_fa.backup_options_during_2fa_enrollment %} {% data reusables.two_fa.test_2fa_immediately %} {% ifversion fpt or ghec %} @@ -95,8 +89,11 @@ Before using this method, be sure that you can receive text messages. Carrier ra {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.security %} {% data reusables.two_fa.enable-two-factor-authentication %} -4. Under "Two-factor authentication", select **Set up using SMS** and click **Continue**. -5. Under "Authentication verification", select your country code and type your mobile phone number, including the area code. When your information is correct, click **Send authentication code**. +4. Below "Setup authenticator app", select **SMS authentication** + + ![2FA SMS alternative option](/assets/images/help/2fa/2fa_sms_alt_option.png) + +5. Under "Setup SMS authentication", select your country code and type your mobile phone number, including the area code. When your information is correct, click **Send authentication code**. ![2FA SMS screen](/assets/images/help/2fa/2fa_wizard_sms_send.png) @@ -104,6 +101,7 @@ Before using this method, be sure that you can receive text messages. Carrier ra ![2FA SMS continue field](/assets/images/help/2fa/2fa_wizard_sms_enter_code.png) {% data reusables.two_fa.save_your_recovery_codes_during_2fa_setup %} +{% data reusables.two_fa.backup_options_during_2fa_enrollment %} {% data reusables.two_fa.test_2fa_immediately %} {% endif %} @@ -128,8 +126,7 @@ Authentication with a security key is *secondary* to authentication with a TOTP ![Providing a nickname for a security key](/assets/images/help/2fa/security-key-nickname.png) 8. Activate your security key, following your security key's documentation. ![Prompt for a security key](/assets/images/help/2fa/security-key-prompt.png) -9. Confirm that you've downloaded and can access your recovery codes. If you haven't already, or if you'd like to generate another set of codes, download your codes and save them in a safe place. If you lose access to your account, you can use your recovery codes to get back into your account. For more information, see "[Recovering your account if you lose your 2FA credentials](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)." - ![Download recovery codes button](/assets/images/help/2fa/2fa-recover-during-setup.png) +9. Confirm that you've downloaded and can access your recovery codes. If you haven't already, or if you'd like to generate another set of codes, download your codes and save them in a safe place. For more information, see "[Downloading your 2FA recovery codes](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods#downloading-your-two-factor-authentication-recovery-codes)." {% data reusables.two_fa.test_2fa_immediately %} {% ifversion fpt or ghec %} diff --git a/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/index.md b/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/index.md index d38eeec17c..313dedc07e 100644 --- a/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/index.md +++ b/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/index.md @@ -1,7 +1,7 @@ --- -title: Managing billing for GitHub Codespaces +title: GitHub Codespacesの支払いの管理 shortTitle: Codespaces -intro: 'You can view your usage and set a spending limit for {% data variables.product.prodname_github_codespaces %}.' +intro: '{% data variables.product.prodname_github_codespaces %} の使用状況を確認し、使用上限を設定できます。' versions: fpt: '*' ghec: '*' @@ -9,5 +9,11 @@ children: - /about-billing-for-github-codespaces - /viewing-your-github-codespaces-usage - /managing-the-spending-limit-for-github-codespaces +ms.openlocfilehash: 869239aefd5a2d244e7ff70735ad814802ed2616 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159094' --- diff --git a/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces.md b/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces.md new file mode 100644 index 0000000000..cbef34d524 --- /dev/null +++ b/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces.md @@ -0,0 +1,86 @@ +--- +title: GitHub Codespaces の使用制限の管理 +intro: '{% data variables.product.prodname_github_codespaces %} に対して使用制限を設定できます。' +shortTitle: Spending limit +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Enterprise + - Organizations + - Spending limits + - User account + - Billing +redirect_from: + - /billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces + - /billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces +ms.openlocfilehash: 87dd5204bb41ddaef911562cfb4662125e04139a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160299' +--- +## {% data variables.product.prodname_github_codespaces %} の使用制限について + +{% data reusables.codespaces.codespaces-free-for-personal-intro %} 詳細については、「[{% data variables.product.prodname_github_codespaces %} の課金について](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」を参照してください。 + +{% data reusables.codespaces.codespaces-spending-limit-requirement %} {% data reusables.codespaces.codespaces-monthly-billing %} + +使用制限に達した場合、それ以上新しい codespace を作成できなくなり、既存の codespace も起動できなくなります。 まだ実行されている既存の codespace は間もなくシャットダウンされますが、使用制限に達した後は使用量に対して課金されません。 + +{% ifversion ghec %} +## Azureサブスクリプションの利用 +Microsoft Enterprise Agreement を通じて {% data variables.product.prodname_enterprise %} を購入した場合、Azure サブスクリプション ID を Enterprise アカウントに接続して、{% data variables.product.prodname_github_codespaces %} の使用を有効にして支払うことができます。 詳細については、「[Azure サブスクリプションを Enterprise に接続する](/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise)」を参照してください。 +{% endif %} + +## 個人アカウントの {% data variables.product.prodname_github_codespaces %} の使用制限の管理 + +自分の個人アカウントの {% data variables.product.prodname_github_codespaces %} の使用制限を設定できます。 + +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.billing_plans %} {% data reusables.dotcom_billing.manage-spending-limit %} {% data reusables.codespaces.monthly-spending-limit-codespaces %} {% data reusables.dotcom_billing.update-spending-limit %} + +## 組織アカウントの {% data variables.product.prodname_github_codespaces %} の使用制限の管理 + +組織の {% data variables.product.prodname_github_codespaces %} については、組織所有者と支払いマネージャーが使用制限を管理できます。 + +{% note %} + +**注**: エンタープライズ アカウントが所有する組織は、エンタープライズ設定で指定されているため、独自の使用制限を指定することはできません。 + +{% endnote %} + +{% data reusables.organizations.billing-settings %} {% data reusables.dotcom_billing.manage-spending-limit %} {% data reusables.codespaces.monthly-spending-limit-codespaces %} {% data reusables.dotcom_billing.update-spending-limit %} + +{% ifversion ghec %} +## エンタープライズ アカウントの {% data variables.product.prodname_github_codespaces %} の使用制限の管理 + +エンタープライズ アカウントの {% data variables.product.prodname_github_codespaces %} の使用制限は、エンタープライズ所有者と支払いマネージャーが管理できます。 + +{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.billing-tab %} +1. **[使用制限]** をクリックします。 + + ![[使用制限] タブ](/assets/images/help/settings/spending-limit-tab-enterprise.png) + +{% data reusables.codespaces.monthly-spending-limit-codespaces %} {% data reusables.dotcom_billing.update-spending-limit %} {% endif %} + +## 利用上限に達した際の変更のエクスポート + +{% data reusables.codespaces.exporting-changes %} + +## 使用状況の管理と利用上限のメール通知 + +メール通知は、利用量がアカウントの使用制限の 75%、90%、100% に達したときに、アカウント オーナーと支払いマネージャーに送信されます。 + +これらの通知は、[課金とプラン/月単位の使用制限] ページの下部に移動し、 **[使用制限アラート]** チェックボックスをオフにすることで、いつでもオフにすることができます。 + +個人アカウントの場合のみ、個人アカウントに含まれる無料使用の 75%、90%、100% を使用したときに送信されるメール通知をオフにすることもできます。 これを行うには、 **[含まれているリソースのアラート]** チェック ボックスをオフにします。 + +![支払いのメール通知設定のスクリーンショット](/assets/images/help/codespaces/codespaces-spending-limit-notifications.png) + +## 参考資料 + +- 「[コンピューターの種類へのアクセスを制限する](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)」 +- [Organization で {% data variables.product.prodname_github_codespaces %} のコストを管理する](/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization) diff --git a/translations/ja-JP/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md b/translations/ja-JP/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md index dcdfa5e6df..7ce4b006b3 100644 --- a/translations/ja-JP/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md +++ b/translations/ja-JP/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md @@ -57,15 +57,25 @@ For example, if your organization uses {% data variables.product.prodname_team % At the end of the month, {% data variables.product.prodname_dotcom %} rounds your data transfer to the nearest GB. -{% data variables.product.prodname_dotcom %} calculates your storage usage for each month based on hourly usage during that month. For example, if you use 3 GB of storage for 10 days of March and 12 GB for 21 days of March, your storage usage would be: +{% data variables.product.prodname_dotcom %} calculates your storage usage for each month based on hourly usage per GB during that month. For example, if you use 3 GB of storage for 10 days of March and 12 GB for 21 days of March, your storage usage would be: - 3 GB x 10 days x (24 hours per day) = 720 GB-Hours - 12 GB x 21 days x (24 hours per day) = 6,048 GB-Hours -- 720 GB-Hours + 6,048 GB-Hours = 6,768 GB-Hours +- 720 GB-Hours + 6,048 GB-Hours = 6,768 total GB-Hours - 6,768 GB-Hours / (744 hours per month) = 9.0967 GB-Months At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB. Therefore, your storage usage for March would be 9.097 GB. +You can also use this calculation in the middle of a billing cycle, to estimate what your total usage might be for the month. For example, if you have an organization that uses {% data variables.product.prodname_team %}, which provides 2 GB of free storage, and you use 0 GB for the first 5 days of April, 1.5 GB for the following 10 days, and you plan to use 3 GB for the last 15 days of the billing cycle, your projected storage usage for the month would be: + +- 0 GB x 5 days x (24 hours per day) = 0 GB-Hours +- 0.5 GB x 10 days x (24 hours per day) = 120 GB-Hours +- 3 GB x 15 days x (24 hours per day) = 1080 GB-Hours +- 0 GB-Hours + 120 GB-Hours + 1080 GB-Hours = 1200 total GB-Hours +- 1200 GB-Hours / (744 hours per month) = 1.6 GB-Months + +The projected 1.6 GB of storage usage for the month would not exceed your 2 GB limit, even though your actual storage amount briefly exceeded 2 GB. + Your {% data variables.product.prodname_registry %} usage shares your account's existing billing date, payment method, and receipt. {% data reusables.dotcom_billing.view-all-subscriptions %} {% data reusables.user-settings.context_switcher %} @@ -74,6 +84,12 @@ Your {% data variables.product.prodname_registry %} usage shares your account's {% data reusables.package_registry.packages-spending-limit-detailed %} -For information on managing and changing your account's spending limit, see "[Managing your spending limit for {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/managing-your-spending-limit-for-github-packages)." +To prevent exceeding your spending limit, {% data variables.product.prodname_dotcom %} checks your storage consumption continuously throughout the month by looking at your current usage and calculating what your projected usage will be at the end of the month if no changes are made before that time. If at any point during the billing cycle your projected monthly usage exceeds your spending limit, both {% data variables.product.prodname_registry %} and {% data variables.product.prodname_actions %} will be disabled to prevent overages. -{% data reusables.dotcom_billing.actions-packages-unpaid-account %} +You should set a spending limit that will cover your maximum projected storage usage at any given point in the billing cycle. For example, imagine you have an organization that uses {% data variables.product.prodname_team %}, and you set a spending limit of $50 USD. {% data variables.product.prodname_team %} provides 2 GB of free storage. For any storage you use over that amount, {% data variables.product.prodname_dotcom %} will charge $0.008 USD per GB per day, or approximately $0.25 USD per GB for a 31-day month. That means the $50 spending limit you set will pay for an extra 200 GB of storage in that period. If on day ten of the billing cycle you reach 202 GB of storage, the next push of a package or {% data variables.product.prodname_actions %} artifact will fail, because you have reached the maximum storage amount that can be paid for by your spending limit in this billing cycle, even if your average consumption for the period is below 202 GB. + +To avoid reaching your spending limit in the current billing cycle, you can delete some of your current storage usage to free up projected usage for the rest of the month. This method is more effective toward the beginning of a billing cycle. The closer you get to the end of a billing cycle, the less impact this method will have on projected monthly usage. + +For more information about managing and changing your account's spending limit, see "[Managing your spending limit for {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/managing-your-spending-limit-for-github-packages)." + +{% data reusables.dotcom_billing.actions-packages-unpaid-account %} \ No newline at end of file diff --git a/translations/ja-JP/content/billing/managing-billing-for-your-github-account/downgrading-your-github-subscription.md b/translations/ja-JP/content/billing/managing-billing-for-your-github-account/downgrading-your-github-subscription.md index 28bbd81e9b..c9a3a2cc24 100644 --- a/translations/ja-JP/content/billing/managing-billing-for-your-github-account/downgrading-your-github-subscription.md +++ b/translations/ja-JP/content/billing/managing-billing-for-your-github-account/downgrading-your-github-subscription.md @@ -1,6 +1,6 @@ --- -title: Downgrading your GitHub subscription -intro: 'You can downgrade the subscription for any type of account on {% data variables.location.product_location %} at any time.' +title: GitHub プランをダウングレードする +intro: '{% data variables.location.product_location %} のいずれの種類のアカウントでも、いつでもサブスクリプションをダウングレードできます。' redirect_from: - /github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription - /articles/downgrading-your-personal-account-s-billing-plan @@ -27,79 +27,83 @@ topics: - Repositories - User account shortTitle: Downgrade subscription +ms.openlocfilehash: e302fb715fc2937c7ed056b813b073a66a7cc1fa +ms.sourcegitcommit: fdc4466e89467a7b13239e26c6042dc1428946b6 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163785' --- -## Downgrading your {% data variables.product.product_name %} subscription +## {% data variables.product.product_name %}プランのダウングレード -When you downgrade your personal account or organization's subscription, pricing and account feature changes take effect on your next billing date. Changes to your paid personal account or organization subscription does not affect subscriptions or payments for other paid {% data variables.product.prodname_dotcom %} features. For more information, see "[How does upgrading or downgrading affect the billing process?](/articles/how-does-upgrading-or-downgrading-affect-the-billing-process)." +個人アカウントまたは Organization のサブスクリプションをダウングレードした場合、価格とアカウント機能の変更は次の請求日から反映されます。 有料の個人アカウントまたは Organization サブスクリプションを変更しても、他の有料 {% data variables.product.prodname_dotcom %} 機能のサブスクリプションや支払いには影響しません。 詳細については、「[How does upgrading or downgrading affect the billing process? (アップグレードまたはダウングレードは課金プロセスにどのように影響しますか?)](/articles/how-does-upgrading-or-downgrading-affect-the-billing-process)」を参照してください。 -## Downgrading your personal account's subscription +## 個人アカウントのサブスクリプションをダウングレードする -If you downgrade your personal account from {% data variables.product.prodname_pro %} to {% data variables.product.prodname_free_user %}, the account will lose access to advanced code review tools on private repositories. {% data reusables.gated-features.more-info %} +個人アカウントを {% data variables.product.prodname_pro %} から {% data variables.product.prodname_free_user %} にダウンロードする場合、そのアカウントは、非公開リポジトリの高度なコード レビュー ツールへのアクセスを失います。 {% data reusables.gated-features.more-info %} -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.billing_plans %} -1. Under "Current plan", use the **Edit** drop-down and click **Downgrade to Free**. - ![Downgrade to free button](/assets/images/help/billing/downgrade-to-free.png) -5. Read the information about the features your personal account will no longer have access to on your next billing date, then click **I understand. Continue with downgrade**. - ![Continue with downgrade button](/assets/images/help/billing/continue-with-downgrade.png) +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.billing_plans %} +1. [現在のプラン] の **[編集]** ドロップダウンを使用して、 **[無料にダウングレード]** をクリックします。 + ![[無料にダウングレード] ボタン](/assets/images/help/billing/downgrade-to-free.png) +5. 次回の請求日に、ご自分の個人アカウントでアクセスできなくなる機能に関する情報を読み、 **[わかりました。ダウングレードを続けます]** をクリックします。 + ![[ダウングレードを続ける] ボタン](/assets/images/help/billing/continue-with-downgrade.png) -If you published a {% data variables.product.prodname_pages %} site in a private repository and added a custom domain, remove or update your DNS records before downgrading from {% data variables.product.prodname_pro %} to {% data variables.product.prodname_free_user %}, to avoid the risk of a domain takeover. For more information, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)." +プライベートリポジトリに {% data variables.product.prodname_pages %} サイトを公開し、カスタムドメインを追加した場合、ドメイン乗っ取りのリスクを回避するため、{% data variables.product.prodname_pro %} から {% data variables.product.prodname_free_user %} にダウングレードする前に DNS レコードを削除または更新します。 詳細については、「[{% data variables.product.prodname_pages %} サイトのカスタム ドメインを管理する](/articles/managing-a-custom-domain-for-your-github-pages-site)」を参照してください。 -## Downgrading your organization's subscription +## Organizationのプランをダウングレードする {% data reusables.dotcom_billing.org-billing-perms %} -If you downgrade your organization from {% data variables.product.prodname_team %} to {% data variables.product.prodname_free_team %} for an organization, the account will lose access to advanced collaboration and management tools for teams. +Organizationを{% data variables.product.prodname_team %}から{% data variables.product.prodname_free_team %}にダウングレードした場合、そのアカウントはチームの高度なコラボレーションおよび管理ツールにはアクセスできなくなります。 -If you downgrade your organization from {% data variables.product.prodname_ghe_cloud %} to {% data variables.product.prodname_team %} or {% data variables.product.prodname_free_team %}, the account will lose access to advanced security, compliance, and deployment controls. {% data reusables.gated-features.more-info %} +Organizationを{% data variables.product.prodname_ghe_cloud %}から{% data variables.product.prodname_team %}または{% data variables.product.prodname_free_team %}にダウングレードした場合、そのアカウントは高度なセキュリティ、コンプライアンス、およびデプロイメントコントロールにアクセスできなくなります。 {% data reusables.gated-features.more-info %} {% note %} -**Notes:** - - If your organization is owned by an enterprise account, billing cannot be managed at the organization level. To downgrade, you must remove the organization from the enterprise account first. For more information, see "[Removing organizations from your enterprise](/enterprise-cloud@latest/admin/user-management/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise)." - - If you're currently trialing {% data variables.product.prodname_ghe_cloud %}, and you don't purchase {% data variables.product.prodname_enterprise %} before the trial ends, your organization will be automatically downgraded to {% data variables.product.prodname_free_team %} or {% data variables.product.prodname_team %}. For more information, see "[Setting up a trial of {% data variables.product.prodname_ghe_cloud %}](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud#finishing-your-trial)." +**注:** + - 組織がエンタープライズ アカウントによって所有されている場合、課金を組織レベルで管理することはできません。 ダウングレードするには、まずエンタープライズ アカウントから組織を削除する必要があります。 詳しくは、「[エンタープライズから組織を削除する](/enterprise-cloud@latest/admin/user-management/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise)」を参照してください。 + - 現在 {% data variables.product.prodname_ghe_cloud %} の試用版を使っていて、試用版の終了前に {% data variables.product.prodname_enterprise %} を購入されない場合は、ご自分の組織は自動的に {% data variables.product.prodname_free_team %} または {% data variables.product.prodname_team %} にダウングレードされます。 詳細については、「[{% data variables.product.prodname_ghe_cloud %} の試用版を設定する](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud#finishing-your-trial)」を参照してください。 {% endnote %} {% data reusables.organizations.billing-settings %} -1. Under "Current plan", use the **Edit** drop-down and click the downgrade option you want. - ![Downgrade button](/assets/images/help/billing/downgrade-option-button.png) -{% data reusables.dotcom_billing.confirm_cancel_org_plan %} +1. [現在のプラン] の下で、 **[編集]** ドロップダウンから必要なダウングレード オプションをクリックします。 + ![[ダウングレード] ボタン](/assets/images/help/billing/downgrade-option-button.png) {% data reusables.dotcom_billing.confirm_cancel_org_plan %} -## Downgrading an organization's subscription with legacy per-repository pricing +## 従来のリポジトリ単位の支払いを使用しているOrganizationのプランをダウングレードする {% data reusables.dotcom_billing.org-billing-perms %} -{% data reusables.dotcom_billing.switch-legacy-billing %} For more information, see "[Switching your organization from per-repository to per-user pricing](/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription#switching-your-organization-from-per-repository-to-per-user-pricing)." +{% data reusables.dotcom_billing.switch-legacy-billing %} 詳しくは、「[Organization をリポジトリごとからユーザーごとに切り替える](/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription#switching-your-organization-from-per-repository-to-per-user-pricing)」をご覧ください。 {% data reusables.organizations.billing-settings %} -5. Under "Subscriptions", select the "Edit" drop-down, and click **Edit plan**. - ![Edit Plan dropdown](/assets/images/help/billing/edit-plan-dropdown.png) -1. Under "Billing/Plans", next to the plan you want to change, click **Downgrade**. - ![Downgrade button](/assets/images/help/billing/downgrade-plan-option-button.png) -1. Enter the reason you're downgrading your account, then click **Downgrade plan**. - ![Text box for downgrade reason and downgrade button](/assets/images/help/billing/downgrade-plan-button.png) +5. [サブスクリプション] の [編集] ドロップダウンから **[プランの編集]** をクリックします。 + ![[プランの編集] ドロップダウン](/assets/images/help/billing/edit-plan-dropdown.png) +1. [請求/プラン] で、変更するプランの横にある **[ダウングレード]** をクリックします。 + ![ダウングレード ボタン](/assets/images/help/billing/downgrade-plan-option-button.png) +1. アカウントをダウングレードする理由を入力し、 **[プランのダウングレード]** をクリックします。 + ![ダウングレードの理由を入力するテキストボックスと [Downgrade] ボタン](/assets/images/help/billing/downgrade-plan-button.png) -## Removing paid seats from your organization +## Organization から有料シートを削除する -To reduce the number of paid seats your organization uses, you can remove members from your organization or convert members to outside collaborators and give them access to only public repositories. For more information, see: -- "[Removing a member from your organization](/articles/removing-a-member-from-your-organization)" -- "[Converting an organization member to an outside collaborator](/articles/converting-an-organization-member-to-an-outside-collaborator)" -- "[Managing an individual's access to an organization repository](/articles/managing-an-individual-s-access-to-an-organization-repository)" +Organization が使用する有料シート数を減らすには、Organization からメンバーを削除するか、メンバーを外部コラボレーターに変更してアクセス権をパブリックリポジトリに限定する方法があります。 詳細については、次を参照してください。 +- 「[Organization からメンバーを削除する](/articles/removing-a-member-from-your-organization)」 +- 「[Organization メンバーを外部コラボレーターに変換する](/articles/converting-an-organization-member-to-an-outside-collaborator)」 +- [Organization のリポジトリへの個人のアクセスを管理する](/articles/managing-an-individual-s-access-to-an-organization-repository) {% data reusables.organizations.billing-settings %} -1. Under "Current plan", use the **Edit** drop-down and click **Remove seats**. - ![remove seats dropdown](/assets/images/help/billing/remove-seats-dropdown.png) -1. Under "Remove seats", select the number of seats you'd like to downgrade to. - ![remove seats option](/assets/images/help/billing/remove-seats-amount.png) -1. Review the information about your new payment on your next billing date, then click **Remove seats**. - ![remove seats button](/assets/images/help/billing/remove-seats-button.png) +1. [現在のプラン] の **[編集]** ドロップダウンを使用して、 **[シートの削除]** をクリックします。 + ![[シートの削除] ドロップダウン](/assets/images/help/billing/remove-seats-dropdown.png) +1. [Remove seats] の下でダウングレードするシート数を選択します。 + ![[シートの削除] オプション](/assets/images/help/billing/remove-seats-amount.png) +1. 次回請求日に新しい支払いに関する情報を確認し、 **[シートの削除]** をクリックします。 + ![[シートの削除] ボタン](/assets/images/help/billing/remove-seats-button.png) -## Further reading +## 参考資料 -- "[{% data variables.product.prodname_dotcom %}'s products](/articles/github-s-products)" -- "[How does upgrading or downgrading affect the billing process?](/articles/how-does-upgrading-or-downgrading-affect-the-billing-process)" -- "[About billing on {% data variables.product.prodname_dotcom %}](/articles/about-billing-on-github)." -- "[About per-user pricing](/articles/about-per-user-pricing)" +- 「[{% data variables.product.prodname_dotcom %} の製品](/articles/github-s-products) +- 「[アップグレードやダウングレードは支払い処理にどのように影響しますか?](/articles/how-does-upgrading-or-downgrading-affect-the-billing-process)」 +- "[{% data variables.product.prodname_dotcom %} の支払いについて](/articles/about-billing-on-github)" +- "[ユーザーごとの価格付けについて](/articles/about-per-user-pricing)" diff --git a/translations/ja-JP/content/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise.md b/translations/ja-JP/content/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise.md index 7bc6979232..7a52a681b0 100644 --- a/translations/ja-JP/content/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise.md +++ b/translations/ja-JP/content/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise.md @@ -22,7 +22,14 @@ For privacy reasons, enterprise owners cannot directly access the details of use ## About the calculation of consumed licenses -{% data variables.product.company_short %} bills for each person who uses deployments of {% data variables.product.prodname_ghe_server %}, is a member of one of your organizations on {% data variables.product.prodname_ghe_cloud %}, or is a {% data variables.visual_studio.prodname_vs_subscriber %}. For more information about the people in your enterprise who consume a license, see "[About per-user pricing](/billing/managing-billing-for-your-github-account/about-per-user-pricing)." +If a user meets one or more of the following conditions, {% data variables.product.company_short %} bills for the user. + +- The user utilizes deployments of {% data variables.product.prodname_ghe_server %}. +- The user is a member of one of your organizations on {% data variables.product.prodname_ghe_cloud %}. +- The user has write access to one of your organization's private repositories. +- The user is a {% data variables.visual_studio.prodname_vs_subscriber %}. + +Invitations for these roles will consume a license until the invitation is accepted or expires. For more information about the people in your enterprise who consume a license, see "[About per-user pricing](/billing/managing-billing-for-your-github-account/about-per-user-pricing)." For each user to consume a single seat regardless of how many deployments they use, you must synchronize license usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Syncing license usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}](/billing/managing-your-license-for-github-enterprise/syncing-license-usage-between-github-enterprise-server-and-github-enterprise-cloud)." diff --git a/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md b/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md index 0e0910c214..f4241ca377 100644 --- a/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md +++ b/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md @@ -62,7 +62,7 @@ You can also enable or disable {% data variables.product.prodname_dependabot_sec You can override the default behavior of {% data variables.product.prodname_dependabot_security_updates %} by adding a dependabot.yml file to your repository. For more information, see "[Configuration options for the dependabot.yml file](/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file)." -If you only require security updates and want to exclude version updates, you can set `open-pull-request-limit` to `0` in order to prevent version updates for a given `package-ecosystem`. For more information, see "[`open-pull-request-limit`](/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file#open-pull-requests-limit)." +If you only require security updates and want to exclude version updates, you can set `open-pull-requests-limit` to `0` in order to prevent version updates for a given `package-ecosystem`. For more information, see "[`open-pull-requests-limit`](/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file#open-pull-requests-limit)." ``` # Example configuration file that: diff --git a/translations/ja-JP/content/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities.md b/translations/ja-JP/content/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities.md new file mode 100644 index 0000000000..d3fe8740df --- /dev/null +++ b/translations/ja-JP/content/code-security/security-advisories/guidance-on-reporting-and-writing/about-coordinated-disclosure-of-security-vulnerabilities.md @@ -0,0 +1,98 @@ +--- +title: セキュリティ脆弱性の調整された開示について +intro: 脆弱性の開示は、セキュリティの報告者とリポジトリメンテナの調整された取り組みです。 +redirect_from: + - /code-security/security-advisories/about-coordinated-disclosure-of-security-vulnerabilities + - /code-security/repository-security-advisories/about-coordinated-disclosure-of-security-vulnerabilities + - /code-security/security-advisories/repository-security-advisories/about-coordinated-disclosure-of-security-vulnerabilities +miniTocMaxHeadingLevel: 3 +versions: + fpt: '*' + ghec: '*' +type: overview +topics: + - Security advisories + - Vulnerabilities +shortTitle: Coordinated disclosure +ms.openlocfilehash: 5f3e9983b3efcca68cb1b5c0bc5891a21f276216 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160015' +--- +## 業界における脆弱性の開示について + +{% data reusables.security-advisory.disclosing-vulnerabilities %} + +脆弱性の初期の報告は非公開で行われ、完全な詳細はメンテナが問題を認め、理想的には対策もしくはパッチが利用可能になり、場合によってはパッチがインストールできるようさらに時間をおいてから公開されます。 詳細については、OWASP Cheat Sheet Series (OWASP チート シート シリーズ) の Web サイトの [「OWASP Cheat Sheet Series」 (OWASP チート シート シリーズ) の「Vulnerability Disclosure」 (脆弱性の開示) ](https://cheatsheetseries.owasp.org/cheatsheets/Vulnerability_Disclosure_Cheat_Sheet.html#commercial-and-open-source-software)を参照してください。 + +### 脆弱性報告者のためのベストプラクティス + +脆弱性をメンテナに非公開で報告するのは良いやり方です。 可能なら、脆弱性報告者は以下を避けることをおすすめします。 +- メンテナに対策の機会を与えることなく脆弱性を公開してしまうこと。 +- メンテナをバイパスしてしまうこと。 +- コードの修正バージョンが利用可能になる前に脆弱性を公開してしまうこと。 +- パブリックなバウンティプログラムが存在しない場合に、問題の報告に補償がなされると期待すること。 + +メンテナに連絡を取ろうとしてレスポンスがなかったり、連絡は取れたものの公開をあまりに長く待つよう頼まれたなら、一定期間後に脆弱性報告者が脆弱性を公開することは許容できます。 + +脆弱性の報告者は、報告のプロセスの一部として、開示ポリシーの条件を明確に述べることをおすすめします。 脆弱性報告者が厳密なポリシーに従っていないばあいでも、意図的な脆弱性の開示の時期についてメンテナが明確な期待を持てるようにするのは良い考えです。 開示ポリシーの例については、GitHub Security Lab の Web サイトの「[Security Lab's disclosure policy](https://securitylab.github.com/advisories#policy)」 (Security Lab の開示ポリシー) を参照してください。 + +### メンテナのためのベストプラクティス + +メンテナは、脆弱性の報告をいつどのように受けたいかを明確に示しておくのが良いでしょう。 この情報が明確に利用できない場合、脆弱性報告者はどのように連絡をすればいいか分からず、gitのコミット履歴から開発者のメールアドレスを取り出して適切なセキュリティに関する連絡先を見つけようとするかもしれません。 これは、不和、報告の喪失、未解決の報告の公開につながるかもしれません。 + +メンテナは、適時に脆弱性を開示すべきです。 リポジトリにセキュリティ脆弱性があるなら、以下のようにすることをおすすめします。 +- 脆弱性は、レスポンスにおいても開示においても単純なバグとしてよりもセキュリティの問題として対処してください。 たとえば、リリースノートではその問題をセキュリティ脆弱性として明示的に言及する必要があります。 +- 脆弱性報告を受け取ったことは、たとえすぐに調査するためのリソースがない場合でも、できるだけ早く認めてください。 これはあなたが迅速に対応して行動するというメッセージを送ることになり、あなたと脆弱性報告者との間のそれ以外のやりとりに肯定的なトーンが設定されます。 +- 報告のインパクトと正確性を検証する際には、脆弱性報告者にも関わってもらってください。 おそらく脆弱性の報告者は、すでにその脆弱性を様々なシナリオの中で考慮するのに時間をかけているでしょう。その中には、あなたが自分では考えていなかったものがあるかもしれません。 +- 脆弱性の報告者が提供してくれた懸念点とアドバイスを慎重に考慮に入れて、適切と思われる方法で問題に対処してください。 脆弱性の報告者は、しばしば特定のコーナーケースや対処のバイパスに関する知識を持っており、それらはセキュリティ研究のバックグラウンドなしでは簡単に見逃してしまうものです。 +- 発見されたことを評価する際には、常に脆弱性の報告者に感謝を示してください。 +- できるかぎり早い修正の公開を目指してください。 +- 脆弱性を開示する際には、広汎なエコシステムがその問題と対策を認識するようにしてください。 認識されたセキュリティの問題がプロジェクトの現在の開発ブランチで修正されながら、そのコミットあるいはそれ以降のリリースがセキュリティ修正あるいはリリースとして明示的に示されていない場合が珍しくありません。 これによって、下流の利用者に問題が生じることがあります。 + +セキュリティ脆弱性の詳細を開会しても、メンテナが悪く見えることはありません。 セキュリティ脆弱性はソフトウェアのあらゆるところに存在し、ユーザはコード中のセキュリティ脆弱性を開示するための明確な確立されたプロセスを持つメンテナを信頼します。 + +## {% data variables.product.prodname_dotcom %}上のプロジェクトの脆弱性の報告と開示について + +{% data variables.product.prodname_dotcom %} で使うことができるプロセスは 2 つあります。 + +- 標準プロセス: 脆弱性報告者は、リポジトリのセキュリティ ポリシーに記載されている連絡先情報を使って、リポジトリ メンテナと連絡を取ります。 リポジトリ メンテナは、必要に応じて、下書きのリポジトリ アドバイザリを作成します。 +- プライベート脆弱性レポート: 脆弱性報告者は、下書きのリポジトリ アドバイザリを提案して、その結果の詳細を提示することで、リポジトリ メンテナに直接、非公開で脆弱性の詳細を開示します。 + +### 標準プロセス + +{% data variables.product.prodname_dotcom_the_website %}上のプロジェクトの脆弱性の報告と開示のプロセスは以下のようになります。 + + あなたが脆弱性の報告したいと考えている人（たとえばセキュリティ研究者）なら、まず関連するリポジトリにセキュリティポリシーがあるかをチェックしてください。 詳細については、「[セキュリティ ポリシーについて](/code-security/getting-started/adding-a-security-policy-to-your-repository#about-security-policies)」を参照してください。 セキュリティポリシーがあるなら、そのリポジトリのセキュリティチームに連絡する前に、それに従ってプロセスを理解してください。 + + セキュリティポリシーがないなら、メンテナへの非公開のコミュニケーション方法を確立するための最も効率的な方法は、望ましいセキュリティの連絡先を尋ねるIssueを作成することです。 そのIssueはすぐに公に見ることができるようになるので、そこにはバグに関する情報は含めないようにするべきであることには注意してください。 コミュニケーションが確立できたら、将来的に利用できるよう、セキュリティポリシーを規定してもらうメンテナに提案できます。 + +{% note %} + +**注**: _npm のみ_ - npm パッケージのマルウェアに関する報告を受けた場合は、お客様個人にご連絡させていただきます。 あなたが適時問題に対応しない場合、私たちはその問題を開示します。 詳細については、npm Docs の Web サイトの「[eporting malware in an npm package](https://docs.npmjs.com/reporting-malware-in-an-npm-package)」 (npm パッケージ内のマルウェアの報告) を参照してください。 + +{% endnote %} + + {% data variables.product.prodname_dotcom_the_website %}でセキュリティ脆弱性を発見したら、私たちの調整された開示プロセスを通じてその脆弱性を報告してください。 詳細については、「[{% data variables.product.prodname_dotcom %} セキュリティ アドバイザリの概要](https://bounty.github.com/)」を参照してください。 + + あなたがメンテナなら、リポジトリのセキュリティポリシーを設定するか、たとえばプロジェクトのREADMEファイルでセキュリティの報告方法を明確にしておくことによって、このパイプラインの開始時点からプロセスの所有権を取ることができます。 セキュリティ ポリシーの追加の詳細については、「[セキュリティ ポリシーについて](/code-security/getting-started/adding-a-security-policy-to-your-repository#about-security-policies)」を参照してください。 セキュリティポリシーがない場合、セキュリティの報告者はおそらくあなたにメールするか、非公開であなたに連絡しようとするでしょう。 あるいは、誰かがセキュリティの問題の詳細を含む（パブリックな）Issueをオープンするかもしれません。 + + メンテナとしてコード中の脆弱性を開示するために、まずは{% data variables.product.prodname_dotcom %}でパッケージのリポジトリにドラフトのセキュリティアドバイザリを作成します。 {% data reusables.security-advisory.security-advisory-overview %} 詳細については、「[リポジトリのセキュリティ アドバイザリについて](/code-security/repository-security-advisories/about-github-security-advisories-for-repositories)」を参照してください。 + + 開始するには、「[リポジトリ セキュリティ アドバイザリの作成](/code-security/repository-security-advisories/creating-a-repository-security-advisory)」を参照してください。 + +### プライベート脆弱性レポート + +{% data reusables.security-advisory.private-vulnerability-reporting-beta %} + +{% data reusables.security-advisory.private-vulnerability-reporting-enable %} + + プライベート脆弱性レポートは、{% data variables.product.prodname_dotcom %} 内で脆弱性報告者がリポジトリ メンテナに対してセキュリティ リスクを非公開で開示する簡単な方法であり、issue のリポジトリ メンテナへの通知がすぐに行われます。 セキュリティ研究者とリポジトリ メンテナについて詳しくは、「[セキュリティ脆弱性の非公開の報告](/code-security/security-advisories/guidance-on-reporting-and-writing/privately-reporting-a-security-vulnerability)」と「[非公開で報告されたセキュリティ脆弱性の管理](/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities)」をそれぞれご覧ください。 + +{% note %} + +**メモ**: 脆弱性を含むリポジトリでプライベート脆弱性レポートが有効になっていない場合、セキュリティ研究者とリポジトリ メンテナの両方が、上記の「[標準プロセス](#standard-process)」セクションで説明されている指示に従う必要があります。 + +{% endnote %} diff --git a/translations/ja-JP/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md b/translations/ja-JP/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md new file mode 100644 index 0000000000..d6daeb7614 --- /dev/null +++ b/translations/ja-JP/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md @@ -0,0 +1,45 @@ +--- +title: Managing privately reported security vulnerabilities +intro: Repository maintainers can manage security vulnerabilities that have been privately reported to them by security reseachers for repositories where private vulnerability reporting is enabled. +permissions: 'Anyone with admin permissions to a repository can see, review, and manage privately-reported vulnerabilities for the repository.' +versions: + fpt: '*' + ghec: '*' +type: how_to +miniTocMaxHeadingLevel: 3 +topics: + - Security advisories + - Vulnerabilities +shortTitle: Manage vulnerability reports +--- + +{% data reusables.security-advisory.private-vulnerability-reporting-beta %} + +{% data reusables.security-advisory.private-vulnerability-reporting-enable %} + +## About privately reporting a security vulnerability + +Private vulnerability reporting makes it easy for security researchers to report vulnerabilities directly to you using a simple form. + +When a security researcher reports a vulnerability privately, you are notified and can choose to either accept it, ask more questions, or reject it. If you accept the report, you're ready to collaborate on a fix for the vulnerability in private with the security researcher. + +## Managing security vulnerabilities that are privately reported + +{% data variables.product.prodname_dotcom %} notifies repository maintainers when security researchers privately report vulnerabilities in their repository, and sends notifications if maintainers watch the repository or if they have notifications enabled for the repository. For more information, see "[Configuring notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-security %} +{% data reusables.repositories.sidebar-advisories %} +1. Click the advisory you want to review. An advisory that is privately reported will have a status of `Needs triage`. + + ![Screenshot showing an example of advisory list](/assets/images/help/security/advisory-list.png) + +2. Carefully review the report. You can: + - Collaborate with the security researcher on a patch in private, by clicking **Start a temporary private fork**. This gives you a place for further discussions with the contributor without changing the status of the proposed advisory from `Needs triage`. + - Accept the vulnerability report as a draft advisory on {% data variables.product.prodname_dotcom %}, by clicking **Accept and open as draft**. If you choose this option: + - This doesn't make the report public. + - The report becomes a draft repository security advisory and you can work on it in the same way as any draft advisory that you create. + For more information on security advisories, see "[About repository security advisories](/code-security/security-advisories/repository-security-advisories/about-repository-security-advisories)." + - Reject the report by clicking **Close security advisory**. Where possible, you should add a comment explaining why you don't consider the report a security risk before you close the advisory. + + ![Screenshot showing the options available to the repository maintainer when reviewing an externally submitted vulnerability report](/assets/images/help/security/advisory-maintainer-options.png) \ No newline at end of file diff --git a/translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review.md b/translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review.md index 0f6307553b..c46eaf0b59 100644 --- a/translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review.md +++ b/translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review.md @@ -1,6 +1,6 @@ --- -title: Configuring dependency review -intro: You can use dependency review to catch vulnerabilities before they are added to your project. +title: 依存関係レビューの構成 +intro: 依存関係レビューを使用して、脆弱性がプロジェクトに追加される前に捕捉できます。 miniTocMaxHeadingLevel: 3 shortTitle: Configure dependency review versions: @@ -15,80 +15,71 @@ topics: - Vulnerabilities - Dependencies - Pull requests +ms.openlocfilehash: b5e5ccb5107cd96d1a88f896fd46d5b948a365cd +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163353' --- - -## About dependency review +## 依存関係の確認について {% data reusables.dependency-review.feature-overview %} -For more information, see "[About dependency review](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)" and "[Reviewing dependency changes in a pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request)." +詳細については、「[依存関係レビューについて](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)」と「[pull request 内の依存関係の変更をレビューする](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request)」を参照してください。 -## About configuring dependency review +## 依存関係レビューの構成について -{% ifversion fpt %} -Dependency review is available in all public repositories in all products and cannot be disabled. Dependency review is available in private repositories owned by organizations that use GitHub Enterprise Cloud and have a license for [{% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security). For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review). +{% ifversion fpt %}依存関係レビューは、すべての製品のすべてのパブリック リポジトリで使用できます。また、無効にすることはできません。 依存関係レビューは、GitHub Enterprise Cloud を使い、[{% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security) のライセンスを持つ組織が所有するプライベート リポジトリで利用できます。 詳細については、[{% data variables.product.prodname_ghe_cloud %} ドキュメント](/enterprise-cloud@latest/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review)を参照してください。 -{% elsif ghec %} -Dependency review is included in {% data variables.product.product_name %} for public repositories. To use dependency review in private repositories owned by organizations, you must have a license for [{% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security) and have the dependency graph enabled. +{% elsif ghec %}依存関係レビューは、パブリック リポジトリの {% data variables.product.product_name %} に含まれています。 組織が所有するプライベート リポジトリで依存関係レビューを使うには、[{% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security) のライセンスがあり、依存関係グラフを有効にする必要があります。 {% data reusables.dependabot.enabling-disabling-dependency-graph-private-repo %} -1. If "{% data variables.product.prodname_GH_advanced_security %}" is not enabled, click **Enable** next to the feature. - ![Screenshot of GitHub Advanced Security feature with "Enable" button emphasized](/assets/images/help/security/enable-ghas-private-repo.png) +1. まだ "{% data variables.product.prodname_GH_advanced_security %}" が有効になっていない場合は、機能の横にある **[Enable]\(有効にする\)** をクリックします。 + ![[Enable]\(有効にする\) ボタンが強調表示された GitHub Advanced Security 機能のスクリーンショット](/assets/images/help/security/enable-ghas-private-repo.png) {% elsif ghes or ghae %} -Dependency review is available when dependency graph is enabled for {% data variables.location.product_location %} and {% data variables.product.prodname_advanced_security %} is enabled for the organization or repository.{% ifversion ghes %} For more information, see "[Enabling {% data variables.product.prodname_GH_advanced_security %} for your enterprise](/admin/code-security/managing-github-advanced-security-for-your-enterprise/enabling-github-advanced-security-for-your-enterprise)."{% endif %} +依存関係の確認は、{% data variables.location.product_location %}に対して依存関係グラフが有効になっており、{% data variables.product.prodname_advanced_security %} が組織またはリポジトリで有効になっている場合に使用できます。{% ifversion ghes %}詳細については、「[エンタープライズで {% data variables.product.prodname_GH_advanced_security %} を有効にする](/admin/code-security/managing-github-advanced-security-for-your-enterprise/enabling-github-advanced-security-for-your-enterprise)」を参照してください。{% endif %} -### Checking if the dependency graph is enabled +### 依存関係グラフが有効になっているかどうかを確認する -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-code-security-and-analysis %} -1. Under "Configure security and analysis features", check if the dependency graph is enabled. -1. If dependency graph is enabled, click **Enable** next to "{% data variables.product.prodname_GH_advanced_security %}" to enable {% data variables.product.prodname_advanced_security %}, including dependency review. The enable button is disabled if your enterprise has no available licenses for {% data variables.product.prodname_advanced_security %}.{% ifversion ghes %} - ![Screenshot of "Code security and analysis" features"](/assets/images/enterprise/3.4/repository/code-security-and-analysis-enable-ghas-3.4.png){% endif %} +{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.navigate-to-code-security-and-analysis %} +1. [Configure security and analysis features]\(セキュリティと分析機能の構成\) で、依存関係グラフが有効になっているかどうかを確認します。 +1. 依存関係グラフが有効である場合は、"{% data variables.product.prodname_GH_advanced_security %}" の横にある **[Enable]\(有効にする\)** をクリックして、依存関係レビューを含む {% data variables.product.prodname_advanced_security %} を有効にします。 エンタープライズに {% data variables.product.prodname_advanced_security %} に使用できるライセンスがない場合、[有効にする] ボタンは無効です。{% ifversion ghes %}!["コードのセキュリティと分析" 機能のスクリーンショット](/assets/images/enterprise/3.4/repository/code-security-and-analysis-enable-ghas-3.4.png){% endif %} {% endif %} {% ifversion dependency-review-action-configuration %} -## About configuring the {% data variables.product.prodname_dependency_review_action %} +## {% data variables.product.prodname_dependency_review_action %} の構成について {% data reusables.dependency-review.dependency-review-action-overview %} -The following configuration options are available. +次の構成オプションを使用できます。 -| Option | Required | Usage | +| オプション | 必須 | 使用法 | |------------------|-------------------------------|--------| -| `fail-on-severity` | Optional | Defines the threshold for level of severity (`low`, `moderate`, `high`, `critical`).
The action will fail on any pull requests that introduce vulnerabilities of the specified severity level or higher. | -{%- ifversion dependency-review-action-licenses %} -| `allow-licenses` | Optional | Contains a list of allowed licenses. You can find the possible values for this parameter in the [Licenses](/rest/licenses) page of the API documentation.
The action will fail on pull requests that introduce dependencies with licenses that do not match the list.|{% endif %} -{%- ifversion dependency-review-action-licenses %} -| `deny-licenses` | Optional | Contains a list of prohibited licenses. You can find the possible values for this parameter in the [Licenses](/rest/licenses) page of the API documentation.
The action will fail on pull requests that introduce dependencies with licenses that match the list.|{% endif %}{% ifversion dependency-review-action-fail-on-scopes %} -| `fail-on-scopes` | Optional | Contains a list of strings representing the build environments you want to support (`development`, `runtime`, `unknown`).
The action will fail on pull requests that introduce vulnerabilites in the scopes that match the list.|{% endif %} -| `allow-ghsas` | Optional | Contains a list of {% data variables.product.prodname_advisory_database %} IDs that can be skipped during detection. You can find the possible values for this parameter in the [{% data variables.product.prodname_advisory_database %}](https://github.com/advisories). | -| `config-file` | Optional | Specifies a path to a configuration file. The configuration file can be local to the repository or a file located in an external repository.| -| `external-repo-token` | Optional | Specifies a token for fetching the configuration file, if the file resides in a private external repository. The token must have read access to the repository.| +| `fail-on-severity` | オプション | 重大度レベル (`low`、`moderate`、`high`、`critical`) のしきい値を定義します。
アクションは、指定した重大度レベル以上の脆弱性を引き起こす pull request で失敗します。 | +{%- ifversion dependency-review-action-licenses %} | `allow-licenses` | 省略可能 | 許可されているライセンスの一覧が含まれています。 このパラメーターに使用できる値は、API ドキュメントの「[ライセンス](/rest/licenses)」のページで確認できます。
このアクションは、list.| と一致しないライセンスを持つ依存関係を導入するプル要求で失敗します。{% endif %} {%- ifversion dependency-review-action-licenses %} | `deny-licenses` |省略可能な|禁止されているライセンスの一覧が含まれています。 このパラメーターに使用できる値は、API ドキュメントの「[ライセンス](/rest/licenses)」のページで確認できます。
アクションは、リストに一致するライセンスを持つ依存関係を導入する pull request で失敗します。|{% endif %}{% ifversion dependency-review-action-fail-on-scopes %} | `fail-on-scopes` | 省略可能 | サポートしたいビルド環境を表す文字列のリストを含めます (`development`、`runtime`、`unknown`)。
アクションは、リストに一致するスコープに脆弱性をもたらす pull request で失敗します。|{% endif %} | `allow-ghsas` | 省略可能 | 検出中にスキップできる {% data variables.product.prodname_advisory_database %} ID のリストを含めます。 このパラメーターに指定できる値は、[{% data variables.product.prodname_advisory_database %}](https://github.com/advisories) で見つけることができます。 | | `config-file` | 省略可能 | 構成ファイルのパスを指定します。 構成ファイルは、リポジトリに対してローカルにすることも、外部リポジトリにあるファイルにすることもできます| | `external-repo-token` | 省略可能 | ファイルがプライベート外部リポジトリに存在する場合に、構成ファイルをフェッチするためのトークンを指定します。 トークンには、リポジトリへの読み取りアクセス権が必要です。| -{% ifversion dependency-review-action-licenses %} -{% tip %} +{% ifversion dependency-review-action-licenses %} {% tip %} -**Tip:** The `allow-licenses` and `deny-licenses` options are mutually exclusive. +**ヒント:** オプション `allow-licenses` と `deny-licenses` は同時に指定できません。 -{% endtip %} -{% endif %} +{% endtip %} {% endif %} -## Configuring the {% data variables.product.prodname_dependency_review_action %} +## {% data variables.product.prodname_dependency_review_action %} の構成 -There are two methods of configuring the {% data variables.product.prodname_dependency_review_action %}: -- Inlining the configuration options in your workflow file. -- Referencing a configuration file in your workflow file. +{% data variables.product.prodname_dependency_review_action %} を構成する方法は 2 つあります。 +- ワークフロー ファイル内に構成オプションをインライン化する。 +- ワークフロー ファイル内で構成オプションを参照する。 -Notice that all of the examples use a short version number for the action (`v3`) instead of a semver release number (for example, `v3.0.8`). This ensures that you use the most recent minor version of the action. -### Using inline configuration to set up the {% data variables.product.prodname_dependency_review_action %} +すべての例で、アクションに対して、semver リリース番号 (`v3.0.8` など) ではなく、短いバージョン番号 (`v3`) が使われています。 これにより、アクションの最新のマイナー バージョンを使うことができます。 +### インライン構成を使って {% data variables.product.prodname_dependency_review_action %} を設定する -1. Add a new YAML workflow to your `.github/workflows` folder. +1. `.github/workflows` フォルダーに新しい YAML ワークフローを追加します。 - {% ifversion ghes %}For `runs-on`, the default label is `self-hosted`. You can replace the default label with the label of any of your runners.{% endif %} + {% ifversion ghes %}`runs-on` の場合、既定のラベルは `self-hosted` です。 既定のラベルは、任意のランナーのラベルに置き換えることができます。{% endif %} ```yaml{:copy} name: 'Dependency Review' on: [pull_request] @@ -106,9 +97,9 @@ Notice that all of the examples use a short version number for the action (`v3`) - name: Dependency Review uses: actions/dependency-review-action@v3 ``` -1. Specify your settings. +1. 必要に応じて設定を変更します。 - This {% data variables.product.prodname_dependency_review_action %} example file illustrates how you can use the available configuration options. + この {% data variables.product.prodname_dependency_review_action %} サンプル ファイルは、利用可能な構成オプションの使用方法を示しています。 ```yaml{:copy} name: 'Dependency Review' on: [pull_request] @@ -146,11 +137,11 @@ Notice that all of the examples use a short version number for the action (`v3`) fail-on-scopes: development, runtime {% endif %} ``` -### Using a configuration file to set up {% data variables.product.prodname_dependency_review_action %} +### 構成ファイルを使って {% data variables.product.prodname_dependency_review_action %} を設定する -1. Add a new YAML workflow to your `.github/workflows` folder and use `config-file` to specify that you are using a configuration file. +1. `.github/workflows` フォルダーに新しい YAML ワークフローを追加し、`config-file` を使って構成ファイルを使用していることを指定します。 - {% ifversion ghes %}For `runs-on`, the default label is `self-hosted`. You can replace the default label with the label of any of your runners.{% endif %} + {% ifversion ghes %}`runs-on` の場合、既定のラベルは `self-hosted` です。 既定のラベルは、任意のランナーのラベルに置き換えることができます。{% endif %} ```yaml{:copy} name: 'Dependency Review' on: [pull_request] @@ -178,9 +169,9 @@ Notice that all of the examples use a short version number for the action (`v3`) # Possible values: Any GitHub token with read access to the private external repository. external-repo-token: 'ghp_123456789abcde' ``` -1. Create the configuration file in the path you have specified. +1. 指定したパスに構成ファイルを作成します。 - This YAML example file illustrates how you can use the available configuration options. + この YAML ファイルの例は、利用可能な構成オプションの使用方法を示しています。 ```yaml{:copy} # Possible values: "critical", "high", "moderate", "low" fail-on-severity: critical @@ -211,5 +202,5 @@ Notice that all of the examples use a short version number for the action (`v3`) - runtime {% endif %} ``` -For further details about the configuration options, see [`dependency-review-action`](https://github.com/actions/dependency-review-action#readme). +構成オプションの詳細については、「[`dependency-review-action`](https://github.com/actions/dependency-review-action#readme)」を参照してください。 {% endif %} diff --git a/translations/ja-JP/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md b/translations/ja-JP/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md index 0f6bc73866..d55a1a0cfe 100644 --- a/translations/ja-JP/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md +++ b/translations/ja-JP/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Disaster recovery for GitHub Codespaces -intro: 'This article describes guidance for a disaster recovery scenario, when a whole region experiences an outage due to major natural disaster or widespread service interruption.' +title: GitHub Codespaces のディザスター リカバリー +intro: この記事では、大規模な自然災害や広範囲にわたるサービスの中断により、地域全体で障害が発生した場合のシステム災害復旧シナリオのガイダンスについて説明します。 versions: fpt: '*' ghec: '*' @@ -9,44 +9,49 @@ topics: shortTitle: Disaster recovery redirect_from: - /codespaces/codespaces-reference/disaster-recovery-for-codespaces +ms.openlocfilehash: 9b892d6a24332e01174c819e2e88a91d1cdf9d65 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158814' --- +当社は、ユーザーが {% data variables.product.prodname_github_codespaces %} をいつでも確実にご利用いただけるよう努力しています。 しかし、当社の管理できる範囲を超えてサービスに影響を及ぼし、計画外のサービスの中断を引き起こす不可抗力が発生する可能性があります。 -We work hard to make sure that {% data variables.product.prodname_github_codespaces %} is always available to you. However, forces beyond our control sometimes impact the service in ways that can cause unplanned service disruptions. +システム災害復旧シナリオはまれにしか発生しませんが、リージョン全体にわたる停止が発生する可能性に備えておくことをお勧めします。 リージョン全体でサービスが中断した場合、ローカルで冗長化されたデータのコピーは一時的に利用できなくなります。 -Although disaster recovery scenarios are rare occurrences, we recommend that you prepare for the possibility that there is an outage of an entire region. If an entire region experiences a service disruption, the locally redundant copies of your data would be temporarily unavailable. - -The following guidance provides options on how to handle service disruption to the entire region where your codespace is deployed. +次のガイダンスでは、codespace がデプロイされているリージョン全体へのサービスの中断を処理する方法を説明します。 {% note %} -**Note:** You can reduce the potential impact of service-wide outages by pushing to remote repositories frequently. +**注:** リモート リポジトリに頻繁にプッシュすることで、サービス全体の停止による潜在的な影響を減らすことができます。 {% endnote %} -## Option 1: Create a new codespace in another region +## オプション 1: 別のリージョンに新しい codespace を作る -In the case of a regional outage, we suggest you recreate your codespace in an unaffected region to continue working. This new codespace will have all of the changes as of your last push to {% data variables.product.prodname_dotcom %}. For information on manually setting another region, see "[Setting your default region for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)." +リージョンが停止した場合、影響を受けていないリージョンで codespace を再び作り、作業を続けることをお勧めします。 この新しい codespace には、{% data variables.product.prodname_dotcom %} への最後のプッシュ時点までのすべての変更が含まれます。 別リージョンの手動設定について詳しくは、「[{% data variables.product.prodname_github_codespaces %} の既定のリージョンの設定](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)」を参照してください。 -You can optimize recovery time by configuring a `devcontainer.json` in the project's repository, which allows you to define the tools, runtimes, frameworks, editor settings, extensions, and other configuration necessary to restore the development environment automatically. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project)." +プロジェクトのリポジトリで、開発環境を自動的に復元するために必要なツール、ランタイム、フレームワーク、エディター設定、機能拡張、その他の設定を定義できる `devcontainer.json` を設定することで、リカバリ時間を最適化できます。 詳細については、[開発コンテナーの概要](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project)に関するページをご覧ください。 -## Option 2: Wait for recovery +## オプション 2: 復旧を待つ -In this case, no action on your part is required. Know that we are working diligently to restore service availability. +この場合、ユーザーによる操作は必要ありません。 サービスを利用できるようにするために鋭意取り組んでいることをご理解ください。 -You can check the current service status on the [Status Dashboard](https://www.githubstatus.com/). +現在のサービスの状態は、[ステータス ダッシュボード](https://www.githubstatus.com/)で確認できます。 -## Option 3: Clone the repository locally or edit in the browser +## オプション 3: リポジトリをローカルでクローンする、またはブラウザーで編集する -While {% data variables.product.prodname_github_codespaces %} provides the benefit of a pre-configured developer environmnent, your source code should always be accessible through the repository hosted on {% data variables.product.prodname_dotcom_the_website %}. In the event of a {% data variables.product.prodname_github_codespaces %} outage, you can still clone the repository locally or edit files in the {% data variables.product.company_short %} browser editor. For more information, see "[Editing files](/repositories/working-with-files/managing-files/editing-files)." +{% data variables.product.prodname_github_codespaces %} では事前構成された開発者環境を利用できるメリットがありますが、ソースコードは常に {% data variables.product.prodname_dotcom_the_website %} でホストされているリポジトリからアクセス可能である必要があります。 {% data variables.product.prodname_github_codespaces %} が停止した場合でも、リポジトリをローカルでクローンしたり、{% data variables.product.company_short %} ブラウザー エディターでファイルを編集したりすることができます。 詳細については、「[ファイルの編集](/repositories/working-with-files/managing-files/editing-files)」を参照してください。 -While this option does not configure a development environment for you, it will allow you to make changes to your source code as needed while you wait for the service disruption to resolve. +このオプションでは開発環境を設定しませんが、サービスの中断が解決するのを待つ間、必要に応じてソースコードを変更できます。 -## Option 4: Use the Dev Containers extension and Docker for a local containerized environment +## オプション 4: ローカルのコンテナ化された環境に Dev Containers 拡張機能と Docker を使う -If your repository has a `devcontainer.json`, consider using the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) in {% data variables.product.prodname_vscode %} to build and attach to a local development container for your repository. The setup time for this option will vary depending on your local specifications and the complexity of your dev container setup. For more information, see "[Developing inside a container](https://code.visualstudio.com/docs/remote/containers#_quick-start-open-a-git-repository-or-github-pr-in-an-isolated-container-volume)" in the {% data variables.product.prodname_vscode_shortname %} documentation. +リポジトリに `devcontainer.json` がある場合、{% data variables.product.prodname_vscode %} で [Dev Containers 拡張機能](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)を使って、ビルドしてリポジトリ用のローカル開発コンテナーにアタッチすることを検討してください。 このオプションのセットアップ時間は、ローカル仕様と開発コンテナセットアップの複雑さによって異なります。 詳細については、{% data variables.product.prodname_vscode_shortname %} ドキュメントの「[コンテナー内で開発する](https://code.visualstudio.com/docs/remote/containers#_quick-start-open-a-git-repository-or-github-pr-in-an-isolated-container-volume)」を参照してください。 {% note %} -**Note:** Be sure your local setup meets the [minimum requirements](https://code.visualstudio.com/docs/remote/containers#_system-requirements) before attempting this option. +**注:** このオプションを試す前に、ローカルのセットアップが [最小要件](https://code.visualstudio.com/docs/remote/containers#_system-requirements)を満たしていることを確認してください。 {% endnote %} diff --git a/translations/ja-JP/content/codespaces/codespaces-reference/index.md b/translations/ja-JP/content/codespaces/codespaces-reference/index.md index a900941c57..26b1a15e4f 100644 --- a/translations/ja-JP/content/codespaces/codespaces-reference/index.md +++ b/translations/ja-JP/content/codespaces/codespaces-reference/index.md @@ -10,6 +10,7 @@ children: - /using-the-github-codespaces-plugin-for-jetbrains - /using-the-vs-code-command-palette-in-codespaces - /security-in-github-codespaces + - /performing-a-full-rebuild-of-a-container - /disaster-recovery-for-github-codespaces ms.openlocfilehash: 87692cd862e791f3e6ffa2be2b07f34c6158e617 ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 diff --git a/translations/ja-JP/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md b/translations/ja-JP/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md index 48607d15d9..2f0aea5e3d 100644 --- a/translations/ja-JP/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md +++ b/translations/ja-JP/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Using GitHub Copilot in GitHub Codespaces -intro: 'You can use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_github_codespaces %} by adding the extension.' +title: GitHub Codespaces での GitHub Copilot の使用 +intro: '拡張機能を追加することで、{% data variables.product.prodname_github_codespaces %} で {% data variables.product.prodname_copilot %} を使用できます。' versions: fpt: '*' ghec: '*' @@ -13,8 +13,13 @@ shortTitle: Copilot in Codespaces redirect_from: - /codespaces/codespaces-reference/using-copilot-in-codespaces - /codespaces/codespaces-reference/using-github-copilot-in-codespaces +ms.openlocfilehash: 6615df6930fa8f27dd8f50c4588d8182b8602549 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158726' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} @@ -23,7 +28,7 @@ redirect_from: {% webui %} -## Using {% data variables.product.prodname_copilot %} in the {% data variables.product.prodname_vscode_shortname %} web client +## {% data variables.product.prodname_vscode_shortname %} Web クライアントでの {% data variables.product.prodname_copilot %} の使用 {% data reusables.codespaces.copilot-in-vscode %} @@ -31,7 +36,7 @@ redirect_from: {% vscode %} -## Using {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %} +## {% data variables.product.prodname_vscode %} での {% data variables.product.prodname_copilot %} の使用 {% data reusables.codespaces.copilot-in-vscode %} @@ -39,57 +44,57 @@ redirect_from: {% jetbrains %} -## Installing {% data variables.product.prodname_copilot %} in your JetBrains IDE +## JetBrains IDE での {% data variables.product.prodname_copilot %} のインストール -[{% data variables.product.prodname_copilot %}](https://copilot.github.com/), an AI pair programmer, can be used in any codespace. For more information, see "[About GitHub Copilot](/copilot/overview-of-github-copilot/about-github-copilot)." +[{% data variables.product.prodname_copilot %}](https://copilot.github.com/) (AI ペア プログラマー) は、任意の codespace で使用できます。 詳細については、「[GitHub Copilot について](/copilot/overview-of-github-copilot/about-github-copilot)」をご覧ください。 -To use {% data variables.product.prodname_copilot %} in a codespace in your JetBrains IDE, install the [{% data variables.product.prodname_copilot %} plugin](https://plugins.jetbrains.com/plugin/17718-github-copilot) from within your codespace. +JetBrains IDE の codespace で {% data variables.product.prodname_copilot %} を使用するには、codespace 内から [{% data variables.product.prodname_copilot %} プラグイン](https://plugins.jetbrains.com/plugin/17718-github-copilot)をインストールします。 {% note %} -**Note**: You must install the {% data variables.product.prodname_copilot %} plugin each time you create a new codespace. +**注**: 新しい codespace を作成するたびに、{% data variables.product.prodname_copilot %} プラグインをインストールする必要があります。 {% endnote %} -1. In the JetBrains client application, open the Settings (Windows/Linux) or Preferences (Mac) dialog box: +1. JetBrains クライアント アプリケーションで、[設定] (Windows/Linux) または [環境設定] (Mac) ダイアログ ボックスを開きます。 - - **Windows/Linux**: Click **File** and then **Settings** (or press Ctrl+Alt+S) - - **Mac**: Click **JetBrains Client** in the MacOS menu bar, then click **Preferences** (or press command+,) + - **Windows/Linux**: **[ファイル]** をクリックし、 **[設定]** をクリックします (または Ctrl+Alt+S キーを押します) + - **Mac**: MacOS メニュー バーの **[JetBrains クライアント]** をクリックし、 **[環境設定]** をクリックします (または command+, キーを押します) -1. In the left-side menu of the Settings/Preferences dialog box, click **Plugins On Host**. Then click the **Marketplace** tab. +1. [設定] または [環境設定] ダイアログ ボックスの左側のメニューで、 **[プラグイン ホスト上]** をクリックします。 次に、 **[Marketplace]** タブをクリックします。 - ![Screenshot of the Marketplace tab for 'Plugins On Host'](/assets/images/help/codespaces/jetbrains-preferences-plugins.png) + ![[プラグイン ホスト上] の [Marketplace] タブのスクリーンショット](/assets/images/help/codespaces/jetbrains-preferences-plugins.png) -1. In the search box, type "copilot" then click the **Install** button for the {% data variables.product.prodname_copilot %} plugin. +1. 検索ボックスに「copilot」と入力し、{% data variables.product.prodname_copilot %} プラグインの **[インストール]** ボタンをクリックします。 - ![Screenshot of the {% data variables.product.prodname_copilot %} plugin](/assets/images/help/codespaces/jetbrains-copilot-plugin.png) + ![{% data variables.product.prodname_copilot %} プラグインのスクリーンショット](/assets/images/help/codespaces/jetbrains-copilot-plugin.png) -1. Click **Accept** on the "Third-Party Plugins Privacy Note" dialog box. -1. Click **Restart IDE**. +1. [サード パーティ製プラグインのプライバシーに関するメモ] ダイアログ ボックスの **[承諾]** をクリックします。 +1. **[Restart IDE]\(IDE を再起動する\)** をクリックします。 - ![Screenshot of the {% data variables.product.prodname_copilot %} plugin](/assets/images/help/codespaces/jetbrains-copilot-restart.png) + ![{% data variables.product.prodname_copilot %} プラグインのスクリーンショット](/assets/images/help/codespaces/jetbrains-copilot-restart.png) -1. Click **Restart** when prompted to confirm that you want to restart the backend IDE that's running remotely. The JetBrains client application will close when you do this. -1. Open the codespace again from the JetBrains Gateway application. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide#opening-a-codespace-in-your-jetbrains-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 %}**. +1. リモートで実行されているバックエンド IDE を再起動するかどうかを確認するメッセージが表示されたら、 **[再起動]** をクリックします。 これを行うと、JetBrains クライアント アプリケーションが閉じます。 +1. JetBrains Gateway アプリケーションから codespace をもう一度開きます。 詳細については、「[JetBrains IDE での {% data variables.product.prodname_github_codespaces %} の使用](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide#opening-a-codespace-in-your-jetbrains-ide)」を参照してください。 +1. JetBrains IDE が再起動したら、 **[ツール]** メニューをクリックします。 **[{% data variables.product.prodname_copilot %}]** 、 **[{% data variables.product.prodname_dotcom %} にログイン]** の順にクリックします。 - ![Screenshot of the JetBrains Tools menu](/assets/images/help/codespaces/jetbrains-tools-menu.png) + ![JetBrains の [ツール] メニューのスクリーンショット](/assets/images/help/codespaces/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**. +1. デバイス コードをコピーしてデバイスの有効化ウィンドウを開くには、[{% data variables.product.prodname_dotcom %} にサインイン] ダイアログ ボックスで、 **[コピーして開く]** をクリックします。 - ![Screenshot of the device code copy and open](/assets/images/help/copilot/device-code-copy-and-open.png) + ![デバイス コードの [コピーして開く] のスクリーンショット](/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. ブラウザーにデバイスのアクティブ化ウィンドウが表示されます。 デバイス コードを貼り付け、 **[続行]** をクリックします。 - - 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**. + - 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 IDE によって確認が表示されます。 {% data variables.product.prodname_copilot %} の使用を開始するには、 **[OK]** をクリックします。 - ![Screenshot of the JetBrains IDE permissions confirmation](/assets/images/help/copilot/jetbrains-ide-confirmation.png) + ![JetBrains IDE によるアクセス許可の確認のスクリーンショット](/assets/images/help/copilot/jetbrains-ide-confirmation.png) -## Further reading +## 参考資料 -- "[Getting started with GitHub Copilot in a JetBrains IDE](/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide)" +- 「[JetBrains IDE で GitHub Copilot の使用を開始する](/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide)」 -{% endjetbrains %} \ No newline at end of file +{% endjetbrains %} diff --git a/translations/ja-JP/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md b/translations/ja-JP/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md index b46863bb7f..1ae7d23c67 100644 --- a/translations/ja-JP/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md +++ b/translations/ja-JP/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md @@ -58,6 +58,8 @@ To rebuild your container, [access the {% data variables.product.prodname_vscode ![Command to rebuild a codespace](/assets/images/help/codespaces/codespaces-rebuild.png) +{% data reusables.codespaces.full-rebuild-tip %} + ### Codespaces logs You can use the {% data variables.product.prodname_vscode_command_palette_shortname %} to access the codespace creation logs, or you can use it export all logs. diff --git a/translations/ja-JP/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md b/translations/ja-JP/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md index 5ee22758aa..c8a0731924 100644 --- a/translations/ja-JP/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md +++ b/translations/ja-JP/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md @@ -1,7 +1,7 @@ --- -title: Changing the machine type for your codespace +title: codespace のマシンの種類を変更する shortTitle: Change the machine type -intro: 'You can change the type of machine that''s running your codespace, so that you''re using resources appropriate for the work you''re doing.' +intro: codespace を実行しているマシンの種類を変更し、実行している作業に適したリソースを使用できます。 versions: fpt: '*' ghec: '*' @@ -10,21 +10,26 @@ redirect_from: topics: - Codespaces type: how_to +ms.openlocfilehash: b8614e9389aa617b3bfcfa3444f5a60aa7dd3c2e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159086' --- +## マシンの種類について -## About machine types +{% data reusables.codespaces.codespaces-machine-types %} codespace を作るときは、あるいは codespace の作成後はいつでも、代替マシンの種類を選べます。 -{% data reusables.codespaces.codespaces-machine-types %} You can choose an alternative machine type either when you create a codespace or at any time after you've created a codespace. +codespace の作成時にマシンの種類を選ぶ方法については、[リポジトリ用の codespace の作成](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)に関する説明を参照してください。 -For information on choosing a machine type 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)." +{% data reusables.codespaces.machine-types-for-unpublished-codespaces %}詳しくは、[テンプレートからの codespace の作成](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)に関する説明を参照してください。 -{% data reusables.codespaces.machine-types-for-unpublished-codespaces %} For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)." - -## Changing the machine type +## マシンの種類の変更 {% note %} -**Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} +**注**: {% data reusables.codespaces.codespaces-machine-type-availability %} {% endnote %} @@ -32,18 +37,18 @@ For information on choosing a machine type when you create a codespace, see "[Cr {% data reusables.codespaces.your-codespaces-procedure-step %} - The current machine type for each of your codespaces is displayed. + 各 codespace の現在のコンピューターの種類が表示されます。 - !['Your codespaces' list](/assets/images/help/codespaces/your-codespaces-list.png) + !["あなたの codespace" リスト](/assets/images/help/codespaces/your-codespaces-list.png) {% data reusables.codespaces.ellipsis-settings %} -1. Click **Change machine type**. +1. **[マシンの種類を変更する]** をクリックします。 - !['Change machine type' menu option](/assets/images/help/codespaces/change-machine-type-menu-option.png) -1. If multiple machine types are available for your codespace, choose the type of machine you want to use. + ![[マシンの種類の変更] メニュー オプション](/assets/images/help/codespaces/change-machine-type-menu-option.png) +1. codespace で複数のコンピューターの種類を使える場合、使うマシンの種類を選びます。 - ![Dialog box showing available machine types to choose](/assets/images/help/codespaces/change-machine-type-choice.png) -1. Click **Update codespace**. + ![選べるマシンの種類を示すダイアログ ボックス](/assets/images/help/codespaces/change-machine-type-choice.png) +1. **[codespace の更新]** をクリックします。 {% endwebui %} @@ -55,39 +60,39 @@ For information on choosing a machine type when you create a codespace, see "[Cr {% cli %} -You can use the `gh codespace edit --machine MACHINE-TYPE-NAME` {% data variables.product.prodname_cli %} command to change the machine type of a codespace. To use this command, you'll first need to find out the available machine types for your codespace. +`gh codespace edit --machine MACHINE-TYPE-NAME` {% data variables.product.prodname_cli %} コマンドを使用して、codespace のマシンの種類を変更できます。 このコマンドを使用するには、まず codespace で使用可能なマシンの種類を確認する必要があります。 -1. To view your list of codespaces, in a terminal, enter the following command. +1. codespaces の一覧を表示するには、ターミナルで次のコマンドを入力します。 ``` gh codespace list ``` -1. Optionally, to find the current machine type for a codespace, enter the following command. +1. 必要に応じて、codespace 用の現在のマシンの種類を検索するには、次のコマンドを入力します。 ``` gh api /user/codespaces/CODESPACE-NAME ``` - Replace `CODESPACE-NAME` with the permanent name of the codespace, for example `octocat-literate-space-parakeet-mld5`. The permanent names are listed under the **NAME** column in the list returned by `gh codespace list`. + `CODESPACE-NAME` を codespace の永続的な名前に置き換えます (例: `octocat-literate-space-parakeet-mld5`)。 永続的な名前は、`gh codespace list` によって返される一覧の **NAME** 列の下に一覧表示されます。 - If you're prompted to request the `codespace` scope, follow the instructions in the terminal. + `codespace` スコープを要求するように求められた場合は、ターミナルの指示に従います。 - Details for the current machine are listed under the `machine` field. -1. To find the available machine types for a codespace, enter the following command. + 現在のマシンについて詳しくは、`machine` フィールドの下に一覧表示されます。 +1. codespace で使用可能なマシンの種類を見つけるには、次のコマンドを入力します。 ``` gh api /user/codespaces/CODESPACE-NAME/machines ``` - Replace `CODESPACE-NAME` with the permanent name of the codespace, for example `octocat-literate-space-parakeet-mld5`. -1. To change the machine type for a codespace, enter the following command. + `CODESPACE-NAME` を codespace の永続的な名前に置き換えます (例: `octocat-literate-space-parakeet-mld5`)。 +1. codespace 用のマシンの種類を変更するには、次のコマンドを入力します。 ``` gh codespace edit --machine MACHINE-TYPE-NAME ``` - Replace `MACHINE-TYPE-NAME` with the name of an available machine type for your codespace, for example `standardLinux32gb`. -1. Using the arrow keys, navigate to the codespace you want to change, then press Enter. + `MACHINE-TYPE-NAME` を codespace で使用できるマシンの種類の名前に置き換えます (例: `standardLinux32gb`)。 +1. 方向キーを使用して、変更する codespace に移動して、Enter キーを押します。 {% endcli %} @@ -95,9 +100,9 @@ You can use the `gh codespace edit --machine MACHINE-TYPE-NAME` {% data variable {% cli %} -## Further reading +## 参考資料 -- "[Codespaces machines](/rest/codespaces/machines)" in the REST API documentation -- [`gh codespace edit`](https://cli.github.com/manual/gh_codespace_edit) in the {% data variables.product.prodname_cli %} manual +- REST API ドキュメント内の「[codespaces マシン](/rest/codespaces/machines)」 +- {% data variables.product.prodname_cli %} マニュアル内の「[`gh codespace edit`](https://cli.github.com/manual/gh_codespace_edit)」 {% endcli %} diff --git a/translations/ja-JP/content/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces.md b/translations/ja-JP/content/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces.md index f0b5bc7897..e828afa876 100644 --- a/translations/ja-JP/content/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces.md +++ b/translations/ja-JP/content/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces.md @@ -1,85 +1,89 @@ --- -title: Configuring automatic deletion of your codespaces +title: codespace の自動削除を構成する shortTitle: Configure automatic deletion -intro: 'Inactive codespaces are automatically deleted. You can choose how long your stopped codespaces are retained, up to a maximum of 30 days.' +intro: 非アクティブの codespace は自動的に削除されます。 停止した codespace を保持する期間は、最大 30 日まで選ぶことができます。 versions: fpt: '*' ghec: '*' topics: - Codespaces type: how_to +ms.openlocfilehash: 5414d2223f490638f27475840a25883e9c353e77 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160109' --- +既定では、{% data variables.product.prodname_github_codespaces %} は、停止して、非アクティブな状態で 30 日間が過ぎると、自動的に削除されます。 -By default, {% data variables.product.prodname_github_codespaces %} are automatically deleted after they have been stopped and have remained inactive for 30 days. - -However, because {% data variables.product.prodname_github_codespaces %} incurs storage charges, you may prefer to reduce the retention period by changing your default period in your personal settings for {% data variables.product.prodname_github_codespaces %}. For more information about storage charges, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)." +しかしながら、{% data variables.product.prodname_github_codespaces %} のストレージ料金が発生するため、{% data variables.product.prodname_github_codespaces %} の個人設定で既定の保持期間を変更して、期間を短縮することをお勧めします。 ストレージ料金の詳しい情報については、「[{% data variables.product.prodname_github_codespaces %} の課金について](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)」をご覧ください。 {% note %} -**Note**: Whether or not you have set a personal codespace retention period, it's a good idea to get into the habit of deleting codespaces that you no longer need. For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)." +**注**: 個人の codespace 保持期間を設定したかどうかにかかわらず、codespace は不要になったら削除することを習慣にすることをお勧めします。 詳細については、「[codespace の削除](/codespaces/developing-in-codespaces/deleting-a-codespace)」を参照してください。 {% endnote %} -Automatic deletion happens irrespective of whether a codespace contains unpushed changes. To prevent automatic deletion of a codespace, just open the codespace again. The retention period is reset every time you connect to a codespace, and the retention countdown restarts when the codespace is stopped. +自動削除は、codespace にプッシュされていない変更が含まれているかどうかに関係なく行われます。 codespace の自動削除を防ぐには、codespace をもう一度開くだけです。 codespace に接続するたびに保持期間がリセットされ、codespace を停止すると、保持期間のカウントダウンが再開されます。 -If a repository belongs to an organization, the organization admin may have set a retention period for the whole organization. If this period is less than the default retention period in your personal settings then the organization retention period will apply to codespaces you create for this repository. For more information, see "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)." +リポジトリが Organaization に属している場合、Organaization 管理者が Organaization 全体の保持期間を設定していることがあります。 この期間の方が個人設定の既定の保持期間より短い場合は、このリポジトリ用に作成した codespace には、Organaization の保持期間が適用されます。 詳しい情報については、「[codespace の保持期間を制限する](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)」をご覧ください。 -Each codespace has its own retention period. You may, therefore, have codespaces with different rentention periods. For example, if: -* You created a codespace, changed your default retention period, then created another codespace. -* You created a codespace using {% data variables.product.prodname_cli %} and specified a different retention period. -* You created a codespace from an organization-owned repository that has a retention period configured for the organization. +codespace ごとに独自の保持期間があります。 そのため、codespace によって保持期間が異なる場合があります。 たとえば、次の場合です。 +* codespace を作成した後、既定の保持期間を変更し、別の codespace を作成した。 +* codespace を {% data variables.product.prodname_cli %} を使って作成し、異なる保持期間を指定した。 +* Organaization 用の保持期間が構成されている Organaization が所有するリポジトリから codespace を作成した。 {% note %} -**Note**: The retention period is specified in days. A day represents a 24-hour period, beginning at the time of day when you stop a codespace. +**注**: 保持期間は日数で指定します。 1 日とは、codespace を停止した時点から始まる 24 時間を意味します。 {% endnote %} {% webui %} -## Setting a default retention period for your codespaces +## codespace の既定の保持期間を設定する -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Default retention period", enter the number of days for which you want your codespaces to be retained, by default, after they have been stopped. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. [既定の保持期間] に、停止後に codespace を保持する既定の日数を入力します。 - ![Selecting your retention period](/assets/images/help/codespaces/setting-default-retention.png) + ![保持期間を選ぶ](/assets/images/help/codespaces/setting-default-retention.png) - You can set your default retention period between `0` and `30` days. + 既定の保持期間は `0` から `30` 日の間で設定できます。 {% warning %} - **Warning**: Setting the period to `0` will result in your codespaces being immediately deleted when you stop them, or when they timeout due to inactivity. For more information, see "[Setting your timeout period for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)." + **警告**: 期間を `0` に設定すると、codespace は、停止したとき、または非アクティブのためにタイムアウトしたとき、即座に削除されます。 詳しい情報については、「[{% data variables.product.prodname_github_codespaces %} のタイムアウト期間を設定する](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)」をご覧ください。 {% endwarning %} -1. Click **Save**. +1. **[保存]** をクリックします。 -When you create a codespace using {% data variables.product.prodname_cli %} you can override this default. If you create a codespace in an organization that specifies a shorter retention period, the organization-level value overrides your personal setting. +codespace を {% data variables.product.prodname_cli %} を使って作成する場合は、この既定値をオーバーライドできます。 より短い保持期間を指定する Organaization で codespace を作成した場合、個人設定は、Organaization レベルの値によってオーバーライドされます。 -If you set a retention period of more than a day, you'll be sent an email notification one day prior to its deletion. +1 日を超える保持期間を設定すると、削除の 1 日前にメール通知を受け取ります。 -## Checking the remaining time until autodeletion +## 自動削除までの残り時間を確認する -You can check whether a codespace is due to be automatically deleted soon. +codespace が間もなく自動的に削除される予定かどうかを確認できます。 -When an inactive codespace is approaching the end of its retention period, this is indicated in your list of codespaces on {% data variables.product.prodname_dotcom %} at [https://github.com/codespaces](https://github.com/codespaces). +非アクティブな codespace の保持期間が終わりに近づくと、{% data variables.product.prodname_dotcom %} の codespace のリスト ([https://github.com/codespaces](https://github.com/codespaces)) にその旨が示されます。 -![The pre-deletion message in the codespaces list on {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/retention-deletion-message.png) +![{% data variables.product.prodname_dotcom %} の codespace リストに表示されている削除前のメッセージ](/assets/images/help/codespaces/retention-deletion-message.png) {% endwebui %} {% cli %} -## Setting a retention period for a codespace +## codespace の保持期間を設定する -To set the codespace retention period when you create a codespace, use the `--retention-period` flag with the `codespace create` subcommand. Specify the period in days. The period must be between 0 and 30 days. +codespace の作成時に codespace 保持期間を設定するには、`codespace create` サブコマンドで `--retention-period` フラグを使います。 期間を日数で指定します。 0 から 30 日の期間を指定してください。 ```shell gh codespace create --retention-period DAYS ``` -If you don't specify a retention period when you create a codespace, then either your default retention period, or an organization retention period, will be used, depending on which is lower. For information about setting your default retention period, click the "Web browser" tab on this page. +codespace の作成時に保持期間を指定しない場合は、既定の保持期間と Organaization の保有期間のどちらか短い方が使われます。 既定の保持期間の設定の詳しい情報については、このページの [Web ブラウザー] タブをクリックしてください。 {% data reusables.cli.cli-learn-more %} @@ -87,20 +91,20 @@ If you don't specify a retention period when you create a codespace, then either {% vscode %} -## Setting the retention period +## 保持期間を設定する -You can set your default retention period in your web browser, on {% data variables.product.prodname_dotcom_the_website %}. Alternatively, if you use {% data variables.product.prodname_cli %} to create a codespace you can set a retention period for that particular codespace. For more information, click the appropriate tab above. +既定の保持期間は、Web ブラウザー内の {% data variables.product.prodname_dotcom_the_website %} で設定できます。 また、codespace を {% data variables.product.prodname_cli %} を使って作成する場合は、その特定の codespace の保持期間を設定できます。 詳しい情報については、上記の該当するタブをクリックしてください。 -## Checking whether codespaces will be autodeleted soon +## codespace が間もなく自動削除されるかどうかを確認する -You can check, in the {% data variables.product.prodname_vscode %} desktop application, whether a codespace is due to be automatically deleted soon. +{% data variables.product.prodname_vscode %} デスクトップ アプリケーションで、codespace が間もなく自動的に削除される予定かどうかを確認できます。 {% data reusables.codespaces.click-remote-explorer-icon-vscode %} -1. Choose **{% data variables.product.prodname_github_codespaces %}** from the dropdown menu at the top right of the Remote Explorer, if it is not already selected. -1. Under "GITHUB CODESPACES," position the mouse pointer over the codespace that you're interested in. A pop-up box is displayed showing you information about the codespace. +1. まだ選んでいない場合は、リモート エクスプローラーの右上にあるドロップダウン メニューから **{% data variables.product.prodname_github_codespaces %}** を選びます。 +1. [GitHub Codespaces] の下で、目的の codespace の上にマウス ポインターを置きます。 codespace に関する情報を示すポップアップ ボックスが表示されます。 - If the codespace is nearing the end of its retention period, a line is included telling you when the codespace will be deleted. + codespace の保持期間が終わりに近づいている場合は、codespace がいつ削除されるのかを通知する行が含まれます。 - ![Codespace information showing the time until deletion](/assets/images/help/codespaces/vscode-deleting-in-5-days.png) + ![削除までの時間を示す codespace 情報](/assets/images/help/codespaces/vscode-deleting-in-5-days.png) {% endvscode %} diff --git a/translations/ja-JP/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md b/translations/ja-JP/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md index ccd3cdb369..808ea75a6d 100644 --- a/translations/ja-JP/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md +++ b/translations/ja-JP/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md @@ -1,7 +1,7 @@ --- -title: Personalizing GitHub Codespaces for your account +title: アカウントの GitHub Codespaces をパーソナライズする shortTitle: Personalize your codespaces -intro: 'You can personalize {% data variables.product.prodname_github_codespaces %} by using a `dotfiles` repository on {% data variables.product.product_name %} or by using Settings Sync.' +intro: '{% data variables.product.product_name %} の `dotfiles` リポジトリを使用するか、Settings Sync を使用して、{% data variables.product.prodname_github_codespaces %} をパーソナライズできます。' redirect_from: - /github/developing-online-with-github-codespaces/personalizing-github-codespaces-for-your-account - /github/developing-online-with-codespaces/personalizing-codespaces-for-your-account @@ -15,39 +15,43 @@ topics: - Codespaces - Set up - Fundamentals +ms.openlocfilehash: 80b6cd1ee982150c1b3c0a66e1247f6098a97bcb +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160259' --- +## {% data variables.product.prodname_codespaces %} のパーソナライズについて +開発環境を使用する場合、設定とツールを好みやワークフローに合わせてカスタマイズすることが重要です。 {% data variables.product.prodname_github_codespaces %} では、Codespaces をパーソナライズするときに使用できる方法は主に 2 つあります。 -## About personalizing {% data variables.product.prodname_codespaces %} +- [設定の同期](#settings-sync) - デスクトップ アプリケーションと {% data variables.product.prodname_vscode_shortname %} Web クライアントの間で {% data variables.product.prodname_vscode %} 設定を同期できます。 +- [ドットファイル](#dotfiles) - `dotfiles` リポジトリを使用して、スクリプト、シェル設定、およびその他の構成を指定できます。 -When using any development environment, customizing the settings and tools to your preferences and workflows is an important step. {% data variables.product.prodname_github_codespaces %} allows for two main ways of personalizing your codespaces. +{% data variables.product.prodname_github_codespaces %} で行ったパーソナル化は、作成するすべての codespace に適用されます。 -- [Settings Sync](#settings-sync) - You can synchronize your {% data variables.product.prodname_vscode %} settings between the desktop application and the {% data variables.product.prodname_vscode_shortname %} web client. -- [Dotfiles](#dotfiles) – You can use a `dotfiles` repository to specify scripts, shell preferences, and other configurations. - -{% data variables.product.prodname_github_codespaces %} personalization applies to any codespace you create. - -Project maintainers can also define a default configuration that applies to every codespace for a repository, created by anyone. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." +プロジェクトのメンテナは、ユーザが作成したリポジトリのすべての codespace に適用されるデフォルト設定を定義することもできます。 詳細については、[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)に関するページをご覧ください。 ## Settings Sync -Settings Sync allows you to synchronize configurations such as settings, keyboard shortcuts, snippets, extensions, and UI state across machines and instances of {% data variables.product.prodname_vscode_shortname %}. +"設定の同期" を使用すると、設定、キーボードショートカット、スニペット、機能拡張、UI の状態などの設定をマシンと {% data variables.product.prodname_vscode_shortname %} のインスタンスとの間で同期できます。 -To enable Settings Sync, in the bottom-left corner of {% data variables.product.prodname_vscode %}'s Activity Bar, select {% octicon "gear" aria-label="The gear icon" %} and click **Turn on Settings Sync…**. In the dialog box, select the settings you'd like to sync. +"設定の同期" を有効にするには、{% data variables.product.prodname_vscode %} のアクティビティ バーの左下隅にある {% octicon "gear" aria-label="The gear icon" %} を選び、 **[設定の同期をオンにする...]** をクリックします。 ダイアログ ボックスで同期する設定を選択します。 -![Setting Sync option in manage menu](/assets/images/help/codespaces/codespaces-manage-settings-sync.png) +![管理メニューの Setting Sync オプション](/assets/images/help/codespaces/codespaces-manage-settings-sync.png) -For more information, see the [Settings Sync guide](https://code.visualstudio.com/docs/editor/settings-sync) in the {% data variables.product.prodname_vscode_shortname %} documentation. +詳しくは、{% data variables.product.prodname_vscode_shortname %} ドキュメントの「[同期の設定](https://code.visualstudio.com/docs/editor/settings-sync)」ガイドをご覧ください。 ## Dotfiles -Dotfiles are files and folders on Unix-like systems starting with `.` that control the configuration of applications and shells on your system. You can store and manage your dotfiles in a repository on {% data variables.product.prodname_dotcom %}. For advice and tutorials about what to include in your dotfiles repository, see [GitHub does dotfiles](https://dotfiles.github.io/). +ドットファイルは、`.` で始まる Unix ライクなシステム上のファイルとフォルダーであり、システム上のアプリケーションとシェルの設定を制御します。 ドットファイルは、{% data variables.product.prodname_dotcom %} のリポジトリに保存して管理できます。 ドットファイル リポジトリに含める内容に関するアドバイスとチュートリアルについては、[GitHub does dotfiles](https://dotfiles.github.io/) を参照してください。 -Your dotfiles repository might include your shell aliases and preferences, any tools you want to install, or any other codespace personalization you want to make. +ドットファイル リポジトリには、シェルのエイリアスと設定、インストールするツール、またはその他の codespace のパーソナル化を含めることができます。 -You can configure {% data variables.product.prodname_github_codespaces %} to use dotfiles from any repository you own by selecting that repository in your [personal {% data variables.product.prodname_github_codespaces %} settings](https://github.com/settings/codespaces). +[個人の {% data variables.product.prodname_github_codespaces %} 設定](https://github.com/settings/codespaces)でそのリポジトリを選ぶことで、所有している任意のリポジトリのドットファイルを使用するように {% data variables.product.prodname_github_codespaces %} を構成できます。 -When you create a new codespace, {% data variables.product.prodname_dotcom %} clones your selected dotfiles repository to the codespace environment, and looks for one of the following files to set up the environment. +新しい codespace を作成すると、{% data variables.product.prodname_dotcom %} は選択したドットファイルのリポジトリを codespace 環境にクローンし、次のいずれかのファイルを探して環境を設定します。 * _install.sh_ * _install_ @@ -58,48 +62,47 @@ When you create a new codespace, {% data variables.product.prodname_dotcom %} cl * _setup_ * _script/setup_ -If none of these files are found, then any files or folders in your selected dotfiles repository starting with `.` are symlinked to the codespace's `~` or `$HOME` directory. +これらのファイルが見つからない場合は、`.` で始まる選択したドットファイル リポジトリ内のすべてのファイルまたはフォルダーが codespace の `~` または `$HOME` ディレクトリにシンボリック リンクされます。 -Any changes to your selected dotfiles repository will apply only to each new codespace, and do not affect any existing codespace. +選択したドットファイル リポジトリへの変更は、新しい codespace にのみそれぞれ適用され、既存の codespace には影響しません。 {% note %} -**Note:** Currently, {% data variables.product.prodname_codespaces %} does not support personalizing the User-scoped settings for {% data variables.product.prodname_vscode_shortname %} with your `dotfiles` repository. You can set default Workspace and Remote [Codespaces] settings for a specific project in the project's repository. For more information, see "[Introduction to dev containers](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project#creating-a-custom-dev-container-configuration)." +**注:** 現在、{% data variables.product.prodname_codespaces %} は、`dotfiles` リポジトリを使用した {% data variables.product.prodname_vscode_shortname %} に対するユーザー スコープの設定のパーソナライズをサポートしていません。 プロジェクトのリポジトリ内の特定のプロジェクトに対して、既定の "ワークスペース" と "リモート [Codespaces] " 設定を設定できます。 詳細については、[開発コンテナーの概要](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project#creating-a-custom-dev-container-configuration)に関するページをご覧ください。 {% endnote %} -### Enabling your dotfiles repository for {% data variables.product.prodname_codespaces %} +### {% data variables.product.prodname_codespaces %} のドットファイル リポジトリを有効にする -You can use your selected dotfiles repository to personalize your {% data variables.product.prodname_github_codespaces %} environment. Once you choose your dotfiles repository, you can add your scripts, preferences, and configurations to it. You then need to enable your dotfiles from your personal {% data variables.product.prodname_github_codespaces %} settings page. +選んだドットファイル リポジトリを使用して、{% data variables.product.prodname_github_codespaces %} 環境をパーソナライズできます。 ドットファイル リポジトリを選択したら、スクリプト、基本設定、構成を追加できます。 その後、個人の {% data variables.product.prodname_github_codespaces %} 設定ページからドットファイルを有効にする必要があります。 {% warning %} -**Warning:** Dotfiles have the ability to run arbitrary scripts, which may contain unexpected or malicious code. Before installing a dotfiles repo, we recommend checking scripts to ensure they don't perform any unexpected actions. +**警告:** ドットファイルには、予期しないコードや悪意のあるコードが含まれている可能性がある任意のスクリプトを実行する機能があります。 ドットファイル リポジトリをインストールする前に、スクリプトをチェックして、予期しないアクションが実行されないようにすることをお勧めします。 {% endwarning %} -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Dotfiles", select **Automatically install dotfiles** so that {% data variables.product.prodname_github_codespaces %} automatically installs your dotfiles into every new codespace you create. - ![Installing dotfiles](/assets/images/help/codespaces/install-custom-dotfiles.png) -2. Choose the repository you want to install dotfiles from. - ![Selecting a dotfiles repo](/assets/images/help/codespaces/select-dotfiles-repo.png) +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. "ドットファイル" の下で **[ドットファイルを自動的にインストールする]** を選ぶと、{% data variables.product.prodname_github_codespaces %} によって、作成したすべての新しい codespace にドットファイルが自動的にインストールされます。 + ![ドットファイルをインストールする](/assets/images/help/codespaces/install-custom-dotfiles.png) +2. インストールするドットファイルをリポジトリから選択します。 + ![ドットファイル リポジトリを選択する](/assets/images/help/codespaces/select-dotfiles-repo.png) -You can add further script, preferences, configuration files to your dotfiles repository or edit existing files whenever you want. Changes to settings will only be picked up by new codespaces. +ドットファイル リポジトリにスクリプト、基本設定、構成ファイルをさらに追加したり、必要に応じて既存のファイルを編集したりできます。 設定の変更は、新しい codespace によってのみ取得されます。 -If your codespace fails to pick up configuration settings from dotfiles, see "[Troubleshooting dotfiles for {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces)." +codespace でドットファイルから構成設定を取得できない場合は、「[{% data variables.product.prodname_github_codespaces %} のドットファイルのトラブルシューティング](/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces)」をご覧ください。 -## Other available settings +## その他の使用可能な設定 -You can also personalize {% data variables.product.prodname_github_codespaces %} using additional options in [your personal settings](https://github.com/settings/codespaces): +[個人用設定](https://github.com/settings/codespaces)の追加オプションを使用して、{% data variables.product.prodname_github_codespaces %} をカスタマイズすることもできます。 -- To enable GPG verification, see "[Managing GPG verification for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)." -- To set your editor, see "[Setting your default editor for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)." -- To set how long a codespace can remain unused before it is automatically stopped, see "[Setting your timeout period for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)." -- To set the period for which your unused codespaces are retained, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)." -- To set your default region, see "[Setting your default region for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)." +- GPG 検証を有効にするには、「[{% data variables.product.prodname_github_codespaces %} の GPG 検証を管理する](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)」を参照してください。 +- エディターを設定するには、「[{% data variables.product.prodname_github_codespaces %} の既定のエディターを設定する](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)」を参照してください。 +- Codespace が未使用の状態となって自動的に停止するまでの期間を確認するには、「[{% data variables.product.prodname_github_codespaces %} のタイムアウト期間を設定する](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)」をご覧ください。 +- 未使用の codespace を保持する期間を設定するには、「[codespace の自動削除を構成する](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)」を参照してください。 +- 既定のリージョンを設定するには、「[{% data variables.product.prodname_github_codespaces %} の既定のリージョンを設定する](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)」を参照してください。 -## Further reading +## 参考資料 -* "[Creating a new repository](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)" -* "[Deep dive into {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive#personalizing-your-codespace-with-extensions-or-plugins)" \ No newline at end of file +* 「[新しいリポジトリの作成](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)」 +* [{% data variables.product.prodname_github_codespaces %} の詳細](/codespaces/getting-started/deep-dive#personalizing-your-codespace-with-extensions-or-plugins) diff --git a/translations/ja-JP/content/codespaces/customizing-your-codespace/renaming-a-codespace.md b/translations/ja-JP/content/codespaces/customizing-your-codespace/renaming-a-codespace.md index 04b0d5b52f..896bdaac99 100644 --- a/translations/ja-JP/content/codespaces/customizing-your-codespace/renaming-a-codespace.md +++ b/translations/ja-JP/content/codespaces/customizing-your-codespace/renaming-a-codespace.md @@ -1,6 +1,6 @@ --- -title: Renaming a codespace -intro: 'You can change the codespace display name to one of your choice through {% data variables.product.prodname_dotcom_the_website %} or the {% data variables.product.prodname_cli %}.' +title: codespace の名前を変更する +intro: 'codespace の表示名は {% data variables.product.prodname_dotcom_the_website %} または {% data variables.product.prodname_cli %} から変更できます。' versions: fpt: '*' ghec: '*' @@ -10,69 +10,74 @@ topics: - Fundamentals - Developer shortTitle: Rename a codespace +ms.openlocfilehash: dcb4558cce7ca0768524917a46cde2a49bacd1ce +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158718' --- +## codespace の名前変更について -## About renaming a codespace +各 codespace には、自動生成された表示名が割り当てられます。 複数の codespace がある場合、表示名は codespace を区別するのに役立ちます。 (例: `literate space parakeet`)。 codespace の表示名を変更できます。 -Each codespace is assigned an auto-generated display name. If you have multiple codespaces, the display name helps you to differentiate between codespaces. For example: `literate space parakeet`. You can change the display name for your codespace. +codespace の表示名を見つけるには: -To find the display name of a codespace: +- {% data variables.product.product_name %} の https://github.com/codespaces で、codespace の一覧を表示します。 -- On {% data variables.product.product_name %}, view your list of codespaces at https://github.com/codespaces. + ![GitHub の codespace の一覧のスクリーンショット](/assets/images/help/codespaces/codespaces-list-display-name.png) - ![Screenshot of the list of codespaces in GitHub](/assets/images/help/codespaces/codespaces-list-display-name.png) +- {% data variables.product.prodname_vscode %} デスクトップ アプリケーションまたは {% data variables.product.prodname_vscode_shortname %} Web クライアントで、[リモート エクスプローラー] をクリックします。 表示名はリストの 2 番目の項目です。 たとえば、次のスクリーンショットの `symmetrical space telegram`。 -- In the {% data variables.product.prodname_vscode %} desktop application, or the {% data variables.product.prodname_vscode_shortname %} web client, click the Remote Explorer. The display name is the second item in the list. For example: `symmetrical space telegram` in the screenshot below. - - ![Screenshot of the Remote Explorer in VS Code](/assets/images/help/codespaces/codespaces-remote-explorer.png) + ![VS Code のリモート エクスプローラーのスクリーンショット](/assets/images/help/codespaces/codespaces-remote-explorer.png) {% indented_data_reference reusables.codespaces.remote-explorer spaces=2 %} -- In a terminal window on your local machine, use this {% data variables.product.prodname_cli %} command: `gh codespace list`. +- ローカル コンピューターのターミナル ウィンドウで、次の {% data variables.product.prodname_cli %} コマンドを使用します: `gh codespace list`。 -### Permanent codespace names +### 永続的な codespace 名 -In addition to the display name, when you create a codespace, a permanent name is also assigned to the codespace. The name is a combination of your {% data variables.product.company_short %} handle, and the auto-generated display name. For example: `octocat-literate-space-parakeet-mld5`. You can't change the permanent name. +表示名に加えて、codespace を作成するときに、永続的な名前も codespace に割り当てられます。 名前は {% data variables.product.company_short %} ハンドルと自動生成された表示名の組み合わせです。 (例: `octocat-literate-space-parakeet-mld5`)。 永続的な名前は変更できません。 -To find the permanent name of a codespace: +codespace の永続的な名前を見つけるには: -* On {% data variables.product.product_name %}, the permanent name is shown in a pop-up when you hover over the display name of a codespace on https://github.com/codespaces. +* {% data variables.product.product_name %} で、 https://github.com/codespaces の codespace の表示名にカーソルを合わせると、永続的な名前がポップアップに表示されます。 - ![Screenshot of the codespace name shown on hover over](/assets/images/help/codespaces/find-codespace-name-github.png) + ![カーソルを合わせると表示される codespace 名のスクリーンショット](/assets/images/help/codespaces/find-codespace-name-github.png) -* In a codespace, use this command in the terminal: `echo $CODESPACE_NAME`. -* In a terminal window on your local machine, use this {% data variables.product.prodname_cli %} command: `gh codespace list`. +* codespace では、ターミナルで次のコマンドを使用します: `echo $CODESPACE_NAME`。 +* ローカル コンピューターのターミナル ウィンドウで、次の {% data variables.product.prodname_cli %} コマンドを使用します: `gh codespace list`。 -## Renaming a codespace +## codespace の名前を変更する -Changing the display name of a codespace can be useful if you have multiple codespaces that you will be using for an extended period. An appropriate name helps you identify a codespace that you use for a particular purpose. +codespace の表示名を変更すると、長期間使用する複数の codespace がある場合に便利です。 適切な名前は、特定の目的に使用する codespace を識別するのに役立ちます。 {% cli %} -You can change the display name for your codespace by using the {% data variables.product.prodname_cli %}. +{% data variables.product.prodname_cli %} を使用して、codespace の表示名を変更できます。 -To rename a codespace, use the `gh codespace edit` subcommand: +codespace の名前を変更するには、`gh codespace edit` サブコマンドを使用します。 ```shell gh codespace edit -c PERMANENT-CODESPACE-NAME -d NEW-DISPLAY-NAME ``` -In this example, replace `PERMANENT-CODESPACE-NAME` with the permanent name of the codespace whose display name you want to change. Replace `NEW-DISPLAY-NAME` with the display name you want to use for this codespace. +この例では、`PERMANENT-CODESPACE-NAME` を、表示名を変更する codespace の永続的な名前に置き換えます。 `NEW-DISPLAY-NAME` を、この codespace に使用する表示名に置き換えます。 -For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli#rename-a-codespace)." +詳細については、「[{% data variables.product.prodname_github_codespaces %} と {% data variables.product.prodname_cli %} の使用](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli#rename-a-codespace)」を参照してください。 {% endcli %} {% webui %} -You can change the display name for your codespace on {% data variables.product.prodname_dotcom_the_website %}. +codespace の表示名は {% data variables.product.prodname_dotcom_the_website %} で変更できます。 {% data reusables.codespaces.your-codespaces-procedure-step %} The current display name for each of your codespaces is displayed. {% data reusables.codespaces.ellipsis-settings %} -1. Click **Rename**. +1. **[名前変更]** をクリックします。 -1. In the prompt, under "Change display name to..." type your desired display name and click **OK**. +1. プロンプトの "Change display name to..." に希望の表示名を入力し、 **[OK]** をクリックします。 -{% endwebui %} \ No newline at end of file +{% endwebui %} diff --git a/translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md b/translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md index ad415c4536..8b9b3d4b1b 100644 --- a/translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md +++ b/translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md @@ -1,5 +1,5 @@ --- -title: Setting your default editor for GitHub Codespaces +title: GitHub Codespaces の既定のエディターを設定する shortTitle: Set the default editor intro: '{% data reusables.codespaces.about-changing-default-editor %}' versions: @@ -11,40 +11,44 @@ redirect_from: topics: - Codespaces type: how_to +ms.openlocfilehash: 5c286ffe8f96d275dc0b20949a87b7ced411c9af +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159935' --- - -On the settings page, you can set your editor preference so that when you create a codespace, or open an existing codespace, it is opened in your choice of: +[設定] ページでは、codespace を作成したり既存の codespace を開いたりするときに、次のいずれかの方法で開くように、エディターの基本設定を設定できます。 * {% data variables.product.prodname_vscode %} (desktop application) * {% data variables.product.prodname_vscode %} (web client application) -* JetBrains Gateway - for opening codespaces in a JetBrains IDE -* JupyterLab - the web interface for Project Jupyter +* JetBrains Gateway - JetBrains IDE で codespace を開く場合 +* JupyterLab - Project Jupyter の Web インターフェイス {% data reusables.codespaces.template-codespaces-default-editor %} -If you want to use {% data variables.product.prodname_vscode %} as your default editor for {% data variables.product.prodname_github_codespaces %}, you need to install {% data variables.product.prodname_vscode %} and the {% data variables.product.prodname_github_codespaces %} extension for {% data variables.product.prodname_vscode %}. For more information, see the [download page for {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/download/) and the [{% data variables.product.prodname_github_codespaces %} extension on the {% data variables.product.prodname_vscode %} marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). +{% data variables.product.prodname_github_codespaces %} の既定のエディターとして {% data variables.product.prodname_vscode %} を使う場合は、{% data variables.product.prodname_vscode %} と、{% data variables.product.prodname_vscode %} 用の {% data variables.product.prodname_github_codespaces %} 拡張機能をインストールする必要があります。 詳しくは、[{% data variables.product.prodname_vscode %} のダウンロード ページ](https://code.visualstudio.com/download/)と、[{% data variables.product.prodname_vscode %} マーケットプレースの {% data variables.product.prodname_github_codespaces %} 拡張機能](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces)をご覧ください。 -If you want to work on a codespace in a JetBrains IDE you must install the JetBrains Gateway. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)." +JetBrains IDE の codespace で作業する場合は、JetBrains Gateway をインストールする必要があります。 詳しくは、「[JetBrains IDE で {% data variables.product.prodname_github_codespaces %} を使う](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)」をご覧ください。 -## Setting your default editor +## 既定のエディターを設定する -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Editor preference", select the option you want. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. [Editor preference]\(エディターの基本設定\) で、必要なオプションを選びます。 - ![Setting your editor](/assets/images/help/codespaces/select-default-editor.png) + ![エディターの設定](/assets/images/help/codespaces/select-default-editor.png) * {% data reusables.codespaces.application-installed-locally %}

- * If you choose **{% data variables.product.prodname_vscode %}**, {% data variables.product.prodname_github_codespaces %} will automatically open in the desktop application when you next create or open a codespace. + * **{% data variables.product.prodname_vscode %}** を選ぶ場合、codespace を次回作成するか開いたときに、デスクトップ アプリケーションで {% data variables.product.prodname_github_codespaces %} が自動的に開きます。 - You may need to allow access to both your browser and {% data variables.product.prodname_vscode %} for it to open successfully.

+ 正常に開かれるには、ブラウザーと {% data variables.product.prodname_vscode %} の両方へのアクセスを許可することが必要な場合があります。

- * If you choose **JetBrains Gateway**, the Gateway application will automatically open when you next create or open a codespace. + * **JetBrains Gateway** を選ぶ場合、codespace を次回作成するか開いたときに、Gateway アプリケーションが自動的に開きます。 - The first time you open a codespace this way you must give permission to open the application. + この方法で初めて codespace を開いたときは、アプリケーションを開く権限を付与する必要があります。 - The Gateway application will open and the codespace will then be automatically selected. You can then choose a JetBrains IDE, if you have not previously done so, and click **Connect** to open the codespace in the JetBrains client. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)." + Gateway が自動的に開いてから、codespace が自動的に選択されます。 その後、JetBrains IDE をこれまでに選んでいなければ、これを選び、 **[接続]** をクリックして、JetBrains クライアント内にある codespace を開きます。 詳しくは、「[JetBrains IDE で {% data variables.product.prodname_github_codespaces %} を使う](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)」をご覧ください。 - To connect to a codespace from the Gateway application, you must have an SSH server running on the codespace. {% indented_data_reference reusables.codespaces.ssh-server-installed spaces=5 %} + Gateway アプリケーションから codespace に接続するには、codespace で実行されている SSH サーバーが必要です。 {% indented_data_reference reusables.codespaces.ssh-server-installed spaces=5 %} - * If you choose **JupyterLab**, the JupyterLab application must be installed in the codespaces you open. {% data reusables.codespaces.jupyterlab-in-default-image %} + * **JupyterLab** を選ぶ場合は、開いている codespace に JupyterLab をインストールする必要があります。 {% data reusables.codespaces.jupyterlab-in-default-image %} diff --git a/translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces.md b/translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces.md index ab0e7be5ee..756ddc0a25 100644 --- a/translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces.md +++ b/translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces.md @@ -1,7 +1,7 @@ --- -title: Setting your timeout period for GitHub Codespaces +title: GitHub Codespaces のタイムアウト期間を設定する shortTitle: Set the timeout -intro: 'You can set your default timeout for {% data variables.product.prodname_github_codespaces %} in your personal settings page.' +intro: '個人用設定ページで、{% data variables.product.prodname_github_codespaces %} の既定のタイムアウトを設定できます。' versions: fpt: '*' ghec: '*' @@ -10,53 +10,57 @@ topics: type: how_to redirect_from: - /codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces +ms.openlocfilehash: 6ca559fefddc34eb6de0441d17344ff8054db509 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159928' --- +## アイドル タイムアウトについて -## About the idle timeout - -A codespace will stop running after a period of inactivity. By default this period is 30 minutes, but you can specify a longer or shorter default timeout period in your personal settings on {% data variables.product.prodname_dotcom %}. The updated setting will apply to any new codespaces you create, or to existing codespaces the next time you start them. You can also specify a timeout when you use {% data variables.product.prodname_cli %} to create a codespace. +非アクティブな期間が経過すると、codespace の実行が停止します。 既定では、この期間は 30 分間ですが、{% data variables.product.prodname_dotcom %} で、個人用設定での既定のタイムアウト期間をより長くまたは短く指定することができます。 更新された設定は、作成した新しい codespace に、または次回開始するときに既存の codespace に適用されます。 また、{% data variables.product.prodname_cli %} を使って codespace を作成するときに、タイムアウトを指定することもできます。 {% warning %} -**Warning**: Codespaces compute usage is billed for the duration for which a codespace is active. If you're not using a codespace but it remains running, and hasn't yet timed out, you are billed for the total time that the codespace was active, irrespective of whether you were using it. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)." +**警告**: codespace コンピューティング使用量は、codespace がアクティブな期間に対して課金されます。 codespace を使ってはいないものの、実行中のままであり、まだタイムアウトしていない場合は、codespace を使っているかどうかにかかわらず、codespace がアクティブだった合計時間に対して課金されます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)」をご覧ください。 {% endwarning %} -### Timeout periods for organization-owned repositories +### Organization が所有するリポジトリのタイムアウト期間 -Organizations can set a maximum idle timeout policy for codespaces created from some or all of their repositories. If an organization policy sets a maximum timeout which is less than the default timeout you have set, the organization's timeout will be used instead of your setting. You will be notified of this after the codespace is created. For more information, see "[Restricting the idle timeout period](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)." +Organization は、そのリポジトリの一部またはすべてから作成された codespace に対して、最大アイドル タイムアウト ポリシーを設定できます。 Organization ポリシーによって最大タイムアウトが設定され、それがユーザーによって設定された既定のタイムアウトよりも短い場合、ユーザーが設定したものではなく、Organization のタイムアウトが使用されます。 このことは、codespace が作成されるとユーザーに通知されます。 詳細については、「[アイドル タイムアウト期間の制限](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)」を参照してください。 {% webui %} -## Setting your default timeout period +## 既定のタイムアウト期間を設定する -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Default idle timeout", enter the time that you want, then click **Save**. The time must be between 5 minutes and 240 minutes (4 hours). - ![Selecting your timeout](/assets/images/help/codespaces/setting-default-timeout.png) +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. [既定のアイドル タイムアウト] の下に必要な時間を入力し、 **[保存]** をクリックします。 時間は 5 分から 240 分 (4 時間) の間で指定する必要があります。 + ![タイムアウトの選択](/assets/images/help/codespaces/setting-default-timeout.png) {% endwebui %} {% cli %} -## Setting the timeout period for a codespace +## codespace のタイムアウト期間を設定する {% data reusables.cli.cli-learn-more %} -To set the timeout period when you create a codespace, use the `idle-timeout` argument with the `codespace create` subcommand. Specify the time in minutes, followed by `m`. The time must be between 5 minutes and 240 minutes (4 hours). +codespace の作成時にタイムアウト期間を設定するには、`codespace create` サブコマンドで `idle-timeout` 引数を使用します。 時間を分単位で指定します (後ろに `m` を付けます)。 時間は 5 分から 240 分 (4 時間) の間で指定する必要があります。 ```shell gh codespace create --idle-timeout 90m ``` -If you don't specify a timeout period when you create a codespace, then the default timeout period will be used. For information about setting a default timeout period, click the "Web browser" tab on this page. You can't currently specify a default timeout period through {% data variables.product.prodname_cli %}. +codespace を作成するときにタイムアウト期間を指定しない場合は、既定のタイムアウト期間が使用されます。 既定のタイムアウト期間の設定については、このページの [Web ブラウザー] タブをクリックしてください。 現在、{% data variables.product.prodname_cli %} を使用して既定のタイムアウト期間を指定することはできません。 {% endcli %} {% vscode %} -## Setting a timeout period +## タイムアウト期間を設定する -You can set your default timeout period in your web browser, on {% data variables.product.prodname_dotcom_the_website %}. Alternatively, if you use {% data variables.product.prodname_cli %} to create a codespace you can set a timeout period for that particular codespace. For more information, click the appropriate tab above. +既定のタイムアウト期間は、Web ブラウザー内の {% data variables.product.prodname_dotcom_the_website %} で設定できます。 また、codespace を {% data variables.product.prodname_cli %} を使って作成する場合は、その特定の codespace のタイムアウト期間を設定できます。 詳しくは、上記の該当するタブをクリックしてください。 {% endvscode %} diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/connecting-to-a-private-network.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/connecting-to-a-private-network.md index bdaddaa45e..a00c508b05 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/connecting-to-a-private-network.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/connecting-to-a-private-network.md @@ -1,6 +1,6 @@ --- -title: Connecting to a private network -intro: 'You can connect {% data variables.product.prodname_github_codespaces %} to resources on a private network, including package registries, license servers, and on-premises databases.' +title: プライベート ネットワークへの接続 +intro: '{% data variables.product.prodname_github_codespaces %} は、パッケージ レジストリ、ライセンス サーバー、オンプレミス データベースなど、プライベート ネットワーク上のリソースに接続できます。' versions: fpt: '*' ghec: '*' @@ -9,51 +9,56 @@ topics: - Codespaces - Fundamentals - Developer +ms.openlocfilehash: 92b8f2b9ea438a4cc799aec1969ff6773f90c298 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159927' --- +## codespace ネットワークについて -## About codespace networking +既定では、codespace から、パブリック インターネット上のすべてのリソース (パッケージ マネージャー、ライセンス サーバー、データベース、クラウド プラットフォーム API を含みます) にアクセスできますが、プライベート ネットワーク上のリソースにはアクセスできません。 -By default, your codespaces have access to all resources on the public internet, including package managers, license servers, databases, and cloud platform APIs, but they have no access to resources on private networks. +## プライベート ネットワーク上のリソースへの接続 -## Connecting to resources on a private network +現在、{% data variables.product.prodname_github_codespaces %} 内のプライベート ネットワーク上のリソースにアクセスする方法は 2 つあります。 +- {% data variables.product.prodname_cli %} 拡張機能を使用して、ローカル コンピューターをリモート リソースへのゲートウェイとして構成する。 +- VPN を使用する。 -There are currently two methods of accessing resources on a private network within {% data variables.product.prodname_github_codespaces %}. -- Using a {% data variables.product.prodname_cli %} extension to configure your local machine as a gateway to remote resources. -- Using a VPN. - -### Using the GitHub CLI extension to access remote resources +### GitHub CLI 拡張機能を使用してリモート リソースにアクセスする {% note %} -**Note**: The {% data variables.product.prodname_cli %} extension is currently in beta and subject to change. +**注:** {% data variables.product.prodname_cli %} 拡張機能は現在ベータ段階であり、変更されることがあります。 {% endnote %} -The {% data variables.product.prodname_cli %} extension allows you to create a bridge between a codespace and your local machine, so that the codespace can access any remote resource that is accessible from your machine. The codespace uses your local machine as a network gateway to reach those resources. For more information, see "[Using {% data variables.product.prodname_cli %} to access remote resources](https://github.com/github/gh-net#codespaces-network-bridge)." +{% data variables.product.prodname_cli %} 拡張機能を使用すると、codespace とご自分のローカル コンピューターの間にブリッジを作成し、コンピューターからアクセスできるあらゆるリモート リソースに codespace がアクセスできるようにすることができます。 codespace は、ローカル コンピューターをネットワーク ゲートウェイとして使用して、それらのリソースに到達します。 詳しくは、[{% data variables.product.prodname_cli %} を使用してリモート リソースにアクセスする](https://github.com/github/gh-net#codespaces-network-bridge)方法に関するページを参照してください。 -### Using a VPN to access resources behind a private network +### VPN を使ってプライベート ネットワークの背後にあるリソースにアクセスする -As an alternative to the {% data variables.product.prodname_cli %} extension, you can use a VPN to access resources behind a private network from within your codespace. +{% data variables.product.prodname_cli %} 拡張機能の代わりに、VPN を使用して、codespace 内からプライベート ネットワークの背後にあるリソースにアクセスできます。 -We recommend VPN tools like [OpenVPN](https://openvpn.net/) to access resources on a private network. For more information, see "[Using the OpenVPN client from {% data variables.product.prodname_github_codespaces %}](https://github.com/codespaces-contrib/codespaces-openvpn)." +プライベート ネットワーク上のリソースにアクセスするには、[OpenVPN](https://openvpn.net/) などの VPN ツールをお勧めします。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} からの OpenVPN クライアントを使う](https://github.com/codespaces-contrib/codespaces-openvpn)」をご覧ください。 -There are also a number of third party solutions that, while not explicitly endorsed by {% data variables.product.prodname_dotcom %}, have provided examples of how to integrate with {% data variables.product.prodname_github_codespaces %}. +また、{% data variables.product.prodname_dotcom %} で積極的にお勧めしているわけではありませんが、{% data variables.product.prodname_github_codespaces %} と統合する方法の例を示すサード パーティ ソリューションもいくつかあります。 -These third party solutions include: +これらのサード パーティ ソリューションには、次のものが含まれます。 - [Tailscale](https://tailscale.com/kb/1160/github-codespaces/) -### Allowlisting private resources for codespaces +### codespace のプライベート リソースを許可リストに載せる -While {% data variables.product.prodname_dotcom %} publishes IP ranges for several products on its Meta API, codespaces IPs are dynamically assigned, meaning your codespace is not guaranteed to have the same IP address day to day. We highly discourage users from allowlisting an entire IP range, as this would give overly broad access to all codespaces (including users not affiliated with your codespaces). +{% data variables.product.prodname_dotcom %} では、Meta API で、いくつかの製品の IP 範囲を発行していますが、codespace IP は動的に割り当てられます。つまり、codespace の IP アドレスが毎日同じとは限らないということです。 ユーザーが IP 範囲全体を許可リストに載せてしまうと、そのユーザーの codespace に関係のないユーザーも、すべての codespace にアクセスできるようになってしまうため、お勧めしません。 -For more information about the Meta API, see "[Meta](/rest/reference/meta)." +Meta API の詳しい情報については、「[メタ情報](/rest/reference/meta)」を参照してください。 -## Restricting access to the public internet +## パブリック インターネットへのアクセスを制限する -At present, there is no way to restrict codespaces from accessing the public internet, or to restrict appropriately authenticated users from accessing a forwarded port. +現時点では、パブリック インターネットからの codespace へのアクセスを制限したり、認証されたユーザーが転送されたポートにアクセスできないように適切に制限したりする方法はありません。 -For more information on how to secure your codespaces, see "[Security in {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/security-in-github-codespaces)." +codespace をセキュリティで保護する方法について詳しくは、「[{% data variables.product.prodname_github_codespaces %} のセキュリティ](/codespaces/codespaces-reference/security-in-github-codespaces)」をご覧ください。 diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository.md new file mode 100644 index 0000000000..e4492c0bb6 --- /dev/null +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository.md @@ -0,0 +1,145 @@ +--- +title: Creating a codespace for a repository +intro: You can create a codespace for a branch in a repository to develop online. +redirect_from: + - /github/developing-online-with-github-codespaces/creating-a-codespace + - /github/developing-online-with-codespaces/creating-a-codespace + - /codespaces/developing-in-codespaces/creating-a-codespace +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Fundamentals + - Developer +shortTitle: Create a codespace for a repo +--- + +## About creating a codespace for a repository + +{% data reusables.codespaces.ways-to-create-a-codespace %} Use the tabs in this article to display instructions for each of these ways of creating a codespace. + +{% data reusables.codespaces.starting-new-project-template %} For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)." + +{% note %} + +**Note**: If you use a JetBrains IDE, you can use {% data variables.product.prodname_cli %} to create a codespace. You can then use the JetBrains Gateway application to open the codespace in a JetBrains IDE. For more information, see "[Using Codespaces in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)." + +{% endnote %} + +You can use {% data variables.product.prodname_github_codespaces %} on your personal {% data variables.product.prodname_dotcom_the_website %} account, with the quota of free use included each month for accounts on the Free and Pro plans. {% data reusables.codespaces.codespaces-continue-by-paying %} + +Organizations can enable members and outside collaborators to create and use codespaces at the organization's expense. For more information, see "[Enabling {% data variables.product.prodname_github_codespaces %} for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)." + +{% data reusables.codespaces.codespaces-are-personal %} + +If you create a codespace from a repository, the codespace will be associated with a specific branch, which cannot be empty. You can create more than one codespace per repository or even per branch. + +{% data reusables.codespaces.you-can-see-all-your-codespaces %} + +### The codespace creation process + +When you create a codespace, a number of steps happen to create and connect you to your development environment: + +- Step 1: VM and storage are assigned to your codespace. +- Step 2: Container is created and your repository is cloned. +- Step 3: You can connect to the codespace. +- Step 4: Codespace continues with post-creation setup. + +For more information on what happens when you create a codespace, see "[Deep Dive](/codespaces/getting-started/deep-dive)." + +For more information on the lifecycle of a codespace, see "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)." + +If you want to use Git hooks for your codespace, then you should set up hooks using the [`devcontainer.json` lifecycle scripts](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts), such as `postCreateCommand`, during step 4. Since your codespace container is created after the repository is cloned, any [git template directory](https://git-scm.com/docs/git-init#_template_directory) configured in the container image will not apply to your codespace. Hooks must instead be installed after the codespace is created. For more information on using `postCreateCommand`, see the [`devcontainer.json` reference](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) in the {% data variables.product.prodname_vscode_shortname %} documentation. + +{% data reusables.codespaces.use-visual-studio-features %} + +{% data reusables.codespaces.prebuilds-crossreference %} + +## Creating a codespace for a repository + +{% webui %} + +{% data reusables.repositories.navigate-to-repo %} +1. Under the repository name, use the "Branch" dropdown menu, and select the branch you want to create a codespace for. + + ![Branch dropdown menu](/assets/images/help/codespaces/branch-drop-down.png) + +1. Click the **{% octicon "code" aria-label="The code icon" %} Code** button, then click the **Codespaces** tab. + + ![New codespace button](/assets/images/help/codespaces/new-codespace-button.png) + + If codespaces for this repository are billable to an organization, or its parent enterprise, a message is displayed below the **Create codespace on BRANCH** button telling you who will pay for the codespace. + +1. Create your codespace, either using the default options, or after configuring advanced options: + + * **Use the default options** + + To create a codespace using the default options, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}). Alternatively, if you don't currently have any codespaces for this repository, you can click **Create codespace on BRANCH**. + + * **Configure options** + + To configure advanced options for your codespace, such as a different machine type or a particular `devcontainer.json` file: + + 1. Click the ellipsis (**...**) at the top right of the **Codespaces** tab and select **New with options**. + + ![View the default machine type](/assets/images/help/codespaces/default-machine-type.png) + + 1. On the options page for your codespace, choose your preferred options from the dropdown menus. + + ![The codespace options page](/assets/images/help/codespaces/advanced-options.png) + + {% note %} + + **Notes** + + * You can bookmark the options page to give you a quick way to create a codespace for this repository and branch. + * The [https://github.com/codespaces/new](https://github.com/codespaces/new) page provides a quick way to create a codespace for any repository and branch. You can get to this page quickly by typing `codespace.new` into your browser's address bar. + * For more information about the `devcontainer.json` file, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)." + * For more information about machine types, see "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)." + * {% data reusables.codespaces.codespaces-machine-type-availability %} + + {% endnote %} + + 1. Click **Create codespace**. + +{% endwebui %} + +{% vscode %} + +{% data reusables.codespaces.creating-a-codespace-in-vscode %} + +{% endvscode %} + +{% cli %} + +{% data reusables.cli.cli-learn-more %} + +To create a new codespace, use the `gh codespace create` subcommand. + +```shell +gh codespace create +``` + +You are prompted to choose a repository. If codespaces for this repository are billable to an organization, or its parent enterprise, a message is displayed telling you who will pay for the codespace. You are then prompted to choose a branch, a dev container configuration file (if more than one is available), and a machine type (if more than one is available). + +Alternatively, you can use flags to specify some or all of the options: + +```shell +gh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE +``` + +In this example, replace `owner/repo` with the repository identifier. Replace `branch` with the name of the branch, or the full SHA hash of the commit, that you want to be initially checked out in the codespace. If you use the `-r` flag without the `b` flag, the codespace is created from the default branch. + +Replace `path` with the path to the dev container configuration file you want to use for the new codespace. If you omit this flag and more than one dev container file is available you will be prompted to choose one from a list. For more information about the dev container configuration file, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." + +Replace `machine-type` with a valid identifier for an available machine type. Identifiers are strings such as: `basicLinux32gb` and `standardLinux32gb`. The type of machines that are available depends on the repository, your personal account, and your location. If you enter an invalid or unavailable machine type, the available types are shown in the error message. If you omit this flag and more than one machine type is available you will be prompted to choose one from a list. + +For full details of the options for this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_create). + +{% endcli %} + +## Further reading +- "[Opening an existing codespace](/codespaces/developing-in-codespaces/opening-an-existing-codespace)" +- "[Adding an 'Open in {% data variables.product.prodname_github_codespaces %}' badge](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)" diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template.md new file mode 100644 index 0000000000..1f90ae0e98 --- /dev/null +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template.md @@ -0,0 +1,102 @@ +--- +title: Creating a codespace from a template +intro: If you're starting a new project, you can create a codespace from a blank template or choose a template specially designed for the type of work you want to do. +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Fundamentals + - Developer +shortTitle: Create a codespace from a template +miniTocMaxHeadingLevel: 3 +--- + +## About templates for {% data variables.product.prodname_github_codespaces %} + +If you're starting a new project, you can get started with development work quickly by creating a codespace from a template. You'll be able to work on your project in a cloud-based development environment, save your files in the cloud, and publish your work to a new remote repository that you can share with others or clone to your local machine. + +{% note %} + +**Note**: Codespaces created from a template, rather than from a repository, are always billed to your personal account. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." + +{% endnote %} + +You can start from a blank template, choose from templates maintained by {% data variables.product.company_short %} for popular technologies such as React or Jupyter Notebook, or launch a codespace from any template repository on {% data variables.product.prodname_dotcom %}. With a blank template, you'll start with an empty directory, with access to cloud-based compute resources and the tools, languages, and runtime environments that come preinstalled with the default codespace image. With other templates, you'll get starter files for the technology you're working with, plus typically some extra files such as a README file, a `.gitignore` file, and dev container configuration files containing some custom environment configuration. For more information on dev containers and the default image, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." + +As an example, if you create a codespace from {% data variables.product.company_short %}'s React template, you'll arrive in a workspace containing template files for a simple application, such as `index.js`, `app.js`, and `package.json`. Shortly after the codespace opens, a development server will start up automatically, and you will be able to view the running application in a simple browser tab within the {% data variables.product.prodname_vscode_shortname %} web client. + +![Screenshot of the React template running in a codespace](/assets/images/help/codespaces/react-template.png) + +The files and configuration included in templates are defined in template repositories. The template repository is cloned into your codespace when you create the codespace. After that, the link is severed, and your codespace won't be linked to a remote repository until you publish to one. + +{% tip %} + +**Tip:** To help people get started with your framework, library, or other project, you can set up a template repository for use with {% data variables.product.prodname_github_codespaces %}. 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)." + +{% endtip %} + +## Creating a codespace from a {% data variables.product.company_short %} template + +Templates maintained by {% data variables.product.company_short %}, including the blank template, are available from the "Your codespaces" page. + +{% data reusables.codespaces.your-codespaces-procedure-step %} +{% data reusables.codespaces.view-all-templates-step %} +1. Optionally, to view the template repository containing the files for a template, click the name of the template. + + ![Screenshot of the "Explore quick start templates" section, with "React" highlighted](/assets/images/help/codespaces/react-template-name.png) + +1. Under the template you want to launch, click **Use this template**. + + ![Screenshot of the quick start templates, with the "Use this template" button highlighted under the React template](/assets/images/help/codespaces/react-template-button.png) + +{% data reusables.codespaces.template-codespaces-default-editor %} + +## Creating a codespace from a template repository + +You can create a codespace from any template repository, then publish your work to a new repository when you are ready. For more information on template repositories, see "[Creating a repository from a template](/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template#about-repository-templates)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.codespaces.open-template-in-codespace-step %} + + {% note %} + + **Note:** If you're a maintainer of the template repository, and want to commit changes to the template repository itself, you should create a codespace from the **{% octicon "code" aria-label="The code icon" %} Code** dropdown. 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)." + + {% endnote %} + +{% data reusables.codespaces.template-codespaces-default-editor %} + +## Publishing to a repository on {% data variables.product.product_name %} + +{% data reusables.codespaces.about-publishing-templates %} + +### Publishing from {% data variables.product.prodname_vscode_shortname %} + +{% data reusables.codespaces.publishing-template-codespaces %} + +When a codespace is published, you have access to a greater range of options to customize your {% data variables.product.prodname_github_codespaces %} experience. For example, you can: + +- Change the machine type of your codespace to make sure you're using resources appropriate for the work you're doing (see "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)"). +- Allow {% data variables.product.prodname_dotcom %} to automatically use GPG to sign commits you make in your codespace (see "[Managing GPG verification for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)"). +- Share encrypted secrets with your codespace (see "[Managing encrypted secrets for your codespaces](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)"). + +### Publishing from {% data variables.product.prodname_dotcom_the_website %} + +You can publish an unpublished codespace from the "Your codespaces" page on {% data variables.product.prodname_dotcom_the_website %}. This is useful if you want to publish a codespace that you don't currently have open in your browser. If you do this, your work will be preserved in a repository, but there won't be a link between your existing codespace and the new repository. However, you can navigate to the new repository and create a codespace from there, and this codespace will be connected to the repository. + +{% data reusables.codespaces.your-codespaces-procedure-step %} +1. Next to the unpublished codespace, click the ellipsis (**...**), then select **Publish to a new repository**. + + ![Screenshot of the "Publish to a new repository" button](/assets/images/help/codespaces/publish-to-new-repository.png) +1. Choose a name for your new repository, set it as **Public** or **Private**, and click **Create repository**. + + ![Screenshot of the "Publish to a new repository" dropdown](/assets/images/help/codespaces/template-new-repository-settings.png) +1. Optionally, to view the new repository, click **See repository**. + +## Further reading + +- "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)" +- "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" +- "[Using source control in your codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)" \ No newline at end of file diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/deleting-a-codespace.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/deleting-a-codespace.md index c004006e66..1df68e4964 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/deleting-a-codespace.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/deleting-a-codespace.md @@ -1,6 +1,6 @@ --- -title: Deleting a codespace -intro: You can delete a codespace you no longer need. +title: codespace を削除する +intro: 不要になった codespace を削除することができます。 redirect_from: - /github/developing-online-with-github-codespaces/deleting-a-codespace - /github/developing-online-with-codespaces/deleting-a-codespace @@ -13,28 +13,33 @@ topics: - Fundamentals - Developer shortTitle: Delete a codespace +ms.openlocfilehash: c9f1f6eb407c985d8981504de28e39a4bf742f7a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158662' --- - -You can delete a codespace in a variety of ways: in the terminal by using {% data variables.product.prodname_cli %}, in {% data variables.product.prodname_vscode %}, or in your web browser. Use the tabs in this article to display instructions for each of these ways of deleting a codespace. +codespace はさまざまな方法で削除できます。たとえば、ターミナルで {% data variables.product.prodname_cli %} を使用して、{% data variables.product.prodname_vscode %} で、または、お使いの Web ブラウザーで削除できます。 この記事のタブを使用し、codespace を削除する各種方法の手順を表示してください。 {% note %} -**Note**: You can't delete a codespace from within the JetBrains Gateway, or the JetBrains client application, or from within JupyterLab. +**注**: codespace は JetBrains Gateway、JetBrains クライアント アプリケーション、JupyterLab 内から削除できません。 {% endnote %} -There are costs associated with storing codespaces. You should therefore delete any codespaces you no longer need. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." +codespace の格納にはコストがかかります。 そのため、不要になった codespace は削除する必要があります。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」をご覧ください。 {% data reusables.codespaces.max-number-codespaces %} -## Deleting a codespace +## codespace を削除する {% webui %} {% data reusables.codespaces.your-codespaces-procedure-step %} -1. To the right of the codespace you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **{% octicon "trash" aria-label="The trash icon" %} Delete** +1. 削除する codespace の右側で [{% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}] をクリックし、 **[{% octicon "trash" aria-label="The trash icon" %} 削除]** をクリックします。 - ![Delete button](/assets/images/help/codespaces/delete-codespace.png) + ![[削除] ボタン](/assets/images/help/codespaces/delete-codespace.png) {% endwebui %} @@ -49,48 +54,48 @@ There are costs associated with storing codespaces. You should therefore delete {% data reusables.cli.cli-learn-more %} -To delete a codespace use the `gh codespace delete` subcommand and then choose a codespace from the list that's displayed. +codespace を削除するには、`gh codespace delete` サブコマンドを使用し、表示されるリストから codespace を選択します。 ```shell gh codespace delete ``` -If you have unsaved changes, you'll be prompted to confirm deletion. You can use the `--force` flag to force deletion, avoiding this prompt. +保存していない変更がある場合は、削除の確認を求めるメッセージが表示されます。 `--force` フラグを使用すると、このプロンプトを回避して強制的に削除できます。 -For more information about this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_delete). +このコマンドの詳細については、[{% data variables.product.prodname_cli %} に関するマニュアル](https://cli.github.com/manual/gh_codespace_delete)を参照してください。 {% endcli %} -## Bulk deleting codespaces +## codespace の一括削除 {% webui %} -You can use {% data variables.product.prodname_cli %} to delete several or all of your codespaces with a single command. For more information, click the "{% data variables.product.prodname_cli %}" tab near the top of this page. +{% data variables.product.prodname_cli %} を使用すると、1 つのコマンドで複数またはすべての codespace を削除できます。 詳細については、このページの上部にある [{% data variables.product.prodname_cli %}] タブをクリックしてください。 {% endwebui %} {% vscode %} -You can use {% data variables.product.prodname_cli %} to delete several or all of your codespaces with a single command. For more information, click the "{% data variables.product.prodname_cli %}" tab near the top of this page. +{% data variables.product.prodname_cli %} を使用すると、1 つのコマンドで複数またはすべての codespace を削除できます。 詳細については、このページの上部にある [{% data variables.product.prodname_cli %}] タブをクリックしてください。 {% endvscode %} {% cli %} -You can delete several or all of your codespaces with a single command, using `gh codespace delete` followed by one of these flags: +`gh codespace delete` の後に次のフラグのいずれかを使用すると、1 つのコマンドを使用して、複数またはすべての codespace を削除できます。 -`--all` - Delete all of your codespaces. +`--all` - すべての codespace を削除します。 -`--repo REPOSITORY` - Delete all of your codespaces for this repository. Or use together with the `--days` flag to filter by age of the codespace. +`--repo REPOSITORY` - このリポジトリのすべての codespace を削除します。 または、`--days` フラグと共に使用して、codespace の経過時間でフィルターします。 -`--days NUMBER` - Delete all of your codespaces that are older than the specified number of days. Can be used together with the `--repo` flag. +`--days NUMBER` - 指定した日数より古い codespace をすべて削除します。 `--repo` フラグと共に使用できます。 -By default you are prompted to confirm deletion of any codespaces that contain unsaved changes. You can use the `--force` flag to skip this confirmation. +既定では、保存されていない変更を含む codespace の削除を確認するメッセージが表示されます。 `--force` フラグを使用して、この確認をスキップできます。 -### Example +### 例 -Delete all of the codespaces for the `octo-org/octo-repo` repository that you created more than 7 days ago. +7 日以上前に作成した `octo-org/octo-repo` リポジトリのすべての codespace を削除します。 ``` gh codespace delete --repo octo-org/octo-repo --days 7 @@ -98,37 +103,37 @@ gh codespace delete --repo octo-org/octo-repo --days 7 {% endcli %} -## Deleting codespaces in your organization +## 組織内の codespace を削除する -As an organization owner, you can use {% data variables.product.prodname_cli %} to delete any codespace in your organization. +組織の所有者は、{% data variables.product.prodname_cli %} を使用して、組織内の任意の codespace を削除できます。 {% webui %} -For more information, click the "{% data variables.product.prodname_cli %}" tab near the top of this page. +詳細については、このページの上部にある [{% data variables.product.prodname_cli %}] タブをクリックしてください。 {% endwebui %} {% vscode %} -For more information, click the "{% data variables.product.prodname_cli %}" tab near the top of this page. +詳細については、このページの上部にある [{% data variables.product.prodname_cli %}] タブをクリックしてください。 {% endvscode %} {% cli %} -1. Enter one of these commands to display a list of codespaces. - * `gh codespace delete --org ORGANIZATION` - Lists the current codespaces in the specified organization. - * `gh codespace delete --org ORGANIZATION --user USER` - Lists only those codespaces created by the specified user. - You must be an owner of the specified organization. -1. In the list of codespaces, navigate to the codespace you want to delete. -1. To delete the selected codespace press Enter. +1. 次のいずれかのコマンドを入力して、codespace の一覧を表示します。 + * `gh codespace delete --org ORGANIZATION` - 指定した組織内の現在の codespace を一覧表示します。 + * `gh codespace delete --org ORGANIZATION --user USER` - 指定したユーザーが作成した codespace のみを一覧表示します。 + 自分が指定した組織の所有者である必要があります。 +1. codespace の一覧で、削除したい codespace に移動します。 +1. 選択した codespace を削除するには、Enter キーを押します。 - If the codespace contains unsaved changes you will be prompted to confirm deletion. + codespace に未保存の変更が含まれている場合は、削除の確認を求めるメッセージが表示されます。 {% endcli %} -You can also use the REST API to delete codespaces for your organization. For more information, see "[Codespaces organizations](/rest/codespaces/organizations#delete-a-codespace-from-the-organization)." +REST API を使用して組織の codespace を削除することもできます。 詳細については、[codespace 組織](/rest/codespaces/organizations#delete-a-codespace-from-the-organization)に関する記事を参照してください。 -## Further reading -- "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" -- "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)" +## 参考資料 +- 「[codespace のライフサイクル](/codespaces/developing-in-codespaces/the-codespace-lifecycle)」 +- [codespace の自動削除の構成](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces) diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/developing-in-a-codespace.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/developing-in-a-codespace.md index 0de2f28409..d361dc0d37 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/developing-in-a-codespace.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/developing-in-a-codespace.md @@ -1,6 +1,6 @@ --- -title: Developing in a codespace -intro: 'You can work in a codespace using your browser, {% data variables.product.prodname_vscode %}, a JetBrains IDE, or in a command shell.' +title: codespace で開発する +intro: 'codespace の作業は、ブラウザー、{% data variables.product.prodname_vscode %}、JetBrains IDE を使うか、コマンド シェルで行うことができます。' redirect_from: - /github/developing-online-with-github-codespaces/developing-in-a-codespace - /github/developing-online-with-codespaces/developing-in-a-codespace @@ -13,127 +13,129 @@ topics: - Fundamentals - Developer shortTitle: Develop in a codespace +ms.openlocfilehash: e941373ade8c2f8365e7b654733b7ee029a6a7dd +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159070' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -## About development with {% data variables.product.prodname_github_codespaces %} +## {% data variables.product.prodname_github_codespaces %} での開発について -You can develop code in a codespace using your choice of tool: +codespace のコード開発には、お好みのツールを使うことができます。 -* A command shell, via an SSH connection initiated using {% data variables.product.prodname_cli %}. -* One of the JetBrains IDEs, via the JetBrains Gateway. -* The {% data variables.product.prodname_vscode %} desktop application. -* A browser-based version of {% data variables.product.prodname_vscode %}. +* {% data variables.product.prodname_cli %} を使って開始され、SSH 接続を介したコマンド シェル。 +* JetBrains Gateway を介した、JetBrains IDE のいずれか。 +* {% data variables.product.prodname_vscode %} デスクトップ アプリケーション。 +* {% data variables.product.prodname_vscode %} のブラウザーベース バージョン。 {% webui %} -The tabs in this article allow you to switch between information for each of these ways of working. You're currently on the tab for the web browser version of {% data variables.product.prodname_vscode %}. +これらの作業方法についてはそれぞれ、この記事のタブを使って情報を切り替えることができます。 現在は、{% data variables.product.prodname_vscode %} の Web ブラウザー バージョンのタブが表示されています。 -## Working in a codespace in the browser +## ブラウザー内の codespace で作業する -Using {% data variables.product.prodname_codespaces %} in the browser provides you with a fully featured development experience. You can edit code, debug, use Git commands, and run your application. +ブラウザー内で {% data variables.product.prodname_codespaces %} を使うと、フル機能の開発エクスペリエンスを利用できます。 コードの編集、デバッグ、Git コマンドの使用、アプリケーションの実行を利用できます。 -![Annotated screenshot of a codespace in the browser](/assets/images/help/codespaces/codespace-overview-annotated.png) +![ブラウザー内の codespace の注釈付きのスクリーンショット](/assets/images/help/codespaces/codespace-overview-annotated.png) -{% data reusables.codespaces.vscode-interface-annotation %} -{% data reusables.codespaces.use-chrome %} For more information, see "[Troubleshooting {% data variables.product.prodname_github_codespaces %} clients](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)." -{% data reusables.codespaces.developing-in-vscode %} -{% data reusables.codespaces.navigating-to-a-codespace %} +{% data reusables.codespaces.vscode-interface-annotation %} {% data reusables.codespaces.use-chrome %} 詳しくは、「[{% data variables.product.prodname_github_codespaces %} クライアントのトラブルシューティング](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)」を参照してください。 +{% data reusables.codespaces.developing-in-vscode %} {% data reusables.codespaces.navigating-to-a-codespace %} {% endwebui %} {% vscode %} -The tabs in this article allow you to switch between information for each of these ways of working. You're currently on the tab for {% data variables.product.prodname_vscode %}. +これらの作業方法についてはそれぞれ、この記事のタブを使って情報を切り替えることができます。 現在は、{% data variables.product.prodname_vscode %} のタブが表示されています。 -## Working in a codespace in {% data variables.product.prodname_vscode_shortname %} +## {% data variables.product.prodname_vscode_shortname %} 内の codespace で作業する -{% data variables.product.prodname_github_codespaces %} provides you with the full development experience of {% data variables.product.prodname_vscode %}. {% data reusables.codespaces.use-visual-studio-features %} +{% data variables.product.prodname_github_codespaces %} は、{% data variables.product.prodname_vscode %} の完全な開発体験を提供します。 {% data reusables.codespaces.use-visual-studio-features %} -![Annotated screenshot of a codespace in VS Code](/assets/images/help/codespaces/codespace-annotated-vscode.png) +![VS Code 内の codespace の注釈付きのスクリーンショット](/assets/images/help/codespaces/codespace-annotated-vscode.png) {% data reusables.codespaces.vscode-interface-annotation %} -For more information on using {% data variables.product.prodname_vscode_shortname %}, see the [User Interface guide](https://code.visualstudio.com/docs/getstarted/userinterface) in the {% data variables.product.prodname_vscode_shortname %} documentation. +{% data variables.product.prodname_vscode_shortname %} の使用方法の詳しい情報については、{% data variables.product.prodname_vscode_shortname %} ドキュメントで[ユーザー インターフェイス ガイド](https://code.visualstudio.com/docs/getstarted/userinterface)を参照してください。 {% data reusables.codespaces.connect-to-codespace-from-vscode %} -For troubleshooting information, see "[Troubleshooting Codespaces clients](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)." -{% data reusables.codespaces.developing-in-vscode %} -{% data reusables.codespaces.navigating-to-a-codespace %} +トラブルシューティングの情報については、「[Codespaces クライアントのトラブルシューティング](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)」を参照してください。 +{% data reusables.codespaces.developing-in-vscode %} {% data reusables.codespaces.navigating-to-a-codespace %} {% endvscode %} {% jetbrains %} -The tabs in this article allow you to switch between information for each of these ways of working. You're currently on the tab for JetBrains IDEs. +これらの作業方法についてはそれぞれ、この記事のタブを使って情報を切り替えることができます。 現在は、JetBrains IDE のタブが表示されています。 -## Working in a codespace in a JetBrains IDE +## JetBrains IDE 内の codespace で作業する -To use {% data variables.product.prodname_github_codespaces %} with a JetBrains IDE you must have already installed JetBrains Gateway. For information about installing JetBrains Gateway, see [the JetBrains website](https://www.jetbrains.com/remote-development/gateway/). +JetBrains IDE で {% data variables.product.prodname_github_codespaces %} を使うには、JetBrains Gateway が既にインストールされている必要があります。 JetBrains Gateway のインストールの詳しい情報については、[JetBrains Web サイト](https://www.jetbrains.com/remote-development/gateway/)を参照してください。 -You can work in a codespace using your choice of JetBrains IDE. After creating a codespace, you can use the JetBrains Gateway application to open the codespace in your preferred IDE. +お好みの JetBrains IDE を使って、codespace で作業できます。 codespace を作成したら、JetBrains Gateway アプリケーションを使って、お好みの IDE で codespace を開くことができます。 -You can edit code, debug, and use Git commands while developing in a codespace with your JetBrains IDE. For more information about the various JetBrains IDEs, see the [JetBrains documentation](https://www.jetbrains.com/help/). +JetBrains IDE を使って codespace で開発する際は、コードの編集、デバッグ、Git コマンドの使用ができます。 さまざまな JetBrains IDE について詳しくは、[JetBrains ドキュメント](https://www.jetbrains.com/help/)を参照してください。 -### IntelliJ IDEA user interface +### IntelliJ IDEA ユーザー インターフェイス -Within the {% data variables.product.prodname_github_codespaces %} documentation we use IntelliJ IDEA as a representative JetBrains IDE. Different JetBrains IDEs may have different layouts. +{% data variables.product.prodname_github_codespaces %} ドキュメントでは、代表的な JetBrains IDE として IntelliJ IDEA を使っています。 JetBrains IDE が異なると、レイアウトが異なる場合があります。 -![Annotated screenshot of a codespace in JetBrains IntelliJ IDEA](/assets/images/help/codespaces/jetbrains-gui-with-callouts.png) +![JetBrains IntelliJ IDEA 内の codespace の注釈付きのスクリーンショット](/assets/images/help/codespaces/jetbrains-gui-with-callouts.png) -1. **Navigation bar** - This displays the path to the currently selected file or directory. Use the buttons to the right of the navigation bar to perform various actions, including building, running, or debugging the project, or running Git commands to commit and push your changes. -2. **Project tool window** - This shows you the structure of your project and allows you to open files in the editor. -3. **{% data variables.product.prodname_github_codespaces %} tool window** - This is displayed by clicking the {% data variables.product.prodname_github_codespaces %} plugin in the bar to the left of the tool window. It displays information about your codespace, including its display name and machine type. The buttons at the top of this tool window allow you to: - * Stop the codespace and disconnect - * Display the "Your codespaces" web page - * View the codespace creation logs - * Rebuild the dev container -4. **Editor** - This is where you edit your files. You can right-click the tab for a file to access options such as moving the tab to a new window. -5. **Terminal** - This is displayed by clicking **Terminal** in the tool window bar at the bottom of the main window (just above the status bar). The integrated terminal allows you to perform command-line tasks without having to switch to a dedicated terminal application. -6. **Status bar** - Hover over the icon at the left of the status bar to see a list of tools. Click the icon to hide or show the tool window bars. The right side of the status bar shows information about the project, including the current Git branch. +1. **ナビゲーション バー** - 現在選ばれているファイルまたはディレクトリへのパスが表示されています。 ナビゲーション バーの右側にあるボタンを使って、プロジェクトのビルド、実行、デバッグ、Git コマンドの実行など、さまざまなアクションを実行して、変更をコミットおよびプッシュします。 +2. **プロジェクト ツール ウィンドウ** - プロジェクトの構造が表示され、エディターでファイルを開くことができます。 +3. **{% data variables.product.prodname_github_codespaces %} ツール ウィンドウ** - ツール ウィンドウの左側にあるバーで {% data variables.product.prodname_github_codespaces %} プラグインをクリックすると表示されます。 表示名やコンピューターの種類など、codespace に関する情報が表示されます。 このツール ウィンドウの上部にあるボタンを使用すると、次の操作を実行できます。 + * codespace を停止して切断する + * "自分の codespace" Web ページを表示する + * codespace 作成ログを表示する + * 開発コンテナーを再構築する +4. **エディター** - ここでファイルを編集します。 ファイルのタブを右クリックすると、タブを新しいウィンドウに移動するなどのオプションにアクセスできます。 +5. **ターミナル** - これは、メイン ウィンドウの下部にあるツール ウィンドウ バー (ステータス バーのすぐ上) で **[ターミナル]** をクリックすると表示されます。 統合ターミナルを使うと、専用のターミナル アプリケーションに切り替えることなく、コマンド ライン タスクを実行できます。 +6. **ステータス バー** - ステータス バーの左側にあるアイコンにカーソルを合わせると、ツールの一覧が表示されます。 アイコンをクリックして、ツール ウィンドウ バーを非表示または表示します。 ステータス バーの右側には、現在の Git ブランチなど、プロジェクトに関する情報が表示されます。 -For more information about the IntelliJ IDEA user interface, see the [JetBrains documentation for IntelliJ IDEA](https://www.jetbrains.com/help/idea/guided-tour-around-the-user-interface.html). +IntelliJ IDEA ユーザー インターフェイスについて詳しくは、[IntelliJ IDEA の JetBrains ドキュメント](https://www.jetbrains.com/help/idea/guided-tour-around-the-user-interface.html)を参照してください。 -### Customizing the codespaces for a repository +### リポジトリの codespace をカスタマイズする -You can customize the codespaces that are created for a repository by creating or updating the dev container configuration for the repository. You can do this from within a codespace. After you change a dev container configuration, you can apply the changes to the current codespace by rebuilding the Docker container for the codespace. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." +リポジトリ用に作成された codespace は、リポジトリの開発コンテナー構成を作成または更新してカスタマイズできます。 これは、codespace 内から行うことができます。 開発コンテナー構成を変更した後、codespace の Docker コンテナーを再構築することで、変更を現在の codespace に適用できます。 詳細については、[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)に関するページをご覧ください。 -### Personalizing your codespace +### Codespace をパーソナライズする -You can use a [dotfiles](https://dotfiles.github.io/tutorials/) repository to personalize aspects of the codespace environment for any codespace that you create. For more information, see "[Personalizing {% data variables.product.prodname_github_codespaces %} for your account](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#dotfiles)." +[ドットファイル](https://dotfiles.github.io/tutorials/) リポジトリを使って、作成する codespace に対して codespace の環境面をパーソナライズできます。 詳しくは、「[アカウントの {% data variables.product.prodname_github_codespaces %} をパーソナライズする](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#dotfiles)」をご覧ください。 -### Committing your changes +### 変更をコミットする -Once you've made changes to your codespace, either new code or configuration changes, you'll want to commit and push your changes. Pushing changes to a repository ensures that anyone else who creates a codespace from this repository has the same configuration. This also means that any customization you do, to modify the configuration of codespaces created for a repository, will be available to everybody who uses the repository. +codespace に変更を加えたら、新しいコードであっても、構成の変更であっても、変更内容をコミットしてプッシュします。 リポジトリに変更をプッシュすることで、このリポジトリから codespace を作成する他の人の構成が同じになるように保証できます。 これは、リポジトリ用に作成された codespace の構成を変更するために行うカスタマイズが、そのリポジトリを使うすべての人に利用可能になるということでもあります。 -For more information, see "[Using source control in your codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace#committing-your-changes)." +詳細については、「[Codespace でソース コントロールを使用する](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace#committing-your-changes)」を参照してください -## Further reading +## 参考資料 -* "[Using {% data variables.product.prodname_github_codespaces %} in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)" -* "[Using the {% data variables.product.prodname_github_codespaces %} plugin for JetBrains](/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains)" -* "[Troubleshooting {% data variables.product.prodname_github_codespaces %} clients](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients)" +* [JetBrains IDE で {% data variables.product.prodname_github_codespaces %} を使う](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide) +* [JetBrains に {% data variables.product.prodname_github_codespaces %} プラグインを使う](/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains) +* [{% data variables.product.prodname_github_codespaces %} クライアントのトラブルシューティング](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients) {% endjetbrains %} {% cli %} -The tabs in this article allow you to switch between information for each of these ways of working. You're currently on the tab for {% data variables.product.prodname_cli %}. +これらの作業方法についてはそれぞれ、この記事のタブを使って情報を切り替えることができます。 現在は、{% data variables.product.prodname_cli %} のタブが表示されています。 -## Working in a codespace in a command shell +## コマンド シェルの codespace で作業する {% data reusables.cli.cli-learn-more %} -You can use {% data variables.product.prodname_cli %} to create a new codespace, or start an existing codespace, and then SSH to it. Once connected, you can work on the command line using your preferred command-line tools. +{% data variables.product.prodname_cli %} を使って新しい codespace を作成するか、既存の codespace を開始して、それに SSH 接続できます。 接続したら、お好みのコマンドライン ツールを使ってコマンド ラインで作業できます。 -After installing {% data variables.product.prodname_cli %} and authenticating with your {% data variables.product.prodname_dotcom %} account you can use the command `gh codespace [...] --help` to browse the help information. Alternatively, you can view the same reference information at [https://cli.github.com/manual/gh_codespace](https://cli.github.com/manual/gh_codespace). +{% data variables.product.prodname_cli %} をインストールし、{% data variables.product.prodname_dotcom %} アカウントで認証したら、コマンド `gh codespace [...] --help` を使ってヘルプ情報を参照できます。 または、[https://cli.github.com/manual/gh_codespace](https://cli.github.com/manual/gh_codespace) で同じ参照情報を表示することもできます。 -For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with GitHub CLI](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli)." +詳しくは、「[GitHub CLI で{% data variables.product.prodname_github_codespaces %} を使う](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli)」を参照してください。 {% endcli %} diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace.md index 260ee1be7e..d585130b34 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace.md @@ -1,5 +1,5 @@ --- -title: Forwarding ports in your codespace +title: codespace でのポートの転送 intro: '{% data reusables.codespaces.about-port-forwarding %}' versions: fpt: '*' @@ -12,76 +12,77 @@ topics: - Fundamentals - Developer shortTitle: Forward ports +ms.openlocfilehash: 320a2e42d647452056961d4f0f987c3c5db49476 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158910' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -## About forwarded ports +## 転送されるポートについて -Port forwarding gives you access to TCP ports running within your codespace. For example, if you're running a web application on a particular port in your codespace, you can forward that port. This allows you to access the application from the browser on your local machine for testing and debugging. +ポート転送を使用すると、Codespaces 内で実行されている TCP ポートにアクセスできます。 たとえば、codespace の特定のポートで Web アプリケーションを実行している場合は、そのポートを転送できます。 これにより、テストやデバッグのために、ローカル コンピューター上のブラウザーからアプリケーションにアクセスできます。 {% webui %} -{% data reusables.codespaces.port-forwarding-intro-non-jetbrains %} -{% data reusables.codespaces.navigate-to-ports-tab %} -1. Under the list of ports, click **Add port**. +{% data reusables.codespaces.port-forwarding-intro-non-jetbrains %} {% data reusables.codespaces.navigate-to-ports-tab %} +1. ポートの一覧で、 **[ポートの追加]** をクリックします。 - ![Add port button](/assets/images/help/codespaces/add-port-button.png) + ![[ポートの追加] ボタン](/assets/images/help/codespaces/add-port-button.png) -1. Type the port number or address, then press enter. +1. ポート番号またはアドレスを入力し、Enter キーを押します。 - ![Text box to type port button](/assets/images/help/codespaces/port-number-text-box.png) + ![ポート番号を入力するテキスト ボックス](/assets/images/help/codespaces/port-number-text-box.png) -## Using HTTPS forwarding +## HTTPS 転送の使用 -By default, {% data variables.product.prodname_github_codespaces %} forwards ports using HTTP but you can update any port to use HTTPS, as needed. If you update a port with public visibility to use HTTPS, the port's visibility will automatically change to private. +既定では、{% data variables.product.prodname_github_codespaces %} は HTTP を使ってポートを転送しますが、必要に応じて、HTTPS を使うように任意のポートを更新できます。 パブリック表示を使ってポートを HTTPS を使えるように更新すると、ポートの表示は自動的にプライベートに変更されます。 {% data reusables.codespaces.navigate-to-ports-tab %} -1. Right click the port you want to update, then hover over **Change Port Protocol**. - ![Option to change port protocol](/assets/images/help/codespaces/update-port-protocol.png) -1. Select the protocol needed for this port. The protocol that you select will be remembered for this port for the lifetime of the codespace. +1. 更新するポートを右クリックし、 **[ポートのプロトコルの変更]** をポイントします。 + ![ポートのプロトコルを変更するオプション](/assets/images/help/codespaces/update-port-protocol.png) +1. このポートに必要なプロトコルを選択します。 選択したプロトコルは、codespace の有効期間中、このポートに対して記憶されます。 {% data reusables.codespaces.port-forwarding-sharing-non-jetbrains %} {% data reusables.codespaces.navigate-to-ports-tab %} -1. Right click the port that you want to share, select the "Port Visibility" menu, then click **Private to Organization** or **Public**. - ![Option to select port visibility in right-click menu](/assets/images/help/codespaces/make-public-option.png) -1. To the right of the local address for the port, click the copy icon. - ![Copy icon for port URL](/assets/images/help/codespaces/copy-icon-port-url.png) -1. Send the copied URL to the person you want to share the port with. +1. 共有するポートを右クリックし、[ポートの可視性] メニューを選択して、 **[Organization にプライベート]** または **[パブリック]** をクリックします。 + ![右クリック メニューでポートの可視性を選択するオプション](/assets/images/help/codespaces/make-public-option.png) +1. ポートのローカル アドレスの右側にあるコピー アイコンをクリックします。 + ![ポートの URL のコピー アイコン](/assets/images/help/codespaces/copy-icon-port-url.png) +1. コピーした URL を、ポートを共有するユーザーに送信します。 -{% data reusables.codespaces.port-forwarding-labeling-non-jetbrains %} -{% data reusables.codespaces.port-forwarding-adding-non-jetbrains %} +{% data reusables.codespaces.port-forwarding-labeling-non-jetbrains %} {% data reusables.codespaces.port-forwarding-adding-non-jetbrains %} {% endwebui %} {% vscode %} -{% data reusables.codespaces.port-forwarding-intro-non-jetbrains %} -{% data reusables.codespaces.navigate-to-ports-tab %} -1. Under the list of ports, click **Add port**. +{% data reusables.codespaces.port-forwarding-intro-non-jetbrains %} {% data reusables.codespaces.navigate-to-ports-tab %} +1. ポートの一覧で、 **[ポートの追加]** をクリックします。 - ![Add port button](/assets/images/help/codespaces/add-port-button.png) + ![[ポートの追加] ボタン](/assets/images/help/codespaces/add-port-button.png) -1. Type the port number or address, then press enter. +1. ポート番号またはアドレスを入力し、Enter キーを押します。 - ![Text box to type port button](/assets/images/help/codespaces/port-number-text-box.png) + ![ポート番号を入力するテキスト ボックス](/assets/images/help/codespaces/port-number-text-box.png) {% data reusables.codespaces.port-forwarding-sharing-non-jetbrains %} {% data reusables.codespaces.navigate-to-ports-tab %} -1. Right click the port that you want to share, select the "Port Visibility" menu, then click **Private to Organization** or **Public**. - ![Option to make port public in right-click menu](/assets/images/help/codespaces/make-public-option.png) -1. To the right of the local address for the port, click the copy icon. - ![Copy icon for port URL](/assets/images/help/codespaces/copy-icon-port-url.png) -1. Send the copied URL to the person you want to share the port with. +1. 共有するポートを右クリックし、[ポートの可視性] メニューを選択して、 **[Organization にプライベート]** または **[パブリック]** をクリックします。 + ![右クリック メニューでポートをパブリックにするオプション](/assets/images/help/codespaces/make-public-option.png) +1. ポートのローカル アドレスの右側にあるコピー アイコンをクリックします。 + ![ポートの URL のコピー アイコン](/assets/images/help/codespaces/copy-icon-port-url.png) +1. コピーした URL を、ポートを共有するユーザーに送信します。 -{% data reusables.codespaces.port-forwarding-labeling-non-jetbrains %} -{% data reusables.codespaces.port-forwarding-adding-non-jetbrains %} +{% data reusables.codespaces.port-forwarding-labeling-non-jetbrains %} {% data reusables.codespaces.port-forwarding-adding-non-jetbrains %} {% endvscode %} @@ -90,37 +91,37 @@ By default, {% data variables.product.prodname_github_codespaces %} forwards por {% data reusables.cli.cli-learn-more %} -To forward a port use the `gh codespace ports forward` subcommand. Replace `codespace-port:local-port` with the remote and local ports that you want to connect. After entering the command choose from the list of codespaces that's displayed. +ポートを転送するには、`gh codespace ports forward` サブコマンドを使用します。 `codespace-port:local-port` を、接続するリモート ポートとローカル ポートに置き換えます。 コマンドを入力した後、表示される codespace の一覧から選択します。 ```shell gh codespace ports forward CODESPACE-PORT:LOCAL-PORT ``` -For more information about this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_ports_forward). +このコマンドの詳細については、[{% data variables.product.prodname_cli %} に関するマニュアル](https://cli.github.com/manual/gh_codespace_ports_forward)を参照してください。 -To see details of forwarded ports enter `gh codespace ports` and then choose a codespace. +転送されるポートの詳細を表示するには、`gh codespace ports` を入力して codespace を選択します。 {% data reusables.codespaces.port-forwarding-sharing-non-jetbrains %} -To change the visibility of a forwarded port, use the `gh codespace ports visibility` subcommand. {% data reusables.codespaces.port-visibility-settings %} +転送されるポートの可視性を変更するには、`gh codespace ports visibility` サブコマンドを使用します。 {% data reusables.codespaces.port-visibility-settings %} -Replace `codespace-port` with the forwarded port number. Replace `setting` with `private`, `org`, or `public`. After entering the command choose from the list of codespaces that's displayed. +`codespace-port` を、転送されるポート番号に置き換えます。 `setting` を、`private`、`org`、または `public` に置き換えます。 コマンドを入力した後、表示される codespace の一覧から選択します。 ```shell gh codespace ports visibility CODESPACE-PORT:SETTINGS ``` -You can set the visibility for multiple ports with one command. For example: +1 つのコマンドを使用して、複数のポートの可視性を設定できます。 次に例を示します。 ```shell gh codespace ports visibility 80:private 3000:public 3306:org ``` -For more information about this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_ports_visibility). +このコマンドの詳細については、[{% data variables.product.prodname_cli %} に関するマニュアル](https://cli.github.com/manual/gh_codespace_ports_visibility)を参照してください。 {% data reusables.codespaces.port-forwarding-labeling-non-jetbrains %} -You can see the port labels when you list the forwarded ports for a codespace. To do this, use the `gh codespace ports` command and then select a codespace. +codespace の転送されたポートを一覧表示するとき、ポート ラベルを表示できます。 これを行うには、`gh codespace ports` コマンドを使用し、codespace を選択します。 {% data reusables.codespaces.port-forwarding-adding-non-jetbrains %} @@ -128,10 +129,10 @@ You can see the port labels when you list the forwarded ports for a codespace. T {% jetbrains %} -## Forwarding a port +## ポートの転送 -For information on how to forward a port in a codespace to a port on your local machine, see the "Port forwarding" section of the "[Security model](https://www.jetbrains.com/help/idea/security-model.html#port_forwarding)" article in the JetBrains documentation. +ローカル コンピューターのポートに codespace のポートを転送する方法については、JetBrains ドキュメントの「[セキュリティ モデル](https://www.jetbrains.com/help/idea/security-model.html#port_forwarding)」という記事の「ポート転送」を参照してください。 -Alternatively, you can use {% data variables.product.prodname_cli %} to forward a port. For more information, click the "{% data variables.product.prodname_cli %}" tab at the top of this page. +あるいは、{% data variables.product.prodname_cli %} を使用してポートを転送できます。 詳細については、このページの上部にある [{% data variables.product.prodname_cli %}] タブをクリックしてください。 {% endjetbrains %} diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning.md index 2e0f9118fb..78a03d20b3 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning.md @@ -1,7 +1,7 @@ --- -title: Getting started with GitHub Codespaces for machine learning +title: 機械学習のための GitHub Codespaces の概要 shortTitle: Machine learning -intro: 'Learn about working on machine learning projects with {% data variables.product.prodname_github_codespaces %} and its out-of-the-box tools.' +intro: '{% data variables.product.prodname_github_codespaces %} とそのすぐに使えるツールを使用して、機械学習プロジェクトに取り組む方法について学習します。' versions: fpt: '*' ghec: '*' @@ -9,58 +9,63 @@ type: tutorial topics: - Codespaces - Developer +ms.openlocfilehash: 905d5b14bfba5e47d1fdfdd7f0be75b16750652d +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158918' --- +## はじめに -## Introduction +このガイドでは、{% data variables.product.prodname_github_codespaces %} を使用した機械学習について説明します。 単純な画像分類器を構築し、{% data variables.product.prodname_github_codespaces %} にプレインストールされているツールの一部について学習し、NVIDIA CUDA の開発環境を構成し、JupyterLab で codespace を開きます。 -This guide introduces you to machine learning with {% data variables.product.prodname_github_codespaces %}. You’ll build a simple image classifier, learn about some of the tools that come preinstalled in {% data variables.product.prodname_github_codespaces %}, configure your development environment for NVIDIA CUDA, and open your codespace in JupyterLab. +## 単純な画像分類器を構築する -## Building a simple image classifier +Jupyter Notebook を使用して、単純な画像分類器を構築します。 -We'll use a Jupyter notebook to build a simple image classifier. +Jupyter Notebook は、順次実行できるセルのセットです。 使用するノートブックには、[PyTorch](https://pytorch.org/) を使って画像分類器を構築する多数のセルが含まれています。 各セルは、データセットのダウンロード、ニューラル ネットワークの設定、モデルのトレーニング、そのモデルのテストなど、そのプロセスの異なるフェーズです。 -Jupyter notebooks are sets of cells that you can execute one after another. The notebook we'll use includes a number of cells that build an image classifier using [PyTorch](https://pytorch.org/). Each cell is a different phase of that process: download a dataset, set up a neural network, train a model, and then test that model. +すべてのセルを順番に実行して、画像分類器を構築するすべてのフェーズを実行します。 この操作を行うと、Jupyter によって出力がノートブックに保存され、結果を確認できるようになります。 -We'll run all of the cells, in sequence, to perform all phases of building the image classifier. When we do this Jupyter saves the output back into the notebook so that you can examine the results. +### codespace を作成する -### Creating a codespace - -1. Go to the [github/codespaces-jupyter](https://github.com/github/codespaces-jupyter) template repository. +1. [github/codespaces-jupyter](https://github.com/github/codespaces-jupyter) テンプレート リポジトリに移動します。 {% data reusables.codespaces.open-template-in-codespace-step %} -A codespace for this template will open in a web-based version of {% data variables.product.prodname_vscode %}. +このテンプレートの codespace は、Web ベース バージョンの {% data variables.product.prodname_vscode %} で開きます。 -### Opening the image classifier notebook +### 画像分類器ノートブックを開く -The default container image that's used by {% data variables.product.prodname_github_codespaces %} includes a set of machine learning libraries that are preinstalled in your codespace. For example, Numpy, pandas, SciPy, Matplotlib, seaborn, scikit-learn, Keras, PyTorch, Requests, and Plotly. For more information about the default image, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#using-the-default-dev-container-configuration)" and [the `devcontainers/images` repository](https://github.com/devcontainers/images/tree/main/src/universal). +{% data variables.product.prodname_github_codespaces %} によって使用される既定のコンテナー イメージには、codespace にプレインストールされている一連の機械学習ライブラリが含まれています。 たとえば、Numpy、pandas、SciPy、Matplotlib、seaborn、scikit-learn、Keras、PyTorch、Requests、Plotly などです。 既定のイメージについては詳しくは、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#using-the-default-dev-container-configuration)」と[ `devcontainers/images` リポジトリ](https://github.com/devcontainers/images/tree/main/src/universal)を参照してください。 -1. In the {% data variables.product.prodname_vscode_shortname %} editor, close any "Get Started" tabs that are displayed. -1. Open the `notebooks/image-classifier.ipynb` notebook file. +1. {% data variables.product.prodname_vscode_shortname %} エディターで、表示されている [作業の開始] タブを閉じます。 +1. `notebooks/image-classifier.ipynb` ノートブック ファイルを開きます。 -### Building the image classifier +### 画像分類器を構築する -The image classifier notebook contains all the code you need to download a dataset, train a neural network, and evaluate its performance. +画像分類器ノートブックには、データセットのダウンロード、ニューラル ネットワークのトレーニング、そのパフォーマンスの評価に必要なすべてのコードが含まれています。 -1. Click **Run All** to execute all of the notebook’s cells. +1. **[すべて実行]** をクリックして、ノートブックのセルをすべて実行します。 - ![Screenshot of the Run All button](/assets/images/help/codespaces/jupyter-run-all.png) + ![[すべて実行] ボタンのスクリーンショット。](/assets/images/help/codespaces/jupyter-run-all.png) -1. Scroll down to view the output of each cell. +1. 下にスクロールして、各セルの出力を表示します。 - ![Screenshot of Step 3 in the editor](/assets/images/help/codespaces/jupyter-notebook-step3.png) + ![エディターの手順 3 のスクリーンショット](/assets/images/help/codespaces/jupyter-notebook-step3.png) -## Configuring NVIDIA CUDA for your codespace +## codespace 用に NVIDIA CUDA を構成する -Some software requires you to install NVIDIA CUDA to use your codespace’s GPU. Where this is the case, you can create your own custom configuration, by using a `devcontainer.json` file, and specify that CUDA should be installed. For more information on creating a custom configuration, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#creating-a-custom-dev-container-configuration)." +一部のソフトウェアでは、codespace の GPU を使用するために NVIDIA CUDA をインストールする必要があります。 その場合は、`devcontainer.json` ファイルを使用して独自のカスタム構成を作成し、CUDA をインストールする必要があることを指定できます。 カスタム構成の作成について詳しくは、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#creating-a-custom-dev-container-configuration)」を参照してください。 {% note %} -**Note**: For full details of the script that's run when you add the `nvidia-cuda` feature, see [the devcontainers/features repository](https://github.com/devcontainers/features/tree/main/src/nvidia-cuda). +**注**: `nvidia-cuda` 機能を追加するときに実行されるスクリプトについて詳しくは、[devcontainers/features リポジトリ](https://github.com/devcontainers/features/tree/main/src/nvidia-cuda)を参照してください。 {% endnote %} -1. Within the codespace, open the `.devcontainer/devcontainer.json` file in the editor. -1. Add a top-level `features` object with the following contents: +1. codespace 内で、エディターで `.devcontainer/devcontainer.json` ファイルを開きます。 +1. 次の内容を含む最上位の `features` オブジェクトを追加します。 ```json{:copy} "features": { @@ -70,9 +75,9 @@ Some software requires you to install NVIDIA CUDA to use your codespace’s GPU. } ``` - For more information about the `features` object, see the [development containers specification](https://containers.dev/implementors/features/#devcontainer-json-properties). + `features` オブジェクトについて詳しくは、「[開発コンテナーの仕様](https://containers.dev/implementors/features/#devcontainer-json-properties)」を参照してください。 - If you are using the `devcontainer.json` file from the image classifier repository you created for this tutorial, your `devcontainer.json` file will now look like this: + このチュートリアル用に作成した画像分類器リポジトリの `devcontainer.json` ファイルを使用している場合、`devcontainer.json` ファイルは次のようになります。 ```json { @@ -92,13 +97,12 @@ Some software requires you to install NVIDIA CUDA to use your codespace’s GPU. } ``` -1. Save the change. -{% data reusables.codespaces.rebuild-command %} - The codespace container will be rebuilt. This will take several minutes. When the rebuild is complete the codespace is automatically reopened. -1. Publish your change to a repository so that CUDA will be installed in any new codespaces you create from this repository in future. For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-from-vs-code)." +1. 変更を保存します。 +{% data reusables.codespaces.rebuild-command %}codespace コンテナーが再構築されます。 これには数分かかります。 再構築が完了すると、自動的に codespace が再び開きます。 +1. 変更をリポジトリに発行し、CUDA が今後このリポジトリから作成する新しい codespace にインストールされるようにします。 詳しくは、「[テンプレートから codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-from-vs-code)」を参照してください。 -## Opening your codespace in JupyterLab +## JupyterLab で codespace を開く -You can open your codespace in JupyterLab from the "Your codespaces" page at [github.com/codespaces](https://github.com/codespaces), or by using {% data variables.product.prodname_cli %}. For more information, see "[Opening an existing codespace](/codespaces/developing-in-codespaces/opening-an-existing-codespace)." +codespace は [github.com/codespaces](https://github.com/codespaces) の "Your codespaces" ページの JupyterLab で開くことができます。あるいは、{% data variables.product.prodname_cli %} を使用して開くことができます。 詳細については、「[既存の codespace を開く](/codespaces/developing-in-codespaces/opening-an-existing-codespace)」を参照してください。 -{% data reusables.codespaces.jupyterlab-installed-in-codespace %} \ No newline at end of file +{% data reusables.codespaces.jupyterlab-installed-in-codespace %} diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md index cc463fbc81..225c8b3fab 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md @@ -1,6 +1,6 @@ --- -title: Opening an existing codespace -intro: 'You can reopen a codespace that you have closed or stopped and return to your work.' +title: 既存の codespace を開く +intro: 終了または停止した codespace をもう一度開いて、作業に戻ることができます。 versions: fpt: '*' ghec: '*' @@ -10,46 +10,51 @@ topics: - Fundamentals - Developer shortTitle: Open an existing codespace +ms.openlocfilehash: e7a35c1a7b3a251094bf69fcd401291b69d03eae +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159006' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -You can reopen any of your active or stopped codespaces on {% data variables.product.prodname_dotcom_the_website %}, in a JetBrains IDE, in {% data variables.product.prodname_vscode %}, or by using {% data variables.product.prodname_cli %}. You can't reopen a codespace that has been deleted. For more information, see "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)." +{% data variables.product.prodname_dotcom_the_website %} 上、JetBrains IDE 内、{% data variables.product.prodname_vscode %} 内、または {% data variables.product.prodname_cli %} を使って、アクティブなまたは停止している codespace をもう一度開くことができます。 削除された codespace を開き直すことはできません。 詳しくは、「[codespace のライフサイクル](/codespaces/developing-in-codespaces/the-codespace-lifecycle)」を参照してください。 -You can view all your codespaces on the "Your codespaces" page at [github.com/codespaces](https://github.com/codespaces). From this page, you can: +自分のすべての codespace は、[github.com/codespaces](https://github.com/codespaces) の [あなたの codespace] ページで確認できます。 このページからは、次のことを行うことができます。 -- Open, stop, or delete your codespaces. -- See who owns (and may be billed for) your codespaces: your personal account, or organizations you belong to. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." -- Create a new codespace, either by choosing one of {% data variables.product.company_short %}'s templates or by clicking **New codespace**. For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)" and "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)." +- codespace を開く、停止する、または削除する。 +- codespaces の所有者 (および課金先である可能性があるユーザー) を確認する (個人アカウント、または所属する組織)。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」をご覧ください。 +- 新しい codespace を、{% data variables.product.company_short %} のテンプレートのいずれかを選択するか、 **[新しい codespace]** をクリックして作成する。 詳しくは、[テンプレートからの codespace の作成](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)と[リポジトリからの codespace の作成](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)に関する説明を参照してください。 -## Opening an existing codespace +## 既存の codespace を開く {% webui %} {% data reusables.codespaces.your-codespaces-procedure-step %} -1. To open a codespace in your default editor, click the name of the codespace. {% data reusables.codespaces.about-changing-default-editor %} For more information, see "[Setting your default editor for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)." +1. 既定のエディターで codespace を開くには、codespace の名前をクリックします。 {% data reusables.codespaces.about-changing-default-editor %}詳しくは、「[{% data variables.product.prodname_github_codespaces %} の既定のエディターを設定する](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)」をご覧ください。 - To open the codespace in an editor other than your default: + 既定以外のエディターで codespace を開くには、次のようにします。 - 1. Click the ellipsis (**...**) to the right of the codespace you want to open. - 1. Click **Open in**. - 1. Click **Open in APPLICATION**. + 1. 開く codespace の右側にある省略記号 ( **...** ) をクリックします。 + 1. **[開く]** をクリックします。 + 1. **[開くアプリケーション]** をクリックします。 - ![Screenshot of the "Open in" dialog box, with "Open in Visual Studio Code" highlighted](/assets/images/help/codespaces/open-codespace-in-another-editor.png) + ![[Visual Studio Code で開く] が強調されている [開く] ダイアログ ボックスのスクリーンショット](/assets/images/help/codespaces/open-codespace-in-another-editor.png) - You can open the codespace in: - * Your browser + codespace は次の中で開くことができます。 + * 自分のブラウザー * {% data variables.product.prodname_vscode %} * JetBrains Gateway * JupyterLab {% data reusables.codespaces.application-installed-locally %} - If you choose **JupyterLab**, the JupyterLab application must be installed in the codespace. {% data reusables.codespaces.jupyterlab-in-default-image %} + **JupyterLab** を選んだ場合は、JupyterLab アプリケーションを codespace にインストールする必要があります。 {% data reusables.codespaces.jupyterlab-in-default-image %} {% endwebui %} @@ -57,29 +62,28 @@ You can view all your codespaces on the "Your codespaces" page at [github.com/co {% note %} -**Note:** {% data reusables.codespaces.using-codespaces-in-vscode %} For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)." +**注:** {% data reusables.codespaces.using-codespaces-in-vscode %}詳しくは、「[{% data variables.product.prodname_vscode %} で {% data variables.product.prodname_github_codespaces %} を使用する](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)」をご覧ください。 {% endnote %} -1. In the {% data variables.product.prodname_vscode_shortname %} desktop application, open the Command Palette with Command+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux). -1. Type "Codespaces" and select one of the following commands. - - To open a codespace in a new window of {% data variables.product.prodname_vscode_shortname %}, select **Codespaces: Open Codespace in New Window** - - To open a codespace in the web editor, select **Codespaces: Open in Browser** -1. Click the codespace that you want to open. +1. {% data variables.product.prodname_vscode_shortname %} デスクトップ アプリケーションで、Command + Shift + P (Mac) または Ctrl + Shift + P (Windows/Linux) を使ってコマンド パレットを開きます。 +1. 「Codespaces」と入力して、次のいずれかのコマンドを選びます。 + - {% data variables.product.prodname_vscode_shortname %} の新しいウィンドウで codespace を開くには、 **[Codespaces: 新しいウィンドウで codespace を開く]** を選びます + - Web エディターで codespace を開くには、 **[Codespaces: ブラウザーで開く]** を選びます +1. 開く codespace をクリックします。 - ![Screenshot of a list of codespaces in Visual Studio Code](/assets/images/help/codespaces/open-codespace-from-vscode.png) + ![Visual Studio Code での codespace の一覧のスクリーンショット](/assets/images/help/codespaces/open-codespace-from-vscode.png) -You can also access the commands listed above by navigating to the Remote Explorer view in {% data variables.product.prodname_vscode_shortname %} and right-clicking the codespace that you want to open. +{% data variables.product.prodname_vscode_shortname %} のリモート エクスプローラー ビューに移動し、開く codespace を右クリックすることで、上記のコマンドにアクセスすることもできます。 -![Screenshot of a codespace selected in the Remote Explorer, with "Open in Browser" highlighted](/assets/images/help/codespaces/open-codespace-remote-explorer.png) +![[ブラウザーで開く] が強調されている、リモート エクスプローラーで選ばれた codespace のスクリーンショット](/assets/images/help/codespaces/open-codespace-remote-explorer.png) -{% data reusables.codespaces.remote-explorer %} -{% endvscode %} +{% data reusables.codespaces.remote-explorer %} {% endvscode %} {% cli %} -1. In a terminal, enter one of the following {% data variables.product.prodname_cli %} commands. - - To open a codespace in {% data variables.product.prodname_vscode_shortname %}, enter: +1. ターミナルで、次のいずれかの {% data variables.product.prodname_cli %} コマンドを入力します。 + - {% data variables.product.prodname_vscode_shortname %} で codespace を開くには、次のように入力します。 ```shell{:copy} gh codespace code @@ -87,17 +91,17 @@ You can also access the commands listed above by navigating to the Remote Explor {% note %} - **Note**: You must have {% data variables.product.prodname_vscode_shortname %} installed on your local machine. For more information, see "[Setting up Visual Studio Code](https://code.visualstudio.com/docs/setup/setup-overview)" in the {% data variables.product.prodname_vscode_shortname %} documentation. + **注**: ローカル コンピューターに {% data variables.product.prodname_vscode_shortname %} がインストールされている必要があります。 詳しくは、{% data variables.product.prodname_vscode_shortname %} ドキュメントの [Visual Studio Code の設定](https://code.visualstudio.com/docs/setup/setup-overview)に関する説明を参照してください。 {% endnote %} - - To open a codespace in the browser, enter: + - ブラウザーで codespace を開くには、次のように入力します。 ```shell{:copy} gh codespace code --web ``` - - To open a codespace in JupyterLab, enter: + - JupyterLab で codespace を開くには、次のように入力します。 ```shell{:copy} gh codespace code --jupyter @@ -105,14 +109,14 @@ You can also access the commands listed above by navigating to the Remote Explor {% note %} - **Note**: {% data reusables.codespaces.jupyterlab-installed-in-codespace %} + **注**: {% data reusables.codespaces.jupyterlab-installed-in-codespace %} {% endnote %} -1. Using the arrow keys, navigate to the codespace that you want to open. -1. To open the codespace, press Enter. +1. 方向キーを使って、開きたい codespace に移動します。 +1. codespace を開くには、Enter キーを押します。 -For more information, see [`gh codespace code`](https://cli.github.com/manual/gh_codespace_code) in the {% data variables.product.prodname_cli %} manual. +詳しくは、{% data variables.product.prodname_cli %} のマニュアルで [`gh codespace code`](https://cli.github.com/manual/gh_codespace_code) をご覧ください。 {% endcli %} @@ -120,4 +124,4 @@ For more information, see [`gh codespace code`](https://cli.github.com/manual/gh {% data reusables.codespaces.opening-codespace-in-jetbrains %} -{% endjetbrains %} \ No newline at end of file +{% endjetbrains %} diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md index 879021588c..407bd58930 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md @@ -1,6 +1,6 @@ --- -title: Stopping and starting a codespace -intro: 'You can stop and start your codespace to save resources and to pause work.' +title: codespace の停止と開始 +intro: codespace を停止して開始すると、リソースを保存し、作業を一時停止することができます。 versions: fpt: '*' ghec: '*' @@ -10,28 +10,33 @@ topics: - Fundamentals - Developer shortTitle: Stop a codespace +ms.openlocfilehash: 290a39d9d60420230bd9b11d5e2d10119ccc1c72 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158806' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -## About stopping and starting a codespace +## codespace の停止と開始について {% data reusables.codespaces.stopping-a-codespace %} -Regardless of where you created or access your codespaces, you can view and manage them in your browser at https://github.com/codespaces. +codespaces は、作成またはアクセスした場所に関係なく、 https://github.com/codespaces で表示および管理できます。 -## Stopping a codespace +## codespace を停止する {% webui %} {% data reusables.codespaces.navigate-to-codespaces-page %} - 1. To the right of the codespace you want to stop, click the elipsis (**...**). - 1. Click **Stop codespace**. - ![Screenshot of option to stop a codespace](/assets/images/help/codespaces/stop-codespace-webui.png) + 1. 停止する codespace の右側にある省略記号 ( **...** ) をクリックします。 + 1. **[codespace の停止]** をクリックします。 + ![codespace を停止するオプションのスクリーンショット](/assets/images/help/codespaces/stop-codespace-webui.png) {% endwebui %} @@ -39,7 +44,7 @@ Regardless of where you created or access your codespaces, you can view and mana {% data reusables.cli.cli-learn-more %} - To stop a codespace use the `gh codespace stop` subcommand and then choose the codespace you want to stop from the list that's displayed. + codespace を停止するには、`gh codespace stop` サブコマンドを使用し、表示される一覧から停止する codespace を選びます。 ```shell{:copy} gh codespace stop @@ -50,41 +55,41 @@ Regardless of where you created or access your codespaces, you can view and mana {% vscode %} {% data reusables.vs-code.open-command-palette %} -1. Type `stop` and select **Codespaces: Stop Codespace** from the list of options. -1. In the list of codespaces, select the codespace you want to stop. +1. 「`stop`」と入力し、オプションの一覧から **[codespace: codespace の停止]** を選びます。 +1. codespace の一覧で、停止する codespace を選びます。 {% endvscode %} {% jetbrains %} {% data reusables.codespaces.jetbrains-open-codespace-plugin %} -1. In the {% data variables.product.prodname_github_codespaces %} tool window, click the stop icon. +1. {% data variables.product.prodname_github_codespaces %} ツール ウィンドウで、停止アイコンをクリックします。 - ![Screenshot of the log button](/assets/images/help/codespaces/jetbrains-plugin-icon-stop.png) + ![ログ ボタンのスクリーンショット](/assets/images/help/codespaces/jetbrains-plugin-icon-stop.png) {% endjetbrains %} -## Restarting a codespace +## codespace の再起動 {% webui %} {% data reusables.codespaces.navigate-to-codespaces-page %} -1. Click the name of the codespace you want to restart. -![Screenshot of stopped codespaces](/assets/images/help/codespaces/restart-codespace-webui.png) +1. 再起動する codespace の名前をクリックします。 +![停止した codespace のスクリーンショット](/assets/images/help/codespaces/restart-codespace-webui.png) {% endwebui %} {% cli %} -When you restart a codespace you can choose to open it in {% data variables.product.prodname_vscode %} or in your browser. +codespace を再起動するとき、{% data variables.product.prodname_vscode %} で開くか、ブラウザーで開くかを選ぶことができます。 - - To restart a codespace and open it in {% data variables.product.prodname_vscode %}, use the `gh codespace code` subcommand and then choose the codespace you want to restart from the list that's displayed. + - codespace を再起動し、{% data variables.product.prodname_vscode %} で開くには、`gh codespace code` サブコマンドを使用し、表示される一覧から再起動する codespace を選びます。 ```shell{:copy} gh codespace code ``` - - To restart a codespace and open it in your browser, use the `gh codespace open --web` subcommand and then choose the codespace you want to restart from the list that's displayed. + - codespace を再起動してブラウザーで開くには、`gh codespace open --web` サブコマンドを使用し、表示される一覧から再起動する codespace を選びます。 ```shell{:copy} gh codespace open --web @@ -95,8 +100,8 @@ When you restart a codespace you can choose to open it in {% data variables.prod {% vscode %} {% data reusables.vs-code.open-command-palette %} -1. Type `connect` and select **Codespaces: Connect to Codespace** from the list of options. -1. In the list of codespaces, select the codespace you want to restart. +1. 「`connect`」と入力し、オプションの一覧から **[codespaces: codespace に接続]** を選びます。 +1. codespace の一覧で、再起動する codespace を選びます。 {% endvscode %} @@ -106,6 +111,6 @@ When you restart a codespace you can choose to open it in {% data variables.prod {% endjetbrains %} -## Further reading +## 参考資料 -- "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" +- 「[codespace のライフサイクル](/codespaces/developing-in-codespaces/the-codespace-lifecycle)」 diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md new file mode 100644 index 0000000000..1d1af74da9 --- /dev/null +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md @@ -0,0 +1,67 @@ +--- +title: The codespace lifecycle +intro: 'You can develop in a {% data variables.product.prodname_github_codespaces %} environment and maintain your data throughout the entire codespace lifecycle.' +versions: + fpt: '*' + ghec: '*' +type: overview +topics: + - Codespaces + - Developer +redirect_from: + - /codespaces/developing-in-codespaces/codespaces-lifecycle +--- + +## About the lifecycle of a codespace + +The lifecycle of a codespace begins when you create a codespace and ends when you delete it. You can disconnect and reconnect to an active codespace without affecting its running processes. You may stop and restart a codespace without losing changes that you have made to your project. + +## Creating a codespace + +When you want to work on a project, you can choose to create a new codespace or open an existing codespace. You might want to create a new codespace from a branch of your repository each time you develop in {% data variables.product.prodname_github_codespaces %} or keep a long-running codespace for a feature. {% data reusables.codespaces.starting-new-project-template %} For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)" and "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)." + +{% data reusables.codespaces.max-number-codespaces %} Similarly, if you reach the maximum number of active codespaces and you try to start another, you are prompted to stop one of your active codespaces. + +If you choose to create a new codespace each time you work on a project, you should regularly push your changes so that any new commits are on {% data variables.product.prodname_dotcom %}. If you choose to use a long-running codespace for your project, you should pull from your repository's default branch each time you start working in your codespace so that your environment has the latest commits. This workflow is very similar to if you were working with a project on your local machine. + +{% data reusables.codespaces.prebuilds-crossreference %} + +## Saving changes in a codespace + +When you connect to a codespace through the web, auto-save is enabled automatically for the web editor and configured to save changes after a delay. When you connect to a codespace through {% data variables.product.prodname_vscode %} running on your desktop, you must enable auto-save. For more information, see [Save/Auto Save](https://code.visualstudio.com/docs/editor/codebasics#_save-auto-save) in the {% data variables.product.prodname_vscode %} documentation. + +Your work will be saved on a virtual machine in the cloud. You can close and stop a codespace and return to the saved work later. If you have unsaved changes, your editor will prompt you to save them before exiting. However, if your codespace is deleted, then your work will be deleted too. To persist your work, you will need to commit your changes and push them to your remote repository, or publish your work to a new remote repository if you created your codespace from a template. For more information, see "[Using source control in your codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)." + +## Timeouts for {% data variables.product.prodname_github_codespaces %} + +If you leave your codespace running without interaction, or if you exit your codespace without explicitly stopping it, the codespace will timeout after a period of inactivity and stop running. By default, a codespace will timeout after 30 minutes of inactivity, but you can customize the duration of the timeout period for new codespaces that you create. For more information about setting the default timeout period for your codespaces, see "[Setting your timeout period for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)." For more information about stopping a codespace, see "[Stopping a codespace](#stopping-a-codespace)." + +When a codespace times out, your data is preserved from the last time your changes were saved. For more information, see "[Saving changes in a codespace](#saving-changes-in-a-codespace)." + +## Rebuilding a codespace + +You can rebuild your codespace to implement changes to your dev container configuration. For most uses, you can create a new codespace as an alternative to rebuilding a codespace. By default, when you rebuild your codespace, {% data variables.product.prodname_github_codespaces %} will reuse images from your cache to speed up the rebuild process. Alternatively, you can perform a full rebuild, which clears your cache and rebuilds the container with fresh images. + +For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)" and "[Performing a full rebuild of a container](/codespaces/codespaces-reference/performing-a-full-rebuild-of-a-container)." + +## Stopping a codespace + +{% data reusables.codespaces.stopping-a-codespace %} For more information, see "[Stopping and starting a codespace](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)." + +## Deleting a codespace + +You can create a codespace for a particular task and then safely delete the codespace after you push your changes to a remote branch. + +If you try to delete a codespace with unpushed git commits, your editor will notify you that you have changes that have not been pushed to a remote branch. You can push any desired changes and then delete your codespace, or continue to delete your codespace and any uncommitted changes. You can also export your code to a new branch without creating a new codespace. For more information, see "[Exporting changes to a branch](/codespaces/troubleshooting/exporting-changes-to-a-branch)." + +Codespaces that have been stopped and remain inactive for a specified period of time will be deleted automatically. By default, inactive codespaces are deleted after 30 days, but you can customize your codespace retention period. For more information, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)." + +If you create a codespace, it will continue to accrue storage charges until it is deleted, irrespective of whether it is active or stopped. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-storage-usage)." Deleting a codespace does not reduce the current billable amount for {% data variables.product.prodname_github_codespaces %}, which accumulates during each monthly billing cycle. For more information, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." + +For more information on deleting a codespace, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)." + +## Losing the connection while using {% data variables.product.prodname_github_codespaces %} + +{% data variables.product.prodname_github_codespaces %} is a cloud-based development environment and requires an internet connection. If you lose connection to the internet while working in a codespace, you will not be able to access your codespace. However, any uncommitted changes will be saved. When you have access to an internet connection again, you can connect to your codespace in the exact same state that it was left in. If you have an unstable internet connection, you should commit and push your changes often. + +If you know that you will often be working offline, you can use your `devcontainer.json` file with the ["Dev Containers" extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) for {% data variables.product.prodname_vscode_shortname %} to build and attach to a local development container for your repository. For more information, see [Developing inside a container](https://code.visualstudio.com/docs/remote/containers) in the {% data variables.product.prodname_vscode %} documentation. diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-for-pull-requests.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-for-pull-requests.md index ef83a33004..4073044326 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-for-pull-requests.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-for-pull-requests.md @@ -1,7 +1,7 @@ --- -title: Using GitHub Codespaces for pull requests +title: pull request で GitHub Codespaces を使用する shortTitle: Pull requests -intro: 'You can use {% data variables.product.prodname_github_codespaces %} in your web browser, or in {% data variables.product.prodname_vscode %} to create pull requests, review pull requests, and address review comments.' +intro: 'Web ブラウザーで、または {% data variables.product.prodname_vscode %} で {% data variables.product.prodname_github_codespaces %} を使うと、pull request の作成、pull request のレビュー、レビュー コメントの対応を行うことができます。' versions: fpt: '*' ghec: '*' @@ -12,47 +12,52 @@ topics: - Developer redirect_from: - /codespaces/developing-in-codespaces/using-codespaces-for-pull-requests +ms.openlocfilehash: 6932f8eb9095987bfe808080983970c8807b6d93 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160008' --- +## {% data variables.product.prodname_github_codespaces %} での pull request について -## About pull requests in {% data variables.product.prodname_github_codespaces %} +{% data variables.product.prodname_github_codespaces %} からは、pull request の使用で必要になることがあるさまざまな機能を提供します。 -{% data variables.product.prodname_github_codespaces %} provides you with many of the capabilities you might need to work with pull requests: +- [pull request の作成](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace#raising-a-pull-request) - Terminal コマンドと Git コマンドを使用するか、Source Control ビューを使用することで、{% data variables.product.prodname_dotcom_the_website %} の場合と同じように pull request を作成できます。 リポジトリで pull request テンプレートが使用される場合、Source Control ビュー内でこれを使用できます。 +- [pull request を開く](#opening-a-pull-request-in-codespaces) – マージされているブランチに codespace アクセスできる場合、codespace で既存の pull request を開くことができます。 +- [pull request をレビューする](#reviewing-a-pull-request-in-codespaces) - codespace で pull request を開いたら、"GitHub pull request" ビューを利用し、レビューコメントを追加したり、pull request を承認したりできます。 また、{% data variables.product.prodname_github_codespaces %} を使って、[レビュー コメントを表示](#view-comments-from-a-review-in-codespaces)することもできます。 -- [Create a pull request](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace#raising-a-pull-request) - Using either the Terminal and Git commands or the Source Control view, you can create pull requests just as you would on {% data variables.product.prodname_dotcom_the_website %}. If the repository uses a pull request template, you'll be able to use this within the Source Control view. -- [Open a pull request](#opening-a-pull-request-in-codespaces) – You can open an existing pull request in a codespace, provided you have codespace access to the branch that is being merged in. -- [Review a pull request](#reviewing-a-pull-request-in-codespaces) - Once you have opened a pull request in a codespace, you can use the "GitHub Pull Request" view to add review comments and approve pull requests. You can also use {% data variables.product.prodname_github_codespaces %} to [view review comments](#view-comments-from-a-review-in-codespaces). - -## Opening a pull request in {% data variables.product.prodname_codespaces %} +## {% data variables.product.prodname_codespaces %} で pull request を開く {% data reusables.repositories.sidebar-pr %} -1. In the list of pull requests, click the pull request you'd like to open in {% data variables.product.prodname_codespaces %}. -1. On the right-hand side of your screen, click **{% octicon "code" aria-label="The code icon" %} Code**. -1. In the {% data variables.product.prodname_codespaces %} tab, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}) +1. pull request のリストで、{% data variables.product.prodname_codespaces %} で開く pull request をクリックします。 +1. 画面の右側にある **[{% octicon "code" aria-label="The code icon" %} コード]** をクリックします。 +1. {% data variables.product.prodname_codespaces %} タブで、プラス記号 ({% octicon "plus" aria-label="The plus icon" %}) をクリックします - ![Option to open PR in a codespace](/assets/images/help/codespaces/open-with-codespaces-pr.png) + ![codespace で PR を開くオプション](/assets/images/help/codespaces/open-with-codespaces-pr.png) - A codespace is created for the pull request branch and is opened in your default editor for {% data variables.product.prodname_github_codespaces %}. + codespace は、pull request ブランチ用に作成され、{% data variables.product.prodname_github_codespaces %} の既定のエディターで開きます。 -## Reviewing a pull request in {% data variables.product.prodname_codespaces %} +## {% data variables.product.prodname_codespaces %} で pull request をレビューする -1. With your default editor set to either {% data variables.product.prodname_vscode %} or {% data variables.product.prodname_vscode %} for Web, open the pull request in a codespace, as described in "[Opening a pull request](/codespaces/developing-in-codespaces/using-codespaces-for-pull-requests#opening-a-pull-request-in-codespaces)" above. -2. In the Activity Bar, click the **GitHub Pull Request** view. This view only appears when you open a pull request in a codespace. - ![Option to open PR in a codespace](/assets/images/help/codespaces/github-pr-view.png) -3. To review a specific file, click the **Open File** icon in the sidebar. - ![Option to open PR in a codespace](/assets/images/help/codespaces/changes-in-files.png) -4. To add review comments, click the **+** icon next to the line number. Type your review comment and then click **Start Review**. - ![Option to open PR in a codespace](/assets/images/help/codespaces/start-review.png) -5. When you are finished adding review comments, from the sidebar you can choose to either submit the comments, approve the changes, or request changes. - ![Option to open PR in a codespace](/assets/images/help/codespaces/submit-review.png) +1. 既定のエディターを Web 用の {% data variables.product.prodname_vscode %} または {% data variables.product.prodname_vscode %} のいずれかに設定した状態で、上記の「[pull request を開く](/codespaces/developing-in-codespaces/using-codespaces-for-pull-requests#opening-a-pull-request-in-codespaces)」で説明されているように、codespace 内にある pull request を開きます。 +2. アクティビティ バーで **[GitHub の pull request]** ビューをクリックします。 このビューは、codespace で pull request を開く場合にのみ表示されます。 + ![codespace で PR を開くオプション](/assets/images/help/codespaces/github-pr-view.png) +3. 特定のファイルをレビューするには、サイド バーの **[ファイルを開く]** アイコンをクリックします。 + ![codespace で PR を開くオプション](/assets/images/help/codespaces/changes-in-files.png) +4. レビュー コメントを追加するには、行番号の横にある **+** アイコンをクリックします。 レビュー コメントを入力し、 **[レビューの開始]** をクリックします。 + ![codespace で PR を開くオプション](/assets/images/help/codespaces/start-review.png) +5. レビュー コメントの追加が完了したら、サイド バーからコメントの送信、変更の承認、または変更の要求のいずれかを選ぶことができます。 + ![codespace で PR を開くオプション](/assets/images/help/codespaces/submit-review.png) -For more information on reviewing a pull request, see "[Reviewing proposed changes in a pull request](/github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request)." +pull request の確認について詳しくは、「[pull request で提案されている変更を確認する](/github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request)」を参照してください。 -## View comments from a review in {% data variables.product.prodname_codespaces %} +## {% data variables.product.prodname_codespaces %} でレビューからのコメントを表示する -Once you have received feedback on a pull request, you can [open it in a codespace](#opening-a-pull-request-in-codespaces) in your web browser, or in {% data variables.product.prodname_vscode_shortname %}, to see the [review comments](#reviewing-a-pull-request-in-codespaces). From there you can respond to comments, add reactions, or dismiss the review. +pull request に関するフィードバックを受け取った後で、[レビュー コメント](#reviewing-a-pull-request-in-codespaces)を確認するには、Web ブラウザーまたは {% data variables.product.prodname_vscode_shortname %} の [codespace で開く](#opening-a-pull-request-in-codespaces)ことができます。 そこから、コメントに返信したり、反応を追加したり、レビューを退けたりできます。 - ![Option to open PR in a codespace](/assets/images/help/codespaces/incorporating-codespaces.png) + ![codespace で PR を開くオプション](/assets/images/help/codespaces/incorporating-codespaces.png) diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md index 74635bca2b..d972cd8198 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md @@ -1,7 +1,7 @@ --- -title: Using GitHub Codespaces in Visual Studio Code +title: Visual Studio Code で GitHub Codespaces を使用する shortTitle: Visual Studio Code -intro: 'You can develop in your codespace directly in {% data variables.product.prodname_vscode %} by connecting the {% data variables.product.prodname_github_codespaces %} extension with your account on {% data variables.product.product_name %}.' +intro: '{% data variables.product.product_name %} のアカウントに {% data variables.product.prodname_github_codespaces %} 拡張機能を接続することで、{% data variables.product.prodname_vscode %} で codespace を直接開発できます。' redirect_from: - /github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code - /github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code @@ -15,70 +15,75 @@ topics: - Codespaces - Visual Studio Code - Developer +ms.openlocfilehash: c651620e2795fb29f2b995f745ad3880e99c0f4e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159920' --- - -## About {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %} +## {% data variables.product.prodname_vscode %} の {% data variables.product.prodname_github_codespaces %} について -You can use your local install of {% data variables.product.prodname_vscode %} to create, manage, work in, and delete codespaces. {% data reusables.codespaces.using-codespaces-in-vscode %} For more information on setting up {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode_shortname %}, see "[Prerequisites](#prerequisites)." +{% data variables.product.prodname_vscode %} のローカル インストールを使用して、codespace の作成、管理、作業、削除を行うことができます。 {% data reusables.codespaces.using-codespaces-in-vscode %} {% data variables.product.prodname_vscode_shortname %} での {% data variables.product.prodname_github_codespaces %} の設定について詳しくは、「[前提条件](#prerequisites)」をご覧ください。 -By default, if you create a new codespace on {% data variables.product.prodname_dotcom_the_website %}, it will open in the browser. If you would prefer to open any new codespaces in {% data variables.product.prodname_vscode_shortname %} automatically, you can set your default editor to be {% data variables.product.prodname_vscode_shortname %}. For more information, see "[Setting your default editor for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)." +既定では、{% data variables.product.prodname_dotcom_the_website %} で作成した新しい codespace は、ブラウザーで開きます。 {% data variables.product.prodname_vscode_shortname %} で新しい codespace を自動的に開きたい場合は、既定のエディターを {% data variables.product.prodname_vscode_shortname %} に設定できます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の既定のエディターを設定する](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)」をご覧ください。 -If you prefer to work in the browser, but want to continue using your existing {% data variables.product.prodname_vscode_shortname %} extensions, themes, and shortcuts, you can turn on 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#settings-sync)." +ブラウザーで作業したいが、既存の {% data variables.product.prodname_vscode_shortname %} 拡張機能、テーマ、ショートカットを引き続き使用する場合は、Settings Sync を有効にすることができます。詳しくは、「[アカウントの {% data variables.product.prodname_github_codespaces %} をパーソナライズする](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#settings-sync)」をご覧ください。 -## Prerequisites +## 前提条件 -To develop in a codespace directly in {% data variables.product.prodname_vscode_shortname %}, you must install and sign into the {% data variables.product.prodname_github_codespaces %} extension with your {% data variables.product.product_name %} credentials. The {% data variables.product.prodname_github_codespaces %} extension requires {% data variables.product.prodname_vscode_shortname %} October 2020 Release 1.51 or later. +{% data variables.product.prodname_vscode_shortname %} の codespace で直接開発するには、{% data variables.product.prodname_github_codespaces %} 拡張機能をインストールして、{% data variables.product.product_name %} 資格情報を使用してサインインする必要があります。 {% data variables.product.prodname_github_codespaces %} 拡張機能には、{% data variables.product.prodname_vscode_shortname %} October 2020 Release 1.51 以降が必要です。 -Use the {% data variables.product.prodname_vscode_marketplace %} to install the [{% data variables.product.prodname_github_codespaces %}](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces) extension. For more information, see [Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery) in the {% data variables.product.prodname_vscode_shortname %} documentation. +{% data variables.product.prodname_vscode_marketplace %} を使用して [{% data variables.product.prodname_github_codespaces %}](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces) 拡張機能をインストールします。 詳細については、{% data variables.product.prodname_vscode_shortname %} ドキュメントの「[拡張機能マーケットプレース](https://code.visualstudio.com/docs/editor/extension-gallery)」を参照してください。 {% mac %} {% data reusables.codespaces.click-remote-explorer-icon-vscode %} -1. Click **Sign in to {% data variables.product.prodname_dotcom %}...**. +1. **[{% data variables.product.prodname_dotcom %} にサインイン...]** をクリックします。 - ![Signing in to {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode-mac.png) + ![{% data variables.product.prodname_github_codespaces %} にサインインする](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode-mac.png) -2. To authorize {% data variables.product.prodname_vscode_shortname %} to access your account on {% data variables.product.product_name %}, click **Allow**. -3. Sign in to {% data variables.product.product_name %} to approve the extension. +2. {% data variables.product.prodname_vscode_shortname %} からの {% data variables.product.product_name %} のアカウントへのアクセスを承認するには、 **[許可]** をクリックします。 +3. 機能拡張を承認するには、{% data variables.product.product_name %} にサインインします。 {% endmac %} {% windows %} {% data reusables.codespaces.click-remote-explorer-icon-vscode %} -1. Use the "REMOTE EXPLORER" drop-down, then click **{% data variables.product.prodname_github_codespaces %}**. +1. [REMOTE EXPLORER] ドロップダウンを使用して、 **{% data variables.product.prodname_github_codespaces %}** をクリックします。 - ![The {% data variables.product.prodname_github_codespaces %} header](/assets/images/help/codespaces/codespaces-header-vscode.png) + ![{% data variables.product.prodname_github_codespaces %} ヘッダー](/assets/images/help/codespaces/codespaces-header-vscode.png) -1. Click **Sign in to view {% data variables.product.prodname_codespaces %}**. +1. **[サインインして {% data variables.product.prodname_codespaces %} を表示]** をクリックします。 - ![Signing in to view {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) + ![サインインして {% data variables.product.prodname_github_codespaces %} を表示する](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) -1. To authorize {% data variables.product.prodname_vscode_shortname %} to access your account on {% data variables.product.product_name %}, click **Allow**. -1. Sign in to {% data variables.product.product_name %} to approve the extension. +1. {% data variables.product.prodname_vscode_shortname %} からの {% data variables.product.product_name %} のアカウントへのアクセスを承認するには、 **[許可]** をクリックします。 +1. 機能拡張を承認するには、{% data variables.product.product_name %} にサインインします。 {% endwindows %} -## Creating a codespace in {% data variables.product.prodname_vscode_shortname %} +## {% data variables.product.prodname_vscode_shortname %} で Codespaces を作成する {% data reusables.codespaces.creating-a-codespace-in-vscode %} -## Opening a codespace in {% data variables.product.prodname_vscode_shortname %} +## {% data variables.product.prodname_vscode_shortname %} で codespace を開く {% data reusables.codespaces.click-remote-explorer-icon-vscode %} -1. Under "Codespaces", click the codespace you want to develop in. -1. Click the Connect to Codespace icon. +1. [Codespaces] で、開発するコードスペースをクリックします。 +1. [Connect to Codespace] アイコンをクリックします。 - ![The Connect to Codespace icon in {% data variables.product.prodname_vscode_shortname %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) + ![{% data variables.product.prodname_vscode_shortname %} の [Connect to Codespace]\(Codespace への接続\) アイコン](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) -## Changing the machine type in {% data variables.product.prodname_vscode_shortname %} +## {% data variables.product.prodname_vscode_shortname %} のマシンの種類の変更 -{% data reusables.codespaces.codespaces-machine-types %} You can change the machine type of your codespace at any time. +{% data reusables.codespaces.codespaces-machine-types %} codespace のマシンの種類はいつでも変更できます。 {% note %} -**Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} +**注**: {% data reusables.codespaces.codespaces-machine-type-availability %} {% endnote %} @@ -86,22 +91,22 @@ Use the {% data variables.product.prodname_vscode_marketplace %} to install the {% data reusables.codespaces.about-changing-storage-size %} -## Deleting a codespace in {% data variables.product.prodname_vscode_shortname %} +## {% data variables.product.prodname_vscode_shortname %} で Codespaces を削除する {% data reusables.codespaces.deleting-a-codespace-in-vscode %} -## Switching to the Insiders build of {% data variables.product.prodname_vscode_shortname %} +## {% data variables.product.prodname_vscode_shortname %} の Insider ビルドへの切り替え -You can use the [Insiders Build of {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/setup/setup-overview#_insiders-nightly-build) within {% data variables.product.prodname_github_codespaces %}. +{% data variables.product.prodname_github_codespaces %} 内で [[{% data variables.product.prodname_vscode_shortname %} の Insiders ビルド]](https://code.visualstudio.com/docs/setup/setup-overview#_insiders-nightly-build) を使うことができます。 -1. In bottom left of your {% data variables.product.prodname_github_codespaces %} window, select **{% octicon "gear" aria-label="The settings icon" %} Settings**. -2. From the list, select "Switch to Insiders Version". +1. {% data variables.product.prodname_github_codespaces %} ウィンドウの左下にある **[{% octicon "gear" aria-label="The settings icon" %} 設定]** を選びます。 +2. 一覧から [Insiders バージョンに切り替える] を選択します。 - ![Clicking on "Insiders Build" in {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/codespaces-insiders-vscode.png) + ![{% data variables.product.prodname_github_codespaces %} で [Insiders ビルド] をクリックする](/assets/images/help/codespaces/codespaces-insiders-vscode.png) -3. Once selected, {% data variables.product.prodname_github_codespaces %} will continue to open in Insiders Version. +3. 選択すると、{% data variables.product.prodname_github_codespaces %} が Insider バージョンで開いたままになります。 -## Further reading +## 参考資料 -- "[Using the {% data variables.product.prodname_vscode_command_palette %} in {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces)" -- "[Using {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces)" \ No newline at end of file +- 「[{% data variables.product.prodname_github_codespaces %} で {% data variables.product.prodname_vscode_command_palette %} を使う](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces)」 +- 「[{% data variables.product.prodname_github_codespaces %} で {% data variables.product.prodname_copilot %} を使う](/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces)」 diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide.md new file mode 100644 index 0000000000..a0a482a183 --- /dev/null +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide.md @@ -0,0 +1,138 @@ +--- +title: JetBrains IDE で GitHub Codespaces を使う +shortTitle: JetBrains IDEs +intro: JetBrains Gateway を使って codespace に接続し、お気に入りの JetBrains IDE で作業できます。 +miniTocMaxHeadingLevel: 3 +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Developer +ms.openlocfilehash: f522bf481e932f9735560ee4a1fec21944ced2e7 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160157' +--- +{% data reusables.codespaces.codespaces-jetbrains-beta-note %} + +## JetBrains IDE 内の {% data variables.product.prodname_codespaces %} について + +JetBrains IDE を使ってコードを処理する場合、codespace での作業を利用できます。 これを行うには、JetBrains Gateway アプリケーションを使います。 + +JetBrains Gateway をインストールした後、JetBrains を既定のエディターとして設定すると、{% data variables.product.prodname_dotcom_the_website %} から codespace を開くたびに JetBrains Gateway が起動し、お使いの JetBrains IDE を選んで codespace に接続できるようになります。 + +{% note %} + +**注**: JetBrains Gateway では、既存の codespace のみを使用できます。 codespace は、{% data variables.product.prodname_dotcom_the_website %} で、または {% data variables.product.prodname_cli %} を使って作成できます。 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)」を参照してください。 + +{% endnote %} + +### JetBrains リモート開発接続プロセス + +JetBrains IDE で codespace を使う基本的なプロセスは次のとおりです。 + +* JetBrains Gateway アプリケーションで、アクティブまたは停止している codespace の 1 つを選びます。 +* 次に、使う JetBrains IDE を選びます。 +* 選んだ JetBrains IDE が、codespace とソース コードをホストするリモート仮想マシンにダウンロードされます。 +* JetBrains シン クライアント アプリケーションがローカル コンピューターにダウンロードされ、起動されます。 +* クライアント アプリケーションは、完全なバックエンド IDE に接続します。 +* ローカル環境の場合と同じ方法で、クライアント アプリケーションでコードを処理できます。 + +## 前提条件 + +JetBrains IDE 内の codespace で作業するには、次のものが必要です。 + +* 有効な JetBrains ライセンス +* JetBrains Gateway アプリケーション +* {% data variables.product.prodname_cli %} version 2.18.0 以降 +* SSH サーバーを実行している既存の codespace + +### JetBrains ライセンス + +JetBrains Gateway から codespace に接続するには、サポートされている JetBrains IDE の少なくとも 1 つに対するライセンスが必要です。 + +### JetBrains Gateway + +JetBrains Gateway は、JetBrains Toolbox アプリケーションからインストールして更新できます。 + +1. [JetBrains Toolbox](https://www.jetbrains.com/toolbox-app) をダウンロードしてインストールします。 +1. JetBrains Toolbox を開きます。 +1. 使用可能なツールの一覧で **Gateway** を見つけて、 **[インストール]** をクリックします。 + + ![JetBrains Toolbox のスクリーンショット](/assets/images/help/codespaces/jetbrains-toolbox.png) + +### {% data variables.product.prodname_cli %} + +JetBrains Gateway の {% data variables.product.prodname_github_codespaces %} プラグインを使うには、JetBrains Gateway から codespace を開く前に、{% data variables.product.prodname_cli %} バージョン 2.18.0 以降をインストールして構成しておく必要があります。 + +次のコマンドを使用して、{% data variables.product.prodname_cli %} のバージョンを確認します。 + +```shell{:copy} +gh --version +``` + +詳しくは、「[GitHub CLI について](/github-cli/github-cli/about-github-cli)」を参照してください。 + +### SSH サーバーを実行する codespace + +接続先の既存の codespace が必要です。 {% data reusables.codespaces.ways-to-create-a-codespace %} 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)」を参照してください。 + +{% data reusables.codespaces.ssh-server-installed %} + +`devcontainer.json` ファイルと既定のコンテナー イメージについて詳しくは、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)」を参照してください。 + +{% note %} + +**注**: SSH 経由で codespace に接続する方法については、「[{% data variables.product.prodname_github_codespaces %} クライアントのトラブルシューティング](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients?tool=jetbrains#ssh-connection-issues)」を参照してください。 + +{% endnote %} + +## JetBrains Gateway を設定する + +{% data variables.product.prodname_github_codespaces %} に JetBrains Gateway を初めて使う際は、{% data variables.product.prodname_codespaces %} プラグインをインストールする必要があります。 また、{% data variables.product.prodname_dotcom %} アカウントを使って、JetBrains Gateway から {% data variables.product.prodname_dotcom_the_website %} へのアクセスを許可する必要があります。 + +1. JetBrains Gateway アプリケーションを開きます。 +1. **[その他のプロバイダーのインストール]** で、{% data variables.product.prodname_github_codespaces %} の **[インストール]** リンクをクリックします。 + + ![JetBrains Gateway の初期ビューのスクリーンショット](/assets/images/help/codespaces/jetbrains-gateway-initial-view.png) + +1. **[codespace に接続]** をクリックします。 + + ![Gateway に [codespace に接続] ボタンが表示されているスクリーンショット](/assets/images/help/codespaces/jetbrains-gateway-connect.png) + +1. [JetBrains Gateway へようこそ] ダイアログ ボックスで、 **[{% data variables.product.prodname_dotcom %} でサインイン]** をクリックします。 + + ![サインイン ボタンのスクリーンショット](/assets/images/help/codespaces/jetbrains-gateway-sign-in.png) + +1. ワンタイム コードの横にあるアイコンをクリックしてコピーし、ログイン リンクをクリックします。 + + ![ワンタイム ログイン コードのスクリーンショット](/assets/images/help/codespaces/jetbrains-gateway-login-code.png) + +1. 現在 {% data variables.product.prodname_dotcom %} にサインインしていない場合、サインイン ページが表示されます。 + * 詳細を入力し、 **[サインイン]** をクリックします。 + * たとえば、2 要素認証コードを入力して、認証を確認します。 +1. [デバイスのアクティブ化] ページで、コピーしたコードを貼り付け、 **[続行]** をクリックします。 +1. 組織に所属している場合は、"組織へのシングル サインオン" ページが表示されます。 JetBrains Gateway からアクセスすることを承認する組織の横にある **[承認]** をクリックし、 **[続行]** をクリックします。 +1. [JetBrains の {% data variables.product.prodname_github_codespaces %} の承認] ページで、 **[{% data variables.product.prodname_dotcom %} の承認]** をクリックします。 +1. JetBrains Gateway アプリケーションに戻り、現在アクティブまたは停止している codespace の一覧から codespace を開き、次の手順のステップ 3 を参照してください。 + +## JetBrains IDE で codespace を開く + +{% data reusables.codespaces.opening-codespace-in-jetbrains %} + + codespace に初めて接続すると、バックエンド IDE がリモート コンピューターにダウンロードされます。 これには数分かかることがあります。 次に同じ codespace に接続する際、このステップは必要なく、接続プロセスが迅速になります。 + + その後、バックエンド IDE が開始されます。 繰り返しになりますが、実行したままのバックエンド IDE に再接続する場合、このステップは今後は必要ありません。 + + クライアント アプリケーションが起動します。 + +## 参考資料 + +- [codespace で開発する](/codespaces/developing-in-codespaces/developing-in-a-codespace) +- [JetBrains に {% data variables.product.prodname_github_codespaces %} プラグインを使う](/codespaces/codespaces-reference/using-the-github-codespaces-plugin-for-jetbrains) +- [{% data variables.product.prodname_github_codespaces %} で {% data variables.product.prodname_copilot %} を使う](/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces) +- [{% data variables.product.prodname_github_codespaces %} クライアントのトラブルシューティング](/codespaces/troubleshooting/troubleshooting-github-codespaces-clients?tool=jetbrains) diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md index 78bca1ff88..4db367bd34 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md @@ -1,7 +1,7 @@ --- -title: Using GitHub Codespaces with GitHub CLI +title: GitHub CLI で GitHub Codespaces を使用する shortTitle: GitHub CLI -intro: 'You can work with {% data variables.product.prodname_github_codespaces %} directly from your command line by using `gh`, the {% data variables.product.product_name %} command line interface.' +intro: '{% data variables.product.product_name %} コマンド ライン インターフェイスの `gh` を使うと、コマンド ラインから直接 {% data variables.product.prodname_github_codespaces %} を操作できます。' miniTocMaxHeadingLevel: 3 versions: fpt: '*' @@ -13,105 +13,110 @@ topics: - Developer redirect_from: - /codespaces/developing-in-codespaces/using-codespaces-with-github-cli +ms.openlocfilehash: e9a268273e0a6d85a17a795f593e7bd3a7885718 +ms.sourcegitcommit: 0a6e3eee6eea9b1e445aea1e4461d64cf6b63218 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163498' --- +## {% data variables.product.prodname_cli %} について -## About {% data variables.product.prodname_cli %} +{% data reusables.cli.about-cli %} 詳細については、「[{% data variables.product.prodname_cli %} について](/github-cli/github-cli/about-github-cli)」を参照してください。 -{% data reusables.cli.about-cli %} For more information, see "[About {% data variables.product.prodname_cli %}](/github-cli/github-cli/about-github-cli)." +{% data variables.product.prodname_cli %} 内の {% data variables.product.prodname_github_codespaces %} を操作すると、次のことができます。 + - [すべての codespaces を一覧表示する](#list-all-of-your-codespaces) + - [新しい codespace を作成する](#create-a-new-codespace) + - [codespace を停止する](#stop-a-codespace) + - [codespace を削除する](#delete-a-codespace) + - [codespace の名前を変更する](#rename-a-codespace) + - [codespace に SSH 接続する](#ssh-into-a-codespace) + - [{% data variables.product.prodname_vscode %} で codespace を開く](#open-a-codespace-in--data-variablesproductprodname_vscode-) + - [JupyterLab で codespace を開く](#open-a-codespace-in-jupyterlab) + - [codespace 間でのファイルのコピー](#copy-a-file-tofrom-a-codespace) + - [codespace 内のポートの変更](#modify-ports-in-a-codespace) + - [codespace ログにアクセスする](#access-codespace-logs) + - [リモート リソースにアクセスする](#access-remote-resources) + - [codespace のマシンの種類を変更する](#change-the-machine-type-of-a-codespace) -You can work with {% data variables.product.prodname_github_codespaces %} in the {% data variables.product.prodname_cli %} to: - - [List all of your codespaces](#list-all-of-your-codespaces) - - [Create a new codespace](#create-a-new-codespace) - - [Stop a codespace](#stop-a-codespace) - - [Delete a codespace](#delete-a-codespace) - - [Rename a codespace](#rename-a-codespace) - - [SSH into a codespace](#ssh-into-a-codespace) - - [Open a codespace in {% data variables.product.prodname_vscode %}](#open-a-codespace-in--data-variablesproductprodname_vscode-) - - [Open a codespace in JupyterLab](#open-a-codespace-in-jupyterlab) - - [Copy a file to/from a codespace](#copy-a-file-tofrom-a-codespace) - - [Modify ports in a codespace](#modify-ports-in-a-codespace) - - [Access codespace logs](#access-codespace-logs) - - [Access remote resources](#access-remote-resources) - - [Change the machine type of a codespace](#change-the-machine-type-of-a-codespace) - -## Installing {% data variables.product.prodname_cli %} +## {% data variables.product.prodname_cli %} のインストール {% data reusables.cli.cli-installation %} -## Using {% data variables.product.prodname_cli %} +## {% data variables.product.prodname_cli %} の使用 -If you have not already done so, run `gh auth login` to authenticate with your {% data variables.product.prodname_dotcom %} account. +まだの場合は、{% data variables.product.prodname_dotcom %} アカウントで `gh auth login` を実行して認証を行います。 -To use `gh` to work with {% data variables.product.prodname_github_codespaces %}, type `gh codespace SUBCOMMAND` or its alias `gh cs SUBCOMMAND`. +`gh` を {% data variables.product.prodname_github_codespaces %} の操作に使用するには、`gh codespace SUBCOMMAND` またはそのエイリアス `gh cs SUBCOMMAND` を入力します。 -As an example of a series of commands you might use to work with {% data variables.product.prodname_github_codespaces %}, you could: +{% data variables.product.prodname_github_codespaces %} を操作するために使用できる一連のコマンドの例として、次の操作を行うことができます。 -* List your current codespaces, to check whether you have a codespace for a particular repository:
+* 現在の codespaces を一覧表示して、特定のリポジトリの codespace があるかどうかを確認します。
`gh codespace list` -* Create a new codespace for the required repository branch:
+* 必要なリポジトリ ブランチの新しい codespace を作成します。
`gh codespace create -r github/docs -b main` -* SSH into the new codespace:
+* 新しい codespace に SSH 接続します。
`gh codespace ssh -c octocat-literate-space-parakeet-7gwrqp9q9jcx4vq` -* Forward a port to your local machine:
+* ローカル コンピューターにポートを転送します。
`gh codespace ports forward 8000:8000 -c octocat-literate-space-parakeet-7gwrqp9q9jcx4vq` -## `gh` commands for {% data variables.product.prodname_github_codespaces %} +## {% data variables.product.prodname_github_codespaces %} 用の `gh` コマンド -The sections below give example commands for each of the available operations. +以下のセクションでは、使用可能な各操作のコマンドの例を示します。 -For a complete reference of `gh` commands for {% data variables.product.prodname_github_codespaces %}, including details of all available options for each command, see the {% data variables.product.prodname_cli %} online help for "[gh codespace](https://cli.github.com/manual/gh_codespace)." Alternatively, on the command line, use `gh codespace --help` for general help or `gh codespace SUBCOMMAND --help` for help with a specific subcommand. +各コマンドで使用可能なすべてのオプションの詳細を含む {% data variables.product.prodname_github_codespaces %} の `gh` コマンドの完全なリファレンスについては、「[gh codespace](https://cli.github.com/manual/gh_codespace)」の {% data variables.product.prodname_cli %} オンライン ヘルプを参照してください。 または、コマンド ラインで `gh codespace --help` (一般的なヘルプ) または `gh codespace SUBCOMMAND --help` (特定のサブコマンドのヘルプ) を使用できます。 {% note %} -**Note**: The `-c CODESPACE_NAME` flag, used with many commands, is optional. If you omit it a list of codespaces is displayed for you to choose from. +**注**: 多数のコマンドで使用される `-c CODESPACE_NAME` フラグは省略可能です。 省略すると、選択できる codespaces の一覧が表示されます。 {% endnote %} -### List all of your codespaces +### すべての codespaces を一覧表示する ```shell gh codespace list ``` -The list includes the unique name of each codespace, which you can use in other `gh codespace` commands. +リストには、他の `gh codespace` コマンドで使用できる各 codespace の一意の名前が含まれています。 -An asterisk at the end of the branch name for a codespace indicates that there are uncommitted or unpushed changes in that codespace. +codespace のブランチ名の末尾にあるアスタリスクは、その codespace にコミットされていない、またはプッシュされていない変更があることを示します。 -### Create a new codespace +### 新しい codespace を作成する ```shell gh codespace create -r OWNER/REPO_NAME [-b BRANCH] ``` -For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)." +詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)」を参照してください。 -### Stop a codespace +### codespace を停止する ```shell gh codespace stop -c CODESPACE-NAME ``` -For more information, see "[Deep dive into {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive#closing-or-stopping-your-codespace)." +詳しくは、「[{% data variables.product.prodname_github_codespaces %} の詳細](/codespaces/getting-started/deep-dive#closing-or-stopping-your-codespace)」をご覧ください。 -### Delete a codespace +### codespace を削除する ```shell gh codespace delete -c CODESPACE-NAME ``` -For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)." +詳細については、「[codespace の削除](/codespaces/developing-in-codespaces/deleting-a-codespace)」を参照してください。 -### Rename a codespace +### codespace の名前を変更する ```shell gh codespace edit -c CODESPACE-NAME -d DISPLAY-NAME ``` -For more information, see "[Renaming a codespace](/codespaces/customizing-your-codespace/renaming-a-codespace)." +詳細については、「[codespace の名前を変更する](/codespaces/customizing-your-codespace/renaming-a-codespace)」を参照してください。 -### SSH into a codespace +### codespace に SSH 接続する -To run commands on the remote codespace machine, from your terminal, you can SSH into the codespace. +リモート codespace コンピューターでコマンドを実行するには、ターミナルから codespace に SSH 接続できます。 ```shell gh codespace ssh -c CODESPACE-NAME @@ -119,25 +124,25 @@ gh codespace ssh -c CODESPACE-NAME {% note %} -**Note**: {% data reusables.codespaces.ssh-server-installed %} +**注**: {% data reusables.codespaces.ssh-server-installed %} -
For more information about the `devcontainer.json` file and the default container image, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." +
`devcontainer.json` ファイルと既定のコンテナー イメージについては詳しくは、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)」を参照してください。 {% endnote %} -{% data variables.product.prodname_github_codespaces %} copies your GitHub SSH keys into the codespace on creation for a seamless authentication experience. You may be asked to enter the passphrase for your SSH key, after which you will get a command prompt from the remote codespace machine. +{% data variables.product.prodname_github_codespaces %} では、シームレスな認証エクスペリエンスを実現するために、作成時に GitHub SSH キーを codespace にコピーします。 SSH キーのパスフレーズの入力を求められる場合があります。その後、リモート codespace コンピューターからコマンド プロンプトが表示されます。 -If you don't have any SSH keys, follow the instructions in "[Generating a new SSH key and adding it to the ssh-agent](/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)." +SSH キーがない場合は、「[新しい SSH キーを生成して ssh-agent に追加する](/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)」の手順に従います。 -### Open a codespace in {% data variables.product.prodname_vscode %} +### {% data variables.product.prodname_vscode %} で codespace を開く ```shell gh codespace code -c CODESPACE-NAME ``` -You must have {% data variables.product.prodname_vscode_shortname %} installed on your local machine. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)." +ローカル コンピューターに {% data variables.product.prodname_vscode_shortname %} がインストールされている必要があります。 詳細については、「[{% data variables.product.prodname_vscode %} での {% data variables.product.prodname_github_codespaces %} の使用](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)」を参照してください。 -### Open a codespace in JupyterLab +### JupyterLab で codespace を開く ```shell gh codespace jupyter -c CODESPACE-NAME @@ -145,95 +150,95 @@ gh codespace jupyter -c CODESPACE-NAME {% data reusables.codespaces.jupyterlab-installed-in-codespace %} -### Copy a file to/from a codespace +### codespace 間でのファイルのコピー ```shell gh codespace cp [-r] SOURCE(S) DESTINATION ``` -Use the prefix `remote:` on a file or directory name to indicate that it's on the codespace. As with the UNIX `cp` command, the first argument specifies the source and the last specifies the destination. If the destination is a directory, you can specify multiple sources. Use the `-r` (recursive) flag if any of the sources is a directory. +ファイル名またはディレクトリ名のプレフィックス `remote:` を使用して、codespace 上にあることを示します。 UNIX `cp` コマンドと同様に、最初の引数はコピー元を指定し、最後の引数はコピー先を指定します。 コピー先がディレクトリの場合は、複数のコピー元を指定できます。 いずれかのコピー元がディレクトリの場合は、`-r` (再帰) フラグを使用します。 -The location of files and directories on the codespace is relative to the home directory of the remote user. +codespace 上のファイルとディレクトリの場所は、リモート ユーザーのホーム ディレクトリに対して相対的です。 -#### Examples +#### 例 -* Copy a file from the local machine to the `$HOME` directory of a codespace: +* ローカル コンピューターから codespace の `$HOME` ディレクトリにファイルをコピーします。 `gh codespace cp myfile.txt remote:` -* Copy a file to the directory in which a repository is checked out in a codespace: +* codespace でリポジトリがチェックアウトされているディレクトリにファイルをコピーします。 `gh codespace cp myfile.txt remote:/workspaces/REPOSITORY-NAME` -* Copy a file from a codespace to the current directory on the local machine: +* codespace からローカル コンピューター上の現在のディレクトリにファイルをコピーします。 `gh codespace cp remote:myfile.txt .` -* Copy three local files to the `$HOME/temp` directory of a codespace: +* 次の 3 つのローカル ファイルを codespace の `$HOME/temp` ディレクトリにコピーします。 `gh codespace cp a1.txt a2.txt a3.txt remote:temp` -* Copy three files from a codespace to the current working directory on the local machine: +* codespace からローカル コンピューター上の現在の作業ディレクトリに次の 3 つのファイルをコピーします。 `gh codespace cp remote:a1.txt remote:a2.txt remote:a3.txt .` -* Copy a local directory into the `$HOME` directory of a codespace: +* 次のローカル ディレクトリを codespace の `$HOME` ディレクトリにコピーします。 `gh codespace cp -r mydir remote:` -* Copy a directory from a codespace to the local machine, changing the directory name: +* codespace からローカル コンピューターにディレクトリをコピーし、ディレクトリ名を変更します。 `gh codespace cp -r remote:mydir mydir-localcopy` -For more information about the `gh codespace cp` command, including additional flags you can use, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_cp). +使用できる追加フラグなど、`gh codespace cp` コマンドの詳細については、[{% data variables.product.prodname_cli %} マニュアル](https://cli.github.com/manual/gh_codespace_cp)を参照してください。 -### Modify ports in a codespace +### codespace 内のポートの変更 -You can forward a port on a codespace to a local port. The port remains forwarded as long as the process is running. To stop forwarding the port, press Control+C. +codespace 上のポートをローカル ポートに転送できます。 プロセスが実行されている限り、ポートは転送されたままです。 ポートの転送を停止するには、Control+C キーを押します。 ```shell gh codespace ports forward CODESPACE-PORT_NAME:LOCAL-PORT-NAME -c CODESPACE-NAME ``` -To see details of forwarded ports enter `gh codespace ports` and then choose a codespace. +転送されたポートの詳細を表示するには、`gh codespace ports` を入力して codespace を選択します。 -You can set the visibility of a forwarded port. {% data reusables.codespaces.port-visibility-settings %} +転送されたポートの可視性を設定できます。 {% data reusables.codespaces.port-visibility-settings %} ```shell gh codespace ports visibility CODESPACE-PORT:private|org|public -c CODESPACE-NAME ``` -You can set the visibility for multiple ports with one command. For example: +1 つのコマンドを使用して、複数のポートの可視性を設定できます。 次に例を示します。 ```shell gh codespace ports visibility 80:private 3000:public 3306:org -c CODESPACE-NAME ``` -For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." +詳細については、「[codespace でのポートの転送](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)」を参照してください。 -### Access codespace logs +### codespace ログにアクセスする -You can see the creation log for a codespace. After entering this command you will be asked to enter the passphrase for your SSH key. +codespace の作成ログを確認できます。 このコマンドを入力すると、SSH キーのパスフレーズを入力するように求められます。 ```shell gh codespace logs -c CODESPACE-NAME ``` -For more information about the creation log, see "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs#creation-logs)." +作成ログについて詳しくは、「[{% data variables.product.prodname_github_codespaces %} ログ](/codespaces/troubleshooting/github-codespaces-logs#creation-logs)」をご覧ください。 -### Access remote resources -You can use the {% data variables.product.prodname_cli %} extension to create a bridge between a codespace and your local machine, so that the codespace can access any remote resource that is accessible from your machine. For more information on using the extension, see "[Using {% data variables.product.prodname_cli %} to access remote resources](https://github.com/github/gh-net#codespaces-network-bridge)." +### リモート リソースにアクセスする +{% data variables.product.prodname_cli %} 拡張機能を使用すると、codespace とご自分のローカル コンピューターの間にブリッジを作成し、コンピューターからアクセスできるあらゆるリモート リソースに codespace がアクセスできるようにすることができます。 拡張機能の使用方法について詳しくは、[{% data variables.product.prodname_cli %} を使用してリモート リソースにアクセスする](https://github.com/github/gh-net#codespaces-network-bridge)方法に関するページを参照してください。 {% note %} -**Note**: The {% data variables.product.prodname_cli %} extension is currently in beta and subject to change. +**注:** {% data variables.product.prodname_cli %} 拡張機能は現在ベータ段階であり、変更されることがあります。 {% endnote %} -### Change the machine type of a codespace +### codespace のマシンの種類を変更する ```shell gh codespace edit -m MACHINE-TYPE-NAME ``` -For more information, see the "{% data variables.product.prodname_cli %}" tab of "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)." +詳しくは、「[codespace のマシンの種類を変更する](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)」の [{% data variables.product.prodname_cli %}] タブを参照してください。 diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md index 4765a8908e..955059d07f 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md @@ -1,6 +1,6 @@ --- -title: Using source control in your codespace -intro: After making changes to a file in your codespace you can quickly commit the changes and push your update to the remote repository. +title: Codespace でソースコントロールを使用する +intro: Codespace 内のファイルに変更を加えた後、変更をすばやくコミットして、更新をリモートリポジトリにプッシュできます。 versions: fpt: '*' ghec: '*' @@ -10,37 +10,42 @@ topics: - Fundamentals - Developer shortTitle: Source control +ms.openlocfilehash: 513bf0729e1f04bf93f45999b2fa9e45231add5c +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160000' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -## About source control in {% data variables.product.prodname_github_codespaces %} +## {% data variables.product.prodname_github_codespaces %} でのソース管理について -You can perform all the Git actions you need directly within your codespace. For example, you can fetch changes from a remote repository, switch branches, create a new branch, commit and push changes, and create a pull request. You can use the integrated terminal within your codespace to enter Git commands, or you can click icons and menu options to complete all the most common Git tasks. This guide explains how to use the graphical user interface for source control. +必要なすべての Git アクションを codespace 内で直接実行できます。 たとえば、リモート リポジトリからの変更のフェッチ、ブランチの切り替え、新しいブランチの作成、変更のコミットとプッシュ、pull request の作成を行うことができます。 Codespace 内の統合ターミナルを使用して Git コマンドを入力するか、アイコンとメニューオプションをクリックして最も一般的な Git タスクをすべて完了することができます。 このガイドでは、ソースコントロールにグラフィカルユーザインターフェースを使用する方法について説明します。 {% vscode %} -For more information about Git support in {% data variables.product.prodname_vscode %}, see "[Using Version Control in VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support)" in the {% data variables.product.prodname_vscode %} documentation. +{% data variables.product.prodname_vscode %} の Git サポートについて詳しくは、{% data variables.product.prodname_vscode %} ドキュメントの「[VS Code でのバージョン コントロールの使用](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support)」をご覧ください。 {% endvscode %} {% webui %} -Source control in the {% data variables.product.prodname_vscode %} web client uses the same workflow as the {% data variables.product.prodname_vscode %} desktop application. For more information, see "[Using Version Control in VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support)" in the {% data variables.product.prodname_vscode %} documentation. +{% data variables.product.prodname_vscode %} Web クライアントのソース管理では、{% data variables.product.prodname_vscode %} デスクトップ アプリケーションと同じワークフローが使用されます。 詳細については、{% data variables.product.prodname_vscode %} ドキュメントの「[VS Code でのバージョン管理の使用](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support)」を参照してください。 {% endwebui %} -A typical workflow for updating a file using {% data variables.product.prodname_github_codespaces %} would be: +{% data variables.product.prodname_github_codespaces %} を使用してファイルを更新するための一般的なワークフローは次のとおりです。 -* From the default branch of your repository on {% data variables.product.prodname_dotcom %}, create a codespace. See "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)." -* In your codespace, create a new branch to work on. -* Make your changes and save them. -* Commit the change. -* Raise a pull request. +* {% data variables.product.prodname_dotcom %} のリポジトリのデフォルトブランチから、codespace を作成します。 「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)」を参照してください。 +* Codespace で、作業する新しいブランチを作成します。 +* 変更を加えて保存します。 +* 変更をコミットします。 +* プルリクエストを発行します。 {% webui %} @@ -56,67 +61,67 @@ A typical workflow for updating a file using {% data variables.product.prodname_ {% jetbrains %} -## Creating or switching branches +## ブランチの作成または切り替え -1. Click the branch name at the right side of the status bar. +1. ステータス バーの右側にあるブランチ名をクリックします。 - ![Screenshot of the branch name in the status bar](/assets/images/help/codespaces/jetbrains-branch-button.png) + ![ステータス バーのブランチ名のスクリーンショット](/assets/images/help/codespaces/jetbrains-branch-button.png) -1. In the pop-up menu, do one of the following: - * To create a new branch based on the current branch, click the name of the current branch, then choose **New Branch**. +1. ポップアップ メニューで、次のいずれかを行います。 + * 現在のブランチに基づいて新しいブランチを作成するには、現在のブランチの名前をクリックし、 **[新しいブランチ]** を選びます。 - ![Screenshot of the new branch option](/assets/images/help/codespaces/jetbrains-new-branch-option.png) + ![新しいブランチ オプションのスクリーンショット](/assets/images/help/codespaces/jetbrains-new-branch-option.png) - Enter a name for the new branch and click **Create**. + 新しいブランチの名前を入力し、 **[作成]** をクリックします。 - ![Screenshot of the create branch dialog box](/assets/images/help/codespaces/jetbrains-create-branch-dialog.png) + ![ブランチの作成ダイアログ ボックスのスクリーンショット](/assets/images/help/codespaces/jetbrains-create-branch-dialog.png) - * To check out an existing branch, start typing the name of the branch you want to check out. Click the branch from the list, then click **Checkout**. + * 既存のブランチをチェックアウトするには、チェックアウトするブランチの名前の入力を始めます。一覧からブランチをクリックし、 **[チェックアウト]** をクリックします。 - ![Screenshot of the checkout option](/assets/images/help/codespaces/jetbrains-checkout-submenu.png) + ![チェックアウト オプションのスクリーンショット](/assets/images/help/codespaces/jetbrains-checkout-submenu.png) {% tip %} - **Tip**: If someone has recently changed a file on the remote repository, in the branch you switched to, you may not see those changes until you pull the changes into your codespace. + **ヒント**: 他のユーザーが最近、リモート リポジトリのファイルを変更した場合、切り替え後のブランチでは、変更を自分の codespace にプルするまで、それらの変更が表示されません。 {% endtip %} -## Committing your changes +## 変更をコミットする -1. At the right side of the navigation bar, click the check mark. +1. ナビゲーション バーの右側にあるチェック マークをクリックします。 - ![Screenshot of the commit check mark](/assets/images/help/codespaces/jetbrains-commit-button.png) + ![[コミット] チェック マークのスクリーンショット](/assets/images/help/codespaces/jetbrains-commit-button.png) -1. In the Commit Changes dialog box, enter a commit message. -1. Click **Commit**. +1. [変更のコミット] ダイアログ ボックスで、コミット メッセージを入力します。 +1. **[コミット]** をクリックします。 - Alternatively, click the down arrow beside **Commit** and click **Commit and Push**. + または、 **[コミット]** の横にある下向き矢印をクリックし、 **[コミットしてプッシュ]** をクリックします。 - ![Screenshot of the commit and push button](/assets/images/help/codespaces/jetbrains-commit-and-push.png) + ![[コミットしてプッシュ] ボタンのスクリーンショット](/assets/images/help/codespaces/jetbrains-commit-and-push.png) -## Pulling changes from the remote repository +## リモートリポジトリから変更をプルする -You can pull changes from the same branch on the remote repository and apply those changes to the copy of the repository you are working on in your codespace. +リモート リポジトリ上の同じブランチから変更をプルし、codespace で作業しているリポジトリのコピーにそれらの変更を適用できます。 -1. At the right side of the navigation bar, click the downward pointing arrow. +1. ナビゲーション バーの右側で、下向きの矢印をクリックします。 - ![Screenshot of the update project downward arrow button](/assets/images/help/codespaces/jetbrains-update-project-button.png) + ![プロジェクトの更新の下向き矢印ボタンのスクリーンショット](/assets/images/help/codespaces/jetbrains-update-project-button.png) -1. In the Update Project dialog box, choose whether you want to merge or rebase the incoming changes. +1. [プロジェクトの更新] ダイアログ ボックスで、受信した変更をマージまたはリベースするかどうかを選びます。 - ![Screenshot of the Update Project dialog box](/assets/images/help/codespaces/jetbrains-update-options.png) + ![[プロジェクトの更新] ダイアログ ボックスのスクリーン ショット](/assets/images/help/codespaces/jetbrains-update-options.png) -1. Click **OK**. +1. **[OK]** をクリックします。 -## Pushing changes to your remote repository +## リモートリポジトリに変更をプッシュする -You can push changes you've saved and committed. This applies those changes to the upstream branch on the remote repository. You might want to do this if you're not yet ready to create a pull request, or if you prefer to create a pull request on {% data variables.product.prodname_dotcom %}. +保存してコミットした変更をプッシュできます。 それにより、変更がリモートリポジトリの上流ブランチに適用されます。 プルリクエストの作成準備が整っていない場合、または {% data variables.product.prodname_dotcom %} でプルリクエストを作成する場合は、この操作を行うことをお勧めします。 -1. At the right side of the navigation bar, click the upward pointing arrow. +1. ナビゲーション バーの右側で、上向きの矢印をクリックします。 - ![Screenshot of the push commits upward arrow](/assets/images/help/codespaces/jetbrains-push-button.png) + ![コミットのプッシュの上向き矢印のスクリーンショット](/assets/images/help/codespaces/jetbrains-push-button.png) -1. In the Push Commits dialog box, click **Push**. +1. [コミットのプッシュ] ダイアログ ボックスで、 **[プッシュ]** をクリックします。 {% endjetbrains %} diff --git a/translations/ja-JP/content/codespaces/getting-started/deep-dive.md b/translations/ja-JP/content/codespaces/getting-started/deep-dive.md index 48c9c1004b..ab69b69208 100644 --- a/translations/ja-JP/content/codespaces/getting-started/deep-dive.md +++ b/translations/ja-JP/content/codespaces/getting-started/deep-dive.md @@ -1,7 +1,7 @@ --- -title: 'Deep dive into {% data variables.product.prodname_github_codespaces %}' +title: '{% data variables.product.prodname_github_codespaces %} の詳細' shortTitle: 'Deep dive into {% data variables.product.prodname_codespaces %}' -intro: 'Understand how {% data variables.product.prodname_github_codespaces %} works.' +intro: '{% data variables.product.prodname_github_codespaces %} のしくみを理解します。' allowTitleToDifferFromFilename: true versions: fpt: '*' @@ -9,151 +9,156 @@ versions: type: quick_start topics: - Codespaces +ms.openlocfilehash: 5f97a137ec09191d5cbaa9c10aa280e10f11bbc0 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158646' --- +{% data variables.product.prodname_github_codespaces %} は、クラウドベースのインスタント開発環境であり、コンテナーを使用して開発用の共通言語、ツール、ユーティリティを提供します。 また、{% data variables.product.prodname_github_codespaces %} は構成可能で、プロジェクトに合わせてカスタマイズされた開発環境を作成できます。 プロジェクト用のカスタム開発環境を構成することにより、プロジェクトのすべてのユーザーに対して繰り返し可能な codespace 構成を作成できます。 -{% data variables.product.prodname_github_codespaces %} is an instant, cloud-based development environment that uses a container to provide you with common languages, tools, and utilities for development. {% data variables.product.prodname_github_codespaces %} is also configurable, allowing you to create a customized development environment for your project. By configuring a custom development environment for your project, you can have a repeatable codespace configuration for all users of your project. +## codespace を作成する -## Creating your codespace +codespace を作成するためのエントリ ポイントは数多くあります。 -There are a number of entry points to create a codespace. - -- From a {% data variables.product.company_short %} template or any template repository on {% data variables.product.prodname_dotcom_the_website %} to start a new project -- From a branch in your repository for new feature work -- From an open pull request to explore work-in-progress -- From a commit in a repository's history to investigate a bug at a specific point in time +- 新しいプロジェクトを開始する {% data variables.product.company_short %} テンプレートまたは {% data variables.product.prodname_dotcom_the_website %} 上の任意のテンプレート リポジトリから +- 新機能の作業を行うリポジトリ内のブランチから +- 進行中の作業を探索するオープンの pull request から +- 特定の時点のバグを調査するリポジトリ内のコミットから {% data reusables.codespaces.ways-to-create-a-codespace %} -Your codespace can be ephemeral if you need to test something or you can return to the same codespace to work on long-running feature work. +何らかのテストを行う必要がある場合、または同じ codespace に戻って長期間の機能作業を行うことができる場合、codespace をエフェメラルにすることができます。 -For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)," "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)," and "[Opening an existing codespace](/codespaces/developing-in-codespaces/opening-an-existing-codespace)." +詳細については、「[リポジトリの codespace の作成](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)」、「[テンプレートから codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)」、「[既存の codespace を開く](/codespaces/developing-in-codespaces/opening-an-existing-codespace)」を参照してください。 {% note %} -**Note**: You can create more than one codespace per repository or even per branch. However, there are limits to the number of codespaces you can create, and the number of codespaces you can run at the same time. If you reach the maximum number of codespaces and try to create another, a message is displayed telling you that you must remove an existing codespace before you can create a new one. +**注**: リポジトリごと、さらにはブランチごとに 1 つ以上の codespace を作成できます。 ただし、作成できる codespace の数と、同時に実行できる codespace の数には制限があります。 codespace の最大数に達してからさらに作成しようとすると、新しい codespace を作成する前に既存のものを削除する必要があることを示すメッセージが表示されます。 {% endnote %} -### The codespace creation process +### codespace の作成プロセス -When you create a codespace, various steps happen in the background before the codespace is available to you. +codespace を作成するときは、codespace を使用できるようになるまでにバックグラウンドでさまざまな手順が発生します。 -### Step 1: VM and storage are assigned to your codespace +### 手順 1: VM とストレージを codespace に割り当てる -When you create a codespace, a [shallow clone](https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/) is made of your repository, or of the template repository if you're creating a codespace from a template. The repository is cloned to a Linux virtual machine that is both dedicated and private to you. Having a dedicated VM ensures that you have the entire set of compute resources from that machine available to you. If necessary, this also allows you to have full root access to your container. +codespace を作成すると、リポジトリの (または、テンプレートから codespace を作成する場合はテンプレート リポジトリの) [シャロー クローン](https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/)が作成されます。 リポジトリは、専用と個人用の両方である Linux 仮想マシンにクローンされます。 専用の VM を使用すると、そのマシンから使用できるコンピューティング リソースのセット全体を確保できます。 必要に応じて、これにより、コンテナーへの完全なルート アクセス権を取得することもできます。 -### Step 2: Container is created +### 手順 2: コンテナーを作成する -{% data variables.product.prodname_github_codespaces %} uses a container as the development environment. This container is created based on configurations that you can define in a `devcontainer.json` file and, optionally, a Dockerfile. If you create a codespace from {% data variables.product.company_short %}'s blank template, or from a repository with no `devcontainer.json` file, {% data variables.product.prodname_github_codespaces %} uses a default image, which has many languages and runtimes available. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." For details of what the default image contains, see the [`microsoft/vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers/tree/main/containers/codespaces-linux) repository. +{% data variables.product.prodname_github_codespaces %} では、開発環境としてコンテナーが使用されます。 このコンテナーは、`devcontainer.json` ファイルおよび必要に応じて Dockerfile で定義できる構成に基づいて作成されます。 {% data variables.product.company_short %} の空のテンプレートから、または `devcontainer.json` ファイルのないリポジトリから codespace を作成する場合、{% data variables.product.prodname_github_codespaces %} で既定のイメージが使用されます。これには、使用可能な言語とランタイムが多数あります。 詳細については、[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)に関するページをご覧ください。 既定のイメージの内容について詳しくは、[`microsoft/vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers/tree/main/containers/codespaces-linux) リポジトリを参照してください。 {% note %} -**Note:** If you want to use Git hooks in your codespace and apply anything in the [git template directory](https://git-scm.com/docs/git-init#_template_directory) to your codespace, then you must set up hooks during step 4 after the container is created. +**注:** codespace で Git フックを使用し、[git テンプレート ディレクトリ](https://git-scm.com/docs/git-init#_template_directory)内の何らかのものを codespace に適用する場合、コンテナーの作成後に手順 4 でフックを設定する必要があります。 -Since your repository is cloned onto the host VM before the container is created, anything in the [git template directory](https://git-scm.com/docs/git-init#_template_directory) will not apply in your codespace unless you set up hooks in your `devcontainer.json` configuration file using the `postCreateCommand` in step 4. For more information, see "[Step 4: Post-creation setup](#step-4-post-creation-setup)." +コンテナーの作成前にリポジトリがホスト VM に複製されるため、手順 4 の `postCreateCommand`を使用して `devcontainer.json` 構成ファイルでフックを設定しない限り、[git テンプレート ディレクトリ](https://git-scm.com/docs/git-init#_template_directory)内のものは codespace に適用されません。 詳細については、「[手順 4: 作成後のセットアップ](#step-4-post-creation-setup)」を参照してください。 {% endnote %} -### Step 3: Connecting to the codespace +### 手順 3: codespace に接続する -When your container has been created and any other initialization has run, you'll be connected to your codespace. You can connect to it by using: +コンテナーが作成され、その他の初期化が実行されると、codespace に接続されます。 次の方法で接続できます。 -* Your web browser +* Web ブラウザー * [Visual Studio Code](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code) -* [A JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide) +* [JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide) * [{% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli) -### Step 4: Post-creation setup +### 手順 4: 作成後のセットアップ -Once you are connected to your codespace, your automated setup may continue to build based on the configuration specified in your `devcontainer.json` file. You may see `postCreateCommand` and `postAttachCommand` run. +codespace に接続された後、`devcontainer.json` ファイルで指定した構成に基づいて、自動セットアップが引き続きビルドされる場合があります。 `postCreateCommand`が表示され、`postAttachCommand` が実行される場合があります。 -If you want to use Git hooks in your codespace, set up hooks using the [`devcontainer.json` lifecycle scripts](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts), such as `postCreateCommand`. For more information, see the [`devcontainer.json` reference](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) in the {% data variables.product.prodname_vscode_shortname %} documentation. +codespace で Git フックを使用する場合は、`postCreateCommand` などの [`devcontainer.json`ライフサイクル スクリプト](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts)を使用してフックを設定します。 詳しい情報については、{% data variables.product.prodname_vscode_shortname %} のドキュメントの「[`devcontainer.json` リファレンス](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties)」を参照してください。 -If you have a public dotfiles repository for {% data variables.product.prodname_github_codespaces %}, you can enable it for use with new codespaces. When enabled, your dotfiles will be cloned to the container and the install script will be invoked. For more information, see "[Personalizing {% data variables.product.prodname_github_codespaces %} for your account](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#dotfiles)." +{% data variables.product.prodname_github_codespaces %} のパブリックのドットファイル リポジトリがある場合、それを新しい codespace で使用できるように有効にすることができます。 有効にすると、ドットファイルがコンテナーに複製され、インストール スクリプトが呼び出されます。 詳しくは、「[アカウントの {% data variables.product.prodname_github_codespaces %} をパーソナライズする](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#dotfiles)」をご覧ください。 -Finally, if you created the codespace from a repository, the entire history of the repository is copied down with a full clone. If you created the codespace from a template, the full history of the template repository is not preserved; instead, unless you are using the blank template, you will start with an initial commit for the contents of the template repository. +最後に、リポジトリから codespace を作成した場合、リポジトリの履歴全体が完全なクローンでコピーされます。 テンプレートから codespace を作成した場合、テンプレート リポジトリの完全な履歴は保持されません。代わりに、空白のテンプレートを使用するのでない限り、テンプレート リポジトリの内容に対する最初のコミットから始めます。 -During post-creation setup you'll still be able to use the integrated terminal and make edits to your files, but take care to avoid any race conditions between your work and the commands that are running. -## {% data variables.product.prodname_codespaces %} lifecycle +作成後のセットアップ中も、統合ターミナルを使用してファイルを編集できますが、作業と実行中のコマンドの間の競合状態を回避するように注意してください。 +## {% data variables.product.prodname_codespaces %} のライフサイクル -### Saving files in your codespace +### ファイルを codespace に保存する -Save changes to files in the normal way, depending on the editor you are using. +使用しているエディターに応じて、通常の方法でファイルに対する変更を保存します。 -If you work on codespaces in {% data variables.product.prodname_vscode %}, you can enable [Auto Save](https://code.visualstudio.com/docs/editor/codebasics#_save-auto-save) to ensure that your changes are always saved. +{% data variables.product.prodname_vscode %} の codespaces で作業する場合は、[自動保存](https://code.visualstudio.com/docs/editor/codebasics#_save-auto-save)を有効にして、変更が常に保存されるようにすることができます。 -### Closing or stopping your codespace +### codespace の終了または停止 -Your codespace will keep running while you are using it, but will time out after a period of inactivity. File changes from the editor and terminal output are counted as activity, so your codespace will not time out if terminal output is continuing. The default inactivity timeout period is 30 minutes. You can define your personal timeout setting for codespaces you create, but this may be overruled by an organization timeout policy. For more information, see "[Setting your timeout period for Codespaces](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces)." +codespace は、使用している間は実行され続けますが、一定時間非アクティブになるとタイムアウトします。 エディターとターミナル出力からのファイルの変更はアクティビティとしてカウントされるため、ターミナル出力が継続されていれば codespace はタイムアウトしません。 既定の非アクティブ タイムアウト期間は 30 分です。 作成する codespace に対して個人用タイムアウト設定を定義できますが、これは組織のタイムアウト ポリシーによって却下される可能性があります。 詳しくは、「[codespace のタイムアウト期間を設定する](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces)」をご覧ください。 -If a codespace times out it will stop running, but you can restart it from the browser tab (if you were using the codespace in the browser), from within {% data variables.product.prodname_vscode_shortname %}, or from your list of codespaces at [https://github.com/codespaces](https://github.com/codespaces). +codespace がタイムアウトすると実行は停止しますが、ブラウザー タブから (ブラウザーで codespace を使用している場合)、{% data variables.product.prodname_vscode_shortname %} 内から、または [https://github.com/codespaces](https://github.com/codespaces) にある codespace の一覧から再起動できます。 -To stop your codespace you can +次の方法で codespace を停止できます。 -* In the browser: on your list of codespaces at [https://github.com/codespaces](https://github.com/codespaces), click the ellipsis (**...**) to the right of the codespace you want to stop and click **Stop codespace**. -* In {% data variables.product.prodname_vscode_shortname %}: open [the {% data variables.product.prodname_vscode_command_palette %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces#suspending-or-stopping-a-codespace) - for example, by pressing Ctrl+Shift+Enter (Windows/Linux) or Shift+Command+P (Mac) - type `Codespaces: stop` then press Enter. -* In the JetBrains client, click the stop button at the top of the {% data variables.product.prodname_github_codespaces %} tool window. For more information, see the "JetBrains IDEs" tab of "[Stopping and starting a codespace](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)." -* In a terminal window: use the {% data variables.product.prodname_cli %} command `gh codespace stop`. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli#gh-commands-for-github-codespaces)." +* ブラウザーで: [https://github.com/codespaces](https://github.com/codespaces) にある codespace の一覧で、停止する codespace の右側にある省略記号 ( **...** ) をクリックし、 **[codespace の停止]** をクリックします。 +* {% data variables.product.prodname_vscode_shortname %} で: [the {% data variables.product.prodname_vscode_command_palette %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces#suspending-or-stopping-a-codespace)を開き (たとえば、Ctrl + Shift + Enter キー (Windows/Linux) または Shift + Command + P キー (Mac) を押す)、「`Codespaces: stop`」と入力して Enter キーを押します。 +* JetBrains クライアントで、{% data variables.product.prodname_github_codespaces %} ツール ウィンドウの上部にある停止ボタンをクリックします。 詳細については、「[codespace の停止と開始](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)」の「JetBrains IDE」タブを参照してください。 +* ターミナル ウィンドウで: {% data variables.product.prodname_cli %} コマンド `gh codespace stop` を使用します。 詳細については、「[{% data variables.product.prodname_github_codespaces %} と {% data variables.product.prodname_cli %} の使用](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli#gh-commands-for-github-codespaces)」を参照してください。 -If you exit your codespace without running the stop command (for example, by closing the browser tab), or if you leave the codespace running without interaction, the codespace and its running processes will continue for the duration of the inactivity timeout period. +stop コマンドを実行せずに codespace を終了した (たとえばブラウザー タブを閉じる) 場合、または操作なしで codespace を実行したままにした場合、codespace とその実行中のプロセスは、非アクティブ タイムアウト期間中は続行されます。 -When you close or stop your codespace, all uncommitted changes are preserved until you connect to the codespace again. +codespace を終了または停止すると、codespace に再度接続するまで、コミットされていない変更はすべて保持されます。 -## Running your application +## アプリケーションの実行 -Port forwarding gives you access to TCP ports running within your codespace. For example, if you're running a web application on port 4000 within your codespace, you can automatically forward that port to make the application accessible from your browser. +ポート転送を使用すると、Codespaces 内で実行されている TCP ポートにアクセスできます。 たとえば、codespace 内のポート 4000 で Web アプリケーションを実行している場合、そのポートを自動的に転送して、ブラウザーからアプリケーションをアクセスできるようにします。 -Port forwarding determines which ports are made accessible to you from the remote machine. Even if you do not forward a port, that port is still accessible to other processes running inside the codespace itself. +ポートの転送は、リモート マシンからアクセス可能にするポートを決定します。 ポートを転送しない場合でも、そのポートには、codespace 自体内で実行されている他のプロセスにアクセスできます。 -![Diagram showing how port forwarding works in a codespace](/assets/images/help/codespaces/port-forwarding.png) +![codespace 内でのポートの転送のしくみを示す図](/assets/images/help/codespaces/port-forwarding.png) -When an application running inside {% data variables.product.prodname_github_codespaces %} outputs a port to the console, {% data variables.product.prodname_github_codespaces %} detects the localhost URL pattern and automatically forwards the port. You can click on the URL in the terminal, or the link in the "toast" notification message that pops up at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, to open the port in a browser. By default, {% data variables.product.prodname_github_codespaces %} forwards the port using HTTP. For more information on port forwarding, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." +{% data variables.product.prodname_github_codespaces %} 内で実行されているアプリケーションでポートをコンソールに出力すると、{% data variables.product.prodname_github_codespaces %} で localhost の URL パターンが検出され、ポートが自動的に転送されます。 ターミナルで URL をクリックするか、{% data variables.product.prodname_vscode_shortname %} の右下隅にポップアップ表示される "トースト" 通知メッセージ内のリンクをクリックして、ブラウザーでポートを開くことができます。 {% data variables.product.prodname_github_codespaces %} の既定では、HTTP を使用してポートが転送されます。 ポートの転送の詳細については、「[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)」 (codespace でのポートの転送) を参照してください。 -While ports can be forwarded automatically, they are not publicly accessible to the internet. By default, all ports are private, but you can manually make a port available to your organization or public, and then share access through a URL. For more information, see "[Sharing a port](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace#sharing-a-port)." +ポートは自動的に転送できますが、インターネットからパブリックにアクセスすることはできません。 既定では、すべてのポートはプライベートですが、手動で、組織またはパブリックでポートを使用できるようにして、URL を使用してアクセスを共有できます。 詳細については、「[Sharing a port](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace#sharing-a-port)」 (ポートの共有) を参照してください。 -Running your application when you first land in your codespace can make for a fast inner dev loop. As you edit, your changes are automatically saved and available on your forwarded port. To view changes, go back to the running application tab in your browser and refresh it. +初めて codespace に入ったときにアプリケーションを実行すると、高速の内部開発ループを実現できます。 編集すると、変更は自動的に保存され、転送されたポートで使用できるようになります。 変更を表示するには、ブラウザーで実行中のアプリケーションのタブに戻って更新します。 -## Committing and pushing your changes +## 変更のコミットとプッシュ -Git is installed by default in your codespace and so you can rely on your existing Git workflow. You can work with Git in your codespace either via the Terminal or by using the source control features of {% data variables.product.prodname_vscode_shortname %} or JetBrains. +Git は既定で codespace にインストールされるため、既存の Git ワークフローに依存できます。 Git を codespace で操作するには、ターミナルを使うか、{% data variables.product.prodname_vscode_shortname %} または JetBrains のソース管理機能を使います。 -If you're working with an existing repository, you can create a codespace from any branch, commit, or pull request in the repository, or you can switch to a new or existing branch from within your active codespace. Because {% data variables.product.prodname_github_codespaces %} is designed to be ephemeral, you can use it as an isolated environment to experiment, check a teammate's pull request, or fix merge conflicts. +既存のリポジトリで作業している場合は、リポジトリ内のブランチ、コミット、または pull request から codespace を作成することも、アクティブな codespace 内から新しいまたは既存のブランチに切り替えることもできます。 {% data variables.product.prodname_github_codespaces %} はエフェメラルになるように設計されているため、分離された環境として使用して、実験、チームメイトの pull request の確認、またはマージ競合の修正を行うことができます。 -If you're working in a codespace created from a template, Git will be installed by default, but you will need to publish your codespace to a remote repository to persist your work and to share it with others. If you start from {% data variables.product.company_short %}'s blank template, you will first need to initialize your workspace as a Git repository (for example by entering `git init`) to start using source control within the codespace. +テンプレートから作成された codespace で作業している場合、Git は既定でインストールされますが、作業を永続化し、他のユーザーと共有するには、codespace をリモート リポジトリに発行する必要があります。 {% data variables.product.company_short %} の空のテンプレートから開始する場合は、codespace 内でソース管理の使用を開始するには、まずワークスペースを Git リポジトリとして初期化する (たとえば「`git init`」を入力して) 必要があります。 -For more information, see "[Using source control in your codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)." +詳細については、「[Codespace でソース コントロールを使用する](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)」を参照してください {% note %} -**Note:** Commits from your codespace will be attributed to the name and public email configured at https://github.com/settings/profile. A token scoped to the repository, included in the environment as `GITHUB_TOKEN`, and your GitHub credentials will be used to authenticate. +**注:** codespace からのコミットは、 https://github.com/settings/profile で構成された名前とパブリック メールに起因します。 スコープがリポジトリにされ、`GITHUB_TOKEN` として環境に含まれたトークンと、GitHub 資格情報が認証に使用されます。 {% endnote %} -## Personalizing your codespace with extensions or plugins +## 拡張機能またはプラグインを使用して codespace をカスタマイズする -You can add plugins and extensions within a codespace to personalize your experience in JetBrains and {% data variables.product.prodname_vscode_shortname %} respectively. +codespace 内にプラグインと拡張機能を追加して、JetBrains と {% data variables.product.prodname_vscode_shortname %} のエクスペリエンスをそれぞれカスタマイズできます。 -### {% data variables.product.prodname_vscode_shortname %} extensions +### {% data variables.product.prodname_vscode_shortname %} 拡張機能 -If you work on your codespaces in the {% data variables.product.prodname_vscode_shortname %} desktop application, or the web client, you can add any extensions you need from the {% data variables.product.prodname_vscode_marketplace %}. For information on how extensions run in {% data variables.product.prodname_github_codespaces %}, see [Supporting Remote Development and {% data variables.product.prodname_github_codespaces %}](https://code.visualstudio.com/api/advanced-topics/remote-extensions) in the {% data variables.product.prodname_vscode_shortname %} documentation. +{% data variables.product.prodname_vscode_shortname %} デスクトップ アプリケーションまたは Web クライアントの codespaces で作業している場合は、{% data variables.product.prodname_vscode_marketplace %} から必要な拡張機能を追加できます。 拡張機能が {% data variables.product.prodname_github_codespaces %} でどのように実行されるかについては、{% data variables.product.prodname_vscode_shortname %} ドキュメントの「[リモート開発と {% data variables.product.prodname_github_codespaces %} のサポート](https://code.visualstudio.com/api/advanced-topics/remote-extensions)」を参照してください。 -If you already use {% data variables.product.prodname_vscode_shortname %}, you can use [Settings Sync](https://code.visualstudio.com/docs/editor/settings-sync) to automatically sync extensions, settings, themes, and keyboard shortcuts between your local instance and any codespaces you create. +既に {% data variables.product.prodname_vscode_shortname %} を使っている場合は、[[設定の同期]](https://code.visualstudio.com/docs/editor/settings-sync) を使って、ローカル インスタンスと作成した codespace との間で拡張機能、設定、テーマ、キーボード ショートカットを自動的に同期できます。 -### JetBrains plugins +### JetBrains プラグイン -If you work on your codespaces in a JetBrains IDE, you can add plugins from the JetBrains Marketplace. +JetBrains IDE で codespace を操作する場合は、JetBrains Marketplace からプラグインを追加できます。 -1. Click **JetBrains Client**, then click **Preferences**. -1. In the Preferences dialog box, click either **Plugins On Host** to install a plugin in the full JetBrains IDE that's running remotely, or **Plugins** to install a plugin on the local client, for example to change the user interface theme. -1. Click the **Marketplace** tab. +1. **[JetBrains クライアント]** をクリックし、 **[基本設定]** をクリックします。 +1. [基本設定] ダイアログ ボックスで、 **[ホスト上のプラグイン]** をクリックして、リモートで実行されている完全な JetBrains IDE にプラグインをインストールするか、 **[プラグイン]** をクリックしてローカル クライアントにプラグインをインストールして、たとえばユーザー インターフェイスのテーマを変更します。 +1. **[Marketplace]** タブをクリックします。 - ![Screenshot of the Marketplace tab for 'Plugins On Host'](/assets/images/help/codespaces/jetbrains-preferences-plugins.png) + ![[プラグイン ホスト上] の [Marketplace] タブのスクリーンショット](/assets/images/help/codespaces/jetbrains-preferences-plugins.png) -1. Click **Install** beside the required plugin. +1. 必要なプラグインの横にある **[インストール]** をクリックします。 -## Further reading +## 参考資料 -- "[Enabling {% data variables.product.prodname_github_codespaces %} for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)" -- "[Managing the cost of {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization)" -- "[Add a dev container configuration to your repository](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)" -- "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)" +- 「[Organization での {% data variables.product.prodname_github_codespaces %} の有効化について](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)」 +- 「[Organization で {% data variables.product.prodname_github_codespaces %} のコストを管理する](/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization)」 +- 「[開発コンテナー構成をリポジトリに追加する](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)」 +- 「[codespace のライフサイクル](/codespaces/developing-in-codespaces/the-codespace-lifecycle)」 diff --git a/translations/ja-JP/content/codespaces/getting-started/quickstart.md b/translations/ja-JP/content/codespaces/getting-started/quickstart.md index c432de015c..4ce94575b8 100644 --- a/translations/ja-JP/content/codespaces/getting-started/quickstart.md +++ b/translations/ja-JP/content/codespaces/getting-started/quickstart.md @@ -1,7 +1,7 @@ --- -title: 'Quickstart for {% data variables.product.prodname_github_codespaces %}' +title: '{% data variables.product.prodname_github_codespaces %} のクイックスタート' shortTitle: 'Quickstart for {% data variables.product.prodname_codespaces %}' -intro: 'Try out {% data variables.product.prodname_github_codespaces %} in 5 minutes.' +intro: '{% data variables.product.prodname_github_codespaces %} は 5 分以内で試すことができます。' allowTitleToDifferFromFilename: true versions: fpt: '*' @@ -11,103 +11,108 @@ topics: - Codespaces redirect_from: - /codespaces/codespaces-quickstart +ms.openlocfilehash: f35fa87711ff3a7c33ed252d0d1e87865af619bc +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158654' --- +## はじめに -## Introduction +このガイドでは、テンプレート リポジトリから codespace を作成し、codespace 内で使用できるいくつかの重要な機能について調べます。 ブラウザー バージョンの {% data variables.product.prodname_vscode %} で作業します。これは、最初は {% data variables.product.prodname_github_codespaces %} の既定のエディターです。 このクイックスタートを試した後、他のエディターで {% data variables.product.prodname_codespaces %} を使用し、既定のエディターを変更できます。 リンクは、このガイドの最後に示します。 -In this guide, you'll create a codespace from a template repository and explore some of the essential features available to you within the codespace. You'll work in the browser version of {% data variables.product.prodname_vscode %}, which is initially the default editor for {% data variables.product.prodname_github_codespaces %}. After trying out this quickstart you can use {% data variables.product.prodname_codespaces %} in other editors, and you can change the default editor. Links are provided at the end of this guide. +このクイックスタートでは、codespace を作成し、転送されるポートに接続して実行中のアプリケーションを表示し、新しいリポジトリに codespace を発行し、拡張機能でセットアップをカスタマイズする方法について学習します。 -From this quickstart, you'll learn how to create a codespace, connect to a forwarded port to view your running application, publish your codespace to a new repository, and personalize your setup with extensions. +{% data variables.product.prodname_github_codespaces %} の厳密なしくみの詳細については、コンパニオン ガイド「[{% data variables.product.prodname_github_codespaces %} の詳細情報](/codespaces/getting-started/deep-dive)」を参照してください。 -For more information on exactly how {% data variables.product.prodname_github_codespaces %} works, see the companion guide "[Deep dive into {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive)." +## codespace を作成する -## Creating your codespace - -1. Navigate to the [github/haikus-for-codespaces](https://github.com/github/haikus-for-codespaces) template repository. +1. [github/haikus-for-codespaces](https://github.com/github/haikus-for-codespaces) テンプレート リポジトリに移動します。 {% data reusables.codespaces.open-template-in-codespace-step %} -## Running the application +## アプリケーションの実行 -Once your codespace is created, the template repository will be automatically cloned into it. Now you can run the application and launch it in a browser. +codespace が作成されると、そこにテンプレート リポジトリが自動的にクローンされます。 これで、アプリケーションを実行し、ブラウザーで起動できます。 -1. When the terminal becomes available, enter the command `npm run dev`. This example uses a Node.js project, and this command runs the script labeled "dev" in the `package.json` file, which starts up the web application defined in the sample repository. +1. ターミナルが使用可能になったら、コマンド `npm run dev` を入力します。 この例では Node.js プロジェクトを使用します。また、このコマンドは `package.json` ファイルで、サンプル リポジトリで定義されている Web アプリケーションを起動する "dev" というラベルの付いたスクリプトを実行します。 - ![npm run dev in terminal](/assets/images/help/codespaces/codespaces-npm-run-dev.png) + ![ターミナルで dev を実行する npm](/assets/images/help/codespaces/codespaces-npm-run-dev.png) - If you're following along with a different application type, enter the corresponding start command for that project. + 別のアプリケーションの種類を使用している場合は、そのプロジェクトの対応する開始コマンドを入力します。 -2. When your application starts, the codespace recognizes the port the application is running on and displays a prompt to let you know it has been forwarded. +2. アプリケーションが起動すると、アプリケーションが実行しているポートが codespace によって認識されて、転送されたことを知らせるプロンプトが表示されます。 - ![Port forwarding "toast" notification](/assets/images/help/codespaces/quickstart-port-toast.png) + ![ポート転送の "トースト" 通知](/assets/images/help/codespaces/quickstart-port-toast.png) -3. Click **Open in Browser** to view your running application in a new tab. +3. **[ブラウザーで開く]** をクリックして、実行中のアプリケーションを新しいタブで表示します。 -## Edit the application and view changes +## アプリケーションを編集して変更を表示する -1. Switch back to your codespace and open the `haikus.json` file by clicking it in the Explorer. +1. codespace に戻り、エクスプローラーで `haikus.json` ファイルをクリックして開きます。 -2. Edit the `text` field of the first haiku to personalize the application with your own haiku. +2. 最初の俳句の `text` フィールドを編集して、独自の俳句でアプリケーションをカスタマイズします。 -3. Go back to the running application tab in your browser and refresh to see your changes. +3. ブラウザーで実行中のアプリケーションのタブに戻り、表示を更新して変更を確認します。 - {% octicon "light-bulb" aria-label="The lightbulb icon" %} If you've closed the tab, open the Ports panel and click the **Open in browser** icon for the running port. + {% octicon "light-bulb" aria-label="The lightbulb icon" %} タブを閉じた場合は、[ポート] パネルを開き、実行中のポートの **[ブラウザーで開く]** アイコンをクリックします。 - ![Port Forwarding Panel](/assets/images/help/codespaces/quickstart-forward-port.png) + ![ポート転送パネル](/assets/images/help/codespaces/quickstart-forward-port.png) -## Committing and pushing your changes +## 変更のコミットとプッシュ -Now that you've made a few changes, you can use the integrated terminal or the source view to publish your work to a new repository. +いくつかの変更を加えたので、統合ターミナルまたはソース ビューを使って作業をリポジトリに公開できます。 {% data reusables.codespaces.source-control-display-dark %} -1. To stage your changes, click **+** next to the `haikus.json` file, or next to **Changes** if you've changed multiple files and you want to stage them all. +1. 変更をステージングするには、`haikus.json` ファイルの横の **[+]** をクリックします。複数のファイルを変更してすべてをステージングする場合は、 **[変更]** の横のものをクリックします。 - ![Source control side bar with staging button highlighted](/assets/images/help/codespaces/codespaces-commit-stage.png) + ![ステージング ボタンが強調表示されたソース コントロール サイドバー](/assets/images/help/codespaces/codespaces-commit-stage.png) -2. To commit your staged changes, type a commit message describing the change you've made, then click **Commit**. +2. ステージングされた変更をコミットするには、行った変更を説明するコミット メッセージを入力し、 **[コミット]** をクリックします。 - ![Source control side bar with a commit message](/assets/images/help/codespaces/vscode-commit-button.png) + ![コミット メッセージがあるソース管理サイドバー](/assets/images/help/codespaces/vscode-commit-button.png) -3. Click **Publish Branch**. +3. **[ブランチを公開する]** をクリックします。 - ![Screenshot of the "Publish branch" button in VS Code](/assets/images/help/codespaces/vscode-publish-branch-button.png) + ![VS Code の [ブランチの発行] ボタンのスクリーンショット](/assets/images/help/codespaces/vscode-publish-branch-button.png) -4. In the "Repository Name" dropdown, type a name for your new repository, then select **Publish to {% data variables.product.company_short %} private repository** or **Publish to {% data variables.product.company_short %} public repository**. +4. [リポジトリ名] ドロップダウンで、新しいリポジトリの名前を入力し、 **[{% data variables.product.company_short %} プライベート リポジトリに発行]** または **[{% data variables.product.company_short %} パブリック リポジトリに発行]** を選びます。 - ![Screenshot of the "Repository Name" dropdown in VS Code](/assets/images/help/codespaces/choose-new-repository.png) + ![VS Code の [リポジトリ名] ドロップダウンのスクリーンショット](/assets/images/help/codespaces/choose-new-repository.png) - The owner of the new repository will be the {% data variables.product.prodname_dotcom %} account with which you created the codespace. -5. In the pop-up that appears in the lower right corner of the editor, click **Open on {% data variables.product.company_short %}** to view the new repository on {% data variables.product.prodname_dotcom_the_website %}. In the new repository, view the `haikus.json` file and check that the change you made in your codespace has been successfully pushed to the repository. + 新しいリポジトリの所有者は、codespace を作成した {% data variables.product.prodname_dotcom %} アカウントになります。 +5. エディターの右下隅に表示されるポップアップで、 **[{% data variables.product.company_short %} で開く]** をクリックして、{% data variables.product.prodname_dotcom_the_website %} の新しいリポジトリを表示します。 新しいリポジトリで `haikus.json` ファイルを表示し、codespace で加えた変更がリポジトリに正常にプッシュされたことを確認します。 - ![Screenshot of the "Open in GitHub" pop-up in VS Code](/assets/images/help/codespaces/open-on-github.png) + ![VS Code の [GitHub で開く] ポップアップのスクリーンショット](/assets/images/help/codespaces/open-on-github.png) -## Personalizing with an extension +## 拡張機能を使用した個人用設定 -When you connect to a codespace using the browser, or the {% data variables.product.prodname_vscode %} desktop application, you can access the Visual Studio Code Marketplace directly from the editor. For this example, you'll install a {% data variables.product.prodname_vscode_shortname %} extension that alters the theme, but you can install any extension that's useful for your workflow. +ブラウザーまたは {% data variables.product.prodname_vscode %} デスクトップ アプリケーションを使用して codespace に接続すると、エディターから Visual Studio Code Marketplace に直接アクセスできます。 この例では、テーマを変更する {% data variables.product.prodname_vscode_shortname %} 拡張機能をインストールしますが、ご自分のワークフローにとって便利なあらゆる拡張機能をインストールすることができます。 -1. In the left sidebar, click the Extensions icon. -1. In the search bar, type `fairyfloss` and click **Install**. +1. 左サイトバーで、[Extensions] アイコンをクリックします。 +1. 検索バーに「`fairyfloss`」と入力し、 **[インストール]** をクリックします。 - ![Add an extension](/assets/images/help/codespaces/add-extension.png) + ![機能拡張を追加](/assets/images/help/codespaces/add-extension.png) -1. Select the `fairyfloss` theme by selecting it from the list. +1. 一覧で `fairyfloss` テーマをクリックして選択します。 - ![Select the fairyfloss theme](/assets/images/help/codespaces/fairyfloss.png) + ![fairyfloss のテーマを選択](/assets/images/help/codespaces/fairyfloss.png) -If you are using a codespace in the browser, or in the {% data variables.product.prodname_vscode %} desktop application, and you have [Settings Sync](https://code.visualstudio.com/docs/editor/settings-sync) turned on, any changes you make to your editor setup in the current codespace, such as changing your theme or keyboard bindings, are automatically synced to any instances of {% data variables.product.prodname_vscode %} that are signed into your {% data variables.product.prodname_dotcom %} account and to any other codespaces you create. +ブラウザーまたは {% data variables.product.prodname_vscode %} デスクトップ アプリケーションで codespace を使う場合で、[[Settings Sync]](https://code.visualstudio.com/docs/editor/settings-sync) が有効になっている場合、テーマやキーボード バインドの変更など、現在の codespace でエディターの設定に加えた変更はすべて、{% data variables.product.prodname_dotcom %} アカウントにサインインしている {% data variables.product.prodname_vscode %} のインスタンスと、ご自分で作成する他の codespace に自動的に同期されます。 -## Next steps +## 次のステップ -You've successfully created, personalized, and run your first application within a codespace but there's so much more to explore! Here are some helpful resources for taking your next steps with {% data variables.product.prodname_github_codespaces %}. +codespace で最初のアプリケーションを正常に作成、パーソナライズ、および実行しましたが、その他にもできることはまだまだたくさんあります。 {% data variables.product.prodname_github_codespaces %} で次の手順を行うのに役立つリソースをいくつか以下に示します。 -* "[Deep dive](/codespaces/getting-started/deep-dive)": This quickstart presented some of the features of {% data variables.product.prodname_github_codespaces %}. The deep dive looks at these areas from a technical standpoint. -* "[Add a dev container configuration to your repository](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)": These guides provide information on setting up your repository to use {% data variables.product.prodname_github_codespaces %} with specific languages. -* "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)": This guide provides details on creating a custom configuration for {% data variables.product.prodname_codespaces %} for your project. +* 「[詳細情報](/codespaces/getting-started/deep-dive)」: このクイックスタートでは、{% data variables.product.prodname_github_codespaces %} の機能をいくつか説明しました。 詳細情報では、これらの領域について技術的な観点から説明します。 +* 「[開発コンテナー構成をリポジトリに追加する](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)」: これらのガイドでは、特定の言語で {% data variables.product.prodname_github_codespaces %} を使用するようにリポジトリを設定する方法について説明します。 +* 「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)」: このガイドではプロジェクト向けの {% data variables.product.prodname_codespaces %} のカスタム構成の作成について詳しい情報を提供します。 -## Further reading +## 参考資料 -* "[Enabling {% data variables.product.prodname_github_codespaces %} for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)" -* "[Using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code)" -* "[Using {% data variables.product.prodname_github_codespaces %} in your JetBrains IDE](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide)" -* "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli)" -* "[Setting your default editor for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)." -* "[Managing the cost of {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization)" +* [Organization に対して {% data variables.product.prodname_github_codespaces %} を有効にする](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization) +* [{% data variables.product.prodname_vscode %} での {% data variables.product.prodname_github_codespaces %} の使用](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code) +* [JetBrains IDE で {% data variables.product.prodname_github_codespaces %} を使う](/codespaces/developing-in-codespaces/using-github-codespaces-in-your-jetbrains-ide) +* [{% data variables.product.prodname_cli %} で {% data variables.product.prodname_github_codespaces %} を使う](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli) +* [{% data variables.product.prodname_github_codespaces %} の既定のエディターを設定する](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces) +* [Organization で {% data variables.product.prodname_github_codespaces %} のコストを管理する](/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization) diff --git a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md index 914857fdef..e655e22a5a 100644 --- a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md +++ b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md @@ -1,8 +1,8 @@ --- -title: Enabling GitHub Codespaces for your organization +title: Organization での GitHub Codespaces の有効化 shortTitle: 'Enable {% data variables.product.prodname_codespaces %}' -intro: "You can control which users in your organization can use {% data variables.product.prodname_github_codespaces %} at the organization's expense." -permissions: "To alter an organization's billing settings, you must be an organization owner." +intro: '組織内のどのユーザーが組織の負担で {% data variables.product.prodname_github_codespaces %} を使用できるかを制御できます。' +permissions: 'To alter an organization''s billing settings, you must be an organization owner.' redirect_from: - /codespaces/managing-codespaces-for-your-organization/managing-user-permissions-for-your-organization - /codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization @@ -14,70 +14,69 @@ topics: - Codespaces - Billing - Administrator +ms.openlocfilehash: 992d744e04ae00db4d760b59a9d08d1700846998 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158902' --- +## Organization での {% data variables.product.prodname_github_codespaces %} の有効化について -## About enabling {% data variables.product.prodname_github_codespaces %} for your organization +組織の所有者は、組織内のどのユーザーが組織の負担で codespace を作成および使用できるかを制御できます。 価格について詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」をご覧ください。 -Organization owners can control which users in your organization can create and use codespaces at the organization's expense. For information about pricing, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." +リポジトリに変更をプッシュできるか、リポジトリをフォークできる人だけがそのリポジトリの codespace を作成できます。 組織によって所有されるリポジトリの codespace をユーザーが作成できるようにするには、次の手順を実行する必要があります。 -Only people who can either push changes to a repository, or fork the repository, can create a codespace for that repository. To allow people to create codespaces for repositories owned by your organization, you must: +- ユーザーが少なくとも、codespace を使用するリポジトリへの書き込みアクセス権を持っていることを確認します。 詳細については、「[リポジトリへのアクセス権を持つ Team と人を管理する](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository)」を参照してください。 +- 組織で IP アドレスの許可リストが有効になっていないことを確認します。 詳細については、{% ifversion fpt %}{% data variables.product.prodname_ghe_cloud %} ドキュメントの{% else %}{% endif %}「[Organization に対する許可 IP アドレスを管理する](/{% ifversion fpt %}enterprise-cloud@latest/{% endif %}organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization)」を参照してください。 -- Ensure that users have at least write access to the repositories where they want to use a codespace. For more information, see "[Managing teams and people with access to your repository](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository)." -- Ensure that your organization does not have an IP address allow list enabled. For more information, see "[Managing allowed IP addresses for your organization](/{% ifversion fpt %}enterprise-cloud@latest/{% endif %}organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %} +組織に課金される codespace をユーザーが作成できるようにするには、次の手順を実行する必要があります。 -To allow people to create codespaces for which your organization will be billed, you must: +- [使用制限を設定します](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces) +- [組織に課金される codespace を作成できるユーザーを選ぶ](#choose-who-can-create-codespaces-that-are-billed-to-your-organization) -- [Set a spending limit](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces) -- [Choose who can create codespaces that are billed to your organization](#choose-who-can-create-codespaces-that-are-billed-to-your-organization) +{% ifversion fpt %} {% note %} -{% ifversion fpt %} -{% note %} +**注:** 証明済みの教育者または教師の場合、{% data variables.product.prodname_github_codespaces %} Education 特典を利用するには、{% data variables.product.prodname_classroom %} から {% data variables.product.prodname_codespaces %} を有効にする必要があります。 詳細については、「[{% data variables.product.prodname_github_codespaces %} を {% data variables.product.prodname_classroom %} で使う](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom#about-the-codespaces-education-benefit-for-verified-teachers)」を参照してください。 -**Note:** If you are a verified educator or a teacher, you must enable {% data variables.product.prodname_github_codespaces %} from a {% data variables.product.prodname_classroom %} to use your {% data variables.product.prodname_codespaces %} Education benefit. For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom#about-the-codespaces-education-benefit-for-verified-teachers)." +{% endnote %} {% endif %} -{% endnote %} -{% endif %} +既定では、codespace はその作成元のリポジトリにのみアクセスできます。 組織内の codespace から、codespace の作成者がアクセスできる他の組織のリポジトリにアクセスできるようにする場合は、「[Organization の codespace に対するリポジトリ アクセスを管理する](/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces)」を参照してください。 -By default, a codespace can only access the repository from which it was created. If you want codespaces in your organization to be able to access other organization repositories that the codespace creator can access, see "[Managing repository access for your organization's codespaces](/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces)." +## 組織に課金される codespace を作成できるユーザーを選ぶ -## Choose who can create codespaces that are billed to your organization +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.click-codespaces %} +1. [課金] をクリックし、以下のオプションの 1 つを選びます。 -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.organizations.click-codespaces %} -1. Under "Billing," select one of the following options: + * **無効** - 組織は codespace の使用に対して課金されません。 組織のリポジトリ用に作成された {% data variables.product.prodname_codespaces %} では、作成した個々のユーザーに対して課金されます。 + * **選択したメンバー** - 選択したメンバーによって組織のリポジトリに対して作成された {% data variables.product.prodname_codespaces %} では、組織に対して課金されます。 + * **すべてのメンバー** - 組織のメンバーによって組織のリポジトリに対して作成された {% data variables.product.prodname_codespaces %} では、組織に対して課金されます。 + * **すべてのメンバーと外部コラボレーター** - 組織のメンバーと外部コラボレーターによって組織のリポジトリに対して作成された {% data variables.product.prodname_codespaces %} では、組織に対して課金されます。 - * **Disabled** - Your organization will not be charged for codespace usage. {% data variables.product.prodname_codespaces %} created for your organization's repositories will be billed to the individual users who create them. - * **Selected members** - {% data variables.product.prodname_codespaces %} created for your organization's repositories by selected members will be billed to the organization. - * **All members** - {% data variables.product.prodname_codespaces %} created for your organization's repositories by members of your organization will be billed to the organization. - * **All members and outside collaborators** - {% data variables.product.prodname_codespaces %} created for your organization's repositories by organization members and outside collaborators will be billed to the organization. - - ![Radio buttons for "Billing"](/assets/images/help/codespaces/codespaces-org-billing-settings.png) + ![[課金] のラジオ ボタン](/assets/images/help/codespaces/codespaces-org-billing-settings.png) {% note %} - **Note:** When you select **All members and outside collaborators**, all outside collaborators who have been added to specific repositories can create and use {% data variables.product.prodname_codespaces %} for those repositories, and your organization will be billed for this usage. For more information on managing outside collaborators, see "[About outside collaborators](/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization#about-outside-collaborators)." + **注:** **[すべてのメンバーと外部のコラボレーターに許可する]** を選ぶと、特定のリポジトリに追加されたすべての外部コラボレーターがこれらのリポジトリの {% data variables.product.prodname_codespaces %} を作成して使用でき、組織はこの使用に対して課金されます。 外部コラボレーターの管理の詳細については、「[外部のコラボレーターについて](/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization#about-outside-collaborators)」を参照してください。 {% endnote %} -1. Click **Save**. -1. If you chose **Selected members**, an input box is displayed for you to enter the names of users you want to select. +1. **[保存]** をクリックします。 +1. **[選択したメンバー]** を選んだ場合は、選ぶユーザーの名前を入力するための入力ボックスが表示されます。 - ![Input box for selecting users](/assets/images/help/codespaces/codespaces-org-billing-add-users.png) + ![ユーザーを選ぶための入力ボックス](/assets/images/help/codespaces/codespaces-org-billing-add-users.png) -## Disabling {% data variables.product.prodname_codespaces %} for your organization +## Organization の {% data variables.product.prodname_codespaces %} の無効化 -You can prevent the creation and use of codespaces billable to your organization. +組織に課金できる codespace の作成と使用を防ぐことができます。 {% data reusables.codespaces.codespaces-disabling-org-billing %} -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.organizations.click-codespaces %} -1. Under "Billing," select **Disabled**. +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.click-codespaces %} +1. [課金] で、 **[無効]** を選びます。 -## Setting a spending limit +## 利用限度の設定 {% data reusables.codespaces.codespaces-spending-limit-requirement %} -For information on managing and changing your account's spending limit, see "[Managing your spending limit for {% data variables.product.prodname_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces)." +アカウントの利用制限の管理と変更については、「[{% data variables.product.prodname_codespaces %} の利用制限の管理](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces)」を参照してください。 diff --git a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/index.md b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/index.md index 05bf754d62..3d287b26c8 100644 --- a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/index.md +++ b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/index.md @@ -1,8 +1,8 @@ --- -title: Managing GitHub Codespaces for your organization +title: Organization での GitHub Codespaces の管理 allowTitleToDifferFromFilename: true shortTitle: Managing your organization -intro: 'You can manage and review how users in your organization can use {% data variables.product.prodname_github_codespaces %}.' +intro: 'Organization 内のユーザの {% data variables.product.prodname_github_codespaces %} の使用方法について管理および確認できます。' versions: fpt: '*' ghec: '*' @@ -20,5 +20,11 @@ children: - /restricting-the-visibility-of-forwarded-ports - /restricting-the-idle-timeout-period - /restricting-the-retention-period-for-codespaces +ms.openlocfilehash: 7b8b9211a8bcafdcfb3fb2b037ea6362e8ecb27f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158638' --- - + diff --git a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md index 10e2e88b4e..dfee97ac57 100644 --- a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md +++ b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md @@ -1,7 +1,7 @@ --- -title: Listing the codespaces in your organization +title: 組織内の codespace を一覧表示する shortTitle: List organization codespaces -intro: 'You can list all of the currently active or stopped codespaces for your organization.' +intro: 組織に対して現在アクティブになっているまたは停止している codespace をすべて一覧表示できます。 permissions: 'To list all of the current codespaces for your organization, you must be an organization owner.' versions: fpt: '*' @@ -10,31 +10,36 @@ type: how_to topics: - Codespaces - Administrator +ms.openlocfilehash: e3d475560c76449ed20b70fbce29ef6273f788fc +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158630' --- +## 概要 -## Overview +組織の所有者は、組織に対して現在アクティブになっているまたは停止している codespace をすべて一覧表示できます。 これを行って、ユーザーが作成している codespace の数を確認し、不要なコストが発生していないことを確認することをお勧めします。 価格について詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」をご覧ください。 -As an organization owner, you can list all of the currently active and stopped codespaces for your organization. You might want to do this to check how many codespaces users are creating, to make sure they aren't incurring unnecessary costs. For information about pricing, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." +組織用の codespace を一覧表示する最も簡単な方法は、{% data variables.product.prodname_cli %} を使用することです。 REST API を使用することもできます。これにより、各 codespace に関する詳しい情報を確認できます。 -The easiest way to list the codespaces for an organization is by using {% data variables.product.prodname_cli %}. You can also use the REST API, which provides more information about each codespace. +Organization または Enterprise の現在の合計 {% data variables.product.prodname_codespaces %} 使用量を確認し、詳細なレポートを生成する方法については、「[{% data variables.product.prodname_github_codespaces %} の使用量を表示する](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)」をご覧ください。 -For information on how to see the current total {% data variables.product.prodname_codespaces %} usage for your organization or enterprise, and generate a detailed report, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." +### {% data variables.product.prodname_cli %} を使用して codespace を一覧表示する -### Using {% data variables.product.prodname_cli %} to list codespaces - -To list all of the current codespaces for a specified organization, use the following command. +指定した組織に対する現在の codespace をすべて一覧表示するには、次のコマンドを使用します。 ```shell{:copy} gh codespace list --org ORGANIZATION ``` -This command returns a list that includes the following information for each codespace: - - The name and display name - - The user who created the codespace - - The repository and branch - - The current state of the codespace +このコマンドを実行すると、codespace ごとに次の情報を含むリストが返されます。 + - 名前と表示名 + - codespace を作成したユーザー + - リポジトリとブランチ + - codespace の現在の状態 -To list all of the current codespaces for an organization that were created by a specific user, use the following command. +特定のユーザーによって作成された、組織向けの現在の codespace をすべて一覧表示するには、次のコマンドを使用します。 ```shell{:copy} gh codespace list --org ORGANIZATION --user USER @@ -42,12 +47,12 @@ gh codespace list --org ORGANIZATION --user USER {% note %} -**Note**: In the above commands, replace `ORGANIZATION` with the name of the organization you are querying. You must be an owner of the organization. +**注**: 上記のコマンドでは、`ORGANIZATION` を、クエリを実行する組織の名前に置き換えます。 組織の所有者でなければなりません。 {% endnote %} -### Using the REST API to list codespaces +### REST API を使用して codespace を一覧表示する -You can use the `/orgs/{org}/codespaces` API endpoint as an alternative method of listing the current codespaces for an organization. This returns more information than {% data variables.product.prodname_cli %}; for example, the machine type details. +組織に対する現在の codespace を一覧表示する別の方法として、`/orgs/{org}/codespaces` API エンドポイントを使用することもできます。 これを使用すると、{% data variables.product.prodname_cli %} よりも多くの情報が返されます。たとえば、マシンの種類に関する詳しい情報などです。 -For more information about this endpoint, see "[Codespaces organizations](/rest/codespaces/organizations#list-codespaces-for-the-organization)." +このエンドポイントについて詳しくは、「[Codespaces Organizations](/rest/codespaces/organizations#list-codespaces-for-the-organization)」を参照してください。 diff --git a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md index 639cc2acac..e43995d2da 100644 --- a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md +++ b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md @@ -1,7 +1,7 @@ --- -title: Managing repository access for your organization's codespaces +title: Organization の codespace に対するリポジトリ アクセスを管理する shortTitle: Repository access -intro: 'You can manage the repositories in your organization that {% data variables.product.prodname_github_codespaces %} can access.' +intro: '{% data variables.product.prodname_github_codespaces %} がアクセスできる Organization 内のリポジトリを管理できます。' permissions: 'To manage access and security for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner.' versions: fpt: '*' @@ -15,26 +15,29 @@ redirect_from: - /codespaces/managing-codespaces-for-your-organization/managing-access-and-security-for-your-organizations-codespaces - /github/developing-online-with-codespaces/managing-access-and-security-for-codespaces - /codespaces/working-with-your-codespace/managing-access-and-security-for-codespaces +ms.openlocfilehash: 9fdec24104a61170977053195446db0b4cf0a62f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160235' --- - {% warning %} -**Deprecation note**: The access and security setting described below is now deprecated and is documented here for reference only. To enable expanded access to other repositories, add the requested permissions to your `devcontainer.json` configuration file. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)." +**非推奨の注意**: 以下で説明するアクセスとセキュリティの設定は現在非推奨であり、ここには参考用に記載されています。 他のリポジトリへの拡張アクセスを有効にするには、要求されたアクセス許可を `devcontainer.json` 構成ファイルに追加します。 詳しくは、「[codespace 内の他のリポジトリへのアクセスの管理](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)」をご覧ください。 {% endwarning %} -By default, a codespace can only access the repository where it was created. When you enable access and security for a repository owned by your organization, any codespaces that are created for that repository will also have read permissions to all other repositories the organization owns and the codespace creator has permissions to access. If you want to restrict the repositories a codespace can access, you can limit it to either the repository where the codespace was created, or to specific repositories. You should only enable access and security for repositories you trust. +デフォルト設定では、Codespace は作成されたリポジトリにのみアクセスできます。 Organization が所有するリポジトリのアクセスとセキュリティを有効にすると、そのリポジトリ用に作成された codespace は、Organization が所有する他のすべてのリポジトリの読み取りアクセス権を持つようになり、codespace の作成者にはアクセスのためのアクセス許可があります。 codespace がアクセスできるリポジトリを制限する場合は、codespace が作成されたリポジトリまたは特定のリポジトリのいずれかに制限できます。 信頼するリポジトリに対してのみ、アクセスとセキュリティを有効にしてください。 -To manage which users in your organization can use {% data variables.product.prodname_github_codespaces %}, see "[Enabling {% data variables.product.prodname_github_codespaces %} for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#enable-codespaces-for-users-in-your-organization)." +Organization 内のどのユーザーが {% data variables.product.prodname_github_codespaces %} を使うことができるかを管理するには、「[Organization の {% data variables.product.prodname_github_codespaces %} を有効にする](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#enable-codespaces-for-users-in-your-organization)」をご覧ください。 -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.organizations.click-codespaces %} -1. Under "Access and security", select the setting you want for your organization. - ![Radio buttons to manage trusted repositories](/assets/images/help/settings/codespaces-org-access-and-security-radio-buttons.png) -1. If you chose "Selected repositories", select the dropdown menu, then click a repository to allow the repository's codespaces to access other repositories owned by your organization. Repeat for all repositories whose codespaces you want to access other repositories. - !["Selected repositories" dropdown menu](/assets/images/help/settings/codespaces-access-and-security-repository-drop-down.png) +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.click-codespaces %} +1. [Access and security] で、あなたの Organization の設定を選択します。 + ![信頼するリポジトリを管理するラジオボタン](/assets/images/help/settings/codespaces-org-access-and-security-radio-buttons.png) +1. [選択したリポジトリ] を選んだ場合、ドロップダウン メニューを選んでから、あなたの Organization が所有するその他のリポジトリにアクセスを許可する、リポジトリの codespace をクリックします。 その他のリポジトリにコードスペースによるアクセスを許可したい、すべてのリポジトリについて同じ手順を繰り返します。 + ![[選択したリポジトリ] ドロップダウン メニュー](/assets/images/help/settings/codespaces-access-and-security-repository-drop-down.png) -## Further reading +## 参考資料 -- "[Managing repository access for your codespaces](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)" +- [codespace のリポジトリ アクセスを管理する](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces) diff --git a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md new file mode 100644 index 0000000000..10d87a820d --- /dev/null +++ b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md @@ -0,0 +1,75 @@ +--- +title: 組織での GitHub Codespaces のコストの管理 +shortTitle: Manage Codespaces costs +intro: '{% data variables.product.prodname_github_codespaces %} の使用状況を確認し、使用制限を設定できます。' +permissions: 'To manage billing for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner or a billing manager.' +versions: + fpt: '*' + ghec: '*' +type: reference +topics: + - Codespaces + - Billing +redirect_from: + - /codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization + - /codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization +ms.openlocfilehash: f11c6e22fa8a233fd4429b91390d25471ad17e6d +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158710' +--- +## 概要 + +組織は、{% data variables.product.prodname_github_codespaces %} のコンピューティングとストレージの使用量に応じて課金されます。 この記事では、組織所有者としてこれらのコストを管理する方法について説明します。 + +{% data variables.product.prodname_github_codespaces %} の価格については、「[{% data variables.product.prodname_github_codespaces %} の課金について](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)」を参照してください。 + +## 使用制限 + +組織内の {% data variables.product.prodname_github_codespaces %} の使用制限を設定できます。 この制限は、{% data variables.product.prodname_github_codespaces %} のコンピューティングとストレージの合計コストに適用されます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の利用上限の管理](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces)」をご覧ください。 + +- **コンピューティング使用量:** これは、請求月にすべての {% data variables.product.prodname_github_codespaces %} インスタンス ("codespaces") がアクティブであった合計時間です。 + +- **ストレージ使用量:** {% data variables.product.prodname_github_codespaces %} の課金目的の場合、アカウント内のすべての codespace とプレビルドで使用されるすべてのファイルが含まれます。 これには特に、クローンされたリポジトリ、構成ファイル、拡張機能などのリソースが含まれます。 + +現在の請求月の {% data variables.product.prodname_github_codespaces %} のコンピューティングとストレージの使用量を確認できます。 詳細については、「[{% data variables.product.prodname_github_codespaces %} の使用状況を表示する](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)」を参照してください。 + +{% note %} + +**注**: {% data variables.product.prodname_github_codespaces %} のプレビルドは、{% data variables.product.prodname_actions %} を使用して作成および更新されます。 これにより、{% data variables.product.prodname_actions %} の課金対象コストが発生する可能性があります。 {% data variables.product.prodname_actions %} に対して使用制限を設定できます。 詳細については、「[{% data variables.product.prodname_github_codespaces %} の課金について](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-codespaces-prebuilds)」および「[{% data variables.product.prodname_actions %} の使用制限の管理](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)」を参照してください。 生成されたプレビルドのストレージは、codespace と同じレートで課金され、{% data variables.product.prodname_github_codespaces %} の使用制限に含まれます。 + +{% endnote %} + +## {% data variables.product.prodname_codespaces %} の無効化または制限 + +Organization への請求の対象となる {% data variables.product.prodname_github_codespaces %} の使用をすべて無効にできます。 または、Organization の費用で {% data variables.product.prodname_codespaces %} を使うことができる Organization のメンバーまたはコラボレーターを指定できます。 詳しくは、「[Organization での {% data variables.product.prodname_github_codespaces %} の有効化](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)」をご覧ください。 + +{% data reusables.codespaces.codespaces-disabling-org-billing %} + +特定のリポジトリ用に作成された codespace からアクセスできるリポジトリを構成できます。 詳しくは、「[codespace 内の他のリポジトリへのアクセスの管理](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)」をご覧ください。 + +Organization が所有するリポジトリから作成された codespace で使うことができるコンピューターの種類を制限できます。 これにより、ユーザーがリソースの多いコンピューターを codespace に使えないようにしたり、不要な料金が発生しないようにしたりすることができます。 詳細については、「[コンピューターの種類へのアクセスの制限](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)」を参照してください。 + +最大アイドル タイムアウト制約を設定して、組織に対して課金できる codespace に対してユーザーが設定できる最大タイムアウトを制限できます。 これにより、短いタイムアウト期間の後でアクティブな codespace を停止することで、アイドル状態で実行されたままになっている codespace によって生成されるコンピューティング使用量の料金を削減できます。 詳細については、「[アイドル タイムアウト期間の制限](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)」を参照してください。 + +また、停止された codespace が未使用の状態のままの期間を制限することもできます。これを過ぎると、自動的に削除されます。 これは、{% data variables.product.prodname_codespaces %} のストレージ コストの低減につながります。 詳しい情報については、「[codespace の保持期間を制限する](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)」をご覧ください。 + +リポジトリのプレビルドを設定したリポジトリ所有者は、選んだリージョンでのみ作成されるように構成することで、プレビルドのストレージ コストを削減できます。 詳しくは、「[事前ビルドを構成する](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)」をご覧ください。 + +## 未使用の codespaces の削除 + +ユーザーは、 https://github.com/codespaces または {% data variables.product.prodname_vscode %} 内から自分の codespace を削除できます。 Codespace のサイズを小さくするには、ユーザーはターミナルを使うか、{% data variables.product.prodname_vscode_shortname %} 内から、ファイルを手動で削除できます。 + +組織の所有者は、組織内の任意の codespace を削除できます。 詳細については、「[codespace の削除](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)」を参照してください。 + +{% note %} + +**注:** Codespace は、停止して、非アクティブな状態となって、ユーザー定義可能な日数を過ぎると、自動的に削除されます。 詳しい情報については、「[codespace の自動削除を構成する](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)」をご覧ください。 組織の所有者は、組織が所有する codespace の最大保持期間を設定できます。 これにより、ユーザーの個人保持設定がオーバーライドされます。 詳しい情報については、「[codespace の保持期間を制限する](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)」をご覧ください。 + +{% endnote %} + +## 参考資料 + +- [組織内の codespace を一覧表示する](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization) diff --git a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md index 4dc53ccac7..0cce939d32 100644 --- a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md +++ b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md @@ -1,7 +1,7 @@ --- -title: Reviewing your organization's audit logs for GitHub Codespaces +title: Organization の GitHub Codespaces の Audit log を確認する shortTitle: Audit logs -intro: 'You can use the audit log to review all actions related to {% data variables.product.prodname_github_codespaces %}.' +intro: 'Audit log を使用して、{% data variables.product.prodname_github_codespaces %} に関連するすべてのアクションを確認できます。' versions: fpt: '*' ghec: '*' @@ -12,17 +12,20 @@ topics: - Administrator redirect_from: - /codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-codespaces +ms.openlocfilehash: 81fbf92217c704ece2f1076de03e1f0445ded2c5 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160156' --- +Organization のメンバーが {% data variables.product.prodname_github_codespaces %} に関連するアクションを実行すると、Audit log でアクションを確認できます。 ログへのアクセスの詳細については、「[監査ログをレビューする](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#accessing-the-audit-log)」を参照してください。 - +![Codespaces 情報を含む Audit log](/assets/images/help/settings/codespaces-audit-log-org.png) -When any member of your organization performs an action related to {% data variables.product.prodname_github_codespaces %}, you can review the actions in the audit log. For information about accessing the log, see "[Reviewing your audit log](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#accessing-the-audit-log)." +監査ログには、誰がいつ何のアクションを実行したかなどの詳細が含まれます。 {% data variables.product.prodname_github_codespaces %} アクションの詳細については、「[`codespaces` カテゴリ アクション](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#codespaces-category-actions)」を参照してください。 -![Audit log with Codespaces information](/assets/images/help/settings/codespaces-audit-log-org.png) +## 参考資料 -The audit log includes details such as who performed the action, what the action was, and when the action was performed. For information on {% data variables.product.prodname_github_codespaces %} actions, see "[`codespaces` category actions](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization#codespaces-category-actions)." - -## Further reading - -- "[Reviewing your security logs for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)" -- "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)" +- 「[{% data variables.product.prodname_github_codespaces %} のセキュリティログをレビューする](/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)」 +- 「[{% data variables.product.prodname_github_codespaces %} ログ](/codespaces/troubleshooting/github-codespaces-logs)」 diff --git a/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces.md b/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces.md index 6a2cc72fd6..099f236718 100644 --- a/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces.md +++ b/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces.md @@ -1,6 +1,6 @@ --- -title: Managing encrypted secrets for your codespaces -intro: 'You can store sensitive information, like tokens, that you want to access in your codespaces via environment variables.' +title: codespaces の暗号化されたシークレットを管理する +intro: 環境変数を介してコードスペースにアクセスする、トークンなどの機密情報を保存できます。 versions: fpt: '*' ghec: '*' @@ -14,89 +14,84 @@ topics: - Security - Secret store shortTitle: Encrypted secrets +ms.openlocfilehash: f2ef60c9311a81ea59ec4f71cb7c1a432102b063 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160443' --- +## {% data variables.product.prodname_github_codespaces %} の暗号化されたシークレットについて - +コードスペースで使用する個人アカウントに、暗号化されたシークレットを追加できます。 たとえば、次のような機密情報を暗号化されたシークレットとして保存しアクセスするとよいでしょう。 +- クラウド サービスへのアクセス トークン +- サービス プリンシパル +- プラン識別子 +- [プライベート イメージ レジストリの資格情報](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry) -## About encrypted secrets for {% data variables.product.prodname_github_codespaces %} - -You can add encrypted secrets to your personal account that you want to use in your codespaces. For example, you may want to store and access the following sensitive information as encrypted secrets. - -- Access tokens to cloud services -- Service principals -- Subscription identifiers -- [Credentials for a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry) - -You can choose which repositories should have access to each secret. Then, you can use the secret in any codespace you create for a repository that has access to the secret. To share a secret with a codespace created from a template, you will need to publish the codespace to a repository on {% data variables.product.prodname_dotcom %}, then give that repository access to the secret. +各シークレットにアクセスできるリポジトリを選択できます。 そして、シークレットへのアクセス権があるリポジトリ用に作成した任意のコードスペースでそのシークレットを使用できます。 テンプレートから作成された codespace とシークレットを共有するには、{% data variables.product.prodname_dotcom %} 上のリポジトリに codespace を発行し、そのリポジトリにシークレットへのアクセス権を付与する必要があります。 {% data reusables.codespaces.secrets-on-start %} -### Naming secrets +### シークレットに名前を付ける -{% data reusables.codespaces.secrets-naming %} For example, a secret created at the repository level must have a unique name in that repository. +{% data reusables.codespaces.secrets-naming %} たとえば、リポジトリレベルで作成されたシークレットは、そのリポジトリ内で一意の名前である必要があります。 {% data reusables.codespaces.secret-precedence %} -### Limits for secrets +### シークレットの制限 -You can store up to 100 secrets for {% data variables.product.prodname_github_codespaces %}. +{% data variables.product.prodname_github_codespaces %} には最大 100 個のシークレットを保存できます。 -Secrets are limited to 64 KB in size. +シークレットの容量は最大64 KBです。 -## Adding a secret +## シークレットを追加する -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. To the right of "Codespaces secrets", click **New secret**. - !["New secret" button](/assets/images/help/settings/codespaces-new-secret-button.png) -1. Under "Name", type a name for your secret. - !["Name" text box](/assets/images/help/settings/codespaces-secret-name-field.png) -{% data reusables.user-settings.codespaces-secret-value %} -{% data reusables.user-settings.codespaces-secret-repository-access %} -1. Click **Add secret**. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. [Codespaces シークレット] の右側にある **[新しいシークレット]** をクリックします。 + ![[新しいシークレット] ボタン](/assets/images/help/settings/codespaces-new-secret-button.png) +1. [Name] で、シークレットの名前を入力します。 + ![[名前] テキスト ボックス](/assets/images/help/settings/codespaces-secret-name-field.png) {% data reusables.user-settings.codespaces-secret-value %} {% data reusables.user-settings.codespaces-secret-repository-access %} +1. **[シークレットの追加]** をクリックします。 -## Editing a secret +## シークレットを編集する -You can update the value of an existing secret, and you can change which repositories can access a secret. +既存のシークレットの値を更新したり、シークレットがアクセスできるリポジトリを変更したりすることができます。 -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Codespaces secrets", to the right of the secret you want to edit, click **Update**. - !["Update" button](/assets/images/help/settings/codespaces-secret-update-button.png) -1. Under "Value", click **enter a new value**. - !["enter a new value" link](/assets/images/help/settings/codespaces-secret-update-value-text.png) -{% data reusables.user-settings.codespaces-secret-value %} -{% data reusables.user-settings.codespaces-secret-repository-access %} -1. Optionally, to remove the secret's access to a repository, deselect the repository. - ![Checkboxes to remove access to repositories](/assets/images/help/settings/codespaces-secret-repository-checkboxes.png) -1. Click **Save changes**. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. [Codespaces シークレット] で、編集するシークレットの右側にある **[更新]** をクリックします。 + ![[更新] ボタン](/assets/images/help/settings/codespaces-secret-update-button.png) +1. [値] で、 **[新しい値の入力]** をクリックします。 + ![[新しい値の入力] リンク](/assets/images/help/settings/codespaces-secret-update-value-text.png) {% data reusables.user-settings.codespaces-secret-value %} {% data reusables.user-settings.codespaces-secret-repository-access %} +1. リポジトリへのシークレットのアクセス権を削除する場合は、リポジトリを選択解除します。 + ![リポジトリへのアクセス権を削除するチェックボックス](/assets/images/help/settings/codespaces-secret-repository-checkboxes.png) +1. **[変更を保存]** をクリックします。 -## Deleting a secret +## シークレットを削除する -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Codespaces secrets", to the right of the secret you want to delete, click **Delete**. - !["Delete" button](/assets/images/help/settings/codespaces-secret-delete-button.png) -1. Read the warning, then click **OK**. - ![Confirmation to delete secret](/assets/images/help/settings/codespaces-secret-delete-warning.png) +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. [Codespaces シークレット] で、削除するシークレットの右側にある **[削除]** をクリックします。 + ![[削除] ボタン](/assets/images/help/settings/codespaces-secret-delete-button.png) +1. 警告を読み、 **[OK]** をクリックします。 + ![シークレットの削除の確認](/assets/images/help/settings/codespaces-secret-delete-warning.png) -## Using secrets +## シークレットの使用 -A secret is exported as an environment variable into the user's terminal session. +シークレットは環境変数としてユーザーのターミナル セッションにエクスポートされます。 - ![Displaying the value of an exported secret in the terminal](/assets/images/help/codespaces/exported-codespace-secret.png) + ![エクスポートされたシークレットの値をターミナルに表示する](/assets/images/help/codespaces/exported-codespace-secret.png) -You can use secrets in a codespace after the codespace is built and is running. For example, a secret can be used: +codespace が構築されて実行されたら、codespace でシークレットを使用できます。 たとえば、次のような場合にシークレットを使用できます。 -* When launching an application from the integrated terminal or ssh session. -* Within a dev container lifecycle script that is run after the codespace is running. For more information about dev container lifecycle scripts, see the documentation on containers.dev: [Specification](https://containers.dev/implementors/json_reference/#lifecycle-scripts). +* 統合ターミナルまたは ssh セッションからアプリケーションを起動するとき。 +* codespace の実行後に実行される開発コンテナー ライフサイクル スクリプト内。 開発コンテナー ライフサイクル スクリプトについて詳しくは、containers.dev の[指定](https://containers.dev/implementors/json_reference/#lifecycle-scripts)に関するドキュメントをご覧ください。 -Codespace secrets cannot be used: +codespace シークレットは、次の場合は使用できません。 -* During codespace build time (that is, within a Dockerfile or custom entry point). -* Within a dev container feature. For more information, see the `features` property in the [dev containers specification](https://containers.dev/implementors/json_reference/#general-properties) on containers.dev. +* codespace の構築時間 (つまり、Dockerfile またはカスタム エントリ ポイント内)。 +* 開発コンテナー機能内。 詳しくは、containers.dev の[開発コンテナーの仕様](https://containers.dev/implementors/json_reference/#general-properties)に関するページの `features` プロパティをご覧ください。 -## Further reading +## 参考資料 -- "[Managing encrypted secrets for your repository and organization for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces)" +- 「[リポジトリの暗号化されたシークレットと {% data variables.product.prodname_github_codespaces %} の Organization を管理する](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces)」 diff --git a/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md b/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md index 692b4c28a6..2492e27e5c 100644 --- a/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md +++ b/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Managing GPG verification for GitHub Codespaces -intro: 'You can allow {% data variables.product.company_short %} to automatically use GPG to sign commits you make in your codespaces, so other people can be confident that the changes come from a trusted source.' +title: GitHub Codespaces の GPG 検証を管理する +intro: '変更が信頼できるソースからのものであることを他の人々が確信できるよう、コードスペースで作成したコミットに GPG を自動的に使用して署名するよう {% data variables.product.company_short %} に許可できます。' versions: fpt: '*' ghec: '*' @@ -14,26 +14,28 @@ redirect_from: - /codespaces/working-with-your-codespace/managing-gpg-verification-for-codespaces - /codespaces/managing-your-codespaces/managing-gpg-verification-for-codespaces shortTitle: GPG verification +ms.openlocfilehash: ff83eba1720a2841747536ec04bfc0b3db055669 +ms.sourcegitcommit: 47e03737d09bed84dfedb7be5924d893d34ea1a8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167102' --- - - - -After you enable GPG verification, {% data variables.product.company_short %} will automatically sign commits you make in {% data variables.product.prodname_github_codespaces %}, and the commits will have a verified status on {% data variables.product.product_name %}. By default, GPG verification is disabled for codespaces you create. You can choose to allow GPG verification for all repositories or specific repositories. Only enable GPG verification for repositories that you trust. For more information about {% data variables.product.product_name %}-signed commits, see "[About commit signature verification](/github/authenticating-to-github/about-commit-signature-verification)." +GPG 検証を有効にすると、{% data variables.product.company_short %} は {% data variables.product.prodname_github_codespaces %} であなたが作成したコミットに自動的に署名し、そのコミットは {% data variables.product.product_name %} で検証済みのステータスとなります。 デフォルトでは、GPG 検証は作成されたコードスペースに対して無効になっています。 GPG 検証を、すべてのリポジトリに対して許可するか特定のリポジトリに対して許可するか選択できます。 GPG 検証は、信頼するリポジトリに対してのみ有効にしてください。 {% data variables.product.product_name %} 署名済みコミットの詳細については、「[コミットの署名の検証について](/github/authenticating-to-github/about-commit-signature-verification)」を参照してください。 {% data reusables.codespaces.gpg-in-active-codespaces %} {% note %} -**Note:** If you have linked a dotfiles repository with {% data variables.product.prodname_github_codespaces %}, the Git configuration in your dotfiles may conflict with the configuration that {% data variables.product.prodname_github_codespaces %} requires to sign commits. For more information, see "[Troubleshooting GPG verification for {% data variables.product.prodname_github_codespaces %}](/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces)." +**注:** ドットファイル リポジトリを {% data variables.product.prodname_github_codespaces %} にリンクしている場合、ドットファイル内の Git 構成が、{% data variables.product.prodname_github_codespaces %} でコミットに署名するために必要な構成と競合する可能性があります。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の GPG 検証のトラブルシューティング](/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces)」を参照してください。 {% endnote %} -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "GPG verification", select the setting you want for GPG verification. - ![Radio buttons to manage GPG verification](/assets/images/help/settings/codespaces-gpg-verification-radio-buttons.png) -1. If you chose "Selected repositories", select the dropdown menu, then click a repository you want enable GPG verification for. Repeat for all repositories you want to enable GPG verification for. - !["Selected repositories" dropdown menu](/assets/images/help/settings/codespaces-gpg-verification-repository-drop-down.png) +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. [GPG verification] で、GPG 検証の設定を選択します。 + ![GPG 検証を管理するラジオ ボタン](/assets/images/help/settings/codespaces-gpg-verification-radio-buttons.png) +1. [選択したリポジトリ] を選んだ場合、ドロップダウン メニューを選んでから、GPG 検証を有効にするリポジトリをクリックします。 GPG 検証を有効にするすべてのリポジトリについて、同じ手順を繰り返します。 + ![[選択したリポジトリ] ドロップダウン メニュー](/assets/images/help/settings/codespaces-gpg-verification-repository-drop-down.png) -Once you have enabled GPG verification for {% data variables.product.prodname_github_codespaces %}, all commits are signed by default in your codespaces. \ No newline at end of file +{% data variables.product.prodname_github_codespaces %} の GPG 検証を有効にすると、すべてのコミットは codespace で既定で署名されます。 diff --git a/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md b/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md index 4519c40fd5..9b1cf12373 100644 --- a/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md +++ b/translations/ja-JP/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md @@ -1,8 +1,8 @@ --- -title: Managing access to other repositories within your codespace +title: codespace 内の他のリポジトリへのアクセスの管理 allowTitleToDifferFromFilename: true shortTitle: Repository access -intro: 'You can manage the repositories that {% data variables.product.prodname_github_codespaces %} can access.' +intro: '{% data variables.product.prodname_github_codespaces %} からアクセスできるリポジトリを管理できます。' versions: fpt: '*' ghec: '*' @@ -11,26 +11,31 @@ topics: - Security redirect_from: - /codespaces/managing-your-codespaces/managing-access-and-security-for-your-codespaces +ms.openlocfilehash: 3f8379c322bd7ccd9ff7d31e17da90a77461536d +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160108' --- +## 概要 -## Overview +既定では、codespace には、作成元のリポジトリをスコープとするトークンが割り当てられます。 テンプレートから作成した codespace を {% data variables.product.product_name %} 上の新しいリポジトリに発行すると、codespace には新しいリポジトリにスコープが設定されたトークンが割り当てられます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} のセキュリティ](/codespaces/codespaces-reference/security-in-github-codespaces#authentication)」をご覧ください。 プロジェクトに他のリポジトリに対する追加のアクセス許可が必要な場合は、`devcontainer.json` ファイルでこれを構成し、他のコラボレーターが適切なアクセス許可セットを持っていることを確認できます。 -By default, your codespace is assigned a token scoped to the repository from which it was created. When you publish a codespace that you created from a template to a new repository on {% data variables.product.product_name %}, the codespace is assigned a token scoped to the new repository. For more information, see "[Security in {% data variables.product.prodname_github_codespaces %}](/codespaces/codespaces-reference/security-in-github-codespaces#authentication)." If your project needs additional permissions for other repositories, you can configure this in the `devcontainer.json` file and ensure other collaborators have the right set of permissions. +`devcontainer.json` ファイルにアクセス許可が一覧表示されると、そのリポジトリのcodespace 作成の一環として、追加のアクセス許可を確認して承認するように求められます。 一覧表示されているアクセス許可を承認すると、{% data variables.product.prodname_github_codespaces %} は選択を記憶し、`devcontainer.json` ファイル内のアクセス許可が変更されない限り、承認を求めるメッセージは表示されません。 -When permissions are listed in the `devcontainer.json` file, you will be prompted to review and authorize the additional permissions as part of codespace creation for that repository. Once you've authorized the listed permissions, {% data variables.product.prodname_github_codespaces %} will remember your choice and will not prompt you for authorization unless the permissions in the `devcontainer.json` file change. +## 前提条件 -## Prerequisites +カスタム アクセス許可が定義された codespace を作成するには、次のいずれかを使用する必要があります。 +* {% data variables.product.prodname_dotcom %} Web UI +* [{% data variables.product.prodname_dotcom %} CLI](https://github.com/cli/cli/releases/latest) 2.5.2 以降 +* [{% data variables.product.prodname_github_codespaces %} {% data variables.product.prodname_vscode %} 拡張機能](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces) 1.5.3 以降 -To create codespaces with custom permissions defined, you must use one of the following: -* The {% data variables.product.prodname_dotcom %} web UI -* [{% data variables.product.prodname_dotcom %} CLI](https://github.com/cli/cli/releases/latest) 2.5.2 or later -* [{% data variables.product.prodname_github_codespaces %} {% data variables.product.prodname_vscode %} extension](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces) 1.5.3 or later +## 追加のリポジトリのアクセス許可の設定 -## Setting additional repository permissions +1. `devcontainer.json` ファイルの {% data variables.product.prodname_github_codespaces %} のリポジトリのアクセス許可を構成します。 リポジトリに `devcontainer.json` ファイルがまだ含まれていない場合は、今すぐ追加します。 詳細については、「[プロジェクトへの開発コンテナーへの追加](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)」に関するページを参照してください。 -1. You configure repository permissions for {% data variables.product.prodname_github_codespaces %} in the `devcontainer.json` file. If your repository does not already contain a `devcontainer.json` file, add one now. For more information, "[Add a dev container to your project](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)." - -1. Edit the `devcontainer.json` file, adding the repository name and permissions needed to the `repositories` object: +1. `devcontainer.json` ファイルを編集し、`repositories` オブジェクトに必要なリポジトリ名とアクセス許可を追加します。 ```json{:copy} { @@ -50,25 +55,25 @@ To create codespaces with custom permissions defined, you must use one of the fo {% note %} - **Note:** You can only reference repositories that belong to the same personal account or organization as the repository you are currently working in. + **注:** 参照できるのは、現在作業しているリポジトリと同じ個人アカウントまたは組織に属するリポジトリのみです。 {% endnote %} - You can grant as many or as few of the following permissions for each repository listed: - * `actions` - read / write - * `checks` - read / write - * `contents` - read / write - * `deployments` - read / write - * `discussions` - read / write - * `issues` - read / write - * `packages` - read - * `pages` - read / write - * `pull_requests` - read / write - * `repository_projects` - read / write - * `statuses` - read / write - * `workflows` - write + 一覧に示されている各リポジトリに対して、次のアクセス許可のうち、いくつでも付与することができます。 + * `actions` - 読み取り / 書き込み + * `checks` - 読み取り / 書き込み + * `contents` - 読み取り / 書き込み + * `deployments` - 読み取り / 書き込み + * `discussions` - 読み取り / 書き込み + * `issues` - 読み取り / 書き込み + * `packages` - 読み取り + * `pages` - 読み取り / 書き込み + * `pull_requests` - 読み取り / 書き込み + * `repository_projects` - 読み取り / 書き込み + * `statuses` - 読み取り / 書き込み + * `workflows` - 書き込み - To set a permission for all repositories in an organization, use the `*` wildcard following your organization name in the `repositories` object. + 組織内のすべてのリポジトリのアクセス許可を設定するには、`repositories` オブジェクト内の組織名の後に `*` ワイルドカードを使用します。 ```json { @@ -86,7 +91,7 @@ To create codespaces with custom permissions defined, you must use one of the fo } ``` - To set all permissions for a given repository, use `"permissions": "read-all"` or `"permissions": "write-all"` in the repository object. + 特定のリポジトリのすべてのアクセス許可を設定するには、リポジトリ オブジェクトで `"permissions": "read-all"` または `"permissions": "write-all"` を使用します。 ```json { @@ -102,32 +107,31 @@ To create codespaces with custom permissions defined, you must use one of the fo } ``` -## Authorizing requested permissions +## 要求されたアクセス許可の承認 -If additional repository permissions are defined in the `devcontainer.json` file, you will be prompted to review and optionally authorize the permissions when you create a codespace or a prebuild configuration for this repository. When you authorize permissions for a repository, {% data variables.product.prodname_github_codespaces %} will not re-prompt you unless the set of requested permissions has changed for the repository. +`devcontainer.json` ファイルで追加のリポジトリのアクセス許可が定義されている場合、このリポジトリの codespace またはプレビルド構成を作るときに、アクセス許可を確認し、必要に応じて認可するように求められます。 リポジトリのアクセス許可を承認すると、要求されたアクセス許可のセットがリポジトリに対して変更されない限り、{% data variables.product.prodname_github_codespaces %} は再プロンプトを表示しません。 -![The requested permissions page](/assets/images/help/codespaces/codespaces-accept-permissions.png) +![要求されたアクセス許可ページ](/assets/images/help/codespaces/codespaces-accept-permissions.png) -You should only authorize permissions for repositories you know and trust. If you don't trust the set of requested permissions, click **Continue without authorizing** to create the codespace with the base set of permissions. Rejecting additional permissions may impact the functionality of your project within the codespace as the codespace will only have access to the repository from which it was created. +承認する必要があるのは、自分が知っていて信頼できるリポジトリに対するアクセス許可のみです。 要求されたアクセス許可のセットを信頼できない場合は、 **[承認なしで続行]** をクリックして、基本のアクセス許可のセットを使用して codespace を作成します。 追加のアクセス許可を拒否すると、codespace は作成元のリポジトリにしかアクセスできないため、codespace 内のプロジェクトの機能に影響を与える可能性があります。 -You can only authorize permissions that your personal account already possesses. If a codespace requests permissions for repositories that you don't currently have access to, contact an owner or admin of the repository to obtain sufficient access and then try to create a codespace again. +個人アカウントが既に所有しているアクセス許可のみを承認できます。 現在アクセス権を持たないリポジトリでのアクセス許可を codespace が要求する場合は、リポジトリの所有者または管理者に連絡して十分なアクセス権を取得してから、codespace の作成を再試行してください。 -## Access and security +## アクセスとセキュリティ {% warning %} -**Deprecation note**: The access and security setting described below is now deprecated and is documented here for reference only. To enable expanded access to other repositories, add the requested permissions to your dev container definition for your codespace, as described above. +**非推奨の注意**: 以下で説明するアクセスとセキュリティの設定は現在非推奨であり、ここには参考用に記載されています。 他のリポジトリへの拡張アクセスを有効にするには、前述のように、要求されたアクセス許可を codespace の開発コンテナー定義に追加します。 {% endwarning %} -When you enable access and security for a repository owned by your personal account, any codespaces that are created for that repository will have read permissions to all other repositories you own. If you want to restrict the repositories a codespace can access, you can limit to it to either the repository the codespace was opened for or specific repositories. You should only enable access and security for repositories you trust. +個人アカウントが所有するリポジトリのアクセスとセキュリティを有効にすると、そのリポジトリ用に作成された codespace には、所有している他のすべてのリポジトリへの読み取り権限が付与されます。 Codespace がアクセスできるリポジトリを制限する場合は、Codespace がオープンされたリポジトリまたは特定のリポジトリのいずれかに制限できます。 信頼するリポジトリに対してのみ、アクセスとセキュリティを有効にしてください。 -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.codespaces-tab %} -1. Under "Access and security", select the setting you want for your personal account. +{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %} +1. [アクセスとセキュリティ] で、あなたの個人アカウントの設定を選択します。 - ![Radio buttons to manage trusted repositories](/assets/images/help/settings/codespaces-access-and-security-radio-buttons.png) + ![信頼するリポジトリを管理するラジオボタン](/assets/images/help/settings/codespaces-access-and-security-radio-buttons.png) -1. If you chose "Selected repositories", select the dropdown menu, then click a repository to allow the repository's codespaces to access other repositories you own. Repeat for all repositories whose codespaces you want to access other repositories you own. +1. [選択したリポジトリ] を選んだ場合、ドロップダウン メニューを選んでから、あなたの所有するその他のリポジトリにアクセスを許可する、リポジトリの codespace をクリックします。 所有するその他のリポジトリにコードスペースによるアクセスを許可したい、すべてのリポジトリについて同じ手順を繰り返します。 - !["Selected repositories" dropdown menu](/assets/images/help/settings/codespaces-access-and-security-repository-drop-down.png) + ![[選択したリポジトリ] ドロップダウン メニュー](/assets/images/help/settings/codespaces-access-and-security-repository-drop-down.png) diff --git a/translations/ja-JP/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md b/translations/ja-JP/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md index 475292c833..6ae24731f1 100644 --- a/translations/ja-JP/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md +++ b/translations/ja-JP/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md @@ -1,7 +1,7 @@ --- -title: Reviewing your security logs for GitHub Codespaces +title: GitHub Codespaces のセキュリティ ログをレビューする shortTitle: Security logs -intro: 'You can use the security log to review all actions related to {% data variables.product.prodname_github_codespaces %}.' +intro: 'セキュリティログを使用して、{% data variables.product.prodname_github_codespaces %} に関連するすべてのアクションをレビューできます。' versions: fpt: '*' ghec: '*' @@ -11,19 +11,22 @@ topics: - Security redirect_from: - /codespaces/managing-your-codespaces/reviewing-your-security-logs-for-codespaces +ms.openlocfilehash: 51cd11f123cbc2b6b67e089d65bc68d3441aa5b8 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160072' --- +## {% data variables.product.prodname_github_codespaces %} のセキュリティログについて - +個人アカウントが所有するリポジトリで {% data variables.product.prodname_github_codespaces %} に関連するアクションを実行したときは、セキュリティ ログでアクションをレビューできます。 ログへのアクセスの詳細については、「[セキュリティ ログをレビューする](/github/authenticating-to-github/reviewing-your-security-log#accessing-your-security-log)」を参照してください。 -## About security logs for {% data variables.product.prodname_github_codespaces %} +![Codespaces 情報を含むセキュリティログ](/assets/images/help/settings/codespaces-audit-log.png) -When you perform an action related to {% data variables.product.prodname_github_codespaces %} in repositories owned by your personal account, you can review the actions in the security log. For information about accessing the log, see "[Reviewing your security log](/github/authenticating-to-github/reviewing-your-security-log#accessing-your-security-log)." +セキュリティログには、発生したアクションの詳細と実行タイミングについての詳細が含まれます。 {% data variables.product.prodname_github_codespaces %} アクションの詳細については、「[{% data variables.product.prodname_codespaces %} カテゴリ アクション](/github/authenticating-to-github/reviewing-your-security-log#codespaces-category-actions)」を参照してください。 -![security log with Codespaces information](/assets/images/help/settings/codespaces-audit-log.png) +## 参考資料 -The security log includes details on what action occurred and when you performed it. For information about {% data variables.product.prodname_github_codespaces %} actions, see "[{% data variables.product.prodname_codespaces %} category actions](/github/authenticating-to-github/reviewing-your-security-log#codespaces-category-actions)". - -## Further reading - -- "[Reviewing your organization's audit logs for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)" -- "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)" \ No newline at end of file +- 「[Organization の {% data variables.product.prodname_github_codespaces %} の Audit log を確認する](/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)」 +- 「[{% data variables.product.prodname_github_codespaces %} ログ](/codespaces/troubleshooting/github-codespaces-logs)」 diff --git a/translations/ja-JP/content/codespaces/overview.md b/translations/ja-JP/content/codespaces/overview.md index cf18e5b837..d5f76f405c 100644 --- a/translations/ja-JP/content/codespaces/overview.md +++ b/translations/ja-JP/content/codespaces/overview.md @@ -15,12 +15,12 @@ versions: type: overview topics: - Codespaces -ms.openlocfilehash: a1618c86671bc5b06474c41803c6b34576a897aa -ms.sourcegitcommit: 2e1852bcdd690cb66b9b5d69cb056a2bb2b9a6b4 +ms.openlocfilehash: 9d01df3f8dae7ceb788e2dd57b02fb3cc977400d +ms.sourcegitcommit: 1529de77bfcbe45519131b5f5fb3ab319758c2d2 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 11/10/2022 -ms.locfileid: '148160801' +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148164324' --- ## codespace とは @@ -50,7 +50,7 @@ codespace への接続には、ブラウザー、{% data variables.product.prodn Organization の所有者は、{% data variables.product.prodname_github_codespaces %} の使用を有効にすることができ、Organization または Enterprise アカウントに対して課金できます。 これは、Organization が所有するリポジトリから作成された codespace に適用されます。 詳しくは、「[Organization での {% data variables.product.prodname_github_codespaces %} の有効化](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization)」をご覧ください。 Organization または Enterprise アカウントで {% data variables.product.prodname_github_codespaces %} を使用するための使用制限を設定できます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の利用上限の管理](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces)」をご覧ください。 -codespace の使用が Organization または Enterprise に課金される場合は、codespace の作成時に表示されます。 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)」を参照してください。 Organization またはその親 Enterprise に課金される codespace は、Organization が所有しており Organization の所有者を削除できます。 詳細については、「[codespace の削除](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)」を参照してください。 +codespace の使用が Organization または Enterprise に課金される場合は、codespace の作成時に表示されます。 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)」を参照してください。 組織、またはその親エンタープライズに課金される codespace は、組織によって所有され、組織の所有者が削除できます。 詳細については、「[codespace の削除](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)」を参照してください。 ### {% data variables.product.prodname_github_codespaces %} のカスタマイズ diff --git a/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md b/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md index 45f4bd4c6b..6514047f43 100644 --- a/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md +++ b/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md @@ -1,7 +1,7 @@ --- -title: About GitHub Codespaces prebuilds +title: GitHub Codespaces のプレビルドについて shortTitle: About prebuilds -intro: '{% data variables.product.prodname_github_codespaces %} prebuilds help to speed up the creation of new codespaces for large or complex repositories.' +intro: '{% data variables.product.prodname_github_codespaces %} プレビルドは、大規模または複雑なリポジトリの新しい codespace の作成を高速化するのに役立ちます。' versions: fpt: '*' ghec: '*' @@ -9,43 +9,48 @@ topics: - Codespaces redirect_from: - /codespaces/prebuilding-your-codespaces/about-codespaces-prebuilds +ms.openlocfilehash: e0962e410f2227a23ff98c8a3e7995ea8ec8a914 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158798' --- - -## Overview +## 概要 {% data reusables.codespaces.prebuilds-definition %} -If it currently takes more than 2 minutes to create a codespace for a repository, you are likely to benefit from using prebuilds. This is because, with a prebuild, any source code, editor extensions, project dependencies, commands, and configurations have already been downloaded, installed, and applied before you create a codespace. +リポジトリの codespace の作成に現在 2 分以上かかる場合、プレビルドを使用すると改善することがあります。 これは、プレビルドを使用する場合、プロジェクト用の codespace を作成する前に、ソース コード、エディター拡張機能、プロジェクトの依存関係、コマンド、構成が既にダウンロード、インストール、適用されているためです。 -By default, whenever you push changes to your repository, {% data variables.product.prodname_github_codespaces %} uses {% data variables.product.prodname_actions %} to automatically update your prebuilds. +既定では、リポジトリに変更をプッシュするたびに、{% data variables.product.prodname_github_codespaces %} は {% data variables.product.prodname_actions %} を使って、プレビルドを自動的に更新します。 -When prebuilds are available for a particular branch of a repository, a particular dev container configuration file, and for your region, you'll see the "{% octicon "zap" aria-label="The zap icon" %} Prebuild ready" label in the list of machine type options when you create a codespace. If a prebuild is still being created, you will see the "{% octicon "history" aria-label="The history icon" %} Prebuild in progress" label. 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)." +リポジトリの特定のブランチ、特定の開発コンテナー構成ファイル、ご利用のリージョンでプレビルドを使用できる場合、codespace を作成するときに、マシンの種類の一覧に、"{% octicon "zap" aria-label="The zap icon" %} プレビルド準備完了" というラベルが表示されます。 プレビルドがまだ作成中の場合、"{% octicon "history" aria-label="The history icon" %} プレビルド進行中" ラベルが表示されます。 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)」を参照してください。 -![The dialog box for choosing a machine type](/assets/images/help/codespaces/choose-custom-machine-type.png) +![コンピューターの種類を選択するためのダイアログ ボックス](/assets/images/help/codespaces/choose-custom-machine-type.png) -When you create a codespace from a template on the "Your codespaces" page, {% data variables.product.prodname_dotcom %} may automatically use a prebuild to speed up creation time. For more information on templates, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)." +"Your codespaces" ページでテンプレートから codespace を作成するとき、{% data variables.product.prodname_dotcom %} では、自動的にプレビルドを使用して作成時間を短縮できます。 テンプレートについて詳しくは、「[テンプレートから codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)」を参照してください。 -## The prebuild process +## プレビルドのプロセス -To create a prebuild you set up a prebuild configuration. When you save the configuration, a {% data variables.product.prodname_actions %} workflow runs to create each of the required prebuilds; one workflow per prebuild. Workflows also run whenever the prebuilds for your configuration need to be updated. This can happen at scheduled intervals, on pushes to a prebuild-enabled repository, or when you change the dev container configuration. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)." +プレビルドを作成するには、プレビルドの構成を設定します。 構成を保存すると、{% data variables.product.prodname_actions %} ワークフローが実行され、必要な各ビルド (プレビルドごとに 1 つのワークフロー) が作成されます。 ワークフローは、構成のプレビルドを更新する必要がある場合にも実行されます。 これは、スケジュールされた間隔、プレビルドが有効なリポジトリへのプッシュ時、または開発コンテナーの構成を変更するときに発生する可能性があります。 詳細については、「[プレビルドの構成](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)」を参照してください。 -When a prebuild configuration workflow runs, {% data variables.product.prodname_dotcom %} creates a temporary codespace, performing setup operations up to and including any `onCreateCommand` and `updateContentCommand` commands in the `devcontainer.json` file. No `postCreateCommand` commands are run during the creation of a prebuild. For more information about these commands, see the [`devcontainer.json` reference](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) in the {% data variables.product.prodname_vscode_shortname %} documentation. A snapshot of the generated container is then taken and stored. +プレビルドの構成ワークフローが実行されると、{% data variables.product.prodname_dotcom %} により一時的な codespace が作成され、`devcontainer.json` ファイル内の任意の `onCreateCommand` および `updateContentCommand` コマンドまでの設定操作が実行されます。 プレビルドの作成時に `postCreateCommand` コマンドは実行されません。 これらのコマンドについて詳しくは、{% data variables.product.prodname_vscode_shortname %} ドキュメントの「[`devcontainer.json` リファレンス](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties)」を参照してください。 生成されたコンテナーのスナップショットが取得され、格納されます。 -As with other {% data variables.product.prodname_actions %} workflows, running a prebuild configuration workflow will either consume some of the {% data variables.product.prodname_actions %} minutes included with your account, if you have any, or it will incur charges for {% data variables.product.prodname_actions %} minutes. Storage of codespace prebuilds is billed in the same way as storage of active or stopped codespaces. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-codespaces-prebuilds)." +その他の {% data variables.product.prodname_actions %} ワークフローと同様に、プレビルド構成ワークフローを実行すると、アカウントに含まれている {% data variables.product.prodname_actions %} 分が残っている場合、それが使用されます。あるいは、{% data variables.product.prodname_actions %} 分に対して料金が発生します。 codespace プレビルドのストレージは、アクティブな codespace または停止した codespace のストレージと同じ方法で課金されます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-codespaces-prebuilds)」をご覧ください。 -When you create a codespace from a prebuild, {% data variables.product.prodname_dotcom %} downloads the existing container snapshot from storage and deploys it on a fresh virtual machine, completing the remaining commands specified in the dev container configuration. Since many operations have already been performed, such as cloning the repository, creating a codespace from a prebuild can be substantially quicker than creating one without a prebuild. This is true where the repository is large and/or `onCreateCommand` commands take a long time to run. +プレビルドから codespace を作成すると、{% data variables.product.prodname_dotcom %} によりストレージから既存のコンテナー スナップショットがダウンロードされ、それを新しい仮想マシンにデプロイし、開発コンテナー構成で指定された残りのコマンドを完了します。 リポジトリの複製など、多くの操作が既に実行されているため、プレビルドから codespace を作成する方が、プレビルドなしで作成するよりも大幅に速くなる可能性があります。 これは、リポジトリが大きい場合や `onCreateCommand` コマンドの実行に時間がかかる場合に当てはまります。 -## About pushing changes to prebuild-enabled branches +## プレビルドが有効なブランチへの変更のプッシュについて -By default, each push to a branch that has a prebuild configuration results in a {% data variables.product.prodname_dotcom %}-managed {% data variables.product.prodname_actions %} workflow run to update the prebuild. The prebuild workflow has a concurrency limit of one workflow run at a time for a given prebuild configuration, unless changes were made that affect the dev container configuration for the associated repository. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." If a run is already in progress, the workflow run that was queued most recently queued will run next, after the current run completes. +既定では、プレビルドの構成があるブランチにプッシュするたびに、{% data variables.product.prodname_dotcom %} で管理される {% data variables.product.prodname_actions %} ワークフローが実行され、プレビルドが更新されます。 関連するリポジトリの開発コンテナー構成に影響を与える変更が行われたのでない限り、プレビルド ワークフローには、特定のプレビルド構成に対して一度に 1 つのワークフロー実行というコンカレンシー制限があります。 詳細については、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)」をご覧ください。 実行が既に進行中の場合は、現在の実行が完了した後、最後にキューに登録されたワークフロー実行が次に実行されます。 -With the prebuild set to be updated on each push, it means that if there are very frequent pushes to your repository, prebuild updates will occur at least as often as it takes to run the prebuild workflow. That is, if your workflow run typically takes one hour to complete, prebuilds will be created for your repository roughly hourly, if the run succeeds, or more often if there were pushes that change the dev container configuration on the branch. +プッシュのたびにプレビルドが更新されるように設定すると、リポジトリへのプッシュが非常に多い場合、プレビルドは少なくとも、プレビルド ワークフローの実行に必要なだけ更新されます。 つまり、ワークフローの実行が完了するまでに通常 1 時間かかるとすると、実行が成功する場合は約 1 時間ごと、ブランチの開発コンテナー構成を変更するプッシュがあった場合はさらに頻繁に、リポジトリに対してプレビルドが作成されます。 -For example, let's imagine 5 pushes are made, in quick succession, against a branch that has a prebuild configuration. In this situation: +たとえば、プレビルドが構成されたブランチに対し、プッシュが 5 回立て続けに行われるとします。 この状況では、次のようになります。 -* A workflow run is started for the first push, to update the prebuild. -* If the 4 remaining pushes do not affect the dev container configuration, the workflow runs for these are queued in a "pending" state. +* 1 番目のプッシュに対するワークフローの実行が開始され、プレビルドが更新されます。 +* 残りの 4 つのプッシュが開発コンテナーの構成に影響しない場合、これらに対するワークフロー実行は "保留中" 状態でキューに入れられます。 - If any of the remaining 4 pushes change the dev container configuration, then the service will not skip that one and will immediately run the prebuild creation workflow, updating the prebuild accordingly if it succeeds. + 残りの 4 つのプッシュのいずれかが開発コンテナーの構成を変更する場合は、サービスはそれをスキップせず、プレビルド作成ワークフローを直ちに実行して、成功した場合はそれに応じてプレビルドを更新します。 -* Once the first run completes, workflow runs for pushes 2, 3, and 4 will be canceled, and the last queued workflow (for push 5) will run and update the prebuild. +* 最初の実行が完了すると、プッシュ 2、3、4 に対するワークフローの実行は取り消されて、最後にキューに入れられたワークフロー (プッシュ 5 に対する) が実行され、プレビルドが更新されます。 diff --git a/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md b/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md index d8302ff3d2..5eae882201 100644 --- a/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md +++ b/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md @@ -1,7 +1,7 @@ --- -title: Managing prebuilds +title: 事前ビルドの管理 shortTitle: Manage prebuilds -intro: 'You can review, modify, and delete the prebuild configurations for your repository.' +intro: リポジトリのプレビルド構成をレビュー、変更、削除できます。 versions: fpt: '*' ghec: '*' @@ -9,90 +9,95 @@ type: how_to topics: - Codespaces miniTocMaxHeadingLevel: 3 +ms.openlocfilehash: f39c46d91193db4c1c44ab336d86024b40adcea4 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160188' --- +## 事前ビルド構成を確認、変更、削除する -## Checking, changing, and deleting your prebuild configurations +リポジトリに対して構成したプレビルドは、{% data variables.product.prodname_actions %} ワークフローを使用して作成および更新され、{% data variables.product.prodname_github_codespaces %} サービスによって管理されます。 -The prebuilds that you configure for a repository are created and updated using a {% data variables.product.prodname_actions %} workflow, managed by the {% data variables.product.prodname_github_codespaces %} service. +プレビルド構成での設定によっては、プレビルドを更新するワークフローが、次のイベントによってトリガーされる場合があります。 -Depending on the settings in a prebuild configuration, the workflow to update the prebuild may be triggered by these events: +* 事前ビルド構成を作成または更新する +* 事前ビルドを持つように構成されているブランチにコミットまたは pull request をプッシュする +* 開発コンテナー構成ファイルの変更 +* 事前ビルドの構成で定義したスケジュール +* ワークフローを手動でトリガーする -* Creating or updating the prebuild configuration -* Pushing a commit or a pull request to a branch that's configured to have prebuilds -* Changing any of the dev container configuration files -* A schedule that you've defined in the prebuild configuration -* Manually triggering the workflow +プレビルド構成の設定によって、プレビルドの更新を自動的にトリガーするイベントが決まります。 詳しくは、「[事前ビルドを構成する](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)」をご覧ください。 -The settings in the prebuild configuration determine which events automatically trigger an update of the prebuild. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)." +リポジトリへの管理者アクセス権を持つユーザーは、事前ビルドの進行状況の確認、事前ビルド構成の編集と削除ができます。 -People with admin access to a repository can check the progress of prebuilds, edit, and delete prebuild configurations. +### 事前ビルドの進行状況を表示する +リポジトリ設定の {% data variables.product.prodname_github_codespaces %} ページで、設定した事前ビルド構成ごとに最新のワークフロー実行の現在の状態を表示できます。 たとえば、"現在実行中" や "1 時間前に最後の実行" などです。 -### Viewing the progress of prebuilds -You can view the current status of the latest workflow run for each prebuild configuration you've set up on the {% data variables.product.prodname_github_codespaces %} page of your repository settings. For example, "Currently running" or "Last run 1 hour ago." +最新の事前ビルド ワークフロー実行のログ出力を表示するには、 **[出力の表示]** をクリックします。 -To see the log output for the latest prebuild workflow run, click **See output**. +![[出力の表示] ボタン](/assets/images/help/codespaces/prebuilds-see-output.png) -![The 'See output' button](/assets/images/help/codespaces/prebuilds-see-output.png) +**[アクション]** タブにワークフローの最新の実行の出力が表示されます。 -This displays the output of the most recent run of the workflow in the **Actions** tab. +![事前ビルド ワークフローの出力](/assets/images/help/codespaces/prebuilds-log-output.png) -![The prebuild workflow output](/assets/images/help/codespaces/prebuilds-log-output.png) +または、指定したブランチに関連付けられているすべての事前ビルド ワークフロー実行を表示するには、省略記号ボタンをクリックし、ドロップダウン メニューから **[実行の表示]** を選択します。 -Alternatively, to view all prebuild workflow runs associated with the specified branch, click the ellipsis button and choose **View runs** from the dropdown menu. +![ドロップダウン メニューの [実行の表示] オプション](/assets/images/help/codespaces/prebuilds-view-runs.png) -![The 'View runs' option in the dropdown menu](/assets/images/help/codespaces/prebuilds-view-runs.png) +関連付けられているブランチの事前ビルドのワークフロー実行履歴が表示されます。 -This displays the workflow run history for prebuilds for the associated branch. +![ワークフロー実行履歴](/assets/images/help/codespaces/prebuilds-workflow-runs.png) -![The workflow run history](/assets/images/help/codespaces/prebuilds-workflow-runs.png) +### 事前ビルド構成を編集する -### Editing a prebuild configuration - -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to edit. -1. In the dropdown menu, click **Edit**. +1. リポジトリ設定の {% data variables.product.prodname_codespaces %} ページで、編集する事前ビルド構成の右側にある省略記号をクリックします。 +1. ドロップダウン メニューの **[編集]** をクリックします。 - ![The 'Edit' option in the dropdown menu](/assets/images/help/codespaces/prebuilds-edit.png) + ![ドロップダウン メニューの [編集] オプション](/assets/images/help/codespaces/prebuilds-edit.png) -1. Make the required changes to the prebuild configuration, then click **Update**. +1. 事前ビルド構成に必要な変更を加えて、 **[更新]** をクリックします。 {% data reusables.codespaces.prebuilds-permission-authorization %} -### Disabling a prebuild configuration +### 事前ビルド構成を無効にする -To pause the update of prebuilds for a configuration, you can disable workflow runs for the configuration. Disabling the workflow runs for a prebuild configuration does not delete any previously created prebuilds for that configuration and, as a result, codespaces will continue to be generated from an existing prebuild. +構成のプレビルドの更新を一時停止するには、構成のワークフロー実行を無効にします。 プレビルド構成のワークフロー実行を無効にしても、その構成に対して以前に作成されたプレビルドは削除されず、その結果、codespace は既存のプレビルドから生成され続けます。 -Disabling the workflow runs for a prebuild configuration is useful if you need to investigate prebuild creation failures. +事前ビルド構成のワークフロー実行を無効にすると、事前ビルドの作成エラーを調査する必要がある場合に役立ちます。 -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to disable. -1. In the dropdown menu, click **Disable runs**. +1. リポジトリ設定の {% data variables.product.prodname_codespaces %} ページで、無効にする事前ビルド構成の右側にある省略記号をクリックします。 +1. ドロップダウン メニューの **[Disable runs]\(実行を無効にする\)** をクリックします。 - ![The 'Disable runs' option in the dropdown menu](/assets/images/help/codespaces/prebuilds-disable.png) + ![ドロップダウン メニューの [実行を無効にする] オプション](/assets/images/help/codespaces/prebuilds-disable.png) -1. To confirm that you want to disable this configuration, click **OK**. +1. この構成を無効にすることを確定するには、 **[OK]** をクリックします。 -### Deleting a prebuild configuration +### 事前ビルド構成を削除する -Deleting a prebuild configuration also deletes all previously created prebuilds for that configuration. As a result, shortly after you delete a configuration, prebuilds generated by that configuration will no longer be available when you create a new codespace. +プレビルド構成を削除すると、その構成用に以前に作成したプレビルドもすべて削除されます。 その結果、構成を削除した直後から、その構成で生成された事前ビルドは、新しい codespace を作成する際に使用できなくなります。 -After you delete a prebuild configuration, workflow runs for that configuration that have been queued or started will still run. They will be listed in the workflow run history, along with previously completed workflow runs. +事前ビルド構成を削除した後も、キューに既に入っているか開始済みの構成のワークフロー実行は引き続き実行されます。 これらは、以前に完了したワークフロー実行と共に、ワークフロー実行履歴に一覧表示されます。 -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to delete. -1. In the dropdown menu, click **Delete**. +1. リポジトリ設定の {% data variables.product.prodname_codespaces %} ページで、削除する事前ビルド構成の右側にある省略記号をクリックします。 +1. ドロップダウン メニューの **[削除]** をクリックします。 - ![The 'Delete' option in the dropdown menu](/assets/images/help/codespaces/prebuilds-delete.png) + ![ドロップダウン メニューの [削除] オプション](/assets/images/help/codespaces/prebuilds-delete.png) -1. Click **OK** to confirm the deletion. +1. 削除を確認するメッセージが表示されたら、 **[OK]** をクリックします。 -### Manually trigger prebuilds +### 事前ビルドを手動でトリガーする -It may be useful to manually trigger a workflow run for a prebuild configuration. Generally this is only necessary if you are debugging a problem with the workflow for a prebuild configuration. +事前ビルド構成のワークフロー実行を手動でトリガーすると便利な場合があります。 通常、これが必要になるのは、事前ビルド構成のワークフローに関する問題をデバッグする場合だけです。 -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration whose workflow you want to trigger. -1. In the dropdown menu, click **Manually trigger**. +1. リポジトリ設定の {% data variables.product.prodname_codespaces %} ページで、トリガーするワークフローが含まれる事前ビルド構成の右側にある省略記号をクリックします。 +1. ドロップダウン メニューで、 **[手動でトリガー]** をクリックします。 - ![The 'Manually trigger' option in the dropdown menu](/assets/images/help/codespaces/prebuilds-manually-trigger.png) + ![ドロップダウン メニューの [手動でトリガー] オプション](/assets/images/help/codespaces/prebuilds-manually-trigger.png) -## Further reading +## 参考資料 -- "[Troubleshooting prebuilds](/codespaces/troubleshooting/troubleshooting-prebuilds)" +- [プレビルドに関するトラブルシューティング](/codespaces/troubleshooting/troubleshooting-prebuilds) diff --git a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file.md b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file.md new file mode 100644 index 0000000000..f14fd52369 --- /dev/null +++ b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file.md @@ -0,0 +1,79 @@ +--- +title: Adding features to a devcontainer.json file +shortTitle: Adding features +intro: With features, you can quickly add tools, runtimes, or libraries to your dev container configuration. +allowTitleToDifferFromFilename: true +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Set up +--- + +{% data reusables.codespaces.about-features %} Use the tabs in this article to display instructions for each of these ways of adding features. + +## Adding features to a `devcontainer.json` file + +{% webui %} + +1. Navigate to your repository on {% data variables.product.prodname_dotcom_the_website %}, find your `devcontainer.json` file, and click {% octicon "pencil" aria-label="The edit icon" %} to edit the file. + + If you don't already have a `devcontainer.json` file, you can create one now. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#creating-a-custom-dev-container-configuration)." +1. To the right of the file editor, in the **Marketplace** tab, browse or search for the feature you want to add, then click the name of the feature. + + ![Screenshot of the Terraform feature in the Marketplace tab, with "Terra" in the search bar](/assets/images/help/codespaces/feature-marketplace.png) +3. Under "Installation," click the code snippet to copy it to your clipboard, then paste the snippet into the `features` object in your `devcontainer.json` file. + + ![Screenshot of a code block in the Installation section of the Marketplace tab](/assets/images/help/codespaces/feature-installation-code.png) + + ```JSON + "features": { + ... + "ghcr.io/devcontainers/features/terraform:1": {}, + ... + } + ``` +1. By default, the latest version of the feature will be used. To choose a different version, or configure other options for the feature, expand the properties listed under "Options" to view the available values, then add the options by manually editing the object in your `devcontainer.json` file. + + ![Screenshot of the Options section of the Marketplace tab, with "version" and "tflint" expanded](/assets/images/help/codespaces/feature-options.png) + + ```JSON + "features": { + ... + "ghcr.io/devcontainers/features/terraform:1": { + "version": "1.1", + "tflint": "latest" + }, + ... + } + ``` +1. Commit the changes to your `devcontainer.json` file. + +The configuration changes will take effect in new codespaces created from the repository. To make the changes take effect in existing codespaces, you will need to pull the updates to the `devcontainer.json` file into your codespace, then rebuild the container for the codespace. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)." + +{% endwebui %} + +{% vscode %} + +{% note %} + +To add features 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). + +{% endnote %} + +{% data reusables.codespaces.command-pallette %} +2. Start typing "Configure" and select **Codespaces: Configure Dev Container Features**. + + ![The Configure Devcontainer Features command in the Command Palette](/assets/images/help/codespaces/codespaces-configure-features.png) + +3. Update your feature selections, then click **OK**. + + ![The select additional features menu during container configuration](/assets/images/help/codespaces/select-additional-features.png) + +4. If you're working in a codespace, a prompt will appear in the lower-right corner. To rebuild the container and apply the changes to the codespace you're working in, click **Rebuild Now**. + + !["Codespaces: Rebuild Container" in the Command Palette](/assets/images/help/codespaces/rebuild-prompt.png) + +{% endvscode %} \ No newline at end of file diff --git a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md index 70f431a081..07527b2f9a 100644 --- a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md +++ b/translations/ja-JP/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: 0b47f0292eb3a13467a8227ac323d289f9712223 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158774' --- +## 開発コンテナについて -## 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 を作成する場合は、ワークスペース内の 1 つ以上の開発コンテナー構成ファイルを使用して開始できます。 環境をさらに構成するには、これらのファイルの設定を追加または削除し、コンテナーをリビルドして、作業中の codespace に変更を適用します。 {% data variables.product.product_name %} 上のリポジトリに codespace を発行すると、そのリポジトリから作成されたすべての codespace で、定義した構成が共有されます。 詳しい情報については、「[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` ファイルを含まないリポジトリから codespace を作成する場合、または {% 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` というパスの独自のサブディレクトリに配置する必要があります。 たとえば、次の 2 つの構成から選ぶようにすることができます。 * `.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)." +ドットファイルと Settings Sync を使用すると、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 コンテナー イメージを作成するために必要な命令が含まれているテキスト ファイルです。 このイメージは、この Dockerfile を参照する `devcontainer.json` ファイルを使用して codespace を作成するたびに、開発コンテナーの生成に使用されます。 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.json` と共に `.devcontainer` フォルダーに配置します。 {% 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` ファイルで使用して、使用する既存のイメージを直接参照できます。 ここで指定するイメージは、設定されている Organization のイメージ ポリシーで許可されている必要があります。 詳しい情報については、「[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: +次の例では、4 つの命令を使用します。 -`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` 命令を使用してソフトウェアをインストールすることもできます。 複数のコマンドを実行するには、`&&` を使用して、コマンドを 1 つの `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 の命令について詳しくは、Docker のドキュメントの「[Dockerfile リファレンス](https://docs.docker.com/engine/reference/builder)」をご覧ください。 -#### 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,130 +116,130 @@ 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. +開発コンテナー内で既存のコンテナー オーケストレーションを使用する場合は、さまざまなオプションを使用できます。 詳しい情報については、開発コンテナーの Web サイトで[仕様](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 %} が既定の Linux イメージを使用して codespace を作成します。 この Linux イメージには、Python、Node、PHP、Java、Go、C++、Ruby、.NET Core/C# などの一般的な言語のランタイム バージョンが多数含まれています。 これらの言語の最新または LTS リリースが使用されます。 JupyterLab や Conda など、データ サイエンスと機械学習をサポートするツールもあります。 イメージには、Git、GitHub CLI、yarn、openssh、vim などの他の開発者ツールやユーティリティも含まれています。 含まれているすべての言語、ランタイム、ツールを確認するには、codespace ターミナル内で `devcontainer-info content-url` コマンドを使用し、コマンドで出力された 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_vscode %} または Web ブラウザーで {% data variables.product.prodname_codespaces %} を使用する場合は、定義済みの構成の一覧から選ぶことで、リポジトリの開発コンテナー構成を作成できます。 これらの構成は、特定のプロジェクト タイプの共通セットアップを提供するものです。また、適切なコンテナー オプション、{% 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 での作業中、またはローカルでのリポジトリの作業中に追加できます。 ローカルで作業していて、codespace に接続されていないときに {% data variables.product.prodname_vscode_shortname %} でこれを行うには、"Dev Containers" 拡張機能がインストールされ、有効になっている必要があります。 この拡張機能について詳しくは、「[{% data variables.product.prodname_vs_marketplace_shortname %}](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)」をご覧ください。 次の手順では、codespace を使用している場合のプロセスについて説明します。 codespace に接続していない場合の {% data variables.product.prodname_vscode_shortname %} の手順は非常によく似ています。 {% 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. **[OK]** をクリックします。 - ![Screenshot of the OK button](/assets/images/help/codespaces/prebuilt-container-ok-button.png) + ![[OK] ボタンのスクリーンショット](/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. +* リポジトリから codespace を作成するすべてのユーザーが使用する単一の `devcontainer.json` ファイルを追加する場合は、リポジトリのルートにある `.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` より 2 レベル以上下位のディレクトリに配置することはできません。 たとえば、`.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" %} コード]** ドロップダウンをクリックします。 +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. +リポジトリに既に 1 つ以上の `devcontainer.json` ファイルが含まれている場合は、 **[開発コンテナーの構成]** をクリックすると、containers.dev の`devcontainer.json`仕様[に従って、優先順位が最も高い既存の ](https://containers.dev/implementors/spec/#devcontainerjson) ファイルが開きます。 -### Default configuration selection during codespace creation +### codespace の作成時における既定の構成の選択 -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` が存在する場合は、codespace を作成するときに使用可能な構成ファイルの一覧でそれが既定の選択になります。 どちらのファイルも存在しない場合は、既定の開発コンテナー構成が既定で選択されます。 -![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) 形式を使用して記述されます。 これにより、構成ファイル内にコメントを含めることができます。 詳しくは、{% data variables.product.prodname_vscode_shortname %} のドキュメントの「[{% data variables.product.prodname_vscode_shortname %} での JSON の編集](https://code.visualstudio.com/docs/languages/json#_json-with-comments)」をご覧ください。 {% 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` ファイルを検証する場合は、JSON ではなく JSONC に設定されていることを確認してください。正しく設定されていないと、コメントがエラーとして報告されます。 {% 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 %} のインターフェイス設定は、ワークスペース、リモート [Codespaces]、ユーザーの 3 つのスコープで構成できます。 これらのスコープは、{% 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. +設定が複数のスコープで定義されている場合は、ワークスペース 設定が優先され、次にリモート [コードスペース] が優先され、次にユーザーが優先されます。 -You can define default interface settings for {% data variables.product.prodname_vscode_shortname %} in two places. +{% data variables.product.prodname_vscode_shortname %} の既定のインターフェイス設定は、2 か所で定義できます。 -* 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 でワークスペースをスコープとする設定として適用されます。 +* `devcontainer.json` ファイルの `settings` キーで定義されたインターフェイス設定は、codespace でリモート [Codespaces] をスコープとする設定として適用されます。 -## Applying configuration changes to a codespace +## codespace への構成変更の適用 -Changes to a configuration will be applied the next time you create a codespace. However, if you're using a codespace in a web browser, in {% data variables.product.prodname_vscode_shortname %}, or in a JetBrains IDE, you can apply configuration changes to the current codespace by rebuilding the container. +構成に対する変更は、次回 codespace を作成するときに適用されます。 ただし、Web ブラウザー、{% data variables.product.prodname_vscode_shortname %}、または JetBrains IDE で codespace を使用している場合は、コンテナーをリビルドすることで、現在の codespace に構成変更を適用できます。 -### Rebuilding the dev container in the {% data variables.product.prodname_vscode_shortname %} web client or desktop application +### {% data variables.product.prodname_vscode_shortname %} Web クライアントまたはデスクトップ アプリケーションで開発コンテナーをリビルドする {% 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. + - 作成ログを確認してエラーを診断するには、 **[View creation log]\(作成ログの表示\)** をクリックします。 + - ログで識別されたエラーを修正するには、`devcontainer.json` ファイルを更新します。 + - 変更を適用するには、コンテナーをリビルドします。 -### Rebuilding the dev container in a JetBrains IDE +### JetBrains IDE での開発コンテナーのリビルド {% data reusables.codespaces.jetbrains-open-codespace-plugin %} -1. In the {% data variables.product.prodname_github_codespaces %} tool window, click the rebuild icon. +1. {% data variables.product.prodname_github_codespaces %} ツール ウィンドウで、リビルド アイコンをクリックします。 - ![Screenshot of the rebuild button](/assets/images/help/codespaces/jetbrains-plugin-icon-rebuild.png) + ![リビルド ボタンのスクリーンショット](/assets/images/help/codespaces/jetbrains-plugin-icon-rebuild.png) -1. Click **Rebuild** when prompted to confirm that you want to rebuild the dev container. -1. Reopen the codespace in your JetBrains IDE. +1. 開発コンテナーをリビルドすることの確認を求められたら、 **[リビルド]** をクリックします。 +1. JetBrains IDE で codespace をもう一度開きます。 -## Further reading +## 参考資料 -- "[Prebuilding your codespaces](/codespaces/prebuilding-your-codespaces)" +- 「[codespaces の事前ビルド](/codespaces/prebuilding-your-codespaces)」 diff --git a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines.md b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines.md index e5659b2dc7..d8e1783c5f 100644 --- a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines.md +++ b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines.md @@ -1,7 +1,7 @@ --- -title: Setting a minimum specification for codespace machines +title: codespace コンピューターに対して最小仕様を設定する shortTitle: Set a minimum machine spec -intro: 'You can avoid under-resourced machine types being used for {% data variables.product.prodname_github_codespaces %} for your repository.' +intro: 'リソース不足のコンピューターの種類が、リポジトリの {% data variables.product.prodname_github_codespaces %} に使用されないようにすることができます。' permissions: People with write permissions to a repository can create or edit the codespace configuration. versions: fpt: '*' @@ -10,26 +10,31 @@ type: how_to topics: - Codespaces - Set up +ms.openlocfilehash: b7eeaac84721ff1d9ceab663957b1615952b0623 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159166' --- +## 概要 -## Overview +作成した codespace は、それぞれ別の仮想マシンにホストされます。 リポジトリから codespace を作成すると、通常はさまざまな種類の仮想マシンから選べます。 マシンの種類ごとにリソース (プロセッサ コア、メモリ、ストレージ) が異なり、既定では、リソースが最も少ないコンピューターの種類が使用されます。 詳細については、「[codespace に合わせたコンピューターの種類の変更](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)」を参照してください。 -Each codespace that you create is hosted on a separate virtual machine. When you create a codespace from a repository, you can usually choose from different types of virtual machines. Each machine type has different resources (processor cores, memory, storage) and, by default, the machine type with the least resources is used. For more information, see "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)." - -If your project needs a certain level of compute power, you can configure {% data variables.product.prodname_github_codespaces %} so that only machine types that meet these requirements can be used by default, or selected by users. You configure this in a `devcontainer.json` file. +プロジェクトで特定のレベルのコンピューティング能力が必要な場合は、それらの要件を満たすコンピューターの種類のみを、既定で使用、またはユーザーが選択できるように、{% data variables.product.prodname_github_codespaces %} を構成することができます。 `devcontainer.json` ファイル内でこれを構成します。 {% data reusables.codespaces.machine-types-for-unpublished-codespaces %} {% note %} -**Important:** Access to some machine types may be restricted at the organization level. Typically this is done to prevent people choosing higher resourced machines that are billed at a higher rate. If your repository is affected by an organization-level policy for machine types you should make sure you don't set a minimum specification that would leave no available machine types for people to choose. For more information, see "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)." +**重要:** 一部のコンピューターの種類へのアクセスは、組織レベルで制限される場合があります。 通常、これは、より高いレートで課金される、よりリソースの多いコンピューターをユーザーが選択することを防ぐために行われます。 リポジトリがコンピューターの種類に関する組織レベルのポリシーの影響を受ける場合は、ユーザーが選択できるコンピューターの種類がなくなるような最小仕様を設定しないようにする必要があります。 詳細については、「[コンピューターの種類へのアクセスの制限](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)」を参照してください。 {% endnote %} -## Setting a minimum machine specification +## コンピューターの最小仕様の設定 {% data reusables.codespaces.edit-devcontainer-json %} -1. Edit the `devcontainer.json` file, adding the `hostRequirements` property at the top level of the file, within the enclosing JSON object. For example: +1. `devcontainer.json` ファイルを編集し、ファイルの最上位レベルにある JSON オブジェクト内に `hostRequirements` プロパティを追加します。 次に例を示します。 ```json{:copy} "hostRequirements": { @@ -39,16 +44,16 @@ If your project needs a certain level of compute power, you can configure {% dat } ``` - You can specify any or all of the options: `cpus`, `memory`, and `storage`. + 次のいずれかの、またはすべてのオプションを指定できます: `cpus`、`memory`、`storage`。 - To check the specifications of the {% data variables.product.prodname_github_codespaces %} machine types that are currently available for your repository, step through the process of creating a codespace until you see the choice of machine types. 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)." + リポジトリで現在使用可能な、{% data variables.product.prodname_github_codespaces %} のコンピューターの種類の仕様を確認するには、コンピューターの種類の選択肢が表示されるまで、codespace の作成プロセスをステップ実行します。 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)」を参照してください。 -1. Save the file and commit your changes to the required branch of the repository. +1. ファイルを保存し、リポジトリの必要なブランチに加えた変更をコミットします。 - Now when you create a codespace for that branch of the repository, and you go to the creation configuration options, you will only be able to select machine types that match or exceed the resources you've specified. + ここで、リポジトリのそのブランチ用に codespace を作成し、作成設定オプションに進むと、指定したリソースと一致するか、またはそれを超えるコンピューターの種類のみを選択できるようになります。 - ![Dialog box showing a limited choice of machine types](/assets/images/help/codespaces/machine-types-limited-choice.png) + ![コンピューターの種類の選択が制限されているダイアログ ボックス](/assets/images/help/codespaces/machine-types-limited-choice.png) -## Further reading +## 参考資料 -- "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)" +- "[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)" diff --git a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces.md b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces.md new file mode 100644 index 0000000000..1293d50948 --- /dev/null +++ b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces.md @@ -0,0 +1,88 @@ +--- +title: GitHub Codespaces 用のテンプレート リポジトリを設定する +shortTitle: Set up a template repo +intro: '{% data variables.product.prodname_github_codespaces %} で使うテンプレート リポジトリを設定することで、ユーザーがプロジェクトを開始するのを手助けできます。' +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Set up +ms.openlocfilehash: 155aa9bf839301439d2746b4b6f0f0575d2e60ff +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159912' +--- +## はじめに + +テンプレート リポジトリを設定することで、ユーザーが {% data variables.product.prodname_github_codespaces %} でフレームワーク、ライブラリ、またはその他のプロジェクトを開始するのを手助けできます。 ユーザーは、クラウドベースの開発環境でテンプレート ファイルの操作をすぐに開始でき、リポジトリの複製や、ツールなどの依存関係のインストールについて気にする必要がありません。 一部の構成で、重要なファイルが既に編集用に開かれ、{% data variables.product.prodname_vscode_shortname %} Web エディター内のプレビュー ブラウザー タブでアプリケーションが既に実行されている codespace でユーザーを設定できるようになります。 + +テンプレート リポジトリへの読み取りアクセス権があればだれでも、{% data variables.product.product_name %} のリポジトリのページから codespace を作成できます。 既存のリポジトリをテンプレートに変換でき、ユーザーがテンプレート リポジトリから codespace を作成できるように設定を変更する必要はありません。 リポジトリをテンプレートに変換する方法について詳しくは、「[テンプレート リポジトリを作成する](/repositories/creating-and-managing-repositories/creating-a-template-repository)」を参照してください。 + +`https://github.com/codespaces/new?template_repository=OWNER/TEMPLATE-REPO` の形式でリンクを提供して、ユーザーをテンプレートの [新しい codespace の作成] ページに直接誘導できます。 + +![[新しい codespace の作成] ページのスクリーンショット](/assets/images/help/codespaces/create-a-new-codespace-page.png) + +たとえば、フレームワークの使用を開始するためのチュートリアル内で、このリンクを提供できます。 リンク内の `OWNER/TEMPLATE-REPO` をお使いのテンプレート リポジトリの名前 (例: `monalisa/octo-template`) に置き換えます。 + +他のユーザーがテンプレートから codespace を作成すると、テンプレート リポジトリの内容がユーザーの codespace に複製されます。 ユーザーの準備ができたら、{% data variables.product.product_name %} 上で、その個人アカウントに属する新しいリポジトリに作業内容を公開できるようになります。 codespace の使用料金は、それを作成したユーザーに課金されます。 詳しくは、「[テンプレートから codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)」を参照してください。 + +## テンプレートについて説明する + +テンプレート リポジトリ用の README がない場合は作成して、テンプレートの目的と使用開始方法について説明します。 詳細については、「[README について](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)」を参照してください。 + +テンプレートの簡単な説明は、`https://github.com/codespaces/new?template_repository=OWNER/TEMPLATE-REPO` リンクをクリックしたユーザーに示される [新しい codespace の作成] ページに表示されます。 この説明は、リポジトリの作成時に設定できる **[説明]** フィールドから取得されます。 この説明はいつでも編集できます。リポジトリのページに移動し、ページの右側にある **[情報]** セクションの横にある **{% octicon "gear" aria-label="The Settings gear" %}** をクリックします。 + +![リポジトリ ページの [情報] セクションのスクリーンショット](/assets/images/help/repository/repository-settings-icon.png) + +## スターター ファイルを追加する + +ユーザーがライブラリ、フレームワーク、またはその他のテクノロジをすぐに使い始めることができるように、通常は、定型コードを含むスターター ファイルがテンプレート リポジトリに用意されています。 + +含めるファイルの種類に関するガイダンスについては、次のように、{% data variables.product.prodname_github_codespaces %} の公式 {% data variables.product.company_short %} テンプレートに含まれるスターター ファイルを確認できます。 + +{% data reusables.codespaces.your-codespaces-procedure-step %} {% data reusables.codespaces.view-all-templates-step %} +1. テンプレート用のファイルが含まれるテンプレート リポジトリを表示するには、テンプレートの名前をクリックします。 + + ![[クイック スタート テンプレートの探索] セクションの [React] が強調表示されているスクリーンショット](/assets/images/help/codespaces/react-template-name.png) + +## コンテナー イメージを構成する + +開発コンテナー構成ファイルをテンプレート リポジトリに追加して、{% data variables.product.prodname_github_codespaces %} でテンプレートを使うユーザーの開発環境をカスタマイズできます。 {% data variables.product.prodname_vscode %} で定義済みの構成設定の一覧から選ぶか、独自の `devcontainer.json` ファイルを記述してカスタム構成を作成できます。 構成ファイルを追加しない場合は、既定のコンテナー イメージが使用されます。 詳しくは、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)」と「[開発コンテナー構成をリポジトリに追加する](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)」を参照してください。 + +{% note %} + +**注:** {% data reusables.codespaces.configuration-choice-templates %} + +{% endnote %} + +テンプレートを使ってユーザーに最適なエクスペリエンスを提供するには、ツールとカスタマイズを使って開発コンテナーを構成する必要があります。 たとえば、`devcontainer.json` ファイル内で、次のようにします。 +- `openFiles` プロパティを使って、テンプレートから codespace を作成するときに {% data variables.product.prodname_vscode_shortname %} Web クライアントで自動的に開くファイルの一覧を定義できます。 +- テンプレートに Web アプリケーションのファイルを含めると、アプリケーションが、ユーザーの codespace で自動的に実行されるようにできます。 これを行うには、`postAttachCommand` プロパティを使って、{% data variables.product.prodname_vscode_shortname %} Web クライアントが codespace に接続するとすぐにローカル サーバーでアプリケーションを起動するスクリプトを実行し、ポートの `onAutoForward` プロパティを `openPreview` に設定して、{% data variables.product.prodname_vscode_shortname %} Web クライアントに埋め込まれたシンプルなブラウザー内に、そのポートで実行されているアプリケーションを表示します。 + +React テンプレートの次の構成設定によって、ユーザーのエディターで `app.js` ファイルが開き、`npm start` (`package.json` ファイルで定義) を実行してローカル サーバーを起動し、codespace のプレビュー ブラウザー タブにポート `3000` を転送します。 + +```JSON +{ + "postAttachCommand": { + "server": "npm start", + }, + + "portsAttributes": { + "3000": { + "label": "Application", + "onAutoForward": "openPreview" + } + }, + + "customizations": { + "codespaces": { + "openFiles": ["src/App.js"] + } + } +} +``` +詳しくは、「[リポジトリの codespace にあるファイルを自動的に開く](/codespaces/setting-up-your-project-for-codespaces/automatically-opening-files-in-the-codespaces-for-a-repository)」と、containers.dev の [開発コンテナーの仕様](https://containers.dev/implementors/json_reference/#general-properties)を参照してください。 diff --git a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md index 43cbbf8871..36de4e93b9 100644 --- a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md +++ b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md @@ -1,8 +1,8 @@ --- -title: Setting up your C# (.NET) project for GitHub Codespaces +title: GitHub Codespaces 用に C# (.NET) プロジェクトを設定する shortTitle: Setting up your C# (.NET) project allowTitleToDifferFromFilename: true -intro: 'Get started with your C# (.NET) project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container.' +intro: 'カスタム開発コンテナを作成して、{% data variables.product.prodname_github_codespaces %} で C# (.NET) プロジェクトを始めます。' redirect_from: - /codespaces/getting-started-with-codespaces/getting-started-with-your-dotnet-project versions: @@ -12,122 +12,126 @@ topics: - Codespaces hasExperimentalAlternative: true hidden: true +ms.openlocfilehash: 10282aedf3bdb239fa238e546c2fc6280787a6a0 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158614' --- +## はじめに -## Introduction +このガイドでは、C# (.NET) プロジェクトの設定方法を紹介します {% data reusables.codespaces.setting-up-project-intro %} -This guide shows you how to set up your C# (.NET) project {% data reusables.codespaces.setting-up-project-intro %} +### 前提条件 -### Prerequisites +- {% data variables.product.prodname_dotcom_the_website %} のリポジトリに既存の C# (.NET) プロジェクトがある必要があります。 プロジェクトがない場合は、次の例を使用してこのチュートリアルを試すことができます: https://github.com/2percentsilk/dotnet-quickstart 。 +- Organization で {% data variables.product.prodname_github_codespaces %} を有効にする必要があります。 -- You should have an existing C# (.NET) project in a repository on {% data variables.product.prodname_dotcom_the_website %}. If you don't have a project, you can try this tutorial with the following example: https://github.com/2percentsilk/dotnet-quickstart. -- You must have {% data variables.product.prodname_github_codespaces %} enabled for your organization. +## ステップ 1: codespace でプロジェクトを開く -## Step 1: Open your project in a codespace +1. リポジトリ名の下で、 **{% octicon "code" aria-label="The code icon" %} コード** のドロップダウン メニューを使用し、 **[Codespaces]** タブでプラス記号 {% octicon "plus" aria-label="The plus icon" %} をクリックします。 -1. Under the repository name, use the **{% octicon "code" aria-label="The code icon" %} Code** dropdown menu, and in the **Codespaces** tab, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}). + ![[New codespace] ボタン](/assets/images/help/codespaces/new-codespace-button.png) - ![New codespace button](/assets/images/help/codespaces/new-codespace-button.png) - -When you create a codespace, your project is created on a remote VM that is dedicated to you. By default, the container for your codespace has many languages and runtimes including .NET. It also includes a common set of tools like git, wget, rsync, openssh, and nano. +codespace を作成すると、プロジェクトは専用のリモート VM 上に作成されます。 デフォルト設定では、codespace のコンテナには、.NET を含む多くの言語とランタイムがあります。 また、git、wget、rsync、openssh、nano などの一般的なツールセットも含まれています。 {% data reusables.codespaces.customize-vcpus-and-ram %} -## Step 2: Add a dev container configuration to your repository from a template +## ステップ 2: テンプレートからリポジトリに開発コンテナーの構成を追加する -The default development container, or "dev container," for {% data variables.product.prodname_github_codespaces %} comes with the latest .NET version and common tools preinstalled. However, we recommend that you configure your own dev container to include all of the tools and scripts that your project needs. This will ensure a fully reproducible environment for all {% data variables.product.prodname_github_codespaces %} users in your repository. +{% data variables.product.prodname_github_codespaces %} の既定の開発コンテナー ("開発コンテナー") には、.NET の最新バージョンと一般的なツールがプレインストールされています。 ただし、独自の開発コンテナーを構成して、プロジェクトに必要なすべてのツールとスクリプトを含めることをお勧めします。 これにより、リポジトリのすべての {% data variables.product.prodname_github_codespaces %} ユーザーに対して、完全に再現可能な環境が保証されます。 {% data reusables.codespaces.setup-custom-devcontainer %} {% data reusables.codespaces.command-palette-container %} -1. For this example, click **C# (.NET)**. If you need additional features you can select any container that’s specific to C# (.NET) or a combination of tools such as C# (.NET) and MS SQL. - ![Select C# (.NET) option from the list](/assets/images/help/codespaces/add-dotnet-prebuilt-container.png) -1. Click the recommended version of .NET. - ![.NET version selection](/assets/images/help/codespaces/add-dotnet-version.png) -1. Accept the default option to add Node.js to your customization. - ![Add Node.js selection](/assets/images/help/codespaces/dotnet-options.png) -{% data reusables.codespaces.rebuild-command %} +1. この例では、 **[C# (.NET)]** をクリックします。 追加機能が必要な場合は、C# (.NET) に固有の任意のコンテナ、または C# (.NET) や MSSQL などのツールの組み合わせを選択できます。 + ![リストから [C# (.NET)] オプションを選択します](/assets/images/help/codespaces/add-dotnet-prebuilt-container.png) +1. .NET の推奨バージョンをクリックします。 + ![.NET のバージョンの選択](/assets/images/help/codespaces/add-dotnet-version.png) +1. デフォルトのオプションを使用して、Node.js をカスタマイズに追加します。 + ![Node.js の選択に追加](/assets/images/help/codespaces/dotnet-options.png) {% data reusables.codespaces.rebuild-command %} -### Anatomy of your dev container +### 開発コンテナの構造 -Adding the C# (.NET) dev container template adds a `.devcontainer` folder to the root of your project's repository with the following files: +C# (.NET) 開発コンテナー テンプレートを追加すると、`.devcontainer` フォルダーが、次のファイルを含むプロジェクトのリポジトリのルートに追加されます。 - `devcontainer.json` - Dockerfile -The newly added `devcontainer.json` file defines a few properties that are described after the sample. +新しく追加された `devcontainer.json` ファイルでは、サンプルの後に説明されるいくつかのプロパティを定義します。 #### devcontainer.json ```json { - "name": "C# (.NET)", - "build": { - "dockerfile": "Dockerfile", - "args": { - // Update 'VARIANT' to pick a .NET Core version: 2.1, 3.1, 5.0 - "VARIANT": "5.0", - // Options - "INSTALL_NODE": "true", - "NODE_VERSION": "lts/*", - "INSTALL_AZURE_CLI": "false" - } - }, + "name": "C# (.NET)", + "build": { + "dockerfile": "Dockerfile", + "args": { + // Update 'VARIANT' to pick a .NET Core version: 2.1, 3.1, 5.0 + "VARIANT": "5.0", + // Options + "INSTALL_NODE": "true", + "NODE_VERSION": "lts/*", + "INSTALL_AZURE_CLI": "false" + } + }, - // Set *default* container specific settings.json values on container create. - "settings": { - "terminal.integrated.shell.linux": "/bin/bash" - }, + // Set *default* container specific settings.json values on container create. + "settings": { + "terminal.integrated.shell.linux": "/bin/bash" + }, - // Add the IDs of extensions you want installed when the container is created. - "extensions": [ - "ms-dotnettools.csharp" - ], + // Add the IDs of extensions you want installed when the container is created. + "extensions": [ + "ms-dotnettools.csharp" + ], - // Use 'forwardPorts' to make a list of ports inside the container available locally. - // "forwardPorts": [5000, 5001], + // Use 'forwardPorts' to make a list of ports inside the container available locally. + // "forwardPorts": [5000, 5001], - // [Optional] To reuse of your local HTTPS dev cert: - // - // 1. Export it locally using this command: - // * Windows PowerShell: - // dotnet dev-certs https --trust; dotnet dev-certs https -ep "$env:USERPROFILE/.aspnet/https/aspnetapp.pfx" -p "SecurePwdGoesHere" - // * macOS/Linux terminal: - // dotnet dev-certs https --trust; dotnet dev-certs https -ep "${HOME}/.aspnet/https/aspnetapp.pfx" -p "SecurePwdGoesHere" - // - // 2. Uncomment these 'remoteEnv' lines: - // "remoteEnv": { - // "ASPNETCORE_Kestrel__Certificates__Default__Password": "SecurePwdGoesHere", - // "ASPNETCORE_Kestrel__Certificates__Default__Path": "/home/vscode/.aspnet/https/aspnetapp.pfx", - // }, - // - // 3. Start the container. - // - // 4. Drag ~/.aspnet/https/aspnetapp.pfx into the root of the file explorer. - // - // 5. Open a terminal in VS Code and run "mkdir -p /home/vscode/.aspnet/https && mv aspnetapp.pfx /home/vscode/.aspnet/https". - // + // [Optional] To reuse of your local HTTPS dev cert: + // + // 1. Export it locally using this command: + // * Windows PowerShell: + // dotnet dev-certs https --trust; dotnet dev-certs https -ep "$env:USERPROFILE/.aspnet/https/aspnetapp.pfx" -p "SecurePwdGoesHere" + // * macOS/Linux terminal: + // dotnet dev-certs https --trust; dotnet dev-certs https -ep "${HOME}/.aspnet/https/aspnetapp.pfx" -p "SecurePwdGoesHere" + // + // 2. Uncomment these 'remoteEnv' lines: + // "remoteEnv": { + // "ASPNETCORE_Kestrel__Certificates__Default__Password": "SecurePwdGoesHere", + // "ASPNETCORE_Kestrel__Certificates__Default__Path": "/home/vscode/.aspnet/https/aspnetapp.pfx", + // }, + // + // 3. Start the container. + // + // 4. Drag ~/.aspnet/https/aspnetapp.pfx into the root of the file explorer. + // + // 5. Open a terminal in VS Code and run "mkdir -p /home/vscode/.aspnet/https && mv aspnetapp.pfx /home/vscode/.aspnet/https". + // - // Use 'postCreateCommand' to run commands after the container is created. - // "postCreateCommand": "dotnet restore", + // Use 'postCreateCommand' to run commands after the container is created. + // "postCreateCommand": "dotnet restore", - // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. - "remoteUser": "vscode" + // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. + "remoteUser": "vscode" } ``` -- **name** - You can name our dev container anything, this is just the default. -- **build** - The build properties. - - **dockerfile** - In the `build` object, `dockerfile` contains the path to the Dockerfile that was also added from the template. +- **name** - 開発コンテナーには任意の名前を付けることができます。これは既定値です。 +- **build** - ビルドのプロパティ。 + - **dockerfile** - `build` オブジェクトの `dockerfile` には、やはりテンプレートから追加された Dockerfile へのパスが含まれます。 - **args** - - **variant**: This file only contains one build argument, which is the .NET Core version that we want to use. -- **settings** - These are {% data variables.product.prodname_vscode %} settings. - - **terminal.integrated.shell.linux** - While bash is the default here, you could use other terminal shells by modifying this. -- **extensions** - These are extensions included by default. - - **ms-dotnettools.csharp** - The Microsoft C# extension provides rich support for developing in C#, including features such as IntelliSense, linting, debugging, code navigation, code formatting, refactoring, variable explorer, test explorer, and more. -- **forwardPorts** - Any ports listed here will be forwarded automatically. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." -- **postCreateCommand** - Use this to run commands that aren't defined in the Dockerfile, after your codespace is created. -- **remoteUser** - By default, you’re running as the vscode user, but you can optionally set this to root. + - **variant**: このファイルには、使う .NET Core バージョンであるビルド引数が 1 つだけ含まれています。 +- **settings** - これらは {% data variables.product.prodname_vscode %} 設定です。 + - **terminal.integrated.shell.linux** - ここでは bash が既定値ですが、これを変更すると他のターミナル シェルを使用できます。 +- **extensions** - これらは既定で含まれる拡張機能です。 + - **ms-dotnettools.csharp** - Microsoft C# 機能拡張は、IntelliSense、リンティング、デバッグ、コード ナビゲーション、コード形式、リファクタリング、変数エクスプローラー、テスト エクスプローラーなどの機能を含み、C# での開発に豊富なサポートを提供します。 +- **forwardPorts** - ここにリストされているポートはすべて自動的に転送されます。 詳細については、「[codespace でのポートの転送](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)」を参照してください。 +- **postCreateCommand** - codespace が作成された後に、Dockerfile で定義されていないコマンドを実行するには、これを使います。 +- **remoteUser** - 既定では、vscode ユーザーとして実行されていますが、必要に応じてこれを root に設定することができます。 #### Dockerfile @@ -155,26 +159,26 @@ RUN if [ "$INSTALL_AZURE_CLI" = "true" ]; then bash /tmp/library-scripts/azcli-d # RUN su vscode -c "source /usr/local/share/nvm/nvm.sh && npm install -g " 2>&1 ``` -You can use the Dockerfile to add additional container layers to specify OS packages, node versions, or global packages we want included in our container. +Dockerfile を使用して、コンテナレイヤーを追加し、コンテナに含める OS パッケージ、ノードバージョン、またはグローバルパッケージを指定できます。 -## Step 3: Modify your devcontainer.json file +## ステップ 3: devcontainer.json ファイルを変更する -With your dev container configuration added and a basic understanding of what everything does, you can now make changes to customize your environment further. In this example, you'll add properties to install extensions and your project dependencies when your codespace launches. +開発コンテナーの構成を追加し、すべての機能を基本的に理解したので、変更を行って環境をさらにカスタマイズできます。 この例では、コードスペースの起動時に拡張機能とプロジェクトの依存関係をインストールするためのプロパティを追加します。 -1. In the Explorer, select the `devcontainer.json` file from the tree to open it. You might have to expand the `.devcontainer` folder to see it. +1. エクスプローラーで、ツリーから `devcontainer.json` ファイルを選択してそれを開きます。 表示するには、`.devcontainer` フォルダーを展開する必要がある場合があります。 - ![devcontainer.json file in the Explorer](/assets/images/help/codespaces/devcontainers-options.png) + ![エクスプローラーの devcontainer.json ファイル](/assets/images/help/codespaces/devcontainers-options.png) -2. Update your the `extensions` list in your `devcontainer.json` file to add a few extensions that are useful when working with your project. +2. `devcontainer.json` ファイル内の `extensions` リストを更新して、プロジェクトを操作する際に役立つ拡張機能をいくつか追加します。 ```json{:copy} "extensions": [ - "ms-dotnettools.csharp", - "streetsidesoftware.code-spell-checker", - ], + "ms-dotnettools.csharp", + "streetsidesoftware.code-spell-checker", + ], ``` -3. Uncomment the `postCreateCommand` to restore dependencies as part of the codespace setup process. +3. codespace 設定プロセスの一部として依存関係を復元するには、`postCreateCommand` のコメントを解除します。 ```json{:copy} // Use 'postCreateCommand' to run commands after the container is created. @@ -187,26 +191,26 @@ With your dev container configuration added and a basic understanding of what ev {% data reusables.codespaces.rebuild-reason %} -5. Check your changes were successfully applied by verifying the "Code Spell Checker" extension was installed. +5. 「Code Spell Checker」機能拡張がインストールされていることを確認して、変更が正常に適用されたことを確認します。 - ![Extensions list](/assets/images/help/codespaces/dotnet-extensions.png) + ![機能拡張のリスト](/assets/images/help/codespaces/dotnet-extensions.png) -## Step 4: Run your application +## 手順 4:アプリケーションを実行する -In the previous section, you used the `postCreateCommand` to install a set of packages via the `dotnet restore` command. With our dependencies now installed, we can run our application. +前のセクションでは、`postCreateCommand` を使用して、一連のパッケージを `dotnet restore` コマンドを使ってインストールしました。 依存関係がインストールされているため、アプリケーションを実行できます。 -1. Run your application by pressing `F5` or entering `dotnet watch run` in your terminal. +1. ターミナルで `F5` を押すか、`dotnet watch run` を入力してアプリケーションを実行します。 -2. When your project starts, you should see a "toast" notification message at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, containing a prompt to connect to the port your project uses. +2. プロジェクトが開始されると、{% data variables.product.prodname_vscode_shortname %} の右下隅に "トースト" 通知メッセージが表示されるはずです。プロジェクトで使用されるポートに接続するように促されます。 - ![Port forwarding "toast" notification](/assets/images/help/codespaces/python-port-forwarding.png) + ![ポート転送の "トースト" 通知](/assets/images/help/codespaces/python-port-forwarding.png) -## Step 5: Commit your changes +## ステップ 5: 変更をコミットする {% data reusables.codespaces.committing-link-to-procedure %} -## Next steps +## 次のステップ -You should now be ready start developing your C# (.NET) project in {% data variables.product.prodname_github_codespaces %}. Here are some additional resources for more advanced scenarios. +これで、C# (.NET) で {% data variables.product.prodname_github_codespaces %} プロジェクトの開発を始める準備ができました。 より高度なシナリオ向けの追加のリソースは次のとおりです。 {% data reusables.codespaces.next-steps-adding-devcontainer %} diff --git a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md index 954d74025b..9cecea66d4 100644 --- a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md +++ b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md @@ -1,8 +1,8 @@ --- -title: Setting up your Java project for GitHub Codespaces +title: GitHub Codespaces 用に Java プロジェクトを設定する allowTitleToDifferFromFilename: true shortTitle: Setting up with your Java project -intro: 'Get started with your Java project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container.' +intro: 'カスタム開発コンテナを作成して、{% data variables.product.prodname_github_codespaces %} で Java プロジェクトを始めます。' redirect_from: - /codespaces/getting-started-with-codespaces/getting-started-with-your-java-project-in-codespaces versions: @@ -12,48 +12,52 @@ topics: - Codespaces hasExperimentalAlternative: true hidden: true +ms.openlocfilehash: b861744483f61bc01e8069188c1ce6298411d57e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158766' --- +## はじめに -## Introduction +このガイドでは、Java プロジェクトの設定方法を紹介します {% data reusables.codespaces.setting-up-project-intro %} -This guide shows you how to set up your Java project {% data reusables.codespaces.setting-up-project-intro %} +### 前提条件 -### Prerequisites +- {% data variables.product.prodname_dotcom_the_website %} のリポジトリに既存の Java プロジェクトがあります。 プロジェクトがない場合は、次の例を使用してこのチュートリアルを試すことができます: https://github.com/microsoft/vscode-remote-try-java +- Organization で {% data variables.product.prodname_github_codespaces %} を有効にする必要があります。 -- You should have an existing Java project in a repository on {% data variables.product.prodname_dotcom_the_website %}. If you don't have a project, you can try this tutorial with the following example: https://github.com/microsoft/vscode-remote-try-java -- You must have {% data variables.product.prodname_github_codespaces %} enabled for your organization. +## ステップ 1: codespace でプロジェクトを開く -## Step 1: Open your project in a codespace +1. リポジトリ名の下で、 **{% octicon "code" aria-label="The code icon" %} コード** のドロップダウン メニューを使用し、 **[Codespaces]** タブでプラス記号 {% octicon "plus" aria-label="The plus icon" %} をクリックします。 -1. Under the repository name, use the **{% octicon "code" aria-label="The code icon" %} Code** dropdown menu, and in the **Codespaces** tab, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}). + ![[New codespace] ボタン](/assets/images/help/codespaces/new-codespace-button.png) - ![New codespace button](/assets/images/help/codespaces/new-codespace-button.png) - -When you create a codespace, your project is created on a remote VM that is dedicated to you. By default, the container for your codespace has many languages and runtimes including Java, nvm, npm, and Yarn. It also includes a set of commonly used tools such as git, wget, rsync, openssh, and nano. +codespace を作成すると、プロジェクトは専用のリモート VM 上に作成されます。 既定では、codespace のコンテナーには、Java、nvm、npm、Yarn を含む多くの言語とランタイムがあります。 また、git、wget、rsync、openssh、nano など、一般的に使用されているツールが含まれています。 {% data reusables.codespaces.customize-vcpus-and-ram %} -## Step 2: Add a dev container configuration to your repository from a template +## ステップ 2: テンプレートからリポジトリに開発コンテナーの構成を追加する -The default development container, or "dev container," for {% data variables.product.prodname_github_codespaces %} comes with the latest Java version, package managers (Maven, Gradle), and other common tools preinstalled. However, we recommend that you configure your own dev container to include all of the tools and scripts that your project needs. This will ensure a fully reproducible environment for all {% data variables.product.prodname_github_codespaces %} users in your repository. +{% data variables.product.prodname_github_codespaces %} の既定の開発コンテナー ("dev コンテナー") には、Java の最新バージョン、パッケージ マネージャー (Maven、Gradle)、その他の一般的なツールがプレインストールされています。 ただし、独自の開発コンテナーを構成して、プロジェクトに必要なすべてのツールとスクリプトを含めることをお勧めします。 これにより、リポジトリのすべての {% data variables.product.prodname_github_codespaces %} ユーザーに対して、完全に再現可能な環境が保証されます。 {% data reusables.codespaces.setup-custom-devcontainer %} {% data reusables.codespaces.command-palette-container %} -1. For this example, click **Java**. In practice, you could select any container that’s specific to Java or a combination of tools such as Java and Azure Functions. - ![Select Java option from the list](/assets/images/help/codespaces/add-java-prebuilt-container.png) -1. Click the recommended version of Java. - ![Java version selection](/assets/images/help/codespaces/add-java-version.png) -{% data reusables.codespaces.rebuild-command %} +1. この例では、 **[Java]** をクリックします。 実際には、Java に固有の任意のコンテナ、または Java と Azure Functions などのツールの組み合わせを選択できます。 + ![一覧から [Java] オプションを選びます](/assets/images/help/codespaces/add-java-prebuilt-container.png) +1. Java の推奨バージョンをクリックします。 + ![Java のバージョンの選択](/assets/images/help/codespaces/add-java-version.png) {% data reusables.codespaces.rebuild-command %} -### Anatomy of your dev container +### 開発コンテナの構造 -Adding the Java dev container template adds a `.devcontainer` directory to the root of your project's repository with the following files: +Java 開発コンテナー テンプレートを追加すると、次のファイルを含む `.devcontainer` ディレクトリが、プロジェクトのリポジトリのルートに追加されます。 - `devcontainer.json` - Dockerfile -The newly added `devcontainer.json` file defines a few properties that are described after the sample. +新しく追加された `devcontainer.json` ファイルでは、サンプルの後に説明されるいくつかのプロパティを定義します。 #### devcontainer.json @@ -61,55 +65,55 @@ The newly added `devcontainer.json` file defines a few properties that are descr // For format details, see https://aka.ms/vscode-remote/devcontainer.json or this file's README at: // https://github.com/microsoft/vscode-dev-containers/tree/v0.159.0/containers/java { - "name": "Java", - "build": { - "dockerfile": "Dockerfile", - "args": { - // Update the VARIANT arg to pick a Java version: 11, 14 - "VARIANT": "11", - // Options - "INSTALL_MAVEN": "true", - "INSTALL_GRADLE": "false", - "INSTALL_NODE": "false", - "NODE_VERSION": "lts/*" - } - }, + "name": "Java", + "build": { + "dockerfile": "Dockerfile", + "args": { + // Update the VARIANT arg to pick a Java version: 11, 14 + "VARIANT": "11", + // Options + "INSTALL_MAVEN": "true", + "INSTALL_GRADLE": "false", + "INSTALL_NODE": "false", + "NODE_VERSION": "lts/*" + } + }, - // Set *default* container specific settings.json values on container create. - "settings": { - "terminal.integrated.shell.linux": "/bin/bash", - "java.home": "/docker-java-home", - "maven.executable.path": "/usr/local/sdkman/candidates/maven/current/bin/mvn" - }, + // Set *default* container specific settings.json values on container create. + "settings": { + "terminal.integrated.shell.linux": "/bin/bash", + "java.home": "/docker-java-home", + "maven.executable.path": "/usr/local/sdkman/candidates/maven/current/bin/mvn" + }, - // Add the IDs of extensions you want installed when the container is created. - "extensions": [ - "vscjava.vscode-java-pack" - ], + // Add the IDs of extensions you want installed when the container is created. + "extensions": [ + "vscjava.vscode-java-pack" + ], - // Use 'forwardPorts' to make a list of ports inside the container available locally. - // "forwardPorts": [], + // Use 'forwardPorts' to make a list of ports inside the container available locally. + // "forwardPorts": [], - // Use 'postCreateCommand' to run commands after the container is created. - // "postCreateCommand": "java -version", + // Use 'postCreateCommand' to run commands after the container is created. + // "postCreateCommand": "java -version", - // Uncomment to connect as a non-root user. See https://aka.ms/vscode-remote/containers/non-root. - "remoteUser": "vscode" + // Uncomment to connect as a non-root user. See https://aka.ms/vscode-remote/containers/non-root. + "remoteUser": "vscode" } ``` -- **name** - You can name your dev container anything, this is just the default. -- **build** - The build properties. - - **dockerfile** - In the `build` object, `dockerfile` contains the path to the Dockerfile that was also added from the template. +- **name** - 開発コンテナーには任意の名前を付けることができます。これは既定値です。 +- **build** - ビルドのプロパティ。 + - **dockerfile** - `build` オブジェクトの `dockerfile` には、やはりテンプレートから追加された Dockerfile へのパスが含まれます。 - **args** - - **variant**: This file only contains one build argument, which is the Java version that is passed into the Dockerfile. -- **settings** - These are {% data variables.product.prodname_vscode %} settings that you can set. - - **terminal.integrated.shell.linux** - While bash is the default here, you could use other terminal shells by modifying this. -- **extensions** - These are extensions included by default. - - **vscjava.vscode-java-pack** - The Java Extension Pack provides popular extensions for Java development to get you started. -- **forwardPorts** - Any ports listed here will be forwarded automatically. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." -- **postCreateCommand** - Use this to run commands that aren't defined in the Dockerfile, after your codespace is created. -- **remoteUser** - By default, you’re running as the `vscode` user, but you can optionally set this to `root`. + - **variant**: このファイルには、Dockerfile に渡される Java のバージョンであるビルド引数が 1 つだけ含まれています。 +- **settings** - これらは、ユーザーが設定できる {% data variables.product.prodname_vscode %} の設定です。 + - **terminal.integrated.shell.linux** - ここでは bash が既定値ですが、これを変更すると他のターミナル シェルを使用できます。 +- **extensions** - これらは既定で含まれる拡張機能です。 + - **vscjava.vscode-java-pack** - Java Extension Pack は、Java 開発を始めるための一般的な機能拡張を提供します。 +- **forwardPorts** - ここにリストされているポートはすべて自動的に転送されます。 詳細については、「[codespace でのポートの転送](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)」を参照してください。 +- **postCreateCommand** - codespace が作成された後に、Dockerfile で定義されていないコマンドを実行するには、これを使います。 +- **remoteUser** - 既定では、`vscode` ユーザーとして実行されていますが、必要に応じてこれを `root` に設定することができます。 #### Dockerfile @@ -139,17 +143,17 @@ RUN if [ "${INSTALL_NODE}" = "true" ]; then su vscode -c "source /usr/local/shar # RUN su vscode -c "source /usr/local/share/nvm/nvm.sh && npm install -g " 2>&1 ``` -You can use the Dockerfile to add additional container layers to specify OS packages, Java versions, or global packages we want included in our container. +Dockerfile を使って、新しいコンテナー レイヤーを追加し、コンテナーに含める OS パッケージ、Java のバージョン、またはグローバル パッケージを指定できます。 -## Step 3: Modify your devcontainer.json file +## ステップ 3: devcontainer.json ファイルを変更する -With your dev container configuration added and a basic understanding of what everything does, you can now make changes to customize your environment further. In this example, you'll add properties to install extensions and your project dependencies when your codespace launches. +開発コンテナーの構成を追加し、すべての機能を基本的に理解したので、変更を行って環境をさらにカスタマイズできます。 この例では、コードスペースの起動時に拡張機能とプロジェクトの依存関係をインストールするためのプロパティを追加します。 -1. In the Explorer, select the `devcontainer.json` file from the tree to open it. You might have to expand the `.devcontainer` folder to see it. +1. エクスプローラーで、ツリーから `devcontainer.json` ファイルを選択してそれを開きます。 表示するには、`.devcontainer` フォルダーを展開する必要がある場合があります。 - ![devcontainer.json file in the Explorer](/assets/images/help/codespaces/devcontainers-options.png) + ![エクスプローラーの devcontainer.json ファイル](/assets/images/help/codespaces/devcontainers-options.png) -2. Add the following lines to your `devcontainer.json` file after `extensions`. +2. `devcontainer.json` ファイルの `extensions` の後に、次の行を追加します。 ```json{:copy} "postCreateCommand": "npm install", @@ -162,22 +166,22 @@ With your dev container configuration added and a basic understanding of what ev {% data reusables.codespaces.rebuild-reason %} -## Step 4: Run your application +## 手順 4:アプリケーションを実行する -In the previous section, you used the `postCreateCommand` to install a set of packages via npm. You can now use this to run our application with npm. +前のセクションでは、`postCreateCommand` 使って、一連のパッケージを npm でインストールしました。 これを使用して、npm でアプリケーションを実行できます。 -1. Run your application by pressing `F5`. +1. `F5` キーを押してアプリケーションを実行します。 -2. When your project starts, you should see a "toast" notification message at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, containing a prompt to connect to the port your project uses. +2. プロジェクトが開始されると、{% data variables.product.prodname_vscode_shortname %} の右下隅に "トースト" 通知メッセージが表示されるはずです。プロジェクトで使用されるポートに接続するように促されます。 - ![Port forwarding "toast" notification](/assets/images/help/codespaces/codespaces-port-toast.png) + ![ポート転送の "トースト" 通知](/assets/images/help/codespaces/codespaces-port-toast.png) -## Step 5: Commit your changes +## ステップ 5: 変更をコミットする {% data reusables.codespaces.committing-link-to-procedure %} -## Next steps +## 次のステップ -You should now be ready start developing your Java project in {% data variables.product.prodname_github_codespaces %}. Here are some additional resources for more advanced scenarios. +これで、Java で {% data variables.product.prodname_github_codespaces %} プロジェクトの開発を始める準備ができました。 より高度なシナリオ向けの追加のリソースは次のとおりです。 {% data reusables.codespaces.next-steps-adding-devcontainer %} diff --git a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md index b46287cc47..9d4578347c 100644 --- a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md +++ b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md @@ -1,8 +1,8 @@ --- -title: Setting up your Node.js project for GitHub Codespaces +title: GitHub Codespaces 用の Node.js プロジェクトを設定する allowTitleToDifferFromFilename: true shortTitle: Setting up your Node.js project -intro: 'Get started with your JavaScript, Node.js, or TypeScript project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container.' +intro: 'カスタム開発コンテナーを作成して、{% data variables.product.prodname_github_codespaces %} で JavaScript、Node.js または TypeScript プロジェクトを始めます。' versions: fpt: '*' ghec: '*' @@ -16,54 +16,57 @@ topics: - JavaScript hasExperimentalAlternative: true hidden: true +ms.openlocfilehash: 19c29f7d3c8110d1c671a9af46227a399a467800 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159904' --- +## はじめに +このガイドでは、JavaScript、Node.js または TypeScript プロジェクトの設定方法を紹介します {% data reusables.codespaces.setting-up-project-intro %} +### 前提条件 -## Introduction +- {% data variables.product.prodname_dotcom_the_website %} のリポジトリに既存の JavaScript、Node.js、または TypeScript プロジェクトがあります。 プロジェクトがない場合は、次の例を使用してこのチュートリアルを試すことができます: https://github.com/microsoft/vscode-remote-try-node +- Organization で {% data variables.product.prodname_github_codespaces %} を有効にする必要があります。 -This guide shows you how to set up your JavaScript, Node.js, or TypeScript project {% data reusables.codespaces.setting-up-project-intro %} +## ステップ 1: codespace でプロジェクトを開く -### Prerequisites +1. リポジトリ名の下で、 **{% octicon "code" aria-label="The code icon" %} コード** のドロップダウン メニューを使い、 **[Codespaces]** タブでプラス記号 {% octicon "plus" aria-label="The plus icon" %} をクリックします。 -- You should have an existing JavaScript, Node.js, or TypeScript project in a repository on {% data variables.product.prodname_dotcom_the_website %}. If you don't have a project, you can try this tutorial with the following example: https://github.com/microsoft/vscode-remote-try-node -- You must have {% data variables.product.prodname_github_codespaces %} enabled for your organization. + ![[New codespace] ボタン](/assets/images/help/codespaces/new-codespace-button.png) -## Step 1: Open your project in a codespace - -1. Under the repository name, use the **{% octicon "code" aria-label="The code icon" %} Code** dropdown menu, and in the **Codespaces** tab, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}). - - ![New codespace button](/assets/images/help/codespaces/new-codespace-button.png) - -When you create a codespace, your project is created on a remote VM that is dedicated to you. By default, the container for your codespace has many languages and runtimes including Node.js, JavaScript, Typescript, nvm, npm, and yarn. It also includes a common set of tools like git, wget, rsync, openssh, and nano. +codespace を作成すると、プロジェクトは専用のリモート VM 上に作成されます。 デフォルト設定では、codespace のコンテナには、Node.js、JavaScript、Typescript、nvm、npm、yarn を含む多くの言語とランタイムがあります。 また、git、wget、rsync、openssh、nano などの一般的なツールセットも含まれています。 {% data reusables.codespaces.customize-vcpus-and-ram %} -## Step 2: Add a dev container configuration to your repository from a template +## ステップ 2: テンプレートからリポジトリに開発コンテナーの構成を追加する -The default development container, or "dev container," for {% data variables.product.prodname_github_codespaces %} will support running Node.js projects like [vscode-remote-try-node](https://github.com/microsoft/vscode-remote-try-node) out of the box. However, we recommend that you configure your own dev container, as this allows you to define any particular tools and scripts your project needs. This will ensure a fully reproducible environment for all {% data variables.product.prodname_github_codespaces %} users in your repository. +{% data variables.product.prodname_github_codespaces %} の既定の開発コンテナーでは、[vscode-remote-try-node](https://github.com/microsoft/vscode-remote-try-node) などの Node.js プロジェクトをすぐに実行できます。 ただし、独自の開発コンテナーを構成することをお勧めします。プロジェクトで必要な特定のツールとスクリプトを定義できるからです。 これにより、リポジトリのすべての {% data variables.product.prodname_github_codespaces %} ユーザーに対して、完全に再現可能な環境が保証されます。 {% data reusables.codespaces.setup-custom-devcontainer %} {% data reusables.codespaces.command-palette-container %} -1. For this example, click **Node.js**. If you need additional features you can select any container that’s specific to Node or a combination of tools such as Node and MongoDB. +1. この例では、 **[Node.js]** をクリックします。 追加機能が必要な場合は、Node に固有の任意のコンテナ、または Node と MongoDB などのツールの組み合わせを選択できます。 - ![Select Node option from the list](/assets/images/help/codespaces/add-node-prebuilt-container.png) + ![リストから Node オプションを選択](/assets/images/help/codespaces/add-node-prebuilt-container.png) -1. Click the recommended version of Node.js. +1. Node.js の推奨バージョンをクリックします。 - ![Node.js version selection](/assets/images/help/codespaces/add-node-version.png) + ![Node.js バージョンの選択](/assets/images/help/codespaces/add-node-version.png) {% data reusables.codespaces.rebuild-command %} -### Anatomy of your dev container +### 開発コンテナの構造 -Adding the Node.js dev container template adds a `.devcontainer` directory to the root of your project's repository with the following files: +Node.js 開発コンテナー テンプレートを追加すると、次のファイルを含む `.devcontainer` ディレクトリが、プロジェクトのリポジトリのルートに追加されます。 - `devcontainer.json` - Dockerfile -The newly added `devcontainer.json` file defines a few properties that are described after the sample. +新しく追加された `devcontainer.json` ファイルでは、サンプルの後に説明されるいくつかのプロパティを定義します。 #### devcontainer.json @@ -71,46 +74,46 @@ The newly added `devcontainer.json` file defines a few properties that are descr // For format details, see https://aka.ms/devcontainer.json. For config options, see the README at: // https://github.com/microsoft/vscode-dev-containers/tree/v0.162.0/containers/javascript-node { - "name": "Node.js", - "build": { - "dockerfile": "Dockerfile", - // Update 'VARIANT' to pick a Node version: 10, 12, 14 - "args": { "VARIANT": "14" } - }, + "name": "Node.js", + "build": { + "dockerfile": "Dockerfile", + // Update 'VARIANT' to pick a Node version: 10, 12, 14 + "args": { "VARIANT": "14" } + }, - // Set *default* container specific settings.json values on container create. - "settings": { - "terminal.integrated.shell.linux": "/bin/bash" - }, + // Set *default* container specific settings.json values on container create. + "settings": { + "terminal.integrated.shell.linux": "/bin/bash" + }, - // Add the IDs of extensions you want installed when the container is created. - "extensions": [ - "dbaeumer.vscode-eslint" - ], + // Add the IDs of extensions you want installed when the container is created. + "extensions": [ + "dbaeumer.vscode-eslint" + ], - // Use 'forwardPorts' to make a list of ports inside the container available locally. - // "forwardPorts": [], + // Use 'forwardPorts' to make a list of ports inside the container available locally. + // "forwardPorts": [], - // Use 'postCreateCommand' to run commands after the container is created. - // "postCreateCommand": "yarn install", + // Use 'postCreateCommand' to run commands after the container is created. + // "postCreateCommand": "yarn install", - // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. - "remoteUser": "node" + // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. + "remoteUser": "node" } ``` -- **name** - You can name your dev container anything, this is just the default. -- **build** - The build properties. - - **dockerfile** - In the `build` object, `dockerfile` contains the path to the Dockerfile that was also added from the template. +- **name** - 開発コンテナーには任意の名前を付けることができます。これは既定値です。 +- **build** - ビルドのプロパティ。 + - **dockerfile** - `build` オブジェクトの `dockerfile` には、やはりテンプレートから追加された Dockerfile へのパスが含まれます。 - **args** - - **variant**: This file only contains one build argument, which is the node variant we want to use that is passed into the Dockerfile. -- **settings** - These are {% data variables.product.prodname_vscode %} settings that you can set. - - **terminal.integrated.shell.linux** - While bash is the default here, you could use other terminal shells by modifying this. -- **extensions** - These are extensions included by default. - - **dbaeumer.vscode-eslint** - ES lint is a great extension for linting, but for JavaScript there are a number of great Marketplace extensions you could also include. -- **forwardPorts** - Any ports listed here will be forwarded automatically. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." -- **postCreateCommand** - Use this to run commands that aren't defined in the Dockerfile, after your codespace is created. -- **remoteUser** - By default, you’re running as the vscode user, but you can optionally set this to root. + - **バリアント**: このファイルにはビルド引数が 1 つだけ含まれています。それは使用するノード バリアントで、Dockerfile に渡されます。 +- **settings** - これらは、ユーザーが設定できる {% data variables.product.prodname_vscode %} の設定です。 + - **terminal.integrated.shell.linux** - ここでは bash が既定値ですが、これを変更すると他のターミナル シェルを使用できます。 +- **extensions** - これらは既定で含まれる拡張機能です。 + - **Dbaeumer.vscode-eslint** - ES lint は lint の優れた機能拡張ですが、JavaScript の場合は、Marketplace の優れた機能拡張も多数含めることができます。 +- **forwardPorts** - ここにリストされているポートはすべて自動的に転送されます。 詳細については、「[codespace でのポートの転送](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)」を参照してください。 +- **postCreateCommand** - codespace が作成された後に、Dockerfile で定義されていないコマンドを実行するには、これを使います。 +- **remoteUser** - 既定では、vscode ユーザーとして実行されていますが、必要に応じてこれを root に設定することができます。 #### Dockerfile @@ -131,17 +134,17 @@ FROM mcr.microsoft.com/vscode/devcontainers/javascript-node:0-${VARIANT} # RUN su node -c "npm install -g " ``` -You can use the Dockerfile to add additional container layers to specify OS packages, node versions, or global packages we want included in our container. +Dockerfile を使用して、コンテナレイヤーを追加し、コンテナに含める OS パッケージ、ノードバージョン、またはグローバルパッケージを指定できます。 -## Step 3: Modify your devcontainer.json file +## ステップ 3: devcontainer.json ファイルを変更する -With your dev container configuration added and a basic understanding of what everything does, you can now make changes to customize your environment further. In this example, you'll add properties to install npm when your codespace launches and make a list of ports inside the container available locally. +開発コンテナーの構成を追加し、すべての機能を基本的に理解したので、変更を行って環境をさらにカスタマイズできます。 この例では、codespace の起動時に npm をインストールするためのプロパティを追加し、コンテナ内のポートのリストをローカルで使用できるようにします。 -1. In the Explorer, select the `devcontainer.json` file from the tree to open it. You might have to expand the `.devcontainer` folder to see it. +1. エクスプローラーで、ツリーから `devcontainer.json` ファイルを選択してそれを開きます。 表示するには、`.devcontainer` フォルダーを展開する必要がある場合があります。 - ![devcontainer.json file in the Explorer](/assets/images/help/codespaces/devcontainers-options.png) + ![エクスプローラーの devcontainer.json ファイル](/assets/images/help/codespaces/devcontainers-options.png) -2. Add the following lines to your `devcontainer.json` file after `extensions`: +2. `extensions` の後で、`devcontainer.json` ファイルに次の行を追加します。 ```json{:copy} "postCreateCommand": "npm install", @@ -154,24 +157,24 @@ With your dev container configuration added and a basic understanding of what ev {% data reusables.codespaces.rebuild-reason %} -## Step 4: Run your application +## 手順 4:アプリケーションを実行する -In the previous section, you used the `postCreateCommand` to installing a set of packages via npm. You can now use this to run our application with npm. +前のセクションでは、`postCreateCommand` 使用して、一連のパッケージを npm を介してインストールしました。 これを使用して、npm でアプリケーションを実行できます。 -1. Run your start command in the terminal with`npm start`. +1. ターミナルで `npm start` を使用して start コマンドを実行します。 - ![npm start in terminal](/assets/images/help/codespaces/codespaces-npmstart.png) + ![npm をターミナルで開始](/assets/images/help/codespaces/codespaces-npmstart.png) -2. When your project starts, you should see a "toast" notification message at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, containing a prompt to connect to the port your project uses. +2. プロジェクトが始まると、{% data variables.product.prodname_vscode_shortname %} の右下隅に "トースト" 通知メッセージが表示されるはずです。プロジェクトで使用されるポートに接続するように促されます。 - ![Port forwarding "toast" notification](/assets/images/help/codespaces/codespaces-port-toast.png) + ![ポート転送の "トースト" 通知](/assets/images/help/codespaces/codespaces-port-toast.png) -## Step 5: Commit your changes +## ステップ 5: 変更をコミットする {% data reusables.codespaces.committing-link-to-procedure %} -## Next steps +## 次のステップ -You should now be ready start developing your JavaScript project in {% data variables.product.prodname_github_codespaces %}. Here are some additional resources for more advanced scenarios. +これで、{% data variables.product.prodname_github_codespaces %} で JavaScript プロジェクトの開発を始める準備ができました。 より高度なシナリオ向けの追加のリソースは次のとおりです。 {% data reusables.codespaces.next-steps-adding-devcontainer %} diff --git a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces.md b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces.md index 6b6e352488..7f382ecb89 100644 --- a/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces.md +++ b/translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces.md @@ -1,8 +1,8 @@ --- -title: Setting up your Python project for GitHub Codespaces +title: GitHub Codespaces 用に Python プロジェクトを設定する allowTitleToDifferFromFilename: true shortTitle: Setting up your Python project -intro: 'Get started with your Python project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container.' +intro: 'カスタム開発コンテナーを作成して、{% data variables.product.prodname_github_codespaces %} で Python プロジェクトを始めます。' versions: fpt: '*' ghec: '*' @@ -15,113 +15,117 @@ topics: - Python hasExperimentalAlternative: true hidden: true +ms.openlocfilehash: 2d9c627907f447a3efd873fceba963b899b57c39 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159848' --- +## はじめに -## Introduction +このガイドでは、Python プロジェクトの設定方法を紹介します {% data reusables.codespaces.setting-up-project-intro %} -This guide shows you how to set up your Python project {% data reusables.codespaces.setting-up-project-intro %} +### 前提条件 -### Prerequisites +- {% data variables.product.prodname_dotcom_the_website %} のリポジトリに既存の Python プロジェクトがあります。 プロジェクトがない場合は、次の例を使用してこのチュートリアルを試すことができます: https://github.com/2percentsilk/python-quickstart 。 +- Organization で {% data variables.product.prodname_github_codespaces %} を有効にする必要があります。 -- You should have an existing Python project in a repository on {% data variables.product.prodname_dotcom_the_website %}. If you don't have a project, you can try this tutorial with the following example: https://github.com/2percentsilk/python-quickstart. -- You must have {% data variables.product.prodname_github_codespaces %} enabled for your organization. +## ステップ 1: codespace でプロジェクトを開く -## Step 1: Open your project in a codespace +1. リポジトリ名の下で、 **{% octicon "code" aria-label="The code icon" %} コード** のドロップダウン メニューを使い、 **[Codespaces]** タブでプラス記号 {% octicon "plus" aria-label="The plus icon" %} をクリックします。 -1. Under the repository name, use the **{% octicon "code" aria-label="The code icon" %} Code** dropdown menu, and in the **Codespaces** tab, click the plus sign ({% octicon "plus" aria-label="The plus icon" %}). + ![[New codespace] ボタン](/assets/images/help/codespaces/new-codespace-button.png) - ![New codespace button](/assets/images/help/codespaces/new-codespace-button.png) - -When you create a codespace, your project is created on a remote VM that is dedicated to you. By default, the container for your codespace has many languages and runtimes including Node.js, JavaScript, Typescript, nvm, npm, and yarn. It also includes a common set of tools like git, wget, rsync, openssh, and nano. +codespace を作成すると、プロジェクトは専用のリモート VM 上に作成されます。 デフォルト設定では、codespace のコンテナには、Node.js、JavaScript、Typescript、nvm、npm、yarn を含む多くの言語とランタイムがあります。 また、git、wget、rsync、openssh、nano などの一般的なツールセットも含まれています。 {% data reusables.codespaces.customize-vcpus-and-ram %} -## Step 2: Add a dev container configuration to your repository from a template +## ステップ 2: テンプレートからリポジトリに開発コンテナーの構成を追加する -The default development container, or "dev container," for {% data variables.product.prodname_github_codespaces %} comes with the latest Python version, package managers (pip, Miniconda), and other common tools preinstalled. However, we recommend that you configure your own dev container to include all of the tools and scripts that your project needs. This will ensure a fully reproducible environment for all {% data variables.product.prodname_github_codespaces %} users in your repository. +{% data variables.product.prodname_github_codespaces %} の既定の開発コンテナー ("dev コンテナー") には、Python の最新バージョン、パッケージ マネージャー (pip、Miniconda)、その他の一般的なツールがプレインストールされています。 ただし、独自の開発コンテナーを構成して、プロジェクトに必要なすべてのツールとスクリプトを含めることをお勧めします。 これにより、リポジトリのすべての {% data variables.product.prodname_github_codespaces %} ユーザーに対して、完全に再現可能な環境が保証されます。 {% data reusables.codespaces.setup-custom-devcontainer %} {% data reusables.codespaces.command-palette-container %} -1. For this example, click **Python 3**. If you need additional features you can select any container that’s specific to Python or a combination of tools such as Python 3 and PostgreSQL. - ![Select Python option from the list](/assets/images/help/codespaces/add-python-prebuilt-container.png) -1. Click the recommended version of Python. - ![Python version selection](/assets/images/help/codespaces/add-python-version.png) -1. Accept the default option to add Node.js to your customization. - ![Add Node.js selection](/assets/images/help/codespaces/add-nodejs-selection.png) -{% data reusables.codespaces.rebuild-command %} +1. この例では、 **[Python 3]** をクリックします。 追加機能が必要な場合は、Python に固有の任意のコンテナ、または Python 3 と PostgreSQL などのツールの組み合わせを選択できます。 + ![リストから Python オプションを選択する](/assets/images/help/codespaces/add-python-prebuilt-container.png) +1. Python の推奨バージョンをクリックします。 + ![Python バージョンの選択](/assets/images/help/codespaces/add-python-version.png) +1. デフォルトのオプションを使用して、Node.js をカスタマイズに追加します。 + ![Node.js の選択に追加](/assets/images/help/codespaces/add-nodejs-selection.png) {% data reusables.codespaces.rebuild-command %} -### Anatomy of your dev container +### 開発コンテナの構造 -Adding the Python dev container template adds a `.devcontainer` directory to the root of your project's repository with the following files: +Python 開発コンテナー テンプレートを追加すると、次のファイルを含む `.devcontainer` ディレクトリが、プロジェクトのリポジトリのルートに追加されます。 - `devcontainer.json` - Dockerfile -The newly added `devcontainer.json` file defines a few properties that are described after the sample. +新しく追加された `devcontainer.json` ファイルでは、サンプルの後に説明されるいくつかのプロパティを定義します。 #### devcontainer.json ```json { - "name": "Python 3", - "build": { - "dockerfile": "Dockerfile", - "context": "..", - "args": { - // Update 'VARIANT' to pick a Python version: 3, 3.6, 3.7, 3.8, 3.9 - "VARIANT": "3", - // Options - "INSTALL_NODE": "true", - "NODE_VERSION": "lts/*" - } - }, + "name": "Python 3", + "build": { + "dockerfile": "Dockerfile", + "context": "..", + "args": { + // Update 'VARIANT' to pick a Python version: 3, 3.6, 3.7, 3.8, 3.9 + "VARIANT": "3", + // Options + "INSTALL_NODE": "true", + "NODE_VERSION": "lts/*" + } + }, - // Set *default* container specific settings.json values on container create. - "settings": { - "terminal.integrated.shell.linux": "/bin/bash", - "python.pythonPath": "/usr/local/bin/python", - "python.linting.enabled": true, - "python.linting.pylintEnabled": true, - "python.formatting.autopep8Path": "/usr/local/py-utils/bin/autopep8", - "python.formatting.blackPath": "/usr/local/py-utils/bin/black", - "python.formatting.yapfPath": "/usr/local/py-utils/bin/yapf", - "python.linting.banditPath": "/usr/local/py-utils/bin/bandit", - "python.linting.flake8Path": "/usr/local/py-utils/bin/flake8", - "python.linting.mypyPath": "/usr/local/py-utils/bin/mypy", - "python.linting.pycodestylePath": "/usr/local/py-utils/bin/pycodestyle", - "python.linting.pydocstylePath": "/usr/local/py-utils/bin/pydocstyle", - "python.linting.pylintPath": "/usr/local/py-utils/bin/pylint" - }, + // Set *default* container specific settings.json values on container create. + "settings": { + "terminal.integrated.shell.linux": "/bin/bash", + "python.pythonPath": "/usr/local/bin/python", + "python.linting.enabled": true, + "python.linting.pylintEnabled": true, + "python.formatting.autopep8Path": "/usr/local/py-utils/bin/autopep8", + "python.formatting.blackPath": "/usr/local/py-utils/bin/black", + "python.formatting.yapfPath": "/usr/local/py-utils/bin/yapf", + "python.linting.banditPath": "/usr/local/py-utils/bin/bandit", + "python.linting.flake8Path": "/usr/local/py-utils/bin/flake8", + "python.linting.mypyPath": "/usr/local/py-utils/bin/mypy", + "python.linting.pycodestylePath": "/usr/local/py-utils/bin/pycodestyle", + "python.linting.pydocstylePath": "/usr/local/py-utils/bin/pydocstyle", + "python.linting.pylintPath": "/usr/local/py-utils/bin/pylint" + }, - // Add the IDs of extensions you want installed when the container is created. - "extensions": [ - "ms-python.python" - ], + // Add the IDs of extensions you want installed when the container is created. + "extensions": [ + "ms-python.python" + ], - // Use 'forwardPorts' to make a list of ports inside the container available locally. - // "forwardPorts": [], + // Use 'forwardPorts' to make a list of ports inside the container available locally. + // "forwardPorts": [], - // Use 'postCreateCommand' to run commands after the container is created. - // "postCreateCommand": "pip3 install --user -r requirements.txt", + // Use 'postCreateCommand' to run commands after the container is created. + // "postCreateCommand": "pip3 install --user -r requirements.txt", - // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. - "remoteUser": "vscode" + // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. + "remoteUser": "vscode" } ``` -- **name** - You can name our dev container anything, this is just the default. -- **build** - The build properties. - - **dockerfile** - In the `build` object, `dockerfile` contains the path to the Dockerfile that was also added from the template. +- **name** - 開発コンテナーには任意の名前を付けることができます。これは既定値です。 +- **build** - ビルドのプロパティ。 + - **dockerfile** - `build` オブジェクトの `dockerfile` には、やはりテンプレートから追加された Dockerfile へのパスが含まれます。 - **args** - - **variant**: This file only contains one build argument, which is the node variant we want to use that is passed into the Dockerfile. -- **settings** - These are {% data variables.product.prodname_vscode %} settings. - - **terminal.integrated.shell.linux** - While bash is the default here, you could use other terminal shells by modifying this. -- **extensions** - These are extensions included by default. - - **ms-python.python** - The Microsoft Python extension provides rich support for the Python language (for all actively supported versions of the language: >=3.6), including features such as IntelliSense, linting, debugging, code navigation, code formatting, refactoring, variable explorer, test explorer, and more. -- **forwardPorts** - Any ports listed here will be forwarded automatically. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." -- **postCreateCommand** - Use this to run commands that aren't defined in the Dockerfile, like `pip3 install -r requirements`, after your codespace is created. -- **remoteUser** - By default, you’re running as the `vscode` user, but you can optionally set this to `root`. + - **variant**: このファイルにはビルド引数が 1 つだけ含まれています。それは使用するノード バリアントで、Dockerfile に渡されます。 +- **settings** - これらは {% data variables.product.prodname_vscode %} 設定です。 + - **terminal.integrated.shell.linux** - ここでは bash が既定値ですが、これを変更すると他のターミナル シェルを使用できます。 +- **extensions** - これらは既定で含まれる拡張機能です。 + - **ms-python.python** - Microsoft Python 機能拡張は、IntelliSense、linting、デバッグ、コードナビゲーション、コード形式、リファクタリング、変数エクスプローラ、テストエクスプローラなどの機能を含む、Python 言語 (言語のアクティブにサポートされているすべてのバージョン 3.6 または以降) の豊富なサポートを提供します。 +- **forwardPorts** - ここにリストされているポートはすべて自動的に転送されます。 詳細については、「[codespace でのポートの転送](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)」を参照してください。 +- **postCreateCommand** - codespace が作成された後に、`pip3 install -r requirements` のような Dockerfile で定義されていないコマンドを実行するには、これを使います。 +- **remoteUser** - 既定では、`vscode` ユーザーとして実行されていますが、必要に応じてこれを `root` に設定することができます。 #### Dockerfile @@ -148,27 +152,27 @@ RUN if [ "${INSTALL_NODE}" = "true" ]; then su vscode -c "umask 0002 && . /usr/l # RUN su vscode -c "source /usr/local/share/nvm/nvm.sh && npm install -g " 2>&1 ``` -You can use the Dockerfile to add additional container layers to specify OS packages, node versions, or global packages we want included in our container. +Dockerfile を使用して、コンテナレイヤーを追加し、コンテナに含める OS パッケージ、ノードバージョン、またはグローバルパッケージを指定できます。 -## Step 3: Modify your devcontainer.json file +## ステップ 3: devcontainer.json ファイルを変更する -With your dev container configuration added and a basic understanding of what everything does, you can now make changes to customize your environment further. In this example, you'll add properties to install extensions and your project dependencies when your codespace launches. +開発コンテナーの構成を追加し、すべての機能を基本的に理解したので、変更を行って環境をさらにカスタマイズできます。 この例では、コードスペースの起動時に拡張機能とプロジェクトの依存関係をインストールするためのプロパティを追加します。 -1. In the Explorer, expand the `.devcontainer` folder and select the `devcontainer.json` file from the tree to open it. +1. エクスプローラーで、`.devcontainer` フォルダーを展開し、ツリーから `devcontainer.json` ファイルを選択してそれを開きます。 - ![devcontainer.json file in the Explorer](/assets/images/help/codespaces/devcontainers-options.png) + ![エクスプローラーの devcontainer.json ファイル](/assets/images/help/codespaces/devcontainers-options.png) -2. Update the `extensions` list in your `devcontainer.json` file to add a few extensions that are useful when working with your project. +2. `devcontainer.json` ファイル内の `extensions` 一覧を更新して、プロジェクトを操作する際に役立つ拡張機能をいくつか追加します。 ```json{:copy} "extensions": [ - "ms-python.python", - "cstrap.flask-snippets", - "streetsidesoftware.code-spell-checker" - ], + "ms-python.python", + "cstrap.flask-snippets", + "streetsidesoftware.code-spell-checker" + ], ``` -3. Uncomment the `postCreateCommand` to auto-install requirements as part of the codespaces setup process. +3. `postCreateCommand` のコメントを解除して、codespaces の設定プロセスの一環として要件を自動インストールします。 ```json{:copy} // Use 'postCreateCommand' to run commands after the container is created. @@ -179,26 +183,26 @@ With your dev container configuration added and a basic understanding of what ev {% data reusables.codespaces.rebuild-reason %} -5. Check your changes were successfully applied by verifying the Code Spell Checker and Flask Snippet extensions were installed. +5. Code Spell Checker と Flask Snippet 機能拡張がインストールされていることを確認して、変更が正常に適用されたことを確認します。 - ![Extensions list](/assets/images/help/codespaces/python-extensions.png) + ![機能拡張のリスト](/assets/images/help/codespaces/python-extensions.png) -## Step 4: Run your application +## 手順 4:アプリケーションを実行する -In the previous section, you used the `postCreateCommand` to install a set of packages via pip3. With your dependencies now installed, you can run your application. +前のセクションでは、`postCreateCommand` 使用して、一連のパッケージを pip3 を介してインストールしました。 依存関係がインストールされたら、アプリケーションを実行できます。 -1. Run your application by pressing `F5` or entering `python -m flask run` in the codespace terminal. +1. codespace ターミナルで `F5` を押すか、`python -m flask run` を入力してアプリケーションを実行します。 -2. When your project starts, you should see a "toast" notification message at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, containing a prompt to connect to the port your project uses. +2. プロジェクトが始まると、{% data variables.product.prodname_vscode_shortname %} の右下隅に "トースト" 通知メッセージが表示されるはずです。プロジェクトで使用されるポートに接続するように促されます。 - ![Port forwarding "toast" notification](/assets/images/help/codespaces/python-port-forwarding.png) + ![ポート転送の "トースト" 通知](/assets/images/help/codespaces/python-port-forwarding.png) -## Step 5: Commit your changes +## ステップ 5: 変更をコミットする {% data reusables.codespaces.committing-link-to-procedure %} -## Next steps +## 次のステップ -You should now be ready start developing your Python project in {% data variables.product.prodname_github_codespaces %}. Here are some additional resources for more advanced scenarios. +これで、Python で {% data variables.product.prodname_github_codespaces %} プロジェクトの開発を始める準備ができました。 より高度なシナリオ向けの追加のリソースは次のとおりです。 {% data reusables.codespaces.next-steps-adding-devcontainer %} diff --git a/translations/ja-JP/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md b/translations/ja-JP/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md index d8f3a8ecd5..45a000f228 100644 --- a/translations/ja-JP/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md +++ b/translations/ja-JP/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md @@ -1,6 +1,6 @@ --- -title: Exporting changes to a branch -intro: This article provides steps for exporting your codespace changes to a branch. +title: ブランチへの変更のエクスポート +intro: この記事では、codespace の変更をブランチにエクスポートする手順について説明します。 versions: fpt: '*' ghec: '*' @@ -8,20 +8,25 @@ type: reference topics: - Codespaces shortTitle: Exporting changes +ms.openlocfilehash: 2a7dee4725af31f3983e753b4202f94be1742556 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159911' --- +## ブランチへの変更のエクスポート -## Exporting changes to a branch +{% data variables.product.prodname_github_codespaces %} を使用しているときに、codespace を起動せずにブランチに変更をエクスポートする場合があります。 これは、[使用制限](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces)に達した場合や、codespace へのアクセスで一般的な問題が発生している場合に便利です。 -While using {% data variables.product.prodname_github_codespaces %}, you may want to export your changes to a branch without launching your codespace. This can be useful when you have hit a [spending limit](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces) or have a general issue accessing your codespace. +codespace が未公開 (テンプレートから作成して、{% data variables.product.product_name %} のリポジトリに関連付けられていない状態) の場合は、変更をブランチにエクスポートすることはできませんが、codespace を起動せずに codespace を新しいリポジトリに発行することはできます。 詳しくは、「[テンプレートから codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-from-githubcom)」をご覧ください。 -If your codespace is unpublished (created from a template and not associated with a repository on {% data variables.product.product_name %}), then you won't be able to export changes to a branch, but you can publish the codespace to a new repository without launching the codespace. For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-from-githubcom)." +変更をブランチにエクスポートするには、次の操作を行います。 -To export your changes to a branch: +{% data reusables.codespaces.your-codespaces-procedure-step %} または、個々のリポジトリでは、 **[{% octicon "code" aria-label="The code icon" %} コード]** メニューをクリックします。 +1. エクスポートする元の codespace の右側にある省略記号 ( **...** ) をクリックします。 +2. **[{% octicon "git-branch" aria-label="The git branch icon" %} ブランチへの変更のエクスポート]** を選択します。 -{% data reusables.codespaces.your-codespaces-procedure-step %} Or, for an individual repository, click the **{% octicon "code" aria-label="The code icon" %} Code** menu. -1. Click the ellipsis (**...**) to the right of the codespace you want to export from. -2. Select **{% octicon "git-branch" aria-label="The git branch icon" %} Export changes to branch**. + ![ブランチへの変更をエクスポートする](/assets/images/help/codespaces/export-changes-to-a-branch.png) - ![Export changes to a branch](/assets/images/help/codespaces/export-changes-to-a-branch.png) - -1. From the popover, select **Create branch**. +1. ポップオーバーから、 **[ブランチの作成]** を選択します。 diff --git a/translations/ja-JP/content/codespaces/troubleshooting/github-codespaces-logs.md b/translations/ja-JP/content/codespaces/troubleshooting/github-codespaces-logs.md index e5acb48518..531499aece 100644 --- a/translations/ja-JP/content/codespaces/troubleshooting/github-codespaces-logs.md +++ b/translations/ja-JP/content/codespaces/troubleshooting/github-codespaces-logs.md @@ -1,6 +1,6 @@ --- -title: GitHub Codespaces logs -intro: 'Overview of the logs used by {% data variables.product.prodname_github_codespaces %}.' +title: GitHub Codespaces ログ +intro: '{% data variables.product.prodname_github_codespaces %} で使用されるログの概要。' versions: fpt: '*' ghec: '*' @@ -11,50 +11,55 @@ topics: shortTitle: Codespaces logs redirect_from: - /codespaces/troubleshooting/codespaces-logs +ms.openlocfilehash: f5cd482888f58f85a051bb9b6e2c5d7c026ed9a9 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160102' --- - {% jetbrains %} {% data reusables.codespaces.codespaces-jetbrains-beta-note %} {% endjetbrains %} -Information on {% data variables.product.prodname_github_codespaces %} is output to various logs: +{% data variables.product.prodname_github_codespaces %} に関する情報は、さまざまなログに出力されます。 {% webui %} -- Codespace logs -- Creation logs -- Browser console logs (for the {% data variables.product.prodname_vscode_shortname %} web client) +- Codespace ログ +- 作成ログ +- ブラウザー コンソール ログ ({% data variables.product.prodname_vscode_shortname %} Web クライアント用) -Extension logs are available if you are using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode_shortname %}. Click the "{% data variables.product.prodname_vscode %}" tab above for details. +拡張機能ログは、{% data variables.product.prodname_vscode_shortname %} で {% data variables.product.prodname_github_codespaces %} を使用している場合に使用できます。 詳細については、上記の [{% data variables.product.prodname_vscode %}] タブをクリックしてください。 {% endwebui %} {% vscode %} -- Codespace logs -- Creation logs -- Extension logs (for the {% data variables.product.prodname_vscode_shortname %} desktop application) +- Codespace ログ +- 作成ログ +- 拡張機能ログ ({% data variables.product.prodname_vscode_shortname %} デスクトップ アプリケーション用) -Browser logs are available if you are using {% data variables.product.prodname_github_codespaces %} in your browser. Click the "Web browser" tab above for details. +ブラウザーのログは、ブラウザーで {% data variables.product.prodname_github_codespaces %} を使用している場合に使用できます。 詳細については、上記の [Web ブラウザー] タブをクリックしてください。 {% endvscode %} {% cli %} -- Codespace logs -- Creation logs +- Codespace ログ +- 作成ログ -Other logs are available if you are using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode_shortname %} or in your web browser. Click the tabs above for details. +他のログは、{% data variables.product.prodname_vscode_shortname %} または自分の Web ブラウザーで {% data variables.product.prodname_github_codespaces %} を使用している場合に使用できます。 詳細については、上のタブをクリックしてください。 {% endcli %} {% jetbrains %} -- Creation logs +- 作成ログ -Other logs are available if you are using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode_shortname %} or in your web browser. Click the tabs above for details. +他のログは、{% data variables.product.prodname_vscode_shortname %} または自分の Web ブラウザーで {% data variables.product.prodname_github_codespaces %} を使用している場合に使用できます。 詳細については、上のタブをクリックしてください。 {% endjetbrains %} @@ -62,10 +67,10 @@ Other logs are available if you are using {% data variables.product.prodname_git {% data reusables.codespaces.codespace-logs %} -1. If you are using {% data variables.product.prodname_github_codespaces %} in the browser, ensure that you are connected to the codespace you want to debug. -1. Open the {% data variables.product.prodname_vscode_command_palette_shortname %} (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)) and type **Export logs**. Select **Codespaces: Export Logs** from the list to download the logs. -1. Define where to save the zip archive of logs then click **Save** (desktop) or click **OK** (web). -1. If you are using {% data variables.product.prodname_github_codespaces %} in the browser, right-click on the zip archive of logs from the Explorer view and select **Download…** to download them to your local machine. +1. ブラウザーで {% data variables.product.prodname_github_codespaces %} を使用している場合は、デバッグするコード空間に接続されることを確認してください。 +1. {% data variables.product.prodname_vscode_command_palette_shortname %} を開き (Shift + Command + P (Mac) / Ctrl + Shift + P (Windows/Linux))、「**開発コンテナー**」と入力します。 **[Codespaces: ログのエクスポート]** を一覧から選択して、該当するログをダウンロードします。 +1. ログの zip アーカイブを保存する場所を定義し、 **[保存]** (デスクトップ) をクリックするか、 **[OK]** (Web) をクリックします。 +1. ブラウザーで {% data variables.product.prodname_github_codespaces %} を使用している場合は、エクスプローラー ビューからログの zip アーカイブを右クリックし、 **[ダウンロード]** を選択して、 それらを、ご利用のローカル コンピューターにダウンロードします。 {% endwebui %} @@ -73,8 +78,8 @@ Other logs are available if you are using {% data variables.product.prodname_git {% data reusables.codespaces.codespace-logs %} -1. Open the {% data variables.product.prodname_vscode_command_palette_shortname %} (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)) and type **Export logs**. Select **Codespaces: Export Logs** from the list to download the logs. -1. Define where to save the zip archive of logs then click **Save** (desktop) or click **OK** (web). +1. {% data variables.product.prodname_vscode_command_palette_shortname %} を開き (Shift + Command + P (Mac) / Ctrl + Shift + P (Windows/Linux))、「**開発コンテナー**」と入力します。 **[Codespaces: ログのエクスポート]** を一覧から選択して、該当するログをダウンロードします。 +1. ログの zip アーカイブを保存する場所を定義し、 **[保存]** (デスクトップ) をクリックするか、 **[OK]** (Web) をクリックします。 {% endvscode %} @@ -82,28 +87,28 @@ Other logs are available if you are using {% data variables.product.prodname_git {% data reusables.codespaces.codespace-logs %} -Currently you can't use {% data variables.product.prodname_cli %} to access these logs. To access them, open your codespace in {% data variables.product.prodname_vscode_shortname %} or in a browser. +現在、{% data variables.product.prodname_cli %} を使用してこれらのログにアクセスすることはできません。 それらにアクセスするには、{% data variables.product.prodname_vscode_shortname %} またはブラウザーでご利用の codespace を開きます。 {% endcli %} -## Creation logs +## 作成ログ -These logs contain information about the container, dev container, and their configuration. They are useful for debugging configuration and setup problems. +これらのログには、コンテナー、開発コンテナー、およびその構成に関する情報が含まれています。 これらは、構成とセットアップの問題のデバッグに役立ちます。 {% webui %} -1. Connect to the codespace you want to debug. -2. Open the {% data variables.product.prodname_vscode_command_palette_shortname %} (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)) and type **Creation logs**. Select **Codespaces: View Creation Log** from the list to open the `creation.log` file. +1. デバッグする codespace に接続します。 +2. {% data variables.product.prodname_vscode_command_palette_shortname %} を開き (Shift + Command + P (Mac) / Ctrl + Shift + P (Windows/Linux))、「**作成ログ**」と入力します。 一覧から **[Codespaces: 作成ログの表示]** を選択して、`creation.log` ファイルを開きます。 -If you want to share the log with support, you can copy the text from the creation log into a text editor and save the file locally. +サポートとログを共有する場合は、作成ログのテキストをテキスト エディターにコピーし、ファイルをローカルに保存できます。 {% endwebui %} {% vscode %} -Open the {% data variables.product.prodname_vscode_command_palette_shortname %} (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)) and type **Creation logs**. Select **Codespaces: View Creation Log** from the list to open the `creation.log` file. +{% data variables.product.prodname_vscode_command_palette_shortname %} を開き (Shift + Command + P (Mac) / Ctrl + Shift + P (Windows/Linux))、「**作成ログ**」と入力します。 一覧から **[Codespaces: 作成ログの表示]** を選択して、`creation.log` ファイルを開きます。 -If you want to share the log with support, you can copy the text from the creation log into a text editor and save the file locally. +サポートとログを共有する場合は、作成ログのテキストをテキスト エディターにコピーし、ファイルをローカルに保存できます。 {% endvscode %} @@ -111,15 +116,15 @@ If you want to share the log with support, you can copy the text from the creati {% data reusables.cli.cli-learn-more %} -To see the creation log use the `gh codespace logs` subcommand. After entering the command choose from the list of codespaces that's displayed. +作成ログを表示するには、`gh codespace logs` サブコマンドを使用します。 コマンドを入力した後、表示される codespace の一覧から選択します。 ```shell gh codespace logs ``` -For more information about this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_logs). +このコマンドの詳細については、[{% data variables.product.prodname_cli %} に関するマニュアル](https://cli.github.com/manual/gh_codespace_logs)を参照してください。 -If you want to share the log with support, you can save the output to a file: +ログをサポートと共有したい場合は、出力をファイルに保存できます。 ```shell gh codespace logs -c > /path/to/logs.txt @@ -129,44 +134,44 @@ gh codespace logs -c > /path/to/logs.txt {% vscode %} -## Extension logs +## 拡張機能ログ -These logs are available for {% data variables.product.prodname_vscode_shortname %} desktop users only. They are useful if it seems like the {% data variables.product.prodname_github_codespaces %} extension or {% data variables.product.prodname_vscode_shortname %} editor are having issues that prevent creation or connection. +これらのログは、{% data variables.product.prodname_vscode_shortname %} デスクトップ ユーザーにのみ使用できます。 それらは、{% data variables.product.prodname_github_codespaces %} 拡張機能または {% data variables.product.prodname_vscode_shortname %} エディターに作成または接続を妨げる問題があるように思われる場合に役立ちます。 -1. In {% data variables.product.prodname_vscode_shortname %}, open the Command Palette. -1. Type **Logs** and select **Developer: Open Extension Logs Folder** from the list to open the extension log folder in your system's file explorer. +1. {% data variables.product.prodname_vscode_shortname %} で、コマンド パレットを開きます。 +1. 「**ログ**」と入力し、一覧から **[開発者: 拡張機能ログ フォルダーを開く]** を選択して、ご利用のシステムのファイル エクスプローラーで拡張機能ログ フォルダーを開きます。 -From this view, you can access logs generated by the various extensions that you use in {% data variables.product.prodname_vscode_shortname %}. You will see logs for {% data variables.product.prodname_github_codespaces %}, {% data variables.product.prodname_dotcom %} Authentication, and Git, in addition to any other extensions you have enabled. +このビューからは、{% data variables.product.prodname_vscode_shortname %} で使用しているさまざまな拡張機能によって生成されたログにアクセスできます。 有効にした他の拡張機能に加えて、{% data variables.product.prodname_github_codespaces %}、{% data variables.product.prodname_dotcom %} 認証、Git のログが表示されます。 {% endvscode %} {% webui %} -## Browser console logs +## ブラウザー コンソールのログ -These logs are useful only if you want to debug problems with using {% data variables.product.prodname_github_codespaces %} in the browser. They are useful for debugging problems creating and connecting to {% data variables.product.prodname_github_codespaces %}. +これらのログは、ブラウザーで {% data variables.product.prodname_github_codespaces %} を使用する際の問題をデバッグする場合にのみ役立ちます。 これらは、{% data variables.product.prodname_github_codespaces %} の作成と接続に関する問題のデバッグに役立ちます。 -1. In the browser window for the codespace you want to debug, open the developer tools window. -1. Display the "Console" tab and click **errors** in the left sidebar to show only the errors. -1. In the log area on the right, right-click and select **Save as** to save a copy of the errors to your local machine. - ![Save errors](/assets/images/help/codespaces/browser-console-log-save.png) +1. デバッグする codespace のブラウザー ウィンドウで、開発者ツール ウィンドウを開きます。 +1. [コンソール] タブを表示し、左側のサイドバーで **[エラー]** をクリックすると、エラーのみが表示されます。 +1. 右側のログ領域で右クリックし、 **[名前を付けて保存]** を選択して、エラーのコピーをローカル コンピューターに保存します。 + ![エラーの保存](/assets/images/help/codespaces/browser-console-log-save.png) {% endwebui %} {% jetbrains %} {% data reusables.codespaces.jetbrains-open-codespace-plugin %} -1. In the {% data variables.product.prodname_github_codespaces %} tool window, click the log icon. +1. {% data variables.product.prodname_github_codespaces %} ツール ウィンドウで、ログ アイコンをクリックします。 - ![Screenshot of the log button](/assets/images/help/codespaces/jetbrains-plugin-icon-log.png) + ![ログ ボタンのスクリーンショット](/assets/images/help/codespaces/jetbrains-plugin-icon-log.png) -## JetBrains logs +## JetBrains ログ -You can download logs for the remote JetBrains IDE and the local client application by going to the **Help** menu in the JetBrains client application and clicking **Collect Host and Client Logs**. +リモート JetBrains IDE とローカル クライアント アプリケーションのログをダウンロードするには、JetBrains クライアント アプリケーションの **[ヘルプ]** メニューに移動し、 **[ホストとクライアント ログの収集]** をクリックします。 {% endjetbrains %} -## Further reading +## 参考資料 -- "[Reviewing your organization's audit logs for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)" -- "[Reviewing your security logs for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)" \ No newline at end of file +- 「[Organization の {% data variables.product.prodname_github_codespaces %} の Audit log を確認する](/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)」 +- 「[{% data variables.product.prodname_github_codespaces %} のセキュリティログをレビューする](/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)」 diff --git a/translations/ja-JP/content/codespaces/troubleshooting/index.md b/translations/ja-JP/content/codespaces/troubleshooting/index.md index cabc8b2247..6b0bce1279 100644 --- a/translations/ja-JP/content/codespaces/troubleshooting/index.md +++ b/translations/ja-JP/content/codespaces/troubleshooting/index.md @@ -1,7 +1,7 @@ --- -title: Troubleshooting GitHub Codespaces +title: GitHub Codespaces のトラブルシューティング shortTitle: Troubleshooting -intro: 'These guides provide information for troubleshooting {% data variables.product.prodname_github_codespaces %}' +intro: 'これらのガイドでは、{% data variables.product.prodname_github_codespaces %} のトラブルシューティングに関する情報を提供します' versions: fpt: '*' ghec: '*' @@ -21,5 +21,11 @@ children: - /troubleshooting-github-codespaces-clients - /troubleshooting-gpg-verification-for-github-codespaces - /working-with-support-for-github-codespaces +ms.openlocfilehash: 8704695a9ae39750bcc94229a62bb7eabcc6cdbe +ms.sourcegitcommit: 47e03737d09bed84dfedb7be5924d893d34ea1a8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167094' --- diff --git a/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md b/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md index e9c7c4560c..ecc2be1919 100644 --- a/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md +++ b/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md @@ -1,6 +1,6 @@ --- -title: Troubleshooting creation and deletion of codespaces -intro: 'This article provides troubleshooting steps for common issues you may experience when creating or deleting a codespace, including storage and configuration issues.' +title: codespace の作成と削除のトラブルシューティング +intro: この記事では、ストレージや構成の issue など、codespace の作成または削除時に発生する可能性のある一般的な issue に対するトラブルシューティング手順について説明します。 versions: fpt: '*' ghec: '*' @@ -8,89 +8,94 @@ type: reference topics: - Codespaces shortTitle: Creation and deletion +ms.openlocfilehash: 09c3a73ec5e41f0170f1d3cd66df139bb2a497e5 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158694' --- +## codespace を作成する -## Creating codespaces +### codespace を作成するアクセス権がない +{% data variables.product.prodname_github_codespaces %} は、すべてのリポジトリで利用できるわけではありません。 codespace を作成するためのオプションが表示されない場合は、そのリポジトリで {% data variables.product.prodname_github_codespaces %} を使用できない可能性があります。 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#access-to-codespaces)」を参照してください。 -### No access to create a codespace -{% data variables.product.prodname_github_codespaces %} is not available for all repositories. If the options for creating a codespace are not displayed, {% data variables.product.prodname_github_codespaces %} may not be available for that repository. For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#access-to-codespaces)." +個人アカウントに {% data variables.product.prodname_github_codespaces %} の毎月の使用料が残っている場合、または支払い方法と使用制限を設定している場合は、パブリック リポジトリの codespaces を作成できます。 ただし、リポジトリに変更をプッシュできる場合、またはリポジトリをフォークできる場合にのみ、プライベート リポジトリの codespace を作成できます。 -Provided you have remaining monthly included usage of {% data variables.product.prodname_github_codespaces %} on your personal account, or you have set up a payment method and a spending limit, you will be able to create codespaces for public repositories. However, you can only create a codespace for a private repository if you can push changes to the repository, or you can fork the repository. +個人アカウントに含まれる使用量と使用制限の設定について詳しくは、「[{% data variables.product.prodname_github_codespaces %} の請求について](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」および「[{% data variables.product.prodname_github_codespaces %} の使用制限の管理](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)」を参照してください。 -For more information about included usage for personal accounts, and setting a spending limit, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)" and "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." +### 作成時に codespace が開かない -### Codespace does not open when created +codespace を作成しても開かない場合: -If you create a codespace and it does not open: +1. キャッシュまたはレポートの問題が発生した場合は、ページを再度読み込んでみてください。 +2. {% data variables.product.prodname_github_codespaces %} ページ (https://github.com/codespaces ) に移動し、そこに新しい codespace が一覧表示されているかどうかを確認します。 このプロセスで、codespace が正常に作成されたが、ブラウザーに報告できなかった可能性があります。 新しい codespace が一覧表示されている場合は、そのページから直接開くことができます。 +3. 一時的な通信エラーを除外するように、リポジトリの codespace の作成を再試行します。 -1. Try reloading the page in case there was a caching or reporting problem. -2. Go to your {% data variables.product.prodname_github_codespaces %} page: https://github.com/codespaces and check whether the new codespace is listed there. The process may have successfully created the codespace but failed to report back to your browser. If the new codespace is listed, you can open it directly from that page. -3. Retry creating the codespace for the repository to rule out a transient communication failure. +{% data variables.product.prodname_github_codespaces %} を使用できるリポジトリの codespace をまだ作成できない場合は、{% data reusables.codespaces.contact-support %} -If you still cannot create a codespace for a repository where {% data variables.product.prodname_github_codespaces %} is available, {% data reusables.codespaces.contact-support %} +### codespace の作成に失敗する -### Codespace creation fails - -If the creation of a codespace fails, it's likely to be due to a temporary infrastructure issue in the cloud - for example, a problem provisioning a virtual machine for the codespace. A less common reason for failure is if it takes longer than an hour to build the container. In this case, the build is cancelled and codespace creation will fail. +codespace の作成に失敗する場合は、クラウドの一時的なインフラストラクチャの問題 (codespace の仮想マシンのプロビジョニングに関する問題など) が原因の可能性があります。 あまり一般的ではない失敗の理由は、コンテナーのビルドに 1 時間以上かかる場合です。 この場合、ビルドは取り消され、codespace の作成は失敗します。 {% note %} -**Note:** A codespace that was not successfully created is never going to be usable and should be deleted. For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)." +**注:** 正常に作成されなかった codespace は使用できなくなり、削除する必要があります。 詳細については、「[codespace の削除](/codespaces/developing-in-codespaces/deleting-a-codespace)」を参照してください。 {% endnote %} -If you create a codespace and the creation fails: +codespace を作成し、作成に失敗した場合: -1. Check {% data variables.product.prodname_dotcom %}'s [Status page](https://githubstatus.com) for any active incidents. -1. Go to [your {% data variables.product.prodname_github_codespaces %} page](https://github.com/codespaces), delete the codespace, and create a new codespace. -1. If the container is building, look at the logs that are streaming and make sure the build is not stuck. A container build that takes longer than one hour will be canceled, resulting in a failed creation. +1. {% data variables.product.prodname_dotcom %} の [[状態] ページ](https://githubstatus.com) でアクティブなインシデントがないか確認します。 +1. [{% data variables.product.prodname_github_codespaces %} ページ](https://github.com/codespaces)に移動し、codespace を削除して、新しい codespace を作成します。 +1. コンテナーがビルドされている場合は、ストリーミング中のログを確認し、ビルドがスタックしていないことを確認します。 1 時間以上かかるコンテナー ビルドは取り消され、作成が失敗します。 - One common scenario where this could happen is if you have a script running that is prompting for user input and waiting for an answer. If this is the case, remove the interactive prompt so that the build can complete non-interactively. + これが発生する可能性がある一般的なシナリオの 1 つは、ユーザー入力のダイアログが表示され、回答を待つスクリプトが実行されている場合です。 この場合は、対話型プロンプトを削除して、ビルドを非対話型で完了できるようにします。 {% note %} - **Note**: To view the logs during a build: - * In the browser, click **View logs.** + **注**: ビルド中にログを表示するには: + * ブラウザーで、 **[ログの表示]** をクリックします。 - ![Screenshot of the Codespaces web UI with the View logs link emphasized](/assets/images/help/codespaces/web-ui-view-logs.png) + ![[ログの表示] リンクが強調された Codespaces Web UI のスクリーンショット](/assets/images/help/codespaces/web-ui-view-logs.png) - * In the VS Code desktop application, click **Building codespace** in the "Setting up remote connection" that's displayed. + * VS Code デスクトップ アプリケーションで、表示されている "リモート接続のセットアップ" の **[codespace のビルド]** をクリックします。 - ![Screenshot of VS Code with the Building codespace link emphasized](/assets/images/help/codespaces/vs-code-building-codespace.png) + ![[codespace のビルド] リンクが強調された VS Code のスクリーンショット](/assets/images/help/codespaces/vs-code-building-codespace.png) {% endnote %} -2. If you have a container that takes a long time to build, consider using prebuilds to speed up codespace creations. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)." +2. ビルドに時間がかかるコンテナーがある場合は、プレビルドを使用して codespace の作成を速めることを検討してください。 詳しくは、「[事前ビルドを構成する](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)」をご覧ください。 -## Deleting codespaces +## codespace を削除する -A codespace can only be deleted by: -* The person who created the codespace. -* An organization owner for an organization-owned codespace. -* Automatic deletion at the end of a retention period. +codespace は、次の方法でのみ削除できます。 +* codespace を作成したユーザー。 +* Organization 所有の codespace の Organization 所有者。 +* 保持期間の終了時の自動的な削除。 -For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)" and "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)." +詳しくは、「[codespace の削除](/codespaces/developing-in-codespaces/deleting-a-codespace)」と「[codespace の自動削除を構成する](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)」をご覧ください。 -## Container storage +## コンテナー ストレージ -When you create a codespace, it has a finite amount of storage and over time it may be necessary for you to free up space. Try running any of the following commands in the {% data variables.product.prodname_github_codespaces %} terminal to free up storage space. +codespace を作成すると、ストレージ容量に限りがあるため、時間の経過とともにスペースを解放する必要がある場合があります。 {% data variables.product.prodname_github_codespaces %} ターミナルで次のコマンドのいずれかを実行してみて、ストレージ スペースを解放します。 -- Remove packages that are no longer used by using `sudo apt autoremove`. -- Clean the apt cache by using `sudo apt clean`. -- See the top 10 largest files in the codespace with`sudo find / -printf '%s %p\n'| sort -nr | head -10`. -- Delete unneeded files, such as build artifacts and logs. +- `sudo apt autoremove` を使用して、使用されなくなったパッケージを削除します。 +- `sudo apt clean` を使用して apt キャッシュをクリーンアップします。 +- `sudo find / -printf '%s %p\n'| sort -nr | head -10` で、codespace 内でサイズが上位 10 個のファイルを参照します。 +- ビルド成果物やログなど、不要なファイルを削除します。 -Some more destructive options: +より破壊的なオプション: -- Remove unused Docker images, networks, and containers by using `docker system prune` (append `-a` if you want to remove all images, and `--volumes` if you want to remove all volumes). -- Remove untracked files from working tree: `git clean -i`. +- `docker system prune` を使用して (すべての画像を削除する場合は `-a` を、すべてのボリュームを削除する場合は `--volumes` を付加します)、未使用の Docker イメージ、ネットワーク、コンテナーを削除します。 +- 追跡されていないファイルを作業ツリーから削除します: `git clean -i`。 -## Configuration +## 構成 {% data reusables.codespaces.recovery-mode %} ``` This codespace is currently running in recovery mode due to a container error. ``` -Review the creation logs and update the dev container configuration as needed. For more information, see "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)." +作成ログを確認し、必要に応じて開発コンテナーの構成を更新します。 詳しい情報については、「[{% data variables.product.prodname_github_codespaces %} のログ](/codespaces/troubleshooting/github-codespaces-logs)」を参照してください。 -You can then try restarting the codespace, or rebuilding the container. For more information, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)." +その後、codespace を再起動するか、コンテナーをリビルドしてみてください。 詳細については、[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)に関するページをご覧ください。 diff --git a/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md b/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md new file mode 100644 index 0000000000..a8f6c2b9ac --- /dev/null +++ b/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md @@ -0,0 +1,117 @@ +--- +title: GitHub Codespaces の GPG 検証のトラブルシューティング +shortTitle: GPG verification +intro: この記事では、codespace でのコミットの署名に関連するエラーのトラブルシューティングに関するアドバイスを提供します。 +versions: + fpt: '*' + ghec: '*' +type: reference +topics: + - Codespaces +ms.openlocfilehash: f3a6537d1ee9087803054347689591c2b217e42e +ms.sourcegitcommit: 47e03737d09bed84dfedb7be5924d893d34ea1a8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/16/2022 +ms.locfileid: '148167118' +--- +GPG 検証を有効にすると、{% data variables.product.prodname_github_codespaces %} は、選んだリポジトリから作成した codespace でコミットに自動的に署名します。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の GPG 検証を管理する](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)」を参照してください。 + +{% data reusables.codespaces.gpg-in-active-codespaces %} + +{% data variables.product.prodname_github_codespaces %} でコミットに署名できない場合は、次のようなエラーが表示されることがあります。 + +```Shell +$ git commit -m 'Initial commit' +error: gpg failed to sign the data +fatal: failed to write commit object +``` + +このエラーは次の場合に発生することがあります。 + +- GPG 検証を無効にし、既存の codespace で通常の署名なしのコミットを行おうとしている。 +- GPG 検証を有効にしたが、{% data variables.product.prodname_github_codespaces %} がコミットに署名するために必要な Git 構成を、{% data variables.product.prodname_github_codespaces %} を Git 構成ファイルを含むドットファイル リポジトリにリンクするなどしてオーバーライドしている。 + +## GPG 検証を無効にした後のエラー + +GPG 検証を有効にすると、{% data variables.product.prodname_github_codespaces %} は、codespace で行ったすべてのコミットに既定で署名します。 これは、`commit.gpgsign` Git 構成値を `true` に設定することによって行われます。 + +GPG 検証を無効にしていて、既存の codespace で作業している場合、この値は引き続き `true` に設定されます。 つまり、{% data variables.product.prodname_github_codespaces %} はコミットに署名しようとしますが、GPG 検証設定を無効にしているため、それができません。 + +codespace で通常の署名なしのコミットを続ける場合は、ターミナルで次のコマンドを入力して、`commit.gpgsign` を `false` の既定値にリセットします。 + +```Shell{:copy} +git config --unset commit.gpgsign +``` + +値が構成から正しく削除されたことを確認するには、「`git config --list`」と入力します。 `commit.gpgsign` の値は一覧に表示されないはずです。 + +## 構成の競合によって発生するエラー + +コミットに自動的に署名するために、{% data variables.product.prodname_github_codespaces %} は codespace に特定の Git 構成値を設定します。 {% data variables.product.prodname_github_codespaces %} によって設定された値をオーバーライドすると、コミットに署名できない可能性があります。 + +{% data variables.product.prodname_github_codespaces %} を Git 構成ファイルを含むドットファイル リポジトリにリンクしている場合、これらの値を誤ってオーバーライドしている可能性があります。 {% data variables.product.prodname_github_codespaces %} でドットファイルを使用する方法について詳しくは、「[アカウントの {% data variables.product.prodname_github_codespaces %} のカスタマイズ](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#dotfiles)」を参照してください。 + +### 構成の競合の確認 + +GPG でコミットに署名するために、{% data variables.product.prodname_github_codespaces %} はシステム レベルで次の Git 構成値を自動的に設定します。 + +| 構成設定 | 必須値 | +| --------------------- | -------------- | +| `user.name` | {% data variables.product.prodname_dotcom %} プロファイルに設定されているフル ネームと一致する必要があります | +| `credential.helper` | `/.codespaces/bin/gitcredential_github.sh` に設定されている必要があります。 | +| `gpg.program` | `/.codespaces/bin/gh-gpgsign` に設定されている必要があります。 | + +これらの値が codespace で正しく設定されていることを確認するには、`git config --list --show-origin` コマンドを使用します。 {% data variables.product.prodname_github_codespaces %} はシステム レベルでこの構成を設定するため、必要な構成設定は `/usr/local/etc/gitconfig` から行う必要があります。 + +```Shell +$ git config --list --show-origin +file:/usr/local/etc/gitconfig credential.helper=/.codespaces/bin/gitcredential_github.sh +file:/usr/local/etc/gitconfig user.name=Mona Lisa +file:/usr/local/etc/gitconfig gpg.program=/.codespaces/bin/gh-gpgsign +``` + +上記の値に加えて、codespace で使用されているドットファイルに次のいずれかの値が含まれていると、エラーが発生する可能性があります。 + +- `user.signingkey` の Git 構成値 +- `commit.gpgsign` の Git 構成値 +- 手動で設定された `GITHUB_TOKEN` + +### 構成の競合の削除 + +{% data variables.product.prodname_github_codespaces %} の自動 GPG 検証を有効にしたままにするには、codespace で使用されているドットファイルから競合する構成を削除する必要があります。 + +たとえば、ローカル コンピューター上のグローバル `.gitconfig` ファイルに `gpg.program` の値が含まれており、このファイルを {% data variables.product.prodname_github_codespaces %} にリンクされているドットファイル リポジトリにプッシュした場合、代わりにこのファイルから `gpg.program` を削除し、ローカル コンピューターのシステム レベルで設定することができます。 + +{% note %} + +**メモ:** ドットファイル リポジトリに対する変更は、作成した新しい codespace には適用されますが、既存の codespace には適用されません。 + +{% endnote %} + +1. ローカル コンピューターでターミナルを開きます。 +2. 競合する値を `~/.gitconfig` (Mac/Linux) または `C:\Users\YOUR-USER\.gitconfig` (Windows) から削除するには、`git config --global --unset` コマンドを使用します。 + + ```Shell + $ git config --global --unset gpg.program + ``` +3. 変更を {% data variables.product.prodname_dotcom %} のドットファイル リポジトリにプッシュします。 +4. 必要に応じて、ローカル構成を保持するには、ドットファイル リポジトリにプッシュしない Git 構成ファイルで値をもう一度設定します。 + + たとえば、`--system` フラグを使用して、`PATH/etc/gitconfig` のシステム レベル ファイルで構成を設定でます。ここで、`PATH` は Git がシステムにインストールされているディレクトリです。 + + ```Shell + $ git config --system gpg.program gpg2 + ``` + +または、ドットファイル リポジトリに `install.sh` などの認識されたファイルのインストール スクリプトが含まれている場合は、`$CODESPACES` 環境変数を使用して、codespace にいない場合にのみ `gpg.program` を設定するなどの条件付きロジックを追加できます。 次の例では、codespace にいない場合、`-z "$CODESPACES"` が `true` を返します。 + +```Shell{:copy} +if [ -z "$CODESPACES" ]; then + git config --global gpg.program gpg2 +fi +``` + +## 参考資料 +- 「[コミット署名の検証について](/authentication/managing-commit-signature-verification/about-commit-signature-verification)」 +- Git の公式ドキュメントの [`git config`](https://git-scm.com/docs/git-config) diff --git a/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md b/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md index 2264e6432e..0741acc054 100644 --- a/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md +++ b/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Troubleshooting port forwarding for GitHub Codespaces -intro: Troubleshooting steps for common port forwarding issues. +title: GitHub Codespaces のポート フォワーディングのトラブルシューティング +intro: ポートの転送に関する一般的な問題のトラブルシューティング手順。 versions: fpt: '*' ghec: '*' @@ -10,17 +10,22 @@ topics: shortTitle: Port forwarding redirect_from: - /codespaces/troubleshooting/troubleshooting-port-forwarding-for-codespaces +ms.openlocfilehash: 828150ca05c18cb1106f5a3c883331785b6bce2e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159150' --- +Codespace 内で実行されているアプリケーションによってポートがコンソールに出力されると、{% data variables.product.prodname_github_codespaces %} によってローカルホスト URL パターンが検出され、ポートが自動的に転送されます。 詳細については、「[codespace でのポートの転送](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)」を参照してください。 -When an application running inside a codespace outputs a port to the console, {% data variables.product.prodname_github_codespaces %} detects the localhost URL pattern and automatically forwards the port. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." +ポートが自動的に転送されない場合は、手動で転送できます。 詳細については、「[ポートの転送](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace#forwarding-a-port)」を参照してください。 -If a port is not automatically forwarded, you can forward it manually. For more information, see "[Forwarding a port](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace#forwarding-a-port)." +ポート フォワーディングが設定されている場合は、次を確認してください。 -If port forwarding is set up, check the following: +- {% data variables.product.prodname_vscode_shortname %} の右下隅にポップアップ表示される通知 "トースト" メッセージのリンクを使うか、ターミナルの URL をクリックして転送されたポートを開きます。 ブラウザー経由で codespace に接続している場合、ローカル マシンに「`localhost:8000`」 (例) と入力しても、動作しません。 +- アプリケーションが codespace 内から引き続き実行されていることを確認してください。 一定期間にわたって非アクティブになった後で codespace が停止した場合は、codespace が再起動したら、必ずアプリケーションを再起動する必要があります。 -- Use the link in the notification "toast" message, that pops up in the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, or click the URL in Terminal, to open the forwarded port. Typing in `localhost:8000` (as an example) to your local machine will not work if you're connected to the codespace via the browser. -- Make sure to check that your application is still running from within your codespace. If your codespace has stopped after a period of inactivity, you'll need to ensure to restart your application once the codespace has restarted. - -Typically, you can make a forwarded port accessible publicly, or within the organization that owns a repository. For more information, see "[Forwarding ports in your codespace](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)." If either, or both, of the options for public or organization visibility are not available, this indicates that an organization-level policy has been configured. For more information, see "[Restricting the visibility of forwarded ports](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)." +通常は、転送されたポートをパブリックに、またはリポジトリを所有する組織内でアクセスできるようにします。 詳細については、「[codespace でのポートの転送](/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace)」を参照してください。 パブリックと組織のオプションのいずれか、または両方での可視性を実現できない場合、これは、組織レベルのポリシーが構成されていることを示しています。 詳細については、「[転送されたポートの可視性の制限](/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)」を参照してください。 {% data reusables.codespaces.forwarded-ports-environment-variable %} diff --git a/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md b/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md index c403cf9f6c..18171b1457 100644 --- a/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md +++ b/translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Troubleshooting your connection to GitHub Codespaces -intro: 'Troubleshooting help for connecting to {% data variables.product.prodname_github_codespaces %}.' +title: GitHub Codespaces に接続できない問題を解決する +intro: '{% data variables.product.prodname_github_codespaces %} への接続に関するトラブルシューティングのヘルプ。' versions: fpt: '*' ghec: '*' @@ -10,49 +10,54 @@ topics: shortTitle: Connection redirect_from: - /codespaces/troubleshooting/troubleshooting-your-connection-to-codespaces +ms.openlocfilehash: 75632e73b689ed7fe1df95027f6e5170136c7935 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160071' --- +## 503 codespace サービスを使用できない -## 503 codespace service unavailable +codespace は、30 分間アクティビティがないと停止するように設定されています。 停止した後で codespace を操作しようとすると、`503 service unavailable` エラーが表示されることがあります。 -Codespaces are set to stop after 30 minutes without any activity. If you try to interact with a codespace after it has stopped, you may see a `503 service unavailable` error. +- **[開始]** ボタンが {% data variables.product.prodname_vscode %} またはブラウザー ウィンドウに表示されている場合は、 **[開始]** をクリックして codespace に再接続します。 +- ウィンドウを再度読み込んで、codespace をリセットします。 {% data variables.product.prodname_vscode %} の [コマンド パレット](/codespaces/codespaces-reference/using-the-command-palette-in-codespaces#accessing-the-command-palette)で、 **[開発者: ウィンドウの再読み込み]** をクリックします。 -- If a **Start** button is shown in {% data variables.product.prodname_vscode %} or in your browser window, click **Start** to reconnect to the codespace. -- Reset your codespace by reloading the window. From the [Command Palette](/codespaces/codespaces-reference/using-the-command-palette-in-codespaces#accessing-the-command-palette) in {% data variables.product.prodname_vscode %}, click **Developer: Reload Window**. +## ブラウザーが接続できない -## Browser cannot connect +ブラウザーから codespace にアクセスできないことがあります。 その場合は、 https://github.com/codespaces にアクセスし、そのページから codespace に接続してみてください。 -Sometimes you may not be able to access a codespace from your browser. If this happens, go to https://github.com/codespaces and try connecting to the codespace from that page. + - そのページに codespace が表示されない場合は、自分が接続しようとしている codespace の所有者であることを確認します。 開くことができるのは、自分で作成した codespace だけです。 codespace の URL には、常に {% data variables.product.company_short %} のハンドルが含まれます。 + - codespace は表示されるのに、そのページから接続できない場合は、別のブラウザーを使って接続できるかどうかを調べます。 - - If the codespace is not listed on that page, check that you are the owner of the codespace you are trying to connect to. You can only open a codespace that you created. The URLs for your codespaces always include your {% data variables.product.company_short %} handle. - - If the codespace is listed but you cannot connect from that page, check whether you can connect using a different browser. +会社のネットワークが接続をブロックしている可能性があります。 可能であれば、デバイスで拒否された接続をログで確認します。 -Your company network may be blocking the connection. If possible, check any logging for rejected connections on your device. +それでも接続できない場合は、{% data reusables.codespaces.contact-support %} -If you still cannot connect, {% data reusables.codespaces.contact-support %} +## JupyterLab で codespace に接続できない -## Unable to connect to your codespace in JupyterLab +JupyterLab で codespace を使用できるようにするには、codespace にそれがインストールされていることを確認する必要があります。 {% data variables.product.prodname_github_codespaces %} で使用される既定のコンテナー イメージには JupyterLab が含まれていますが、開発コンテナー構成をカスタマイズした場合は、JupyterLab を手動でインストールする必要があります。 -To be able to use a codespace in JupyterLab, you must ensure that your codespace has it installed. The default container image that's used by {% data variables.product.prodname_github_codespaces %} includes JupyterLab, but if you have customized your dev container configuration you will have to manually install JupyterLab. +codespace で Debian ベースのイメージが使用されている場合は、`installJupyterlab` オプションを `true` に設定して `python` 機能を `devcontainer.json` ファイルに追加することで、開発コンテナーに JupyterLab をインストールできます。 それ以外の場合は、Dockerfile に直接インストールします。 インストール手順については、JupyterLab ドキュメントの「[インストール](https://jupyterlab.readthedocs.io/en/stable/getting_started/installation.html)」を参照してください。 -If your codespace uses a Debian-based image, you can install JupyterLab in the dev container by adding the `python` feature to your `devcontainer.json` file, with the `installJupyterlab` option set to `true`. Otherwise, install it directly in your Dockerfile. For installation instructions, see "[Installation](https://jupyterlab.readthedocs.io/en/stable/getting_started/installation.html)" in the JupyterLab documentation. +`python` 機能の詳細については、[`devcontainers/features` リポジトリ](https://github.com/devcontainers/features/tree/main/src/python)の README ページを参照してください。 `devcontainer.json` ファイルと Dockerfile の詳細については、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)」をご覧ください。 -For more information about the `python` feature, see the README page in the [`devcontainers/features` repository](https://github.com/devcontainers/features/tree/main/src/python). For more information about the `devcontainer.json` file and the Dockerfile, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)." +それでも接続できない場合は、{% data reusables.codespaces.contact-support %} -If you still cannot connect, {% data reusables.codespaces.contact-support %} +## {% data variables.product.prodname_vscode %} 用の {% data variables.product.prodname_github_codespaces %} 拡張機能が接続できない -## {% data variables.product.prodname_github_codespaces %} extension for {% data variables.product.prodname_vscode %} cannot connect +{% data variables.product.prodname_vscode %} デスクトップから codespace に接続できない場合は、次のトラブルシューティング手順を使います。 -If you cannot connect to a codespace from {% data variables.product.prodname_vscode %} desktop, use the following troubleshooting steps. +1. インストールされている {% data variables.product.prodname_github_codespaces %} 拡張機能が最新バージョンであることを確認します。 拡張機能はプレビュー リリースであり、頻繁に更新プログラムがリリースされます。 + 1. {% data variables.product.prodname_vscode %} で、[拡張機能] タブを表示します。 + 2. {% data variables.product.prodname_github_codespaces %} 拡張機能を選択して、拡張機能の概要ページを表示します。 + 3. 更新プログラムが利用可能な場合は、ボタンが表示されたら、 **[X.X.X に更新する]** をクリックして最新バージョンにアップグレードします。 +2. {% data variables.product.prodname_vscode %} の安定したビルドまたは [{% data variables.product.prodname_vscode %} Insiders](https://code.visualstudio.com/insiders/) リリース (夜間更新) のどちらを使用しているかを確認します。 Insiders リリースを使っている場合は、[安定したビルド](https://code.visualstudio.com/)をインストールしてみます。 +3. 会社のネットワークが接続をブロックしている可能性があります。 可能であれば、デバイスで拒否された接続をログで確認します。 -1. Check that you have the latest version of the {% data variables.product.prodname_github_codespaces %} extension installed. The extension is a preview release and frequent updates are released. - 1. In {% data variables.product.prodname_vscode %}, display the "Extensions" tab. - 2. Select the {% data variables.product.prodname_github_codespaces %} extension to display the extension's overview page. - 3. If an update is available, a button is shown, click **Update to X.X.X** to upgrade to the latest version. -2. Check whether you are using the stable build of {% data variables.product.prodname_vscode %} or the [{% data variables.product.prodname_vscode %} Insiders](https://code.visualstudio.com/insiders/) release (nightly updates). If you are using the insiders release, try installing the [stable build](https://code.visualstudio.com/). -3. Your company network may be blocking the connection. If possible, check any logging for rejected connections on your device. +それでも接続できない場合は、{% data reusables.codespaces.contact-support %} -If you still cannot connect, {% data reusables.codespaces.contact-support %} +### codespace に待ち時間の問題がある -### The codespace has latency issues - -If the codespace seems particularly slow or has latency issues, it is possible that it has been created in a region that is far from you. To resolve this, you can [manually set your {% data variables.product.prodname_github_codespaces %} region](/codespaces/managing-your-codespaces/setting-your-default-region-for-codespaces). +codespace が特に遅いと思われる場合、または待ち時間の問題がある場合は、遠いリージョンに作成されている可能性があります。 これを解決するには、[{% data variables.product.prodname_github_codespaces %} のリージョンを手動で設定する](/codespaces/managing-your-codespaces/setting-your-default-region-for-codespaces)ことができます。 diff --git a/translations/ja-JP/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md b/translations/ja-JP/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md index c75eb6ab59..f86da8b858 100644 --- a/translations/ja-JP/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md +++ b/translations/ja-JP/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md @@ -1,6 +1,6 @@ --- -title: Working with support for GitHub Codespaces -intro: 'Tips on getting the best help from support for {% data variables.product.prodname_github_codespaces %}.' +title: GitHub Codespaces のサポートを使用する +intro: '{% data variables.product.prodname_github_codespaces %} のサポートから最適なヘルプを得るためのヒント。' versions: fpt: '*' ghec: '*' @@ -10,29 +10,34 @@ topics: shortTitle: Working with support redirect_from: - /codespaces/troubleshooting/working-with-support-for-codespaces +ms.openlocfilehash: a4db589cb5d8de71e6e8c7d109e0156885c33848 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159896' --- +codespace に関する問題が発生したときにサポートが支援できるように、codespace の永続的な名前とその codespace ID (識別子) を把握しておく必要があります。 さらに、サポートによって、一部のログを共有するように求められる場合があります。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} ログ](/codespaces/troubleshooting/github-codespaces-logs)」と「[GitHub サポートについて](/github/working-with-github-support/about-github-support)」をご覧ください。 -Before support can help you with problems with codespaces, you need to know the permanent name of the codespace and its codespaces ID (identifier). In addition, support may ask you to share some logs with them. For more information, see "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)" and "[About GitHub Support](/github/working-with-github-support/about-github-support)." +## codespace 名 -## Codespace names +各 codespace には、{% data variables.product.company_short %} ハンドル、自動的に生成された 2 つか 3 つの単語、およびいくつかのランダムな文字を組み合わせた一意の名前が付けられています。 (例: `octocat-literate-space-parakeet-mld5`)。 また、そのような自動的に生成された 2 つか 3 つの単語によって、codespace の最初の表示名も形成されます (この場合は、`literate-space-parakeet`)。 codespace の表示名は変更できますが、永続的な名前はこれの影響を受けません。 詳しくは、「[codespace の名前を変更する](/codespaces/customizing-your-codespace/renaming-a-codespace)」をご覧ください。 -Each codespace has a unique name that is a combination of your {% data variables.product.company_short %} handle, two or three automatically generated words, and some random characters. For example: `octocat-literate-space-parakeet-mld5`. The two or three automatically generated words also form the initial display name of your codespace, in this case, `literate-space-parakeet`. You can change the display name for a codespace, but this will not affect the permanent name. For more information, see "[Renaming a codespace](/codespaces/customizing-your-codespace/renaming-a-codespace)." +codespace の名前を見つけるには: -To find the name of a codespace: +- ブラウザーで codespace を開きます。 URL のサブドメインは codespace の名前です。 たとえば、`https://octocat-literate-space-parakeet-mld5.github.dev` は `octocat-literate-space-parakeet-mld5` codespace の URL です。 +- codespace を開くことができない場合は、{% data variables.product.product_name %} (https://github.com/codespaces ) で名前にアクセスできます。 https://github.com/codespaces で codespace の表示名にカーソルを合わせると、ポップアップに名前が表示されます。 + ![カーソルを合わせると表示される codespace 名](/assets/images/help/codespaces/find-codespace-name-github.png) -- Open the codespace in the browser. The subdomain of the URL is the name of the codespace. For example: `https://octocat-literate-space-parakeet-mld5.github.dev` is the URL for the `octocat-literate-space-parakeet-mld5` codespace. -- If you cannot open a codespace, you can access the name in {% data variables.product.product_name %} on https://github.com/codespaces. The name is shown in a pop-up when you hover over the display name of a codespace on https://github.com/codespaces. - ![Codespace name shown on hover over](/assets/images/help/codespaces/find-codespace-name-github.png) +codespace の名前は多くのログ ファイルにも含まれています。 たとえば、codespace ログでは `friendlyName` 値として、{% data variables.product.prodname_github_codespaces %} 拡張機能ログでは `making GET request for` の後に、ブラウザー コンソール ログでは `clientUrl` の後にあります。 詳しい情報については、「[{% data variables.product.prodname_github_codespaces %} のログ](/codespaces/troubleshooting/github-codespaces-logs)」を参照してください。 -The name the codespace is also included in many of the log files. For example, in the codespace logs as the value of `friendlyName`, in the {% data variables.product.prodname_github_codespaces %} extension log after `making GET request for`, and in the browser console log after `clientUrl`. For more information, see "[{% data variables.product.prodname_github_codespaces %} logs](/codespaces/troubleshooting/github-codespaces-logs)." +## codespace ID -## Codespaces IDs +すべての codespace には ID (識別子) もあります。 {% data variables.product.prodname_vscode %} ではこれは既定で表示されないため、ID にアクセスする前に {% data variables.product.prodname_github_codespaces %} 拡張機能の設定を更新する必要がある場合があります。 -Every codespace also has an ID (identifier). This is not shown by default in {% data variables.product.prodname_vscode %} so you may need to update the settings for the {% data variables.product.prodname_github_codespaces %} extension before you can access the ID. - -1. In {% data variables.product.prodname_vscode %}, browser or desktop, in the Activity Bar on the left, click **Remote Explorer** to show details for the codespace. +1. {% data variables.product.prodname_vscode %} (ブラウザーまたはデスクトップ) の左側のアクティビティ バーで、 **[リモート エクスプローラー]** をクリックして codespace の詳細を表示します。 {% indented_data_reference reusables.codespaces.remote-explorer spaces=3 %} -1. If the sidebar includes a "Codespace Performance" section, hover over the "Codespace ID" and click the clipboard icon to copy the ID. -1. If the information is not shown, click {% octicon "gear" aria-label="The gear icon" %}, in the bottom-left corner of the Activity Bar, to display the "Settings" tab. -1. Expand **Extensions** and click **{% data variables.product.prodname_github_codespaces %}** to display the settings for the extension. Then enable **Show Performance Explorer** to display the "Codespace Performance" section in the sidebar. - ![Codespace ID and settings required to display performance information](/assets/images/help/codespaces/find-codespace-id.png) +1. サイドバーに [codespace パフォーマンス] セクションが含まれている場合は、[codespace ID] にカーソルを合わせ、クリップボード アイコンをクリックしてその ID をコピーします。 +1. 情報が表示されない場合は、アクティビティ バーの左下隅にある {% octicon "gear" aria-label="The gear icon" %} をクリックして、[設定] タブを表示します。 +1. **[拡張機能]** を展開し、 **[{% data variables.product.prodname_github_codespaces %}]** をクリックして拡張機能の設定を表示します。 その後、 **[パフォーマンス エクスプローラーの表示]** を有効にして、サイドバーに [codespace パフォーマンス] セクションを表示します。 + ![パフォーマンス情報を表示するために必要な codespace ID と設定](/assets/images/help/codespaces/find-codespace-id.png) diff --git a/translations/ja-JP/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization.md b/translations/ja-JP/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization.md index 0c62ef4329..798f39df02 100644 --- a/translations/ja-JP/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization.md +++ b/translations/ja-JP/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization.md @@ -1,6 +1,6 @@ --- -title: Blocking a user from your organization -intro: Organization owners and moderators can block anyone who is not a member of the organization from collaborating on the organization's repositories. +title: Organization からのユーザのブロック +intro: Organization のオーナーとモデレーターは、Organization のメンバーではないユーザーが Organization のリポジトリで共同作業を行うことをブロックできます。 redirect_from: - /articles/blocking-a-user-from-your-organization - /github/building-a-strong-community/blocking-a-user-from-your-organization @@ -10,68 +10,71 @@ versions: topics: - Community shortTitle: Block from your org +ms.openlocfilehash: 527ce4fcf92946836f7a3d93e5caf07193561d4b +ms.sourcegitcommit: 1529de77bfcbe45519131b5f5fb3ab319758c2d2 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148164356' --- - -You can block non-members from within your organization's settings or from a specific comment made by a user. When you block a user in a comment, you can choose to send the user a notification explaining that they were blocked and why. Otherwise, the user is not directly notified that you've blocked them. Blocked users can still delete their existing content. +組織の設定内、もしくはユーザーが作成した特定のコメントから、メンバー以外の人をブロックできます。 コメント内でユーザをブロックした場合、そのユーザに、ブロックされたこととその理由を説明する通知を送信できます。 そうしない場合、ブロックされたことはユーザには直接通知されません。 ユーザは、ブロックされても既存のコンテンツを削除できます。 {% data reusables.organizations.blocking-a-user %} {% tip %} -**Tip:** If you're blocking a user because of a heated conversation, consider locking the conversation so only collaborators can comment. For more information, see "[Locking conversations](/communities/moderating-comments-and-conversations/locking-conversations)." +**ヒント:** 過熱した会話を鎮めるためにユーザーをブロックする場合、会話をロックすることにより、コラボレーターだけがコメントできるようになります。 詳細については、[会話のロック](/communities/moderating-comments-and-conversations/locking-conversations)に関するページを参照してください。 {% endtip %} -At the time that you block a user from your organization: -- The user stops watching your organization's repositories -- The user's stars and issue assignments are removed from your repositories -- The user's votes on discussions or comments in your organization's repositories are deleted -- The user is removed as a collaborator on your organization's repositories -- The user's contributions to your organization's repositories are no longer counted as contributions for them -- Any pending repository or organization invitations to the blocked user are cancelled +ユーザを Organization からブロックすると、以下のようになります: +- そのユーザによる Organization のリポジトリの Watch は停止します。 +- そのユーザによる Star 付けや Issue 割り当てはリポジトリから削除されます。 +- Organization のリポジトリ内のディスカッションまたはコメントに対するユーザの投票が削除されます +- そのユーザは、Organization のリポジトリのコラボレーターではなくなります。 +- Organization のリポジトリへのユーザのコントリビューションがカウントされなくなります +- ブロックされたユーザへの保留中のリポジトリまたは Organization の招待はキャンセルされます -After you've blocked a user from your organization, they cannot: -- Cross-reference your organization's repositories in comments -- Fork, watch, pin, or star your organization's repositories +ユーザを Organization からブロックすると、そのユーザは以下のことができなくなります: +- Organization のリポジトリをコメント中でクロス参照すること +- Organization のリポジトリのフォーク、Watch、ピン留め、Star 付け -In your organization's repositories, blocked users also cannot: -- Open issues -- Send, close, or merge pull requests -- Comment on issues, pull requests, or commits -- Add or edit wiki pages +また、ブロックされたユーザは Organization のリポジトリで以下のことができません: +- Issue のオープン +- プルリクエストの送信、クローズ、マージ +- Issue、プルリクエスト、あるいはコメントにコメントする +- ウィキページを追加または編集する -## Blocking a user in a comment +## コメントでユーザをブロックする -1. Navigate to the comment whose author you would like to block. -2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Block user**. -![The horizontal kebab icon and comment moderation menu showing the block user option](/assets/images/help/repository/comment-menu-block-user.png) -3. If you'd like to set a time limit for the block, use the Block user drop-down menu, and select the amount of time you'd like to block the user. -![Block time limit in the block user drop-down menu](/assets/images/help/organizations/org-block-options-menu-from-comment.png) -4. If you'd like to hide all of the comments the user has made in the organization, select **Hide this user's comments** and choose a reason. -![Send a notification in the block user drop-down menu](/assets/images/help/organizations/org-block-options-menu-hide-user-comments.png) -5. If you'd like to notify the user why they're being blocked, select **Send a notification to this user**. -![Send a notification in the block user drop-down menu](/assets/images/help/organizations/org-block-options-menu-send-notification.png) -6. To block the user, click **Block user from organization** or **Block user from organization and send message**. -![Block user button](/assets/images/help/organizations/org-block-user-button-in-comment.png) +1. ブロックしたい作者のコメントへ移動します。 +2. コメントの右上で {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} をクリックし、次に **[Block user]** をクリックします。 +![ユーザー ブロックのオプションを表示する水平の kebab アイコンとコメント調整メニュー](/assets/images/help/repository/comment-menu-block-user.png) +3. ブロックに期限を設定したい場合には、[Block user] ドロップダウンメニューを使い、ユーザをブロックしたい期間を選択します。 +![ユーザーのブロック ドロップダウン メニュー内のブロック期間制限](/assets/images/help/organizations/org-block-options-menu-from-comment.png) +4. 組織内でそのユーザーが書いたすべてのコメントを隠したい場合は、 **[Hide this user's comments]\(このユーザーのコメントを隠す\)** を選択し、理由を選択します。 +![ユーザーのブロック ドロップダウン メニュー内の通知の送信](/assets/images/help/organizations/org-block-options-menu-hide-user-comments.png) +5. ブロックする理由をユーザーに通知したい場合は、 **[Send a notification to this user]\(このユーザーに通知を送信\)** を選択します。 +![ユーザーのブロック ドロップダウン メニュー内の通知の送信](/assets/images/help/organizations/org-block-options-menu-send-notification.png) +6. ユーザーをブロックするには、 **[Block user from organization]\(Organization からユーザーをブロック\)** または **[Block user from organization and send message]\(Organization からユーザーをブロックしてメッセージを送信\)** をクリックします。 +![[ユーザーのブロック] ボタン](/assets/images/help/organizations/org-block-user-button-in-comment.png) -## Blocking a user in the organization settings +## Organization 設定でユーザをブロックする -1. To block an organization member, first [remove the user](/articles/removing-a-member-from-your-organization) from the organization. +1. 組織メンバーをブロックするにはまず、組織から[ユーザーを削除](/articles/removing-a-member-from-your-organization)します。 -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.organizations.block_users %} -6. Under "Block a user", type the username of the user you'd like to block. -![Username field](/assets/images/help/organizations/org-block-username-field.png) -7. If you'd like to set a time limit for the block, use the Block options drop-down menu, and select the amount of time you'd like to block the user. -![Block options drop-down menu](/assets/images/help/organizations/org-block-options-menu.png) -8. Click **Block user**. -![Block button](/assets/images/help/organizations/org-block-user-button.png) +{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.block_users %} +6. [Block a user] の下で、ブロックしたいユーザ名を入力します。 +![ユーザー名フィールド](/assets/images/help/organizations/org-block-username-field.png) +7. ブロックに期限を設定したい場合には、[Block option] ドロップダウンメニューを使い、ユーザをブロックする期間を選択します。 +![ブロック オプションのドロップダウン メニュー](/assets/images/help/organizations/org-block-options-menu.png) +8. **[Block user]** をクリックします。 +![ブロック ボタン](/assets/images/help/organizations/org-block-user-button.png) -## Further reading +## 参考資料 -- "[Viewing users who are blocked from your organization](/communities/maintaining-your-safety-on-github/viewing-users-who-are-blocked-from-your-organization)" -- "[Unblocking a user from your organization](/communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-organization)" -- "[Blocking a user from your personal account](/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account)" -- "[Unblocking a user from your personal account](/communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-personal-account)" -- "[Reporting abuse or spam](/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam)" +- "[組織からブロックされているユーザーの表示](/communities/maintaining-your-safety-on-github/viewing-users-who-are-blocked-from-your-organization)" +- "[組織からユーザーのブロックを解除する](/communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-organization)" +- "[個人アカウントからのユーザーのブロック](/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account)" +- "[個人アカウントからユーザーのブロックを解除する](/communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-personal-account)" +- "[悪用あるいはスパムをレポートする](/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam)" diff --git a/translations/ja-JP/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md b/translations/ja-JP/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md index d7164d372a..4e211bc496 100644 --- a/translations/ja-JP/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md +++ b/translations/ja-JP/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md @@ -1,6 +1,6 @@ --- -title: About GitHub Global Campus for students -intro: '{% data variables.product.prodname_education %} offers students real-world experience with free access to various developer tools from {% data variables.product.prodname_dotcom %}''s partners.' +title: 学生向け GitHub Global Campus について +intro: '{% data variables.product.prodname_education %} は学生に対し、{% data variables.product.prodname_dotcom %} のパートナーからのさまざまな開発者ツールへの無料アクセスを含む実世界の体験を提供します。' redirect_from: - /education/teach-and-learn-with-github-education/about-github-education-for-students - /github/teaching-and-learning-with-github-education/about-github-education-for-students @@ -10,40 +10,46 @@ redirect_from: versions: fpt: '*' shortTitle: For students +ms.openlocfilehash: 198f0354e63721a4763e8fa32f832a19b2dac9d9 +ms.sourcegitcommit: 3abdbdbb47a9319f20e11845e9c2d8a7fce63422 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/15/2022 +ms.locfileid: '148165098' --- -Using {% data variables.product.prodname_dotcom %} for your school projects is a practical way to collaborate with others and build a portfolio that showcases real-world experience. +学校のプロジェクトで{% data variables.product.prodname_dotcom %}を利用することは、他者とコラボレーションして実世界の体験を見てもらうためのポートフォリオを構築するための実際的な方法です。 -Everyone with a {% data variables.product.prodname_dotcom %} account can collaborate in unlimited public and private repositories with {% data variables.product.prodname_free_user %}. As a student, you can also apply for {% data variables.product.prodname_education %} student benefits. Your {% data variables.product.prodname_education %} student benefits and resources are all included in {% data variables.product.prodname_global_campus %}, a portal that allows you to access your education benefits, all in one place. For more information, see "[Apply to GitHub Global Campus as a student](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/apply-to-github-global-campus-as-a-student)" and [{% data variables.product.prodname_education %}](https://education.github.com/). +{% data variables.product.prodname_dotcom %} アカウントを持つ誰もが、{% data variables.product.prodname_free_user %} での無制限のパブリックおよびプライベートリポジトリで協業できます。 学生として、{% data variables.product.prodname_education %} の学生特典を申請することもできます。 {% data variables.product.prodname_education %} の学生特典とリソースはすべて、{% data variables.product.prodname_global_campus %} に含まれています。これは、教育関連の特典のすべてに 1 か所でアクセスできるポータルです。 詳しくは「[学生として GitHub Global Campus に申請する](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/apply-to-github-global-campus-as-a-student)」と、「[{% data variables.product.prodname_education %}](https://education.github.com/)」を参照してください。 -Before applying for Global Campus, check if your learning community is already partnered with us as a {% data variables.product.prodname_campus_program %} school. For more information, see "[About {% data variables.product.prodname_campus_program %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)." +Global Campus に申請する前に、ご自分の学習コミュニティが既に {% data variables.product.prodname_campus_program %} 学校として提携しているかどうかをご確認ください。 詳細については、「[{% data variables.product.prodname_campus_program %} について](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)」を参照してください。 -If you're a member of a school club, a teacher can apply for {% data variables.product.prodname_global_campus %} so your team can collaborate using {% data variables.product.prodname_team %}, which allows unlimited users and private repositories, for free. For more information, see "[Apply to {% data variables.product.prodname_global_campus %} as a teacher](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)." +あなたが学校のクラブ活動のメンバーなら、あなたの先生が {% data variables.product.prodname_global_campus %} に申請すると、チームが {% data variables.product.prodname_team %} を使ってコラボレーションができるようになります。これによって、無制限のユーザーとプライベート リポジトリが無料で提供されます。 詳しくは、「[教師として {% data variables.product.prodname_global_campus %} に申請する](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)」を参照してください。 -Once you are a verified {% data variables.product.prodname_global_campus %} student, you can access {% data variables.product.prodname_global_campus %} anytime by going to the [{% data variables.product.prodname_education %} website](https://education.github.com). +認証された {% data variables.product.prodname_global_campus %} 学生になると、[{% data variables.product.prodname_education %} Web サイト](https://education.github.com) にアクセスして、いつでも {% data variables.product.prodname_global_campus %} をお使いいただけます。 -![{% data variables.product.prodname_global_campus %} portal for students](/assets/images/help/education/global-campus-portal-students.png) +![学生向け {% data variables.product.prodname_global_campus %} ポータル](/assets/images/help/education/global-campus-portal-students.png) -## {% data variables.product.prodname_global_campus %} features for students +## 学生向け {% data variables.product.prodname_global_campus %} の機能 -{% data variables.product.prodname_global_campus %} is a portal from which you can access your {% data variables.product.prodname_education %} benefits and resources, all in one place. On the {% data variables.product.prodname_global_campus %} portal, students can: -- Connect with a local Campus Expert. For more information on campus experts, see "[About Campus Experts](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-campus-experts)." -- Explore and claim offers for free industry tools from the [Student Developer Pack](https://education.github.com/pack). -- See upcoming in-person and virtual events for students, curated by {% data variables.product.prodname_education %} and student leaders. -- View assignments from [GitHub Classroom](https://classroom.github.com/) with upcoming due dates. -- Stay in the know on what the community is interested in by rewatching recent [Campus TV](https://www.twitch.tv/githubeducation) episodes. Campus TV is created by {% data variables.product.prodname_dotcom %} and student community leaders and can be watched live or on demand. -- Discover student-created repositories from GitHub Community Exchange. For more information, see "[About GitHub Community Exchange](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)." +{% data variables.product.prodname_global_campus %} は、{% data variables.product.prodname_education %} 特典とリソースをすべてまとめて 1 か所で利用できるポータルです。 {% data variables.product.prodname_global_campus %} ポータルで、学生は次のことができます。 +- 地元の Campus Expert とつながる。 Campus Expert については詳しくは、「[Campus Expert について](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-campus-experts)」を参照してください。 +- [Student Developer Pack](https://education.github.com/pack) から無料の業界ツールのオファーを調べてリクエストする。 +- {% data variables.product.prodname_education %} と学生リーダーによってキュレーションされた、学生向けの今後の対人イベントと仮想イベントを参照する。 +- [GitHub Classroom](https://classroom.github.com/) からの課題を今後の期限付きで表示する。 +- [Campus TV](https://www.twitch.tv/githubeducation) の最近のエピソードをもう一度観て、学生コミュニティで関心が持たれている事柄を常に把握する。 Campus TV は、{% data variables.product.prodname_dotcom %} と学生コミュニティのリーダーによって作成されます。ライブまたはオンデマンドでご覧になれます。 +- GitHub Community Exchange から学生が作成したリポジトリを見つける。 詳しくは、「[GitHub Community Exchange について](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)」を参照してください。 -{% data variables.product.prodname_global_campus %} students also receive the following {% data variables.product.prodname_dotcom %} benefits. -- **{% data variables.product.prodname_copilot %}**: Verified students receive a free subscription for {% data variables.product.prodname_copilot %}. You will be automatically notified about the free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page in your account settings. For more information about subscribing to and using {% data variables.product.prodname_copilot %}, see "[Managing your {% data variables.product.prodname_copilot %} subscription](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)" and "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." -- **{% data variables.product.prodname_github_codespaces %}**: {% data reusables.education.student-codespaces-benefit %} For more information on getting started with {% data variables.product.prodname_github_codespaces %}, see "[{% data variables.product.prodname_github_codespaces %} overview](/codespaces/overview)." +{% data variables.product.prodname_global_campus %} の学生は、次の {% data variables.product.prodname_dotcom %} 特典も受け取ります。 +- **{% data variables.product.prodname_copilot %}** : 検証済みの学生は、{% data variables.product.prodname_copilot %} の無料サブスクリプションを受け取ります。 アカウント設定で {% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスすると、無料サブスクリプションに関して自動的に通知されます。 {% data variables.product.prodname_copilot %} のサブスクライブと使用について詳しくは、「[{% data variables.product.prodname_copilot %} サブスクリプションの管理](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)」と「[{% data variables.product.prodname_copilot %} について](/copilot/overview-of-github-copilot/about-github-copilot)」を参照してください。 +- **{% data variables.product.prodname_github_codespaces %}** : {% data reusables.education.student-codespaces-benefit %} {% data variables.product.prodname_github_codespaces %} の使用を始める方法について詳しくは、「[{% data variables.product.prodname_github_codespaces %} の概要](/codespaces/overview)」を参照してください。 {% note %} -**Note:** {% data reusables.education.note-on-student-codespaces-usage %} For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom)." +**注:** {% data reusables.education.note-on-student-codespaces-usage %} 詳しくは、「[{% data variables.product.prodname_github_codespaces %} と {% data variables.product.prodname_classroom %} の使用](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom)」を参照してください。 {% endnote %} -## Further reading +## 参考資料 -- "[About {% data variables.product.prodname_global_campus %} for teachers](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers)" -- "[About {% data variables.product.prodname_community_exchange %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)" +- [教師向け {% data variables.product.prodname_global_campus %} について](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers) +- 「[{% data variables.product.prodname_community_exchange %} について](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange)」 diff --git a/translations/ja-JP/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md b/translations/ja-JP/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md index dc7a203cd0..09ea2ad504 100644 --- a/translations/ja-JP/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md +++ b/translations/ja-JP/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md @@ -1,6 +1,6 @@ --- -title: About GitHub Global Campus for teachers -intro: '{% data variables.product.prodname_global_campus %} offers teachers a central place to access tools and resources for working more effectively inside and outside of the classroom.' +title: 教師向け GitHub Global Campus について +intro: '{% data variables.product.prodname_global_campus %} には、教室の内外で作業効率を高めるためのツールやリソースを利用できる、教師のための中心的な場所が用意されています。' redirect_from: - /education/teach-and-learn-with-github-education/about-github-education-for-educators-and-researchers - /github/teaching-and-learning-with-github-education/about-github-education-for-educators-and-researchers @@ -10,28 +10,32 @@ redirect_from: versions: fpt: '*' shortTitle: For teachers +ms.openlocfilehash: 2a93f87df67d1694bd93888d29a582afa9c749e4 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158966' --- +認定教育機関の学生または教職員は、{% data variables.product.prodname_education %} 特典とリソースが含まれている {% data variables.product.prodname_global_campus %} を申し込むことができます。 詳しくは、「[教師として {% data variables.product.prodname_global_campus %} に応募する](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)」を参照してください。 -As a faculty member at an accredited educational institution, you can apply for {% data variables.product.prodname_global_campus %}, which includes {% data variables.product.prodname_education %} benefits and resources. For more information, see "[Apply to {% data variables.product.prodname_global_campus %} as a teacher](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)." +{% data variables.product.prodname_global_campus %} は、GitHub Education Community を使って教育特典をすべてまとめて 1 か所で利用できるポータルです。 認証済み {% data variables.product.prodname_global_campus %} 教師になると、[{% data variables.product.prodname_education %} website](https://education.github.com) にアクセスすることで、いつでも {% data variables.product.prodname_global_campus %} を利用できます。 -{% data variables.product.prodname_global_campus %} is a portal that allows the GitHub Education Community to access their education benefits, all in one place. Once you are a verified {% data variables.product.prodname_global_campus %} teacher, you can access {% data variables.product.prodname_global_campus %} anytime by going to the [{% data variables.product.prodname_education %} website](https://education.github.com). +![教師向け {% data variables.product.prodname_global_campus %} ポータル](/assets/images/help/education/global-campus-portal-teachers.png) -![{% data variables.product.prodname_global_campus %} portal for teachers](/assets/images/help/education/global-campus-portal-teachers.png) +個別割引を申請する前に、学習コミュニティが既に {% data variables.product.prodname_campus_program %} 学校として提携しているかどうかを確認してください。 詳細については、「[{% data variables.product.prodname_campus_program %} について](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)」を参照してください。 -Before applying for an individual discount, check if your learning community is already partnered with us as a {% data variables.product.prodname_campus_program %} school. For more information, see "[About {% data variables.product.prodname_campus_program %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/about-github-campus-program)." +## 教師向け {% data variables.product.prodname_global_campus %} 機能 -## {% data variables.product.prodname_global_campus %} features for teachers +{% data variables.product.prodname_global_campus %} は、{% data variables.product.prodname_education %} 特典とリソースをすべてまとめて 1 か所で利用できるポータルです。 {% data variables.product.prodname_global_campus %} ポータルでは、あらゆるレベルの教師が次を行うことができます。{% data reusables.education.apply-for-team %} + - 最近の割り当てやクラスの進行状況などのアクティブな [{% data variables.product.prodname_classroom %}](https://classroom.github.com) の一目でわかる概要と、{% data variables.product.prodname_classroom %} へのリンクを確認する。 + - 世界中の仲間によって投稿された [{% data variables.product.prodname_discussions %}](https://github.com/orgs/community/discussions/categories/github-education) を確認して操作し、テクノロジ教育の現在の傾向について議論し、[{% data variables.product.prodname_education %} ブログ](https://github.blog/category/education/)の最新の投稿を確認する。 + - {% data variables.product.prodname_education %} と学生リーダーによってキュレーションされた学生イベントを確認する。 + - [Campus TV](https://www.twitch.tv/githubeducation) の最近のエピソードをもう一度観て、学生コミュニティで関心が持たれている事柄を常に把握しておく。 Campus TV は、{% data variables.product.prodname_dotcom %} と学生コミュニティのリーダーによって作成されます。ライブまたはオンデマンドでの視聴が可能です。 + - 学生の教育のための素材が入った {% data variables.product.prodname_dotcom %} のスワッグ バッグを要求する。 -{% data variables.product.prodname_global_campus %} is a portal from which you can access your {% data variables.product.prodname_education %} benefits and resources, all in one place. On the {% data variables.product.prodname_global_campus %} portal, teachers of all levels can: - {% data reusables.education.apply-for-team %} - - View an overview of your active [{% data variables.product.prodname_classroom %}](https://classroom.github.com), including recent assignments and your class's progress at a glance, as well as links to {% data variables.product.prodname_classroom %}. - - View and interact with [{% data variables.product.prodname_discussions %}](https://github.com/orgs/community/discussions/categories/github-education) posted by your peers from around the world to discuss current trends in technology education, and see the latest posts from our [{% data variables.product.prodname_education %} blog](https://github.blog/category/education/). - - See student events curated by {% data variables.product.prodname_education %} and student leaders. - - Stay in the know on what the student community is interested in by rewatching recent [Campus TV](https://www.twitch.tv/githubeducation) episodes. Campus TV is created by {% data variables.product.prodname_dotcom %} and student community leaders and can be watched live or on demand. - - Request a {% data variables.product.prodname_dotcom %} swag bag with educational materials and goodies for your students. +{% data variables.product.prodname_education %} に登録している認定講師には、{% data variables.product.prodname_copilot %} の無料サブスクリプションが用意されています。 アカウント設定で {% data variables.product.prodname_copilot %} サブスクリプション ページにアクセスすると、無料サブスクリプションに関して自動的に通知されます。 {% data variables.product.prodname_copilot %} のサブスクライブと使用について詳しくは、「[{% data variables.product.prodname_copilot %} サブスクリプションの管理](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)」と「[{% data variables.product.prodname_copilot %} について](/copilot/overview-of-github-copilot/about-github-copilot)」を参照してください。 -A free subscription for {% data variables.product.prodname_copilot %} is available to verified teachers with {% data variables.product.prodname_education %}. You will be automatically notified about the free subscription when you visit the {% data variables.product.prodname_copilot %} subscription page in your account settings. For more information about subscribing to and using {% data variables.product.prodname_copilot %}, see "[Managing your {% data variables.product.prodname_copilot %} subscription](/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription#setting-up-a-trial-of-github-copilot)" and "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." +## 関連項目 -## Further reading - -- "[About {% data variables.product.prodname_global_campus %} for students](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students)" +- 「[学生向け {% data variables.product.prodname_global_campus %} について](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students)」 diff --git a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md index 34a57ee0e7..4bdb079f53 100644 --- a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md +++ b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md @@ -1,27 +1,33 @@ --- -title: Using GitHub Codespaces with GitHub Classroom +title: GitHub Classroom で GitHub codespace を使用する shortTitle: Using Codespaces with GitHub Classroom product: '{% data reusables.gated-features.codespaces-classroom-articles %}' -intro: 'You can use {% data variables.product.prodname_github_codespaces %} as the preferred editor in your assignments to give students access to a browser-based Visual Studio Code environment with one-click setup.' +intro: '{% data variables.product.prodname_github_codespaces %} を割り当てで優先エディターとして使用し、ワン クリックで設定できるブラウザーベースの Visual Studio Code 環境に学生がアクセスできるようにできます。' versions: fpt: '*' permissions: 'Organization owners who are admins for a classroom can enable {% data variables.product.prodname_github_codespaces %} for their organization and integrate {% data variables.product.prodname_github_codespaces %} as the supported editor for an assignment. {% data reusables.classroom.classroom-admins-link %}' +ms.openlocfilehash: 6794d20b9ea0153b3baf4bee1a08c68b2ba17456 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158878' --- -## About {% data variables.product.prodname_github_codespaces %} +## {% data variables.product.prodname_github_codespaces %} について -{% data variables.product.prodname_github_codespaces %} is an instant, cloud-based development environment that uses a container to provide you with common languages, tools, and utilities for development. {% data variables.product.prodname_github_codespaces %} is also configurable, allowing you to create a customized development environment that is the same for all users of your project. For more information, see "[{% data variables.product.prodname_github_codespaces %} overview](/codespaces/overview)." +{% data variables.product.prodname_github_codespaces %} は、クラウドベースのインスタント開発環境であり、コンテナーを使用して開発用の共通言語、ツール、ユーティリティを提供します。 また、{% data variables.product.prodname_github_codespaces %} も構成可能で、プロジェクトのすべてのユーザーに共通のカスタマイズされた開発環境を作成できます。 詳しい情報については、「[{% data variables.product.prodname_github_codespaces %} の概要](/codespaces/overview)」を参照してください。 -Once {% data variables.product.prodname_github_codespaces %} is enabled in an organization or enterprise, users can create a codespace from any branch or commit in an organization or enterprise repository and begin developing using cloud-based compute resources. You can connect to a codespace from the browser or locally using Visual Studio Code. +Organization または Enterprise で {% data variables.product.prodname_github_codespaces %} を有効にすると、ユーザーは、任意のブランチから codespace を作成するか、Organization または Enterprise リポジトリでコミットし、クラウドベースのコンピューティング リソースを使用して開発を始めることができます。 codespace には、ブラウザーから接続することも、Visual Studio Code を使用してローカルで接続することもできます。 {% data reusables.codespaces.links-to-get-started %} -Setting {% data variables.product.prodname_github_codespaces %} as the preferred editor for an assignment in GitHub Classroom assignments, is beneficial for both students and teachers. {% data variables.product.prodname_github_codespaces %} is a good option for students using loaned devices or without access to a local IDE setup, since each codespace is cloud-based and requires no local setup. Students can launch a codespace for an assignment repository in Visual Studio Code directly in their browser, and begin developing right away without needing any further configuration. +{% data variables.product.prodname_github_codespaces %} を、GitHub Classroom の課題で課題用の優先エディターとして設定すると、学生と教師の両方にとって役立ちます。 {% data variables.product.prodname_github_codespaces %} は、各 codespace がクラウドベースであり、ローカルでの設定が必要ないため、貸し出されているデバイスを使っている学生、またはローカル IDE 設定にアクセスできない学生に適したオプションです。 学生は、ブラウザーで直接 Visual Studio Code 内の課題リポジトリの codespace を起動し、すぐに開発を開始できます。追加の構成は必要ありません。 -For assignments with complex setup environments, teachers can customize the dev container configuration for a repository's codespaces. This ensures that when a student creates a codespace, it automatically opens with the development environment configured by the teacher. For more information on dev containers, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)." +複雑な設定環境を使用する課題の場合、教師はリポジトリの codespace 向け開発コンテナーの構成をカスタマイズできます。 これにより、学生が codespace を作成する際、教師が構成した開発環境で codespace が自動的に開くようになります。 開発コンテナーの詳細については、「[開発コンテナーの概要」を](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)参照してください。 {% note %} -**Note**: Individual codespaces are automatically deleted if they are stopped and left unused for a prolonged period. For more information, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)." +**注**: 個々の codespace が停止し、長期間未使用のままになっている場合、個々の codespace は自動的に削除されます。 詳しい情報については、「[codespace の自動削除を構成する](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)」をご覧ください。 {% endnote %} @@ -29,74 +35,72 @@ For assignments with complex setup environments, teachers can customize the dev {% note %} -**Note:** {% data reusables.education.note-on-student-codespaces-usage %} +**注:** {% data reusables.education.note-on-student-codespaces-usage %} {% endnote %} -## About the {% data variables.product.prodname_codespaces %} Education benefit for verified teachers +## 認証済み教師に対する {% data variables.product.prodname_codespaces %} Education 特典について -The {% data variables.product.prodname_codespaces %} Education benefit gives verified teachers a free monthly allowance of {% data variables.product.prodname_github_codespaces %} hours to use in {% data variables.product.prodname_classroom %}. The free allowance is estimated to be enough for a class of 50 with 5 assignments per month, on a 2 core machine with 1 codespace stored per student. +{% data variables.product.prodname_codespaces %} Education 特典を利用すると、認証済みの教師には、{% data variables.product.prodname_classroom %} での {% data variables.product.prodname_github_codespaces %} の利用時間について、毎月無料の使用枠が与えられます。 この無料利用枠は、学生ごとに 1 つの codespace が保存されている 2 コアのマシンで、毎月 5 つの課題がある 50 人のクラスを目安としています。 {% data reusables.classroom.free-limited-codespaces-for-verified-teachers-beta-note %} -To become a verified teacher, you need to be approved for an educator or teacher benefit. For more information, see "[Apply to {% data variables.product.prodname_global_campus %} as a teacher](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)." +認証済み教師になるには、教育者特典または教師特典の承認を受ける必要があります。 詳しくは、「[教師として {% data variables.product.prodname_global_campus %} に応募する](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)」を参照してください。 -After you have confirmation that you are a verified teacher, visit [{% data variables.product.prodname_global_campus %} for Teachers](https://education.github.com/globalcampus/teacher) to upgrade the organization to GitHub Team. For more information, see [GitHub's products](/get-started/learning-about-github/githubs-products#github-team). +認証済み教師であるという確認を受け取ったら、[{% data variables.product.prodname_global_campus %} for Teachers](https://education.github.com/globalcampus/teacher) にアクセスして、Organization を GitHub Team にアップグレードします。 詳しい情報については、「[GitHub の製品](/get-started/learning-about-github/githubs-products#github-team)」を参照してください。 -If you are eligible for the {% data variables.product.prodname_codespaces %} Education benefit, when you enable {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_classroom %} for your organization, GitHub automatically adds a Codespace policy to restrict machine types for all codespaces in the organization to 2 core machines. This helps you make the most of the free {% data variables.product.prodname_github_codespaces %} usage. However, you can change or remove these policies in your organization settings. For more information, see "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)." +{% data variables.product.prodname_codespaces %} Education 特典の対象者の場合、Organization の {% data variables.product.prodname_classroom %} で {% data variables.product.prodname_github_codespaces %} を有効にすると、GitHub では、Codespace ポリシーが自動的に追加され、Organization 内のすべての codespace のマシンの種類が 2 コア マシンに制限されます。 これは、{% data variables.product.prodname_github_codespaces %} の無料使用量を最大限に活用するのに役立ちます。 ただし、これらのポリシーは、Organization の設定で変更または削除できます。 詳細については、「[コンピューターの種類へのアクセスの制限](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)」を参照してください。 -When the {% data variables.product.prodname_codespaces %} Education benefit moves out of beta, if your organization exceeds their free allowance for {% data variables.product.prodname_github_codespaces %} usage, your organization will be billed for additional usage. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." +{% data variables.product.prodname_codespaces %} Education 特典がベータ版から移行されると、Organization での {% data variables.product.prodname_github_codespaces %} の使用量が無料利用枠を超えると、追加の使用量に対して請求が行われます。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」をご覧ください。 -## Enabling {% data variables.product.prodname_codespaces %} for your organization +## Organization での {% data variables.product.prodname_codespaces %} の有効化 -{% data variables.product.prodname_github_codespaces %} is available to use with {% data variables.product.prodname_classroom %} for organizations that use {% data variables.product.prodname_team %}. If you are eligible for the {% data variables.product.prodname_codespaces %} Education benefit, you must enable {% data variables.product.prodname_github_codespaces %} through {% data variables.product.prodname_classroom %}, instead of enabling it directly in your organization settings. Otherwise, your organization will be billed directly for all usage of {% data variables.product.prodname_github_codespaces %}. +{% data variables.product.prodname_github_codespaces %} は、{% data variables.product.prodname_team %} を使用する Organization の {% data variables.product.prodname_classroom %} で使用できます。 {% data variables.product.prodname_codespaces %} Education 特典の対象である場合、{% data variables.product.prodname_github_codespaces %} は、Organization の設定で直接有効にするのではなく、{% data variables.product.prodname_classroom %} を介して有効にする必要があります。 そうしないと、Organization での {% data variables.product.prodname_github_codespaces %} のすべての使用量に対して直接請求されることになります。 -### Enabling Codespaces for an organization when creating a new classroom +### 新しいクラスルームの作成時に Organization の codespace を有効にする {% data reusables.classroom.sign-into-github-classroom %} -1. Click **New classroom**. +1. **[新しいクラスルーム]** をクリックします。 - !["New classroom" button](/assets/images/help/classroom/click-new-classroom-button.png) + ![[新しいクラスルーム] ボタン](/assets/images/help/classroom/click-new-classroom-button.png) -1. In the list of organizations, click the organization you'd like to use for your classroom. Organizations that are eligible for {% data variables.product.prodname_github_codespaces %} will have a note showing that they are eligible. Optionally, you can create a new organization. For more information, see "[Creating a new organization from scratch](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)." +1. Organizationのリスト中で、クラスルームに使いたいOrganizationをクリックしてください。 {% data variables.product.prodname_github_codespaces %} の対象となる Organization には、対象であることを示すメモが表示されます。 あるいは、新しいOrganizationを作成することもできます。 詳細については、「[新しい Organization をゼロから作成](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)」を参照してください。 - ![Choose organization for classroom with codespaces eligibility](/assets/images/help/classroom/org-view-codespaces-eligibility.png) + ![codespace の対象となるクラスルームの Organization を選択する](/assets/images/help/classroom/org-view-codespaces-eligibility.png) -1. In the "Name your classroom" page, under "{% data variables.product.prodname_codespaces %} in your Classroom", click **Enable**. Note that this will enable {% data variables.product.prodname_github_codespaces %} for all repositories and users in the organization. +1. [クラスルームに名前を付ける] ページの [Classroom の {% data variables.product.prodname_codespaces %}] で、 **[有効]** をクリックします。 これにより、Organization 内のすべてのリポジトリとユーザーに対して {% data variables.product.prodname_github_codespaces %} が有効になることにご注意ください。 - ![Enable Codespaces for org in "Setup classroom basics" page](/assets/images/help/classroom/setup-classroom-enable-codespaces-button.png) + ![[クラスルームの基本設定] ページで Organization の codespace を有効にする](/assets/images/help/classroom/setup-classroom-enable-codespaces-button.png) -1. When you are ready to create the new classroom, click **Create classroom**. +1. 新しいクラスルームを作成する準備ができたら、 **[クラスルームの作成]** をクリックします。 -### Enabling Codespaces for an organization via an existing classroom +### 既存のクラスルームを使用して Organization の codespace を有効にする -{% data reusables.classroom.sign-into-github-classroom %} -{% data reusables.classroom.click-classroom-in-list %} -{% data reusables.classroom.click-settings %} -1. Under "{% data variables.product.prodname_github_codespaces %}", click **Enable**. This will enable {% data variables.product.prodname_github_codespaces %} for all repositories and users in the organization. A new Codespace policy is also added to restrict machine types for all codespaces in the organization to 2 core machines. +{% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-settings %} +1. {% data variables.product.prodname_github_codespaces %} で、**有効** をクリックします。 これにより、Organization 内のすべてのリポジトリとユーザーに対して {% data variables.product.prodname_github_codespaces %} が有効になります。 新しい Codespace ポリシーも追加され、Organization 内のすべて codespace のマシンの種類が 2 コア マシンに制限されます。 - ![Enable Codespaces for org in existing classroom settings](/assets/images/help/classroom/classroom-settings-enable-codespaces-button.png) + ![既存のクラスルームの設定で Organization の codespace を有効にする](/assets/images/help/classroom/classroom-settings-enable-codespaces-button.png) -You can use the same methods as above to disable {% data variables.product.prodname_github_codespaces %} for your organization as well. Note that this will disable {% data variables.product.prodname_github_codespaces %} for all users and repositories in the organization. +上記と同じ方法を使用して、Organization の {% data variables.product.prodname_github_codespaces %} を無効にすることもできます。 これにより、Organization 内のすべてのユーザーとリポジトリに対して {% data variables.product.prodname_github_codespaces %} が無効になることにご注意ください。 -## Configuring an assignment to use {% data variables.product.prodname_codespaces %} -To make {% data variables.product.prodname_github_codespaces %} available to students for an assignment, you can choose {% data variables.product.prodname_github_codespaces %} as the supported editor for the assignment. When creating a new assignment, in the "Add your starter code and choose your optional online IDE" page, under "Add a supported editor", select **{% data variables.product.prodname_github_codespaces %}** from the dropdown menu. +## {% data variables.product.prodname_codespaces %} を使用するように課題を構成する +学生が {% data variables.product.prodname_github_codespaces %} を課題に使用できるようにするには、課題向けのサポートされるエディターとして {% data variables.product.prodname_github_codespaces %} を選ぶことができます。 新しい課題を作成するときに、[スタート コードを追加してオプションのオンライン IDE を選択する] ページの [サポートされるエディターの追加] で、ドロップダウン メニューから **[{% data variables.product.prodname_github_codespaces %}]** を選択します。 -![Select Codespaces as supported editor for assignment](/assets/images/help/classroom/select-supported-editor-including-codespaces.png) +![課題向けのサポートされるエディターとして codespace を選択する](/assets/images/help/classroom/select-supported-editor-including-codespaces.png) -If you use a template repository for an assignment, you can define a dev container in the repository to customize the tools and runtimes available to students when they launch a codespace to work on the assignment. If you do not define a dev container, {% data variables.product.prodname_github_codespaces %} will use a default configuration, which contains many of the common tools that your students might need for development. For more information on defining a dev container, see "[Add a dev container configuration to your repository](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)." +課題のテンプレート リポジトリを使用する場合、リポジトリ内の開発コンテナーを定義して、学生が codespace を起動して課題に取り組むときに使用できるツールとランタイムをカスタマイズできます。 開発コンテナーを定義しない場合、{% data variables.product.prodname_github_codespaces %} では、既定の構成が使用されます。これには、学生が開発に必要とする可能性のある一般的なツールが多く含まれています。 開発コンテナーの定義に関する詳しい情報については、「[開発コンテナーの構成をリポジトリに追加する](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)」を参照してください。 -## Launching an assignment using {% data variables.product.prodname_github_codespaces %} +## {% data variables.product.prodname_github_codespaces %} を使用して課題を起動する -When a student opens an assignment, the repository's README file includes their teacher's recommendation of the IDE they should use for the work. +学生が課題を開くと、リポジトリの README ファイルに、学生が作業に使用する必要がある IDE に関する教師の推奨事項が含まれます。 -![Screenshot of the Codespaces note in the README for a student assignment repository](/assets/images/help/classroom/student-codespaces-readme-link.png) +![学生の課題リポジトリの README 内にある codespace に関する注意のスクリーンショット](/assets/images/help/classroom/student-codespaces-readme-link.png) -Students can launch a new or existing codespace by clicking the **Open in GitHub Codespace** button in the README, or by clicking the **{% octicon "code" aria-label="The code icon" %} Code** button on the main page of the assignment repository, then selecting the **Codespaces** tab. From the **Codespaces** tab you can select an existing codespace or create a new one. 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)." +学生は、README の **[GitHub Codespace で開く]** ボタンをクリックするか、課題リポジトリのメイン ページにある **{% octicon "code" aria-label="The code icon" %} [コード]** ボタンをクリックして、 **[Codespaces]** タブを選ぶと、新規または既存の codespace を起動できます。 **[Codespaces]** タブでは、既存の codespace を選ぶか、新しい codespace を作成できます。 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository#creating-a-codespace-for-a-repository)」を参照してください。 -![Launch new codespace in assignment repository](/assets/images/help/classroom/student-launch-new-codespace.png) +![課題リポジトリで新しい codespace を起動する](/assets/images/help/classroom/student-launch-new-codespace.png) -Teachers can view each student's codespace for an assignment in the assignment overview page. You can click on the Codespaces icon on the right side of each student row to launch the codespace. +教師は、[課題の概要] ページで各学生の課題の codespace を表示できます。 各学生行の右側にある [codespace] アイコンをクリックして codespace を起動できます。 -![Teacher assignment overview with student's codespaces](/assets/images/help/classroom/teacher-assignment-view-with-codespaces.png) +![学生の codespace を表示した教師の [課題の概要]](/assets/images/help/classroom/teacher-assignment-view-with-codespaces.png) -When you connect to a codespace through a browser, auto-save is enabled automatically. If you want to save changes to the repository, you will need to commit the changes and push them to a remote branch. If you leave your codespace running without interaction for 30 minutes by default, the codespace will timeout and stop running. Your data will be preserved from the last time you made a change. For more information on the lifecycle of a codespace, see "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)." +ブラウザーを使用して codespace に接続する場合は、自動保存が自動的に有効になります。 リポジトリに対する変更を保存する場合、変更をコミットしてリモート ブランチにプッシュする必要があります。 既定では、30 分間操作することなく codespace を実行したままにした場合、codespace はタイムアウトになり、実行が停止されます。 データは、最後に変更した時点の状態で保持されます。 codespace のライフサイクルの詳細については、「[Codespace のライフサイクル](/codespaces/developing-in-codespaces/the-codespace-lifecycle)」を参照してください。 diff --git a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md index 66cdb5d8b3..ffef0a4aba 100644 --- a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md +++ b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md @@ -74,6 +74,8 @@ If you've already created a group assignment for the classroom, you can reuse a ### Choosing a visibility for assignment repositories +{% data reusables.classroom.assignments-repository-visibility-and-permissions %} + {% data reusables.classroom.assignments-guide-choose-visibility %} {% data reusables.classroom.assignments-guide-click-continue-after-basics %} diff --git a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment.md b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment.md index d47992c3f1..8161608b81 100644 --- a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment.md +++ b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment.md @@ -1,6 +1,6 @@ --- -title: 個人課題の作成 -intro: コースにおいて、個人で修了するための課題を学生のために作成できます。 +title: Create an individual assignment +intro: You can create an assignment for students in your course to complete individually. versions: fpt: '*' permissions: 'Organization owners who are admins for a classroom can create and manage individual assignments for a classroom. {% data reusables.classroom.classroom-admins-link %}' @@ -8,14 +8,8 @@ redirect_from: - /education/manage-coursework-with-github-classroom/creating-an-individual-assignment - /education/manage-coursework-with-github-classroom/create-an-individual-assignment shortTitle: Individual assignment -ms.openlocfilehash: 4f5fab2f63ff686762a4fb6ccd5964b7f4d9cb3c -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147573869' --- -## 個人課題について +## About individual assignments {% data reusables.classroom.assignments-individual-definition %} @@ -23,82 +17,84 @@ ms.locfileid: '147573869' {% data reusables.classroom.about-assignments %} -個人課題の作成のビデオ デモについては、「[{% data variables.product.prodname_classroom %} のセットアップの基本](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)」をご覧ください。 +For a video demonstration of the creation of an individual assignment, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)." {% data reusables.classroom.reuse-assignment-link %} -## 前提条件 +## Prerequisites {% data reusables.classroom.assignments-classroom-prerequisite %} -## 課題を作成する +## Creating an assignment {% data reusables.classroom.assignments-guide-create-the-assignment %} -## 課題の基本情報をセットアップする +## Setting up the basics for an assignment -課題に名前を付け、期限を設定するかを決定し、課題リポジトリの可視性を選択します。 +Name your assignment, decide whether to assign a deadline, and choose the visibility of assignment repositories. -- [課題に名前を付ける](#naming-an-assignment) -- [課題に期限を設定する](#assigning-a-deadline-for-an-assignment) -- [課題のタイプを選択する](#choosing-an-assignment-type) -- [課題リポジトリの可視性を選択する](#choosing-a-visibility-for-assignment-repositories) +- [Naming an assignment](#naming-an-assignment) +- [Assigning a deadline for an assignment](#assigning-a-deadline-for-an-assignment) +- [Choosing an assignment type](#choosing-an-assignment-type) +- [Choosing a visibility for assignment repositories](#choosing-a-visibility-for-assignment-repositories) -### 課題に名前を付ける +### Naming an assignment -個人課題では、{% data variables.product.prodname_classroom %}はリポジトリのプレフィックスと学生の{% data variables.product.product_name %}ユーザ名から、リポジトリに名前を付けます。 デフォルトでは、リポジトリのプレフィックスが課題のタイトルとなります。 たとえば、課題に "assignment-1" という名前を付け、{% data variables.product.product_name %} での学生のユーザー名が @octocat である場合、@octocat の課題リポジトリの名前は `assignment-1-octocat` になります。 +For an individual assignment, {% data variables.product.prodname_classroom %} names repositories by the repository prefix and the student's {% data variables.product.product_name %} username. By default, the repository prefix is the assignment title. For example, if you name an assignment "assignment-1" and the student's username on {% data variables.product.product_name %} is @octocat, the name of the assignment repository for @octocat will be `assignment-1-octocat`. {% data reusables.classroom.assignments-type-a-title %} -### 課題に期限を設定する +### Assigning a deadline for an assignment {% data reusables.classroom.assignments-guide-assign-a-deadline %} -### 課題のタイプを選択する +### Choosing an assignment type -[Individual or group assignment]\(個人またはグループの課題\) の下のドロップダウン メニューを選んで、 **[Individual assignment]\(個人課題\)** をクリックします。 課題の作成後は、課題タイプを変更できません。 グループ課題を作成する場合は、「[グループ課題の作成](/education/manage-coursework-with-github-classroom/create-a-group-assignment)」をご覧ください。 +Under "Individual or group assignment", select the drop-down menu, and click **Individual assignment**. You can't change the assignment type after you create the assignment. If you'd rather create a group assignment, see "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." -### 課題リポジトリの可視性を選択する +### Choosing a visibility for assignment repositories + +{% data reusables.classroom.assignments-repository-visibility-and-permissions %} {% data reusables.classroom.assignments-guide-choose-visibility %} {% data reusables.classroom.assignments-guide-click-continue-after-basics %} -## スターターコードを追加し、開発環境を構成する +## Adding starter code and configuring a development environment {% data reusables.classroom.assignments-guide-intro-for-environment %} -- [テンプレートリポジトリを作成する](#choosing-a-template-repository) -- [統合開発環境 (IDE) を選択する](#choosing-an-integrated-development-environment-ide) +- [Choosing a template repository](#choosing-a-template-repository) +- [Choosing an integrated development environment (IDE)](#choosing-an-integrated-development-environment-ide) -### テンプレートリポジトリを作成する +### Choosing a template repository -デフォルトでは、新しい課題ではクラスルームの名簿に掲載されている各学生に対し、空のリポジトリが作成されます。 {% data reusables.classroom.you-can-choose-a-template-repository %} +By default, a new assignment will create an empty repository for each student on the roster for the classroom. {% data reusables.classroom.you-can-choose-a-template-repository %} {% data reusables.classroom.assignments-guide-choose-template-repository %} {% data reusables.classroom.assignments-guide-click-continue-after-starter-code-and-feedback %} -### 統合開発環境 (IDE) を選択する +### Choosing an integrated development environment (IDE) -{% data reusables.classroom.about-online-ides %}詳細については、「[{% data variables.product.prodname_classroom %} と IDE の統合](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)」を参照してください。 +{% data reusables.classroom.about-online-ides %} For more information, see "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)." {% data reusables.classroom.classroom-codespaces-link %} {% data reusables.classroom.assignments-guide-choose-an-online-ide %} -## 課題にフィードバックを行う +## Providing feedback for an assignment -必要に応じて、課題を自動的に採点し、各提出物を学生と議論するための場を作成できます。 +Optionally, you can automatically grade assignments and create a space for discussing each submission with the student. -- [課題を自動的にテストする](#testing-assignments-automatically) -- [フィードバックのために pull request を作成する](#creating-a-pull-request-for-feedback) +- [Testing assignments automatically](#testing-assignments-automatically) +- [Creating a pull request for feedback](#creating-a-pull-request-for-feedback) -### 課題を自動的にテストする +### Testing assignments automatically {% data reusables.classroom.assignments-guide-using-autograding %} -### フィードバックのためにプルリクエストを作成する +### Creating a pull request for feedback {% data reusables.classroom.you-can-create-a-pull-request-for-feedback %} @@ -106,34 +102,34 @@ ms.locfileid: '147573869' {% data reusables.classroom.assignments-guide-click-create-assignment-button %} -## 学生を課題に招待する +## Inviting students to an assignment {% data reusables.classroom.assignments-guide-invite-students-to-assignment %} -課題の **[クラスルームの名簿]** タブで、学生がクラスルームに参加して課題を受け取ったか、または提出したかを確認できます。 このタブでは、学生の {% data variables.product.prodname_dotcom %} エイリアスを関連する名簿識別子にリンクしたり、その逆にリンクしたりすることもできます。{% data reusables.classroom.assignments-to-prevent-submission %} +You can see whether a student has joined the classroom and accepted or submitted an assignment in the **Classroom roster** tab for the assignment. You can also link students' {% data variables.product.prodname_dotcom %} aliases to their associated roster identifier and vice versa in this tab. {% data reusables.classroom.assignments-to-prevent-submission %}
Individual assignment
-## 学生の進捗状況を監視する -課題の概要ページには、課題の受け入れと学生の進捗状況の概要が表示されます。 課題の構成に基づいて、表示される概要情報が異なる場合があります。 +## Monitoring students' progress +The assignment overview page provides an overview of your assignment acceptances and student progress. You may have different summary information based on the configurations of your assignments. -- **[名簿に登録された学生]** : Classroom の名簿に登録されている学生の数。 -- **[Added students]\(追加された学生\)** : 課題を受け入れていて、名簿識別子に関連付けられていない {% data variables.product.prodname_dotcom %} アカウントの数。 -- **[Accepted students]\(受け入れた学生\)** : この課題を受け入れたアカウントの数。 -- **[Assignment submissions]\(課題の提出\)** : 課題を提出した学生の数。 提出は、課題の期限にトリガーされます。 -- **[Passing students]\(合格した学生\)** : 現在、この課題の自動採点テストに合格している学生の数。 +- **Rostered students**: The number of students on the Classroom's roster. +- **Added students**: The number of {% data variables.product.prodname_dotcom %} accounts that have accepted the assignment and are not associated with a roster identifier. +- **Accepted students**: The number of accounts have accepted this assignment. +- **Assignment submissions**: The number of students that have submitted the assignment. Submission is triggered at the assignment deadline. +- **Passing students**: The number of students currently passing the autograding tests for this assignment. -## 次の手順 +## Next steps -- 課題を作成した後、学生はGitおよび{% data variables.product.product_name %}の機能を使用して課題を開始できます。 学生はリポジトリのクローン、コミットのプッシュ、ブランチの管理、プルリクエストの作成およびレビュー、マージコンフリクトへの対処、およびIssueの変更に関するディスカッションが可能です。 あなたも学生も、リポジトリのコミット履歴をレビューできます。 詳しくは、[{% data variables.product.prodname_dotcom %} の概要](/github/getting-started-with-github)、[リポジトリ](/repositories)、[issue と pull request での共同作業](/github/collaborating-with-issues-and-pull-requests)に関する記事をご覧ください。 +- Once you create the assignment, students can start work on the assignment using Git and {% data variables.product.product_name %}'s features. Students can clone the repository, push commits, manage branches, create and review pull requests, address merge conflicts, and discuss changes with issues. Both you and student can review the commit history for the repository. For more information, see "[Getting started with {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)," "[Repositories](/repositories)," and "[Collaborating with issues and pull requests](/github/collaborating-with-issues-and-pull-requests)." -- 課題を完了した学生がいる場合には、その学生のリポジトリにあるファイルをレビューできます。また、学生の作業についてをより深く理解するため、リポジトリの履歴や視覚化されたデータを確認できます。 詳細については、[グラフを使用したリポジトリ データの視覚化](/github/visualizing-repository-data-with-graphs)に関する記事を参照してください。 +- When a student finishes an assignment, you can review the files in the repository, or you can review the history and visualizations for the repository to better understand the student's work. For more information, see "[Visualizing repository data with graphs](/github/visualizing-repository-data-with-graphs)." -- プルリクエストの内の個々のコミットや行にコメントすることで、課題にフィードバックを行うことができます。 詳細については、「[pull request へコメントする](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)」および[コードから issue を開く方法](/github/managing-your-work-on-github/opening-an-issue-from-code)に関する記事を参照してください。 返信テンプレートを作成して一般的なエラーに関するフィードバックを提供する方法の詳細については、「[返信テンプレートについて](/github/writing-on-github/about-saved-replies)」を参照してください。 +- You can provide feedback for an assignment by commenting on individual commits or lines in a pull request. For more information, see "[Commenting on a pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)" and "[Opening an issue from code](/github/managing-your-work-on-github/opening-an-issue-from-code)." For more information about creating saved replies to provide feedback for common errors, see "[About saved replies](/github/writing-on-github/about-saved-replies)." -## 参考資料 +## Further reading -- 「[教師向け {% data variables.product.prodname_global_campus %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers)」 -- [学習管理システムを {% data variables.product.prodname_classroom %} に接続する](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom) +- "[{% data variables.product.prodname_global_campus %} for teachers](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers)" +- "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom)" diff --git a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md index f5b3ca880d..12c73693ca 100644 --- a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md +++ b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md @@ -11,6 +11,7 @@ children: - /use-the-git-and-github-starter-assignment - /create-an-individual-assignment - /create-a-group-assignment + - /editing-an-assignment - /reuse-an-assignment - /create-an-assignment-from-a-template-repository - /leave-feedback-with-pull-requests @@ -18,11 +19,11 @@ children: - /register-a-learning-management-system-with-github-classroom - /connect-a-learning-management-system-course-to-a-classroom shortTitle: Teach -ms.openlocfilehash: 8d2c7eb41a233af9ef331ae30daf97387a80b522 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 291aac6523c5df876e7e327aad962711cc82b003 +ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: '145112158' +ms.lasthandoff: 11/21/2022 +ms.locfileid: '148179750' --- diff --git a/translations/ja-JP/content/get-started/onboarding/getting-started-with-github-ae.md b/translations/ja-JP/content/get-started/onboarding/getting-started-with-github-ae.md index 0717b20b76..7a247d6c1c 100644 --- a/translations/ja-JP/content/get-started/onboarding/getting-started-with-github-ae.md +++ b/translations/ja-JP/content/get-started/onboarding/getting-started-with-github-ae.md @@ -19,7 +19,7 @@ You will first need to purchase {% data variables.product.product_name %}. For m After {% data variables.product.company_short %} creates the owner account for {% data variables.location.product_location %} on {% data variables.product.product_name %}, you will receive an email to sign in and complete the initialization. During initialization, you, as the enterprise owner, will name {% data variables.location.product_location %}, configure SAML SSO, create policies for all organizations in {% data variables.location.product_location %}, and configure a support contact for your enterprise members. For more information, see "[Initializing {% data variables.product.prodname_ghe_managed %}](/admin/configuration/configuring-your-enterprise/initializing-github-ae)." ### 3. Restricting network traffic -You can configure an allow list for specific IP addresses to restrict access to assets owned by organizations in your enterprise account. For more information, see "[Restricting network traffic to your enterprise](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise)." +You can configure an allow list for specific IP addresses to restrict access to assets owned by organizations in your enterprise account. For more information, see "[Restricting network traffic to your enterprise with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)." ### 4. Managing identity and access for {% data variables.location.product_location %} You can centrally manage access to {% data variables.location.product_location %} on {% data variables.product.product_name %} from an identity provider (IdP) using SAML single sign-on (SSO) for user authentication and System for Cross-domain Identity Management (SCIM) for user provisioning. Once you configure provisioning, you can assign or unassign users to the application from the IdP, creating or disabling user accounts in the enterprise. For more information, see "[About identity and access management for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-identity-and-access-management-for-your-enterprise)." diff --git a/translations/ja-JP/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server.md b/translations/ja-JP/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server.md index 56ce427eb4..5e075f9525 100644 --- a/translations/ja-JP/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server.md +++ b/translations/ja-JP/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server.md @@ -1,6 +1,6 @@ --- -title: Setting up a trial of GitHub Enterprise Server -intro: 'You can try {% data variables.product.prodname_ghe_server %} for free.' +title: GitHub Enterprise Server のトライアルを設定する +intro: '{% data variables.product.prodname_ghe_server %} のトライアルは無料でできます。' redirect_from: - /articles/requesting-a-trial-of-github-enterprise - /articles/setting-up-a-trial-of-github-enterprise-server @@ -13,45 +13,50 @@ versions: topics: - Accounts shortTitle: Enterprise Server trial +ms.openlocfilehash: 9beee350488bdf27beb7107deda3c44f560d29e9 +ms.sourcegitcommit: 0a6e3eee6eea9b1e445aea1e4461d64cf6b63218 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163558' --- +## {% data variables.product.prodname_ghe_server %} の試用版について -## About trials of {% data variables.product.prodname_ghe_server %} +{% data variables.product.prodname_ghe_server %} を評価するための 45 日間トライアルをリクエストできます。 トライアルは仮想アプライアンスとしてインストールされ、オンプレミスまたはクラウドでのデプロイメントのオプションがあります。 {% data variables.product.prodname_ghe_server %} に関する詳しい情報と、サポートされている仮想化プラットフォームの一覧については、「[{% data variables.product.prodname_ghe_server %} について](/enterprise-server/admin/overview/about-github-enterprise-server)」を参照してください。 -You can request a 45-day trial to evaluate {% data variables.product.prodname_ghe_server %}. Your trial will be installed as a virtual appliance, with options for on-premises or cloud deployment. For more information about {% data variables.product.prodname_ghe_server %}, and for a list of supported virtualization platforms, see "[About {% data variables.product.prodname_ghe_server %}](/enterprise-server/admin/overview/about-github-enterprise-server)." +{% ifversion ghes %}{% data variables.product.prodname_dependabot %}{% else %}セキュリティ{% endif %} アラートと {% data variables.product.prodname_github_connect %} は、{% data variables.product.prodname_ghe_server %} の試用版では現在利用できません。 これらの機能のデモについては、{% data variables.contact.contact_enterprise_sales %} にお問い合わせください。 これらの機能の詳細については、「[{% data variables.product.prodname_dependabot_alerts %} について](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」と「[エンタープライズ アカウントを {% data variables.product.prodname_ghe_cloud %} に接続する](/enterprise-server@latest/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud)」を参照してください。 -{% ifversion ghes %}{% data variables.product.prodname_dependabot %}{% else %}Security{% endif %} alerts and {% data variables.product.prodname_github_connect %} are not currently available in trials of {% data variables.product.prodname_ghe_server %}. For a demonstration of these features, contact {% data variables.contact.contact_enterprise_sales %}. For more information about these features, see "[About {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" and "[Connecting your enterprise account to {% data variables.product.prodname_ghe_cloud %}](/enterprise-server@latest/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud)." - -Trials are also available for {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Setting up a trial of {% data variables.product.prodname_ghe_cloud %}](/articles/setting-up-a-trial-of-github-enterprise-cloud)." +{% data variables.product.prodname_ghe_cloud %} のトライアルも利用できます。 詳細については、「[{% data variables.product.prodname_ghe_cloud %} の試用版を設定する](/articles/setting-up-a-trial-of-github-enterprise-cloud)」を参照してください。 {% data reusables.products.which-product-to-use %} -## Setting up your trial of {% data variables.product.prodname_ghe_server %} +## {% data variables.product.prodname_ghe_server %} のトライアルを設定する -{% data variables.product.prodname_ghe_server %} is installed as a virtual appliance. Determine the best person in your organization to set up a virtual machine, and ask that person to submit a [trial request](https://enterprise.github.com/trial). You can begin your trial immediately after submitting a request. +{% data variables.product.prodname_ghe_server %} は仮想アプライアンスとしてインストールされます。 組織で仮想マシンをセットアップするのに最適な担当者を決定し、その担当者に[試用版のリクエスト](https://enterprise.github.com/trial)をサブミットするよう依頼してください。 トライアルはリクエストをサブミットした直後に開始できます。 -To set up an account for the {% data variables.product.prodname_enterprise %} Web portal, click the link in the email you received after submitting your trial request, and follow the prompts. Then, download your license file. For more information, see "[Managing your license for {% data variables.product.prodname_enterprise %}](/enterprise-server@latest/billing/managing-your-license-for-github-enterprise)." +{% data variables.product.prodname_enterprise %} ウェブポータルのアカウントをセットアップするため、トライアルリクエストをサブミットした後に受信したメールにあるリンクをクリックして、プロンプトに従います。 次に、ライセンスファイルをダウンロードします。 詳細については、「[{% data variables.product.prodname_enterprise %} のライセンスの管理](/enterprise-server@latest/billing/managing-your-license-for-github-enterprise)」を参照してください。 -To install {% data variables.product.prodname_ghe_server %}, download the necessary components and upload your license file. For more information, see the instructions for your chosen visualization platform in "[Setting up a {% data variables.product.prodname_ghe_server %} instance](/enterprise-server@latest/admin/installation/setting-up-a-github-enterprise-server-instance)." +{% data variables.product.prodname_ghe_server %} をインストールするために必要なコンポーネントをダウンロードしてライセンスファイルをアップロードします。 詳細については、「[{% data variables.product.prodname_ghe_server %} インスタンスを設定する](/enterprise-server@latest/admin/installation/setting-up-a-github-enterprise-server-instance)」の選択した視覚化プラットフォームの手順を参照してください。 -## Next steps +## 次の手順 -To get the most out of your trial, follow these steps: +トライアルを最大限に活用するためには、次の手順に従ってください: -1. [Create an organization](/enterprise-server@latest/admin/user-management/creating-organizations). -2. To learn the basics of using {% data variables.product.prodname_dotcom %}, see: - - [Intro to {% data variables.product.prodname_dotcom %}](https://resources.github.com/devops/methodology/maximizing-devops-roi/) webcast - - [Understanding the {% data variables.product.prodname_dotcom %} flow](https://guides.github.com/introduction/flow/) in {% data variables.product.prodname_dotcom %} Guides - - [Hello World](https://guides.github.com/activities/hello-world/) in {% data variables.product.prodname_dotcom %} Guides - - "[About versions of {% data variables.product.prodname_docs %}](/get-started/learning-about-github/about-versions-of-github-docs)" -3. To configure your instance to meet your organization's needs, see "[Configuring your enterprise](/enterprise-server@latest/admin/configuration/configuring-your-enterprise)." -4. To integrate {% data variables.product.prodname_ghe_server %} with your identity provider, see "[Using SAML](/enterprise-server@latest/admin/user-management/using-saml)" and "[Using LDAP](/enterprise-server@latest/admin/authentication/using-ldap)." -5. Invite an unlimited number of people to join your trial. - - Add users to your {% data variables.product.prodname_ghe_server %} instance using built-in authentication or your configured identity provider. For more information, see "[Using built in authentication](/enterprise-server@latest/admin/user-management/using-built-in-authentication)." - - To invite people to become account administrators, visit the [{% data variables.product.prodname_enterprise %} Web portal](https://enterprise.github.com/login). +1. [組織の作成](/enterprise-server@latest/admin/user-management/creating-organizations)。 +2. {% data variables.product.prodname_dotcom %} の基本的な使い方を学ぶには、次を参照してください: + - [{% data variables.product.prodname_dotcom %} の概要](https://resources.github.com/devops/methodology/maximizing-devops-roi/) Web キャスト + - {% data variables.product.prodname_dotcom %} ガイドの [{% data variables.product.prodname_dotcom %} フローについて](https://guides.github.com/introduction/flow/) + - {% data variables.product.prodname_dotcom %} ガイドの [Hello World](https://guides.github.com/activities/hello-world/) + - 「[{% data variables.product.prodname_docs %} のバージョンについて](/get-started/learning-about-github/about-versions-of-github-docs)」 +3. 組織のニーズを満たすようにインスタンスを構成するには、「[エンタープライズの構成](/enterprise-server@latest/admin/configuration/configuring-your-enterprise)」を参照してください。 +4. {% data variables.product.prodname_ghe_server %} を ID プロバイダーと統合するには、「[SAML の使用](/enterprise-server@latest/admin/user-management/using-saml)」および「[LDAP の使用](/enterprise-server@latest/admin/authentication/using-ldap)」を参照してください。 +5. 個人をトライアルに招待します。人数制限はありません。 + - ビルトイン認証または設定済みアイデンティティプロバイダを使用して、ユーザを {% data variables.product.prodname_ghe_server %} インスタンスに追加します。 詳細については、「[ビルトイン認証を使用する](/enterprise-server@latest/admin/user-management/using-built-in-authentication)」を参照してください。 + - ユーザーをアカウント管理者に招待するには、[{% data variables.product.prodname_enterprise %} Web ポータル](https://enterprise.github.com/login)にアクセスします。 {% note %} - **Note:** People you invite to become account administrators will receive an email with a link to accept your invitation. + **注:** アカウント管理者になるよう招待された個人は、招待を承諾するためのリンクを含むメールを受信します。 {% endnote %} @@ -59,12 +64,12 @@ To get the most out of your trial, follow these steps: {% data reusables.products.product-roadmap %} -## Finishing your trial +## トライアルを終了する -You can upgrade to full licenses in the [{% data variables.product.prodname_enterprise %} Web portal](https://enterprise.github.com/login) at any time during the trial period. +試用期間中いつでも [{% data variables.product.prodname_enterprise %} Web ポータル](https://enterprise.github.com/login)でフル ライセンスにアップグレードできます。 -If you haven't upgraded by the last day of your trial, you'll receive an email notifying you that your trial had ended. If you need more time to evaluate {% data variables.product.prodname_enterprise %}, contact {% data variables.contact.contact_enterprise_sales %} to request an extension. +トライアル最終日になってもアップグレードしていない場合、トライアルが終了したことを通知するメールが送信されます。 {% data variables.product.prodname_enterprise %} を評価するための時間がさらに必要な場合は、{% data variables.contact.contact_enterprise_sales %} に連絡して延長をリクエストしてください。 -## Further reading +## 参考資料 -- "[Setting up a trial of {% data variables.product.prodname_ghe_cloud %}](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud)" +- 「[{% data variables.product.prodname_ghe_cloud %} の試用版を設定する](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud)」 diff --git a/translations/ja-JP/content/get-started/using-github/github-command-palette.md b/translations/ja-JP/content/get-started/using-github/github-command-palette.md index c169b3d97e..06e79b29e1 100644 --- a/translations/ja-JP/content/get-started/using-github/github-command-palette.md +++ b/translations/ja-JP/content/get-started/using-github/github-command-palette.md @@ -1,229 +1,234 @@ --- -title: GitHub Command Palette -intro: 'Use the command palette in {% data variables.product.product_name %} to navigate, search, and run commands directly from your keyboard.' +title: GitHub コマンド パレット +intro: '{% data variables.product.product_name %} のコマンド パレットを使って、キーボードから直接移動、検索、コマンドの実行を行います。' versions: feature: command-palette shortTitle: GitHub Command Palette +ms.openlocfilehash: 5c6b739f2422be780cef6fa0e44e5d75663cc036 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159054' --- - {% data reusables.command-palette.beta-note %} -## About the {% data variables.product.prodname_command_palette %} +## {% data variables.product.prodname_command_palette %} について -You can navigate, search, and run commands on {% data variables.product.product_name %} with the {% data variables.product.prodname_command_palette %}. The command palette is an on-demand way to show suggestions based on your current context and resources you've used recently. You can open the command palette with a keyboard shortcut from anywhere on {% data variables.product.product_name %}, which saves you time and keeps your hands on the keyboard. +{% data variables.product.prodname_command_palette %} を使って、{% data variables.product.product_name %} で移動、検索、コマンドを実行できます。 コマンド パレットは、現在のコンテキストと最近使ったリソースに基づく候補を表示するオンデマンドの方法です。 コマンド パレットは、{% data variables.product.product_name %} の任意の場所からキーボード ショートカットで開くことができるので、時間を節約してキーボードから手を離さずにいることができます。 -### Fast navigation +### 高速ナビゲーション -When you open the command palette, the suggestions are optimized to give you easy access from anywhere in a repository, personal account, or organization to top-level pages like the Issues page. If the location you want isn't listed, start entering the name or number for the location to refine the suggestions. +コマンド パレットを開くと、リポジトリ、個人アカウント、組織のどこからでも issue ページなどのトップレベルのページに簡単にアクセスできるように、候補が最適化されています。 目的の場所が一覧表示されていない場合は、場所の名前または番号を入力し始めると、候補が絞り込まれます。 -![Command palette repository suggestions](/assets/images/help/command-palette/command-palette-navigation-repo-default.png) +![コマンド パレット リポジトリの候補](/assets/images/help/command-palette/command-palette-navigation-repo-default.png) -### Easy access to commands +### コマンドへの簡単なアクセス -The ability to run commands directly from your keyboard, without navigating through a series of menus, may change the way you use {% data variables.product.prodname_dotcom %}. For example, you can switch themes with a few keystrokes, making it easy to toggle between themes as your needs change. +メニューから操作することなく、キーボードから直接コマンドを実行できるため、{% data variables.product.prodname_dotcom %} の使い方が変わるかもしれません。 たとえば、数回のキー操作でテーマを切り替えられるので、ニーズの変化に応じて簡単にテーマを切り替えることができます。 -![Command palette change theme](/assets/images/help/command-palette/command-palette-command-change-theme.png) +![コマンド パレットのテーマの変更](/assets/images/help/command-palette/command-palette-command-change-theme.png) -## Opening the {% data variables.product.prodname_command_palette %} +## {% data variables.product.prodname_command_palette %} を開く -Open the command palette using one of the following default keyboard shortcuts: -- Windows and Linux: Ctrl+K or Ctrl+Alt+K -- Mac: Command+K or Command+Option+K +コマンド パレットを開くには、次の既定のキーボード ショートカットのいずれかを使います。 +- Windows と Linux: Ctrl+K または Ctrl+Alt+K +- Mac: Command+K または Command+Option+K -You can customize the keyboard shortcuts you use to open the command palette in the [Accessibility section](https://github.com/settings/accessibility) of your user settings. For more information, see "[Customizing your {% data variables.product.prodname_command_palette %} keyboard shortcuts](#customizing-your-github-command-palette-keyboard-shortcuts)." +コマンド パレットを開くためのキーボード ショートカットは、ユーザー設定の [[アクセシビリティ セクション]](https://github.com/settings/accessibility) でカスタマイズすることができます。 詳細については「[{% data variables.product.prodname_command_palette %} キーボード ショートカットのカスタマイズ](#customizing-your-github-command-palette-keyboard-shortcuts)」を参照してください。 -When you open the command palette, it shows your location at the top left and uses it as the scope for suggestions (for example, the `mashed-avocado` organization). +コマンド パレットを開くと、左上隅に場所が表示され、それを候補のスコープとして使います (たとえば、`mashed-avocado` 組織)。 -![Command palette launch](/assets/images/help/command-palette/command-palette-launch.png) +![コマンド パレットの起動](/assets/images/help/command-palette/command-palette-launch.png) {% note %} -**Notes:** -- If you are editing Markdown text, open the command palette with Ctrl+Alt+K (Windows and Linux) or Command+Option+K (Mac).{% ifversion projects-v2 %} -- If you are working on a {% data variables.projects.project_v2 %}, a project-specific command palette is displayed instead. For more information, see "[Customizing a view](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)."{% endif %} +**注:** +- Markdown テキストを編集している場合、Ctrl+Alt+K キー (Windows および Linux) または Command+Option+K キー (Mac) を使用してコマンド パレットを開きます。{% ifversion projects-v2 %} +- {% data variables.projects.project_v2 %} で作業している場合は、代わりにプロジェクト固有のコマンド パレットが表示されます。 詳しい情報については、「[ビューのカスタマイズ](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)」を参照してください。{% endif %} {% endnote %} -### Customizing your {% data variables.product.prodname_command_palette %} keyboard shortcuts +### {% data variables.product.prodname_command_palette %} キーボード ショートカットのカスタマイズ -The default keyboard shortcuts used to open the command palette may conflict with your default OS and browser keyboard shortcuts. You have the option to customize your keyboard shortcuts in the [Accessibility section](https://github.com/settings/accessibility) of your account settings. In the command palette settings, you can customize the keyboard shortcuts for opening the command palette in both search mode and command mode. +コマンド パレットを開くための既定のキーボード ショートカットは、OS とブラウザーの既定のキーボード ショートカットと競合する場合があります。 アカウント設定の [[アクセシビリティ セクション]](https://github.com/settings/accessibility) に、キーボード ショートカットをカスタマイズするオプションがあります。 コマンド パレットの設定では、検索モードとコマンド モードの両方でコマンド パレットを開くためのキーボード ショートカットをカスタマイズできます。 -![Command palette keyboard shortcut settings](/assets/images/help/command-palette/command-palette-keyboard-shortcut-settings.png) -## Navigating with the {% data variables.product.prodname_command_palette %} +![コマンド パレットのキーボード ショートカット設定](/assets/images/help/command-palette/command-palette-keyboard-shortcut-settings.png) +## {% data variables.product.prodname_command_palette %} による移動 -You can use the command palette to navigate to any page that you have access to on {% data variables.product.product_name %}. +コマンド パレットを使うと、{% data variables.product.product_name %} でアクセスできる任意のページに移動できます。 {% data reusables.command-palette.open-palette %} -2. Start typing the path you want to navigate to. The suggestions in the command palette change to match your text. +2. 移動したいパスの入力を開始します。 コマンド パレットの候補は、テキストに合わせて変化します。 - ![Command palette navigation current scope](/assets/images/help/command-palette/command-palette-navigation-current-scope.png) + ![コマンド パレット ナビゲーションの現在のスコープ](/assets/images/help/command-palette/command-palette-navigation-current-scope.png) {% data reusables.command-palette.change-scope %} - You can also use keystrokes to narrow your search. For more information, see "[Keystroke functions](#keystroke-functions)." + キー入力による絞り込み検索もできます。 詳細については、「[キー入力関数](#keystroke-functions)」を参照してください。 -4. Finish entering the path, or use the arrow keys to highlight the path you want from the list of suggestions. +4. パスの入力を完了するか、方向キーを使って候補の中から必要なパスを強調表示します。 -5. Use Enter to jump to your chosen location. Alternatively, use Ctrl+Enter (Windows and Linux) or Command+Enter (Mac) to open the location in a new browser tab. +5. Enter キーで選んだ場所にジャンプします。 または、Ctrl+Enter (Windows と Linux) または Command+Enter (Mac) を使って、新しいブラウザー タブで場所を開きます。 -## Searching with the {% data variables.product.prodname_command_palette %} +## {% data variables.product.prodname_command_palette %} を使用した検索 -You can use the command palette to search for anything on {% data variables.location.product_location %}. +コマンド パレットを使用して、{% data variables.location.product_location %} からすべてのことを検索できます。 {% data reusables.command-palette.open-palette %} {% data reusables.command-palette.change-scope %} -3. Optionally, use keystrokes to find specific types of resource: +3. 必要に応じて、キー ストロークを使用して特定の種類のリソースを検索します。 - - # Search for issues, pull requests, discussions, and projects - - ! Search for projects - - @ Search for users, organizations, and repositories - - / Search for files within a repository scope + - # issue、pull request、ディスカッション、プロジェクトを検索する + - ! プロジェクトを検索する + - @ ユーザー、組織、リポジトリを管理する + - / リポジトリ スコープ内のファイルを検索する - ![Command palette search files](/assets/images/help/command-palette/command-palette-search-files.png) + ![コマンド パレットのファイル検索](/assets/images/help/command-palette/command-palette-search-files.png) -4. Begin entering your search terms. The command palette will offer you a range of suggested searches based on your search scope. +4. 検索語句の入力を開始します。 コマンド パレットでは、ユーザーの検索範囲に基づいて、一連の検索語の候補が表示されます。 {% tip %} - You can also use the full syntax of {% data variables.product.prodname_dotcom %}'s integrated search within the command palette. For more information, see "[Searching for information on {% data variables.product.prodname_dotcom %}](/search-github)." + コマンド パレット内で {% data variables.product.prodname_dotcom %} の統合検索の完全な構文を使用することもできます。 詳細については、「[{% data variables.product.prodname_dotcom %} での情報の検索](/search-github)」を参照してください。 {% endtip %} -5. Use the arrow keys to highlight the search result you want and use Enter to jump to your chosen location. Alternatively, use Ctrl+Enter (Windows and Linux) or Command+Enter (Mac) to open the location in a new browser tab. +5. 矢印キーを使用して目的の検索結果を強調表示し、Enter キーを使用して選択した場所にジャンプします。 または、Ctrl+Enter (Windows と Linux) または Command+Enter (Mac) を使って、新しいブラウザー タブで場所を開きます。 -## Running commands from the {% data variables.product.prodname_command_palette %} +## {% data variables.product.prodname_command_palette %} からのコマンドの実行 -You can use the {% data variables.product.prodname_command_palette %} to run commands. For example, you can create a new repository or issue, or change your theme. When you run a command, the location for its action is determined by either the underlying page or the scope shown in the command palette. +{% data variables.product.prodname_command_palette %} を使用してコマンドを実行できます。 たとえば、新しいリポジトリや issue を作成したり、テーマを変更したりできます。 コマンドを実行する際、そのアクションの対象となる場所は、基になるページ、またはコマンド パレットに表示されるスコープによって決まります。 -- Pull request and issue commands always run on the underlying page. -- Higher-level commands, for example, repository commands, run in the scope shown in the command palette. +- pull request コマンドと issue コマンドは、常に基になるページで実行されます。 +- リポジトリ コマンドなどの上位レベル コマンドは、コマンド パレットに表示されているスコープで実行されます。 -For a full list of supported commands, see "[{% data variables.product.prodname_command_palette %} reference](#github-command-palette-reference)." +サポートされているコマンドの完全な一覧については、「[{% data variables.product.prodname_command_palette %} リファレンス](#github-command-palette-reference)」を参照してください。 -1. The default keyboard shortcuts to open the command palette in command mode are Ctrl+Shift+K (Windows and Linux) or Command+Shift+K (Mac). If you already have the command palette open, press > to switch to command mode. {% data variables.product.prodname_dotcom %} suggests commands based on your location. +1. コマンド パレットをコマンド モードで開くための既定のキーボード ショートカットは、Ctrl+Shift+K (Windows および Linux) または Command+Shift+K (Mac) です。 コマンド パレットを既に開いている場合は、> を押してコマンド モードに切り替えます。 {% data variables.product.prodname_dotcom %} では、ユーザーの場所に基づいてコマンドが提案されます。 - ![Command palette command mode](/assets/images/help/command-palette/command-palette-command-mode.png) + ![コマンド パレットのコマンド モード](/assets/images/help/command-palette/command-palette-command-mode.png) {% data reusables.command-palette.change-scope %} -3. If the command you want is not displayed, check your scope then start entering the command name in the text box. +3. 目的のコマンドが表示されない場合は、スコープを確認した後、テキスト ボックスでコマンド名の入力を開始します。 -4. Use the arrow keys to highlight the command you want and use Enter to run it. +4. 方向キーを使用して目的のコマンドを強調表示し、Enter キーを使用して実行します。 -## Closing the command palette +## コマンド パレットの終了 -When the command palette is active, you can use one of the following keyboard shortcuts to close the command palette: +コマンド パレットがアクティブな場合は、次のいずれかのキーボード ショートカットを使用してコマンド パレットを閉じます。 -- Search and navigation mode: Esc or Ctrl+K (Windows and Linux) Command+K (Mac) -- Command mode: Esc or Ctrl+Shift+K (Windows and Linux) Command+Shift+K (Mac) +- 検索およびナビゲーション モード: Esc または Ctrl+K (Windows および Linux) Command+K (Mac) +- コマンド モード: Esc または Ctrl+Shift+K (Windows および Linux) Command+Shift+K (Mac) -If you have customized the command palette keyboard shortcuts in the Accessibility settings, your customized keyboard shortcuts will be used for both opening and closing the command palette. +アクセシビリティ設定でコマンド パレットのキーボード ショートカットをカスタマイズした場合、カスタマイズしたキーボード ショートカットは、コマンド パレットの開閉の両方に使用されます。 -## {% data variables.product.prodname_command_palette %} reference +## {% data variables.product.prodname_command_palette %} リファレンス -### Keystroke functions +### キーストローク関数 -These keystrokes are available when the command palette is in navigation and search modes, that is, they are not available in command mode. +これらのキーストロークは、コマンド パレットがナビゲーション モードと検索モードにある場合、つまりコマンド モードでは使用できない場合に使用できます。 -| Keystroke | Function | +| キー操作 | 機能 | | :- | :- | -|>| Enter command mode. For more information, see "[Running commands from the {% data variables.product.prodname_command_palette %}](#running-commands-from-the-github-command-palette)." | -|#| Search for issues, pull requests, discussions, and projects. For more information, see "[Searching with the {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)."| -|@| Search for users, organizations, and repositories. For more information, see "[Searching with the {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)."| -|/| Search for files within a repository scope or repositories within an organization scope. For more information, see "[Searching with the {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)." | -|!| Search just for projects. For more information, see "[Searching with the {% data variables.product.prodname_command_palette %}](#searching-with-the-github-command-palette)."| -|Ctrl+C or Command+C| Copy the search or navigation URL for the highlighted result to the clipboard.| -|Enter| Jump to the highlighted result or run the highlighted command.| -|Ctrl+Enter or Command+Enter| Open the highlighted search or navigation result in a new brower tab.| -|?| Display help within the command palette.| +|>| コマンド モードを開始します。 詳細については、「[{% data variables.product.prodname_command_palette %} からのコマンドの実行](#running-commands-from-the-github-command-palette)」を参照してください。 | +|#| issue、pull request、ディスカッション、プロジェクトを検索します。 詳細については、「[{% data variables.product.prodname_command_palette %} を使用した検索](#searching-with-the-github-command-palette)」を参照してください。| +|@| ユーザー、組織、リポジトリを管理します。 詳細については、「[{% data variables.product.prodname_command_palette %} を使用した検索](#searching-with-the-github-command-palette)」を参照してください。| +|/| リポジトリ スコープ内のファイル、または組織スコープ内のリポジトリを検索します。 詳細については、「[{% data variables.product.prodname_command_palette %} を使用した検索](#searching-with-the-github-command-palette)」を参照してください。 | +|!| プロジェクトのみを検索します。 詳細については、「[{% data variables.product.prodname_command_palette %} を使用した検索](#searching-with-the-github-command-palette)」を参照してください。| +|Ctrl+C または Command+C| 強調表示された結果の検索 URL またはナビゲーション URL をクリップボードにコピーします。| +|Enter| 強調表示された結果に移動するか、強調表示されたコマンドを実行します。| +|Ctrl+Enter または Command+Enter| 強調表示された検索またはナビゲーションの結果を新しいブラウザー タブで開きます。| +|?| コマンド パレット内にヘルプを表示します。| -### Global commands +### グローバル コマンド -These commands are available from all scopes. +これらのコマンドは、すべてのスコープから使用できます。 -| Command | Behavior| +| コマンド | 動作| | :- | :- | :- | -|`Import repository`|Create a new repository by importing a project from another version control system. For more information, see "[Importing a repository with GitHub importer](/get-started/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer)." | -|`New gist`|Open a new gist. For more information, see "[Creating a gist](/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists)." | -|`New organization`|Create a new organization. For more information, see "[Creating a new organization from scratch](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)." | -|`New project`|Create a new project board. For more information, see "[Creating a project](/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project)." | -|`New repository`|Create a new repository from scratch. For more information, see "[Creating a new repository](/repositories/creating-and-managing-repositories/creating-a-new-repository)." | -|`Switch theme to `|Change directly to a different theme for the UI. For more information, see "[Managing your theme settings](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-your-theme-settings)." | +|`Import repository`|別のバージョン管理システムからプロジェクトをインポートして、新しいリポジトリを作成します。 詳細については、「[GitHub Importer でリポジトリをインポートする](/get-started/importing-your-projects-to-github/importing-source-code-to-github/importing-a-repository-with-github-importer)」を参照してください。 | +|`New gist`|新しい gist を開きます。 詳細については、「[Gist の作成](/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists)」を参照してください。 | +|`New organization`|新しい組織を作成します。 詳細については、「[新しい Organization をゼロから作成](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)」を参照してください。 | +|`New project`|新しいプロジェクト ボードを作成します。 詳細については、「[プロジェクトの作成](/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project)」を参照してください。 | +|`New repository`|新しいリポジトリを最初から作成します。 詳細については、「[新しいリポジトリの作成](/repositories/creating-and-managing-repositories/creating-a-new-repository)」を参照してください。 | +|`Switch theme to `|UI の別のテーマに直接変更します。 詳細については、「[テーマ設定を管理する](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-your-theme-settings)」を参照してください。 | -### Organization commands +### 組織コマンド -These commands are available only within the scope of an organization. +これらのコマンドは、組織スコープ内でのみ使用できます。 -| Command | Behavior| +| コマンド | 動作| | :- | :- | -| `New team`| Create a new team in the current organization. For more information, see "[Creating a team](/organizations/organizing-members-into-teams/creating-a-team)." +| `New team`| 現在の組織に新しいチームを作成します。 詳細については、「[チームを作成する](/organizations/organizing-members-into-teams/creating-a-team)」を参照してください。 -### Repository commands +### リポジトリ コマンド -Most of these commands are available only on the home page of the repository. If a command is also available on other pages, this is noted in the behavior column. +これらのコマンドのほとんどは、リポジトリのホーム ページでのみ使用できます。 コマンドが他のページでも使用できる場合は、動作列にその旨を記します。 -| Command | Behavior| +| コマンド | 動作| | :- | :- | -|`Clone repository: `|Copy the URL needed to clone the repository using {% data variables.product.prodname_cli %}, HTTPS, or SSH to the clipboard. For more information, see "[Cloning a repository](/repositories/creating-and-managing-repositories/cloning-a-repository)."| -|`New discussion`|Create a new discussion in the repository. For more information, see "[Creating a new discussion](/discussions/quickstart#creating-a-new-discussion)."| -|`New file`|Create a new file from any page in the repository. For more information, see "[Adding a file to a repository](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository)." -|`New issue`|Open a new issue from any page in the repository. For more information, see "[Creating an issue](/issues/tracking-your-work-with-issues/creating-an-issue)."| -|`Open in new codespace`|Create and open a codespace for this repository. For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)."| -|`Open in github.dev editor`|Open the current repository in the github.dev editor. For more information, see "[Opening the web based editor](/codespaces/the-githubdev-web-based-editor#opening-the-web-based-editor)."| +|`Clone repository: `|{% data variables.product.prodname_cli %}、HTTPS、または SSH を使用してリポジトリを複製するために必要な URL をクリップボードにコピーします。 詳細については、「[リポジトリをクローンする](/repositories/creating-and-managing-repositories/cloning-a-repository)」を参照してください。| +|`New discussion`|リポジトリに新しいディスカッションを作成します。 詳細については、「[新しいディスカッションを作成する](/discussions/quickstart#creating-a-new-discussion)」を参照してください。| +|`New file`|リポジトリ内の任意のページから新しいファイルを作成します。 詳細については、「[リポジトリにファイルを追加する](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository)」を参照してください。 +|`New issue`|リポジトリ内の任意のページから新しい issue を開きます。 詳細については、「[Issue の作成](/issues/tracking-your-work-with-issues/creating-an-issue)」を参照してください。| +|`Open in new codespace`|このリポジトリのコードスペースを作成して開きます。 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)」を参照してください。| +|`Open in github.dev editor`|github.dev エディターで現在のリポジトリを開きます。 詳細については、「[Web ベースのエディターを開く](/codespaces/the-githubdev-web-based-editor#opening-the-web-based-editor)」を参照してください。| -### File commands +### ファイル コマンド -These commands are available only when you open the command palette from a file in a repository. +これらのコマンドは、リポジトリ内のファイルからコマンド パレットを開く場合にのみ使用できます。 -| Command | Behavior| +| コマンド | 動作| | :- | :- | -|`Copy permalink`|Create a link to the file that includes the current commit SHA and copy the link to the clipboard. For more information, see "[Getting permanent links to files](/repositories/working-with-files/using-files/getting-permanent-links-to-files#press-y-to-permalink-to-a-file-in-a-specific-commit)." -|`Open in github.dev editor`|Open the currently displayed file in github.dev editor. For more information, see "[Opening the web based editor](/codespaces/the-githubdev-web-based-editor#opening-the-web-based-editor)."| +|`Copy permalink`|現在のコミット SHA を含むファイルへのリンクを作成し、リンクをクリップボードにコピーします。 詳細については、「[ファイルへのパーマリンクを取得する](/repositories/working-with-files/using-files/getting-permanent-links-to-files#press-y-to-permalink-to-a-file-in-a-specific-commit)」を参照してください。 +|`Open in github.dev editor`|現在表示されているファイルを github.dev エディターで開きます。 詳細については、「[Web ベースのエディターを開く](/codespaces/the-githubdev-web-based-editor#opening-the-web-based-editor)」を参照してください。| -### Discussion commands +### ディスカッション コマンド -These commands are available only when you open the command palette from a discussion. They act on your current page and are not affected by the scope set in the command palette. +これらのコマンドは、ディスカッションからコマンド パレットを開く場合にのみ使用できます。 これらは現在のページで動作し、コマンド パレットで設定されたスコープの影響を受けません。 -| Command | Behavior| +| コマンド | 動作| | :- | :- | -|`Delete discussion...`|Permanently delete the discussion. For more information, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)." -|`Edit discussion body`|Open the main body of the discussion ready for editing. -|`Subscribe`/`unsubscribe`|Opt in or out of notifications for additions to the discussion. For more information, see "[About notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)." -|`Transfer discussion...`|Move the discussion to a different repository. For more information, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions#transferring-a-discussion)." +|`Delete discussion...`|ディスカッションを完全に削除します。 詳しくは、「[ディスカッションの管理](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)」を参照してください。 +|`Edit discussion body`|編集する準備ができているディスカッションの本文を開きます。 +|`Subscribe`/`unsubscribe`|ディスカッションへの追加の通知をオプトインまたはオプトアウトします。 詳細については、「[通知について](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)」を参照してください。 +|`Transfer discussion...`|ディスカッションを別のリポジトリに移動します。 詳しくは、「[ディスカッションの管理](/discussions/managing-discussions-for-your-community/managing-discussions#transferring-a-discussion)」を参照してください。 -### Issue commands +### issue コマンド -These commands are available only when you open the command palette from an issue. They act on your current page and are not affected by the scope set in the command palette. +これらのコマンドは、issue からコマンド パレットを開く場合にのみ使用できます。 これらは現在のページで動作し、コマンド パレットで設定されたスコープの影響を受けません。 -| Command | Behavior| +| コマンド | 動作| | :- | :- | -|`Close`/`reopen issue`|Close or reopen the current issue. For more information, see "[About issues](/issues/tracking-your-work-with-issues/about-issues)."| -|`Convert issue to discussion...`|Convert the current issue into a discussion. For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)." -|`Delete issue...`|Delete the current issue. For more information, see "[Deleting an issue](/issues/tracking-your-work-with-issues/deleting-an-issue)."| -|`Edit issue body`|Open the main body of the issue ready for editing. -|`Edit issue title`|Open the title of the issue ready for editing. -|`Lock issue`|Limit new comments to users with write access to the repository. For more information, see "[Locking conversations](/communities/moderating-comments-and-conversations/locking-conversations)." -|`Pin`/`unpin issue`|Change whether or not the issue is shown in the pinned issues section for the repository. For more information, see "[Pinning an issue to your repository](/issues/tracking-your-work-with-issues/pinning-an-issue-to-your-repository)."| -|`Subscribe`/`unsubscribe`|Opt in or out of notifications for changes to this issue. For more information, see "[About notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)." -|`Transfer issue...`|Transfer the issue to another repository. For more information, see "[Transferring an issue to another repository](/issues/tracking-your-work-with-issues/transferring-an-issue-to-another-repository)."| +|`Close`/`reopen issue`|現在の issue を閉じるか、もう一度開きます。 詳細については、「[Issue について](/issues/tracking-your-work-with-issues/about-issues)」を参照してください。| +|`Convert issue to discussion...`|現在の issue をディスカッションに変換します。 詳細については、「[ディスカッションをモデレートする](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)」を参照してください。 +|`Delete issue...`|現在の issue を削除します。 詳細については、「[Issue の削除](/issues/tracking-your-work-with-issues/deleting-an-issue)」を参照してください。| +|`Edit issue body`|編集する準備ができている issue の本文を開きます。 +|`Edit issue title`|編集する準備ができている issue のタイトルを開きます。 +|`Lock issue`|リポジトリへの書き込みアクセス権を持つユーザーへの新しいコメントを制限します。 詳細については、[会話のロック](/communities/moderating-comments-and-conversations/locking-conversations)に関するページを参照してください。 +|`Pin`/`unpin issue`|リポジトリのピン留めされた issue セクションに issue が表示されるかどうかを変更します。 詳細については、「[Issue をリポジトリにピン止めする](/issues/tracking-your-work-with-issues/pinning-an-issue-to-your-repository)」を参照してください。| +|`Subscribe`/`unsubscribe`|この issue に対する変更についての通知をオプトインまたはオプトアウトします。 詳細については、「[通知について](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)」を参照してください。 +|`Transfer issue...`|issue を別のリポジトリに転送します。 詳細については、「[Transferring an issue to another repository (Issue を別のリポジトリに転送する)](/issues/tracking-your-work-with-issues/transferring-an-issue-to-another-repository)」を参照してください。| -### Pull request commands +### pull request コマンド -These commands are available only when you open the command palette from a pull request. They act on your current page and are not affected by the scope set in the command palette. +これらのコマンドは、pull request からコマンド パレットを開く場合にのみ使用できます。 これらは現在のページで動作し、コマンド パレットで設定されたスコープの影響を受けません。 -| Command | Behavior| +| コマンド | 動作| | :- | :- | -|`Close`/`reopen pull request`|Close or reopen the current pull request. For more information, see "[About pull requests](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)."| -|`Convert to draft`/`Mark pull request as ready for review`|Change the state of the pull request to show it as ready, or not ready, for review. For more information, see "[Changing the state of a pull request](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request)."| -|`Copy current branch name`| Add the name of the head branch for the pull request to the clipboard. -|`Edit pull request body`|Open the main body of the pull request ready for editing. -|`Edit pull request title`|Open the title of the pull request ready for editing. -|`Open in new codespace`|Create and open a codespace for the head branch of the pull request. For more information, see "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)." -|`Subscribe`/`unsubscribe`|Opt in or out of notifications for changes to this pull request. For more information, see "[About notifications](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)." -|`Update current branch`|Update the head branch of the pull request with changes from the base branch. This is available only for pull requests that target the default branch of the repository. For more information, see "[About branches](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches)."| +|`Close`/`reopen pull request`|現在の pull request を閉じるか、もう一度開きます。 詳細については、「[pull request について](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)」を参照してください。| +|`Convert to draft`/`Mark pull request as ready for review`|pull request の状態を変更して、レビューの準備ができているか、準備ができていない状態として表示します。 詳細については、[pull request の状態変更](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request)に関するページを参照してください。| +|`Copy current branch name`| pull request のヘッド ブランチの名前をクリップボードに追加します。 +|`Edit pull request body`|編集の準備ができている pull request の本文を開きます。 +|`Edit pull request title`|編集の準備ができている pull request のタイトルを開きます。 +|`Open in new codespace`|pull request のヘッド ブランチのコードスペースを作成して開きます。 詳しくは、「[リポジトリの codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)」を参照してください。 +|`Subscribe`/`unsubscribe`|この pull request に対する変更についての通知をオプトインまたはオプトアウトします。 詳細については、「[通知について](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)」を参照してください。 +|`Update current branch`|pull request のヘッド ブランチを、ベース ブランチからの変更内容で更新します。 これは、リポジトリの既定のブランチを対象とする pull request でのみ使用できます。 詳細については、[ブランチについて](/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches)のページを参照してください。| diff --git a/translations/ja-JP/content/get-started/using-github/keyboard-shortcuts.md b/translations/ja-JP/content/get-started/using-github/keyboard-shortcuts.md index 416cf4f6d1..86dec80403 100644 --- a/translations/ja-JP/content/get-started/using-github/keyboard-shortcuts.md +++ b/translations/ja-JP/content/get-started/using-github/keyboard-shortcuts.md @@ -21,10 +21,11 @@ Typing ? on {% data variables.product.prodname_dotcom %} brings up a {% ifversion keyboard-shortcut-accessibility-setting %} You can disable character key shortcuts, while still allowing shortcuts that use modifier keys, in your accessibility settings. For more information, see "[Managing accessibility settings](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-accessibility-settings)."{% endif %} -Below is a list of some of the available keyboard shortcuts. {% ifversion command-palette %} The {% data variables.product.prodname_command_palette %} also gives you quick access to a wide range of actions, without the need to remember keyboard shortcuts. For more information, see "[{% data variables.product.prodname_command_palette %}](/get-started/using-github/github-command-palette)."{% endif %} +The following sections list some of the available keyboard shortcuts, organized by the pages where you can use them on {% data variables.location.product_location %}. + ## Site wide shortcuts | Keyboard shortcut | Description @@ -130,16 +131,14 @@ For more keyboard shortcuts, see the [CodeMirror documentation](https://codemirr |Shift and click | When creating an issue from a task list, open the new issue form in a new tab by holding Shift and clicking the {% octicon "issue-opened" aria-label="The issue opened icon" %} in the upper-right corner of the task. For more information, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)." |Command and click (Mac) or
Ctrl+Shift and click (Windows/Linux) | When creating an issue from a task list, open the new issue form in the new window by holding Command or Ctrl+Shift and clicking the {% octicon "issue-opened" aria-label="The issue opened icon" %} in the upper-right corner of the task. For more information, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)."{% endif %} -## Changes in pull requests +## "Files changed" tab in pull requests | Keyboard shortcut | Description |-----------|------------ -|C | Open the list of commits in the pull request -|T | Open the list of changed files in the pull request -|J | Move selection down in the list -|K | Move selection up in the list -|Command+Shift+Enter | Add a single comment on a pull request diff | -|Alt and click | Toggle between collapsing and expanding all outdated review comments in a pull request by holding down Alt and clicking **Show outdated** or **Hide outdated**.| +|C | Open the **Commits** dropdown menu to filter which commits are shown in the diffs +|T | Move your cursor to the "Filter changed files" field +|Command+Shift+Enter (Mac) or Ctrl+Shift+Enter (Windows/Linux) | Submit a review comment | +|Option and click (Mac) or Alt and click (Windows/Linux) | Toggle between collapsing and expanding all outdated or resolved review comments in a pull request (for example, by holding down Alt and clicking **Show outdated** or **Hide outdated**) | |Click, then Shift and click | Comment on multiple lines of a pull request by clicking a line number, holding Shift, then clicking another line number. For more information, see "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request)."| {% ifversion projects-v2 %} diff --git a/translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md b/translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md new file mode 100644 index 0000000000..2b4495efc3 --- /dev/null +++ b/translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md @@ -0,0 +1,81 @@ +--- +title: About task lists +intro: 'You can use task lists to break the work for an issue or pull request into smaller tasks, then track the full set of work to completion.' +redirect_from: + - /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/about-task-lists + - /articles/about-task-lists + - /github/managing-your-work-on-github/about-task-lists + - /issues/tracking-your-work-with-issues/creating-issues/about-task-lists + - /issues/tracking-your-work-with-issues/about-task-lists +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - Pull requests + - Issues +--- + +{% ifversion projects-v2-tasklists %} +{% note %} + +**Note:** For more information about the new iteration of Tasklists, which is currently in a private beta, see "[About Tasklists](/issues/tracking-your-work-with-issues/about-tasklists)." + +{% endnote %} +{% endif %} + +## About task lists + +A task list is a set of tasks that each render on a separate line with a clickable checkbox. You can select or deselect the checkboxes to mark the tasks as complete or incomplete. + +You can use Markdown to create a task list in any comment on {% data variables.product.product_name %}. {% ifversion fpt or ghec %}If you reference an issue, pull request, or discussion in a task list, the reference will unfurl to show the title and state.{% endif %} + +{% ifversion not fpt or ghec %} +You can view task list summary information in issue and pull request lists, when the task list is in the initial comment. +{% else %} + +## About issue task lists + +If you add a task list to the body of an issue, the list has added functionality. + +- To help you track your team's work on an issue, the progress of an issue's task list appears in various places on {% data variables.product.product_name %}, such as a repository's list of issues. +- If a task references another issue and someone closes that issue, the task's checkbox will automatically be marked as complete. +- If a task requires further tracking or discussion, you can convert the task to an issue by hovering over the task and clicking {% octicon "issue-opened" aria-label="The issue opened icon" %} in the upper-right corner of the task. To add more details before creating the issue, you can use keyboard shortcuts to open the new issue form. For more information, see "[Keyboard shortcuts](/github/getting-started-with-github/using-github/keyboard-shortcuts#issues-and-pull-requests)." +- Any issues referenced in the task list will specify that they are tracked in the referencing issue. + +![Rendered task list](/assets/images/help/writing/task-list-rendered.png) + +{% endif %} + +## Creating task lists + +{% data reusables.repositories.task-list-markdown %} + +{% tip %} + +**Tip:** You cannot create task list items within closed issues or issues with linked pull requests. + +{% endtip %} + +## Reordering tasks + +You can reorder the items in a task list by clicking to the left of a task's checkbox, dragging the task to a new location, and dropping the task. You can reorder tasks across different lists in the same comment, but you can not reorder tasks across different comments. + +{% ifversion fpt %} ![Reordered task list](/assets/images/help/writing/task-list-reordered.gif) +{% else %} ![Reordered task list](/assets/images/enterprise/writing/task-lists-reorder.gif) {% endif %} + +{% ifversion fpt %} + +## Navigating tracked issues + +Any issues that are referenced in a task list specify that they are tracked by the issue that contains the task list. To navigate to the tracking issue from the tracked issue, click on the tracking issue number in the **Tracked in** section next to the issue status. + +![Tracked in example](/assets/images/help/writing/task_list_tracked.png) + +{% endif %} + +## Further reading + +{% ifversion code-scanning-task-lists %} +* "[Tracking {% data variables.product.prodname_code_scanning %} alerts in issues using task lists](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists)"{% endif %} diff --git a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects.md b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects.md index 412732a2a2..14f650658f 100644 --- a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects.md +++ b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects.md @@ -11,12 +11,12 @@ type: tutorial topics: - Projects allowTitleToDifferFromFilename: true -ms.openlocfilehash: 6b4deff4ee518bfdafcd3886577a1c9b12ea7b2e -ms.sourcegitcommit: bf11c3e08cbb5eab6320e0de35b32ade6d863c03 +ms.openlocfilehash: ab041e8473e310913eb1b794302415e9b6323e76 +ms.sourcegitcommit: e4069b5613c10d74954185995d0fb73224079463 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/27/2022 -ms.locfileid: '148111602' +ms.lasthandoff: 11/17/2022 +ms.locfileid: '148169233' --- この記事では、GraphQL API を使用してプロジェクトを管理する方法を説明します。 {% data variables.product.prodname_actions %} ワークフローで API を使用する方法について詳しくは、「[Actions を使った {% data variables.product.prodname_projects_v2 %} の自動化](/issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions)」を参照してください。 使用可能なデータ型の完全な一覧については、「[リファレンス](/graphql/reference)」を参照してください。 @@ -665,7 +665,7 @@ gh api graphql -f query=' curl --request POST \ --url https://api.github.com/graphql \ --header 'Authorization: Bearer TOKEN' \ - --data '{"query":"mutation {updateProjectV2ItemFieldValue( input: { projectId: \"PROJECT_ID\" itemId: \"ITEM_ID\" fieldId: \"FIELD_ID\" value: { singleSelectOptionId: \"OPTION_ID\" }}) { projectV2Item { id }}}"}' + --data '{"query":"mutation {updateProjectV2ItemFieldValue( input: { projectId: \"PROJECT_ID\" itemId: \"ITEM_ID\" fieldId: \"FIELD_ID\" value: { iterationId: \"ITERATION_ID\" }}) { projectV2Item { id }}}"}' ``` {% endcurl %} diff --git a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md index 171c7b065d..ee685e956c 100644 --- a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md +++ b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md @@ -10,12 +10,12 @@ type: tutorial topics: - Projects allowTitleToDifferFromFilename: true -ms.openlocfilehash: b1c04738a3c03d892b360c3b23def694d202ee0c -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 680d6cff10dfc063ebaef0ebc9f8f7d0c15ba2e7 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148109025' +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158942' --- Issueにアサインされた人やラベルといったアイテムのメタデータやプロジェクトのフィールドに対するフィルタを使って、ビューをカスタマイズできます。 フィルタを組み合わせて、ビューとして保存できます。 詳しくは、「[プロジェクトのビューのカスタマイズ](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)」をご覧ください。 @@ -25,6 +25,8 @@ Issueにアサインされた人やラベルといったアイテムのメタデ {% data variables.product.prodname_projects_v2 %} の分析情報を使用して作成するグラフでも同じフィルターを使用でき、グラフの作成に使用するデータをフィルター処理できます。 詳しくは、「[プロジェクトのインサイトの利用](/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects)」をご覧ください。 +ビューをフィルタリングし、項目を追加すると、追加された項目にフィルタリングされたメタデータが適用されます。 たとえば、`status:"In progress"` でフィルタリングするとき、ある項目を追加すると、その新しい項目の状態が "進行中" に設定されます。 + ## アイテムのフィルタリング テーブルの上部にある{% octicon "filter" aria-label="the filter icon" %}をクリックして、"Filter by keyword or by field（キーワードもしくはフィールドでフィルタ）"バーを表示させてください。 フィルタに使いたいフィールド名及び値を入力し始めてください。 入力していくと、利用できる値が表示されます。 diff --git a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md index 2b8dd52bd8..fe4f66e36e 100644 --- a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md +++ b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md @@ -1,6 +1,6 @@ --- -title: 'About {% data variables.product.prodname_projects_v2 %}' -intro: '{% data variables.product.prodname_projects_v2 %} is an adaptable, flexible tool for planning and tracking work on {% data variables.product.company_short %}.' +title: '{% data variables.product.prodname_projects_v2 %} について' +intro: '{% data variables.product.prodname_projects_v2 %} は、{% data variables.product.company_short %} での作業を計画および追跡するための、適応性のある柔軟なツールです。' allowTitleToDifferFromFilename: true miniTocMaxHeadingLevel: 3 versions: @@ -10,52 +10,57 @@ redirect_from: type: overview topics: - Projects +ms.openlocfilehash: 768234aa5e6c9cfbca6a6144a80ac2868f3316ce +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158862' --- +## {% data variables.product.prodname_projects_v2 %} について -## About {% data variables.product.prodname_projects_v2 %} +プロジェクトは、作業の計画と追跡を効果的に行えるように {% data variables.product.company_short %} 上の issue および pull request と統合できる、適応性のあるスプレッドシートです。 issue と pull request をフィルター処理、並べ替え、グループ化して複数のビューを作成し、チーム固有のメタデータを追跡するカスタム フィールドを追加してカスタマイズしたうえで、構成可能なグラフを使って作業を視覚化できます。 プロジェクトには、特定の手法を適用するのではなく、チームのニーズやプロセスに合わせてカスタマイズできる柔軟な機能があります。 -A project is an adaptable spreadsheet that integrates with your issues and pull requests on {% data variables.product.company_short %} to help you plan and track your work effectively. You can create and customize multiple views by filtering, sorting, grouping your issues and pull requests, adding custom fields to track metadata specific to your team, and visualize work with configurable charts. Rather than enforcing a specific methodology, a project provides flexible features you can customize to your team’s needs and processes. +### 最新の状態に保つ -### Staying up-to-date +プロジェクトは、追加した issue と pull request から構築され、プロジェクトと作業の間に直接参照が作成されます。 変更を加えると情報がプロジェクトに自動的に同期され、ビューとグラフが更新されます。 この統合は双方向なので、pull reqeust や issue に関する情報をプロジェクト内で変更すると、その pull request や issue にはその情報が反映されます。 たとえば、プロジェクトの担当者を変更すると、その変更が issue に表示されます。 この統合をさらに進め、担当者別にプロジェクトをグループ化し、issue を別のグループにドラッグして issue の割り当てを変更できます。 -Your projects are built from the issues and pull requests you add, creating direct references between your project and your work. Information is synced automatically to your project as you make changes, updating your views and charts. This integration works both ways, so that when you change information about a pull request or issue in your project, the pull request or issue reflects that information. For example, change an assignee in your project and that change is shown in your issue. You can take this integration even further, group your project by assignee, and make changes to issue assignment by dragging issues into the different groups. +### 項目へのメタデータの追加 -### Adding metadata to your items +カスタム フィールドを使用し、issue、pull request、ドラフト issue にメタデータを追加し、項目属性のより豊富なビューを作成できます。 issue や pull request に関して、現時点で存在している組み込みのメタデータ (担当者、マイルストーン、ラベルなど) に限定されるわけではありません。 たとえば、カスタム フィールドとして次のメタデータを追加できます。 -You can use custom fields to add metadata to your issues, pull requests, and draft issues and build a richer view of item attributes. You’re not limited to the built-in metadata (assignee, milestone, labels, etc.) that currently exists for issues and pull requests. For example, you can add the following metadata as custom fields: - -- A date field to track target ship dates. -- A number field to track the complexity of a task. -- A single select field to track whether a task is Low, Medium, or High priority. -- A text field to add a quick note. -- An iteration field to plan work week-by-week, including support for breaks. +- ターゲット出荷日を追跡する日付フィールド。 +- タスクの複雑さを追跡する数値フィールド。 +- タスクの優先度が低、中、高のいずれかであるかを追跡する選択フィールド。 +- クイック メモを追加できるテキスト フィールド。 +- 週単位で作業計画を立てるためのイテレーション フィールド (休憩のサポートを含む)。 {% ifversion projects-v2-tasklists %} -### Exploring the relationships between issues +### issue 間の関係を調べる {% data reusables.projects.tasklists-release-stage %} -You can use Tasklists to build hierarchies of issues, dividing your issues into smaller subtasks, and creating new relationships between your issues. For more information, see "[About Tasklists](/issues/tracking-your-work-with-issues/about-tasklists)." +タスクリストを使用し、issue の階層を構築したり、issue を小さなサブタスクに分割したり、issue 間に新しいリレーションシップを作成したりできます。 詳細については、「[タスクリストについて](/issues/tracking-your-work-with-issues/about-tasklists)」を参照してください。 -These relationships are displayed on the issue, as well as the Tracked-by and Tracks fields in your projects. You can filter by issues which are tracked by another issue, and you can also group your table views by the Tracked-by field to show all parent issues with a list of their subtasks. +これらの関係は issue と、プロジェクトの Tracked-by フィールドと Tracks フィールドに表示されます。 別の issue によって追跡されている issue 別にフィルタリングできます。また、Tracked-by フィールドでテーブル表示をグループ化し、すべての親 issue とそのサブタスクの一覧を表示できます。 {% endif %} -### Viewing your project from different perspectives +### 様々な観点からプロジェクトを見る -Quickly answer your most pressing questions by tailoring your project view to give you the information you need. You can save these views, allowing you to quickly return to them as needed and make them available to your team. Views not only let you scope down the items listed but also offer two different layout options. +必要な情報が提供されるようにプロジェクト ビューを調整し、最も差し迫った質問にすばやく答えます。 これらのビューは、必要に応じてすばやく戻ることができるように保存し、チームで使用できます。 ビューを使用すると、一覧表示される項目を絞り込むことができるだけでなく、2 つの異なるレイアウト オプションも提供されます。 -You can view your project as a high density table layout: +プロジェクトは、高密度のテーブルレイアウトで表示できます。 -![Project table](/assets/images/help/issues/projects_table.png) +![プロジェクトのテーブル](/assets/images/help/issues/projects_table.png) -Or as a board: +あるいはボードとして表示できます。 -![Project board](/assets/images/help/issues/projects_board.png) +![Project ボード](/assets/images/help/issues/projects_board.png) -To help you focus on specific aspects of your project, you can group, sort, or filter items: +プロジェクトの特定の側面に注目しやすくするために、アイテムをグループ化、ソート、フィルタできます。 -![Project view](/assets/images/help/issues/project_view.png) +![プロジェクト ビュー](/assets/images/help/issues/project_view.png) -For more information, see "[Customizing a view](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)." +詳しくは、「[ビューのカスタマイズ](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view)」を参照してください。 diff --git a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields.md b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields.md new file mode 100644 index 0000000000..806e4413d9 --- /dev/null +++ b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields.md @@ -0,0 +1,56 @@ +--- +title: 追跡と追跡対象フィールドについて +shortTitle: About Tracks and Tracked-by fields +intro: プロジェクト内の issue のサブタスクを表示できます。 +miniTocMaxHeadingLevel: 3 +versions: + feature: projects-v2-tasklists +type: tutorial +topics: + - Projects +ms.openlocfilehash: 74cd26d20882a00ac8c7ac1d109cc6810286cec6 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160039' +--- +{% data reusables.projects.tasklists-release-stage %} + +タスクリストにサブタスクを追加するときに、プロジェクトの [追跡] フィールドと [追跡対象] フィールドを有効にして、issue 間の関係を確認できます。 タスクリストでの issue 階層の作成の詳細については、「[タスクリストについて](/issues/tracking-your-work-with-issues/about-tasklists)」を参照してください。 + +[追跡対象] フィールドを使用して項目をグループ化し、各 issue のサブタスクと、それらを完了するために必要な作業を明確に示すビューを作成できます。 詳細については、「[テーブル レイアウトのフィールド値によるグループ化](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view#grouping-by-field-values-in-table-layout)」を参照してください。 + +[追跡対象] フィールドでフィルター処理して、特定の issue によって追跡されている項目のみを表示することもできます。 「tracked-by」と入力し始めて一覧から issue を選ぶか、リポジトリと issue 番号がわかっている場合は、以下のフィルターを完全に入力できます。 + +``` +tracked-by:"/#" +``` + +フィルターを使用するには、`` をリポジトリ所有者に、`` をリポジトリ名に、`` を issue 番号に置き換えます。 詳細については、[プロジェクトのフィルター処理](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects)に関するページを参照してください。 + +### [追跡対象] フィールドの有効化 + +[追跡対象] フィールドを有効にして、プロジェクト内の項目を追跡している issue を確認できます。 + +1. テーブル ビューで、右端のフィールド ヘッダーの [{% octicon "plus" aria-label="the plus icon" %}] をクリックします。 + + ![新しいフィールドのボタンを示すスクリーンショット](/assets/images/help/projects-v2/new-field-button.png) + +1. [非表示フィールド] の **[追跡対象]** をクリックします。 + + ![フィールド メニューを示すスクリーンショット](/assets/images/help/projects-v2/select-tracked-by-field.png) + + +### [追跡] フィールドを有効にする + +[追跡] フィールドを有効にすると、プロジェクト内のアイテムが追跡している他の issue を確認できます。 + +1. テーブル ビューで、右端のフィールド ヘッダーの [{% octicon "plus" aria-label="the plus icon" %}] をクリックします。 + + ![新しいフィールドのボタンを示すスクリーンショット](/assets/images/help/projects-v2/new-field-button.png) + +1. [非表示フィールド] の **[追跡]** をクリックします。 + + ![フィールド メニューを示すスクリーンショット](/assets/images/help/projects-v2/select-tracks-field.png) + diff --git a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md new file mode 100644 index 0000000000..fae1444443 --- /dev/null +++ b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md @@ -0,0 +1,25 @@ +--- +title: カスタムフィールドの削除 +intro: '{% data variables.projects.project_v2 %} からカスタム フィールドを削除する方法について学習します。' +miniTocMaxHeadingLevel: 3 +versions: + feature: projects-v2 +type: tutorial +topics: + - Projects +redirect_from: + - /issues/planning-and-tracking-with-projects/understanding-field-types/deleting-fields +ms.openlocfilehash: b4a0c070b92b3b28c684c9e3b2f7388b9d7b517a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159831' +--- +{% data reusables.projects.project-settings %} +1. 削除するカスタム フィールドの名前をクリックします。 + ![繰り返しフィールドを示すスクリーンショット](/assets/images/help/projects-v2/select-single-select.png) +1. フィールドの名前の横にある {% octicon "kebab-horizontal" aria-label="The menu icon" %} をクリックして、メニューを開きます。 + ![フィールド名を示すスクリーンショット](/assets/images/help/projects-v2/field-options.png) +1. **[フィールドの削除]** をクリックします。 + ![フィールド名を示すスクリーンショット](/assets/images/help/projects-v2/delete-field.png) diff --git a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/index.md b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/index.md new file mode 100644 index 0000000000..6f91d0dd25 --- /dev/null +++ b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/index.md @@ -0,0 +1,28 @@ +--- +title: フィールドについて +shortTitle: Understanding fields +intro: さまざまなフィールドとカスタム フィールドの種類、プロジェクトにフィールドを追加する方法、カスタム フィールドを管理する方法について説明します。 +versions: + feature: projects-v2 +topics: + - Issues + - Projects +children: + - /about-text-and-number-fields + - /about-date-fields + - /about-single-select-fields + - /about-iteration-fields + - /about-tracks-and-tracked-by-fields + - /renaming-custom-fields + - /deleting-custom-fields +allowTitleToDifferFromFilename: true +redirect_from: + - /issues/planning-and-tracking-with-projects/understanding-field-types +ms.openlocfilehash: ed15d18adff2e51c6f5d9ce41f4af701f71354ed +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160032' +--- + diff --git a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md new file mode 100644 index 0000000000..ec81e54e04 --- /dev/null +++ b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md @@ -0,0 +1,24 @@ +--- +title: カスタム フィールドの名前の変更 +intro: '{% data variables.projects.project_v2 %} の既存のカスタム フィールドの名前を変更する方法について学習します。' +miniTocMaxHeadingLevel: 3 +versions: + feature: projects-v2 +type: tutorial +topics: + - Projects +redirect_from: + - /issues/planning-and-tracking-with-projects/understanding-field-types/renaming-fields +ms.openlocfilehash: 45520fab579af228685443e0aa9ab563289325f1 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160175' +--- +{% data reusables.projects.project-settings %} +1. 名前を変更するカスタム フィールドの名前をクリックします。 + ![繰り返しフィールドを示すスクリーンショット](/assets/images/help/projects-v2/select-single-select.png) +1. [フィールド名] に、フィールドの新しい名前を入力します。 + ![フィールド名を示すスクリーンショット](/assets/images/help/projects-v2/field-rename.png) +1. 変更を保存するには、Return キーを押します。 diff --git a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md index 96a1e4cb41..771239a8c8 100644 --- a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md +++ b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md @@ -11,12 +11,12 @@ product: '{% data reusables.gated-features.historical-insights-for-projects %}' topics: - Projects allowTitleToDifferFromFilename: true -ms.openlocfilehash: 89f93ace53547fccd69ffb7e6d7b666a6cb48991 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 809d8492bb1ec7c8cd4eb051b1eaefb00d29097e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148109096' +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158574' --- {% ifversion fpt %} @@ -30,6 +30,8 @@ ms.locfileid: '148109096' {% data variables.product.prodname_projects_v2 %} の分析情報を使って、プロジェクトにソースデータとして追加された項目を使うグラフを表示、作成、カスタマイズすることができます。 既定のグラフにフィルターを適用し、独自のグラフを作成することもできます。 グラフを作成するときは、フィルター、グラフの種類、表示される情報を設定します。グラフは、プロジェクトを表示できるすべてのユーザーが使用できます。 現在のグラフと履歴グラフの 2 種類のグラフを生成できます。 + Insights では、アーカイブまたは削除した項目は追跡されません。 + ### 現在のグラフについて 現在のグラフを作成して、プロジェクト項目を視覚化できます。 たとえば、グラフを作成して、各個人に割り当てられている項目の数や、今後の繰り返しごとに割り当てられている issue の数を示すことができます。 diff --git a/translations/ja-JP/content/issues/tracking-your-work-with-issues/about-tasklists.md b/translations/ja-JP/content/issues/tracking-your-work-with-issues/about-tasklists.md new file mode 100644 index 0000000000..552c6f2519 --- /dev/null +++ b/translations/ja-JP/content/issues/tracking-your-work-with-issues/about-tasklists.md @@ -0,0 +1,146 @@ +--- +title: タスクリストについて +intro: タスクリストを使用して、issue をより小さなサブタスクに分割できます。 +versions: + feature: projects-v2-tasklists +miniTocMaxHeadingLevel: 3 +redirect_from: + - /early-access/issues/about-tasklists +ms.openlocfilehash: e35065ae4de634bb7a2da815e0a860c7c0b92234 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160127' +--- +{% data reusables.projects.tasklists-release-stage %} + +## タスクリストについて + +タスクリストでは、{% data variables.product.product_name %} に関する issue の階層のサポートが追加され、issue の追跡、issue のより小さなサブタスクへの分割、issue 間の新しいリレーションシップの作成に役立ちます。 + +タスクリストは、[ベータ タスク リスト](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)の以前のイテレーションに基づいて構築され、項目を issue に変換し、タスクリストの進行状況を表示し、issue 間の "追跡/追跡対象" リレーションシップを作成する機能が保持されます。 + +タスクリストに追加した issue は、担当者と適用されたラベルを表示するために自動的に設定されます。 + +![動作中のタスクリストを示す画像](/assets/images/help/issues/tasklist-hero.png) + +### {% data variables.projects.projects_v2 %} との統合について + + プロジェクトのサイドパネルでは階層内の issue の場所が階層リンク メニューに表示され、タスクリストに含まれる issue 間を移動できます。 [追跡] と [追跡対象] フィールドをプロジェクト ビューに追加して、issue 間のリレーションシップをすばやく確認することもできます。 詳しくは、「[追跡と追跡対象フィールドについて](/issues/planning-and-tracking-with-projects/understanding-fields/about-tracks-and-tracked-by-fields)」を参照してください。 + +## タスクリストの作成 + +タスクリストを作成するために、[タスクリストの追加] ボタンを使用するか、issue の Markdown を編集できます。 + +### [タスクリストの追加] ボタンを使用したタスクリストの作成 + +編集できる issue の説明の下部にある **{% octicon "checklist" aria-label="The checklist icon" %} [タスク リストの追加]** ボタンをクリックして、タスク リストを作成します。 + +![[タスクリストの追加] ボタンを示すスクリーンショット](/assets/images/help/issues/tasklist-add-tasklist-button.png) + +### Markdown を使用したタスクリストの作成 + +issue の説明で Markdown を使用して、タスクリストを作成できます。 フェンスされたコード ブロックを作成し、開くバッククォートの横に `[tasklist]` を含めます。 各項目の先頭に `- [ ]` を付け、他の issue やテキストへのリンクを含めます。 必要に応じて、リストの上部に Markdown ヘッダーとしてタイトルを含めることができます。 + +```` +```[tasklist] +### Tasks +- [ ] https://github.com/octo-org/octo-repo/issues/45 +- [ ] Draft issue title +``` +```` + +Markdown は、{% data variables.product.product_name %} によってタスクリストとしてレンダリングされます。 その後、UI を使用して変更を加え、issue とドラフト issue を追加できます。 issue の説明を編集する場合、Markdown を直接変更することも、Markdown をコピーして他の issue のタスクリストを複製することもできます。 + + + +## タスクリストへの issue の追加 + +1. タスクリストの下部にある **[タスクに項目を追加する]** をクリックします。 + + ![[タスクに項目を追加する] ボタンを示すスクリーンショット](/assets/images/help/issues/add-new-tasklist-button.png) + +1. タスクリストに追加する issue を選びます。 + + * リポジトリから最近更新された issue を追加するには、ドロップダウンでその issue をクリックするか、方向キーを使用して選んでから、Enter キーを押します。 + + ![最近の issue を示すスクリーンショット](/assets/images/help/issues/select-recent-issue.png) + + * リポジトリで issue を検索するには、まず、issue のタイトルまたは issue の番号を入力して結果をクリックするか、方向キーを使用して選び、Enter キーを押します。 + + ![issue の検索を示すスクリーンショット](/assets/images/help/issues/search-for-issue.png) + + * URL を使用して issue を直接追加するには、issue の URL を貼り付けて Enter キーを押します。 + + ![貼り付けた issue の URL を示すスクリーンショット](/assets/images/help/issues/paste-issue-url.png) + + +## タスクリストでのドラフト issue の作成 + +ドラフト issue は、後で issue に変換できるアイデアをすばやく取り込むのに役立ちます。 リポジトリから参照される issue や pull request とは異なり、ドラフト issue はタスクリストにのみ存在します。 + +1. タスクリストの下部にある **[タスクに項目を追加する]** をクリックします。 + + ![[タスクに項目を追加する] ボタンを示すスクリーンショット](/assets/images/help/issues/add-new-tasklist-button.png) + +1. ドラフト issue のタイトルを入力し、Enter キーを押します。 + + ![ドラフト issue のタイトルを示すスクリーンショット](/assets/images/help/issues/add-draft-issue-to-tasklist.png) + + +## タスクリストの issue へのドラフト issue の変換 + +ドラフト issue を issue に変換することができます。 issue は、タスクリストの親 issue と同じリポジトリに作成されます。 + +1. 変換するドラフト issue の横にある {% octicon "kebab-horizontal" aria-label="The kebab menu icon" %} をクリックします。 + + ![メニュー アイコンを示すスクリーンショット](/assets/images/help/issues/tasklist-item-kebab.png) + +1. メニューで、 **[issue に変換]** をクリックします。 + + ![[issue に変換] オプションを示すスクリーンショット](/assets/images/help/issues/tasklist-convert-to-issue.png) + + +## タスクリストからの issue またはドラフト issue の削除 + +タスクリストから issue またはドラフト issue を削除することができます。 タスクリストから削除された issue は、リポジトリから削除されません。 + +1. 削除するドラフト issue の横にある {% octicon "kebab-horizontal" aria-label="The kebab menu icon" %} をクリックします。 + + ![メニュー アイコンを示すスクリーンショット](/assets/images/help/issues/tasklist-item-kebab.png) + +1. メニューで、 **[削除]** をクリックします。 + + ![[削除] オプションを示すスクリーンショット](/assets/images/help/issues/tasklist-remove.png) + +## タスクリストのタイトルの変更 + +新しいタスクリストを作成すると、既定のタイトルは "タスク" になります。 issue の Markdown を編集して、タイトルを変更することができます。 + +1. issue 本文の右上にある {% octicon "kebab-horizontal" aria-label="The kebab menu icon" %} をクリックします。 + + ![メニュー アイコンの場所を示すスクリーンショット](/assets/images/help/issues/comment-menu.png) + +1. メニューで、 **[編集]** をクリックします。 + + ![編集オプションを示すスクリーンショット](/assets/images/help/issues/comment-menu-edit.png) + +1. フェンスされたコード ブロックのヘッダーを新しいタイトルに変更します。 たとえば、`### Tasks` を `### My new title` に変更します。 + + ![編集オプションを示すスクリーンショット](/assets/images/help/issues/edit-tasklist-title.png) + +1. **[コメントの更新]** をクリックします。 + +## タスクリストのコピー + +[Markdown のコピー] オプションを使用してタスクリストをコピーすると、{% data variables.product.product_name %} によって Markdown がクリップボードにコピーされ、issue の名前が含まれるため、コンテキストを失うことなく GitHub の外部にタスクリストを貼り付けることができます。 + +1. タスクリストの右上にある {% octicon "kebab-horizontal" aria-label="The kebab menu icon" %} をクリックします。 + + ![メニュー アイコンを示すスクリーンショット](/assets/images/help/issues/tasklist-kebab.png) + +1. メニューで、 **[Markdown のコピー]** をクリックします。 + + ![[Markdown のコピー] オプションを示すスクリーンショット](/assets/images/help/issues/tasklist-copy-markdown.png) + diff --git a/translations/ja-JP/content/organizations/collaborating-with-groups-in-organizations/about-organizations.md b/translations/ja-JP/content/organizations/collaborating-with-groups-in-organizations/about-organizations.md index 52fc0b96ca..ca7ffe9825 100644 --- a/translations/ja-JP/content/organizations/collaborating-with-groups-in-organizations/about-organizations.md +++ b/translations/ja-JP/content/organizations/collaborating-with-groups-in-organizations/about-organizations.md @@ -1,6 +1,6 @@ --- -title: About organizations -intro: 'Organizations are shared accounts where businesses and open-source projects can collaborate across many projects at once, with sophisticated security and administrative features.' +title: Organizationについて +intro: Organization は、高度なセキュリティと管理機能を使って、企業とオープンソース プロジェクトが一度に多くのプロジェクト間で共同作業ができる共有アカウントです。 redirect_from: - /articles/about-organizations - /github/setting-up-and-managing-organizations-and-teams/about-organizations @@ -12,48 +12,48 @@ versions: topics: - Organizations - Teams +ms.openlocfilehash: 0269554568c8781706a8d79600f5b6191d0b9598 +ms.sourcegitcommit: 1529de77bfcbe45519131b5f5fb3ab319758c2d2 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148164332' --- +## Organizationについて -## About organizations +{% data reusables.organizations.about-organizations %} アカウントの種類のについて詳しくは、「[{% data variables.product.prodname_dotcom %} アカウントの種類](/get-started/learning-about-github/types-of-github-accounts)」をご覧ください。 -{% data reusables.organizations.about-organizations %} For more information about account types, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/get-started/learning-about-github/types-of-github-accounts)." +Organization に参加するために招待するユーザーの数に制限はなく、Organization のメンバーには、Organization とそのデータへのさまざまなレベルのアクセス権を許可するさまざまなロールを許可することができます。 詳細については、「[Organization のロール](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)」を参照してください。 -You can invite an unlimited number of people to join your organization, then give these organization members a variety of roles that grant different levels of access to the organization and its data. For more information, see "[Roles in an organization](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)." +また、Organization 自体へのアクセスを管理するだけでなく、Organization のリポジトリ、プロジェクト ボード、アプリへのアクセスを個別に管理できます。 詳しくは、「[Organization のリポジトリロール](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)」、「[Organization のプロジェクトボード権限](/organizations/managing-access-to-your-organizations-project-boards/project-board-permissions-for-an-organization)」、「[Organization のアプリケーションに対するアクセスを管理する](/organizations/managing-access-to-your-organizations-apps)」をご覧ください。 -In addition to managing access to the organization itself, you can separately manage access to your organization's repositories, project boards, and apps. For more information, see "[Repository roles for an organization](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)", "[Project board permissions for an organization](/organizations/managing-access-to-your-organizations-project-boards/project-board-permissions-for-an-organization)", and "[Managing access to your organization's apps](/organizations/managing-access-to-your-organizations-apps)." +アクセス管理を簡素化し、コラボレーションを向上するために、連鎖アクセス許可とメンションを使って、グループの構造を反映する入れ子になったチームを作成できます。 詳細については、「[Team について](/organizations/organizing-members-into-teams/about-teams)」を参照してください。 -To simplify access management and enhance collaboration, you can create nested teams that reflect your group's structure, with cascading access permissions and mentions. For more information, see "[About teams](/organizations/organizing-members-into-teams/about-teams)." +メンバーが作成できるリポジトリの種類を制限するなど、設定を管理して、グループ固有のニーズを満たすように Organization を構成できます。 詳しくは、「[Organization の設定を管理する](/organizations/managing-organization-settings)」をご覧ください。 -You can configure the organization to meet the unique needs of your group by managing settings, such as restricting the types of repositories that members can create. For more information, see "[Managing organization settings](/organizations/managing-organization-settings)." +Organization のセキュリティを強化するために、セキュリティ要件を適用し、Organization の監査ログを確認できます。 詳しくは、「[Organization を安全に保つ](/organizations/keeping-your-organization-secure)」をご覧ください。 -To harden your organization's security, you can enforce security requirements and review the organization's audit log. For more information, see "[Keeping your organization secure](/organizations/keeping-your-organization-secure)." - -To learn how to use organizations most effectively, see "[Best practices for organizations](/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations)." +組織を最も効果的に使用する方法については、「[組織のベスト プラクティス](/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations)」を参照してください。 {% ifversion fpt or ghec %} -## About feature availability +## 使用できる機能について -{% data reusables.organizations.organization-plans %} -{% endif %} +{% data reusables.organizations.organization-plans %} {% endif %} -## Organizations and enterprise accounts +## Organization と Enterprise アカウント -{% ifversion fpt %} -Enterprise accounts are a feature of {% data variables.product.prodname_ghe_cloud %} that allow owners to centrally manage policy and billing for multiple organizations. For more information, see [the {% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/organizations/collaborating-with-groups-in-organizations/about-organizations). -{% else %} -{% ifversion ghec %}For organizations that belong to an enterprise account, billing is managed at the enterprise account level, and billing settings are not available at the organization level.{% endif %} Enterprise owners can set policy for all organizations in the enterprise account or allow organization owners to set the policy at the organization level. Organization owners cannot change settings enforced for your organization at the enterprise account level. If you have questions about a policy or setting for your organization, contact the owner of your enterprise account. +{% ifversion fpt %}Enterprise アカウントは、所有者が複数の Organization のポリシーと支払いを集中管理できるようにする {% data variables.product.prodname_ghe_cloud %} の機能です。 詳細については、[{% data variables.product.prodname_ghe_cloud %} ドキュメント](/enterprise-cloud@latest/organizations/collaborating-with-groups-in-organizations/about-organizations)を参照してください。 +{% else %}{% ifversion ghec %}Enterprise アカウントに属する Organization では、支払いは Enterprise アカウントのレベルで管理され、支払い設定は Organization レベルでは利用できません。{% endif %}Enterprise 所有者は Enterprise アカウント内のすべての Organization のポリシーを設定するか、Organization 所有者に Organization レベルでのポリシーの設定を許可することができます。 Organization のオーナーは、Enterprise アカウントのレベルで Organization に強制された設定を変更することはできません。 Organization のポリシーや設定について質問がある場合は Enterprise アカウントのオーナーに問い合わせてください。 -{% ifversion ghec %} -{% data reusables.enterprise.create-an-enterprise-account %} For more information, see "[Creating an enterprise account](/admin/overview/creating-an-enterprise-account)." +{% ifversion ghec %}{% data reusables.enterprise.create-an-enterprise-account %}詳しくは、「[Enterprise アカウントの作成](/admin/overview/creating-an-enterprise-account)」をご覧ください。 {% data reusables.enterprise-accounts.invite-organization %} -{% endif %} -{% endif %} +{% endif %} {% endif %} {% ifversion fpt or ghec %} -## Terms of service and data protection for organizations +## Organization の利用規約とデータ保護 -An entity, such as a company, non-profit, or group, can agree to the Standard Terms of Service or the Corporate Terms of Service for their organization. For more information, see "[Upgrading to the Corporate Terms of Service](/articles/upgrading-to-the-corporate-terms-of-service)." +会社、非営利団体、グループなどは、Organization として標準の利用規約あるいは企業向け利用規約に合意できます。 詳しくは、「[企業利用規約にアップグレードする](/articles/upgrading-to-the-corporate-terms-of-service)」をご覧ください。 {% endif %} diff --git a/translations/ja-JP/content/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations.md b/translations/ja-JP/content/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations.md new file mode 100644 index 0000000000..4892923515 --- /dev/null +++ b/translations/ja-JP/content/organizations/collaborating-with-groups-in-organizations/best-practices-for-organizations.md @@ -0,0 +1,38 @@ +--- +title: 組織のベスト プラクティス +shortTitle: Best practices +intro: '組織向けに {% data variables.product.prodname_dotcom %} が推奨するプラクティスについて説明します。' +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - Organizations + - Teams +ms.openlocfilehash: 015c74d7a69a1feb5c8ff9467a4219753f2cb5eb +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163459' +--- +## 複数の所有者を割り当てる + +{% data reusables.organizations.org-ownership-recommendation %}詳しくは、「[Organization の所有権の継続性を管理する](/organizations/managing-peoples-access-to-your-organization-with-roles/maintaining-ownership-continuity-for-your-organization)」をご覧ください。 + +## チームを使う + +チームを使って、組織内でのコラボレーションを促進することをお勧めします。 詳細については、「[Team について](/organizations/organizing-members-into-teams/about-teams)」を参照してください。 + +{% ifversion ghec %}ID プロバイダー (IdP) を使用してチーム メンバーシップを管理することを強くお勧めします。 詳細については、「[Organization の Team 同期を管理する](/organizations/managing-saml-single-sign-on-for-your-organization/managing-team-synchronization-for-your-organization)」を参照してください。 + +{% data reusables.enterprise-accounts.emu-scim-note %} {% endif %} + +チームは可能な限り見えるようにして、機密性の高い状況に備えてシークレット チームを用意しておくことをお勧めします。 詳細については、「[Team の可視性の変更](/organizations/organizing-members-into-teams/changing-team-visibility)」を参照してください。 + +{% ifversion ghec or ghes or ghae %} +## セキュリティの概要を使う + +{% data reusables.security-overview.about-the-security-overview %} 詳しくは、「[セキュリティの概要について](/code-security/security-overview/about-the-security-overview)」を参照してください。 +{% endif %} diff --git a/translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md b/translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md index 940d7d2045..859f0341a9 100644 --- a/translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md +++ b/translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md @@ -1,6 +1,6 @@ --- -title: Organization に対する許可 IP アドレスを管理する -intro: 接続を許可される IP アドレスのリストを設定することで、Organizationのプライベートアセットに対するアクセスを制限することができます。 +title: Managing allowed IP addresses for your organization +intro: You can restrict access to your organization's private assets by configuring a list of IP addresses that are allowed to connect. redirect_from: - /github/setting-up-and-managing-organizations-and-teams/managing-allowed-ip-addresses-for-your-organization - /organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization @@ -12,82 +12,100 @@ topics: - Teams shortTitle: Manage allowed IP addresses permissions: Organization owners can manage allowed IP addresses for an organization. -ms.openlocfilehash: 5d0a9bbc9b2207e088e2051025a8844e7cf0dbec -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147707300' --- -## 許可 IP アドレスについて -特定の IP アドレスに対する許可リストを設定することで、Organizationのプライベートアセットへのアクセスを制限できます。 {% data reusables.identity-and-permissions.ip-allow-lists-example-and-restrictions %} +## About allowed IP addresses -{% ifversion ghec %} {% note %} +You can restrict access to private organization assets by configuring an allow list for specific IP addresses. {% data reusables.identity-and-permissions.ip-allow-lists-example-and-restrictions %} -**注:** IP 許可リストを使用できるのは、{% data variables.product.prodname_ghe_cloud %} を使用する Organization だけです。 {% data reusables.enterprise.link-to-ghec-trial %} +{% ifversion ghec %} +{% note %} -{% endnote %} {% endif %} +**Note:** Only organizations that use {% data variables.product.prodname_ghe_cloud %} can use IP allow lists. {% data reusables.enterprise.link-to-ghec-trial %} + +{% endnote %} +{% endif %} {% data reusables.identity-and-permissions.ip-allow-lists-cidr-notation %} {% data reusables.identity-and-permissions.ip-allow-lists-enable %} -許可リストをセットアップした場合は、Organizationにインストールした{% data variables.product.prodname_github_apps %}に設定されたIPアドレスを自動的に許可リストに追加するかを選択することもできます。 {% data variables.product.prodname_github_app %}の作者は、自分のアプリケーションのための許可リストを、アプリケーションが実行されるIPアドレスを指定して設定できます。 それらの許可リストを継承すれば、アプリケーションからの接続リクエストが拒否されるのを避けられます。 詳細については、「[{% data variables.product.prodname_github_apps %} によるアクセスの許可](#allowing-access-by-github-apps)」を参照してください。 +If you set up an allow list you can also choose to automatically add to your allow list any IP addresses configured for {% data variables.product.prodname_github_apps %} that you install in your organization. The creator of a {% data variables.product.prodname_github_app %} can configure an allow list for their application, specifying the IP addresses at which the application runs. By inheriting their allow list into yours, you avoid connection requests from the application being refused. For more information, see "[Allowing access by {% data variables.product.prodname_github_apps %}](#allowing-access-by-github-apps)." -Enterprise アカウントで Organization に対して許可される IP アドレスを設定することもできます。 詳細については、「[エンタープライズでのセキュリティ設定のポリシーの適用](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-allowed-ip-addresses-for-organizations-in-your-enterprise)」を参照してください。 +You can also configure allowed IP addresses for the organizations in an enterprise account. For more information, see "[Enforcing policies for security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-allowed-ip-addresses-for-organizations-in-your-enterprise)." -## 許可 IP アドレスを追加する +## Adding an allowed IP address {% data reusables.identity-and-permissions.about-adding-ip-allow-list-entries %} {% data reusables.identity-and-permissions.ipv6-allow-lists %} -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} {% data reusables.identity-and-permissions.ip-allow-lists-add-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-add-description %} {% data reusables.identity-and-permissions.ip-allow-lists-add-entry %} {% data reusables.identity-and-permissions.check-ip-address %} +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +{% data reusables.identity-and-permissions.ip-allow-lists-add-ip %} +{% data reusables.identity-and-permissions.ip-allow-lists-add-description %} +{% data reusables.identity-and-permissions.ip-allow-lists-add-entry %} +{% data reusables.identity-and-permissions.check-ip-address %} -## 許可 IP アドレスを有効化する +## Enabling allowed IP addresses {% data reusables.identity-and-permissions.about-enabling-allowed-ip-addresses %} -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} -1. [IP 許可リスト] で、 **[IP 許可リストを有効にする]** を選択します。 - ![IP アドレスを許可するチェックボックス](/assets/images/help/security/enable-ip-allowlist-organization-checkbox.png) -1. **[保存]** をクリックします。 +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +1. Under "IP allow list", select **Enable IP allow list**. + ![Checkbox to allow IP addresses](/assets/images/help/security/enable-ip-allowlist-organization-checkbox.png) +1. Click **Save**. -## {% data variables.product.prodname_github_apps %}によるアクセスの許可 +## Allowing access by {% data variables.product.prodname_github_apps %} -許可リストを使っているなら、Organizationにインストールした{% data variables.product.prodname_github_apps %}に設定されたIPアドレスを自動的に許可リストに追加するかも選択できます。 +If you're using an allow list, you can also choose to automatically add to your allow list any IP addresses configured for {% data variables.product.prodname_github_apps %} that you install in your organization. {% data reusables.identity-and-permissions.ip-allow-lists-address-inheritance %} {% data reusables.apps.ip-allow-list-only-apps %} -作成した {% data variables.product.prodname_github_app %} の許可リストを作成する方法の詳細については、「[GitHub App に対する許可 IP アドレスを管理する](/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app)」を参照してください。 +For more information about how to create an allow list for a {% data variables.product.prodname_github_app %} you have created, see "[Managing allowed IP addresses for a GitHub App](/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app)." -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} -1. [IP 許可リスト] で、 **[インストール済みの GitHub App の IP 許可リストの構成を有効にする]** を選択します。 - ![GitHub App IP アドレスを許可するチェックボックス](/assets/images/help/security/enable-ip-allowlist-githubapps-checkbox.png) -1. **[保存]** をクリックします。 +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +1. Under "IP allow list", select **Enable IP allow list configuration for installed GitHub Apps**. + ![Checkbox to allow GitHub App IP addresses](/assets/images/help/security/enable-ip-allowlist-githubapps-checkbox.png) +1. Click **Save**. -## 許可 IP アドレスを編集する +## Editing an allowed IP address {% data reusables.identity-and-permissions.about-editing-ip-allow-list-entries %} -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-entry %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-edit-description %} -1. **[Update]** をクリックします。 +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +{% data reusables.identity-and-permissions.ip-allow-lists-edit-entry %} +{% data reusables.identity-and-permissions.ip-allow-lists-edit-ip %} +{% data reusables.identity-and-permissions.ip-allow-lists-edit-description %} +1. Click **Update**. {% data reusables.identity-and-permissions.check-ip-address %} -{% ifversion ip-allow-list-address-check %} -## IP アドレスが許可されているかどうかを確認する +## Checking if an IP address is permitted {% data reusables.identity-and-permissions.about-checking-ip-address %} -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} {% data reusables.identity-and-permissions.check-ip-address-step %} {% endif %} +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +{% data reusables.identity-and-permissions.check-ip-address-step %} -## 許可 IP アドレスを削除する +## Deleting an allowed IP address -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.security %} {% data reusables.identity-and-permissions.ip-allow-lists-delete-entry %} {% data reusables.identity-and-permissions.ip-allow-lists-confirm-deletion %} +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.security %} +{% data reusables.identity-and-permissions.ip-allow-lists-delete-entry %} +{% data reusables.identity-and-permissions.ip-allow-lists-confirm-deletion %} -## IP許可リストで {% data variables.product.prodname_actions %} を使用する +## Using {% data variables.product.prodname_actions %} with an IP allow list {% data reusables.actions.ip-allow-list-self-hosted-runners %} diff --git a/translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md b/translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md index ddcbcd53d1..743dcf7071 100644 --- a/translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md +++ b/translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md @@ -486,8 +486,9 @@ For more information, see "[Managing the publication of {% data variables.produc | `oauth_app_access_approved` | Triggered when an owner [grants organization access to an {% data variables.product.prodname_oauth_app %}](/articles/approving-oauth-apps-for-your-organization/). | `oauth_app_access_denied` | Triggered when an owner [disables a previously approved {% data variables.product.prodname_oauth_app %}'s access](/articles/denying-access-to-a-previously-approved-oauth-app-for-your-organization) to your organization. | `oauth_app_access_requested` | Triggered when an organization member requests that an owner grant an {% data variables.product.prodname_oauth_app %} access to your organization.{% endif %} -{% ifversion ghec %} -| `org.transfer` | Triggered when an organization is transferred between enterprise accounts. For more information, see "[Transferring an organization between enterprise accounts](/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise#transferring-an-organization-between-enterprise-accounts)."{% endif %} +{%- ifversion ghec %} +| `org.transfer` | Triggered when an organization is transferred between enterprise accounts. For more information, see "[Transferring an organization between enterprise accounts](/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise#transferring-an-organization-between-enterprise-accounts)." +{%- endif %} | `register_self_hosted_runner` | Triggered when a new self-hosted runner is registered. For more information, see "[Adding a self-hosted runner to an organization](/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-organization)." | `remove_actions_secret` | Triggered when a {% data variables.product.prodname_actions %} secret is removed.{% ifversion fpt or ghec %} | `remove_billing_manager` | Triggered when an [owner removes a billing manager from an organization](/articles/removing-a-billing-manager-from-your-organization/) or when [two-factor authentication is required in an organization](/articles/requiring-two-factor-authentication-in-your-organization) and a billing manager doesn't use 2FA or disables 2FA. |{% endif %} diff --git a/translations/ja-JP/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md b/translations/ja-JP/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md index 6e30cf02ec..ecf4aa5c3f 100644 --- a/translations/ja-JP/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md +++ b/translations/ja-JP/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md @@ -15,12 +15,12 @@ topics: - Organizations - Teams shortTitle: Roles in an organization -ms.openlocfilehash: 960f6f701ad524220e9e79ada04fa9e4d30b8e9f -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: c6c345e3d1f0fb2c49aa55e79346bc4ac6567885 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148108803' +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159174' --- ## ロールについて {% data reusables.organizations.about-roles %} @@ -121,7 +121,7 @@ Organizationでの{% data variables.product.prodname_github_app %}マネージ | スポンサー プランを別の Organization に関連付ける (詳細については、「[Organization へのスポンサーシップの関連付け](/sponsors/sponsoring-open-source-contributors/attributing-sponsorships-to-your-organization)」を参照) | **X** | | | | | | Organization 内のリポジトリから {% data variables.product.prodname_pages %} サイトの公開を管理する (「[Organization の {% data variables.product.prodname_pages %} サイトの公開を管理する](/organizations/managing-organization-settings/managing-the-publication-of-github-pages-sites-for-your-organization)」を参照) | **X** | | | | | | セキュリティと分析の設定を管理する (「[Organization のセキュリティと分析設定を管理する](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization)」を参照) | **X** | | | | **X** | -| Organization のセキュリティの概要を表示する (「[セキュリティの概要について](/code-security/security-overview/about-the-security-overview)」を参照) | **X** | | | | **X** |{% ifversion ghec %} +| Organization のセキュリティの概要を表示する ([セキュリティの概要](/code-security/security-overview/about-the-security-overview)に関する説明を参照) | **X** | | | | **X** |{% ifversion ghec %} | [SAML シングル サインオン](/articles/about-identity-and-access-management-with-saml-single-sign-on)を有効にして適用する | **X** | | | | | | [Organization へのユーザーの SAML アクセスを管理する](/organizations/granting-access-to-your-organization-with-saml-single-sign-on/viewing-and-managing-a-members-saml-access-to-your-organization) | **X** | | | | | | Organization の SSH 認証局を管理する (「[Organization の SSH 認証局を管理する](/articles/managing-your-organizations-ssh-certificate-authorities)」を参照) | **X** | | | | |{% endif %} @@ -167,7 +167,7 @@ Organizationでの{% data variables.product.prodname_github_app %}マネージ | "*チーム メンテナ*" に指定できる | **X** | **X** | **X** | | リポジトリを移譲する | **X** | | | | セキュリティと分析の設定を管理する (「[Organization のセキュリティと分析設定を管理する](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization)」を参照) | **X** | | **X** |{% ifversion ghes %} -| Organization のセキュリティの概要を表示する (「[セキュリティの概要について](/code-security/security-overview/about-the-security-overview)」を参照) | **X** | | **X** |{% endif %}{% ifversion ghes %} +| Organization のセキュリティの概要を表示する ([セキュリティの概要](/code-security/security-overview/about-the-security-overview)に関する説明を参照) | **X** | | **X** |{% endif %}{% ifversion ghes %} | {% data variables.product.prodname_dependabot_security_updates %} を管理する (「[{% data variables.product.prodname_dependabot_security_updates %} について](/github/managing-security-vulnerabilities/about-dependabot-security-updates)」を参照) | **X** | | **X** |{% endif %} | Organization の SSH 認証局を管理する (「[Organization の SSH 認証局を管理する](/articles/managing-your-organizations-ssh-certificate-authorities)」を参照) | **X** | | | | プロジェクト ボードを作成する (「[Organization のプロジェクト ボード権限](/articles/project-board-permissions-for-an-organization)」を参照) | **X** | **X** | **X** | diff --git a/translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks.md b/translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks.md index d167d9caa8..53820923b2 100644 --- a/translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks.md +++ b/translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks.md @@ -1,6 +1,6 @@ --- -title: About forks -intro: A fork is a copy of a repository that you manage. Forks let you make changes to a project without affecting the original repository. You can fetch updates from or submit changes to the original repository with pull requests. +title: フォークについて +intro: フォークはユーザが管理するリポジトリのコピーです。 フォークを使えば、オリジナルのリポジトリに影響を与えることなくプロジェクトへの変更を行えます。 オリジナルのリポジトリから更新をフェッチしたり、プルリクエストでオリジナルのリポジトリに変更をサブミットしたりできます。 redirect_from: - /github/collaborating-with-issues-and-pull-requests/working-with-forks/about-forks - /articles/about-forks @@ -13,33 +13,39 @@ versions: ghec: '*' topics: - Pull requests +ms.openlocfilehash: 83372d27f052ee8c22730f5ce5d22e9efbf04fbb +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148158750' --- -Forking a repository is similar to copying a repository, with two major differences: +リポジトリのフォークはリポジトリのコピーと似ていますが、次の 2 つの大きな違いがあります。 -* You can use a pull request to suggest changes from your user-owned fork to the original repository in its GitHub instance, also known as the *upstream* repository. -* You can bring changes from the upstream repository to your local fork by synchronizing your fork with the upstream repository. +* pull request を使って、ユーザーが所有するフォークからの変更を、GitHub 内にあるオリジナルのリポジトリ (*上流* のリポジトリとも呼ばれます) に提案できます。 +* 上流のリポジトリと自分のフォークを同期させることで、上流のリポジトリからの変更を自分のローカルフォークへ持ち込めます。 {% data reusables.repositories.you-can-fork %} {% ifversion fpt or ghec %} -If you're a member of an {% data variables.enterprise.prodname_emu_enterprise %}, there are further restrictions on the repositories you can fork. {% data reusables.enterprise-accounts.emu-forks %} For more information, see "[About {% data variables.product.prodname_emus %}](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %} +{% data variables.enterprise.prodname_emu_enterprise %} のメンバーの場合、フォークできるリポジトリに対して、さらに制限があります。 {% data reusables.enterprise-accounts.emu-forks %} 詳しい情報については、{% data variables.product.prodname_ghe_cloud %} ドキュメントの「[{% data variables.product.prodname_emus %} について](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users){% ifversion fpt %}」を参照してください。{% else %}.{% endif %} {% endif %} {% data reusables.repositories.desktop-fork %} -Deleting a fork will not delete the original upstream repository. You can make any changes you want to your fork—add collaborators, rename files, generate {% data variables.product.prodname_pages %}—with no effect on the original.{% ifversion fpt or ghec %} You cannot restore a deleted forked repository. For more information, see "[Restoring a deleted repository](/articles/restoring-a-deleted-repository)."{% endif %} +フォークを削除しても、オリジナルの上流のリポジトリは削除されません。 オリジナルに影響を与えることなく、コラボレータの追加、ファイル名の変更、{% data variables.product.prodname_pages %} の生成など、自分のフォークに必要な変更を加えることができます。{% ifversion fpt or ghec %} 削除されたフォーク リポジトリを復元することはできません。 詳しい情報については、「[削除したリポジトリの復元](/articles/restoring-a-deleted-repository)」を参照してください。{% endif %} -In open source projects, forks are often used to iterate on ideas or changes before they are offered back to the upstream repository. When you make changes in your user-owned fork and open a pull request that compares your work to the upstream repository, you can give anyone with push access to the upstream repository permission to push changes to your pull request branch (including deleting the branch). This speeds up collaboration by allowing repository maintainers the ability to make commits or run tests locally to your pull request branch from a user-owned fork before merging. You cannot give push permissions to a fork owned by an organization. +オープンソースプロジェクトでは、フォークを使用して、上流のリポジトリに提供される前にアイデアや変更をイテレーションすることがよくあります。 ユーザーが所有するフォークに変更を加え、作業を上流リポジトリと比較する pull request をオープンすると、上流リポジトリにプッシュ アクセスできるどのユーザーにも、変更を pull request ブランチにプッシュする権限 (ブランチの削除を含む) を付与することができます。 これにより、リポジトリメンテナがマージする前に、ユーザが所有するフォークからプルリクエストブランチに対してローカルでコミットを実行したり、テストを実行したりすることができるようになり、コラボレーションがスピードアップします。 Organization が所有するフォークにプッシュ権限を与えることはできません。 {% data reusables.repositories.private_forks_inherit_permissions %} -If you want to create a new repository from the contents of an existing repository but don't want to merge your changes to the upstream in the future, you can duplicate the repository or, if the repository is a template, you can use the repository as a template. For more information, see "[Duplicating a repository](/articles/duplicating-a-repository)" and "[Creating a repository from a template](/articles/creating-a-repository-from-a-template)". +既存のリポジトリのコンテンツから新しいリポジトリを作成したいものの、その後は変更を上流にマージしたくない場合は、リポジトリを複製するか、リポジトリがテンプレートである場合は、リポジトリをテンプレートとして使うことができます。 詳しい情報については、「[リポジトリを複製する](/articles/duplicating-a-repository)」と「[テンプレートからリポジトリを作成する](/articles/creating-a-repository-from-a-template)」を参照します。 -## Further reading +## 参考資料 -- "[About collaborative development models](/pull-requests/collaborating-with-pull-requests/getting-started/about-collaborative-development-models)" -- "[Creating a pull request from a fork](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)" -- [Open Source Guides](https://opensource.guide/){% ifversion fpt or ghec %} +- 「[共同開発モデルについて](/pull-requests/collaborating-with-pull-requests/getting-started/about-collaborative-development-models)」 +- "[フォークから pull request を作成する](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)" +- [オープン ソース ガイド](https://opensource.guide/){% ifversion fpt or ghec %} - [{% data variables.product.prodname_learning %}]({% data variables.product.prodname_learning_link %}){% endif %} diff --git a/translations/ja-JP/content/repositories/creating-and-managing-repositories/about-repositories.md b/translations/ja-JP/content/repositories/creating-and-managing-repositories/about-repositories.md index 722c93cc98..4dab94d59c 100644 --- a/translations/ja-JP/content/repositories/creating-and-managing-repositories/about-repositories.md +++ b/translations/ja-JP/content/repositories/creating-and-managing-repositories/about-repositories.md @@ -18,12 +18,12 @@ versions: ghec: '*' topics: - Repositories -ms.openlocfilehash: af0b8eb9f8bd7a98c246a0806a8bc60f59ba147f -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 95e4033aa41f7920b5447554773dc61a181f5861 +ms.sourcegitcommit: 0a6e3eee6eea9b1e445aea1e4461d64cf6b63218 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: '148107286' +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163506' --- ## リポジトリについて @@ -44,6 +44,8 @@ ms.locfileid: '148107286' {% data reusables.repositories.repo-size-limit %} +リポジトリを最も効果的に使用する方法については、「[リポジトリのベスト プラクティス](/repositories/creating-and-managing-repositories/best-practices-for-repositories)」を参照してください。 + ## リポジトリの可視性について リポジトリの可視性 ({% ifversion ghes or ghec %}パブリック、内部、またはプライベート{% elsif ghae %}プライベートまたは内部{% else %}パブリックまたはプライベート{% endif %}) を選択することで、リポジトリにアクセスできるユーザーを制限できます。 @@ -132,7 +134,6 @@ diff はきわめて大きくなることがあるため、コミット、プル ## 参考資料 -- 「[新しいリポジトリの作成](/articles/creating-a-new-repository)」 - 「[フォークについて](/github/collaborating-with-pull-requests/working-with-forks/about-forks)」 - 「[Issue および pull request を使用した共同作業](/categories/collaborating-with-issues-and-pull-requests)」 - 「[{% data variables.product.prodname_dotcom %} での作業の管理](/categories/managing-your-work-on-github/)」 diff --git a/translations/ja-JP/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md b/translations/ja-JP/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md new file mode 100644 index 0000000000..e5cf7c055e --- /dev/null +++ b/translations/ja-JP/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md @@ -0,0 +1,35 @@ +--- +title: リポジトリのベスト プラクティス +shortTitle: Best practices +intro: リポジトリを最も効果的に使用する方法について説明します。 +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - Repositories +ms.openlocfilehash: f14bef158431c8251f26a4d917f4207d8e7dbc8a +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163475' +--- +## README ファイルを作成する + +作業内容を理解して参照しやすくするために、リポジトリごとに README ファイルを作成することをお勧めします。 + +{% data reusables.repositories.about-READMEs %} 詳しくは、「[READMEについて](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)」を参照してください。 + +## フォークよりもブランチを優先する + +コラボレーションを合理化するために、通常のコラボレーターは 1 つのリポジトリから作業し、リポジトリ間ではなくブランチ間で pull request を作成することをお勧めします。 フォークは、プロジェクトに関係のない人 (オープンソースの共同作成者など) からのコントリビューションを受けるのに最適です。 + +ブランチ ワークフローを使用しながら、重要なブランチ (`main` など) の品質を維持するために、必要な状態チェックと pull request レビューで保護されたブランチを使用できます。 詳細については、「[保護されたブランチについて](/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches)」を参照してください。 + +## {% data variables.large_files.product_name_long %} を使う + +パフォーマンスを最適化するために、{% data variables.location.product_location %} ではリポジトリ内で許可されるファイルのサイズが制限されています。 詳しくは、「[{% data variables.product.prodname_dotcom %} での大きいファイルについて](/repositories/working-with-files/managing-large-files/about-large-files-on-github)」をご覧ください。 + +Git リポジトリで大きなファイルを追跡するには、{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) を使うことをお勧めします。 詳しくは、「[{% data variables.large_files.product_name_long %} について](/repositories/working-with-files/managing-large-files/about-git-large-file-storage)」をご覧ください。 diff --git a/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md b/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md index 5450d81b0a..f618607c80 100644 --- a/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md +++ b/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md @@ -1,6 +1,6 @@ --- -title: About READMEs -intro: 'You can add a README file to your repository to tell other people why your project is useful, what they can do with your project, and how they can use it.' +title: READMEについて +intro: リポジトリにREADMEファイルを追加して、そのプロジェクトがなぜ有益なのか、そのプロジェクトで何ができるか、そのプロジェクトをどのように使えるかを他者に伝えることができます。 redirect_from: - /articles/section-links-on-readmes-and-blob-pages - /articles/relative-links-in-readmes @@ -14,25 +14,31 @@ versions: ghec: '*' topics: - Repositories +ms.openlocfilehash: 146f1a33eb4de224625b9603b27d2f383e55c54d +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148163337' --- -## About READMEs +## READMEについて {% data reusables.repositories.about-READMEs %} -For more information about providing guidelines for your project, see {% ifversion fpt or ghec %}"[Adding a code of conduct to your project](/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project)" and {% endif %}"[Setting up your project for healthy contributions](/communities/setting-up-your-project-for-healthy-contributions)." +プロジェクトのガイドラインを提供する方法について詳しくは、{% ifversion fpt or ghec %}「[プロジェクトへの行動規範の追加](/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project)」および{% endif %}「[健全なコントリビューションを促すプロジェクトをセットアップする](/communities/setting-up-your-project-for-healthy-contributions)」を参照してください。 -A README is often the first item a visitor will see when visiting your repository. README files typically include information on: -- What the project does -- Why the project is useful -- How users can get started with the project -- Where users can get help with your project -- Who maintains and contributes to the project +多くの場合、READMEはリポジトリへの訪問者が最初に目にするアイテムです。 通常、README ファイルには以下の情報が含まれています: +- このプロジェクトが行うこと +- このプロジェクトが有益な理由 +- このプロジェクトの使い始め方 +- このプロジェクトに関するヘルプをどこで得るか +- このプロジェクトのメンテナンス者とコントリビューター -If you put your README file in your repository's hidden `.github`, root, or `docs` directory, {% data variables.product.product_name %} will recognize and automatically surface your README to repository visitors. +README ファイルをリポジトリの隠れ `.github` ルートまたは `docs` ディレクトリに置けば、{% data variables.product.product_name %} はそれを認識して自動的に README をリポジトリへの訪問者に提示します。 -If a repository contains more than one README file, then the file shown is chosen from locations in the following order: the `.github` directory, then the repository's root directory, and finally the `docs` directory. +リポジトリに複数の README ファイルが含まれている場合、表示されるファイルは、`.github` ディレクトリ、リポジトリのルート ディレクトリ、最後に `docs` ディレクトリの順に選択されます。 -![Main page of the github/scientist repository and its README file](/assets/images/help/repository/repo-with-readme.png) +![github/scientistリポジトリのメインページとそのREADMEファイル](/assets/images/help/repository/repo-with-readme.png) {% ifversion fpt or ghes or ghec %} @@ -40,30 +46,28 @@ If a repository contains more than one README file, then the file shown is chose {% endif %} -![README file on your username/username repository](/assets/images/help/repository/username-repo-with-readme.png) +![ユーザ名/ユーザ名リポジトリの README ファイル](/assets/images/help/repository/username-repo-with-readme.png) -## Auto-generated table of contents for README files +## README ファイルの自動生成された目次 -For the rendered view of any Markdown file in a repository, including README files, {% data variables.product.product_name %} will automatically generate a table of contents based on section headings. You can view the table of contents for a README file by clicking the {% octicon "list-unordered" aria-label="The unordered list icon" %} menu icon at the top left of the rendered page. +README ファイルなど、リポジトリの Markdown ファイルをレンダリングすると、{% data variables.product.product_name %} によって、セクション見出しに基づいて目次が自動的に生成されます。 レンダリングされたページの左上にある {% octicon "list-unordered" aria-label="The unordered list icon" %} メニューアイコンをクリックすると、README ファイルの目次を表示できます。 -![README with automatically generated TOC](/assets/images/help/repository/readme-automatic-toc.png) +![自動的に生成された TOC を含む README](/assets/images/help/repository/readme-automatic-toc.png) -## Section links in README files and blob pages +## READMEファイルのセクションリンクとblobページ {% data reusables.repositories.section-links %} -## Relative links and image paths in README files +## READMEファイル中の相対リンクと画像パス {% data reusables.repositories.relative-links %} -## Wikis +## Wiki -A README should contain only the necessary information for developers to get started using and contributing to your project. Longer documentation is best suited for wikis. For more information, see "[About wikis](/communities/documenting-your-project-with-wikis/about-wikis)." +README には、開発者がプロジェクトを使用し、プロジェクトに貢献するために必要な情報のみを含めてください。 長いドキュメントは Wiki に最適です。 詳しくは、「[Wiki について](/communities/documenting-your-project-with-wikis/about-wikis)」を参照してください。 -## Further reading +## 参考資料 -- "[Adding a file to a repository](/articles/adding-a-file-to-a-repository)" -- 18F's "[Making READMEs readable](https://github.com/18F/open-source-guide/blob/18f-pages/pages/making-readmes-readable.md)" -{%- ifversion fpt or ghec %} -- "[Adding an 'Open in GitHub Codespaces' badge](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)" -{%- endif %} +- "[ファイルをリポジトリに追加する](/articles/adding-a-file-to-a-repository)" +- 18F の「[README を読み取り可能にする](https://github.com/18F/open-source-guide/blob/18f-pages/pages/making-readmes-readable.md)」{%- ifversion fpt or ghec %} +- 「[[GitHub Codespaces で開く] バッジを追加する](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)」{%- endif %} diff --git a/translations/ja-JP/content/repositories/working-with-files/using-files/navigating-code-on-github.md b/translations/ja-JP/content/repositories/working-with-files/using-files/navigating-code-on-github.md index 6b3d53ac1f..6a00923df9 100644 --- a/translations/ja-JP/content/repositories/working-with-files/using-files/navigating-code-on-github.md +++ b/translations/ja-JP/content/repositories/working-with-files/using-files/navigating-code-on-github.md @@ -1,6 +1,6 @@ --- -title: Navigating code on GitHub -intro: 'You can understand the relationships within and across repositories by navigating code directly in {% data variables.product.product_name %}.' +title: GitHub 上のコード間を移動する +intro: '{% data variables.product.product_name %} で直接コードを移動することにより、リポジトリ内およびリポジトリ間の関係について理解できます。' redirect_from: - /articles/navigating-code-on-github - /github/managing-files-in-a-repository/navigating-code-on-github @@ -10,18 +10,24 @@ versions: ghec: '*' topics: - Repositories +ms.openlocfilehash: 89fc5092468d50484cfcad71824870b6456d9ac7 +ms.sourcegitcommit: 1529de77bfcbe45519131b5f5fb3ab319758c2d2 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: '148164164' --- -## About navigating code on {% data variables.product.prodname_dotcom %} +## {% data variables.product.prodname_dotcom %} のナビゲーションコードについて -Code navigation helps you to read, navigate, and understand code by showing and linking definitions of a named entity corresponding to a reference to that entity, as well as references corresponding to an entity's definition. +コード ナビゲーションは、そのエンティティへの参照に対応する名前付きエンティティの定義と、エンティティの定義に対応する参照を表示しリンクすることで、コードの読み取り、ナビゲーション、理解に役立ちます。 -![Code navigation display](/assets/images/help/repository/code-navigation-popover.png) +![コード ナビゲーションの表示](/assets/images/help/repository/code-navigation-popover.png) -Code navigation uses the open source [`tree-sitter`](https://github.com/tree-sitter/tree-sitter) library. The following languages and navigation strategies are supported: +コード ナビゲーションでは、オープン ソースの [`tree-sitter`](https://github.com/tree-sitter/tree-sitter) ライブラリを使用します。 次の言語とナビゲーション戦略がサポートされています。 -| Language | Search-based code navigation | Precise code navigation | +| 言語 | 検索ベースのコード ナビゲーション | 正確なコード ナビゲーション | |:----------:|:----------------------------:|:-----------------------:| | C# | ✅ | | | CodeQL | ✅ | | @@ -36,49 +42,49 @@ Code navigation uses the open source [`tree-sitter`](https://github.com/tree-sit | TypeScript | ✅ | | -You do not need to configure anything in your repository to enable code navigation. We will automatically extract search-based and precise code navigation information for these supported languages in all repositories and you can switch between the two supported code navigation approaches if your programming language is supported by both. +コード ナビゲーションを有効にするために、リポジトリで何かを構成する必要はありません。 サポートされているこれらの言語の検索ベースのナビゲーション情報と正確なコード ナビゲーション情報をすべてのリポジトリで自動的に抽出し、プログラミング言語が両方でサポートされている場合は、サポートされている 2 つのコード ナビゲーション アプローチを切り替えることができます。 -{% data variables.product.prodname_dotcom %} has developed two code navigation approaches based on the open source [`tree-sitter`](https://github.com/tree-sitter/tree-sitter) and [`stack-graphs`](https://github.com/github/stack-graphs) library: - - Search-based - searches all definitions and references across a repository to find entities with a given name - - Precise - resolves definitions and references based on the set of classes, functions, and imported definitions at a given point in your code +{% data variables.product.prodname_dotcom %} では、オープン ソースの [`tree-sitter`](https://github.com/tree-sitter/tree-sitter) と [`stack-graphs`](https://github.com/github/stack-graphs) ライブラリに基づいて 2 つのコード ナビゲーション アプローチが開発されました。 + - 検索ベース - リポジトリ全体のすべての定義と参照を検索して、特定の名前のエンティティを見つける + - 正確 - コード内の特定のポイントにあるクラス、関数、インポートされた定義のセットに基づいて定義と参照を解決する -To learn more about these approaches, see "[Precise and search-based navigation](#precise-and-search-based-navigation)." +これらのアプローチの詳細については、「[正確なナビゲーションと検索ベースのナビゲーション](#precise-and-search-based-navigation)」を参照してください。 -Future releases will add *precise code navigation* for more languages, which is a code navigation approach that can give more accurate results. +将来のリリースでは、より正確な結果を得ることができるコード ナビゲーション アプローチである、*正確なコード ナビゲーション* が、より多くの言語について追加されます。 -## Jumping to the definition of a function or method +## 関数やメソッドの定義にジャンプする -You can jump to a function or method's definition within the same repository by clicking the function or method call in a file. +ファイル内の関数またはメソッドの呼び出しをクリックすることで、同じリポジトリ内の関数またはメソッドの定義にジャンプできます。 -![Jump-to-definition tab](/assets/images/help/repository/jump-to-definition-tab.png) +![[Jump-to-definition] タブ](/assets/images/help/repository/jump-to-definition-tab.png) -## Finding all references of a function or method +## 関数とメソッドの全リファレンスを検索する -You can find all references for a function or method within the same repository by clicking the function or method call in a file, then clicking the **References** tab. +ファイル内の関数またはメソッドの呼び出しをクリックして **[参照]** タブをクリックすることで、同じリポジトリ内の関数またはメソッドのすべての参照を検索できます。 -![Find all references tab](/assets/images/help/repository/find-all-references-tab.png) +![[Find all references] タブ](/assets/images/help/repository/find-all-references-tab.png) -## Precise and search-based navigation +## 正確なナビゲーションと検索ベースのナビゲーション -Certain languages supported by {% data variables.product.prodname_dotcom %} have access to *precise code navigation*, which uses an algorithm (based on the open source [`stack-graphs`](https://github.com/github/stack-graphs) library) that resolves definitions and references based on the set of classes, functions, and imported definitions that are visible at any given point in your code. Other languages use *search-based code navigation*, which searches all definitions and references across a repository to find entities with a given name. Both strategies are effective at finding results and both make sure to avoid inappropriate results such as comments, but precise code navigation can give more accurate results, especially when a repository contains multiple methods or functions with the same name. +{% data variables.product.prodname_dotcom %} でサポートされている一部の言語では、コード内の任意の時点で表示されるクラス、関数、インポートされた定義のセットに基づいて定義と参照を解決するアルゴリズム (オープン ソース [`stack-graphs`](https://github.com/github/stack-graphs) ライブラリに基づく) を使用する *正確なコード ナビゲーション* にアクセスできます。 *検索ベースのコード ナビゲーション* を使用する言語もあります。この場合は、リポジトリ全体のすべての定義と参照を検索して、特定の名前のエンティティを見つけます。 どちらの方法も結果を見つけるのに効果的であり、どちらもコメントなどの不適切な結果を避けるようにしますが、特にリポジトリに同じ名前の複数のメソッドや関数が含まれている場合は、正確なコード ナビゲーションを使用すると、より正確な結果が得られます。 -If you don't see the results you expect from a precise code navigation query, you can click on the "search-based" link in the displayed popover to perform search-based navigation. +正確なコード ナビゲーション クエリで想定される結果が得られない場合は、表示されるポップオーバーの [検索ベース] リンクをクリックして、検索ベースのナビゲーションを実行できます。 -![Search-based code navigation link](/assets/images/help/repository/search-based-code-navigation-link.png) +![検索ベースのコード ナビゲーション リンク](/assets/images/help/repository/search-based-code-navigation-link.png) -If your precise results appear inaccurate, you can file a support request. +正確なコード ナビゲーションの結果が不正確と思われる場合は、サポート要求を提出できます。 -## Cross-repository precise code navigation +## リポジトリ間の正確なコード ナビゲーション -Cross-repo code navigation is available for languages that are supported by precise code navigation and the dependency graph. For more information, see "[About the dependency graph](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph)." With cross-repo code navigation, you can jump to the definition of functions or variables defined in dependencies imported by your project if that dependency is a repository hosted by {% data variables.product.prodname_dotcom %}. Cross-repo code navigation does not support find-all-references requests at this time. +リポジトリ間のコード ナビゲーションは、正確なコード ナビゲーションと依存関係グラフによってサポートされている言語で使用できます。 詳細については、「[依存関係グラフについて](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph)」を参照してください。 リポジトリ間のコード ナビゲーションを使用すると、プロジェクトによってインポートされた依存関係で定義されている関数や変数の定義にジャンプできます (その依存関係が {% data variables.product.prodname_dotcom %} によってホストされるリポジトリである場合)。 現時点では、リポジトリ間のコード ナビゲーションでは、すべての参照を検索する要求はサポートされていません。 -![Screenshot of cross-repository code navigation](/assets/images/help/repository/cross-repository-code-navigation.png) +![リポジトリ間コード ナビゲーションのスクリーンショット](/assets/images/help/repository/cross-repository-code-navigation.png) -## Troubleshooting code navigation +## コード ナビゲーションのトラブルシューティング -If code navigation is enabled for you but you don't see links to the definitions of functions and methods: -- Code navigation only works for active branches. Push to the branch and try again. -- Code navigation only works for repositories with fewer than 100,000 files. +コード ナビゲーションが有効になっているにもかかわらず、関数とメソッドの定義へのリンクが表示されない場合: +- コード ナビゲーションは、アクティブなブランチに対してのみ機能します。 ブランチにプッシュして、もう一度やり直してください。 +- コード ナビゲーションが動作するのは、100,000 個未満のファイルをもつリポジトリのみです。 -## Further reading -- "[Searching code](/github/searching-for-information-on-github/searching-code)" +## 参考資料 +- 「[コードの検索](/github/searching-for-information-on-github/searching-code)」 diff --git a/translations/ja-JP/content/rest/overview/libraries.md b/translations/ja-JP/content/rest/overview/libraries.md index fb72c8370f..3b8dbcae50 100644 --- a/translations/ja-JP/content/rest/overview/libraries.md +++ b/translations/ja-JP/content/rest/overview/libraries.md @@ -11,12 +11,12 @@ versions: ghec: '*' topics: - API -ms.openlocfilehash: aa139c0d25354260ccf688079f3e15a871b627bd -ms.sourcegitcommit: 0ed77777360ec29eee7cd4fc212ae36fdd97c0bc +ms.openlocfilehash: 4560ae5e63f8a607f068bb24e84f1a014f44885c +ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 11/11/2022 -ms.locfileid: '148160963' +ms.lasthandoff: 11/21/2022 +ms.locfileid: '148179737' --- ![Gundamcat](/assets/images/gundamcat.png) @@ -35,7 +35,7 @@ ms.locfileid: '148160963' | ライブラリ名 | リポジトリ | |---|---| -|**Tentacles**| [Raynes/tentacles](https://github.com/Raynes/tentacles)| +|**Tentacles**| [Raynes/tentacles](https://github.com/clj-commons/tentacles)| ### Dart diff --git a/translations/ja-JP/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md b/translations/ja-JP/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md index 86af4520c6..2ff7c3f65b 100644 --- a/translations/ja-JP/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md +++ b/translations/ja-JP/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md @@ -1,6 +1,6 @@ --- -title: About searching on GitHub -intro: 'Our integrated search covers the many repositories, users, and lines of code on {% data variables.product.product_name %}.' +title: GitHub での検索について +intro: 'GitHub の統合検索機能は、{% data variables.product.product_name %}上の多くのリポジトリ、ユーザ、コードの行が対象です。' redirect_from: - /articles/using-the-command-bar - /articles/github-search-basics @@ -17,79 +17,82 @@ versions: ghec: '*' topics: - GitHub search +ms.openlocfilehash: 58ecec218d8f8f0ee3d11afbf65debf7df72e811 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148159102' --- +{% ifversion github-code-search %} {% note %} -{% ifversion github-code-search %} - {% note %} + **注:** {% data reusables.search.classic-search-code-search-note %} - **Note:** {% data reusables.search.classic-search-code-search-note %} - - {% endnote %} -{% endif %} + {% endnote %} {% endif %} {% data reusables.search.you-can-search-globally %} -- To search globally across all of {% data variables.product.product_name %}, type what you're looking for into the search field at the top of any page, and choose "All {% data variables.product.prodname_dotcom %}" in the search drop-down menu. -- To search within a particular repository or organization, navigate to the repository or organization page, type what you're looking for into the search field at the top of the page, and press **Enter**. +- {% data variables.product.product_name %} 全体にわたってグローバルに検索するには、探している内容を任意のページの上部にある検索フィールドに入力し、[All {% data variables.product.prodname_dotcom %}] を検索ドロップダウンメニューで選択します。 +- 特定のリポジトリや Organization 内で検索するには、そのリポジトリまたは Organization のページにアクセスし、検索する内容をページの上部にある検索フィールドに入力して、**Enter** キーを押します。 {% note %} -**Notes:** +**注:** {% ifversion fpt or ghes or ghec %} - {% data reusables.search.required_login %}{% endif %} -- {% data variables.product.prodname_pages %} sites are not searchable on {% data variables.product.product_name %}. However you can search the source content if it exists in the default branch of a repository, using code search. For more information, see "[Searching code](/search-github/searching-on-github/searching-code)." For more information about {% data variables.product.prodname_pages %}, see "[What is GitHub Pages?](/articles/what-is-github-pages/)" -- Currently our search doesn't support exact matching. -- Whenever you are searching in code files, only the first two results in each file will be returned. +- {% data variables.product.prodname_pages %}サイトは、{% data variables.product.product_name %}上では検索できません。 ただし、コンテンツのソースがリポジトリのデフォルトブランチにある場合は、コード検索を使って検索できます。 詳しい情報については、「[コードの検索](/search-github/searching-on-github/searching-code)」を参照してください。 {% data variables.product.prodname_pages %} の詳しい情報については、[GitHub Pages について](/articles/what-is-github-pages/)のページを参照してください +- 現在、GitHub の検索は完全一致をサポートしていません。 +- コードファイルのどこを検索しても、返されるのは各ファイルで最初の 2 つの結果のみです。 {% endnote %} -After running a search on {% data variables.product.product_name %}, you can sort the results, or further refine them by clicking one of the languages in the sidebar. For more information, see "[Sorting search results](/search-github/getting-started-with-searching-on-github/sorting-search-results)." +{% data variables.product.product_name %}上で検索を行った後、結果をソートしたり、サイドバー内の言語の 1 つをクリックしてさらに絞り込んだりすることができます。 詳しい情報については、「[検索結果をソートする](/search-github/getting-started-with-searching-on-github/sorting-search-results)」を参照してください。 -{% data variables.product.product_name %} search uses an ElasticSearch cluster to index projects every time a change is pushed to {% data variables.product.product_name %}. Issues and pull requests are indexed when they are created or modified. +{% data variables.product.product_name %}の検索は、変更が {% data variables.product.product_name %}にプッシュされるたびにプロジェクトを Elasticsearch クラスタを使ってインデックス付けしています。 Issue やプルリクエストは、作成あるいは変更されると同時にインデックス付けされます。 -## Types of searches on {% data variables.product.prodname_dotcom %} +## {% data variables.product.prodname_dotcom %}での検索の種類 -You can search for the following information across all repositories you can access on {% data variables.location.product_location %}. +以下の情報は、{% data variables.location.product_location %} でアクセスできるすべてのリポジトリから検索できます。 -- [Repositories](/search-github/searching-on-github/searching-for-repositories) -- [Topics](/search-github/searching-on-github/searching-topics) -- [Issues and pull requests](/search-github/searching-on-github/searching-issues-and-pull-requests){% ifversion fpt or ghec %} -- [Discussions](/search-github/searching-on-github/searching-discussions){% endif %} -- [Code](/search-github/searching-on-github/searching-code) -- [Commits](/search-github/searching-on-github/searching-commits) -- [Users](/search-github/searching-on-github/searching-users) -- [Packages](/search-github/searching-on-github/searching-for-packages) -- [Wikis](/search-github/searching-on-github/searching-wikis) +- [リポジトリ](/search-github/searching-on-github/searching-for-repositories) +- [トピック](/search-github/searching-on-github/searching-topics) +- [問題と pull request](/search-github/searching-on-github/searching-issues-and-pull-requests){% ifversion fpt or ghec %} +- [ディスカッション](/search-github/searching-on-github/searching-discussions){% endif %} +- [コード](/search-github/searching-on-github/searching-code) +- [コミット](/search-github/searching-on-github/searching-commits) +- [ユーザー](/search-github/searching-on-github/searching-users) +- [パッケージ](/search-github/searching-on-github/searching-for-packages) +- [Wiki](/search-github/searching-on-github/searching-wikis) -## Searching using a visual interface +## ビジュアルインターフェースを使った検索 -You can search {% data variables.product.product_name %} using the {% data variables.search.search_page_url %} or {% data variables.search.advanced_url %}. {% ifversion command-palette %}Alternatively, you can use the interactive search in the {% data variables.product.prodname_command_palette %} to search your current location in the UI, a specific user, repository or organization, and globally across all of {% data variables.product.product_name %}, without leaving the keyboard. For more information, see "[{% data variables.product.prodname_command_palette %}](/get-started/using-github/github-command-palette)."{% endif %} +{% data variables.search.search_page_url %} または {% data variables.search.advanced_url %} を使って、{% data variables.product.product_name %} を検索できます。 {% ifversion command-palette %}または、{% data variables.product.prodname_command_palette %} で対話型検索を行うと、キーボードを使ったままで、UI、特定のユーザー、リポジトリ、組織内だけではなく、{% data variables.product.product_name %} 全体でグローバルに、現在の場所を検索することもできます。 詳しい情報については、「[{% data variables.product.prodname_command_palette %}](/get-started/using-github/github-command-palette)」を参照してください。{% endif %} -The {% data variables.search.advanced_url %} provides a visual interface for constructing search queries. You can filter your searches by a variety of factors, such as the number of stars or number of forks a repository has. As you fill in the advanced search fields, your query will automatically be constructed in the top search bar. +{% data variables.search.advanced_url %}は、検索クエリを構築するビジュアルなインターフェースを提供します。 検索は、Star 数やリポジトリの持つフォーク数など、様々な要素でフィルタリングできます。 高度な検索フィールドに記入していくに従って、上部の検索バーでは自動的にクエリが構築されていきます。 -![Advanced Search](/assets/images/help/search/advanced_search_demo.gif) +![高度な検索](/assets/images/help/search/advanced_search_demo.gif) -## Searching repositories on {% data variables.product.prodname_dotcom_the_website %} from your private enterprise environment +## プライベート Enterprise 環境から {% data variables.product.prodname_dotcom_the_website %} でリポジトリを検索する {% ifversion fpt or ghec %} -If you use both {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_ghe_server %} or {% data variables.product.prodname_ghe_managed %}, and an enterprise owner has enabled {% data variables.enterprise.prodname_unified_search %}, you can search across both environments at the same time from {% data variables.product.prodname_ghe_server %} or {% data variables.product.prodname_ghe_managed %}. For more information, see [the {% data variables.product.prodname_ghe_server %} documentation](/enterprise-server@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment) or [the {% data variables.product.prodname_ghe_managed %} documentation](/github-ae@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment). +{% data variables.product.prodname_dotcom_the_website %} と {% data variables.product.prodname_ghe_server %} または {% data variables.product.prodname_ghe_managed %} の両方を使う場合や Enterprise 所有者が {% data variables.enterprise.prodname_unified_search %} を有効にしている場合は、{% data variables.product.prodname_ghe_server %} または {% data variables.product.prodname_ghe_managed %} から両方の環境で同時に検索できます。 詳しい情報については、[{% data variables.product.prodname_ghe_server %} のドキュメント](/enterprise-server@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment)、または [{% data variables.product.prodname_ghe_managed %} のドキュメント](/github-ae@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment)を参照してください。 {% else %} -If you use both {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.product_name %}, and an enterprise owner has enabled {% data variables.enterprise.prodname_unified_search %}, you can search across both environments at the same time from {% data variables.product.product_name %}. For more information about how enterprise owners can enable {% data variables.enterprise.prodname_unified_search %}, see "[Enabling {% data variables.enterprise.prodname_unified_search %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)." +{% data variables.product.prodname_dotcom_the_website %} と {% data variables.product.product_name %} の両方を使う場合や Enterprise 所有者が {% data variables.enterprise.prodname_unified_search %} を有効にしている場合は、{% data variables.product.product_name %} から、両方の環境で同時に検索できます。 Enterprise 所有者が {% data variables.enterprise.prodname_unified_search %} を有効にする方法については、[Enterprise での {% data variables.enterprise.prodname_unified_search %} の有効化](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)に関するページを参照してください。 -Your enterprise owner on {% data variables.product.product_name %} can separately enable {% data variables.enterprise.prodname_unified_search %} for all public repositories on {% data variables.product.prodname_dotcom_the_website %} and for private repositories owned by the organization or enterprise on {% data variables.product.prodname_dotcom_the_website %} that is connected to {% data variables.product.product_name %} through {% data variables.product.prodname_github_connect %}. +{% data variables.product.product_name %} の Enterprise 所有者は、{% data variables.product.prodname_dotcom_the_website %} のすべてのパブリック リポジトリや、{% data variables.product.prodname_github_connect %} 経由で {% data variables.product.product_name %} に接続されている {% data variables.product.prodname_dotcom_the_website %} の Organization または Enterprise が所有するプライベート リポジトリに対して、{% data variables.enterprise.prodname_unified_search %} を個別に有効にすることができます。 -Before you can use {% data variables.enterprise.prodname_unified_search %} for private repositories, you must connect your personal accounts on {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.product_name %}. For more information, see "[Enabling {% data variables.product.prodname_dotcom_the_website %} repository search from your private enterprise environment](/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment)." +プライベート リポジトリに {% data variables.enterprise.prodname_unified_search %} を使うには、{% data variables.product.prodname_dotcom_the_website %} と {% data variables.product.product_name %} の個人用アカウントを接続する必要があります。 詳しい情報については、「[プライベート Enterprise 環境からの {% data variables.product.prodname_dotcom_the_website %} リポジトリの検索を有効にする](/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment)」を参照してください。 -When you search from {% data variables.product.product_name %}, only private repositories that you have access to and that are owned by the connected organization or enterprise account will be included in search results. Neither you nor anyone else will be able to search private repositories owned by your personal account on {% data variables.product.prodname_dotcom_the_website %} from {% data variables.product.product_name %}. +{% data variables.product.product_name %} から検索する場合の検索結果には、アクセス可能で、接続されている Organization アカウントまたは Enterprise アカウントが所有するプライベート リポジトリのみが含まれます。 すべてのユーザーは、{% data variables.product.product_name %} から {% data variables.product.prodname_dotcom_the_website %} の個人用アカウントが所有するプライベート リポジトリを検索することはできません。 -To limit your search to one environment, you can use a filter option on the {% data variables.search.advanced_url %} or you can use the `environment:` search prefix. To only search for content on {% data variables.product.product_name %}, use the search syntax `environment:local`. To only search for content on {% data variables.product.prodname_dotcom_the_website %}, use `environment:github`. +検索を 1 つの環境に制限するには、{% data variables.search.advanced_url %} に対してフィルター オプションを使うか、`environment:` 検索プレフィックスを使います。 {% data variables.product.product_name %} のコンテンツのみを検索するには、検索構文 `environment:local` を使います。 {% data variables.product.prodname_dotcom_the_website %} のコンテンツのみを検索するには、`environment:github` を使います。 {% endif %} -## Further reading +## 参考資料 -- "[Understanding the search syntax](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax)" -- "[Searching on GitHub](/articles/searching-on-github)" +- 「[検索構文を理解する](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax)」 +- 「[GitHub 上で検索する](/articles/searching-on-github)」 diff --git a/translations/ja-JP/content/search-github/github-code-search/about-github-code-search.md b/translations/ja-JP/content/search-github/github-code-search/about-github-code-search.md new file mode 100644 index 0000000000..6d3f336b2d --- /dev/null +++ b/translations/ja-JP/content/search-github/github-code-search/about-github-code-search.md @@ -0,0 +1,58 @@ +--- +title: GitHub Code Search (ベータ版) について +intro: 新しいコード検索 (ベータ版) を使用すると、GitHub 全体のコードを検索、移動、理解できます。 +allowTitleToDifferFromFilename: true +versions: + feature: github-code-search +topics: + - GitHub search +ms.openlocfilehash: 8bf3232e87de2fc773f69bf5047e75ab0e52c7e2 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160227' +--- +{% note %} + +**注:** {% data reusables.search.code-search-code-view-beta-note %} + +{% data reusables.search.code-view-link %} + +{% endnote %} + +## 新しいコード検索 (ベータ版) について + +新しいコード検索 (ベータ版) を使用すると、コード、チームのコード、オープン ソース コミュニティのコードを、すべて {% data variables.product.prodname_dotcom_the_website %} からすばやく検索、ナビゲート、理解できます。 この検索エンジンは、正規表現、ブール演算、特殊な修飾子、シンボル検索を使用して GitHub 全体でのコード検索がスケーラブルで、コード対応になり、サポートされるように設計されています。 新しいコード検索 (ベータ版) の構文について詳しくは、「[GitHub Code Search (ベータ版) 構文について](/search-github/github-code-search/understanding-github-code-search-syntax)」を参照してください。 + +新しいコード検索エンジンに加えて、コード検索 (ベータ版) には、{% data variables.product.prodname_dotcom_the_website %} の検索インターフェイスに、検索候補、入力候補、検索を保存する機能などの新機能が含まれています。 新しい検索インターフェイスを使用すると、探しているものをより迅速かつ簡単に見つけることができます。 詳細については、「[GitHub Code Search (ベータ版) の使用](/search-github/github-code-search/using-github-code-search)」を参照してください。 + +{% data reusables.search.non-code-search-explanation %} + +新しいコード検索 (ベータ版) は、{% data variables.product.prodname_dotcom_the_website %} の再設計されたコード ビュー (ベータ版) と緊密に統合されています。 {% data reusables.search.code-view-link %} + +新しいコード検索 (ベータ版) と新しいコード ビューにアクセスするには、[Waitlist](https://github.com/features/code-search-code-view/signup) にサインアップします。 + +## 新しいコード検索とコード ビューの有効化と無効化 (ベータ版) + +{% data reusables.search.enabling-and-disabling-code-search-and-view-beta %} + +## 制限事項 + +新しいコード検索 (ベータ版) 用に多数のパブリック リポジトリにインデックスを作成し、さらにインデックスを作成し続けます。 さらに、ベータ版の GitHub ユーザーのプライベート リポジトリは、既に GitHub.com 上のプライベート リポジトリにアクセスできるベータ版の参加者によってインデックスが作成され、検索可能になっています。 ただし、現時点では非常に大きなリポジトリにインデックスを作成できない場合があり、すべてのコードにインデックスが作成されるわけではありません。 + +インデックス付きコードに関する現在の制限は次のとおりです。 + - ベンダー化されたコードと生成されたコードは除外されます ([Enry](https://github.com/go-enry/go-enry) によって決定されます) + - 空のファイルと 350 KiB を超えるファイルは除外されます + - UTF-8 でエンコードされたファイルのみが含まれます + - 非常に大きなリポジトリにインデックスを作成できない場合があります + +現在、リポジトリの既定のブランチでのコードの検索のみがサポートされています。 + +新しいコード検索 (ベータ版) を使用した検索の結果は、100 件の結果 (10 ページ) に制限されます。 現時点では、コード検索結果の並べ替えはサポートされていません。 この制限は、新しいコード検索 (ベータ版) を使用したコードの検索にのみ適用され、他の種類の検索には適用されません。 + +新しいコード検索 (ベータ版) では、`symbol:` 修飾子を使用したコード内のシンボル定義 (関数やクラス定義など) の検索がサポートされています。 ただし、`symbol:` 修飾子は定義のみを検索し、参照は検索しないこと、また、すべてのシンボル型または言語がまだ完全にサポートされているわけではないことに注意してください。 サポートされている言語の一覧については、「[シンボル修飾子](/search-github/github-code-search/understanding-github-code-search-syntax#symbol-qualifier)」を参照してください。 + +## フィードバックとサポート + +[ディスカッション フォーラム](https://github.com/orgs/community/discussions/categories/code-search-and-navigation)では、新しいコード検索 (ベータ版) に関するフィードバックを表示して共有できます。 diff --git a/translations/ja-JP/content/search-github/github-code-search/index.md b/translations/ja-JP/content/search-github/github-code-search/index.md new file mode 100644 index 0000000000..30f6e61cc2 --- /dev/null +++ b/translations/ja-JP/content/search-github/github-code-search/index.md @@ -0,0 +1,26 @@ +--- +title: GitHub Code Search (ベータ版) +intro: 'さまざまな構文を使用して、{% data variables.product.product_name %} を検索できます。 検索範囲の調整、クエリの作成とトラブルシューティング、修飾子を使用した検索結果の絞り込みを行うことができます。' +allowTitleToDifferFromFilename: true +versions: + feature: github-code-search +topics: + - GitHub search +children: + - /about-github-code-search + - /using-github-code-search + - /understanding-github-code-search-syntax +ms.openlocfilehash: a2420a27a7026b61dff0d05650d4b525f9d55adb +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160031' +--- +{% note %} + +**注:** {% data reusables.search.code-search-code-view-beta-note %} + +{% data reusables.search.code-search-link %} {% data reusables.search.code-view-link %} + +{% endnote %} diff --git a/translations/ja-JP/content/search-github/github-code-search/understanding-github-code-search-syntax.md b/translations/ja-JP/content/search-github/github-code-search/understanding-github-code-search-syntax.md new file mode 100644 index 0000000000..6d31c4f6ba --- /dev/null +++ b/translations/ja-JP/content/search-github/github-code-search/understanding-github-code-search-syntax.md @@ -0,0 +1,293 @@ +--- +title: GitHub Code Search (ベータ版) の構文について +intro: 特殊なコード修飾子、正規表現、ブール演算を使用して、必要な結果の検索クエリを作成できます。 +allowTitleToDifferFromFilename: true +versions: + feature: github-code-search +topics: + - GitHub search +ms.openlocfilehash: 098da2b7fe8a8c5466805c583e6b029b5b9b58c1 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160064' +--- +{% note %} + +**注:** {% data reusables.search.code-search-code-view-beta-note %} + +{% data reusables.search.code-search-link %} {% data reusables.search.code-view-link %} + +{% endnote %} + +## 新しいコード検索 (ベータ版) のクエリ構造について + +この記事の検索構文は、新しいコード検索 (ベータ版) が有効になっているコードの検索にのみ適用されます。 {% data reusables.search.non-code-search-explanation %} + +検索クエリは、検索したいテキストと、検索を絞り込む修飾子で構成される検索用語で構成されます。 + +修飾子のないただの用語は、ファイルの内容またはファイルのパスのいずれかと一致します。 + +たとえば、次のクエリがあります。 + +``` +http-push +``` + +上記のクエリは、用語 `http-push` が含まれていなくても、 ファイル `docs/http-push.txt` と一致します。 用語 `http-push` が含まれている場合は、`example.txt` というファイルとも一致します。 + +複数の用語を空白で区切って入力して、両方の用語を満たすドキュメントを検索できます。 + +たとえば、次のクエリがあります。 + +``` +sparse index +``` + +検索結果には、その順序を問わず `sparse` と `index` の両方の用語を含むすべてのドキュメントが含まれます。 たとえば、`SparseIndexVector` を含むファイル、フレーズ `index for sparse trees` を含むファイル、さらには用語 `sparse` を含む `index.txt` というファイルにも一致します。 + +空白で区切られた複数の用語の検索は、検索 `hello AND world` と同じです。 新しいコード検索 (ベータ版) では `hello OR world` などの他のブール演算もサポートされています。 ブール演算について詳しくは、「[ブール演算の使用](#using-boolean-operations)」を参照してください。 + +新しいコード検索 (ベータ版) では、空白を含めた正確な文字列の検索もサポートされています。 詳しくは、「[完全一致のクエリ](#query-for-an-exact-match)」を参照してください。 + +`repo:`、`language:`、`path:` などの特殊な修飾子を使用して、コード検索を絞り込むことができます。 新しいコード検索 (ベータ版) で使用できる修飾子について詳しくは、「[修飾子の使用](#using-qualifiers)」を参照してください。 + +また、式を円記号で囲むことで、検索で正規表現を使用することもできます。 正規表現の使用について詳しくは、「[正規表現の使用](#using-regular-expressions)」を参照してください。 + +## 完全一致のクエリ + +空白を含む正確な文字列を検索するには、文字列を引用符で囲みます。 次に例を示します。 + +``` +"sparse index" +``` + +引用符を含むフレーズを検索するには、円記号を使用して引用符をエスケープします。 たとえば、正確な文字列 `name = "tensorflow"` を見つけるには、次のように検索します。 + +``` +"name = \"tensorflow\"" +``` + +次のように、引用符で囲まれた文字列を修飾子で使用することもできます。 + +``` +path: git language: "protocol buffers" +``` + +## ブール演算の使用 + +新しいコード検索 (ベータ版) では、ブール式がサポートされています。 演算子 `AND`、`OR`、および `NOT` を使用して、検索用語を組み合わせることができます。 + +既定では、隣接する用語を空白で区切ることは、演算子 `AND` を使用することと同じです。 たとえば、検索クエリ `sparse index` は `sparse AND index` と同じです。つまり、検索結果には、その順序を問わず `sparse` と `index` の両方の用語を含むすべてのドキュメントが含まれます。 + +どちらか一方の用語を含むドキュメントを検索するには、`OR` 演算子を使用します。 たとえば、次のクエリは、`sparse` または `index` のどちらかを含むドキュメントと一致します。 + +``` +sparse OR index +``` + +検索結果からファイルを除外するには、`NOT` 演算子を使用します。 たとえば、`__testing__` ディレクトリ内のファイルを除外するには、次のように検索します。 + +``` +"fatal error" NOT path:__testing__ +``` + +かっこを使用して、より複雑なブール式を表すことができます。 次に例を示します。 + +``` +(language:ruby OR language:python) AND NOT path:"/tests/" +``` + +## 修飾子の使用 + +特殊なキーワードを使用して、検索を修飾できます。 +- [リポジトリ修飾子](#repository-qualifier) +- [Organization とユーザーの修飾子](#organization-and-user-qualifiers) +- [言語修飾子](#language-qualifier) +- [パス修飾子](#path-qualifier) +- [シンボル修飾子](#symbol-qualifier) +- [コンテンツ修飾子](#content-qualifier) +- [Is 修飾子](#is-qualifier) + +### リポジトリ修飾子 + +リポジトリを検索するには、`repo:` 修飾子を使用します。 所有者を含む完全なリポジトリ名を指定する必要があります。 次に例を示します。 + +``` +repo:github/linguist +``` + +リポジトリのセット内で検索するには、複数の `repo:` 修飾子をブール演算子 `OR` と組み合わせます。 たとえば次のような点です。 + +``` +repo:github/linguist OR repo:tree-sitter/tree-sitter +``` + +{% note %} + +**メモ:** 新しいコード検索のベータ版では、現在、リポジトリ名の正規表現や部分一致はサポートされていないため、`repo:` 修飾子を機能させるには、リポジトリ名全体 (ユーザー プレフィックスを含む) を入力する必要があります。 + +{% endnote %} + +### Organization とユーザーの修飾子 + +Organization 内のファイルを検索するには `org:` 修飾子を使用します。 次に例を示します。 + +``` +org:github +``` + +個人用アカウント内のファイルを検索するには `user:` 修飾子を使用します。 たとえば次のような点です。 + +``` +user:octocat +``` + +{% note %} + +**メモ:** 新しいコード検索のベータ版では、現在、Organization やユーザー名の正規表現や部分一致はサポートされていないため、修飾子を機能させるには、Organization やユーザー名全体を入力する必要があります。 + +{% endnote %} + + +### 言語修飾子 + +特定の言語に絞り込むには、`language:` 修飾子を使用します。 次に例を示します。 + +``` +language: ruby OR language:cpp OR language:csharp +``` + +サポートされている言語名の完全な一覧については、[github/linguist](https://github.com/github/linguist) の [languages.yaml](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml) を参照してください。 希望の言語が一覧にない場合は、追加の pull request を開くことができます。 + +### パス修飾子 + +ファイル パス内で検索するには、`path:` 修飾子を使用します。 これは、ファイル パス内のいずれかの場所にその用語を含むファイルと一致します。 たとえば、パス内に用語 `unit_tests` を含むファイルを検索するには、次を使用します。 + +``` +path:unit_tests +``` + 上記のクエリは、`src/unit_tests/my_test.py` と `src/docs/unit_tests.md` の両方と一致します。両方ともパスのどこかに `unit_test` が含まれているからです。 + + 特定のファイル名 (そして、パスの一部ではない) のみと一致させるには、正規表現を使用します。 + + ``` + path:/(^|\/)README\.md$/ + ``` +正規表現では `.` は特別な意味を持つため、ファイル名内の `.` はエスケープされることに注意してください。 正規表現の使用について詳しくは、「[正規表現の使用](#using-regular-expressions)」を参照してください。 + +
+ +`path:` 修飾子では、いくつかの制限付き glob 式を使用することもできます。 + +たとえば、拡張子 `txt` のファイルを検索するには、次を使用できます。 + +``` +path:*.txt +``` +
+`src` ディレクトリ内の JavaScript ファイルを検索するには、次を使用できます。 + +``` +path:src/*.js +``` + +- 既定では、glob 式はパスの先頭に固定されないため、上記の式は `app/src/main.js` のようなパスとも一致します。 ただし、式の前に `/` を付けると、それが先頭に固定されます。 次に例を示します。 + + ``` + path:/src/*.js + ``` +- `*` は `/` 文字と一致しないため、上記の例では、すべての結果が `src` ディレクトリの直接の子孫になります。 サブディレクトリ内で一致し、結果に `/src/app/testing/utils/example.js` のような深く入れ子になったファイルが含まれるようにするには、`**` を使用します。 次に例を示します。 + + ``` + path:/src/**/*.js + ``` +
+ +`?` グローバル文字を使用することもできます。 たとえば、パス `file.aac` または `file.abc` と一致させるには、次を使用できます。 + +``` +path:*.a?c +``` +
+`*` や `?` などの特殊文字を含むファイル名を検索するには、単に引用符で囲まれた文字列を使用します。 + +``` +path:"file?" +``` + +glob 式は引用符で囲まれた文字列に対して無効になっているため、上記のクエリはリテラル文字列 `file?` を含むパスにのみ一致します。 + +### シンボル修飾子 + +`symbol:` 修飾子を使用して、コード内の関数やクラス定義などのシンボル定義を検索できます。 シンボル検索は、オープンソースの [Tree-sitter](https://github.com/tree-sitter) パーサー エコシステムを使用したコードの解析に基づいているため、追加の設定やビルド ツールの統合は必要ありません。 + +たとえば、`WithContext` というシンボルを検索するには: + +``` +language:go symbol:WithContext +``` + +一部の言語では、プレフィックス (クラス名のプレフィックスなど) を使用してシンボルを検索できます。 たとえば、構造体 `Maint` のメソッド `deleteRows` の場合、Go を使用していれば `symbol:Maint.deleteRows`、Rust では `symbol:Maint::deleteRows` を検索できます。 + +シンボル修飾子で正規表現を使用することもできます。 たとえば、次のクエリでは、Rust で `String` 型にユーザーが実装した変換が見つかります。 + +``` +language:rust symbol:/^String::to_.*/ +``` + +この修飾子は定義のみを検索し、参照は検索しないこと、また、すべてのシンボル型または言語がまだ完全にサポートされているわけではないことに注意してください。 シンボル抽出は、次の言語でサポートされています。 + +- C# +- Python +- Go +- Java +- JavaScript +- TypeScript +- PHP +- プロトコル バッファー +- Ruby +- Rust + +ただし、その他の言語のサポートも追加するよう取り組んでいます。 この取り組みに貢献したい場合は、シンボル検索の基になっているオープンソースの [Tree-sitter](https://github.com/tree-sitter) パーサー エコシステムでご希望の言語のサポートを追加できます。 + +### Content 修飾子 + +既定では、ただの用語はパスとファイルの内容の両方を検索します。 ファイル パスではなく、ファイルの内容と厳密に一致するように検索を制限するには、`content:` 修飾子を使用します。 次に例を示します。 + +``` +content:README.md +``` + +このクエリは、`README.md` いうファイルと一致するのではなく、用語 `README.md` を含むファイルにのみ一致します。 + +### Is 修飾子 + +ドキュメントのプロパティに基づいてフィルター処理するには、`is:` 修飾子を使用できます。 現時点では、この修飾子でサポートされている唯一の値は、アーカイブされたリポジトリに検索を制限する `archived` です。 次に例を示します。 + +``` +path:/MIT.txt is:archived +``` + +`is:` 修飾子は `NOT` 演算子で反転させることができます。 アーカイブされていないリポジトリを検索するには、次を検索します。 + +``` +log4j NOT is:archived +``` + +## 正規表現の使用 + +新しいコード検索 (ベータ版) では、コード内のパターンを検索するための正規表現がサポートされています。 正規表現は、正規表現を円記号で囲むことで、ただの検索用語だけでなく多くの修飾子内でも使用できます。 + +たとえば、正規表現 `sparse.*index` を検索するには、次を使用します。 + +``` +/sparse.*index/ +``` + +正規表現内のスラッシュはエスケープする必要があることに注意してください。 たとえば、`App/src` ディレクトリ内のファイルを検索するには、次を使用します。 + +``` +/^App\/src\// +``` diff --git a/translations/ja-JP/content/search-github/github-code-search/using-github-code-search.md b/translations/ja-JP/content/search-github/github-code-search/using-github-code-search.md new file mode 100644 index 0000000000..ee55c53026 --- /dev/null +++ b/translations/ja-JP/content/search-github/github-code-search/using-github-code-search.md @@ -0,0 +1,81 @@ +--- +title: GitHub Code Search (ベータ) の使用 +intro: 'アップグレードされた検索インターフェイスで候補、入力補完、保存した検索を使用して、探しているものを {% data variables.product.prodname_dotcom_the_website %} 全体からすばやく見つけることができます。' +allowTitleToDifferFromFilename: true +versions: + feature: github-code-search +topics: + - GitHub search +ms.openlocfilehash: 7578dd05f251b1df23fbd64c63d04e533f7fa9ef +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160203' +--- +{% note %} + +**注:** {% data reusables.search.code-search-code-view-beta-note %} + +{% data reusables.search.code-search-link %} {% data reusables.search.code-view-link %} + +{% endnote %} + +## 新しいコード検索 (ベータ) の使用について + +新しいコード検索ベータ版へのアクセスが可能になると、あなたが所有しているリポジトリと、あなたがメンバーとして属する Organization の中のリポジトリ (パブリック、プライベート、内部のどれであるかを問いません) のインデックスが GitHub によって作成されます。 つまり、既にインデックスが付けられている {% data variables.product.prodname_dotcom_the_website %} 上のパブリック リポジトリに加えて、あなたのすべてのリポジトリを検索できます。 {% data variables.product.prodname_dotcom_the_website %} であなたのコードを閲覧する権限を持つユーザーに限り、検索結果にあなたのコードが表示されます。 フォークは、他のリポジトリと同じ方法でインデックスが付けられて検索可能になります。 + +すべてのコードにインデックスが付けられるわけではなく、現在はリポジトリの既定のブランチのみを検索できます。 既知の制限事項について詳しくは、「[GitHub Code Search (ベータ) について](/search-github/github-code-search/about-github-code-search#limitations)」を参照してください。 + +新しいコード検索ベータ版は、新しいコード ビュー ベータ版の中に統合されています。 {% data reusables.search.code-view-link %} + +## 検索バーの使用 + +新しいコード検索エンジンに加えて、このベータ版には {% data variables.product.prodname_dotcom_the_website %} でのアップグレードされた検索インターフェイスが含まれています。 候補、入力補完、保存した検索を使用して、探しているものをすばやく見つけることができます。多くの場合は、クエリ全体を入力する必要はなく、検索結果ページを表示することも不要です。 + +新しいコード検索 (ベータ) の検索構文について詳しくは、「[GitHub Code Search (ベータ) の構文について](/search-github/github-code-search/understanding-github-code-search-syntax)」を参照してください。 + +{% data reusables.search.non-code-search-explanation %} + +1. {% data variables.product.prodname_dotcom_the_website %} の上部のナビゲーションにある検索バーをクリックします。 +1. 検索バーの下に、候補の一覧がカテゴリ別に表示されます。これには、最近使用した検索条件や、あなたがアクセスできるリポジトリ、チーム、プロジェクトの候補が含まれます。 また、あなたが作成した "保存した検索条件" の一覧も表示されます。 保存した検索条件について詳しくは、「[保存した検索条件の作成と管理](#creating-and-managing-saved-searches)」を参照してください。 + + ![候補と保存した検索条件が表示されている検索バー](/assets/images/help/search/code-search-beta-search-bar.png) + + 具体的な候補のいずれかをクリックすると、その候補のページ (たとえばリポジトリまたはプロジェクトのページ) に直接移動できます。 最近使用した検索条件または保存した検索条件をクリックすると、検索の種類に応じて、検索クエリが検索バーに表示されるか、その検索語句の検索結果ページが表示されます。 + +1. 検索クエリの入力を開始すると、そのクエリに一致する入力補完と候補の一覧が表示されます。 候補をクリックして特定の場所にジャンプすることができます。 修飾子を多く入力するほど、より具体的な候補、たとえば直接ジャンプできるコード ファイルが表示されます。 + + ![クエリとコード候補が表示されている検索バー](/assets/images/help/search/code-search-beta-search-bar-code-suggestions.png) + +1. クエリをキーボードから入力した後に Enter キーも押すと、全検索結果のビューに移動できます。ここでは一致した結果のそれぞれを見ることができ、フィルターを適用するためのビジュアル インターフェイスもあります。 詳しくは、「[検索結果ビューの使用](#using-the-search-results-view)」を参照してください。 + +## 保存した検索条件の作成と管理 + +1. {% data variables.product.prodname_dotcom_the_website %} の上部のナビゲーションにある検索バーをクリックし、検索クエリ (または任意の文字) の入力を開始します。 +1. 検索バーの下に、[保存した検索条件] セクションが表示されます。 {% octicon "plus-circle" aria-label="The plus-circle icon" %} **[保存した検索条件を作成]** をクリックします。 + + ![検索バーの [保存した検索条件を作成] ボタン](/assets/images/help/search/code-search-beta-create-saved-search.png) + +1. ポップアップ ウィンドウで、クエリの名前と保存したいクエリを入力します。 **[保存した検索条件を作成]** をクリックします。 + + ![[保存した検索条件を作成] ウィンドウ](/assets/images/help/search/code-search-beta-create-saved-search-window.png) + +1. 検索バーをもう一度クリックすると、保存した検索条件が検索バーの下の [保存した検索条件] セクションに表示されます。 保存した検索条件の 1 つをクリックすると、そのクエリが検索バーに追加され、それに応じて候補がフィルター処理されます。 + + ![保存した検索を検索バーで使用する](/assets/images/help/search/code-search-beta-saved-search-in-search-bar.png) + + - 保存した検索条件を編集するには、[保存した検索条件] セクションで、保存した検索条件の右にある {% octicon "pencil" aria-label="The pencil icon" %} をクリックします。 + - 保存した検索条件を削除するには、保存した検索条件の右にある {% octicon "trash" aria-label="The trash icon" %} をクリックします。 + + ![保存した検索条件を編集または削除するためのボタン](/assets/images/help/search/code-search-beta-edit-or-delete-saved-search.png) + +## 検索結果ビューの使用 + +検索結果ビューは既に GitHub の従来の検索に存在しており、その機能は、コードを除くほとんどの検索の種類については同じです。 新しいコード検索ベータ版を有効にすると、新たに設計された UI が検索結果ページに表示されます。この中には、新しいコード検索エンジンでサポートされているフィルター (パスやシンボルのフィルターなど) が含まれます。 + +ビジュアル インターフェイスを使用して検索クエリを作成し、結果を表示してフィルター処理するには、{% data variables.search.search_page_url %} または {% data variables.search.advanced_url %} を使用します。 検索バーに検索クエリを入力した後に Enter キーを押した場合は、検索結果ビューも表示されます。 + +検索結果ビューでは、さまざまな種類の検索結果 (コード、issue、pull request、リポジトリなど) の間を移動できます。 フィルターを表示して使用することもできます。 + +![検索結果ビュー](/assets/images/help/search/code-search-beta-results-view.png) diff --git a/translations/ja-JP/content/search-github/searching-on-github/searching-code.md b/translations/ja-JP/content/search-github/searching-on-github/searching-code.md index 3ac136a456..b3d0ea42a4 100644 --- a/translations/ja-JP/content/search-github/searching-on-github/searching-code.md +++ b/translations/ja-JP/content/search-github/searching-on-github/searching-code.md @@ -1,6 +1,6 @@ --- -title: Searching code -intro: 'You can search for code on {% data variables.product.product_name %} and narrow the results using these code search qualifiers in any combination.' +title: コードの検索 +intro: '{% data variables.product.product_name %} 上のコードを検索することができます。そして、これらのコードを検索する修飾子を組み合わせることで、検索結果を絞ることができます。' redirect_from: - /articles/searching-code - /github/searching-for-information-on-github/searching-files-in-a-repository-for-exact-matches @@ -14,108 +14,111 @@ versions: ghec: '*' topics: - GitHub search +ms.openlocfilehash: 125c17f1050cdb6d1b1d5a3d58d3e513eddce40f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: '148160220' --- +{% ifversion github-code-search %} {% note %} -{% ifversion github-code-search %} - {% note %} + **注:** {% data reusables.search.classic-search-code-search-note %} - **Note:** {% data reusables.search.classic-search-code-search-note %} + {% endnote %} {% endif %} - {% endnote %} -{% endif %} +{% data reusables.search.you-can-search-globally %} 詳細については、「[GitHub での検索について](/search-github/getting-started-with-searching-on-github/about-searching-on-github)」を参照してください。 -{% data reusables.search.you-can-search-globally %} For more information, see "[About searching on GitHub](/search-github/getting-started-with-searching-on-github/about-searching-on-github)." - -You can only search code using these code search qualifiers. Search qualifiers specifically for repositories, users, or commits, will not work when searching for code. +これらのコード検索の修飾子を使わなければ、コードを検索できません。 リポジトリ、ユーザまたはコミットの特定の修飾子での検索は、コードを検索する場合、うまくいきません。 {% data reusables.search.syntax_tips %} -## Considerations for code search +## コード検索での留意点 -Due to the complexity of searching code, there are some restrictions on how searches are performed: +コードの検索は複雑なため、検索の実行には一定の制限があります。 {% ifversion fpt or ghes or ghec %} - {% data reusables.search.required_login %}{% endif %} -- Code in [forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks) is only searchable if the fork has more stars than the parent repository. Forks with fewer stars than the parent repository are **not** indexed for code search. To include forks with more stars than their parent in the search results, you will need to add `fork:true` or `fork:only` to your query. For more information, see "[Searching in forks](/search-github/searching-on-github/searching-in-forks)." -- Only the _default branch_ is indexed for code search.{% ifversion fpt or ghec %} -- Only files smaller than 384 KB are searchable.{% else %}* Only files smaller than 5 MB are searchable. -- Only the first 500 KB of each file is searchable.{% endif %} -- Up to 4,000 private{% ifversion ghec or ghes or ghae %} and internal{% endif %} repositories are searchable. These 4,000 repositories will be the most recently updated of the first 10,000 private{% ifversion ghec or ghes or ghae %} and internal{% endif %} repositories that you have access to. -- Only repositories with fewer than 500,000 files are searchable.{% ifversion fpt or ghec %} -- Only repositories that have had activity or have been returned in search results in the last year are searchable.{% endif %} -- Except with [`filename`](#search-by-filename) searches, you must always include at least one search term when searching source code. For example, searching for [`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) is not valid, while [`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) is. -- At most, search results can show two fragments from the same file, but there may be more results within the file. -- You can't use the following wildcard characters as part of your search query: . , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ] @. The search will simply ignore these symbols. +- [フォーク](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)内のコードは、フォークの星の数が親リポジトリよりも多い場合にのみ検索できます。 親リポジトリより星の数が少ないフォークは、コード検索ではインデックス **されません**。 検索結果に親よりも星の数が多いフォークを含めるには、クエリに `fork:true` または `fork:only` を追加する必要があります。 詳細については、「[フォーク内を検索する](/search-github/searching-on-github/searching-in-forks)」を参照してください。 +- コード検索用にインデックスが作成されるのは "_既定のブランチ_" だけです。{% ifversion fpt or ghec %} +- 384 KB より小さいファイルのみ検索可能です。{% else %}* 5 MB より小さいファイルのみ検索可能です。 +- 各ファイルの最初の 500 KB のみ検索可能です。{% endif %} +- 最大 4,000 個のプライベート {% ifversion ghec or ghes or ghae %}リポジトリと内部{% endif %} リポジトリが検索可能です。 これら 4,000 個のリポジトリは、アクセス権がある最初の 10,000 個のプライベート {% ifversion ghec or ghes or ghae %}リポジトリと内部{% endif %}リポジトリのうち、最近更新されたものです。 +- ファイル数が 500,000 未満のリポジトリのみ検索可能です。{% ifversion fpt or ghec %} +- 昨年アクティビティがあった、または検索結果に返されたリポジトリのみが検索可能です。{% endif %} +- [`filename`](#search-by-filename) で検索する場合を除き、ソースコードを検索する際には、必ず 1 つ以上の検索用語を含めなければなりません。 たとえば、[`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) という検索は無効ですが、[`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) は有効です。 +- 検索結果では、同一ファイルから取り出される部分は 2 つまでです。そのファイルはさらに多くの部分でヒットしている可能性があります。 +- 検索クエリの一部として次のワイルドカード文字を用いることはできません: . , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ] @。 検索では、これらのシンボルは単に無視されます。 -## Search by the file contents or file path +## ファイルの内容またはファイルパスで検索 -With the `in` qualifier you can restrict your search to the contents of the source code file, the file path, or both. When you omit this qualifier, only the file contents are searched. +`in` 修飾子によって、ソースコード ファイル、ファイル パスまたはその両方の内容に検索を限定することができます。 この修飾子を省略した場合、ファイルの内容だけが検索されます。 -| Qualifier | Example +| 修飾子 | 例 | ------------- | ------------- -| `in:file` | [**octocat in:file**](https://github.com/search?q=octocat+in%3Afile&type=Code) matches code where "octocat" appears in the file contents. -| `in:path` | [**octocat in:path**](https://github.com/search?q=octocat+in%3Apath&type=Code) matches code where "octocat" appears in the file path. -| | [**octocat in:file,path**](https://github.com/search?q=octocat+in%3Afile%2Cpath&type=Code) matches code where "octocat" appears in the file contents or the file path. +| `in:file` | [**octocat in:file**](https://github.com/search?q=octocat+in%3Afile&type=Code) は、ファイルの内容に「octocat」が表示されるコードとマッチします。 +| `in:path` | [**octocat in:path**](https://github.com/search?q=octocat+in%3Apath&type=Code) は、ファイル パスに「octocat」が表示されるコードとマッチします。 +| | [**octocat in:file,path**](https://github.com/search?q=octocat+in%3Afile%2Cpath&type=Code) は、ファイルの内容またはパスに「octocat」が表示されるコードとマッチします。 -## Search within a user's or organization's repositories +## ユーザまたは Organization のリポジトリ内の検索 -To search the code in all repositories owned by a certain user or organization, you can use the `user` or `org` qualifier. To search the code in a specific repository, you can use the `repo` qualifier. +特定のユーザーまたは組織が所有するすべてのリポジトリのコードを検索するには、`user` 修飾子または `org` 修飾子を使います。 特定のリポジトリのコードを検索するには、`repo` 修飾子を使います。 -| Qualifier | Example +| 修飾子 | 例 | ------------- | ------------- -| user:USERNAME | [**user:defunkt extension:rb**](https://github.com/search?q=user%3Agithub+extension%3Arb&type=Code) matches code from @defunkt that ends in .rb. -| org:ORGNAME |[**org:github extension:js**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+extension%3Ajs&type=Code) matches code from GitHub that ends in .js. -| repo:USERNAME/REPOSITORY | [**repo:mozilla/shumway extension:as**](https://github.com/search?q=repo%3Amozilla%2Fshumway+extension%3Aas&type=Code) matches code from @mozilla's shumway project that ends in .as. +| user:USERNAME | [**user:defunkt extension:rb**](https://github.com/search?q=user%3Agithub+extension%3Arb&type=Code) は、.rb で終わる @defunkt のコードとマッチします。 +| org:ORGNAME |[**org:github extension:js**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+extension%3Ajs&type=Code) は、.js で終わる GitHub のコードとマッチします。 +| repo:USERNAME/REPOSITORY | [**repo:mozilla/shumway extension:as**](https://github.com/search?q=repo%3Amozilla%2Fshumway+extension%3Aas&type=Code) は、.as で終わる @mozilla の shumway プロジェクトのコードとマッチします。 -## Search by file location +## ファイルの場所での検索 -You can use the `path` qualifier to search for source code that appears at a specific location in a repository. Use `path:/` to search for files that are located at the root level of a repository. Or specify a directory name or the path to a directory to search for files that are located within that directory or any of its subdirectories. +リポジトリの特定の場所に表示されているソースコードを探すには、`path` 修飾子を使います。 リポジトリのルート レベルにあるファイルを検索するには、`path:/` を使います。 または、ディレクトリやそのサブディレクトリ内に存在しているファイルを検索するには、ディレクトリ名もしくはディレクトリへのパスを明示してください。 -| Qualifier | Example +| 修飾子 | 例 | ------------- | ------------- -| path:/ | [**octocat filename:readme path:/**](https://github.com/search?utf8=%E2%9C%93&q=octocat+filename%3Areadme+path%3A%2F&type=Code) matches _readme_ files with the word "octocat" that are located at the root level of a repository. -| path:DIRECTORY | [**form path:cgi-bin language:perl**](https://github.com/search?q=form+path%3Acgi-bin+language%3Aperl&type=Code) matches Perl files with the word "form" in the cgi-bin directory, or in any of its subdirectories. -| path:PATH/TO/DIRECTORY | [**`console path:app/public language:javascript`**](https://github.com/search?q=console+path%3A%22app%2Fpublic%22+language%3Ajavascript&type=Code) matches JavaScript files with the word "console" in the app/public directory, or in any of its subdirectories (even if they reside in app/public/js/form-validators). +| path:/ | [**octocat filename:readme path:/**](https://github.com/search?utf8=%E2%9C%93&q=octocat+filename%3Areadme+path%3A%2F&type=Code) は、リポジトリのルート レベルにある「octocat」という単語を含む _readme_ ファイルとマッチします。 +| path:DIRECTORY | [**form path:cgi-bin language:perl**](https://github.com/search?q=form+path%3Acgi-bin+language%3Aperl&type=Code) は、cgi-bin ディレクトリまたはそのサブディレクトリ内の「form」という単語を含む Perl ファイルとマッチします。 +| path:PATH/TO/DIRECTORY | [ **`console path:app/public language:javascript`**](https://github.com/search?q=console+path%3A%22app%2Fpublic%22+language%3Ajavascript&type=Code) は、app/public ディレクトリまたはそのサブディレクトリ (app/public/js/form-validators を含む) 内の「console」という単語を含む JavaScript ファイルとマッチします。 -## Search by language +## 言語で検索 -You can search for code based on what language it's written in. The `language` qualifier can be the language name or alias. For a full list of supported languages with their names and aliases, see the [github/linguist repository](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml). +コードが書かれた言語で検索することができます。 `language` 修飾子には、言語名またはエイリアスを指定できます。 サポートされている言語とその名前とエイリアスの完全な一覧については、[github/linguist リポジトリ](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml)を参照してください。 -| Qualifier | Example +| 修飾子 | 例 | ------------- | ------------- -| language:LANGUAGE | [**element language:xml size:100**](https://github.com/search?q=element+language%3Axml+size%3A100&type=Code) matches code with the word "element" that's marked as being XML and has exactly 100 bytes. -| | [**display language:scss**](https://github.com/search?q=display+language%3Ascss&type=Code) matches code with the word "display," that's marked as being SCSS. -| | [**org:mozilla language:markdown**](https://github.com/search?utf8=%E2%9C%93&q=org%3Amozilla+language%3Amarkdown&type=Code) matches code from all @mozilla's repositories that's marked as Markdown. +| language:LANGUAGE | [**element language:xml size:100**](https://github.com/search?q=element+language%3Axml+size%3A100&type=Code) は、XML としてマークされ、ぴったり 100 バイトの「element」という単語を含むコードとマッチします。 +| | [**display language:scss**](https://github.com/search?q=display+language%3Ascss&type=Code) は、SCSS としてマークされ、「display」という単語を含むコードとマッチします。 +| | [**org:mozilla language:markdown**](https://github.com/search?utf8=%E2%9C%93&q=org%3Amozilla+language%3Amarkdown&type=Code) は、Markdown としてマークされているすべての @mozilla のリポジトリのコードとマッチします。 -## Search by file size +## ファイルサイズで検索 -You can use the `size` qualifier to search for source code based on the size of the file where the code exists. The `size` qualifier uses [greater than, less than, and range qualifiers](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax) to filter results based on the byte size of the file in which the code is found. +コードが存在するファイルのサイズによってソースコードを検索するには、`size` 修飾子を使います。 `size` 修飾子は[より大きい修飾子、より小さい修飾子、および範囲の修飾子](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax)を使用して、コードが見つかったファイルのバイト サイズに基づいて結果をフィルタリングします。 -| Qualifier | Example +| 修飾子 | 例 | ------------- | ------------- -| size:n | [**function size:>10000 language:python**](https://github.com/search?q=function+size%3A%3E10000+language%3Apython&type=Code) matches code with the word "function," written in Python, in files that are larger than 10 KB. +| size:n | [**function size:>10000 language:python**](https://github.com/search?q=function+size%3A%3E10000+language%3Apython&type=Code) は、10 KB を超えるファイル内の Python で記述された「function」という単語を含むコードとマッチします。 -## Search by filename +## ファイル名で検索 -The `filename` qualifier matches code files with a certain filename. You can also find a file in a repository using the file finder. For more information, see "[Finding files on GitHub](/search-github/searching-on-github/finding-files-on-github)." +`filename` 修飾子は、特定のファイル名を持つコード ファイルとマッチします。 ファイルファインダーを使ってリポジトリにあるファイルを表示できます。 詳細については、「[GitHub でのファイルの検索](/search-github/searching-on-github/finding-files-on-github)」を参照してください。 -| Qualifier | Example +| 修飾子 | 例 | ------------- | ------------- -| filename:FILENAME | [**filename:linguist**](https://github.com/search?utf8=%E2%9C%93&q=filename%3Alinguist&type=Code) matches files named "linguist." -| | [**filename:.vimrc commands**](https://github.com/search?q=filename%3A.vimrc+commands&type=Code) matches *.vimrc* files with the word "commands." -| | [**filename:test_helper path:test language:ruby**](https://github.com/search?q=minitest+filename%3Atest_helper+path%3Atest+language%3Aruby&type=Code) matches Ruby files named *test_helper* within the *test* directory. +| filename:FILENAME | [**filename:linguist**](https://github.com/search?utf8=%E2%9C%93&q=filename%3Alinguist&type=Code) は、「linguist」という名前のファイルとマッチします。 +| | [**filename:.vimrc commands**](https://github.com/search?q=filename%3A.vimrc+commands&type=Code) は、「commands」という単語を含む *.vimrc* ファイルとマッチします。 +| | [**filename:test_helper path:test language:ruby**](https://github.com/search?q=minitest+filename%3Atest_helper+path%3Atest+language%3Aruby&type=Code) は、*test* ディレクトリ内の *test_helper* という名前の Ruby ファイルとマッチします。 -## Search by file extension +## ファイルの拡張子で検索 -The `extension` qualifier matches code files with a certain file extension. +`extension` 修飾子は、特定のファイル拡張子を持つコード ファイルとマッチします。 -| Qualifier | Example +| 修飾子 | 例 | ------------- | ------------- -| extension:EXTENSION | [**form path:cgi-bin extension:pm**](https://github.com/search?q=form+path%3Acgi-bin+extension%3Apm&type=Code) matches code with the word "form," under cgi-bin, with the .pm file extension. -| | [**icon size:>200000 extension:css**](https://github.com/search?utf8=%E2%9C%93&q=icon+size%3A%3E200000+extension%3Acss&type=Code) matches files larger than 200 KB that end in .css and have the word "icon." +| extension:EXTENSION | [**form path:cgi-bin extension:pm**](https://github.com/search?q=form+path%3Acgi-bin+extension%3Apm&type=Code) は、cgi-bin の下の「form」という単語を含み .pm というファイル拡張子を持つコードとマッチします。 +| | [**icon size:>200000 extension:css**](https://github.com/search?utf8=%E2%9C%93&q=icon+size%3A%3E200000+extension%3Acss&type=Code) は、.css で終わり「icon」という単語を含む 200 KB を超えるファイルとマッチします。 -## Further reading +## 参考資料 -- "[Sorting search results](/search-github/getting-started-with-searching-on-github/sorting-search-results/)" -- "[Searching in forks](/search-github/searching-on-github/searching-in-forks)"{% ifversion fpt or ghec %} -- "[Navigating code on {% data variables.product.prodname_dotcom %}](/github/managing-files-in-a-repository/navigating-code-on-github)"{% endif %} +- 「[検索結果をソートする](/search-github/getting-started-with-searching-on-github/sorting-search-results/)」 +- 「[フォーク内を検索する](/search-github/searching-on-github/searching-in-forks)」{% ifversion fpt or ghec %} +- 「[{% data variables.product.prodname_dotcom %} のナビゲーション コード](/github/managing-files-in-a-repository/navigating-code-on-github)」{% endif %} diff --git a/translations/ja-JP/data/features/ip-allow-list-address-check.yml b/translations/ja-JP/data/features/ip-allow-list-address-check.yml deleted file mode 100644 index c4dda87a70..0000000000 --- a/translations/ja-JP/data/features/ip-allow-list-address-check.yml +++ /dev/null @@ -1,3 +0,0 @@ -versions: - ghec: '*' - ghae: 'issue-7818' diff --git a/translations/ja-JP/data/learning-tracks/admin.yml b/translations/ja-JP/data/learning-tracks/admin.yml index 6c84460f88..9f45bbaca7 100644 --- a/translations/ja-JP/data/learning-tracks/admin.yml +++ b/translations/ja-JP/data/learning-tracks/admin.yml @@ -9,7 +9,7 @@ get_started_with_github_ae: - /admin/overview/about-data-residency - /admin/configuration/configuring-your-enterprise/deploying-github-ae - /admin/configuration/initializing-github-ae - - /admin/configuration/restricting-network-traffic-to-your-enterprise + - /admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list - /admin/github-actions/getting-started-with-github-actions-for-github-ae deploy_an_instance: diff --git a/translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md b/translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md index 4cb42a307d..8bc127db04 100644 --- a/translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md +++ b/translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md @@ -7,5 +7,5 @@ To allow your self-hosted runners to communicate with {% data variables.product. {% endwarning %} -To allow your self-hosted {% ifversion actions-hosted-runners %}or larger hosted{% endif %} runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your runners to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." +To allow your self-hosted {% ifversion actions-hosted-runners %}or larger hosted{% endif %} runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your runners to the IP allow list that you have configured for your enterprise. {% endif %} diff --git a/translations/ja-JP/data/reusables/actions/private-repository-forks-configure.md b/translations/ja-JP/data/reusables/actions/private-repository-forks-configure.md index 7ff3731a54..0f5d6a03a1 100644 --- a/translations/ja-JP/data/reusables/actions/private-repository-forks-configure.md +++ b/translations/ja-JP/data/reusables/actions/private-repository-forks-configure.md @@ -1,7 +1,13 @@ -1. Under **Fork pull request workflows**, select your options. For example: - {% ifversion actions-private-fork-workflow-approvals %} - ![Enable, disable, or limits actions for this repository](/assets/images/help/settings/actions-fork-pull-request-workflows-require-approval.png){% else %} +--- +ms.openlocfilehash: dc48389e4e331c52d67017151cf599747cc006ee +ms.sourcegitcommit: fdc4466e89467a7b13239e26c6042dc1428946b6 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: "148163829" +--- +1. **[Fork pull request workflows]\(pull request ワークフローのフォーク\)** で、オプションを選択します。 例: {% ifversion actions-private-fork-workflow-approvals %} ![このリポジトリのアクションを有効化、無効化、または制限する](/assets/images/help/settings/actions-fork-pull-request-workflows-require-approval.png){% else %} - ![Enable, disable, or limits actions for this repository](/assets/images/help/settings/actions-fork-pull-request-workflows.png){% endif %} + ![このリポジトリのアクションを有効化、無効化、または制限する](/assets/images/help/settings/actions-fork-pull-request-workflows.png){% endif %} -1. Click **Save** to apply the settings. +1. **[保存]** をクリックして設定を適用します。 diff --git a/translations/ja-JP/data/reusables/actions/private-repository-forks-options.md b/translations/ja-JP/data/reusables/actions/private-repository-forks-options.md index 7e7219bd70..8cfd832d38 100644 --- a/translations/ja-JP/data/reusables/actions/private-repository-forks-options.md +++ b/translations/ja-JP/data/reusables/actions/private-repository-forks-options.md @@ -1,4 +1,12 @@ -- **Run workflows from fork pull requests** - Allows users to run workflows from fork pull requests, using a `GITHUB_TOKEN` with read-only permission, and with no access to secrets. -- **Send write tokens to workflows from pull requests** - Allows pull requests from forks to use a `GITHUB_TOKEN` with write permission. -- **Send secrets to workflows from pull requests** - Makes all secrets available to the pull request.{% ifversion actions-private-fork-workflow-approvals %} -- **Require approval for fork pull request workflows** - Workflow runs on pull requests from collaborators without write permission will require approval from someone with write permission before they will run.{% endif %} +--- +ms.openlocfilehash: d9874c3884e3191a0296272fbead8f30b7630e5a +ms.sourcegitcommit: fdc4466e89467a7b13239e26c6042dc1428946b6 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: "148163823" +--- +- **フォーク pull request からワークフローを実行する** - 読み取り専用権限を持ち、シークレットへのアクセス権を持たない `GITHUB_TOKEN` を使用して、フォーク pull request からワークフローを実行できます。 +- **pull request からワークフローに書き込みトークンを送信する** - フォークからの pull request で書き込み権限を持つ `GITHUB_TOKEN` を使用できます。 +- **pull request からワークフローにシークレットを送信する** - すべてのシークレットを pull request で利用できるようにします。{% ifversion actions-private-fork-workflow-approvals %} +- **フォークの pull request ワークフローに対して承認を要求する** - 書き込みアクセス許可のないコラボレーターからの pull request に対するワークフロー実行には、実行する前に書き込みアクセス許可を持つ誰かからの承認が必要になります。{% endif %} diff --git a/translations/ja-JP/data/reusables/actions/ref_protected-description.md b/translations/ja-JP/data/reusables/actions/ref_protected-description.md index 17da011074..65728f8e09 100644 --- a/translations/ja-JP/data/reusables/actions/ref_protected-description.md +++ b/translations/ja-JP/data/reusables/actions/ref_protected-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: e3a5d34c1e7fa7964296417f959e02f7d25322d1 -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a +ms.openlocfilehash: aa83ecff715eed06bc0b455344b227e8676ee4e3 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/11/2022 -ms.locfileid: "145068122" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179600" --- -ワークフローの実行をトリガーした ref に対してブランチ保護が構成されている場合 `true`。 +ワークフローの実行をトリガーした ref に対してブランチ保護が構成されている場合 `true`。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/ref_type-description.md b/translations/ja-JP/data/reusables/actions/ref_type-description.md index c828a56a91..2e645cf410 100644 --- a/translations/ja-JP/data/reusables/actions/ref_type-description.md +++ b/translations/ja-JP/data/reusables/actions/ref_type-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: eb37287768f8539b10e549b5407c9aeb1170d1eb -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 +ms.openlocfilehash: efa01b1ee2415e7b0aa1cc919fec24801839d2db +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "145089319" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179593" --- -ワークフローの実行をトリガーした ref の種類。 有効な値は `branch` または `tag`です。 +ワークフローの実行をトリガーした ref の種類。 有効な値は `branch` または `tag`です。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/run_id_description.md b/translations/ja-JP/data/reusables/actions/run_id_description.md index 03d199f41e..45c758825c 100644 --- a/translations/ja-JP/data/reusables/actions/run_id_description.md +++ b/translations/ja-JP/data/reusables/actions/run_id_description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: d2eb1d49e6bb3057ce347b8bdd37f7f1a66014fa -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 3ceb785289a3b263eebda76d766bab52d6cec3c3 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145068092" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179588" --- -各ワークフローの一意の番号は、リポジトリ内で実行されます。 この番号は、ワークフローの実行をやり直しても変化しません、 +各ワークフローの一意の番号は、リポジトリ内で実行されます。 この番号は、ワークフローの実行をやり直しても変化しません、 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/run_number_description.md b/translations/ja-JP/data/reusables/actions/run_number_description.md index 8a284af1d7..1b8c96e17e 100644 --- a/translations/ja-JP/data/reusables/actions/run_number_description.md +++ b/translations/ja-JP/data/reusables/actions/run_number_description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 4e92d27887f94b524e0e5d9c2d007b29e2dbb28b -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 +ms.openlocfilehash: d3a31b63ff15fefd904ffeb91bb195e24cbafe19 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147878753" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179648" --- -リポジトリ内の特定のワークフローの各実行に対するユニークな番号。 この番号は、ワークフローの最初の実行時に 1 から始まり、新しい実行ごとに増加します。 この番号は、ワークフローの実行をやり直しても変化しません、 +リポジトリ内の特定のワークフローの各実行に対するユニークな番号。 この番号は、ワークフローの最初の実行時に 1 から始まり、新しい実行ごとに増加します。 この番号は、ワークフローの実行をやり直しても変化しません、 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/runner-arch-description.md b/translations/ja-JP/data/reusables/actions/runner-arch-description.md index f6b1ba6017..a126b294b9 100644 --- a/translations/ja-JP/data/reusables/actions/runner-arch-description.md +++ b/translations/ja-JP/data/reusables/actions/runner-arch-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: af8eda15fb2efa1997bec460be9f8d9549171c71 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 +ms.openlocfilehash: 217ff84c9edd02f476d3f25f01d384f46ab05e0c +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "145089256" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179606" --- -ジョブを実行しているランナーのアーキテクチャ。 指定できる値は、`X86`、`X64`、`ARM`、および `ARM64` です。 +ジョブを実行しているランナーのアーキテクチャ。 指定できる値は、`X86`、`X64`、`ARM`、および `ARM64` です。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/runner-debug-description.md b/translations/ja-JP/data/reusables/actions/runner-debug-description.md index a3f5a2783a..972d7ee84e 100644 --- a/translations/ja-JP/data/reusables/actions/runner-debug-description.md +++ b/translations/ja-JP/data/reusables/actions/runner-debug-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: e97366a49253e628513ace9247bb7f4c9301aa80 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 +ms.openlocfilehash: 1b97b54e74b57343a5bc824c86e2849f99c5f6a8 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147614554" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179656" --- -これは、[デバッグ ログ](/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging)が有効になっている場合にのみ設定され、値は常に `1` です。 独自のジョブ手順で追加のデバッグまたは詳細ログを有効にするためのインジケーターとして役に立ちます。 +これは、[デバッグ ログ](/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging)が有効になっている場合にのみ設定され、値は常に `1` です。 独自のジョブ手順で追加のデバッグまたは詳細ログを有効にするためのインジケーターとして役に立ちます。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/runner-name-description.md b/translations/ja-JP/data/reusables/actions/runner-name-description.md index 338793c55a..510ca703af 100644 --- a/translations/ja-JP/data/reusables/actions/runner-name-description.md +++ b/translations/ja-JP/data/reusables/actions/runner-name-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 92f9c6962ced87f0075e67d91920b4262d376bbe -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 +ms.openlocfilehash: 99093fe4bc8da22d7507cd16ffdbf5c3756ae83f +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147878766" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179605" --- -ジョブを実行しているランナーの名前。 +ジョブを実行しているランナーの名前。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/runner-os-description.md b/translations/ja-JP/data/reusables/actions/runner-os-description.md index a384554415..d04aa8b485 100644 --- a/translations/ja-JP/data/reusables/actions/runner-os-description.md +++ b/translations/ja-JP/data/reusables/actions/runner-os-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 4bf3f1a9bd94d5faf665ceab4c30925162bf2977 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 78f1e2366d4ae9645f335439efa2bb040194bea9 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145089247" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179585" --- -ジョブを実行しているランナーのオペレーティングシステム。 設定可能な値は、`Linux`、`Windows`、または `macOS` です。 +ジョブを実行しているランナーのオペレーティングシステム。 設定可能な値は、`Linux`、`Windows`、または `macOS` です。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/runner-temp-directory-description.md b/translations/ja-JP/data/reusables/actions/runner-temp-directory-description.md index b607d2f0be..1891bc509b 100644 --- a/translations/ja-JP/data/reusables/actions/runner-temp-directory-description.md +++ b/translations/ja-JP/data/reusables/actions/runner-temp-directory-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 2e1561ff6bfee56d135e4897fbc6d42e252a7809 -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a +ms.openlocfilehash: b29e97e5613dbe28ac0769e4f814027d581a93a2 +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/11/2022 -ms.locfileid: "145068063" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179599" --- -ランナー上の一時ディレクトリへのパス。 このディレクトリは、各ジョブの開始及び終了時点で空になります。 ランナーのユーザアカウントが削除する権限を持っていない場合、ファイルは削除されないことに注意してください。 +ランナー上の一時ディレクトリへのパス。 このディレクトリは、各ジョブの開始及び終了時点で空になります。 ランナーのユーザアカウントが削除する権限を持っていない場合、ファイルは削除されないことに注意してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/runner-tool-cache-description.md b/translations/ja-JP/data/reusables/actions/runner-tool-cache-description.md index 413f26cb23..81789a5200 100644 --- a/translations/ja-JP/data/reusables/actions/runner-tool-cache-description.md +++ b/translations/ja-JP/data/reusables/actions/runner-tool-cache-description.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 6945058380431dbf753ad8dd9ce03c032193a46a -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a +ms.openlocfilehash: b0adac22b7786fb4e5b712d86b4a0379611ab2ec +ms.sourcegitcommit: 99eb4456062aea31ca381977396417cf92e5798d ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/11/2022 -ms.locfileid: "145089240" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179584" --- -{% data variables.product.prodname_dotcom %}ホストランナーにプレインストールされているツールを含むディレクトリへのパス。 詳細については、「[{% data variables.product.prodname_dotcom %} ホスト ランナーの概要](/actions/reference/specifications-for-github-hosted-runners/#supported-software)」を参照してください。 +{% data variables.product.prodname_dotcom %}ホストランナーにプレインストールされているツールを含むディレクトリへのパス。 詳細については、「[{% data variables.product.prodname_dotcom %} ホスト ランナーの概要](/actions/reference/specifications-for-github-hosted-runners/#supported-software)」を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/supported-github-runners.md b/translations/ja-JP/data/reusables/actions/supported-github-runners.md index d9816dfffd..2599a33141 100644 --- a/translations/ja-JP/data/reusables/actions/supported-github-runners.md +++ b/translations/ja-JP/data/reusables/actions/supported-github-runners.md @@ -1,17 +1,9 @@ ---- -ms.openlocfilehash: c30f6000486156f1995f0f05ff27fc173b893de5 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147529273" ----
Imagen del ejecutorEtiqueta de flujo de trabajo YAMLNotasRunner imageYAML workflow labelNotes
-Windows Server 2022 +Windows Server 2022 -windows-latest o windows-2022 +windows-latest or windows-2022 -La etiqueta windows-latest usa actualmente la imagen del ejecutor de Windows Server 2022. +The windows-latest label currently uses the Windows Server 2022 runner image.
-Ubuntu 22.04 +Ubuntu 22.04 ubuntu-22.04 @@ -48,26 +40,29 @@ Ubuntu 22.04
-Ubuntu 20.04 +Ubuntu 20.04 -ubuntu-latest o ubuntu-20.04 +ubuntu-latest or ubuntu-20.04 +The ubuntu-latest label is currently transitioning to the Ubuntu 22.04 runner image. During the transition, the label might refer to the runner image for either Ubuntu 20.04 or 22.04. For more information, see this {% data variables.product.prodname_dotcom %} blog post. +
-Ubuntu 18.04 [en desuso] +Ubuntu 18.04 [deprecated] ubuntu-18.04 -Realiza la migración a ubuntu-20.04 o ubuntu-22.04. Para obtener más información, consulta esta entrada de blog de GitHub. +Migrate to ubuntu-20.04 or ubuntu-22.04. For more information, see this GitHub blog post.
-macOS Monterey 12 +macOS Monterey 12 macos-12 @@ -75,24 +70,24 @@ macOS Monterey 12
-macOS Big Sur 11 +macOS Big Sur 11 -macos-latest o macos-11 +macos-latest or macos-11 -La etiqueta macos-latest usa actualmente la imagen del ejecutor de macOS 11. +The macos-latest label is currently transitioning to the macOS Monterey 12 runner image. During the transition, the label might refer to the runner image for either macOS 11 or 12. For more information, see this {% data variables.product.prodname_dotcom %} blog post.
-macOS Catalina 10.15 [en desuso] +macOS Catalina 10.15 [deprecated] macos-10.15 -Realiza la migración a macOS-11 o macOS-12. Para obtener más información, consulta esta entrada de blog de GitHub. +Migrate to macOS-11 or macOS-12. For more information, see this GitHub blog post.
- - - + + + @@ -20,10 +12,10 @@ ms.locfileid: "147529273" Windows Server 2022 @@ -51,18 +43,21 @@ Ubuntu 22.04 Ubuntu 20.04 + @@ -78,21 +73,21 @@ macOS Monterey 12 macOS Big Sur 11 @@ -100,12 +95,12 @@ macOS Catalina 10.15 [非推奨] {% note %} -**注:** `-latest` ランナー イメージは、{% data variables.product.prodname_dotcom %} が提供する最新の安定したイメージであり、オペレーティング システム ベンダーから入手できるオペレーティング システムの最新バージョンではない可能性があります。 +**Note:** The `-latest` runner images are the latest stable images that {% data variables.product.prodname_dotcom %} provides, and might not be the most recent version of the operating system available from the operating system vendor. {% endnote %} {% warning %} -注: ベータ版および非推奨のイメージは、"現状のまま"、"保証なし"、"利用可能な状態" で提供され、サービス レベル アグリーメントと保証から除外されます。 ベータ版のイメージは、カスタマー サポートでカバーされない場合があります。 +**Warning:** Beta and Deprecated Images are provided "as-is", "with all faults" and "as available" and are excluded from the service level agreement and warranty. Beta Images may not be covered by customer support. {% endwarning %} diff --git a/translations/ja-JP/data/reusables/advanced-security/more-information-about-enforcement-policy.md b/translations/ja-JP/data/reusables/advanced-security/more-information-about-enforcement-policy.md index 42c0840433..1c693a9b49 100644 --- a/translations/ja-JP/data/reusables/advanced-security/more-information-about-enforcement-policy.md +++ b/translations/ja-JP/data/reusables/advanced-security/more-information-about-enforcement-policy.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 1b37f350d1a16509df7b661fcde678b6599b3f09 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 1da05f80c01813e53ccdb66c877587e3b2268d34 +ms.sourcegitcommit: 8d9e10685cfb2556fba0ce07484a3b9579808703 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147879287" +ms.lasthandoff: 11/18/2022 +ms.locfileid: "148172155" --- -詳細については、「[Enforcing policies for {% data variables.product.prodname_advanced_security %} in your enterprise (エンタープライズで GitHub Actions のポリシーを適用する)]({% ifversion fpt %}/enterprise-cloud@latest{% endif %}/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)」を参照してください。 +詳細については、「[Enforcing policies for {% data variables.product.prodname_advanced_security %} in your enterprise (エンタープライズで GitHub Actions のポリシーを適用する)]({% ifversion fpt %}/enterprise-cloud@latest{% endif %}/admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise)」を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/classroom/assignments-guide-choose-visibility.md b/translations/ja-JP/data/reusables/classroom/assignments-guide-choose-visibility.md index 95e1eafbca..336f746de9 100644 --- a/translations/ja-JP/data/reusables/classroom/assignments-guide-choose-visibility.md +++ b/translations/ja-JP/data/reusables/classroom/assignments-guide-choose-visibility.md @@ -1,15 +1,11 @@ --- -ms.openlocfilehash: 66fdbca75762848fce18a18321fd082a844cfa3f -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: ec67345b92fb3aba571c6932ccc3b67d77473726 +ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145115806" +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179729" --- -課題のためのリポジトリは、パブリックにもプライベートにもできます。 プライベートリポジトリを使うと、学生あるいはTeamだけが提供されたフィードバックを見ることができます。 - -また、課題のためのリポジトリに対する管理権限を学生に与えるかを決定することもできます。 学生が課題のリポジトリに対して管理タスクを行えなければならないのであれば、管理権限を与えてください。 詳細については、「[リポジトリについて](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)」と「[Organization のリポジトリ ロール](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)」を参照してください。 - "Repository visibility（リポジトリの可視性）"の下で、可視性を選択してください。 必要に応じて、 **[リポジトリに対する管理者アクセスを学生に付与する]** を選んでください。
diff --git a/translations/ja-JP/data/reusables/classroom/assignments-repository-visibility-and-permissions.md b/translations/ja-JP/data/reusables/classroom/assignments-repository-visibility-and-permissions.md new file mode 100644 index 0000000000..a601ab4e8a --- /dev/null +++ b/translations/ja-JP/data/reusables/classroom/assignments-repository-visibility-and-permissions.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: f5dc693751e91ffe9b472a5c99c1f359902873a0 +ms.sourcegitcommit: 82b1242de02ecc4bdec02a5b6d11568fb2deb1aa +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/21/2022 +ms.locfileid: "148179856" +--- +課題のためのリポジトリは、パブリックにもプライベートにもできます。 プライベートリポジトリを使うと、学生あるいはTeamだけが提供されたフィードバックを見ることができます。 + +また、課題のためのリポジトリに対する管理権限を学生に与えるかを決定することもできます。 学生が課題のリポジトリに対して管理タスクを行えなければならないのであれば、管理権限を与えてください。 詳細については、「[リポジトリについて](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)」と「[Organization のリポジトリ ロール](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)」を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/about-features.md b/translations/ja-JP/data/reusables/codespaces/about-features.md new file mode 100644 index 0000000000..4a5948ecf6 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/about-features.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 55348a01f34b4eb85873a075b637bdff802fcef3 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159984" +--- +各機能は、インストール コードと開発コンテナー構成の自己完結型ユニットであり、さまざまな基本コンテナー イメージで動作するように設計されています。 各機能を使用すると、codespace イメージにツール、ランタイム、またはライブラリをすばやく追加できます。 詳しくは、containers.dev で、[使用できる機能](https://containers.dev/features)と[機能の仕様](https://containers.dev/implementors/features/)をご確認ください。 + +機能は、{% data variables.product.prodname_vscode_shortname %} からか、{% data variables.product.prodname_dotcom_the_website %} のリポジトリから `devcontainer.json` ファイルに追加できます。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/about-publishing-templates.md b/translations/ja-JP/data/reusables/codespaces/about-publishing-templates.md new file mode 100644 index 0000000000..639a2347bf --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/about-publishing-templates.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: 88adaa8f671dd9eb805301c3e659bcdba76f24cc +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160195" +--- +テンプレートから作成された codespace で作業する場合、作業はクラウド内の仮想マシンに保存されますが、{% data variables.product.prodname_dotcom %} のリポジトリには保存されません。 + +ファイルを保存し、codespace を閉じて停止し、後で作業に戻ることができます。 通常、Git はプレインストールされ、{% data variables.product.company_short %} の空のテンプレートから開始しない限り、作業ディレクトリは Git リポジトリとして自動的に初期化されます。 つまり、ファイルの追加やコミットなど、ローカル ソース管理に Git をすぐに使用できます。 + +しかし、発行されていない codespace を削除した場合、または保持期間の間に未使用のままで自動的に削除された場合は、作業も削除されます。 作業を永続化し、他のユーザーがあなたのプロジェクトで作業できるようにするには、ご自分の codespace を {% data variables.product.prodname_dotcom %} のリポジトリに発行する必要があります。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/application-installed-locally.md b/translations/ja-JP/data/reusables/codespaces/application-installed-locally.md new file mode 100644 index 0000000000..020b0b2a6d --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/application-installed-locally.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: cdcd2ca433a74eef0f9a768c6db21b9ac708ccd1 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159815" +--- +**{% data variables.product.prodname_vscode %}** または **JetBrains Gateway** を選ぶ場合、選んだアプリケーションをローカル コンピューターにインストールしていることを確認する必要があります。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/codespace-logs.md b/translations/ja-JP/data/reusables/codespaces/codespace-logs.md new file mode 100644 index 0000000000..bd325b855c --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/codespace-logs.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 945a4c8f9249f6153a4fe51e4f53c2b4b16cf060 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160228" +--- +## Codespace ログ + +これらのログには、codespace、コンテナー、セッション、{% data variables.product.prodname_vscode_shortname %} 環境に関する詳細情報が含まれています。 接続の問題やその他の予期しない動作の診断に役立ちます。 たとえば、codespace がフリーズしても、[Windowsの再読み込み] オプションを使用すると、それを数分間凍結解除することができます。つまり、codespace からランダムに切断されても、すぐに再接続することができます。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/codespaces-continue-by-paying.md b/translations/ja-JP/data/reusables/codespaces/codespaces-continue-by-paying.md new file mode 100644 index 0000000000..82c7b9d70f --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/codespaces-continue-by-paying.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 73174295d5ab0a8f7b5fb9cebc3dbb4412409c3a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159823" +--- +毎月含まれているストレージとコンピューティングの使用量を超えて {% data variables.product.prodname_github_codespaces %} を使い続けるには、支払い情報を入力して、利用限度を設定します。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」をご覧ください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/codespaces-disabling-org-billing.md b/translations/ja-JP/data/reusables/codespaces/codespaces-disabling-org-billing.md index d5e6b42576..fdfb27f7a2 100644 --- a/translations/ja-JP/data/reusables/codespaces/codespaces-disabling-org-billing.md +++ b/translations/ja-JP/data/reusables/codespaces/codespaces-disabling-org-billing.md @@ -1,5 +1,13 @@ +--- +ms.openlocfilehash: da45d9e5d01d2980559db0175157d03b2f7a454a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159222" +--- {% note %} -**Note**: If you disable billing for {% data variables.product.prodname_github_codespaces %} for some organization members and collaborators, or for your entire organization, anyone who can either push changes to, or fork, a repository in your organization, will still be able to create a codespace for that repository by using their personal account. However, this will not incur any charge for your organization. For information about restricting access to a repository, see "[Managing teams and people with access to your repository](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository)." +**注**: 一部の Organization メンバーとコラボレーター、または組織全体に対して {% data variables.product.prodname_github_codespaces %} の課金を無効にした場合でも、ユーザーが Organization 内のリポジトリに変更をプッシュまたはフォークできる場合、個人アカウントを使用してそのリポジトリ用に codespace を作成できます。 ただし、Organization に対しては料金は発生しません。 リポジトリへのアクセスを制限する方法については、「[リポジトリへのアクセス権を持つ Team と人を管理する](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository)」を参照してください。 {% endnote %} diff --git a/translations/ja-JP/data/reusables/codespaces/codespaces-free-for-personal-intro.md b/translations/ja-JP/data/reusables/codespaces/codespaces-free-for-personal-intro.md new file mode 100644 index 0000000000..3c7c4e099f --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/codespaces-free-for-personal-intro.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 1f6226c3fdf40ed1108934afd16966a9696a154d +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160120" +--- +{% data variables.product.prodname_github_codespaces %} は、組織、企業、または個人アカウントのいずれかによって支払われます。 個人アカウントの Free および Pro プランには、毎月一定の使用量までの {% data variables.product.prodname_github_codespaces %} の無料使用が含まれます。 diff --git a/translations/ja-JP/data/reusables/codespaces/codespaces-jetbrains-beta-note.md b/translations/ja-JP/data/reusables/codespaces/codespaces-jetbrains-beta-note.md new file mode 100644 index 0000000000..9fc4e81fd7 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/codespaces-jetbrains-beta-note.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: 7c6428ee82232f9609978bbb6f166623b1de6a6c +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159887" +--- +{% note %} + +**メモ**: JetBrains IDE での {% data variables.product.prodname_github_codespaces %} の使用は現在、パブリック ベータ版であり、変更される場合があります。 + +{% endnote %} diff --git a/translations/ja-JP/data/reusables/codespaces/codespaces-machine-type-availability.md b/translations/ja-JP/data/reusables/codespaces/codespaces-machine-type-availability.md index 9c22afa3aa..812703eb67 100644 --- a/translations/ja-JP/data/reusables/codespaces/codespaces-machine-type-availability.md +++ b/translations/ja-JP/data/reusables/codespaces/codespaces-machine-type-availability.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: bde9df5c980a7448c30645675dc13086c1094fdc -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 32a0269159f5f1556cd96d10ef75915fe84b05c0 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147882884" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159872" --- -使用可能なマシンの種類の選択は、組織に設定されたポリシーまたはリポジトリの最低限のマシンのタイプの仕様によって制限される場合があります。 詳細については、「[マシンのタイプへのアクセスの制限](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)」および「[コードスペース マシンの最低限の仕様の設定](/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines)」を参照してください。 +使用可能なマシンは、数多くの要因によって、選択の幅が制限されます。 これには、Organization に対して構成されているポリシーや、リポジトリでの最低限の種類のマシン仕様が含まれます。 詳細については、「[マシンのタイプへのアクセスの制限](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)」および「[コードスペース マシンの最低限の仕様の設定](/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/codespaces/codespaces-machine-types.md b/translations/ja-JP/data/reusables/codespaces/codespaces-machine-types.md index 7a171657f6..83e3de4ad0 100644 --- a/translations/ja-JP/data/reusables/codespaces/codespaces-machine-types.md +++ b/translations/ja-JP/data/reusables/codespaces/codespaces-machine-types.md @@ -1,11 +1,11 @@ --- -ms.openlocfilehash: 2a61633813730ae2a55d43d2d2cf976fda95784f -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 +ms.openlocfilehash: 9e66c56694869bc5479af2930548104fe373ec12 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147111113" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160212" --- -通常、2 コアから 32 コアの任意のリモート マシン上で codespace を実行できます。 これらはそれぞれ、異なるレベルのリソースと支払い層を持っています。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」をご覧ください。 +通常、任意の種類のリモート マシン上で codespace を実行できます。 これらのマシンの種類には、2 コアから 32 コアまでのハードウェア仕様が用意されていますが、すべての種類のマシンが常に使用できるわけではありません。 マシンの各種類には、それぞれ異なるレベルのリソースと異なる請求レベルが用意されています。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」をご覧ください。 既定では、codespace を作成するときに、有効なリソースが最も少ないマシンの種類が使われます。 diff --git a/translations/ja-JP/data/reusables/codespaces/codespaces-spending-limit-requirement.md b/translations/ja-JP/data/reusables/codespaces/codespaces-spending-limit-requirement.md index 9c886492a7..9893dee56d 100644 --- a/translations/ja-JP/data/reusables/codespaces/codespaces-spending-limit-requirement.md +++ b/translations/ja-JP/data/reusables/codespaces/codespaces-spending-limit-requirement.md @@ -1,7 +1,15 @@ +--- +ms.openlocfilehash: 7d64df6146c09aa6cd5fc997ccb96022fab29501 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159230" +--- {% note %} -**Note:** You must set a non-zero spending limit on your personal, organization, or enterprise account before the account can be billed for use of {% data variables.product.prodname_github_codespaces %}. +**注:** 個人、Organization、または Enterprise アカウントに対する {% data variables.product.prodname_github_codespaces %} の使用の課金が発生する前に、そのアカウントにゼロ以外の使用制限を設定する必要があります。 {% endnote %} -By default, all accounts have a {% data variables.product.prodname_github_codespaces %} spending limit of $0 USD. This prevents new codespaces being created, or existing codespaces being opened, if doing so would incur a billable cost to your personal, organization, or enterprise account. For personal accounts, codespaces can always be created and used if the account has not reached the limit of its monthly included usage. For organizations and enterprises, the default spending limit means that, to allow people to create codespaces that are billed to the organization, or its parent enterprise, the limit must be changed to a value above $0 USD. +既定で、{% data variables.product.prodname_github_codespaces %} の使用制限は、すべてのアカウントで 0 米ドルです。 これにより、個人、Organization または Enterprise に課金対象のコストが発生してしまうため、新しい codespace を作成したり、既存の codespace を開くことを防ぐことができます。 個人用アカウントでは、そのアカウントの毎月の使用量の上限に達していない場合は、いつでも codespaces を作成して使用できます。 Organization と Enterprise の既定の使用制限は、請求先を Organization またはその親 Enterprise とする codespace をユーザーが作成する場合には、上限を 0 米ドルを超える値に変更する必要があることを意味します。 diff --git a/translations/ja-JP/data/reusables/codespaces/configuration-choice-templates.md b/translations/ja-JP/data/reusables/codespaces/configuration-choice-templates.md new file mode 100644 index 0000000000..eb669ce73b --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/configuration-choice-templates.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 9a7f2eacb54b6133ec322f00ced9c0325747838c +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159816" +--- +ユーザーがテンプレート リポジトリで **[このテンプレートを使用]** ボタンから codespace を作成する場合、構成を選ぶことはできません。 codespace は、リポジトリのルートにある `.devcontainer/devcontainer.json` または `.devcontainer.json` で定義されている既定の構成に基づいて構築されます。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/copilot-in-vscode.md b/translations/ja-JP/data/reusables/codespaces/copilot-in-vscode.md new file mode 100644 index 0000000000..67f82be5cf --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/copilot-in-vscode.md @@ -0,0 +1,17 @@ +--- +ms.openlocfilehash: 56d362df2d0dc32b709c6e6d9cc1b8910ac81be5 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159840" +--- +[{% data variables.product.prodname_copilot %}](https://copilot.github.com/) (AI ペア プログラマー) は、任意の codespace で使用できます。 詳しくは、「[GitHub Copilot について](/copilot/overview-of-github-copilot/about-github-copilot)」をご覧ください。 + +{% data variables.product.prodname_github_codespaces %} で {% data variables.product.prodname_copilot %} を使い始めるには、[{% data variables.product.prodname_vscode_marketplace %} から {% data variables.product.prodname_copilot %} 拡張機能](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)をインストールします。 + +{% data variables.product.prodname_copilot %} またはその他の拡張機能をすべての codespace に含めるには、Settings Sync を有効にします。詳しくは、「[アカウントの {% data variables.product.prodname_github_codespaces %} をパーソナライズする](/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account#settings-sync)」をご覧ください。 また、すべてのユーザーの特定のプロジェクトに {% data variables.product.prodname_copilot %} を含めるには、`devcontainer.json` ファイルで `GitHub.copilot` を拡張機能として指定できます。 `devcontainer.json` ファイルの構成については、「[開発コンテナーの概要](/codespaces/customizing-your-codespace/configuring-codespaces-for-your-project#creating-a-custom-dev-container-configuration)」を参照してください。 + +## 参考資料 + +- 「[Visual Studio Code で GitHub Copilot を使い始める](/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code)」 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/creating-a-codespace-in-vscode.md b/translations/ja-JP/data/reusables/codespaces/creating-a-codespace-in-vscode.md index 3dafc1ad37..a0052a218f 100644 --- a/translations/ja-JP/data/reusables/codespaces/creating-a-codespace-in-vscode.md +++ b/translations/ja-JP/data/reusables/codespaces/creating-a-codespace-in-vscode.md @@ -1,30 +1,38 @@ -After you connect your account on {% data variables.product.prodname_dotcom_the_website %} to the {% data variables.product.prodname_github_codespaces %} extension, you can create a new codespace. For more information about the {% data variables.product.prodname_github_codespaces %} extension, see the [{% data variables.product.prodname_vs_marketplace_shortname %}](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). +--- +ms.openlocfilehash: d8f0e4e19ba362881f261a214aa56666f5902979 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148158582" +--- +{% data variables.product.prodname_dotcom_the_website %} のアカウントを {% data variables.product.prodname_github_codespaces %} 拡張機能に接続したら、新しい codespace を作成することができます。 {% data variables.product.prodname_github_codespaces %} 拡張機能の詳しい情報については、[{% data variables.product.prodname_vs_marketplace_shortname %}](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces) に関するページを参照してください。 {% data reusables.codespaces.click-remote-explorer-icon-vscode %} -2. Click the Add icon: {% octicon "plus" aria-label="The plus icon" %}. +2. [追加] アイコン {% octicon "plus" aria-label="The plus icon" %} をクリックします。 - ![The Create new Codespace option in {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/create-codespace-vscode.png) + ![{% data variables.product.prodname_github_codespaces %} の [Create New Codespace] オプション](/assets/images/help/codespaces/create-codespace-vscode.png) -3. Type the name of the repository you want to develop in, then select it. +3. 開発するリポジトリの名前を入力し、それを選択します。 - ![Searching for repository to create a new codespace](/assets/images/help/codespaces/choose-repository-vscode.png) + ![新しい codespace を作成するためのリポジトリを検索する](/assets/images/help/codespaces/choose-repository-vscode.png) - If the repository you choose is owned by an organization, and the organization has configured codespaces for this repository to be billable to the organization, or its parent enterprise, a message will be displayed in subsequent prompts telling you who will pay for the codespace. + 選択したリポジトリが組織所有であり、このリポジトリの料金がその組織かその親会社に請求されるよう、codespace が設定されている場合、後続のプロンプトにメッセージが表示され、codespace の料金の支払者が伝えられます。 -4. Click the branch you want to develop on. +4. 開発するブランチをクリックします。 - ![Searching for a branch to create a new codespace](/assets/images/help/codespaces/choose-branch-vscode.png) + ![新しい codespace を作成するためのブランチを検索する](/assets/images/help/codespaces/choose-branch-vscode.png) -5. If prompted to choose a dev container configuration file, choose a file from the list. +5. 開発コンテナー構成ファイルの選択を求められたら、一覧からファイルを選びます。 - ![Choosing a dev container configuration file for {% data variables.product.prodname_github_codespaces %}](/assets/images/help/codespaces/choose-dev-container-vscode.png) + ![{% data variables.product.prodname_github_codespaces %} の開発コンテナー構成ファイルの選択](/assets/images/help/codespaces/choose-dev-container-vscode.png) -6. Click the machine type you want to use. +6. 使用するマシンの種類をクリックします。 - ![Instance types for a new codespace](/assets/images/help/codespaces/choose-sku-vscode.png) + ![新しい codespace のインスタンス型](/assets/images/help/codespaces/choose-sku-vscode.png) {% note %} - **Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} + **注**: {% data reusables.codespaces.codespaces-machine-type-availability %} {% endnote %} diff --git a/translations/ja-JP/data/reusables/codespaces/developing-in-vscode.md b/translations/ja-JP/data/reusables/codespaces/developing-in-vscode.md new file mode 100644 index 0000000000..e309d17602 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/developing-in-vscode.md @@ -0,0 +1,26 @@ +--- +ms.openlocfilehash: 71aea4a0d9c72885e56e7aef5a20b36bf817fec5 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160063" +--- +### リポジトリの codespace をカスタマイズする + +リポジトリ用に作成された codespace は、リポジトリの開発コンテナー構成を作成または更新してカスタマイズできます。 これは、codespace 内から行うことができます。 開発コンテナー構成を変更した後、codespace の Docker コンテナーを再構築することで、変更を現在の codespace に適用できます。 詳細については、[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)に関するページをご覧ください。 + +### Codespace をパーソナライズする + +[ドットファイル](https://dotfiles.github.io/tutorials/) リポジトリと[同期設定](https://code.visualstudio.com/docs/editor/settings-sync)を使用して、作成した任意の codespace の codespace 環境のアスペクトをパーソナライズすることができます。 パーソナライズには、シェルの環境設定や追加のツールが含まれます。 詳細については、「[アカウントの {% data variables.product.prodname_codespaces %} をパーソナライズする](/codespaces/setting-up-your-codespace/personalizing-codespaces-for-your-account)」を参照してください。 + +### Codespace からアプリケーションを実行する +{% data reusables.codespaces.about-port-forwarding %} 詳しい情報については、「[Codespace でポートを転送する](/github/developing-online-with-codespaces/forwarding-ports-in-your-codespace)」を参照してください。 + +### 変更をコミットする + +{% data reusables.codespaces.committing-link-to-procedure %} + +### {% data variables.product.prodname_vscode_command_palette %} を使用する + +{% data variables.product.prodname_vscode_command_palette %} を使用すると、{% data variables.product.prodname_codespaces %} と {% data variables.product.prodname_vscode %} で多くの機能を利用したり、管理したりすることができます。 詳しい情報については、「[{% data variables.product.prodname_codespaces %} で {% data variables.product.prodname_vscode_command_palette %} を使用する](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces)」を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/edit-devcontainer-json.md b/translations/ja-JP/data/reusables/codespaces/edit-devcontainer-json.md index 6ad1646807..8a624f60ab 100644 --- a/translations/ja-JP/data/reusables/codespaces/edit-devcontainer-json.md +++ b/translations/ja-JP/data/reusables/codespaces/edit-devcontainer-json.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 38208812f73fda89c12d251955a1eee327ceb8db -ms.sourcegitcommit: 27882d9b3f19979c817c25952a2fb4dc4c6f0a65 +ms.openlocfilehash: 363a170cc5f062ac400e868eb920e1e035ac8fd8 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/27/2022 -ms.locfileid: "148114120" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159142" --- -1. ご利用のリポジトリの {% data variables.product.prodname_github_codespaces %} は、`devcontainer.json` ファイル内で構成されます。 リポジトリに `devcontainer.json` ファイルがまだ含まれていない場合は、今すぐ追加します。 「[開発コンテナー構成をリポジトリに追加する](/free-pro-team@latest/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)」を参照してください。 \ No newline at end of file +1. ご利用のリポジトリの {% data variables.product.prodname_github_codespaces %} は、`devcontainer.json` ファイル内で構成されている場合があります。 リポジトリに `devcontainer.json` ファイルがまだ含まれていない場合は、今すぐ追加します。 「[開発コンテナー構成をリポジトリに追加する](/codespaces/setting-up-your-project-for-codespaces/setting-up-your-project-for-codespaces)」を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/exporting-changes.md b/translations/ja-JP/data/reusables/codespaces/exporting-changes.md index 4de22a4e47..44241537b1 100644 --- a/translations/ja-JP/data/reusables/codespaces/exporting-changes.md +++ b/translations/ja-JP/data/reusables/codespaces/exporting-changes.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: dbfc559ca9be38d03d5bcd7c884687f098025ea9 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 63705338500bed176d013288ee7b091e593300ec +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/11/2022 -ms.locfileid: "145115357" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148158606" --- -使用制限に達した場合は、codespace の作成や再開ができなくなります。 [進行中の作業内容の変更を新しいブランチにエクスポートする](/codespaces/troubleshooting/exporting-changes-to-a-branch)ことは、引き続き可能です。 +個人、組織、または企業のアカウントが使用制限に達した場合、そのアカウントに課金される codespace は作成も再開もできなくなります。 ただし、進行中の作業内容の変更を新しいブランチにエクスポートすることは引き続き可能です。 詳細については、「[ブランチへの変更のエクスポート](/codespaces/troubleshooting/exporting-changes-to-a-branch)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/codespaces/gpg-in-active-codespaces.md b/translations/ja-JP/data/reusables/codespaces/gpg-in-active-codespaces.md new file mode 100644 index 0000000000..63e41d74ae --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/gpg-in-active-codespaces.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 9f5ba15be4cbdf524f825469d291bd3df970f974 +ms.sourcegitcommit: 47e03737d09bed84dfedb7be5924d893d34ea1a8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/16/2022 +ms.locfileid: "148167113" +--- +GPG 検証を有効にすると、関連するリポジトリから作成した新しい codespace で自動的に有効になります。 既存のアクティブな codespace で GPG 検証を有効にするには、codespace を停止して再起動する必要があります。 詳しくは、「[codespace の停止と開始](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)」を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/jetbrains-open-codespace-plugin.md b/translations/ja-JP/data/reusables/codespaces/jetbrains-open-codespace-plugin.md new file mode 100644 index 0000000000..d478bdc9f0 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/jetbrains-open-codespace-plugin.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: f9f3e238032c9256fa1d6e5432c79e2736a5a30a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160196" +--- +1. JetBrains クライアントで、{% data variables.product.prodname_github_codespaces %} プラグインをクリックして、{% data variables.product.prodname_github_codespaces %} ツール ウィンドウを表示します。 + + ![{% data variables.product.prodname_github_codespaces %} ツール ウィンドウのスクリーンショット](/assets/images/help/codespaces/jetbrains-codespaces-tool-window.png) diff --git a/translations/ja-JP/data/reusables/codespaces/jupyterlab-in-default-image.md b/translations/ja-JP/data/reusables/codespaces/jupyterlab-in-default-image.md new file mode 100644 index 0000000000..6742912f87 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/jupyterlab-in-default-image.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: c3900e59c91a3d0afd192b5ff948b612bfe0ba64 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160055" +--- +既定のコンテナー イメージには JupyterLab が含まれているため、既定のイメージから作成された codespace には常に JupyterLab がインストールされます。 既定のイメージについては詳しくは、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#using-the-default-dev-container-configuration)」と[ `devcontainers/images` リポジトリ](https://github.com/devcontainers/images/tree/main/src/universal)を参照してください。 開発コンテナー構成で既定のイメージを使用していない場合は、`devcontainer.json` ファイルに `ghcr.io/devcontainers/features/python` 機能を追加して JupyterLab をインストールできます。 オプション `"installJupyterlab": true`を含める必要があります。 詳細については、`devcontainers/features` リポジトリの [`python` 機能の README](https://github.com/devcontainers/features/tree/main/src/python#python-python) を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/jupyterlab-installed-in-codespace.md b/translations/ja-JP/data/reusables/codespaces/jupyterlab-installed-in-codespace.md new file mode 100644 index 0000000000..5e63869d75 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/jupyterlab-installed-in-codespace.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 1e6e9e375bb024561c279007909ab7a46f47b8a9 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160114" +--- +JupyterLab アプリケーションは、開いている codespace にインストールされている必要があります。 {% data reusables.codespaces.jupyterlab-in-default-image %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/links-to-get-started.md b/translations/ja-JP/data/reusables/codespaces/links-to-get-started.md index 3adfe82c65..a17d616516 100644 --- a/translations/ja-JP/data/reusables/codespaces/links-to-get-started.md +++ b/translations/ja-JP/data/reusables/codespaces/links-to-get-started.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 6d1607f3c2d1c775f5328d13ff4cb458d82037a0 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: b942594848833f5ccdeba0f4f6388e463591eac6 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109204" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148158950" --- -{% data variables.product.prodname_github_codespaces %} で作業を開始するには、「[{% data variables.product.prodname_github_codespaces %} のクイックスタート](/codespaces/getting-started/quickstart)」を参照してください。 codespace の作成または再オープンについて詳しくは、「[codespace の作成](/codespaces/developing-in-codespaces/creating-a-codespace)」と「[既存の codespace を開く](/codespaces/developing-in-codespaces/opening-an-existing-codespace)」を参照してください。 {% data variables.product.prodname_github_codespaces %} のしくみについて詳しくは、「[{% data variables.product.prodname_github_codespaces %} の詳細](/codespaces/getting-started/deep-dive)」をご覧ください。 +{% data variables.product.prodname_github_codespaces %} で作業を開始するには、「[{% data variables.product.prodname_github_codespaces %} のクイックスタート](/codespaces/getting-started/quickstart)」を参照してください。 codespace の作成に関する詳細については、「[リポジトリの codespace の作成](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)」と「[テンプレートから codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)」を参照してください。 既に作成した codespace に戻る場合は、「[既存の codespace を開く](/codespaces/developing-in-codespaces/opening-an-existing-codespace)」を参照してください。 {% data variables.product.prodname_github_codespaces %} のしくみについて詳しくは、「[{% data variables.product.prodname_github_codespaces %} の詳細](/codespaces/getting-started/deep-dive)」をご覧ください。 diff --git a/translations/ja-JP/data/reusables/codespaces/machine-types-for-unpublished-codespaces.md b/translations/ja-JP/data/reusables/codespaces/machine-types-for-unpublished-codespaces.md new file mode 100644 index 0000000000..91e340e5fd --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/machine-types-for-unpublished-codespaces.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 2511362f6aa19d917b5cf8488a368c9dd52b09a1 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159991" +--- +発行されていない codespace ({% data variables.product.product_name %} のリポジトリにリンクされていないテンプレートから作成された codespace) は、常に同じ仕様の仮想マシン上で実行されます。 発行されていない codespace のマシンの種類を変更することはできません。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/monthly-spending-limit-codespaces.md b/translations/ja-JP/data/reusables/codespaces/monthly-spending-limit-codespaces.md new file mode 100644 index 0000000000..ab13a84c84 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/monthly-spending-limit-codespaces.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 78eee4151cf6c88b83875b990e895707127e5421 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160087" +--- +1. [Codespaces] で、使用を制限するか、無制限の使用を許可します。 + + ![使用を制限するか、無制限の使用を許可するラジオ ボタンのスクリーンショット](/assets/images/help/billing/limit-or-unlimited-codespaces.png) diff --git a/translations/ja-JP/data/reusables/codespaces/navigating-to-a-codespace.md b/translations/ja-JP/data/reusables/codespaces/navigating-to-a-codespace.md new file mode 100644 index 0000000000..53011e1431 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/navigating-to-a-codespace.md @@ -0,0 +1,16 @@ +--- +ms.openlocfilehash: 3263bcf4439cdee99cbf589dde18dcb92af1ec00 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160204" +--- +## 既存の codespace に移動する + +1. {% data reusables.codespaces.you-can-see-all-your-codespaces %} +1. 開発する codespace の名前をクリックします。 + + ![Codespace の名前](/assets/images/help/codespaces/click-name-codespace.png) + +または、リポジトリに移動して、 **{% octicon "code" aria-label="The code icon" %} Code** を選ぶことで、特定のリポジトリの codespace を表示することもできます。 ドロップダウン メニューには、リポジトリのアクティブな codespace がすべて表示されます。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/open-template-in-codespace-step.md b/translations/ja-JP/data/reusables/codespaces/open-template-in-codespace-step.md new file mode 100644 index 0000000000..7ff2bcad2b --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/open-template-in-codespace-step.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 0193cb7b3950276f157e8ef2a84a958278cfc800 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160174" +--- +1. ファイル リストの上にある **[このテンプレートを使用する]** をクリックし、 **[codespace で開く]** を選びます。 + + ![[このテンプレートを使用する] ボタン](/assets/images/help/repository/use-this-template-button.png) \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/opening-codespace-in-jetbrains.md b/translations/ja-JP/data/reusables/codespaces/opening-codespace-in-jetbrains.md new file mode 100644 index 0000000000..c96b297f06 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/opening-codespace-in-jetbrains.md @@ -0,0 +1,34 @@ +--- +ms.openlocfilehash: 52206649d45bd9d76bcc593adeffa47318a70880 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160169" +--- +JetBrains Gateway を既定のエディターとして設定している場合、{% data variables.product.prodname_dotcom_the_website %} から codespace を開くと、Gateway が自動的に起動します。 + +JetBrains Gateway が既定のエディターではない場合でも、[github.com/codespaces](https://github.com/codespaces) にある [あなたの Codespaces] ページに移動し、開く codespace の右側にある省略記号 (...) をクリックすることによって、JetBrains で codespace を開くことができます。 詳しくは、「[既存の codespace を開く](/codespaces/developing-in-codespaces/opening-an-existing-codespace?tool=webui)」をご覧ください。 + +または、JetBrains Gateway を開き、次の手順で説明するように、既存の codespace を選ぶこともできます。 + +1. JetBrains Gateway アプリケーションを開きます。 +1. **[{% data variables.product.prodname_codespaces %} に接続する]** をクリックします。 + + ![JetBrains Gateway の初期ビューのスクリーンショット](/assets/images/help/codespaces/jetbrains-gateway-connect.png) + +1. [あなたの Codespaces] リストで、作業する codespace をクリックします。 + + ![JetBrains Gateway の codespace リストのスクリーンショット](/assets/images/help/codespaces/jetbrains-gateway-codespaces.png) + +1. "使用可能な IDE" リストで、使用する JetBrains IDE をクリックします。 Gateway は、次回 codespace に接続するときのために、選んだ項目を記憶します。 + + ![JetBrains Gateway の codespace リストのスクリーンショット](/assets/images/help/codespaces/jetbrains-gateway-ides.png) + +1. **[Connect]** をクリックします。 + + {% note %} + + **注**: "ファイアウォールを実行している場合": リモート リソースに初めて接続するときに、JetBrains Gateway がお使いのネットワーク経由で通信することを許可するように求められる場合があります。 + + {% endnote %} diff --git a/translations/ja-JP/data/reusables/codespaces/port-forwarding-adding-non-jetbrains.md b/translations/ja-JP/data/reusables/codespaces/port-forwarding-adding-non-jetbrains.md new file mode 100644 index 0000000000..d2442dee95 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/port-forwarding-adding-non-jetbrains.md @@ -0,0 +1,17 @@ +--- +ms.openlocfilehash: 5aef043edaeaf981964defece5a3a008a89ee5b8 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160151" +--- +## codespace 構成へのポートの追加 + +転送されるポートをリポジトリの {% data variables.product.prodname_github_codespaces %} 構成に追加し、リポジトリから作成されるすべての codespace でポートが自動的に転送されるようにすることができます。 変更を適用するには、構成を更新した後、以前に作成した codespace をリビルドする必要があります。 詳細については、[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)に関するページをご覧ください。 + +`forwardPorts` プロパティを使用して `.devcontainer.json` ファイル内の転送ポートを手動で構成することも、ブラウザーまたは {% data variables.product.prodname_vscode_shortname %} デスクトップ アプリケーションで開いた codespace の [ポート] パネルを使用することもできます。 + +{% data reusables.codespaces.navigate-to-ports-tab %} +1. codespace の構成に追加するポートを右クリックして、 **[ラベルを設定して devcontainer.json を更新する]** をクリックします。 + ![右クリック メニューでラベルを設定し devcontainer.json にポートを追加するオプション](/assets/images/help/codespaces/update-devcontainer-to-add-port-option.png) {% data reusables.codespaces.type-port-label %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/port-forwarding-labeling-non-jetbrains.md b/translations/ja-JP/data/reusables/codespaces/port-forwarding-labeling-non-jetbrains.md new file mode 100644 index 0000000000..fcf6656e07 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/port-forwarding-labeling-non-jetbrains.md @@ -0,0 +1,15 @@ +--- +ms.openlocfilehash: b85601bfdb4f5333e435878cba013882ed9c7f74 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160024" +--- +## ポートのラベル付け + +ブラウザーまたは {% data variables.product.prodname_vscode_shortname %} デスクトップ アプリケーションで codespace を開くと、転送されたポートにラベルを付けて、リストで識別しやすくすることができます。 + +{% data reusables.codespaces.navigate-to-ports-tab %} +1. ラベルを付けるポートをポイントして、ラベル アイコンをクリックします。 + ![ポートのラベル アイコン](/assets/images/help/codespaces/label-icon.png) {% data reusables.codespaces.type-port-label %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/prebuilds-permission-authorization.md b/translations/ja-JP/data/reusables/codespaces/prebuilds-permission-authorization.md index a21b08a741..68600bff4d 100644 --- a/translations/ja-JP/data/reusables/codespaces/prebuilds-permission-authorization.md +++ b/translations/ja-JP/data/reusables/codespaces/prebuilds-permission-authorization.md @@ -1,10 +1,10 @@ --- -ms.openlocfilehash: c32a9f6f6a799c3653cb17fe89721090fc01d155 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: bb81ad72418e81366595d963296493a7a3b55202 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109195" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148158678" --- リポジトリの開発コンテナー構成で他のリポジトリにアクセスするためのアクセス許可が指定されている場合は、認可ページが表示されます。 `devcontainer.json` ファイルでこれを指定する方法について詳しくは、「[codespace 内の他のリポジトリへのアクセスを管理する](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/codespaces/publishing-template-codespaces.md b/translations/ja-JP/data/reusables/codespaces/publishing-template-codespaces.md new file mode 100644 index 0000000000..f1d8f65ce5 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/publishing-template-codespaces.md @@ -0,0 +1,34 @@ +--- +ms.openlocfilehash: a78c61511f0daa225bc27576a2ab57e8e1bea939 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160150" +--- +codespace で作業している場合は、{% data variables.product.prodname_vscode_shortname %} Web クライアントまたはデスクトップ アプリケーションから発行できます。 + +{% data reusables.codespaces.source-control-display-dark %} +1. 変更をステージングするには、追加または変更したファイルの横の **[+]** をクリックします。複数のファイルを変更してすべてをステージングする場合は、 **[変更]** の横のものをクリックします。 + + ![ステージング ボタンが強調表示されたソース コントロール サイドバー](/assets/images/help/codespaces/codespaces-commit-stage.png) + + {% note %} + + **注:** {% data variables.product.company_short %} の空のテンプレートから開始した場合、ディレクトリを Git リポジトリとして既に初期化していない限り、変更の一覧は表示されません。 空のテンプレートから作成された codespace を発行するには、[ソース管理] ビューで **[{% data variables.product.company_short %} に発行]** をクリックし、手順 5 に進みます。 + + {% endnote %} +2. ステージングされた変更をコミットするには、行った変更を説明するコミット メッセージを入力し、 **[コミット]** をクリックします。 + + ![コミット メッセージがあるソース管理サイドバー](/assets/images/help/codespaces/vscode-commit-button.png) +3. **[ブランチを公開する]** をクリックします。 + + ![VS Code の [ブランチの発行] ボタンのスクリーンショット](/assets/images/help/codespaces/vscode-publish-branch-button.png) +4. [リポジトリ名] ドロップダウンで、新しいリポジトリの名前を入力し、 **[{% data variables.product.company_short %} プライベート リポジトリに発行]** または **[{% data variables.product.company_short %} パブリック リポジトリに発行]** を選びます。 + + ![VS Code の [リポジトリ名] ドロップダウンのスクリーンショット](/assets/images/help/codespaces/choose-new-repository.png) + + 新しいリポジトリの所有者は、codespace を作成した {% data variables.product.prodname_dotcom %} アカウントになります。 +5. 必要に応じて、エディターの右下隅に表示されるポップアップで、 **[{% data variables.product.company_short %} で開く]** をクリックして、{% data variables.product.prodname_dotcom_the_website %} の新しいリポジトリを表示します。 + + ![VS Code の [GitHub で開く] ポップアップのスクリーンショット](/assets/images/help/codespaces/open-on-github.png) \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/rebuild-command.md b/translations/ja-JP/data/reusables/codespaces/rebuild-command.md index b6ddc5fbeb..e60ef5447f 100644 --- a/translations/ja-JP/data/reusables/codespaces/rebuild-command.md +++ b/translations/ja-JP/data/reusables/codespaces/rebuild-command.md @@ -1,11 +1,5 @@ ---- -ms.openlocfilehash: 2a9a8aec377e545ba9eecac42e61e9cdff9c4bfd -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/09/2022 -ms.locfileid: "147760880" ---- -1. {% data variables.product.prodname_vscode_command_palette_shortname %} にアクセスし (Shift + Command + P (Mac) / Ctrl + Shift + P (Windows/Linux))、「リビルド」と入力します。 **[Codespaces: コンテナーのリビルド]** を選択します。 +1. Access the {% data variables.product.prodname_vscode_command_palette_shortname %} (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)), then start typing "rebuild". Select **Codespaces: Rebuild Container**. - ![コンテナリビルドの選択肢](/assets/images/help/codespaces/codespaces-rebuild.png) + ![Screenshot of Rebuild Container command in the Command Pallette](/assets/images/help/codespaces/codespaces-rebuild.png) + + {% indented_data_reference reusables.codespaces.full-rebuild-tip %} diff --git a/translations/ja-JP/data/reusables/codespaces/setting-up-project-intro.md b/translations/ja-JP/data/reusables/codespaces/setting-up-project-intro.md new file mode 100644 index 0000000000..dbdbf2f0ee --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/setting-up-project-intro.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 21daaf99777a364391eb83e7c9addbd0d1947265 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159879" +--- +{% data variables.product.prodname_vscode %} デスクトップ アプリケーションか {% data variables.product.prodname_vscode_shortname %} Web クライアントのいずれかが使用されている {% data variables.product.prodname_codespaces %} で。 codespace でプロジェクトを開いて開発コンテナーの構成を変更する例について紹介します。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/setup-custom-devcontainer.md b/translations/ja-JP/data/reusables/codespaces/setup-custom-devcontainer.md index 21001ff0e1..7319883be3 100644 --- a/translations/ja-JP/data/reusables/codespaces/setup-custom-devcontainer.md +++ b/translations/ja-JP/data/reusables/codespaces/setup-custom-devcontainer.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 8fce179b1aa62f79737c46329d11f3e375dc375c -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 +ms.openlocfilehash: 7c8d446316e97bed4e63b3eb5ae7b8f9b1e4da40 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147060298" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159864" --- -カスタム開発コンテナーを使用するようにリポジトリを設定するには、`devcontainer.json` ファイルを 1 つ以上作成する必要があります。 これらは、テンプレートからか {% data variables.product.prodname_vscode %} 内に追加したり、独自のものを記述したりすることができます。 開発コンテナーの詳しい情報については、「[開発コンテナーの概要](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project)」を参照してください。 +カスタム開発コンテナーを使用するようにリポジトリを設定するには、`devcontainer.json` ファイルを 1 つ以上作成する必要があります。 これは、定義済みの構成テンプレートから追加するか、{% data variables.product.prodname_vscode %} 内に追加するか、または独自に記述することができます。 開発コンテナーの詳しい情報については、「[開発コンテナーの概要](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/codespaces/source-control-commit-changes.md b/translations/ja-JP/data/reusables/codespaces/source-control-commit-changes.md index 256e357809..5611d08f42 100644 --- a/translations/ja-JP/data/reusables/codespaces/source-control-commit-changes.md +++ b/translations/ja-JP/data/reusables/codespaces/source-control-commit-changes.md @@ -1,15 +1,15 @@ --- -ms.openlocfilehash: 8cb17c6661826a0d46c37436b05b9f694541dab1 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 0591199ee1d92622aaef5c89e7dcc3d1eab89bfe +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145139147" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160168" --- {% data reusables.codespaces.source-control-display-dark %} 1. 変更をステージングするには、変更したファイルの横の **[+]** をクリックします。複数のファイルを変更してすべてをステージングする場合は、 **[変更]** の横のものをクリックします。 -![ステージング ボタンが強調表示されたソース コントロール サイドバー](/assets/images/help/codespaces/codespaces-commit-stage.png) +![ステージング ボタンが強調表示されているソース管理のサイドバー](/assets/images/help/codespaces/codespaces-commit-stage.png) 1. 行った変更について説明するコミットメッセージを入力します。 -![コミット メッセージがあるソース管理サイドバー](/assets/images/help/codespaces/codespaces-commit-commit-message.png) -1. ステージングされた変更をコミットするには、ソースコントロールサイドバーの上部にあるチェックマークをクリックします。 +![コミット メッセージがあるソース管理のサイドバー](/assets/images/help/codespaces/codespaces-commit-commit-message.png) +1. ステージされている変更をコミットするには、ソース管理のサイドバーの上部にあるチェック マークをクリックします。 ![チェック マーク アイコンをクリックする](/assets/images/help/codespaces/codespaces-commit-checkmark-icon.png) diff --git a/translations/ja-JP/data/reusables/codespaces/source-control-pull-request.md b/translations/ja-JP/data/reusables/codespaces/source-control-pull-request.md index d532eef5d9..6091a63391 100644 --- a/translations/ja-JP/data/reusables/codespaces/source-control-pull-request.md +++ b/translations/ja-JP/data/reusables/codespaces/source-control-pull-request.md @@ -1,13 +1,13 @@ --- -ms.openlocfilehash: 32ab6120ced32f068eda9d9b9b1823352685f4ed -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 +ms.openlocfilehash: fe4475ec888b22062f49db7a8e87034125a35c94 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "145139124" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159807" --- 1. リポジトリのローカル コピーに変更をコミットし、 **[pull request の作成]** アイコンをクリックします。 -![ステージング ボタンが強調表示されたソース コントロール サイドバー](/assets/images/help/codespaces/codespaces-commit-pr-button.png) +![ステージング ボタンが強調表示されているソース管理サイドバー](/assets/images/help/codespaces/codespaces-commit-pr-button.png) 1. マージ元のローカルブランチとリポジトリ、およびマージ先のリモートブランチとリポジトリが正しいことを確認します。 そして、プルリクエストにタイトルと説明を付けます。 -![ステージング ボタンが強調表示されたソース コントロール サイドバー](/assets/images/help/codespaces/codespaces-commit-pr.png) +![ステージング ボタンが強調表示されているソース管理サイドバー](/assets/images/help/codespaces/codespaces-commit-pr.png) 1. **[作成]** をクリックします。 diff --git a/translations/ja-JP/data/reusables/codespaces/source-control.md b/translations/ja-JP/data/reusables/codespaces/source-control.md new file mode 100644 index 0000000000..2458635377 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/source-control.md @@ -0,0 +1,63 @@ +--- +ms.openlocfilehash: c760b3f26f89437d485cc222de4fbc54fa907735 +ms.sourcegitcommit: f464cc9bfc41132f315ea172c591bfd145a06736 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/15/2022 +ms.locfileid: "148165461" +--- +## テンプレートから作成された codespace の発行 + +テンプレート リポジトリまたは "あなたの codespaces" ページのテンプレートから codespace を作成する場合、codespace を発行するまで、{% data variables.product.prodname_dotcom %} のリポジトリに作業は格納されません。 詳しくは、「[テンプレートから codespace を作成する](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template#publishing-to-a-repository-on-github)」を参照してください。 + +{% data reusables.codespaces.publishing-template-codespaces %} + +## ブランチの作成または切り替え + +{% data reusables.codespaces.create-or-switch-branch %} + +{% tip %} + +**ヒント**: 他のユーザーが最近、リモート リポジトリのファイルを変更した場合、切り替え後のブランチでは、変更を自分の codespace にプルするまで、それらの変更が表示されません。 + +{% endtip %} + +## 変更をコミットする + +{% data reusables.codespaces.source-control-commit-changes %} + +## リモートリポジトリから変更をプルする + +リモートリポジトリからいつでも codespace に変更をプルできます。 + +{% data reusables.codespaces.source-control-display-dark %} +1. サイドバーの上部にある省略記号 **[...]** をクリックします。![[表示] および [その他のアクション] の省略記号ボタン](/assets/images/help/codespaces/source-control-ellipsis-button.png) +1. ドロップダウン メニューの **[プル]** をクリックします。 + +codespace の作成後に開発コンテナー構成が変更された場合は、codespace のコンテナーを再構築することで変更を適用できます。 詳細については、[開発コンテナーの概要](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project#applying-changes-to-your-configuration)に関するページをご覧ください。 + +## 新しい変更を自動的にフェッチするように codespace を設定する + +リモートリポジトリに対して行われた新しいコミットの詳細を自動的にフェッチするように codespace を設定できます。 これにより、リポジトリのローカルコピーが古くなっているかどうかを確認できます。古くなっている場合は、新しい変更をプルすることができます。 + +フェッチ操作でリモートリポジトリの新しい変更が検出されると、ステータスバーに新しいコミットの数が表示されます。 その後、変更をローカルコピーにプルできます。 + +1. アクティビティ バーの下部にある **[管理]** ボタンをクリックします。 +![[管理] ボタン](/assets/images/help/codespaces/manage-button.png) +1. メニューで、[**設定**] をクリックします。 +1. [設定] ページで、次を検索します: `autofetch`。 +![autofetch を検索する](/assets/images/help/codespaces/autofetch-search.png) +1. 現在のリポジトリに登録されているすべてのリモートの更新の詳細をフェッチするには、**Git: Autofetch** を `all` に設定します。 +![Git autofetch を有効にする](/assets/images/help/codespaces/autofetch-all.png) +1. 各自動フェッチ間の秒数を変更する場合は、**Git: Autofetch Period** の値を編集します。 + +## プルリクエストを発行する + +{% data reusables.codespaces.source-control-pull-request %} + +## リモートリポジトリに変更をプッシュする + +保存してコミットした変更をプッシュできます。 それにより、変更がリモートリポジトリの上流ブランチに適用されます。 プルリクエストの作成準備が整っていない場合、または {% data variables.product.prodname_dotcom %} でプルリクエストを作成する場合は、この操作を行うことをお勧めします。 + +1. サイドバーの上部にある省略記号 **[...]** をクリックします。![[表示] および [その他のアクション] の省略記号ボタン](/assets/images/help/codespaces/source-control-ellipsis-button-nochanges.png) +1. ドロップダウン メニューの **[プッシュ]** をクリックします。 diff --git a/translations/ja-JP/data/reusables/codespaces/ssh-server-installed.md b/translations/ja-JP/data/reusables/codespaces/ssh-server-installed.md new file mode 100644 index 0000000000..e9eb02eb39 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/ssh-server-installed.md @@ -0,0 +1,19 @@ +--- +ms.openlocfilehash: 8c155db26d97e1f845638c790dd3cf1114eac47a +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160219" +--- +接続する codespace では、SSH サーバーを実行している必要があります。 既定のコンテナー イメージには、自動的に開始される SSH サーバーが含まれています。 codespaces が既定のイメージから作成されていない場合は、`devcontainer.json` ファイル内の `features` オブジェクトに次を追加することで、SSH サーバーをインストールして起動できます。 + +```json +"features": { + ... + "ghcr.io/devcontainers/features/sshd:1": { + "version": "latest" + }, + ... +} +``` \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/starting-new-project-template.md b/translations/ja-JP/data/reusables/codespaces/starting-new-project-template.md new file mode 100644 index 0000000000..bbd6e35556 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/starting-new-project-template.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 175259e6863efa78d746eef4f78de4acfa3bc6c7 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160023" +--- +新しいプロジェクトを始める場合は、テンプレートから codespace を作成して、後で {% data variables.product.product_name %} でリポジトリを発行できます。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/stopping-a-codespace.md b/translations/ja-JP/data/reusables/codespaces/stopping-a-codespace.md index e41bb8fbb8..bf4b490be5 100644 --- a/translations/ja-JP/data/reusables/codespaces/stopping-a-codespace.md +++ b/translations/ja-JP/data/reusables/codespaces/stopping-a-codespace.md @@ -1,13 +1,13 @@ --- -ms.openlocfilehash: 5431cd0a877d3a87e4dd22fc3503bb9f67058b76 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 4bdcc6ff93e7671d4dc368fc44784c963f549aae +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109188" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159046" --- -codespace はいつでも停止できます。 codespace を停止すると、実行中のすべてのプロセスが停止され、ターミナルの履歴が消去されます。 次に codespace を起動するときに、codespace に保存した変更は引き続き使用できます。 codespace を明示的に停止しない場合、非アクティブからタイムアウトするまで実行され続けます。 詳細については、「[Codespace のタイムアウト](/codespaces/developing-in-codespaces/codespaces-lifecycle#codespaces-timeouts)」を参照してください。 +codespace はいつでも停止できます。 codespace を停止すると、実行中のすべてのプロセスが停止され、ターミナルの履歴が消去されます。 次に codespace を起動するときに、codespace に保存した変更は引き続き使用できます。 codespace を明示的に停止しない場合、非アクティブからタイムアウトするまで実行され続けます。 詳しくは、「[codespace のライフサイクル](/codespaces/developing-in-codespaces/the-codespace-lifecycle#timeouts-for-github-codespaces)」を参照してください。 -実行中の codespace にのみ CPU 料金が発生します。停止した codespace では、ストレージ コストのみが発生します。 +CPU 料金は、実行中の codespace に対してのみ発生します。 停止した codespace には、ストレージ コストのみが発生します。 codespace を停止し、再起動したときに、変更を適用したいと思うかもしれません。 たとえば、codespace に使用するマシンの種類を変更した場合、変更を有効にするには、その codespace を停止して再起動する必要があります。 また、エラーや予期しない問題が発生した場合に、codespace を停止し、再起動または削除することもできます。 diff --git a/translations/ja-JP/data/reusables/codespaces/template-codespaces-default-editor.md b/translations/ja-JP/data/reusables/codespaces/template-codespaces-default-editor.md new file mode 100644 index 0000000000..bbb7d0f90b --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/template-codespaces-default-editor.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 56dc7f61a1ed68ffdb7e90f7edae615a8e428cad +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159959" +--- +新しい codespace をテンプレートから作成すると、常に {% data variables.product.prodname_vscode %} Web クライアントで開きます。 サポートされているエディターでは、既存の codespace を開くことができます。 詳しくは、「[既存の codespace を開く](/codespaces/developing-in-codespaces/opening-an-existing-codespace)」をご覧ください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/usage-report-download.md b/translations/ja-JP/data/reusables/codespaces/usage-report-download.md new file mode 100644 index 0000000000..c35648e227 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/usage-report-download.md @@ -0,0 +1,21 @@ +--- +ms.openlocfilehash: c03f2677064bae6362b21c172725d334a2b22994 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160144" +--- +1. または、[今月の利用状況] の横にある **[利用レポートの取得]** をクリックして、{% data variables.product.prodname_actions %}、{% data variables.product.prodname_registry %}、{% data variables.product.prodname_github_codespaces %} のストレージ利用状況の CSV レポートをダウンロードするためのリンクを含むメールを受け取ることもできます。 メールはアカウントのプライマリ メール アドレスに送信されます。 レポートで過去 7 日間、30 日間、90 日間、または 180 日間のどれを対象にするかを選択できます。 + + ![CSV レポートのダウンロード](/assets/images/help/billing/actions-packages-report-download.png) + + このレポートで使用されるデータは毎日更新されます。 + + {% data variables.product.prodname_github_codespaces %} コンピューティングの使用量とストレージのコストを確認するには、レポートをフィルター処理して、`Product` 列に "Codespaces" が示される行のみを表示します。 + + ![{% data variables.product.prodname_codespaces %} でフィルター処理された使用状況レポートのスクリーンショット](/assets/images/help/codespaces/CSV-usage-report.png) + + プレビルドの作成、更新、および格納のコストのみを表示するには、レポートをフィルター処理して、`Actions Workflow` 列に "Codespaces プレビルドの作成" が示される行のみを表示します。 + + ![プレビルド用にフィルター処理された使用状況レポートのスクリーンショット](/assets/images/help/codespaces/CSV-usage-report-prebuilds.png) diff --git a/translations/ja-JP/data/reusables/codespaces/use-chrome.md b/translations/ja-JP/data/reusables/codespaces/use-chrome.md index 6f841fb0a5..6cd4a953df 100644 --- a/translations/ja-JP/data/reusables/codespaces/use-chrome.md +++ b/translations/ja-JP/data/reusables/codespaces/use-chrome.md @@ -1,2 +1,10 @@ +--- +ms.openlocfilehash: 28b050801ea07a3ef9a6644f45e9e987c9ed21a9 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160138" +--- -For the best experience with {% data variables.product.prodname_github_codespaces %}, we recommend using a Chromium-based browser, like Google Chrome or Microsoft Edge. +{% data variables.product.prodname_github_codespaces %} での最善の体験のためには、Google Chrome あるいは Microsoft Edge のような Chromium ベースのブラウザーを使うことをおすすめします。 diff --git a/translations/ja-JP/data/reusables/codespaces/view-all-templates-step.md b/translations/ja-JP/data/reusables/codespaces/view-all-templates-step.md new file mode 100644 index 0000000000..c4c01c73b4 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/view-all-templates-step.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 97424b3eef10bea63f1cb8006fc600107ab1a57b +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159871" +--- +1. テンプレートの完全な一覧を表示するには、[クイック スタート テンプレートの探索] で **[すべて表示]** をクリックします。 + + ![[クイック スタート テンプレートの探索] セクションのスクリーンショット。[すべて表示] が強調表示されています](/assets/images/help/codespaces/codespace-templates-see-all.png) \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/vscode-interface-annotation.md b/translations/ja-JP/data/reusables/codespaces/vscode-interface-annotation.md new file mode 100644 index 0000000000..23052cb375 --- /dev/null +++ b/translations/ja-JP/data/reusables/codespaces/vscode-interface-annotation.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: e534b88265d2daba3b103080c5ed050adfb89459 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160139" +--- +1. **サイドバー** - 既定では、この領域にはエクスプローラーにプロジェクト ファイルが表示されます。 +2. **アクティビティ バー** - これによりビューが表示され、それらを切り替える方法が提供されます。 ビューはドラッグアンドドロップで並べ替えることができます。 +3. **エディター** - ここでファイルを編集します。 ファイルのタブを右クリックすると、エクスプローラーでファイルを見つけるなどのオプションにアクセスできます。 +4. **パネル** - 出力とデバッグ情報、および統合ターミナルの既定の場所を確認できます。 +5. **ステータス バー** - この領域には、codespace とプロジェクトに関する有用な情報が表示されます。 たとえば、ブランチ名、設定されたポートなどです。 diff --git a/translations/ja-JP/data/reusables/education/note-on-student-codespaces-usage.md b/translations/ja-JP/data/reusables/education/note-on-student-codespaces-usage.md new file mode 100644 index 0000000000..732f2be798 --- /dev/null +++ b/translations/ja-JP/data/reusables/education/note-on-student-codespaces-usage.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 5403ea0030ebd6bdcf072c1791f863ce9f73377e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160132" +--- +学生が {% data variables.product.prodname_classroom %} の課題リポジトリで {% data variables.product.prodname_github_codespaces %} を使用している場合、その使用量は教室を所有する組織に課金され、学生の個人アカウントの使用量には影響しません。 diff --git a/translations/ja-JP/data/reusables/education/student-codespaces-benefit.md b/translations/ja-JP/data/reusables/education/student-codespaces-benefit.md new file mode 100644 index 0000000000..a656376c95 --- /dev/null +++ b/translations/ja-JP/data/reusables/education/student-codespaces-benefit.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 3d5f9723fc9c1778d8e98d24b3997710a468c12b +ms.sourcegitcommit: aa67bb5ad7aa6804c5def4390e30adcc7cf96ea1 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/15/2022 +ms.locfileid: "148165194" +--- +検証済みの学生は、個人アカウントに対して {% data variables.product.prodname_github_codespaces %} を無料で使用できます (1 か月あたり最大 180 コア時間)。 学生が使用できるストレージとコア時間の月間使用量は、{% data variables.product.prodname_pro %} アカウントに含まれる量と同じです。 詳しくは、「[{% data variables.product.prodname_github_codespaces %} の支払いについて](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)」をご覧ください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/enterprise-accounts/emu-azure-admin-consent.md b/translations/ja-JP/data/reusables/enterprise-accounts/emu-azure-admin-consent.md index e118cef250..1b68756a7d 100644 --- a/translations/ja-JP/data/reusables/enterprise-accounts/emu-azure-admin-consent.md +++ b/translations/ja-JP/data/reusables/enterprise-accounts/emu-azure-admin-consent.md @@ -1,14 +1,6 @@ ---- -ms.openlocfilehash: 75ac89c3c50225b0c930c6d603acf0d5c331597d -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147067859" ---- -1. リダイレクトされたら、ID プロバイダーにサインインしてから、指示に従って同意し、{% data variables.product.prodname_emu_idp_oidc_application %} アプリケーションをインストールします。 +1. After {% data variables.product.product_name %} redirects you to your IdP, sign in, then follow the instructions to give consent and install the {% data variables.product.prodname_emu_idp_oidc_application %} application. After Azure AD asks for permissions for {% data variables.product.company_short %} {% data variables.product.prodname_emus %} with OIDC, enable **Consent on behalf of your organization**, then click **Accept**. {% warning %} - **警告:** {% data variables.product.prodname_emu_idp_oidc_application %} アプリケーションのインストールに同意するには、グローバル管理者権限を持つユーザーとして Azure AD にサインインする必要があります。 + **Warning:** You must sign in to Azure AD as a user with global admin rights in order to consent to the installation of the {% data variables.product.prodname_emu_idp_oidc_application %} application. {% endwarning %} diff --git a/translations/ja-JP/data/reusables/enterprise-accounts/oidc-beta-notice.md b/translations/ja-JP/data/reusables/enterprise-accounts/oidc-beta-notice.md deleted file mode 100644 index 9a86d820ed..0000000000 --- a/translations/ja-JP/data/reusables/enterprise-accounts/oidc-beta-notice.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -ms.openlocfilehash: 212811ec85eac69f0a197bdd7b5002848a30a889 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147059883" ---- -{% note %} - -**注:** {% data variables.product.prodname_emus %} に対する OpenID Connect (OIDC) と条件付きアクセス ポリシー (CAP) のサポートはパブリック ベータ段階であり、Azure AD でのみ使用できます。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/enterprise-accounts/settings-tab.md b/translations/ja-JP/data/reusables/enterprise-accounts/settings-tab.md index a8e0287ccd..0e9052f985 100644 --- a/translations/ja-JP/data/reusables/enterprise-accounts/settings-tab.md +++ b/translations/ja-JP/data/reusables/enterprise-accounts/settings-tab.md @@ -1,10 +1,11 @@ --- -ms.openlocfilehash: 2ca0b407c0a2da2784d555031fd4257384ea3839 -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 +ms.openlocfilehash: 55d1e3fd84a0d13fabb3d1b8f6543055a897ed83 +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147878874" +ms.lasthandoff: 11/22/2022 +ms.locfileid: "148180136" --- 1. エンタープライズ アカウントのサイドバーで、{% octicon "gear" aria-label="The Settings gear" %} **[設定]** をクリックします。 ![エンタープライズ アカウントのサイドバー内の [設定] タブ](/assets/images/help/business-accounts/enterprise-account-settings-tab.png) + \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/enterprise/best-practices.md b/translations/ja-JP/data/reusables/enterprise/best-practices.md new file mode 100644 index 0000000000..8e0eba4ef1 --- /dev/null +++ b/translations/ja-JP/data/reusables/enterprise/best-practices.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 22e809fc1161b294cac04d68a232c28453aa6352 +ms.sourcegitcommit: 0a6e3eee6eea9b1e445aea1e4461d64cf6b63218 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: "148163586" +--- +エンタープライズで {% data variables.product.product_name %} を最も効果的に使用する方法については、「[エンタープライズのベスト プラクティス](/admin/overview/best-practices-for-enterprises)」を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/enterprise_installation/image-urls-viewable-warning.md b/translations/ja-JP/data/reusables/enterprise_installation/image-urls-viewable-warning.md index ecff795df4..d4ad4ce937 100644 --- a/translations/ja-JP/data/reusables/enterprise_installation/image-urls-viewable-warning.md +++ b/translations/ja-JP/data/reusables/enterprise_installation/image-urls-viewable-warning.md @@ -1,5 +1,5 @@ {% warning %} -**Warning:** If you add an image attachment to a pull request or issue comment, anyone can view the anonymized image URL without authentication{% ifversion ghes %}, even if the pull request is in a private repository, or if private mode is enabled. To prevent unauthorized access to the images, ensure that you restrict network access to the systems that serve the images, including {% data variables.location.product_location %}{% endif %}.{% ifversion ghae %} To prevent unauthorized access to image URLs on {% data variables.product.product_name %}, consider restricting network traffic to your enterprise. For more information, see "[Restricting network traffic to your enterprise](/admin/configuration/restricting-network-traffic-to-your-enterprise)."{% endif %} +**Warning:** If you add an image attachment to a pull request or issue comment, anyone can view the anonymized image URL without authentication{% ifversion ghes %}, even if the pull request is in a private repository, or if private mode is enabled. To prevent unauthorized access to the images, ensure that you restrict network access to the systems that serve the images, including {% data variables.location.product_location %}{% endif %}.{% ifversion ghae %} To prevent unauthorized access to image URLs on {% data variables.product.product_name %}, consider restricting network traffic to your enterprise. For more information, see "[Restricting network traffic to your enterprise with an IP allow list](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)."{% endif %} {% endwarning %} diff --git a/translations/ja-JP/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md b/translations/ja-JP/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md new file mode 100644 index 0000000000..78e5e1ab5a --- /dev/null +++ b/translations/ja-JP/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 303172b12f23dc26668c3ac8a09c3b943eb64fbb +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/22/2022 +ms.locfileid: "148180122" +--- +現在、認証に SAML SSO を使っており、OIDC を使って CAP サポートの恩恵を受けたい場合は、移行パスをたどることができます。 詳細については、「[SAML から OIDC への移行](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc)」を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/about-adding-ip-allow-list-entries.md b/translations/ja-JP/data/reusables/identity-and-permissions/about-adding-ip-allow-list-entries.md index 3c08dedb53..af9e2e65e5 100644 --- a/translations/ja-JP/data/reusables/identity-and-permissions/about-adding-ip-allow-list-entries.md +++ b/translations/ja-JP/data/reusables/identity-and-permissions/about-adding-ip-allow-list-entries.md @@ -1,11 +1,3 @@ ---- -ms.openlocfilehash: db4c80c49c4e3effe99073f29010147f3a1efc08 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148108934" ---- -それぞれに IP アドレスまたはアドレス範囲を含むエントリを追加することで、IP 許可リストを作成できます。{% ifversion ip-allow-list-address-check %} エントリの追加が完了したら、特定の IP アドレスがリスト内のいずれかの有効なエントリによって許可されるかどうかを確認できます。{% endif %} +You can create an IP allow list by adding entries that each contain an IP address or address range. After you finish adding entries, you can check whether a particular IP address would be allowed by any of the enabled entries in your list. -Enterprise 内の Organization が所有する {% ifversion ghae %}Enterprise{% else %} プライベート アセット{% endif %}へのアクセスがリストによって制限される前に、許可 IP アドレスも有効にする必要があります。 +Before the list restricts access to {% ifversion ghae %}your enterprise{% else %}private assets owned by organizations in your enterprise{% endif %}, you must also enable allowed IP addresses. diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/about-editing-ip-allow-list-entries.md b/translations/ja-JP/data/reusables/identity-and-permissions/about-editing-ip-allow-list-entries.md index f8ace38686..f8c5490631 100644 --- a/translations/ja-JP/data/reusables/identity-and-permissions/about-editing-ip-allow-list-entries.md +++ b/translations/ja-JP/data/reusables/identity-and-permissions/about-editing-ip-allow-list-entries.md @@ -1,12 +1,3 @@ ---- -ms.openlocfilehash: 8f78a77c83ea498d8d41a0deff20903062542479 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148108928" ---- -IP 許可リストのエントリを編集できます。 有効なエントリを編集すると、変更がすぐに適用されます。 +You can edit an entry in your IP allow list. If you edit an enabled entry, changes are enforced immediately. -{% ifversion ip-allow-list-address-check %}エントリの編集が完了したら、特定の IP アドレスがリスト内のいずれかの有効なエントリによって許可されるかどうかを確認できます。 -{% endif %} +After you finish editing entries, you can check whether your allow list will permit a connection from a particular IP address after you enable the list. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md b/translations/ja-JP/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md index 16814a5064..25129e468e 100644 --- a/translations/ja-JP/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md +++ b/translations/ja-JP/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md @@ -1,12 +1,3 @@ ---- -ms.openlocfilehash: 095556009ed66ca0b687734f62f21c70fd87699a -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148108923" ---- -IP 許可リストを作成すると、許可 IP アドレスを有効にすることができます。 許可 IP アドレスを有効にすると、IP 許可リスト内のいずれかの有効なエントリが、{% data variables.product.company_short %} によってすぐに適用されます。 +After you create an IP allow list, you can enable allowed IP addresses. When you enable allowed IP addresses, {% data variables.product.company_short %} immediately enforces any enabled entries in your IP allow list. -{% ifversion ip-allow-list-address-check %} 許可 IP アドレスを有効にする前に、特定の IP アドレスがリスト内のいずれかの有効なエントリによって許可されるかどうかを確認できます。 詳しくは、「[IP アドレスが許可されているかどうかを確認する](#checking-if-an-ip-address-is-permitted)」を参照してください。 -{% endif %} +Before you enable your IP allow list, you can check whether your allow list will permit a connection from a particular IP address. For more information, see "[Checking if an IP address is permitted](#checking-if-an-ip-address-is-permitted)." \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/check-ip-address.md b/translations/ja-JP/data/reusables/identity-and-permissions/check-ip-address.md index 21bc6ff94a..7e0f3eab0d 100644 --- a/translations/ja-JP/data/reusables/identity-and-permissions/check-ip-address.md +++ b/translations/ja-JP/data/reusables/identity-and-permissions/check-ip-address.md @@ -1,11 +1,9 @@ --- -ms.openlocfilehash: 7b848e4c3bb4a9a4578e3f1ff92f6249dd20c699 -ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110 +ms.openlocfilehash: 18467aadad6c07acc5efc9080626cd5c1bec2a6d +ms.sourcegitcommit: c562c85cc75ffe1eb4e9595d8adc09ec71697ab1 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 10/25/2022 -ms.locfileid: "148109612" +ms.lasthandoff: 11/22/2022 +ms.locfileid: "148180006" --- -{%- ifversion ip-allow-list-address-check %} 1. 必要に応じて、特定の IP アドレスがリスト内のいずれかの有効なエントリによって許可されるかどうかを確認できます。 詳しくは、「[IP アドレスが許可されているかどうかを確認する](#checking-if-an-ip-address-is-permitted)」を参照してください。 -{%- endif %} diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/ip-allow-lists-enable.md b/translations/ja-JP/data/reusables/identity-and-permissions/ip-allow-lists-enable.md index 9024491a0e..6990c62b23 100644 --- a/translations/ja-JP/data/reusables/identity-and-permissions/ip-allow-lists-enable.md +++ b/translations/ja-JP/data/reusables/identity-and-permissions/ip-allow-lists-enable.md @@ -1,11 +1,3 @@ ---- -ms.openlocfilehash: abbbdeeb76eb7a1312105eb1319c808514893c30 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147682797" ---- -IP 許可リストを適用するには、まず IP アドレスをリストに追加し、次に IP 許可リストを有効にする必要があります。{% ifversion ip-allow-list-address-check %} リストが完成したら、特定の IP アドレスがリスト内のいずれかの有効なエントリによって許可されるかどうかを確認できます。{% endif %} +To enforce the IP allow list, you must first add IP addresses to the list, then enable the IP allow list. After you complete your list, you can check whether a particular IP address would be allowed by any of the enabled entries in the list. -IP 許可リストを有効にするには、現在の IP アドレスまたは一致する範囲を追加する必要があります。 +You must add your current IP address, or a matching range, before you enable the IP allow list. diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md b/translations/ja-JP/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md index 823f539e9d..1b0ced7720 100644 --- a/translations/ja-JP/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md +++ b/translations/ja-JP/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md @@ -1,22 +1,16 @@ ---- -ms.openlocfilehash: 130c705dad9367dbecb144ac281e8e58fa6d6cb7 -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147880373" ---- -許可リストを使っているなら、Enterpriseにインストールした{% data variables.product.prodname_github_apps %}に設定されたIPアドレスを自動的に許可リストに追加するかも選択できます。 +If you're using an allow list, you can also choose to automatically add to your allow list any IP addresses configured for {% data variables.product.prodname_github_apps %} that are installed in your enterprise. {% data reusables.identity-and-permissions.ip-allow-lists-address-inheritance %} {% data reusables.apps.ip-allow-list-only-apps %} -作成した {% data variables.product.prodname_github_app %} の許可リストを作成する方法の詳細については、「[GitHub App に対する許可 IP アドレスを管理する](/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app)」を参照してください。 +For more information about how to create an allow list for a {% data variables.product.prodname_github_app %} you have created, see "[Managing allowed IP addresses for a GitHub App](/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app)." -{% data variables.product.prodname_github_apps %}のIPアドレスの自動追加を有効化するには: +To enable automatic addition of IP addresses for {% data variables.product.prodname_github_apps %}: -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %} -1. [IP 許可リスト] で、 **[インストール済みの GitHub App の IP 許可リストの構成を有効にする]** を選択します。 - ![GitHub App IP アドレスを許可するチェックボックス](/assets/images/help/security/enable-ip-allowlist-githubapps-checkbox.png) -1. **[保存]** をクリックします。 +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.security-tab %} +1. Select **Enable IP allow list configuration for installed GitHub Apps**. If you are using {% data variables.product.prodname_emus %} with OIDC, first select **GitHub** as your IP allow list configuration, then select **Enable IP allow list configuration for installed GitHub Apps**. + ![Checkbox to allow GitHub App IP addresses](/assets/images/help/security/enable-ip-allowlist-githubapps-checkbox.png) +1. Click **Save**. diff --git a/translations/ja-JP/data/reusables/organizations/org-ownership-recommendation.md b/translations/ja-JP/data/reusables/organizations/org-ownership-recommendation.md index c32c81d245..1b685f3573 100644 --- a/translations/ja-JP/data/reusables/organizations/org-ownership-recommendation.md +++ b/translations/ja-JP/data/reusables/organizations/org-ownership-recommendation.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: 0a42d7b90fd6973a0d52e7cff8dfc3082de11135 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 64c92d2427b9be166d820bf3fcb23d39d449a295 +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145122550" +ms.lasthandoff: 11/14/2022 +ms.locfileid: "148163474" --- -一人のOrganizationオーナーによってメンテナンスされ、管理されているプロジェクトは、そのOrganizationオーナーが不在になると、簡単にアクセスできなくなってしまいます。 Organization には、*オーナー* 権限を持つ人を少なくとも 2 人置き、確実にプロジェクトへのアクセスが失われないようにすることをお勧めします。 +組織に所有者が 1 人しかない場合、その所有者に連絡できないと、その組織のプロジェクトにアクセスできなくなるおそれがあります。 誰もプロジェクトにアクセスできなくなることがないようにするには、各組織内の少なくとも 2 人が所有者ロールを持つようにすることをお勧めします。 diff --git a/translations/ja-JP/data/reusables/projects/projects-filters.md b/translations/ja-JP/data/reusables/projects/projects-filters.md index 0fa8f3b743..6cd4013a9d 100644 --- a/translations/ja-JP/data/reusables/projects/projects-filters.md +++ b/translations/ja-JP/data/reusables/projects/projects-filters.md @@ -1,10 +1,18 @@ -- To filter for any match of multiple values (an OR query), separate the values with a comma. For example `label:"good first issue",bug` will list all issues labelled `good first issue` or `bug`. -- To filter for the absence of a specific value, place `-` before your filter. For example, `-label:"bug"` will only show items that do not have the label `bug`. -- To filter for the absence of all values, enter `no:` followed by the field name. For example, `no:assignee` will only show items that do not have an assignee. -- To filter by state, enter `is:`. For example, `is: issue` or `is:open`. -- Separate multiple filters with a space. For example, `status:"In progress" -label:"bug" no:assignee` will show only items that have a status of `In progress`, do not have the label `bug`, and do not have an assignee. -- To filter for the previous, current, or next iteration of an iteration field, use `@previous`, `@current`, or `@next`. For example, `iteration:@current`. -- To filter for items assigned to the viewer, use `@me`. For example, `assignee:@me`. Anyone using this view will see items assigned to themselves. -- To filter by when an item was last updated, use `last-updated:` followed by the number of days. This filter only supports `{number}days` (or `1day` for a single day) as a unit. For example, `last-updated:7days` will only show items that were last updated 7 or more days ago. -- To filter date and number fields, use `>`, `>=`, `<`, `<=`, and `..` range queries. For example: `target:2022-03-01..2022-03-15`. For more information, see "[Understanding the search syntax](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax)." {% ifversion projects-v2-tasklists %} -- To filter for issues tracked by a specified issue, use `tracked-by:"/#"` and replace `` with the repository owner, `` with the repository name, and `` with the issue number. {% endif %} +--- +ms.openlocfilehash: 9106c4a2e538e62d23cd0aa2e417758376f6ffcd +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148158854" +--- +- 複数の値 (OR クエリ) の一致をフィルター処理するには、値をコンマで区切ります。 たとえば、`label:"good first issue",bug` は、`good first issue` または `bug` とラベル付けされたすべての Issue を一覧表示します。 +- 特定の値がない場合にフィルター処理するには、フィルターの前に `-` を配置します。 たとえば、`-label:"bug"` は、`bug` のラベルがない項目のみを表示します。 +- すべての値がない場合にフィルター処理するには、`no:` の後にフィールド名を入力します。 たとえば、`no:assignee` は、担当者がいない項目のみを表示します。 +- 状態でフィルター処理するには、「`is:`」と入力します。 たとえば、`is: issue` または `is:open` です。 +- 複数のフィルタは空白で区切ってください。 たとえば、`status:"In progress" -label:"bug" no:assignee` は、状態が `In progress` で、`bug` のラベルがなく、担当者がいない項目のみを表示します。 +- 繰り返しフィールドの前、現在、または次の繰り返しをフィルター処理するには、`@previous`、`@current`、`@next` のいずれかを使用します。 たとえば、`iteration:@current` のようにします。 +- ビューアーに割り当てられている項目をフィルター処理するには、`@me` を使用します。 たとえば、`assignee:@me` のようにします。 このビューを使用しているユーザーには、自分に割り当てられた項目が表示されます。 +- 項目の最終更新日別にフィルタリングするには、`last-updated:` を使用し、それに日数を指定します。 このフィルターではユニットとしてのみ `{number}days` がサポートされます (あるいは、1 日の場合は `1day`)。 たとえば、`last-updated:7days` の場合、7 日以上前に最終更新された項目のみが表示されます。 +- 日付と数値のフィールドをフィルター処理するには、`>`、`>=`、`<`、`<=`、`..` の範囲クエリを使用します。 (例: `target:2022-03-01..2022-03-15`)。 詳細については、「[Understanding the search syntax](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax)」 (検索構文の理解) を参照してください。 {% ifversion projects-v2-tasklists %} +- 指定の issue によって追跡される issue に対してフィルタリングするには、`tracked-by:"/#"` を使用し、`` をリポジトリ所有者に、`` をリポジトリ名に、`` を issue 番号に置換します。 {% endif %} diff --git a/translations/ja-JP/data/reusables/projects/tasklists-release-stage.md b/translations/ja-JP/data/reusables/projects/tasklists-release-stage.md new file mode 100644 index 0000000000..88d151e3da --- /dev/null +++ b/translations/ja-JP/data/reusables/projects/tasklists-release-stage.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: 989d63ee95229407cd3c3b05f5cfb41bd9038aee +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159960" +--- +{% note %} + +**メモ:** プロジェクトのタスクリストと追跡とフィールド別の追跡は現在、プライベート ベータ版であり、変更される場合があります。 タスクリストを試したり、新しいフィールドを使ってみたりすることに興味がある場合は、[順番待ちリスト](https://aka.ms/tasklist-roadmap-signup)に参加できます。 + +{% endnote %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/repositories/sidebar-advisories.md b/translations/ja-JP/data/reusables/repositories/sidebar-advisories.md index 13364a2ed0..bc9ed15db2 100644 --- a/translations/ja-JP/data/reusables/repositories/sidebar-advisories.md +++ b/translations/ja-JP/data/reusables/repositories/sidebar-advisories.md @@ -1,10 +1,10 @@ --- -ms.openlocfilehash: 309963c78d20d0ae2bb067deed484e5eb45dc43c -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 +ms.openlocfilehash: b598a0f5e8e2d131e5381f0f867518de344084c9 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147879103" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159975" --- -1. サイドバーで、 **[セキュリティ アドバイザリ]** をクリックします。 +1. 左側のサイドバーの [レポート] で、 **[アドバイザリ]** をクリックします。 ![[セキュリティ アドバイザリ] タブ](/assets/images/help/security/advisories-tab.png) diff --git a/translations/ja-JP/data/reusables/repositories/sidebar-security.md b/translations/ja-JP/data/reusables/repositories/sidebar-security.md index 83073c58de..38b529eae2 100644 --- a/translations/ja-JP/data/reusables/repositories/sidebar-security.md +++ b/translations/ja-JP/data/reusables/repositories/sidebar-security.md @@ -1,10 +1,10 @@ --- -ms.openlocfilehash: 8a30be469d4a74efc97849e83e825f619c585036 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d +ms.openlocfilehash: 88f9918556730cd1d87c09c72a032d15a149d220 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "145087720" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159951" --- -1. リポジトリ名の下にある **{% octicon "shield" aria-label="The shield symbol" %} [Security]\(セキュリティ\)** をクリックします。 +1. リポジトリ名の下にある **[{% octicon "shield" aria-label="The shield symbol" %} セキュリティ]** をクリックします。 ![[セキュリティ] タブ](/assets/images/help/repository/security-tab.png) diff --git a/translations/ja-JP/data/reusables/saml/assert-the-administrator-attribute.md b/translations/ja-JP/data/reusables/saml/assert-the-administrator-attribute.md index 83ab9ba0ca..26fdd0ba86 100644 --- a/translations/ja-JP/data/reusables/saml/assert-the-administrator-attribute.md +++ b/translations/ja-JP/data/reusables/saml/assert-the-administrator-attribute.md @@ -1,9 +1,9 @@ --- -ms.openlocfilehash: bb28859183eee48b1c16f8e309ec2d3f839d2e4e -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a +ms.openlocfilehash: e26318e1b0d86ee5ec0c486ccaba4f7dbb8e2ed9 +ms.sourcegitcommit: ced661bdffebd0f96f6f76db109fbe31983448ba ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/11/2022 -ms.locfileid: "145137683" +ms.lasthandoff: 11/16/2022 +ms.locfileid: "148167075" --- -人をEnterpriseのオーナーにするには、所有権をIdPで委任しなければなりません。 IdP のユーザー アカウントに対して、SAML アサーションの `administrator` 属性を、値を `true` にして含めます。 Enterprise 所有者の詳細については、「[Enterprise におけるロール](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)」を参照してください。 +ある人をエンタープライズ所有者にするには、IdP からアクセスを委任する必要があります。 Azure AD と SCIM を使用する場合は、エンタープライズ所有者ロールをユーザーに割り当てます。 他の IdP の場合、IdP のユーザー アカウントに対して、SAML アサーションの `administrator` 属性を、`true` の値を指定して含めます。 Enterprise 所有者の詳細については、「[Enterprise におけるロール](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)」を参照してください。 Azure AD を使用した認証とプロビジョニングの詳細については、「[Azure AD を使用したエンタープライズの認証とプロビジョニングの構成](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/search/classic-search-code-search-note.md b/translations/ja-JP/data/reusables/search/classic-search-code-search-note.md new file mode 100644 index 0000000000..b5174d49c3 --- /dev/null +++ b/translations/ja-JP/data/reusables/search/classic-search-code-search-note.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 838274ec284192127269b9f56d68452cf2962133 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159792" +--- +この記事では、従来の GitHub 検索エクスペリエンスについて説明します。 新しいコード検索とコード ビューのベータ版に参加しており、新しい機能を有効にしている場合、検索コードと GitHub.com 検索インターフェイスの構文は異なります。 ただし、コード以外の検索の種類での検索構文は、同じままです。 + +現在は限定パブリック ベータの新しいコード検索とコード ビューについて詳しくは、「[GitHub Code Search (ベータ版) について](/search-github/github-code-search/about-github-code-search)」をご覧ください。 新しいコード検索とコード ビューのベータ版を試すには、[順番待ちリスト](https://github.com/features/code-search-code-view/signup)に参加してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/search/code-search-code-view-beta-note.md b/translations/ja-JP/data/reusables/search/code-search-code-view-beta-note.md new file mode 100644 index 0000000000..e91fb0790d --- /dev/null +++ b/translations/ja-JP/data/reusables/search/code-search-code-view-beta-note.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 92a49c10ee87f1b8b076946d8b638144d7f24c5f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160016" +--- +新しいコード検索とコード ビューは、限定パブリック ベータです。 アクセスの順番待ちリストに参加するには、 https://github.com/features/code-search-code-view/signup をご覧ください。 diff --git a/translations/ja-JP/data/reusables/search/code-search-link.md b/translations/ja-JP/data/reusables/search/code-search-link.md new file mode 100644 index 0000000000..2c6700f29c --- /dev/null +++ b/translations/ja-JP/data/reusables/search/code-search-link.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 47117b97072b09f605c68d17be3a5fc350053862 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160115" +--- +新しいコード検索の詳細については、「[GitHub Code Search (ベータ版) について](/search-github/github-code-search/about-github-code-search)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/search/code-view-link.md b/translations/ja-JP/data/reusables/search/code-view-link.md new file mode 100644 index 0000000000..b534da8794 --- /dev/null +++ b/translations/ja-JP/data/reusables/search/code-view-link.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: fc1fa9b6a29ae3e58d822d9379ba004a0196b054 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160121" +--- +新しいコード ビューの詳細については、「[新しいコード ビュー (ベータ版) を使用したファイルの移動](/repositories/working-with-files/managing-files/navigating-files-with-the-new-code-view)」を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/search/enabling-and-disabling-code-search-and-view-beta.md b/translations/ja-JP/data/reusables/search/enabling-and-disabling-code-search-and-view-beta.md new file mode 100644 index 0000000000..7d03243e7d --- /dev/null +++ b/translations/ja-JP/data/reusables/search/enabling-and-disabling-code-search-and-view-beta.md @@ -0,0 +1,14 @@ +--- +ms.openlocfilehash: 56c01942ad1ac3496b9875a039a091676e3fc51e +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160126" +--- +ベータ版への参加の順番待ちリストから承諾されると、メールが届きます。 アクセス権が付与されると、アカウントで新しいコード検索とコード ビューのベータ版が自動的に有効になります。 + +{% data variables.product.prodname_dotcom_the_website %} のベータ版はいつでも無効または有効にすることができます。 この設定は、コード検索とコード ビューの両方に適用されることに注意してください。 + +{% data reusables.feature-preview.feature-preview-setting %} +1. [新しい Code Search とコード ビュー (ベータ版)] の右側にある **[有効]** または **[無効]** をクリックします。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/search/non-code-search-explanation.md b/translations/ja-JP/data/reusables/search/non-code-search-explanation.md new file mode 100644 index 0000000000..11ed6a56e8 --- /dev/null +++ b/translations/ja-JP/data/reusables/search/non-code-search-explanation.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: c1ebccb91c4ab8257429c582ab6c42e6583f823b +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160162" +--- +issue、ユーザー、ディスカッションなど、コード以外のコンテンツを検索するための構文と修飾子は、以前と同じように機能することにご注意ください。 コード以外の検索について詳しくは、「[GitHub での検索について](/search-github/getting-started-with-searching-on-github/about-searching-on-github)」および「[GitHub での検索](/search-github/searching-on-github)」をご覧ください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-beta.md b/translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-beta.md new file mode 100644 index 0000000000..2c5525c792 --- /dev/null +++ b/translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-beta.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: 3a6ce7caed12668a49728186aa2d3911d4f90668 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159799" +--- +{% note %} + +**メモ:** 脆弱性のプライベート レポートは現在、ベータ版であり、変更される場合があります。 + +{% endnote %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-enable.md b/translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-enable.md new file mode 100644 index 0000000000..50ab21690e --- /dev/null +++ b/translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-enable.md @@ -0,0 +1,10 @@ +--- +ms.openlocfilehash: e4d1f38bc3b4f5c0ac9efbe78084116696d2ee34 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159808" +--- +パブリック リポジトリの所有者と管理者は、リポジトリでプライベート脆弱性レポートを有効にすることができます。 詳しくは、「[リポジトリのプライベート脆弱性レポートの構成](/code-security/security-advisories/repository-security-advisories/configuring-private-vulnerability-reporting-for-a-repository)」をご覧ください。 + diff --git a/translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-overview.md b/translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-overview.md new file mode 100644 index 0000000000..617156bc73 --- /dev/null +++ b/translations/ja-JP/data/reusables/security-advisory/private-vulnerability-reporting-overview.md @@ -0,0 +1,11 @@ +--- +ms.openlocfilehash: 76133fe9416c92282de821d12e88432cdc1b5452 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159832" +--- +プライベート脆弱性レポートを使うと、セキュリティ研究者は簡単なフォームを使って脆弱性を直接報告できます。 + +セキュリティ研究者によって脆弱性が非公開で報告されると、通知を受け取って、承諾するか、さらに質問するか、拒否するかを選ぶことができます。 レポートを承諾した場合は、セキュリティ研究者と非公開で脆弱性の修正を共同で行う準備が整います。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md b/translations/ja-JP/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md index 374ae4e632..163f9f3035 100644 --- a/translations/ja-JP/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md +++ b/translations/ja-JP/data/reusables/security-advisory/security-researcher-cannot-create-advisory.md @@ -1,13 +1,13 @@ --- -ms.openlocfilehash: 842c9e724fedf0f6758935c2081916f3b7cfe35d -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 +ms.openlocfilehash: 7d82a865735b8fa7966b15d72c0710224ceead3f +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 ms.translationtype: HT ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "145139387" +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148160187" --- {% note %} -**注:** セキュリティ研究者の場合は、保守担当者に直接連絡して、自分が管理していないリポジトリで自分に代わってセキュリティ アドバイザリを作成または CVE を発行するように依頼する必要があります。 +**注:** セキュリティ研究者の場合は、保守担当者に直接連絡して、自分が管理していないリポジトリで自分に代わってセキュリティ アドバイザリを作成または CVE を発行するように依頼する必要があります。 しかし、リポジトリに対してプライベート脆弱性レポートが有効になっている場合は、脆弱性を自分で "プライベートで" 報告できます。 詳しくは、「[セキュリティの脆弱性をプライベートで報告する](/code-security/security-advisories/guidance-on-reporting-and-writing/privately-reporting-a-security-vulnerability)」をご覧ください。 -{% endnote %} +{% endnote %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/security-overview/about-the-security-overview.md b/translations/ja-JP/data/reusables/security-overview/about-the-security-overview.md new file mode 100644 index 0000000000..f250875d22 --- /dev/null +++ b/translations/ja-JP/data/reusables/security-overview/about-the-security-overview.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: 3cb6c82081c33d45d039fef92162f4061287f14e +ms.sourcegitcommit: c2aa10a61db44ee111c09565b6114dd5c97b6e2e +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/14/2022 +ms.locfileid: "148163466" +--- +セキュリティの概要には、組織またはエンタープライズのセキュリティ状態の大まかな概要が表示され、介入を必要とする問題のあるリポジトリを簡単に特定できます。 また、セキュリティの概要を使って特定のセキュリティ機能を有効にしているリポジトリを確認したり、現在使われていない使用可能なセキュリティ機能を構成したりすることもできます。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/security-overview/beta-org-risk-coverage.md b/translations/ja-JP/data/reusables/security-overview/beta-org-risk-coverage.md new file mode 100644 index 0000000000..a02487706b --- /dev/null +++ b/translations/ja-JP/data/reusables/security-overview/beta-org-risk-coverage.md @@ -0,0 +1,13 @@ +--- +ms.openlocfilehash: a6449876cc0f409f9c5d6ea4f72268299fea9818 +ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/09/2022 +ms.locfileid: "148159944" +--- +{% ifversion security-overview-org-risk-coverage %} {% note %} + +**メモ:** [セキュリティ リスク] ビューと [セキュリティの対象範囲] ビューは現在、ベータ版であり、変更される場合があります。 + +{% endnote %} {% endif %} diff --git a/translations/ja-JP/data/reusables/user-settings/sessions.md b/translations/ja-JP/data/reusables/user-settings/sessions.md new file mode 100644 index 0000000000..22e59ad3e8 --- /dev/null +++ b/translations/ja-JP/data/reusables/user-settings/sessions.md @@ -0,0 +1,9 @@ +--- +ms.openlocfilehash: bd35cf7047bb22a5c41ba794a5fb02317f9f705f +ms.sourcegitcommit: b2e5d14036a700b781e91158a552f8c0b1f04839 +ms.translationtype: HT +ms.contentlocale: ja-JP +ms.lasthandoff: 11/15/2022 +ms.locfileid: "148165582" +--- +1. サイドバーの [アクセス] セクションで、 **[{% octicon "broadcast" aria-label="The broadcast icon" %} セッション]** をクリックします。 \ No newline at end of file diff --git a/translations/log/msft-ja-resets.csv b/translations/log/msft-ja-resets.csv index fccbbdf4ec..54f3a51184 100644 --- a/translations/log/msft-ja-resets.csv +++ b/translations/log/msft-ja-resets.csv @@ -53,6 +53,7 @@ translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-pers translations/ja-JP/content/actions/automating-builds-and-tests/building-and-testing-nodejs-or-python.md,file deleted because it no longer exists in main translations/ja-JP/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/deploying-github-advanced-security-in-your-enterprise.md,file deleted because it no longer exists in main translations/ja-JP/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/overview-of-github-advanced-security-deployment.md,file deleted because it no longer exists in main +translations/ja-JP/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md,file deleted because it no longer exists in main translations/ja-JP/content/admin/configuration/configuring-your-enterprise/troubleshooting-ssl-errors.md,file deleted because it no longer exists in main translations/ja-JP/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-gateway-for-nas-storage.md,file deleted because it no longer exists in main translations/ja-JP/content/admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/allowing-built-in-authentication-for-users-outside-your-identity-provider.md,file deleted because it no longer exists in main @@ -239,6 +240,7 @@ translations/ja-JP/content/rest/reference/users.md,file deleted because it no lo translations/ja-JP/content/rest/reference/webhooks.md,file deleted because it no longer exists in main translations/ja-JP/content/site-policy/privacy-policies/github-data-protection-agreement.md,file deleted because it no longer exists in main translations/ja-JP/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-user-account.md,file deleted because it no longer exists in main +translations/ja-JP/data/features/ip-allow-list-address-check.yml,file deleted because it no longer exists in main translations/ja-JP/data/features/security-overview-views.yml,file deleted because it no longer exists in main translations/ja-JP/data/glossaries/internal.yml,file deleted because it no longer exists in main translations/ja-JP/data/graphql/ghes-3.1/graphql_previews.enterprise.yml,file deleted because it no longer exists in main @@ -399,6 +401,7 @@ translations/ja-JP/data/reusables/dotcom_billing/monthly-spending-limit-codespac translations/ja-JP/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/education/upgrade-organization.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/education/upgrade-page.md,file deleted because it no longer exists in main +translations/ja-JP/data/reusables/enterprise-accounts/oidc-beta-notice.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/enterprise-accounts/repository-visibility-policy.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/enterprise-licensing/you-can-sync-for-a-combined-view.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/enterprise_management_console/username_normalization.md,file deleted because it no longer exists in main @@ -507,10 +510,10 @@ translations/ja-JP/content/actions/learn-github-actions/finding-and-customizing- translations/ja-JP/content/actions/learn-github-actions/understanding-github-actions.md,rendering error translations/ja-JP/content/actions/learn-github-actions/usage-limits-billing-and-administration.md,rendering error translations/ja-JP/content/actions/managing-issues-and-pull-requests/moving-assigned-issues-on-project-boards.md,broken liquid tags -translations/ja-JP/content/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks.md,broken liquid tags translations/ja-JP/content/actions/managing-workflow-runs/disabling-and-enabling-a-workflow.md,rendering error translations/ja-JP/content/actions/managing-workflow-runs/manually-running-a-workflow.md,rendering error translations/ja-JP/content/actions/managing-workflow-runs/re-running-workflows-and-jobs.md,rendering error +translations/ja-JP/content/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer.md,rendering error translations/ja-JP/content/actions/monitoring-and-troubleshooting-workflows/viewing-job-execution-time.md,rendering error translations/ja-JP/content/actions/publishing-packages/publishing-docker-images.md,rendering error translations/ja-JP/content/actions/publishing-packages/publishing-nodejs-packages.md,broken liquid tags @@ -521,7 +524,6 @@ translations/ja-JP/content/actions/security-guides/security-hardening-for-github translations/ja-JP/content/actions/using-github-hosted-runners/controlling-access-to-larger-runners.md,rendering error translations/ja-JP/content/actions/using-github-hosted-runners/using-larger-runners.md,rendering error translations/ja-JP/content/actions/using-workflows/about-workflows.md,rendering error -translations/ja-JP/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md,broken liquid tags translations/ja-JP/content/actions/using-workflows/creating-starter-workflows-for-your-organization.md,rendering error translations/ja-JP/content/actions/using-workflows/events-that-trigger-workflows.md,rendering error translations/ja-JP/content/actions/using-workflows/reusing-workflows.md,rendering error @@ -558,7 +560,6 @@ translations/ja-JP/content/admin/configuration/configuring-your-enterprise/confi translations/ja-JP/content/admin/configuration/configuring-your-enterprise/configuring-web-commit-signing.md,rendering error translations/ja-JP/content/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode.md,rendering error translations/ja-JP/content/admin/configuration/configuring-your-enterprise/enabling-private-mode.md,rendering error -translations/ja-JP/content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md,rendering error translations/ja-JP/content/admin/configuration/configuring-your-enterprise/managing-github-mobile-for-your-enterprise.md,rendering error translations/ja-JP/content/admin/configuration/configuring-your-enterprise/site-admin-dashboard.md,rendering error translations/ja-JP/content/admin/configuration/configuring-your-enterprise/troubleshooting-tls-errors.md,rendering error @@ -567,7 +568,6 @@ translations/ja-JP/content/admin/enterprise-management/caching-repositories/conf translations/ja-JP/content/admin/enterprise-management/caching-repositories/index.md,rendering error translations/ja-JP/content/admin/enterprise-management/configuring-clustering/cluster-network-configuration.md,broken liquid tags translations/ja-JP/content/admin/enterprise-management/configuring-clustering/configuring-high-availability-replication-for-a-cluster.md,broken liquid tags -translations/ja-JP/content/admin/enterprise-management/configuring-clustering/initializing-the-cluster.md,broken liquid tags translations/ja-JP/content/admin/enterprise-management/monitoring-your-appliance/accessing-the-monitor-dashboard.md,rendering error translations/ja-JP/content/admin/enterprise-management/monitoring-your-appliance/configuring-collectd.md,rendering error translations/ja-JP/content/admin/enterprise-management/monitoring-your-appliance/generating-a-health-check-for-your-enterprise.md,rendering error @@ -580,15 +580,14 @@ translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-mach translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md,rendering error translations/ja-JP/content/admin/github-actions/advanced-configuration-and-troubleshooting/troubleshooting-github-actions-for-your-enterprise.md,rendering error translations/ja-JP/content/admin/github-actions/advanced-configuration-and-troubleshooting/using-a-staging-environment.md,rendering error +translations/ja-JP/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md,rendering error translations/ja-JP/content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates.md,rendering error translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises.md,rendering error translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md,rendering error translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md,rendering error translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md,rendering error -translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md,broken liquid tags translations/ja-JP/content/admin/github-actions/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise.md,rendering error translations/ja-JP/content/admin/identity-and-access-management/index.md,broken liquid tags -translations/ja-JP/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise.md,broken liquid tags translations/ja-JP/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/changing-authentication-methods.md,rendering error translations/ja-JP/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/index.md,broken liquid tags translations/ja-JP/content/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication.md,rendering error @@ -598,6 +597,7 @@ translations/ja-JP/content/admin/identity-and-access-management/using-built-in-a translations/ja-JP/content/admin/identity-and-access-management/using-built-in-authentication/inviting-people-to-use-your-instance.md,rendering error translations/ja-JP/content/admin/identity-and-access-management/using-cas-for-enterprise-iam/index.md,rendering error translations/ja-JP/content/admin/identity-and-access-management/using-cas-for-enterprise-iam/using-cas.md,rendering error +translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users.md,broken liquid tags translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-support-for-your-idps-conditional-access-policy.md,rendering error translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users.md,rendering error translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users.md,rendering error @@ -605,7 +605,6 @@ translations/ja-JP/content/admin/identity-and-access-management/using-enterprise translations/ja-JP/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md,rendering error translations/ja-JP/content/admin/identity-and-access-management/using-ldap-for-enterprise-iam/index.md,rendering error translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam.md,broken liquid tags -translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad.md,broken liquid tags translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise.md,broken liquid tags translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise.md,rendering error translations/ja-JP/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/enabling-encrypted-assertions.md,rendering error @@ -635,7 +634,6 @@ translations/ja-JP/content/admin/packages/enabling-github-packages-with-azure-bl translations/ja-JP/content/admin/packages/enabling-github-packages-with-minio.md,rendering error translations/ja-JP/content/admin/packages/getting-started-with-github-packages-for-your-enterprise.md,rendering error translations/ja-JP/content/admin/packages/migrating-your-enterprise-to-the-container-registry-from-the-docker-registry.md,rendering error -translations/ja-JP/content/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages.md,rendering error translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/about-enterprise-policies.md,broken liquid tags translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md,rendering error translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md,rendering error @@ -676,6 +674,7 @@ translations/ja-JP/content/authentication/managing-commit-signature-verification translations/ja-JP/content/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account.md,rendering error translations/ja-JP/content/authentication/managing-commit-signature-verification/associating-an-email-with-your-gpg-key.md,rendering error translations/ja-JP/content/authentication/managing-commit-signature-verification/displaying-verification-statuses-for-all-of-your-commits.md,rendering error +translations/ja-JP/content/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key.md,broken liquid tags translations/ja-JP/content/authentication/securing-your-account-with-two-factor-authentication-2fa/about-two-factor-authentication.md,rendering error translations/ja-JP/content/authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication.md,broken liquid tags translations/ja-JP/content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md,rendering error @@ -689,14 +688,12 @@ translations/ja-JP/content/billing/managing-billing-for-github-actions/about-bil translations/ja-JP/content/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security.md,broken liquid tags translations/ja-JP/content/billing/managing-billing-for-github-advanced-security/viewing-your-github-advanced-security-usage.md,rendering error translations/ja-JP/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md,rendering error -translations/ja-JP/content/billing/managing-billing-for-github-codespaces/index.md,broken liquid tags translations/ja-JP/content/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot.md,broken liquid tags translations/ja-JP/content/billing/managing-billing-for-github-copilot/managing-your-github-copilot-subscription.md,broken liquid tags translations/ja-JP/content/billing/managing-billing-for-github-packages/about-billing-for-github-packages.md,rendering error translations/ja-JP/content/billing/managing-billing-for-your-github-account/about-billing-for-your-enterprise.md,broken liquid tags translations/ja-JP/content/billing/managing-billing-for-your-github-account/about-per-user-pricing.md,rendering error translations/ja-JP/content/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise.md,broken liquid tags -translations/ja-JP/content/billing/managing-billing-for-your-github-account/downgrading-your-github-subscription.md,rendering error translations/ja-JP/content/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription.md,rendering error translations/ja-JP/content/billing/managing-billing-for-your-github-account/viewing-the-subscription-and-usage-for-your-enterprise-account.md,broken liquid tags translations/ja-JP/content/billing/managing-your-license-for-github-enterprise/about-licenses-for-github-enterprise.md,rendering error @@ -746,6 +743,7 @@ translations/ja-JP/content/code-security/secret-scanning/managing-alerts-from-se translations/ja-JP/content/code-security/secret-scanning/protecting-pushes-with-secret-scanning.md,rendering error translations/ja-JP/content/code-security/secret-scanning/pushing-a-branch-blocked-by-push-protection.md,rendering error translations/ja-JP/content/code-security/security-advisories/global-security-advisories/about-the-github-advisory-database.md,rendering error +translations/ja-JP/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md,rendering error translations/ja-JP/content/code-security/security-advisories/repository-security-advisories/configuring-private-vulnerability-reporting-for-a-repository.md,rendering error translations/ja-JP/content/code-security/security-overview/about-the-security-overview.md,rendering error translations/ja-JP/content/code-security/security-overview/filtering-alerts-in-the-security-overview.md,rendering error @@ -754,69 +752,26 @@ translations/ja-JP/content/code-security/supply-chain-security/end-to-end-supply translations/ja-JP/content/code-security/supply-chain-security/end-to-end-supply-chain/securing-code.md,rendering error translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review.md,rendering error translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph.md,rendering error -translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-dependency-review.md,broken liquid tags translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-the-dependency-graph.md,broken liquid tags -translations/ja-JP/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md,broken liquid tags translations/ja-JP/content/codespaces/codespaces-reference/security-in-github-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md,broken liquid tags translations/ja-JP/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md,broken liquid tags -translations/ja-JP/content/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md,broken liquid tags -translations/ja-JP/content/codespaces/customizing-your-codespace/renaming-a-codespace.md,broken liquid tags -translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/developing-in-codespaces/connecting-to-a-private-network.md,broken liquid tags -translations/ja-JP/content/codespaces/developing-in-codespaces/deleting-a-codespace.md,broken liquid tags -translations/ja-JP/content/codespaces/developing-in-codespaces/developing-in-a-codespace.md,broken liquid tags -translations/ja-JP/content/codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace.md,broken liquid tags -translations/ja-JP/content/codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning.md,broken liquid tags -translations/ja-JP/content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md,broken liquid tags -translations/ja-JP/content/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace.md,broken liquid tags -translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-for-pull-requests.md,broken liquid tags -translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md,rendering error -translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md,broken liquid tags -translations/ja-JP/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md,broken liquid tags -translations/ja-JP/content/codespaces/getting-started/deep-dive.md,broken liquid tags -translations/ja-JP/content/codespaces/getting-started/quickstart.md,broken liquid tags -translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md,broken liquid tags -translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/index.md,broken liquid tags -translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md,broken liquid tags -translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md,broken liquid tags +translations/ja-JP/content/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository.md,rendering error +translations/ja-JP/content/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template.md,rendering error +translations/ja-JP/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md,broken liquid tags translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md,rendering error translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces.md,rendering error translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md,rendering error translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces.md,rendering error translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports.md,rendering error -translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md,broken liquid tags translations/ja-JP/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md,rendering error -translations/ja-JP/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md,broken liquid tags translations/ja-JP/content/codespaces/prebuilding-your-codespaces/testing-dev-container-changes.md,broken liquid tags translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge.md,rendering error -translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers.md,broken liquid tags -translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines.md,broken liquid tags -translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces.md,broken liquid tags +translations/ja-JP/content/codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file.md,broken liquid tags translations/ja-JP/content/codespaces/the-githubdev-web-based-editor.md,rendering error -translations/ja-JP/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md,broken liquid tags -translations/ja-JP/content/codespaces/troubleshooting/github-codespaces-logs.md,broken liquid tags -translations/ja-JP/content/codespaces/troubleshooting/index.md,broken liquid tags -translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-prebuilds.md,broken liquid tags -translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md,broken liquid tags -translations/ja-JP/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md,broken liquid tags +translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-prebuilds.md,rendering error translations/ja-JP/content/communities/documenting-your-project-with-wikis/about-wikis.md,rendering error translations/ja-JP/content/communities/documenting-your-project-with-wikis/changing-access-permissions-for-wikis.md,rendering error translations/ja-JP/content/communities/documenting-your-project-with-wikis/editing-wiki-content.md,rendering error -translations/ja-JP/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization.md,broken liquid tags translations/ja-JP/content/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors.md,rendering error translations/ja-JP/content/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema.md,broken liquid tags translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md,broken liquid tags @@ -849,14 +804,12 @@ translations/ja-JP/content/discussions/guides/finding-your-discussions.md,render translations/ja-JP/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions.md,rendering error translations/ja-JP/content/discussions/managing-discussions-for-your-community/managing-discussions.md,rendering error translations/ja-JP/content/discussions/managing-discussions-for-your-community/moderating-discussions.md,rendering error -translations/ja-JP/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students.md,broken liquid tags -translations/ja-JP/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers.md,broken liquid tags translations/ja-JP/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/glossary.md,broken liquid tags translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/about-using-makecode-arcade-with-github-classroom.md,rendering error translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide.md,broken liquid tags -translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md,broken liquid tags translations/ja-JP/content/education/manage-coursework-with-github-classroom/learn-with-github-classroom/view-autograding-results.md,rendering error translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md,rendering error +translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment.md,broken liquid tags translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/manage-classrooms.md,broken liquid tags translations/ja-JP/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/use-the-git-and-github-starter-assignment.md,broken liquid tags translations/ja-JP/content/get-started/customizing-your-github-workflow/exploring-integrations/github-extensions-and-integrations.md,rendering error @@ -885,12 +838,10 @@ translations/ja-JP/content/get-started/quickstart/fork-a-repo.md,rendering error translations/ja-JP/content/get-started/quickstart/git-and-github-learning-resources.md,broken liquid tags translations/ja-JP/content/get-started/quickstart/github-glossary.md,broken liquid tags translations/ja-JP/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud.md,rendering error -translations/ja-JP/content/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-server.md,broken liquid tags translations/ja-JP/content/get-started/signing-up-for-github/signing-up-for-a-new-github-account.md,rendering error translations/ja-JP/content/get-started/signing-up-for-github/verifying-your-email-address.md,rendering error translations/ja-JP/content/get-started/using-git/about-git-rebase.md,rendering error translations/ja-JP/content/get-started/using-git/splitting-a-subfolder-out-into-a-new-repository.md,rendering error -translations/ja-JP/content/get-started/using-github/github-command-palette.md,rendering error translations/ja-JP/content/get-started/using-github/github-desktop.md,broken liquid tags translations/ja-JP/content/get-started/using-github/github-mobile.md,rendering error translations/ja-JP/content/get-started/using-github/keyboard-shortcuts.md,rendering error @@ -898,6 +849,7 @@ translations/ja-JP/content/get-started/using-github/troubleshooting-connectivity translations/ja-JP/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github.md,broken liquid tags translations/ja-JP/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md,rendering error translations/ja-JP/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github.md,rendering error +translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md,rendering error translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md,broken liquid tags translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions.md,rendering error translations/ja-JP/content/github-cli/github-cli/quickstart.md,rendering error @@ -915,13 +867,12 @@ translations/ja-JP/content/graphql/reference/unions.md,rendering error translations/ja-JP/content/issues/organizing-your-work-with-project-boards/managing-project-boards/changing-project-board-visibility.md,rendering error translations/ja-JP/content/issues/organizing-your-work-with-project-boards/managing-project-boards/copying-a-project-board.md,rendering error translations/ja-JP/content/issues/organizing-your-work-with-project-boards/managing-project-boards/creating-a-project-board.md,rendering error -translations/ja-JP/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md,broken liquid tags translations/ja-JP/content/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue.md,rendering error -translations/ja-JP/content/organizations/collaborating-with-groups-in-organizations/about-organizations.md,broken liquid tags translations/ja-JP/content/organizations/collaborating-with-groups-in-organizations/about-your-organizations-news-feed.md,rendering error translations/ja-JP/content/organizations/granting-access-to-your-organization-with-saml-single-sign-on/about-two-factor-authentication-and-saml-single-sign-on.md,rendering error translations/ja-JP/content/organizations/granting-access-to-your-organization-with-saml-single-sign-on/viewing-and-managing-a-members-saml-access-to-your-organization.md,rendering error translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/accessing-compliance-reports-for-your-organization.md,rendering error +translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md,broken liquid tags translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization.md,rendering error translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md,rendering error translations/ja-JP/content/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities.md,broken liquid tags @@ -973,7 +924,6 @@ translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/propos translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally.md,broken liquid tags translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request.md,rendering error translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md,rendering error -translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks.md,broken liquid tags translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork.md,rendering error translations/ja-JP/content/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/changing-a-commit-message.md,rendering error translations/ja-JP/content/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-on-behalf-of-an-organization.md,rendering error @@ -1000,7 +950,6 @@ translations/ja-JP/content/repositories/creating-and-managing-repositories/creat translations/ja-JP/content/repositories/creating-and-managing-repositories/restoring-a-deleted-repository.md,rendering error translations/ja-JP/content/repositories/creating-and-managing-repositories/transferring-a-repository.md,rendering error translations/ja-JP/content/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors.md,rendering error -translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md,broken liquid tags translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository.md,rendering error translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md,rendering error translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository.md,rendering error @@ -1014,7 +963,6 @@ translations/ja-JP/content/repositories/releasing-projects-on-github/managing-re translations/ja-JP/content/repositories/working-with-files/managing-files/adding-a-file-to-a-repository.md,rendering error translations/ja-JP/content/repositories/working-with-files/managing-large-files/about-large-files-on-github.md,rendering error translations/ja-JP/content/repositories/working-with-files/using-files/getting-permanent-links-to-files.md,rendering error -translations/ja-JP/content/repositories/working-with-files/using-files/navigating-code-on-github.md,broken liquid tags translations/ja-JP/content/rest/activity/notifications.md,broken liquid tags translations/ja-JP/content/rest/apps/oauth-applications.md,rendering error translations/ja-JP/content/rest/codespaces/codespaces.md,broken liquid tags @@ -1049,9 +997,7 @@ translations/ja-JP/content/rest/projects/projects.md,broken liquid tags translations/ja-JP/content/rest/quickstart.md,broken liquid tags translations/ja-JP/content/rest/scim.md,rendering error translations/ja-JP/content/rest/teams/team-sync.md,rendering error -translations/ja-JP/content/search-github/getting-started-with-searching-on-github/about-searching-on-github.md,rendering error translations/ja-JP/content/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment.md,rendering error -translations/ja-JP/content/search-github/searching-on-github/searching-code.md,broken liquid tags translations/ja-JP/content/search-github/searching-on-github/searching-for-repositories.md,rendering error translations/ja-JP/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-sponsorship-tiers.md,broken liquid tags translations/ja-JP/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-organization.md,rendering error @@ -1096,8 +1042,6 @@ translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md,b translations/ja-JP/data/reusables/actions/jobs/section-defining-outputs-for-jobs.md,broken liquid tags translations/ja-JP/data/reusables/actions/more-resources-for-ghes.md,rendering error translations/ja-JP/data/reusables/actions/moving-a-runner-to-a-group.md,rendering error -translations/ja-JP/data/reusables/actions/private-repository-forks-configure.md,broken liquid tags -translations/ja-JP/data/reusables/actions/private-repository-forks-options.md,broken liquid tags translations/ja-JP/data/reusables/actions/ref_name-description.md,broken liquid tags translations/ja-JP/data/reusables/actions/reusable-workflow-artifacts.md,rendering error translations/ja-JP/data/reusables/actions/reusable-workflow-calling-syntax.md,rendering error @@ -1114,6 +1058,7 @@ translations/ja-JP/data/reusables/actions/settings-ui/settings-actions-pages-cus translations/ja-JP/data/reusables/actions/settings-ui/settings-actions-runner-groups.md,rendering error translations/ja-JP/data/reusables/actions/settings-ui/settings-actions-runners.md,rendering error translations/ja-JP/data/reusables/actions/sidebar-secret.md,rendering error +translations/ja-JP/data/reusables/actions/supported-github-runners.md,broken liquid tags translations/ja-JP/data/reusables/actions/upgrade-runners-before-upgrade-ghes.md,rendering error translations/ja-JP/data/reusables/actions/workflow-basic-example-and-explanation.md,rendering error translations/ja-JP/data/reusables/actions/workflow-dispatch-inputs.md,rendering error @@ -1136,15 +1081,12 @@ translations/ja-JP/data/reusables/code-scanning/deprecation-codeql-runner.md,ren translations/ja-JP/data/reusables/code-scanning/enterprise-enable-code-scanning-actions.md,broken liquid tags translations/ja-JP/data/reusables/code-scanning/enterprise-enable-code-scanning.md,broken liquid tags translations/ja-JP/data/reusables/code-scanning/what-is-codeql-cli.md,rendering error -translations/ja-JP/data/reusables/codespaces/codespaces-disabling-org-billing.md,broken liquid tags translations/ja-JP/data/reusables/codespaces/codespaces-policy-targets.md,rendering error -translations/ja-JP/data/reusables/codespaces/codespaces-spending-limit-requirement.md,broken liquid tags -translations/ja-JP/data/reusables/codespaces/creating-a-codespace-in-vscode.md,rendering error translations/ja-JP/data/reusables/codespaces/customize-vcpus-and-ram.md,broken liquid tags translations/ja-JP/data/reusables/codespaces/next-steps-adding-devcontainer.md,broken liquid tags translations/ja-JP/data/reusables/codespaces/prebuilds-crossreference.md,broken liquid tags +translations/ja-JP/data/reusables/codespaces/rebuild-command.md,broken liquid tags translations/ja-JP/data/reusables/codespaces/secrets-on-start.md,broken liquid tags -translations/ja-JP/data/reusables/codespaces/use-chrome.md,broken liquid tags translations/ja-JP/data/reusables/command_line/provide-an-access-token.md,broken liquid tags translations/ja-JP/data/reusables/copilot/install-copilot-in-neovim.md,broken liquid tags translations/ja-JP/data/reusables/dependabot/beta-security-and-version-updates.md,rendering error @@ -1163,6 +1105,7 @@ translations/ja-JP/data/reusables/dotcom_billing/view-all-subscriptions.md,rende translations/ja-JP/data/reusables/enterprise-accounts/actions-packages-report-download-enterprise-accounts.md,broken liquid tags translations/ja-JP/data/reusables/enterprise-accounts/billing-microsoft-ea-overview.md,broken liquid tags translations/ja-JP/data/reusables/enterprise-accounts/dormant-user-activity.md,rendering error +translations/ja-JP/data/reusables/enterprise-accounts/emu-azure-admin-consent.md,broken liquid tags translations/ja-JP/data/reusables/enterprise-accounts/emu-cap-validates.md,broken liquid tags translations/ja-JP/data/reusables/enterprise-accounts/emu-forks.md,rendering error translations/ja-JP/data/reusables/enterprise-accounts/emu-permission-follow.md,broken liquid tags @@ -1205,6 +1148,11 @@ translations/ja-JP/data/reusables/getting-started/enterprise-advanced-security.m translations/ja-JP/data/reusables/getting-started/managing-enterprise-members.md,rendering error translations/ja-JP/data/reusables/git/git-push.md,rendering error translations/ja-JP/data/reusables/git/provide-credentials.md,rendering error +translations/ja-JP/data/reusables/identity-and-permissions/about-adding-ip-allow-list-entries.md,broken liquid tags +translations/ja-JP/data/reusables/identity-and-permissions/about-editing-ip-allow-list-entries.md,broken liquid tags +translations/ja-JP/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md,broken liquid tags +translations/ja-JP/data/reusables/identity-and-permissions/ip-allow-lists-enable.md,broken liquid tags +translations/ja-JP/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md,broken liquid tags translations/ja-JP/data/reusables/identity-and-permissions/vigilant-mode-beta-note.md,rendering error translations/ja-JP/data/reusables/large_files/storage_assets_location.md,broken liquid tags translations/ja-JP/data/reusables/large_files/use_lfs_tip.md,rendering error @@ -1231,7 +1179,6 @@ translations/ja-JP/data/reusables/pages/emu-org-only.md,broken liquid tags translations/ja-JP/data/reusables/pages/sidebar-pages.md,rendering error translations/ja-JP/data/reusables/projects/enable-basic-workflow.md,broken liquid tags translations/ja-JP/data/reusables/projects/graphql-ghes.md,rendering error -translations/ja-JP/data/reusables/projects/projects-filters.md,broken liquid tags translations/ja-JP/data/reusables/pull_requests/configure_pull_request_merges_intro.md,rendering error translations/ja-JP/data/reusables/pull_requests/default_merge_option.md,rendering error translations/ja-JP/data/reusables/pull_requests/pull_request_merges_and_contributions.md,rendering error
ランナー イメージYAML ワークフロー ラベルメモRunner imageYAML workflow labelNotes
-windows-latest または windows-2022 +windows-latest or windows-2022 -windows-latest ラベルは現在、Windows Server 2022 ランナー イメージを使用しています。 +The windows-latest label currently uses the Windows Server 2022 runner image.
-ubuntu-latest または ubuntu-20.04 +ubuntu-latest or ubuntu-20.04 +The ubuntu-latest label is currently transitioning to the Ubuntu 22.04 runner image. During the transition, the label might refer to the runner image for either Ubuntu 20.04 or 22.04. For more information, see this {% data variables.product.prodname_dotcom %} blog post. +
-Ubuntu 18.04 [非推奨] +Ubuntu 18.04 [deprecated] ubuntu-18.04 -ubuntu-20.04 または ubuntu-22.04 に移行。 詳しくは、こちらの GitHub のブログ記事をご覧ください。 +Migrate to ubuntu-20.04 or ubuntu-22.04. For more information, see this GitHub blog post.
-macos-latest または macos-11 +macos-latest or macos-11 -macos-latest ラベルは現在、macOS 11 ランナー イメージを使用しています。 +The macos-latest label is currently transitioning to the macOS Monterey 12 runner image. During the transition, the label might refer to the runner image for either macOS 11 or 12. For more information, see this {% data variables.product.prodname_dotcom %} blog post.
-macOS Catalina 10.15 [非推奨] +macOS Catalina 10.15 [deprecated] macos-10.15 -macOS-11 または macOS-12 に移行。 詳しくは、こちらの GitHub のブログ記事をご覧ください。 +Migrate to macOS-11 or macOS-12. For more information, see this GitHub blog post.