diff --git a/translations/es-ES/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md b/translations/es-ES/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md index 2e602f02b3..4b325323cd 100644 --- a/translations/es-ES/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md +++ b/translations/es-ES/content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md @@ -252,4 +252,6 @@ Para obtener más información sobre cómo cambiar las políticas del límite de Puedes utilizar la API de REST de {% data variables.product.product_name %} para administrar tus cachés. {% ifversion actions-cache-list-delete-apis %}Puedes utilizar la API para listar y borrar entradas de caché y ver tu uso de caché.{% elsif actions-cache-management %}En la actualidad, puedes utilizar la API para ver tu uso de caché y esperar más funcionalidades en las actualizaciones futuras.{% endif %} Para obtener más información, consulta la sección "[Caché de {% data variables.product.prodname_actions %}](/rest/actions/cache)" en la documentación de la API de REST. +You can also install a {% data variables.product.prodname_cli %} extension to manage your caches from the command line. For more information about the extension, see [the extension documentation](https://github.com/actions/gh-actions-cache#readme). For more information about {% data variables.product.prodname_cli %} extensions, see "[Using GitHub CLI extensions](/github-cli/github-cli/using-github-cli-extensions)." + {% endif %} diff --git a/translations/es-ES/content/actions/using-workflows/events-that-trigger-workflows.md b/translations/es-ES/content/actions/using-workflows/events-that-trigger-workflows.md index 48b1d71459..fc54ce4459 100644 --- a/translations/es-ES/content/actions/using-workflows/events-that-trigger-workflows.md +++ b/translations/es-ES/content/actions/using-workflows/events-that-trigger-workflows.md @@ -415,7 +415,7 @@ on: {% data reusables.actions.branch-requirement %} -Ejecuta tu flujo de trabajo cuando alguien sube información a una rama que sea la fuente de publicación de {% data variables.product.prodname_pages %} si {% data variables.product.prodname_pages %} se encuentra habilitado para el repositorio. Para obtener más información sobre las fuentes de publicación de {% data variables.product.prodname_pages %}, consulta la sección "[Cojnfigurar una fuente de publicación para tu sitio de GitHub Pages](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)". Para obtener información acerca de la API de REST, consulta la sección "[Páginas](/rest/reference/repos#pages)". +Ejecuta tu flujo de trabajo cuando alguien sube información a una rama que sea la fuente de publicación de {% data variables.product.prodname_pages %} si {% data variables.product.prodname_pages %} se encuentra habilitado para el repositorio. Para obtener más información sobre las fuentes de publicación de {% data variables.product.prodname_pages %}, consulta la sección "[Cojnfigurar una fuente de publicación para tu sitio de GitHub Pages](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)". Para obtener información acerca de la API de REST, consulta la sección "[Páginas](/rest/reference/repos#pages)". Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento `page_build`. @@ -896,9 +896,9 @@ jobs: ### `subir` -| Carga del evento Webhook | Tipos de actividad | `GITHUB_SHA` | `GITHUB_REF` | -| ------------------------------------------------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------- | --------------- | -| [`subir`](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads/#push) | n/a | Confirmación subida, a menos que se elimine una rama (cuando se trata de la rama por defecto) | Ref actualizado | +| Carga del evento Webhook | Tipos de actividad | `GITHUB_SHA` | `GITHUB_REF` | +| ------------------------------------------------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------- | --------------- | +| [`subir`](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads/#push) | n/a | When you delete a branch, the SHA in the workflow run (and its associated refs) reverts to the default branch of the repository. | Ref actualizado | {% 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 30ba5946e7..ce6fbbd519 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 @@ -44,8 +44,9 @@ Si compraste {% data variables.product.prodname_enterprise %} mediante un Acuerd ### Facturación para las precompilaciones de los {% data variables.product.prodname_codespaces %} +{% data reusables.codespaces.billing-for-prebuilds-default %} -{% data reusables.codespaces.billing-for-prebuilds %} +{% data reusables.codespaces.billing-for-prebuilds-reducing %} ## Configurar un límite de gastos diff --git a/translations/es-ES/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md b/translations/es-ES/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md index 45bfc49294..f5d8b7b8b1 100644 --- a/translations/es-ES/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md +++ b/translations/es-ES/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md @@ -33,14 +33,14 @@ El {% data variables.product.prodname_dependabot %} crea las solicitudes de camb El {% data variables.product.prodname_dependabot %} puede activar flujos de trabajo de las {% data variables.product.prodname_actions %} en sus solicitudes de cambios y comentarios; sin embargo, algunos eventos se tratan de forma distinta. {% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5792 %} -Para el caso de los flujos de trabajo que inicia el {% data variables.product.prodname_dependabot %} (`github.actor == "dependabot[bot]"`) y que utilizan los eventos `pull_request`, `pull_request_review`, `pull_request_review_comment`, `push`, `create`, `deployment` y `deployment_status`, aplican las siguientes restricciones: +For workflows initiated by {% data variables.product.prodname_dependabot %} (`github.actor == 'dependabot[bot]'`) using the `pull_request`, `pull_request_review`, `pull_request_review_comment`, `push`, `create`, `deployment`, and `deployment_status` events, the following restrictions apply: {% endif %} - {% ifversion ghes = 3.3 %} El `GITHUB_TOKEN` tiene permisos de solo lectura, a menos de que tu adminsitrador haya eliminado las restricciones.{% else %} El `GITHUB_TOKEN` tiene permisos de solo lectura predeterminadamente.{% endif %} - {% ifversion ghes = 3.3 %}No se puede acceder a los secretos a menos de que tu administrador haya eliminado las restricciones.{% else %}Los secretos se llenan desde los secretos del {% data variables.product.prodname_dependabot %}. Los secretos de las {% data variables.product.prodname_actions %} no están disponibles.{% endif %} {% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5792 %} -Para el caso de los flujos de trabajo que inicia el {% data variables.product.prodname_dependabot %}(`github.actor == "dependabot[bot]"`) y utilizan el evento `pull_request_target`, si {% data variables.product.prodname_dependabot %} (`github.actor == "dependabot[bot]"`) creó la ref base de la solicitud de cambios, entonces el `GITHUB_TOKEN` será de solo lectura y los secretos no estarán disponibles. +For workflows initiated by {% data variables.product.prodname_dependabot %} (`github.actor == 'dependabot[bot]'`) using the `pull_request_target` event, if the base ref of the pull request was created by {% data variables.product.prodname_dependabot %} (`github.actor == 'dependabot[bot]'`), the `GITHUB_TOKEN` will be read-only and secrets are not available. {% endif %} {% ifversion actions-stable-actor-ids %}These restrictions apply even if the workflow is re-run by a different actor.{% endif %} diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace.md b/translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace.md index c6be14d5eb..5f39925329 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace.md @@ -111,7 +111,7 @@ If you would like to create a codespace for a repository owned by your personal **Notes** * You can bookmark the options page to give you a quick way to create a codespace for this repository and branch. - * The [https://github.com/codespaces/new](https://github.com/codespaces/new) page provides a quick way to create a codespace for any repository and branch. + * The [https://github.com/codespaces/new](https://github.com/codespaces/new) page provides a quick way to create a codespace for any repository and branch. You can get to this page quickly by typing `codespace.new` into your browser's address bar. * For more information about the `devcontainer.json` file, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)." * For more information about machine types, see "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)." * {% data reusables.codespaces.codespaces-machine-type-availability %} @@ -152,10 +152,10 @@ Alternatively, you can use flags to specify some or all of the options: gh codespace create -r owner/repo -b branch -m machine-type ``` -Replace `owner/repo` with the repository identifier. Replace `branch` with the name of the branch, or the full SHA hash of the commit, that you want to be initially checked out in the codespace. If you use the `-r` flag without the `b` flag, the codespace is created from the default branch. +In this example, replace `owner/repo` with the repository identifier. Replace `branch` with the name of the branch, or the full SHA hash of the commit, that you want to be initially checked out in the codespace. If you use the `-r` flag without the `b` flag, the codespace is created from the default branch. Replace `machine-type` with a valid identifier for an available machine type. Identifiers are strings such as: `basicLinux32gb` and `standardLinux32gb`. The type of machines that are available depends on the repository, your personal account, and your location. If you enter an invalid or unavailable machine type, the available types are shown in the error message. If you omit this flag and more than one machine type is available you will be prompted to choose one from a list. -For more information about this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_create). +For full details of the options for this command, see [the {% data variables.product.prodname_cli %} manual](https://cli.github.com/manual/gh_codespace_create). {% endcli %} diff --git a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md index a71b7d50c1..72397e5d8b 100644 --- a/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md +++ b/translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-repository-access-for-your-organizations-codespaces.md @@ -20,13 +20,13 @@ redirect_from: {% warning %} -**Aviso de obsolesencia**: El acceso y ajustes de seguridad ahora son obsoletos. Para habilitar un acceso expandido a otros repositorios, agrega los permisos solicitados a tu definición de contenedor dev. Si necesitas más información, consulta la sección "[Administrar el acceso a otros repositorios dentro de tu codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)". +**Deprecation note**: The access and security setting described below is now deprecated and is documented here for reference only. Para habilitar un acceso expandido a otros repositorios, agrega los permisos solicitados a tu definición de contenedor dev. Si necesitas más información, consulta la sección "[Administrar el acceso a otros repositorios dentro de tu codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)". {% endwarning %} Predeterminadamente, un codespace solo puede acceer al repositorio en donde se creó. Cuando habilitas el acceso y la seguridad de un repositorio que pertenece a tu organización, cualquier codespace que se cree para dicho repositorio también tendrá permisos de lectura en el resto de los repositorios que pertenezcan a esa misma organización y a los cuales pueda acceder el creador de dicho codespace. Si quieres restringir los repositorios a los cuales puede acceder un codespace, puedes limitarlos a ya sea el repositorio en donde se creó el codespace o a algunos repositorios específicos. Solo debes habilitar el acceso y la seguridad para los repositorios en los cuales confíes. -Para administrar qué usuarios de tu organización pueden utilizar {% data variables.product.prodname_github_codespaces %}, consulta la sección "[Administrar permisos de usuarios para tu organización](/codespaces/managing-codespaces-for-your-organization/managing-user-permissions-for-your-organization)". +To manage which users in your organization can use {% data variables.product.prodname_github_codespaces %}, see "[Enabling GitHub Codespaces for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#enable-codespaces-for-users-in-your-organization)." {% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} diff --git a/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md b/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md index 7843fa83d4..199a6e4554 100644 --- a/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md +++ b/translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md @@ -105,7 +105,7 @@ To create codespaces with custom permissions defined, you must use one of the fo ## Authorizing requested permissions -If additional repository permissions are defined in the `devcontainer.json` file, you will be prompted to review and optionally authorize the permissions when you create a codespace for this repository. When you authorize permissions for a repository, {% data variables.product.prodname_codespaces %} will not re-prompt you unless the set of requested permissions has changed for the repository. +If additional repository permissions are defined in the `devcontainer.json` file, you will be prompted to review and optionally authorize the permissions when you create a codespace or a prebuild configuration for this repository. When you authorize permissions for a repository, {% data variables.product.prodname_codespaces %} will not re-prompt you unless the set of requested permissions has changed for the repository. ![The requested permissions page](/assets/images/help/codespaces/codespaces-accept-permissions.png) @@ -117,7 +117,7 @@ You can only authorize permissions that your personal account already possesses. {% warning %} -**Deprecation note**: The access and security setting, in the {% data variables.product.prodname_codespaces %} section of your personal account settings, is now deprecated. To enable expanded access to other repositories, add the requested permissions to your dev container definition for your codespace, as described above. +**Deprecation note**: The access and security setting described below is now deprecated and is documented here for reference only. To enable expanded access to other repositories, add the requested permissions to your dev container definition for your codespace, as described above. {% endwarning %} 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 e343ef5139..77fb4405fc 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 @@ -18,19 +18,15 @@ El precompilar tus codespaces te permite ser más productivo y acceder a ellos m Predeterminadamente, cada que subas cambios a tu repositorio, {% data variables.product.prodname_github_codespaces %} utiliza {% data variables.product.prodname_actions %} para actualizar tus precompilaciones automáticamente. -Cuando las precompilaciones están disponibles para una rama en particular de un repositorio y para tu región, verás la etiqueta "{% octicon "zap" aria-label="The zap icon" %} Prebuild ready" en la lista de opciones de tipo de máquina al crear un codespace. Si se está creando una precompilación, verás la etiqueta "{% octicon "history" aria-label="The history icon" %} Prebuild in progress". Para obtener más información, consulta la sección "[Crear un codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)". +When prebuilds are available for a particular branch of a repository, a particular dev container configuration file, and for your region, you'll see the "{% octicon "zap" aria-label="The zap icon" %} Prebuild ready" label in the list of machine type options when you create a codespace. Si se está creando una precompilación, verás la etiqueta "{% octicon "history" aria-label="The history icon" %} Prebuild in progress". Para obtener más información, consulta la sección "[Crear un codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)". ![La caja de diálogo para elegir un tipo de máquina](/assets/images/help/codespaces/choose-custom-machine-type.png) -{% note %} - -{% data reusables.codespaces.prebuilds-not-available %} - -{% endnote %} - ## Acerca de la facturación para las precompilaciones de {% data variables.product.prodname_codespaces %} -{% data reusables.codespaces.billing-for-prebuilds %} Para obtener más detalles sobre los precios de almacenamiento de {% data variables.product.prodname_codespaces %}, consulta la sección "[Acerca de la facturación para {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". +{% data reusables.codespaces.billing-for-prebuilds-default %} Para obtener más detalles sobre los precios de almacenamiento de {% data variables.product.prodname_codespaces %}, consulta la sección "[Acerca de la facturación para {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)". + +{% data reusables.codespaces.billing-for-prebuilds-reducing %} El utilizar los codespaces creados utilizando precompilaciones se carga en la misma tasa que los codespaces normales. diff --git a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories.md b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories.md new file mode 100644 index 0000000000..78e72da050 --- /dev/null +++ b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories.md @@ -0,0 +1,63 @@ +--- +title: Allowing a prebuild to access other repositories +shortTitle: Allow external repo access +intro: You can permit your prebuild template access to other {% data variables.product.prodname_dotcom %} repositories so that it can be built successfully. +versions: + fpt: '*' + ghec: '*' +type: how_to +topics: + - Codespaces + - Set up +product: '{% data reusables.gated-features.codespaces %}' +permissions: People with admin access to a repository can configure prebuilds for the repository. +--- + +By default, the {% data variables.product.prodname_actions %} workflow for a prebuild configuration can only access its own repository contents. Your project may use additional resources, located elsewhere, to build the development environment. + +## Allowing a prebuild read access external resources + +You can configure read access to other {% data variables.product.prodname_dotcom %} repositories, with the same repository owner, by specifying permissions in the `devcontainer.json` file used by your prebuild configuration. For more information, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)." + +{% note %} + +**Note**: You can only authorize read permissions in this way, and the owner of the target repository must be the same as the owner of the repository for which you're creating a prebuild. For example, if you're creating a prebuild configuration for the `octo-org/octocat` repository, then you'll be able to grant read permissions for other `octo-org/*` repositories if this is specified in the `devcontainer.json` file, and provided you have the permissions yourself. + +{% endnote %} + +When you create or edit a prebuild configuration for a `devcontainer.json` file that sets up read access to other repositories with the same repository owner, you'll be prompted to grant these permissions when you click **Create** or **Update**. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." + +## Allowing a prebuild write access external resources + +If your project requires write access to resources, or if the external resources reside in a repository with a different owner to the repository for which you are creating a prebuild configuration, you can use a personal access token (PAT) to grant this access. + +You will need to create a new personal account and then use this account to create a PAT with the appropriate scopes. + +1. Create a new personal account on {% data variables.product.prodname_dotcom %}. + + {% warning %} + + **Warning**: Although you can generate the PAT using your existing personal account, we strongly recommend creating a new account with access only to the target repositories required for your scenario. This is because the access token's `repository` permission grants access to all of the repositories that the account has access to. For more information, see "[Signing up for a new GitHub account](/get-started/signing-up-for-github/signing-up-for-a-new-github-account)" and "[Security hardening for {% data variables.product.prodname_actions %}](/actions/security-guides/security-hardening-for-github-actions#considering-cross-repository-access)." + + {% endwarning %} +1. Give the new account read access to the required repositories. For more information, see "[Managing an individual's access to an organization repository](/organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository)." +1. While signed into the new account, create a PAT with the `repo` scope. Optionally, if the prebuild will need to download packages from the {% data variables.product.company_short %} {% data variables.product.prodname_container_registry %}, also select the `read:packages` scope. For more information, see "[Creating a personal access token](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)." + + !['repo' and 'packages' scopes selected for a PAT](/assets/images/help/codespaces/prebuilds-select-scopes.png) + + If the prebuild will use a package from the {% data variables.product.company_short %} {% data variables.product.prodname_container_registry %}, you will need to either grant the new account access to the package or configure the package to inherit the access permissions of the repository you are prebuilding. For more information, see "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." +{% ifversion ghec %}1. Authorize the token for use with SAML single sign-on (SSO), so that it can access repositories that are owned by organizations with SSO enabled. For more information, see "[Authorizing a personal access token for use with SAML single sign-on](/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)." + + ![The button to configure SSO for a PAT](/assets/images/help/codespaces/configure-SSO-for-PAT.png) + +{% endif %} +1. Copy the token string. You will assign this to a {% data variables.product.prodname_codespaces %} repository secret. +1. Sign back into the account that has admin access to the repository. +1. In the repository for which you want to create {% data variables.product.prodname_codespaces %} prebuilds, create a new {% data variables.product.prodname_codespaces %} repository secret called `CODESPACES_PREBUILD_TOKEN`, giving it the value of the token you created and copied. For more information, see "[Managing encrypted secrets for your repository and organization for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces#adding-secrets-for-a-repository)." + +The PAT will be used for all subsequent prebuild templates created for your repository. Unlike other {% data variables.product.prodname_codespaces %} repository secrets, the `CODESPACES_PREBUILD_TOKEN` secret is only used for prebuilding and will not be available to use in codespaces created from your repository. + +## Further reading + +- "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds)" +- "[Troubleshooting prebuilds](/codespaces/troubleshooting/troubleshooting-prebuilds)" 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 dc0580d5bf..c3beed5e20 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 @@ -13,13 +13,11 @@ product: '{% data reusables.gated-features.codespaces %}' permissions: People with admin access to a repository can configure prebuilds for the repository. --- -Puedes ajustar una configuración de precompilación para una rama específica de tu repositorio. +You can set up a prebuild configuration for the combination of a specific branch of your repository with a specific dev container configuration file. -Habitualmente, a cualquier rama que se cree de una rama base con precompilación habilitada habitualmente también se le asignará una precompilación durante la creación del codespace. Esto es cierto si el contenedor dev en la rama es el mismo que en la rama base. Esto es porque la mayoría de las configuraciones de precompilación de las ramas con la misma configuración de contenedor dev son idénticas, así que los desarrolladores también pueden beneficiarse de tener tiempos más rápidos de creación de codespaces en dichas ramas. Para obtener más información, consulta la sección "[Introducción a los contenedores dev](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". +Any branches created from a prebuild-enabled parent branch will typically also get prebuilds for the same dev container configuration. This is because the prebuild template for child branches that use the same dev container configuration as the parent branch are, for the most part, identical, so developers can benefit from faster codespace creation times on those branches also. Para obtener más información, consulta la sección "[Introducción a los contenedores dev](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)". -Habitualmente, cuando configuras las precompilaciones de una rama, estas estarán disponibles para los tipos de máquina de {% data variables.product.prodname_github_codespaces %} para dicha rama. Sin embargo, si tu repositorio es mayor a 32 GB, las precompilaciones no estarán disponibles para los tipos de máquina de 2 y 4 núcleos, ya que el almacenamiento que estos proporcionan se limita a 32 GB. - -{% data reusables.codespaces.prebuilds-not-available %} +Typically, when you configure prebuilds for a branch, prebuilds will be available for multiple machine types. Sin embargo, si tu repositorio es mayor a 32 GB, las precompilaciones no estarán disponibles para los tipos de máquina de 2 y 4 núcleos, ya que el almacenamiento que estos proporcionan se limita a 32 GB. ## Prerrequisitos @@ -32,20 +30,24 @@ Antes de que configures las precompilaciones para tu proyecto, se debe cumplir c {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} 1. En la sección de "Automatización & código" de la barra lateral, haz clic en **{% octicon "codespaces" aria-label="The Codespaces icon" %} {% data variables.product.prodname_codespaces %}**. -1. Debajo de "Configuración de precompilación", haz clic en **Configurar precompilación**. +1. In the "Prebuild configuration" section of the page, click **Set up prebuild**. ![El botón de 'Configurar precompilaciones'](/assets/images/help/codespaces/prebuilds-set-up.png) 1. Elige la rama para la cual quieres configurar una precompilación. - ![El menú desplegable la rama](/assets/images/help/codespaces/prebuilds-choose-branch.png) + ![The branch drop-down menu](/assets/images/help/codespaces/prebuilds-choose-branch.png) {% note %} - **Nota**: Cualquier rama que se cree de una rama base habilitada para precompilaciones también obtendrá precompilaciones habitualmente. Por ejemplo, si habilitas las precompilaciones para la rama predeterminada del repositorio, las ramas que se basen en la predeterminada, en la mayoría de los casos, también obtendrán precompilaciones. + **Note**: Any branches created from a prebuild-enabled base branch will typically also get prebuilds for the same dev container configuration. For example, if you enable prebuilds for a dev container configuration file on the default branch of the repository, branches based on the default branch will, in most cases, also get prebuilds for the same dev container configuration. {% endnote %} +1. Optionally, in the **Configuration file** drop-down menu that's displayed, choose the `devcontainer.json` configuration file that you want to use for this prebuild template. Para obtener más información, consulta la sección "[Introducción a los contenedores dev](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)." + + ![The configuration file drop-down menu](/assets/images/help/codespaces/prebuilds-choose-configfile.png) + 1. Elige cómo quieres activar automáticamente las actualizaciones de la plantilla de precompilación. * **Cada subida** (el ajuste predeterminado) - Con este ajuste, las configuraciones de precompilación se actualizarán en cada subida que se haga a la rama predeterminada. Esto garantizará que los codespaces que se generen de una plantilla de precompilación siempre contengan la configuración de codespace más reciente, incluyendo cualquier dependencia que se haya actualizado o agregado recientemente. @@ -54,19 +56,19 @@ Antes de que configures las precompilaciones para tu proyecto, se debe cumplir c ![Las opciones de activación de precompilación](/assets/images/help/codespaces/prebuilds-triggers.png) -1. Selecciona **Reducir la precompilación disponible para solo las regiones específicas** para limitar el acceso a tu imagen precompilada y luego selecciona en qué regiones quieres que esté disponible. Los desarrolladores solo pueden crear condespaces desde una precompilación si estos se ubican en una región que selecciones. Predeterminadamente, tu imagen de precompilación se encuentra disponible a todas las regiones en donde están disponibles los codespaces y aplican costos de almacenamiento para cada región. +1. Optionally, select **Reduce prebuild available to only specific regions** to limit access to your prebuild template, then select which regions you want it to be available in. Los desarrolladores solo pueden crear condespaces desde una precompilación si estos se ubican en una región que selecciones. By default, your prebuild template is available to all regions where codespaces is available and storage costs apply for each region. ![Las opciones de selección de región](/assets/images/help/codespaces/prebuilds-regions.png) {% note %} **Notas**: - * La plantilla de precompilación para cada región incurrirá en cargos individuales. Por lo tanto, solo deberías habilitar las precompilaciones para las regiones en las que sabes que se utilizarán. Para obtener más información, consulta la sección "[Acerca de las precompilaciones de {% data variables.product.prodname_github_codespaces %}](/codespaces/prebuilding-your-codespaces/about-codespaces-prebuilds#about-billing-for-github-codespaces-prebuilds)". + * La plantilla de precompilación para cada región incurrirá en cargos individuales. Por lo tanto, solo deberías habilitar las precompilaciones para las regiones en las que sabes que se utilizarán. Para obtener más información, consulta la sección "[Acerca de las precompilaciones de {% data variables.product.prodname_github_codespaces %}](/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds#about-billing-for-codespaces-prebuilds)". * Los desarrolladores pueden configurar su región predeterminada para {% data variables.product.prodname_codespaces %}, lo que te puede permitir habilitar las precompilaciones para menos regiones. Para obtener más información, consulta la sección "[Configurar tu región predeterminada para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)". {% endnote %} -1. Configura la cantidad de versiones de plantillas de precompilación a retener. Puedes ingresar cualquier número entre 1 y 5. La cantidad predeterminada de versiones guardadas es de 2, lo que significa que solo la versión de plantilla más reciente y la versión previa se guardan. +1. Optionally, set the number of prebuild template versions to be retained. Puedes ingresar cualquier número entre 1 y 5. La cantidad predeterminada de versiones guardadas es de 2, lo que significa que solo la versión de plantilla más reciente y la versión previa se guardan. Dependiendo de los ajustes de activación de la precompilación, tu plantilla de precompilación podría cambiar con cada subida o en cada cambio de configuración de contenedor dev. El retener versiones anteriores de plantillas de precompilación te permite crear una precompilación desde una confirmación antigua con una configuración de contenedor dev diferente que la plantilla de precompilación actual. Ya que existe un costo de almacenamiento asociado con la retención de versiones de plantilla de precompilación, puedes elegir la cantidad de versiones a retener con base en las necesidades de tu equipo. Para obtener más información sobre la facturación, consulta la sección "[Acerca de la facturación para los {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#codespaces-pricing)". @@ -74,33 +76,27 @@ Antes de que configures las precompilaciones para tu proyecto, se debe cumplir c ![El ajuste de historial de plantilla de precompilación](/assets/images/help/codespaces/prebuilds-template-history-setting.png) -1. Agrega usuarios o equipos para notificarles cuando falla la ejecución de flujo de trabajo de la precompilación para esta configuración. Puedes comenzar a escribir un nombre de usuario, de equipo o nombre completo y luego hacer clic en el nombre una vez que aparezca para agregarlos a la lista. Los usuarios o equipos que agregues recibirán un correo electrónico cuando ocurran fallas en la precompilación, los cuales contienen un enlace a las bitácoras de ejecución de flujo de trabajo para ayudar con las investigaciones subsecuentes. +1. Optionally, add users or teams to notify when the prebuild workflow run fails for this configuration. Puedes comenzar a escribir un nombre de usuario, de equipo o nombre completo y luego hacer clic en el nombre una vez que aparezca para agregarlos a la lista. Los usuarios o equipos que agregues recibirán un correo electrónico cuando ocurran fallas en la precompilación, los cuales contienen un enlace a las bitácoras de ejecución de flujo de trabajo para ayudar con las investigaciones subsecuentes. ![El ajuste de notificación de falla de precompilación](/assets/images/help/codespaces/prebuilds-failure-notification-setting.png) 1. Da clic en **Crear**. - La configuración de precompilación se lista en la página de {% data variables.product.prodname_codespaces %} de tus ajustes de repositorio. Un flujo de trabajo de {% data variables.product.prodname_actions %} se pone en cola y luego se ejecuta para crear plantillas de precompilación en la rama que seleccionaste y en las regiones que especificaste. + {% data reusables.codespaces.prebuilds-permission-authorization %} - {% note %} +After you create a prebuild configuration it is listed on the {% data variables.product.prodname_codespaces %} page of your repository settings. A {% data variables.product.prodname_actions %} workflow is queued and then run to create prebuild templates in the regions you specified, based on the branch and dev container configuration file you selected. - **Nota**: Predeterminadamente, el flujo de trabajo de {% data variables.product.prodname_actions %} para una configuración de precompilación solo puede acceder a los recursos de su propio repositorio. Si tu proyecto utiliza recursos desde fuera del repositorio, necesitarás configurar el secreto `CODESPACES_PREBUILD_TOKEN` para obtener el acceso requerido. Para obtener más información, consulta la sección "[Permitir que una precompilación acceda a los recursos externos](/codespaces/prebuilding-your-codespaces/managing-prebuilds#allowing-a-prebuild-to-access-external-resources)". +![Screenshot of the list of prebuild configurations](/assets/images/help/codespaces/prebuild-configs-list.png) - {% endnote %} - -## Configurar el acceso a los recursos que no están en el repositorio - -Predeterminadamente, el flujo de trabajo de {% data variables.product.prodname_actions %} para una configuración de compilación previa solo puede acceder al contenido de su propio repositorio. Si tu proyecto necesita acceder a recursos internos para compilar el ambiente de desarrollo, necesitarás configurar un token de acceso personal (PAT) con los alcances de acceso adecuados. - -Para obtener más información, consulta la sección "[Permitir que una compilación previa acceda a recursos externos](/codespaces/prebuilding-your-codespaces/managing-prebuilds#allowing-a-prebuild-to-access-external-resources)". +For information about editing and deleting prebuild configurations, see "[Managing prebuilds](/codespaces/prebuilding-your-codespaces/managing-prebuilds)." ## Configurar variables de ambiente -Para permitir que el proceso de precompilación acceda a las variables de ambiente que se requieren para crear tu ambiente de desarrollo, puedes configurarlas ya sea como secretos de repositorio de {% data variables.product.prodname_codespaces %} o como secretos de organización de {% data variables.product.prodname_codespaces %}. Para obtener más información, consulta las secciones "[Agregar secretos para un repositorio](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-codespaces#adding-secrets-for-a-repository)" y "[Agregar secretos para una organización](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-codespaces#adding-secrets-for-an-organization)". +Para permitir que el proceso de precompilación acceda a las variables de ambiente que se requieren para crear tu ambiente de desarrollo, puedes configurarlas ya sea como secretos de repositorio de {% data variables.product.prodname_codespaces %} o como secretos de organización de {% data variables.product.prodname_codespaces %}. Para obtener más información, consulta las secciones "[Agregar secretos para un repositorio](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces#adding-secrets-for-a-repository)" y "[Agregar secretos para una organización](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces#adding-secrets-for-an-organization)". -Las precompilaciones no utilizan ningún secreto a nivel de usuario mientras compilan tu ambiente, porque estos no se agregan sino hasta después de que se haya creado el codespace. +Secrets that you create in this way will be accessible by anyone who creates a codespace from this repository. Si no quieres esto, como alternativa, puedes configurar el secreto `CODESPACES_PREBUILD_TOKEN`. El secreto `CODESPACES_PREBUILD_TOKEN` solo se utiliza para precompilar y no se puede acceder a su valor en los codespaces de los usuarios. -Cualquiera que cree un codespace desde este repositorio podrá acceder a los secretos de {% data variables.product.prodname_codespaces %} que crees de esta forma. Si no quieres esto, como alternativa, puedes configurar el secreto `CODESPACES_PREBUILD_TOKEN`. El secreto `CODESPACES_PREBUILD_TOKEN` solo se utiliza para precompilar y no se puede acceder a su valor en los codespaces de los usuarios. Para obtener más información, consulta la sección "[Permitir que una compilación previa acceda a recursos externos](/codespaces/prebuilding-your-codespaces/managing-prebuilds#allowing-a-prebuild-to-access-external-resources)". +Prebuilds cannot use any user-level secrets while building your environment, because these are not available until after the codespace has been created. ## Configurar tareas que llevan mucho tiempo para que se incluyan en la precompilación @@ -110,4 +106,5 @@ Puedes utilizar los comandos `onCreateCommand` y `updateContentCommand` en tu `d ## Leer más +- "[Allowing a prebuild to access other repositories](/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories)" - "[Solucionar problemas de las compilaciones previas](/codespaces/troubleshooting/troubleshooting-prebuilds)" diff --git a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/index.md b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/index.md index c6aecf50c1..59f45ee95e 100644 --- a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/index.md +++ b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/index.md @@ -12,6 +12,7 @@ redirect_from: children: - /about-github-codespaces-prebuilds - /configuring-prebuilds + - /allowing-a-prebuild-to-access-other-repositories - /managing-prebuilds - /testing-dev-container-changes --- diff --git a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md index f2e4d810ec..0680eb1705 100644 --- a/translations/es-ES/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md +++ b/translations/es-ES/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md @@ -1,7 +1,7 @@ --- -title: Managing prebuilds -shortTitle: Manage prebuilds -intro: 'You can review, modify, and delete the prebuild configurations for your repository.' +title: Administrar las precompilaciones +shortTitle: Administrar las precompilaciones +intro: 'Puedes revisar, modificar y borrar las configuraciones de precompilación de tu repositorio.' versions: fpt: '*' ghec: '*' @@ -12,113 +12,88 @@ product: '{% data reusables.gated-features.codespaces %}' miniTocMaxHeadingLevel: 3 --- -## Checking, changing, and deleting your prebuild configurations +## Verificar, cambiar y borrar tus configuraciones de precompilación -The prebuilds that you configure for a repository are created and updated using a {% data variables.product.prodname_actions %} workflow, managed by the {% data variables.product.prodname_github_codespaces %} service. +Las precompilaciones que configures para un repositorio se crean y actualizan utilizando un flujo de trabajo de {% data variables.product.prodname_actions %}, que administra el servicio de {% data variables.product.prodname_github_codespaces %}. -Depending on the settings in a prebuild configuration, the workflow to update the prebuild template may be triggered by these events: +Dependiendo de los ajustes en una configuración de precompilación, el flujo de trabajo para actualizar la plantilla de precompilación podría activarse con estos eventos: -* Creating or updating the prebuild configuration -* Pushing a commit or a pull request to a branch that's configured to have prebuilds -* Changing any of the dev container configuration files -* A schedule that you've defined in the prebuild configuration -* Manually triggering the workflow +* Crear o actualizar la configuración de precompilación +* Subir una confirmación o una solicitud de cambios a una rama que está configurada para tener precompilaciones +* Cambiar cualquiera de los archivos de configuración del contenedor dev +* Un itinerario que definiste en la configuración de la precompilación +* Activar el flujo de trabajo manualmente -The settings in the prebuild configuration determine which events automatically trigger an update of the prebuild template. For more information, see "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)." +Los ajustes en la configuración de precompilación determinan qué eventos activan automáticamente una actualización de la plantilla de precompilación. Para obtener más información, consulta la sección "[Configurar las precompilaciones](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)". -People with admin access to a repository can check the progress of prebuilds, edit, and delete prebuild configurations. +Las personas con acceso administrativo a un repositorio pueden verificar el progreso de las precompilaciones, así como editar y borrar las configuraciones de estas. -### Viewing the progress of prebuilds -You can view the current status of the latest workflow run for each prebuild configuration you've set up on the {% data variables.product.prodname_codespaces %} page of your repository settings. For example, "Currently running" or "Last run 1 hour ago." +### Ver el progreso de las precompilaciones +Pudes ver el estado actual de la ejecución de flujo de trabajo más reciente para cada configuración de precompilación que hayas ajustado en la página de {% data variables.product.prodname_codespaces %} de tus ajustes de repositorio. Por ejemplo, "Actualmente en ejecución" o "Última ejecución hace 1 hora". -To see the log output for the latest prebuild workflow run, click **See output**. +Para ver la salida de bitácora de la ejecución de flujo de trabajo de la precompilación más reciente, haz clic en **Ver la salida**. -![The 'See output' button](/assets/images/help/codespaces/prebuilds-see-output.png) +![El botón de 'Ver salida'](/assets/images/help/codespaces/prebuilds-see-output.png) -This displays the output of the most recent run of the workflow in the **Actions** tab. +Esto muestra la salida de la ejecución más reciente del flujo de trabajo en la pestaña de **Acciones**. -![The prebuild workflow output](/assets/images/help/codespaces/prebuilds-log-output.png) +![La salida de flujo de trabajo de precompilación](/assets/images/help/codespaces/prebuilds-log-output.png) -Alternatively, to view all prebuild workflow runs associated with the specified branch, click the ellipsis button and choose **View runs** from the dropdown menu. +Como alternativa, para ver todas las ejecuciones de flujo de trabajo de una precompilación asociadas con la rama especificada, haz clic en el botón de puntos suspensivos y elige **Ver ejecuciones** del menú desplegable. -![The 'View runs' option in the drop-down menu](/assets/images/help/codespaces/prebuilds-view-runs.png) +![La opción de 'Ver ejecuciones' en el menú desplegable](/assets/images/help/codespaces/prebuilds-view-runs.png) -This displays the workflow run history for prebuilds for the associated branch. +Esto muestra el historial de ejecución de flujo de trabajo para las precompilaciones para la rama asociada. -![The workflow run history](/assets/images/help/codespaces/prebuilds-workflow-runs.png) +![El historial de ejecución de flujo de trabajo](/assets/images/help/codespaces/prebuilds-workflow-runs.png) -### Editing a prebuild configuration +### Editar una configuración de precompilación -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to edit. -1. In the dropdown menu, click **Edit**. - - ![The 'Edit' option in the drop-down menu](/assets/images/help/codespaces/prebuilds-edit.png) +1. En la página de {% data variables.product.prodname_codespaces %} de tus ajustes de repositorio, haz clic en los puntos suspensivos a la derecha de la configuración de precompilación que quieras editar. +1. En el menú desplegable, haz clic en **Editar**. -1. Make the required changes to the prebuild configuration, then click **Update**. + ![La opción de 'Editar' en el menú desplegable](/assets/images/help/codespaces/prebuilds-edit.png) -### Disabling a prebuild configuration +1. Haz los cambios requeridos en la configuración de precompilación y luego haz clic en **Actualizar**. -To pause the update of prebuild templates for a configuration, you can disable workflow runs for the configuration. Disabling the workflow runs for a prebuild configuration does not delete any previously created prebuild templates for that configuration and, as a result, codespaces will continue to be generated from an existing prebuild template. + {% data reusables.codespaces.prebuilds-permission-authorization %} -Disabling the workflow runs for a prebuild configuration is useful if you need to investigate template creation failures. -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to disable. -1. In the dropdown menu, click **Disable runs**. +### Inhabilitar una configuración de precompilación - ![The 'Disable runs' option in the drop-down menu](/assets/images/help/codespaces/prebuilds-disable.png) +Para pausar la actualización de las plantillas de precompilación de una configuración, puedes inhabilitar las ejecuciones de flujo de trabajo para dicha configuración. El inhabilitar las ejecuciones de flujo de trabajo para una configuración de precompilación no borra ninguna plantilla de precompilación creada anteriormente para dicha configuración y, como resultado, los codespaces seguirán generándose desde una plantilla de precompilación existente. -1. To confirm that you want to disable this configuration, click **OK**. +El inhabilitar las ejecuciones de flujos de trabajo para una configuración precompilada es útil si necesitas investigar los fallos en la creación de plantillas. -### Deleting a prebuild configuration +1. En la página de {% data variables.product.prodname_codespaces %} de tus ajustes de repositorio, haz clic en los puntos suspensivos a la derecha de la configuración de precompilación que quieras inhabilitar. +1. En el menú desplegable, haz clic en **Inhabilitar ejecuciones**. -Deleting a prebuild configuration also deletes all previously created prebuild templates for that configuration. As a result, shortly after you delete a configuration, prebuilds generated by that configuration will no longer be available when you create a new codespace. + ![La opción de 'Inhabilitar ejecuciones' en el menú desplegable](/assets/images/help/codespaces/prebuilds-disable.png) -After you delete a prebuild configuration, workflow runs for that configuration that have been queued or started will still run. They will be listed in the workflow run history, along with previously completed workflow runs. +1. Para confirmar que quieres inhabilitar esta configuración, haz clic en **OK**. -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to delete. -1. In the dropdown menu, click **Delete**. +### Borrar una configuración de precompilación - ![The 'Delete' option in the drop-down menu](/assets/images/help/codespaces/prebuilds-delete.png) +El borrar una configuración de preocmpilación también borrar todas las plantillas de precompilación que se hayan creado previamente para dicha configuración. Como resultado, poco después de que borres una configuración, las precompilaciones generadas por dicha configuración ya no estarán disponibles cuando crees un codespace nuevo. -1. Click **OK** to confirm the deletion. +Después de que borras una configuración de precompilación, todavía se ejecutarán las ejecuciones de flujo de trabajo de dicha configuración que se hayan puesto en cola o que hayan iniciado. Se listarán en el historial de ejecución de flujo de trabajo junto con las ejecuciones de flujo de trabajo que se hayan completado previamente. -### Manually trigger prebuilds +1. En la página de {% data variables.product.prodname_codespaces %} de tus ajustes de repositorio, haz clic en los puntos suspensivos a la derecha de la configuración de precompilación que quieras borrar. +1. En el menú desplegable, haz clic en **Borrar**. -It may be useful to manually trigger a workflow run for a prebuild configuration. Generally this is only necessary if you are debugging a problem with the workflow for a prebuild configuration. + ![La opción de 'Borrar' en el menú desplegable](/assets/images/help/codespaces/prebuilds-delete.png) -1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration whose workflow you want to trigger. -1. In the dropdown menu, click **Manually trigger**. +1. Haz clic en **OK** para confirmar el borrado. - ![The 'Manually trigger' option in the drop-down menu](/assets/images/help/codespaces/prebuilds-manually-trigger.png) +### Activar las precompilaciones manualmente -## Allowing a prebuild to access external resources +Puede ser útil activar una ejecución de flujo de trabajo manualmente para una configuración precompilada. Generalmente, esto solo es necesario si estás depurando un problema con el flujo de trabajo de una configuración de precompilación. -By default, the {% data variables.product.prodname_actions %} workflow for a prebuild configuration can only access its own repository contents. Your project may use additional resources to build the development environment, such as files in other repositories, packages, GHCR images, and APIs. To allow your prebuild setup to access these resources, you will need to create a new personal account and then use this account to create a personal access token (PAT) with the appropriate scopes. +1. En la página de {% data variables.product.prodname_codespaces %} de tus ajustes de repositorio, haz clic en los puntos suspensivos a la derecha de la configuración de precompilación cuyo flujo de trabajo quieras activar. +1. En el menú desplegable, haz clic en **Activar manualmente**. -1. Create a new personal account on {% data variables.product.prodname_dotcom %}. - - {% warning %} - - **Warning**: Although you can generate the PAT using your existing personal account, we strongly recommend creating a new account with access only to the target repositories required for your scenario. This is because the access token's `repository` permission grants access to all of the repositories that the account has access to. For more information, see "[Signing up for a new GitHub account](/get-started/signing-up-for-github/signing-up-for-a-new-github-account)" and "[Security hardening for {% data variables.product.prodname_actions %}](/actions/security-guides/security-hardening-for-github-actions#considering-cross-repository-access)." - - {% endwarning %} -1. Give the new account read access to the required repositories. For more information, see "[Managing an individual's access to an organization repository](/organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository)." -1. While signed into the new account, create a PAT with the `repo` scope. Optionally, if the prebuild will need to download packages from the {% data variables.product.company_short %} {% data variables.product.prodname_container_registry %}, also select the `read:packages` scope. For more information, see "[Creating a personal access token](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)." + ![La opción de 'Activar manualmente' en le menú desplegable](/assets/images/help/codespaces/prebuilds-manually-trigger.png) - !['repo' and 'packages' scopes selected for a PAT](/assets/images/help/codespaces/prebuilds-select-scopes.png) - - If the prebuild will use a package from the {% data variables.product.company_short %} {% data variables.product.prodname_container_registry %}, you will need to either grant the new account access to the package or configure the package to inherit the access permissions of the repository you are prebuilding. For more information, see "[Configuring a package's access control and visibility](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." -{% ifversion ghec %}1. Authorize the token for use with SAML single sign-on (SSO), so that it can access repositories that are owned by organizations with SSO enabled. For more information, see "[Authorizing a personal access token for use with SAML single sign-on](/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)." +## Leer más - ![The button to configure SSO for a PAT](/assets/images/help/codespaces/configure-SSO-for-PAT.png) - -{% endif %} -1. Copy the token string. You will assign this to a {% data variables.product.prodname_codespaces %} repository secret. -1. Sign back into the account that has admin access to the repository. -1. In the repository for which you want to create {% data variables.product.prodname_codespaces %} prebuilds, create a new {% data variables.product.prodname_codespaces %} repository secret called `CODESPACES_PREBUILD_TOKEN`, giving it the value of the token you created and copied. For more information, see "[Managing encrypted secrets for your repository and organization for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-codespaces-for-your-organization/managing-encrypted-secrets-for-your-repository-and-organization-for-github-codespaces#adding-secrets-for-a-repository)." - -The PAT will be used for all subsequent prebuild templates created for your repository. Unlike other {% data variables.product.prodname_codespaces %} repository secrets, the `CODESPACES_PREBUILD_TOKEN` secret is only used for prebuilding and will not be available to use in codespaces created from your repository. - -## Further reading - -- "[Troubleshooting prebuilds](/codespaces/troubleshooting/troubleshooting-prebuilds)" +- "[Solucionar problemas de las compilaciones previas](/codespaces/troubleshooting/troubleshooting-prebuilds)" diff --git a/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-prebuilds.md b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-prebuilds.md index 1ade71b23d..ed3757d254 100644 --- a/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-prebuilds.md +++ b/translations/es-ES/content/codespaces/troubleshooting/troubleshooting-prebuilds.md @@ -55,8 +55,14 @@ Aquí tienes lo que puedes verificar si la etiqueta de "{% octicon "zap" aria-la * Verifica si el cambio en el contenedor dev se subió recientemente en la rama habilitada para precompilación. De ser así, habitualmente tendrás que esperar hasta que la ejecución de flujo de trabajo de precompilación para esta subida se complete antes de que las precompilaciones estén disponibles nuevamente. * Si no se hicieron cambios de configuración recientemente, dirígete a la pestaña de **Acciones** de tu repositorio, haz clic en **{% octicon "codespaces" aria-label="The Codespaces icon" %} Preconfiguraciones de los {% data variables.product.prodname_codespaces %} ** en la lista de flujos de trabajo y verifica que las ejecuciones de flujo de trabajo precompliladas para la rama estén teniendo éxito. Si las ejecuciones más recientes de un flujo de trabajo fallaron y una o más de estas ejecuciones fallidas contenían cambios a la configuración del contenedor dev, entonces no habrán precompilaciones disponibles para la rama asociada. +## Some resources cannot be accessed in codespaces created using a prebuild + +If the `devcontainer.json` configuration file for a prebuild configuration specifies that permissions for access to other repositories are required, then the repository administrator is prompted to authorize these permissions when they create or update the prebuild configuration. If the administrator does not grant all of the requested permissions there's a chance that problems may occur in the prebuild, and in codespaces created from this prebuild. This is true even if the user who creates a codespace based on this prebuild _does_ grant all of the permissions when they are prompted to do so. + ## Ejecuciones de flujo de trabajo con solución de problemas fallida para las precompilaciones +If the `devcontainer.json` configuration file for a prebuild configuration is updated to specify that permissions for access to other repositories are required, and a repository administrator has not been prompted to authorize these permissions for the prebuild configuration, then the prebuild workflow may fail. Try updating the prebuild configuration, without making any changes. If, when you click **Update**, the authorization page is displayed, check that the requested permissions are appropriate and, if so, authorize the request. For more information, see "[Managing prebuilds](/codespaces/prebuilding-your-codespaces/managing-prebuilds#editing-a-prebuild-configuration)" and "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces#setting-additional-repository-permissions)." + Si las ejecuciones de flujo de trabajo para una configuración de precompilación están fallando, puedes inhabilitar temporalmente dicha configuración de precompilación mientras haces tu investigación. Para obtener más información, consulta la sección "[Administrar las precompilaciones](/codespaces/prebuilding-your-codespaces/managing-prebuilds#disabling-a-prebuild-configuration)". ## Leer más diff --git a/translations/es-ES/content/communities/documenting-your-project-with-wikis/adding-or-editing-wiki-pages.md b/translations/es-ES/content/communities/documenting-your-project-with-wikis/adding-or-editing-wiki-pages.md index c0079afa59..e2d72ab4f2 100644 --- a/translations/es-ES/content/communities/documenting-your-project-with-wikis/adding-or-editing-wiki-pages.md +++ b/translations/es-ES/content/communities/documenting-your-project-with-wikis/adding-or-editing-wiki-pages.md @@ -34,7 +34,7 @@ shortTitle: Administrar las páginas de wiki {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-wiki %} 4. Desplázate hasta la página que deseas cambiar con la ayuda de la barra lateral wiki. En el ángulo superior derecho de la página, haz clic en **Edite** (Editar). ![Botón de la página para editar wikis](/assets/images/help/wiki/wiki_edit_page_button.png) -5. Usa el editor de texto para editar el contenido de la página. ![Wiki WYSIWYG](/assets/images/help/wiki/wiki_wysiwyg.png) +5. Use the text editor to edit the page's content. ![Wiki WYSIWYG](/assets/images/help/wiki/wiki_wysiwyg.png) 6. Escribe un mensaje de confirmación que describa tus cambios. ![Mensaje de confirmación de la wiki](/assets/images/help/wiki/wiki_commit_message.png) 7. Para confirmar tus cambios en la wiki, haz clic en **Guardar página**. diff --git a/translations/es-ES/content/developers/overview/github-developer-program.md b/translations/es-ES/content/developers/overview/github-developer-program.md index 0e1313502e..c7e110ad2e 100644 --- a/translations/es-ES/content/developers/overview/github-developer-program.md +++ b/translations/es-ES/content/developers/overview/github-developer-program.md @@ -27,7 +27,7 @@ Contacta por correo electrónico a part * Utiliza el [Logo de Octocat o de GitHub](https://github.com/logos) para denotar que tu producto se integra con GitHub * Publica un video o un blog en tu sitio web que explique esta integración -## ¿Estás listo para unirte al Programa de Desarrollador de GitHub? +## ¿Estás listo para unirte al Programa de Desarrollador de GitHub? La membrecía está disponible para los desarrolladores individuales y para las comañías que tienen: diff --git a/translations/es-ES/content/issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-notes-to-a-project-board.md b/translations/es-ES/content/issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-notes-to-a-project-board.md index 0abbeb2dca..3e10bff729 100644 --- a/translations/es-ES/content/issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-notes-to-a-project-board.md +++ b/translations/es-ES/content/issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-notes-to-a-project-board.md @@ -25,13 +25,13 @@ allowTitleToDifferFromFilename: true {% endtip %} -When you add a URL for an issue, pull request, or another {% data variables.projects.projects_v1_board %} to a note, you'll see a preview in a summary card below your text. +Cuando agregas una URL para una propuesta, solicitud de cambios u otro {% data variables.projects.projects_v1_board %} a una nota, verás una vista previa en la tarjeta de resumen debajo de tu texto. ![Tarjetas de tableros de proyecto mostrando una vista previa de una propuesta y otro tablero de proyecto](/assets/images/help/projects/note-with-summary-card.png) -## Adding notes to a {% data variables.projects.projects_v1_board %} +## Agregar notas a un {% data variables.projects.projects_v1_board %} -1. Navigate to the {% data variables.projects.projects_v1_board %} where you want to add notes. +1. Navega al {% data variables.projects.projects_v1_board %} en donde quieres agregar notas. 2. En la columna en la que deseas agregar una nota, haz clic en {% octicon "plus" aria-label="The plus icon" %}. ![Icono de adición en el encabezado de la columna](/assets/images/help/projects/add-note-button.png) 3. Escribe tu nota, luego haz clic en **Add** (Agregar). ![Campo para escribir una nota y botón Add card (Agregar tarjeta)](/assets/images/help/projects/create-and-add-note-button.png) @@ -49,7 +49,7 @@ Cuando conviertes una nota en una propuesta, la propuesta se crea automáticamen {% tip %} -**Sugerencia:** Puedes agregar el contenido en el cuerpo de tu nota para @mencionar a alguien, vincular otra propuesta o solicitud de extracción, y agregar un emoji. These {% data variables.product.prodname_dotcom %} Flavored Markdown features aren't supported within {% data variables.projects.projects_v1_board %} notes, but once your note is converted to an issue, they'll appear correctly. Para obtener más información sobre cómo usar estas características, consulta "[Acerca de la escritura y el formato en {% data variables.product.prodname_dotcom %}](/articles/about-writing-and-formatting-on-github)". +**Sugerencia:** Puedes agregar el contenido en el cuerpo de tu nota para @mencionar a alguien, vincular otra propuesta o solicitud de extracción, y agregar un emoji. Estas características de lenguaje de marcado enriquecido de {% data variables.product.prodname_dotcom %} no son compatibles con las notas del {% data variables.projects.projects_v1_board %}, pero una vez que tu nota se convierta en una propuesta, se mostrarán correctamente. Para obtener más información sobre cómo usar estas características, consulta "[Acerca de la escritura y el formato en {% data variables.product.prodname_dotcom %}](/articles/about-writing-and-formatting-on-github)". {% endtip %} diff --git a/translations/es-ES/content/issues/planning-and-tracking-with-projects/index.md b/translations/es-ES/content/issues/planning-and-tracking-with-projects/index.md index 0c575a334f..85aefe6a1f 100644 --- a/translations/es-ES/content/issues/planning-and-tracking-with-projects/index.md +++ b/translations/es-ES/content/issues/planning-and-tracking-with-projects/index.md @@ -17,5 +17,7 @@ children: - /viewing-insights-from-your-project - /managing-your-project allowTitleToDifferFromFilename: true +redirect_from: + - /issues/trying-out-the-new-projects-experience --- diff --git a/translations/es-ES/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md b/translations/es-ES/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md index bfe116aa3a..b844e2251b 100644 --- a/translations/es-ES/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md +++ b/translations/es-ES/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md @@ -40,12 +40,12 @@ The `dig` command, which can be used to verify correct configuration of DNS reco ## Configuring a subdomain -To set up a `www` or custom subdomain, such as `www.example.com` or `blog.example.com`, you must add your domain in the repository settings, which will create a CNAME file in your site’s repository. After that, configure a CNAME record with your DNS provider. +To set up a `www` or custom subdomain, such as `www.example.com` or `blog.example.com`, you must add your domain in the repository settings. After that, configure a CNAME record with your DNS provider. {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %} -4. Under "Custom domain", type your custom domain, then click **Save**. This will create a commit that adds a _CNAME_ file in the root of your publishing source. +4. Under "Custom domain", type your custom domain, then click **Save**. If you are publishing your site from a branch, this will create a commit that adds a `CNAME` file to the root of your source branch. If you are publishing your site with a custom {% data variables.product.prodname_actions %} workflow , no `CNAME` file is created. For more information about your publishing source, see "[Configuring a publishing source for your GitHub Pages site](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)." ![Save custom domain button](/assets/images/help/pages/save-custom-subdomain.png) 5. Navigate to your DNS provider and create a `CNAME` record that points your subdomain to the default domain for your site. For example, if you want to use the subdomain `www.example.com` for your user site, create a `CNAME` record that points `www.example.com` to `.github.io`. If you want to use the subdomain `www.anotherexample.com` for your organization site, create a `CNAME` record that points `www.anotherexample.com` to `.github.io`. The `CNAME` record should always point to `.github.io` or `.github.io`, excluding the repository name. {% data reusables.pages.contact-dns-provider %} {% data reusables.pages.default-domain-information %} @@ -64,14 +64,14 @@ To set up a `www` or custom subdomain, such as `www.example.com` or `blog.exampl ## Configuring an apex domain -To set up an apex domain, such as `example.com`, you must configure a _CNAME_ file in your {% data variables.product.prodname_pages %} repository and at least one `ALIAS`, `ANAME`, or `A` record with your DNS provider. +To set up an apex domain, such as `example.com`, you must configure a custom domain in your repository settings and at least one `ALIAS`, `ANAME`, or `A` record with your DNS provider. {% data reusables.pages.www-and-apex-domain-recommendation %} For more information, see "[Configuring a subdomain](#configuring-a-subdomain)." {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %} -4. Under "Custom domain", type your custom domain, then click **Save**. This will create a commit that adds a _CNAME_ file in the root of your publishing source. +4. Under "Custom domain", type your custom domain, then click **Save**. If you are publishing your site from a branch, this will create a commit that adds a `CNAME` file to the root of your source branch. If you are publishing your site with a custom {% data variables.product.prodname_actions %} workflow , no `CNAME` file is created. For more information about your publishing source, see "[Configuring a publishing source for your GitHub Pages site](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)." ![Save custom domain button](/assets/images/help/pages/save-custom-apex-domain.png) 5. Navigate to your DNS provider and create either an `ALIAS`, `ANAME`, or `A` record. You can also create `AAAA` records for IPv6 support. {% data reusables.pages.contact-dns-provider %} - To create an `ALIAS` or `ANAME` record, point your apex domain to the default domain for your site. {% data reusables.pages.default-domain-information %} diff --git a/translations/es-ES/content/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages.md b/translations/es-ES/content/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages.md index 892a5af812..754f259468 100644 --- a/translations/es-ES/content/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages.md +++ b/translations/es-ES/content/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages.md @@ -18,7 +18,9 @@ shortTitle: Troubleshoot a custom domain ## _CNAME_ errors -Custom domains are stored in a _CNAME_ file in the root of your publishing source. You can add or update this file through your repository settings or manually. For more information, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)." +{% ifversion pages-custom-workflow %}If you are publishing from a custom {% data variables.product.prodname_actions %} workflow, any _CNAME_ file is ignored and is not required.{% endif %} + +If you are publishing from a branch, custom domains are stored in a _CNAME_ file in the root of your publishing source. You can add or update this file through your repository settings or manually. For more information, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)." For your site to render at the correct domain, make sure your _CNAME_ file still exists in the repository. For example, many static site generators force push to your repository, which can overwrite the _CNAME_ file that was added to your repository when you configured your custom domain. If you build your site locally and push generated files to {% data variables.product.product_name %}, make sure to pull the commit that added the _CNAME_ file to your local repository first, so the file will be included in the build. diff --git a/translations/es-ES/content/pages/getting-started-with-github-pages/about-github-pages.md b/translations/es-ES/content/pages/getting-started-with-github-pages/about-github-pages.md index 6e8072ac21..765d90a90f 100644 --- a/translations/es-ES/content/pages/getting-started-with-github-pages/about-github-pages.md +++ b/translations/es-ES/content/pages/getting-started-with-github-pages/about-github-pages.md @@ -71,15 +71,11 @@ For more information, see "[Enabling subdomain isolation](/enterprise/admin/inst ## Publishing sources for {% data variables.product.prodname_pages %} sites -The publishing source for your {% data variables.product.prodname_pages %} site is the branch and folder where the source files for your site are stored. - {% data reusables.pages.private_pages_are_public_warning %} -If the default publishing source exists in your repository, {% data variables.product.prodname_pages %} will automatically publish a site from that source. The default publishing source for user and organization sites is the root of the default branch for the repository. The default publishing source for project sites is the root of the `gh-pages` branch. +{% data reusables.pages.pages-about-publishing-source %} -If you want to keep the source files for your site in a different location, you can change the publishing source for your site. You can publish your site from any branch in the repository, either from the root of the repository on that branch, `/`, or from the `/docs` folder on that branch. For more information, see "[Configuring a publishing source for your {% data variables.product.prodname_pages %} site](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)." - -If you choose the `/docs` folder of any branch as your publishing source, {% data variables.product.prodname_pages %} will read everything to publish your site{% ifversion fpt or ghec %}, including the _CNAME_ file,{% endif %} from the `/docs` folder.{% ifversion fpt or ghec %} For example, when you edit your custom domain through the {% data variables.product.prodname_pages %} settings, the custom domain will write to `/docs/CNAME`. For more information about _CNAME_ files, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)."{% endif %} +For more information, see "[Configuring a publishing source for your GitHub Pages site](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)." {% ifversion ghec %} ## Limitations for {% data variables.product.prodname_emus %} @@ -93,10 +89,22 @@ For more information about {% data variables.product.prodname_emus %}, see "[Abo ## Static site generators -{% data variables.product.prodname_pages %} publishes any static files that you push to your repository. You can create your own static files or use a static site generator to build your site for you. You can also customize your own build process locally or on another server. We recommend Jekyll, a static site generator with built-in support for {% data variables.product.prodname_pages %} and a simplified build process. For more information, see "[About {% data variables.product.prodname_pages %} and Jekyll](/articles/about-github-pages-and-jekyll)." +{% data variables.product.prodname_pages %} publishes any static files that you push to your repository. You can create your own static files or use a static site generator to build your site for you. You can also customize your own build process locally or on another server. + +{% ifversion pages-custom-workflow %} + +If you use a custom build process or a static site generator other than Jekyll, you can write a {% data variables.product.prodname_actions %} to build and publish your site. {% data variables.product.product_name %} provides starter workflows for several static site generators. For more information, see "[Configuring a publishing source for your GitHub Pages site](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)." + +If you publish your site from a source branch, {% data variables.product.prodname_pages %} will use Jekyll to build your site by default. If you want to use a static site generator other than Jekyll, we recommend that you write a {% data variables.product.prodname_actions %} to build and publish your site instead. Otherwise, disable the Jekyll build process by creating an empty file called `.nojekyll` in the root of your publishing source, then follow your static site generator's instructions to build your site locally. + +{% else %} + +We recommend Jekyll, a static site generator with built-in support for {% data variables.product.prodname_pages %} and a simplified build process. For more information, see "[About {% data variables.product.prodname_pages %} and Jekyll](/articles/about-github-pages-and-jekyll)." {% data variables.product.prodname_pages %} will use Jekyll to build your site by default. If you want to use a static site generator other than Jekyll, disable the Jekyll build process by creating an empty file called `.nojekyll` in the root of your publishing source, then follow your static site generator's instructions to build your site locally. +{% endif %} + {% data variables.product.prodname_pages %} does not support server-side languages such as PHP, Ruby, or Python. ## Limits on use of {% data variables.product.prodname_pages %} @@ -117,7 +125,7 @@ In addition, your use of {% data variables.product.prodname_pages %} is subject - Published {% data variables.product.prodname_pages %} sites may be no larger than 1 GB. {% ifversion fpt or ghec %} - {% data variables.product.prodname_pages %} sites have a *soft* bandwidth limit of 100 GB per month. - - {% data variables.product.prodname_pages %} sites have a *soft* limit of 10 builds per hour. + - {% data variables.product.prodname_pages %} sites have a *soft* limit of 10 builds per hour.{% ifversion pages-custom-workflow %} This limit does not apply if you build and publish your site with a custom {% data variables.product.prodname_actions %} workflow {% endif %} If your site exceeds these usage quotas, we may not be able to serve your site, or you may receive a polite email from {% data variables.contact.contact_support %} suggesting strategies for reducing your site's impact on our servers, including putting a third-party content distribution network (CDN) in front of your site, making use of other {% data variables.product.prodname_dotcom %} features such as releases, or moving to a different hosting service that might better fit your needs. diff --git a/translations/es-ES/content/pages/getting-started-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md b/translations/es-ES/content/pages/getting-started-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md index 787ce8e0a1..66ecf31a2b 100644 --- a/translations/es-ES/content/pages/getting-started-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md +++ b/translations/es-ES/content/pages/getting-started-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md @@ -13,12 +13,21 @@ versions: topics: - Pages shortTitle: Agregar un tema al sitio de Páginas +permissions: 'People with admin permissions for a repository can use the theme chooser to add a theme to a {% data variables.product.prodname_pages %} site.' --- -Las personas con permisos de administración para un repositorio pueden usar el selector de temas para agregar un tema al sitio de {% data variables.product.prodname_pages %}. - ## Acerca del selector de temas +{% ifversion pages-custom-workflow %} + +{% note %} + +**Note**: The Jekyll theme chooser is not supported for {% data variables.product.prodname_pages %} sites that are published with a custom {% data variables.product.prodname_actions %} workflow. If you build your site with Jekyll and publish your site with a custom {% data variables.product.prodname_actions %} workflow, you can add a theme by editing the `_config.yml` file. For more information, see "[Adding a theme to your GitHub Pages site using Jekyll](/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll)." + +{% endnote %} + +{% endif %} + El selector de temas agrega un tema de Jekyll a tu repositorio. Para obtener más información acerca de Jekyll, consulta "[Acerca de las {% data variables.product.prodname_pages %} y Jekyll](/articles/about-github-pages-and-jekyll)". La forma en que funciona el selector de temas depende de si tu repositorio es público o privado. diff --git a/translations/es-ES/content/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md b/translations/es-ES/content/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md index 80eedc1f09..80bbfd7f07 100644 --- a/translations/es-ES/content/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md +++ b/translations/es-ES/content/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md @@ -1,6 +1,6 @@ --- title: Configurar una fuente de publicación para tu sitio de Páginas de GitHub -intro: 'Si usas la fuente de publicación predeterminada para tu sitio de {% data variables.product.prodname_pages %}, tu sitio se publicará automáticamente. También puedes elegir publicar tu sitio desde una rama o carpeta diferente.' +intro: '{% ifversion pages-custom-workflow %}You can configure your {% data variables.product.prodname_pages %} site to publish when changes are pushed to a specific branch, or you can write a {% data variables.product.prodname_actions %} workflow to publish your site.{% else%}If you use the default publishing source for your {% data variables.product.prodname_pages %} site, your site will publish automatically. You can also choose to publish your site from a different branch or folder.{% endif %}' redirect_from: - /articles/configuring-a-publishing-source-for-github-pages - /articles/configuring-a-publishing-source-for-your-github-pages-site @@ -17,20 +17,30 @@ topics: shortTitle: Configurar la fuenta de publicción --- -Para obtener más información acerca de las fuentes de publicación, consulta "[Acerca de las {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)". +## About publishing sources -## Elegir una fuente de publicación +{% data reusables.pages.pages-about-publishing-source %} -Antes de configurar una fuente de publicación, asegúrate de que la rama que quieres utilizar como fuente de publicación ya exista en tu repositorio. +{% data reusables.pages.private_pages_are_public_warning %} +## Publishing from a branch + +1. Make sure the branch you want to use as your publishing source already exists in your repository. {% data reusables.pages.navigate-site-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %} +{% ifversion pages-custom-workflow %} +1. Under "Build and deployment", under "Source", select **Deploy from a branch**. +1. Under "Build and deployment", under "Branch", use the **None** or **Branch** drop-down menu and select a publishing source. + + ![Menú desplegable para seleccionar una fuente de publicación](/assets/images/help/pages/publishing-source-drop-down.png) +{% else %} 3. Debajo de "{% data variables.product.prodname_pages %}", utiliza el menú desplegable de **Ninguno** o de **Rama** y selecciona una fuente de publicación. ![Menú desplegable para seleccionar una fuente de publicación](/assets/images/help/pages/publishing-source-drop-down.png) +{% endif %} 4. Opcionalmente, utiliza el menú desplegable para seleccionar una carpeta para tu fuente de publicación. ![Menú desplegable para seleccionar una carpeta para una fuente de publicación](/assets/images/help/pages/publishing-source-folder-drop-down.png) 5. Haz clic en **Save ** (guardar). ![Botón para guardar los cambios en la configuración de la fuente de publicación](/assets/images/help/pages/publishing-source-save.png) -## Solución de problemas de publicación con tu sitio de {% data variables.product.prodname_pages %} +### Troubleshooting publishing from a branch {% data reusables.pages.admin-must-push %} @@ -49,3 +59,45 @@ Para encontrar errores potenciales en ya sea la compilación o el despliegue, pu {% endnote %} {% endif %} + +{% ifversion pages-custom-workflow %} + +## Publishing with a custom {% data variables.product.prodname_actions %} workflow + +{% data reusables.pages.pages-custom-workflow-beta %} + +To configure your site to publish with {% data variables.product.prodname_actions %}: + +{% data reusables.pages.navigate-site-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.pages.sidebar-pages %} +1. Under "Build and deployment", under "Source", select **GitHub Actions**. +1. {% data variables.product.product_name %} will suggest several starter workflows. If you already have a workflow to publish your site, you can skip this step. Otherwise, choose one of the options to create a {% data variables.product.prodname_actions %} workflow. For more information about creating your custom workflow, see "[Creating a custom {% data variables.product.prodname_actions %} workflow to publish your site](#creating-a-custom-github-actions-workflow-to-publish-your-site)." + + {% data variables.product.prodname_pages %} does not associate a specific workflow to the {% data variables.product.prodname_pages %} settings. However, the {% data variables.product.prodname_pages %} settings will link to the workflow run that most recently deployed your site. + +### Creating a custom {% data variables.product.prodname_actions %} workflow to publish your site + +For more information about {% data variables.product.prodname_actions %}, see "[Actions](/actions)." + +When you configure your site to publish with {% data variables.product.prodname_actions %}, {% data variables.product.product_name %} will suggest starter workflows for common publishing scenarios. The general flow of a workflow is to: + +1. Trigger whenever there is a push to the default branch of the repository or whenever a pull request that targets the default branch is opened, reopened, or updated. +1. Use the [`actions/checkout`](https://github.com/actions/checkout) action to check out the repository contents. +1. If required by your site, build any static site files. +1. Use the [`actions/upload-pages-artifact`](https://github.com/actions/upload-pages-artifact) action to upload the static files as an artifact. +1. If the workflow was triggered by a push to the default branch, use the [`actions/deploy-pages`](https://github.com/actions/deploy-pages) action to deploy the artifact. This step is skipped if the workflow was triggered by a pull request. + +The starter workflows use a deployment environment called `github-pages`. If your repository does not already include an environment called `github-pages`, the environment will be created automatically. We recommend that you add an environment protection rule so that only the default branch can deploy to this environment. Para obtener más información, consulta la sección "[Utilizar ambientes para despliegue](/actions/deployment/targeting-different-environments/using-environments-for-deployment)". + +{% note %} + +**Note**: A `CNAME` file in your repository file does not automatically add or remove a custom domain. Instead, you must configure the custom domain through your repository settings or through the API. For more information, see "[Managing a custom domain for your GitHub Pages site](/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain)" and the [Pages API reference documentation](/rest/pages#update-information-about-a-github-pages-site). + +{% endnote %} + +### Troubleshooting publishing with a custom {% data variables.product.prodname_actions %} workflow + +For information about how to troubleshoot your {% data variables.product.prodname_actions %} workflow, see "[About monitoring and troubleshooting](/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting)." + +{% endif %} diff --git a/translations/es-ES/content/pages/getting-started-with-github-pages/creating-a-github-pages-site.md b/translations/es-ES/content/pages/getting-started-with-github-pages/creating-a-github-pages-site.md index 318966492c..075304be17 100644 --- a/translations/es-ES/content/pages/getting-started-with-github-pages/creating-a-github-pages-site.md +++ b/translations/es-ES/content/pages/getting-started-with-github-pages/creating-a-github-pages-site.md @@ -41,14 +41,11 @@ shortTitle: Crear un sitio de GitHub Pages {% data reusables.pages.navigate-site-repo %} {% data reusables.pages.decide-publishing-source %} -3. Si ya existe la fuente de publicación que elegiste, desplázate hasta la fuente de publicación. Si la fuente de publicación que elegiste no existe, crear la fuente de publicación. -4. En la raíz de la fuente de publicación, crea un archivo nuevo denominado `index.md` que contenga el contenido que quieras mostrar en la página principal de tu sitio. +1. Create the entry file for your site. {% data variables.product.prodname_pages %} will look for an `index.html`, `index.md`, or `README.md` file as the entry file for your site. - {% tip %} + {% ifversion pages-custom-workflow %}If your publishing source is a branch and folder, the entry file must be at the top level of the source folder on the source branch. For example, if your publishing source is the `/docs` folder on the `main` branch, your entry file must be located in the `/docs` folder on a branch called `main`. - **Tip:** Si el archivo `index.html` está presente, este se utilizará en vez de `index.md`. Si ni `index.html` ni `index.md` están presentes, se utilizará `README.md`. - - {% endtip %} + If your publishing source is a {% data variables.product.prodname_actions %} workflow, the artifact that you deploy must include the entry file at the top level of the artifact. Instead of adding the entry file to your repository, you may choose to have your {% data variables.product.prodname_actions %} workflow generate your entry file when the workflow runs.{% else %} The entry file must be at the top level of your chosen publishing source. For example, if your publishing source is the `/docs` folder on the `main` branch, your entry file must be located in the `/docs` folder on a branch called `main`.{% endif %} {% data reusables.pages.configure-publishing-source %} {% data reusables.repositories.sidebar-settings %} {% data reusables.pages.sidebar-pages %} diff --git a/translations/es-ES/content/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site.md b/translations/es-ES/content/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site.md index 6055d21fcd..c55397d6f7 100644 --- a/translations/es-ES/content/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site.md +++ b/translations/es-ES/content/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site.md @@ -20,6 +20,18 @@ topics: shortTitle: Dejar de publicar el sitio de las páginas --- +{% ifversion pages-custom-workflow %} + +When you unpublish your site, the site will no longer be available. Any existing repository settings or content will not be affected. + +{% data reusables.repositories.navigate-to-repo %} +1. Under **{% data variables.product.prodname_pages %}**, next to the **Your site is live at** message, click {% octicon "kebab-horizontal" aria-label="the horizontal kebab icon" %}. +1. In the menu that appears, select **Unpublish site**. + + ![Drop down menu to unpublish site](/assets/images/help/pages/unpublish-site.png) + +{% else %} + ## Anular la publicación de un sitio de proyecto {% data reusables.repositories.navigate-to-repo %} @@ -35,3 +47,5 @@ shortTitle: Dejar de publicar el sitio de las páginas {% data reusables.repositories.navigate-to-repo %} 2. Borra la rama que estás utilizando como fuente de publicación, o borra todo el repositorio. Para obtener más información, consulta "[Crear y eliminar ramas dentro de tu repositorio](/articles/creating-and-deleting-branches-within-your-repository#deleting-a-branch)" y "[Eliminar un repositorio](/articles/deleting-a-repository)". {% data reusables.pages.update_your_dns_settings %} + +{% endif %} diff --git a/translations/es-ES/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md b/translations/es-ES/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md index c5b53d6108..b76538436f 100644 --- a/translations/es-ES/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/es-ES/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md @@ -19,7 +19,7 @@ shortTitle: Jekyll build errors for Pages ## About Jekyll build errors -Sometimes, {% data variables.product.prodname_pages %} will not attempt to build your site after you push changes to your site's publishing source.{% ifversion fpt or ghec %} +{% ifversion pages-custom-workflow %}If you are publishing from a branch, sometimes{% else %}Sometimes,{% endif %} {% data variables.product.prodname_pages %} will not attempt to build your site after you push changes to your site's publishing source.{% ifversion fpt or ghec %} - The person who pushed the changes hasn't verified their email address. For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."{% endif %} - You're pushing with a deploy key. If you want to automate pushes to your site's repository, you can set up a machine user instead. For more information, see "[Managing deploy keys](/developers/overview/managing-deploy-keys#machine-users)." - You're using a CI service that isn't configured to build your publishing source. For example, Travis CI won't build the `gh-pages` branch unless you add the branch to a safe list. For more information, see "[Customizing the build](https://docs.travis-ci.com/user/customizing-the-build/#safelisting-or-blocklisting-branches)" on Travis CI, or your CI service's documentation. @@ -57,11 +57,15 @@ We recommend testing your site locally, which allows you to see build error mess ## Viewing Jekyll build error messages in your pull request -When you create a pull request to update your publishing source on {% data variables.product.product_name %}, you can see build error messages on the **Checks** tab of the pull request. For more information, see "[About status checks](/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks)." +{% ifversion pages-custom-workflow %}If you are publishing from a branch, when{% else %}When{% endif %} you create a pull request to update your publishing source on {% data variables.product.product_name %}, you can see build error messages on the **Checks** tab of the pull request. For more information, see "[About status checks](/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks)." + +{% ifversion pages-custom-workflow %}If you are publishing with a custom {% data variables.product.prodname_actions %} workflow, in order to see build error messages in your pull request, you must configure your workflow to run on the `pull_request` trigger. When you do this, we recommend that you skip any deploy steps if the workflow was triggered by the `pull_request` event. This will allow you to see any build errors without deploying the changes from your pull request to your site. For more information, see "[Events that trigger workflows](/actions/using-workflows/events-that-trigger-workflows#pull_request)" and "[Expressions](/actions/learn-github-actions/expressions)."{% endif %} ## Viewing Jekyll build errors by email -When you push changes to your publishing source on {% data variables.product.product_name %}, {% data variables.product.prodname_pages %} will attempt to build your site. If the build fails, you'll receive an email at your primary email address. You'll also receive emails for build warnings. {% data reusables.pages.build-failure-email-server %} +{% ifversion pages-custom-workflow %}If you are publishing from a branch, when{% else %}When{% endif %} you push changes to your publishing source on {% data variables.product.product_name %}, {% data variables.product.prodname_pages %} will attempt to build your site. If the build fails, you'll receive an email at your primary email address. You'll also receive emails for build warnings. {% data reusables.pages.build-failure-email-server %} + +{% ifversion pages-custom-workflow %}If you are publishing with a custom {% data variables.product.prodname_actions %} workflow, in order to receive emails about build errors in your pull request, you must configure your workflow to run on the `pull_request` trigger. When you do this, we recommend that you skip any deploy steps if the workflow was triggered by the `pull_request` event. This will allow you to see any build errors without deploying the changes from your pull request to your site. For more information, see "[Events that trigger workflows](/actions/using-workflows/events-that-trigger-workflows#pull_request)" and "[Expressions](/actions/learn-github-actions/expressions)."{% endif %} ## Viewing Jekyll build error messages in your pull request with a third-party CI service diff --git a/translations/es-ES/content/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites.md b/translations/es-ES/content/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites.md index 0f301a230a..3c55bfe5d5 100644 --- a/translations/es-ES/content/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites.md +++ b/translations/es-ES/content/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites.md @@ -43,12 +43,12 @@ Si Jekyll encuentra un error al compilar tu sitio de {% data variables.product.p Si recibiste un mensaje de error genérico, revisa los problemas comunes. - Estás usando plugins no compatibles. Para obtener más información, consulta "[Acerca de las {% data variables.product.prodname_pages %} y Jekyll](/articles/about-github-pages-and-jekyll#plugins)".{% ifversion fpt or ghec %} - Tu repositorio ha excedido nuestros límites de tamaño del repositorio. Para obtener más información, consulta "[¿Cuál es mi cuota de disco?](/articles/what-is-my-disk-quota)"{% endif %} -- Cambiaste el parámetro `fuente` de tu archivo *_config.yml*. {% data variables.product.prodname_pages %} reemplaza este parámetro durante el proceso de compilación. -- Un nombre de archivo en tu fuente de publicación contiene dos puntos (`:`), los cuales no se admiten. +- Cambiaste el parámetro `fuente` de tu archivo *_config.yml*. {% ifversion pages-custom-workflow %}If you publish your site from a branch, {% endif %}{% data variables.product.prodname_pages %} overrides this setting during the build process. +- A filename in your published files contains a colon (`:`) which is not supported. Si recibiste un mensaje de error específico, revisa la información de solución de problemas para el mensaje de error que aparece a continuación. -Después de haber corregido los errores, sube los cambios a la fuente de publicación de tu sitio para activar otra compilación en {% data variables.product.product_name %}. +{% ifversion pages-custom-workflow %}After you've fixed any errors, trigger another build by pushing the changes to your site's source branch (if you are publishing from a branch) or by triggering your custom {% data variables.product.prodname_actions %} workflow (if you are publishing with {% data variables.product.prodname_actions %}).{% else %}After you've fixed any errors, push the changes to your site's publishing source to trigger another build on {% data variables.product.product_name %}.{% endif %} ## Error de archivo de configuración @@ -74,7 +74,7 @@ Este error significa que tu código hace referencia a un archivo que no existe e ## El archivo es un enlace simbólico -Este error significa que tu código hace referencia a un archivo simbólico que no existe en la fuente de publicación de tu sitio. +This error means that your code references a symlinked file that does not exist in the published files for your site. {% data reusables.pages.search-for-includes %} Si alguno de los archivos a los que has hecho referencia es un enlace simbólico, copia o mueve los archivos al directorio *_includes*. @@ -162,9 +162,9 @@ Para solucionar el problema, elimina la línea `relativa_permalinks` de tu archi ## El enlace simbólico no existe dentro del repositorio de tu sitio -Este error significa que tu sitio incluye un enlace simbólico (symlink) que no existe en la fuente de publicación de tu sitio. Para obtener más información acerca de los enlaces simbólicos, consulta "[Enlace simbólico](https://en.wikipedia.org/wiki/Symbolic_link)" en Wikipedia. +This error means that your site includes a symbolic link (symlink) that does not exist in the published files for your site. Para obtener más información acerca de los enlaces simbólicos, consulta "[Enlace simbólico](https://en.wikipedia.org/wiki/Symbolic_link)" en Wikipedia. -Para solucionar el problema, determina si el archivo en el mensaje de error se utiliza para compilar tu sitio. De lo contrario, o si no quieres que el archivo sea un enlace simbólico, elimina el archivo. Si el archivo de enlace simbólico se necesita para compilar tu sitio, asegúrate de que el archivo o el directorio al que hace referencia el enlace simbólico esté en la fuente de publicación de tu sitio. Para incluir activos externos, considera usar {% ifversion fpt or ghec %}`submódulo de git` o {% endif %}un administrador de paquetes de terceros como [Bower](https://bower.io/).{% ifversion fpt or ghec %} Para obtener más información, consulta "[Usar submódulos con las {% data variables.product.prodname_pages %}](/articles/using-submodules-with-github-pages)".{% endif %} +Para solucionar el problema, determina si el archivo en el mensaje de error se utiliza para compilar tu sitio. De lo contrario, o si no quieres que el archivo sea un enlace simbólico, elimina el archivo. If the symlinked file is necessary to build your site, make sure the file or directory the symlink references is in the published files for your site. Para incluir activos externos, considera usar {% ifversion fpt or ghec %}`submódulo de git` o {% endif %}un administrador de paquetes de terceros como [Bower](https://bower.io/).{% ifversion fpt or ghec %} Para obtener más información, consulta "[Usar submódulos con las {% data variables.product.prodname_pages %}](/articles/using-submodules-with-github-pages)".{% endif %} ## Error de sintaxis en el bucle 'for' diff --git a/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md b/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md index de120ef003..7c7f48b199 100644 --- a/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md +++ b/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md @@ -17,7 +17,7 @@ topics: --- People with admin or owner permissions can set up a CODEOWNERS file in a repository. -The people you choose as code owners must have read permissions for the repository. When the code owner is a team, that team must be visible and it must have write permissions, even if all the individual members of the team already have write permissions directly, through organization membership, or through another team membership. +The people you choose as code owners must have write permissions for the repository. When the code owner is a team, that team must be visible and it must have write permissions, even if all the individual members of the team already have write permissions directly, through organization membership, or through another team membership. ## About code owners @@ -47,7 +47,7 @@ To reduce the size of your CODEOWNERS file, consider using wildcard patterns to ## CODEOWNERS syntax -A CODEOWNERS file uses a pattern that follows most of the same rules used in [gitignore](https://git-scm.com/docs/gitignore#_pattern_format) files, with [some exceptions](#syntax-exceptions). The pattern is followed by one or more {% data variables.product.prodname_dotcom %} usernames or team names using the standard `@username` or `@org/team-name` format. Users must have `read` access to the repository and teams must have explicit `write` access, even if the team's members already have access. +A CODEOWNERS file uses a pattern that follows most of the same rules used in [gitignore](https://git-scm.com/docs/gitignore#_pattern_format) files, with [some exceptions](#syntax-exceptions). The pattern is followed by one or more {% data variables.product.prodname_dotcom %} usernames or team names using the standard `@username` or `@org/team-name` format. Users and teams must have explicit `write` access to the repository, even if the team's members already have access. {% ifversion fpt or ghec%}In most cases, you{% else %}You{% endif %} can also refer to a user by an email address that has been added to their account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, for example `user@example.com`. {% ifversion fpt or ghec %} You cannot use an email address to refer to a {% data variables.product.prodname_managed_user %}. For more information about {% data variables.product.prodname_managed_users %}, see "[About {% data variables.product.prodname_emus %}](/enterprise-cloud@latest/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/about-enterprise-managed-users){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %}{% endif %} diff --git a/translations/es-ES/content/rest/actions/cache.md b/translations/es-ES/content/rest/actions/cache.md index d1b9f42585..7384ad9f14 100644 --- a/translations/es-ES/content/rest/actions/cache.md +++ b/translations/es-ES/content/rest/actions/cache.md @@ -2,7 +2,7 @@ title: GitHub Actions Cache allowTitleToDifferFromFilename: true shortTitle: Caché -intro: 'The {% data variables.product.prodname_actions %} Cache API allows you to query and manage the {% data variables.product.prodname_actions %} cache for repositories.' +intro: 'La API de caché de {% data variables.product.prodname_actions %} te permite consultar y administrar el caché de {% data variables.product.prodname_actions %} para los repositorios.' topics: - API versions: @@ -13,4 +13,4 @@ versions: ## About the Cache API -La API de caché de {% data variables.product.prodname_actions %} te permite consultar y administrar el caché de {% data variables.product.prodname_actions %} para los repositorios. Para obtener más información, consulta la sección "[Almacenar las dependencias en caché para agilizar los flujos de trabajo](/actions/advanced-guides/caching-dependencies-to-speed-up-workflows#usage-limits-and-eviction-policy)". +La API de caché de {% data variables.product.prodname_actions %} te permite consultar y administrar el caché de {% data variables.product.prodname_actions %} para los repositorios. {% ifversion actions-cache-management %}You can also install a {% data variables.product.prodname_cli %} extension to manage your caches from the command line. {% endif %}For more information, see "[Caching dependencies to speed up workflows](/actions/advanced-guides/caching-dependencies-to-speed-up-workflows#managing-caches)." diff --git a/translations/es-ES/data/features/pages-custom-workflow.yml b/translations/es-ES/data/features/pages-custom-workflow.yml new file mode 100644 index 0000000000..308c24e035 --- /dev/null +++ b/translations/es-ES/data/features/pages-custom-workflow.yml @@ -0,0 +1,5 @@ +#Issue 7066 +#Publishing Pages via custom Actions workflow +versions: + fpt: '*' + ghec: '*' 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 new file mode 100644 index 0000000000..355b05d57c --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-default.md @@ -0,0 +1,3 @@ +Predeterminadamente, un flujo de trabajo de {% data variables.product.prodname_actions %} se activa cada que creas o actualizas una plantilla de precompilación o cuando la subes a una rama habilitada para precompilación. Así como con otros flujos de trabajo, cuando se están ejecutando los flujos de trabajo de precompilación, estos podrán ya sea consumir algunos de los minutos de las acciones que se inlcuyen en tu cuenta, en caso de que los tengas, o incurrir en cambios para los minutos de las acciones. Para obtener más información sobre los precios para los minutos de las acciones, consulta la sección "[Acerca de la facturación para las {% 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 te cobrará por el almacenamiento de las plantillas de precompilación asociadas con cada configuración de precompilación para los repositorios y regiones específicos. El almacenamiento de plantillas de precompilación se factura con la misma tasa 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 new file mode 100644 index 0000000000..3317291e62 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/billing-for-prebuilds-reducing.md @@ -0,0 +1,3 @@ +Para reducir el consumo de minutos de acciones, puedes configurar una plantilla de precompilaciòn para que se actualice únicamente cuando haces un cambio a los archivos de configuración de tu contenedor dev o solo bajo un itinerario personalizado. También puedes administrar el uso de tu almacenamiento si ajustas la cantidad de versiones de plantillas que se retendrán para tus configuraciones precompiladas. Para obtener más información, consulta la sección "[Configurar las precompilaciones](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)". + +Si eres un propietario de organización, puedes rastrear el uso de flujos de trabajo precompilados y de almacenamiento si descargas un reporte de uso de {% data variables.product.prodname_actions %} para tu organización. You can identify workflow runs for prebuilds by filtering the CSV output to only include the workflow called "Create {% data variables.product.prodname_codespaces %} Prebuilds." Para obtener más información, consulta la sección "[Visualizar tu uso de {% data variables.product.prodname_actions %}](/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/billing-for-prebuilds.md b/translations/es-ES/data/reusables/codespaces/billing-for-prebuilds.md deleted file mode 100644 index 17a99cffa8..0000000000 --- a/translations/es-ES/data/reusables/codespaces/billing-for-prebuilds.md +++ /dev/null @@ -1,7 +0,0 @@ -Predeterminadamente, un flujo de trabajo de {% data variables.product.prodname_actions %} se activa cada que creas o actualizas una plantilla de precompilación o cuando la subes a una rama habilitada para precompilación. Así como con otros flujos de trabajo, cuando se están ejecutando los flujos de trabajo de precompilación, estos podrán ya sea consumir algunos de los minutos de las acciones que se inlcuyen en tu cuenta, en caso de que los tengas, o incurrir en cambios para los minutos de las acciones. Para obtener más información sobre los precios para los minutos de las acciones, consulta la sección "[Acerca de la facturación para las {% 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 te cobrará por el almacenamiento de las plantillas de precompilación asociadas con cada configuración de precompilación para los repositorios y regiones específicos. El almacenamiento de plantillas de precompilación se factura con la misma tasa que el almacenamiento de los codespaces. Para obtener más información, consulta la sección "[Calcular el uso de almacenamiento](#calculating-storage-usage)". - -Para reducir el consumo de minutos de acciones, puedes configurar una plantilla de precompilaciòn para que se actualice únicamente cuando haces un cambio a los archivos de configuración de tu contenedor dev o solo bajo un itinerario personalizado. También puedes administrar el uso de tu almacenamiento si ajustas la cantidad de versiones de plantillas que se retendrán para tus configuraciones precompiladas. Para obtener más información, consulta la sección "[Configurar las precompilaciones](/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-a-prebuild)". - -Si eres un propietario de organización, puedes rastrear el uso de flujos de trabajo precompilados y de almacenamiento si descargas un reporte de uso de {% data variables.product.prodname_actions %} para tu organización. Puedes identificar las ejecuciones de flujo de trabajo para las precompilaciones si filtras la salida den CSV para que solo incluya el flujo de trabajo llamado "Crear precompilaciones de codespaces". Para obtener más información, consulta la sección "[Visualizar tu uso de {% data variables.product.prodname_actions %}](/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/prebuilds-not-available.md b/translations/es-ES/data/reusables/codespaces/prebuilds-not-available.md deleted file mode 100644 index c82899edb6..0000000000 --- a/translations/es-ES/data/reusables/codespaces/prebuilds-not-available.md +++ /dev/null @@ -1 +0,0 @@ -Prebuilds are not available if you choose to use a `devcontainer.json` file from a `.devcontainer/SUBDIRECTORY` location when you create a codespace. For information about choosing a `devcontainer.json` file, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)." diff --git a/translations/es-ES/data/reusables/codespaces/prebuilds-permission-authorization.md b/translations/es-ES/data/reusables/codespaces/prebuilds-permission-authorization.md new file mode 100644 index 0000000000..d0fb9ccae7 --- /dev/null +++ b/translations/es-ES/data/reusables/codespaces/prebuilds-permission-authorization.md @@ -0,0 +1,13 @@ + If the dev container configuration for the repository specifies permissions for accessing other repositories, you will be shown an authorization page. For more information on how this is specified in the `devcontainer.json` file, see "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces)." + + Click {% octicon "chevron-down" aria-label="The expand down icon" %} to view the details of the requested permissions. + + ![Screenshot of the authorization page for prebuilds](/assets/images/help/codespaces/prebuild-authorization-page.png) + + Click **Authorize and continue** to grant these permissions for creation of the prebuild. Alternatively, you can click **Continue without authorizing** but, if you do so, codespaces created from the resulting prebuild may not work properly. + + {% note %} + + **Note**: Users who create codespaces using this prebuild will also be asked to grant these permisssions. + + {% endnote %} \ No newline at end of file diff --git a/translations/es-ES/data/reusables/organizations/security-manager-beta-note.md b/translations/es-ES/data/reusables/organizations/security-manager-beta-note.md index ba9f9a4e95..ae3e8fca1d 100644 --- a/translations/es-ES/data/reusables/organizations/security-manager-beta-note.md +++ b/translations/es-ES/data/reusables/organizations/security-manager-beta-note.md @@ -1,5 +1,5 @@ {% note %} -**Nota:** el rol de administrador de seguridad se encuentra en beta público y está sujeto a cambios.{% ifversion fpt %} Esta característica no está disponible para las organizaciones que utilizan planes tradicionales de facturación por repositorio.{% endif %} +**Nota:** El rol de administrador de seguridad se encuentra en beta público y está sujeto a cambios. {% endnote %} diff --git a/translations/es-ES/data/reusables/pages/admin-must-push.md b/translations/es-ES/data/reusables/pages/admin-must-push.md index 99cf0b7a3f..79f244c85a 100644 --- a/translations/es-ES/data/reusables/pages/admin-must-push.md +++ b/translations/es-ES/data/reusables/pages/admin-must-push.md @@ -1,5 +1,5 @@ {% tip %} -**Nota**: Si tu sitio no se publicó automáticamente, asegúrate de que alguien con permisos administrativos y una dirección de correo electrónico verificada haya subido a la fuente de publicación. +**Note**: {% ifversion pages-custom-workflow %}If you are publishing from a branch and{% else %}If{% endif %} your site has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the publishing source. {% endtip %} diff --git a/translations/es-ES/data/reusables/pages/check-workflow-run.md b/translations/es-ES/data/reusables/pages/check-workflow-run.md index 8dfa3889b8..129d8ebf7d 100644 --- a/translations/es-ES/data/reusables/pages/check-workflow-run.md +++ b/translations/es-ES/data/reusables/pages/check-workflow-run.md @@ -1,5 +1,5 @@ {% ifversion fpt %} -1. Si tu sitio de {% data variables.product.prodname_pages %} se compiló desde un repositorio público, este se compila y despliega con un flujo de trabajo de {% data variables.product.prodname_actions %} a menos de que hayas configurado a tu sitio de {% data variables.product.prodname_pages %} para que utilice una herramienta de IC diferente. Para obtener más información sobre cómo ver el estado del flujo de trabajo, consulta la sección "[Ver el historial de ejecución del flujo de trabajo](/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)". +1. Unless your {% data variables.product.prodname_pages %} site is built from a private or internal repository and published from a branch, your site is built and deployed with a {% data variables.product.prodname_actions %} workflow. Para obtener más información sobre cómo ver el estado del flujo de trabajo, consulta la sección "[Ver el historial de ejecución del flujo de trabajo](/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)". {% note %} diff --git a/translations/es-ES/data/reusables/pages/configure-publishing-source.md b/translations/es-ES/data/reusables/pages/configure-publishing-source.md index 33256406b9..b6776dd3f0 100644 --- a/translations/es-ES/data/reusables/pages/configure-publishing-source.md +++ b/translations/es-ES/data/reusables/pages/configure-publishing-source.md @@ -1 +1 @@ -1. Configura tu fuente de publicción. Para obtener más información, consulta "[Configurar una fuente de publicación para tu sitio {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)". +1. Configura tu fuente de publicción. Para obtener más información, consulta "[Configurar una fuente de publicación para tu sitio {% data variables.product.prodname_pages %}](/articles/configuring-a-publishing-source-for-your-github-pages-site)". diff --git a/translations/es-ES/data/reusables/pages/decide-publishing-source.md b/translations/es-ES/data/reusables/pages/decide-publishing-source.md index 862637b38a..28907ae368 100644 --- a/translations/es-ES/data/reusables/pages/decide-publishing-source.md +++ b/translations/es-ES/data/reusables/pages/decide-publishing-source.md @@ -1 +1 @@ -1. Decide qué fuente de publicación quieres utilizar. Para obtener más información, consulta la sección "[Acerca de{% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)". +1. Decide qué fuente de publicación quieres utilizar. For more information, see "[Configuring a publishing source for your GitHub Pages site](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)." diff --git a/translations/es-ES/data/reusables/pages/navigate-publishing-source.md b/translations/es-ES/data/reusables/pages/navigate-publishing-source.md index 5bfdb6c007..a0efb6048e 100644 --- a/translations/es-ES/data/reusables/pages/navigate-publishing-source.md +++ b/translations/es-ES/data/reusables/pages/navigate-publishing-source.md @@ -1 +1 @@ -1. Navega a la fuente de publicación para tu sitio. Para obtener más información acerca de las fuentes de publicación, consulta "[Acerca de las {% data variables.product.prodname_pages %}](/articles/about-github-pages#publishing-sources-for-github-pages-sites)". +1. Navega a la fuente de publicación para tu sitio. For more information, see "[Configuring a publishing source for your GitHub Pages site](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)." diff --git a/translations/es-ES/data/reusables/pages/new-or-existing-repo.md b/translations/es-ES/data/reusables/pages/new-or-existing-repo.md index a204a46ae5..762dd4f301 100644 --- a/translations/es-ES/data/reusables/pages/new-or-existing-repo.md +++ b/translations/es-ES/data/reusables/pages/new-or-existing-repo.md @@ -1,4 +1,6 @@ -Si tu sitio es un proyecto independiente, puedes crear un repositorio nuevo para almacenar el código fuente del mismo. Si tu sitio se asocia con un proyecto existente, puedes agregar el código fuente al repositorio de dicho proyecto en una carpeta de `/docs` en la rama predeterminada o en una diferente. Por ejemplo, si estás creando un sitio para publicar documentación para un proyecto que ya está en {% data variables.product.product_name %}, podrías querer almacenar el código fuente para este sitio en el mismo repositorio donde se encuentra el proyecto. +You can either create a repository or choose an existing repository for your site. + +If you want to create a {% data variables.product.prodname_pages %} site for a repository where not all of the files in the repository are related to the site, you will be able to configure a publishing source for your site. For example, you can have a dedicated branch and folder to hold your site source files{% ifversion pages-custom-workflow %}, or you can use a custom {% data variables.product.prodname_actions %} workflow to build and deploy your site source files{% endif %}. {% ifversion fpt or ghec %}Si la cuenta a la que pertenece el repositorio utiliza {% data variables.product.prodname_free_user %} o {% data variables.product.prodname_free_team %} para organizaciones, el repositorio deberá ser público.{% endif %} diff --git a/translations/es-ES/data/reusables/pages/pages-about-branch-source.md b/translations/es-ES/data/reusables/pages/pages-about-branch-source.md new file mode 100644 index 0000000000..e84fc9f3ca --- /dev/null +++ b/translations/es-ES/data/reusables/pages/pages-about-branch-source.md @@ -0,0 +1 @@ +You can specify which branch and folder to use as your publishing source. The source branch can be any branch in your repository, and the source folder can either be the root of the repository (`/`) on the source branch or a `/docs` folder on the source branch. Whenever changes are pushed to the source branch, the changes in the source folder will be published to your {% data variables.product.prodname_pages %} site. diff --git a/translations/es-ES/data/reusables/pages/pages-about-publishing-source.md b/translations/es-ES/data/reusables/pages/pages-about-publishing-source.md new file mode 100644 index 0000000000..a5ea80617b --- /dev/null +++ b/translations/es-ES/data/reusables/pages/pages-about-publishing-source.md @@ -0,0 +1,13 @@ +{% ifversion pages-custom-workflow %} + +You can publish your site when changes are pushed to a specific branch, or you can write a {% data variables.product.prodname_actions %} workflow to publish your site. + +If you do not need any control over the build process for your site, we recommend that you publish your site when changes are pushed to a specific branch. {% data reusables.pages.pages-about-branch-source %} + +If you want to use a build process other than Jekyll or you do not want a dedicated branch to hold your compiled static files, we recommend that you write a {% data variables.product.prodname_actions %} workflow to publish your site. {% data variables.product.product_name %} provides starter workflows for common publishing scenarios to help you write your workflow. + +{% else %} + +Your {% data variables.product.prodname_pages %} site will publish whenever changes are pushed to a specific branch. {% data reusables.pages.pages-about-branch-source %} + +{% endif %} diff --git a/translations/es-ES/data/reusables/pages/pages-custom-workflow-beta.md b/translations/es-ES/data/reusables/pages/pages-custom-workflow-beta.md new file mode 100644 index 0000000000..5f5ce32eef --- /dev/null +++ b/translations/es-ES/data/reusables/pages/pages-custom-workflow-beta.md @@ -0,0 +1,9 @@ +{% ifversion pages-custom-workflow %} + +{% note %} + +Note: Publishing your {% data variables.product.prodname_pages %} site with a custom {% data variables.product.prodname_actions %} workflow is in beta and subject to change. + +{% endnote %} + +{% endif %} \ No newline at end of file diff --git a/translations/es-ES/data/reusables/pages/test-locally.md b/translations/es-ES/data/reusables/pages/test-locally.md index a86da44fc2..dcceb61b5b 100644 --- a/translations/es-ES/data/reusables/pages/test-locally.md +++ b/translations/es-ES/data/reusables/pages/test-locally.md @@ -1 +1 @@ -Los cambios en tu sitio se publican automáticamente cuando se fusionan con la fuente de publicación de tu sitio. Si quieres pre-visualizar tus cambios primero, puedes hacer los cambios localmente en vez de en {% data variables.product.product_name %}. Después, prueba tu sitio localmente. Para obtener más información, consulta "[Verificar tu sitio de {% data variables.product.prodname_pages %} localmente con Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)". +{% ifversion pages-custom-workflow %}If you are publishing from a branch, changes{% else %}Changes{% endif %} to your site are published automatically when the changes are merged into your site's publishing source. {% ifversion pages-custom-workflow %}If you are publishing from a custom {% data variables.product.prodname_actions %} workflow, changes are published whenever your workflow is triggered (typically by a push to the default branch). {% endif %}If you want to preview your changes first, you can make the changes locally instead of on {% data variables.product.product_name %}. Después, prueba tu sitio localmente. Para obtener más información, consulta "[Verificar tu sitio de {% data variables.product.prodname_pages %} localmente con Jekyll](/articles/testing-your-github-pages-site-locally-with-jekyll)". diff --git a/translations/log/es-resets.csv b/translations/log/es-resets.csv index ef570bcea8..9b34fa31e1 100644 --- a/translations/log/es-resets.csv +++ b/translations/log/es-resets.csv @@ -126,7 +126,7 @@ translations/es-ES/content/codespaces/getting-started/deep-dive.md,Listed in loc translations/es-ES/content/codespaces/index.md,Listed in localization-support#489 translations/es-ES/content/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces.md,broken liquid tags translations/es-ES/content/codespaces/overview.md,Listed in localization-support#489 -translations/es-ES/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md,broken liquid tags +translations/es-ES/content/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories.md,broken liquid tags translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces.md,Listed in localization-support#489 translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces.md,Listed in localization-support#489 translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces.md,Listed in localization-support#489