diff --git a/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance.md b/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance.md
index 0ee3befdd0..468b95f2c7 100644
--- a/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance.md
+++ b/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance.md
@@ -61,7 +61,7 @@ If you use {% data variables.product.prodname_codeql %} {% data variables.produc
{% ifversion ghes %}
If you want to use actions to run {% data variables.product.prodname_code_scanning %} on {% data variables.product.prodname_ghe_server %}, the actions must be available on your appliance.
-The {% data variables.product.prodname_codeql %} action is included in your installation of {% data variables.product.prodname_ghe_server %}. If {% data variables.product.prodname_ghe_server %} {{ allVersions[currentVersion].currentRelease }} has access to the internet, the action will automatically download the {% data variables.product.prodname_codeql %} {% data variables.product.codeql_cli_ghes_recommended_version %} bundle required to perform analysis. Alternatively, you can use a synchronization tool to make the latest released version of the {% data variables.product.prodname_codeql %} analysis bundle available locally. For more information, see "[Configuring {% data variables.product.prodname_codeql %} analysis on a server without internet access](#configuring-codeql-analysis-on-a-server-without-internet-access)" below.
+The {% data variables.product.prodname_codeql %} action is included in your installation of {% data variables.product.prodname_ghe_server %}. If both {% data variables.product.prodname_ghe_server %} {{ allVersions[currentVersion].currentRelease }} and your {% data variables.product.prodname_actions %} runner have access to the internet, the action will automatically download the {% data variables.product.prodname_codeql %} {% data variables.product.codeql_cli_ghes_recommended_version %} bundle required to perform analysis. Alternatively, you can use a synchronization tool to make the latest released version of the {% data variables.product.prodname_codeql %} analysis bundle available locally. For more information, see "[Configuring {% data variables.product.prodname_codeql %} analysis on a server without internet access](#configuring-codeql-analysis-on-a-server-without-internet-access)" below.
You can also make third-party actions available to users for {% data variables.product.prodname_code_scanning %}, by setting up {% data variables.product.prodname_github_connect %}. For more information, see "[Configuring {% data variables.product.prodname_github_connect %} to sync {% data variables.product.prodname_actions %}](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance#configuring-github-connect-to-sync-github-actions)" below.
diff --git a/content/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security.md b/content/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security.md
index 6ce5b9d665..972856f9bb 100644
--- a/content/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security.md
+++ b/content/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security.md
@@ -41,6 +41,10 @@ You can make extra features for code security available to users by buying and u
{% data reusables.advanced-security.license-overview %}
+{% ifversion ghes %}
+You can determine how many licenses you'll need for {% data variables.product.prodname_GH_advanced_security %} by generating a count of your instance's active committers in the site admin dashboard. For more information, see "[Site admin dashboard](/admin/configuration/configuring-your-enterprise/site-admin-dashboard#advanced-security-committers)."
+{% endif %}
+
To discuss licensing {% data variables.product.prodname_GH_advanced_security %} for your enterprise, contact {% data variables.contact.contact_enterprise_sales %}.
## About committer numbers for {% data variables.product.prodname_GH_advanced_security %}
diff --git a/content/billing/managing-billing-for-your-github-account/about-per-user-pricing.md b/content/billing/managing-billing-for-your-github-account/about-per-user-pricing.md
index 3f39770dc7..0253200ccb 100644
--- a/content/billing/managing-billing-for-your-github-account/about-per-user-pricing.md
+++ b/content/billing/managing-billing-for-your-github-account/about-per-user-pricing.md
@@ -20,6 +20,7 @@ topics:
## About per-user pricing
{% ifversion fpt %}
+
New organizations on {% data variables.product.prodname_dotcom_the_website %} can build public and open-source projects with {% data variables.product.prodname_free_team %}, or upgrade to a paid product with per-user pricing. For more information, see "[{% data variables.product.company_short %}'s products](/get-started/learning-about-github/githubs-products)" and "[Upgrading your {% data variables.product.prodname_dotcom %} subscription](/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription)."
Organizations using a paid subscription before May 11, 2016 can choose to stay on their existing per-repository plan or switch to per-user pricing. {% data variables.product.company_short %} will notify you twelve months before any mandated change to your subscription. For more information on switching your subscription, see "[Upgrading your {% data variables.product.prodname_dotcom %} subscription](/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription)."
@@ -37,48 +38,70 @@ In addition to licensed seats, your bill may include other charges, such as {% d
## People that consume a license
-Each person consumes one license, and {% data variables.product.company_short %} identifies individuals by primary email address.
+{% ifversion fpt %}
-{% data variables.product.company_short %} bills for the following people.
+{% data variables.product.company_short %} bills for the following people:
-{%- ifversion ghec %}
-- Enterprise owners who are a member or owner of at least one organization in the enterprise
-{%- endif %}
- Organization members, including owners
-- Outside collaborators on private{% ifversion ghec %} or internal{% endif %} repositories owned by your organization, excluding forks
-- Anyone with a pending invitation to become an organization owner or member
-- Anyone with a pending invitation to become an outside collaborator on private{% ifversion ghec %} or internal{% endif %} repositories owned by your organization, excluding forks
-{%- ifversion ghec %}
-- Each user on any {% data variables.product.prodname_ghe_server %} instance that you deploy
-{%- endif %}
+- Outside collaborators on private repositories owned by your organization, excluding forks
+- Anyone with a pending invitation to become an outside collaborator on private or internal repositories owned by your organization, excluding forks
- Dormant users
-{% data variables.product.company_short %} does not bill for any of the following people.
-
-{%- ifversion ghec %}
-- Enterprise owners who are not a member or owner of at least one organization in the enterprise
-- Enterprise billing managers
-{%- endif %}
-- Organization billing managers{% ifversion ghec %} for individual organizations on {% data variables.product.prodname_ghe_cloud %}{% endif %}
-- Anyone with a pending invitation to become an{% ifversion ghec %} enterprise or{% endif %} organization billing manager
-- Anyone with a pending invitation to become an outside collaborator on a public repository owned by your organization
-{%- ifversion ghes %}
-- Suspended users
-{%- endif %}
-
{% note %}
-**Note**: {% data reusables.organizations.org-invite-scim %}
+**Notes:**
+- {% data variables.product.company_short %} counts each outside collaborator once for billing purposes, even if the user account has access to multiple repositories owned by your organization.
+- {% data reusables.organizations.org-invite-scim %}
{% endnote %}
-For more information, see {% ifversion not fpt %}"[Roles in an enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)" or {% endif %}"[Roles in an organization](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)."
+{% data variables.product.company_short %} does not bill for the following people:
-{% data variables.product.company_short %} counts each {% ifversion not fpt %}member or {% endif %}outside collaborator once for billing purposes, even if the user account has {% ifversion not fpt %}membership in multiple organizations in an enterprise or {% endif %}access to multiple repositories owned by your organization. For more information about outside collaborators, see "[Adding outside collaborators to repositories in your organization](/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization)."
+- Billing managers
+- Anyone with a pending invitation to become a billing manager
+- Anyone with a pending invitation to become an outside collaborator on a public repository owned by your organization
-{% ifversion ghes %}Suspended users are not counted when calculating the number of licensed users consuming seats. For more information, see "[Suspending and unsuspending users](/admin/user-management/managing-users-in-your-enterprise/suspending-and-unsuspending-users)."{% endif %}
+{% else %}
-Dormant users do occupy a seat license.{% ifversion ghes %} As such, you can choose to suspend dormant users to release user licenses.{% endif %} For more information, see "[Managing dormant users](/admin/user-management/managing-users-in-your-enterprise/managing-dormant-users)."
+{% data variables.product.company_short %} bills for the following accounts for each deployment of {% data variables.product.prodname_enterprise %}.
+
+### Accounts that consume a license on {% data variables.product.prodname_ghe_cloud %}
+
+{% data variables.product.company_short %} bills for each of the following accounts on {% data variables.product.prodname_ghe_cloud %}:
+
+- Enterprise owners who are a member or owner of at least one organization in the enterprise
+- Organization members, including owners
+- Outside collaborators on private or internal repositories owned by your organization, excluding forks
+- Anyone with a pending invitation to become an organization owner or member
+- Anyone with a pending invitation to become an outside collaborator on private or internal repositories owned by your organization, excluding forks
+- Dormant users
+
+{% note %}
+
+**Notes:**
+ - {% data variables.product.company_short %} counts each member or outside collaborator once for billing purposes, even if the user account has membership in multiple organizations in an enterprise or access to multiple repositories owned by your organization.
+ - {% data reusables.organizations.org-invite-scim %}
+
+{% endnote %}
+
+{% data variables.product.company_short %} does not bill for any of the following accounts:
+
+- {% data variables.product.prodname_managed_users_caps %} that are suspended
+- Enterprise owners who are not a member or owner of at least one organization in the enterprise
+- Enterprise billing managers
+- Billing managers for individual organizations
+- Anyone with a pending invitation to become a billing manager
+- Anyone with a pending invitation to become an outside collaborator on a public repository owned by your organization
+
+### Accounts that consume a license on {% data variables.product.prodname_ghe_server %}
+
+Each user account on {% data variables.product.prodname_ghe_server %} consumes a seat.
+
+Suspended users are not counted when calculating the number of licensed users consuming seats. For more information, see "[Suspending and unsuspending users]({% ifversion not ghes %}/enterprise-server@latest{% endif %}/admin/user-management/managing-users-in-your-enterprise/suspending-and-unsuspending-users){% ifversion not ghes %}" in the {% data variables.product.prodname_ghe_server %} documentation.{% else %}."{% endif %}
+
+Dormant users do occupy a seat license. As such, you can choose to suspend dormant users to release user licenses. For more information, see "[Managing dormant users]({% ifversion not ghes %}/enterprise-server@latest{% endif %}/admin/user-management/managing-users-in-your-enterprise/managing-dormant-users){% ifversion not ghes %}" in the {% data variables.product.prodname_ghe_server %} documentation.{% else %}."{% endif %}
+
+{% endif %}
## About changes to your subscription
@@ -123,5 +146,7 @@ When you downgrade to a legacy paid plan with fewer private repositories, your n
{%- ifversion not fpt %}
- "[About enterprise accounts](/admin/overview/about-enterprise-accounts)"
+- "[Roles in an enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)"
{%- endif %}
-- "[About repositories](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)"
+- "[Roles in an organization](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)"
+- "[Adding outside collaborators to repositories in your organization](/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization)."
diff --git a/translations/es-ES/content/actions/using-workflows/workflow-commands-for-github-actions.md b/translations/es-ES/content/actions/using-workflows/workflow-commands-for-github-actions.md
index 5a6de2d67d..60e836a70a 100644
--- a/translations/es-ES/content/actions/using-workflows/workflow-commands-for-github-actions.md
+++ b/translations/es-ES/content/actions/using-workflows/workflow-commands-for-github-actions.md
@@ -169,6 +169,8 @@ Sets an action's output parameter.
Optionally, you can also declare output parameters in an action's metadata file. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs-for-docker-container-and-javascript-actions)."
+You can escape multiline strings for setting an output parameter by creating an environment variable and using it in a workflow command. For more information, see "[Setting an environment variable](#setting-an-environment-variable)."
+
### Example: Setting an output parameter
{% bash %}
diff --git a/translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md b/translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md
index f99aea3dca..82d3255404 100644
--- a/translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md
+++ b/translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md
@@ -1,5 +1,5 @@
---
-title: Configurar copias de seguridad en tu aparato
+title: Configuring backups on your appliance
shortTitle: Configuring backups
redirect_from:
- /enterprise/admin/categories/backups-and-restores
@@ -14,7 +14,7 @@ redirect_from:
- /enterprise/admin/installation/configuring-backups-on-your-appliance
- /enterprise/admin/configuration/configuring-backups-on-your-appliance
- /admin/configuration/configuring-backups-on-your-appliance
-intro: 'Como parte de un plan de recuperación ante desastres, puedes proteger los datos de producción en {% data variables.product.product_location %} configurando copias de seguridad automáticas.'
+intro: 'As part of a disaster recovery plan, you can protect production data on {% data variables.product.product_location %} by configuring automated backups.'
versions:
ghes: '*'
type: how_to
@@ -23,162 +23,158 @@ topics:
- Enterprise
- Fundamentals
- Infrastructure
-ms.openlocfilehash: 4403ec24aa3da63f6700ae4bfcd2392ec0cfd194
-ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
-ms.translationtype: HT
-ms.contentlocale: es-ES
-ms.lasthandoff: 09/09/2022
-ms.locfileid: '147861656'
---
-## Acerca de {% data variables.product.prodname_enterprise_backup_utilities %}
+## About {% data variables.product.prodname_enterprise_backup_utilities %}
-{% data variables.product.prodname_enterprise_backup_utilities %} es un sistema de copias de seguridad que se instala en un host independiente, el cual realiza instantáneas de copias de seguridad de {% data variables.product.product_location %} en intervalos regulares a través de una conexión de red SSH segura. Puedes utilizar una instantánea para restablecer una instancia existente del {% data variables.product.prodname_ghe_server %} a su estado previo desde el host de copias de seguridad.
+{% data variables.product.prodname_enterprise_backup_utilities %} is a backup system you install on a separate host, which takes backup snapshots of {% data variables.product.product_location %} at regular intervals over a secure SSH network connection. You can use a snapshot to restore an existing {% data variables.product.prodname_ghe_server %} instance to a previous state from the backup host.
-Solo se transferirán por la red y ocuparán espacio de almacenamiento físico adicional los datos que se hayan agregado después de esa última instantánea. Para minimizar el impacto en el rendimiento, las copias de seguridad se realizan en línea con la prioridad CPU/IO más baja. No necesitas programar una ventana de mantenimiento para realizar una copia de seguridad.
+Only data added since the last snapshot will transfer over the network and occupy additional physical storage space. To minimize performance impact, backups are performed online under the lowest CPU/IO priority. You do not need to schedule a maintenance window to perform a backup.
-Las versiones principales y los números de versión de {% data variables.product.prodname_enterprise_backup_utilities %} se alinean con las versiones de actualización de características de {% data variables.product.product_name %}. Se admiten las cuatro versiones más recientes de ambos productos. Para obtener más información, consulta "[Versiones de {% data variables.product.product_name %}](/admin/all-releases)".
+Major releases and version numbers for {% data variables.product.prodname_enterprise_backup_utilities %} align with feature releases of {% data variables.product.product_name %}. We support the four most recent versions of both products. For more information, see "[{% data variables.product.product_name %} releases](/admin/all-releases)."
-Para obtener información más detallada sobre las características, los requisitos y el uso avanzado, consulta el archivo [README de {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme) en la documentación del proyecto de {% data variables.product.prodname_enterprise_backup_utilities %}.
+For more detailed information on features, requirements, and advanced usage, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation.
-## Prerrequisitos
+## Prerequisites
-Para utilizar {% data variables.product.prodname_enterprise_backup_utilities %}, debe tener un sistema de host Linux o Unix independiente de {% data variables.product.product_location %}.
+To use {% data variables.product.prodname_enterprise_backup_utilities %}, you must have a Linux or Unix host system separate from {% data variables.product.product_location %}.
-También puedes incorporar {% data variables.product.prodname_enterprise_backup_utilities %} en un entorno existente para almacenar los datos críticos de manera permanente y a largo plazo.
+You can also integrate {% data variables.product.prodname_enterprise_backup_utilities %} into an existing environment for long-term permanent storage of critical data.
-Recomendamos que exista una distancia geográfica entre el host de copias de seguridad y {% data variables.product.product_location %}. Esto asegura que las copias de seguridad estén disponibles para su recuperación en el caso de que ocurra un desastre significativo o una interrupción de red en el sitio principal.
+We recommend that the backup host and {% data variables.product.product_location %} be geographically distant from each other. This ensures that backups are available for recovery in the event of a major disaster or network outage at the primary site.
-Los requisitos de almacenamiento físico variarán en función del uso del disco del repositorio de Git y de los patrones de crecimiento esperados:
+Physical storage requirements will vary based on Git repository disk usage and expected growth patterns:
-| Hardware | Recomendación |
+| Hardware | Recommendation |
| -------- | --------- |
-| **vCPU** | 2 |
-| **Memoria** | 2 GB |
-| **Storage** | Cinco veces el almacenamiento asignado de la instancia principal |
+| **vCPUs** | 2 |
+| **Memory** | 2 GB |
+| **Storage** | Five times the primary instance's allocated storage |
-Es posible que se requieran más recursos según su uso, como la actividad del usuario y las integraciones seleccionadas.
+More resources may be required depending on your usage, such as user activity and selected integrations.
-Para obtener más información, consulta [los requisitos de {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils/blob/master/docs/requirements.md) en la documentación del proyecto de {% data variables.product.prodname_enterprise_backup_utilities %}.
+For more information, see [{% data variables.product.prodname_enterprise_backup_utilities %} requirements](https://github.com/github/backup-utils/blob/master/docs/requirements.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation.
-## Instalar {% data variables.product.prodname_enterprise_backup_utilities %}
+## Installing {% data variables.product.prodname_enterprise_backup_utilities %}
-Para instalar {% data variables.product.prodname_enterprise_backup_utilities %} en el host de copia de seguridad, se recomienda clonar el repositorio Git del proyecto. Este enfoque permite capturar nuevas versiones directamente mediante Git y el archivo de configuración de copia de seguridad existente, `backup.config`, se conservará al instalar una nueva versión.
+To install {% data variables.product.prodname_enterprise_backup_utilities %} on your backup host, we recommend cloning the project's Git repository. This approach allows you to fetch new releases directly using Git, and your existing backup configuration file, `backup.config`, will be preserved when installing a new version.
-Como alternativa, si el equipo host no puede acceder a Internet, puedes descargar cada versión de {% data variables.product.prodname_enterprise_backup_utilities %} como archivo comprimido y, después, extraer e instalar el contenido. Para obtener más información, consulta [Introducción](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) de la documentación del proyecto de {% data variables.product.prodname_enterprise_backup_utilities %}.
+Alternatively, if the host machine can't access the internet, you can download each {% data variables.product.prodname_enterprise_backup_utilities %} release as a compressed archive, then extract and install the contents. For more information, see [Getting started](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation.
-Las instantáneas de copia de seguridad se escriben en la ruta de acceso del disco establecida por la variable de directorio de datos `GHE_DATA_DIR` del archivo `backup.config`. Las instantáneas deben almacenarse en un sistema de archivos que admita vínculos simbólicos y físicos.
+Backup snapshots are written to the disk path set by the `GHE_DATA_DIR` data directory variable in your `backup.config` file. Snapshots need to be stored on a filesystem which supports symbolic and hard links.
{% note %}
-**Nota:** Se recomienda asegurarse de que las instantáneas no se mantienen en un subdirectorio del directorio de instalación de {% data variables.product.prodname_enterprise_backup_utilities %} para evitar sobrescribir accidentalmente el directorio de datos al actualizar las versiones de {% data variables.product.prodname_enterprise_backup_utilities %}.
+**Note:** We recommend ensuring your snapshots are not kept in a subdirectory of the {% data variables.product.prodname_enterprise_backup_utilities %} installation directory, to avoid inadvertently overwriting your data directory when upgrading {% data variables.product.prodname_enterprise_backup_utilities %} versions.
{% endnote %}
-1. Ejecuta el siguiente comando para clonar el [repositorio del proyecto de {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils/) en un directorio local del host de copia de seguridad.
+1. To clone the [{% data variables.product.prodname_enterprise_backup_utilities %} project repository](https://github.com/github/backup-utils/) to a local directory on your backup host, run the following command.
```
$ git clone https://github.com/github/backup-utils.git /path/to/target/directory/backup-utils
```
-1. Ejecuta el siguiente comando para cambiar al directorio del repositorio local.
+1. To change into the local repository directory, run the following command.
```
cd backup-utils
```
{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %}
-1. Ejecuta el siguiente comando para copiar el archivo `backup.config-example` incluido en `backup.config`.
+1. To copy the included `backup.config-example` file to `backup.config`, run the following command.
```shell
cp backup.config-example backup.config
```
-1. Para personalizar la configuración, edita `backup.config` en un editor de texto.
- 1. Establezca el valor `GHE_HOSTNAME` en la dirección IP o el nombre del host de su instancia principal de {% data variables.product.prodname_ghe_server %}.
+1. To customize your configuration, edit `backup.config` in a text editor.
+ 1. Set the `GHE_HOSTNAME` value to your primary {% data variables.product.prodname_ghe_server %} instance's hostname or IP address.
{% note %}
- **Nota:** Si {% data variables.product.product_location %} se implementa como un clúster o en una configuración de alta disponibilidad utilizando un equilibrador de carga, el `GHE_HOSTNAME` puede ser el nombre de host del equilibrador de carga siempre y cuando permita acceso por SSH a {% data variables.product.product_location %} (por el puerto 122).
+ **Note:** If {% data variables.product.product_location %} is deployed as a cluster or in a high availability configuration using a load balancer, the `GHE_HOSTNAME` can be the load balancer hostname, as long as it allows SSH access (on port 122) to {% data variables.product.product_location %}.
- Para garantizar que un dispositivo recuperado esté disponible de inmediato, realiza copias de seguridad centradas en la instancia principal, incluso en una configuración de replicación geográfica.
+ To ensure a recovered appliance is immediately available, perform backups targeting the primary instance even in a geo-replication configuration.
{% endnote %}
- 1. Establezca el valor `GHE_DATA_DIR` para la ubicación del sistema de archivos en la que quiera almacenar las instantáneas de copias de seguridad. Se recomienda elegir una ubicación en el mismo sistema de archivos que el host de copia de seguridad, pero fuera de donde se clonó el repositorio Git en el paso 1.
-1. Para conceder acceso al host de copia de seguridad a la instancia, abre la página de configuración de la instancia principal en `http(s)://HOSTNAME/setup/settings` y agrega la clave SSH del host de copia de seguridad a la lista de claves SSH autorizadas. Para obtener más información, consulte"[Acceso al shell administrativo (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh#enabling-access-to-the-administrative-shell-via-ssh)".
-1. En el host de copia de seguridad, comprueba la conectividad SSH con {% data variables.product.product_location %} con el comando `ghe-host-check`.
+ 1. Set the `GHE_DATA_DIR` value to the filesystem location where you want to store backup snapshots. We recommend choosing a location on the same filesystem as your backup host, but outside of where you cloned the Git repository in step 1.
+1. To grant your backup host access to your instance, open your primary instance's settings page at `http(s)://HOSTNAME/setup/settings` and add the backup host's SSH key to the list of authorized SSH keys. For more information, see "[Accessing the administrative shell (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh#enabling-access-to-the-administrative-shell-via-ssh)."
+1. On your backup host, verify SSH connectivity with {% data variables.product.product_location %} with the `ghe-host-check` command.
```shell
./bin/ghe-host-check
- ```
-1. Ejecuta el siguiente comando para crear una copia de seguridad completa inicial.
+ ```
+1. To create an initial full backup, run the following command.
```shell
./bin/ghe-backup
```
-Para obtener más información sobre el uso avanzado, consulta el archivo [README de {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme) en la documentación del proyecto de {% data variables.product.prodname_enterprise_backup_utilities %}.
+For more information on advanced usage, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation.
-## Actualizar {% data variables.product.prodname_enterprise_backup_utilities %}
+## Upgrading {% data variables.product.prodname_enterprise_backup_utilities %}
-Al actualizar {% data variables.product.prodname_enterprise_backup_utilities %}, debes elegir una versión que funcione con la versión actual de {% data variables.product.product_name %}. La versión instalada de {% data variables.product.prodname_enterprise_backup_utilities %} debe ser, al menos, la misma que la de {% data variables.product.product_location %} y no puede ser más de dos versiones posteriores. Para obtener más información, consulta [los requisitos de la versión de {% data variables.product.prodname_ghe_server %}](https://github.com/github/backup-utils/blob/master/docs/requirements.md#github-enterprise-server-version-requirements) en la documentación del proyecto de {% data variables.product.prodname_enterprise_backup_utilities %}.
-Puedes actualizar {% data variables.product.prodname_enterprise_backup_utilities %} en un repositorio Git mediante la captura y extracción del repositorio de los cambios más recientes.
+When upgrading {% data variables.product.prodname_enterprise_backup_utilities %}, you must choose a release that will work with your current version of {% data variables.product.product_name %}. Your installation of {% data variables.product.prodname_enterprise_backup_utilities %} must be at least the same version as {% data variables.product.product_location %}, and cannot be more than two versions ahead. For more information, see [{% data variables.product.prodname_ghe_server %} version requirements](https://github.com/github/backup-utils/blob/master/docs/requirements.md#github-enterprise-server-version-requirements) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation.
+You can upgrade {% data variables.product.prodname_enterprise_backup_utilities %} in a Git repository by fetching and checking out the latest changes.
-Como alternativa, si no usas un repositorio Git para la instalación, puedes extraer un nuevo archivo o cambiar el enfoque para usar un repositorio Git en su lugar.
+Alternatively, if you don't use a Git repository for your installation, you can extract a new archive into place, or you can change your approach to use a Git repository instead.
-### Comprobación del tipo de instalación
+### Verifying the installation type
-Puedes comprobar el método de instalación de {% data variables.product.prodname_enterprise_backup_utilities %} y determinar la mejor manera de actualizar la versión instalada.
+You can verify the installation method for {% data variables.product.prodname_enterprise_backup_utilities %} and determine the best way to upgrade your installation.
{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %}
-1. Ejecuta el siguiente comando para comprobar si existe un directorio de trabajo válido dentro de un repositorio Git.
+1. To check if a valid working directory exists inside a Git repository, run the following command.
```
git rev-parse --is-inside-work-tree
```
- Si la salida es `true`, {% data variables.product.prodname_enterprise_backup_utilities %} se instaló mediante la clonación del repositorio Git del proyecto. Si la salida incluye `fatal: not a git repository (or any of the parent directories)`, es probable que {% data variables.product.prodname_enterprise_backup_utilities %} se instalase extrayendo un archivo de archivo comprimido.
-Si la instalación está en un repositorio Git, puedes instalar la versión más reciente mediante Git. Si la instalación procede de un archivo comprimido, puedes descargar y extraer la versión más reciente, o bien puedes volver a instalar {% data variables.product.prodname_enterprise_backup_utilities %} mediante Git para simplificar las actualizaciones futuras.
+ If the output is `true`, {% data variables.product.prodname_enterprise_backup_utilities %} was installed by cloning the project's Git repository. If the output includes `fatal: not a git repository (or any of the parent directories)`, {% data variables.product.prodname_enterprise_backup_utilities %} was likely installed by extracting a compressed archive file.
+If your installation is in a Git repository, you can install the latest version using Git. If the installation is from a compressed archive file, you can either download and extract the latest version, or you can reinstall {% data variables.product.prodname_enterprise_backup_utilities %} using Git to simplify future upgrades.
-- [Actualización de una instalación en un repositorio Git](#upgrading-an-installation-in-a-git-repository)
-- [Uso de Git en lugar de archivos comprimidos para actualizaciones](#using-git-instead-of-compressed-archives-for-upgrades)
+- [Upgrading an installation in a Git repository](#upgrading-an-installation-in-a-git-repository)
+- [Using Git instead of compressed archives for upgrades](#using-git-instead-of-compressed-archives-for-upgrades)
-### Actualización de una instalación en un repositorio Git
+### Upgrading an installation in a Git repository
-{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} {% note %}
+{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %}
+ {% note %}
- **Nota:** Se recomienda crear una copia del archivo `backup.config` existente en una ubicación temporal, como `$HOME/backup.config`, antes de actualizar {% data variables.product.prodname_enterprise_backup_utilities %}.
+ **Note:** We recommend creating a copy of your existing `backup.config` file in a temporary location, like `$HOME/backup.config`, before upgrading {% data variables.product.prodname_enterprise_backup_utilities %}.
{% endnote %}
-1. Descarga las actualizaciones más recientes del proyecto mediante la ejecución del comando `git fetch`.
+1. Download the latest project updates by running the `git fetch` command.
```shell
git fetch
```
-{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %}
+{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %}
+{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %}
-### Uso de Git en lugar de archivos comprimidos para actualizaciones
+### Using Git instead of compressed archives for upgrades
-Si el host de copia de seguridad tiene conectividad a Internet y se usó previamente un archivo comprimido (`.tar.gz`) para instalar o actualizar {% data variables.product.prodname_enterprise_backup_utilities %}, se recomienda usar un repositorio Git para la instalación en su lugar. La actualización mediante Git requiere menos trabajo y conserva la configuración de copia de seguridad.
+If your backup host has internet connectivity and you previously used a compressed archive (`.tar.gz`) to install or upgrade {% data variables.product.prodname_enterprise_backup_utilities %}, we recommend using a Git repository for your installation instead. Upgrading using Git requires less work and preserves your backup configuration.
{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %}
-1. Para realizar una copia de seguridad de la configuración de {% data variables.product.prodname_enterprise_backup_utilities %} existente, copia el archivo `backup.config` actual en una ubicación segura, como el directorio principal.
+1. To back up your existing {% data variables.product.prodname_enterprise_backup_utilities %} configuration, copy your current `backup.config` file to a safe location, such as your home directory.
```
$ cp backup.config $HOME/backup.config.saved-$(date +%Y%m%d-%H%M%S)
```
-1. Cambia al directorio local del host de copia de seguridad donde deseas instalar el repositorio Git {% data variables.product.prodname_enterprise_backup_utilities %}.
-1. Ejecuta el siguiente comando para clonar el [repositorio del proyecto](https://github.com/github/backup-utils/) en el directorio del host de copia de seguridad.
+1. Change to the local directory on your backup host where you want to install the {% data variables.product.prodname_enterprise_backup_utilities %} Git repository.
+1. To clone the [project repository](https://github.com/github/backup-utils/) to the directory on your backup host, run the following command.
```
git clone https://github.com/github/backup-utils.git
```
-1. Ejecuta el siguiente comando para cambiar al repositorio clonado.
+1. To change into the cloned repository, run the following command.
```
cd backup-utils
```
{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %}
-1. Para restaurar la configuración de copia de seguridad anterior, copia el archivo de configuración de copia de seguridad existente en el directorio del repositorio local. Reemplaza la ruta de acceso del comando por la ubicación del archivo guardado en el paso 2.
+1. To restore your backup configuration from earlier, copy your existing backup configuration file to the local repository directory. Replace the path in the command with the location of the file saved in step 2.
```
$ cp PATH/TO/BACKUP/FROM/STEP/2 backup.config
@@ -186,44 +182,44 @@ Si el host de copia de seguridad tiene conectividad a Internet y se usó previam
{% note %}
- **Nota:** Puedes elegir dónde restaurar el archivo de configuración de copia de seguridad después de la clonación. Para obtener más información sobre dónde se pueden encontrar los archivos de configuración, consulta [Introducción](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) en la documentación del proyecto de {% data variables.product.prodname_enterprise_backup_utilities %}.
+ **Note:** You can choose where to restore your backup configuration file to after cloning. For more information about where configuration files can be located, see [Getting started](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation.
{% endnote %}
-1. Revisa el archivo en un editor de texto para confirmar que las rutas de acceso a directorios o scripts del archivo de configuración de copia de seguridad son correctas.
+1. To confirm that the paths to directories or scripts in your backup configuration file are correct, review the file in a text editor.
{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %}
-1. Elimina el antiguo directorio de GitHub Enterprise Server Backup Utilities del paso 1 (donde se encuentra la instalación del archivo comprimido).
+1. Delete your old GitHub Enterprise Server Backup Utilities directory from step 1 (where the compressed archive installation was located).
-## Programar una copia de seguridad
+## Scheduling a backup
-Puede programar copias de seguridad con una determinada frecuencia en el host de copia de seguridad utilizando el comando `cron(8)` o un servicio de programación mediante comando similar. La frecuencia de copias de seguridad configurada dictará el peor caso de Punto Objetivo de Recuperación (RPO) de tu plan de recuperación. Por ejemplo, si has programado que la copia de seguridad se ejecute todos los días a la medianoche, podrías perder hasta 24 horas de datos en un escenario de desastre. Recomendamos comenzar con un cronograma de copias de seguridad por hora, que garantice un peor caso máximo de una hora de pérdida de datos, si los datos del sitio principal se destruyen.
+You can schedule regular backups on the backup host using the `cron(8)` command or a similar command scheduling service. The configured backup frequency will dictate the worst case recovery point objective (RPO) in your recovery plan. For example, if you have scheduled the backup to run every day at midnight, you could lose up to 24 hours of data in a disaster scenario. We recommend starting with an hourly backup schedule, guaranteeing a worst case maximum of one hour of data loss if the primary site data is destroyed.
-Si los intentos de copias de seguridad se superponen, el comando `ghe-backup` se detendrá con un mensaje de error que indicará la existencia de una copia de seguridad simultánea. Si esto ocurre, recomendamos que disminuyas la frecuencia de tus copias de seguridad programadas. Para obtener más información, consulta la sección sobre programar copias de seguridad del archivo [README de {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#scheduling-backups) en la documentación del proyecto de {% data variables.product.prodname_enterprise_backup_utilities %}.
+If backup attempts overlap, the `ghe-backup` command will abort with an error message, indicating the existence of a simultaneous backup. If this occurs, we recommended decreasing the frequency of your scheduled backups. For more information, see the "Scheduling backups" section of the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#scheduling-backups) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation.
-## Restauración de una copia de seguridad
+## Restoring a backup
-En el caso de una interrupción de red prolongada o de un evento catastrófico en el sitio principal, puede restablecer {% data variables.product.product_location %} proporcionando otro dispositivo para {% data variables.product.prodname_enterprise %} y realizando un restablecimiento desde el host de copias de seguridad. Debes agregar la clave SSH del host de copias de seguridad en el aparato objetivo {% data variables.product.prodname_enterprise %} como una clave SSH autorizada antes de restablecer un aparato.
+In the event of prolonged outage or catastrophic event at the primary site, you can restore {% data variables.product.product_location %} by provisioning another {% data variables.product.prodname_enterprise %} appliance and performing a restore from the backup host. You must add the backup host's SSH key to the target {% data variables.product.prodname_enterprise %} appliance as an authorized SSH key before restoring an appliance.
{% note %}
-**Nota:** Cuando realice restauraciones de copias de seguridad en {% data variables.product.product_location %}, se aplicarán las mismas reglas de compatibilidad de versión. Solo puedes restablecer datos de por lo mucho dos lanzamientos de características anteriores.
+**Note:** When performing backup restores to {% data variables.product.product_location %}, the same version supportability rules apply. You can only restore data from at most two feature releases behind.
-Por ejemplo, si haces una copia de seguridad de {% data variables.product.product_name %} 3.0.x, puedes restaurar la copia de seguridad en una instancia de {% data variables.product.product_name %} 3.2.x. No se pueden restaurar datos desde una copia de seguridad de {% data variables.product.product_name %} 2.22.x a una instancia que ejecute 3.2.x, ya que serían tres saltos entre versiones (de 2.22 a 3.0, a 3.1 y finalmente a 3.2). Primero necesitarías restablecer a una instancia que ejecute 3.1.x y luego actualizar a 3.2.x.
+For example, if you take a backup from {% data variables.product.product_name %} 3.0.x, you can restore the backup to a {% data variables.product.product_name %} 3.2.x instance. You cannot restore data from a backup of {% data variables.product.product_name %} 2.22.x to an instance running 3.2.x, because that would be three jumps between versions (2.22 to 3.0 to 3.1 to 3.2). You would first need to restore to an instance running 3.1.x, and then upgrade to 3.2.x.
{% endnote %}
-Para restaurar {% data variables.product.product_location %} desde la última instantánea correcta, use el comando `ghe-restore`.
+To restore {% data variables.product.product_location %} from the last successful snapshot, use the `ghe-restore` command.
{% note %}
-**Nota:** Antes de restaurar una copia de seguridad, asegúrate de que:
-- El modo de mantenimiento está habilitado en la instancia principal y se han completado todos los procesos activos. Para más información, vea "[Habilitación del modo de mantenimiento](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)".
-- La replicación se ha detenido en todas las réplicas en configuraciones de alta disponibilidad. Para obtener más información, consulta el comando `ghe-repl-stop` en "[Acerca de la configuración de alta disponibilidad](/admin/enterprise-management/configuring-high-availability/about-high-availability-configuration#ghe-repl-stop)".
-- Si {% data variables.product.product_location %} tiene habilitadas las {% data variables.product.prodname_actions %}, primero deberás configurar el proveedor de almacenamiento externo de {% data variables.product.prodname_actions %} en el dispositivo de repuesto. Para obtener más información, consulte "[Copia de seguridad y restauración de {% data variables.product.prodname_ghe_server %} con {% data variables.product.prodname_actions %} habilitado](/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled)".
+**Note:** Prior to restoring a backup, ensure:
+- Maintenance mode is enabled on the primary instance and all active processes have completed. For more information, see "[Enabling maintenance mode](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)."
+- Replication is stopped on all replicas in high availability configurations. For more information, see the `ghe-repl-stop` command in "[About high availability configuration](/admin/enterprise-management/configuring-high-availability/about-high-availability-configuration#ghe-repl-stop)."
+- If {% data variables.product.product_location %} has {% data variables.product.prodname_actions %} enabled, you must first configure the {% data variables.product.prodname_actions %} external storage provider on the replacement appliance. For more information, see "[Backing up and restoring {% data variables.product.prodname_ghe_server %} with {% data variables.product.prodname_actions %} enabled](/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled)."
{% endnote %}
-Al ejecutar el comando `ghe-restore`, deberías ver un resultado similar al siguiente:
+When running the `ghe-restore` command, you should see output similar to this:
```shell
$ ghe-restore -c 169.154.1.1
@@ -242,15 +238,20 @@ $ ghe-restore -c 169.154.1.1
> Visit https://169.154.1.1/setup/settings to review appliance configuration.
```
-{% ifversion ip-exception-list %} Opcionalmente, para validar la restauración, configura una lista de excepciones IP para permitir el acceso a una lista específica de direcciones IP. Para obtener más información, consulta "[Validación de cambios en el modo de mantenimiento mediante la lista de excepciones de IP](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)".
+{% ifversion ip-exception-list %}
+Optionally, to validate the restore, configure an IP exception list to allow access to a specified list of IP addresses. For more information, see "[Validating changes in maintenance mode using the IP exception list](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)."
{% endif %}
{% note %}
-**Nota:** La configuración de red se excluye de la instantánea de copia de seguridad. Debes configurar manualmente la red en el aparato objetivo para el {% data variables.product.prodname_ghe_server %} como obligatoria para tu entorno.
+**Note:**
+
+- The network settings are excluded from the backup snapshot. You must manually configure the network on the target {% data variables.product.prodname_ghe_server %} appliance as required for your environment.
+
+- When restoring to new disks on an existing or empty {% data variables.product.prodname_ghe_server %} instance, stale UUIDs may be present, resulting in Git and/or Alambic replication reporting as out of sync. Stale server entry IDs can be the result of a retired node in a high availability configuration still being present in the application database, but not in the restored replication configuration. To remediate, stale UUIDs can be torn down using `ghe-repl-teardown` once the restore has completed and prior to starting replication. In this scenario, contact {% data variables.contact.contact_ent_support %} for further assistance.
{% endnote %}
-Puede usar estas opciones adicionales con el comando `ghe-restore`:
-- La marca `-c` sobrescribe los ajustes, el certificado y los datos de licencia en el host objetivo, incluso si este ya está configurado. Omite esta marca si estás configurando una instancia de preparación con fines de prueba y si quieres conservar la configuración existente en el objetivo. Para obtener más información, consulta la sección sobre el uso de comandos de copia de seguridad y restauración del archivo [README de {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#using-the-backup-and-restore-commands) en la documentación del proyecto de {% data variables.product.prodname_enterprise_backup_utilities %}.
-- La marca `-s` le permite seleccionar una instantánea de copia de seguridad diferente.
+You can use these additional options with `ghe-restore` command:
+- The `-c` flag overwrites the settings, certificate, and license data on the target host even if it is already configured. Omit this flag if you are setting up a staging instance for testing purposes and you wish to retain the existing configuration on the target. For more information, see the "Using backup and restore commands" section of the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#using-the-backup-and-restore-commands) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation.
+- The `-s` flag allows you to select a different backup snapshot.
diff --git a/translations/es-ES/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md b/translations/es-ES/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md
index 6fa069a0f2..9445e64621 100644
--- a/translations/es-ES/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md
+++ b/translations/es-ES/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md
@@ -93,7 +93,7 @@ Optionally, if you use {% data variables.product.prodname_registry %} on your pr
{% warning %}
-**Warning**: If you don't configure {% data variables.product.prodname_actions %} on the staging instance before restoring your production backup, your staging instance will use your production instance's external storage, which could result in loss of data. We strongly recommended that you use different external storage for your staging instance.
+**Warning**: If you don't configure {% data variables.product.prodname_registry %} on the staging instance before restoring your production backup, your staging instance will use your production instance's external storage, which could result in loss of data. We strongly recommended that you use different external storage for your staging instance.
{% endwarning %}
@@ -128,7 +128,7 @@ Optionally, if you use {% data variables.product.prodname_registry %} on your pr
Use the `ghe-restore` command to restore the rest of the data from the backup. For more information, see "[Restoring a backup](/admin/configuration/configuring-backups-on-your-appliance#restoring-a-backup)."
-If the staging instance is already configured and you're about to overwrite settings, certificate, and license data, add the `-c` option to the command. For more information about the option, see [Using the backup and restore commands](https://github.com/github/backup-utils/blob/master/docs/usage.md#restoring-settings-tls-certificate-and-license) in the {% data variables.product.prodname_enterprise_backup_utilities %} documentation.
+If the staging instance is already configured and you want to overwrite settings, certificate, and license data, add the `-c` option to the command. For more information about the option, see [Using the backup and restore commands](https://github.com/github/backup-utils/blob/master/docs/usage.md#restoring-settings-tls-certificate-and-license) in the {% data variables.product.prodname_enterprise_backup_utilities %} documentation.
### 6. Review the instance's configuration
diff --git a/translations/es-ES/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md b/translations/es-ES/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md
index a21fbca0a0..6e8acc6b4d 100644
--- a/translations/es-ES/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md
+++ b/translations/es-ES/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md
@@ -56,7 +56,7 @@ Jobs that run on Windows and macOS runners that {% data variables.product.prodna
The storage used by a repository is the total storage used by {% data variables.product.prodname_actions %} artifacts and {% data variables.product.prodname_registry %}. Your storage cost is the total usage for all repositories owned by your account. For more information about pricing for {% data variables.product.prodname_registry %}, see "[About billing for {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/about-billing-for-github-packages)."
- If your account's usage surpasses these limits and you have set a spending limit above $0 USD, you will pay $0.008 USD per GB of storage per day and per-minute usage depending on the operating system used by the {% data variables.product.prodname_dotcom %}-hosted runner. {% data variables.product.prodname_dotcom %} rounds the minutes each job uses up to the nearest minute.
+ If your account's usage surpasses these limits and you have set a spending limit above $0 USD, you will pay $0.008 USD per GB of storage per day and per-minute usage depending on the operating system used by the {% data variables.product.prodname_dotcom %}-hosted runner. {% data variables.product.prodname_dotcom %} rounds the minutes and partial minutes each job uses up to the nearest whole minute.
{% note %}
diff --git a/translations/es-ES/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md b/translations/es-ES/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md
index d11653618f..29711c895e 100644
--- a/translations/es-ES/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md
+++ b/translations/es-ES/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md
@@ -3,6 +3,7 @@ title: About billing for GitHub Codespaces
shortTitle: About billing
intro: 'View pricing and see how to manage {% data variables.product.prodname_github_codespaces %} billing for your organization.'
permissions: 'To manage billing for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner or a billing manager.'
+miniTocMaxHeadingLevel: 3
versions:
fpt: '*'
ghec: '*'
@@ -13,40 +14,105 @@ topics:
- Billing
redirect_from:
- /billing/managing-billing-for-github-codespaces/about-billing-for-codespaces
+ - /github/developing-online-with-codespaces/about-billing-for-codespaces
+ - /codespaces/getting-started-with-codespaces/about-billing-for-codespaces
+ - /codespaces/codespaces-reference/about-billing-for-codespaces
+ - /codespaces/codespaces-reference/understanding-billing-for-codespaces
+ - /codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md
---
## {% data variables.product.prodname_github_codespaces %} pricing
-Charges are incurred for the use of {% data variables.product.prodname_github_codespaces %} for repositories owned by organization and enterprise accounts on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %}. These accounts do not include any free minutes or storage for {% data variables.product.prodname_github_codespaces %}. Repositories in personal accounts are not currently billed for {% data variables.product.prodname_github_codespaces %} usage.
+Charges are incurred for the use of {% data variables.product.prodname_github_codespaces %} for repositories owned by organization and enterprise accounts on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %}. These accounts do not include any free minutes or storage for {% data variables.product.prodname_github_codespaces %}. Personal accounts are not currently billed for {% data variables.product.prodname_github_codespaces %} usage.
+
+A {% data variables.product.prodname_github_codespaces %} instance (a "codespace") incurs charges for compute time, while it is active, and for the amount of storage it uses on disk.
{% data variables.product.prodname_github_codespaces %} usage is billed according to the units of measure in the following table:
-| Product | SKU | Unit of measure | Price |
-| ------------------- | -------- | --------------- | ----- |
-| Codespaces Compute | 2 core | 1 hour | $0.18 |
-| | 4 core | 1 hour | $0.36 |
-| | 8 core | 1 hour | $0.72 |
-| | 16 core | 1 hour | $1.44 |
-| | 32 core | 1 hour | $2.88 |
-| Codespaces Storage | Storage | 1 GB-month | $0.07 |
+| Component | Machine type | Unit of measure | Price |
+| ------------------- | ------------ | --------------- | ----- |
+| Codespaces compute | 2 core | 1 hour | $0.18 |
+| | 4 core | 1 hour | $0.36 |
+| | 8 core | 1 hour | $0.72 |
+| | 16 core | 1 hour | $1.44 |
+| | 32 core | 1 hour | $2.88 |
+| Codespaces storage | Storage | 1 GB-month* | $0.07 |
+
+* See "[Billing for storage usage](#billing-for-storage-usage)" below for details of the GB-month unit of measure.
+
+If you enable prebuilding of codespaces this will incur additional charges. For more information, see "[Billing for {% data variables.product.prodname_codespaces %} prebuilds](#billing-for-codespaces-prebuilds)."
## About billing for {% data variables.product.prodname_github_codespaces %}
-{% data reusables.codespaces.codespaces-billing %}
+{% data variables.product.prodname_github_codespaces %} is billed in US dollars (USD) according to their compute and storage usage. {% data reusables.codespaces.codespaces-monthly-billing %} xxx
-Your {% data variables.product.prodname_github_codespaces %} usage shares your organization or enterprise account's existing billing date, payment method, and receipt. {% data reusables.dotcom_billing.view-all-subscriptions %}
+Your {% data variables.product.prodname_github_codespaces %} usage shares your organization or enterprise account's existing payment method, and receipt. For more information, see "[Viewing your subscriptions and billing date](/articles/viewing-your-subscriptions-and-billing-date)."
{% ifversion ghec %}
If you purchased {% data variables.product.prodname_enterprise %} through a Microsoft Enterprise Agreement, you can connect your Azure Subscription ID to your enterprise account to enable and pay for {% data variables.product.prodname_github_codespaces %} usage. For more information, see "[Connecting an Azure subscription to your enterprise](/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise)."
{% endif %}
-{% data reusables.dotcom_billing.pricing_calculator.pricing_cal_codespaces %}
+### Billing for compute usage
+The compute usage of a codespace is the number of minutes for which that codespace is active. Total compute usage is calculated by summing the number of minutes used by all codespaces that are billable to the organization or enterprise. These totals are reported to the billing service every hour, and are billed monthly.
+
+As an example, if a codespace is active for 1 hour and 15 minutes, then the compute cost will be the hourly cost of the codespace, as determined by its machine type, multiplied by 1.25.
+
+You can restrict compute usage by stopping your codespaces. For information, see "[Stopping and starting a codespace](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)." Codespaces are stopped automatically after a configurable period of inactivity. The timeout period can be configured by the user, or at the organization level. 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)" and "[Restricting the idle timeout period](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)."
+
+### Billing for storage usage
+For {% data variables.product.prodname_github_codespaces %} billing purposes, this includes all storage used by all codespaces and prebuilds in your account. This includes any files used by the codespaces, such as cloned repositories, configuration files, and extensions, among others. Storage is billed for all of your existing codespaces, regardless of whether they are active or stopped. The storage billing for a codespace ends when it is deleted.
+
+Codespace storage is reported in GB-months. Your billing month runs from a fixed day in one month until the same day in the next month. In most cases the day of the month is determined by the day you started on your current {% data variables.product.prodname_dotcom %} plan. Your GB-month storage, is calculated as follows. Once every hour, the storage used by all of your currently active and stopped codespaces is assessed. This figure is then divided by the number of hours in the current billing month: `total storage size / hours this month`. The result is added to the running total for codespace storage for the month.
+
+For example, if you have one codespace that uses 100 GB of storage and has existed for one hour you will have used `100 / (24 * 30) = 0.1388` GB-months of storage in a 30-day month. If your use of GitHub Codespaces during a 30-day month consists of two 100 GB codespaces that both existed for three full days then there will be `24 * 3` hourly reports for the storage of these codespaces, giving a total of: `(24 * 3) * 200 / (24 * 30) = 20` GB-months.
+
+For each hourly report, the storage usage for the previous hour is calculated in seconds. As a result, you won't be charged for a full hour of storage if a codespace did not exist for the full 60 minutes. At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB.
+
+As an organization owner, you can:
+- List the currently active and stopped codespaces for your organization. For more information, see "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)." In addition to the cost of these codespaces, the cost of {% data variables.product.prodname_github_codespaces %} for the current month may include costs for codespaces that existed earlier in the current month but have since been deleted.
+- See the total {% data variables.product.prodname_github_codespaces %} compute and storage usage for your organization for the current month to date. For more information, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)."
+- Configure your organization settings to manage the cost of {% data variables.product.prodname_github_codespaces %}. For more information, see "[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)."
+
+To estimate the costs for metered services, you can use the {% data variables.product.prodname_dotcom %} [pricing calculator](https://github.com/pricing/calculator?feature=codespaces).
### Billing for {% data variables.product.prodname_codespaces %} prebuilds
-{% data reusables.codespaces.billing-for-prebuilds-default %}
+{% data reusables.codespaces.prebuilds-definition %} For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds)."
-{% data reusables.codespaces.billing-for-prebuilds-reducing %}
+#### {% data variables.product.prodname_actions %} costs for prebuilds
+
+Prebuilds are created and updated by running a {% data variables.product.prodname_actions %} workflow on a {% data variables.product.prodname_dotcom %}-hosted runner. By default, prebuilds are updated every time you modify the prebuild configuration, or push changes to a prebuild-enabled branch. As with other workflows, while prebuild workflows are running they will either consume some of the Actions minutes included with your account, if you have any, or they will incur charges for Actions minutes. For more information about pricing for Actions minutes, see "[About billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)." There is no associated {% data variables.product.prodname_codespaces %} compute cost for creating or updating prebuilds.
+
+To reduce consumption of Actions minutes, you can set a prebuild to be updated only when you make a change to your dev container configuration files, or only on a custom schedule. You can also manage your storage usage by adjusting the number of previous versions of each prebuild that are retained. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)."
+
+If you are an organization or enterprise owner, you can track usage of prebuild workflows and storage by downloading a usage report for your organization or enterprise. You can identify workflow runs for prebuilds by filtering the CSV output to only include the workflow called "Create {% data variables.product.prodname_github_codespaces %} Prebuilds." For more information, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage#viewing-github-actions-usage-for-your-organization)."
+
+#### Storage costs for prebuilds
+
+In addition to {% data variables.product.prodname_actions %} minutes, you will also be billed for the storage of prebuilds associated with each prebuild configuration for a given repository and region. Storage of prebuilds is billed at the same rate as storage of codespaces.
+
+The storage cost for a prebuild in a single region will be similar to the storage cost that will be incurred for storing a single codespace created from that prebuild. The storage cost for the generated codespace may be more than the cost for the prebuild if, for example, the `updateContentCommand` and `postCreateCommand` commands are used during codespace creation to download more files to the dev container.
+
+The total storage costs associated with a prebuild template will depend on:
+
+* The price of storage per GB. See the table above.
+* The size of the generated prebuild in GB.
+* The number of regions in which the prebuild is available (because a copy of the prebuild is stored in each region).
+* The number of older versions of the prebuild that are retained.
+
+The storage cost for a prebuild is therefore calculated as: `price per GB * size (GB) * regions * versions`.
+
+To limit the storage costs associated with prebuilds, you can choose to create prebuilds only in selected regions, and you can specify the number of older versions of prebuilds that will be retained. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)."
+
+{% note %}
+
+**Note**: Prebuilds may be updated several times during a billing month. Newer versions of a prebuild may be larger or smaller than the previous versions. This will affect the storage charges. For details of how storage is calculated during a billing month, see "[Billing for storage usage](#billing-for-storage-usage)" above.
+
+{% endnote %}
+
+#### Cost of codespaces created from prebuilds
+
+Use of codespaces created using prebuilds is charged at the same rate as regular codespaces.
## Setting a spending limit
@@ -72,7 +138,7 @@ For example, a user in an organization can fork a repository within that organiz
## How billing is handled when a repository is transferred
-Usage is billed and reported on every hour. As such, you pay for any usage when a repository is within your organization. When a repository is transferred out of your organization, any codespaces in that repository are removed as part of the transfer process.
+Usage is calculated every hour. An organization pays for usage of codespaces created from any repository owned by the organization, where the organization settings permit the organization to be billed. For more information, see "[Enabling GitHub Codespaces for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#choose-who-can-create-codespaces-that-are-billed-to-your-organization)." When a repository is transferred out of your organization, ownership and billing responsibility for any codespaces associated with that repository will change accordingly.
## What happens when users are removed
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 839d5dc496..b565c2a921 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
@@ -11,4 +11,3 @@ children:
- /viewing-your-github-codespaces-usage
- /managing-spending-limits-for-github-codespaces
---
-
diff --git a/translations/es-ES/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md b/translations/es-ES/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md
index cf5ad18c14..929ebfd3e8 100644
--- a/translations/es-ES/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md
+++ b/translations/es-ES/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md
@@ -21,6 +21,8 @@ redirect_from:
{% data reusables.codespaces.codespaces-spending-limit-requirement %}
+{% data reusables.codespaces.codespaces-monthly-billing %}
+
Once you've reached your spending limit, your organization or repository will no longer be able to create new codespaces, and won't be able to start existing codespaces. Any existing codespaces that are still running will not be shutdown; if you don't change the spending limit, you will not be charged for the amount that exceeds the limit.
For more information about pricing for {% data variables.product.prodname_github_codespaces %} usage, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)."
@@ -67,4 +69,4 @@ You can disable these notifications anytime by navigating to the bottom of the *
## Further reading
- "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)"
-- "[Managing billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)"
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 3081c864ef..9652fd43bd 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
@@ -21,8 +21,21 @@ Organization owners and billing managers can view {% data variables.product.prod
{% 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.
- 
+
+ 
+
+ 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-spending-limits-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.
+
+ {% endnote %}
+
{% data reusables.dotcom_billing.actions-packages-report-download-org-account %}
+ The data used for this report is updated daily.
1. Filter the report to show only rows that mention "Codespaces" in the `Product` field.

@@ -38,3 +51,7 @@ Enterprise owners and billing managers can view {% data variables.product.prodna
1. Under "{% data variables.product.prodname_codespaces %} monthly usage", view the usage details of each organization in your enterprise account.
{% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %}
{% endif %}
+
+## Further reading
+
+- "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)"
\ No newline at end of file
diff --git a/translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md b/translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md
index 51ae89d06d..f8ef3037ef 100644
--- a/translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md
+++ b/translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md
@@ -14,23 +14,23 @@ shortTitle: Private image registry
A registry is a secure space for storing, managing, and fetching private container images. You may use one to store one or more images. There are many examples of registries, such as {% data variables.product.prodname_container_registry %}, {% data variables.product.prodname_npm_registry %}, Azure Container Registry, or DockerHub.
-{% data variables.product.prodname_ghcr_and_npm_registry %} can be configured to allow container images to be pulled seamlessly into {% data variables.product.prodname_github_codespaces %} during codespace creation, without having to provide any authentication credentials. For other image registries, you must create secrets in {% data variables.product.prodname_dotcom %} to store the access details, which will allow {% data variables.product.prodname_github_codespaces %} to access images stored in that registry.
+{% data variables.packages.prodname_ghcr_and_npm_registry %} can be configured to allow container images to be pulled seamlessly into {% data variables.product.prodname_github_codespaces %} during codespace creation, without having to provide any authentication credentials. For other image registries, you must create secrets in {% data variables.product.prodname_dotcom %} to store the access details, which will allow {% data variables.product.prodname_github_codespaces %} to access images stored in that registry.
-## Accessing images stored in {% data variables.product.prodname_ghcr_and_npm_registry %}
+## Accessing images stored in {% data variables.packages.prodname_ghcr_and_npm_registry %}
-{% data variables.product.prodname_ghcr_and_npm_registry %} provide the easiest way for {% data variables.product.prodname_github_codespaces %} to consume dev container images.
+{% data variables.packages.prodname_ghcr_and_npm_registry %} provide the easiest way for {% data variables.product.prodname_github_codespaces %} to consume dev container images.
For more information, see "[Working with the Container registry](/packages/working-with-a-github-packages-registry/working-with-the-container-registry)" and "[Working with the npm registry](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry)".
### Accessing an image published to the same repository as the codespace
-If you publish a container image to {% data variables.product.prodname_ghcr_or_npm_registry %} in the same repository that the codespace is being launched in, you will automatically be able to fetch that image on codespace creation. You won't have to provide any additional credentials, unless the **Inherit access from repo** option was unselected when the container image was published.
+If you publish a container image to {% data variables.packages.prodname_ghcr_or_npm_registry %} in the same repository that the codespace is being launched in, you will automatically be able to fetch that image on codespace creation. You won't have to provide any additional credentials, unless the **Inherit access from repo** option was unselected when the container image was published.
#### Inheriting access from the repository from which an image was published
-By default, when you publish a container image to {% data variables.product.prodname_ghcr_or_npm_registry %}, the image inherits the access setting of the repository from which the image was published. For example, if the repository is public, the image is also public. If the repository is private, the image is also private, but is accessible from the repository.
+By default, when you publish a container image to {% data variables.packages.prodname_ghcr_or_npm_registry %}, the image inherits the access setting of the repository from which the image was published. For example, if the repository is public, the image is also public. If the repository is private, the image is also private, but is accessible from the repository.
-This behavior is controlled by the **Inherit access from repo** option. **Inherit access from repo** is selected by default when publishing via {% data variables.product.prodname_actions %}, but not when publishing directly to {% data variables.product.prodname_ghcr_or_npm_registry %} using a Personal Access Token (PAT).
+This behavior is controlled by the **Inherit access from repo** option. **Inherit access from repo** is selected by default when publishing via {% data variables.product.prodname_actions %}, but not when publishing directly to {% data variables.packages.prodname_ghcr_or_npm_registry %} using a Personal Access Token (PAT).
If the **Inherit access from repo** option was not selected when the image was published, you can manually add the repository to the published container image's access controls. For more information, see "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#inheriting-access-for-a-container-image-from-a-repository)."
@@ -46,13 +46,13 @@ If you want to allow a subset of an organization's repositories to access a cont
### Publishing a container image from a codespace
-Seamless access from a codespace to {% data variables.product.prodname_ghcr_or_npm_registry %} is limited to pulling container images. If you want to publish a container image from inside a codespace, you must use a personal access token (PAT) with the `write:packages` scope.
+Seamless access from a codespace to {% data variables.packages.prodname_ghcr_or_npm_registry %} is limited to pulling container images. If you want to publish a container image from inside a codespace, you must use a personal access token (PAT) with the `write:packages` scope.
We recommend publishing images via {% data variables.product.prodname_actions %}. For more information, see "[Publishing Docker images](/actions/publishing-packages/publishing-docker-images)" and "[Publishing Node.js packages](/actions/publishing-packages/publishing-nodejs-packages)."
## Accessing images stored in other container registries
-If you are accessing a container image from a registry that isn't {% data variables.product.prodname_ghcr_or_npm_registry %}, {% data variables.product.prodname_github_codespaces %} checks for the presence of three secrets, which define the server name, username, and personal access token (PAT) for a container registry. If these secrets are found, {% data variables.product.prodname_github_codespaces %} will make the registry available inside your codespace.
+If you are accessing a container image from a registry that isn't {% data variables.packages.prodname_ghcr_or_npm_registry %}, {% data variables.product.prodname_github_codespaces %} checks for the presence of three secrets, which define the server name, username, and personal access token (PAT) for a container registry. If these secrets are found, {% data variables.product.prodname_github_codespaces %} will make the registry available inside your codespace.
- `<*>_CONTAINER_REGISTRY_SERVER`
- `<*>_CONTAINER_REGISTRY_USER`
diff --git a/translations/es-ES/content/codespaces/codespaces-reference/index.md b/translations/es-ES/content/codespaces/codespaces-reference/index.md
index 7c3b8c6374..3f347c7c57 100644
--- a/translations/es-ES/content/codespaces/codespaces-reference/index.md
+++ b/translations/es-ES/content/codespaces/codespaces-reference/index.md
@@ -6,7 +6,6 @@ versions:
ghec: '*'
product: '{% data reusables.gated-features.codespaces %}'
children:
- - /understanding-billing-for-github-codespaces
- /allowing-your-codespace-to-access-a-private-image-registry
- /using-github-copilot-in-github-codespaces
- /using-the-vs-code-command-palette-in-codespaces
diff --git a/translations/es-ES/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md b/translations/es-ES/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md
deleted file mode 100644
index f6a802c687..0000000000
--- a/translations/es-ES/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md
+++ /dev/null
@@ -1,63 +0,0 @@
----
-title: Understanding billing for GitHub Codespaces
-intro: 'Learn how your {% data variables.product.prodname_github_codespaces %} usage is billed.'
-versions:
- fpt: '*'
- ghec: '*'
-redirect_from:
- - /github/developing-online-with-codespaces/about-billing-for-codespaces
- - /codespaces/getting-started-with-codespaces/about-billing-for-codespaces
- - /codespaces/codespaces-reference/about-billing-for-codespaces
- - /codespaces/codespaces-reference/understanding-billing-for-codespaces
-type: reference
-topics:
- - Codespaces
- - Billing
-product: '{% data reusables.gated-features.codespaces %}'
-shortTitle: Understanding billing
----
-
-This article explains how billing works for your codespaces, and explains how your organization's billing manager can help.
-
-## Getting access to {% data variables.product.prodname_github_codespaces %}
-
-Your organization's administrator might limit {% data variables.product.prodname_github_codespaces %} usage to only specific personal accounts. To get access, you will need to contact your billing manager. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)."
-
-## How much it costs to use {% data variables.product.prodname_codespaces %}
-
-To see the pricing for {% data variables.product.prodname_github_codespaces %} usage, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-codespaces#codespaces-pricing)."
-
-## How your codespace usage is billed
-
-Your codespace is billed for its compute minutes and for the amount of storage it uses on disk.
-
-If you enable prebuilding of codespaces this will incur additional charges. For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds#about-billing-for-codespaces-prebuilds)."
-
-### Understanding what compute minutes are
-Your codespace is billed for the number of minutes that it's active. If your codespaces window is left idle for 30 minutes, it will automatically shutdown, and compute billing for the codespace will end until you start the codespace again.
-
-### Understanding how codespace storage is billed
-For {% data variables.product.prodname_github_codespaces %}, storage is defined to include any files relating to your codespace, such as the cloned repository, configuration files, and extensions, among others. This storage is billed while your codespace is shutdown. The storage billing for a codespace ends when you manually delete it from https://github.com/codespaces.
-
-## How spending limits work
-
-Before your organization can use {% data variables.product.prodname_github_codespaces %}, your billing manager will need to set a spending limit. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)."
-
-## Exporting changes when you have reached your spending limit
-
-{% data reusables.codespaces.exporting-changes %}
-
-## Checking your current usage and limits
-If you need to check your current usage or spending limit, contact your organization's billing manager. For more information, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)."
-
-## Codespaces can be automatically deleted
-
-Your codespace will be automatically deleted when you are removed from an organization or repository.
-
-## Deleting your unused codespaces
-
-You can manually delete your codespaces in https://github.com/codespaces and from within {% data variables.product.prodname_vscode %}. To reduce the size of a codespace, you can manually delete files using the terminal or from within {% data variables.product.prodname_vscode %}.
-
-## Further reading
-
-- "[Managing billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization)"
diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md b/translations/es-ES/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md
index 2465cfe69e..d3ec7e7ef3 100644
--- a/translations/es-ES/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md
+++ b/translations/es-ES/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md
@@ -71,7 +71,7 @@ If you try to delete a codespace with unpushed git commits, your editor will not
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)."
-You will be charged for the storage of all your codespaces. When you delete a codespace, you will no longer be charged.
+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)."
diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/index.md b/translations/es-ES/content/codespaces/developing-in-codespaces/index.md
index 2853830f88..20b0ca7bf8 100644
--- a/translations/es-ES/content/codespaces/developing-in-codespaces/index.md
+++ b/translations/es-ES/content/codespaces/developing-in-codespaces/index.md
@@ -11,12 +11,12 @@ children:
- /codespaces-lifecycle
- /developing-in-a-codespace
- /creating-a-codespace
+ - /deleting-a-codespace
- /opening-an-existing-codespace
- /using-source-control-in-your-codespace
- /using-github-codespaces-for-pull-requests
- /stopping-and-starting-a-codespace
- /renaming-a-codespace
- - /deleting-a-codespace
- /forwarding-ports-in-your-codespace
- /default-environment-variables-for-your-codespace
- /connecting-to-a-private-network
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 782e475ffb..c6a2e16f8a 100644
--- a/translations/es-ES/content/codespaces/getting-started/deep-dive.md
+++ b/translations/es-ES/content/codespaces/getting-started/deep-dive.md
@@ -117,6 +117,6 @@ If you already use {% data variables.product.prodname_vscode_shortname %}, you c
## 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 billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)"
- "[Codespaces lifecycle](/codespaces/developing-in-codespaces/codespaces-lifecycle)"
diff --git a/translations/es-ES/content/codespaces/getting-started/quickstart.md b/translations/es-ES/content/codespaces/getting-started/quickstart.md
index 3aa2d59490..213fec6823 100644
--- a/translations/es-ES/content/codespaces/getting-started/quickstart.md
+++ b/translations/es-ES/content/codespaces/getting-started/quickstart.md
@@ -111,4 +111,4 @@ You've successfully created, personalized, and run your first application within
## 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 billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)"
diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md
index ff040d9a82..25d134cf2a 100644
--- a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md
+++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md
@@ -19,7 +19,7 @@ topics:
## About enabling {% data variables.product.prodname_github_codespaces %} for your organization
-Organization owners can control which users in your organization can create and use codespaces at the organization's expense.
+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 GitHub Codespaces](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)."
Only people who can clone a repository can create a codespace for that repository. To allow people to create codespaces for repositories owned by your organization, you must:
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 9b6b0ec70c..7e160fd83f 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
@@ -11,7 +11,7 @@ topics:
children:
- /enabling-github-codespaces-for-your-organization
- /listing-the-codespaces-in-your-organization
- - /managing-billing-for-github-codespaces-in-your-organization
+ - /managing-the-cost-of-github-codespaces-in-your-organization
- /managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces
- /managing-repository-access-for-your-organizations-codespaces
- /reviewing-your-organizations-audit-logs-for-github-codespaces
diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md
deleted file mode 100644
index b00448e35b..0000000000
--- a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md
+++ /dev/null
@@ -1,62 +0,0 @@
----
-title: Managing billing for GitHub Codespaces in your organization
-shortTitle: Manage billing
-intro: 'You can check your {% data variables.product.prodname_github_codespaces %} usage and set usage limits.'
-product: '{% data reusables.gated-features.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
----
-
-## Overview
-
-To learn about pricing for {% data variables.product.prodname_github_codespaces %}, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)."
-
-{% data reusables.codespaces.codespaces-billing %}
-
-- As an organization owner or a billing manager, you can manage {% data variables.product.prodname_github_codespaces %} billing for your organization: ["About billing for Codespaces"](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)
-- As an organization owner, you can list the currently active and stopped codespaces for your organization. In addition to these codespaces, costs for the current month may include costs for codespaces that existed earlier in the current month but have since been deleted.
-- For users, there is a guide that explains how billing works: ["Understanding billing for {% data variables.product.prodname_github_codespaces %}"](/codespaces/codespaces-reference/understanding-billing-for-github-codespaces)
-
-## Usage limits
-
-You can set a usage limit for the codespaces in your organization or repository. This limit is applied to the compute and storage usage for {% data variables.product.prodname_github_codespaces %}:
-
-- **Compute minutes:** Compute usage is calculated by the actual number of minutes used by all {% data variables.product.prodname_github_codespaces %} instances while they are active. These totals are reported to the billing service daily, and is billed monthly. You can set a spending limit for {% data variables.product.prodname_github_codespaces %} usage in your organization. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)."
-
-- **Storage usage:** For {% data variables.product.prodname_github_codespaces %} billing purposes, this includes all storage used by all codespaces in your account. This includes resources such as cloned repositories, configuration files, and extensions, among others. These totals are reported to the billing service daily, and is billed monthly. At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB. To check how many compute minutes and storage GB have been used by {% data variables.product.prodname_github_codespaces %}, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage"](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)."
-
-## Disabling or limiting {% data variables.product.prodname_codespaces %}
-
-You can disable all use of {% data variables.product.prodname_github_codespaces %} that would be billed to your organization. Alternatively, you can specify which organization members or collaborators can use {% data variables.product.prodname_codespaces %} at your 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-disabling-org-billing %}
-
-You can configure which repositories can be accessed from codespaces created for a particular repository. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)."
-
-You can limit the choice of types of machine that are available for codespaces created from repositories owned by your organization. This allows you to prevent people using overly resourced machines for their codespaces, and incurring unnecessary charges. For more information, see "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)."
-
-You can also restrict how long a codespace can remain unused before it is automatically deleted. This can help to reduce storage costs for {% data variables.product.prodname_codespaces %}. For more information, see "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)."
-
-## Deleting unused codespaces
-
-Your users can delete their own codespaces in https://github.com/codespaces and from within {% data variables.product.prodname_vscode %}. To reduce the size of a codespace, users can manually delete files using the terminal or from within {% data variables.product.prodname_vscode_shortname %}.
-
-As an organization owner, you can delete any codespace in your organization. For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)."
-
-{% note %}
-
-**Note:** Codespaces are automatically deleted after they have been stopped and have remained inactive for a defined number of days. For more information, see "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)." A codespace can only be manually deleted by the person who created the codespace.
-
-{% endnote %}
-
-## Further reading
-
-- "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)"
diff --git a/translations/es-ES/content/codespaces/overview.md b/translations/es-ES/content/codespaces/overview.md
index 4c07f6674a..1a6ee65780 100644
--- a/translations/es-ES/content/codespaces/overview.md
+++ b/translations/es-ES/content/codespaces/overview.md
@@ -40,6 +40,8 @@ You can also personalize aspects of your codespace environment by using a public
For information on pricing, storage, and usage for {% data variables.product.prodname_github_codespaces %}, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)."
-{% data reusables.codespaces.codespaces-spending-limit-requirement %} For information on how organizations owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an organization, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)."
+{% data reusables.codespaces.codespaces-spending-limit-requirement %}
+
+{% data reusables.codespaces.codespaces-monthly-billing %} For information on how organizations owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an organization, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)."
You can see who will pay for a codespace before you create it. For more information, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)."
\ No newline at end of file
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 8b6652eee4..9bbee8317c 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
@@ -14,7 +14,9 @@ redirect_from:
## Overview
-Prebuilding your codespaces allows you to be more productive and access your codespace faster, particularly if your repository is large or complex and new codespaces currently take more than 2 minutes to start. This is because any source code, editor extensions, project dependencies, commands, and configurations have already been downloaded, installed, and applied before you create a codespace for your project. Think of a prebuild as a "ready-to-go" template for a codespace.
+{% 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.
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.
@@ -28,16 +30,10 @@ To create a prebuild you set up a prebuild configuration. When you save the conf
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.
+As with other Actions workflows, running a prebuild configuration workflow will either consume some of the Actions minutes included with your account, if you have any, or it will incur charges for 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)."
+
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.
-## About billing for {% data variables.product.prodname_codespaces %} prebuilds
-
-{% data reusables.codespaces.billing-for-prebuilds-default %} For details of {% data variables.product.prodname_github_codespaces %} storage pricing, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)."
-
-{% data reusables.codespaces.billing-for-prebuilds-reducing %}
-
-Use of codespaces created using prebuilds is charged at the same rate as regular codespaces.
-
## 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 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.
diff --git a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md
index 9c44b43045..5f8d82217a 100644
--- a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md
+++ b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md
@@ -61,7 +61,7 @@ Before you can configure prebuilds for your project the following must be true:
{% note %}
**Notes**:
- * The prebuild for each region will incur individual charges. You should, therefore, only enable prebuilds for regions in which you know they'll be used. For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds#about-billing-for-codespaces-prebuilds)."
+ * The prebuild for each region will incur individual charges. You should, therefore, only enable prebuilds for regions in which you know they'll be used. 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)."
* Developers can set their default region for {% data variables.product.prodname_github_codespaces %}, which can allow you to enable prebuilds for fewer regions. For more information, see "[Setting your default region for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)."
{% endnote %}
diff --git a/translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md b/translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md
index c357bd8cbc..7898abc4e9 100644
--- a/translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md
+++ b/translations/es-ES/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md
@@ -1,6 +1,6 @@
---
-title: Referencias y direcciones URL autovinculadas
-intro: 'Las referencias a las direcciones URL, propuestas, solicitudes de extracción y confirmaciones se acortan automáticamente y se convierten en vínculos.'
+title: Autolinked references and URLs
+intro: 'References to URLs, issues, pull requests, and commits are automatically shortened and converted into links.'
redirect_from:
- /articles/autolinked-references-and-urls
- /github/writing-on-github/autolinked-references-and-urls
@@ -11,68 +11,68 @@ versions:
ghae: '*'
ghec: '*'
shortTitle: Auto linked references
-ms.openlocfilehash: 6f6548dbe931a7a6adb809aa4e5616db4358c242
-ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
-ms.translationtype: HT
-ms.contentlocale: es-ES
-ms.lasthandoff: 09/05/2022
-ms.locfileid: '147419693'
---
## URLs
-{% data variables.product.product_name %} automáticamente crea vínculos desde las direcciones URL estándar.
+{% data variables.product.product_name %} automatically creates links from standard URLs.
`Visit https://github.com`
-
+
-Para obtener más información sobre la creación de vínculos, consulta "[Sintaxis de escritura y formato básicos](/articles/basic-writing-and-formatting-syntax/#links)".
+For more information on creating links, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax/#links)."
-## Propuestas y solicitudes de extracción
+## Issues and pull requests
-Dentro de las conversaciones en {% data variables.product.product_name %}, las referencias a las propuestas y solicitudes de extracción se convierten automáticamente en vínculos acortados.
+Within conversations on {% data variables.product.product_name %}, references to issues and pull requests are automatically converted to shortened links.
{% note %}
-**Nota:** Las referencias vinculadas automáticamente no se crean en wikis ni archivos en un repositorio.
+**Note:** Autolinked references are not created in wikis or files in a repository.
{% endnote %}
-| Tipo de referencia | Referencia sin formato | Vínculo corto |
+| Reference type | Raw reference | Short link |
| --- | --- | --- |
-| Dirección URL de la solicitud de incorporación de cambios o el problema | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26)
-| `#` y número de la solicitud de incorporación de cambios o el problema | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) |
-| `GH-` y número de la solicitud de incorporación de cambios o el problema | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) |
-| `Username/Repository#` y número de la solicitud de incorporación de cambios o el problema | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26)
-| `Organization_name/Repository#` y número de la solicitud de incorporación de cambios o el problema | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039)
+| Issue or pull request URL | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26)
+| `#` and issue or pull request number | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) |
+| `GH-` and issue or pull request number | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) |
+| `Username/Repository#` and issue or pull request number | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26)
+| `Organization_name/Repository#` and issue or pull request number | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039)
-{% ifversion fpt or ghec %} Si referencias una propuesta, una solicitud de cambios o un debate en una lista, la referencia se desplegará para mostrar el título y el estado en su lugar. Para obtener más información sobre las listas de tareas, consulta "[Acerca de las listas de tareas](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)".
+{% ifversion fpt or ghec %}
+If you reference an issue, pull request, or discussion in a list, the reference will unfurl to show the title and state instead. For more information about task lists, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)."
{% endif %}
-## Etiquetas
-Al hacer referencia a la URL de una etiqueta en Markdown, la etiqueta se representa automáticamente. Solo se representan las etiquetas del mismo repositorio, las direcciones URL que apuntan a una etiqueta de otro repositorio se representan como cualquier [dirección URL](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#urls).
+## Labels
+When referencing the URL of a label in Markdown, the label is automatically rendered. Only labels of the same repository are rendered, URLs pointing to a label from a different repository are rendered as any [URL](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#urls).
-Para encontrar la dirección URL de una etiqueta, navega a la página Etiquetas y haz clic en una etiqueta. Por ejemplo, la dirección URL de la etiqueta "mejora" en nuestro [repositorio de documentación](https://github.com/github/docs/) público es
+The URL of a label can be found by navigating to the labels page and clicking on a label. For example, the URL of the label "enhancement" in our public [docs repository](https://github.com/github/docs/) is
```md
https://github.com/github/docs/labels/enhancement
```
+{% note %}
-## Confirmar SHA
+**Note:** If the label name contains a period (`.`), the label will not automatically render from the label URL.
-Las referencias a un hash SHA de confirmación se convertirán automáticamente en enlaces acortados para la confirmación en {% data variables.product.product_name %}.
+{% endnote %}
-| Tipo de referencia | Referencia sin formato | Vínculo corto |
+## Commit SHAs
+
+References to a commit's SHA hash are automatically converted into shortened links to the commit on {% data variables.product.product_name %}.
+
+| Reference type | Raw reference | Short link |
| --- | --- | --- |
-| Dirección URL de confirmación | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) |
+| Commit URL | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) |
| SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) |
| User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e)
| `Username/Repository@SHA` | `jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e` | [`jlord/sheetsee.js@a5c3785`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) |
-## Personalizar enlaces automáticos a recursos externos
+## Custom autolinks to external resources
{% data reusables.repositories.autolink-references %}
-## Información adicional
+## Further reading
-- "[Sintaxis de escritura y formato básicos](/articles/basic-writing-and-formatting-syntax)"
+- "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax)"
diff --git a/translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md b/translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md
index 18235d4ef4..68dd781bd9 100644
--- a/translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md
+++ b/translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md
@@ -26,14 +26,14 @@ The {% data variables.product.prodname_registry %} registries below **only** use
- Apache Maven registry
- NuGet registry
-{% ifversion packages-npm-v2 %}For {% data variables.product.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %}
+{% ifversion packages-npm-v2 %}For {% data variables.packages.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %}
{% ifversion fpt or ghec %}
## Granular permissions for user/organization-scoped packages
Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of the package separately from a repository that is connected (or linked) to a package.
-Currently, the {% data variables.product.prodname_ghcr_and_npm_registry %} offer granular permissions for your container image packages.
+Currently, the {% data variables.packages.prodname_ghcr_and_npm_registry %} offer granular permissions for your container image packages.
## Visibility and access permissions for container images
diff --git a/translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md b/translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md
index 536a07b00e..3e7204200c 100644
--- a/translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md
+++ b/translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md
@@ -15,7 +15,7 @@ shortTitle: Access control & visibility
Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of a package separately from the repository that it is connected (or linked) to.
-Currently, you can only use granular permissions with the {% data variables.product.prodname_ghcr_and_npm_registry %}. Granular permissions are not supported in our other package registries, such as the RubyGems registry.{% ifversion docker-ghcr-enterprise-migration %} For more information about migration to the {% data variables.product.prodname_container_registry %}, see "[Migrating to the {% data variables.product.prodname_container_registry %} from the Docker registry](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)."{% endif %}
+Currently, you can only use granular permissions with the {% data variables.packages.prodname_ghcr_and_npm_registry %}. Granular permissions are not supported in our other package registries, such as the RubyGems registry.{% ifversion docker-ghcr-enterprise-migration %} For more information about migration to the {% data variables.product.prodname_container_registry %}, see "[Migrating to the {% data variables.product.prodname_container_registry %} from the Docker registry](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)."{% endif %}
For more information about permissions for repository-scoped packages, packages-related scopes for PATs, or managing permissions for your actions workflows, see "[About permissions for GitHub Packages](/packages/learn-github-packages/about-permissions-for-github-packages)."
@@ -105,7 +105,7 @@ To further customize access to your container image, see "[Configuring access to
{% ifversion fpt or ghec %}
## Ensuring {% data variables.product.prodname_github_codespaces %} access to your package
-By default, a codespace can seamlessly access certain packages in the {% data variables.product.prodname_ghcr_and_npm_registry %}, such as those published in the same repository with the **Inherit access** option selected. For more information on which access is automatically configured, see "[Allowing your codespace to access a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry#accessing-images-stored-in-container-registry-and-npm-registry)."
+By default, a codespace can seamlessly access certain packages in the {% data variables.packages.prodname_ghcr_and_npm_registry %}, such as those published in the same repository with the **Inherit access** option selected. For more information on which access is automatically configured, see "[Allowing your codespace to access a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry#accessing-images-stored-in-container-registry-and-npm-registry)."
Otherwise, to ensure that a codespace has access to your package, you must grant access to the repository where the codespace is being launched.
diff --git a/translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md b/translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md
index 65c5f9c589..f3595a34ff 100644
--- a/translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md
+++ b/translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md
@@ -1,6 +1,6 @@
---
-title: Borrar y restablecer un paquete
-intro: Aprende cómo borrar o restablecer un paquete.
+title: Deleting and restoring a package
+intro: Learn how to delete or restore a package.
product: '{% data reusables.gated-features.packages %}'
redirect_from:
- /github/managing-packages-with-github-packages/deleting-a-package
@@ -13,90 +13,88 @@ versions:
ghec: '*'
ghae: '*'
shortTitle: Delete & restore a package
-ms.openlocfilehash: 4491e7cd25fbec2a19abb06c552ba0e0d3ac7b24
-ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
-ms.translationtype: HT
-ms.contentlocale: es-ES
-ms.lasthandoff: 09/09/2022
-ms.locfileid: '147704991'
---
+
{% data reusables.package_registry.packages-ghes-release-stage %}
-## Soporte para borrado y restablecimiento de paquetes en {% data variables.product.prodname_dotcom %}
+## Package deletion and restoration support on {% data variables.product.prodname_dotcom %}
-En {% data variables.product.prodname_dotcom %}, si tienes el acceso necesario, puedes borrar:
-- todo un paquete privado
-- todo un paquete público, si es que no hay más de 5000 descargas de ninguna versión de este
-- una versión específica de un paquete privado
-- una versión específica de un paquete público, si la versión del paquete no tiene más de 5000 descargas
+On {% data variables.product.prodname_dotcom %} if you have the required access, you can delete:
+- an entire private package
+- an entire public package, if there's not more than 5000 downloads of any version of the package
+- a specific version of a private package
+- a specific version of a public package, if the package version doesn't have more than 5,000 downloads
{% note %}
-**Nota:**
-- No puedes eliminar un paquete público específico si alguna versión del paquete tiene más de 5000 descargas. Ante este escenario, ponte en contacto con el equipo de [soporte técnico de GitHub](https://support.github.com/contact?tags=docs-packages) para obtener más ayuda.
-- Cuando borres paquetes públicos, toma en cuenta que podrías dañar proyetos que dependen de ellos.
+**Note:**
+- You cannot delete a public package if any version of the package has more than 5,000 downloads. In this scenario, contact [GitHub support](https://support.github.com/contact?tags=docs-packages) for further assistance.
+- When deleting public packages, be aware that you may break projects that depend on your package.
{% endnote %}
-En {% data variables.product.prodname_dotcom %}, también puedes restablecer un paquete completo o una versión de paquete si:
-- Restableces el paquete dentro de los primeros 30 días después de que se borró.
-- El espacio de nombre del paquete aún se encuentra disponible y no se ha utilizado en un paquete nuevo.
+On {% data variables.product.prodname_dotcom %}, you can also restore an entire package or package version, if:
+- You restore the package within 30 days of its deletion.
+- The same package namespace is still available and not used for a new package.
{% ifversion fpt or ghec or ghes %}
-## Soporte de la API de paquetes
+## Packages API support
{% ifversion fpt or ghec %}
-Puedes utiliza la API de REST para administrar tus paquetes. Para obtener más información, consulta "[API {% data variables.product.prodname_registry %}](/rest/reference/packages)".
+You can use the REST API to manage your packages. For more information, see the "[{% data variables.product.prodname_registry %} API](/rest/reference/packages)."
{% endif %}
-En el caso de los paquetes que heredan sus permisos y acceso desde repositorios, puedes usar GraphQL para eliminar una versión específica de paquete.{% data reusables.package_registry.no-graphql-to-delete-packages %} Para obtener más información sobre la compatibilidad con GraphQL, consulta «[Eliminación de una versión de un paquete con ámbito de repositorio con GraphQL](#deleting-a-version-of-a-repository-scoped-package-with-graphql)».
+For packages that inherit their permissions and access from repositories, you can use GraphQL to delete a specific package version.{% data reusables.package_registry.no-graphql-to-delete-packages %} For more information about GraphQL support, see "[Deleting a version of a repository-scoped package with GraphQL](#deleting-a-version-of-a-repository-scoped-package-with-graphql)."
{% endif %}
-## Permisos necesarios para borrar o restablecer un paquete
+## Required permissions to delete or restore a package
-En el caso de los paquetes que heredan sus permisos de acceso de los repositorios, puedes borrar un paquete si tienes permisos administrativos en el repositorio.
+For packages that inherit their access permissions from repositories, you can delete a package if you have admin permissions to the repository.
-Los registros {% data variables.product.prodname_registry %} que se mencionan a continuación **solo** utilizan permisos con ámbito de repositorio:
+The {% data variables.product.prodname_registry %} registries below **only** use repository-scoped permissions:
- {% ifversion not fpt or ghec %}: Imágenes de Docker en `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`{% endif %} {% ifversion packages-npm-v2 %}{% else %}: npm{% endif %}
- - Registro de RubyGems
- - Registro de Apache maven
- - Registro de NuGet
+ {% ifversion not fpt or ghec %}- Docker images at `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE-NAME`{% endif %}
+ {% ifversion packages-npm-v2 %}{% else %}- npm{% endif %}
+ - RubyGems registry
+ - Apache Maven registry
+ - NuGet registry
-{% ifversion packages-npm-v2 %}Para {% data variables.product.prodname_ghcr_and_npm_registry %}, puedes optar por permitir que los paquetes estén en el ámbito de un usuario o una organización, o vinculados a un repositorio.{% endif %}
+{% ifversion packages-npm-v2 %}For {% data variables.packages.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %}
{% ifversion fpt or ghec %}
-Para eliminar un paquete que tenga permisos pormenorizados separados de un repositorio, tales como imágenes de contenedor que se almacenan en `https://ghcr.io/OWNER/PACKAGE-NAME` o `https://npm.pkg.github.com/OWNER/PACKAGE-NAME`, debes tener acceso de administrador al paquete. Para más información, vea "[Acerca de los permisos para {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages)".
+To delete a package that has granular permissions separate from a repository, such as container images stored at `https://ghcr.io/OWNER/PACKAGE-NAME` or `https://npm.pkg.github.com/OWNER/PACKAGE-NAME`, you must have admin access to the package. For more information, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages)."
{% endif %}
-## Borrar la versión de un paquete
+## Deleting a package version
-### Borrar la versión de un paquete con alcance de repositorio en {% data variables.product.prodname_dotcom %}
+### Deleting a version of a repository-scoped package on {% data variables.product.prodname_dotcom %}
-Para borrar una versión de un paquete con alcance de repositorio debes tener permisos de administrador en el repositorio al que pertenezca dicho paquete. Para obtener más información, consulta "[Permisos necesarios](#required-permissions-to-delete-or-restore-a-package)".
+To delete a version of a repository-scoped package, you must have admin permissions to the repository that owns the package. For more information, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)."
-{% data reusables.repositories.navigate-to-repo %} {% data reusables.package_registry.packages-from-code-tab %} {% data reusables.package_registry.package-settings-option %}
-5. A la izquierda, haz clic en **Administrar versiones**.
-5. A la derecha de la versión que quieres eliminar, haz clic en {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} y selecciona **Eliminar versión**.
- 
-6. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en **Entiendo las consecuencias y quiero eliminar esta versión**.
- 
+{% data reusables.repositories.navigate-to-repo %}
+{% data reusables.package_registry.packages-from-code-tab %}
+{% data reusables.package_registry.package-settings-option %}
+5. On the left, click **Manage versions**.
+5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**.
+ 
+6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**.
+ 
{% ifversion fpt or ghec or ghes %}
-### Borrar una versión de un paquete con alcance de repositorio con GraphQL
+### Deleting a version of a repository-scoped package with GraphQL
-En el caso de los paquetes que heredan sus permisos y acceso de los repositorios, puedes utilizar a GraphQL para borrar las versiones específicas de estos.
+For packages that inherit their permissions and access from repositories, you can use the GraphQL to delete a specific package version.
-{% data reusables.package_registry.no-graphql-to-delete-packages %}{% ifversion fpt or ghec %} Sin embargo, puedes usar la API de REST. Para obtener más información, consulta «[API de {% data variables.product.prodname_registry %}](/rest/reference/packages)».{% endif %}
+{% data reusables.package_registry.no-graphql-to-delete-packages %}{% ifversion fpt or ghec %} You can however use the REST API. For more information, see the "[{% data variables.product.prodname_registry %} API](/rest/reference/packages)."{% endif %}
-Usa la mutación `deletePackageVersion` en GraphQL API. Debes usar un token con los ámbitos `read:packages`, `delete:packages` y `repo`. Para obtener más información, consulta "[Acerca de {% data variables.product.prodname_registry %}](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)."
+Use the `deletePackageVersion` mutation in the GraphQL API. You must use a token with the `read:packages`, `delete:packages`, and `repo` scopes. For more information about tokens, see "[About {% data variables.product.prodname_registry %}](/packages/publishing-and-managing-packages/about-github-packages#authenticating-to-github-packages)."
-En el ejemplo siguiente se muestra cómo eliminar una versión de paquete mediante un elemento `packageVersionId` de `MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg`.
+The following example demonstrates how to delete a package version, using a `packageVersionId` of `MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg`.
```shell
curl -X POST \
@@ -106,136 +104,148 @@ curl -X POST \
HOSTNAME/graphql
```
-Para encontrar todos los paquetes privados que has publicado en {% data variables.product.prodname_registry %}, junto con los identificadores de versión de los paquetes, puedes usar la conexión `packages` mediante el objeto `repository`. Necesitarás un token con los ámbitos `read:packages` y `repo`. Para obtener más información, consulta la conexión [`packages`](/graphql/reference/objects#repository) o la interfaz [`PackageOwner`](/graphql/reference/interfaces#packageowner).
+To find all of the private packages you have published to {% data variables.product.prodname_registry %}, along with the version IDs for the packages, you can use the `packages` connection through the `repository` object. You will need a token with the `read:packages` and `repo` scopes. For more information, see the [`packages`](/graphql/reference/objects#repository) connection or the [`PackageOwner`](/graphql/reference/interfaces#packageowner) interface.
-Para obtener más información sobre la mutación `deletePackageVersion`, consulta "[`deletePackageVersion`](/graphql/reference/mutations#deletepackageversion)".
+For more information about the `deletePackageVersion` mutation, see "[`deletePackageVersion`](/graphql/reference/mutations#deletepackageversion)."
-No puedes borrar directamente todo un paquete utilizando GraphQL, pero si borras cada versión de un paquete, este ya no se mostrará en {% data variables.product.product_name %}.
+You cannot directly delete an entire package using GraphQL, but if you delete every version of a package, the package will no longer show on {% data variables.product.product_name %}.
{% endif %}
{% ifversion fpt or ghec %}
-### Borrar una versión de un paquete con alcance de usuario en {% data variables.product.prodname_dotcom %}
+### Deleting a version of a user-scoped package on {% data variables.product.prodname_dotcom %}
-Para eliminar una versión específica de un paquete con ámbito de usuario en {% data variables.product.prodname_dotcom %}, como una imagen de Docker en `ghcr.io`, sigue estos pasos. Para eliminar un paquete completo, consulta "[Eliminación de un paquete de ámbito de usuario completo en {% data variables.product.prodname_dotcom %}](#deleting-an-entire-user-scoped-package-on-github)."
+To delete a specific version of a user-scoped package on {% data variables.product.prodname_dotcom %}, such as for a Docker image at `ghcr.io`, use these steps. To delete an entire package, see "[Deleting an entire user-scoped package on {% data variables.product.prodname_dotcom %}](#deleting-an-entire-user-scoped-package-on-github)."
-Para revisar quién puede eliminar una versión del paquete, consulta "[Permisos necesarios](#required-permissions-to-delete-or-restore-a-package)".
+To review who can delete a package version, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)."
-{% data reusables.package_registry.package-settings-from-user-level %} {% data reusables.package_registry.package-settings-option %}
-5. A la izquierda, haz clic en **Administrar versiones**.
-5. A la derecha de la versión que quieres eliminar, haz clic en {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} y selecciona **Eliminar versión**.
- 
-6. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en **Entiendo las consecuencias y quiero eliminar esta versión**.
- 
+{% data reusables.package_registry.package-settings-from-user-level %}
+{% data reusables.package_registry.package-settings-option %}
+5. On the left, click **Manage versions**.
+5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**.
+ 
+6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**.
+ 
-### Borrar una versión de un paquete con alcance de organización en {% data variables.product.prodname_dotcom %}
+### Deleting a version of an organization-scoped package on {% data variables.product.prodname_dotcom %}
-Para eliminar una versión específica de un paquete con ámbito de organización en {% data variables.product.prodname_dotcom %}, como una imagen de Docker en `ghcr.io`, sigue estos pasos.
-Para eliminar un paquete completo, consulta "[Eliminación de un paquete de ámbito de organización completo en {% data variables.product.prodname_dotcom %}](#deleting-an-entire-organization-scoped-package-on-github)."
+To delete a specific version of an organization-scoped package on {% data variables.product.prodname_dotcom %}, such as for a Docker image at `ghcr.io`, use these steps.
+To delete an entire package, see "[Deleting an entire organization-scoped package on {% data variables.product.prodname_dotcom %}](#deleting-an-entire-organization-scoped-package-on-github)."
-Para revisar quién puede elimninar una versión de paquete, consulta "[Permisos necesarios para eliminar o restaurar un paquete](#required-permissions-to-delete-or-restore-a-package)."
+To review who can delete a package version, see "[Required permissions to delete or restore a package](#required-permissions-to-delete-or-restore-a-package)."
-{% data reusables.package_registry.package-settings-from-org-level %} {% data reusables.package_registry.package-settings-option %}
-5. A la izquierda, haz clic en **Administrar versiones**.
-5. A la derecha de la versión que quieres eliminar, haz clic en {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} y selecciona **Eliminar versión**.
- 
-6. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en **Entiendo las consecuencias y quiero eliminar esta versión**.
-  {% endif %}
-
-## Borrar un paquete completo
-
-### Borrar un paquete completo con alcance de repositorio en {% data variables.product.prodname_dotcom %}
-
-Para borrar un paquete completo con alcance de repositorio, debes tener permisos administrativos en el repositorio al que pertenezca dicho paquete. Para obtener más información, consulta "[Permisos necesarios](#required-permissions-to-delete-or-restore-a-package)".
-
-{% data reusables.repositories.navigate-to-repo %} {% data reusables.package_registry.packages-from-code-tab %} {% data reusables.package_registry.package-settings-option %}
-4. En "Zona de peligro", haz clic en **Eliminar este paquete**.
-5. Para confirmarlo, revisa el mensaje de confirmación, escribe el nombre de tu paquete y haz clic en **Lo entiendo y quiero eliminar este paquete.**
- 
-
-{% ifversion fpt or ghec %}
-### Borrar un paquete completo con alcance de usuario en {% data variables.product.prodname_dotcom %}
-
-Para revisar quién puede eliminar un paquete, consulta "[Permisos necesarios](#required-permissions-to-delete-or-restore-a-package)".
-
-{% data reusables.package_registry.package-settings-from-user-level %} {% data reusables.package_registry.package-settings-option %}
-5. A la izquierda, haz clic en **Opciones**.
- 
-6. En "Zona de peligro", haz clic en **Eliminar este paquete**.
- 
-6. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en **Entiendo las consecuencias y quiero eliminar este paquete**.
- 
-
-### Borrar un paquete completo con alcance de organización en {% data variables.product.prodname_dotcom %}
-
-Para revisar quién puede eliminar un paquete, consulta "[Permisos necesarios](#required-permissions-to-delete-or-restore-a-package)".
-
-{% data reusables.package_registry.package-settings-from-org-level %} {% data reusables.package_registry.package-settings-option %}
-5. A la izquierda, haz clic en **Opciones**.
- 
-6. En "Zona de peligro", haz clic en **Eliminar este paquete**.
- 
-6. Para confirmar la eliminación, escribe el nombre del paquete y haz clic en **Entiendo las consecuencias y quiero eliminar este paquete**.
-  {% endif %}
-
-## Restablecer paquetes
-
-Puedes restablecer un paquete o versión que hayas borrado si:
-- Restableces el paquete dentro de los primeros 30 días después de que se borró.
-- El mismo designador de nombre del paquete y su versión se encuentran disponibles y no se han reutilizado para un paquete nuevo.
-
-Por ejemplo, si tienes un paquete RubyGems eliminado denominado `octo-package` que tenía como ámbito el repositorio `octo-repo-owner/octo-repo`, solo puedes restaurar el paquete si el espacio de nombres `rubygem.pkg.github.com/octo-repo-owner/octo-repo/octo-package` del paquete todavía está disponible y aún no han transcurrido 30 días.
-
-{% ifversion fpt or ghec %} Para restaurar un paquete eliminado, también debes cumplir uno de estos requisitos de permisos:
- - Para los paquetes con ámbito de repositorio: tienes permisos de administrador para el repositorio que posee el paquete eliminado.{% ifversion fpt or ghec %}
- - Para los paquetes con ámbito de cuenta de usuario: el paquete eliminado pertenece a tu cuenta de usuario.
- - Para los paquetes con ámbito de organización: tienes permisos de administrador para el paquete eliminado en la organización que posee el paquete.{% endif %} {% endif %}
-
-{% ifversion ghae or ghes %} Para eliminar un paquete, también debes tener permisos de administrador en el repositorio que posee el paquete eliminado.
+{% data reusables.package_registry.package-settings-from-org-level %}
+{% data reusables.package_registry.package-settings-option %}
+5. On the left, click **Manage versions**.
+5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**.
+ 
+6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**.
+ 
{% endif %}
-Para obtener más información, consulta "[Permisos necesarios](#required-permissions-to-delete-or-restore-a-package)".
+## Deleting an entire package
-Una vez que se restablezca el paquete, este utilizará el designador de nombre que ya tenía. Si ya no está disponible el mismo designador de nombre del paquete, no podrás restablecerlo. En este caso, para restablecer el paquete que se borró, primero deberás borrar el paquete nuevo que utiliza el designador de nombre del paquete que se borró.
+### Deleting an entire repository-scoped package on {% data variables.product.prodname_dotcom %}
-### Restablecer un paquete en una organización
+To delete an entire repository-scoped package, you must have admin permissions to the repository that owns the package. For more information, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)."
- Puedes restablecer un paquete borrado a través de los ajustes de cuenta de tu organización, siempre y cuando el paquete estuviera en el repositorio que pertenece a esta{% ifversion fpt or ghec %} o tuviera permisos granulares y se le hubiera configurado un alcance para tu cuenta de organización{% endif %}.
+{% data reusables.repositories.navigate-to-repo %}
+{% data reusables.package_registry.packages-from-code-tab %}
+{% data reusables.package_registry.package-settings-option %}
+4. Under "Danger Zone", click **Delete this package**.
+5. To confirm, review the confirmation message, enter your package name, and click **I understand, delete this package.**
+ 
-Para revisar quién puede restaurar un paquete en una organización, consulta "[Permisos necesarios](#required-permissions-to-delete-or-restore-a-package)".
+{% ifversion fpt or ghec %}
+### Deleting an entire user-scoped package on {% data variables.product.prodname_dotcom %}
-{% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %}
-3. En la izquierda, haga clic en **Packages**.
-4. En "Paquetes eliminados", junto al paquete que quieres restaurar, haz clic en **Restaurar**.
- 
-5. Para confirmar, escribe el nombre del paquete y haz clic en **Entiendo las consecuencias y quiero restaurar este paquete**.
- 
+To review who can delete a package, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)."
+
+{% data reusables.package_registry.package-settings-from-user-level %}
+{% data reusables.package_registry.package-settings-option %}
+5. On the left, click **Options**.
+ 
+6. Under "Danger zone", click **Delete this package**.
+ 
+6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**.
+ 
+
+### Deleting an entire organization-scoped package on {% data variables.product.prodname_dotcom %}
+
+To review who can delete a package, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)."
+
+{% data reusables.package_registry.package-settings-from-org-level %}
+{% data reusables.package_registry.package-settings-option %}
+5. On the left, click **Options**.
+ 
+6. Under "Danger zone", click **Delete this package**.
+ 
+6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**.
+ 
+{% endif %}
+
+## Restoring packages
+
+You can restore a deleted package or version if:
+- You restore the package within 30 days of its deletion.
+- The same package namespace and version is still available and not reused for a new package.
+
+For example, if you have a deleted RubyGems package named `octo-package` that was scoped to the repo `octo-repo-owner/octo-repo`, then you can only restore the package if the package namespace `rubygem.pkg.github.com/octo-repo-owner/octo-repo/octo-package` is still available, and 30 days have not yet passed.
+
+{% ifversion fpt or ghec %}
+To restore a deleted package, you must also meet one of these permission requirements:
+ - For repository-scoped packages: You have admin permissions to the repository that owns the deleted package.{% ifversion fpt or ghec %}
+ - For user-account scoped packages: Your personal account owns the deleted package.
+ - For organization-scoped packages: You have admin permissions to the deleted package in the organization that owns the package.{% endif %}
+{% endif %}
+
+{% ifversion ghae or ghes %}
+To delete a package, you must also have admin permissions to the repository that owns the deleted package.
+{% endif %}
+
+For more information, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)."
+
+Once the package is restored, the package will use the same namespace it did before. If the same package namespace is not available, you will not be able to restore your package. In this scenario, to restore the deleted package, you must delete the new package that uses the deleted package's namespace first.
+
+### Restoring a package in an organization
+
+ You can restore a deleted package through your organization account settings, as long as the package was in a repository owned by the organizaton{% ifversion fpt or ghec %} or had granular permissions and was scoped to your organization account{% endif %}.
+
+To review who can restore a package in an organization, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)."
+
+{% data reusables.organizations.navigate-to-org %}
+{% data reusables.organizations.org_settings %}
+3. On the left, click **Packages**.
+4. Under "Deleted Packages", next to the package you want to restore, click **Restore**.
+ 
+5. To confirm, type the name of the package and click **I understand the consequences, restore this package**.
+ 
{% ifversion fpt or ghec %}
-### Restablecer un paquete con alcance de cuenta de usuario
+### Restoring a user-account scoped package
-Puedes restaurar un paquete que se haya eliminado mediante la configuración de tu cuenta de usuario, siempre y cuando haya estado en uno de tus repositorios o haya tenido como ámbito tu cuenta de usuario. Para obtener más información, consulta "[Permisos necesarios](#required-permissions-to-delete-or-restore-a-package)".
+You can restore a deleted package through your personal account settings, if the package was in one of your repositories or scoped to your personal account. For more information, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)."
{% data reusables.user-settings.access_settings %}
-2. En la izquierda, haga clic en **Packages**.
-4. En "Paquetes eliminados", junto al paquete que quieres restaurar, haz clic en **Restaurar**.
- 
-5. Para confirmar, escribe el nombre del paquete y haz clic en **Entiendo las consecuencias y quiero restaurar este paquete**.
- 
+2. On the left, click **Packages**.
+4. Under "Deleted Packages", next to the package you want to restore, click **Restore**.
+ 
+5. To confirm, type the name of the package and click **I understand the consequences, restore this package**.
+ 
{% endif %}
-### Restablecer la versión de un paquete
+### Restoring a package version
-Puedes restablecer una versión de paquete desde la página de llegada del mismo. Para revisar quién puede restaurar un paquete, consulta "[Permisos necesarios](#required-permissions-to-delete-or-restore-a-package)".
+You can restore a package version from your package's landing page. To review who can restore a package, see "[Required permissions](#required-permissions-to-delete-or-restore-a-package)."
-1. Navega a la página de llegada de tu paquete.
-2. A la derecha, haz clic en **Configuración del paquete**.
-2. A la izquierda, haz clic en **Administrar versiones**.
-3. A la derecha, usa el menú desplegable "Versiones" y selecciona **Eliminado**.
- 
-4. Junto a la versión del paquete eliminado que quieres restaurar, haz clic en **Restaurar**.
- 
-5. Para confirmarlo, haz clic en **Entiendo las consecuencias y quiero restaurar esta versión.**
- 
+1. Navigate to your package's landing page.
+2. On the right, click **Package settings**.
+2. On the left, click **Manage versions**.
+3. On the top right, use the "Versions" drop-down menu and select **Deleted**.
+ 
+4. Next to the deleted package version you want to restore, click **Restore**.
+ 
+5. To confirm, click **I understand the consequences, restore this version.**
+ 
diff --git a/translations/es-ES/content/packages/learn-github-packages/introduction-to-github-packages.md b/translations/es-ES/content/packages/learn-github-packages/introduction-to-github-packages.md
index 5450ffcff9..530f6d7efe 100644
--- a/translations/es-ES/content/packages/learn-github-packages/introduction-to-github-packages.md
+++ b/translations/es-ES/content/packages/learn-github-packages/introduction-to-github-packages.md
@@ -51,7 +51,7 @@ For more information about the configuration of {% data variables.product.prodna
| | |
|--------------------|--------------------|
-| Permissions | {% ifversion fpt or ghec %}The permissions for a package are either inherited from the repository where the package is hosted or, for packages in the {% data variables.product.prodname_ghcr_and_npm_registry %}, they can be defined for specific user or organization accounts. For more information, see "[Configuring a package’s access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." {% else %}Each package inherits the permissions of the repository where the package is hosted.
For example, anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version.{% endif %} |
+| Permissions | {% ifversion fpt or ghec %}The permissions for a package are either inherited from the repository where the package is hosted or, for packages in the {% data variables.packages.prodname_ghcr_and_npm_registry %}, they can be defined for specific user or organization accounts. For more information, see "[Configuring a package’s access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." {% else %}Each package inherits the permissions of the repository where the package is hosted.
For example, anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version.{% endif %} |
| Visibility | {% data reusables.package_registry.public-or-private-packages %} |
For more information, see "[About permissions for {% data variables.product.prodname_registry %}](/packages/learn-github-packages/about-permissions-for-github-packages)."
diff --git a/translations/es-ES/content/packages/learn-github-packages/viewing-packages.md b/translations/es-ES/content/packages/learn-github-packages/viewing-packages.md
index 4c67fda41e..3c239df022 100644
--- a/translations/es-ES/content/packages/learn-github-packages/viewing-packages.md
+++ b/translations/es-ES/content/packages/learn-github-packages/viewing-packages.md
@@ -31,7 +31,7 @@ Repository-scoped packages inherit their permissions and visibility from the rep
- NuGet registry
{% ifversion fpt or ghec %}
-The {% data variables.product.prodname_ghcr_and_npm_registry %} offer you the option of granular permissions and visibility settings that can be customized for each package owned by a personal user or organization account. You can choose to use granular permissions or connect the package to a repository and inherit it's permissions. For more information, see "[Connecting a repository to a package](/packages/learn-github-packages/connecting-a-repository-to-a-package)."
+The {% data variables.packages.prodname_ghcr_and_npm_registry %} offer you the option of granular permissions and visibility settings that can be customized for each package owned by a personal user or organization account. You can choose to use granular permissions or connect the package to a repository and inherit it's permissions. For more information, see "[Connecting a repository to a package](/packages/learn-github-packages/connecting-a-repository-to-a-package)."
{% endif %}
For more information, see "[About permissions for GitHub Packages](/packages/learn-github-packages/about-permissions-for-github-packages){% ifversion fpt or ghec %}" and "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility){% endif %}."
diff --git a/translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md b/translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md
index 6b3f8fc7cd..34d324af49 100644
--- a/translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md
+++ b/translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md
@@ -24,7 +24,7 @@ shortTitle: Publish & install with Actions
You can extend the CI and CD capabilities of your repository by publishing or installing packages as part of your workflow.
{% ifversion fpt or ghec %}
-### Authenticating to the {% data variables.product.prodname_ghcr_and_npm_registry %}
+### Authenticating to the {% data variables.packages.prodname_ghcr_and_npm_registry %}
{% data reusables.package_registry.authenticate_with_pat_for_v2_registry %}
@@ -40,7 +40,7 @@ You can reference the `GITHUB_TOKEN` in your workflow file using the {% raw %}`{
{% note %}
-**Note:** Some registries, such as RubyGems, {% ifversion packages-npm-v2 %}{% else %}npm, {% endif %}Apache Maven, NuGet, {% ifversion fpt or ghec %}and Gradle{% else %}Gradle, and Docker packages that use the package namespace `docker.pkg.github.com`{% endif %}, only allow repository-owned packages. With {% data variables.product.prodname_ghcr_and_npm_registry_full %} you can choose to allow packages to be owned by a user, an organization, or linked to a repository.
+**Note:** Some registries, such as RubyGems, {% ifversion packages-npm-v2 %}{% else %}npm, {% endif %}Apache Maven, NuGet, {% ifversion fpt or ghec %}and Gradle{% else %}Gradle, and Docker packages that use the package namespace `docker.pkg.github.com`{% endif %}, only allow repository-owned packages. With {% data variables.packages.prodname_ghcr_and_npm_registry_full %} you can choose to allow packages to be owned by a user, an organization, or linked to a repository.
{% endnote %}
@@ -49,11 +49,11 @@ When you enable GitHub Actions, GitHub installs a GitHub App on your repository.
{% data variables.product.prodname_registry %} allows you to push and pull packages through the `GITHUB_TOKEN` available to a {% data variables.product.prodname_actions %} workflow.
{% ifversion fpt or ghec %}
-## About permissions and package access for {% data variables.product.prodname_ghcr_and_npm_registry %}
+## About permissions and package access for {% data variables.packages.prodname_ghcr_and_npm_registry %}
-The {% data variables.product.prodname_ghcr_and_npm_registry_full %} allows users to create and administer packages as free-standing resources at the organization level. Packages can be owned by an organization or personal account and you can customize access to each of your packages separately from repository permissions.
+The {% data variables.packages.prodname_ghcr_and_npm_registry_full %} allows users to create and administer packages as free-standing resources at the organization level. Packages can be owned by an organization or personal account and you can customize access to each of your packages separately from repository permissions.
-All workflows accessing the {% data variables.product.prodname_ghcr_and_npm_registry %} should use the `GITHUB_TOKEN` instead of a personal access token. For more information about security best practices, see "[Security hardening for GitHub Actions](/actions/learn-github-actions/security-hardening-for-github-actions#using-secrets)."
+All workflows accessing the {% data variables.packages.prodname_ghcr_and_npm_registry %} should use the `GITHUB_TOKEN` instead of a personal access token. For more information about security best practices, see "[Security hardening for GitHub Actions](/actions/learn-github-actions/security-hardening-for-github-actions#using-secrets)."
## Default permissions and access settings for containers modified through workflows
@@ -486,7 +486,7 @@ Installing packages hosted by {% data variables.product.prodname_registry %} thr
{% ifversion fpt or ghec %}
## Upgrading a workflow that accesses a registry using a PAT
-The {% data variables.product.prodname_ghcr_and_npm_registry %} support the `GITHUB_TOKEN` for easy and secure authentication in your workflows. If your workflow is using a personal access token (PAT) to authenticate to the registry, then we highly recommend you update your workflow to use the `GITHUB_TOKEN`.
+The {% data variables.packages.prodname_ghcr_and_npm_registry %} support the `GITHUB_TOKEN` for easy and secure authentication in your workflows. If your workflow is using a personal access token (PAT) to authenticate to the registry, then we highly recommend you update your workflow to use the `GITHUB_TOKEN`.
For more information about the `GITHUB_TOKEN`, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#using-the-github_token-in-a-workflow)."
diff --git a/translations/es-ES/content/site-policy/privacy-policies/github-data-protection-agreement.md b/translations/es-ES/content/site-policy/privacy-policies/github-data-protection-agreement.md
deleted file mode 100644
index c41be3227f..0000000000
--- a/translations/es-ES/content/site-policy/privacy-policies/github-data-protection-agreement.md
+++ /dev/null
@@ -1,1002 +0,0 @@
----
-title: Acuerdo de Protección de Datos de GitHub
-redirect_from:
- - /github/site-policy/github-data-protection-addendum
- - /github/site-policy-deprecated/github-data-protection-addendum
- - /github/site-policy/github-data-protection-agreement-non-enterprise-customers
- - /github/site-policy/github-data-protection-agreement
-versions:
- fpt: '*'
-ms.openlocfilehash: 91cef1674fbe12ac10a22cc3f41fcea35e93d90e
-ms.sourcegitcommit: 93b306112b5cd5ce482d468a25c9961ad02f87ac
-ms.translationtype: HT
-ms.contentlocale: es-ES
-ms.lasthandoff: 08/29/2022
-ms.locfileid: '144556776'
----
-## Introducción
-
-Las partes pactan que este Acuerdo de Protección de Datos de GitHub («**DPA**») establece sus obligaciones con respecto al procesamiento y la seguridad de los Datos Personales y, cuando se indique explícitamente en los Términos de DPA, los Datos del Cliente en relación con los Servicios en Línea proporcionados por GitHub, Inc. («**GitHub**»). El DPA (incluidos su Apéndice y los Anexos) se establece entre GitHub y cualquier cliente que reciba Servicios en Línea de GitHub según el Acuerdo de Cliente de GitHub («**Cliente**») y se incorpora por referencia en el Acuerdo de Cliente de GitHub.
-
-En caso de conflicto o incoherencia entre los Términos de DPA y cualquier otro término del Acuerdo de Cliente de GitHub, prevalecerán los Términos de DPA. Las disposiciones de los Términos de DPA reemplazan cualquier disposición en conflicto de la Declaración de Privacidad de GitHub que, de lo contrario, se pueda aplicar al procesamiento de Datos Personales. Para mayor claridad, las Cláusulas Contractuales Tipo prevalecen sobre cualquier otro término de los Términos de DPA.
-
-### Términos y Actualizaciones de DPA Aplicables
-
-#### Límites en las Actualizaciones
-
-Cuando el Cliente renueve o compre una nueva suscripción a un Servicio en Línea, se aplicarán los Términos de DPA vigentes en ese momento y no cambiarán durante el plazo de esa nueva suscripción para ese Servicio en Línea.
-
-#### Nuevas características, Complementos o Software Relacionado
-
-Sin perjuicio de los límites anteriores sobre las actualizaciones, cuando GitHub presenta características, complementos o software relacionado que son nuevos (es decir, que no se han incluido previamente con la suscripción), GitHub puede proporcionar términos o realizar actualizaciones al DPA que se aplican al uso del Cliente de esas nuevas características, suplementos o software relacionado. Si dichos términos incluyen cualquier cambio material contrario a los Términos de DPA, GitHub le ofrecerá al Cliente la opción de usar las nuevas características, los complementos o el software relacionado, sin perder la funcionalidad existente de un Servicio en Línea disponible con carácter general. Si el Cliente no utiliza las características nuevas, complementos o software relacionado, no se aplicarán los nuevos términos correspondientes.
-
-#### Reglamentos y Requisitos Gubernamentales
-
-Sin perjuicio de los límites anteriores sobre las actualizaciones, GitHub puede modificar o finalizar un Servicio en Línea en cualquier país o jurisdicción donde exista un requisito u obligación gubernamental actual o futura que (1) someta a GitHub a cualquier regulación o requisito que no sea de aplicación general a las empresas que operan allí, (2) presente dificultades para que GitHub continúe operando el Servicio en Línea sin modificaciones, y/o (3) haga que GitHub considere que los Términos de DPA o el Servicio en Línea puedan entrar en conflicto con dicho requisito u obligación.
-
-### Notificaciones Electrónicas
-
-GitHub puede proporcionar información y avisos al Cliente sobre los Servicios en Línea electrónicamente, incluido el correo electrónico o a través de un sitio web que GitHub reconozca. El aviso se realiza a partir de la fecha en que GitHub lo hace disponible.
-
-### Versiones Anteriores
-
-Los Términos de DPA proporcionan términos para los Servicios en Línea que están actualmente disponibles. Para versiones anteriores de los Términos de DPA, el Cliente puede ponerse en contacto con su revendedor o el Administrador de la Cuenta de GitHub.
-
-## Definiciones
-
-Todos los términos con mayúscula inicial que no se definan en este DPA tendrán el mismo significado que el establecido en el Acuerdo de Cliente de GitHub. En este DPA se utilizan los siguientes términos definidos:
-
-«**CCPA**» se refiere a la Ley de Privacidad del Consumidor de California tal como se establece en Cal. Civ. Código §1798.100 et seq. y sus regulaciones implementadas.
-
-«**Datos del Cliente**» se refiere a todos los datos, incluidos los archivos de texto, sonido, vídeo o imagen y software, proporcionados a GitHub por o en nombre del Cliente a través de los Servicios en Línea.
-
-«**Requisitos de Protección de Datos**» se refiere al RGPD, las Leyes Locales de Protección de Datos de la UE/EEE, la CCPA y cualquier ley, reglamento y otros requisitos legales aplicables relacionados con (a) la privacidad y la seguridad de los datos; y (b) el uso, la recopilación, la retención, el almacenamiento, la seguridad, la divulgación, la transferencia, la eliminación y cualquier otro procesamiento de Datos Personales.
-
-«**Datos de Diagnóstico**» se refiere a los datos recopilados u obtenidos por GitHub a partir del software instalado localmente por el Cliente en relación con el Servicio en Línea. Los Datos de Diagnóstico también pueden recibir el nombre de «telemetría». Los Datos de Diagnóstico no incluyen los Datos del Cliente, los Datos Generados por el Servicio ni los Datos de los Servicios Profesionales.
-
-«**Términos de DPA**» se refiere a los términos de este DPA y a cualquier término específico del Servicio en Línea en el Acuerdo de Cliente de GitHub que complemente o modifique específicamente los términos de privacidad y seguridad en este DPA para un Servicio en Línea específico (o característica de un Servicio en Línea). En caso de conflicto o incoherencia entre el DPA y dichos términos específicos del Servicio en Línea, los términos específicos del Servicio en Línea prevalecerán en cuanto al Servicio en Línea aplicable (o característica de ese Servicio en Línea).
-
-«**RGPD**» se refiere al Reglamento (UE) 2016/679 del Parlamento Europeo y del Consejo con fecha del 27 de abril de 2016 sobre la protección de las personas físicas en lo que respecta al procesamiento de datos personales y a la libre circulación de estos datos, y por el que se deroga la Directiva 95/46/CE (Reglamento General de Protección de Datos). En relación con el Reino Unido, «RGPD» se refiere al Reglamento (UE) 2016/679 transpuesto a la legislación nacional del Reino Unido por la Ley de la Unión Europea (Desistimiento) de Reino Unido en 2018 y modificado por los Reglamentos de Protección de Datos, Privacidad y Comunicaciones Electrónicas de Reino Unido (Enmiendas, etc.) (Salida de la UE) de 2019 (ya que se puede modificar ocasionalmente).
-
-«**Leyes Locales de Protección de Datos de la UE/EEE**» se refiere a cualquier legislación y regulación subordinada que implemente el RGPD.
-
-«**Términos Relacionados con el RGPD**» se refiere a los términos del Anexo 3, por los cuales GitHub asume compromisos vinculantes con respecto al procesamiento de Datos Personales según lo exige el Artículo 28 del RGPD.
-
-«**Entidad Afiliada de GitHub**» se refiere a cualquier entidad que GitHub controle de forma directa o indirecta, o bien que esté bajo su control o bajo control compartido.
-
-«**Acuerdo de Cliente de GitHub**» se refiere al servicio u otros acuerdos celebrados por el Cliente con GitHub para los Servicios en Línea.
-
-«**Declaración de Privacidad de GitHub**» se refiere a la declaración de privacidad de GitHub disponible en https://docs.github.com/en/github/site-policy/github-privacy-statement.
-
-«**Servicio en Línea**» se refiere a cualquier servicio o software proporcionado por GitHub al Cliente según el Acuerdo de Cliente de GitHub pactado con el Cliente, incluidas las Versiones Preliminares, las actualizaciones, los parches, las correcciones de errores y el soporte técnico.
-
-«**Datos Personales**» se refiere a cualquier información relacionada con una persona física identificada o identificable. Una persona física identificable es una persona que puede identificarse directa o indirectamente, especialmente mediante la referencia a un identificador como un nombre, un número de identificación, datos de ubicación, un identificador en línea o a uno o más factores específicos de la identidad física, fisiológica, genética, mental, económica, cultural o social de esa persona física.
-
-«**Versión Preliminar**» se refiere a los Servicios en Línea proporcionados para versión preliminar, evaluación, demostración o prueba, o versiones previas al lanzamiento de los Servicios en Línea.
-
-«**Datos de Servicios Profesionales**» se refiere a todos los datos, incluidos todos los archivos de texto, sonido, vídeo, imagen o software, que un Cliente proporciona a GitHub o en su nombre (o que el Cliente autoriza a GitHub a obtener de un Servicio en Línea) u obtenidos o procesados de otra manera por o en nombre de GitHub a través de un contrato con GitHub para obtener Servicios Profesionales. Los Datos de Servicios Profesionales incluyen Datos de Soporte.
-
-«**Datos Generados por el Servicio**» se refiere a los datos generados o derivados por GitHub a través de la operación de un Servicio en Línea. Los Datos Generados por el Servicio no incluyen los Datos del Cliente, los Datos de Diagnóstico ni los Datos de Servicios Profesionales.
-
-«**Cláusulas Contractuales Tipo**» se refiere a cualquiera de los siguientes conjuntos de Cláusulas Contractuales Tipo, según corresponda en el caso individual a la transferencia de datos personales de acuerdo con el apartado de este DPA titulado «Transferencias de Datos y Ubicación» más adelante:
-- las Cláusulas Contractuales Tipo (MÓDULO DOS: Transferencia de responsable a encargado), con fecha del 4 de junio de 2021, para la transferencia de datos personales a terceros países de conformidad con el Reglamento (UE) 2016/679 del Parlamento Europeo y del Consejo, tal como se describe en el Artículo 46 del RGPD y aprobado por Decisión de Ejecución de la Comisión Europea (UE) 2021/91 («Cláusulas Contractuales Tipo (UE/EEE)»). Las Cláusulas Contractuales Tipo (UE/EEE) se establecen en el Anexo 1.
-- las Cláusulas Contractuales Tipo (Encargados del Tratamiento), con fecha del 5 de febrero de 2010, para la transferencia de datos personales a encargados establecidos en países terceros que no garanticen un nivel adecuado de protección de datos, tal como se describe en el Artículo 46 del RGPD, aprobado por Decisión de la Comisión Europea 2010/87/UE y reconocido por las autoridades reguladoras o supervisoras de Reino Unido para su uso en relación con transferencias de datos desde Reino Unido («Cláusulas Contractuales Tipo (RU)»). Las Cláusulas Contractuales Tipo (RU) se establecen en el Anexo 2.
-
-«**Subencargado**» se refiere a otros encargados utilizados por GitHub para procesar Datos Personales en nombre del Cliente en relación con los Servicios en Línea, tal como se describe en el Artículo 28 del RGPD.
-
-«**Datos de Soporte**» se refiere a todos los datos, incluidos todos los archivos de texto, sonido, vídeo, imagen o software que el Cliente proporciona a GitHub o en su nombre (o que el Cliente autoriza a GitHub a obtener de un Servicio en Línea) por medio de un contrato con GitHub para obtener soporte técnico para los Servicios en Línea contemplados en este acuerdo. Los Datos de Soporte son un subconjunto de los Datos de Servicios Profesionales.
-
-Los términos en minúsculas utilizados pero no definidos en este DPA, como «vulneración de datos personales», «procesamiento», «responsable», «encargado», «elaboración de perfiles», «datos personales» e «interesado» tendrán el mismo significado que el que se establece en el Artículo 4 del RGPD, independientemente de si se aplica el RGPD. Los términos «importador de datos» y «exportador de datos» tienen los significados establecidos en las Cláusulas Contractuales Tipo.
-
-Para mayor claridad, y como se detalla anteriormente, los datos definidos como Datos del Cliente, Datos de Diagnóstico, Datos Generados por el Servicio y Datos de Servicios Profesionales pueden contener Datos Personales. Para fines ilustrativos, consulte el gráfico a continuación:
-
-

(1) El Acuerdo sobre el Espacio Económico Europeo (Acuerdo EEE) prevé la ampliación del mercado interior de la Unión Europea a los tres Estados del EEE: Islandia, Liechtenstein y Noruega. La legislación de protección de datos de la Unión, incluido el Reglamento (UE) 2016/679, está cubierta por el Acuerdo EEE y se ha incorporado al Anexo XI del mismo. Por lo tanto, cualquier divulgación por parte del importador de datos a un tercero ubicado en el EEE no se considera una transferencia posterior a los efectos de estas Cláusulas.
- -(2) Este requisito puede ser satisfecho por el subencargado que se adhiere a estas Cláusulas bajo el Módulo apropiado, de conformidad con la Cláusula 7.
- -(3) Con respecto al impacto de tales leyes y prácticas en el cumplimiento de estas Cláusulas, se pueden considerar diferentes elementos como parte de una evaluación general. Dichos elementos pueden incluir experiencia práctica relevante y documentada con casos anteriores de solicitudes de divulgación de las autoridades públicas, o la ausencia de tales solicitudes, que cubran un periodo de tiempo suficientemente representativo. Esto se refiere en concreto a los registros internos u otra documentación, elaborados de forma continua de acuerdo con la debida diligencia y certificados de la alta dirección, siempre que esta información pueda compartirse legalmente con terceros. Cuando se base en esta experiencia práctica para concluir que no se impedirá que el importador de datos cumpla estas Cláusulas, debe estar respaldada por otros elementos objetivos relevantes, y las Partes deben considerar cuidadosamente si estos elementos juntos tienen suficiente peso, en términos de su confiabilidad y representatividad, para apoyar esta conclusión. En concreto, las Partes deben tener en cuenta si su experiencia práctica está corroborada y no desmentida por información fiable disponible públicamente o accesible de otro modo sobre la existencia o ausencia de solicitudes dentro del mismo sector y/o la aplicación de la ley en la práctica, como la jurisprudencia y los informes de los órganos de control independientes.
diff --git a/translations/es-ES/content/site-policy/privacy-policies/index.md b/translations/es-ES/content/site-policy/privacy-policies/index.md index b57be47d2a..216cc64c18 100644 --- a/translations/es-ES/content/site-policy/privacy-policies/index.md +++ b/translations/es-ES/content/site-policy/privacy-policies/index.md @@ -8,7 +8,6 @@ topics: children: - /github-privacy-statement - /global-privacy-practices - - /github-data-protection-agreement - /github-subprocessors-and-cookies - /github-codespaces-privacy-statement - /github-candidate-privacy-policy diff --git a/translations/es-ES/data/reusables/actions/hosted-runner-security.md b/translations/es-ES/data/reusables/actions/hosted-runner-security.md index 5f31b6298c..bbc2edbd12 100644 --- a/translations/es-ES/data/reusables/actions/hosted-runner-security.md +++ b/translations/es-ES/data/reusables/actions/hosted-runner-security.md @@ -1,11 +1 @@ ---- -ms.openlocfilehash: 39b050df26b1192db1f0d539b2bd789f90c022d1 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/09/2022 -ms.locfileid: "147764120" ---- -Se recomienda usar solo {% data variables.actions.hosted_runner %} con repositorios privados: -- Las bifurcaciones de tu repositorio pueden ejecutar código potencialmente peligroso en tu {% data variables.actions.hosted_runner %} creando una solicitud de extracción que ejecute el código en un flujo de trabajo. -- Podría incurrir en costos inesperados si permites que los repositorios bifurcados ejecuten trabajos en {% data variables.actions.hosted_runner %}. \ No newline at end of file +If you are using a Fixed IP range, we recommend that you only use {% data variables.actions.hosted_runner %}s with private repositories. Forks of your repository can potentially run dangerous code on your {% data variables.actions.hosted_runner %} by creating a pull request that executes the code in a workflow. diff --git a/translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-default.md b/translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-default.md deleted file mode 100644 index 584ed2962d..0000000000 --- a/translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-default.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -ms.openlocfilehash: 0036dd5cf979531479a7ddf523c7475391b29c0a -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147548012" ---- -De forma predeterminada, un flujo de trabajo de {% data variables.product.prodname_actions %} se desencadena cada vez que crea o actualiza una precompilación, o hace una inserción en una rama habilitada para la precompilación. Como sucede con otros flujos de trabajo, mientras se ejecutan los de precompilación, consumirán algunos de los minutos de acciones incluidos en la cuenta, si tiene alguno, o incurrirán en cargos por los minutos de acciones. Para más información sobre los precios de los minutos de acciones, vea "[Acerca de la facturación de {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)". - -Junto con los minutos de {% data variables.product.prodname_actions %}, también se le facturarán por el almacenamiento de precompilaciones asociadas a cada configuración de precompilación para un repositorio y una región determinados. El almacenamiento de precompilaciones se factura a la misma velocidad que el almacenamiento de los codespaces. \ No newline at end of file diff --git a/translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-reducing.md b/translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-reducing.md deleted file mode 100644 index 03f82b7b20..0000000000 --- a/translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-reducing.md +++ /dev/null @@ -1,3 +0,0 @@ -To reduce consumption of Actions minutes, you can set a prebuild to be updated only when you make a change to your dev container configuration files, or only on a custom schedule. You can also manage your storage usage by adjusting the number of template versions to be retained for your prebuild configurations. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." - -If you are an organization or enterprise owner, you can track usage of prebuild workflows and storage by downloading a {% data variables.product.prodname_actions %} usage report for your organization or enterprise. You can identify workflow runs for prebuilds by filtering the CSV output to only include the workflow called "Create {% data variables.product.prodname_github_codespaces %} Prebuilds." For more information, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage#viewing-github-actions-usage-for-your-organization)." diff --git a/translations/es-ES/data/reusables/codespaces/codespaces-billing.md b/translations/es-ES/data/reusables/codespaces/codespaces-billing.md deleted file mode 100644 index 8d3a745bc6..0000000000 --- a/translations/es-ES/data/reusables/codespaces/codespaces-billing.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -ms.openlocfilehash: 845c770a8a03c57a4c10a84d28fd4d3d78282042 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147111126" ---- -Los {% data variables.product.prodname_codespaces %} se cobran en dólares estadounidenses (USD) de acuerdo con su uso de almacenamiento y cálculo. - -### Calcular el uso de cómputo -El uso de proceso se define como la cantidad total de minutos de tiempo de actividad durante los cuáles se encuentra activa una instancia de {% data variables.product.prodname_github_codespaces %}. El uso de cómputo se calcula sumando la cantidad real de minutos que utilizan todos los codespaces. Estos totales se reportan al servicio de facturación diariamente y se cobran mensualmente. - -El tiempo de actividad se controla deteniendo tu codespace, lo cual se puede hacer manual o automáticamente después de que un desarrollador especifique un periodo de inactividad. Para obtener más información, consulta "[Cerrar o detener el codespace](/codespaces/getting-started/deep-dive#closing-or-stopping-your-codespace)". - -### Calcular el uso de almacenamiento -En la facturación de {% data variables.product.prodname_github_codespaces %}, se incluye todo el almacenamiento que utilizan todos los codespaces de tu cuenta. Esto incluye cualquier archivo que utilicen los codespaces, tales como los repositorios clonados, archivos de configuración y extensiones, entre otros. Estos totales se reportan al servicio de facturación diariamente y se cobran mensualmente. Al final del mes, {% data variables.product.prodname_dotcom %} redondea tu almacenamiento al número de MB más cercano. 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 e32b29f3f4..1322dfe4ae 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 @@ -5,5 +5,3 @@ {% endnote %} By default, your organization or enterprise will have a {% data variables.product.prodname_github_codespaces %} spending limit of $0. This prevents new codespaces from being created, or existing codespaces from being opened, if this would incur a billable cost to your organization or enterprise. To allow your users to create codespaces in your organization, set the limit to a value higher than $0. - -{% data reusables.billing.overages-billed-monthly %} 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 c89126ae76..545324000c 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,11 +1,5 @@ After you connect your account on {% data variables.product.product_location %} 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 %} marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). -{% note %} - -**Note**: Currently, {% data variables.product.prodname_vscode_shortname %} doesn't allow you to choose a dev container configuration when you create a codespace. If you want to choose a specific dev container configuration, use the {% data variables.product.prodname_dotcom %} web interface to create your codespace. For more information, click the **Web browser** tab at the top of this page. - -{% endnote %} - {% data reusables.codespaces.click-remote-explorer-icon-vscode %} 2. Click the Add icon: {% octicon "plus" aria-label="The plus icon" %}. diff --git a/translations/es-ES/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md b/translations/es-ES/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md deleted file mode 100644 index 16dceb4a01..0000000000 --- a/translations/es-ES/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -ms.openlocfilehash: 86ebb6e0ab13cf7daf5fb580792bf8f4606eb054 -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147881920" ---- -Para estimar los costos por servicios de consumo, puede usar la [calculadora de precios](https://github.com/pricing/calculator?feature=codespaces) de {% data variables.product.prodname_dotcom %}. diff --git a/translations/ja-JP/content/actions/using-workflows/workflow-commands-for-github-actions.md b/translations/ja-JP/content/actions/using-workflows/workflow-commands-for-github-actions.md index 5a6de2d67d..60e836a70a 100644 --- a/translations/ja-JP/content/actions/using-workflows/workflow-commands-for-github-actions.md +++ b/translations/ja-JP/content/actions/using-workflows/workflow-commands-for-github-actions.md @@ -169,6 +169,8 @@ Sets an action's output parameter. Optionally, you can also declare output parameters in an action's metadata file. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs-for-docker-container-and-javascript-actions)." +You can escape multiline strings for setting an output parameter by creating an environment variable and using it in a workflow command. For more information, see "[Setting an environment variable](#setting-an-environment-variable)." + ### Example: Setting an output parameter {% bash %} diff --git a/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md b/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md index d59a45baf8..82d3255404 100644 --- a/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md +++ b/translations/ja-JP/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md @@ -1,5 +1,5 @@ --- -title: アプライアンスでのバックアップの設定 +title: Configuring backups on your appliance shortTitle: Configuring backups redirect_from: - /enterprise/admin/categories/backups-and-restores @@ -14,7 +14,7 @@ redirect_from: - /enterprise/admin/installation/configuring-backups-on-your-appliance - /enterprise/admin/configuration/configuring-backups-on-your-appliance - /admin/configuration/configuring-backups-on-your-appliance -intro: 'ディザスター リカバリー計画の一部として、自動バックアップを構成して {% data variables.product.product_location %}の運用データを保護できます。' +intro: 'As part of a disaster recovery plan, you can protect production data on {% data variables.product.product_location %} by configuring automated backups.' versions: ghes: '*' type: how_to @@ -23,162 +23,158 @@ topics: - Enterprise - Fundamentals - Infrastructure -ms.openlocfilehash: 4403ec24aa3da63f6700ae4bfcd2392ec0cfd194 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/09/2022 -ms.locfileid: '147861653' --- -## {% data variables.product.prodname_enterprise_backup_utilities %}について +## About {% data variables.product.prodname_enterprise_backup_utilities %} -{% data variables.product.prodname_enterprise_backup_utilities %} は、個別のホストにインストールするバックアップ システムで、{% data variables.product.product_location %} のバックアップ スナップショットをセキュアな SSH ネットワーク接続経由で定期的に取得します。 スナップショットを使用して、既存の {% data variables.product.prodname_ghe_server %} インスタンスをバックアップホストから以前の状態に復元できます。 +{% data variables.product.prodname_enterprise_backup_utilities %} is a backup system you install on a separate host, which takes backup snapshots of {% data variables.product.product_location %} at regular intervals over a secure SSH network connection. You can use a snapshot to restore an existing {% data variables.product.prodname_ghe_server %} instance to a previous state from the backup host. -ネットワーク経由で転送されるのは最後のスナップショット以降に追加されたデータのみで、追加の物理ストレージ領域もその分だけしか占めません。 パフォーマンスへの影響を最小化するために、バックアップは最低のCPU/IO優先度の下でオンライン実行されます。 バックアップを行うために、メンテナンスウィンドウをスケジューリングする必要はありません。 +Only data added since the last snapshot will transfer over the network and occupy additional physical storage space. To minimize performance impact, backups are performed online under the lowest CPU/IO priority. You do not need to schedule a maintenance window to perform a backup. -{% data variables.product.prodname_enterprise_backup_utilities %} のメジャー リリースとバージョン番号は、{% data variables.product.product_name %} の機能リリースと一致します。 両方の製品の最新バージョン 4 つをサポートしています。 詳しい情報については、「[{% data variables.product.product_name %} のリリース](/admin/all-releases)」をご覧ください。 +Major releases and version numbers for {% data variables.product.prodname_enterprise_backup_utilities %} align with feature releases of {% data variables.product.product_name %}. We support the four most recent versions of both products. For more information, see "[{% data variables.product.product_name %} releases](/admin/all-releases)." -機能、要件、および高度な使用方法について詳しくは、{% data variables.product.prodname_enterprise_backup_utilities %} プロジェクト ドキュメントの [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) を参照してください。 +For more detailed information on features, requirements, and advanced usage, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## 前提条件 +## Prerequisites -{% data variables.product.prodname_enterprise_backup_utilities %} を利用するには、{% data variables.product.product_location %} とは別の Linux もしくは Unix ホスト システムが必要です。 +To use {% data variables.product.prodname_enterprise_backup_utilities %}, you must have a Linux or Unix host system separate from {% data variables.product.product_location %}. -{% data variables.product.prodname_enterprise_backup_utilities %}は、重要なデータのための長期的な恒久ストレージの既存環境に統合することもできます。 +You can also integrate {% data variables.product.prodname_enterprise_backup_utilities %} into an existing environment for long-term permanent storage of critical data. -バックアップ ホストと {% data variables.product.product_location %} は、地理的に離れたところに配置することをおすすめします。 そうすることで、プライマリのサイトにおける大規模な災害やネットワーク障害に際してもリカバリにバックアップが利用できることが保証されます。 +We recommend that the backup host and {% data variables.product.product_location %} be geographically distant from each other. This ensures that backups are available for recovery in the event of a major disaster or network outage at the primary site. -物理的なストレージの要求は、Gitリポジトリのディスク利用状況と予想される成長パターンによって異なります。 +Physical storage requirements will vary based on Git repository disk usage and expected growth patterns: -| ハードウェア | 推奨 | +| Hardware | Recommendation | | -------- | --------- | -| **vCPU 数** | 2 | -| **[メモリ]** | 2 GB | -| **Storage** | プライマリインスタンスに割り当てられたストレージの5倍 | +| **vCPUs** | 2 | +| **Memory** | 2 GB | +| **Storage** | Five times the primary instance's allocated storage | -ユーザのアクティビティや他の製品との結合といった利用方法によっては、さらに多くのリソースが必要になることがあります。 +More resources may be required depending on your usage, such as user activity and selected integrations. -詳しくは、{% data variables.product.prodname_enterprise_backup_utilities %} プロジェクト ドキュメントの「[{% data variables.product.prodname_enterprise_backup_utilities %} の要件](https://github.com/github/backup-utils/blob/master/docs/requirements.md)」を参照してください。 +For more information, see [{% data variables.product.prodname_enterprise_backup_utilities %} requirements](https://github.com/github/backup-utils/blob/master/docs/requirements.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## {% data variables.product.prodname_enterprise_backup_utilities %}のインストール +## Installing {% data variables.product.prodname_enterprise_backup_utilities %} -バックアップ ホストに {% data variables.product.prodname_enterprise_backup_utilities %} をインストールするには、プロジェクトの Git リポジトリを複製することをお勧めします。 この方法では、Git を使用して新しいリリースを直接フェッチすることができ、新しいバージョンをインストールするときに既存のバックアップ構成ファイル `backup.config` が保持されます。 +To install {% data variables.product.prodname_enterprise_backup_utilities %} on your backup host, we recommend cloning the project's Git repository. This approach allows you to fetch new releases directly using Git, and your existing backup configuration file, `backup.config`, will be preserved when installing a new version. -または、ホスト マシンがインターネットにアクセスできない場合は、圧縮アーカイブとして各 {% data variables.product.prodname_enterprise_backup_utilities %} リリースをダウンロードし、コンテンツを抽出してインストールできます。 詳しくは、{% data variables.product.prodname_enterprise_backup_utilities %} プロジェクト ドキュメントの「[概要](https://github.com/github/backup-utils/blob/master/docs/getting-started.md)」を参照してください。 +Alternatively, if the host machine can't access the internet, you can download each {% data variables.product.prodname_enterprise_backup_utilities %} release as a compressed archive, then extract and install the contents. For more information, see [Getting started](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -バックアップ スナップショットは、`backup.config` ファイル内の`GHE_DATA_DIR` データ ディレクトリ変数によって設定されたディスク パスに書き込まれます。 スナップショットは、シンボリック リンクとハード リンクをサポートするファイル システムに格納する必要があります。 +Backup snapshots are written to the disk path set by the `GHE_DATA_DIR` data directory variable in your `backup.config` file. Snapshots need to be stored on a filesystem which supports symbolic and hard links. {% note %} -**注:** {% data variables.product.prodname_enterprise_backup_utilities %} バージョンをアップグレードするときに誤ってデータ ディレクトリが上書きされないように、スナップショットが {% data variables.product.prodname_enterprise_backup_utilities %} インストール ディレクトリのサブディレクトリに保持されないようにすることをお勧めします。 +**Note:** We recommend ensuring your snapshots are not kept in a subdirectory of the {% data variables.product.prodname_enterprise_backup_utilities %} installation directory, to avoid inadvertently overwriting your data directory when upgrading {% data variables.product.prodname_enterprise_backup_utilities %} versions. {% endnote %} -1. [{% data variables.product.prodname_enterprise_backup_utilities %} プロジェクト リポジトリ](https://github.com/github/backup-utils/)をバックアップ ホスト上のローカル ディレクトリに複製するには、次のコマンドを実行します。 +1. To clone the [{% data variables.product.prodname_enterprise_backup_utilities %} project repository](https://github.com/github/backup-utils/) to a local directory on your backup host, run the following command. ``` $ git clone https://github.com/github/backup-utils.git /path/to/target/directory/backup-utils ``` -1. ローカル リポジトリ ディレクトリに移動するには、次のコマンドを実行します。 +1. To change into the local repository directory, run the following command. ``` cd backup-utils ``` {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} -1. インクルードされた `backup.config-example` ファイルを `backup.config` にコピーするには、次のコマンドを実行します。 +1. To copy the included `backup.config-example` file to `backup.config`, run the following command. ```shell cp backup.config-example backup.config ``` -1. 構成をカスタマイズするには、テキスト エディターで `backup.config` を編集します。 - 1. `GHE_HOSTNAME` の値をプライマリの {% data variables.product.prodname_ghe_server %} インスタンスのホスト名あるいは IP アドレスに設定します。 +1. To customize your configuration, edit `backup.config` in a text editor. + 1. Set the `GHE_HOSTNAME` value to your primary {% data variables.product.prodname_ghe_server %} instance's hostname or IP address. {% note %} - **注:** {% data variables.product.product_location %} がクラスターとして、またはロード バランサーを使用する高可用性構成に展開されている場合は、{% data variables.product.product_location %} への SSH アクセス (ポート 122 上) が許可されている限り、`GHE_HOSTNAME` をロード バランサーのホスト名に指定できます。 + **Note:** If {% data variables.product.product_location %} is deployed as a cluster or in a high availability configuration using a load balancer, the `GHE_HOSTNAME` can be the load balancer hostname, as long as it allows SSH access (on port 122) to {% data variables.product.product_location %}. - 復旧されたアプライアンスがすぐに利用できることを保証するために、geo レプリケーション構成の場合であってもプライマリ インスタンスをターゲットとしたバックアップを実行してください。 + To ensure a recovered appliance is immediately available, perform backups targeting the primary instance even in a geo-replication configuration. {% endnote %} - 1. `GHE_DATA_DIR` の値をバックアップ スナップショットを保存したいファイルシステムの場所に設定します。 手順 1 で Git リポジトリを複製した場所以外の、バックアップ ホストと同じファイル システム上の場所を選ぶことをお勧めします。 -1. バックアップ ホストにインスタンスへのアクセスを許可するには、プライマリ インスタンスの設定ページ `http(s)://HOSTNAME/setup/settings` を開き、承認された SSH キーの一覧にバックアップ ホストの SSH キーを追加します。 詳細については、「[管理シェル (SSH) にアクセスする](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh#enabling-access-to-the-administrative-shell-via-ssh)」を参照してください。 -1. バックアップ ホストで、`ghe-host-check` コマンドを使用して、{% data variables.product.product_location %} との SSH 接続を確認します。 + 1. Set the `GHE_DATA_DIR` value to the filesystem location where you want to store backup snapshots. We recommend choosing a location on the same filesystem as your backup host, but outside of where you cloned the Git repository in step 1. +1. To grant your backup host access to your instance, open your primary instance's settings page at `http(s)://HOSTNAME/setup/settings` and add the backup host's SSH key to the list of authorized SSH keys. For more information, see "[Accessing the administrative shell (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh#enabling-access-to-the-administrative-shell-via-ssh)." +1. On your backup host, verify SSH connectivity with {% data variables.product.product_location %} with the `ghe-host-check` command. ```shell ./bin/ghe-host-check - ``` -1. 最初の完全バックアップを作成するには、次のコマンドを実行します。 + ``` +1. To create an initial full backup, run the following command. ```shell ./bin/ghe-backup ``` -高度な使用方法について詳しくは、{% data variables.product.prodname_enterprise_backup_utilities %} プロジェクト ドキュメントの [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) を参照してください。 +For more information on advanced usage, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## {% data variables.product.prodname_enterprise_backup_utilities %} のアップグレード +## Upgrading {% data variables.product.prodname_enterprise_backup_utilities %} -{% data variables.product.prodname_enterprise_backup_utilities %} をアップグレードするときは、現在のバージョンの {% data variables.product.product_name %} で動作するリリースを選ぶ必要があります。 {% data variables.product.prodname_enterprise_backup_utilities %} のインストールは、少なくとも {% data variables.product.product_location %} と同じバージョンである必要があり、3 つ以上先のバージョンにインストールすることはできません。 詳しくは、{% data variables.product.prodname_enterprise_backup_utilities %} プロジェクト ドキュメントの「[{% data variables.product.prodname_ghe_server %} バージョン要件](https://github.com/github/backup-utils/blob/master/docs/requirements.md#github-enterprise-server-version-requirements)」を参照してください。 -最新の変更をフェッチしてチェックアウトすることで、Git リポジトリの {% data variables.product.prodname_enterprise_backup_utilities %} をアップグレードできます。 +When upgrading {% data variables.product.prodname_enterprise_backup_utilities %}, you must choose a release that will work with your current version of {% data variables.product.product_name %}. Your installation of {% data variables.product.prodname_enterprise_backup_utilities %} must be at least the same version as {% data variables.product.product_location %}, and cannot be more than two versions ahead. For more information, see [{% data variables.product.prodname_ghe_server %} version requirements](https://github.com/github/backup-utils/blob/master/docs/requirements.md#github-enterprise-server-version-requirements) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. +You can upgrade {% data variables.product.prodname_enterprise_backup_utilities %} in a Git repository by fetching and checking out the latest changes. -または、インストールに Git リポジトリを使用しない場合は、新しいアーカイブを抽出することも、代わりに Git リポジトリを使用するように方法を変更することもできます。 +Alternatively, if you don't use a Git repository for your installation, you can extract a new archive into place, or you can change your approach to use a Git repository instead. -### インストールの種類の確認 +### Verifying the installation type -{% data variables.product.prodname_enterprise_backup_utilities %} のインストール方法を確認し、インストールをアップグレードする最適な方法を決定できます。 +You can verify the installation method for {% data variables.product.prodname_enterprise_backup_utilities %} and determine the best way to upgrade your installation. {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} -1. 有効な作業ディレクトリが Git リポジトリ内に存在するかどうかを確認するには、次のコマンドを実行します。 +1. To check if a valid working directory exists inside a Git repository, run the following command. ``` git rev-parse --is-inside-work-tree ``` - 出力が `true` の場合、{% data variables.product.prodname_enterprise_backup_utilities %} は、プロジェクトの Git リポジトリを複製することによってインストールされました。 出力に `fatal: not a git repository (or any of the parent directories)` が含まれている場合、{% data variables.product.prodname_enterprise_backup_utilities %} は、圧縮アーカイブ ファイルを抽出することによってインストールされたと考えられます。 -インストールが Git リポジトリにある場合は、Git を使用して最新バージョンをインストールできます。 インストールが圧縮アーカイブ ファイルから行われた場合は、最新バージョンをダウンロードして抽出するか、Git を使用して {% data variables.product.prodname_enterprise_backup_utilities %} を再インストールして、将来のアップグレードを簡略化できます。 + If the output is `true`, {% data variables.product.prodname_enterprise_backup_utilities %} was installed by cloning the project's Git repository. If the output includes `fatal: not a git repository (or any of the parent directories)`, {% data variables.product.prodname_enterprise_backup_utilities %} was likely installed by extracting a compressed archive file. +If your installation is in a Git repository, you can install the latest version using Git. If the installation is from a compressed archive file, you can either download and extract the latest version, or you can reinstall {% data variables.product.prodname_enterprise_backup_utilities %} using Git to simplify future upgrades. -- [Git リポジトリでのインストールのアップグレード](#upgrading-an-installation-in-a-git-repository) -- [圧縮アーカイブの代わりに Git を使用してアーカイブする](#using-git-instead-of-compressed-archives-for-upgrades) +- [Upgrading an installation in a Git repository](#upgrading-an-installation-in-a-git-repository) +- [Using Git instead of compressed archives for upgrades](#using-git-instead-of-compressed-archives-for-upgrades) -### Git リポジトリでのインストールのアップグレード +### Upgrading an installation in a Git repository -{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} {% note %} +{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} + {% note %} - **注:** {% data variables.product.prodname_enterprise_backup_utilities %} をアップグレードする前に、既存の `backup.config` ファイルのコピーを `$HOME/backup.config` のような一時的な場所に作成することをお勧めします。 + **Note:** We recommend creating a copy of your existing `backup.config` file in a temporary location, like `$HOME/backup.config`, before upgrading {% data variables.product.prodname_enterprise_backup_utilities %}. {% endnote %} -1. `git fetch` コマンドを実行して、最新のプロジェクト更新プログラムをダウンロードします。 +1. Download the latest project updates by running the `git fetch` command. ```shell git fetch ``` -{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %} +{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} +{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %} -### 圧縮アーカイブの代わりに Git を使用してアーカイブする +### Using Git instead of compressed archives for upgrades -バックアップ ホストにインターネット接続があり、以前に圧縮アーカイブ (`.tar.gz`) を使用して {% data variables.product.prodname_enterprise_backup_utilities %} をインストールまたはアップグレードした場合は、代わりにインストールに Git リポジトリを使用することをお勧めします。 Git を使用してアップグレードすると、作業が少なくなり、バックアップ構成が保持されます。 +If your backup host has internet connectivity and you previously used a compressed archive (`.tar.gz`) to install or upgrade {% data variables.product.prodname_enterprise_backup_utilities %}, we recommend using a Git repository for your installation instead. Upgrading using Git requires less work and preserves your backup configuration. {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} -1. 既存の {% data variables.product.prodname_enterprise_backup_utilities %} の構成をバックアップするには、現在の `backup.config` ファイルをホーム ディレクトリなどの安全な場所にコピーします。 +1. To back up your existing {% data variables.product.prodname_enterprise_backup_utilities %} configuration, copy your current `backup.config` file to a safe location, such as your home directory. ``` $ cp backup.config $HOME/backup.config.saved-$(date +%Y%m%d-%H%M%S) ``` -1. {% data variables.product.prodname_enterprise_backup_utilities %} Git リポジトリをインストールするバックアップ ホスト上のローカル ディレクトリに移動します。 -1. [プロジェクト リポジトリ](https://github.com/github/backup-utils/)をバックアップ ホスト上のディレクトリに複製するには、次のコマンドを実行します。 +1. Change to the local directory on your backup host where you want to install the {% data variables.product.prodname_enterprise_backup_utilities %} Git repository. +1. To clone the [project repository](https://github.com/github/backup-utils/) to the directory on your backup host, run the following command. ``` git clone https://github.com/github/backup-utils.git ``` -1. 複製されたリポジトリに移動するには、次のコマンドを実行します。 +1. To change into the cloned repository, run the following command. ``` cd backup-utils ``` {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} -1. 前の手順からバックアップ構成を復元するには、既存のバックアップ構成ファイルをローカル リポジトリ ディレクトリにコピーします。 コマンドのパスを、手順 2 で保存したファイルの場所に置き換えます。 +1. To restore your backup configuration from earlier, copy your existing backup configuration file to the local repository directory. Replace the path in the command with the location of the file saved in step 2. ``` $ cp PATH/TO/BACKUP/FROM/STEP/2 backup.config @@ -186,44 +182,44 @@ ms.locfileid: '147861653' {% note %} - **注:** 複製後にバックアップ構成ファイルを復元する場所を選ぶことができます。 構成ファイルを配置できる場所について詳しくは、{% data variables.product.prodname_enterprise_backup_utilities %} プロジェクト ドキュメントの「[概要](https://github.com/github/backup-utils/blob/master/docs/getting-started.md)」を参照してください。 + **Note:** You can choose where to restore your backup configuration file to after cloning. For more information about where configuration files can be located, see [Getting started](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. {% endnote %} -1. バックアップ構成ファイル内のディレクトリまたはスクリプトのパスが正しいことを確認するには、テキスト エディターでファイルを確認します。 +1. To confirm that the paths to directories or scripts in your backup configuration file are correct, review the file in a text editor. {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %} -1. 手順 1 から古い GitHub Enterprise Server Backup Utilities ディレクトリ (圧縮アーカイブのインストール場所) を削除します。 +1. Delete your old GitHub Enterprise Server Backup Utilities directory from step 1 (where the compressed archive installation was located). -## バックアップのスケジューリング +## Scheduling a backup -`cron(8)` コマンドや同様のコマンド スケジューリング サービスを使用して、バックアップ ホストで定期的なバックアップをスケジュール設定できます。 設定されたバックアップ頻度によって、リカバリー計画での最悪の目標復旧ポイント (RPO) が決まります。 たとえば、毎日午前 0 時にバックアップを実行するようにスケジュール設定した場合、災害のシナリオで最大 24 時間分のデータが失われる可能性があります。 プライマリサイトのデータが破壊された場合に、最悪でも最大 1 時間分のデータ損失で収まることが保証されるように、1 時間ごとのバックアップスケジュールから始めることをおすすめします。 +You can schedule regular backups on the backup host using the `cron(8)` command or a similar command scheduling service. The configured backup frequency will dictate the worst case recovery point objective (RPO) in your recovery plan. For example, if you have scheduled the backup to run every day at midnight, you could lose up to 24 hours of data in a disaster scenario. We recommend starting with an hourly backup schedule, guaranteeing a worst case maximum of one hour of data loss if the primary site data is destroyed. -バックアップの試行が重複すると、`ghe-backup` コマンドはエラー メッセージを表示して中断し、同時バックアップが存在することを示します。 そのような場合は、スケジュール設定したバックアップの頻度を減らすことをおすすめします。 詳しくは、{% data variables.product.prodname_enterprise_backup_utilities %} プロジェクト ドキュメントの [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#scheduling-backups) を参照してください。 +If backup attempts overlap, the `ghe-backup` command will abort with an error message, indicating the existence of a simultaneous backup. If this occurs, we recommended decreasing the frequency of your scheduled backups. For more information, see the "Scheduling backups" section of the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#scheduling-backups) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## バックアップの復元 +## Restoring a backup -プライマリ サイトで長時間の停止または壊滅的なイベントが発生した場合は、別の {% data variables.product.prodname_enterprise %} アプライアンスをプロビジョニングしてバックアップ ホストから復元することで、{% data variables.product.product_location %} を復元できます。 アプライアンスを復元する前に、バックアップホストの SSH キーをターゲットの {% data variables.product.prodname_enterprise %} アプライアンスに認証済み SSH キーとして追加する必要があります。 +In the event of prolonged outage or catastrophic event at the primary site, you can restore {% data variables.product.product_location %} by provisioning another {% data variables.product.prodname_enterprise %} appliance and performing a restore from the backup host. You must add the backup host's SSH key to the target {% data variables.product.prodname_enterprise %} appliance as an authorized SSH key before restoring an appliance. {% note %} -**注意:** {% data variables.product.product_location %} へのバックアップを復元する場合は、同じバージョンのサポート ルールが適用されます。 最大 2 つ前の機能リリースからしかデータを復元できません。 +**Note:** When performing backup restores to {% data variables.product.product_location %}, the same version supportability rules apply. You can only restore data from at most two feature releases behind. -たとえば、{% data variables.product.product_name %} 3.0.x からバックアップを取得した場合、バックアップを {% data variables.product.product_name %} 3.2.x インスタンスに復元できます。 {% data variables.product.product_name %} 2.22.x のバックアップから 3.2.x を実行しているインスタンスにデータを復元することはできません。これは、バージョンを 3 回ジャンプするためです (2.22 から 3.0、3.1、3.2 の順)。 最初に 3.1.x を実行しているインスタンスに復元してから、3.2.x にアップグレードする必要があります。 +For example, if you take a backup from {% data variables.product.product_name %} 3.0.x, you can restore the backup to a {% data variables.product.product_name %} 3.2.x instance. You cannot restore data from a backup of {% data variables.product.product_name %} 2.22.x to an instance running 3.2.x, because that would be three jumps between versions (2.22 to 3.0 to 3.1 to 3.2). You would first need to restore to an instance running 3.1.x, and then upgrade to 3.2.x. {% endnote %} -最後に成功したスナップショットから {% data variables.product.product_location %} を復元するには、`ghe-restore` コマンドを使用します。 +To restore {% data variables.product.product_location %} from the last successful snapshot, use the `ghe-restore` command. {% note %} -**注:** バックアップを復元する前に、次のことを確認してください。 -- プライマリ インスタンスでメンテナンス モードが有効になり、すべてのアクティブなプロセスが完了している。 詳細については、「[メンテナンス モードの有効化](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)」を参照してください。 -- 高可用性構成のすべてのレプリカでレプリケーションが停止している。 詳しくは、「[高可用性構成について](/admin/enterprise-management/configuring-high-availability/about-high-availability-configuration#ghe-repl-stop)」の `ghe-repl-stop` コマンドを参照してください。 -- {% data variables.product.product_location %} で {% data variables.product.prodname_actions %} が有効になっている場合は、まず交換用アプライアンスで {% data variables.product.prodname_actions %} 外部ストレージ プロバイダーを構成する必要があります。 詳細については、「[{% data variables.product.prodname_actions %} を有効にして、{% data variables.product.prodname_ghe_server %} をバックアップおよび復元する](/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled)」を参照してください。 +**Note:** Prior to restoring a backup, ensure: +- Maintenance mode is enabled on the primary instance and all active processes have completed. For more information, see "[Enabling maintenance mode](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)." +- Replication is stopped on all replicas in high availability configurations. For more information, see the `ghe-repl-stop` command in "[About high availability configuration](/admin/enterprise-management/configuring-high-availability/about-high-availability-configuration#ghe-repl-stop)." +- If {% data variables.product.product_location %} has {% data variables.product.prodname_actions %} enabled, you must first configure the {% data variables.product.prodname_actions %} external storage provider on the replacement appliance. For more information, see "[Backing up and restoring {% data variables.product.prodname_ghe_server %} with {% data variables.product.prodname_actions %} enabled](/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled)." {% endnote %} -`ghe-restore` コマンドを実行すると、次のような出力が表示されます。 +When running the `ghe-restore` command, you should see output similar to this: ```shell $ ghe-restore -c 169.154.1.1 @@ -242,15 +238,20 @@ $ ghe-restore -c 169.154.1.1 > Visit https://169.154.1.1/setup/settings to review appliance configuration. ``` -{% ifversion ip-exception-list %}必要に応じて復元を検証するには、指定した IP アドレスのリストへのアクセスを許可するように IP 例外リストを構成します。 詳細については、「[IP 例外リストを使い、メンテナンス モードで変更を検証する](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)」を参照してください。 +{% ifversion ip-exception-list %} +Optionally, to validate the restore, configure an IP exception list to allow access to a specified list of IP addresses. For more information, see "[Validating changes in maintenance mode using the IP exception list](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)." {% endif %} {% note %} -**注意:** ネットワーク設定はバックアップ スナップショットから除外されます。 ご使用の環境に合わせて、ターゲットの {% data variables.product.prodname_ghe_server %} アプライアンスでネットワークを手動で設定する必要があります。 +**Note:** + +- The network settings are excluded from the backup snapshot. You must manually configure the network on the target {% data variables.product.prodname_ghe_server %} appliance as required for your environment. + +- When restoring to new disks on an existing or empty {% data variables.product.prodname_ghe_server %} instance, stale UUIDs may be present, resulting in Git and/or Alambic replication reporting as out of sync. Stale server entry IDs can be the result of a retired node in a high availability configuration still being present in the application database, but not in the restored replication configuration. To remediate, stale UUIDs can be torn down using `ghe-repl-teardown` once the restore has completed and prior to starting replication. In this scenario, contact {% data variables.contact.contact_ent_support %} for further assistance. {% endnote %} -`ghe-restore` コマンドでは、次の追加オプションを使用できます。 -- `-c` フラグは、既に設定されている場合でも、ターゲット ホストで設定、証明書、およびライセンス データを上書きします。 テストのためにステージングインスタンスを設定しており、ターゲット上の依存の設定を残しておきたい場合には、このフラグを省いてください。 詳しくは、{% data variables.product.prodname_enterprise_backup_utilities %} プロジェクト ドキュメントの [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#using-the-backup-and-restore-commands) の「バックアップと復旧コマンドの使用」セクションを参照してください。 -- `-s` フラグにより、異なるバックアップ スナップショットを選択できます。 +You can use these additional options with `ghe-restore` command: +- The `-c` flag overwrites the settings, certificate, and license data on the target host even if it is already configured. Omit this flag if you are setting up a staging instance for testing purposes and you wish to retain the existing configuration on the target. For more information, see the "Using backup and restore commands" section of the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#using-the-backup-and-restore-commands) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. +- The `-s` flag allows you to select a different backup snapshot. diff --git a/translations/ja-JP/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md b/translations/ja-JP/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md index 6fa069a0f2..9445e64621 100644 --- a/translations/ja-JP/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md +++ b/translations/ja-JP/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md @@ -93,7 +93,7 @@ Optionally, if you use {% data variables.product.prodname_registry %} on your pr {% warning %} -**Warning**: If you don't configure {% data variables.product.prodname_actions %} on the staging instance before restoring your production backup, your staging instance will use your production instance's external storage, which could result in loss of data. We strongly recommended that you use different external storage for your staging instance. +**Warning**: If you don't configure {% data variables.product.prodname_registry %} on the staging instance before restoring your production backup, your staging instance will use your production instance's external storage, which could result in loss of data. We strongly recommended that you use different external storage for your staging instance. {% endwarning %} @@ -128,7 +128,7 @@ Optionally, if you use {% data variables.product.prodname_registry %} on your pr Use the `ghe-restore` command to restore the rest of the data from the backup. For more information, see "[Restoring a backup](/admin/configuration/configuring-backups-on-your-appliance#restoring-a-backup)." -If the staging instance is already configured and you're about to overwrite settings, certificate, and license data, add the `-c` option to the command. For more information about the option, see [Using the backup and restore commands](https://github.com/github/backup-utils/blob/master/docs/usage.md#restoring-settings-tls-certificate-and-license) in the {% data variables.product.prodname_enterprise_backup_utilities %} documentation. +If the staging instance is already configured and you want to overwrite settings, certificate, and license data, add the `-c` option to the command. For more information about the option, see [Using the backup and restore commands](https://github.com/github/backup-utils/blob/master/docs/usage.md#restoring-settings-tls-certificate-and-license) in the {% data variables.product.prodname_enterprise_backup_utilities %} documentation. ### 6. Review the instance's configuration diff --git a/translations/ja-JP/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md b/translations/ja-JP/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md index a21fbca0a0..6e8acc6b4d 100644 --- a/translations/ja-JP/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md +++ b/translations/ja-JP/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md @@ -56,7 +56,7 @@ Jobs that run on Windows and macOS runners that {% data variables.product.prodna The storage used by a repository is the total storage used by {% data variables.product.prodname_actions %} artifacts and {% data variables.product.prodname_registry %}. Your storage cost is the total usage for all repositories owned by your account. For more information about pricing for {% data variables.product.prodname_registry %}, see "[About billing for {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/about-billing-for-github-packages)." - If your account's usage surpasses these limits and you have set a spending limit above $0 USD, you will pay $0.008 USD per GB of storage per day and per-minute usage depending on the operating system used by the {% data variables.product.prodname_dotcom %}-hosted runner. {% data variables.product.prodname_dotcom %} rounds the minutes each job uses up to the nearest minute. + If your account's usage surpasses these limits and you have set a spending limit above $0 USD, you will pay $0.008 USD per GB of storage per day and per-minute usage depending on the operating system used by the {% data variables.product.prodname_dotcom %}-hosted runner. {% data variables.product.prodname_dotcom %} rounds the minutes and partial minutes each job uses up to the nearest whole minute. {% note %} diff --git a/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md b/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md index d11653618f..29711c895e 100644 --- a/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md +++ b/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md @@ -3,6 +3,7 @@ title: About billing for GitHub Codespaces shortTitle: About billing intro: 'View pricing and see how to manage {% data variables.product.prodname_github_codespaces %} billing for your organization.' permissions: 'To manage billing for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner or a billing manager.' +miniTocMaxHeadingLevel: 3 versions: fpt: '*' ghec: '*' @@ -13,40 +14,105 @@ topics: - Billing redirect_from: - /billing/managing-billing-for-github-codespaces/about-billing-for-codespaces + - /github/developing-online-with-codespaces/about-billing-for-codespaces + - /codespaces/getting-started-with-codespaces/about-billing-for-codespaces + - /codespaces/codespaces-reference/about-billing-for-codespaces + - /codespaces/codespaces-reference/understanding-billing-for-codespaces + - /codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md --- ## {% data variables.product.prodname_github_codespaces %} pricing -Charges are incurred for the use of {% data variables.product.prodname_github_codespaces %} for repositories owned by organization and enterprise accounts on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %}. These accounts do not include any free minutes or storage for {% data variables.product.prodname_github_codespaces %}. Repositories in personal accounts are not currently billed for {% data variables.product.prodname_github_codespaces %} usage. +Charges are incurred for the use of {% data variables.product.prodname_github_codespaces %} for repositories owned by organization and enterprise accounts on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %}. These accounts do not include any free minutes or storage for {% data variables.product.prodname_github_codespaces %}. Personal accounts are not currently billed for {% data variables.product.prodname_github_codespaces %} usage. + +A {% data variables.product.prodname_github_codespaces %} instance (a "codespace") incurs charges for compute time, while it is active, and for the amount of storage it uses on disk. {% data variables.product.prodname_github_codespaces %} usage is billed according to the units of measure in the following table: -| Product | SKU | Unit of measure | Price | -| ------------------- | -------- | --------------- | ----- | -| Codespaces Compute | 2 core | 1 hour | $0.18 | -| | 4 core | 1 hour | $0.36 | -| | 8 core | 1 hour | $0.72 | -| | 16 core | 1 hour | $1.44 | -| | 32 core | 1 hour | $2.88 | -| Codespaces Storage | Storage | 1 GB-month | $0.07 | +| Component | Machine type | Unit of measure | Price | +| ------------------- | ------------ | --------------- | ----- | +| Codespaces compute | 2 core | 1 hour | $0.18 | +| | 4 core | 1 hour | $0.36 | +| | 8 core | 1 hour | $0.72 | +| | 16 core | 1 hour | $1.44 | +| | 32 core | 1 hour | $2.88 | +| Codespaces storage | Storage | 1 GB-month* | $0.07 | + +* See "[Billing for storage usage](#billing-for-storage-usage)" below for details of the GB-month unit of measure. + +If you enable prebuilding of codespaces this will incur additional charges. For more information, see "[Billing for {% data variables.product.prodname_codespaces %} prebuilds](#billing-for-codespaces-prebuilds)." ## About billing for {% data variables.product.prodname_github_codespaces %} -{% data reusables.codespaces.codespaces-billing %} +{% data variables.product.prodname_github_codespaces %} is billed in US dollars (USD) according to their compute and storage usage. {% data reusables.codespaces.codespaces-monthly-billing %} xxx -Your {% data variables.product.prodname_github_codespaces %} usage shares your organization or enterprise account's existing billing date, payment method, and receipt. {% data reusables.dotcom_billing.view-all-subscriptions %} +Your {% data variables.product.prodname_github_codespaces %} usage shares your organization or enterprise account's existing payment method, and receipt. For more information, see "[Viewing your subscriptions and billing date](/articles/viewing-your-subscriptions-and-billing-date)." {% ifversion ghec %} If you purchased {% data variables.product.prodname_enterprise %} through a Microsoft Enterprise Agreement, you can connect your Azure Subscription ID to your enterprise account to enable and pay for {% data variables.product.prodname_github_codespaces %} usage. For more information, see "[Connecting an Azure subscription to your enterprise](/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise)." {% endif %} -{% data reusables.dotcom_billing.pricing_calculator.pricing_cal_codespaces %} +### Billing for compute usage +The compute usage of a codespace is the number of minutes for which that codespace is active. Total compute usage is calculated by summing the number of minutes used by all codespaces that are billable to the organization or enterprise. These totals are reported to the billing service every hour, and are billed monthly. + +As an example, if a codespace is active for 1 hour and 15 minutes, then the compute cost will be the hourly cost of the codespace, as determined by its machine type, multiplied by 1.25. + +You can restrict compute usage by stopping your codespaces. For information, see "[Stopping and starting a codespace](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)." Codespaces are stopped automatically after a configurable period of inactivity. The timeout period can be configured by the user, or at the organization level. 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)" and "[Restricting the idle timeout period](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)." + +### Billing for storage usage +For {% data variables.product.prodname_github_codespaces %} billing purposes, this includes all storage used by all codespaces and prebuilds in your account. This includes any files used by the codespaces, such as cloned repositories, configuration files, and extensions, among others. Storage is billed for all of your existing codespaces, regardless of whether they are active or stopped. The storage billing for a codespace ends when it is deleted. + +Codespace storage is reported in GB-months. Your billing month runs from a fixed day in one month until the same day in the next month. In most cases the day of the month is determined by the day you started on your current {% data variables.product.prodname_dotcom %} plan. Your GB-month storage, is calculated as follows. Once every hour, the storage used by all of your currently active and stopped codespaces is assessed. This figure is then divided by the number of hours in the current billing month: `total storage size / hours this month`. The result is added to the running total for codespace storage for the month. + +For example, if you have one codespace that uses 100 GB of storage and has existed for one hour you will have used `100 / (24 * 30) = 0.1388` GB-months of storage in a 30-day month. If your use of GitHub Codespaces during a 30-day month consists of two 100 GB codespaces that both existed for three full days then there will be `24 * 3` hourly reports for the storage of these codespaces, giving a total of: `(24 * 3) * 200 / (24 * 30) = 20` GB-months. + +For each hourly report, the storage usage for the previous hour is calculated in seconds. As a result, you won't be charged for a full hour of storage if a codespace did not exist for the full 60 minutes. At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB. + +As an organization owner, you can: +- List the currently active and stopped codespaces for your organization. For more information, see "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)." In addition to the cost of these codespaces, the cost of {% data variables.product.prodname_github_codespaces %} for the current month may include costs for codespaces that existed earlier in the current month but have since been deleted. +- See the total {% data variables.product.prodname_github_codespaces %} compute and storage usage for your organization for the current month to date. For more information, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." +- Configure your organization settings to manage the cost of {% data variables.product.prodname_github_codespaces %}. For more information, see "[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)." + +To estimate the costs for metered services, you can use the {% data variables.product.prodname_dotcom %} [pricing calculator](https://github.com/pricing/calculator?feature=codespaces). ### Billing for {% data variables.product.prodname_codespaces %} prebuilds -{% data reusables.codespaces.billing-for-prebuilds-default %} +{% data reusables.codespaces.prebuilds-definition %} For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds)." -{% data reusables.codespaces.billing-for-prebuilds-reducing %} +#### {% data variables.product.prodname_actions %} costs for prebuilds + +Prebuilds are created and updated by running a {% data variables.product.prodname_actions %} workflow on a {% data variables.product.prodname_dotcom %}-hosted runner. By default, prebuilds are updated every time you modify the prebuild configuration, or push changes to a prebuild-enabled branch. As with other workflows, while prebuild workflows are running they will either consume some of the Actions minutes included with your account, if you have any, or they will incur charges for Actions minutes. For more information about pricing for Actions minutes, see "[About billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)." There is no associated {% data variables.product.prodname_codespaces %} compute cost for creating or updating prebuilds. + +To reduce consumption of Actions minutes, you can set a prebuild to be updated only when you make a change to your dev container configuration files, or only on a custom schedule. You can also manage your storage usage by adjusting the number of previous versions of each prebuild that are retained. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." + +If you are an organization or enterprise owner, you can track usage of prebuild workflows and storage by downloading a usage report for your organization or enterprise. You can identify workflow runs for prebuilds by filtering the CSV output to only include the workflow called "Create {% data variables.product.prodname_github_codespaces %} Prebuilds." For more information, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage#viewing-github-actions-usage-for-your-organization)." + +#### Storage costs for prebuilds + +In addition to {% data variables.product.prodname_actions %} minutes, you will also be billed for the storage of prebuilds associated with each prebuild configuration for a given repository and region. Storage of prebuilds is billed at the same rate as storage of codespaces. + +The storage cost for a prebuild in a single region will be similar to the storage cost that will be incurred for storing a single codespace created from that prebuild. The storage cost for the generated codespace may be more than the cost for the prebuild if, for example, the `updateContentCommand` and `postCreateCommand` commands are used during codespace creation to download more files to the dev container. + +The total storage costs associated with a prebuild template will depend on: + +* The price of storage per GB. See the table above. +* The size of the generated prebuild in GB. +* The number of regions in which the prebuild is available (because a copy of the prebuild is stored in each region). +* The number of older versions of the prebuild that are retained. + +The storage cost for a prebuild is therefore calculated as: `price per GB * size (GB) * regions * versions`. + +To limit the storage costs associated with prebuilds, you can choose to create prebuilds only in selected regions, and you can specify the number of older versions of prebuilds that will be retained. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." + +{% note %} + +**Note**: Prebuilds may be updated several times during a billing month. Newer versions of a prebuild may be larger or smaller than the previous versions. This will affect the storage charges. For details of how storage is calculated during a billing month, see "[Billing for storage usage](#billing-for-storage-usage)" above. + +{% endnote %} + +#### Cost of codespaces created from prebuilds + +Use of codespaces created using prebuilds is charged at the same rate as regular codespaces. ## Setting a spending limit @@ -72,7 +138,7 @@ For example, a user in an organization can fork a repository within that organiz ## How billing is handled when a repository is transferred -Usage is billed and reported on every hour. As such, you pay for any usage when a repository is within your organization. When a repository is transferred out of your organization, any codespaces in that repository are removed as part of the transfer process. +Usage is calculated every hour. An organization pays for usage of codespaces created from any repository owned by the organization, where the organization settings permit the organization to be billed. For more information, see "[Enabling GitHub Codespaces for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#choose-who-can-create-codespaces-that-are-billed-to-your-organization)." When a repository is transferred out of your organization, ownership and billing responsibility for any codespaces associated with that repository will change accordingly. ## What happens when users are removed 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 839d5dc496..b565c2a921 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 @@ -11,4 +11,3 @@ children: - /viewing-your-github-codespaces-usage - /managing-spending-limits-for-github-codespaces --- - diff --git a/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md b/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md index cf5ad18c14..929ebfd3e8 100644 --- a/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md +++ b/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md @@ -21,6 +21,8 @@ redirect_from: {% data reusables.codespaces.codespaces-spending-limit-requirement %} +{% data reusables.codespaces.codespaces-monthly-billing %} + Once you've reached your spending limit, your organization or repository will no longer be able to create new codespaces, and won't be able to start existing codespaces. Any existing codespaces that are still running will not be shutdown; if you don't change the spending limit, you will not be charged for the amount that exceeds the limit. For more information about pricing for {% data variables.product.prodname_github_codespaces %} usage, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." @@ -67,4 +69,4 @@ You can disable these notifications anytime by navigating to the bottom of the * ## Further reading - "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" -- "[Managing billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)" diff --git a/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md b/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md index 3081c864ef..9652fd43bd 100644 --- a/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md +++ b/translations/ja-JP/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md @@ -21,8 +21,21 @@ Organization owners and billing managers can view {% data variables.product.prod {% 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. -  + +  + + 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-spending-limits-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. + + {% endnote %} + {% data reusables.dotcom_billing.actions-packages-report-download-org-account %} + The data used for this report is updated daily. 1. Filter the report to show only rows that mention "Codespaces" in the `Product` field.  @@ -38,3 +51,7 @@ Enterprise owners and billing managers can view {% data variables.product.prodna 1. Under "{% data variables.product.prodname_codespaces %} monthly usage", view the usage details of each organization in your enterprise account. {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} {% endif %} + +## Further reading + +- "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)" \ No newline at end of file diff --git a/translations/ja-JP/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md b/translations/ja-JP/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md index 51ae89d06d..f8ef3037ef 100644 --- a/translations/ja-JP/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md +++ b/translations/ja-JP/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md @@ -14,23 +14,23 @@ shortTitle: Private image registry A registry is a secure space for storing, managing, and fetching private container images. You may use one to store one or more images. There are many examples of registries, such as {% data variables.product.prodname_container_registry %}, {% data variables.product.prodname_npm_registry %}, Azure Container Registry, or DockerHub. -{% data variables.product.prodname_ghcr_and_npm_registry %} can be configured to allow container images to be pulled seamlessly into {% data variables.product.prodname_github_codespaces %} during codespace creation, without having to provide any authentication credentials. For other image registries, you must create secrets in {% data variables.product.prodname_dotcom %} to store the access details, which will allow {% data variables.product.prodname_github_codespaces %} to access images stored in that registry. +{% data variables.packages.prodname_ghcr_and_npm_registry %} can be configured to allow container images to be pulled seamlessly into {% data variables.product.prodname_github_codespaces %} during codespace creation, without having to provide any authentication credentials. For other image registries, you must create secrets in {% data variables.product.prodname_dotcom %} to store the access details, which will allow {% data variables.product.prodname_github_codespaces %} to access images stored in that registry. -## Accessing images stored in {% data variables.product.prodname_ghcr_and_npm_registry %} +## Accessing images stored in {% data variables.packages.prodname_ghcr_and_npm_registry %} -{% data variables.product.prodname_ghcr_and_npm_registry %} provide the easiest way for {% data variables.product.prodname_github_codespaces %} to consume dev container images. +{% data variables.packages.prodname_ghcr_and_npm_registry %} provide the easiest way for {% data variables.product.prodname_github_codespaces %} to consume dev container images. For more information, see "[Working with the Container registry](/packages/working-with-a-github-packages-registry/working-with-the-container-registry)" and "[Working with the npm registry](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry)". ### Accessing an image published to the same repository as the codespace -If you publish a container image to {% data variables.product.prodname_ghcr_or_npm_registry %} in the same repository that the codespace is being launched in, you will automatically be able to fetch that image on codespace creation. You won't have to provide any additional credentials, unless the **Inherit access from repo** option was unselected when the container image was published. +If you publish a container image to {% data variables.packages.prodname_ghcr_or_npm_registry %} in the same repository that the codespace is being launched in, you will automatically be able to fetch that image on codespace creation. You won't have to provide any additional credentials, unless the **Inherit access from repo** option was unselected when the container image was published. #### Inheriting access from the repository from which an image was published -By default, when you publish a container image to {% data variables.product.prodname_ghcr_or_npm_registry %}, the image inherits the access setting of the repository from which the image was published. For example, if the repository is public, the image is also public. If the repository is private, the image is also private, but is accessible from the repository. +By default, when you publish a container image to {% data variables.packages.prodname_ghcr_or_npm_registry %}, the image inherits the access setting of the repository from which the image was published. For example, if the repository is public, the image is also public. If the repository is private, the image is also private, but is accessible from the repository. -This behavior is controlled by the **Inherit access from repo** option. **Inherit access from repo** is selected by default when publishing via {% data variables.product.prodname_actions %}, but not when publishing directly to {% data variables.product.prodname_ghcr_or_npm_registry %} using a Personal Access Token (PAT). +This behavior is controlled by the **Inherit access from repo** option. **Inherit access from repo** is selected by default when publishing via {% data variables.product.prodname_actions %}, but not when publishing directly to {% data variables.packages.prodname_ghcr_or_npm_registry %} using a Personal Access Token (PAT). If the **Inherit access from repo** option was not selected when the image was published, you can manually add the repository to the published container image's access controls. For more information, see "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#inheriting-access-for-a-container-image-from-a-repository)." @@ -46,13 +46,13 @@ If you want to allow a subset of an organization's repositories to access a cont ### Publishing a container image from a codespace -Seamless access from a codespace to {% data variables.product.prodname_ghcr_or_npm_registry %} is limited to pulling container images. If you want to publish a container image from inside a codespace, you must use a personal access token (PAT) with the `write:packages` scope. +Seamless access from a codespace to {% data variables.packages.prodname_ghcr_or_npm_registry %} is limited to pulling container images. If you want to publish a container image from inside a codespace, you must use a personal access token (PAT) with the `write:packages` scope. We recommend publishing images via {% data variables.product.prodname_actions %}. For more information, see "[Publishing Docker images](/actions/publishing-packages/publishing-docker-images)" and "[Publishing Node.js packages](/actions/publishing-packages/publishing-nodejs-packages)." ## Accessing images stored in other container registries -If you are accessing a container image from a registry that isn't {% data variables.product.prodname_ghcr_or_npm_registry %}, {% data variables.product.prodname_github_codespaces %} checks for the presence of three secrets, which define the server name, username, and personal access token (PAT) for a container registry. If these secrets are found, {% data variables.product.prodname_github_codespaces %} will make the registry available inside your codespace. +If you are accessing a container image from a registry that isn't {% data variables.packages.prodname_ghcr_or_npm_registry %}, {% data variables.product.prodname_github_codespaces %} checks for the presence of three secrets, which define the server name, username, and personal access token (PAT) for a container registry. If these secrets are found, {% data variables.product.prodname_github_codespaces %} will make the registry available inside your codespace. - `<*>_CONTAINER_REGISTRY_SERVER` - `<*>_CONTAINER_REGISTRY_USER` diff --git a/translations/ja-JP/content/codespaces/codespaces-reference/index.md b/translations/ja-JP/content/codespaces/codespaces-reference/index.md index 3811c73c20..23376ac98a 100644 --- a/translations/ja-JP/content/codespaces/codespaces-reference/index.md +++ b/translations/ja-JP/content/codespaces/codespaces-reference/index.md @@ -6,7 +6,6 @@ versions: ghec: '*' product: '{% data reusables.gated-features.codespaces %}' children: - - /understanding-billing-for-github-codespaces - /allowing-your-codespace-to-access-a-private-image-registry - /using-github-copilot-in-github-codespaces - /using-the-vs-code-command-palette-in-codespaces diff --git a/translations/ja-JP/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md b/translations/ja-JP/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md deleted file mode 100644 index f6a802c687..0000000000 --- a/translations/ja-JP/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: Understanding billing for GitHub Codespaces -intro: 'Learn how your {% data variables.product.prodname_github_codespaces %} usage is billed.' -versions: - fpt: '*' - ghec: '*' -redirect_from: - - /github/developing-online-with-codespaces/about-billing-for-codespaces - - /codespaces/getting-started-with-codespaces/about-billing-for-codespaces - - /codespaces/codespaces-reference/about-billing-for-codespaces - - /codespaces/codespaces-reference/understanding-billing-for-codespaces -type: reference -topics: - - Codespaces - - Billing -product: '{% data reusables.gated-features.codespaces %}' -shortTitle: Understanding billing ---- - -This article explains how billing works for your codespaces, and explains how your organization's billing manager can help. - -## Getting access to {% data variables.product.prodname_github_codespaces %} - -Your organization's administrator might limit {% data variables.product.prodname_github_codespaces %} usage to only specific personal accounts. To get access, you will need to contact your billing manager. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)." - -## How much it costs to use {% data variables.product.prodname_codespaces %} - -To see the pricing for {% data variables.product.prodname_github_codespaces %} usage, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-codespaces#codespaces-pricing)." - -## How your codespace usage is billed - -Your codespace is billed for its compute minutes and for the amount of storage it uses on disk. - -If you enable prebuilding of codespaces this will incur additional charges. For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds#about-billing-for-codespaces-prebuilds)." - -### Understanding what compute minutes are -Your codespace is billed for the number of minutes that it's active. If your codespaces window is left idle for 30 minutes, it will automatically shutdown, and compute billing for the codespace will end until you start the codespace again. - -### Understanding how codespace storage is billed -For {% data variables.product.prodname_github_codespaces %}, storage is defined to include any files relating to your codespace, such as the cloned repository, configuration files, and extensions, among others. This storage is billed while your codespace is shutdown. The storage billing for a codespace ends when you manually delete it from https://github.com/codespaces. - -## How spending limits work - -Before your organization can use {% data variables.product.prodname_github_codespaces %}, your billing manager will need to set a spending limit. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." - -## Exporting changes when you have reached your spending limit - -{% data reusables.codespaces.exporting-changes %} - -## Checking your current usage and limits -If you need to check your current usage or spending limit, contact your organization's billing manager. For more information, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." - -## Codespaces can be automatically deleted - -Your codespace will be automatically deleted when you are removed from an organization or repository. - -## Deleting your unused codespaces - -You can manually delete your codespaces in https://github.com/codespaces and from within {% data variables.product.prodname_vscode %}. To reduce the size of a codespace, you can manually delete files using the terminal or from within {% data variables.product.prodname_vscode %}. - -## Further reading - -- "[Managing billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization)" diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md index 2465cfe69e..d3ec7e7ef3 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md @@ -71,7 +71,7 @@ If you try to delete a codespace with unpushed git commits, your editor will not 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)." -You will be charged for the storage of all your codespaces. When you delete a codespace, you will no longer be charged. +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)." diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/index.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/index.md index a77caa0ede..2068d092f9 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/index.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/index.md @@ -11,12 +11,12 @@ children: - /codespaces-lifecycle - /developing-in-a-codespace - /creating-a-codespace + - /deleting-a-codespace - /opening-an-existing-codespace - /using-source-control-in-your-codespace - /using-github-codespaces-for-pull-requests - /stopping-and-starting-a-codespace - /renaming-a-codespace - - /deleting-a-codespace - /forwarding-ports-in-your-codespace - /default-environment-variables-for-your-codespace - /connecting-to-a-private-network 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 782e475ffb..c6a2e16f8a 100644 --- a/translations/ja-JP/content/codespaces/getting-started/deep-dive.md +++ b/translations/ja-JP/content/codespaces/getting-started/deep-dive.md @@ -117,6 +117,6 @@ If you already use {% data variables.product.prodname_vscode_shortname %}, you c ## 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 billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)" - "[Codespaces lifecycle](/codespaces/developing-in-codespaces/codespaces-lifecycle)" diff --git a/translations/ja-JP/content/codespaces/getting-started/quickstart.md b/translations/ja-JP/content/codespaces/getting-started/quickstart.md index 3aa2d59490..213fec6823 100644 --- a/translations/ja-JP/content/codespaces/getting-started/quickstart.md +++ b/translations/ja-JP/content/codespaces/getting-started/quickstart.md @@ -111,4 +111,4 @@ You've successfully created, personalized, and run your first application within ## 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 billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)" 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 7471e3832a..427e5e8323 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 @@ -11,7 +11,7 @@ topics: children: - /enabling-github-codespaces-for-your-organization - /listing-the-codespaces-in-your-organization - - /managing-billing-for-github-codespaces-in-your-organization + - /managing-the-cost-of-github-codespaces-in-your-organization - /managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces - /managing-repository-access-for-your-organizations-codespaces - /reviewing-your-organizations-audit-logs-for-github-codespaces 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 3206984f1d..68ef8f119d 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: 組織内の codespace を一覧表示する +title: Listing the codespaces in your organization shortTitle: List organization codespaces -intro: 組織に対して現在アクティブになっているまたは停止している codespace をすべて一覧表示できます。 +intro: 'You can list all of the currently active or stopped codespaces for your organization.' product: '{% data reusables.gated-features.codespaces %}' permissions: 'To list all of the current codespaces for your organization, you must be an organization owner.' versions: @@ -11,34 +11,31 @@ type: how_to topics: - Codespaces - Administrator -ms.openlocfilehash: 72d59c35641dd77b4d3623cc70b12b5be880be34 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/09/2022 -ms.locfileid: '147865220' --- -## 概要 -組織の所有者は、組織に対して現在アクティブになっているまたは停止している codespace をすべて一覧表示できます。 これを行って、ユーザーが作成している codespace の数を確認し、不要なコストが発生していないことを確認することをお勧めします。 +## Overview -組織用の codespace を一覧表示する最も簡単な方法は、{% data variables.product.prodname_cli %} を使用することです。 REST API を使用することもできます。これにより、各 codespace に関する詳しい情報を確認できます。 +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 GitHub Codespaces](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." -### {% data variables.product.prodname_cli %} を使用して 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. -指定した組織に対する現在の codespace をすべて一覧表示するには、次のコマンドを使用します。 +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)." + +### Using {% data variables.product.prodname_cli %} to list codespaces + +To list all of the current codespaces for a specified organization, use the following command. ```shell{:copy} gh codespace list --org ORGANIZATION ``` -このコマンドを実行すると、codespace ごとに次の情報を含むリストが返されます。 - - 名前と表示名 - - codespace を作成したユーザー - - リポジトリとブランチ - - codespace の現在の状態 +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 をすべて一覧表示するには、次のコマンドを使用します。 +To list all of the current codespaces for an organization that were created by a specific user, use the following command. ```shell{:copy} gh codespace list --org ORGANIZATION --user USER @@ -46,12 +43,12 @@ gh codespace list --org ORGANIZATION --user USER {% note %} -**注**: 上記のコマンドでは、`ORGANIZATION` を、クエリを実行する組織の名前に置き換えます。 組織の所有者でなければなりません。 +**Note**: In the above commands, replace `ORGANIZATION` with the name of the organization you are querying. You must be an owner of the organization. {% endnote %} -### REST API を使用して codespace を一覧表示する +### Using the REST API to list codespaces -組織に対する現在の codespace を一覧表示する別の方法として、`/orgs/{org}/codespaces` API エンドポイントを使用することもできます。 これを使用すると、{% data variables.product.prodname_cli %} よりも多くの情報が返されます。たとえば、マシンの種類に関する詳しい情報などです。 +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. -このエンドポイントについて詳しくは、「[Codespaces Organizations](/rest/codespaces/organizations#list-codespaces-for-the-organization)」を参照してください。 +For more information about this endpoint, see "[Codespaces organizations](/rest/codespaces/organizations#list-codespaces-for-the-organization)." \ No newline at end of file diff --git a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md b/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md deleted file mode 100644 index b00448e35b..0000000000 --- a/translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Managing billing for GitHub Codespaces in your organization -shortTitle: Manage billing -intro: 'You can check your {% data variables.product.prodname_github_codespaces %} usage and set usage limits.' -product: '{% data reusables.gated-features.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 ---- - -## Overview - -To learn about pricing for {% data variables.product.prodname_github_codespaces %}, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)." - -{% data reusables.codespaces.codespaces-billing %} - -- As an organization owner or a billing manager, you can manage {% data variables.product.prodname_github_codespaces %} billing for your organization: ["About billing for Codespaces"](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces) -- As an organization owner, you can list the currently active and stopped codespaces for your organization. In addition to these codespaces, costs for the current month may include costs for codespaces that existed earlier in the current month but have since been deleted. -- For users, there is a guide that explains how billing works: ["Understanding billing for {% data variables.product.prodname_github_codespaces %}"](/codespaces/codespaces-reference/understanding-billing-for-github-codespaces) - -## Usage limits - -You can set a usage limit for the codespaces in your organization or repository. This limit is applied to the compute and storage usage for {% data variables.product.prodname_github_codespaces %}: - -- **Compute minutes:** Compute usage is calculated by the actual number of minutes used by all {% data variables.product.prodname_github_codespaces %} instances while they are active. These totals are reported to the billing service daily, and is billed monthly. You can set a spending limit for {% data variables.product.prodname_github_codespaces %} usage in your organization. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." - -- **Storage usage:** For {% data variables.product.prodname_github_codespaces %} billing purposes, this includes all storage used by all codespaces in your account. This includes resources such as cloned repositories, configuration files, and extensions, among others. These totals are reported to the billing service daily, and is billed monthly. At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB. To check how many compute minutes and storage GB have been used by {% data variables.product.prodname_github_codespaces %}, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage"](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." - -## Disabling or limiting {% data variables.product.prodname_codespaces %} - -You can disable all use of {% data variables.product.prodname_github_codespaces %} that would be billed to your organization. Alternatively, you can specify which organization members or collaborators can use {% data variables.product.prodname_codespaces %} at your 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-disabling-org-billing %} - -You can configure which repositories can be accessed from codespaces created for a particular repository. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)." - -You can limit the choice of types of machine that are available for codespaces created from repositories owned by your organization. This allows you to prevent people using overly resourced machines for their codespaces, and incurring unnecessary charges. For more information, see "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)." - -You can also restrict how long a codespace can remain unused before it is automatically deleted. This can help to reduce storage costs for {% data variables.product.prodname_codespaces %}. For more information, see "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)." - -## Deleting unused codespaces - -Your users can delete their own codespaces in https://github.com/codespaces and from within {% data variables.product.prodname_vscode %}. To reduce the size of a codespace, users can manually delete files using the terminal or from within {% data variables.product.prodname_vscode_shortname %}. - -As an organization owner, you can delete any codespace in your organization. For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)." - -{% note %} - -**Note:** Codespaces are automatically deleted after they have been stopped and have remained inactive for a defined number of days. For more information, see "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)." A codespace can only be manually deleted by the person who created the codespace. - -{% endnote %} - -## Further reading - -- "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)" diff --git a/translations/ja-JP/content/codespaces/overview.md b/translations/ja-JP/content/codespaces/overview.md index 4c07f6674a..1a6ee65780 100644 --- a/translations/ja-JP/content/codespaces/overview.md +++ b/translations/ja-JP/content/codespaces/overview.md @@ -40,6 +40,8 @@ You can also personalize aspects of your codespace environment by using a public For information on pricing, storage, and usage for {% data variables.product.prodname_github_codespaces %}, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." -{% data reusables.codespaces.codespaces-spending-limit-requirement %} For information on how organizations owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an organization, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." +{% data reusables.codespaces.codespaces-spending-limit-requirement %} + +{% data reusables.codespaces.codespaces-monthly-billing %} For information on how organizations owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an organization, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." You can see who will pay for a codespace before you create it. For more information, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)." \ No newline at end of file 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 8b6652eee4..9bbee8317c 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 @@ -14,7 +14,9 @@ redirect_from: ## Overview -Prebuilding your codespaces allows you to be more productive and access your codespace faster, particularly if your repository is large or complex and new codespaces currently take more than 2 minutes to start. This is because any source code, editor extensions, project dependencies, commands, and configurations have already been downloaded, installed, and applied before you create a codespace for your project. Think of a prebuild as a "ready-to-go" template for a codespace. +{% 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. 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. @@ -28,16 +30,10 @@ To create a prebuild you set up a prebuild configuration. When you save the conf 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. +As with other Actions workflows, running a prebuild configuration workflow will either consume some of the Actions minutes included with your account, if you have any, or it will incur charges for 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)." + 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. -## About billing for {% data variables.product.prodname_codespaces %} prebuilds - -{% data reusables.codespaces.billing-for-prebuilds-default %} For details of {% data variables.product.prodname_github_codespaces %} storage pricing, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." - -{% data reusables.codespaces.billing-for-prebuilds-reducing %} - -Use of codespaces created using prebuilds is charged at the same rate as regular codespaces. - ## 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 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. diff --git a/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md b/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md index 9c44b43045..5f8d82217a 100644 --- a/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md +++ b/translations/ja-JP/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md @@ -61,7 +61,7 @@ Before you can configure prebuilds for your project the following must be true: {% note %} **Notes**: - * The prebuild for each region will incur individual charges. You should, therefore, only enable prebuilds for regions in which you know they'll be used. For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds#about-billing-for-codespaces-prebuilds)." + * The prebuild for each region will incur individual charges. You should, therefore, only enable prebuilds for regions in which you know they'll be used. 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)." * Developers can set their default region for {% data variables.product.prodname_github_codespaces %}, which can allow you to enable prebuilds for fewer regions. For more information, see "[Setting your default region for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)." {% endnote %} diff --git a/translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md b/translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md index 9525e0cabf..7898abc4e9 100644 --- a/translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md +++ b/translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md @@ -1,6 +1,6 @@ --- -title: 自動リンクされた参照と URL -intro: URL、Issue、プルリクエスト、コミットへの参照は、自動的に短縮されてリンクに変換されます。 +title: Autolinked references and URLs +intro: 'References to URLs, issues, pull requests, and commits are automatically shortened and converted into links.' redirect_from: - /articles/autolinked-references-and-urls - /github/writing-on-github/autolinked-references-and-urls @@ -11,68 +11,68 @@ versions: ghae: '*' ghec: '*' shortTitle: Auto linked references -ms.openlocfilehash: 6f6548dbe931a7a6adb809aa4e5616db4358c242 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147419690' --- -## URL +## URLs -{% data variables.product.product_name %}は自動的に標準的な URL からリンクを生成します。 +{% data variables.product.product_name %} automatically creates links from standard URLs. `Visit https://github.com` - + -リンクの作成の詳細については、「[基本的な書き方とフォーマットの構文](/articles/basic-writing-and-formatting-syntax/#links)」を参照してください。 +For more information on creating links, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax/#links)." -## Issue およびプルリクエスト +## Issues and pull requests -{% data variables.product.product_name %} 上の会話の中では、Issue やプルリクエストへの参照は自動的に短縮リンクに変換されます。 +Within conversations on {% data variables.product.product_name %}, references to issues and pull requests are automatically converted to shortened links. {% note %} -**メモ:** 自動リンクされた参照は、ウィキやリポジトリ中のファイルでは作成されません。 +**Note:** Autolinked references are not created in wikis or files in a repository. {% endnote %} -| 参照の種類 | 未処理の参照 | ショート リンク | +| Reference type | Raw reference | Short link | | --- | --- | --- | -| イシューまたは pull request の URL | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) -| `#` と、イシューまたは pull request の番号 | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `GH-` と、イシューまたは pull request の番号 | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) | -| `Username/Repository#` と、イシューまたは pull request の番号 | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26) -| `Organization_name/Repository#` と、イシューまたは pull request の番号 | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039) +| Issue or pull request URL | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) +| `#` and issue or pull request number | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | +| `GH-` and issue or pull request number | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) | +| `Username/Repository#` and issue or pull request number | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26) +| `Organization_name/Repository#` and issue or pull request number | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039) -{% ifversion fpt or ghec %} リストで issue、pull request、ディスカッションを参照すると、その参照はタイトルと状態を表示するように展開されます。 タスク リストの詳細については、「[タスク リストについて](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)」を参照してください。 +{% ifversion fpt or ghec %} +If you reference an issue, pull request, or discussion in a list, the reference will unfurl to show the title and state instead. For more information about task lists, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)." {% endif %} -## ラベル -Markdown でラベルの URL を参照すると、ラベルが自動的にレンダリングされます。 同じリポジトリのラベルのみがレンダリングされ、別のリポジトリのラベルを指す URL は任意の [URL](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#urls) としてレンダリングされます。 +## Labels +When referencing the URL of a label in Markdown, the label is automatically rendered. Only labels of the same repository are rendered, URLs pointing to a label from a different repository are rendered as any [URL](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#urls). -ラベルの URL は、ラベル ページに移動し、ラベルをクリックすることで見つけることができます。 たとえば、パブリック [ドキュメント リポジトリ](https://github.com/github/docs/)内のラベル "enhancement" の URL は次のようになります +The URL of a label can be found by navigating to the labels page and clicking on a label. For example, the URL of the label "enhancement" in our public [docs repository](https://github.com/github/docs/) is ```md https://github.com/github/docs/labels/enhancement ``` +{% note %} -## コミット SHA +**Note:** If the label name contains a period (`.`), the label will not automatically render from the label URL. -コミットの SHA ハッシュへの参照は、{% data variables.product.product_name %}上のコミットへの短縮リンクに自動的に変換されます。 +{% endnote %} -| 参照の種類 | 未処理の参照 | ショート リンク | +## Commit SHAs + +References to a commit's SHA hash are automatically converted into shortened links to the commit on {% data variables.product.product_name %}. + +| Reference type | Raw reference | Short link | | --- | --- | --- | -| コミット URL | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | +| Commit URL | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | `Username/Repository@SHA` | `jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e` | [`jlord/sheetsee.js@a5c3785`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -## 外部リソースへのカスタム自動リンク +## Custom autolinks to external resources {% data reusables.repositories.autolink-references %} -## 参考資料 +## Further reading -- [Basic writing and formatting syntax (基本的な書き方とフォーマットの構文)](/articles/basic-writing-and-formatting-syntax) +- "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/ja-JP/content/packages/learn-github-packages/about-permissions-for-github-packages.md b/translations/ja-JP/content/packages/learn-github-packages/about-permissions-for-github-packages.md index 1aab26f3ae..68dd781bd9 100644 --- a/translations/ja-JP/content/packages/learn-github-packages/about-permissions-for-github-packages.md +++ b/translations/ja-JP/content/packages/learn-github-packages/about-permissions-for-github-packages.md @@ -1,6 +1,6 @@ --- -title: GitHub Packagesの権限について -intro: パッケージの権限の管理方法を学んでください。 +title: About permissions for GitHub Packages +intro: Learn about how to manage permissions for your packages. product: '{% data reusables.gated-features.packages %}' versions: fpt: '*' @@ -8,83 +8,80 @@ versions: ghae: '*' ghec: '*' shortTitle: About permissions -ms.openlocfilehash: 1663fa3bfc8fd6149e43fd9cf09a8362739c7341 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147704940' --- -{% ifversion fpt or ghec %} パッケージの権限は、リポジトリ スコープかユーザー/組織スコープです。 -{% endif %} - -## リポジトリスコープのパッケージの権限 - -リポジトリスコープのパッケージは、パッケージを所有するリポジトリの権限と可視性を継承します。 リポジトリをスコープとするパッケージは、リポジトリのメインページにアクセスし、ページ右にある **パッケージ** リンクをクリックすれば見つかります。 {% ifversion fpt or ghec %}詳細については、「[リポジトリのパッケージへの接続](/packages/learn-github-packages/connecting-a-repository-to-a-package)」を参照してください。{% endif %} - -以下の {% data variables.product.prodname_registry %} レジストリでは、リポジトリ スコープのアクセス許可 **のみ** を使います。 - - {% ifversion not fpt or ghec %}- Docker レジストリ (`docker.pkg.github.com`){% endif %} {% ifversion packages-npm-v2 %}{% else %}- npm レジストリ{% endif %} - - RubyGemsレジストリ - - Apache Mavenレジストリ - - NuGetレジストリ - -{% ifversion packages-npm-v2 %}{% data variables.product.prodname_ghcr_and_npm_registry %}の場合、パッケージのスコープをユーザー、組織に設定、またはリポジトリにリンクすることを許可できます。{% endif %} {% ifversion fpt or ghec %} -## ユーザ/Organizationスコープのパッケージの詳細な権限 +The permissions for packages are either repository-scoped or user/organization-scoped. +{% endif %} -詳細な権限を持つパッケージは、個人ユーザもしくはOrganizationアカウントをスコープとします。 パッケージのアクセス制御と可視性は、パッケージに接続された(あるいはリンクされた)リポジトリは別個に変更できます。 +## Permissions for repository-scoped packages -現在のところ、{% data variables.product.prodname_ghcr_and_npm_registry %}でコンテナ イメージ パッケージに関する細かいアクセス許可を提供しています。 +A repository-scoped package inherits the permissions and visibility of the repository that owns the package. You can find a package scoped to a repository by going to the main page of the repository and clicking the **Packages** link to the right of the page. {% ifversion fpt or ghec %}For more information, see "[Connecting a repository to a package](/packages/learn-github-packages/connecting-a-repository-to-a-package)."{% endif %} -## コンテナイメージの可視性とアクセス権限 +The {% data variables.product.prodname_registry %} registries below **only** use repository-scoped permissions: + + {% ifversion not fpt or ghec %}- Docker registry (`docker.pkg.github.com`){% endif %} + {% ifversion packages-npm-v2 %}{% else %}- npm registry{% endif %} + - RubyGems registry + - Apache Maven registry + - NuGet registry + +{% ifversion packages-npm-v2 %}For {% data variables.packages.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} + +{% ifversion fpt or ghec %} +## Granular permissions for user/organization-scoped packages + +Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of the package separately from a repository that is connected (or linked) to a package. + +Currently, the {% data variables.packages.prodname_ghcr_and_npm_registry %} offer granular permissions for your container image packages. + +## Visibility and access permissions for container images {% data reusables.package_registry.visibility-and-access-permissions %} -詳細については、「[パッケージのアクセス制御と可視性の設定](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)」を参照してください。 +For more information, see "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." {% endif %} -## パッケージの管理 +## About scopes and permissions for package registries -パッケージ レジストリでホストされているパッケージを使用もしくは管理するためには、適切なスコープを持つトークンを使わなければならず、個人用アカウントが適切な権限を持っていなければなりません。 +To use or manage a package hosted by a package registry, you must use a token with the appropriate scope, and your personal account must have appropriate permissions. -次に例を示します。 -- リポジトリからパッケージをダウンロードしてインストールするには、トークンに `read:packages` スコープが設定されていなければならず、ユーザー アカウントには読み取り権限が設定されていなければなりません。 -- {% ifversion fpt or ghes or ghec %}{% data variables.product.product_name %} 上のパッケージを削除するには、ご利用のトークンに少なくとも `delete:packages` および `read:packages` スコープが設定されている必要があります。 リポジトリをスコープとするパッケージには、`repo` スコープも必要です。 詳細については、「[パッケージを削除および復元する](/packages/learn-github-packages/deleting-and-restoring-a-package)」を参照してください。{% elsif ghae %}{% data variables.product.product_name %} で指定したバージョンのパッケージを削除するには、ご利用のトークンに `delete:packages` および `repo` スコープが設定されている必要があります。 詳細については、「[パッケージを削除および復元する](/packages/learn-github-packages/deleting-and-restoring-a-package)」を参照してください。{% endif %} +For example: +- To download and install packages from a repository, your token must have the `read:packages` scope, and your user account must have read permission. +- {% ifversion fpt or ghes or ghec %}To delete a package on {% data variables.product.product_name %}, your token must at least have the `delete:packages` and `read:packages` scope. The `repo` scope is also required for repo-scoped packages. For more information, see "[Deleting and restoring a package](/packages/learn-github-packages/deleting-and-restoring-a-package)."{% elsif ghae %}To delete a specified version of a package on {% data variables.product.product_name %}, your token must have the `delete:packages` and `repo` scope. For more information, see "[Deleting and restoring a package](/packages/learn-github-packages/deleting-and-restoring-a-package)."{% endif %} -| Scope | 説明 | 必要な権限 | +| Scope | Description | Required permission | | --- | --- | --- | -|`read:packages`| {% data variables.product.prodname_registry %}からのパッケージのダウンロードとインストール | 読み取り | -|`write:packages`| {% data variables.product.prodname_registry %}へのパッケージのアップロードと公開 | 書き込み | -| `delete:packages` | {% ifversion fpt or ghes or ghec %} {% data variables.product.prodname_registry %}からのパッケージの削除{% elsif ghae %}{% data variables.product.prodname_registry %}からの指定したバージョンのパッケージの削除{% endif %} | admin | -| `repo` | パッケージをアップロードおよび削除する (`write:packages` または `delete:packages` と一緒に) | 書き込みもしくは読み取り | +|`read:packages`| Download and install packages from {% data variables.product.prodname_registry %} | read | +|`write:packages`| Upload and publish packages to {% data variables.product.prodname_registry %} | write | +| `delete:packages` | {% ifversion fpt or ghes or ghec %} Delete packages from {% data variables.product.prodname_registry %} {% elsif ghae %} Delete specified versions of packages from {% data variables.product.prodname_registry %} {% endif %} | admin | +| `repo` | Upload and delete packages (along with `write:packages`, or `delete:packages`) | write or admin | -{% data variables.product.prodname_actions %} ワークフローを作成する際には、`GITHUB_TOKEN` を使って {% data variables.product.prodname_registry %} にパッケージを公開してインストールでき、個人用アクセス トークンを保存して管理する必要はありません。 +When you create a {% data variables.product.prodname_actions %} workflow, you can use the `GITHUB_TOKEN` to publish and install packages in {% data variables.product.prodname_registry %} without needing to store and manage a personal access token. -詳細については、以下を参照してください: {% ifversion fpt or ghec %} -- "[パッケージのアクセス制御と可視性の設定](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)"{% endif %} -- "[{% data variables.product.prodname_actions %} を使用したパッケージの発行とインストール](/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions)" -- 「[個人用アクセス トークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token/)」 -- "[利用できるスコープ](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)" +For more information, see:{% ifversion fpt or ghec %} +- "[Configuring a package’s access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)"{% endif %} +- "[Publishing and installing a package with {% data variables.product.prodname_actions %}](/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions)" +- "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token/)" +- "[Available scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/#available-scopes)" -## {% data variables.product.prodname_actions %}ワークフローでのパッケージへのアクセスのメンテナンス +## Maintaining access to packages in {% data variables.product.prodname_actions %} workflows -ワークフローがパッケージへのアクセスを確実に維持するためには、確実にワークフローで正しいアクセストークンを使用し、パッケージへの{% data variables.product.prodname_actions %}アクセスを有効化してください。 +To ensure your workflows will maintain access to your packages, ensure that you're using the right access token in your workflow and that you've enabled {% data variables.product.prodname_actions %} access to your package. -{% data variables.product.prodname_actions %} の概念的背景や、ワークフローでパッケージを使用する例については、「[GitHub Actions ワークフローを利用した GitHub Packages の管理](/packages/managing-github-packages-using-github-actions-workflows)」を参照してください。 +For more conceptual background on {% data variables.product.prodname_actions %} or examples of using packages in workflows, see "[Managing GitHub Packages using GitHub Actions workflows](/packages/managing-github-packages-using-github-actions-workflows)." -### アクセス トークン +### Access tokens -- ワークフロー リポジトリに関連付けられているパッケージを発行するには、`GITHUB_TOKEN` を使用します。 -- `GITHUB_TOKEN`がアクセスできない他のプライベート リポジトリに関連するパッケージをインストールするには、個人用アクセス トークンを使用してください。 +- To publish packages associated with the workflow repository, use `GITHUB_TOKEN`. +- To install packages associated with other private repositories that `GITHUB_TOKEN` can't access, use a personal access token -{% data variables.product.prodname_actions %} ワークフローで使用される `GITHUB_TOKEN` の詳細については、「[ワークフローで認証する](/actions/reference/authentication-in-a-workflow#using-the-github_token-in-a-workflow)」を参照してください。 +For more information about `GITHUB_TOKEN` used in {% data variables.product.prodname_actions %} workflows, see "[Authentication in a workflow](/actions/reference/authentication-in-a-workflow#using-the-github_token-in-a-workflow)." {% ifversion fpt or ghec %} -### コンテナイメージに対する{% data variables.product.prodname_actions %}アクセス +### {% data variables.product.prodname_actions %} access for container images -ワークフローがコンテナイメージに確実にアクセスできるようにするには、ワークフローが実行されるリポジトリへの{% data variables.product.prodname_actions %}アクセスを有効化しなければなりません。 この設定は、パッケージの設定ページにあります。 詳細については、「[パッケージへのワークフローのアクセスの確保](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package)」を参照してください。 +To ensure your workflows have access to your container image, you must enable {% data variables.product.prodname_actions %} access to the repositories where your workflow is run. You can find this setting on your package's settings page. For more information, see "[Ensuring workflow access to your package](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package)." {% endif %} diff --git a/translations/ja-JP/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md b/translations/ja-JP/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md index 536a07b00e..3e7204200c 100644 --- a/translations/ja-JP/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md +++ b/translations/ja-JP/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md @@ -15,7 +15,7 @@ shortTitle: Access control & visibility Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of a package separately from the repository that it is connected (or linked) to. -Currently, you can only use granular permissions with the {% data variables.product.prodname_ghcr_and_npm_registry %}. Granular permissions are not supported in our other package registries, such as the RubyGems registry.{% ifversion docker-ghcr-enterprise-migration %} For more information about migration to the {% data variables.product.prodname_container_registry %}, see "[Migrating to the {% data variables.product.prodname_container_registry %} from the Docker registry](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)."{% endif %} +Currently, you can only use granular permissions with the {% data variables.packages.prodname_ghcr_and_npm_registry %}. Granular permissions are not supported in our other package registries, such as the RubyGems registry.{% ifversion docker-ghcr-enterprise-migration %} For more information about migration to the {% data variables.product.prodname_container_registry %}, see "[Migrating to the {% data variables.product.prodname_container_registry %} from the Docker registry](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)."{% endif %} For more information about permissions for repository-scoped packages, packages-related scopes for PATs, or managing permissions for your actions workflows, see "[About permissions for GitHub Packages](/packages/learn-github-packages/about-permissions-for-github-packages)." @@ -105,7 +105,7 @@ To further customize access to your container image, see "[Configuring access to {% ifversion fpt or ghec %} ## Ensuring {% data variables.product.prodname_github_codespaces %} access to your package -By default, a codespace can seamlessly access certain packages in the {% data variables.product.prodname_ghcr_and_npm_registry %}, such as those published in the same repository with the **Inherit access** option selected. For more information on which access is automatically configured, see "[Allowing your codespace to access a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry#accessing-images-stored-in-container-registry-and-npm-registry)." +By default, a codespace can seamlessly access certain packages in the {% data variables.packages.prodname_ghcr_and_npm_registry %}, such as those published in the same repository with the **Inherit access** option selected. For more information on which access is automatically configured, see "[Allowing your codespace to access a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry#accessing-images-stored-in-container-registry-and-npm-registry)." Otherwise, to ensure that a codespace has access to your package, you must grant access to the repository where the codespace is being launched. diff --git a/translations/ja-JP/content/packages/learn-github-packages/deleting-and-restoring-a-package.md b/translations/ja-JP/content/packages/learn-github-packages/deleting-and-restoring-a-package.md index 456eca2565..f3595a34ff 100644 --- a/translations/ja-JP/content/packages/learn-github-packages/deleting-and-restoring-a-package.md +++ b/translations/ja-JP/content/packages/learn-github-packages/deleting-and-restoring-a-package.md @@ -62,7 +62,7 @@ The {% data variables.product.prodname_registry %} registries below **only** use - Apache Maven registry - NuGet registry -{% ifversion packages-npm-v2 %}For {% data variables.product.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} +{% ifversion packages-npm-v2 %}For {% data variables.packages.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} {% ifversion fpt or ghec %} diff --git a/translations/ja-JP/content/packages/learn-github-packages/introduction-to-github-packages.md b/translations/ja-JP/content/packages/learn-github-packages/introduction-to-github-packages.md index 9f6228e86c..530f6d7efe 100644 --- a/translations/ja-JP/content/packages/learn-github-packages/introduction-to-github-packages.md +++ b/translations/ja-JP/content/packages/learn-github-packages/introduction-to-github-packages.md @@ -1,6 +1,6 @@ --- -title: GitHub Packages の概要 -intro: '{% data variables.product.prodname_registry %} はソフトウェア パッケージのホスティング サービスであり、ソフトウェア パッケージをプライベートに{% ifversion ghae %}特定のユーザーに対して、または Enterprise に対して内部的に{% else %}またはパブリックに{% endif %}ホストでき、パッケージをプロジェクト中で依存関係として使えるようになります。' +title: Introduction to GitHub Packages +intro: '{% data variables.product.prodname_registry %} is a software package hosting service that allows you to host your software packages privately {% ifversion ghae %} for specified users or internally for your enterprise{% else %}or publicly{% endif %} and use packages as dependencies in your projects.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/about-github-package-registry @@ -16,118 +16,122 @@ versions: ghae: '*' ghec: '*' shortTitle: Introduction -ms.openlocfilehash: a141c93378f836eebf5ff33b0ced482409d6e577 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147704948' --- -{% data reusables.package_registry.packages-ghes-release-stage %} {% data reusables.package_registry.packages-ghae-release-stage %} -## {% data variables.product.prodname_registry %} について +{% data reusables.package_registry.packages-ghes-release-stage %} +{% data reusables.package_registry.packages-ghae-release-stage %} -{% data variables.product.prodname_registry %} は、コンテナーやその他の依存関係を含むパッケージをホストおよび管理するためのプラットフォームです。 {% data variables.product.prodname_registry %}は、ソースコードとパッケージを 1 か所にまとめ、統合された権限管理{% ifversion fpt or ghec %}と支払い{% endif %}を提供し、{% data variables.product.product_name %} 上でのソフトウェア開発を一元化できるようにします。 +## About {% data variables.product.prodname_registry %} -{% data variables.product.prodname_registry %}は、{% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API、{% data variables.product.prodname_actions %}、webhookと統合して、コード、CI、デプロイメントのソリューションを含むエンドツーエンドのDevOpsワークフローを作成できます。 +{% data variables.product.prodname_registry %} is a platform for hosting and managing packages, including containers and other dependencies. {% data variables.product.prodname_registry %} combines your source code and packages in one place to provide integrated permissions management{% ifversion fpt or ghec %} and billing{% endif %}, so you can centralize your software development on {% data variables.product.product_name %}. -{% data variables.product.prodname_registry %}は、nmp、RubyGems、Apache Maven、Gradle、Docker、NuGetといった、広く使われているパッケージマネージャーに対する様々なパッケージレジストリを提供しています。 {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %} の {% data variables.product.prodname_container_registry %} はコンテナーに最適化されており、Docker と OCI イメージをサポートします。{% endif %} {% data variables.product.prodname_registry %} がサポートするさまざまなパッケージ レジストリについての詳しい情報は、「[{% data variables.product.prodname_registry %} レジストリの操作](/packages/working-with-a-github-packages-registry)」をご覧ください。 +You can integrate {% data variables.product.prodname_registry %} with {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} APIs, {% data variables.product.prodname_actions %}, and webhooks to create an end-to-end DevOps workflow that includes your code, CI, and deployment solutions. + +{% data variables.product.prodname_registry %} offers different package registries for commonly used package managers, such as npm, RubyGems, Apache Maven, Gradle, Docker, and NuGet. {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_container_registry %} is optimized for containers and supports Docker and OCI images.{% endif %} For more information on the different package registries that {% data variables.product.prodname_registry %} supports, see "[Working with a {% data variables.product.prodname_registry %} registry](/packages/working-with-a-github-packages-registry)." {% ifversion fpt or ghec %} - + {% else %} - + {% endif %} -{% data variables.product.product_name %}では、ライセンスのようなメタデータやパッケージのREADMEを表示したり、統計をダウンロードしたり、バージョン履歴を見たりできます。 詳しくは、「[パッケージの表示](/packages/manage-packages/viewing-packages)」をご覧ください。 +You can view a package's README, as well as metadata such as licensing, download statistics, version history, and more on {% data variables.product.product_name %}. For more information, see "[Viewing packages](/packages/manage-packages/viewing-packages)." {% ifversion ghes %} -{% data variables.product.product_name %} での {% data variables.product.prodname_registry %} の構成について詳しくは、「[Enterprise 向けの {% data variables.product.prodname_registry %} を使い始める](/admin/packages/getting-started-with-github-packages-for-your-enterprise)」を参照してください。 +For more information about the configuration of {% data variables.product.prodname_registry %} on {% data variables.product.product_name %}, see "[Getting started with {% data variables.product.prodname_registry %} for your enterprise](/admin/packages/getting-started-with-github-packages-for-your-enterprise)." {% endif %} -### パッケージの権限と可視性の概要 +### Overview of package permissions and visibility | | | |--------------------|--------------------| -| アクセス許可 | {% ifversion fpt or ghec %}パッケージの権限は、パッケージがホストされているリポジトリから継承したり、{% data variables.product.prodname_ghcr_and_npm_registry %}内のパッケージの場合は特定のユーザーまたは Organization アカウントに対して定義したりできます。 詳しくは、「[パッケージのアクセス制御と可視性の設定](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)」を参照してください。 {% else %}それぞれのパッケージは、ホストされているリポジトリの権限を継承します。| -{% raw %} ```yaml +{% raw %} +```yaml on: push: branches: ['release'] @@ -179,7 +177,7 @@ on: {% endraw %} |
-release というブランチに変更をプッシュするたびに、Create and publish a Docker image ワークフローを実行するよう設定します。
+ Configures the Create and publish a Docker image workflow to run every time a change is pushed to the branch called release.
|
- ワークフローに2つのカスタムの環境変数を定義します。 これらは{% data variables.product.prodname_container_registry %}ドメイン、そしてこのワークフローがビルドするDockerイメージの名前として使われます。 + Defines two custom environment variables for the workflow. These are used for the {% data variables.product.prodname_container_registry %} domain, and a name for the Docker image that this workflow builds. | @@ -211,7 +209,7 @@ jobs: {% endraw %}- このワークフロー中には1つのジョブがあります。 これは、Ubuntuの利用可能な最新バージョンで実行されるよう設定されています。 + There is a single job in this workflow. It's configured to run on the latest available version of Ubuntu. | @@ -237,7 +235,7 @@ run-npm-build:- このジョブではNPMをインストールし、それをアプリケーションのビルドに使用します。 + This job installs NPM and uses it to build the app. | @@ -272,13 +270,14 @@ run-npm-test:
-このジョブでは npm test を使用してコードをテストします。 needs: run-npm-build コマンドにより、このジョブは run-npm-build ジョブに依存するようになります。
+ This job uses npm test to test the code. The needs: run-npm-build command makes this job dependent on the run-npm-build job.
|
| -{% raw %} ```yaml +{% raw %} +```yaml build-and-push-image: runs-on: ubuntu-latest needs: run-npm-test @@ -286,7 +285,7 @@ build-and-push-image: {% endraw %} |
-このジョブはパッケージを公開します。 needs: run-npm-test コマンドにより、このジョブは run-npm-test ジョブに依存するようになります。
+ This job publishes the package. The needs: run-npm-test command makes this job dependent on the run-npm-test job.
|
| -{% raw %} ```yaml +{% raw %} +```yaml permissions: contents: read packages: write @@ -302,14 +302,15 @@ permissions: {% endraw %} |
-GITHUB_TOKEN に付与されているアクセス許可をこのジョブ内のアクション用に設定します。
+ Sets the permissions granted to the GITHUB_TOKEN for the actions in this job.
|
| -{% raw %} ```yaml +{% raw %} +```yaml - name: Log in to the Container registry uses: docker/login-action@f054a8b539a109f9f41c372932f1ae047eff08c9 with: @@ -320,13 +321,14 @@ permissions: {% endraw %} |
-パッケージを公開するアカウントとパスワードを使ってレジストリにログインする Log in to the {% data variables.product.prodname_container_registry %} というステップを作成します。 いったん公開されると、パッケージはここで定めたアカウントが所有することになります。
+ Creates a step called Log in to the {% data variables.product.prodname_container_registry %}, which logs in to the registry using the account and password that will publish the packages. Once published, the packages are owned by the account defined here.
|
| -{% raw %} ```yaml +{% raw %} +```yaml - name: Extract metadata (tags, labels) for Docker id: meta uses: docker/metadata-action@98669ae865ea3cffbcbaa878cf57c20bbf1c6c38 @@ -336,14 +338,15 @@ permissions: {% endraw %} |
-このステップは docker/metadata-action を使って、指定されたイメージに適用されるタグとラベルを抽出します。 id "meta"は、このステップの出力が以降のステップから参照できるようにします。 images の値は、タグとラベルのためのベース名を提供します。
+ This step uses docker/metadata-action to extract tags and labels that will be applied to the specified image. The id "meta" allows the output of this step to be referenced in a subsequent step. The images value provides the base name for the tags and labels.
|
| -{% raw %} ```yaml +{% raw %} +```yaml - name: Log in to GitHub Docker Registry uses: docker/login-action@f054a8b539a109f9f41c372932f1ae047eff08c9 with: @@ -354,70 +357,75 @@ permissions: {% endraw %} |
-パッケージを公開するアカウントとパスワードを使ってレジストリにログインする Log in to GitHub Docker Registry という新しいステップを作成します。 いったん公開されると、パッケージはここで定めたアカウントが所有することになります。
+ Creates a new step called Log in to GitHub Docker Registry, which logs in to the registry using the account and password that will publish the packages. Once published, the packages are owned by the account defined here.
|
| -{% raw %} ```yaml +{% raw %} +```yaml - name: Build and push Docker image ``` {% endraw %} |
-Build and push Docker image という新しいステップを作成します。 このステップは、build-and-push-image ジョブの一部として実行されます。
+ Creates a new step called Build and push Docker image. This step runs as part of the build-and-push-image job.
|
| -{% raw %} ```yaml +{% raw %} +```yaml uses: docker/build-push-action@ad44023a93711e3deb337508980b4b5e9bcdc5dc ``` {% endraw %} |
-Docker の build-push-action アクションを使用して、リポジトリの Dockerfile を元にイメージをビルドします。 ビルドが成功すると、イメージを{% data variables.product.prodname_registry %}にプッシュします。
+ Uses the Docker build-push-action action to build the image, based on your repository's Dockerfile. If the build succeeds, it pushes the image to {% data variables.product.prodname_registry %}.
|
| -{% raw %} ```yaml +{% raw %} +```yaml with: ``` {% endraw %} |
-必要なパラメーターを build-push-action アクションに送信します。 これらは以降の行で定義されます。
+ Sends the required parameters to the build-push-action action. These are defined in the subsequent lines.
|
| -{% raw %} ```yaml +{% raw %} +```yaml context: . ``` {% endraw %} | -ビルドのコンテキストを、指定されたパス内にあるファイル群として定義します。 詳細については、「使用」を参照してください。 + Defines the build's context as the set of files located in the specified path. For more information, see "Usage." |
| -{% raw %} ```yaml +{% raw %} +```yaml push: true ``` {% endraw %} | -ビルドに成功したら、このイメージをレジストリにプッシュします。 + Pushes this image to the registry if it is built successfully. | - "meta"ステップで抽出されたタグとラベルを追加します。 + Adds the tags and labels extracted in the "meta" step. | {% else %}
| -{% ifversion ghae %} {% raw %} ```yaml +{% ifversion ghae %} +{% raw %} +```yaml tags: | docker.YOUR-HOSTNAME.com/${{ github.repository }}/octo-image:${{ github.sha }} ``` -{% endraw %} {% else %} {% raw %} ```yaml +{% endraw %} +{% else %} +{% raw %} +```yaml tags: | docker.pkg.github.com/${{ github.repository }}/octo-image:${{ github.sha }} ``` -{% endraw %} {% endif %} +{% endraw %} +{% endif %} | -ワークフローをトリガーしたコミットのSHAでイメージにタグ付けします。 + Tags the image with the SHA of the commit that triggered the workflow. |

(1) 欧州経済地域に関する協定 (EEA 協定) では、欧州連合の内部市場をアイスランド、リヒテンシュタイン、ノルウェーに拡大することを規定しています。 2016 年 679 番 EU 規則を含む EU のデータ保護法は、EEA 協定の対象であり、その別紙 XI に組み込まれています。 したがって、EEA に拠点を置く第三者へのデータ輸入者による開示は、本条項の目的のための転送とは認められません。
- -(2) 本要件は、第 7 条に従って、適切な構成要素の元で本条項に準拠する下請処理者によって満たされる場合があります。
- -(3) 本条項の遵守に対する当該法律および慣行の影響に関しては、全体的な評価の一部としてさまざまな要素が考慮される場合があります。 当該要素には、十分な代表的な時間枠をカバーする公的機関からの開示請求より以前の事例に関する関連性のある文書化された実務経験、またはそのような開示請求の不存在が含まれる場合があります。 これは特に、デュー デリジェンスに従って継続的に作成され、上級管理職レベルで認定された内部記録またはその他の文書を指します。ただし、この情報を第三者と合法的に共有できる場合に限ります。 データ輸入者が本条項を遵守することを妨げられないと結論付けるために、当該実務経験に依拠する場合、他の関連する客観的な要素によって補完される必要があり、両当事者は、これらの要素と一緒に十分な重みがあるかどうかをこの結論を裏付ける信頼性および代表性の観点から、慎重に検討する必要があります。 特に、両当事者は、その実務経験が裏付けられたものかどうか、および同部門内での請求の有無に関する公開済みあるいはアクセス可能な信頼できる情報や法律の実際の適用 (監督機関による判例、報告書など) と矛盾がないかどうかを考慮する必要があります。
diff --git a/translations/ja-JP/content/site-policy/privacy-policies/index.md b/translations/ja-JP/content/site-policy/privacy-policies/index.md index 88306df9eb..cfcc93a3f2 100644 --- a/translations/ja-JP/content/site-policy/privacy-policies/index.md +++ b/translations/ja-JP/content/site-policy/privacy-policies/index.md @@ -8,7 +8,6 @@ topics: children: - /github-privacy-statement - /global-privacy-practices - - /github-data-protection-agreement - /github-subprocessors-and-cookies - /github-codespaces-privacy-statement - /github-candidate-privacy-policy diff --git a/translations/ja-JP/data/reusables/actions/hosted-runner-security.md b/translations/ja-JP/data/reusables/actions/hosted-runner-security.md index 03b8cb816f..bbc2edbd12 100644 --- a/translations/ja-JP/data/reusables/actions/hosted-runner-security.md +++ b/translations/ja-JP/data/reusables/actions/hosted-runner-security.md @@ -1,11 +1 @@ ---- -ms.openlocfilehash: 39b050df26b1192db1f0d539b2bd789f90c022d1 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/09/2022 -ms.locfileid: "147763985" ---- -プライベート リポジトリでは、{% data variables.actions.hosted_runner %} のみ使うことをお勧めします。 -- ワークフロー内でコードを実行する pull request を作成することで、リポジトリのフォークによって、{% data variables.actions.hosted_runner %} 上で危険なコードが実行される可能性があります。 -- フォークされたリポジトリを使って {% data variables.actions.hosted_runner %} 上でジョブを実行できるようにすると、予測しないコストが発生する可能性があります。 \ No newline at end of file +If you are using a Fixed IP range, we recommend that you only use {% data variables.actions.hosted_runner %}s with private repositories. Forks of your repository can potentially run dangerous code on your {% data variables.actions.hosted_runner %} by creating a pull request that executes the code in a workflow. diff --git a/translations/ja-JP/data/reusables/codespaces/billing-for-prebuilds-default.md b/translations/ja-JP/data/reusables/codespaces/billing-for-prebuilds-default.md deleted file mode 100644 index 4dc9bdb0f6..0000000000 --- a/translations/ja-JP/data/reusables/codespaces/billing-for-prebuilds-default.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -ms.openlocfilehash: 0036dd5cf979531479a7ddf523c7475391b29c0a -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147548009" ---- -既定では、プレビルドを作成または更新するたびに、またはプレビルドが有効なブランチにプッシュするたびに、{% data variables.product.prodname_actions %} ワークフローがトリガーされます。 他のワークフローと同様に、プレビルド ワークフローが実行されている間、アカウントに含まれているアクションの分数がある場合はその一部を消費するか、アクションの分数の料金が発生します。 アクション分の価格の詳細については、「[{% data variables.product.prodname_actions %} の課金について](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)」を参照してください。 - -{% data variables.product.prodname_actions %} の利用時間 (分) と併せて、特定のリポジトリとリージョンに対する各プレビルド構成に関連付けられているプレビルドのストレージについても課金されます。 プレビルドのストレージは、codespace のストレージと同じレートで課金されます。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/codespaces/billing-for-prebuilds-reducing.md b/translations/ja-JP/data/reusables/codespaces/billing-for-prebuilds-reducing.md deleted file mode 100644 index 03f82b7b20..0000000000 --- a/translations/ja-JP/data/reusables/codespaces/billing-for-prebuilds-reducing.md +++ /dev/null @@ -1,3 +0,0 @@ -To reduce consumption of Actions minutes, you can set a prebuild to be updated only when you make a change to your dev container configuration files, or only on a custom schedule. You can also manage your storage usage by adjusting the number of template versions to be retained for your prebuild configurations. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." - -If you are an organization or enterprise owner, you can track usage of prebuild workflows and storage by downloading a {% data variables.product.prodname_actions %} usage report for your organization or enterprise. You can identify workflow runs for prebuilds by filtering the CSV output to only include the workflow called "Create {% data variables.product.prodname_github_codespaces %} Prebuilds." For more information, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage#viewing-github-actions-usage-for-your-organization)." diff --git a/translations/ja-JP/data/reusables/codespaces/codespaces-billing.md b/translations/ja-JP/data/reusables/codespaces/codespaces-billing.md deleted file mode 100644 index 8bcd203e34..0000000000 --- a/translations/ja-JP/data/reusables/codespaces/codespaces-billing.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -ms.openlocfilehash: 845c770a8a03c57a4c10a84d28fd4d3d78282042 -ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147111123" ---- -{% data variables.product.prodname_codespaces %} は、コンピューティングとストレージの使用量に応じて米ドル (USD) で課金されます。 - -### コンピューティング使用量の計算 -コンピューティング使用量は、{% data variables.product.prodname_github_codespaces %} インスタンスがアクティブであるアップタイム時間 (分) の合計として定義されます。 コンピューティング使用量は、すべての codespace で実際に使われた分数を合計することで計算されます。 これらの合計は、毎日課金サービスに報告され、毎月請求されます。 - -アップタイムを制御するには、codespace を停止します。これは、手動で行うか、開発者が指定した非アクティブ期間の後に自動的に行うことができます。 詳細については、「[codespace の終了または停止](/codespaces/getting-started/deep-dive#closing-or-stopping-your-codespace)」を参照してください。 - -### ストレージ使用量の計算 -{% data variables.product.prodname_github_codespaces %} の課金目的の場合、アカウント内のすべての codespace で使用されるすべてのストレージが含まれます。 これには、codespace に使われるすべてのファイル (クローンされたリポジトリ、構成ファイル、拡張機能など) が含まれます。 これらの合計は、毎日課金サービスに報告され、毎月請求されます。 月末に、{% data variables.product.prodname_dotcom %}はストレージ使用量を最も近いGBに丸めます。 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 e32b29f3f4..1322dfe4ae 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 @@ -5,5 +5,3 @@ {% endnote %} By default, your organization or enterprise will have a {% data variables.product.prodname_github_codespaces %} spending limit of $0. This prevents new codespaces from being created, or existing codespaces from being opened, if this would incur a billable cost to your organization or enterprise. To allow your users to create codespaces in your organization, set the limit to a value higher than $0. - -{% data reusables.billing.overages-billed-monthly %} 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 c89126ae76..545324000c 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,11 +1,5 @@ After you connect your account on {% data variables.product.product_location %} 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 %} marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). -{% note %} - -**Note**: Currently, {% data variables.product.prodname_vscode_shortname %} doesn't allow you to choose a dev container configuration when you create a codespace. If you want to choose a specific dev container configuration, use the {% data variables.product.prodname_dotcom %} web interface to create your codespace. For more information, click the **Web browser** tab at the top of this page. - -{% endnote %} - {% data reusables.codespaces.click-remote-explorer-icon-vscode %} 2. Click the Add icon: {% octicon "plus" aria-label="The plus icon" %}. diff --git a/translations/ja-JP/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md b/translations/ja-JP/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md deleted file mode 100644 index f54f227d98..0000000000 --- a/translations/ja-JP/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -ms.openlocfilehash: 86ebb6e0ab13cf7daf5fb580792bf8f4606eb054 -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147881917" ---- -消費型サービスのコストを見積もるために、{% data variables.product.prodname_dotcom %} [料金計算ツール](https://github.com/pricing/calculator?feature=codespaces)を使用できます。 diff --git a/translations/log/msft-cn-resets.csv b/translations/log/msft-cn-resets.csv index c3e505a62b..aec41aff1e 100644 --- a/translations/log/msft-cn-resets.csv +++ b/translations/log/msft-cn-resets.csv @@ -75,6 +75,7 @@ translations/zh-CN/content/code-security/dependabot/dependabot-alerts/browsing-s translations/zh-CN/content/codespaces/codespaces-reference/disaster-recovery-for-codespaces.md,file deleted because it no longer exists in main translations/zh-CN/content/codespaces/codespaces-reference/security-in-codespaces.md,file deleted because it no longer exists in main translations/zh-CN/content/codespaces/codespaces-reference/understanding-billing-for-codespaces.md,file deleted because it no longer exists in main +translations/zh-CN/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md,file deleted because it no longer exists in main translations/zh-CN/content/codespaces/codespaces-reference/using-github-copilot-in-codespaces.md,file deleted because it no longer exists in main translations/zh-CN/content/codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account.md,file deleted because it no longer exists in main translations/zh-CN/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-codespaces.md,file deleted because it no longer exists in main @@ -85,6 +86,7 @@ translations/zh-CN/content/codespaces/developing-in-codespaces/using-codespaces- translations/zh-CN/content/codespaces/developing-in-codespaces/using-codespaces-with-github-cli.md,file deleted because it no longer exists in main translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization.md,file deleted because it no longer exists in main translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization.md,file deleted because it no longer exists in main +translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md,file deleted because it no longer exists in main translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-codespaces.md,file deleted because it no longer exists in main translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-codespaces.md,file deleted because it no longer exists in main translations/zh-CN/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-codespaces.md,file deleted because it no longer exists in main @@ -171,6 +173,7 @@ translations/zh-CN/content/rest/reference/secret-scanning.md,file deleted becaus translations/zh-CN/content/rest/reference/teams.md,file deleted because it no longer exists in main translations/zh-CN/content/rest/reference/users.md,file deleted because it no longer exists in main translations/zh-CN/content/rest/reference/webhooks.md,file deleted because it no longer exists in main +translations/zh-CN/content/site-policy/privacy-policies/github-data-protection-agreement.md,file deleted because it no longer exists in main translations/zh-CN/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/zh-CN/data/glossaries/internal.yml,file deleted because it no longer exists in main translations/zh-CN/data/graphql/ghes-3.1/graphql_previews.enterprise.yml,file deleted because it no longer exists in main @@ -181,7 +184,10 @@ translations/zh-CN/data/reusables/apps/metadata-permissions.md,file deleted beca translations/zh-CN/data/reusables/codespaces/about-billing-for-codespaces.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/codespaces/availability.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/codespaces/beta-functionality-limited.md,file deleted because it no longer exists in main +translations/zh-CN/data/reusables/codespaces/billing-for-prebuilds-default.md,file deleted because it no longer exists in main +translations/zh-CN/data/reusables/codespaces/billing-for-prebuilds-reducing.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/codespaces/billing-for-prebuilds.md,file deleted because it no longer exists in main +translations/zh-CN/data/reusables/codespaces/codespaces-billing.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/codespaces/concurrent-codespace-limit.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/codespaces/prebuilds-beta-note.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/codespaces/prebuilds-not-available.md,file deleted because it no longer exists in main @@ -189,6 +195,7 @@ translations/zh-CN/data/reusables/codespaces/unsupported-repos.md,file deleted b translations/zh-CN/data/reusables/dependabot/create-dependabot-yml.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/desktop/paste-email-git-config.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/dotcom_billing/codespaces-minutes.md,file deleted because it no longer exists in main +translations/zh-CN/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/education/upgrade-organization.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/education/upgrade-page.md,file deleted because it no longer exists in main translations/zh-CN/data/reusables/enterprise-accounts/repository-visibility-policy.md,file deleted because it no longer exists in main @@ -234,7 +241,7 @@ translations/zh-CN/content/account-and-profile/managing-subscriptions-and-notifi translations/zh-CN/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md,rendering error translations/zh-CN/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile.md,rendering error translations/zh-CN/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme.md,broken liquid tags -translations/zh-CN/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile.md,broken liquid tags +translations/zh-CN/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile.md,rendering error translations/zh-CN/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private.md,broken liquid tags translations/zh-CN/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-your-private-contributions-and-achievements-on-your-profile.md,rendering error translations/zh-CN/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/index.md,broken liquid tags @@ -291,6 +298,7 @@ translations/zh-CN/content/admin/code-security/managing-github-advanced-security translations/zh-CN/content/admin/configuration/configuring-github-connect/about-github-connect.md,broken liquid tags translations/zh-CN/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md,rendering error translations/zh-CN/content/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise.md,rendering error +translations/zh-CN/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md,broken liquid tags translations/zh-CN/content/admin/configuration/configuring-your-enterprise/configuring-email-for-notifications.md,broken liquid tags translations/zh-CN/content/admin/configuration/configuring-your-enterprise/configuring-rate-limits.md,rendering error translations/zh-CN/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md,broken liquid tags @@ -392,7 +400,6 @@ translations/zh-CN/content/code-security/supply-chain-security/understanding-you translations/zh-CN/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md,broken liquid tags translations/zh-CN/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md,broken liquid tags translations/zh-CN/content/codespaces/codespaces-reference/security-in-github-codespaces.md,broken liquid tags -translations/zh-CN/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md,broken liquid tags translations/zh-CN/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md,broken liquid tags translations/zh-CN/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md,broken liquid tags translations/zh-CN/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md,broken liquid tags @@ -413,7 +420,7 @@ translations/zh-CN/content/codespaces/developing-in-codespaces/using-github-code translations/zh-CN/content/codespaces/getting-started/deep-dive.md,broken liquid tags translations/zh-CN/content/codespaces/getting-started/quickstart.md,broken liquid tags translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md,broken liquid tags -translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md,broken liquid tags +translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md,broken liquid tags translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces.md,rendering error translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md,broken liquid tags translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md,broken liquid tags @@ -477,6 +484,7 @@ translations/zh-CN/content/get-started/using-github/keyboard-shortcuts.md,render translations/zh-CN/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/zh-CN/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md,rendering error translations/zh-CN/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md,broken liquid tags +translations/zh-CN/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md,broken liquid tags translations/zh-CN/content/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions.md,rendering error translations/zh-CN/content/graphql/guides/migrating-from-rest-to-graphql.md,broken liquid tags translations/zh-CN/content/graphql/overview/about-the-graphql-api.md,rendering error @@ -485,7 +493,7 @@ translations/zh-CN/content/issues/planning-and-tracking-with-projects/managing-y translations/zh-CN/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects.md,broken liquid tags translations/zh-CN/content/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests.md,rendering error translations/zh-CN/content/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue.md,rendering error -translations/zh-CN/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization.md,broken liquid tags +translations/zh-CN/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization.md,rendering error translations/zh-CN/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md,rendering error translations/zh-CN/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-your-organizations-installed-integrations.md,rendering error translations/zh-CN/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md,rendering error @@ -629,7 +637,6 @@ translations/zh-CN/data/reusables/code-scanning/enterprise-enable-code-scanning. translations/zh-CN/data/reusables/code-scanning/example-configuration-files.md,broken liquid tags translations/zh-CN/data/reusables/code-scanning/licensing-note.md,broken liquid tags translations/zh-CN/data/reusables/code-scanning/run-additional-queries.md,broken liquid tags -translations/zh-CN/data/reusables/codespaces/billing-for-prebuilds-reducing.md,broken liquid tags translations/zh-CN/data/reusables/codespaces/codespaces-api-beta-note.md,broken liquid tags translations/zh-CN/data/reusables/codespaces/codespaces-spending-limit-requirement.md,broken liquid tags translations/zh-CN/data/reusables/codespaces/creating-a-codespace-in-vscode.md,broken liquid tags diff --git a/translations/log/msft-es-resets.csv b/translations/log/msft-es-resets.csv index 76fa14db11..331fbf45a8 100644 --- a/translations/log/msft-es-resets.csv +++ b/translations/log/msft-es-resets.csv @@ -78,6 +78,7 @@ translations/es-ES/content/code-security/dependabot/dependabot-alerts/browsing-s translations/es-ES/content/codespaces/codespaces-reference/disaster-recovery-for-codespaces.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/codespaces-reference/security-in-codespaces.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/codespaces-reference/understanding-billing-for-codespaces.md,file deleted because it no longer exists in main +translations/es-ES/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/codespaces-reference/using-github-copilot-in-codespaces.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-codespaces.md,file deleted because it no longer exists in main @@ -88,6 +89,7 @@ translations/es-ES/content/codespaces/developing-in-codespaces/using-codespaces- translations/es-ES/content/codespaces/developing-in-codespaces/using-codespaces-with-github-cli.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization.md,file deleted because it no longer exists in main +translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-codespaces.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-codespaces.md,file deleted because it no longer exists in main translations/es-ES/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-codespaces.md,file deleted because it no longer exists in main @@ -174,6 +176,7 @@ translations/es-ES/content/rest/reference/secret-scanning.md,file deleted becaus translations/es-ES/content/rest/reference/teams.md,file deleted because it no longer exists in main translations/es-ES/content/rest/reference/users.md,file deleted because it no longer exists in main 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/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 @@ -186,7 +189,10 @@ translations/es-ES/data/reusables/billing/per-user-pricing-reference.md,file del translations/es-ES/data/reusables/codespaces/about-billing-for-codespaces.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/codespaces/availability.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/codespaces/beta-functionality-limited.md,file deleted because it no longer exists in main +translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-default.md,file deleted because it no longer exists in main +translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-reducing.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/codespaces/billing-for-prebuilds.md,file deleted because it no longer exists in main +translations/es-ES/data/reusables/codespaces/codespaces-billing.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/codespaces/concurrent-codespace-limit.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/codespaces/prebuilds-beta-note.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/codespaces/prebuilds-not-available.md,file deleted because it no longer exists in main @@ -194,6 +200,7 @@ translations/es-ES/data/reusables/codespaces/unsupported-repos.md,file deleted b translations/es-ES/data/reusables/dependabot/create-dependabot-yml.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/desktop/paste-email-git-config.md,file deleted because it no longer exists in main translations/es-ES/data/reusables/dotcom_billing/codespaces-minutes.md,file deleted because it no longer exists in main +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/repository-visibility-policy.md,file deleted because it no longer exists in main @@ -256,7 +263,7 @@ translations/es-ES/content/account-and-profile/managing-subscriptions-and-notifi translations/es-ES/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md,rendering error translations/es-ES/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile.md,rendering error translations/es-ES/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme.md,broken liquid tags -translations/es-ES/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile.md,broken liquid tags +translations/es-ES/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile.md,rendering error translations/es-ES/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private.md,broken liquid tags translations/es-ES/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-your-private-contributions-and-achievements-on-your-profile.md,broken liquid tags translations/es-ES/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository.md,rendering error @@ -306,6 +313,7 @@ translations/es-ES/content/actions/using-workflows/workflow-commands-for-github- translations/es-ES/content/actions/using-workflows/workflow-syntax-for-github-actions.md,rendering error translations/es-ES/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance.md,broken liquid tags translations/es-ES/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md,rendering error +translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md,broken liquid tags translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-rate-limits.md,rendering error 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/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled.md,broken liquid tags @@ -391,7 +399,6 @@ translations/es-ES/content/code-security/supply-chain-security/understanding-you translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.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/understanding-billing-for-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 @@ -411,7 +418,6 @@ translations/es-ES/content/codespaces/developing-in-codespaces/using-github-code 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/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/managing-billing-for-github-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/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 @@ -473,6 +479,7 @@ translations/es-ES/content/get-started/using-github/keyboard-shortcuts.md,render 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/working-with-advanced-formatting/attaching-files.md,broken liquid tags +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/graphql/guides/migrating-from-rest-to-graphql.md,broken liquid tags translations/es-ES/content/graphql/overview/about-the-graphql-api.md,rendering error @@ -481,7 +488,7 @@ translations/es-ES/content/issues/planning-and-tracking-with-projects/managing-y translations/es-ES/content/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests.md,rendering error 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/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-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/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-your-organizations-installed-integrations.md,rendering error translations/es-ES/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md,rendering error @@ -501,6 +508,7 @@ translations/es-ES/content/organizations/restricting-access-to-your-organization translations/es-ES/content/organizations/restricting-access-to-your-organizations-data/approving-oauth-apps-for-your-organization.md,broken liquid tags translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md,rendering error translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md,rendering error +translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md,broken liquid tags translations/es-ES/content/packages/learn-github-packages/introduction-to-github-packages.md,rendering error translations/es-ES/content/packages/learn-github-packages/viewing-packages.md,rendering error translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md,rendering error @@ -597,6 +605,7 @@ translations/es-ES/data/reusables/actions/changing-the-name-of-a-runner-group.md translations/es-ES/data/reusables/actions/create-runner-group.md,rendering error translations/es-ES/data/reusables/actions/creating-a-runner-group-for-an-organization.md,rendering error translations/es-ES/data/reusables/actions/enterprise-storage-ha-backups.md,broken liquid tags +translations/es-ES/data/reusables/actions/hosted-runner-security.md,broken liquid tags translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md,broken liquid tags translations/es-ES/data/reusables/actions/moving-a-runner-to-a-group.md,rendering error translations/es-ES/data/reusables/actions/ref_name-description.md,broken liquid tags @@ -624,7 +633,6 @@ translations/es-ES/data/reusables/code-scanning/autobuild-add-build-steps.md,bro translations/es-ES/data/reusables/code-scanning/codeql-languages-bullets.md,rendering error translations/es-ES/data/reusables/code-scanning/codeql-languages-keywords.md,rendering error translations/es-ES/data/reusables/code-scanning/enterprise-enable-code-scanning.md,broken liquid tags -translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-reducing.md,broken liquid tags translations/es-ES/data/reusables/codespaces/codespaces-api-beta-note.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,broken liquid tags diff --git a/translations/log/msft-ja-resets.csv b/translations/log/msft-ja-resets.csv index c1e0bdd8ea..47dc70b6c9 100644 --- a/translations/log/msft-ja-resets.csv +++ b/translations/log/msft-ja-resets.csv @@ -83,6 +83,7 @@ translations/ja-JP/content/code-security/dependabot/dependabot-alerts/browsing-s translations/ja-JP/content/codespaces/codespaces-reference/disaster-recovery-for-codespaces.md,file deleted because it no longer exists in main translations/ja-JP/content/codespaces/codespaces-reference/security-in-codespaces.md,file deleted because it no longer exists in main translations/ja-JP/content/codespaces/codespaces-reference/understanding-billing-for-codespaces.md,file deleted because it no longer exists in main +translations/ja-JP/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md,file deleted because it no longer exists in main translations/ja-JP/content/codespaces/codespaces-reference/using-github-copilot-in-codespaces.md,file deleted because it no longer exists in main translations/ja-JP/content/codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account.md,file deleted because it no longer exists in main translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-codespaces.md,file deleted because it no longer exists in main @@ -93,6 +94,7 @@ translations/ja-JP/content/codespaces/developing-in-codespaces/using-codespaces- translations/ja-JP/content/codespaces/developing-in-codespaces/using-codespaces-with-github-cli.md,file deleted because it no longer exists in main translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization.md,file deleted because it no longer exists in main translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization.md,file deleted because it no longer exists in main +translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md,file deleted because it no longer exists in main translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-codespaces.md,file deleted because it no longer exists in main translations/ja-JP/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-codespaces.md,file deleted because it no longer exists in main translations/ja-JP/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-codespaces.md,file deleted because it no longer exists in main @@ -181,6 +183,7 @@ translations/ja-JP/content/rest/reference/secret-scanning.md,file deleted becaus translations/ja-JP/content/rest/reference/teams.md,file deleted because it no longer exists in main translations/ja-JP/content/rest/reference/users.md,file deleted because it no longer exists in main 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/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 @@ -192,7 +195,10 @@ translations/ja-JP/data/reusables/billing/per-user-pricing-reference.md,file del translations/ja-JP/data/reusables/codespaces/about-billing-for-codespaces.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/codespaces/availability.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/codespaces/beta-functionality-limited.md,file deleted because it no longer exists in main +translations/ja-JP/data/reusables/codespaces/billing-for-prebuilds-default.md,file deleted because it no longer exists in main +translations/ja-JP/data/reusables/codespaces/billing-for-prebuilds-reducing.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/codespaces/billing-for-prebuilds.md,file deleted because it no longer exists in main +translations/ja-JP/data/reusables/codespaces/codespaces-billing.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/codespaces/concurrent-codespace-limit.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/codespaces/prebuilds-beta-note.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/codespaces/prebuilds-not-available.md,file deleted because it no longer exists in main @@ -200,6 +206,7 @@ translations/ja-JP/data/reusables/codespaces/unsupported-repos.md,file deleted b translations/ja-JP/data/reusables/dependabot/create-dependabot-yml.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/desktop/paste-email-git-config.md,file deleted because it no longer exists in main translations/ja-JP/data/reusables/dotcom_billing/codespaces-minutes.md,file deleted because it no longer exists in main +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/repository-visibility-policy.md,file deleted because it no longer exists in main @@ -252,7 +259,7 @@ translations/ja-JP/content/account-and-profile/managing-subscriptions-and-notifi translations/ja-JP/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md,rendering error translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile.md,rendering error translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme.md,broken liquid tags -translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile.md,broken liquid tags +translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile.md,rendering error translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private.md,broken liquid tags translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-your-private-contributions-and-achievements-on-your-profile.md,broken liquid tags translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository.md,rendering error @@ -304,6 +311,7 @@ translations/ja-JP/content/actions/using-workflows/workflow-commands-for-github- translations/ja-JP/content/actions/using-workflows/workflow-syntax-for-github-actions.md,rendering error translations/ja-JP/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance.md,broken liquid tags translations/ja-JP/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md,rendering error +translations/ja-JP/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md,broken liquid tags translations/ja-JP/content/admin/configuration/configuring-your-enterprise/configuring-rate-limits.md,rendering error translations/ja-JP/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server.md,rendering error translations/ja-JP/content/admin/github-actions/advanced-configuration-and-troubleshooting/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled.md,broken liquid tags @@ -382,10 +390,9 @@ translations/ja-JP/content/code-security/supply-chain-security/understanding-you 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,rendering error 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/allowing-your-codespace-to-access-a-private-image-registry.md,broken liquid tags +translations/ja-JP/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md,rendering error 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/understanding-billing-for-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 @@ -404,7 +411,7 @@ translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-code translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.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/managing-billing-for-github-codespaces-in-your-organization.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-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces.md,rendering error 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-idle-timeout-period.md,rendering error @@ -465,6 +472,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/working-with-advanced-formatting/attaching-files.md,broken liquid tags +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/graphql/guides/migrating-from-rest-to-graphql.md,broken liquid tags translations/ja-JP/content/graphql/overview/about-the-graphql-api.md,rendering error @@ -472,7 +480,7 @@ translations/ja-JP/content/issues/planning-and-tracking-with-projects/automating translations/ja-JP/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md,broken liquid tags translations/ja-JP/content/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests.md,rendering error 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/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-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/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-your-organizations-installed-integrations.md,rendering error translations/ja-JP/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md,rendering error @@ -491,8 +499,12 @@ translations/ja-JP/content/organizations/managing-peoples-access-to-your-organiz translations/ja-JP/content/organizations/organizing-members-into-teams/managing-code-review-settings-for-your-team.md,rendering error translations/ja-JP/content/organizations/restricting-access-to-your-organizations-data/about-oauth-app-access-restrictions.md,broken liquid tags translations/ja-JP/content/organizations/restricting-access-to-your-organizations-data/approving-oauth-apps-for-your-organization.md,broken liquid tags +translations/ja-JP/content/packages/learn-github-packages/about-permissions-for-github-packages.md,broken liquid tags translations/ja-JP/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md,rendering error translations/ja-JP/content/packages/learn-github-packages/deleting-and-restoring-a-package.md,rendering error +translations/ja-JP/content/packages/learn-github-packages/introduction-to-github-packages.md,broken liquid tags +translations/ja-JP/content/packages/learn-github-packages/viewing-packages.md,broken liquid tags +translations/ja-JP/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md,broken liquid tags translations/ja-JP/content/packages/working-with-a-github-packages-registry/working-with-the-container-registry.md,rendering error translations/ja-JP/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md,rendering error translations/ja-JP/content/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line.md,broken liquid tags @@ -582,6 +594,7 @@ translations/ja-JP/data/reusables/actions/changing-the-access-policy-of-a-runner translations/ja-JP/data/reusables/actions/changing-the-name-of-a-runner-group.md,rendering error translations/ja-JP/data/reusables/actions/create-runner-group.md,rendering error translations/ja-JP/data/reusables/actions/creating-a-runner-group-for-an-organization.md,rendering error +translations/ja-JP/data/reusables/actions/hosted-runner-security.md,broken liquid tags translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md,broken liquid tags translations/ja-JP/data/reusables/actions/moving-a-runner-to-a-group.md,rendering error translations/ja-JP/data/reusables/actions/ref_name-description.md,broken liquid tags @@ -611,7 +624,6 @@ translations/ja-JP/data/reusables/code-scanning/autobuild-add-build-steps.md,bro translations/ja-JP/data/reusables/code-scanning/codeql-languages-bullets.md,rendering error translations/ja-JP/data/reusables/code-scanning/codeql-languages-keywords.md,rendering error translations/ja-JP/data/reusables/code-scanning/enterprise-enable-code-scanning.md,broken liquid tags -translations/ja-JP/data/reusables/codespaces/billing-for-prebuilds-reducing.md,broken liquid tags translations/ja-JP/data/reusables/codespaces/codespaces-api-beta-note.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 diff --git a/translations/log/msft-pt-resets.csv b/translations/log/msft-pt-resets.csv index 9a3733877a..d962cdeaf9 100644 --- a/translations/log/msft-pt-resets.csv +++ b/translations/log/msft-pt-resets.csv @@ -76,6 +76,7 @@ translations/pt-BR/content/code-security/dependabot/dependabot-alerts/browsing-s translations/pt-BR/content/codespaces/codespaces-reference/disaster-recovery-for-codespaces.md,file deleted because it no longer exists in main translations/pt-BR/content/codespaces/codespaces-reference/security-in-codespaces.md,file deleted because it no longer exists in main translations/pt-BR/content/codespaces/codespaces-reference/understanding-billing-for-codespaces.md,file deleted because it no longer exists in main +translations/pt-BR/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md,file deleted because it no longer exists in main translations/pt-BR/content/codespaces/codespaces-reference/using-github-copilot-in-codespaces.md,file deleted because it no longer exists in main translations/pt-BR/content/codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account.md,file deleted because it no longer exists in main translations/pt-BR/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-codespaces.md,file deleted because it no longer exists in main @@ -86,6 +87,7 @@ translations/pt-BR/content/codespaces/developing-in-codespaces/using-codespaces- translations/pt-BR/content/codespaces/developing-in-codespaces/using-codespaces-with-github-cli.md,file deleted because it no longer exists in main translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization.md,file deleted because it no longer exists in main translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization.md,file deleted because it no longer exists in main +translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md,file deleted because it no longer exists in main translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-codespaces.md,file deleted because it no longer exists in main translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-codespaces.md,file deleted because it no longer exists in main translations/pt-BR/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-codespaces.md,file deleted because it no longer exists in main @@ -173,6 +175,7 @@ translations/pt-BR/content/rest/reference/secret-scanning.md,file deleted becaus translations/pt-BR/content/rest/reference/teams.md,file deleted because it no longer exists in main translations/pt-BR/content/rest/reference/users.md,file deleted because it no longer exists in main translations/pt-BR/content/rest/reference/webhooks.md,file deleted because it no longer exists in main +translations/pt-BR/content/site-policy/privacy-policies/github-data-protection-agreement.md,file deleted because it no longer exists in main translations/pt-BR/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/pt-BR/data/glossaries/internal.yml,file deleted because it no longer exists in main translations/pt-BR/data/graphql/ghes-3.1/graphql_previews.enterprise.yml,file deleted because it no longer exists in main @@ -184,7 +187,10 @@ translations/pt-BR/data/reusables/billing/per-user-pricing-reference.md,file del translations/pt-BR/data/reusables/codespaces/about-billing-for-codespaces.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/codespaces/availability.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/codespaces/beta-functionality-limited.md,file deleted because it no longer exists in main +translations/pt-BR/data/reusables/codespaces/billing-for-prebuilds-default.md,file deleted because it no longer exists in main +translations/pt-BR/data/reusables/codespaces/billing-for-prebuilds-reducing.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/codespaces/billing-for-prebuilds.md,file deleted because it no longer exists in main +translations/pt-BR/data/reusables/codespaces/codespaces-billing.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/codespaces/concurrent-codespace-limit.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/codespaces/prebuilds-beta-note.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/codespaces/prebuilds-not-available.md,file deleted because it no longer exists in main @@ -192,6 +198,7 @@ translations/pt-BR/data/reusables/codespaces/unsupported-repos.md,file deleted b translations/pt-BR/data/reusables/dependabot/create-dependabot-yml.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/desktop/paste-email-git-config.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/dotcom_billing/codespaces-minutes.md,file deleted because it no longer exists in main +translations/pt-BR/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/education/upgrade-organization.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/education/upgrade-page.md,file deleted because it no longer exists in main translations/pt-BR/data/reusables/enterprise-accounts/repository-visibility-policy.md,file deleted because it no longer exists in main @@ -240,7 +247,7 @@ translations/pt-BR/content/account-and-profile/managing-subscriptions-and-notifi translations/pt-BR/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md,rendering error translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile.md,rendering error translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme.md,broken liquid tags -translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile.md,broken liquid tags +translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile.md,rendering error translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private.md,broken liquid tags translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-your-private-contributions-and-achievements-on-your-profile.md,broken liquid tags translations/pt-BR/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/index.md,broken liquid tags @@ -294,6 +301,7 @@ translations/pt-BR/content/actions/using-workflows/workflow-syntax-for-github-ac translations/pt-BR/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance.md,broken liquid tags translations/pt-BR/content/admin/configuration/configuring-github-connect/about-github-connect.md,broken liquid tags translations/pt-BR/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md,rendering error +translations/pt-BR/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md,broken liquid tags translations/pt-BR/content/admin/configuration/configuring-your-enterprise/configuring-email-for-notifications.md,broken liquid tags translations/pt-BR/content/admin/configuration/configuring-your-enterprise/configuring-rate-limits.md,rendering error translations/pt-BR/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md,broken liquid tags @@ -387,7 +395,6 @@ translations/pt-BR/content/code-security/supply-chain-security/understanding-you translations/pt-BR/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md,broken liquid tags translations/pt-BR/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md,broken liquid tags translations/pt-BR/content/codespaces/codespaces-reference/security-in-github-codespaces.md,broken liquid tags -translations/pt-BR/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md,broken liquid tags translations/pt-BR/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md,broken liquid tags translations/pt-BR/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md,broken liquid tags translations/pt-BR/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md,broken liquid tags @@ -408,7 +415,6 @@ translations/pt-BR/content/codespaces/developing-in-codespaces/using-github-code translations/pt-BR/content/codespaces/getting-started/deep-dive.md,broken liquid tags translations/pt-BR/content/codespaces/getting-started/quickstart.md,broken liquid tags translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md,broken liquid tags -translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md,broken liquid tags translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces.md,rendering error translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md,broken liquid tags translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md,broken liquid tags @@ -472,6 +478,7 @@ translations/pt-BR/content/get-started/using-github/keyboard-shortcuts.md,render translations/pt-BR/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/pt-BR/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md,rendering error translations/pt-BR/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md,broken liquid tags +translations/pt-BR/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md,broken liquid tags translations/pt-BR/content/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions.md,rendering error translations/pt-BR/content/graphql/guides/migrating-from-rest-to-graphql.md,broken liquid tags translations/pt-BR/content/graphql/overview/about-the-graphql-api.md,rendering error @@ -480,7 +487,7 @@ translations/pt-BR/content/issues/planning-and-tracking-with-projects/managing-y translations/pt-BR/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects.md,broken liquid tags translations/pt-BR/content/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests.md,rendering error translations/pt-BR/content/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue.md,rendering error -translations/pt-BR/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization.md,broken liquid tags +translations/pt-BR/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization.md,rendering error translations/pt-BR/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md,rendering error translations/pt-BR/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-your-organizations-installed-integrations.md,rendering error translations/pt-BR/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md,rendering error @@ -502,7 +509,9 @@ translations/pt-BR/content/organizations/restricting-access-to-your-organization translations/pt-BR/content/packages/learn-github-packages/about-permissions-for-github-packages.md,rendering error translations/pt-BR/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md,rendering error translations/pt-BR/content/packages/learn-github-packages/deleting-and-restoring-a-package.md,rendering error +translations/pt-BR/content/packages/learn-github-packages/introduction-to-github-packages.md,broken liquid tags translations/pt-BR/content/packages/learn-github-packages/viewing-packages.md,rendering error +translations/pt-BR/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md,broken liquid tags translations/pt-BR/content/packages/working-with-a-github-packages-registry/working-with-the-container-registry.md,rendering error translations/pt-BR/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md,rendering error translations/pt-BR/content/pages/getting-started-with-github-pages/creating-a-github-pages-site.md,rendering error @@ -633,7 +642,6 @@ translations/pt-BR/data/reusables/code-scanning/enterprise-enable-code-scanning. translations/pt-BR/data/reusables/code-scanning/example-configuration-files.md,broken liquid tags translations/pt-BR/data/reusables/code-scanning/licensing-note.md,broken liquid tags translations/pt-BR/data/reusables/code-scanning/run-additional-queries.md,broken liquid tags -translations/pt-BR/data/reusables/codespaces/billing-for-prebuilds-reducing.md,broken liquid tags translations/pt-BR/data/reusables/codespaces/codespaces-api-beta-note.md,broken liquid tags translations/pt-BR/data/reusables/codespaces/codespaces-spending-limit-requirement.md,broken liquid tags translations/pt-BR/data/reusables/codespaces/creating-a-codespace-in-vscode.md,broken liquid tags diff --git a/translations/pt-BR/content/actions/using-workflows/workflow-commands-for-github-actions.md b/translations/pt-BR/content/actions/using-workflows/workflow-commands-for-github-actions.md index 5a6de2d67d..60e836a70a 100644 --- a/translations/pt-BR/content/actions/using-workflows/workflow-commands-for-github-actions.md +++ b/translations/pt-BR/content/actions/using-workflows/workflow-commands-for-github-actions.md @@ -169,6 +169,8 @@ Sets an action's output parameter. Optionally, you can also declare output parameters in an action's metadata file. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs-for-docker-container-and-javascript-actions)." +You can escape multiline strings for setting an output parameter by creating an environment variable and using it in a workflow command. For more information, see "[Setting an environment variable](#setting-an-environment-variable)." + ### Example: Setting an output parameter {% bash %} diff --git a/translations/pt-BR/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md b/translations/pt-BR/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md index 7e6ea2741b..82d3255404 100644 --- a/translations/pt-BR/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md +++ b/translations/pt-BR/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md @@ -1,5 +1,5 @@ --- -title: Configurar backups no appliance +title: Configuring backups on your appliance shortTitle: Configuring backups redirect_from: - /enterprise/admin/categories/backups-and-restores @@ -14,7 +14,7 @@ redirect_from: - /enterprise/admin/installation/configuring-backups-on-your-appliance - /enterprise/admin/configuration/configuring-backups-on-your-appliance - /admin/configuration/configuring-backups-on-your-appliance -intro: 'Dentro de um plano de recuperação de desastre, é possível proteger os dados de produção no {% data variables.product.product_location %} configurando backups automatizados.' +intro: 'As part of a disaster recovery plan, you can protect production data on {% data variables.product.product_location %} by configuring automated backups.' versions: ghes: '*' type: how_to @@ -23,162 +23,158 @@ topics: - Enterprise - Fundamentals - Infrastructure -ms.openlocfilehash: 4403ec24aa3da63f6700ae4bfcd2392ec0cfd194 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/09/2022 -ms.locfileid: '147861649' --- -## Sobre o {% data variables.product.prodname_enterprise_backup_utilities %} +## About {% data variables.product.prodname_enterprise_backup_utilities %} -O {% data variables.product.prodname_enterprise_backup_utilities %} é um sistema de backup que você instala em um host separado, que usa instantâneos de backup do {% data variables.product.product_location %} em intervalos regulares em uma conexão de rede SSH segura. É possível usar um instantâneo para voltar uma instância do {% data variables.product.prodname_ghe_server %} a um estado anterior do host de backup. +{% data variables.product.prodname_enterprise_backup_utilities %} is a backup system you install on a separate host, which takes backup snapshots of {% data variables.product.product_location %} at regular intervals over a secure SSH network connection. You can use a snapshot to restore an existing {% data variables.product.prodname_ghe_server %} instance to a previous state from the backup host. -Somente os dados adicionados desde o último instantâneo serão transferidos pela rede e ocuparão espaço adicional de armazenamento físico. Para minimizar o impacto no desempenho, os backups são feitos online com a menor prioridade de E/S de CPU. Não é necessário programar um período de manutenção para fazer backups. +Only data added since the last snapshot will transfer over the network and occupy additional physical storage space. To minimize performance impact, backups are performed online under the lowest CPU/IO priority. You do not need to schedule a maintenance window to perform a backup. -As principais versões e números de versão para {% data variables.product.prodname_enterprise_backup_utilities %} se alinham às versões de recurso de {% data variables.product.product_name %}. Damos suporte às quatro versões mais recentes de ambos os produtos. Para obter mais informações, confira "[Versões do {% data variables.product.product_name %}](/admin/all-releases)". +Major releases and version numbers for {% data variables.product.prodname_enterprise_backup_utilities %} align with feature releases of {% data variables.product.product_name %}. We support the four most recent versions of both products. For more information, see "[{% data variables.product.product_name %} releases](/admin/all-releases)." -Para obter informações detalhadas sobre recursos, requisitos e uso avançado, confira [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) na documentação do projeto do {% data variables.product.prodname_enterprise_backup_utilities %}. +For more detailed information on features, requirements, and advanced usage, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## Pré-requisitos +## Prerequisites -Para usar o {% data variables.product.prodname_enterprise_backup_utilities %}, você precisa ter um sistema de host Linux ou UNIX separado do {% data variables.product.product_location %}. +To use {% data variables.product.prodname_enterprise_backup_utilities %}, you must have a Linux or Unix host system separate from {% data variables.product.product_location %}. -Também é possível integrar o {% data variables.product.prodname_enterprise_backup_utilities %} a um ambiente para fins de armazenamento permanente em longo prazo de dados essenciais. +You can also integrate {% data variables.product.prodname_enterprise_backup_utilities %} into an existing environment for long-term permanent storage of critical data. -Recomendamos que o host de backup e o {% data variables.product.product_location %} estejam geograficamente distantes um do outro. Essa medida garante que os backups estejam disponíveis para recuperação em casos de grandes desastres ou falhas de rede no site primário. +We recommend that the backup host and {% data variables.product.product_location %} be geographically distant from each other. This ensures that backups are available for recovery in the event of a major disaster or network outage at the primary site. -Os requisitos de armazenamento físico variam com base no uso do disco do repositório Git e nos padrões de crescimento esperados: +Physical storage requirements will vary based on Git repository disk usage and expected growth patterns: -| Hardware | Recomendação | +| Hardware | Recommendation | | -------- | --------- | | **vCPUs** | 2 | -| **Memória** | 2 GB | -| **Storage** | Cinco vezes o armazenamento alocado da instância primária | +| **Memory** | 2 GB | +| **Storage** | Five times the primary instance's allocated storage | -Podem ser necessários mais recursos, dependendo do seu uso, como atividade do usuário e integrações selecionadas. +More resources may be required depending on your usage, such as user activity and selected integrations. -Para obter mais informações, confira os [requisitos do {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils/blob/master/docs/requirements.md) na documentação do projeto do {% data variables.product.prodname_enterprise_backup_utilities %}. +For more information, see [{% data variables.product.prodname_enterprise_backup_utilities %} requirements](https://github.com/github/backup-utils/blob/master/docs/requirements.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## Instalar o {% data variables.product.prodname_enterprise_backup_utilities %} +## Installing {% data variables.product.prodname_enterprise_backup_utilities %} -Para instalar {% data variables.product.prodname_enterprise_backup_utilities %} no seu backup, recomendamos clonar o repositório Git do projeto. Essa abordagem permite buscar novas versões diretamente usando o Git, e o arquivo de configuração de backup existente, `backup.config`, será preservado ao instalar uma nova versão. +To install {% data variables.product.prodname_enterprise_backup_utilities %} on your backup host, we recommend cloning the project's Git repository. This approach allows you to fetch new releases directly using Git, and your existing backup configuration file, `backup.config`, will be preserved when installing a new version. -Como alternativa, se o computador host não puder acessar a Internet, você poderá baixar cada versão do {% data variables.product.prodname_enterprise_backup_utilities %} como um arquivo compactado e extrair e instalar o conteúdo. Para obter mais informações, confira [Introdução](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) na documentação do projeto do {% data variables.product.prodname_enterprise_backup_utilities %}. +Alternatively, if the host machine can't access the internet, you can download each {% data variables.product.prodname_enterprise_backup_utilities %} release as a compressed archive, then extract and install the contents. For more information, see [Getting started](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -Os instantâneos de backup são gravados no caminho do disco definido pela variável de diretório de dados `GHE_DATA_DIR` em seu arquivo `backup.config`. Os instantâneos precisam ser armazenados em um sistema de arquivos que dê suporte a links simbólicos e rígidos. +Backup snapshots are written to the disk path set by the `GHE_DATA_DIR` data directory variable in your `backup.config` file. Snapshots need to be stored on a filesystem which supports symbolic and hard links. {% note %} -**Nota:** recomendamos garantir que seus instantâneos não sejam mantidos em um subdiretório do diretório de instalação {% data variables.product.prodname_enterprise_backup_utilities %} de dados, para evitar substituir inadvertidamente o diretório de dados ao atualizar as versões {% data variables.product.prodname_enterprise_backup_utilities %}. +**Note:** We recommend ensuring your snapshots are not kept in a subdirectory of the {% data variables.product.prodname_enterprise_backup_utilities %} installation directory, to avoid inadvertently overwriting your data directory when upgrading {% data variables.product.prodname_enterprise_backup_utilities %} versions. {% endnote %} -1. Para clonar o [repositório de projeto {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils/) para um diretório local no host de backup, execute o comando a seguir. +1. To clone the [{% data variables.product.prodname_enterprise_backup_utilities %} project repository](https://github.com/github/backup-utils/) to a local directory on your backup host, run the following command. ``` $ git clone https://github.com/github/backup-utils.git /path/to/target/directory/backup-utils ``` -1. Para alterar para o diretório do repositório local, execute o comando a seguir. +1. To change into the local repository directory, run the following command. ``` cd backup-utils ``` {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} -1. Para copiar o arquivo incluído `backup.config-example` no `backup.config`, execute o comando a seguir. +1. To copy the included `backup.config-example` file to `backup.config`, run the following command. ```shell cp backup.config-example backup.config ``` -1. Para personalizar sua configuração, edite `backup.config` em um editor de texto. - 1. Defina o valor `GHE_HOSTNAME` como o nome do host ou o endereço IP da instância primária do {% data variables.product.prodname_ghe_server %}. +1. To customize your configuration, edit `backup.config` in a text editor. + 1. Set the `GHE_HOSTNAME` value to your primary {% data variables.product.prodname_ghe_server %} instance's hostname or IP address. {% note %} - **Observação:** se o {% data variables.product.product_location %} for implantado como um cluster ou em uma configuração de alta disponibilidade usando um balanceador de carga, o `GHE_HOSTNAME` poderá ser o nome do host do balanceador de carga, desde que permita o acesso SSH (na porta 122) ao {% data variables.product.product_location %}. + **Note:** If {% data variables.product.product_location %} is deployed as a cluster or in a high availability configuration using a load balancer, the `GHE_HOSTNAME` can be the load balancer hostname, as long as it allows SSH access (on port 122) to {% data variables.product.product_location %}. - Para garantir que um dispositivo recuperado esteja disponível imediatamente, execute backups direcionados à instância primária mesmo em uma configuração de replicação geográfica. + To ensure a recovered appliance is immediately available, perform backups targeting the primary instance even in a geo-replication configuration. {% endnote %} - 1. Defina o valor `GHE_DATA_DIR` como o local do sistema de arquivos em que deseja armazenar instantâneos de backup. É recomendável escolher um local no mesmo sistema de arquivos que o host de backup, mas fora de onde você clonou o repositório Git na etapa 1. -1. Para conceder acesso ao host de backup à instância, abra a página de configurações da instância principal em `http(s)://HOSTNAME/setup/settings` e adicione a chave SSH do host de backup à lista de chaves SSH autorizadas. Para obter mais informações, confira "[Como acessar o shell administrativo (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh#enabling-access-to-the-administrative-shell-via-ssh)". -1. Em seu host de backup, verifique a conectividade do SSH com o {% data variables.product.product_location %} usando o comando `ghe-host-check`. + 1. Set the `GHE_DATA_DIR` value to the filesystem location where you want to store backup snapshots. We recommend choosing a location on the same filesystem as your backup host, but outside of where you cloned the Git repository in step 1. +1. To grant your backup host access to your instance, open your primary instance's settings page at `http(s)://HOSTNAME/setup/settings` and add the backup host's SSH key to the list of authorized SSH keys. For more information, see "[Accessing the administrative shell (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh#enabling-access-to-the-administrative-shell-via-ssh)." +1. On your backup host, verify SSH connectivity with {% data variables.product.product_location %} with the `ghe-host-check` command. ```shell ./bin/ghe-host-check - ``` -1. Para criar um backup completo inicial, execute o comando a seguir. + ``` +1. To create an initial full backup, run the following command. ```shell ./bin/ghe-backup ``` -Para obter informações sobre o uso avançado, confira [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) na documentação do projeto do {% data variables.product.prodname_enterprise_backup_utilities %}. +For more information on advanced usage, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## Atualizar o {% data variables.product.prodname_enterprise_backup_utilities %} +## Upgrading {% data variables.product.prodname_enterprise_backup_utilities %} -Ao atualizar o {% data variables.product.prodname_enterprise_backup_utilities %}, você precisa escolher uma versão que funcionará com sua versão atual do {% data variables.product.product_name %}. Sua instalação do {% data variables.product.prodname_enterprise_backup_utilities %} precisa ter pelo menos a mesma versão que {% data variables.product.product_location %} e não pode ter mais do que duas versões posteriores. Para obter mais informações, confira os [requisitos de versão do {% data variables.product.prodname_ghe_server %}](https://github.com/github/backup-utils/blob/master/docs/requirements.md#github-enterprise-server-version-requirements) na documentação do projeto do {% data variables.product.prodname_enterprise_backup_utilities %}. -Você pode atualizar {% data variables.product.prodname_enterprise_backup_utilities %} em um repositório Git buscando e fazendo check-out das alterações mais recentes. +When upgrading {% data variables.product.prodname_enterprise_backup_utilities %}, you must choose a release that will work with your current version of {% data variables.product.product_name %}. Your installation of {% data variables.product.prodname_enterprise_backup_utilities %} must be at least the same version as {% data variables.product.product_location %}, and cannot be more than two versions ahead. For more information, see [{% data variables.product.prodname_ghe_server %} version requirements](https://github.com/github/backup-utils/blob/master/docs/requirements.md#github-enterprise-server-version-requirements) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. +You can upgrade {% data variables.product.prodname_enterprise_backup_utilities %} in a Git repository by fetching and checking out the latest changes. -Como alternativa, se você não usar um repositório Git para sua instalação, poderá extrair um novo arquivo no local ou mudar sua abordagem para usar um repositório Git. +Alternatively, if you don't use a Git repository for your installation, you can extract a new archive into place, or you can change your approach to use a Git repository instead. -### Verificar o tipo de instalação +### Verifying the installation type -Você pode verificar o método de instalação do {% data variables.product.prodname_enterprise_backup_utilities %} e determinar a melhor forma de atualizar sua instalação. +You can verify the installation method for {% data variables.product.prodname_enterprise_backup_utilities %} and determine the best way to upgrade your installation. {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} -1. Para verificar se existe um diretório de trabalho válido dentro de um repositório Git, execute o comando a seguir. +1. To check if a valid working directory exists inside a Git repository, run the following command. ``` git rev-parse --is-inside-work-tree ``` - Se a saída é `true`, {% data variables.product.prodname_enterprise_backup_utilities %} foi instalado clonando o repositório Git do projeto. Se a saída inclui `fatal: not a git repository (or any of the parent directories)`, {% data variables.product.prodname_enterprise_backup_utilities %} foi provavelmente instalado extraindo um arquivo morto compactado. -Se a instalação estiver em um repositório Git, você poderá instalar a versão mais recente usando o Git. Se a instalação for de um arquivo morto compactado, você poderá baixar e extrair a versão mais recente ou reinstalar o {% data variables.product.prodname_enterprise_backup_utilities %} usando o Git para simplificar atualizações futuras. + If the output is `true`, {% data variables.product.prodname_enterprise_backup_utilities %} was installed by cloning the project's Git repository. If the output includes `fatal: not a git repository (or any of the parent directories)`, {% data variables.product.prodname_enterprise_backup_utilities %} was likely installed by extracting a compressed archive file. +If your installation is in a Git repository, you can install the latest version using Git. If the installation is from a compressed archive file, you can either download and extract the latest version, or you can reinstall {% data variables.product.prodname_enterprise_backup_utilities %} using Git to simplify future upgrades. -- [Atualizar uma instalação em um repositório Git](#upgrading-an-installation-in-a-git-repository) -- [Usar o Git em vez de arquivos compactados para upgrades](#using-git-instead-of-compressed-archives-for-upgrades) +- [Upgrading an installation in a Git repository](#upgrading-an-installation-in-a-git-repository) +- [Using Git instead of compressed archives for upgrades](#using-git-instead-of-compressed-archives-for-upgrades) -### Atualizar uma instalação em um repositório Git +### Upgrading an installation in a Git repository -{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} {% note %} +{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} + {% note %} - **Nota:** é recomendável criar uma cópia do arquivo `backup.config` existente em um local temporário, como `$HOME/backup.config`, antes de atualizar dados {% data variables.product.prodname_enterprise_backup_utilities %}. + **Note:** We recommend creating a copy of your existing `backup.config` file in a temporary location, like `$HOME/backup.config`, before upgrading {% data variables.product.prodname_enterprise_backup_utilities %}. {% endnote %} -1. Baixe as atualizações de projeto mais recentes executando o comando `git fetch`. +1. Download the latest project updates by running the `git fetch` command. ```shell git fetch ``` -{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %} +{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} +{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %} -### Usar o Git em vez de arquivos compactados para upgrades +### Using Git instead of compressed archives for upgrades -Se o host de backup tiver conectividade com a Internet e você tiver usado anteriormente um arquivo compactado (`.tar.gz`) para instalar ou atualizar o {% data variables.product.prodname_enterprise_backup_utilities %}, recomendamos usar um repositório Git para sua instalação. A atualização usando o Git requer menos trabalho e preserva sua configuração de backup. +If your backup host has internet connectivity and you previously used a compressed archive (`.tar.gz`) to install or upgrade {% data variables.product.prodname_enterprise_backup_utilities %}, we recommend using a Git repository for your installation instead. Upgrading using Git requires less work and preserves your backup configuration. {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} -1. Para fazer backup da configuração existente do {% data variables.product.prodname_enterprise_backup_utilities %}, copie o arquivo `backup.config` atual para um local seguro, como seu diretório inicial. +1. To back up your existing {% data variables.product.prodname_enterprise_backup_utilities %} configuration, copy your current `backup.config` file to a safe location, such as your home directory. ``` $ cp backup.config $HOME/backup.config.saved-$(date +%Y%m%d-%H%M%S) ``` -1. Altere para o diretório local no seu host de backup em que deseja isntalar o repositório Git do {% data variables.product.prodname_enterprise_backup_utilities %}. -1. Para clonar o [repositório de projeto](https://github.com/github/backup-utils/) para o diretório no seu host de backup, execute o comando a seguir. +1. Change to the local directory on your backup host where you want to install the {% data variables.product.prodname_enterprise_backup_utilities %} Git repository. +1. To clone the [project repository](https://github.com/github/backup-utils/) to the directory on your backup host, run the following command. ``` git clone https://github.com/github/backup-utils.git ``` -1. Para alterar para o repositório clonado, execute o comando a seguir. +1. To change into the cloned repository, run the following command. ``` cd backup-utils ``` {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} -1. Para restaurar a configuração de backup anterior, copie o arquivo de configuração de backup existente para o diretório do repositório local. Substitua o caminho no comando pelo local do arquivo salvo na etapa 2. +1. To restore your backup configuration from earlier, copy your existing backup configuration file to the local repository directory. Replace the path in the command with the location of the file saved in step 2. ``` $ cp PATH/TO/BACKUP/FROM/STEP/2 backup.config @@ -186,44 +182,44 @@ Se o host de backup tiver conectividade com a Internet e você tiver usado anter {% note %} - **Nota:** você pode escolher para onde deseja restaurar seu arquivo de configuração de backup após a clonagem. Para obter mais informações sobre onde os arquivos de configuração podem estar localizados, confira [Introdução](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) na documentação do projeto do {% data variables.product.prodname_enterprise_backup_utilities %}. + **Note:** You can choose where to restore your backup configuration file to after cloning. For more information about where configuration files can be located, see [Getting started](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. {% endnote %} -1. Para confirmar se os caminhos para diretórios ou scripts no arquivo de configuração de backup estão corretos, examine o arquivo em um editor de texto. +1. To confirm that the paths to directories or scripts in your backup configuration file are correct, review the file in a text editor. {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %} -1. Exclua seu antigo diretório de Utilitários de Backup do GitHub Enterprise Server da etapa 1 (em que a instalação de arquivos compactados estava localizada). +1. Delete your old GitHub Enterprise Server Backup Utilities directory from step 1 (where the compressed archive installation was located). -## Programar um backup +## Scheduling a backup -Você pode agendar backups regulares no host de backup usando o comando `cron(8)` ou um serviço de agendamento de comando semelhante. A frequência configurada determinará o objetivo do ponto de recuperação (RPO) nos piores cenários do seu plano de recuperação. Por exemplo, ao programar backups diários à meia-noite, você pode perder até 24 horas de dados em caso de desastre. É recomendável começar com backups a cada hora, garantindo a possibilidade de perdas menores (no máximo de uma hora) caso os dados primários do site sejam destruídos. +You can schedule regular backups on the backup host using the `cron(8)` command or a similar command scheduling service. The configured backup frequency will dictate the worst case recovery point objective (RPO) in your recovery plan. For example, if you have scheduled the backup to run every day at midnight, you could lose up to 24 hours of data in a disaster scenario. We recommend starting with an hourly backup schedule, guaranteeing a worst case maximum of one hour of data loss if the primary site data is destroyed. -Se as tentativas de backup forem sobrepostas, o comando `ghe-backup` será anulado com uma mensagem de erro, indicando a existência de um backup simultâneo. Nesse caso, é recomendável diminuir a frequência dos backups programados. Para obter informações, confira a seção "Agendar backups" do [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#scheduling-backups) na documentação do projeto do {% data variables.product.prodname_enterprise_backup_utilities %}. +If backup attempts overlap, the `ghe-backup` command will abort with an error message, indicating the existence of a simultaneous backup. If this occurs, we recommended decreasing the frequency of your scheduled backups. For more information, see the "Scheduling backups" section of the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#scheduling-backups) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## Como restaurar um backup +## Restoring a backup -No caso de interrupção prolongada ou evento catastrófico no site primário, você pode restaurar o {% data variables.product.product_location %} provisionando outro dispositivo do {% data variables.product.prodname_enterprise %} e executando uma restauração por meio do host de backup. Antes de restaurar um appliance, você deve adicionar a chave SSH do host de backup ao appliance de destino do {% data variables.product.prodname_enterprise %} como chave SSH autorizada. +In the event of prolonged outage or catastrophic event at the primary site, you can restore {% data variables.product.product_location %} by provisioning another {% data variables.product.prodname_enterprise %} appliance and performing a restore from the backup host. You must add the backup host's SSH key to the target {% data variables.product.prodname_enterprise %} appliance as an authorized SSH key before restoring an appliance. {% note %} -**Observação:** durante a execução de restaurações de backup no {% data variables.product.product_location %}, as mesmas regras de capacidade de suporte de versão se aplicam. Você só pode restaurar dados de no máximo duas versões do recursos para trás. +**Note:** When performing backup restores to {% data variables.product.product_location %}, the same version supportability rules apply. You can only restore data from at most two feature releases behind. -Por exemplo, se você fizer um backup do {% data variables.product.product_name %} 3.0.x, poderá restaurar o backup para uma instância 3.2.x do {% data variables.product.product_name %}. Não é possível restaurar dados de um backup do {% data variables.product.product_name %} 2.22.x para uma instância que executa 3.2.x, porque ela seria três saltos entre as versões (2.22 ara 3.0 para 3.1 para 3.2). Primeiro, você precisa restaurar em uma instância que executa a versão 3.1.x e, em seguida, atualizar para a 3.2.x. +For example, if you take a backup from {% data variables.product.product_name %} 3.0.x, you can restore the backup to a {% data variables.product.product_name %} 3.2.x instance. You cannot restore data from a backup of {% data variables.product.product_name %} 2.22.x to an instance running 3.2.x, because that would be three jumps between versions (2.22 to 3.0 to 3.1 to 3.2). You would first need to restore to an instance running 3.1.x, and then upgrade to 3.2.x. {% endnote %} -Para restaurar o {% data variables.product.product_location %} do último instantâneo bem-sucedido, use o comando `ghe-restore`. +To restore {% data variables.product.product_location %} from the last successful snapshot, use the `ghe-restore` command. {% note %} -**Nota:** antes de restaurar um backup, verifique se: -- O modo de manutenção está habilitado na instância primária e todos os processos ativos foram concluídos. Para obter mais informações, confira "[Como habilitar o modo de manutenção](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)". -- A replicação é interrompida em todas as réplicas em configurações de alta disponibilidade. Para obter mais informações, confira o comando `ghe-repl-stop` em "[Sobre a configuração de alta disponibilidade](/admin/enterprise-management/configuring-high-availability/about-high-availability-configuration#ghe-repl-stop)". -- Se o {% data variables.product.product_location %} tiver o {% data variables.product.prodname_actions %} habilitado, primeiro, você precisará configurar o provedor de armazenamento externo do {% data variables.product.prodname_actions %} no dispositivo substituto. Para obter mais informações, confira "[Backup e restauração do {% data variables.product.prodname_ghe_server %} com o {% data variables.product.prodname_actions %} habilitado](/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled)". +**Note:** Prior to restoring a backup, ensure: +- Maintenance mode is enabled on the primary instance and all active processes have completed. For more information, see "[Enabling maintenance mode](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)." +- Replication is stopped on all replicas in high availability configurations. For more information, see the `ghe-repl-stop` command in "[About high availability configuration](/admin/enterprise-management/configuring-high-availability/about-high-availability-configuration#ghe-repl-stop)." +- If {% data variables.product.product_location %} has {% data variables.product.prodname_actions %} enabled, you must first configure the {% data variables.product.prodname_actions %} external storage provider on the replacement appliance. For more information, see "[Backing up and restoring {% data variables.product.prodname_ghe_server %} with {% data variables.product.prodname_actions %} enabled](/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled)." {% endnote %} -Ao executar o comando `ghe-restore`, você deverá ver uma saída semelhante a esta: +When running the `ghe-restore` command, you should see output similar to this: ```shell $ ghe-restore -c 169.154.1.1 @@ -242,15 +238,20 @@ $ ghe-restore -c 169.154.1.1 > Visit https://169.154.1.1/setup/settings to review appliance configuration. ``` -{% ifversion ip-exception-list %} Opcionalmente, para validar a restauração, configure uma lista de exceções de IP para permitir o acesso a uma lista especificada de endereços IP. Para obter mais informações, confira "[Validar alterações no modo de manutenção usando a lista de exceções de IP](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)". +{% ifversion ip-exception-list %} +Optionally, to validate the restore, configure an IP exception list to allow access to a specified list of IP addresses. For more information, see "[Validating changes in maintenance mode using the IP exception list](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)." {% endif %} {% note %} -**Observação:** as configurações de rede são excluídas do instantâneo de backup. Você deve configurar manualmente a rede no appliance de destino do {% data variables.product.prodname_ghe_server %} conforme o seu ambiente. +**Note:** + +- The network settings are excluded from the backup snapshot. You must manually configure the network on the target {% data variables.product.prodname_ghe_server %} appliance as required for your environment. + +- When restoring to new disks on an existing or empty {% data variables.product.prodname_ghe_server %} instance, stale UUIDs may be present, resulting in Git and/or Alambic replication reporting as out of sync. Stale server entry IDs can be the result of a retired node in a high availability configuration still being present in the application database, but not in the restored replication configuration. To remediate, stale UUIDs can be torn down using `ghe-repl-teardown` once the restore has completed and prior to starting replication. In this scenario, contact {% data variables.contact.contact_ent_support %} for further assistance. {% endnote %} -Você pode usar essas opções adicionais com o comando `ghe-restore`: -- O sinalizador `-c` substitui as configurações, o certificado e os dados de licença no host de destino, mesmo que ele já esteja configurado. Omita esse sinalizador se você estiver configurando uma instância de preparo para fins de teste e se quiser manter a configuração no destino. Para obter mais informações, confira a seção "Usar comandos de backup e restauração" do [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#using-the-backup-and-restore-commands) na documentação do projeto do {% data variables.product.prodname_enterprise_backup_utilities %}. -- O sinalizador `-s` permite que você selecione outro instantâneo de backup. +You can use these additional options with `ghe-restore` command: +- The `-c` flag overwrites the settings, certificate, and license data on the target host even if it is already configured. Omit this flag if you are setting up a staging instance for testing purposes and you wish to retain the existing configuration on the target. For more information, see the "Using backup and restore commands" section of the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#using-the-backup-and-restore-commands) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. +- The `-s` flag allows you to select a different backup snapshot. diff --git a/translations/pt-BR/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md b/translations/pt-BR/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md index 6fa069a0f2..9445e64621 100644 --- a/translations/pt-BR/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md +++ b/translations/pt-BR/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md @@ -93,7 +93,7 @@ Optionally, if you use {% data variables.product.prodname_registry %} on your pr {% warning %} -**Warning**: If you don't configure {% data variables.product.prodname_actions %} on the staging instance before restoring your production backup, your staging instance will use your production instance's external storage, which could result in loss of data. We strongly recommended that you use different external storage for your staging instance. +**Warning**: If you don't configure {% data variables.product.prodname_registry %} on the staging instance before restoring your production backup, your staging instance will use your production instance's external storage, which could result in loss of data. We strongly recommended that you use different external storage for your staging instance. {% endwarning %} @@ -128,7 +128,7 @@ Optionally, if you use {% data variables.product.prodname_registry %} on your pr Use the `ghe-restore` command to restore the rest of the data from the backup. For more information, see "[Restoring a backup](/admin/configuration/configuring-backups-on-your-appliance#restoring-a-backup)." -If the staging instance is already configured and you're about to overwrite settings, certificate, and license data, add the `-c` option to the command. For more information about the option, see [Using the backup and restore commands](https://github.com/github/backup-utils/blob/master/docs/usage.md#restoring-settings-tls-certificate-and-license) in the {% data variables.product.prodname_enterprise_backup_utilities %} documentation. +If the staging instance is already configured and you want to overwrite settings, certificate, and license data, add the `-c` option to the command. For more information about the option, see [Using the backup and restore commands](https://github.com/github/backup-utils/blob/master/docs/usage.md#restoring-settings-tls-certificate-and-license) in the {% data variables.product.prodname_enterprise_backup_utilities %} documentation. ### 6. Review the instance's configuration diff --git a/translations/pt-BR/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md b/translations/pt-BR/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md index a21fbca0a0..6e8acc6b4d 100644 --- a/translations/pt-BR/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md +++ b/translations/pt-BR/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md @@ -56,7 +56,7 @@ Jobs that run on Windows and macOS runners that {% data variables.product.prodna The storage used by a repository is the total storage used by {% data variables.product.prodname_actions %} artifacts and {% data variables.product.prodname_registry %}. Your storage cost is the total usage for all repositories owned by your account. For more information about pricing for {% data variables.product.prodname_registry %}, see "[About billing for {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/about-billing-for-github-packages)." - If your account's usage surpasses these limits and you have set a spending limit above $0 USD, you will pay $0.008 USD per GB of storage per day and per-minute usage depending on the operating system used by the {% data variables.product.prodname_dotcom %}-hosted runner. {% data variables.product.prodname_dotcom %} rounds the minutes each job uses up to the nearest minute. + If your account's usage surpasses these limits and you have set a spending limit above $0 USD, you will pay $0.008 USD per GB of storage per day and per-minute usage depending on the operating system used by the {% data variables.product.prodname_dotcom %}-hosted runner. {% data variables.product.prodname_dotcom %} rounds the minutes and partial minutes each job uses up to the nearest whole minute. {% note %} diff --git a/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md b/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md index d11653618f..29711c895e 100644 --- a/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md +++ b/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md @@ -3,6 +3,7 @@ title: About billing for GitHub Codespaces shortTitle: About billing intro: 'View pricing and see how to manage {% data variables.product.prodname_github_codespaces %} billing for your organization.' permissions: 'To manage billing for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner or a billing manager.' +miniTocMaxHeadingLevel: 3 versions: fpt: '*' ghec: '*' @@ -13,40 +14,105 @@ topics: - Billing redirect_from: - /billing/managing-billing-for-github-codespaces/about-billing-for-codespaces + - /github/developing-online-with-codespaces/about-billing-for-codespaces + - /codespaces/getting-started-with-codespaces/about-billing-for-codespaces + - /codespaces/codespaces-reference/about-billing-for-codespaces + - /codespaces/codespaces-reference/understanding-billing-for-codespaces + - /codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md --- ## {% data variables.product.prodname_github_codespaces %} pricing -Charges are incurred for the use of {% data variables.product.prodname_github_codespaces %} for repositories owned by organization and enterprise accounts on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %}. These accounts do not include any free minutes or storage for {% data variables.product.prodname_github_codespaces %}. Repositories in personal accounts are not currently billed for {% data variables.product.prodname_github_codespaces %} usage. +Charges are incurred for the use of {% data variables.product.prodname_github_codespaces %} for repositories owned by organization and enterprise accounts on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %}. These accounts do not include any free minutes or storage for {% data variables.product.prodname_github_codespaces %}. Personal accounts are not currently billed for {% data variables.product.prodname_github_codespaces %} usage. + +A {% data variables.product.prodname_github_codespaces %} instance (a "codespace") incurs charges for compute time, while it is active, and for the amount of storage it uses on disk. {% data variables.product.prodname_github_codespaces %} usage is billed according to the units of measure in the following table: -| Product | SKU | Unit of measure | Price | -| ------------------- | -------- | --------------- | ----- | -| Codespaces Compute | 2 core | 1 hour | $0.18 | -| | 4 core | 1 hour | $0.36 | -| | 8 core | 1 hour | $0.72 | -| | 16 core | 1 hour | $1.44 | -| | 32 core | 1 hour | $2.88 | -| Codespaces Storage | Storage | 1 GB-month | $0.07 | +| Component | Machine type | Unit of measure | Price | +| ------------------- | ------------ | --------------- | ----- | +| Codespaces compute | 2 core | 1 hour | $0.18 | +| | 4 core | 1 hour | $0.36 | +| | 8 core | 1 hour | $0.72 | +| | 16 core | 1 hour | $1.44 | +| | 32 core | 1 hour | $2.88 | +| Codespaces storage | Storage | 1 GB-month* | $0.07 | + +* See "[Billing for storage usage](#billing-for-storage-usage)" below for details of the GB-month unit of measure. + +If you enable prebuilding of codespaces this will incur additional charges. For more information, see "[Billing for {% data variables.product.prodname_codespaces %} prebuilds](#billing-for-codespaces-prebuilds)." ## About billing for {% data variables.product.prodname_github_codespaces %} -{% data reusables.codespaces.codespaces-billing %} +{% data variables.product.prodname_github_codespaces %} is billed in US dollars (USD) according to their compute and storage usage. {% data reusables.codespaces.codespaces-monthly-billing %} xxx -Your {% data variables.product.prodname_github_codespaces %} usage shares your organization or enterprise account's existing billing date, payment method, and receipt. {% data reusables.dotcom_billing.view-all-subscriptions %} +Your {% data variables.product.prodname_github_codespaces %} usage shares your organization or enterprise account's existing payment method, and receipt. For more information, see "[Viewing your subscriptions and billing date](/articles/viewing-your-subscriptions-and-billing-date)." {% ifversion ghec %} If you purchased {% data variables.product.prodname_enterprise %} through a Microsoft Enterprise Agreement, you can connect your Azure Subscription ID to your enterprise account to enable and pay for {% data variables.product.prodname_github_codespaces %} usage. For more information, see "[Connecting an Azure subscription to your enterprise](/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise)." {% endif %} -{% data reusables.dotcom_billing.pricing_calculator.pricing_cal_codespaces %} +### Billing for compute usage +The compute usage of a codespace is the number of minutes for which that codespace is active. Total compute usage is calculated by summing the number of minutes used by all codespaces that are billable to the organization or enterprise. These totals are reported to the billing service every hour, and are billed monthly. + +As an example, if a codespace is active for 1 hour and 15 minutes, then the compute cost will be the hourly cost of the codespace, as determined by its machine type, multiplied by 1.25. + +You can restrict compute usage by stopping your codespaces. For information, see "[Stopping and starting a codespace](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)." Codespaces are stopped automatically after a configurable period of inactivity. The timeout period can be configured by the user, or at the organization level. 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)" and "[Restricting the idle timeout period](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)." + +### Billing for storage usage +For {% data variables.product.prodname_github_codespaces %} billing purposes, this includes all storage used by all codespaces and prebuilds in your account. This includes any files used by the codespaces, such as cloned repositories, configuration files, and extensions, among others. Storage is billed for all of your existing codespaces, regardless of whether they are active or stopped. The storage billing for a codespace ends when it is deleted. + +Codespace storage is reported in GB-months. Your billing month runs from a fixed day in one month until the same day in the next month. In most cases the day of the month is determined by the day you started on your current {% data variables.product.prodname_dotcom %} plan. Your GB-month storage, is calculated as follows. Once every hour, the storage used by all of your currently active and stopped codespaces is assessed. This figure is then divided by the number of hours in the current billing month: `total storage size / hours this month`. The result is added to the running total for codespace storage for the month. + +For example, if you have one codespace that uses 100 GB of storage and has existed for one hour you will have used `100 / (24 * 30) = 0.1388` GB-months of storage in a 30-day month. If your use of GitHub Codespaces during a 30-day month consists of two 100 GB codespaces that both existed for three full days then there will be `24 * 3` hourly reports for the storage of these codespaces, giving a total of: `(24 * 3) * 200 / (24 * 30) = 20` GB-months. + +For each hourly report, the storage usage for the previous hour is calculated in seconds. As a result, you won't be charged for a full hour of storage if a codespace did not exist for the full 60 minutes. At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB. + +As an organization owner, you can: +- List the currently active and stopped codespaces for your organization. For more information, see "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)." In addition to the cost of these codespaces, the cost of {% data variables.product.prodname_github_codespaces %} for the current month may include costs for codespaces that existed earlier in the current month but have since been deleted. +- See the total {% data variables.product.prodname_github_codespaces %} compute and storage usage for your organization for the current month to date. For more information, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." +- Configure your organization settings to manage the cost of {% data variables.product.prodname_github_codespaces %}. For more information, see "[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)." + +To estimate the costs for metered services, you can use the {% data variables.product.prodname_dotcom %} [pricing calculator](https://github.com/pricing/calculator?feature=codespaces). ### Billing for {% data variables.product.prodname_codespaces %} prebuilds -{% data reusables.codespaces.billing-for-prebuilds-default %} +{% data reusables.codespaces.prebuilds-definition %} For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds)." -{% data reusables.codespaces.billing-for-prebuilds-reducing %} +#### {% data variables.product.prodname_actions %} costs for prebuilds + +Prebuilds are created and updated by running a {% data variables.product.prodname_actions %} workflow on a {% data variables.product.prodname_dotcom %}-hosted runner. By default, prebuilds are updated every time you modify the prebuild configuration, or push changes to a prebuild-enabled branch. As with other workflows, while prebuild workflows are running they will either consume some of the Actions minutes included with your account, if you have any, or they will incur charges for Actions minutes. For more information about pricing for Actions minutes, see "[About billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)." There is no associated {% data variables.product.prodname_codespaces %} compute cost for creating or updating prebuilds. + +To reduce consumption of Actions minutes, you can set a prebuild to be updated only when you make a change to your dev container configuration files, or only on a custom schedule. You can also manage your storage usage by adjusting the number of previous versions of each prebuild that are retained. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." + +If you are an organization or enterprise owner, you can track usage of prebuild workflows and storage by downloading a usage report for your organization or enterprise. You can identify workflow runs for prebuilds by filtering the CSV output to only include the workflow called "Create {% data variables.product.prodname_github_codespaces %} Prebuilds." For more information, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage#viewing-github-actions-usage-for-your-organization)." + +#### Storage costs for prebuilds + +In addition to {% data variables.product.prodname_actions %} minutes, you will also be billed for the storage of prebuilds associated with each prebuild configuration for a given repository and region. Storage of prebuilds is billed at the same rate as storage of codespaces. + +The storage cost for a prebuild in a single region will be similar to the storage cost that will be incurred for storing a single codespace created from that prebuild. The storage cost for the generated codespace may be more than the cost for the prebuild if, for example, the `updateContentCommand` and `postCreateCommand` commands are used during codespace creation to download more files to the dev container. + +The total storage costs associated with a prebuild template will depend on: + +* The price of storage per GB. See the table above. +* The size of the generated prebuild in GB. +* The number of regions in which the prebuild is available (because a copy of the prebuild is stored in each region). +* The number of older versions of the prebuild that are retained. + +The storage cost for a prebuild is therefore calculated as: `price per GB * size (GB) * regions * versions`. + +To limit the storage costs associated with prebuilds, you can choose to create prebuilds only in selected regions, and you can specify the number of older versions of prebuilds that will be retained. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." + +{% note %} + +**Note**: Prebuilds may be updated several times during a billing month. Newer versions of a prebuild may be larger or smaller than the previous versions. This will affect the storage charges. For details of how storage is calculated during a billing month, see "[Billing for storage usage](#billing-for-storage-usage)" above. + +{% endnote %} + +#### Cost of codespaces created from prebuilds + +Use of codespaces created using prebuilds is charged at the same rate as regular codespaces. ## Setting a spending limit @@ -72,7 +138,7 @@ For example, a user in an organization can fork a repository within that organiz ## How billing is handled when a repository is transferred -Usage is billed and reported on every hour. As such, you pay for any usage when a repository is within your organization. When a repository is transferred out of your organization, any codespaces in that repository are removed as part of the transfer process. +Usage is calculated every hour. An organization pays for usage of codespaces created from any repository owned by the organization, where the organization settings permit the organization to be billed. For more information, see "[Enabling GitHub Codespaces for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#choose-who-can-create-codespaces-that-are-billed-to-your-organization)." When a repository is transferred out of your organization, ownership and billing responsibility for any codespaces associated with that repository will change accordingly. ## What happens when users are removed diff --git a/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/index.md b/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/index.md index 839d5dc496..b565c2a921 100644 --- a/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/index.md +++ b/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/index.md @@ -11,4 +11,3 @@ children: - /viewing-your-github-codespaces-usage - /managing-spending-limits-for-github-codespaces --- - diff --git a/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md b/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md index cf5ad18c14..929ebfd3e8 100644 --- a/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md +++ b/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md @@ -21,6 +21,8 @@ redirect_from: {% data reusables.codespaces.codespaces-spending-limit-requirement %} +{% data reusables.codespaces.codespaces-monthly-billing %} + Once you've reached your spending limit, your organization or repository will no longer be able to create new codespaces, and won't be able to start existing codespaces. Any existing codespaces that are still running will not be shutdown; if you don't change the spending limit, you will not be charged for the amount that exceeds the limit. For more information about pricing for {% data variables.product.prodname_github_codespaces %} usage, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." @@ -67,4 +69,4 @@ You can disable these notifications anytime by navigating to the bottom of the * ## Further reading - "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" -- "[Managing billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)" diff --git a/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md b/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md index 3081c864ef..9652fd43bd 100644 --- a/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md +++ b/translations/pt-BR/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md @@ -21,8 +21,21 @@ Organization owners and billing managers can view {% data variables.product.prod {% 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. -  + +  + + 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-spending-limits-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. + + {% endnote %} + {% data reusables.dotcom_billing.actions-packages-report-download-org-account %} + The data used for this report is updated daily. 1. Filter the report to show only rows that mention "Codespaces" in the `Product` field.  @@ -38,3 +51,7 @@ Enterprise owners and billing managers can view {% data variables.product.prodna 1. Under "{% data variables.product.prodname_codespaces %} monthly usage", view the usage details of each organization in your enterprise account. {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} {% endif %} + +## Further reading + +- "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)" \ No newline at end of file diff --git a/translations/pt-BR/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md b/translations/pt-BR/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md index 51ae89d06d..f8ef3037ef 100644 --- a/translations/pt-BR/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md +++ b/translations/pt-BR/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md @@ -14,23 +14,23 @@ shortTitle: Private image registry A registry is a secure space for storing, managing, and fetching private container images. You may use one to store one or more images. There are many examples of registries, such as {% data variables.product.prodname_container_registry %}, {% data variables.product.prodname_npm_registry %}, Azure Container Registry, or DockerHub. -{% data variables.product.prodname_ghcr_and_npm_registry %} can be configured to allow container images to be pulled seamlessly into {% data variables.product.prodname_github_codespaces %} during codespace creation, without having to provide any authentication credentials. For other image registries, you must create secrets in {% data variables.product.prodname_dotcom %} to store the access details, which will allow {% data variables.product.prodname_github_codespaces %} to access images stored in that registry. +{% data variables.packages.prodname_ghcr_and_npm_registry %} can be configured to allow container images to be pulled seamlessly into {% data variables.product.prodname_github_codespaces %} during codespace creation, without having to provide any authentication credentials. For other image registries, you must create secrets in {% data variables.product.prodname_dotcom %} to store the access details, which will allow {% data variables.product.prodname_github_codespaces %} to access images stored in that registry. -## Accessing images stored in {% data variables.product.prodname_ghcr_and_npm_registry %} +## Accessing images stored in {% data variables.packages.prodname_ghcr_and_npm_registry %} -{% data variables.product.prodname_ghcr_and_npm_registry %} provide the easiest way for {% data variables.product.prodname_github_codespaces %} to consume dev container images. +{% data variables.packages.prodname_ghcr_and_npm_registry %} provide the easiest way for {% data variables.product.prodname_github_codespaces %} to consume dev container images. For more information, see "[Working with the Container registry](/packages/working-with-a-github-packages-registry/working-with-the-container-registry)" and "[Working with the npm registry](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry)". ### Accessing an image published to the same repository as the codespace -If you publish a container image to {% data variables.product.prodname_ghcr_or_npm_registry %} in the same repository that the codespace is being launched in, you will automatically be able to fetch that image on codespace creation. You won't have to provide any additional credentials, unless the **Inherit access from repo** option was unselected when the container image was published. +If you publish a container image to {% data variables.packages.prodname_ghcr_or_npm_registry %} in the same repository that the codespace is being launched in, you will automatically be able to fetch that image on codespace creation. You won't have to provide any additional credentials, unless the **Inherit access from repo** option was unselected when the container image was published. #### Inheriting access from the repository from which an image was published -By default, when you publish a container image to {% data variables.product.prodname_ghcr_or_npm_registry %}, the image inherits the access setting of the repository from which the image was published. For example, if the repository is public, the image is also public. If the repository is private, the image is also private, but is accessible from the repository. +By default, when you publish a container image to {% data variables.packages.prodname_ghcr_or_npm_registry %}, the image inherits the access setting of the repository from which the image was published. For example, if the repository is public, the image is also public. If the repository is private, the image is also private, but is accessible from the repository. -This behavior is controlled by the **Inherit access from repo** option. **Inherit access from repo** is selected by default when publishing via {% data variables.product.prodname_actions %}, but not when publishing directly to {% data variables.product.prodname_ghcr_or_npm_registry %} using a Personal Access Token (PAT). +This behavior is controlled by the **Inherit access from repo** option. **Inherit access from repo** is selected by default when publishing via {% data variables.product.prodname_actions %}, but not when publishing directly to {% data variables.packages.prodname_ghcr_or_npm_registry %} using a Personal Access Token (PAT). If the **Inherit access from repo** option was not selected when the image was published, you can manually add the repository to the published container image's access controls. For more information, see "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#inheriting-access-for-a-container-image-from-a-repository)." @@ -46,13 +46,13 @@ If you want to allow a subset of an organization's repositories to access a cont ### Publishing a container image from a codespace -Seamless access from a codespace to {% data variables.product.prodname_ghcr_or_npm_registry %} is limited to pulling container images. If you want to publish a container image from inside a codespace, you must use a personal access token (PAT) with the `write:packages` scope. +Seamless access from a codespace to {% data variables.packages.prodname_ghcr_or_npm_registry %} is limited to pulling container images. If you want to publish a container image from inside a codespace, you must use a personal access token (PAT) with the `write:packages` scope. We recommend publishing images via {% data variables.product.prodname_actions %}. For more information, see "[Publishing Docker images](/actions/publishing-packages/publishing-docker-images)" and "[Publishing Node.js packages](/actions/publishing-packages/publishing-nodejs-packages)." ## Accessing images stored in other container registries -If you are accessing a container image from a registry that isn't {% data variables.product.prodname_ghcr_or_npm_registry %}, {% data variables.product.prodname_github_codespaces %} checks for the presence of three secrets, which define the server name, username, and personal access token (PAT) for a container registry. If these secrets are found, {% data variables.product.prodname_github_codespaces %} will make the registry available inside your codespace. +If you are accessing a container image from a registry that isn't {% data variables.packages.prodname_ghcr_or_npm_registry %}, {% data variables.product.prodname_github_codespaces %} checks for the presence of three secrets, which define the server name, username, and personal access token (PAT) for a container registry. If these secrets are found, {% data variables.product.prodname_github_codespaces %} will make the registry available inside your codespace. - `<*>_CONTAINER_REGISTRY_SERVER` - `<*>_CONTAINER_REGISTRY_USER` diff --git a/translations/pt-BR/content/codespaces/codespaces-reference/index.md b/translations/pt-BR/content/codespaces/codespaces-reference/index.md index 1e98b6400d..e5d4fe7cc4 100644 --- a/translations/pt-BR/content/codespaces/codespaces-reference/index.md +++ b/translations/pt-BR/content/codespaces/codespaces-reference/index.md @@ -6,7 +6,6 @@ versions: ghec: '*' product: '{% data reusables.gated-features.codespaces %}' children: - - /understanding-billing-for-github-codespaces - /allowing-your-codespace-to-access-a-private-image-registry - /using-github-copilot-in-github-codespaces - /using-the-vs-code-command-palette-in-codespaces diff --git a/translations/pt-BR/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md b/translations/pt-BR/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md deleted file mode 100644 index f6a802c687..0000000000 --- a/translations/pt-BR/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: Understanding billing for GitHub Codespaces -intro: 'Learn how your {% data variables.product.prodname_github_codespaces %} usage is billed.' -versions: - fpt: '*' - ghec: '*' -redirect_from: - - /github/developing-online-with-codespaces/about-billing-for-codespaces - - /codespaces/getting-started-with-codespaces/about-billing-for-codespaces - - /codespaces/codespaces-reference/about-billing-for-codespaces - - /codespaces/codespaces-reference/understanding-billing-for-codespaces -type: reference -topics: - - Codespaces - - Billing -product: '{% data reusables.gated-features.codespaces %}' -shortTitle: Understanding billing ---- - -This article explains how billing works for your codespaces, and explains how your organization's billing manager can help. - -## Getting access to {% data variables.product.prodname_github_codespaces %} - -Your organization's administrator might limit {% data variables.product.prodname_github_codespaces %} usage to only specific personal accounts. To get access, you will need to contact your billing manager. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)." - -## How much it costs to use {% data variables.product.prodname_codespaces %} - -To see the pricing for {% data variables.product.prodname_github_codespaces %} usage, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-codespaces#codespaces-pricing)." - -## How your codespace usage is billed - -Your codespace is billed for its compute minutes and for the amount of storage it uses on disk. - -If you enable prebuilding of codespaces this will incur additional charges. For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds#about-billing-for-codespaces-prebuilds)." - -### Understanding what compute minutes are -Your codespace is billed for the number of minutes that it's active. If your codespaces window is left idle for 30 minutes, it will automatically shutdown, and compute billing for the codespace will end until you start the codespace again. - -### Understanding how codespace storage is billed -For {% data variables.product.prodname_github_codespaces %}, storage is defined to include any files relating to your codespace, such as the cloned repository, configuration files, and extensions, among others. This storage is billed while your codespace is shutdown. The storage billing for a codespace ends when you manually delete it from https://github.com/codespaces. - -## How spending limits work - -Before your organization can use {% data variables.product.prodname_github_codespaces %}, your billing manager will need to set a spending limit. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." - -## Exporting changes when you have reached your spending limit - -{% data reusables.codespaces.exporting-changes %} - -## Checking your current usage and limits -If you need to check your current usage or spending limit, contact your organization's billing manager. For more information, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." - -## Codespaces can be automatically deleted - -Your codespace will be automatically deleted when you are removed from an organization or repository. - -## Deleting your unused codespaces - -You can manually delete your codespaces in https://github.com/codespaces and from within {% data variables.product.prodname_vscode %}. To reduce the size of a codespace, you can manually delete files using the terminal or from within {% data variables.product.prodname_vscode %}. - -## Further reading - -- "[Managing billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization)" diff --git a/translations/pt-BR/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md b/translations/pt-BR/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md index 2465cfe69e..d3ec7e7ef3 100644 --- a/translations/pt-BR/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md +++ b/translations/pt-BR/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md @@ -71,7 +71,7 @@ If you try to delete a codespace with unpushed git commits, your editor will not 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)." -You will be charged for the storage of all your codespaces. When you delete a codespace, you will no longer be charged. +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)." diff --git a/translations/pt-BR/content/codespaces/developing-in-codespaces/index.md b/translations/pt-BR/content/codespaces/developing-in-codespaces/index.md index 0be0db0c41..89acc97c82 100644 --- a/translations/pt-BR/content/codespaces/developing-in-codespaces/index.md +++ b/translations/pt-BR/content/codespaces/developing-in-codespaces/index.md @@ -11,12 +11,12 @@ children: - /codespaces-lifecycle - /developing-in-a-codespace - /creating-a-codespace + - /deleting-a-codespace - /opening-an-existing-codespace - /using-source-control-in-your-codespace - /using-github-codespaces-for-pull-requests - /stopping-and-starting-a-codespace - /renaming-a-codespace - - /deleting-a-codespace - /forwarding-ports-in-your-codespace - /default-environment-variables-for-your-codespace - /connecting-to-a-private-network diff --git a/translations/pt-BR/content/codespaces/getting-started/deep-dive.md b/translations/pt-BR/content/codespaces/getting-started/deep-dive.md index 782e475ffb..c6a2e16f8a 100644 --- a/translations/pt-BR/content/codespaces/getting-started/deep-dive.md +++ b/translations/pt-BR/content/codespaces/getting-started/deep-dive.md @@ -117,6 +117,6 @@ If you already use {% data variables.product.prodname_vscode_shortname %}, you c ## 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 billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)" - "[Codespaces lifecycle](/codespaces/developing-in-codespaces/codespaces-lifecycle)" diff --git a/translations/pt-BR/content/codespaces/getting-started/quickstart.md b/translations/pt-BR/content/codespaces/getting-started/quickstart.md index 3aa2d59490..213fec6823 100644 --- a/translations/pt-BR/content/codespaces/getting-started/quickstart.md +++ b/translations/pt-BR/content/codespaces/getting-started/quickstart.md @@ -111,4 +111,4 @@ You've successfully created, personalized, and run your first application within ## 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 billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)" diff --git a/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md b/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md index ff040d9a82..25d134cf2a 100644 --- a/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md +++ b/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md @@ -19,7 +19,7 @@ topics: ## About enabling {% data variables.product.prodname_github_codespaces %} for your organization -Organization owners can control which users in your organization can create and use codespaces at the organization's expense. +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 GitHub Codespaces](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." Only people who can clone a repository can create a codespace for that repository. To allow people to create codespaces for repositories owned by your organization, you must: diff --git a/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/index.md b/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/index.md index c69731bb7f..70286203b8 100644 --- a/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/index.md +++ b/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/index.md @@ -11,7 +11,7 @@ topics: children: - /enabling-github-codespaces-for-your-organization - /listing-the-codespaces-in-your-organization - - /managing-billing-for-github-codespaces-in-your-organization + - /managing-the-cost-of-github-codespaces-in-your-organization - /managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces - /managing-repository-access-for-your-organizations-codespaces - /reviewing-your-organizations-audit-logs-for-github-codespaces diff --git a/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md b/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md deleted file mode 100644 index b00448e35b..0000000000 --- a/translations/pt-BR/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Managing billing for GitHub Codespaces in your organization -shortTitle: Manage billing -intro: 'You can check your {% data variables.product.prodname_github_codespaces %} usage and set usage limits.' -product: '{% data reusables.gated-features.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 ---- - -## Overview - -To learn about pricing for {% data variables.product.prodname_github_codespaces %}, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)." - -{% data reusables.codespaces.codespaces-billing %} - -- As an organization owner or a billing manager, you can manage {% data variables.product.prodname_github_codespaces %} billing for your organization: ["About billing for Codespaces"](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces) -- As an organization owner, you can list the currently active and stopped codespaces for your organization. In addition to these codespaces, costs for the current month may include costs for codespaces that existed earlier in the current month but have since been deleted. -- For users, there is a guide that explains how billing works: ["Understanding billing for {% data variables.product.prodname_github_codespaces %}"](/codespaces/codespaces-reference/understanding-billing-for-github-codespaces) - -## Usage limits - -You can set a usage limit for the codespaces in your organization or repository. This limit is applied to the compute and storage usage for {% data variables.product.prodname_github_codespaces %}: - -- **Compute minutes:** Compute usage is calculated by the actual number of minutes used by all {% data variables.product.prodname_github_codespaces %} instances while they are active. These totals are reported to the billing service daily, and is billed monthly. You can set a spending limit for {% data variables.product.prodname_github_codespaces %} usage in your organization. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." - -- **Storage usage:** For {% data variables.product.prodname_github_codespaces %} billing purposes, this includes all storage used by all codespaces in your account. This includes resources such as cloned repositories, configuration files, and extensions, among others. These totals are reported to the billing service daily, and is billed monthly. At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB. To check how many compute minutes and storage GB have been used by {% data variables.product.prodname_github_codespaces %}, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage"](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." - -## Disabling or limiting {% data variables.product.prodname_codespaces %} - -You can disable all use of {% data variables.product.prodname_github_codespaces %} that would be billed to your organization. Alternatively, you can specify which organization members or collaborators can use {% data variables.product.prodname_codespaces %} at your 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-disabling-org-billing %} - -You can configure which repositories can be accessed from codespaces created for a particular repository. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)." - -You can limit the choice of types of machine that are available for codespaces created from repositories owned by your organization. This allows you to prevent people using overly resourced machines for their codespaces, and incurring unnecessary charges. For more information, see "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)." - -You can also restrict how long a codespace can remain unused before it is automatically deleted. This can help to reduce storage costs for {% data variables.product.prodname_codespaces %}. For more information, see "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)." - -## Deleting unused codespaces - -Your users can delete their own codespaces in https://github.com/codespaces and from within {% data variables.product.prodname_vscode %}. To reduce the size of a codespace, users can manually delete files using the terminal or from within {% data variables.product.prodname_vscode_shortname %}. - -As an organization owner, you can delete any codespace in your organization. For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)." - -{% note %} - -**Note:** Codespaces are automatically deleted after they have been stopped and have remained inactive for a defined number of days. For more information, see "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)." A codespace can only be manually deleted by the person who created the codespace. - -{% endnote %} - -## Further reading - -- "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)" diff --git a/translations/pt-BR/content/codespaces/overview.md b/translations/pt-BR/content/codespaces/overview.md index 4c07f6674a..1a6ee65780 100644 --- a/translations/pt-BR/content/codespaces/overview.md +++ b/translations/pt-BR/content/codespaces/overview.md @@ -40,6 +40,8 @@ You can also personalize aspects of your codespace environment by using a public For information on pricing, storage, and usage for {% data variables.product.prodname_github_codespaces %}, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." -{% data reusables.codespaces.codespaces-spending-limit-requirement %} For information on how organizations owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an organization, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." +{% data reusables.codespaces.codespaces-spending-limit-requirement %} + +{% data reusables.codespaces.codespaces-monthly-billing %} For information on how organizations owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an organization, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." You can see who will pay for a codespace before you create it. For more information, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)." \ No newline at end of file diff --git a/translations/pt-BR/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md b/translations/pt-BR/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md index 8b6652eee4..9bbee8317c 100644 --- a/translations/pt-BR/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md +++ b/translations/pt-BR/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md @@ -14,7 +14,9 @@ redirect_from: ## Overview -Prebuilding your codespaces allows you to be more productive and access your codespace faster, particularly if your repository is large or complex and new codespaces currently take more than 2 minutes to start. This is because any source code, editor extensions, project dependencies, commands, and configurations have already been downloaded, installed, and applied before you create a codespace for your project. Think of a prebuild as a "ready-to-go" template for a codespace. +{% 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. 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. @@ -28,16 +30,10 @@ To create a prebuild you set up a prebuild configuration. When you save the conf 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. +As with other Actions workflows, running a prebuild configuration workflow will either consume some of the Actions minutes included with your account, if you have any, or it will incur charges for 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)." + 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. -## About billing for {% data variables.product.prodname_codespaces %} prebuilds - -{% data reusables.codespaces.billing-for-prebuilds-default %} For details of {% data variables.product.prodname_github_codespaces %} storage pricing, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." - -{% data reusables.codespaces.billing-for-prebuilds-reducing %} - -Use of codespaces created using prebuilds is charged at the same rate as regular codespaces. - ## 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 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. diff --git a/translations/pt-BR/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md b/translations/pt-BR/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md index 9c44b43045..5f8d82217a 100644 --- a/translations/pt-BR/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md +++ b/translations/pt-BR/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md @@ -61,7 +61,7 @@ Before you can configure prebuilds for your project the following must be true: {% note %} **Notes**: - * The prebuild for each region will incur individual charges. You should, therefore, only enable prebuilds for regions in which you know they'll be used. For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds#about-billing-for-codespaces-prebuilds)." + * The prebuild for each region will incur individual charges. You should, therefore, only enable prebuilds for regions in which you know they'll be used. 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)." * Developers can set their default region for {% data variables.product.prodname_github_codespaces %}, which can allow you to enable prebuilds for fewer regions. For more information, see "[Setting your default region for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)." {% endnote %} diff --git a/translations/pt-BR/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md b/translations/pt-BR/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md index 8cceb7d96b..7898abc4e9 100644 --- a/translations/pt-BR/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md +++ b/translations/pt-BR/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md @@ -1,6 +1,6 @@ --- -title: URLs e referências autovinculadas -intro: 'As referências a URLs, problemas, pull requests e commits são automaticamente reduzidas e convertidas em links.' +title: Autolinked references and URLs +intro: 'References to URLs, issues, pull requests, and commits are automatically shortened and converted into links.' redirect_from: - /articles/autolinked-references-and-urls - /github/writing-on-github/autolinked-references-and-urls @@ -11,68 +11,68 @@ versions: ghae: '*' ghec: '*' shortTitle: Auto linked references -ms.openlocfilehash: 6f6548dbe931a7a6adb809aa4e5616db4358c242 -ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/11/2022 -ms.locfileid: '147419686' --- ## URLs -O {% data variables.product.product_name %} cria links automaticamente de URLs padrão. +{% data variables.product.product_name %} automatically creates links from standard URLs. `Visit https://github.com` - + -Para obter mais informações sobre a criação de links, confira "[Sintaxe básica de escrita e formatação](/articles/basic-writing-and-formatting-syntax/#links)". +For more information on creating links, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax/#links)." -## Problemas e pull requests +## Issues and pull requests -Nas conversas do {% data variables.product.product_name %}, as referências a problemas e pull request são convertidas automaticamente em links curtos. +Within conversations on {% data variables.product.product_name %}, references to issues and pull requests are automatically converted to shortened links. {% note %} -**Observação:** as referências vinculadas automaticamente não são criadas em wikis nem arquivos em um repositório. +**Note:** Autolinked references are not created in wikis or files in a repository. {% endnote %} -| Tipo de referência | Referência bruta | Link curto | +| Reference type | Raw reference | Short link | | --- | --- | --- | -| URL do problema ou da solicitação de pull | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) -| `#` e o número do problema ou da solicitação de pull | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `GH-` e o número do problema ou da solicitação de pull | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) | -| `Username/Repository#` e o número do problema ou da solicitação de pull | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26) -| `Organization_name/Repository#` e o número do problema ou da solicitação de pull | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039) +| Issue or pull request URL | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) +| `#` and issue or pull request number | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | +| `GH-` and issue or pull request number | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) | +| `Username/Repository#` and issue or pull request number | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26) +| `Organization_name/Repository#` and issue or pull request number | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039) -{% ifversion fpt or ghec %} Se você fizer referência a um problema, pull request ou discussão em uma lista, a referência irá desenrolar-se para mostrar o título e o estado. Para obter mais informações sobre listas de tarefas, confira "[Sobre as listas de tarefas](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)". +{% ifversion fpt or ghec %} +If you reference an issue, pull request, or discussion in a list, the reference will unfurl to show the title and state instead. For more information about task lists, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)." {% endif %} -## Rótulos -Ao referenciar a URL de uma etiqueta em Markdown, a etiqueta é renderizada automaticamente. Somente as etiquetas do mesmo repositório são renderizadas, as URLs que apontam para uma etiqueta de um repositório diferente são renderizadas como qualquer [URL](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#urls). +## Labels +When referencing the URL of a label in Markdown, the label is automatically rendered. Only labels of the same repository are rendered, URLs pointing to a label from a different repository are rendered as any [URL](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#urls). -Para encontrar a URL de uma etiqueta, navegue até a página de etiquetas e clique em uma etiqueta. Por exemplo, a URL da etiqueta "melhoria" em nosso [repositório de documentos](https://github.com/github/docs/) públicos é +The URL of a label can be found by navigating to the labels page and clicking on a label. For example, the URL of the label "enhancement" in our public [docs repository](https://github.com/github/docs/) is ```md https://github.com/github/docs/labels/enhancement ``` +{% note %} -## SHAs de commit +**Note:** If the label name contains a period (`.`), the label will not automatically render from the label URL. -As referências em um hash SHA de commit são convertidas automaticamente em links curtos para o commit no {% data variables.product.product_name %}. +{% endnote %} -| Tipo de referência | Referência bruta | Link curto | +## Commit SHAs + +References to a commit's SHA hash are automatically converted into shortened links to the commit on {% data variables.product.product_name %}. + +| Reference type | Raw reference | Short link | | --- | --- | --- | -| URL da confirmação | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | +| Commit URL | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | `Username/Repository@SHA` | `jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e` | [`jlord/sheetsee.js@a5c3785`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -## Links automáticos personalizados para recursos externos +## Custom autolinks to external resources {% data reusables.repositories.autolink-references %} -## Leitura adicional +## Further reading -- "[Sintaxe básica de escrita e formatação](/articles/basic-writing-and-formatting-syntax)" +- "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/pt-BR/content/packages/learn-github-packages/about-permissions-for-github-packages.md b/translations/pt-BR/content/packages/learn-github-packages/about-permissions-for-github-packages.md index 18235d4ef4..68dd781bd9 100644 --- a/translations/pt-BR/content/packages/learn-github-packages/about-permissions-for-github-packages.md +++ b/translations/pt-BR/content/packages/learn-github-packages/about-permissions-for-github-packages.md @@ -26,14 +26,14 @@ The {% data variables.product.prodname_registry %} registries below **only** use - Apache Maven registry - NuGet registry -{% ifversion packages-npm-v2 %}For {% data variables.product.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} +{% ifversion packages-npm-v2 %}For {% data variables.packages.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} {% ifversion fpt or ghec %} ## Granular permissions for user/organization-scoped packages Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of the package separately from a repository that is connected (or linked) to a package. -Currently, the {% data variables.product.prodname_ghcr_and_npm_registry %} offer granular permissions for your container image packages. +Currently, the {% data variables.packages.prodname_ghcr_and_npm_registry %} offer granular permissions for your container image packages. ## Visibility and access permissions for container images diff --git a/translations/pt-BR/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md b/translations/pt-BR/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md index 536a07b00e..3e7204200c 100644 --- a/translations/pt-BR/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md +++ b/translations/pt-BR/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md @@ -15,7 +15,7 @@ shortTitle: Access control & visibility Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of a package separately from the repository that it is connected (or linked) to. -Currently, you can only use granular permissions with the {% data variables.product.prodname_ghcr_and_npm_registry %}. Granular permissions are not supported in our other package registries, such as the RubyGems registry.{% ifversion docker-ghcr-enterprise-migration %} For more information about migration to the {% data variables.product.prodname_container_registry %}, see "[Migrating to the {% data variables.product.prodname_container_registry %} from the Docker registry](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)."{% endif %} +Currently, you can only use granular permissions with the {% data variables.packages.prodname_ghcr_and_npm_registry %}. Granular permissions are not supported in our other package registries, such as the RubyGems registry.{% ifversion docker-ghcr-enterprise-migration %} For more information about migration to the {% data variables.product.prodname_container_registry %}, see "[Migrating to the {% data variables.product.prodname_container_registry %} from the Docker registry](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)."{% endif %} For more information about permissions for repository-scoped packages, packages-related scopes for PATs, or managing permissions for your actions workflows, see "[About permissions for GitHub Packages](/packages/learn-github-packages/about-permissions-for-github-packages)." @@ -105,7 +105,7 @@ To further customize access to your container image, see "[Configuring access to {% ifversion fpt or ghec %} ## Ensuring {% data variables.product.prodname_github_codespaces %} access to your package -By default, a codespace can seamlessly access certain packages in the {% data variables.product.prodname_ghcr_and_npm_registry %}, such as those published in the same repository with the **Inherit access** option selected. For more information on which access is automatically configured, see "[Allowing your codespace to access a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry#accessing-images-stored-in-container-registry-and-npm-registry)." +By default, a codespace can seamlessly access certain packages in the {% data variables.packages.prodname_ghcr_and_npm_registry %}, such as those published in the same repository with the **Inherit access** option selected. For more information on which access is automatically configured, see "[Allowing your codespace to access a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry#accessing-images-stored-in-container-registry-and-npm-registry)." Otherwise, to ensure that a codespace has access to your package, you must grant access to the repository where the codespace is being launched. diff --git a/translations/pt-BR/content/packages/learn-github-packages/deleting-and-restoring-a-package.md b/translations/pt-BR/content/packages/learn-github-packages/deleting-and-restoring-a-package.md index 456eca2565..f3595a34ff 100644 --- a/translations/pt-BR/content/packages/learn-github-packages/deleting-and-restoring-a-package.md +++ b/translations/pt-BR/content/packages/learn-github-packages/deleting-and-restoring-a-package.md @@ -62,7 +62,7 @@ The {% data variables.product.prodname_registry %} registries below **only** use - Apache Maven registry - NuGet registry -{% ifversion packages-npm-v2 %}For {% data variables.product.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} +{% ifversion packages-npm-v2 %}For {% data variables.packages.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} {% ifversion fpt or ghec %} diff --git a/translations/pt-BR/content/packages/learn-github-packages/introduction-to-github-packages.md b/translations/pt-BR/content/packages/learn-github-packages/introduction-to-github-packages.md index 9e90094b83..530f6d7efe 100644 --- a/translations/pt-BR/content/packages/learn-github-packages/introduction-to-github-packages.md +++ b/translations/pt-BR/content/packages/learn-github-packages/introduction-to-github-packages.md @@ -1,6 +1,6 @@ --- -title: Introdução ao GitHub Packages -intro: 'O {% data variables.product.prodname_registry %} é um serviço de hospedagem de pacotes de software que permite que você hospede pacotes de software de modo privado{% ifversion ghae %} para usuários especificados ou internamente para a empresa{% else %}ou publicamente{% endif %} e use os pacotes como dependências dos projetos.' +title: Introduction to GitHub Packages +intro: '{% data variables.product.prodname_registry %} is a software package hosting service that allows you to host your software packages privately {% ifversion ghae %} for specified users or internally for your enterprise{% else %}or publicly{% endif %} and use packages as dependencies in your projects.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /articles/about-github-package-registry @@ -16,118 +16,122 @@ versions: ghae: '*' ghec: '*' shortTitle: Introduction -ms.openlocfilehash: a141c93378f836eebf5ff33b0ced482409d6e577 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/09/2022 -ms.locfileid: '147704944' --- -{% data reusables.package_registry.packages-ghes-release-stage %} {% data reusables.package_registry.packages-ghae-release-stage %} -## Sobre o {% data variables.product.prodname_registry %} +{% data reusables.package_registry.packages-ghes-release-stage %} +{% data reusables.package_registry.packages-ghae-release-stage %} -{% data variables.product.prodname_registry %} é uma plataforma para hospedar e gerenciar pacotes, incluindo contêineres e outras dependências. {% data variables.product.prodname_registry %} combina seu código-fonte e pacotes em um só lugar para fornecer gerenciamento integrado de permissões{% ifversion fpt or ghec %} e faturamento{% endif %}, para que você possa centralizar o desenvolvimento do seu software em {% data variables.product.product_name %}. +## About {% data variables.product.prodname_registry %} -Você pode integrar {% data variables.product.prodname_registry %} às APIs de {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %}, {% data variables.product.prodname_actions %} e webhooks para criar um fluxo de trabalho de ponta a ponta que inclui seu código, CI e soluções de implantação. +{% data variables.product.prodname_registry %} is a platform for hosting and managing packages, including containers and other dependencies. {% data variables.product.prodname_registry %} combines your source code and packages in one place to provide integrated permissions management{% ifversion fpt or ghec %} and billing{% endif %}, so you can centralize your software development on {% data variables.product.product_name %}. -{% data variables.product.prodname_registry %} oferece registros de pacotes diferentes para gerentes de pacotes comumente usados, como npm, RubyGems, Apache Maven, Gradle, Docker e NuGet. {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_container_registry %} é otimizado para contêineres e é compatível com imagens do Docker e OCI.{% endif %} Para obter mais informações sobre os diferentes registros de pacotes com os quais {% data variables.product.prodname_registry %} tem suporte, confira "[Trabalhar com um registro {% data variables.product.prodname_registry %}](/packages/working-with-a-github-packages-registry)". +You can integrate {% data variables.product.prodname_registry %} with {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} APIs, {% data variables.product.prodname_actions %}, and webhooks to create an end-to-end DevOps workflow that includes your code, CI, and deployment solutions. + +{% data variables.product.prodname_registry %} offers different package registries for commonly used package managers, such as npm, RubyGems, Apache Maven, Gradle, Docker, and NuGet. {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_container_registry %} is optimized for containers and supports Docker and OCI images.{% endif %} For more information on the different package registries that {% data variables.product.prodname_registry %} supports, see "[Working with a {% data variables.product.prodname_registry %} registry](/packages/working-with-a-github-packages-registry)." {% ifversion fpt or ghec %} - + {% else %} - + {% endif %} -Você pode visualizar o LEIAME de um pacote, bem como os metadados como licenciamento, estatísticas de download, histórico de versão e muito mais em {% data variables.product.product_name %}. Para obter mais informações, confira "[Como ver pacotes](/packages/manage-packages/viewing-packages)". +You can view a package's README, as well as metadata such as licensing, download statistics, version history, and more on {% data variables.product.product_name %}. For more information, see "[Viewing packages](/packages/manage-packages/viewing-packages)." {% ifversion ghes %} -Para obter mais informações sobre a configuração do {% data variables.product.prodname_registry %} no {% data variables.product.product_name %}, confira "[Introdução ao {% data variables.product.prodname_registry %} para sua empresa](/admin/packages/getting-started-with-github-packages-for-your-enterprise)". +For more information about the configuration of {% data variables.product.prodname_registry %} on {% data variables.product.product_name %}, see "[Getting started with {% data variables.product.prodname_registry %} for your enterprise](/admin/packages/getting-started-with-github-packages-for-your-enterprise)." {% endif %} -### Visão geral das permissões e visibilidade do pacote +### Overview of package permissions and visibility | | | |--------------------|--------------------| -| Permissões | {% ifversion fpt or ghec %}As permissões para um pacote são herdadas do repositório em que o pacote está hospedado ou, para pacotes em {% data variables.product.prodname_ghcr_and_npm_registry %}, eles podem ser definidos para contas específicas de usuário ou organização. Para obter mais informações, confira "[Como configurar o controle de acesso e a visibilidade de um pacote](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)". {% else %}Cada pacote herda as permissões do repositório em que o pacote está hospedado.| -{% raw %} ```yaml +{% raw %} +```yaml on: push: branches: ['release'] @@ -179,7 +177,7 @@ on: {% endraw %} |
-Configura o fluxo de trabalho Create and publish a Docker image para que ele seja executado sempre que uma alteração é enviada por push ao branch chamado release.
+ Configures the Create and publish a Docker image workflow to run every time a change is pushed to the branch called release.
|
- Define duas variáveis de ambiente personalizadas para o fluxo de trabalho. Estes são usados para o domínio de {% data variables.product.prodname_container_registry %} e um nome para a imagem Docker que esta fluxo de trabalho cria. + Defines two custom environment variables for the workflow. These are used for the {% data variables.product.prodname_container_registry %} domain, and a name for the Docker image that this workflow builds. | @@ -211,7 +209,7 @@ jobs: {% endraw %}- Há um único trabalho neste fluxo de trabalho. Ele está configurado para ser executado na última versão disponível do Ubuntu. + There is a single job in this workflow. It's configured to run on the latest available version of Ubuntu. | @@ -237,7 +235,7 @@ run-npm-build:- Este trabalho instala o NPM e o usa para criar o aplicativo. + This job installs NPM and uses it to build the app. | @@ -272,13 +270,14 @@ run-npm-test:
-Ele usa o npm test para testar o código. O comando needs: run-npm-build torna esse trabalho dependente do trabalho run-npm-build.
+ This job uses npm test to test the code. The needs: run-npm-build command makes this job dependent on the run-npm-build job.
|
| -{% raw %} ```yaml +{% raw %} +```yaml build-and-push-image: runs-on: ubuntu-latest needs: run-npm-test @@ -286,7 +285,7 @@ build-and-push-image: {% endraw %} |
-Este trabalho publica o pacote. O comando needs: run-npm-test torna esse trabalho dependente do trabalho run-npm-test.
+ This job publishes the package. The needs: run-npm-test command makes this job dependent on the run-npm-test job.
|
| -{% raw %} ```yaml +{% raw %} +```yaml permissions: contents: read packages: write @@ -302,14 +302,15 @@ permissions: {% endraw %} |
-Define as permissões concedidas ao GITHUB_TOKEN para as ações nesse trabalho.
+ Sets the permissions granted to the GITHUB_TOKEN for the actions in this job.
|
-{% raw %} ```yaml
+{% raw %}
+```yaml
- name: Log in to the Container registry
uses: docker/login-action@f054a8b539a109f9f41c372932f1ae047eff08c9
with:
@@ -320,13 +321,14 @@ Define as permissões concedidas ao GITHUB_TOKEN para as ações ne
{% endraw %}
|
-Cria uma etapa chamada Log in to the {% data variables.product.prodname_container_registry %}, que faz logon no registro usando a conta e a senha que publicarão os pacotes. Uma vez publicados, os pacotes pertencem à conta definida aqui.
+ Creates a step called Log in to the {% data variables.product.prodname_container_registry %}, which logs in to the registry using the account and password that will publish the packages. Once published, the packages are owned by the account defined here.
|
-{% raw %} ```yaml
+{% raw %}
+```yaml
- name: Extract metadata (tags, labels) for Docker
id: meta
uses: docker/metadata-action@98669ae865ea3cffbcbaa878cf57c20bbf1c6c38
@@ -336,14 +338,15 @@ Cria uma etapa chamada Log in to the {% data variables.product.prodname_co
{% endraw %}
|
-Esta etapa usa docker/metadata-action para extrair marcas e rótulos que serão aplicados à imagem especificada. A id "meta" permite que a saída desta etapa seja referenciada em uma etapa seguinte. O valor images fornece o nome base para as marcas e os rótulos.
+ This step uses docker/metadata-action to extract tags and labels that will be applied to the specified image. The id "meta" allows the output of this step to be referenced in a subsequent step. The images value provides the base name for the tags and labels.
|
-{% raw %} ```yaml
+{% raw %}
+```yaml
- name: Log in to GitHub Docker Registry
uses: docker/login-action@f054a8b539a109f9f41c372932f1ae047eff08c9
with:
@@ -354,70 +357,75 @@ Esta etapa usa d
{% endraw %}
|
-Cria uma etapa chamada Log in to GitHub Docker Registry, que faz logon no registro usando a conta e a senha que publicará os pacotes. Uma vez publicados, os pacotes pertencem à conta definida aqui.
+ Creates a new step called Log in to GitHub Docker Registry, which logs in to the registry using the account and password that will publish the packages. Once published, the packages are owned by the account defined here.
|
| -{% raw %} ```yaml +{% raw %} +```yaml - name: Build and push Docker image ``` {% endraw %} |
-Cria uma etapa chamada Build and push Docker image. Essa etapa é executada como parte do trabalho build-and-push-image.
+ Creates a new step called Build and push Docker image. This step runs as part of the build-and-push-image job.
|
| -{% raw %} ```yaml +{% raw %} +```yaml uses: docker/build-push-action@ad44023a93711e3deb337508980b4b5e9bcdc5dc ``` {% endraw %} |
-Usa a ação build-push-action do Docker para compilar a imagem, com base no Dockerfile do repositório. Se a criação for bem-sucedida, ela faz p push da imagem para {% data variables.product.prodname_registry %}.
+ Uses the Docker build-push-action action to build the image, based on your repository's Dockerfile. If the build succeeds, it pushes the image to {% data variables.product.prodname_registry %}.
|
| -{% raw %} ```yaml +{% raw %} +```yaml with: ``` {% endraw %} |
-Envia os parâmetros obrigatórios para a ação build-push-action. Estas são definidas nas linhas subsequentes.
+ Sends the required parameters to the build-push-action action. These are defined in the subsequent lines.
|
| -{% raw %} ```yaml +{% raw %} +```yaml context: . ``` {% endraw %} | -Define o contexto da criação como o conjunto de arquivos localizados no caminho especificado. Para obter mais informações, confira "Uso". + Defines the build's context as the set of files located in the specified path. For more information, see "Usage." |
| -{% raw %} ```yaml +{% raw %} +```yaml push: true ``` {% endraw %} | -Faz push desta imagem para o registro se for construída com sucesso. + Pushes this image to the registry if it is built successfully. | - Adiciona as tags e etiquetas extraídos na etapa "meta". + Adds the tags and labels extracted in the "meta" step. | {% else %}
| -{% ifversion ghae %} {% raw %} ```yaml +{% ifversion ghae %} +{% raw %} +```yaml tags: | docker.YOUR-HOSTNAME.com/${{ github.repository }}/octo-image:${{ github.sha }} ``` -{% endraw %} {% else %} {% raw %} ```yaml +{% endraw %} +{% else %} +{% raw %} +```yaml tags: | docker.pkg.github.com/${{ github.repository }}/octo-image:${{ github.sha }} ``` -{% endraw %} {% endif %} +{% endraw %} +{% endif %} | -Marca a imagem com o SHA do commit que acionou o fluxo de trabalho. + Tags the image with the SHA of the commit that triggered the workflow. |

(1) O Acordo sobre a Área Econômica Europeia (Acordo da EEA) prevê a extensão do mercado interno da União Europeia aos três Estados da EEA: Islândia, Listenstaine e Noruega. A legislação da União para proteção de dados, incluindo o Regulamento (UE) 2016/679, é coberta pelo Acordo da EEA e foi incorporada no Adendo XI. Portanto, qualquer divulgação pelo importador de dados a um terceiro localizado na EEA não se qualifica como uma transferência posterior para os fins destas Cláusulas.
- -(2) Este requisito pode ser atendido pelo subprocessador aderente a estas Cláusulas sob o Módulo apropriado, de acordo com a Cláusula 7.
- -(3) No que diz respeito ao impacto de tais leis e práticas no cumprimento destas Cláusulas, diversos elementos podem ser considerados como parte de uma avaliação global. Esses elementos podem incluir experiência prática relevante e documentada com instâncias anteriores de solicitações de divulgação de autoridades públicas, ou a ausência de tais solicitações, abrangendo um período de tempo suficientemente representativo. Isso se refere especialmente a registros internos ou outra documentação, elaborados de forma contínua de acordo com a devida diligência e certificados em nível de gerência sênior, desde que essas informações possam ser legalmente compartilhadas com terceiros. Quando essa experiência prática for considerada para concluir que o importador de dados não será impedido de cumprir estas Cláusulas, ela precisará ser embasada por outros elementos objetivos e relevantes, e cabe às Partes considerar cuidadosamente se esses elementos juntos envolvem peso, em termos de confiabilidade e representatividade, para sustentar esta conclusão. Em particular, as Partes devem levar em consideração se sua experiência prática é corroborada e não contrariada por informações confiáveis publicamente disponíveis ou acessíveis de outra forma sobre a existência ou ausência de solicitações dentro do mesmo setor e/ou a aplicação da lei na prática, como jurisprudência e relatórios de órgãos de supervisão independentes.
diff --git a/translations/pt-BR/content/site-policy/privacy-policies/index.md b/translations/pt-BR/content/site-policy/privacy-policies/index.md index 17769b6773..747b739767 100644 --- a/translations/pt-BR/content/site-policy/privacy-policies/index.md +++ b/translations/pt-BR/content/site-policy/privacy-policies/index.md @@ -8,7 +8,6 @@ topics: children: - /github-privacy-statement - /global-privacy-practices - - /github-data-protection-agreement - /github-subprocessors-and-cookies - /github-codespaces-privacy-statement - /github-candidate-privacy-policy diff --git a/translations/pt-BR/data/reusables/codespaces/billing-for-prebuilds-default.md b/translations/pt-BR/data/reusables/codespaces/billing-for-prebuilds-default.md deleted file mode 100644 index f7e5e8c5bb..0000000000 --- a/translations/pt-BR/data/reusables/codespaces/billing-for-prebuilds-default.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -ms.openlocfilehash: 0036dd5cf979531479a7ddf523c7475391b29c0a -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147548005" ---- -Por padrão, um fluxo de trabalho do {% data variables.product.prodname_actions %} é acionado sempre que você cria ou atualiza uma pré-compilação ou envia por push para um branch habilitado para pré-compilação. Assim como acontece com outros fluxos de trabalho, enquanto os fluxos de trabalho de pré-build estiverem em execução, eles consumirão alguns dos minutos do Actions incluídos na sua conta, se houver, ou vão gerar custos de minutos no Actions. Para obter mais informações sobre os preços de minutos do Actions, confira "[Sobre a cobrança do {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)". - -Juntamente com os minutos do {% data variables.product.prodname_actions %}, também serão incorridas cobranças pelo armazenamento de pré-compilações associadas a cada configuração de pré-compilação para um determinado repositório e região. O armazenamento de pré-compilações é cobrado na mesma taxa que o armazenamento de codespaces. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/codespaces/billing-for-prebuilds-reducing.md b/translations/pt-BR/data/reusables/codespaces/billing-for-prebuilds-reducing.md deleted file mode 100644 index 03f82b7b20..0000000000 --- a/translations/pt-BR/data/reusables/codespaces/billing-for-prebuilds-reducing.md +++ /dev/null @@ -1,3 +0,0 @@ -To reduce consumption of Actions minutes, you can set a prebuild to be updated only when you make a change to your dev container configuration files, or only on a custom schedule. You can also manage your storage usage by adjusting the number of template versions to be retained for your prebuild configurations. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." - -If you are an organization or enterprise owner, you can track usage of prebuild workflows and storage by downloading a {% data variables.product.prodname_actions %} usage report for your organization or enterprise. You can identify workflow runs for prebuilds by filtering the CSV output to only include the workflow called "Create {% data variables.product.prodname_github_codespaces %} Prebuilds." For more information, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage#viewing-github-actions-usage-for-your-organization)." diff --git a/translations/pt-BR/data/reusables/codespaces/codespaces-billing.md b/translations/pt-BR/data/reusables/codespaces/codespaces-billing.md deleted file mode 100644 index 245b70707d..0000000000 --- a/translations/pt-BR/data/reusables/codespaces/codespaces-billing.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -ms.openlocfilehash: 845c770a8a03c57a4c10a84d28fd4d3d78282042 -ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147111119" ---- -Os {% data variables.product.prodname_codespaces %} são cobrados em USD (dólares americanos) de acordo com o uso de computação e armazenamento. - -### Como calcular o uso de computação -O uso de computação é definido como o número total de minutos de tempo de atividade durante os quais uma instância do {% data variables.product.prodname_github_codespaces %} está ativa. Ele é calculado somando o número real de minutos usados por todos os codespaces. Esses totais são relatados ao serviço de cobrança diariamente e são cobrados mensalmente. - -O tempo de atividade é controlado pela interrupção do seu codespace, o que pode ser feito manual ou automaticamente após um período de inatividade especificado pelo desenvolvedor. Para obter mais informações, confira "[Como fechar ou interromper seu codespace](/codespaces/getting-started/deep-dive#closing-or-stopping-your-codespace)". - -### Como calcular o uso do armazenamento -Para fins de cobrança do {% data variables.product.prodname_github_codespaces %}, isso inclui todo o armazenamento usado por todos os codespaces na sua conta. Isso inclui todos os arquivos usados pelos codespaces, como repositórios clonados, arquivos de configuração e extensões, entre outros. Esses totais são relatados ao serviço de cobrança diariamente e são cobrados mensalmente. No final do mês, {% data variables.product.prodname_dotcom %} arredonda seu armazenamento para o MB mais próximo. diff --git a/translations/pt-BR/data/reusables/codespaces/codespaces-spending-limit-requirement.md b/translations/pt-BR/data/reusables/codespaces/codespaces-spending-limit-requirement.md index e32b29f3f4..1322dfe4ae 100644 --- a/translations/pt-BR/data/reusables/codespaces/codespaces-spending-limit-requirement.md +++ b/translations/pt-BR/data/reusables/codespaces/codespaces-spending-limit-requirement.md @@ -5,5 +5,3 @@ {% endnote %} By default, your organization or enterprise will have a {% data variables.product.prodname_github_codespaces %} spending limit of $0. This prevents new codespaces from being created, or existing codespaces from being opened, if this would incur a billable cost to your organization or enterprise. To allow your users to create codespaces in your organization, set the limit to a value higher than $0. - -{% data reusables.billing.overages-billed-monthly %} diff --git a/translations/pt-BR/data/reusables/codespaces/creating-a-codespace-in-vscode.md b/translations/pt-BR/data/reusables/codespaces/creating-a-codespace-in-vscode.md index c89126ae76..545324000c 100644 --- a/translations/pt-BR/data/reusables/codespaces/creating-a-codespace-in-vscode.md +++ b/translations/pt-BR/data/reusables/codespaces/creating-a-codespace-in-vscode.md @@ -1,11 +1,5 @@ After you connect your account on {% data variables.product.product_location %} 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 %} marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). -{% note %} - -**Note**: Currently, {% data variables.product.prodname_vscode_shortname %} doesn't allow you to choose a dev container configuration when you create a codespace. If you want to choose a specific dev container configuration, use the {% data variables.product.prodname_dotcom %} web interface to create your codespace. For more information, click the **Web browser** tab at the top of this page. - -{% endnote %} - {% data reusables.codespaces.click-remote-explorer-icon-vscode %} 2. Click the Add icon: {% octicon "plus" aria-label="The plus icon" %}. diff --git a/translations/pt-BR/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md b/translations/pt-BR/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md deleted file mode 100644 index cfc3a02446..0000000000 --- a/translations/pt-BR/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -ms.openlocfilehash: 86ebb6e0ab13cf7daf5fb580792bf8f4606eb054 -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147881913" ---- -Para estimar os custos dos serviços de consumo, use a [calculadora de preços](https://github.com/pricing/calculator?feature=codespaces) do {% data variables.product.prodname_dotcom %}. diff --git a/translations/zh-CN/content/actions/using-workflows/workflow-commands-for-github-actions.md b/translations/zh-CN/content/actions/using-workflows/workflow-commands-for-github-actions.md index 5a6de2d67d..60e836a70a 100644 --- a/translations/zh-CN/content/actions/using-workflows/workflow-commands-for-github-actions.md +++ b/translations/zh-CN/content/actions/using-workflows/workflow-commands-for-github-actions.md @@ -169,6 +169,8 @@ Sets an action's output parameter. Optionally, you can also declare output parameters in an action's metadata file. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs-for-docker-container-and-javascript-actions)." +You can escape multiline strings for setting an output parameter by creating an environment variable and using it in a workflow command. For more information, see "[Setting an environment variable](#setting-an-environment-variable)." + ### Example: Setting an output parameter {% bash %} diff --git a/translations/zh-CN/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md b/translations/zh-CN/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md index 8010b7d3e1..82d3255404 100644 --- a/translations/zh-CN/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md +++ b/translations/zh-CN/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md @@ -1,5 +1,5 @@ --- -title: 在设备上配置备份 +title: Configuring backups on your appliance shortTitle: Configuring backups redirect_from: - /enterprise/admin/categories/backups-and-restores @@ -14,7 +14,7 @@ redirect_from: - /enterprise/admin/installation/configuring-backups-on-your-appliance - /enterprise/admin/configuration/configuring-backups-on-your-appliance - /admin/configuration/configuring-backups-on-your-appliance -intro: '作为灾难恢复计划的一部分,你可以通过配置自动备份的方式保护 {% data variables.product.product_location %} 中的生产数据。' +intro: 'As part of a disaster recovery plan, you can protect production data on {% data variables.product.product_location %} by configuring automated backups.' versions: ghes: '*' type: how_to @@ -23,162 +23,158 @@ topics: - Enterprise - Fundamentals - Infrastructure -ms.openlocfilehash: 4403ec24aa3da63f6700ae4bfcd2392ec0cfd194 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: zh-CN -ms.lasthandoff: 09/09/2022 -ms.locfileid: '147861650' --- -## 关于 {% data variables.product.prodname_enterprise_backup_utilities %} +## About {% data variables.product.prodname_enterprise_backup_utilities %} -{% data variables.product.prodname_enterprise_backup_utilities %} 是安装在单独主机上的备份系统,它通过安全的 SSH 网络连接定期对 {% data variables.product.product_location %} 进行备份快照。 您可以使用快照将现有的 {% data variables.product.prodname_ghe_server %} 实例从备份主机还原为上一个状态。 +{% data variables.product.prodname_enterprise_backup_utilities %} is a backup system you install on a separate host, which takes backup snapshots of {% data variables.product.product_location %} at regular intervals over a secure SSH network connection. You can use a snapshot to restore an existing {% data variables.product.prodname_ghe_server %} instance to a previous state from the backup host. -只有自上一个快照之后添加的数据将通过网络传输并占用额外的物理存储空间。 要最大限度地减小对性能的影响,会以最低 CPU/IO 优先级在线执行备份。 您不需要排定维护窗口来执行备份。 +Only data added since the last snapshot will transfer over the network and occupy additional physical storage space. To minimize performance impact, backups are performed online under the lowest CPU/IO priority. You do not need to schedule a maintenance window to perform a backup. -{% data variables.product.prodname_enterprise_backup_utilities %} 的主要版本和版本号与 {% data variables.product.product_name %} 的功能版一致。 我们支持这两种产品的四个最新版本。 有关详细信息,请参阅“[{% data variables.product.product_name %} 版本](/admin/all-releases)”。 +Major releases and version numbers for {% data variables.product.prodname_enterprise_backup_utilities %} align with feature releases of {% data variables.product.product_name %}. We support the four most recent versions of both products. For more information, see "[{% data variables.product.product_name %} releases](/admin/all-releases)." -有关功能、要求和高级使用情况的更多详细信息,请参阅 {% data variables.product.prodname_enterprise_backup_utilities %} 项目文档中的 [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme)。 +For more detailed information on features, requirements, and advanced usage, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## 先决条件 +## Prerequisites -若要使用 {% data variables.product.prodname_enterprise_backup_utilities %},必须将 Linux 或 Unix 主机系统与 {% data variables.product.product_location %} 分开。 +To use {% data variables.product.prodname_enterprise_backup_utilities %}, you must have a Linux or Unix host system separate from {% data variables.product.product_location %}. -您还可以将 {% data variables.product.prodname_enterprise_backup_utilities %} 集成到现有环境中,以便长期、永久地存储重要数据。 +You can also integrate {% data variables.product.prodname_enterprise_backup_utilities %} into an existing environment for long-term permanent storage of critical data. -建议将备份主机和 {% data variables.product.product_location %} 放置在相距较远的地理位置。 这样可以确保在主要站点发生重大事故或网络故障的情况下通过备份进行还原。 +We recommend that the backup host and {% data variables.product.product_location %} be geographically distant from each other. This ensures that backups are available for recovery in the event of a major disaster or network outage at the primary site. -物理存储要求将因 Git 仓库磁盘使用情况以及预计的增长情况而异: +Physical storage requirements will vary based on Git repository disk usage and expected growth patterns: -| 硬件 | 建议 | +| Hardware | Recommendation | | -------- | --------- | -| **vCPU** | 2 | -| **内存** | 2 GB | -| **存储** | 等于为主要实例分配的存储空间的五倍 | +| **vCPUs** | 2 | +| **Memory** | 2 GB | +| **Storage** | Five times the primary instance's allocated storage | -根据您的使用情况(例如用户活动和选定的集成),可能需要更多资源。 +More resources may be required depending on your usage, such as user activity and selected integrations. -有关详细信息,请参阅 {% data variables.product.prodname_enterprise_backup_utilities %} 项目文档中的 [{% data variables.product.prodname_enterprise_backup_utilities %} 要求](https://github.com/github/backup-utils/blob/master/docs/requirements.md)。 +For more information, see [{% data variables.product.prodname_enterprise_backup_utilities %} requirements](https://github.com/github/backup-utils/blob/master/docs/requirements.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## 安装 {% data variables.product.prodname_enterprise_backup_utilities %} +## Installing {% data variables.product.prodname_enterprise_backup_utilities %} -若要在备份主机上安装 {% data variables.product.prodname_enterprise_backup_utilities %},建议克隆项目的 Git 存储库。 使用此方法可以直接使用 Git 提取新版本,并且会在安装新版本时保留现有备份配置文件 `backup.config`。 +To install {% data variables.product.prodname_enterprise_backup_utilities %} on your backup host, we recommend cloning the project's Git repository. This approach allows you to fetch new releases directly using Git, and your existing backup configuration file, `backup.config`, will be preserved when installing a new version. -或者,如果主机无法访问 Internet,你可以将每个 {% data variables.product.prodname_enterprise_backup_utilities %} 版本下载为压缩存档,然后解压缩并安装这些内容。 有关详细信息,请参阅 {% data variables.product.prodname_enterprise_backup_utilities %} 项目文档中的[入门指南](https://github.com/github/backup-utils/blob/master/docs/getting-started.md)。 +Alternatively, if the host machine can't access the internet, you can download each {% data variables.product.prodname_enterprise_backup_utilities %} release as a compressed archive, then extract and install the contents. For more information, see [Getting started](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -备份快照会写入通过 `backup.config` 文件中的 `GHE_DATA_DIR` 数据目录变量设置的磁盘路径。 快照需要存储在支持符号链接和硬链接的文件系统上。 +Backup snapshots are written to the disk path set by the `GHE_DATA_DIR` data directory variable in your `backup.config` file. Snapshots need to be stored on a filesystem which supports symbolic and hard links. {% note %} -注意:建议确保快照未保存在 {% data variables.product.prodname_enterprise_backup_utilities %} 安装目录的子目录中,以避免在升级 {% data variables.product.prodname_enterprise_backup_utilities %} 版本时意外覆盖数据目录。 +**Note:** We recommend ensuring your snapshots are not kept in a subdirectory of the {% data variables.product.prodname_enterprise_backup_utilities %} installation directory, to avoid inadvertently overwriting your data directory when upgrading {% data variables.product.prodname_enterprise_backup_utilities %} versions. {% endnote %} -1. 若要将 [{% data variables.product.prodname_enterprise_backup_utilities %} 项目存储库](https://github.com/github/backup-utils/)克隆到备份主机上的本地目录,请运行以下命令。 +1. To clone the [{% data variables.product.prodname_enterprise_backup_utilities %} project repository](https://github.com/github/backup-utils/) to a local directory on your backup host, run the following command. ``` $ git clone https://github.com/github/backup-utils.git /path/to/target/directory/backup-utils ``` -1. 若要更改为本地存储库目录,请运行以下命令。 +1. To change into the local repository directory, run the following command. ``` cd backup-utils ``` {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} -1. 若要将包含的 `backup.config-example` 文件复制到 `backup.config`,请运行以下命令。 +1. To copy the included `backup.config-example` file to `backup.config`, run the following command. ```shell cp backup.config-example backup.config ``` -1. 若要自定义配置,请在文本编辑器中编辑 `backup.config`。 - 1. 将 `GHE_HOSTNAME` 值设置为主要 {% data variables.product.prodname_ghe_server %} 实例的主机名或 IP 地址。 +1. To customize your configuration, edit `backup.config` in a text editor. + 1. Set the `GHE_HOSTNAME` value to your primary {% data variables.product.prodname_ghe_server %} instance's hostname or IP address. {% note %} - 注意:如果使用负载均衡器将 {% data variables.product.product_location %} 部署为群集或部署在高可用性配置中,则 `GHE_HOSTNAME` 可以是负载均衡器主机名,只要它允许对 {% data variables.product.product_location %} 进行 SSH 访问(在端口 122 上)。 + **Note:** If {% data variables.product.product_location %} is deployed as a cluster or in a high availability configuration using a load balancer, the `GHE_HOSTNAME` can be the load balancer hostname, as long as it allows SSH access (on port 122) to {% data variables.product.product_location %}. - 为确保恢复的设备立即可用,即使在异地复制配置中也应针对主实例执行备份。 + To ensure a recovered appliance is immediately available, perform backups targeting the primary instance even in a geo-replication configuration. {% endnote %} - 1. 将 `GHE_DATA_DIR` 值设置为要存储备份快照的文件系统位置。 建议在备份主机所在的同一文件系统上选择一个位置,但在步骤 1 中克隆 Git 存储库的位置除外。 -1. 若要授予备份主机对实例的访问权限,请在 `http(s)://HOSTNAME/setup/settings` 上打开主实例的设置页,并将备份主机的 SSH 密钥添加到授权的 SSH 密钥列表中。 有关详细信息,请参阅“[访问管理 shell (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh#enabling-access-to-the-administrative-shell-via-ssh)”。 -1. 在备份主机上,使用 `ghe-host-check` 命令验证与 {% data variables.product.product_location %} 的 SSH 连接。 + 1. Set the `GHE_DATA_DIR` value to the filesystem location where you want to store backup snapshots. We recommend choosing a location on the same filesystem as your backup host, but outside of where you cloned the Git repository in step 1. +1. To grant your backup host access to your instance, open your primary instance's settings page at `http(s)://HOSTNAME/setup/settings` and add the backup host's SSH key to the list of authorized SSH keys. For more information, see "[Accessing the administrative shell (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh#enabling-access-to-the-administrative-shell-via-ssh)." +1. On your backup host, verify SSH connectivity with {% data variables.product.product_location %} with the `ghe-host-check` command. ```shell ./bin/ghe-host-check - ``` -1. 若要创建初始完整备份,请运行以下命令。 + ``` +1. To create an initial full backup, run the following command. ```shell ./bin/ghe-backup ``` -有关高级使用情况的更多详细信息,请参阅 {% data variables.product.prodname_enterprise_backup_utilities %} 项目文档中的 [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme)。 +For more information on advanced usage, see the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## 升级 {% data variables.product.prodname_enterprise_backup_utilities %} +## Upgrading {% data variables.product.prodname_enterprise_backup_utilities %} -升级 {% data variables.product.prodname_enterprise_backup_utilities %} 时,必须选择适用于当前版本的 {% data variables.product.product_name %} 的版本。 安装的 {% data variables.product.prodname_enterprise_backup_utilities %} 的版本必须至少与 {% data variables.product.product_location %} 的版本相同,并且不能低于两个版本。 有关详细信息,请参阅 {% data variables.product.prodname_enterprise_backup_utilities %} 项目文档中的 [{% data variables.product.prodname_ghe_server %} 要求](https://github.com/github/backup-utils/blob/master/docs/requirements.md#github-enterprise-server-version-requirements)。 -可以通过提取和签出最新更改来升级 Git 存储库中的 {% data variables.product.prodname_enterprise_backup_utilities %}。 +When upgrading {% data variables.product.prodname_enterprise_backup_utilities %}, you must choose a release that will work with your current version of {% data variables.product.product_name %}. Your installation of {% data variables.product.prodname_enterprise_backup_utilities %} must be at least the same version as {% data variables.product.product_location %}, and cannot be more than two versions ahead. For more information, see [{% data variables.product.prodname_ghe_server %} version requirements](https://github.com/github/backup-utils/blob/master/docs/requirements.md#github-enterprise-server-version-requirements) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. +You can upgrade {% data variables.product.prodname_enterprise_backup_utilities %} in a Git repository by fetching and checking out the latest changes. -或者,如果不使用 Git 存储库进行安装,则可以将新存档提取到适当位置,也可以更改方法,改为使用 Git 存储库。 +Alternatively, if you don't use a Git repository for your installation, you can extract a new archive into place, or you can change your approach to use a Git repository instead. -### 验证安装类型 +### Verifying the installation type -可以验证 {% data variables.product.prodname_enterprise_backup_utilities %} 的安装方法,并确定升级安装的最佳方法。 +You can verify the installation method for {% data variables.product.prodname_enterprise_backup_utilities %} and determine the best way to upgrade your installation. {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} -1. 若要检查 Git 存储库中是否存在有效的工作目录,请运行以下命令。 +1. To check if a valid working directory exists inside a Git repository, run the following command. ``` git rev-parse --is-inside-work-tree ``` - 如果输出为 `true`,则已通过克隆项目的 Git 存储库安装 {% data variables.product.prodname_enterprise_backup_utilities %}。 如果输出包含 `fatal: not a git repository (or any of the parent directories)`,则可能已通过提取压缩存储文件安装 {% data variables.product.prodname_enterprise_backup_utilities %}。 -如果在 Git 存储库中进行安装,则可以使用 Git 安装最新版本。 如果从压缩存档文件进行安装,则可以下载并提取最新版本,也可以使用 Git 重新安装 {% data variables.product.prodname_enterprise_backup_utilities %} 以简化未来的升级。 + If the output is `true`, {% data variables.product.prodname_enterprise_backup_utilities %} was installed by cloning the project's Git repository. If the output includes `fatal: not a git repository (or any of the parent directories)`, {% data variables.product.prodname_enterprise_backup_utilities %} was likely installed by extracting a compressed archive file. +If your installation is in a Git repository, you can install the latest version using Git. If the installation is from a compressed archive file, you can either download and extract the latest version, or you can reinstall {% data variables.product.prodname_enterprise_backup_utilities %} using Git to simplify future upgrades. -- [升级 Git 存储库中的安装](#upgrading-an-installation-in-a-git-repository) -- [使用 Git 而不是压缩存档进行升级](#using-git-instead-of-compressed-archives-for-upgrades) +- [Upgrading an installation in a Git repository](#upgrading-an-installation-in-a-git-repository) +- [Using Git instead of compressed archives for upgrades](#using-git-instead-of-compressed-archives-for-upgrades) -### 升级 Git 存储库中的安装 +### Upgrading an installation in a Git repository -{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} {% note %} +{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} + {% note %} - 注意:建议在升级 {% data variables.product.prodname_enterprise_backup_utilities %} 之前在临时位置(如 `$HOME/backup.config`)创建现有 `backup.config` 文件的副本。 + **Note:** We recommend creating a copy of your existing `backup.config` file in a temporary location, like `$HOME/backup.config`, before upgrading {% data variables.product.prodname_enterprise_backup_utilities %}. {% endnote %} -1. 通过运行 `git fetch` 命令下载最新的项目更新。 +1. Download the latest project updates by running the `git fetch` command. ```shell git fetch ``` -{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %} +{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} +{% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %} -### 使用 Git 而不是压缩存档进行升级 +### Using Git instead of compressed archives for upgrades -如果备份主机具有 Internet 连接,并且你之前使用了压缩存档 (`.tar.gz`) 来安装或升级 {% data variables.product.prodname_enterprise_backup_utilities %},建议改用 Git 存储库进行安装。 使用 Git 进行升级需要执行的工作量更少,并可保留备份配置。 +If your backup host has internet connectivity and you previously used a compressed archive (`.tar.gz`) to install or upgrade {% data variables.product.prodname_enterprise_backup_utilities %}, we recommend using a Git repository for your installation instead. Upgrading using Git requires less work and preserves your backup configuration. {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-directory %} -1. 若要备份现有 {% data variables.product.prodname_enterprise_backup_utilities %} 配置,请将当前 `backup.config` 文件复制到安全位置,例如主目录。 +1. To back up your existing {% data variables.product.prodname_enterprise_backup_utilities %} configuration, copy your current `backup.config` file to a safe location, such as your home directory. ``` $ cp backup.config $HOME/backup.config.saved-$(date +%Y%m%d-%H%M%S) ``` -1. 更改为备份主机上要安装 {% data variables.product.prodname_enterprise_backup_utilities %} Git 存储库的本地目录。 -1. 若要将[项目存储库](https://github.com/github/backup-utils/)克隆到备份主机上的目录,请运行以下命令。 +1. Change to the local directory on your backup host where you want to install the {% data variables.product.prodname_enterprise_backup_utilities %} Git repository. +1. To clone the [project repository](https://github.com/github/backup-utils/) to the directory on your backup host, run the following command. ``` git clone https://github.com/github/backup-utils.git ``` -1. 若要更改为克隆的存储库,请运行以下命令。 +1. To change into the cloned repository, run the following command. ``` cd backup-utils ``` {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-update-repo %} -1. 若要还原之前的备份配置,请将现有备份配置文件复制到本地存储库目录。 将命令中的路径替换为步骤 2 中保存的文件的位置。 +1. To restore your backup configuration from earlier, copy your existing backup configuration file to the local repository directory. Replace the path in the command with the location of the file saved in step 2. ``` $ cp PATH/TO/BACKUP/FROM/STEP/2 backup.config @@ -186,44 +182,44 @@ ms.locfileid: '147861650' {% note %} - 注意:可以选择在克隆后将备份配置文件还原到的位置。 有关可放置配置文件的位置的详细信息,请参阅 {% data variables.product.prodname_enterprise_backup_utilities %} 项目文档中的[入门指南](https://github.com/github/backup-utils/blob/master/docs/getting-started.md)。 + **Note:** You can choose where to restore your backup configuration file to after cloning. For more information about where configuration files can be located, see [Getting started](https://github.com/github/backup-utils/blob/master/docs/getting-started.md) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. {% endnote %} -1. 若要确认指向备份配置文件中目录或脚本的路径是否正确,请查看文本编辑器中的文件。 +1. To confirm that the paths to directories or scripts in your backup configuration file are correct, review the file in a text editor. {% data reusables.enterprise_backup_utilities.enterprise-backup-utils-verify-upgrade %} -1. 删除步骤 1 中的旧 GitHub Enterprise Server 备份实用程序目录(压缩存档安装所在的位置)。 +1. Delete your old GitHub Enterprise Server Backup Utilities directory from step 1 (where the compressed archive installation was located). -## 排定备份 +## Scheduling a backup -可以使用 `cron(8)` 命令或类似的命令调度服务在备份主机上调度定期备份。 配置的备份频率将决定您的恢复计划中的最坏情况恢复点目标 (RPO)。 例如,如果您已排定在每天午夜运行备份,则在发生灾难的情况下,可能丢失长达 24 小时的数据。 建议在开始时采用每小时备份日程,从而确保在主要站点数据受到破坏时,最坏情况下最多会丢失一小时的数据。 +You can schedule regular backups on the backup host using the `cron(8)` command or a similar command scheduling service. The configured backup frequency will dictate the worst case recovery point objective (RPO) in your recovery plan. For example, if you have scheduled the backup to run every day at midnight, you could lose up to 24 hours of data in a disaster scenario. We recommend starting with an hourly backup schedule, guaranteeing a worst case maximum of one hour of data loss if the primary site data is destroyed. -如果备份尝试重叠,`ghe-backup` 命令将以错误消息中止,指示存在同时备份。 如果出现这种情况,建议降低已排定的备份的频率。 有关详细信息,请参阅 {% data variables.product.prodname_enterprise_backup_utilities %} 项目文档中的 [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#scheduling-backups) 的“计划备份”部分。 +If backup attempts overlap, the `ghe-backup` command will abort with an error message, indicating the existence of a simultaneous backup. If this occurs, we recommended decreasing the frequency of your scheduled backups. For more information, see the "Scheduling backups" section of the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#scheduling-backups) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. -## 还原备份 +## Restoring a backup -如果主站点发生长时间故障或灾难性事件,则可以通过预配另一台 {% data variables.product.prodname_enterprise %} 设备并从备份主机执行还原 {% data variables.product.product_location %}。 在还原设备之前,您必须将备份主机的 SSH 密钥作为已授权 SSH 密钥添加到目标 {% data variables.product.prodname_enterprise %} 设备。 +In the event of prolonged outage or catastrophic event at the primary site, you can restore {% data variables.product.product_location %} by provisioning another {% data variables.product.prodname_enterprise %} appliance and performing a restore from the backup host. You must add the backup host's SSH key to the target {% data variables.product.prodname_enterprise %} appliance as an authorized SSH key before restoring an appliance. {% note %} -**注意:** 当执行备份还原到 {% data variables.product.product_location %} 时,同样的版本支持性规则也适用。 您最多只能从后面两个功能版本恢复数据。 +**Note:** When performing backup restores to {% data variables.product.product_location %}, the same version supportability rules apply. You can only restore data from at most two feature releases behind. -例如,如果从 {% data variables.product.product_name %} 3.0.x 获取备份,则可以将备份还原到 {% data variables.product.product_name %} 3.2.x 实例。 无法将数据从 {% data variables.product.product_name %} 2.22.x 的备份还原到运行 3.2.x 的实例,因为这样会跨过三个版本(2.22 到 3.0 到 3.1 到 3.2)。 需要先还原到运行 3.1.x 的实例,然后升级到 3.2.x。 +For example, if you take a backup from {% data variables.product.product_name %} 3.0.x, you can restore the backup to a {% data variables.product.product_name %} 3.2.x instance. You cannot restore data from a backup of {% data variables.product.product_name %} 2.22.x to an instance running 3.2.x, because that would be three jumps between versions (2.22 to 3.0 to 3.1 to 3.2). You would first need to restore to an instance running 3.1.x, and then upgrade to 3.2.x. {% endnote %} -若要从上次成功快照还原 {% data variables.product.product_location %},请使用 `ghe-restore` 命令。 +To restore {% data variables.product.product_location %} from the last successful snapshot, use the `ghe-restore` command. {% note %} -注意:还原备份之前,请确保: -- 在主实例上启用了维护模式,并且所有活动进程都已完成。 有关详细信息,请参阅“[启用维护模式](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)”。 -- 在高可用性配置中的所有副本上停止复制。 有关详细信息,请参阅“[关于高可用性配置](/admin/enterprise-management/configuring-high-availability/about-high-availability-configuration#ghe-repl-stop)”中的 `ghe-repl-stop` 命令。 -- 如果 {% data variables.product.product_location %} 启用了 {% data variables.product.prodname_actions %},则必须在替换设备上配置 {% data variables.product.prodname_actions %} 外部存储提供程序。 有关详细信息,请参阅“[在启用 {% data variables.product.prodname_actions %} 的情况下备份和还原 {% data variables.product.prodname_ghe_server %}](/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled)”。 +**Note:** Prior to restoring a backup, ensure: +- Maintenance mode is enabled on the primary instance and all active processes have completed. For more information, see "[Enabling maintenance mode](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)." +- Replication is stopped on all replicas in high availability configurations. For more information, see the `ghe-repl-stop` command in "[About high availability configuration](/admin/enterprise-management/configuring-high-availability/about-high-availability-configuration#ghe-repl-stop)." +- If {% data variables.product.product_location %} has {% data variables.product.prodname_actions %} enabled, you must first configure the {% data variables.product.prodname_actions %} external storage provider on the replacement appliance. For more information, see "[Backing up and restoring {% data variables.product.prodname_ghe_server %} with {% data variables.product.prodname_actions %} enabled](/admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled)." {% endnote %} -运行 `ghe-restore` 命令之后,你应该会看到类似于以下内容的输出: +When running the `ghe-restore` command, you should see output similar to this: ```shell $ ghe-restore -c 169.154.1.1 @@ -242,15 +238,20 @@ $ ghe-restore -c 169.154.1.1 > Visit https://169.154.1.1/setup/settings to review appliance configuration. ``` -{% ifversion ip-exception-list %}(可选)若要验证还原,请配置 IP 例外列表以允许访问指定 IP 地址列表。 有关详细信息,请参阅“[使用 IP 异常列表在维护模式下验证更改](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)”。 +{% ifversion ip-exception-list %} +Optionally, to validate the restore, configure an IP exception list to allow access to a specified list of IP addresses. For more information, see "[Validating changes in maintenance mode using the IP exception list](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)." {% endif %} {% note %} -**注意:** 网络设置会排除在备份快照之外。 您必须根据环境的要求在目标 {% data variables.product.prodname_ghe_server %} 设备上手动配置网络。 +**Note:** + +- The network settings are excluded from the backup snapshot. You must manually configure the network on the target {% data variables.product.prodname_ghe_server %} appliance as required for your environment. + +- When restoring to new disks on an existing or empty {% data variables.product.prodname_ghe_server %} instance, stale UUIDs may be present, resulting in Git and/or Alambic replication reporting as out of sync. Stale server entry IDs can be the result of a retired node in a high availability configuration still being present in the application database, but not in the restored replication configuration. To remediate, stale UUIDs can be torn down using `ghe-repl-teardown` once the restore has completed and prior to starting replication. In this scenario, contact {% data variables.contact.contact_ent_support %} for further assistance. {% endnote %} -可以使用 `ghe-restore` 命令使用这些附加选项: -- 即使已配置 `-c` 标志,该标志也会覆盖目标主机上的设置、证书和许可证数据。 如果您要为测试设置暂存实例,并且希望在目标设备上保留现有配置,请省略此标志。 有关详细信息,请参阅 {% data variables.product.prodname_enterprise_backup_utilities %} 项目文档中的 [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#using-the-backup-and-restore-commands) 的“使用备份和还原命令”部分。 -- `-s` 标志让你能够选择不同的备份快照。 +You can use these additional options with `ghe-restore` command: +- The `-c` flag overwrites the settings, certificate, and license data on the target host even if it is already configured. Omit this flag if you are setting up a staging instance for testing purposes and you wish to retain the existing configuration on the target. For more information, see the "Using backup and restore commands" section of the [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#using-the-backup-and-restore-commands) in the {% data variables.product.prodname_enterprise_backup_utilities %} project documentation. +- The `-s` flag allows you to select a different backup snapshot. diff --git a/translations/zh-CN/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md b/translations/zh-CN/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md index 6fa069a0f2..9445e64621 100644 --- a/translations/zh-CN/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md +++ b/translations/zh-CN/content/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md @@ -93,7 +93,7 @@ Optionally, if you use {% data variables.product.prodname_registry %} on your pr {% warning %} -**Warning**: If you don't configure {% data variables.product.prodname_actions %} on the staging instance before restoring your production backup, your staging instance will use your production instance's external storage, which could result in loss of data. We strongly recommended that you use different external storage for your staging instance. +**Warning**: If you don't configure {% data variables.product.prodname_registry %} on the staging instance before restoring your production backup, your staging instance will use your production instance's external storage, which could result in loss of data. We strongly recommended that you use different external storage for your staging instance. {% endwarning %} @@ -128,7 +128,7 @@ Optionally, if you use {% data variables.product.prodname_registry %} on your pr Use the `ghe-restore` command to restore the rest of the data from the backup. For more information, see "[Restoring a backup](/admin/configuration/configuring-backups-on-your-appliance#restoring-a-backup)." -If the staging instance is already configured and you're about to overwrite settings, certificate, and license data, add the `-c` option to the command. For more information about the option, see [Using the backup and restore commands](https://github.com/github/backup-utils/blob/master/docs/usage.md#restoring-settings-tls-certificate-and-license) in the {% data variables.product.prodname_enterprise_backup_utilities %} documentation. +If the staging instance is already configured and you want to overwrite settings, certificate, and license data, add the `-c` option to the command. For more information about the option, see [Using the backup and restore commands](https://github.com/github/backup-utils/blob/master/docs/usage.md#restoring-settings-tls-certificate-and-license) in the {% data variables.product.prodname_enterprise_backup_utilities %} documentation. ### 6. Review the instance's configuration diff --git a/translations/zh-CN/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md b/translations/zh-CN/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md index a21fbca0a0..6e8acc6b4d 100644 --- a/translations/zh-CN/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md +++ b/translations/zh-CN/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md @@ -56,7 +56,7 @@ Jobs that run on Windows and macOS runners that {% data variables.product.prodna The storage used by a repository is the total storage used by {% data variables.product.prodname_actions %} artifacts and {% data variables.product.prodname_registry %}. Your storage cost is the total usage for all repositories owned by your account. For more information about pricing for {% data variables.product.prodname_registry %}, see "[About billing for {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/about-billing-for-github-packages)." - If your account's usage surpasses these limits and you have set a spending limit above $0 USD, you will pay $0.008 USD per GB of storage per day and per-minute usage depending on the operating system used by the {% data variables.product.prodname_dotcom %}-hosted runner. {% data variables.product.prodname_dotcom %} rounds the minutes each job uses up to the nearest minute. + If your account's usage surpasses these limits and you have set a spending limit above $0 USD, you will pay $0.008 USD per GB of storage per day and per-minute usage depending on the operating system used by the {% data variables.product.prodname_dotcom %}-hosted runner. {% data variables.product.prodname_dotcom %} rounds the minutes and partial minutes each job uses up to the nearest whole minute. {% note %} diff --git a/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md b/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md index d11653618f..29711c895e 100644 --- a/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md +++ b/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces.md @@ -3,6 +3,7 @@ title: About billing for GitHub Codespaces shortTitle: About billing intro: 'View pricing and see how to manage {% data variables.product.prodname_github_codespaces %} billing for your organization.' permissions: 'To manage billing for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner or a billing manager.' +miniTocMaxHeadingLevel: 3 versions: fpt: '*' ghec: '*' @@ -13,40 +14,105 @@ topics: - Billing redirect_from: - /billing/managing-billing-for-github-codespaces/about-billing-for-codespaces + - /github/developing-online-with-codespaces/about-billing-for-codespaces + - /codespaces/getting-started-with-codespaces/about-billing-for-codespaces + - /codespaces/codespaces-reference/about-billing-for-codespaces + - /codespaces/codespaces-reference/understanding-billing-for-codespaces + - /codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md --- ## {% data variables.product.prodname_github_codespaces %} pricing -Charges are incurred for the use of {% data variables.product.prodname_github_codespaces %} for repositories owned by organization and enterprise accounts on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %}. These accounts do not include any free minutes or storage for {% data variables.product.prodname_github_codespaces %}. Repositories in personal accounts are not currently billed for {% data variables.product.prodname_github_codespaces %} usage. +Charges are incurred for the use of {% data variables.product.prodname_github_codespaces %} for repositories owned by organization and enterprise accounts on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %}. These accounts do not include any free minutes or storage for {% data variables.product.prodname_github_codespaces %}. Personal accounts are not currently billed for {% data variables.product.prodname_github_codespaces %} usage. + +A {% data variables.product.prodname_github_codespaces %} instance (a "codespace") incurs charges for compute time, while it is active, and for the amount of storage it uses on disk. {% data variables.product.prodname_github_codespaces %} usage is billed according to the units of measure in the following table: -| Product | SKU | Unit of measure | Price | -| ------------------- | -------- | --------------- | ----- | -| Codespaces Compute | 2 core | 1 hour | $0.18 | -| | 4 core | 1 hour | $0.36 | -| | 8 core | 1 hour | $0.72 | -| | 16 core | 1 hour | $1.44 | -| | 32 core | 1 hour | $2.88 | -| Codespaces Storage | Storage | 1 GB-month | $0.07 | +| Component | Machine type | Unit of measure | Price | +| ------------------- | ------------ | --------------- | ----- | +| Codespaces compute | 2 core | 1 hour | $0.18 | +| | 4 core | 1 hour | $0.36 | +| | 8 core | 1 hour | $0.72 | +| | 16 core | 1 hour | $1.44 | +| | 32 core | 1 hour | $2.88 | +| Codespaces storage | Storage | 1 GB-month* | $0.07 | + +* See "[Billing for storage usage](#billing-for-storage-usage)" below for details of the GB-month unit of measure. + +If you enable prebuilding of codespaces this will incur additional charges. For more information, see "[Billing for {% data variables.product.prodname_codespaces %} prebuilds](#billing-for-codespaces-prebuilds)." ## About billing for {% data variables.product.prodname_github_codespaces %} -{% data reusables.codespaces.codespaces-billing %} +{% data variables.product.prodname_github_codespaces %} is billed in US dollars (USD) according to their compute and storage usage. {% data reusables.codespaces.codespaces-monthly-billing %} xxx -Your {% data variables.product.prodname_github_codespaces %} usage shares your organization or enterprise account's existing billing date, payment method, and receipt. {% data reusables.dotcom_billing.view-all-subscriptions %} +Your {% data variables.product.prodname_github_codespaces %} usage shares your organization or enterprise account's existing payment method, and receipt. For more information, see "[Viewing your subscriptions and billing date](/articles/viewing-your-subscriptions-and-billing-date)." {% ifversion ghec %} If you purchased {% data variables.product.prodname_enterprise %} through a Microsoft Enterprise Agreement, you can connect your Azure Subscription ID to your enterprise account to enable and pay for {% data variables.product.prodname_github_codespaces %} usage. For more information, see "[Connecting an Azure subscription to your enterprise](/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise)." {% endif %} -{% data reusables.dotcom_billing.pricing_calculator.pricing_cal_codespaces %} +### Billing for compute usage +The compute usage of a codespace is the number of minutes for which that codespace is active. Total compute usage is calculated by summing the number of minutes used by all codespaces that are billable to the organization or enterprise. These totals are reported to the billing service every hour, and are billed monthly. + +As an example, if a codespace is active for 1 hour and 15 minutes, then the compute cost will be the hourly cost of the codespace, as determined by its machine type, multiplied by 1.25. + +You can restrict compute usage by stopping your codespaces. For information, see "[Stopping and starting a codespace](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)." Codespaces are stopped automatically after a configurable period of inactivity. The timeout period can be configured by the user, or at the organization level. 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)" and "[Restricting the idle timeout period](/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)." + +### Billing for storage usage +For {% data variables.product.prodname_github_codespaces %} billing purposes, this includes all storage used by all codespaces and prebuilds in your account. This includes any files used by the codespaces, such as cloned repositories, configuration files, and extensions, among others. Storage is billed for all of your existing codespaces, regardless of whether they are active or stopped. The storage billing for a codespace ends when it is deleted. + +Codespace storage is reported in GB-months. Your billing month runs from a fixed day in one month until the same day in the next month. In most cases the day of the month is determined by the day you started on your current {% data variables.product.prodname_dotcom %} plan. Your GB-month storage, is calculated as follows. Once every hour, the storage used by all of your currently active and stopped codespaces is assessed. This figure is then divided by the number of hours in the current billing month: `total storage size / hours this month`. The result is added to the running total for codespace storage for the month. + +For example, if you have one codespace that uses 100 GB of storage and has existed for one hour you will have used `100 / (24 * 30) = 0.1388` GB-months of storage in a 30-day month. If your use of GitHub Codespaces during a 30-day month consists of two 100 GB codespaces that both existed for three full days then there will be `24 * 3` hourly reports for the storage of these codespaces, giving a total of: `(24 * 3) * 200 / (24 * 30) = 20` GB-months. + +For each hourly report, the storage usage for the previous hour is calculated in seconds. As a result, you won't be charged for a full hour of storage if a codespace did not exist for the full 60 minutes. At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB. + +As an organization owner, you can: +- List the currently active and stopped codespaces for your organization. For more information, see "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)." In addition to the cost of these codespaces, the cost of {% data variables.product.prodname_github_codespaces %} for the current month may include costs for codespaces that existed earlier in the current month but have since been deleted. +- See the total {% data variables.product.prodname_github_codespaces %} compute and storage usage for your organization for the current month to date. For more information, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." +- Configure your organization settings to manage the cost of {% data variables.product.prodname_github_codespaces %}. For more information, see "[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)." + +To estimate the costs for metered services, you can use the {% data variables.product.prodname_dotcom %} [pricing calculator](https://github.com/pricing/calculator?feature=codespaces). ### Billing for {% data variables.product.prodname_codespaces %} prebuilds -{% data reusables.codespaces.billing-for-prebuilds-default %} +{% data reusables.codespaces.prebuilds-definition %} For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds)." -{% data reusables.codespaces.billing-for-prebuilds-reducing %} +#### {% data variables.product.prodname_actions %} costs for prebuilds + +Prebuilds are created and updated by running a {% data variables.product.prodname_actions %} workflow on a {% data variables.product.prodname_dotcom %}-hosted runner. By default, prebuilds are updated every time you modify the prebuild configuration, or push changes to a prebuild-enabled branch. As with other workflows, while prebuild workflows are running they will either consume some of the Actions minutes included with your account, if you have any, or they will incur charges for Actions minutes. For more information about pricing for Actions minutes, see "[About billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)." There is no associated {% data variables.product.prodname_codespaces %} compute cost for creating or updating prebuilds. + +To reduce consumption of Actions minutes, you can set a prebuild to be updated only when you make a change to your dev container configuration files, or only on a custom schedule. You can also manage your storage usage by adjusting the number of previous versions of each prebuild that are retained. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." + +If you are an organization or enterprise owner, you can track usage of prebuild workflows and storage by downloading a usage report for your organization or enterprise. You can identify workflow runs for prebuilds by filtering the CSV output to only include the workflow called "Create {% data variables.product.prodname_github_codespaces %} Prebuilds." For more information, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage#viewing-github-actions-usage-for-your-organization)." + +#### Storage costs for prebuilds + +In addition to {% data variables.product.prodname_actions %} minutes, you will also be billed for the storage of prebuilds associated with each prebuild configuration for a given repository and region. Storage of prebuilds is billed at the same rate as storage of codespaces. + +The storage cost for a prebuild in a single region will be similar to the storage cost that will be incurred for storing a single codespace created from that prebuild. The storage cost for the generated codespace may be more than the cost for the prebuild if, for example, the `updateContentCommand` and `postCreateCommand` commands are used during codespace creation to download more files to the dev container. + +The total storage costs associated with a prebuild template will depend on: + +* The price of storage per GB. See the table above. +* The size of the generated prebuild in GB. +* The number of regions in which the prebuild is available (because a copy of the prebuild is stored in each region). +* The number of older versions of the prebuild that are retained. + +The storage cost for a prebuild is therefore calculated as: `price per GB * size (GB) * regions * versions`. + +To limit the storage costs associated with prebuilds, you can choose to create prebuilds only in selected regions, and you can specify the number of older versions of prebuilds that will be retained. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." + +{% note %} + +**Note**: Prebuilds may be updated several times during a billing month. Newer versions of a prebuild may be larger or smaller than the previous versions. This will affect the storage charges. For details of how storage is calculated during a billing month, see "[Billing for storage usage](#billing-for-storage-usage)" above. + +{% endnote %} + +#### Cost of codespaces created from prebuilds + +Use of codespaces created using prebuilds is charged at the same rate as regular codespaces. ## Setting a spending limit @@ -72,7 +138,7 @@ For example, a user in an organization can fork a repository within that organiz ## How billing is handled when a repository is transferred -Usage is billed and reported on every hour. As such, you pay for any usage when a repository is within your organization. When a repository is transferred out of your organization, any codespaces in that repository are removed as part of the transfer process. +Usage is calculated every hour. An organization pays for usage of codespaces created from any repository owned by the organization, where the organization settings permit the organization to be billed. For more information, see "[Enabling GitHub Codespaces for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#choose-who-can-create-codespaces-that-are-billed-to-your-organization)." When a repository is transferred out of your organization, ownership and billing responsibility for any codespaces associated with that repository will change accordingly. ## What happens when users are removed diff --git a/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/index.md b/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/index.md index 839d5dc496..b565c2a921 100644 --- a/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/index.md +++ b/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/index.md @@ -11,4 +11,3 @@ children: - /viewing-your-github-codespaces-usage - /managing-spending-limits-for-github-codespaces --- - diff --git a/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md b/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md index cf5ad18c14..929ebfd3e8 100644 --- a/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md +++ b/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces.md @@ -21,6 +21,8 @@ redirect_from: {% data reusables.codespaces.codespaces-spending-limit-requirement %} +{% data reusables.codespaces.codespaces-monthly-billing %} + Once you've reached your spending limit, your organization or repository will no longer be able to create new codespaces, and won't be able to start existing codespaces. Any existing codespaces that are still running will not be shutdown; if you don't change the spending limit, you will not be charged for the amount that exceeds the limit. For more information about pricing for {% data variables.product.prodname_github_codespaces %} usage, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." @@ -67,4 +69,4 @@ You can disable these notifications anytime by navigating to the bottom of the * ## Further reading - "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)" -- "[Managing billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)" diff --git a/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md b/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md index 3081c864ef..9652fd43bd 100644 --- a/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md +++ b/translations/zh-CN/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md @@ -21,8 +21,21 @@ Organization owners and billing managers can view {% data variables.product.prod {% 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. -  + +  + + 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-spending-limits-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. + + {% endnote %} + {% data reusables.dotcom_billing.actions-packages-report-download-org-account %} + The data used for this report is updated daily. 1. Filter the report to show only rows that mention "Codespaces" in the `Product` field.  @@ -38,3 +51,7 @@ Enterprise owners and billing managers can view {% data variables.product.prodna 1. Under "{% data variables.product.prodname_codespaces %} monthly usage", view the usage details of each organization in your enterprise account. {% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %} {% endif %} + +## Further reading + +- "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)" \ No newline at end of file diff --git a/translations/zh-CN/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md b/translations/zh-CN/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md index 51ae89d06d..f8ef3037ef 100644 --- a/translations/zh-CN/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md +++ b/translations/zh-CN/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md @@ -14,23 +14,23 @@ shortTitle: Private image registry A registry is a secure space for storing, managing, and fetching private container images. You may use one to store one or more images. There are many examples of registries, such as {% data variables.product.prodname_container_registry %}, {% data variables.product.prodname_npm_registry %}, Azure Container Registry, or DockerHub. -{% data variables.product.prodname_ghcr_and_npm_registry %} can be configured to allow container images to be pulled seamlessly into {% data variables.product.prodname_github_codespaces %} during codespace creation, without having to provide any authentication credentials. For other image registries, you must create secrets in {% data variables.product.prodname_dotcom %} to store the access details, which will allow {% data variables.product.prodname_github_codespaces %} to access images stored in that registry. +{% data variables.packages.prodname_ghcr_and_npm_registry %} can be configured to allow container images to be pulled seamlessly into {% data variables.product.prodname_github_codespaces %} during codespace creation, without having to provide any authentication credentials. For other image registries, you must create secrets in {% data variables.product.prodname_dotcom %} to store the access details, which will allow {% data variables.product.prodname_github_codespaces %} to access images stored in that registry. -## Accessing images stored in {% data variables.product.prodname_ghcr_and_npm_registry %} +## Accessing images stored in {% data variables.packages.prodname_ghcr_and_npm_registry %} -{% data variables.product.prodname_ghcr_and_npm_registry %} provide the easiest way for {% data variables.product.prodname_github_codespaces %} to consume dev container images. +{% data variables.packages.prodname_ghcr_and_npm_registry %} provide the easiest way for {% data variables.product.prodname_github_codespaces %} to consume dev container images. For more information, see "[Working with the Container registry](/packages/working-with-a-github-packages-registry/working-with-the-container-registry)" and "[Working with the npm registry](/packages/working-with-a-github-packages-registry/working-with-the-npm-registry)". ### Accessing an image published to the same repository as the codespace -If you publish a container image to {% data variables.product.prodname_ghcr_or_npm_registry %} in the same repository that the codespace is being launched in, you will automatically be able to fetch that image on codespace creation. You won't have to provide any additional credentials, unless the **Inherit access from repo** option was unselected when the container image was published. +If you publish a container image to {% data variables.packages.prodname_ghcr_or_npm_registry %} in the same repository that the codespace is being launched in, you will automatically be able to fetch that image on codespace creation. You won't have to provide any additional credentials, unless the **Inherit access from repo** option was unselected when the container image was published. #### Inheriting access from the repository from which an image was published -By default, when you publish a container image to {% data variables.product.prodname_ghcr_or_npm_registry %}, the image inherits the access setting of the repository from which the image was published. For example, if the repository is public, the image is also public. If the repository is private, the image is also private, but is accessible from the repository. +By default, when you publish a container image to {% data variables.packages.prodname_ghcr_or_npm_registry %}, the image inherits the access setting of the repository from which the image was published. For example, if the repository is public, the image is also public. If the repository is private, the image is also private, but is accessible from the repository. -This behavior is controlled by the **Inherit access from repo** option. **Inherit access from repo** is selected by default when publishing via {% data variables.product.prodname_actions %}, but not when publishing directly to {% data variables.product.prodname_ghcr_or_npm_registry %} using a Personal Access Token (PAT). +This behavior is controlled by the **Inherit access from repo** option. **Inherit access from repo** is selected by default when publishing via {% data variables.product.prodname_actions %}, but not when publishing directly to {% data variables.packages.prodname_ghcr_or_npm_registry %} using a Personal Access Token (PAT). If the **Inherit access from repo** option was not selected when the image was published, you can manually add the repository to the published container image's access controls. For more information, see "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#inheriting-access-for-a-container-image-from-a-repository)." @@ -46,13 +46,13 @@ If you want to allow a subset of an organization's repositories to access a cont ### Publishing a container image from a codespace -Seamless access from a codespace to {% data variables.product.prodname_ghcr_or_npm_registry %} is limited to pulling container images. If you want to publish a container image from inside a codespace, you must use a personal access token (PAT) with the `write:packages` scope. +Seamless access from a codespace to {% data variables.packages.prodname_ghcr_or_npm_registry %} is limited to pulling container images. If you want to publish a container image from inside a codespace, you must use a personal access token (PAT) with the `write:packages` scope. We recommend publishing images via {% data variables.product.prodname_actions %}. For more information, see "[Publishing Docker images](/actions/publishing-packages/publishing-docker-images)" and "[Publishing Node.js packages](/actions/publishing-packages/publishing-nodejs-packages)." ## Accessing images stored in other container registries -If you are accessing a container image from a registry that isn't {% data variables.product.prodname_ghcr_or_npm_registry %}, {% data variables.product.prodname_github_codespaces %} checks for the presence of three secrets, which define the server name, username, and personal access token (PAT) for a container registry. If these secrets are found, {% data variables.product.prodname_github_codespaces %} will make the registry available inside your codespace. +If you are accessing a container image from a registry that isn't {% data variables.packages.prodname_ghcr_or_npm_registry %}, {% data variables.product.prodname_github_codespaces %} checks for the presence of three secrets, which define the server name, username, and personal access token (PAT) for a container registry. If these secrets are found, {% data variables.product.prodname_github_codespaces %} will make the registry available inside your codespace. - `<*>_CONTAINER_REGISTRY_SERVER` - `<*>_CONTAINER_REGISTRY_USER` diff --git a/translations/zh-CN/content/codespaces/codespaces-reference/index.md b/translations/zh-CN/content/codespaces/codespaces-reference/index.md index 5a4afcdbe9..1ec4619e5a 100644 --- a/translations/zh-CN/content/codespaces/codespaces-reference/index.md +++ b/translations/zh-CN/content/codespaces/codespaces-reference/index.md @@ -6,7 +6,6 @@ versions: ghec: '*' product: '{% data reusables.gated-features.codespaces %}' children: - - /understanding-billing-for-github-codespaces - /allowing-your-codespace-to-access-a-private-image-registry - /using-github-copilot-in-github-codespaces - /using-the-vs-code-command-palette-in-codespaces diff --git a/translations/zh-CN/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md b/translations/zh-CN/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md deleted file mode 100644 index f6a802c687..0000000000 --- a/translations/zh-CN/content/codespaces/codespaces-reference/understanding-billing-for-github-codespaces.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: Understanding billing for GitHub Codespaces -intro: 'Learn how your {% data variables.product.prodname_github_codespaces %} usage is billed.' -versions: - fpt: '*' - ghec: '*' -redirect_from: - - /github/developing-online-with-codespaces/about-billing-for-codespaces - - /codespaces/getting-started-with-codespaces/about-billing-for-codespaces - - /codespaces/codespaces-reference/about-billing-for-codespaces - - /codespaces/codespaces-reference/understanding-billing-for-codespaces -type: reference -topics: - - Codespaces - - Billing -product: '{% data reusables.gated-features.codespaces %}' -shortTitle: Understanding billing ---- - -This article explains how billing works for your codespaces, and explains how your organization's billing manager can help. - -## Getting access to {% data variables.product.prodname_github_codespaces %} - -Your organization's administrator might limit {% data variables.product.prodname_github_codespaces %} usage to only specific personal accounts. To get access, you will need to contact your billing manager. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)." - -## How much it costs to use {% data variables.product.prodname_codespaces %} - -To see the pricing for {% data variables.product.prodname_github_codespaces %} usage, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-codespaces#codespaces-pricing)." - -## How your codespace usage is billed - -Your codespace is billed for its compute minutes and for the amount of storage it uses on disk. - -If you enable prebuilding of codespaces this will incur additional charges. For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds#about-billing-for-codespaces-prebuilds)." - -### Understanding what compute minutes are -Your codespace is billed for the number of minutes that it's active. If your codespaces window is left idle for 30 minutes, it will automatically shutdown, and compute billing for the codespace will end until you start the codespace again. - -### Understanding how codespace storage is billed -For {% data variables.product.prodname_github_codespaces %}, storage is defined to include any files relating to your codespace, such as the cloned repository, configuration files, and extensions, among others. This storage is billed while your codespace is shutdown. The storage billing for a codespace ends when you manually delete it from https://github.com/codespaces. - -## How spending limits work - -Before your organization can use {% data variables.product.prodname_github_codespaces %}, your billing manager will need to set a spending limit. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." - -## Exporting changes when you have reached your spending limit - -{% data reusables.codespaces.exporting-changes %} - -## Checking your current usage and limits -If you need to check your current usage or spending limit, contact your organization's billing manager. For more information, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." - -## Codespaces can be automatically deleted - -Your codespace will be automatically deleted when you are removed from an organization or repository. - -## Deleting your unused codespaces - -You can manually delete your codespaces in https://github.com/codespaces and from within {% data variables.product.prodname_vscode %}. To reduce the size of a codespace, you can manually delete files using the terminal or from within {% data variables.product.prodname_vscode %}. - -## Further reading - -- "[Managing billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization)" diff --git a/translations/zh-CN/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md b/translations/zh-CN/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md index 2465cfe69e..d3ec7e7ef3 100644 --- a/translations/zh-CN/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md +++ b/translations/zh-CN/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md @@ -71,7 +71,7 @@ If you try to delete a codespace with unpushed git commits, your editor will not 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)." -You will be charged for the storage of all your codespaces. When you delete a codespace, you will no longer be charged. +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)." diff --git a/translations/zh-CN/content/codespaces/developing-in-codespaces/index.md b/translations/zh-CN/content/codespaces/developing-in-codespaces/index.md index 6ff3d03b71..296d55dacf 100644 --- a/translations/zh-CN/content/codespaces/developing-in-codespaces/index.md +++ b/translations/zh-CN/content/codespaces/developing-in-codespaces/index.md @@ -11,12 +11,12 @@ children: - /codespaces-lifecycle - /developing-in-a-codespace - /creating-a-codespace + - /deleting-a-codespace - /opening-an-existing-codespace - /using-source-control-in-your-codespace - /using-github-codespaces-for-pull-requests - /stopping-and-starting-a-codespace - /renaming-a-codespace - - /deleting-a-codespace - /forwarding-ports-in-your-codespace - /default-environment-variables-for-your-codespace - /connecting-to-a-private-network diff --git a/translations/zh-CN/content/codespaces/getting-started/deep-dive.md b/translations/zh-CN/content/codespaces/getting-started/deep-dive.md index 782e475ffb..c6a2e16f8a 100644 --- a/translations/zh-CN/content/codespaces/getting-started/deep-dive.md +++ b/translations/zh-CN/content/codespaces/getting-started/deep-dive.md @@ -117,6 +117,6 @@ If you already use {% data variables.product.prodname_vscode_shortname %}, you c ## 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 billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)" - "[Codespaces lifecycle](/codespaces/developing-in-codespaces/codespaces-lifecycle)" diff --git a/translations/zh-CN/content/codespaces/getting-started/quickstart.md b/translations/zh-CN/content/codespaces/getting-started/quickstart.md index 3aa2d59490..213fec6823 100644 --- a/translations/zh-CN/content/codespaces/getting-started/quickstart.md +++ b/translations/zh-CN/content/codespaces/getting-started/quickstart.md @@ -111,4 +111,4 @@ You've successfully created, personalized, and run your first application within ## 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 billing for {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-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)" diff --git a/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md b/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md index ff040d9a82..25d134cf2a 100644 --- a/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md +++ b/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md @@ -19,7 +19,7 @@ topics: ## About enabling {% data variables.product.prodname_github_codespaces %} for your organization -Organization owners can control which users in your organization can create and use codespaces at the organization's expense. +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 GitHub Codespaces](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." Only people who can clone a repository can create a codespace for that repository. To allow people to create codespaces for repositories owned by your organization, you must: diff --git a/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/index.md b/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/index.md index 21248d1932..be8dd52968 100644 --- a/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/index.md +++ b/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/index.md @@ -11,7 +11,7 @@ topics: children: - /enabling-github-codespaces-for-your-organization - /listing-the-codespaces-in-your-organization - - /managing-billing-for-github-codespaces-in-your-organization + - /managing-the-cost-of-github-codespaces-in-your-organization - /managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces - /managing-repository-access-for-your-organizations-codespaces - /reviewing-your-organizations-audit-logs-for-github-codespaces diff --git a/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md b/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md index 249872ab25..68ef8f119d 100644 --- a/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md +++ b/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md @@ -1,7 +1,7 @@ --- -title: 列出组织中的 codespace +title: Listing the codespaces in your organization shortTitle: List organization codespaces -intro: 可以列出组织当前处于活动状态或已停止的所有 codespace。 +intro: 'You can list all of the currently active or stopped codespaces for your organization.' product: '{% data reusables.gated-features.codespaces %}' permissions: 'To list all of the current codespaces for your organization, you must be an organization owner.' versions: @@ -11,34 +11,31 @@ type: how_to topics: - Codespaces - Administrator -ms.openlocfilehash: 72d59c35641dd77b4d3623cc70b12b5be880be34 -ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794 -ms.translationtype: HT -ms.contentlocale: zh-CN -ms.lasthandoff: 09/09/2022 -ms.locfileid: '147865209' --- -## 概述 -作为组织所有者,可以列出组织当前处于活动状态和已停止的所有 codespace。 你可能想要执行此操作来检查用户正在创建多少 codespace,以确保不会产生不必要的成本。 +## Overview -列出组织的 codespace 的最简单方法是使用 {% data variables.product.prodname_cli %}。 还可以使用 REST API,该 API 提供有关每个 codespace 的详细信息。 +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 GitHub Codespaces](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." -### 使用 {% data variables.product.prodname_cli %} 列出 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. -若要列出指定组织的所有当前 codespace,请使用以下命令。 +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)." + +### Using {% data variables.product.prodname_cli %} to list codespaces + +To list all of the current codespaces for a specified organization, use the following command. ```shell{:copy} gh codespace list --org ORGANIZATION ``` -此命令返回一个列表,其中包含每个 codespace 的以下信息: - - 名称和显示名称 - - 创建 codespace 的用户 - - 存储库和分支 - - codespace 的当前状态 +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,请使用以下命令。 +To list all of the current codespaces for an organization that were created by a specific user, use the following command. ```shell{:copy} gh codespace list --org ORGANIZATION --user USER @@ -46,12 +43,12 @@ gh codespace list --org ORGANIZATION --user USER {% note %} -**注意**:在上述命令中,将 `ORGANIZATION` 替换为要查询的组织的名称。 你必须是组织的所有者。 +**Note**: In the above commands, replace `ORGANIZATION` with the name of the organization you are querying. You must be an owner of the organization. {% endnote %} -### 使用 REST API 列出 codespace +### Using the REST API to list codespaces -可以将 `/orgs/{org}/codespaces` API 终结点用作列出组织当前 codespace 的替代方法。 这将返回比 {% data variables.product.prodname_cli %} 更详细的信息;例如,计算机类型详细信息。 +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. -有关此终结点的详细信息,请参阅“[Codespaces 组织](/rest/codespaces/organizations#list-codespaces-for-the-organization)”。 +For more information about this endpoint, see "[Codespaces organizations](/rest/codespaces/organizations#list-codespaces-for-the-organization)." \ No newline at end of file diff --git a/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md b/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md deleted file mode 100644 index b00448e35b..0000000000 --- a/translations/zh-CN/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Managing billing for GitHub Codespaces in your organization -shortTitle: Manage billing -intro: 'You can check your {% data variables.product.prodname_github_codespaces %} usage and set usage limits.' -product: '{% data reusables.gated-features.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 ---- - -## Overview - -To learn about pricing for {% data variables.product.prodname_github_codespaces %}, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)." - -{% data reusables.codespaces.codespaces-billing %} - -- As an organization owner or a billing manager, you can manage {% data variables.product.prodname_github_codespaces %} billing for your organization: ["About billing for Codespaces"](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces) -- As an organization owner, you can list the currently active and stopped codespaces for your organization. In addition to these codespaces, costs for the current month may include costs for codespaces that existed earlier in the current month but have since been deleted. -- For users, there is a guide that explains how billing works: ["Understanding billing for {% data variables.product.prodname_github_codespaces %}"](/codespaces/codespaces-reference/understanding-billing-for-github-codespaces) - -## Usage limits - -You can set a usage limit for the codespaces in your organization or repository. This limit is applied to the compute and storage usage for {% data variables.product.prodname_github_codespaces %}: - -- **Compute minutes:** Compute usage is calculated by the actual number of minutes used by all {% data variables.product.prodname_github_codespaces %} instances while they are active. These totals are reported to the billing service daily, and is billed monthly. You can set a spending limit for {% data variables.product.prodname_github_codespaces %} usage in your organization. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." - -- **Storage usage:** For {% data variables.product.prodname_github_codespaces %} billing purposes, this includes all storage used by all codespaces in your account. This includes resources such as cloned repositories, configuration files, and extensions, among others. These totals are reported to the billing service daily, and is billed monthly. At the end of the month, {% data variables.product.prodname_dotcom %} rounds your storage to the nearest MB. To check how many compute minutes and storage GB have been used by {% data variables.product.prodname_github_codespaces %}, see "[Viewing your {% data variables.product.prodname_github_codespaces %} usage"](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)." - -## Disabling or limiting {% data variables.product.prodname_codespaces %} - -You can disable all use of {% data variables.product.prodname_github_codespaces %} that would be billed to your organization. Alternatively, you can specify which organization members or collaborators can use {% data variables.product.prodname_codespaces %} at your 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-disabling-org-billing %} - -You can configure which repositories can be accessed from codespaces created for a particular repository. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)." - -You can limit the choice of types of machine that are available for codespaces created from repositories owned by your organization. This allows you to prevent people using overly resourced machines for their codespaces, and incurring unnecessary charges. For more information, see "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)." - -You can also restrict how long a codespace can remain unused before it is automatically deleted. This can help to reduce storage costs for {% data variables.product.prodname_codespaces %}. For more information, see "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)." - -## Deleting unused codespaces - -Your users can delete their own codespaces in https://github.com/codespaces and from within {% data variables.product.prodname_vscode %}. To reduce the size of a codespace, users can manually delete files using the terminal or from within {% data variables.product.prodname_vscode_shortname %}. - -As an organization owner, you can delete any codespace in your organization. For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)." - -{% note %} - -**Note:** Codespaces are automatically deleted after they have been stopped and have remained inactive for a defined number of days. For more information, see "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)." A codespace can only be manually deleted by the person who created the codespace. - -{% endnote %} - -## Further reading - -- "[Listing the codespaces in your organization](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)" diff --git a/translations/zh-CN/content/codespaces/overview.md b/translations/zh-CN/content/codespaces/overview.md index 4c07f6674a..1a6ee65780 100644 --- a/translations/zh-CN/content/codespaces/overview.md +++ b/translations/zh-CN/content/codespaces/overview.md @@ -40,6 +40,8 @@ You can also personalize aspects of your codespace environment by using a public For information on pricing, storage, and usage for {% data variables.product.prodname_github_codespaces %}, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." -{% data reusables.codespaces.codespaces-spending-limit-requirement %} For information on how organizations owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an organization, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." +{% data reusables.codespaces.codespaces-spending-limit-requirement %} + +{% data reusables.codespaces.codespaces-monthly-billing %} For information on how organizations owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an organization, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)." You can see who will pay for a codespace before you create it. For more information, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)." \ No newline at end of file diff --git a/translations/zh-CN/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md b/translations/zh-CN/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md index 8b6652eee4..9bbee8317c 100644 --- a/translations/zh-CN/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md +++ b/translations/zh-CN/content/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds.md @@ -14,7 +14,9 @@ redirect_from: ## Overview -Prebuilding your codespaces allows you to be more productive and access your codespace faster, particularly if your repository is large or complex and new codespaces currently take more than 2 minutes to start. This is because any source code, editor extensions, project dependencies, commands, and configurations have already been downloaded, installed, and applied before you create a codespace for your project. Think of a prebuild as a "ready-to-go" template for a codespace. +{% 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. 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. @@ -28,16 +30,10 @@ To create a prebuild you set up a prebuild configuration. When you save the conf 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. +As with other Actions workflows, running a prebuild configuration workflow will either consume some of the Actions minutes included with your account, if you have any, or it will incur charges for 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)." + 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. -## About billing for {% data variables.product.prodname_codespaces %} prebuilds - -{% data reusables.codespaces.billing-for-prebuilds-default %} For details of {% data variables.product.prodname_github_codespaces %} storage pricing, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." - -{% data reusables.codespaces.billing-for-prebuilds-reducing %} - -Use of codespaces created using prebuilds is charged at the same rate as regular codespaces. - ## 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 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. diff --git a/translations/zh-CN/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md b/translations/zh-CN/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md index 9c44b43045..5f8d82217a 100644 --- a/translations/zh-CN/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md +++ b/translations/zh-CN/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md @@ -61,7 +61,7 @@ Before you can configure prebuilds for your project the following must be true: {% note %} **Notes**: - * The prebuild for each region will incur individual charges. You should, therefore, only enable prebuilds for regions in which you know they'll be used. For more information, see "[About {% data variables.product.prodname_github_codespaces %} prebuilds](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds#about-billing-for-codespaces-prebuilds)." + * The prebuild for each region will incur individual charges. You should, therefore, only enable prebuilds for regions in which you know they'll be used. 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)." * Developers can set their default region for {% data variables.product.prodname_github_codespaces %}, which can allow you to enable prebuilds for fewer regions. For more information, see "[Setting your default region for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)." {% endnote %} diff --git a/translations/zh-CN/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md b/translations/zh-CN/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md index 500f61c322..7898abc4e9 100644 --- a/translations/zh-CN/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md +++ b/translations/zh-CN/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md @@ -1,6 +1,6 @@ --- -title: 自动链接引用和 URL -intro: 对 URL、议题、拉取请求和提交的引用会自动缩短并转换为链接。 +title: Autolinked references and URLs +intro: 'References to URLs, issues, pull requests, and commits are automatically shortened and converted into links.' redirect_from: - /articles/autolinked-references-and-urls - /github/writing-on-github/autolinked-references-and-urls @@ -11,68 +11,68 @@ versions: ghae: '*' ghec: '*' shortTitle: Auto linked references -ms.openlocfilehash: 6f6548dbe931a7a6adb809aa4e5616db4358c242 -ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d -ms.translationtype: HT -ms.contentlocale: zh-CN -ms.lasthandoff: 09/11/2022 -ms.locfileid: '147419687' --- -## URL +## URLs -{% data variables.product.product_name %} 自动从标准 URL 创建链接。 +{% data variables.product.product_name %} automatically creates links from standard URLs. `Visit https://github.com` - + -有关创建链接的详细信息,请参阅“[基本编写和格式设置语法](/articles/basic-writing-and-formatting-syntax/#links)”。 +For more information on creating links, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax/#links)." -## 议题和拉取请求 +## Issues and pull requests -在 {% data variables.product.product_name %} 上的对话中,对议题和拉取请求的引用将自动转换为缩短的链接。 +Within conversations on {% data variables.product.product_name %}, references to issues and pull requests are automatically converted to shortened links. {% note %} -**注意:** 在存储库的 wiki 或文件中没有创建自动链接的引用。 +**Note:** Autolinked references are not created in wikis or files in a repository. {% endnote %} -| 引用类型 | 原始引用 | 短链接 | +| Reference type | Raw reference | Short link | | --- | --- | --- | -| 问题或拉取请求 URL | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) -| `#` 和问题或拉取请求编号 | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | -| `GH-` 和问题或拉取请求编号 | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) | -| `Username/Repository#` 和问题或拉取请求编号 | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26) -| `Organization_name/Repository#` 和问题或拉取请求编号 | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039) +| Issue or pull request URL | https://github.com/jlord/sheetsee.js/issues/26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) +| `#` and issue or pull request number | #26 | [#26](https://github.com/jlord/sheetsee.js/issues/26) | +| `GH-` and issue or pull request number | GH-26 | [GH-26](https://github.com/jlord/sheetsee.js/issues/26) | +| `Username/Repository#` and issue or pull request number | jlord/sheetsee.js#26 | [jlord/sheetsee.js#26](https://github.com/jlord/sheetsee.js/issues/26) +| `Organization_name/Repository#` and issue or pull request number | github/linguist#4039 | [github/linguist#4039](https://github.com/github/linguist/pull/4039) -{% ifversion fpt or ghec %} 如果在列表中引用问题、拉取请求或讨论,则引用将展开以显示标题和状态。 有关任务列表的详细信息,请参阅“[关于任务列表](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)”。 +{% ifversion fpt or ghec %} +If you reference an issue, pull request, or discussion in a list, the reference will unfurl to show the title and state instead. For more information about task lists, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)." {% endif %} -## 标签 -在 Markdown 中引用标签的 URL 时,标签会自动呈现。 仅呈现同一存储库的标签,指向不同存储库标签的 URL 将呈现为任何 [URL](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#urls)。 +## Labels +When referencing the URL of a label in Markdown, the label is automatically rendered. Only labels of the same repository are rendered, URLs pointing to a label from a different repository are rendered as any [URL](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#urls). -通过导航到标签页并单击标签,可找到标签的 URL。 例如,公共[文档存储库](https://github.com/github/docs/)中标签“增强”的 URL 为 +The URL of a label can be found by navigating to the labels page and clicking on a label. For example, the URL of the label "enhancement" in our public [docs repository](https://github.com/github/docs/) is ```md https://github.com/github/docs/labels/enhancement ``` +{% note %} -## 提交 SHA +**Note:** If the label name contains a period (`.`), the label will not automatically render from the label URL. -对提交 SHA 哈希的引用会自动转换为指向 {% data variables.product.product_name %} 上提交的短链接。 +{% endnote %} -| 引用类型 | 原始引用 | 短链接 | +## Commit SHAs + +References to a commit's SHA hash are automatically converted into shortened links to the commit on {% data variables.product.product_name %}. + +| Reference type | Raw reference | Short link | | --- | --- | --- | -| 提交 URL | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | +| Commit URL | [`https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | | User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | [jlord@a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | `Username/Repository@SHA` | `jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e` | [`jlord/sheetsee.js@a5c3785`](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) | -## 自定义外部资源的自动链接 +## Custom autolinks to external resources {% data reusables.repositories.autolink-references %} -## 延伸阅读 +## Further reading -- “[基本编写和格式设置语法](/articles/basic-writing-and-formatting-syntax)” +- "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax)" diff --git a/translations/zh-CN/content/packages/learn-github-packages/about-permissions-for-github-packages.md b/translations/zh-CN/content/packages/learn-github-packages/about-permissions-for-github-packages.md index 18235d4ef4..68dd781bd9 100644 --- a/translations/zh-CN/content/packages/learn-github-packages/about-permissions-for-github-packages.md +++ b/translations/zh-CN/content/packages/learn-github-packages/about-permissions-for-github-packages.md @@ -26,14 +26,14 @@ The {% data variables.product.prodname_registry %} registries below **only** use - Apache Maven registry - NuGet registry -{% ifversion packages-npm-v2 %}For {% data variables.product.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} +{% ifversion packages-npm-v2 %}For {% data variables.packages.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} {% ifversion fpt or ghec %} ## Granular permissions for user/organization-scoped packages Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of the package separately from a repository that is connected (or linked) to a package. -Currently, the {% data variables.product.prodname_ghcr_and_npm_registry %} offer granular permissions for your container image packages. +Currently, the {% data variables.packages.prodname_ghcr_and_npm_registry %} offer granular permissions for your container image packages. ## Visibility and access permissions for container images diff --git a/translations/zh-CN/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md b/translations/zh-CN/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md index 536a07b00e..3e7204200c 100644 --- a/translations/zh-CN/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md +++ b/translations/zh-CN/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md @@ -15,7 +15,7 @@ shortTitle: Access control & visibility Packages with granular permissions are scoped to a personal user or organization account. You can change the access control and visibility of a package separately from the repository that it is connected (or linked) to. -Currently, you can only use granular permissions with the {% data variables.product.prodname_ghcr_and_npm_registry %}. Granular permissions are not supported in our other package registries, such as the RubyGems registry.{% ifversion docker-ghcr-enterprise-migration %} For more information about migration to the {% data variables.product.prodname_container_registry %}, see "[Migrating to the {% data variables.product.prodname_container_registry %} from the Docker registry](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)."{% endif %} +Currently, you can only use granular permissions with the {% data variables.packages.prodname_ghcr_and_npm_registry %}. Granular permissions are not supported in our other package registries, such as the RubyGems registry.{% ifversion docker-ghcr-enterprise-migration %} For more information about migration to the {% data variables.product.prodname_container_registry %}, see "[Migrating to the {% data variables.product.prodname_container_registry %} from the Docker registry](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)."{% endif %} For more information about permissions for repository-scoped packages, packages-related scopes for PATs, or managing permissions for your actions workflows, see "[About permissions for GitHub Packages](/packages/learn-github-packages/about-permissions-for-github-packages)." @@ -105,7 +105,7 @@ To further customize access to your container image, see "[Configuring access to {% ifversion fpt or ghec %} ## Ensuring {% data variables.product.prodname_github_codespaces %} access to your package -By default, a codespace can seamlessly access certain packages in the {% data variables.product.prodname_ghcr_and_npm_registry %}, such as those published in the same repository with the **Inherit access** option selected. For more information on which access is automatically configured, see "[Allowing your codespace to access a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry#accessing-images-stored-in-container-registry-and-npm-registry)." +By default, a codespace can seamlessly access certain packages in the {% data variables.packages.prodname_ghcr_and_npm_registry %}, such as those published in the same repository with the **Inherit access** option selected. For more information on which access is automatically configured, see "[Allowing your codespace to access a private image registry](/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry#accessing-images-stored-in-container-registry-and-npm-registry)." Otherwise, to ensure that a codespace has access to your package, you must grant access to the repository where the codespace is being launched. diff --git a/translations/zh-CN/content/packages/learn-github-packages/deleting-and-restoring-a-package.md b/translations/zh-CN/content/packages/learn-github-packages/deleting-and-restoring-a-package.md index 456eca2565..f3595a34ff 100644 --- a/translations/zh-CN/content/packages/learn-github-packages/deleting-and-restoring-a-package.md +++ b/translations/zh-CN/content/packages/learn-github-packages/deleting-and-restoring-a-package.md @@ -62,7 +62,7 @@ The {% data variables.product.prodname_registry %} registries below **only** use - Apache Maven registry - NuGet registry -{% ifversion packages-npm-v2 %}For {% data variables.product.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} +{% ifversion packages-npm-v2 %}For {% data variables.packages.prodname_ghcr_and_npm_registry %}, you can choose to allow packages to be scoped to a user, an organization, or linked to a repository.{% endif %} {% ifversion fpt or ghec %} diff --git a/translations/zh-CN/content/packages/learn-github-packages/introduction-to-github-packages.md b/translations/zh-CN/content/packages/learn-github-packages/introduction-to-github-packages.md index 5450ffcff9..530f6d7efe 100644 --- a/translations/zh-CN/content/packages/learn-github-packages/introduction-to-github-packages.md +++ b/translations/zh-CN/content/packages/learn-github-packages/introduction-to-github-packages.md @@ -51,7 +51,7 @@ For more information about the configuration of {% data variables.product.prodna | | | |--------------------|--------------------| -| Permissions | {% ifversion fpt or ghec %}The permissions for a package are either inherited from the repository where the package is hosted or, for packages in the {% data variables.product.prodname_ghcr_and_npm_registry %}, they can be defined for specific user or organization accounts. For more information, see "[Configuring a package’s access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." {% else %}Each package inherits the permissions of the repository where the package is hosted.
《欧洲经济区协定》(EEA 协定)规定将欧洲联盟的内部市场扩大到冰岛、列支敦士登和挪威这三个欧洲经济区国家。 欧盟数据保护立法,包括法规 (EU) 2016/679,受欧洲经济区协议的约束,并已纳入其附录 XI。 因此,就本条款而言,数据输入者向位于欧洲经济区的第三方披露的任何信息均不符合向外传输的条件。
- -(2) 根据第 7 条,在相应模块下加入这些条款的子处理方可能满足此要求。
- -(3) 关于此类法律和惯例对遵守这些条款的影响,可将不同的要素视为总体评估的一部分。 这些要素可包括公共当局以前要求披露或没有此类请求的相关且有案可稽的实践经验,涵盖有充分代表性的时限。 这特指内部记录或其他文件,这些文件是根据尽职调查连续起草的,并经高级管理层认证,前提是这些信息可以合法地与第三方共享。 如果依靠这一实际经验得出数据输入者遵守这些条款的结论,则需要得到其他相关客观要素的支持,缔约方应仔细考虑这些要素在可靠性和代表性方面是否具有足够的份量来支持这一结论。 特别是,缔约方必须考虑其实际经验是否得到证实,是否与关于同一部门内是否存在请求和/或实践中法律适用情况的公开可获得或以其他方式可获得的可靠信息相矛盾,例如判例法和独立监督机构的报告。
diff --git a/translations/zh-CN/content/site-policy/privacy-policies/index.md b/translations/zh-CN/content/site-policy/privacy-policies/index.md index cb44e91b91..8ff988753c 100644 --- a/translations/zh-CN/content/site-policy/privacy-policies/index.md +++ b/translations/zh-CN/content/site-policy/privacy-policies/index.md @@ -8,7 +8,6 @@ topics: children: - /github-privacy-statement - /global-privacy-practices - - /github-data-protection-agreement - /github-subprocessors-and-cookies - /github-codespaces-privacy-statement - /github-candidate-privacy-policy diff --git a/translations/zh-CN/data/reusables/codespaces/billing-for-prebuilds-default.md b/translations/zh-CN/data/reusables/codespaces/billing-for-prebuilds-default.md deleted file mode 100644 index 46a475db58..0000000000 --- a/translations/zh-CN/data/reusables/codespaces/billing-for-prebuilds-default.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -ms.openlocfilehash: 0036dd5cf979531479a7ddf523c7475391b29c0a -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: zh-CN -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147548006" ---- -默认情况下,每次创建或更新预生成或推送到启用预生成的分支时,都会触发 {% data variables.product.prodname_actions %} 工作流。 与其他工作流一样,虽然预生成工作流正在运行,但它们会消耗帐户中包含的一些 Actions 分钟数(如果有),或者它们会产生 Actions 分钟费用。 有关 Actions 分钟定价的详细信息,请参阅“[关于 {% data variables.product.prodname_actions %} 的计费](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)”。 - -除了 {% data variables.product.prodname_actions %} 分钟数,还将针对与给定存储库和区域的每个预生成配置关联的预生成的存储计费。 预生成的存储按与 codespace 存储相同的费率计费。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/codespaces/billing-for-prebuilds-reducing.md b/translations/zh-CN/data/reusables/codespaces/billing-for-prebuilds-reducing.md deleted file mode 100644 index 03f82b7b20..0000000000 --- a/translations/zh-CN/data/reusables/codespaces/billing-for-prebuilds-reducing.md +++ /dev/null @@ -1,3 +0,0 @@ -To reduce consumption of Actions minutes, you can set a prebuild to be updated only when you make a change to your dev container configuration files, or only on a custom schedule. You can also manage your storage usage by adjusting the number of template versions to be retained for your prebuild configurations. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." - -If you are an organization or enterprise owner, you can track usage of prebuild workflows and storage by downloading a {% data variables.product.prodname_actions %} usage report for your organization or enterprise. You can identify workflow runs for prebuilds by filtering the CSV output to only include the workflow called "Create {% data variables.product.prodname_github_codespaces %} Prebuilds." For more information, see "[Viewing your {% data variables.product.prodname_actions %} usage](/billing/managing-billing-for-github-actions/viewing-your-github-actions-usage#viewing-github-actions-usage-for-your-organization)." diff --git a/translations/zh-CN/data/reusables/codespaces/codespaces-billing.md b/translations/zh-CN/data/reusables/codespaces/codespaces-billing.md deleted file mode 100644 index 93a34628ab..0000000000 --- a/translations/zh-CN/data/reusables/codespaces/codespaces-billing.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -ms.openlocfilehash: 845c770a8a03c57a4c10a84d28fd4d3d78282042 -ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d -ms.translationtype: HT -ms.contentlocale: zh-CN -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147111120" ---- -{% data variables.product.prodname_codespaces %} 根据其计算和存储使用情况按美元计费。 - -### 计算计算使用情况 -计算使用情况定义为 {% data variables.product.prodname_github_codespaces %} 实例处于活动状态的运行时间总分钟数。 计算使用情况通过将所有 codespace 使用的实际分钟数相加来计算。 这些总数每天报告给计费服务,并按月计费。 - -运行时间通过停止 codespace 进行控制,可在开发人员指定的非活动期之后手动或自动完成。 有关详细信息,请参阅[关闭或停止 codespace](/codespaces/getting-started/deep-dive#closing-or-stopping-your-codespace)。 - -### 计算存储使用情况 -出于 {% data variables.product.prodname_github_codespaces %} 计费目的,这包括你帐户中所有 codespace 使用的所有存储空间。 这包括 codespace 使用的所有文件,例如克隆的存储库、配置文件和扩展等。 这些总数每天报告给计费服务,并按月计费。 到月底,{% data variables.product.prodname_dotcom %} 会将您的存储量舍入到最接近的 MB。 diff --git a/translations/zh-CN/data/reusables/codespaces/codespaces-spending-limit-requirement.md b/translations/zh-CN/data/reusables/codespaces/codespaces-spending-limit-requirement.md index e32b29f3f4..1322dfe4ae 100644 --- a/translations/zh-CN/data/reusables/codespaces/codespaces-spending-limit-requirement.md +++ b/translations/zh-CN/data/reusables/codespaces/codespaces-spending-limit-requirement.md @@ -5,5 +5,3 @@ {% endnote %} By default, your organization or enterprise will have a {% data variables.product.prodname_github_codespaces %} spending limit of $0. This prevents new codespaces from being created, or existing codespaces from being opened, if this would incur a billable cost to your organization or enterprise. To allow your users to create codespaces in your organization, set the limit to a value higher than $0. - -{% data reusables.billing.overages-billed-monthly %} diff --git a/translations/zh-CN/data/reusables/codespaces/creating-a-codespace-in-vscode.md b/translations/zh-CN/data/reusables/codespaces/creating-a-codespace-in-vscode.md index c89126ae76..545324000c 100644 --- a/translations/zh-CN/data/reusables/codespaces/creating-a-codespace-in-vscode.md +++ b/translations/zh-CN/data/reusables/codespaces/creating-a-codespace-in-vscode.md @@ -1,11 +1,5 @@ After you connect your account on {% data variables.product.product_location %} 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 %} marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces). -{% note %} - -**Note**: Currently, {% data variables.product.prodname_vscode_shortname %} doesn't allow you to choose a dev container configuration when you create a codespace. If you want to choose a specific dev container configuration, use the {% data variables.product.prodname_dotcom %} web interface to create your codespace. For more information, click the **Web browser** tab at the top of this page. - -{% endnote %} - {% data reusables.codespaces.click-remote-explorer-icon-vscode %} 2. Click the Add icon: {% octicon "plus" aria-label="The plus icon" %}. diff --git a/translations/zh-CN/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md b/translations/zh-CN/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md deleted file mode 100644 index 2d793635ac..0000000000 --- a/translations/zh-CN/data/reusables/dotcom_billing/pricing_calculator/pricing_cal_codespaces.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -ms.openlocfilehash: 86ebb6e0ab13cf7daf5fb580792bf8f4606eb054 -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a -ms.translationtype: HT -ms.contentlocale: zh-CN -ms.lasthandoff: 09/11/2022 -ms.locfileid: "147881914" ---- -若要估算消耗性服务的成本,可以使用 {% data variables.product.prodname_dotcom %} [定价计算器](https://github.com/pricing/calculator?feature=codespaces)。