jprdonnelly/docs
1
0
Fork 0
mirror of synced 2026-01-07 09:01:31 -05:00
Code Issues Projects Releases Wiki Activity

Merge pull request #20531 from github/repo-sync

Browse Source 
repo sync
This commit is contained in:
Octomerger Bot
2022-09-10 13:58:16 -04:00
committed by GitHub
parent b053e540e6 e82b4cdac2
commit 35eb9874a9
49 changed files with 2932 additions and 3111 deletions
Download Patch File Download Diff File Expand all files Collapse all files

51
translations/es-ES/content/actions/automating-builds-and-tests/about-continuous-integration.md
View File

@@ -1,6 +1,6 @@
---
title: About continuous integration
intro: 'You can create custom continuous integration (CI) workflows directly in your {% data variables.product.prodname_dotcom %} repository with {% data variables.product.prodname_actions %}.'
title: Acerca de la integración continua
intro: 'Con {% data variables.product.prodname_actions %}, puedes crear flujos de trabajo de integración continua (IC) directamente en tu repositorio de {% data variables.product.prodname_dotcom %}.'
redirect_from:
- /articles/about-continuous-integration
- /github/automating-your-workflow-with-github-actions/about-continuous-integration
@@ -16,45 +16,48 @@ type: overview
topics:
- CI
shortTitle: Continuous integration
ms.openlocfilehash: 26b9088133ad561900d06a0c885d6b06b9b55861
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147518908'
---
{% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %}
{% data reusables.actions.enterprise-beta %}
{% data reusables.actions.enterprise-github-hosted-runners %}
## Acerca de la integración continua
## About continuous integration
La integración continua (CI) es una práctica de software que requiere la confirmación de código de forma periódica en un repositorio compartido. La confirmación de código con mayor frecuencia detecta errores más rápido y reduce la cantidad de código que un desarrollador necesita depurar al encontrar la fuente de un error. Las actualizaciones frecuentes de código facilitan también la fusión de cambios de diferentes miembros de un equipo de desarrollo de software. Esto es excelente para los desarrolladores, que pueden dedicar más tiempo a escribir el código y menos tiempo a depurar errores o resolver conflictos de fusión.
Continuous integration (CI) is a software practice that requires frequently committing code to a shared repository. Committing code more often detects errors sooner and reduces the amount of code a developer needs to debug when finding the source of an error. Frequent code updates also make it easier to merge changes from different members of a software development team. This is great for developers, who can spend more time writing code and less time debugging errors or resolving merge conflicts.
Al confirmar el código en tu repositorio, puedes crear y probar el código continuamente para asegurarte de que la confirmación no introduzca errores. Tus pruebas pueden incluir limpiadores de código (que verifican el formato de estilo), verificaciones de seguridad, cobertura de código, pruebas funcionales y otras verificaciones personalizadas.
When you commit code to your repository, you can continuously build and test the code to make sure that the commit doesn't introduce errors. Your tests can include code linters (which check style formatting), security checks, code coverage, functional tests, and other custom checks.
Para crear y probar tu código es necesario un servidor. Puedes crear y probar las actualizaciones localmente antes de subir un código a un repositorio o puedes usar un servidor CI que verifique las nuevas confirmaciones de código en un repositorio.
Building and testing your code requires a server. You can build and test updates locally before pushing code to a repository, or you can use a CI server that checks for new code commits in a repository.
## Acerca de la integración continua utilizando {% data variables.product.prodname_actions %}
## About continuous integration using {% data variables.product.prodname_actions %}
{% ifversion ghae %}CI using {% data variables.product.prodname_actions %} offers workflows that can build the code in your repository and run your tests. Workflows can run on runner systems that you host. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)."
{% else %} CI using {% data variables.product.prodname_actions %} offers workflows that can build the code in your repository and run your tests. Workflows can run on {% data variables.product.prodname_dotcom %}-hosted virtual machines, or on machines that you host yourself. For more information, see "[About {% data variables.product.prodname_dotcom %}-hosted runners](/actions/using-github-hosted-runners/about-github-hosted-runners)" and "[About self-hosted runners](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)."
{% ifversion ghae %}La CI con {% data variables.product.prodname_actions %} ofrece flujos de trabajo que pueden compilar el código del repositorio y ejecutar las pruebas. Los flujos de trabajo pueden ejecutarse en sistemas de ejecutores que almacenes. Para más información, consulte [Seguridad del ejecutor autohospedado con repositorios públicos](/actions/hosting-your-own-runners/about-self-hosted-runners).
{% else %} Tener una IC utilizando {% data variables.product.prodname_actions %} ofrece flujos de trabajo que pueden compilar el código de tu repositorio y ejecutar tus pruebas. Los flujos de trabajo pueden ejecutarse en máquinas virtuales hospedadas en {% data variables.product.prodname_dotcom %}, o en máquinas que hospedes tú mismo. Para obtener más información, consulta "[Acerca de los ejecutores hospedados en {% data variables.product.prodname_dotcom %}](/actions/using-github-hosted-runners/about-github-hosted-runners)" y "[Acerca de los ejecutores autohospedados](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)".
{% endif %}
You can configure your CI workflow to run when a {% data variables.product.prodname_dotcom %} event occurs (for example, when new code is pushed to your repository), on a set schedule, or when an external event occurs using the repository dispatch webhook.
Puede configurar el flujo de trabajo de CI para que se ejecute cuando se produzca un evento de {% data variables.product.prodname_dotcom %} (por ejemplo, cuando se inserta código nuevo en el repositorio), en una programación establecida o cuando se produce un evento externo mediante el webhook de envío de un repositorio.
{% data variables.product.product_name %} runs your CI tests and provides the results of each test in the pull request, so you can see whether the change in your branch introduces an error. When all CI tests in a workflow pass, the changes you pushed are ready to be reviewed by a team member or merged. When a test fails, one of your changes may have caused the failure.
{% data variables.product.product_name %} ejecuta tus pruebas de CI y entrega los resultados de cada prueba en la solicitud de extracción, de modo que puedas ver si el cambio en tu rama introduce un error. Cuando se superan todas las pruebas de CI en un flujo de trabajo, los cambios que subiste están listos para su revisión por parte de un miembro del equipo o para su fusión. Cuando una prueba falla, es posible que uno de tus cambios haya causado la falla.
When you set up CI in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends CI workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a starter workflow that installs your Node.js packages and runs your tests. You can use the CI starter workflow suggested by {% data variables.product.product_name %}, customize the suggested starter workflow, or create your own custom workflow file to run your CI tests.
Al configurar la CI en tu repositorio, {% data variables.product.product_name %} analiza el código en tu repositorio y recomienda flujos de trabajo de CI n función del lenguaje y el encuadre en tu repositorio. Por ejemplo, si usa [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} sugerirá un flujo de trabajo inicial que instala los paquetes de Node.js y ejecuta las pruebas. Puedes utilizar el flujo de trabajo inicial de IC que sugiere {% data variables.product.product_name %}, personalizarlo o crear tu propio archivo de flujo de trabajo para ejecutar tus pruebas de IC.
![Screenshot of suggested continuous integration starter workflows](/assets/images/help/repository/ci-with-actions-template-picker.png)
![Captura de pantalla de los flujos de trabajo iniciales de integración continua sugeridos](/assets/images/help/repository/ci-with-actions-template-picker.png)
In addition to helping you set up CI workflows for your project, you can use {% data variables.product.prodname_actions %} to create workflows across the full software development life cycle. For example, you can use actions to deploy, package, or release your project. For more information, see "[About {% data variables.product.prodname_actions %}](/articles/about-github-actions)."
Además de ayudarte a configurar flujos de trabajo de CI para tu proyecto, puedes usar {% data variables.product.prodname_actions %} para crear flujos de trabajo durante todo el ciclo de vida de desarrollo de software. Por ejemplo, puedes usar acciones para implementar, empaquetar o lanzar tu proyecto. Para más información, vea "[Acerca de {% data variables.product.prodname_actions %}](/articles/about-github-actions)".
For a definition of common terms, see "[Core concepts for {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)."
Para obtener una definición de términos comunes, vea "[Conceptos básicos para {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)".
## Starter workflow
## Flujo de trabajo inicial
{% data variables.product.product_name %} offers CI starter workflow for a variety of languages and frameworks.
{% data variables.product.product_name %} ofrece un flujo inicial de IC para diversos lenguajes y marcos de trabajo.
Browse the complete list of CI starter workflow offered by {% data variables.product.company_short %} in the {% ifversion fpt or ghec %}[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/main/ci) repository{% else %} `actions/starter-workflows` repository on {% data variables.product.product_location %}{% endif %}.
Examine la lista completa del flujo de trabajo de inicio de CI ofrecido por {% data variables.product.company_short %} en el repositorio {% ifversion fpt or ghec %}[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/main/ci) repository{% else %} `actions/starter-workflows` en {% data variables.product.product_location %}{% endif %}.
## Further reading
## Lecturas adicionales
{% ifversion fpt or ghec %}
- "[Managing billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)"
{% endif %}
- "[Administración de la facturación para {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)" {% endif %}

431
translations/es-ES/content/actions/using-workflows/workflow-syntax-for-github-actions.md
View File

@@ -1,7 +1,7 @@
---
title: Workflow syntax for GitHub Actions
title: Sintaxis del flujo de trabajo para Acciones de GitHub
shortTitle: Workflow syntax
intro: A workflow is a configurable automated process made up of one or more jobs. You must create a YAML file to define your workflow configuration.
intro: Un flujo de trabajo es un proceso automatizado configurable formado por uno o más trabajos. Debes crear un archivo YAML para definir tu configuración de flujo de trabajo.
redirect_from:
- /articles/workflow-syntax-for-github-actions
- /github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions
@@ -14,20 +14,24 @@ versions:
ghae: '*'
ghec: '*'
miniTocMaxHeadingLevel: 4
ms.openlocfilehash: dff224ca488c6cd695546926ab5264377bdfcf0a
ms.sourcegitcommit: b98a79b01967b159f740a942286edae2792fe826
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 08/10/2022
ms.locfileid: '147541081'
---
{% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %}
{% data reusables.actions.enterprise-beta %}
{% data reusables.actions.enterprise-github-hosted-runners %}
## <a name="about-yaml-syntax-for-workflows"></a>Acerca de la sintaxis de YAML para flujos de trabajo
## About YAML syntax for workflows
Los archivos de flujo de trabajo usan la sintaxis de YAML y deben tener una extensión de archivo `.yml` o `.yaml`. {% data reusables.actions.learn-more-about-yaml %}
Workflow files use YAML syntax, and must have either a `.yml` or `.yaml` file extension. {% data reusables.actions.learn-more-about-yaml %}
You must store workflow files in the `.github/workflows` directory of your repository.
Debe almacenar los archivos de flujo de trabajo en el directorio `.github/workflows` del repositorio.
## `name`
The name of your workflow. {% data variables.product.prodname_dotcom %} displays the names of your workflows on your repository's actions page. If you omit `name`, {% data variables.product.prodname_dotcom %} sets it to the workflow file path relative to the root of the repository.
Nombre del flujo de trabajo. {% data variables.product.prodname_dotcom %} muestra los nombres de tus flujos de trabajo en la página de acciones de tu repositorio. Si omite `name`, {% data variables.product.prodname_dotcom %} lo establece en la ruta del archivo de flujo de trabajo en relación con la raíz del repositorio.
## `on`
@@ -58,21 +62,21 @@ The name of your workflow. {% data variables.product.prodname_dotcom %} displays
{% data reusables.actions.reusable-workflows-ghes-beta %}
Use `on.workflow_call` to define the inputs and outputs for a reusable workflow. You can also map the secrets that are available to the called workflow. For more information on reusable workflows, see "[Reusing workflows](/actions/using-workflows/reusing-workflows)."
Use `on.workflow_call` para definir las entradas y salidas de un flujo de trabajo reutilizable. También puedes mapear los secretos que están disponibles para el flujo de trabajo llamado. Para más información sobre los flujos de trabajo reutilizables, vea "[Reutilización de flujos de trabajo](/actions/using-workflows/reusing-workflows)".
### `on.workflow_call.inputs`
When using the `workflow_call` keyword, you can optionally specify inputs that are passed to the called workflow from the caller workflow. For more information about the `workflow_call` keyword, see "[Events that trigger workflows](/actions/learn-github-actions/events-that-trigger-workflows#workflow-reuse-events)."
Al usar la palabra clave `workflow_call`, puede especificar opcionalmente las entradas que se pasan al flujo de trabajo llamado desde el flujo de trabajo que realiza la llamada. Para más información sobre la palabra clave `workflow_call`, vea "[Eventos que desencadenan flujos de trabajo](/actions/learn-github-actions/events-that-trigger-workflows#workflow-reuse-events)".
In addition to the standard input parameters that are available, `on.workflow_call.inputs` requires a `type` parameter. For more information, see [`on.workflow_call.inputs.<input_id>.type`](#onworkflow_callinputsinput_idtype).
Además de los parámetros de entrada estándar que están disponibles, `on.workflow_call.inputs` necesita un parámetro `type`. Para más información, vea [`on.workflow_call.inputs.<input_id>.type`](#onworkflow_callinputsinput_idtype).
If a `default` parameter is not set, the default value of the input is `false` for a boolean, `0` for a number, and `""` for a string.
Si no se establece un parámetro `default`, el valor predeterminado de la entrada es `false` para un valor booleano, `0` para un número y `""` para una cadena.
Within the called workflow, you can use the `inputs` context to refer to an input.
Dentro del flujo de trabajo llamado, puede usar el contexto `inputs` para hacer referencia a una entrada.
If a caller workflow passes an input that is not specified in the called workflow, this results in an error.
Si un flujo de trabajo llamante pasa una entrada que no se especifica en el flujo llamado, dará un error como resultado.
#### Example
#### <a name="example"></a>Ejemplo
{% raw %}
```yaml
@@ -95,19 +99,19 @@ jobs:
```
{% endraw %}
For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)."
Para más información, vea "[Reutilización de flujos de trabajo](/actions/learn-github-actions/reusing-workflows)".
#### `on.workflow_call.inputs.<input_id>.type`
Required if input is defined for the `on.workflow_call` keyword. The value of this parameter is a string specifying the data type of the input. This must be one of: `boolean`, `number`, or `string`.
Obligatorio si se define la entrada para la palabra clave `on.workflow_call`. El valor de este parámetro es una secuencia que especifica el tipo de datos de la entrada. Debe ser uno de los siguientes: `boolean`, `number` o `string`.
### `on.workflow_call.outputs`
A map of outputs for a called workflow. Called workflow outputs are available to all downstream jobs in the caller workflow. Each output has an identifier, an optional `description,` and a `value.` The `value` must be set to the value of an output from a job within the called workflow.
Un mapa de salidas para un flujo de trabajo llamado. Las salidas de flujo de trabajo llamadas se encuentran disponibles en todos los jobs en línea descendente en el flujo de trabajo llamante. Cada salida tiene un identificador, un valor `description,` opcional y un valor `value.`. `value` se debe establecer en el valor de una salida de un trabajo dentro del flujo de trabajo llamado.
In the example below, two outputs are defined for this reusable workflow: `workflow_output1` and `workflow_output2`. These are mapped to outputs called `job_output1` and `job_output2`, both from a job called `my_job`.
En el ejemplo siguiente, se definen dos salidas para este flujo de trabajo reutilizable: `workflow_output1` y `workflow_output2`. Se asignan a las salidas `job_output1` y `job_output2`, las dos de un trabajo denominado `my_job`.
#### Example
#### <a name="example"></a>Ejemplo
{% raw %}
```yaml
@@ -124,17 +128,17 @@ on:
```
{% endraw %}
For information on how to reference a job output, see [`jobs.<job_id>.outputs`](#jobsjob_idoutputs). For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)."
Para obtener información sobre cómo hacer referencia a una salida de trabajo, vea [`jobs.<job_id>.outputs`](#jobsjob_idoutputs). Para más información, vea "[Reutilización de flujos de trabajo](/actions/learn-github-actions/reusing-workflows)".
### `on.workflow_call.secrets`
A map of the secrets that can be used in the called workflow.
Un mapa de los secretos que pueden utilizarse en el flujo de trabajo llamado.
Within the called workflow, you can use the `secrets` context to refer to a secret.
Dentro del flujo de trabajo llamado, puede usar el contexto `secrets` para hacer referencia a un secreto.
If a caller workflow passes a secret that is not specified in the called workflow, this results in an error.
Si un flujo de trabajo llamante pasa un secreto que no se especifica en el flujo de trabajo llamado, esto da un error como resultado.
#### Example
#### <a name="example"></a>Ejemplo
{% raw %}
```yaml
@@ -159,11 +163,11 @@ jobs:
#### `on.workflow_call.secrets.<secret_id>`
A string identifier to associate with the secret.
Un identificador de secuencia para asociar con el secreto.
#### `on.workflow_call.secrets.<secret_id>.required`
A boolean specifying whether the secret must be supplied.
Un booleano que especifica si el secreto debe suministrarse.
{% endif %}
## `on.workflow_run.<branches|branches-ignore>`
@@ -180,13 +184,13 @@ A boolean specifying whether the secret must be supplied.
## `env`
A `map` of environment variables that are available to the steps of all jobs in the workflow. You can also set environment variables that are only available to the steps of a single job or to a single step. For more information, see [`jobs.<job_id>.env`](#jobsjob_idenv) and [`jobs.<job_id>.steps[*].env`](#jobsjob_idstepsenv).
Objeto `map` de variables de entorno disponibles para los pasos de todos los trabajos del flujo de trabajo. También puedes configurar variables de ambiente que solo estén disponibles para los pasos en un solo job o en un solo paso. Para más información, vea [`jobs.<job_id>.env`](#jobsjob_idenv) y [`jobs.<job_id>.steps[*].env`](#jobsjob_idstepsenv).
Variables in the `env` map cannot be defined in terms of other variables in the map.
Las variables del mapa `env` no se pueden definir en relación a otras variables del mapa.
{% data reusables.repositories.actions-env-var-note %}
### Example
### <a name="example"></a>Ejemplo
```yaml
env:
@@ -247,11 +251,11 @@ env:
## `jobs.<job_id>.env`
A `map` of environment variables that are available to all steps in the job. You can also set environment variables for the entire workflow or an individual step. For more information, see [`env`](#env) and [`jobs.<job_id>.steps[*].env`](#jobsjob_idstepsenv).
Objeto `map` de las variables de entorno disponibles para todos los pasos del trabajo. También puedes establecer las variables de ambiente para todo el flujo de trabajo o para un paso en particular. Para más información, vea [`env`](#env) y [`jobs.<job_id>.steps[*].env`](#jobsjob_idstepsenv).
{% data reusables.repositories.actions-env-var-note %}
### Example
### <a name="example"></a>Ejemplo
```yaml
jobs:
@@ -270,11 +274,11 @@ jobs:
## `jobs.<job_id>.steps`
A job contains a sequence of tasks called `steps`. Steps can run commands, run setup tasks, or run an action in your repository, a public repository, or an action published in a Docker registry. Not all steps run actions, but all actions run as a step. Each step runs in its own process in the runner environment and has access to the workspace and filesystem. Because steps run in their own process, changes to environment variables are not preserved between steps. {% data variables.product.prodname_dotcom %} provides built-in steps to set up and complete a job.
Un trabajo contiene una secuencia de tareas denominada `steps`. Los pasos pueden ejecutar comandos, tareas de configuración o una acción en tu repositorio, un repositorio público o una acción publicada en un registro de Docker. No todos los pasos ejecutan acciones, pero todas las acciones se ejecutan como un paso. Cada paso se ejecuta en su propio proceso en el ambiente ejecutor y tiene acceso al espacio de trabajo y al sistema de archivos. Ya que los pasos se ejecutan en su propio proceso, los cambios a las variables de ambiente no se preservan entre pasos. {% data variables.product.prodname_dotcom %} proporciona pasos integrados para configurar y completar un job.
You can run an unlimited number of steps as long as you are within the workflow usage limits. For more information, see {% ifversion fpt or ghec or ghes %}"[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and {% endif %}"[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits){% ifversion fpt or ghec or ghes %}" for self-hosted runner usage limits.{% elsif ghae %}."{% endif %}
Puedes ejecutar un número de pasos ilimitado siempre que estés dentro de los límites de uso del flujo de trabajo. Para más información, vea {% ifversion fpt or ghec or ghes %}"[Límites de uso y facturación](/actions/reference/usage-limits-billing-and-administration)" para ejecutores hospedados en {% data variables.product.prodname_dotcom %} y {% endif %}"[Acerca de los ejecutores autohospedados](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits){% ifversion fpt or ghec or ghes %}" para los límites de uso del ejecutor autohospedado.{% elsif ghae %}".{% endif %}
### Example
### <a name="example"></a>Ejemplo
{% raw %}
```yaml
@@ -300,17 +304,17 @@ jobs:
### `jobs.<job_id>.steps[*].id`
A unique identifier for the step. You can use the `id` to reference the step in contexts. For more information, see "[Contexts](/actions/learn-github-actions/contexts)."
Un identificador único para el paso. Puede usar `id` para hacer referencia al paso en los contextos. Para más información, vea "[Contextos](/actions/learn-github-actions/contexts)".
### `jobs.<job_id>.steps[*].if`
You can use the `if` conditional to prevent a step from running unless a condition is met. You can use any supported context and expression to create a conditional.
Puede usar el condicional `if` para impedir que se ejecute un paso si no se cumple una condición. Puedes usar cualquier contexto y expresión admitidos para crear un condicional.
{% data reusables.actions.expression-syntax-if %} For more information, see "[Expressions](/actions/learn-github-actions/expressions)."
{% data reusables.actions.expression-syntax-if %} Para más información, vea "[Expresiones](/actions/learn-github-actions/expressions)".
#### Example: Using contexts
#### <a name="example-using-contexts"></a>Ejemplo: Utilizando contextos
This step only runs when the event type is a `pull_request` and the event action is `unassigned`.
Este paso solo se ejecuta cuando el tipo de evento es `pull_request` y la acción del evento es `unassigned`.
```yaml
steps:
@@ -319,9 +323,9 @@ steps:
run: echo This event is a pull request that had an assignee removed.
```
#### Example: Using status check functions
#### <a name="example-using-status-check-functions"></a>Ejemplo: Utilizando funciones de verificación de estado
The `my backup step` only runs when the previous step of a job fails. For more information, see "[Expressions](/actions/learn-github-actions/expressions#status-check-functions)."
El objeto `my backup step` solo se ejecuta cuando se produce un error en el paso anterior de un trabajo. Para más información, vea "[Expresiones](/actions/learn-github-actions/expressions#status-check-functions)".
```yaml
steps:
@@ -332,11 +336,11 @@ steps:
uses: actions/heroku@1.0.0
```
#### Example: Using secrets
#### <a name="example-using-secrets"></a>Ejemplo: Utilizar secretos
Secrets cannot be directly referenced in `if:` conditionals. Instead, consider setting secrets as job-level environment variables, then referencing the environment variables to conditionally run steps in the job.
No se puede hacer referencia a los secretos directamente en las condicionales `if:`. En vez de esto, considera configurar secretos como variables de ambiente a nivel de jobs y luego referencia dichas variables para ejecutar pasos de forma condicional en el job.
If a secret has not been set, the return value of an expression referencing the secret (such as {% raw %}`${{ secrets.SuperSecret }}`{% endraw %} in the example) will be an empty string.
Si no se ha establecido un secreto, el valor devuelto de una expresión que hace referencia al secreto (como {% raw %}`${{ secrets.SuperSecret }}`{% endraw %} en el ejemplo) será una cadena vacía.
{% raw %}
```yaml
@@ -355,26 +359,26 @@ jobs:
```
{% endraw %}
For more information, see "[Context availability](/actions/learn-github-actions/contexts#context-availability)" and "[Encrypted secrets](/actions/security-guides/encrypted-secrets)."
Para más información, vea "[Disponibilidad de contextos](/actions/learn-github-actions/contexts#context-availability)" y "[Secretos cifrados](/actions/security-guides/encrypted-secrets)".
### `jobs.<job_id>.steps[*].name`
A name for your step to display on {% data variables.product.prodname_dotcom %}.
Un nombre para que tu paso se muestre en {% data variables.product.prodname_dotcom %}.
### `jobs.<job_id>.steps[*].uses`
Selects an action to run as part of a step in your job. An action is a reusable unit of code. You can use an action defined in the same repository as the workflow, a public repository, or in a [published Docker container image](https://hub.docker.com/).
Selecciona una acción a ejecutar como parte de un paso en tu trabajo. Una acción es una unidad de código reutilizable. Puede usar una acción definida en el mismo repositorio que el flujo de trabajo, un repositorio público o en una [imagen de contenedor de Docker publicada](https://hub.docker.com/).
We strongly recommend that you include the version of the action you are using by specifying a Git ref, SHA, or Docker tag. If you don't specify a version, it could break your workflows or cause unexpected behavior when the action owner publishes an update.
- Using the commit SHA of a released action version is the safest for stability and security.
- If the action publishes major version tags, you should expect to receive critical fixes and security patches while still retaining compatibility. Note that this behavior is at the discretion of the action's author.
- Using the default branch of an action may be convenient, but if someone releases a new major version with a breaking change, your workflow could break.
Te recomendamos firmemente que incluyas la versión de la acción que estás utilizando y especifiques un número de etiqueta de la ref de Git, SHA o Docker. Si no especificas una versión, podrías interrumpir tus flujos de trabajo o provocar un comportamiento inesperado cuando el propietario de la acción publique una actualización.
- El uso del SHA de confirmación de una versión de acción lanzada es lo más seguro para la estabilidad y la seguridad.
- Usar la versión de acción principal específica te permite recibir correcciones críticas y parches de seguridad y al mismo tiempo mantener la compatibilidad. También asegura que tu flujo de trabajo aún debería funcionar.
- Puede ser conveniente utilizar la rama predeterminada de una acciòn, pero si alguien lanza una versiòn principal nueva con un cambio importante, tu flujo de trabajo podrìa fallar.
Some actions require inputs that you must set using the [`with`](#jobsjob_idstepswith) keyword. Review the action's README file to determine the inputs required.
Algunas acciones necesitan entradas que debe establecer mediante la palabra clave [`with`](#jobsjob_idstepswith). Revisa el archivo README de la acción para determinar las entradas requeridas.
Actions are either JavaScript files or Docker containers. If the action you're using is a Docker container you must run the job in a Linux environment. For more details, see [`runs-on`](#jobsjob_idruns-on).
Las acciones son archivos de JavaScript o contenedores de Docker. Si la acción que estás usando es un contenedor de Docker, debes ejecutar el job en un ambiente Linux. Para obtener información, vea [`runs-on`](#jobsjob_idruns-on).
#### Example: Using versioned actions
#### <a name="example-using-versioned-actions"></a>Ejemplo: Utilizando acciones versionadas
```yaml
steps:
@@ -388,11 +392,11 @@ steps:
- uses: actions/checkout@main
```
#### Example: Using a public action
#### <a name="example-using-a-public-action"></a>Ejemplo: Utilizando una acción pública
`{owner}/{repo}@{ref}`
You can specify a branch, ref, or SHA in a public {% data variables.product.prodname_dotcom %} repository.
Puedes especificar una rama, ref, o SHA en un repositorio público de {% data variables.product.prodname_dotcom %}.
```yaml
jobs:
@@ -406,11 +410,11 @@ jobs:
uses: actions/aws@v2.0.1
```
#### Example: Using a public action in a subdirectory
#### <a name="example-using-a-public-action-in-a-subdirectory"></a>Ejemplo: Utilizando una acción pública en un subdirectorio
`{owner}/{repo}/{path}@{ref}`
A subdirectory in a public {% data variables.product.prodname_dotcom %} repository at a specific branch, ref, or SHA.
Un subdirectorio en un repositorio público de {% data variables.product.prodname_dotcom %} en una rama, ref o SHA específicos.
```yaml
jobs:
@@ -420,11 +424,11 @@ jobs:
uses: actions/aws/ec2@main
```
#### Example: Using an action in the same repository as the workflow
#### <a name="example-using-an-action-in-the-same-repository-as-the-workflow"></a>Ejemplo: Utilizando una acción en el mismo repositorio que el flujo de trabajo
`./path/to/dir`
The path to the directory that contains the action in your workflow's repository. You must check out your repository before using the action.
La ruta al directorio que contiene la acción en el repositorio de tu flujo de trabajo. Debes revisar tu repositorio antes de usar la acción.
```yaml
jobs:
@@ -436,11 +440,11 @@ jobs:
uses: ./.github/actions/my-action
```
#### Example: Using a Docker Hub action
#### <a name="example-using-a-docker-hub-action"></a>Ejemplo: Utilizando una acción de Docker Hub
`docker://{image}:{tag}`
A Docker image published on [Docker Hub](https://hub.docker.com/).
Una imagen de Docker publicada en [Docker Hub](https://hub.docker.com/).
```yaml
jobs:
@@ -451,11 +455,11 @@ jobs:
```
{% ifversion fpt or ghec %}
#### Example: Using the {% data variables.product.prodname_registry %} {% data variables.product.prodname_container_registry %}
#### <a name="example-using-the--data-variablesproductprodname_registry---data-variablesproductprodname_container_registry-"></a>Ejemplo: Utilizando el {% data variables.product.prodname_container_registry %} del {% data variables.product.prodname_registry %}
`docker://{host}/{image}:{tag}`
A Docker image in the {% data variables.product.prodname_registry %} {% data variables.product.prodname_container_registry %}.
Una imagen de Docker en el {% data variables.product.prodname_container_registry %} del {% data variables.product.prodname_registry %}.
```yaml
jobs:
@@ -465,11 +469,11 @@ jobs:
uses: docker://ghcr.io/OWNER/IMAGE_NAME
```
{% endif %}
#### Example: Using a Docker public registry action
#### <a name="example-using-a-docker-public-registry-action"></a>Ejemplo: Utilizando una acción del registro público de Docker
`docker://{host}/{image}:{tag}`
A Docker image in a public registry. This example uses the Google Container Registry at `gcr.io`.
Una imagen de Docker en un registro público. En este ejemplo se usa Google Container Registry en `gcr.io`.
```yaml
jobs:
@@ -479,11 +483,11 @@ jobs:
uses: docker://gcr.io/cloud-builders/gradle
```
#### Example: Using an action inside a different private repository than the workflow
#### <a name="example-using-an-action-inside-a-different-private-repository-than-the-workflow"></a>Ejemplo: Utilizando una acción dentro de un repositorio privado diferente al del flujo de trabajo
Your workflow must checkout the private repository and reference the action locally. Generate a personal access token and add the token as an encrypted secret. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)" and "[Encrypted secrets](/actions/reference/encrypted-secrets)."
Tu flujo de trabajo debe registrar el repositorio privado y referenciar la acción de forma local. Genera un token de acceso personal y agrega el token como un secreto cifrado. Para más información, vea "[Creación de un token de acceso personal](/github/authenticating-to-github/creating-a-personal-access-token)" y "[Secretos cifrados](/actions/reference/encrypted-secrets)".
Replace `PERSONAL_ACCESS_TOKEN` in the example with the name of your secret.
Reemplace `PERSONAL_ACCESS_TOKEN` en el ejemplo por el nombre del secreto.
```yaml
jobs:
@@ -502,20 +506,20 @@ jobs:
### `jobs.<job_id>.steps[*].run`
Runs command-line programs using the operating system's shell. If you do not provide a `name`, the step name will default to the text specified in the `run` command.
Ejecuta programas de la línea de comandos usando el shell del sistema operativo. Si no proporciona un valor `name`, el nombre del paso tendrá como valor predeterminado el texto especificado en el comando `run`.
Commands run using non-login shells by default. You can choose a different shell and customize the shell used to run commands. For more information, see [`jobs.<job_id>.steps[*].shell`](#jobsjob_idstepsshell).
Predeterminadamente, los comandos se ejecutan utilizando shells diferentes a los de ingreso. Puedes elegir un shell diferente y personalizar el que utilizaste para ejecutar los comandos. Para más información, vea [`jobs.<job_id>.steps[*].shell`](#jobsjob_idstepsshell).
Each `run` keyword represents a new process and shell in the runner environment. When you provide multi-line commands, each line runs in the same shell. For example:
Cada palabra clave `run` representa un nuevo proceso y shell en el entorno del ejecutor. Cuando proporcionas comandos de varias líneas, cada línea se ejecuta en el mismo shell. Por ejemplo:
* A single-line command:
* Comando de una sola línea:
```yaml
- name: Install Dependencies
run: npm install
```
* A multi-line command:
* Comando de varias líneas:
```yaml
- name: Clean install dependencies and build
@@ -524,7 +528,7 @@ Each `run` keyword represents a new process and shell in the runner environment.
npm run build
```
Using the `working-directory` keyword, you can specify the working directory of where to run the command.
Con la palabra clave `working-directory`, puede especificar el directorio de trabajo desde el que ejecutar el comando.
```yaml
- name: Clean temp directory
@@ -534,20 +538,20 @@ Using the `working-directory` keyword, you can specify the working directory of
### `jobs.<job_id>.steps[*].shell`
You can override the default shell settings in the runner's operating system using the `shell` keyword. You can use built-in `shell` keywords, or you can define a custom set of shell options. The shell command that is run internally executes a temporary file that contains the commands specified in the `run` keyword.
Puede invalidar los valores del shell predeterminado en el sistema operativo del ejecutor mediante la palabra clave `shell`. Puede usar palabras clave `shell` integradas, o bien puede definir un conjunto personalizado de opciones de shell. El comando de shell que se ejecuta internamente ejecuta un archivo temporal que contiene los comandos especificados en la palabra clave `run`.
| Supported platform | `shell` parameter | Description | Command run internally |
| Plataforma compatible | Parámetro `shell` | Descripción | Comando ejecutado interamente |
|--------------------|-------------------|-------------|------------------------|
| Linux / macOS | unspecified | The default shell on non-Windows platforms. Note that this runs a different command to when `bash` is specified explicitly. If `bash` is not found in the path, this is treated as `sh`. | `bash -e {0}` |
| All | `bash` | The default shell on non-Windows platforms with a fallback to `sh`. When specifying a bash shell on Windows, the bash shell included with Git for Windows is used. | `bash --noprofile --norc -eo pipefail {0}` |
| All | `pwsh` | The PowerShell Core. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. | `pwsh -command ". '{0}'"` |
| All | `python` | Executes the python command. | `python {0}` |
| Linux / macOS | `sh` | The fallback behavior for non-Windows platforms if no shell is provided and `bash` is not found in the path. | `sh -e {0}` |
| Windows | `cmd` | {% data variables.product.prodname_dotcom %} appends the extension `.cmd` to your script name and substitutes for `{0}`. | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. |
| Windows | `pwsh` | This is the default shell used on Windows. The PowerShell Core. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. If your self-hosted Windows runner does not have _PowerShell Core_ installed, then _PowerShell Desktop_ is used instead.| `pwsh -command ". '{0}'"`. |
| Windows | `powershell` | The PowerShell Desktop. {% data variables.product.prodname_dotcom %} appends the extension `.ps1` to your script name. | `powershell -command ". '{0}'"`. |
| Linux/macOS | unspecified | El shell predeterminado en plataformas que no son de Windows. Ten en cuenta que esto ejecuta un comando diferente a cuando `bash` se especifica explícitamente. Si `bash` no se encuentra en la ruta de acceso, se trata como `sh`. | `bash -e {0}` |
| Todo | `bash` | El shell predeterminado en plataformas que no son de Windows con una reserva en `sh`. Al especificar un bash shell en Windows, se usa el bash shell incluido con Git para Windows. | `bash --noprofile --norc -eo pipefail {0}` |
| Todo | `pwsh` | Powershell Core. {% data variables.product.prodname_dotcom %} agrega la extensión `.ps1` al nombre del script. | `pwsh -command ". '{0}'"` |
| Todo | `python` | Ejecuta el comando python. | `python {0}` |
| Linux/macOS | `sh` | El comportamiento de reserva para plataformas que no son Windows si no se proporciona un shell y `bash` no se encuentra en la ruta. | `sh -e {0}` |
| Windows | `cmd` | {% data variables.product.prodname_dotcom %} agrega la extensión `.cmd` al nombre del script y lo sustituye por `{0}`. | `%ComSpec% /D /E:ON /V:OFF /S /C "CALL "{0}""`. |
| Windows | `pwsh` | Este es el shell predeterminado que se usa en Windows. Powershell Core. {% data variables.product.prodname_dotcom %} agrega la extensión `.ps1` al nombre del script. Si el ejecutor autohospedado de Windows no tiene _PowerShell Core_ instalado, en su lugar se usa _PowerShell Desktop_.| `pwsh -command ". '{0}'"`. |
| Windows | `powershell` | El PowerShell Desktop. {% data variables.product.prodname_dotcom %} agrega la extensión `.ps1` al nombre del script. | `powershell -command ". '{0}'"`. |
#### Example: Running a script using bash
#### <a name="example-running-a-script-using-bash"></a>Ejemplo: Ejecutando un script utilizando bash
```yaml
steps:
@@ -556,7 +560,7 @@ steps:
shell: bash
```
#### Example: Running a script using Windows `cmd`
#### <a name="example-running-a-script-using-windows-cmd"></a>Ejemplo: Ejecución de un script con Windows `cmd`
```yaml
steps:
@@ -565,7 +569,7 @@ steps:
shell: cmd
```
#### Example: Running a script using PowerShell Core
#### <a name="example-running-a-script-using-powershell-core"></a>Ejemplo: Ejecutando un script utilizando PowerShell Core
```yaml
steps:
@@ -574,7 +578,7 @@ steps:
shell: pwsh
```
#### Example: Using PowerShell Desktop to run a script
#### <a name="example-using-powershell-desktop-to-run-a-script"></a>Ejemplo: Utilizar PowerShell Desktop para ejecutar un script
```yaml
steps:
@@ -583,7 +587,7 @@ steps:
shell: powershell
```
#### Example: Running a python script
#### <a name="example-running-a-python-script"></a>Ejemplo: Ejecutando un script de python
```yaml
steps:
@@ -594,11 +598,11 @@ steps:
shell: python
```
#### Custom shell
#### <a name="custom-shell"></a>Shell personalizado
You can set the `shell` value to a template string using `command […options] {0} [..more_options]`. {% data variables.product.prodname_dotcom %} interprets the first whitespace-delimited word of the string as the command, and inserts the file name for the temporary script at `{0}`.
Puede establecer el valor `shell` en una cadena de plantilla mediante `command […options] {0} [..more_options]`. {% data variables.product.prodname_dotcom %} interpreta la primera palabra delimitada por espacios en blanco de la cadena como el comando e inserta el nombre del archivo para el script temporal en `{0}`.
For example:
Por ejemplo:
```yaml
steps:
@@ -608,39 +612,36 @@ steps:
shell: perl {0}
```
The command used, `perl` in this example, must be installed on the runner.
El comando que se usa, `perl` en este ejemplo, debe estar instalado en el ejecutor.
{% ifversion ghae %}
{% data reusables.actions.self-hosted-runners-software %}
{% elsif fpt or ghec %}
For information about the software included on GitHub-hosted runners, see "[Specifications for GitHub-hosted runners](/actions/reference/specifications-for-github-hosted-runners#supported-software)."
{% ifversion ghae %} {% data reusables.actions.self-hosted-runners-software %} {% elsif fpt or ghec %} Para obtener información sobre el software incluido en los ejecutores hospedados en GitHub, vea "[Especificaciones para ejecutores hospedados en GitHub](/actions/reference/specifications-for-github-hosted-runners#supported-software)".
{% endif %}
#### Exit codes and error action preference
#### <a name="exit-codes-and-error-action-preference"></a>Códigos de salida y preferencia de acción de error
For built-in shell keywords, we provide the following defaults that are executed by {% data variables.product.prodname_dotcom %}-hosted runners. You should use these guidelines when running shell scripts.
Para palabras clave shell incorporadas, brindamos los siguientes valores predeterminados accionados por los ejecutadores alojados por {% data variables.product.prodname_dotcom %}. Deberías usar estos lineamientos al ejecutar scripts de shell.
- `bash`/`sh`:
- Fail-fast behavior using `set -eo pipefail`: This option is set when `shell: bash` is explicitly specified. It is not applied by default.
- You can take full control over shell parameters by providing a template string to the shell options. For example, `bash {0}`.
- sh-like shells exit with the exit code of the last command executed in a script, which is also the default behavior for actions. The runner will report the status of the step as fail/succeed based on this exit code.
- Comportamiento con respuesta rápida a errores mediante `set -eo pipefail`: esta opción se establece cuando `shell: bash` se especifica de manera explícita. No se aplica de manera predeterminada.
- Puedes controlar completamente los parámetros del shell al proporcionar una cadena de plantilla a las opciones del shell. Por ejemplo, `bash {0}`.
- Los shells tipo sh salen con el código de salida del último comando ejecutado en un script, que también es el comportamiento predeterminado para las acciones. El ejecutor informará el estado del paso como fallido o exitoso según este código de salida.
- `powershell`/`pwsh`
- Fail-fast behavior when possible. For `pwsh` and `powershell` built-in shell, we will prepend `$ErrorActionPreference = 'stop'` to script contents.
- We append `if ((Test-Path -LiteralPath variable:\LASTEXITCODE)) { exit $LASTEXITCODE }` to powershell scripts so action statuses reflect the script's last exit code.
- Users can always opt out by not using the built-in shell, and providing a custom shell option like: `pwsh -File {0}`, or `powershell -Command "& '{0}'"`, depending on need.
- Comportamiento de falla rápida cuando sea posible. Para el shell integrado de `pwsh` y `powershell`, se antepondrá `$ErrorActionPreference = 'stop'` al contenido del script.
- Se anexa `if ((Test-Path -LiteralPath variable:\LASTEXITCODE)) { exit $LASTEXITCODE }` a los scripts de PowerShell para que los estados de acción reflejen el último código de salida del script.
- Los usuarios siempre pueden optar por no usar el shell integrado y proporcionar una opción de shell personalizada como `pwsh -File {0}` o `powershell -Command "& '{0}'"`, según sea necesario.
- `cmd`
- There doesn't seem to be a way to fully opt into fail-fast behavior other than writing your script to check each error code and respond accordingly. Because we can't actually provide that behavior by default, you need to write this behavior into your script.
- `cmd.exe` will exit with the error level of the last program it executed, and it will return the error code to the runner. This behavior is internally consistent with the previous `sh` and `pwsh` default behavior and is the `cmd.exe` default, so this behavior remains intact.
- No parece haber una manera de optar por completo por un comportamiento de falla rápida que no sea escribir tu script para verificar cada código de error y responder en consecuencia. Debido a que en realidad no podemos proporcionar ese comportamiento por defecto, debes escribir este comportamiento en tu script.
- `cmd.exe` saldrá con el nivel de error del último programa que ha ejecutado y devolverá el código de error al ejecutor. Este comportamiento es internamente coherente con el comportamiento predeterminado de `sh` y `pwsh` anterior, y es el `cmd.exe` predeterminado, por lo que este comportamiento permanece intacto.
### `jobs.<job_id>.steps[*].with`
A `map` of the input parameters defined by the action. Each input parameter is a key/value pair. Input parameters are set as environment variables. The variable is prefixed with `INPUT_` and converted to upper case.
Objeto `map` de los parámetros de entrada definidos por la acción. Cada parámetro de entrada es un par clave/valor. Los parámetros de entrada se establecen como variables de entorno. La variable utiliza el prefijo `INPUT_` se convierte en mayúsculas.
#### Example
#### <a name="example"></a>Ejemplo
Defines the three input parameters (`first_name`, `middle_name`, and `last_name`) defined by the `hello_world` action. These input variables will be accessible to the `hello-world` action as `INPUT_FIRST_NAME`, `INPUT_MIDDLE_NAME`, and `INPUT_LAST_NAME` environment variables.
Define los tres parámetros de entrada (`first_name`, `middle_name` y `last_name`) definidos por la acción `hello_world`. Estas variables de entrada serán accesibles para la acción `hello-world` como las variables de entorno `INPUT_FIRST_NAME`, `INPUT_MIDDLE_NAME` y `INPUT_LAST_NAME`.
```yaml
jobs:
@@ -656,9 +657,9 @@ jobs:
### `jobs.<job_id>.steps[*].with.args`
A `string` that defines the inputs for a Docker container. {% data variables.product.prodname_dotcom %} passes the `args` to the container's `ENTRYPOINT` when the container starts up. An `array of strings` is not supported by this parameter.
Objeto `string` que define las entradas de un contenedor de Docker. {% data variables.product.prodname_dotcom %} pasa `args` al valor `ENTRYPOINT` del contenedor cuando se inicia. Este parámetro no admite un objeto `array of strings`.
#### Example
#### <a name="example"></a>Ejemplo
{% raw %}
```yaml
@@ -671,17 +672,17 @@ steps:
```
{% endraw %}
The `args` are used in place of the `CMD` instruction in a `Dockerfile`. If you use `CMD` in your `Dockerfile`, use the guidelines ordered by preference:
`args` se usan en lugar de la instrucción `CMD` en `Dockerfile`. Si usa `CMD` en `Dockerfile`, utilice las instrucciones ordenadas por preferencia:
1. Document required arguments in the action's README and omit them from the `CMD` instruction.
1. Use defaults that allow using the action without specifying any `args`.
1. If the action exposes a `--help` flag, or something similar, use that as the default to make your action self-documenting.
1. En el documento se necesitaban argumentos en el archivo Léame de la acción y omitirlos de la instrucción `CMD`.
1. Use los valores predeterminados que permiten usar la acción sin especificar `args`.
1. Si la acción expone una marca `--help`, o algo similar, úsela como valor predeterminado para que la acción se documente de forma automática.
### `jobs.<job_id>.steps[*].with.entrypoint`
Overrides the Docker `ENTRYPOINT` in the `Dockerfile`, or sets it if one wasn't already specified. Unlike the Docker `ENTRYPOINT` instruction which has a shell and exec form, `entrypoint` keyword accepts only a single string defining the executable to be run.
Invalida `ENTRYPOINT` de Docker en `Dockerfile`, o bien lo establece si todavía no se ha especificado uno. A diferencia de la instrucción `ENTRYPOINT` de Docker que tiene un formato de shell y archivo ejecutable, la palabra clave `entrypoint` solo acepta una cadena que define el archivo ejecutable que se va a ejecutar.
#### Example
#### <a name="example"></a>Ejemplo
```yaml
steps:
@@ -691,17 +692,17 @@ steps:
entrypoint: /a/different/executable
```
The `entrypoint` keyword is meant to be used with Docker container actions, but you can also use it with JavaScript actions that don't define any inputs.
La palabra clave `entrypoint` se debe usar con acciones de contenedor de Docker, pero también se puede utilizar con acciones de JavaScript que no definan ninguna entrada.
### `jobs.<job_id>.steps[*].env`
Sets environment variables for steps to use in the runner environment. You can also set environment variables for the entire workflow or a job. For more information, see [`env`](#env) and [`jobs.<job_id>.env`](#jobsjob_idenv).
Establece variables de entorno para los pasos a utilizar en el entorno del ejecutor. También puedes establecer las variables de entorno para todo el flujo de trabajo o para una tarea. Para más información, vea [`env`](#env) y [`jobs.<job_id>.env`](#jobsjob_idenv).
{% data reusables.repositories.actions-env-var-note %}
Public actions may specify expected environment variables in the README file. If you are setting a secret in an environment variable, you must set secrets using the `secrets` context. For more information, see "[Using environment variables](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" and "[Contexts](/actions/learn-github-actions/contexts)."
Es posible que las acciones públicas especifiquen las variables de entorno esperadas en el archivo README. Si va a establecer un secreto en una variable de entorno, debe hacerlo con el contexto `secrets`. Para más información, vea "[Uso de variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" y "[Contextos](/actions/learn-github-actions/contexts)".
#### Example
#### <a name="example"></a>Ejemplo
{% raw %}
```yaml
@@ -716,41 +717,41 @@ steps:
### `jobs.<job_id>.steps[*].continue-on-error`
Prevents a job from failing when a step fails. Set to `true` to allow a job to pass when this step fails.
Impide que un trabajo falle cuando falla un paso. Establézcalo en `true` para permitir que un trabajo se supere cuando se produzca un error en este paso.
### `jobs.<job_id>.steps[*].timeout-minutes`
The maximum number of minutes to run the step before killing the process.
El número máximo de minutos para ejecutar el paso antes de terminar el proceso.
## `jobs.<job_id>.timeout-minutes`
The maximum number of minutes to let a job run before {% data variables.product.prodname_dotcom %} automatically cancels it. Default: 360
La cantidad máxima de minutos para permitir que un trabajo se ejecute antes que {% data variables.product.prodname_dotcom %} lo cancele automáticamente. Predeterminado: 360
If the timeout exceeds the job execution time limit for the runner, the job will be canceled when the execution time limit is met instead. For more information about job execution time limits, see {% ifversion fpt or ghec or ghes %}"[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration#usage-limits)" for {% data variables.product.prodname_dotcom %}-hosted runners and {% endif %}"[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits){% ifversion fpt or ghec or ghes %}" for self-hosted runner usage limits.{% elsif ghae %}."{% endif %}
Si el tiempo de espera excede el límite de tiempo de ejecución del job para el ejecutor, dicho job se cancelará cuando se llegue al límite de tiempo de ejecución. Para más información sobre los límites de tiempo de ejecución de trabajos, vea {% ifversion fpt or ghec or ghes %}"[Límites de uso y facturación](/actions/reference/usage-limits-billing-and-administration#usage-limits)" para ejecutores hospedados en {% data variables.product.prodname_dotcom %} y {% endif %}"[Acerca de los ejecutores autohospedados](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits){% ifversion fpt or ghec or ghes %}" para los límites de uso del ejecutor autohospedado.{% elsif ghae %}".{% endif %}
{% note %}
**Note:** {% data reusables.actions.github-token-expiration %} For self-hosted runners, the token may be the limiting factor if the job timeout is greater than 24 hours. For more information on the `GITHUB_TOKEN`, see "[About the `GITHUB_TOKEN` secret](/actions/security-guides/automatic-token-authentication#about-the-github_token-secret)."
**Nota:** {% data reusables.actions.github-token-expiration %} Para los ejecutores autohospedados, el token podría ser el factor de limitación si el tiempo de inactividad del trabajo es superior a 24 horas. Para más información sobre `GITHUB_TOKEN`, vea "[Acerca del secreto `GITHUB_TOKEN`](/actions/security-guides/automatic-token-authentication#about-the-github_token-secret)".
{% endnote %}
## `jobs.<job_id>.strategy`
Use `jobs.<job_id>.strategy` to use a matrix strategy for your jobs. {% data reusables.actions.jobs.about-matrix-strategy %} For more information, see "[Using a matrix for your jobs](/actions/using-jobs/using-a-matrix-for-your-jobs)."
Usa `jobs.<job_id>.strategy` para emplear una estrategia de matriz en los trabajos. {% data reusables.actions.jobs.about-matrix-strategy %} Para obtener más información, consulta "[Uso de una matriz para los trabajos](/actions/using-jobs/using-a-matrix-for-your-jobs)".
### `jobs.<job_id>.strategy.matrix`
{% data reusables.actions.jobs.using-matrix-strategy %}
#### Example: Using a single-dimension matrix
#### <a name="example-using-a-single-dimension-matrix"></a>Ejemplo: Uso de una matriz de una sola dimensión
{% data reusables.actions.jobs.single-dimension-matrix %}
#### Example: Using a multi-dimension matrix
#### <a name="example-using-a-multi-dimension-matrix"></a>Ejemplo: Uso de una matriz de varias dimensiones
{% data reusables.actions.jobs.multi-dimension-matrix %}
#### Example: Using contexts to create matrices
#### <a name="example-using-contexts-to-create-matrices"></a>Ejemplo: Uso de contextos para crear matrices
{% data reusables.actions.jobs.matrix-from-context %}
@@ -758,11 +759,11 @@ Use `jobs.<job_id>.strategy` to use a matrix strategy for your jobs. {% data reu
{% data reusables.actions.jobs.matrix-include %}
#### Example: Expanding configurations
#### <a name="example-expanding-configurations"></a>Ejemplo: Expansión de configuraciones
{% data reusables.actions.jobs.matrix-expand-with-include %}
#### Example: Adding configurations
#### <a name="example-adding-configurations"></a>Ejemplo: Incorporación de configuraciones
{% data reusables.actions.jobs.matrix-add-with-include %}
@@ -780,11 +781,11 @@ Use `jobs.<job_id>.strategy` to use a matrix strategy for your jobs. {% data reu
## `jobs.<job_id>.continue-on-error`
Prevents a workflow run from failing when a job fails. Set to `true` to allow a workflow run to pass when this job fails.
Previene que una ejecución de flujo de trabajo falle cuando un job falle. Establézcalo en `true` para permitir que se supere una ejecución de flujo de trabajo cuando se produce un error en este trabajo.
### Example: Preventing a specific failing matrix job from failing a workflow run
### <a name="example-preventing-a-specific-failing-matrix-job-from-failing-a-workflow-run"></a>Ejemplo: Previniendo un job de matriz específico que falle desde una ejecución de flujo de trabajo que también falle
You can allow specific jobs in a job matrix to fail without failing the workflow run. For example, if you wanted to only allow an experimental job with `node` set to `15` to fail without failing the workflow run.
Puedes permitir que ciertos jobs en una matriz de jobs fallen sin que la ejecución de flujo de trabajo falle. Por ejemplo, si solo quiere permitir que se produzca un error en un trabajo experimental con `node` establecido en `15` sin que se ejecute el flujo de trabajo.
{% raw %}
```yaml
@@ -837,17 +838,17 @@ strategy:
{% data reusables.actions.docker-container-os-support %}
Used to host service containers for a job in a workflow. Service containers are useful for creating databases or cache services like Redis. The runner automatically creates a Docker network and manages the life cycle of the service containers.
Se usa para hospedar contenedores de servicio para un trabajo en un flujo de trabajo. Los contenedores de servicio son útiles para crear bases de datos o servicios de caché como Redis. El ejecutor crea automáticamente una red Docker y administra el ciclo de vida de los contenedores de servicio.
If you configure your job to run in a container, or your step uses container actions, you don't need to map ports to access the service or action. Docker automatically exposes all ports between containers on the same Docker user-defined bridge network. You can directly reference the service container by its hostname. The hostname is automatically mapped to the label name you configure for the service in the workflow.
Si configuras tu trabajo para que se ejecute en un contenedor, o si tu paso usa acciones del contenedor, no necesitas asignar puertos para acceder al servicio o a la acción. Docker expone automáticamente todos los puertos entre contenedores en la misma red de puente definida por el usuario de Docker. Puedes hacer referencia directamente al contenedor de servicio por su nombre de host. El nombre del host se correlaciona automáticamente con el nombre de la etiqueta que configuraste para el servicio en el flujo de trabajo.
If you configure the job to run directly on the runner machine and your step doesn't use a container action, you must map any required Docker service container ports to the Docker host (the runner machine). You can access the service container using localhost and the mapped port.
Si configuras el trabajo para que se ejecute directamente en la máquina del ejecutor y tu paso no usa una acción de contenedor, debes asignar cualquier puerto del contenedor de servicio Docker que sea necesario para el host Docker (la máquina del ejecutor). Puedes acceder al contenedor de servicio utilizando host local y el puerto asignado.
For more information about the differences between networking service containers, see "[About service containers](/actions/automating-your-workflow-with-github-actions/about-service-containers)."
Para más información sobre las diferencias entre los contenedores de servicios de red, vea "[Acerca de los contenedores de servicios](/actions/automating-your-workflow-with-github-actions/about-service-containers)".
### Example: Using localhost
### <a name="example-using-localhost"></a>Ejemplo: Utilizando al host local
This example creates two services: nginx and redis. When you specify the Docker host port but not the container port, the container port is randomly assigned to a free port. {% data variables.product.prodname_dotcom %} sets the assigned container port in the {% raw %}`${{job.services.<service_name>.ports}}`{% endraw %} context. In this example, you can access the service container ports using the {% raw %}`${{ job.services.nginx.ports['8080'] }}`{% endraw %} and {% raw %}`${{ job.services.redis.ports['6379'] }}`{% endraw %} contexts.
Este ejemplo crea dos servicios: nginx y Redis. Cuando especificas el puerto del host de Docker pero no el puerto del contenedor, el puerto del contenedor se asigna aleatoriamente a un puerto gratuito. {% data variables.product.prodname_dotcom %} establece el puerto de contenedor asignado en el contexto {% raw %}`${{job.services.<service_name>.ports}}`{% endraw %}. En este ejemplo, puede acceder a los puertos del contenedor de servicios mediante los contextos {% raw %}`${{ job.services.nginx.ports['8080'] }}`{% endraw %} y {% raw %}`${{ job.services.redis.ports['6379'] }}`{% endraw %}.
```yaml
services:
@@ -865,13 +866,13 @@ services:
### `jobs.<job_id>.services.<service_id>.image`
The Docker image to use as the service container to run the action. The value can be the Docker Hub image name or a registry name.
La imagen Docker para usar como el contenedor de servicio para ejecutar la acción. El valor puede ser el nombre de la imagen de Docker Hub o un nombre de registro.
### `jobs.<job_id>.services.<service_id>.credentials`
{% data reusables.actions.registry-credentials %}
#### Example
#### <a name="example"></a>Ejemplo
{% raw %}
```yaml
@@ -891,23 +892,23 @@ services:
### `jobs.<job_id>.services.<service_id>.env`
Sets a `map` of environment variables in the service container.
Establece un valor `map` de variables de entorno en el contenedor de servicios.
### `jobs.<job_id>.services.<service_id>.ports`
Sets an `array` of ports to expose on the service container.
Establece un valor `array` de puertos que se van a exponer en el contenedor de servicios.
### `jobs.<job_id>.services.<service_id>.volumes`
Sets an `array` of volumes for the service container to use. You can use volumes to share data between services or other steps in a job. You can specify named Docker volumes, anonymous Docker volumes, or bind mounts on the host.
Establece un valor `array` de volúmenes para el contenedor de servicios. Puedes usar volúmenes para compartir datos entre servicios u otros pasos en un trabajo. Puedes especificar volúmenes Docker con nombre, volúmenes Docker anónimos o montajes de enlace en el host.
To specify a volume, you specify the source and destination path:
Para especificar un volumen, especifica la ruta de origen y destino:
`<source>:<destinationPath>`.
The `<source>` is a volume name or an absolute path on the host machine, and `<destinationPath>` is an absolute path in the container.
`<source>` es un nombre de volumen o una ruta absoluta en el equipo host y `<destinationPath>` es una ruta absoluta en el contenedor.
#### Example
#### <a name="example"></a>Ejemplo
```yaml
volumes:
@@ -918,11 +919,11 @@ volumes:
### `jobs.<job_id>.services.<service_id>.options`
Additional Docker container resource options. For a list of options, see "[`docker create` options](https://docs.docker.com/engine/reference/commandline/create/#options)."
Opciones adicionales de recursos del contenedor Docker. Para obtener una lista de opciones, vea "[Opciones de `docker create`](https://docs.docker.com/engine/reference/commandline/create/#options)".
{% warning %}
**Warning:** The `--network` option is not supported.
**Advertencia:** No se admite la opción `--network`.
{% endwarning %}
@@ -931,25 +932,25 @@ Additional Docker container resource options. For a list of options, see "[`dock
{% data reusables.actions.reusable-workflows-ghes-beta %}
The location and version of a reusable workflow file to run as a job. {% ifversion fpt or ghec or ghes > 3.4 or ghae-issue-6000 %}Use one of the following syntaxes:{% endif %}
La ubicación y versión de un archivo de flujo de trabajo reutilizable a ejecutar como un job. {% ifversion fpt or ghec or ghes > 3.4 or ghae-issue-6000 %}Use una de las siguientes sintaxis:{% endif %}
{% data reusables.actions.reusable-workflow-calling-syntax %}
### Example
### <a name="example"></a>Ejemplo
{% data reusables.actions.uses-keyword-example %}
For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)."
Para más información, vea "[Reutilización de flujos de trabajo](/actions/learn-github-actions/reusing-workflows)".
### `jobs.<job_id>.with`
When a job is used to call a reusable workflow, you can use `with` to provide a map of inputs that are passed to the called workflow.
Cuando se utiliza un trabajo para llamar a un flujo de trabajo reutilizable, puede usar `with` para proporcionar un mapa de entradas que se pasen al flujo de trabajo llamado.
Any inputs that you pass must match the input specifications defined in the called workflow.
Cualquier entrada que pases debe coincidir con las especificaciones de la entrada que se define en el flujo de trabajo llamado.
Unlike [`jobs.<job_id>.steps[*].with`](#jobsjob_idstepswith), the inputs you pass with `jobs.<job_id>.with` are not be available as environment variables in the called workflow. Instead, you can reference the inputs by using the `inputs` context.
A diferencia de [`jobs.<job_id>.steps[*].with`](#jobsjob_idstepswith), las entradas que se pasan con `jobs.<job_id>.with` no están disponibles como variables de entorno en el flujo de trabajo llamado. En su lugar, puede hacer referencia a las entradas mediante el contexto `inputs`.
#### Example
#### <a name="example"></a>Ejemplo
```yaml
jobs:
@@ -961,17 +962,17 @@ jobs:
### `jobs.<job_id>.with.<input_id>`
A pair consisting of a string identifier for the input and the value of the input. The identifier must match the name of an input defined by [`on.workflow_call.inputs.<inputs_id>`](/actions/creating-actions/metadata-syntax-for-github-actions#inputsinput_id) in the called workflow. The data type of the value must match the type defined by [`on.workflow_call.inputs.<input_id>.type`](#onworkflow_callinputsinput_idtype) in the called workflow.
Un par que consiste de un identificador de secuencias para la entrada y del valor de entrada. El identificador debe coincidir con el nombre de una entrada definida por [`on.workflow_call.inputs.<inputs_id>`](/actions/creating-actions/metadata-syntax-for-github-actions#inputsinput_id) en el flujo de trabajo llamado. El tipo de datos del valor debe coincidir con el tipo definido por [`on.workflow_call.inputs.<input_id>.type`](#onworkflow_callinputsinput_idtype) en el flujo de trabajo llamado.
Allowed expression contexts: `github`, and `needs`.
Contextos de expresión permitidos: `github` y `needs`.
### `jobs.<job_id>.secrets`
When a job is used to call a reusable workflow, you can use `secrets` to provide a map of secrets that are passed to the called workflow.
Cuando se utiliza un trabajo para llamar a un flujo de trabajo reutilizable, puede usar `secrets` para proporcionar un mapa de secretos que se pasen al flujo de trabajo llamado.
Any secrets that you pass must match the names defined in the called workflow.
Cualquier secreto que pases debe coincidir con los nombres que se definen en el flujo de trabajo llamado.
#### Example
#### <a name="example"></a>Ejemplo
{% raw %}
```yaml
@@ -987,9 +988,9 @@ jobs:
### `jobs.<job_id>.secrets.inherit`
Use the `inherit` keyword to pass all the calling workflow's secrets to the called workflow. This includes all secrets the calling workflow has access to, namely organization, repository, and environment secrets. The `inherit` keyword can be used to pass secrets across repositories within the same organization, or across organizations within the same enterprise.
Usa la palabra clave `inherit` para pasar todos los secretos del flujo de trabajo que realiza la llamada al flujo de trabajo llamado. Esto incluye todos los secretos a los que tiene acceso el flujo de trabajo que realiza la llamada, es decir, los secretos de la organización, al repositorio y el entorno. La palabra clave `inherit` se puede usar para pasar secretos entre repositorios de la misma organización o entre organizaciones de la misma empresa.
#### Example
#### <a name="example"></a>Ejemplo
{% raw %}
@@ -1021,74 +1022,66 @@ jobs:
### `jobs.<job_id>.secrets.<secret_id>`
A pair consisting of a string identifier for the secret and the value of the secret. The identifier must match the name of a secret defined by [`on.workflow_call.secrets.<secret_id>`](#onworkflow_callsecretssecret_id) in the called workflow.
Un par que consiste de un identificador de secuencias para el secreto y el valor de dicho secreto. El identificador debe coincidir con el nombre de un secreto definido por [`on.workflow_call.secrets.<secret_id>`](#onworkflow_callsecretssecret_id) en el flujo de trabajo llamado.
Allowed expression contexts: `github`, `needs`, and `secrets`.
Contextos de expresión permitidos: `github`, `needs` y `secrets`.
{% endif %}
## Filter pattern cheat sheet
## <a name="filter-pattern-cheat-sheet"></a>Hoja de datos de patrones de filtro
You can use special characters in path, branch, and tag filters.
Puedes usar caracteres especiales en los filtros de ruta, de rama y de etiqueta.
- `*`: Matches zero or more characters, but does not match the `/` character. For example, `Octo*` matches `Octocat`.
- `**`: Matches zero or more of any character.
- `?`: Matches zero or one of the preceding character.
- `+`: Matches one or more of the preceding character.
- `[]` Matches one character listed in the brackets or included in ranges. Ranges can only include `a-z`, `A-Z`, and `0-9`. For example, the range`[0-9a-z]` matches any digit or lowercase letter. For example, `[CB]at` matches `Cat` or `Bat` and `[1-2]00` matches `100` and `200`.
- `!`: At the start of a pattern makes it negate previous positive patterns. It has no special meaning if not the first character.
- `*`: coincide con cero o más caracteres, pero no coincide con el carácter `/`. Por ejemplo, `Octo*` coincide con `Octocat`.
- `**`: coincide con cero o más repeticiones de cualquier carácter.
- `?`: Coincide con cero o una repetición del carácter anterior.
- `+`: coincide con cero o más repeticiones del carácter anterior.
- `[]` coincide con un carácter que aparece en los corchetes o que se incluye en los rangos. Los rangos solo pueden incluir `a-z`, `A-Z`y `0-9`. Por ejemplo, el rango `[0-9a-z]` coincide con cualquier dígito o letra minúscula. Por ejemplo, `[CB]at` coincide con `Cat` o `Bat`, y `[1-2]00` coincide con `100` y `200`.
- `!`: al comienzo de un patrón hace que se nieguen los patrones positivos anteriores. No tiene ningún significado especial si no es el primer caracter.
The characters `*`, `[`, and `!` are special characters in YAML. If you start a pattern with `*`, `[`, or `!`, you must enclose the pattern in quotes. Also, if you use a [flow sequence](https://yaml.org/spec/1.2.2/#flow-sequences) with a pattern containing `[` and/or `]`, the pattern must be enclosed in quotes.
Los caracteres `*`, `[` y `!` son caracteres especiales en YAML. Si inicia un patrón con `*`, `[` o `!`, debe incluirlo entre comillas.
```yaml
# Valid
branches:
- '**/README.md'
- '**/README.md'
# Invalid - creates a parse error that
# prevents your workflow from running.
branches:
- **/README.md
# Valid
branches: [ main, 'release/v[0-9].[0-9]' ]
# Invalid - creates a parse error
branches: [ main, release/v[0-9].[0-9] ]
- **/README.md
```
For more information about branch, tag, and path filter syntax, see "[`on.<push>.<branches|tags>`](#onpushbranchestagsbranches-ignoretags-ignore)", "[`on.<pull_request>.<branches|tags>`](#onpull_requestpull_request_targetbranchesbranches-ignore)", and "[`on.<push|pull_request>.paths`](#onpushpull_requestpull_request_targetpathspaths-ignore)."
Para más información sobre la sintaxis de filtro de rama, etiqueta y ruta, vea "[`on.<push>.<branches|tags>`](#onpushbranchestagsbranches-ignoretags-ignore)", "[`on.<pull_request>.<branches|tags>`](#onpull_requestpull_request_targetbranchesbranches-ignore)" y "[`on.<push|pull_request>.paths`](#onpushpull_requestpull_request_targetpathspaths-ignore)".
### Patterns to match branches and tags
### <a name="patterns-to-match-branches-and-tags"></a>Patrones para encontrar ramas y etiquetas
| Pattern | Description | Example matches |
| Patrón | Descripción | Coincidencias de ejemplo |
|---------|------------------------|---------|
| `feature/*` | The `*` wildcard matches any character, but does not match slash (`/`). | `feature/my-branch`<br/><br/>`feature/your-branch` |
| `feature/**` | The `**` wildcard matches any character including slash (`/`) in branch and tag names. | `feature/beta-a/my-branch`<br/><br/>`feature/your-branch`<br/><br/>`feature/mona/the/octocat` |
| `main`<br/><br/>`releases/mona-the-octocat` | Matches the exact name of a branch or tag name. | `main`<br/><br/>`releases/mona-the-octocat` |
| `'*'` | Matches all branch and tag names that don't contain a slash (`/`). The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | `main`<br/><br/>`releases` |
| `'**'` | Matches all branch and tag names. This is the default behavior when you don't use a `branches` or `tags` filter. | `all/the/branches`<br/><br/>`every/tag` |
| `'*feature'` | The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | `mona-feature`<br/><br/>`feature`<br/><br/>`ver-10-feature` |
| `v2*` | Matches branch and tag names that start with `v2`. | `v2`<br/><br/>`v2.0`<br/><br/>`v2.9` |
| `v[12].[0-9]+.[0-9]+` | Matches all semantic versioning branches and tags with major version 1 or 2. | `v1.10.1`<br/><br/>`v2.0.0` |
| `feature/*` | El carácter comodín `*` coincide con cualquier carácter, pero no con la barra diagonal (`/`). | `feature/my-branch`<br/><br/>`feature/your-branch` |
| `feature/**` | El carácter comodín `**` coincide con cualquier carácter, incluida la barra diagonal (`/`) en los nombres de rama y etiqueta. | `feature/beta-a/my-branch`<br/><br/>`feature/your-branch`<br/><br/>`feature/mona/the/octocat` |
| `main`<br/><br/>`releases/mona-the-octocat` | Encuentra el nombre exacto de una rama o el nombre de etiqueta. | `main`<br/><br/>`releases/mona-the-octocat` |
| `'*'` | Coincide con todos los nombres de rama o de etiqueta que no contienen una barra diagonal (`/`). El carácter `*` es un carácter especial en YAML. Al iniciar un patrón con `*`, debe usar comillas. | `main`<br/><br/>`releases` |
| `'**'` | Encuentra todos los nombres de rama y de etiqueta. Este es el comportamiento predeterminado cuando no se usa un filtro `branches` o `tags`. | `all/the/branches`<br/><br/>`every/tag` |
| `'*feature'` | El carácter `*` es un carácter especial en YAML. Al iniciar un patrón con `*`, debe usar comillas. | `mona-feature`<br/><br/>`feature`<br/><br/>`ver-10-feature` |
| `v2*` | Coincide con los nombres de rama y etiqueta que comienzan por `v2`. | `v2`<br/><br/>`v2.0`<br/><br/>`v2.9` |
| `v[12].[0-9]+.[0-9]+` | Coincide con todas las etiquetas y ramas de versionamiento semántico con la versión principal 1 o 2. | `v1.10.1`<br/><br/>`v2.0.0` |
### Patterns to match file paths
### <a name="patterns-to-match-file-paths"></a>Patrones para encontrar rutas de archivos
Path patterns must match the whole path, and start from the repository's root.
Los patrones de ruta deben coincidir con toda la ruta y comenzar desde la raíz del repositorio.
| Pattern | Description of matches | Example matches |
| Patrón | Descripción de coincidencias | Coincidencias de ejemplo |
|---------|------------------------|-----------------|
| `'*'` | The `*` wildcard matches any character, but does not match slash (`/`). The `*` character is a special character in YAML. When you start a pattern with `*`, you must use quotes. | `README.md`<br/><br/>`server.rb` |
| `'*.jsx?'` | The `?` character matches zero or one of the preceding character. | `page.js`<br/><br/>`page.jsx` |
| `'**'` | The `**` wildcard matches any character including slash (`/`). This is the default behavior when you don't use a `path` filter. | `all/the/files.md` |
| `'*.js'` | The `*` wildcard matches any character, but does not match slash (`/`). Matches all `.js` files at the root of the repository. | `app.js`<br/><br/>`index.js`
| `'**.js'` | Matches all `.js` files in the repository. | `index.js`<br/><br/>`js/index.js`<br/><br/>`src/js/app.js` |
| `docs/*` | All files within the root of the `docs` directory, at the root of the repository. | `docs/README.md`<br/><br/>`docs/file.txt` |
| `docs/**` | Any files in the `/docs` directory at the root of the repository. | `docs/README.md`<br/><br/>`docs/mona/octocat.txt` |
| `docs/**/*.md` | A file with a `.md` suffix anywhere in the `docs` directory. | `docs/README.md`<br/><br/>`docs/mona/hello-world.md`<br/><br/>`docs/a/markdown/file.md`
| `'**/docs/**'` | Any files in a `docs` directory anywhere in the repository. | `docs/hello.md`<br/><br/>`dir/docs/my-file.txt`<br/><br/>`space/docs/plan/space.doc`
| `'**/README.md'` | A README.md file anywhere in the repository. | `README.md`<br/><br/>`js/README.md`
| `'**/*src/**'` | Any file in a folder with a `src` suffix anywhere in the repository. | `a/src/app.js`<br/><br/>`my-src/code/js/app.js`
| `'**/*-post.md'` | A file with the suffix `-post.md` anywhere in the repository. | `my-post.md`<br/><br/>`path/their-post.md` |
| `'**/migrate-*.sql'` | A file with the prefix `migrate-` and suffix `.sql` anywhere in the repository. | `migrate-10909.sql`<br/><br/>`db/migrate-v1.0.sql`<br/><br/>`db/sept/migrate-v1.sql` |
| `*.md`<br/><br/>`!README.md` | Using an exclamation mark (`!`) in front of a pattern negates it. When a file matches a pattern and also matches a negative pattern defined later in the file, the file will not be included. | `hello.md`<br/><br/>_Does not match_<br/><br/>`README.md`<br/><br/>`docs/hello.md` |
| `*.md`<br/><br/>`!README.md`<br/><br/>`README*` | Patterns are checked sequentially. A pattern that negates a previous pattern will re-include file paths. | `hello.md`<br/><br/>`README.md`<br/><br/>`README.doc`|
| `'*'` | El carácter comodín `*` coincide con cualquier carácter, pero no con la barra diagonal (`/`). El carácter `*` es un carácter especial en YAML. Al iniciar un patrón con `*`, debe usar comillas. | `README.md`<br/><br/>`server.rb` |
| `'*.jsx?'` | El carácter `?` coincide con cero o una repetición del carácter anterior. | `page.js`<br/><br/>`page.jsx` |
| `'**'` | El carácter comodín `**` coincide con cualquier carácter, incluida la barra diagonal (`/`). Este es el comportamiento predeterminado cuando no se usa un filtro `path`. | `all/the/files.md` |
| `'*.js'` | El carácter comodín `*` coincide con cualquier carácter, pero no con la barra diagonal (`/`). Coincide con todos los archivos `.js` en la raíz del repositorio. | `app.js`<br/><br/>`index.js`
| `'**.js'` | Coincide con todos los archivos `.js` en el repositorio. | `index.js`<br/><br/>`js/index.js`<br/><br/>`src/js/app.js` |
| `docs/*` | Todos los archivos dentro de la raíz del directorio `docs`, en la raíz del repositorio. | `docs/README.md`<br/><br/>`docs/file.txt` |
| `docs/**` | Todos los archivos del directorio `/docs` en la raíz del repositorio. | `docs/README.md`<br/><br/>`docs/mona/octocat.txt` |
| `docs/**/*.md` | Un archivo con un sufijo `.md` en cualquier parte del directorio `docs`. | `docs/README.md`<br/><br/>`docs/mona/hello-world.md`<br/><br/>`docs/a/markdown/file.md`
| `'**/docs/**'` | Todos los archivos de un directorio `docs` en cualquier parte del repositorio. | `docs/hello.md`<br/><br/>`dir/docs/my-file.txt`<br/><br/>`space/docs/plan/space.doc`
| `'**/README.md'` | Un archivo README.md en cualquier parte del repositorio. | `README.md`<br/><br/>`js/README.md`
| `'**/*src/**'` | Cualquier archivo de una carpeta con un sufijo `src` en cualquier parte del repositorio. | `a/src/app.js`<br/><br/>`my-src/code/js/app.js`
| `'**/*-post.md'` | Un archivo con el sufijo `-post.md` en cualquier parte del repositorio. | `my-post.md`<br/><br/>`path/their-post.md` |
| `'**/migrate-*.sql'` | Un archivo con el prefijo `migrate-` y el sufijo `.sql` en cualquier parte del repositorio. | `migrate-10909.sql`<br/><br/>`db/migrate-v1.0.sql`<br/><br/>`db/sept/migrate-v1.sql` |
| `*.md`<br/><br/>`!README.md` | El uso de una signo de exclamación (`!`) delante de un patrón lo niega. Cuando un archivo coincida con un patrón y también coincida con un patrón negativo definido más adelante en el archivo, no se incluirá el archivo. | `hello.md`<br/><br/>_No coincide_<br/><br/>`README.md`<br/><br/>`docs/hello.md` |
| `*.md`<br/><br/>`!README.md`<br/><br/>`README*` | Los patrones se marcan de forma secuencial. Un patrón que niega un patrón previo volverá a incluir las rutas del archivo. | `hello.md`<br/><br/>`README.md`<br/><br/>`README.doc`|

70
translations/es-ES/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance.md
View File

@@ -1,7 +1,7 @@
---
title: Configuring code scanning for your appliance
title: Configurar el escaneo de código para tu aplicativo
shortTitle: Configuring code scanning
intro: 'You can enable, configure and disable {% data variables.product.prodname_code_scanning %} for {% data variables.product.product_location %}. {% data variables.product.prodname_code_scanning_capc %} allows users to scan code for vulnerabilities and errors.'
intro: 'Puedes habilitar, configurar y deshabilitar {% data variables.product.prodname_code_scanning %} para {% data variables.product.product_location %}. {% data variables.product.prodname_code_scanning_capc %} permite que los usuarios escaneen el código para encontrar vulnerabilidades y errores.'
product: '{% data reusables.gated-features.code-scanning %}'
miniTocMaxHeadingLevel: 3
redirect_from:
@@ -16,74 +16,78 @@ topics:
- Code scanning
- Enterprise
- Security
ms.openlocfilehash: ad1bab39f7fe6af6f07e59d8d5c8b95ccd144711
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147052068'
---
{% data reusables.code-scanning.beta %}
## About {% data variables.product.prodname_code_scanning %}
## Acerca de {% data variables.product.prodname_code_scanning %}
{% data reusables.code-scanning.about-code-scanning %}
You can configure {% data variables.product.prodname_code_scanning %} to run {% data variables.product.prodname_codeql %} analysis and third-party analysis. {% data variables.product.prodname_code_scanning_capc %} also supports running analysis natively using {% data variables.product.prodname_actions %} or externally using existing CI/CD infrastructure. The table below summarizes all the options available to users when you configure {% data variables.product.product_location %} to allow {% data variables.product.prodname_code_scanning %} using actions.
Puedes configurar el {% data variables.product.prodname_code_scanning %} para ejecutar los análisis del {% data variables.product.prodname_codeql %} y de terceros. El {% data variables.product.prodname_code_scanning_capc %} también es compatible con ejecutar análisis de forma nativa utilizando las {% data variables.product.prodname_actions %} o utilizando la infraestructura de IC/DC existente externamente. La siguiente tabla resume todas las opciones disponibles para los usuarios cuando configuras {% data variables.product.product_location %} para que permita el {% data variables.product.prodname_code_scanning %} utilizando acciones.
{% data reusables.code-scanning.enabling-options %}
## Checking whether your license includes {% data variables.product.prodname_GH_advanced_security %}
## Verificar si tu licencia incluye a la {% data variables.product.prodname_GH_advanced_security %}
{% data reusables.advanced-security.check-for-ghas-license %}
## Prerequisites for {% data variables.product.prodname_code_scanning %}
## Prerequisitos para el {% data variables.product.prodname_code_scanning %}
- A license for {% data variables.product.prodname_GH_advanced_security %}{% ifversion ghes %} (see "[About billing for {% data variables.product.prodname_GH_advanced_security %}](/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security)"){% endif %}
- Una licencia para {% data variables.product.prodname_GH_advanced_security %}{% ifversion ghes %} (vea "[Acerca de la facturación de {% data variables.product.prodname_GH_advanced_security %}](/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security)"){% endif %}
- {% data variables.product.prodname_code_scanning_capc %} enabled in the management console (see "[Enabling {% data variables.product.prodname_GH_advanced_security %} for your enterprise](/admin/advanced-security/enabling-github-advanced-security-for-your-enterprise)")
- {% data variables.product.prodname_code_scanning_capc %} habilitado en la consola de administración (vea "[Habilitación de {% data variables.product.prodname_GH_advanced_security %} para la empresa](/admin/advanced-security/enabling-github-advanced-security-for-your-enterprise)")
- A VM or container for {% data variables.product.prodname_code_scanning %} analysis to run in.
- Una MV o contenedor para ejecutar el análisis de {% data variables.product.prodname_code_scanning %}.
## Running {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_actions %}
## Ejecutar el {% data variables.product.prodname_code_scanning %} utilizando {% data variables.product.prodname_actions %}
### Setting up a self-hosted runner
### Configurar un ejecutor auto-hospedado
{% data variables.product.prodname_ghe_server %} can run {% data variables.product.prodname_code_scanning %} using a {% data variables.product.prodname_actions %} workflow. First, you need to provision one or more self-hosted {% data variables.product.prodname_actions %} runners in your environment. You can provision self-hosted runners at the repository, organization, or enterprise account level. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."
{% data variables.product.prodname_ghe_server %} puede ejecutar un {% data variables.product.prodname_code_scanning %} utilizando un flujo de trabajo de {% data variables.product.prodname_actions %}. Primero, necesitas aprovisionar uno o más ejecutores auto-hospedados de {% data variables.product.prodname_actions %} en tu ambiente. Puedes aprovisionar ejecutores auto-hospedados a nivel de repositorio, organización o empresa. Para más información, vea "[Acerca de los ejecutores autohospedados](/actions/hosting-your-own-runners/about-self-hosted-runners)" y "[Adición de ejecutores autohospedados](/actions/hosting-your-own-runners/adding-self-hosted-runners)".
You must ensure that Git is in the PATH variable on any self-hosted runners you use to run {% data variables.product.prodname_codeql %} actions.
Debes asegurarte de que Git esté en la variable de "PATH" de cualquier ejecutor auto-hospedado que utilices para ejecutar las acciones de {% data variables.product.prodname_codeql %}.
### Provisioning the actions for {% data variables.product.prodname_code_scanning %}
### Aprovisionar las acciones del {% data variables.product.prodname_code_scanning %}
{% ifversion ghes %}
If you want to use actions to run {% data variables.product.prodname_code_scanning %} on {% data variables.product.prodname_ghe_server %}, the actions must be available on your appliance.
{% ifversion ghes %} Si quiere usar acciones para ejecutar {% data variables.product.prodname_code_scanning %} en {% data variables.product.prodname_ghe_server %}, las acciones deben estar disponibles en el dispositivo.
The {% data variables.product.prodname_codeql %} action is included in your installation of {% data variables.product.prodname_ghe_server %}. If {% data variables.product.prodname_ghe_server %} {{ allVersions[currentVersion].currentRelease }} has access to the internet, the action will automatically download the {% data variables.product.prodname_codeql %} {% data variables.product.codeql_cli_ghes_recommended_version %} bundle required to perform analysis. Alternatively, you can use a synchronization tool to make the latest released version of the {% data variables.product.prodname_codeql %} analysis bundle available locally. For more information, see "[Configuring {% data variables.product.prodname_codeql %} analysis on a server without internet access](#configuring-codeql-analysis-on-a-server-without-internet-access)" below.
La acción {% data variables.product.prodname_codeql %} se incluye en tu instalación de {% data variables.product.prodname_ghe_server %}. Si {% data variables.product.prodname_ghe_server %} {{ allVersions[currentVersion].currentRelease }} tiene acceso a Internet, la acción descargará automáticamente la agrupación de {% data variables.product.prodname_codeql %} {% data variables.product.codeql_cli_ghes_recommended_version %} necesaria para realizar el análisis. Como alternativa, puedes utilizar una herramienta de sincronización para que el conjunto de análisis de {% data variables.product.prodname_codeql %} esté disponible de forma local. Para más información, vea "[Configuración del análisis de {% data variables.product.prodname_codeql %} en un servidor sin acceso a Internet](#configuring-codeql-analysis-on-a-server-without-internet-access)" a continuación.
You can also make third-party actions available to users for {% data variables.product.prodname_code_scanning %}, by setting up {% data variables.product.prodname_github_connect %}. For more information, see "[Configuring {% data variables.product.prodname_github_connect %} to sync {% data variables.product.prodname_actions %}](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance#configuring-github-connect-to-sync-github-actions)" below.
También puedes hacer que acciones de terceros estén disponibles para el {% data variables.product.prodname_code_scanning %} para los usuarios si configuras {% data variables.product.prodname_github_connect %}. Para más información, vea "[Configuración de {% data variables.product.prodname_github_connect %} para sincronizar {% data variables.product.prodname_actions %}](/enterprise/admin/configuration/configuring-code-scanning-for-your-appliance#configuring-github-connect-to-sync-github-actions)" a continuación.
### Configuring {% data variables.product.prodname_codeql %} analysis on a server without internet access
If the server on which you are running {% data variables.product.prodname_ghe_server %} is not connected to the internet, and you want to allow users to enable {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} for their repositories, you must use the {% data variables.product.prodname_codeql %} action sync tool to copy the {% data variables.product.prodname_codeql %} analysis bundle from {% data variables.product.prodname_dotcom_the_website %} to your server. The tool, and details of how to use it, are available at [https://github.com/github/codeql-action-sync-tool](https://github.com/github/codeql-action-sync-tool/).
### Configurar el análisis de {% data variables.product.prodname_codeql %} en un servidor sin acceso a internet
Si el servidor en el que estás ejecutando a {% data variables.product.prodname_ghe_server %} no está conectado a internet y quieres permitir que los usuarios habiliten el {% data variables.product.prodname_code_scanning %} de {% data variables.product.prodname_codeql %} para sus repositorios, debes utilizar la herramienta de sincronización de la acción de {% data variables.product.prodname_codeql %} para copiar el paquete de análisis de {% data variables.product.prodname_codeql %} desde {% data variables.product.prodname_dotcom_the_website %} hacia tu servidor. La herramienta y los detalles de cómo usarla están disponibles en [https://github.com/github/codeql-action-sync-tool](https://github.com/github/codeql-action-sync-tool/).
If you set up the {% data variables.product.prodname_codeql %} action sync tool, you can use it to sync the latest releases of the {% data variables.product.prodname_codeql %} action and associated {% data variables.product.prodname_codeql %} analysis bundle. These are compatible with {% data variables.product.prodname_ghe_server %}.
Si configuras la herramienta de sincronización de la acción de {% data variables.product.prodname_codeql %}, puedes utilizarla para sincronizar los últimos lanzamientos de la acción de {% data variables.product.prodname_codeql %} y el paquete de análisis de {% data variables.product.prodname_codeql %} relacionado. Estos son compatibles con {% data variables.product.prodname_ghe_server %}.
{% endif %}
### Configuring {% data variables.product.prodname_github_connect %} to sync {% data variables.product.prodname_actions %}
1. If you want to download action workflows on demand from {% data variables.product.prodname_dotcom_the_website %}, you need to enable {% data variables.product.prodname_github_connect %}. For more information, see "[Enabling {% data variables.product.prodname_github_connect %}](/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud#enabling-github-connect)."
2. You'll also need to enable {% data variables.product.prodname_actions %} for {% data variables.product.product_location %}. For more information, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}](/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server)."
3. The next step is to configure access to actions on {% data variables.product.prodname_dotcom_the_website %} using {% data variables.product.prodname_github_connect %}. For more information, see "[Enabling automatic access to {% data variables.product.prodname_dotcom_the_website %} actions using {% data variables.product.prodname_github_connect %}](/enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect)."
4. Add a self-hosted runner to your repository, organization, or enterprise account. For more information, see "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."
### Configurar {% data variables.product.prodname_github_connect %} para sincronizarse con {% data variables.product.prodname_actions %}
1. Si quieres descargar flujos de trabajo de acciones por petición desde {% data variables.product.prodname_dotcom_the_website %}, necesitarás habilitar {% data variables.product.prodname_github_connect %}. Para más información, vea "[Habilitación de {% data variables.product.prodname_github_connect %}](/admin/configuration/managing-connections-between-your-enterprise-accounts/connecting-your-enterprise-account-to-github-enterprise-cloud#enabling-github-connect)".
2. También tendrá que habilitar {% data variables.product.prodname_actions %} para {% data variables.product.product_location %}. Para más información, vea "[Introducción a {% data variables.product.prodname_actions %} para {% data variables.product.prodname_ghe_server %}](/admin/github-actions/getting-started-with-github-actions-for-github-enterprise-server)".
3. El siguiente paso es configurar el acceso a las acciones en {% data variables.product.prodname_dotcom_the_website %} utilizando {% data variables.product.prodname_github_connect %}. Para más información, vea "[Habilitación del acceso automático a las acciones de {% data variables.product.prodname_dotcom_the_website %} mediante {% data variables.product.prodname_github_connect %}](/enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect)".
4. Agrega un ejecutor auto-hospedado a tu repositorio, organización, o cuenta empresarial. Para más información, vea "[Adición de ejecutores autohospedados](/actions/hosting-your-own-runners/adding-self-hosted-runners)".
## Running code scanning using the {% data variables.product.prodname_codeql_cli %}
## Ejecutar el escaneo de código utilizando el {% data variables.product.prodname_codeql_cli %}
If you don't want to use {% data variables.product.prodname_actions %}, you should run {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_cli %}.
Si no quieres utilizar {% data variables.product.prodname_actions %}, debes ejecutar el {% data variables.product.prodname_code_scanning %} utilizando el {% data variables.product.prodname_codeql_cli %}.
The {% data variables.product.prodname_codeql_cli %} is a command-line tool that you use to analyze codebases on any machine, including a third-party CI/CD system. For more information, see "[Installing CodeQL CLI in your CI system](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system)."
El {% data variables.product.prodname_codeql_cli %} es una herramienta de línea de comandos que utilizas para analizar bases de código en cualquier máquina, incluyendo un sistema de IC/DC de terceros. Para más información, vea "[Instalación de la CLI de CodeQL en el sistema de CI](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system)".
{% ifversion codeql-runner-supported %}
## Running {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_runner %}
## Ejecutar el {% data variables.product.prodname_code_scanning %} utilizando el {% data variables.product.prodname_codeql_runner %}
{% data reusables.code-scanning.deprecation-codeql-runner %}
If you don't want to use {% data variables.product.prodname_actions %}, you can run {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_runner %}.
Si no quieres utilizar {% data variables.product.prodname_actions %}, puedes ejecutar el {% data variables.product.prodname_code_scanning %} utilizando el {% data variables.product.prodname_codeql_runner %}.
The {% data variables.product.prodname_codeql_runner %} is a command-line tool that you can add to your third-party CI/CD system. The tool runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. For more information, see "[Running {% data variables.product.prodname_code_scanning %} in your CI system](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)."
El {% data variables.product.prodname_codeql_runner %} es una herramienta de línea de comandos que puedes agregar a tu sistema de IC/CD de terceros. Esta herramienta ejecuta el análisis de {% data variables.product.prodname_codeql %} en un control de un repositorio de {% data variables.product.prodname_dotcom %}. Para más información, vea "[Ejecución de {% data variables.product.prodname_code_scanning %} en el sistema de CI](/github/finding-security-vulnerabilities-and-errors-in-your-code/running-codeql-code-scanning-in-your-ci-system)".
{% endif %}

99
translations/es-ES/content/admin/configuration/configuring-github-connect/managing-github-connect.md
View File

@@ -1,7 +1,7 @@
---
title: Managing GitHub Connect
title: Administrar GitHub Connect
shortTitle: Manage GitHub Connect
intro: 'You can enable {% data variables.product.prodname_github_connect %} to access additional features and workflows for {% data variables.product.product_location %}.'
intro: 'Puedes habilitar {% data variables.product.prodname_github_connect %} para que acceda a las características y flujos de trabajo adicionales para {% data variables.product.product_location %}.'
redirect_from:
- /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-to-github-com
- /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com
@@ -20,69 +20,64 @@ topics:
- GitHub Connect
- Infrastructure
- Networking
ms.openlocfilehash: 0dea06870a1bc7bc951580acf3d83a9d2f0984c2
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '146332460'
---
{% data reusables.github-connect.beta %}
## About {% data variables.product.prodname_github_connect %}
## Acerca de {% data variables.product.prodname_github_connect %}
You can access additional features and workflows on {% data variables.product.product_location %} by enabling {% data variables.product.prodname_github_connect %}. For more information, see "[About {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/about-github-connect)."
Puedes acceder a las características y flujos de trabajo adicionales de {% data variables.product.product_location %} si habilitas {% data variables.product.prodname_github_connect %}. Para más información, vea "[Acerca de {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/about-github-connect)".
When you enable {% data variables.product.prodname_github_connect %}, you configure a connection between {% data variables.product.product_location %} and an organization or enterprise account on {% data variables.product.prodname_ghe_cloud %}. Enabling {% data variables.product.prodname_github_connect %} creates a {% data variables.product.prodname_github_app %} owned by the organization or enterprise account on {% data variables.product.prodname_ghe_cloud %}. {% data variables.product.product_name %} uses the {% data variables.product.prodname_github_app %}'s credentials to make requests to {% data variables.product.prodname_ghe_cloud %}.
Cuando habilitas {% data variables.product.prodname_github_connect %}, configuras una conexión entre {% data variables.product.product_location %} y una organización o cuenta empresarial en {% data variables.product.prodname_ghe_cloud %}. El Habilitar {% data variables.product.prodname_github_connect %} crea una {% data variables.product.prodname_github_app %} que pertenece a la cuenta de organización o de empresa de {% data variables.product.prodname_ghe_cloud %}. {% data variables.product.product_name %} usa las credenciales de {% data variables.product.prodname_github_app %} para realizar solicitudes a {% data variables.product.prodname_ghe_cloud %}.
{% ifversion ghes %}
{% data variables.product.prodname_ghe_server %} stores credentials from the {% data variables.product.prodname_github_app %}. The following credentials will be replicated to all nodes in a high availability or cluster environment, and stored in any backups, including snapshots created by {% data variables.product.prodname_enterprise_backup_utilities %}.
- An authentication token, which is valid for one hour
- A private key, which is used to generate a new authentication token
{% ifversion ghes %} {% data variables.product.prodname_ghe_server %} almacena las credenciales de {% data variables.product.prodname_github_app %}. Las siguientes credenciales se replicarán en todos los nodos en un ambiente de clúster o de disponibilidad alta y se almacenarán en cualquier respaldo, incluyendo las capturas de pantalla que crea {% data variables.product.prodname_enterprise_backup_utilities %}.
- Un token de autenticación, que es válido durante una hora
- Una clave privada, que se usa para generar un nuevo token de autenticación {% endif %}
## Prerrequisitos
Para utilizar {% data variables.product.prodname_github_connect %}, debes tener una cuenta de organización o de empresa en {% data variables.product.prodname_dotcom_the_website %} que utilice {% data variables.product.prodname_ghe_cloud %}. Puede que ya hayas incluido a {% data variables.product.prodname_ghe_cloud %} en tu plan,. {% data reusables.enterprise.link-to-ghec-trial %}
{% ifversion ghes %} Si su cuenta de organización o empresa de {% data variables.product.prodname_dotcom_the_website %} usa listas de direcciones IP permitidas, debe agregar la dirección IP o la red de {% data variables.product.product_location %} a su lista de IP permitidas en {% data variables.product.prodname_dotcom_the_website %}. Para más información, vea "[Administración de direcciones IP permitidas para la organización](/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)" y "[Aplicación de directivas para la configuración de seguridad en la empresa
](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-allowed-ip-addresses-for-organizations-in-your-enterprise)" en la documentación de {% data variables.product.prodname_ghe_cloud %}.
Para configurar una conexión, la configuración de proxy debe permitir la conectividad a `github.com`, `api.github.com` y `uploads.github.com`. Para obtener más información, consulte "[Configuración de un servidor proxy web de salida](/enterprise/admin/guides/installation/configuring-an-outbound-web-proxy-server)".
{% endif %}
## Prerequisites
## Habilitar {% data variables.product.prodname_github_connect %}
To use {% data variables.product.prodname_github_connect %}, you must have an organization or enterprise account on {% data variables.product.prodname_dotcom_the_website %} that uses {% data variables.product.prodname_ghe_cloud %}. You may already have {% data variables.product.prodname_ghe_cloud %} included in your plan. {% data reusables.enterprise.link-to-ghec-trial %}
Los propietarios de empresa que también son propietarios de una cuenta de empresa u organización que utiliza {% data variables.product.prodname_ghe_cloud %} pueden habilitar {% data variables.product.prodname_github_connect %}.
Si estás conectando a {% data variables.product.product_location %} a una organización en {% data variables.product.prodname_ghe_cloud %} que no le pertenezca a una cuenta empresarial, debes iniciar sesión en {% data variables.product.prodname_dotcom_the_website %} como propietario de organización.
Si estás conectando {% data variables.product.product_location %} a una organización de {% data variables.product.prodname_ghe_cloud %} que le pertenezca a una cuenta empresarial o si la conectas a la cuenta empresarial misma, deberás iniciar sesión en {% data variables.product.prodname_dotcom_the_website %} como propietario de empresa.
{% ifversion ghes %}
If your organization or enterprise account on {% data variables.product.prodname_dotcom_the_website %} uses IP allow lists, you must add the IP address or network for {% data variables.product.product_location %} to your IP allow list on {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Managing allowed IP addresses for your organization](/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)" and "[Enforcing policies for security settings in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-allowed-ip-addresses-for-organizations-in-your-enterprise)" in the {% data variables.product.prodname_ghe_cloud %} documentation.
To configure a connection, your proxy configuration must allow connectivity to `github.com`, `api.github.com`, and `uploads.github.com`. For more information, see "[Configuring an outbound web proxy server](/enterprise/admin/guides/installation/configuring-an-outbound-web-proxy-server)."
{% endif %}
## Enabling {% data variables.product.prodname_github_connect %}
Enterprise owners who are also owners of an organization or enterprise account that uses {% data variables.product.prodname_ghe_cloud %} can enable {% data variables.product.prodname_github_connect %}.
If you're connecting {% data variables.product.product_location %} to an organization on {% data variables.product.prodname_ghe_cloud %} that is not owned by an enterprise account, you must sign into {% data variables.product.prodname_dotcom_the_website %} as an organization owner.
If you're connecting {% data variables.product.product_location %} to an organization on {% data variables.product.prodname_ghe_cloud %} that is owned by an enterprise account or to an enterprise account itself, you must sign into {% data variables.product.prodname_dotcom_the_website %} as an enterprise owner.
{% ifversion ghes %}
1. Sign in to {% data variables.product.product_location %} and {% data variables.product.prodname_dotcom_the_website %}.
{% data reusables.enterprise-accounts.access-enterprise %}
{% data reusables.enterprise-accounts.github-connect-tab %}{% else %}
1. Sign in to {% data variables.product.product_location %} and {% data variables.product.prodname_dotcom_the_website %}.
1. Inicie sesión en {% data variables.product.product_location %} y {% data variables.product.prodname_dotcom_the_website %}.
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.github-connect-tab %}{% else %}
1. Inicie sesión en {% data variables.product.product_location %} y {% data variables.product.prodname_dotcom_the_website %}.
{% data reusables.enterprise-accounts.access-enterprise %}{% data reusables.enterprise-accounts.github-connect-tab %}{% endif %}
1. Under "{% data variables.product.prodname_github_connect %} is not enabled yet", click **Enable {% data variables.product.prodname_github_connect %}**. By clicking **Enable {% data variables.product.prodname_github_connect %}**, you agree to the "<a href="/github/site-policy/github-terms-for-additional-products-and-features#connect" class="dotcom-only">{% data variables.product.prodname_dotcom %} Terms for Additional Products and Features</a>."
{% ifversion ghes %}
![Enable GitHub Connect button](/assets/images/enterprise/business-accounts/enable-github-connect-button.png){% else %}
![Enable GitHub Connect button](/assets/images/enterprise/github-ae/enable-github-connect-button.png)
{% endif %}
1. Next to the enterprise account or organization you'd like to connect, click **Connect**.
![Connect button next to an enterprise account or business](/assets/images/enterprise/business-accounts/choose-enterprise-or-org-connect.png)
1. En "{% data variables.product.prodname_github_connect %} aún no está habilitado", haga clic en **Habilitar {% data variables.product.prodname_github_connect %}** . Al hacer clic en **Habilitar datos {% data variables.product.prodname_github_connect %}** , acepta los <a href="/github/site-policy/github-terms-for-additional-products-and-features#connect" class="dotcom-only">términos "{% data variables.product.prodname_dotcom %} términos para productos y características adicionales</a>".
{% ifversion ghes %} ![Botón Enable GitHub Connect (Habilitar GitHub Connect)](/assets/images/enterprise/business-accounts/enable-github-connect-button.png){% else %} ![Botón Enable GitHub Connect (Habilitar GitHub Connect)](/assets/images/enterprise/github-ae/enable-github-connect-button.png) {% endif %}
1. Junto a la cuenta de empresa u organización a la que quiere conectarse, haga clic en **Connect** (Conectar).
![Botón Connect (Conectar) junto a una cuenta de empresa o un negocio](/assets/images/enterprise/business-accounts/choose-enterprise-or-org-connect.png)
## Disabling {% data variables.product.prodname_github_connect %}
## Deshabilitación de {% data variables.product.prodname_github_connect %}
Enterprise owners can disable {% data variables.product.prodname_github_connect %}.
Los propietarios de empresas pueden inhabilitar {% data variables.product.prodname_github_connect %}.
When you disconnect from {% data variables.product.prodname_ghe_cloud %}, the {% data variables.product.prodname_github_connect %} {% data variables.product.prodname_github_app %} is deleted from your enterprise account or organization and credentials stored on {% data variables.product.product_location %} are deleted.
Cuando te desconectas de {% data variables.product.prodname_ghe_cloud %}, la {% data variables.product.prodname_github_app %} de {% data variables.product.prodname_github_connect %} se borra de tu cuenta empresarial u organización, así como las credenciales almacenadas en {% data variables.product.product_location %}.
{% data reusables.enterprise-accounts.access-enterprise %}
{% data reusables.enterprise-accounts.github-connect-tab %}
1. Next to the enterprise account or organization you'd like to disconnect, click **Disable {% data variables.product.prodname_github_connect %}**.
{% ifversion ghes %}
![Disable GitHub Connect button next to an enterprise account or organization name](/assets/images/enterprise/business-accounts/disable-github-connect-button.png)
1. Read the information about disconnecting and click **Disable {% data variables.product.prodname_github_connect %}**.
![Modal with warning information about disconnecting and confirmation button](/assets/images/enterprise/business-accounts/confirm-disable-github-connect.png)
{% else %}
![Disable GitHub Connect button next to an enterprise account or organization name](/assets/images/enterprise/github-ae/disable-github-connect-button.png)
1. Read the information about disconnecting and click **Disable {% data variables.product.prodname_github_connect %}**.
![Modal with warning information about disconnecting and confirmation button](/assets/images/enterprise/github-ae/confirm-disable-github-connect.png)
{% endif %}
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.github-connect-tab %}
1. Junto a la cuenta de empresa u organización a la que quiere desconectar, haga clic en **Deshabilitar {% data variables.product.prodname_github_connect %}** .
{% ifversion ghes %} ![Botón Disable GitHub Connect (Deshabilitar GitHub Connect) junto al nombre de la organización o de la cuenta de empresa](/assets/images/enterprise/business-accounts/disable-github-connect-button.png)
1. Lee la información sobre la desconexión y haga clic en **Deshabilitar {% data variables.product.prodname_github_connect %}** .
![Ventana modal con información de advertencia sobre la desconexión y con el botón de confirmación](/assets/images/enterprise/business-accounts/confirm-disable-github-connect.png)
{% else %} ![Botón Disable GitHub Connect (Deshabilitar GitHub Connect) junto al nombre de la organización o de la cuenta de empresa](/assets/images/enterprise/github-ae/disable-github-connect-button.png)
1. Lee la información sobre la desconexión y haga clic en **Deshabilitar {% data variables.product.prodname_github_connect %}** .
![Ventana modal con información de advertencia sobre la desconexión y con el botón de confirmación](/assets/images/enterprise/github-ae/confirm-disable-github-connect.png) {% endif %}

1841
translations/es-ES/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md
View File

File diff suppressed because it is too large Load Diff

35
translations/es-ES/content/admin/overview/about-upgrades-to-new-releases.md
View File

@@ -1,7 +1,7 @@
---
title: About upgrades to new releases
title: Acerca de las mejoras a los nuevos lanzamientos
shortTitle: About upgrades
intro: '{% ifversion ghae %}Your enterprise on {% data variables.product.product_name %} is updated with the latest features and bug fixes on a regular basis by {% data variables.product.company_short %}.{% else %}You can benefit from new features and bug fixes for {% data variables.product.product_name %} by upgrading your enterprise to a newly released version.{% endif %}'
intro: '{% ifversion ghae %}{% data variables.product.company_short %} Actualiza tu empresa en {% data variables.product.product_name %} frecuentemente con las características y correcciones de errores más recientes.{% else %}Puedes beneficiarte de estas características y correcciones de errores para {% data variables.product.product_name %} si actualizas tu empresa a una versión que se haya lanzado recientemente.{% endif %}'
versions:
ghes: '*'
ghae: '*'
@@ -9,41 +9,46 @@ type: overview
topics:
- Enterprise
- Upgrades
ms.openlocfilehash: 196745ee4ededaf78bd5afe876e4afa09141e930
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '145120202'
---
{% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %}
{% data reusables.enterprise.constantly-improving %}{% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} is a fully managed service, so {% data variables.product.company_short %} completes the upgrade process for your enterprise.{% endif %}
{% data reusables.enterprise.constantly-improving %}{% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} es un servicio totalmente administrado, de manera que {% data variables.product.company_short %} completa el proceso de actualización automáticamente para la empresa.{% endif %}
Feature releases include new functionality and feature upgrades and typically occur quarterly. {% ifversion ghae %}{% data variables.product.company_short %} will upgrade your enterprise to the latest feature release. You will be given advance notice of any planned downtime for your enterprise.{% endif %}
Los lanzamientos de características incluyen mejoras de funcionalidades y características y, habitualmente, suceden cada trimestre. {% ifversion ghae %}{% data variables.product.company_short %} actualizará tu empresa al lanzamiento de características más reciente. Se te notificará previamente sobre cualquier tiempo de inactividad que se planee para tu empresa.{% endif %}
{% ifversion ghes %}
Starting with {% data variables.product.prodname_ghe_server %} 3.0, all feature releases begin with at least one release candidate. Release candidates are proposed feature releases, with a complete feature set. There may be bugs or issues in a release candidate which can only be found through feedback from customers actually using {% data variables.product.product_name %}.
Desde {% data variables.product.prodname_ghe_server %} 3.0, todos los lanzamiento de características comenzarán con por lo menos un candidato de lanzamiento. Los candidatos de lanzamiento son propuestas de lanzamientos de características con un conjunto de características completo. Puede que haya errores o problemas en un lanzamiento candidato que solo pueden encontrarse mediante la retroalimentación de los clientes que actualmente utilizan {% data variables.product.product_name %}.
You can get early access to the latest features by testing a release candidate as soon as the release candidate is available. You can upgrade to a release candidate from a supported version and can upgrade from the release candidate to later versions when released. You should upgrade any environment running a release candidate as soon as the release is generally available. For more information, see "[Upgrade requirements](/admin/enterprise-management/upgrade-requirements)."
Puedes obtener acceso a las últimas características si pruebas un candidato de lanzamiento tan pronto como esté disponible. Puedes actualizarte a un candidato de lanzamiento desde una versión compatible y puedes actualizar desde el candidato de lanzamiento a versiones posteriores cuando éstas se lancen. Deberías actualizar cualquier ambiente que ejecute un lanzamiento candidato tan pronto como dicho lanzamiento esté disponible en general. Para obtener más información, consulte "[Requisitos de actualización](/admin/enterprise-management/upgrade-requirements)".
Release candidates should be deployed on test or staging environments. As you test a release candidate, please provide feedback by contacting support. For more information, see "[Working with {% data variables.contact.github_support %}](/admin/enterprise-support)."
Los candidatos de lanzamiento deben desplegarse en ambientes de montaje o de pruebas. Conforme pruebes un candidato de lanzamiento, por favor, proporciona retroalimentación contactando a soporte. Para obtener más información, consulte "[Trabajar con {% data variables.contact.github_support %}](/admin/enterprise-support)".
We'll use your feedback to apply bug fixes and any other necessary changes to create a stable production release. Each new release candidate adds bug fixes for issues found in prior versions. When the release is ready for widespread adoption, {% data variables.product.company_short %} publishes a stable production release.
Utilizaremos tu retroalimentación para aplicar las correcciones de errores y cualquier otro cambio necesario para crear un lanzamiento productivo estable. Cada lanzamiento nuevo agrega correcciones de errores para los problemas de las versiones previas. Cuando el lanzamiento se encuentra listo para que se utilice en general, {% data variables.product.company_short %} publica un lanzamiento productivo estable.
{% endif %}
{% warning %}
**Warning**: The upgrade to a new feature release will cause a few hours of downtime, during which none of your users will be able to use the enterprise. You can inform your users about downtime by publishing a global announcement banner, using your enterprise settings or the REST API. For more information, see "[Customizing user messages on your instance](/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)" and "[{% data variables.product.prodname_enterprise %} administration](/rest/reference/enterprise-admin#announcements)."
**Advertencia**: Actualizar a una nueva versión de actualización de características provocará unas cuantas horas de inactividad, durante las cuales ninguno de los usuarios podrá utilizar el software empresarial. Puedes informar a tus usuarios sobre dicha inactividad si publicas una notificación de anuncio global utilizando la configuración de tu empresa o la API de REST. Para obtener más información, consulte "[Personalizar mensajes de usuario en su instancia](/admin/user-management/customizing-user-messages-on-your-instance#creating-a-global-announcement-banner)" y "[Administración de {% data variables.product.prodname_enterprise %}](/rest/reference/enterprise-admin#announcements)".
{% endwarning %}
{% ifversion ghes %}
Patch releases, which consist of hot patches and bug fixes only, happen more frequently. Patch releases are generally available when first released, with no release candidates. Upgrading to a patch release typically requires less than five minutes of downtime.
Los lanzamientos de parches, los cuales consisten únicamente de parches y correcciones de errores, ocurren con más frecuencia. Los lanzamientos de parches están disponibles en general cuando se lanzan por primera vez, sin candidatos de lanzamiento. El mejorar a un lanzamiento de parche habitualmente requiere de menos de cinco minutos de tiempo de inactividad.
To upgrade your enterprise to a new release, see "[Release notes](/enterprise-server/admin/release-notes)" and "[Upgrading {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server)." Because you can only upgrade from a feature release that's at most two releases behind, use the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.
Para actualizar el software empresarial a una nueva versión, consulte "[Notas de la versión](/enterprise-server/admin/release-notes)" y "[Actualización de {% data variables.product.prodname_ghe_server %}](/admin/enterprise-management/upgrading-github-enterprise-server)". Dado que solo puede actualizar desde una versión de actualización de características que tenga como máximo dos versiones anteriores, use el [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) para buscar la ruta de actualización de la versión actual.
{% endif %}
## Further reading
## Información adicional
- [ {% data variables.product.prodname_roadmap %} ]( {% data variables.product.prodname_roadmap_link %} ) in the `github/roadmap` repository{% ifversion ghae %}
- [ {% data variables.product.prodname_ghe_managed %} release notes](/admin/release-notes)
{% endif %}
- [ {% data variables.product.prodname_roadmap %} ]( {% data variables.product.prodname_roadmap_link %} ) en el repositorio de `github/roadmap` {% ifversion ghae %}
- [Notas de la versión de {% data variables.product.prodname_ghe_managed %}](/admin/release-notes) {% endif %}

70
translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-projects-in-your-enterprise.md Normal file
View File

@@ -0,0 +1,70 @@
---
title: Requerir políticas para proyectos en tu empresa
intro: 'Puedes requerir políticas para las {% data variables.projects.projects_v2_and_v1 %} dentro de las organizaciones de tu empresa o permitir que estas se configuren en cada organización.'
permissions: Enterprise owners can enforce policies for projects in an enterprise.
redirect_from:
- /articles/enforcing-project-board-settings-for-organizations-in-your-business-account
- /articles/enforcing-project-board-policies-for-organizations-in-your-enterprise-account
- /articles/enforcing-project-board-policies-in-your-enterprise-account
- /github/setting-up-and-managing-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account
- /github/setting-up-and-managing-your-enterprise/enforcing-project-board-policies-in-your-enterprise-account
- /github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account/enforcing-project-board-policies-in-your-enterprise-account
- /admin/policies/enforcing-policies-for-your-enterprise/enforcing-project-board-policies-in-your-enterprise
versions:
ghec: '*'
ghes: '*'
ghae: '*'
type: how_to
topics:
- Enterprise
- Policies
- Projects
shortTitle: Project board policies
ms.openlocfilehash: 2066ab3fd36814150ff79457930d05909027513e
ms.sourcegitcommit: fd8ebcd1ce75cc30bf063dbcc886e3df98c4c871
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/06/2022
ms.locfileid: '147854143'
---
## Acerca de las políticas para proyectos en tu empresa
Puedes requerir políticas para controlar cómo los miembros de la empresa administran {% data variables.projects.projects_v2_and_v1 %}, o bien puedes permitir que los propietarios de la organización administren políticas para {% data variables.projects.projects_v2_and_v1 %} en el nivel de organización. {% ifversion project-visibility-policy %}
Algunas políticas se aplican tanto a {% data variables.product.prodname_projects_v2 %}, a la nueva experiencia de proyectos y a {% data variables.product.prodname_projects_v1 %}, a la experiencia anterior, mientras que algunas solo se aplican a {% data variables.product.prodname_projects_v1 %}. Para más información de cada experiencia, consulta "[Acerca de {% data variables.product.prodname_projects_v2 %}](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)" y "[Acerca de{% data variables.product.prodname_projects_v1 %}](/issues/organizing-your-work-with-project-boards/managing-project-boards/about-project-boards)."
{% else %}Para más información, consulta "[Acerca de los planes de protecto](/issues/organizing-your-work-with-project-boards/managing-project-boards/about-project-boards)."{% endif %}
## Requerir una política para proyectos a nivel de organziazión
En todas las organizaciones que son propiedad de tu empresa, puedes habilitar o inhabilitar tableros de proyecto en toda la organización o permitir que los propietarios administren este parámetro a nivel de la organización.
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.projects-tab %}
4. En "Proyectos de la organización", revisa la información sobre cómo modificar los parámetros. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %}
5. En "Proyectos de la organización", usa el menú desplegable y elige una política.
![Menú desplegable con opciones de directivas de paneles de proyecto de la organización](/assets/images/help/business-accounts/organization-projects-policy-drop-down.png)
{% ifversion project-visibility-policy %}
## Requerir una política para los cambios a la visibilidad de los proyectos
En todas las organizaciones que pertenecen a tu empresa, puedes habilitar o deshabilitar la capacidad de la gente con acceso de administrador a un proyecto para cambiar la visibilidad del proyecto, o bien puedes permitir que los propietarios administren la configuración en el nivel de organización.
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.projects-tab %}
1. En "Permiso de cambio para visibilidad del proyecto", revisa la información sobre cómo modificar los parámetros. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %}
1. Selecciona el menú desplegable y, a continuación, haz clic en una política.
![Captura de pantalla del menú desplegable para configurar la política "Permiso de cambio de visibilidad del proyecto"](/assets/images/help/business-accounts/project-visibility-change-drop-down.png) {% endif %}
{% ifversion projects-v1 %}
## Requerir políticas para {% data variables.product.prodname_projects_v1 %}
Algunas políticas se aplican solo a {% data variables.product.prodname_projects_v1 %}.
### Requerir una política para proyectos de repositorios
En todas las organizaciones que pertenezcan a tu empresa, puedes habilitar o deshabilitar proyectos a nivel de los repositorios o permitir que los propietarios administren este parámetro a nivel de la organización.
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.projects-tab %}
4. En "Proyectos de repositorios", revisa la información sobre cómo modificar los parámetros. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %}
5. En "Proyectos de repositorios", usa el menú desplegable y elige una política.
![Menú desplegable con las opciones de políticas de paneles de proyecto de repositorios](/assets/images/help/business-accounts/repository-projects-policy-drop-down.png) {% endif %}

19
translations/es-ES/content/authentication/authenticating-with-saml-single-sign-on/authorizing-an-ssh-key-for-use-with-saml-single-sign-on.md
View File

@@ -11,12 +11,12 @@ versions:
topics:
- SSO
shortTitle: SSH Key with SAML
ms.openlocfilehash: 11df62f1a4adc5a0de1f54efbccafe71ad0feb83
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.openlocfilehash: f4b11c123c01d56263de883cbdd0f87c48eee04b
ms.sourcegitcommit: c0ac2ca826e2bb2e9355b57c2fd9b334d8f63b67
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '145120041'
ms.lasthandoff: 09/06/2022
ms.locfileid: '147854287'
---
Puedes autorizar una clave SSH existente, o crear una nueva clave SSH, y luego autorizarla. Para más información sobre cómo crear una nueva clave SSH, consulte "[Generación de una nueva clave SSH y adición al agente de SSH](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)".
@@ -31,11 +31,12 @@ Puedes autorizar una clave SSH existente, o crear una nueva clave SSH, y luego a
{% endnote %}
{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.ssh %}
3. Junto a la clave SSH que quiere autorizar, haga clic en **Enable SSO** (Habilitar SSO) o **Disable SSO** (Deshabilitar SSO).
![Botón para autorizar el token de SSO](/assets/images/help/settings/ssh-sso-button.png)
4. Busca la organización para la que deseas autorizar la clave SSH.
5. Haga clic en **Autorizar**.
![Botón para autorizar el token](/assets/images/help/settings/ssh-sso-authorize.png)
1. A la derecha de la clave SSH que deseas autorizar, haz clic en **Configurar SSO**.
![Captura de pantalla del botón autorización del token de SSO](/assets/images/help/settings/ssh-sso-button.png)
1. A la derecha de la organización para la que te gustaría autorizar el token, haz clic en **Autorizar**.
![Captura de pantalla del botón autorización del token](/assets/images/help/settings/ssh-sso-authorize.png)
## Información adicional

39
translations/es-ES/content/billing/managing-licenses-for-visual-studio-subscriptions-with-github-enterprise/about-visual-studio-subscriptions-with-github-enterprise.md
View File

@@ -1,6 +1,6 @@
---
title: About Visual Studio subscriptions with GitHub Enterprise
intro: 'You can give {% data variables.product.prodname_vs %} subscribers on your team access to {% data variables.product.prodname_enterprise %} with a combined offering from Microsoft.'
title: Acerca de las suscripciones a Visual Studio con GitHub Enterprise
intro: 'Puedes otorgar acceso a {% data variables.product.prodname_enterprise %} a tus suscriptores de {% data variables.product.prodname_vs %} con una oferta combinada de Microsoft.'
redirect_from:
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account/managing-licenses-for-visual-studio-subscription-with-github-enterprise
- /github/setting-up-and-managing-your-enterprise/managing-licenses-for-the-github-enterprise-and-visual-studio-bundle
@@ -17,35 +17,40 @@ topics:
- Enterprise
- Licensing
shortTitle: About
ms.openlocfilehash: d3adb998cb3413387766753a4dcdbee033df6506
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147052260'
---
## Acerca de {% data variables.product.prodname_vss_ghe %}
## About {% data variables.product.prodname_vss_ghe %}
{% data reusables.enterprise-accounts.vss-ghe-description %} {% data variables.product.prodname_vss_ghe %} se encuentra disponible desde Microsoft bajo las condiciones del Acuerdo Empresarial de Microsoft. Para más información, vea [{% data variables.product.prodname_vss_ghe %}](https://visualstudio.microsoft.com/subscriptions/visual-studio-github/) en el sitio web de {% data variables.product.prodname_vs %}.
{% data reusables.enterprise-accounts.vss-ghe-description %} {% data variables.product.prodname_vss_ghe %} is available from Microsoft under the terms of the Microsoft Enterprise Agreement. For more information, see [{% data variables.product.prodname_vss_ghe %}](https://visualstudio.microsoft.com/subscriptions/visual-studio-github/) on the {% data variables.product.prodname_vs %} website.
Para usar la parte de {% data variables.product.prodname_enterprise %} de la licencia, la cuenta personal de cada suscriptor en {% data variables.product.prodname_dotcom_the_website %} debe ser o convertirse en miembro de una organización propiedad de tu empresa en {% data variables.product.prodname_dotcom_the_website %}. Para lograrlo, los propietarios de las organizaciones pueden invitar por correo electrónico a los miembros nuevos para que se unan a una organización. El suscriptor puede aceptar la invitación con una cuenta personal existente en {% data variables.product.prodname_dotcom_the_website %} o crear una cuenta nueva.
To use the {% data variables.product.prodname_enterprise %} portion of the license, each subscriber's personal account on {% data variables.product.prodname_dotcom_the_website %} must be or become a member of an organization owned by your enterprise on {% data variables.product.prodname_dotcom_the_website %}. To accomplish this, organization owners can invite new members to an organization by email address. The subscriber can accept the invitation with an existing personal account on {% data variables.product.prodname_dotcom_the_website %} or create a new account.
Para más información sobre la configuración de {% data variables.product.prodname_vss_ghe %}, vea "[Configuración de {% data variables.product.prodname_vss_ghe %}](/billing/managing-licenses-for-visual-studio-subscriptions-with-github-enterprise/setting-up-visual-studio-subscriptions-with-github-enterprise)".
For more information about the setup of {% data variables.product.prodname_vss_ghe %}, see "[Setting up {% data variables.product.prodname_vss_ghe %}](/billing/managing-licenses-for-visual-studio-subscriptions-with-github-enterprise/setting-up-visual-studio-subscriptions-with-github-enterprise)."
## Acerca de las licencias de {% data variables.product.prodname_vss_ghe %}
## About licenses for {% data variables.product.prodname_vss_ghe %}
Después de asignar una licencia para {% data variables.product.prodname_vss_ghe %} a un suscriptor, el suscriptor usará la parte {% data variables.product.prodname_enterprise %} de la licencia mediante la unión a una organización de tu empresa con una cuenta personal en {% data variables.product.prodname_dotcom_the_website %}. Si la dirección de correo electrónico verificada de la cuenta personal de un miembro de empresa en {% data variables.product.prodname_dotcom_the_website %} coincide con el nombre principal de usuario (UPN) de un suscriptor de tu cuenta de {% data variables.product.prodname_vs %}, el suscriptor de {% data variables.product.prodname_vs %} consumirá automáticamente una licencia de {% data variables.product.prodname_vss_ghe %}.
After you assign a license for {% data variables.product.prodname_vss_ghe %} to a subscriber, the subscriber will use the {% data variables.product.prodname_enterprise %} portion of the license by joining an organization in your enterprise with a personal account on {% data variables.product.prodname_dotcom_the_website %}. If the verified email address for the personal account of an enterprise member on {% data variables.product.prodname_dotcom_the_website %} matches the User Primary Name (UPN) for a subscriber to your {% data variables.product.prodname_vs %} account, the {% data variables.product.prodname_vs %} subscriber will automatically consume one license for {% data variables.product.prodname_vss_ghe %}.
La cantidad total de licencias para tu empresa en {% data variables.product.prodname_dotcom %} es la suma de todas las licencias estándar de {% data variables.product.prodname_enterprise %} y de la cantidad de licencias de suscripción de {% data variables.product.prodname_vs %} que incluyan acceso a {% data variables.product.prodname_dotcom %}. Si la cuenta personal de un miembro de la empresa no se corresponde con la dirección de correo electrónico de un suscriptor de {% data variables.product.prodname_vs %}, la licencia que consume la cuenta personal no está disponible para un suscriptor de {% data variables.product.prodname_vs %}.
The total quantity of your licenses for your enterprise on {% data variables.product.prodname_dotcom %} is the sum of any standard {% data variables.product.prodname_enterprise %} licenses and the number of {% data variables.product.prodname_vs %} subscription licenses that include access to {% data variables.product.prodname_dotcom %}. If the personal account for an enterprise member does not correspond with the email address for a {% data variables.product.prodname_vs %} subscriber, the license that the personal account consumes is unavailable for a {% data variables.product.prodname_vs %} subscriber.
Para más información sobre {% data variables.product.prodname_enterprise %}, vea "[Productos de {% data variables.product.company_short %}](/github/getting-started-with-github/githubs-products#github-enterprise)". Para más información sobre las cuentas de {% data variables.product.prodname_dotcom_the_website %}, vea "[Tipos de cuentas de {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/types-of-github-accounts)".
For more information about {% data variables.product.prodname_enterprise %}, see "[{% data variables.product.company_short %}'s products](/github/getting-started-with-github/githubs-products#github-enterprise)." For more information about accounts on {% data variables.product.prodname_dotcom_the_website %}, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/github/getting-started-with-github/types-of-github-accounts)."
You can view the number of {% data variables.product.prodname_enterprise %} licenses available to your enterprise on {% data variables.product.product_location %}. The list of pending invitations includes subscribers who are not yet members of at least one organization in your enterprise. For more information, see "[Viewing the subscription and usage for your enterprise account](/billing/managing-billing-for-your-github-account/viewing-the-subscription-and-usage-for-your-enterprise-account)" and "[Viewing people in your enterprise](/admin/user-management/managing-users-in-your-enterprise/viewing-people-in-your-enterprise#viewing-members-and-outside-collaborators)."
Puedes ver la cantidad de licencias de {% data variables.product.prodname_enterprise %} disponibles para tu empresa en {% data variables.product.product_location %}. La lista de invitaciones pendientes incluye a los suscriptores que aún no sean miembros de por lo menos una organización en tu empresa. Para más información, vea "[Visualización de la suscripción y el uso de la cuenta de empresa](/billing/managing-billing-for-your-github-account/viewing-the-subscription-and-usage-for-your-enterprise-account)" y "[Visualización de personas en la empresa](/admin/user-management/managing-users-in-your-enterprise/viewing-people-in-your-enterprise#viewing-members-and-outside-collaborators)".
{% tip %}
**Tip**: If you download a CSV file with your enterprise's license usage in step 6 of "[Viewing the subscription and usage for your enterprise account](/billing/managing-billing-for-your-github-account/viewing-the-subscription-and-usage-for-your-enterprise-account#viewing-the-subscription-and-usage-for-your-enterprise-account)," any members with a missing value for the "Name" or "Profile" columns have not yet accepted an invitation to join an organization within the enterprise.
**Sugerencia**: Si descarga un archivo CSV con el uso de licencia de la empresa en el paso 6 de "[Visualización de la suscripción y el uso de la cuenta de empresa](/billing/managing-billing-for-your-github-account/viewing-the-subscription-and-usage-for-your-enterprise-account#viewing-the-subscription-and-usage-for-your-enterprise-account)", los miembros a los que les falte un valor en las columnas "Nombre" o "Perfil" todavía no han aceptado una invitación para unirse a una organización dentro de la empresa.
{% endtip %}
You can also see pending {% data variables.product.prodname_enterprise %} invitations to subscribers in {% data variables.product.prodname_vss_admin_portal_with_url %}.
También puedes ver las invitaciones pendientes de {% data variables.product.prodname_enterprise %} para los suscriptores en {% data variables.product.prodname_vss_admin_portal_with_url %}.
## Further reading
## Información adicional
- [{% data variables.product.prodname_vs %} subscriptions with {% data variables.product.prodname_enterprise %}](https://docs.microsoft.com/visualstudio/subscriptions/access-github) in Microsoft Docs
- [Use {% data variables.product.prodname_vs %} or {% data variables.product.prodname_vscode %} to deploy apps from {% data variables.product.prodname_dotcom %}](https://docs.microsoft.com/en-us/azure/developer/github/deploy-with-visual-studio) in Microsoft Docs
- [Suscripciones de {% data variables.product.prodname_vs %} con {% data variables.product.prodname_enterprise %}](https://docs.microsoft.com/visualstudio/subscriptions/access-github) en Microsoft Docs
- [Uso de {% data variables.product.prodname_vs %} o {% data variables.product.prodname_vscode %} para implementar aplicaciones de {% data variables.product.prodname_dotcom %}](https://docs.microsoft.com/en-us/azure/developer/github/deploy-with-visual-studio) en Microsoft Docs

99
translations/es-ES/content/code-security/adopting-github-advanced-security-at-scale/phase-2-preparing-to-enable-at-scale.md
View File

@@ -1,6 +1,6 @@
---
title: 'Phase 2: Preparing to enable at scale'
intro: "In this phase you will prepare developers and collect data about your repositories to ensure your teams are ready and you have everything you need for pilot programs and rolling out {% data variables.product.prodname_code_scanning %} and {% data variables.product.prodname_secret_scanning %}."
title: 'Fase 2: Prepararse para la habilitación a escala'
intro: 'En esta fase, prepararás a los desarrolladores y recopilarás datos sobre los repositorios para asegurarte de que los equipos están listos y tienes todo lo que necesitas para los programas piloto y el lanzamiento de {% data variables.product.prodname_code_scanning %} y {% data variables.product.prodname_secret_scanning %}.'
versions:
ghes: '*'
ghae: '*'
@@ -9,37 +9,42 @@ topics:
- Advanced Security
shortTitle: 2. Preparation
miniTocMaxHeadingLevel: 3
ms.openlocfilehash: a34711765e8beb6d57215c0c8fd16519e975539d
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147145390'
---
{% note %}
This article is part of a series on adopting {% data variables.product.prodname_GH_advanced_security %} at scale. For the previous article in this series, see "[Phase 1: Align on your rollout strategy and goals](/code-security/adopting-github-advanced-security-at-scale/phase-1-align-on-your-rollout-strategy-and-goals)."
Este artículo forma parte de una serie sobre la adopción de {% data variables.product.prodname_GH_advanced_security %} a escala. Para ver el artículo anterior de esta serie, consulta "[Fase 1: Alineación con la estrategia y los objetivos de lanzamiento](/code-security/adopting-github-advanced-security-at-scale/phase-1-align-on-your-rollout-strategy-and-goals)".
{% endnote %}
## Preparing to enable {% data variables.product.prodname_code_scanning %}
## Preparación para la habilitación de {% data variables.product.prodname_code_scanning %}
{% data reusables.code-scanning.about-code-scanning %} For more information, see "[About code scanning](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning)."
{% data reusables.code-scanning.about-code-scanning %} Para obtener más información, consulta "[Acerca del análisis de código](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning)".
Rolling {% data variables.product.prodname_code_scanning %} out across hundreds of repositories can be difficult, especially when done inefficiently. Following these steps will ensure your rollout is both efficient and successful. As part of your preparation, you will work with your teams, use automation to collect data about your repositories, and enable {% data variables.product.prodname_code_scanning %}.
El lanzamiento de {% data variables.product.prodname_code_scanning %} en cientos de repositorios puede resultar difícil, sobre todo si no se hace de una forma eficaz. Si sigues estos pasos, te asegurarás de que el lanzamiento sea eficaz y correcto. Como parte de la preparación, trabajarás con los equipos, usarás la automatización para recopilar datos sobre los repositorios y habilitarás {% data variables.product.prodname_code_scanning %}.
### Preparing teams for {% data variables.product.prodname_code_scanning %}
### Preparación de los equipos para {% data variables.product.prodname_code_scanning %}
First, prepare your teams to use {% data variables.product.prodname_code_scanning %}. The more teams that use {% data variables.product.prodname_code_scanning %}, the more data you'll have to drive remediation plans and monitor progress on your rollout. During this phase, focus on leveraging APIs and running internal enablement events.
En primer lugar, prepara a tus equipos para que usen {% data variables.product.prodname_code_scanning %}. Cuantos más equipos usen {% data variables.product.prodname_code_scanning %}, más datos tendrás plara generar planes de corrección y supervisar el progreso del lanzamiento. Durante esta fase, céntrate en aprovechar las API y ejecutar eventos de habilitación internos.
Your core focus should be preparing as many teams to use {% data variables.product.prodname_code_scanning %} as possible. You can also encourage teams to remediate appropriately, but we recommend prioritizing enablement and use of {% data variables.product.prodname_code_scanning %} over fixing issues during this phase.
El enfoque principal debe ser preparar tantos equipos como sea posible para que usen {% data variables.product.prodname_code_scanning %}. También puedes animar a los equipos a corregir correctamente, pero se recomienda priorizar la habilitación y el uso de {% data variables.product.prodname_code_scanning %} por encima de la corrección de incidencias durante esta fase.
### Collecting information about your repositories
### Recopilación de información sobre los repositorios
You can programmatically gather information about the different programming languages used in your repositories and use that data to enable {% data variables.product.prodname_code_scanning %} on all repositories that use the same language, using {% data variables.product.product_name %}'s GraphQL API.
Puedes recopilar información mediante programación sobre los distintos lenguajes de programación que se usan en los repositorios y usar esos datos para habilitar {% data variables.product.prodname_code_scanning %} en todos los repositorios que usan el mismo lenguaje, mediante la GraphQL API de {% data variables.product.product_name %}.
{% note %}
**Note:** To gather this data without manually running the GraphQL queries described in this article, you can use our publicly available tool. For more information, see the "[ghas-enablement tool](https://github.com/NickLiffen/ghas-enablement)" repository.
**Nota:** Para recopilar estos datos sin ejecutar manualmente las consultas de GraphQL descritas en este artículo, puedes usar nuestra herramienta disponible públicamente. Para obtener más información, consulta el repositorio "[herramienta de habilitación de GHAS](https://github.com/NickLiffen/ghas-enablement)".
{% endnote %}
If you want to gather information from repositories belonging to multiple organizations in your enterprise, you can use the query below to obtain the names of your organizations and then feed those into repository query. Replace OCTO-ENTERPRISE with your enterprise name.
Si quieres recopilar información de repositorios que pertenecen a varias organizaciones de la empresa, puedes usar la consulta siguiente para obtener los nombres de las organizaciones y, a continuación, introducirlos en la consulta del repositorio. Reemplaza OCTO-ENTERPRISE por el nombre de tu empresa.
```graphql
query {
@@ -58,7 +63,7 @@ query {
}
```
You can identify which repositories use which languages by collating repositories by language at the organization level. You can modify the sample GraphQL query below, replacing OCTO-ORG with the organization name.
Puedes identificar qué repositorios usan los lenguajes mediante la intercalación de repositorios por lenguaje en el nivel de organización. Puedes modificar la consulta de GraphQL de ejemplo siguiente, reemplazando OCTO-ORG por el nombre de la organización.
```graphql
query {
@@ -83,11 +88,11 @@ query {
}
```
For more information about running GraphQL queries, see "[Forming calls with GraphQL](/graphql/guides/forming-calls-with-graphql)."
Para obtener más información sobre la ejecución de consultas de GraphQL, consulta "[Creación de llamadas con GraphQL](/graphql/guides/forming-calls-with-graphql)".
Then, convert the data from the GraphQL query into a readable format, such as a table.
A continuación, convierte los datos de la consulta de GraphQL en un formato legible, como una tabla.
| Language | Number of Repos | Name of Repos |
| Idioma | Número de repositorios | Nombre de los repositorios |
|-------------------------|-----------------|-----------------------------------------|
| JavaScript (TypeScript) | 4212 | org/repo<br /> org/repo |
| Python | 2012 | org/repo<br /> org/repo |
@@ -97,57 +102,55 @@ Then, convert the data from the GraphQL query into a readable format, such as a
| Kotlin | 82 | org/repo<br /> org/repo |
| C | 12 | org/repo<br /> org/repo |
You can filter out the languages that are currently not supported by {% data variables.product.prodname_GH_advanced_security %} from this table.
Puedes filtrar los lenguajes que actualmente no son compatibles con {% data variables.product.prodname_GH_advanced_security %} de esta tabla.
If you have repositories with multiple languages, you can format the GraphQL results as shown in the table below. Filter out languages that are not supported, but retain all repositories with at least one supported language. You can enable {% data variables.product.prodname_code_scanning %} on these repositories, and all supported languages will be scanned.
Si tienes repositorios con varios lenguajes, puedes dar formato a los resultados de GraphQL como se muestra en la tabla siguiente. Filtra los lenguajes que no se admiten, pero conserva todos los repositorios con al menos un lenguaje admitido. Puedes habilitar {% data variables.product.prodname_code_scanning %} en estos repositorios y se analizarán todos los lenguajes admitidos.
| Language(s) | Number of Repos | Name of Repos |
| Idiomas | Número de repositorios | Nombre de los repositorios |
|------------------------|-----------------|------------------------------------------|
| JavaScript/Python/Go | 16 | org/repo <br /> org/repo |
| Rust/TypeScript/Python | 12 | org/repo <br /> org/repo |
An understanding of which repositories are using which languages will help you identify candidate repositories for pilot programs in phase 3, and prepares you to enable {% data variables.product.prodname_code_scanning %} across all repositories, one language at a time, in phase 5.
Comprender qué repositorios usan qué lenguajes te ayudará a identificar los repositorios candidatos para programas piloto en la fase 3 y te preparará para habilitar {% data variables.product.prodname_code_scanning %} en todos los repositorios lenguaje por lenguaje en la fase 5.
{% ifversion ghes %}
### Enabling {% data variables.product.prodname_code_scanning %} for your appliance
### Habilitación de {% data variables.product.prodname_code_scanning %} para el dispositivo
Before you can proceed with pilot programs and rolling out {% data variables.product.prodname_code_scanning %} across your enterprise, you must first enable {% data variables.product.prodname_code_scanning %} for your appliance. For more information, see "[Configuring code scanning for your appliance](/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance)."
Para poder continuar con los programas piloto y el lanzamiento de {% data variables.product.prodname_code_scanning %} en la empresa, primero debes habilitar {% data variables.product.prodname_code_scanning %} para el dispositivo. Para obtener más información, consulta "[Configuración del análisis de código para el dispositivo](/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance)".
{% endif %}
## Preparing to enable {% data variables.product.prodname_secret_scanning %}
## Preparación para la habilitación de {% data variables.product.prodname_secret_scanning %}
If a project communicates with an external service, it might use a token or private key for authentication. If you check a secret into a repository, anyone who has read access to the repository can use the secret to access the external service with your privileges. {% data variables.product.prodname_secret_scanning_caps %} will scan your entire Git history on all branches present in your {% data variables.product.prodname_dotcom %} repositories for secrets and alert you{% ifversion secret-scanning-push-protection %} or block the push containing the secret{% endif %}. For more information, see "[About secret scanning](/code-security/secret-scanning/about-secret-scanning)."
Si tu proyecto se comunica con un servicio externo, puede que use un token o una clave privada para la autenticación. Si registras un secreto en un repositorio, cualquiera que tenga acceso de lectura al mismo puede utilizarlo para acceder al servicio externo con tus privilegios. {% data variables.product.prodname_secret_scanning_caps %} analizará todo el historial de Git en todas las ramas presentes en los repositorios de {% data variables.product.prodname_dotcom %} en busca de secretos y te alertará{% ifversion secret-scanning-push-protection %} o bloqueará la inserción que contiene el secreto{% endif %}. Para más información, vea "[Acerca del examen de secretos](/code-security/secret-scanning/about-secret-scanning)".
### Considerations when enabling {% data variables.product.prodname_secret_scanning %}
### Consideraciones al habilitar {% data variables.product.prodname_secret_scanning %}
{% data variables.product.product_name %}’s {% data variables.product.prodname_secret_scanning %} capability is slightly different from {% data variables.product.prodname_code_scanning %} since it requires no specific configuration per programming language or per repository and less configuration overall to get started. This means enabling {% data variables.product.prodname_secret_scanning %} at the organizational level can be easy but clicking **Enable All** at the organization level and ticking the option **Automatically enable {% data variables.product.prodname_secret_scanning %} for every new repository** has some downstream effects that you should be aware of:
La funcionalidad {% data variables.product.prodname_secret_scanning %} de {% data variables.product.product_name %} es un poco diferente de {% data variables.product.prodname_code_scanning %}, ya que no requiere ninguna configuración específica por lenguaje de programación o por repositorio y requiere menos configuración en general para empezar. Esto significa que habilitar {% data variables.product.prodname_secret_scanning %} en el nivel de organización puede ser fácil, pero hacer clic en **Habilitar todo** en el nivel de organización y marcar la opción **Habilitar {% data variables.product.prodname_secret_scanning %} automáticamente para cada repositorio nuevo** tiene algunos efectos descendentes que debes tener en cuenta:
- **License consumption**
Enabling {% data variables.product.prodname_secret_scanning %} for all repositories will consume all your licenses, even if no one is using code scanning. This is fine unless you plan to increase the number of active developers in your organization. If the number of active developers is likely to increase in the coming months, you may exceed your license limit and then be unable to use {% data variables.product.prodname_GH_advanced_security %} on newly created repositories.
- **Initial high volume of detected secrets**
If you are enabling {% data variables.product.prodname_secret_scanning %} on a large organization, be prepared to see a high number of secrets found. Sometimes this comes as a shock to organizations and the alarm is raised. If you would like to turn on {% data variables.product.prodname_secret_scanning %} across all repositories at once, plan for how you will respond to multiple alerts across the organization.
- **Consumo de licencias**
La habilitación de {% data variables.product.prodname_secret_scanning %} para todos los repositorios consumirá todas tus licencias, incluso si nadie usa el análisis de código. No es ningún problema a menos que planees aumentar el número de desarrolladores activos en la organización. Si es probable que el número de desarrolladores activos aumente en los próximos meses, puede que superes el límite de licencias y que no puedas usar {% data variables.product.prodname_GH_advanced_security %} en los repositorios recién creados.
- **Volumen inicial de secretos detectados alto**
Si habilitas {% data variables.product.prodname_secret_scanning %} en una organización grande, prepárate para ver un número elevado de secretos detectados. A veces esto choca a las organizaciones y saltan todas las alarmas. Si quieres activar {% data variables.product.prodname_secret_scanning %} en todos los repositorios a la vez, planea cómo responderás a varias alertas en toda la organización.
{% data variables.product.prodname_secret_scanning_caps %} can be enabled for individual repositories. For more information, see "[Configuring {% data variables.product.prodname_secret_scanning %} for your repositories](/code-security/secret-scanning/configuring-secret-scanning-for-your-repositories)." {% data variables.product.prodname_secret_scanning_caps %} can also be enabled for all repositories in your organization, as described above. For more information on enabling for all repositories, see "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)."
{% data variables.product.prodname_secret_scanning_caps %} se puede habilitar para repositorios individuales. Para más información, vea "[Configuración de {% data variables.product.prodname_secret_scanning %} para los repositorios](/code-security/secret-scanning/configuring-secret-scanning-for-your-repositories)". {% data variables.product.prodname_secret_scanning_caps %} también se puede habilitar para todos los repositorios de la organización, como se ha descrito anteriormente. Para obtener más información sobre la habilitación para todos los repositorios, consulta "[Administración de la configuración de seguridad y análisis para la organización](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)".
### Patrones personalizados para {% data variables.product.prodname_secret_scanning %}
{% ifversion ghae %} {% note %}
**Nota:** Los patrones personalizados de {% data variables.product.prodname_secret_scanning %} se encuentran actualmente en versión beta y están sujetos a cambios.
{% endnote %} {% endif %}
{% data variables.product.prodname_secret_scanning_caps %} detecta un gran número de patrones predeterminados, pero también se puede configurar para que detecte patrones personalizados, como formatos de secreto exclusivos de tu infraestructura o usados por integradores que {% data variables.product.prodname_secret_scanning %} de {% data variables.product.product_name %} actualmente no detecta. Para obtener más información sobre los secretos admitidos para los patrones de asociados, consulta "[Patrones de análisis de secretos](/code-security/secret-scanning/secret-scanning-patterns)".
A medida que auditas los repositorios y hablas con los equipos de seguridad y desarrolladores, crea una lista de los tipos de secretos que usarás más adelante para configurar patrones personalizados para {% data variables.product.prodname_secret_scanning %}. Para más información, vea "[Definición de patrones personalizados para el análisis de secretos](/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning)".
### Custom patterns for {% data variables.product.prodname_secret_scanning %}
{% ifversion ghae %}
{% note %}
**Note:** Custom patterns for {% data variables.product.prodname_secret_scanning %} is currently in beta and is subject to change.
Para ver el artículo siguiente de esta serie, consulta "[Fase 3: Programas piloto](/code-security/adopting-github-advanced-security-at-scale/phase-3-pilot-programs)".
{% endnote %}
{% endif %}
{% data variables.product.prodname_secret_scanning_caps %} detects a large number of default patterns but can also be configured to detect custom patterns, such as secret formats unique to your infrastructure or used by integrators that {% data variables.product.product_name %}'s {% data variables.product.prodname_secret_scanning %} does not currently detect. For more information about supported secrets for partner patterns, see "[Secret scanning patterns](/code-security/secret-scanning/secret-scanning-patterns)."
As you audit your repositories and speak to security and developer teams, build a list of the secret types that you will later use to configure custom patterns for {% data variables.product.prodname_secret_scanning %}. For more information, see "[Defining custom patterns for secret scanning](/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning)."
{% note %}
For the next article in this series, see "[Phase 3: Pilot programs](/code-security/adopting-github-advanced-security-at-scale/phase-3-pilot-programs)."
{% endnote %}

122
translations/es-ES/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-alerts.md
View File

@@ -1,6 +1,6 @@
---
title: About code scanning alerts
intro: Learn about the different types of code scanning alerts and the information that helps you understand the problem each alert highlights.
title: Acerca de las alertas de análisis de código
intro: Obtén información sobre los diferentes tipos de alertas de análisis de código y la información que te ayuda a comprender el problema que resalta cada alerta.
product: '{% data reusables.gated-features.code-scanning %}'
versions:
fpt: '*'
@@ -12,115 +12,113 @@ topics:
- Advanced Security
- Code scanning
- CodeQL
ms.openlocfilehash: 1e540aa8b061e0bbdd5b7be1a2563cd983cfb753
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147067638'
---
{% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %}
{% data reusables.code-scanning.beta %}
{% data reusables.code-scanning.enterprise-enable-code-scanning %}
## Acerca de las alertas de {% data variables.product.prodname_code_scanning %}
## About alerts from {% data variables.product.prodname_code_scanning %}
Puedes configurar el {% data variables.product.prodname_code_scanning %} para que verifique el código en un repositorio utilizando el análisis predeterminado de {% data variables.product.prodname_codeql %}, un análisis de terceros, o varios tipos de análisis. Cuando se complete el análisis, las alertas resultantes se mostrarán unas junto a otras en la vista de seguridad del repositorio. Los resultados de las herramientas de terceros o de las consultas personalizadas podrían no incluir todas las propiedades que ves para las alertas que se detectan con el análisis predeterminado del {% data variables.product.prodname_codeql %} de {% data variables.product.company_short %}. Para más información, vea "[Configuración de {% data variables.product.prodname_code_scanning %} para un repositorio](/code-security/secure-coding/setting-up-code-scanning-for-a-repository)".
You can set up {% data variables.product.prodname_code_scanning %} to check the code in a repository using the default {% data variables.product.prodname_codeql %} analysis, a third-party analysis, or multiple types of analysis. When the analysis is complete, the resulting alerts are displayed alongside each other in the security view of the repository. Results from third-party tools or from custom queries may not include all of the properties that you see for alerts detected by {% data variables.product.company_short %}'s default {% data variables.product.prodname_codeql %} analysis. For more information, see "[Setting up {% data variables.product.prodname_code_scanning %} for a repository](/code-security/secure-coding/setting-up-code-scanning-for-a-repository)."
Predeterminadamente, el {% data variables.product.prodname_code_scanning %} analiza tu código periódicamente en la rama predeterminada y durante las solicitudes de cambios. Para obtener información sobre cómo administrar alertas en una solicitud de incorporación de cambios, vea "[Evaluación de prioridades de las alertas de {% data variables.product.prodname_code_scanning %} en las solicitudes de incorporación de cambios](/code-security/secure-coding/triaging-code-scanning-alerts-in-pull-requests)".
By default, {% data variables.product.prodname_code_scanning %} analyzes your code periodically on the default branch and during pull requests. For information about managing alerts on a pull request, see "[Triaging {% data variables.product.prodname_code_scanning %} alerts in pull requests](/code-security/secure-coding/triaging-code-scanning-alerts-in-pull-requests)."
## Acerca de los detalles de la alerta
## About alert details
Cada alerta resalta un problema en el código y el nombre de la herramienta que lo identificó. Puedes ver la línea de código que ha desencadenado la alerta, así como las propiedades de la misma, tales como la gravedad de alerta, la gravedad de seguridad y la naturaleza del problema. Las alertas también te dicen si el problema se introdujo por primera vez. Para las alertas que identificó el análisis de {% data variables.product.prodname_codeql %}, también verás información de cómo arreglar elproblema.
Each alert highlights a problem with the code and the name of the tool that identified it. You can see the line of code that triggered the alert, as well as properties of the alert, such as the alert severity, security severity, and the nature of the problem. Alerts also tell you when the issue was first introduced. For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem.
{% ifversion fpt or ghec or ghes > 3.4 or ghae-issue-6249 %} {% data reusables.code-scanning.alert-default-branch %} {% endif %}
{% ifversion fpt or ghec or ghes > 3.4 or ghae-issue-6249 %}
{% data reusables.code-scanning.alert-default-branch %}
{% endif %}
{% ifversion fpt or ghec or ghes > 3.4 or ghae-issue-6249 %} ![Alerta de ejemplo de {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-alert.png) {% else %} ![Example alert from {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/3.4/repository/code-scanning-alert.png) {% endif %}
{% ifversion fpt or ghec or ghes > 3.4 or ghae-issue-6249 %}
![Example alert from {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-alert.png)
{% else %}
![Example alert from {% data variables.product.prodname_code_scanning %}](/assets/images/enterprise/3.4/repository/code-scanning-alert.png)
{% endif %}
Si configura {% data variables.product.prodname_code_scanning %} mediante {% data variables.product.prodname_codeql %}, también encontrará problemas de flujo de datos en el código. El análisis de flujo de datos encuentra problemas de seguridad potenciales en el código, tales como: utilizar los datos de formas no seguras, pasar argumentos peligrosos a las funciones y tener fugas de información sensible.
If you set up {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_codeql %}, you can also find data-flow problems in your code. Data-flow analysis finds potential security issues in code, such as: using data insecurely, passing dangerous arguments to functions, and leaking sensitive information.
Cuando {% data variables.product.prodname_code_scanning %} reporta alertas de flujo de datos, {% data variables.product.prodname_dotcom %} te muestra como se mueven los datos a través del código. El {% data variables.product.prodname_code_scanning_capc %} te permite identificar las áreas de tu código que filtran información sensible y que podrían ser el punto de entrada para los ataques que hagan los usuarios malintencionados.
When {% data variables.product.prodname_code_scanning %} reports data-flow alerts, {% data variables.product.prodname_dotcom %} shows you how data moves through the code. {% data variables.product.prodname_code_scanning_capc %} allows you to identify the areas of your code that leak sensitive information, and that could be the entry point for attacks by malicious users.
### Acerca de los niveles de gravedad
### About severity levels
Los niveles de gravedad de la alerta pueden ser `Error`, `Warning` o `Note`.
Alert severity levels may be `Error`, `Warning`, or `Note`.
Si {% data variables.product.prodname_code_scanning %} está habilitado como una comprobación de solicitud de incorporación de cambios, se producirá un error en la comprobación si detecta resultados con una gravedad de `error`. Puedes especificar qué nivel de gravedad de las alertas de análisis de código provocan un error de comprobación. Para obtener más información, consulta "[Definición de las gravedades que provocan un error de comprobación de solicitudes de incorporación de cambios](/code-security/secure-coding/configuring-code-scanning#defining-the-severities-causing-pull-request-check-failure)".
If {% data variables.product.prodname_code_scanning %} is enabled as a pull request check, the check will fail if it detects any results with a severity of `error`. You can specify which severity level of code scanning alerts causes a check failure. For more information, see "[Defining the severities causing pull request check failure](/code-security/secure-coding/configuring-code-scanning#defining-the-severities-causing-pull-request-check-failure)."
### Acerca de los niveles de gravedad
### About security severity levels
El {% data variables.product.prodname_code_scanning_capc %} muestra los niveles de gravedad de seguridad para las alertas que generan las consultas de seguridad. Los niveles de gravedad de seguridad pueden ser `Critical`, `High`, `Medium` o `Low`.
{% data variables.product.prodname_code_scanning_capc %} displays security severity levels for alerts that are generated by security queries. Security severity levels can be `Critical`, `High`, `Medium`, or `Low`.
Para calcular la gravedad de seguridad de una alerta, utilizamos los datos del Sistema de Puntuación para Vulnerabilidades Comunes (CVSS). El CVSS es un marco de trabajo de código abierto para comunicar las características y gravedad de las vulnerabilidades de software y otros productos de seguridad lo utilizan habitualmente para puntuar las alertas. Para más información sobre cómo se calculan los niveles de gravedad, vea [esta entrada de blog](https://github.blog/changelog/2021-07-19-codeql-code-scanning-new-severity-levels-for-security-alerts/).
To calculate the security severity of an alert, we use Common Vulnerability Scoring System (CVSS) data. CVSS is an open framework for communicating the characteristics and severity of software vulnerabilities, and is commonly used by other security products to score alerts. For more information about how severity levels are calculated, see [this blog post](https://github.blog/changelog/2021-07-19-codeql-code-scanning-new-severity-levels-for-security-alerts/).
By default, any {% data variables.product.prodname_code_scanning %} results with a security severity of `Critical` or `High` will cause a check failure. You can specify which security severity level for {% data variables.product.prodname_code_scanning %} results should cause a check failure. For more information, see "[Defining the severities causing pull request check failure](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#defining-the-severities-causing-pull-request-check-failure)."
De manera predeterminada, cualquier resultado de {% data variables.product.prodname_code_scanning %} con una gravedad de seguridad de `Critical` o `High` provocará un error de comprobación. Puede especificar qué nivel de gravedad de seguridad para los resultados de {% data variables.product.prodname_code_scanning %} debe provocar un error de comprobación. Para obtener más información, consulta "[Definición de las gravedades que provocan un error de comprobación de solicitudes de incorporación de cambios](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#defining-the-severities-causing-pull-request-check-failure)".
{% ifversion fpt or ghes > 3.4 or ghae-issue-6251 or ghec %}
### About analysis origins
### Acerca de los orígenes de análisis
You can set up multiple configurations of code analysis on a repository, using different tools and targeting different languages or areas of the code. Each configuration of code scanning is the analysis origin for all the alerts it generates. For example, an alert generated using the default CodeQL analysis with GitHub Actions will have a different analysis origin from an alert generated externally and uploaded via the code scanning API.
Puede establecer varias configuraciones de análisis de código en un repositorio, mediante distintas herramientas y destinadas a diferentes lenguajes o áreas del código. Cada configuración del análisis de código es el origen del análisis de todas las alertas que genera. Por ejemplo, una alerta generada mediante el análisis de CodeQL predeterminado con Acciones de GitHub tendrá un origen de análisis diferente al de una alerta generada externamente y cargada mediante la API de análisis de código.
If you use multiple configurations to analyze a file, any problems detected by the same query are reported as alerts with multiple analysis origins. If an alert has more than one analysis origin, a {% octicon "workflow" aria-label="The workflow icon" %} icon will appear next to any relevant branch in the **Affected branches** section on the right-hand side of the alert page. You can hover over the {% octicon "workflow" aria-label="The workflow icon" %} icon to see the names of each analysis origin and the status of the alert for that analysis origin. You can also view the history of when alerts appeared in each analysis origin in the timeline on the alert page. If an alert only has one analysis origin, no information about analysis origins is displayed on the alert page.
Si usa varias configuraciones para analizar un archivo, los problemas detectados por la misma consulta se notifican como alertas con varios orígenes de análisis. Si una alerta tiene más de un origen de análisis, aparecerá un icono {% octicon "workflow" aria-label="The workflow icon" %} junto a cualquier rama pertinente de la sección **Ramas afectadas** en el lado derecho de la página de alertas. Puede mantener el puntero sobre el icono {% octicon "workflow" aria-label="The workflow icon" %} para ver los nombres de cada origen de análisis y el estado de la alerta para ese origen de análisis. También puede ver el historial de cuándo han aparecido las alertas en cada origen de análisis en la escala de tiempo de la página de alertas. Si una alerta solo tiene un origen de análisis, no se muestra información sobre los orígenes de análisis en la página de alertas.
![Code scanning alert with multiple analysis origins](/assets/images/help/repository/code-scanning-analysis-origins.png)
![Alerta de análisis de código con varios orígenes de análisis](/assets/images/help/repository/code-scanning-analysis-origins.png)
{% note %}
**Note:** Sometimes a code scanning alert displays as fixed for one analysis origin but is still open for a second analysis origin. You can resolve this by re-running the second code scanning configuration to update the alert status for that analysis origin.
**Nota:** En ocasiones una alerta de análisis de código se muestra como fija para un origen de análisis, pero sigue abierta para un segundo origen de análisis. Para resolverlo, vuelva a ejecutar la segunda configuración de análisis de código para actualizar el estado de alerta de ese origen de análisis.
{% endnote %}
{% endif %}
### About labels for alerts that are not found in application code
### Acerca de las etiquetas para las alertas que no se encuentran en el código de la aplicación
{% data variables.product.product_name %} assigns a category label to alerts that are not found in application code. The label relates to the location of the alert.
{% data variables.product.product_name %} asigna una etiqueta de categoría a las alertas que no se encuentran en el código de aplicación. La etiqueta se relaciona con la ubicación de la alerta.
- **Generated**: Code generated by the build process
- **Test**: Test code
- **Library**: Library or third-party code
- **Documentation**: Documentation
- **Generada**: código generado por el proceso de compilación
- **Prueba**: código de prueba
- **Biblioteca**: biblioteca o código de terceros
- **Documentación**: documentación
{% data variables.product.prodname_code_scanning_capc %} categorizes files by file path. You cannot manually categorize source files.
El {% data variables.product.prodname_code_scanning_capc %} categoriza los archivos por sus rutas. No puedes categorizar los archivos de origen manualmente.
Here is an example from the {% data variables.product.prodname_code_scanning %} alert list of an alert marked as occurring in library code.
Este es un ejemplo de la lista de alertas de {% data variables.product.prodname_code_scanning %} para una alerta marcada como procedente de código de biblioteca.
![Code scanning library alert in list](/assets/images/help/repository/code-scanning-library-alert-index.png)
![Alerta de librería del escaneo de código en la lista](/assets/images/help/repository/code-scanning-library-alert-index.png)
On the alert page, you can see that the filepath is marked as library code (`Library` label).
En la página de alertas, puede ver si la ruta se marca como código de biblioteca (la etiqueta `Library`).
![Code scanning library alert details](/assets/images/help/repository/code-scanning-library-alert-show.png)
![Detalles de la alerta de librería del escaneo de código](/assets/images/help/repository/code-scanning-library-alert-show.png)
{% ifversion codeql-ml-queries %}
## About experimental alerts
## Acerca de las alertas experimentales
{% data reusables.code-scanning.beta-codeql-ml-queries %}
In repositories that run {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql %} action, you may see some alerts that are marked as experimental. These are alerts that were found using a machine learning model to extend the capabilities of an existing {% data variables.product.prodname_codeql %} query.
En los repositorios que ejecutan {% data variables.product.prodname_code_scanning %} mediante la acción {% data variables.product.prodname_codeql %}, es posible que vea algunas alertas marcadas como experimentales. Se trata de alertas detectadas mediante un modelo de Machine Learning para ampliar las funcionalidades de una consulta de {% data variables.product.prodname_codeql %} existente.
![Code scanning experimental alert in list](/assets/images/help/repository/code-scanning-experimental-alert-list.png)
![Alerta experimental de análisis de código en la lista](/assets/images/help/repository/code-scanning-experimental-alert-list.png)
### Benefits of using machine learning models to extend queries
### Ventajas del uso de modelos de Machine Learning para ampliar las consultas
Queries that use machine learning models are capable of finding vulnerabilities in code that was written using frameworks and libraries that the original query writer did not include.
Las consultas que usan modelos de Machine Learning son capaces de encontrar vulnerabilidades en el código que se ha escrito mediante marcos y bibliotecas que el creador original de la consulta no ha incluido.
Each of the security queries for {% data variables.product.prodname_codeql %} identifies code that's vulnerable to a specific type of attack. Security researchers write the queries and include the most common frameworks and libraries. So each existing query finds vulnerable uses of common frameworks and libraries. However, developers use many different frameworks and libraries, and a manually maintained query cannot include them all. Consequently, manually maintained queries do not provide coverage for all frameworks and libraries.
Cada una de las consultas de seguridad de {% data variables.product.prodname_codeql %} identifica código vulnerable a un tipo de ataque específico. Los investigadores de seguridad escriben las consultas e incluyen los marcos y bibliotecas más comunes. Por tanto, cada consulta existente busca usos vulnerables de marcos y bibliotecas comunes. Pero los desarrolladores usan muchos marcos y bibliotecas diferentes, y una consulta mantenida manualmente no puede incluirlas todas. Por tanto, las consultas mantenidas manualmente no proporcionan cobertura para todos los marcos y bibliotecas.
{% data variables.product.prodname_codeql %} uses a machine learning model to extend an existing security query to cover a wider range of frameworks and libraries. The machine learning model is trained to detect problems in code it's never seen before. Queries that use the model will find results for frameworks and libraries that are not described in the original query.
En {% data variables.product.prodname_codeql %} se usa un modelo de Machine Learning para ampliar una consulta de seguridad existente a fin de abarcar una gama más amplia de marcos y bibliotecas. El modelo de Machine Learning se entrena para detectar problemas en el código que nunca se han visto antes. Las consultas que usan el modelo encontrarán resultados para marcos y bibliotecas que no se describen en la consulta original.
### Alerts identified using machine learning
### Alertas identificadas mediante el aprendizaje automático
Alerts found using a machine learning model are tagged as "Experimental alerts" to show that the technology is under active development. These alerts have a higher rate of false positive results than the queries they are based on. The machine learning model will improve based on user actions such as marking a poor result as a false positive or fixing a good result.
Las alertas encontradas mediante un modelo de Machine Learning se etiquetan como "Alertas experimentales" para mostrar que la tecnología está en desarrollo activo. Estas alertas tienen una tasa más alta de resultados falsos positivos que las consultas en las que se basan. El modelo de Machine Learning mejorará en función de las acciones del usuario, como marcar un resultado deficiente como un falso positivo o corregir un resultado correcto.
![Code scanning experimental alert details](/assets/images/help/repository/code-scanning-experimental-alert-show.png)
![Detalles de la alerta experimental de análisis de código](/assets/images/help/repository/code-scanning-experimental-alert-show.png)
## Enabling experimental alerts
## Habilitación de alertas experimentales
The default {% data variables.product.prodname_codeql %} query suites do not include any queries that use machine learning to generate experimental alerts. To run machine learning queries during {% data variables.product.prodname_code_scanning %} you need to run the additional queries contained in one of the following query suites.
Los conjuntos de consultas de {% data variables.product.prodname_codeql %} predeterminados no incluyen ninguna consulta que use el aprendizaje automático para generar alertas experimentales. Para ejecutar consultas de aprendizaje automático durante {% data variables.product.prodname_code_scanning %} tendrá que ejecutar las consultas adicionales contenidas en uno de los conjuntos de consultas siguientes.
{% data reusables.code-scanning.codeql-query-suites %}
When you update your workflow to run an additional query suite this will increase the analysis time.
Al actualizar el flujo de trabajo para ejecutar un conjunto de consultas adicional, aumentará el tiempo de análisis.
``` yaml
- uses: {% data reusables.actions.action-codeql-action-init %}
@@ -129,14 +127,14 @@ When you update your workflow to run an additional query suite this will increas
queries: security-extended
```
For more information, see "[Configuring code scanning](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs)."
Para más información, vea "[Configuración del análisis de código](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs)".
## Disabling experimental alerts
## Deshabilitación de alertas experimentales
The simplest way to disable queries that use machine learning to generate experimental alerts is to stop running the `security-extended` or `security-and-quality` query suite. In the example above, you would comment out the `queries` line. If you need to continue to run the `security-extended` or `security-and-quality` suite and the machine learning queries are causing problems, then you can open a ticket with [{% data variables.product.company_short %} support](https://support.github.com/contact) with the following details.
La manera más sencilla de deshabilitar las consultas que usan el aprendizaje automático para generar alertas experimentales consiste en dejar de ejecutar el conjunto de consultas `security-extended` o `security-and-quality`. En el ejemplo anterior, tendría que convertir en comentario la línea `queries`. Si necesita seguir ejecutando el conjunto `security-extended` o `security-and-quality`, y las consultas de aprendizaje automático generan problemas, puede abrir una incidencia con el [soporte técnico de {% data variables.product.company_short %}](https://support.github.com/contact) con los detalles siguientes.
- Ticket title: "{% data variables.product.prodname_code_scanning %}: removal from experimental alerts beta"
- Specify details of the repositories or organizations that are affected
- Request an escalation to engineering
- Título de la incidencia de soporte técnico: "{% data variables.product.prodname_code_scanning %}: eliminación de alertas experimentales beta"
- Especificar los detalles de los repositorios u organizaciones que se ven afectados
- Solicitud de una escalación al departamento de ingeniería
{% endif %}

55
translations/es-ES/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql.md
View File

@@ -1,7 +1,7 @@
---
title: About code scanning with CodeQL
title: Acerca del examen de código con CodeQL
shortTitle: Code scanning with CodeQL
intro: 'You can use {% data variables.product.prodname_codeql %} to identify vulnerabilities and errors in your code. The results are shown as {% data variables.product.prodname_code_scanning %} alerts in {% data variables.product.prodname_dotcom %}.'
intro: 'Puedes utilizar {% data variables.product.prodname_codeql %} para identificar las vulnerabilidades y errores en tu código. Los resultados se muestran como alertas del {% data variables.product.prodname_code_scanning %} en {% data variables.product.prodname_dotcom %}.'
product: '{% data reusables.gated-features.code-scanning %}'
redirect_from:
- /code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql
@@ -15,57 +15,58 @@ topics:
- Advanced Security
- Code scanning
- CodeQL
ms.openlocfilehash: 41531627f73e7878cfa5667560b61cd4e21d20b7
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147052180'
---
{% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %}
{% data reusables.code-scanning.beta %}
{% data reusables.code-scanning.enterprise-enable-code-scanning %}
## About {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %}
## Acerca de {% data variables.product.prodname_code_scanning %} con {% data variables.product.prodname_codeql %}
{% data reusables.code-scanning.about-codeql-analysis %}
There are two main ways to use {% data variables.product.prodname_codeql %} analysis for {% data variables.product.prodname_code_scanning %}:
Hay dos formas principales para utilizar el análisis de {% data variables.product.prodname_codeql %} para el {% data variables.product.prodname_code_scanning %}:
- Add the {% data variables.product.prodname_codeql %} workflow to your repository. This uses the [github/codeql-action](https://github.com/github/codeql-action/) to run the {% data variables.product.prodname_codeql_cli %}. For more information, see "[Setting up {% data variables.product.prodname_code_scanning %} for a repository](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository#setting-up-code-scanning-using-actions)."
- Run the {% data variables.product.prodname_codeql %} CLI directly in an external CI system and upload the results to {% data variables.product.prodname_dotcom %}. For more information, see "[About {% data variables.product.prodname_codeql %} code scanning in your CI system ](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system)."
- Agregar el flujo de trabajo de {% data variables.product.prodname_codeql %} a tu repositorio. Se usa la acción [github/codeql-action](https://github.com/github/codeql-action/) para ejecutar la {% data variables.product.prodname_codeql_cli %}. Para obtener más información, consulte "[Configuración de {% data variables.product.prodname_code_scanning %} para un repositorio](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository#setting-up-code-scanning-using-actions)".
- Ejecutar el CLI de {% data variables.product.prodname_codeql %} directamente en un sistema de IC externo y cargar los resultados en {% data variables.product.prodname_dotcom %}. Para obtener más información, consulte "[Acerca del análisis de código de {% data variables.product.prodname_codeql %} en el sistema de CI](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system)".
{% ifversion ghes or ghae %}
{% note %}
On {% data variables.product.product_name %} {% ifversion ghes %}{{ allVersions[currentVersion].currentRelease }},{% endif %} the {% data variables.product.prodname_codeql %} action uses {% data variables.product.prodname_codeql_cli %} version {% data variables.product.codeql_cli_ghes_recommended_version %} by default. We recommend that you use the same version of the {% data variables.product.prodname_codeql_cli %} if you run analysis in an external CI system.
{% note %} En {% data variables.product.product_name %} {% ifversion ghes %}{{ allVersions[currentVersion].currentRelease }},{% endif %} la acción {% data variables.product.prodname_codeql %} utiliza la versión de {% data variables.product.prodname_codeql_cli %} {% data variables.product.codeql_cli_ghes_recommended_version %} de forma predeterminada. Se recomienda usar la misma versión de {% data variables.product.prodname_codeql_cli %} si ejecutas análisis en un sistema de CI externo.
{% endnote %}
{% endif %}
## About {% data variables.product.prodname_codeql %}
## Acerca de {% data variables.product.prodname_codeql %}
{% data variables.product.prodname_codeql %} treats code like data, allowing you to find potential vulnerabilities in your code with greater confidence than traditional static analyzers.
El {% data variables.product.prodname_codeql %} trata el código como datos, permitiéndote encontrar vulnerabilidades potenciales en tu código con mayor confianza que los analizadores estáticos tradicionales.
1. You generate a {% data variables.product.prodname_codeql %} database to represent your codebase.
2. Then you run {% data variables.product.prodname_codeql %} queries on that database to identify problems in the codebase.
3. The query results are shown as {% data variables.product.prodname_code_scanning %} alerts in {% data variables.product.product_name %} when you use {% data variables.product.prodname_codeql %} with {% data variables.product.prodname_code_scanning %}.
1. Generas una base de datos de {% data variables.product.prodname_codeql %} para representar tu base de código.
2. Entonces, ejecutarás consultas de {% data variables.product.prodname_codeql %} en esa base de datos para identificar problemas en la base de código.
3. Estos resultados de consulta se muestran como alertas del {% data variables.product.prodname_code_scanning %} en {% data variables.product.product_name %} cuando utilizas al {% data variables.product.prodname_codeql %} con el {% data variables.product.prodname_code_scanning %}.
{% data variables.product.prodname_codeql %} supports both compiled and interpreted languages, and can find vulnerabilities and errors in code that's written in the supported languages.
{% data variables.product.prodname_codeql %} es compatible tanto con lenguajes compilados como interpretados, y puede buscar vulnerabilidades y errores en el código escrito en los lenguajes compatibles.
{% data reusables.code-scanning.codeql-languages-bullets %}
## About {% data variables.product.prodname_codeql %} queries
## Acerca de las consultas de {% data variables.product.prodname_codeql %}
{% data variables.product.company_short %} experts, security researchers, and community contributors write and maintain the default {% data variables.product.prodname_codeql %} queries used for {% data variables.product.prodname_code_scanning %}. The queries are regularly updated to improve analysis and reduce any false positive results. The queries are open source, so you can view and contribute to the queries in the [`github/codeql`](https://github.com/github/codeql) repository. For more information, see [{% data variables.product.prodname_codeql %}](https://codeql.github.com/) on the {% data variables.product.prodname_codeql %} website. You can also write your own queries. For more information, see "[About {% data variables.product.prodname_codeql %} queries](https://codeql.github.com/docs/writing-codeql-queries/about-codeql-queries/)" in the {% data variables.product.prodname_codeql %} documentation.
Los expertos de {% data variables.product.company_short %}, investigadores de seguridad y contribuyentes comunitarios escriben y mantienen las consultas predeterminadas de {% data variables.product.prodname_codeql %} que se utilizan para el {% data variables.product.prodname_code_scanning %}. Las consultas se actualizan frecuentemente para mejorar el análisis y reducir cualquier resultado falso positivo. Las consultas son código abierto, por lo que puede ver y contribuir en ellas en el repositorio de [`github/codeql`](https://github.com/github/codeql). Para obtener más información, consulte [{% data variables.product.prodname_codeql %}](https://codeql.github.com/) en el sitio web de {% data variables.product.prodname_codeql %}. También puede escribir consultas propias. Para obtener más información, consulte "[Acerca de las consultas de {% data variables.product.prodname_codeql %}](https://codeql.github.com/docs/writing-codeql-queries/about-codeql-queries/)" en la documentación de {% data variables.product.prodname_codeql %}.
You can run additional queries as part of your code scanning analysis.
Puedes ejecutar consultas adicionales como parte de tu análisis de escaneo de código.
{%- ifversion codeql-packs %}
These queries must belong to a published {% data variables.product.prodname_codeql %} query pack (beta) or a QL pack in a repository. {% data variables.product.prodname_codeql %} packs (beta) provide the following benefits over traditional QL packs:
{%- ifversion codeql-packs %} Estas consultas deben pertenecer a un paquete de consultas (beta) de {% data variables.product.prodname_codeql %} publicado o un paquete de QL en un repositorio. Los paquetes de {% data variables.product.prodname_codeql %} (beta) proporcionan los siguientes beneficios sobre los paquetes tradicionales de QL:
- When a {% data variables.product.prodname_codeql %} query pack (beta) is published to the {% data variables.product.company_short %} {% data variables.product.prodname_container_registry %}, all the transitive dependencies required by the queries and a compilation cache are included in the package. This improves performance and ensures that running the queries in the pack gives identical results every time until you upgrade to a new version of the pack or the CLI.
- QL packs do not include transitive dependencies, so queries in the pack can depend only on the standard libraries (that is, the libraries referenced by an `import LANGUAGE` statement in your query), or libraries in the same QL pack as the query.
- Cuando un paquete de consultas de {% data variables.product.prodname_codeql %} (beta) se publica en el {% data variables.product.prodname_container_registry %} de {% data variables.product.company_short %}, todas las dependencias transitivas que requieren las consultas y un caché de compilación se incluyen en el paquete. Esto mejora el rendimiento y garantiza que el ejecutar las consultas del paquete proporciona resultados idénticos cada vez que actualizas a una versión nueva del paquete o de CLI.
- Los paquetes de QL no incluyen las dependencias transitivas, así que las consultas del paquete pueden depender únicamente de las librerías estándar (esto es, librerías a las que se hace referencia mediante una instrucción `import LANGUAGE` en la consulta) o en las librerías del mismo paquete de QL que la consulta.
For more information, see "[About {% data variables.product.prodname_codeql %} packs](https://codeql.github.com/docs/codeql-cli/about-codeql-packs/)" and "[About {% data variables.product.prodname_ql %} packs](https://codeql.github.com/docs/codeql-cli/about-ql-packs/)" in the {% data variables.product.prodname_codeql %} documentation.
Para obtener más información, consulte "[Acerca de los paquetes de {% data variables.product.prodname_codeql %}](https://codeql.github.com/docs/codeql-cli/about-codeql-packs/) y ["Acerca de los paquetes de {% data variables.product.prodname_ql %} packs](https://codeql.github.com/docs/codeql-cli/about-ql-packs/) en la documentación de {% data variables.product.prodname_codeql %}.
{% data reusables.code-scanning.beta-codeql-packs-cli %}
{%- else %}
The queries you want to run must belong to a QL pack in a repository. Queries must only depend on the standard libraries (that is, the libraries referenced by an `import LANGUAGE` statement in your query), or libraries in the same QL pack as the query. For more information, see "[About {% data variables.product.prodname_ql %} packs](https://codeql.github.com/docs/codeql-cli/about-ql-packs/)."
{%- else %} Estas consultas que desea ejecutar deben pertenecer al paquete de QL de un repositorio. Las consultas solo pueden depender de las librerías estándar (es decir, aquellas a las que hace referencia una instrucción `import LANGUAGE` en la consulta), o de aquellas en el mismo paquete de QL que la consulta. Para obtener más información, consulte ["Acerca de los paquetes de {% data variables.product.prodname_ql %}](https://codeql.github.com/docs/codeql-cli/about-ql-packs/)".
{% endif %}

10
translations/es-ES/content/code-security/code-scanning/integrating-with-code-scanning/index.md
View File

@@ -1,7 +1,7 @@
---
title: Integrating with code scanning
title: Integrarse con el escaneo de código
shortTitle: Integrate with code scanning
intro: 'You can integrate third-party code analysis tools with {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_code_scanning %} by uploading data as SARIF files.'
intro: 'Puedes integrar las herramientas de análisis de código de terceros con el {% data variables.product.prodname_code_scanning %} de {% data variables.product.prodname_dotcom %} su cargas datos como archivos SARIF.'
product: '{% data reusables.gated-features.code-scanning %}'
redirect_from:
- /github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning
@@ -20,5 +20,11 @@ children:
- /about-integration-with-code-scanning
- /uploading-a-sarif-file-to-github
- /sarif-support-for-code-scanning
ms.openlocfilehash: 8c1a80ed1cc695b82e9a1902db1a2f1e1389ae3a
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '145116825'
---

246
translations/es-ES/content/code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning.md
View File

@@ -1,7 +1,7 @@
---
title: SARIF support for code scanning
title: Soporte de SARIF para escaneo de código
shortTitle: SARIF support
intro: 'To display results from a third-party static analysis tool in your repository on {% data variables.product.prodname_dotcom %}, you''ll need your results stored in a SARIF file that supports a specific subset of the SARIF 2.1.0 JSON schema for {% data variables.product.prodname_code_scanning %}. If you use the default {% data variables.product.prodname_codeql %} static analysis engine, then your results will display in your repository on {% data variables.product.prodname_dotcom %} automatically.'
intro: 'Para mostrar los resultados de una herramienta de análisis estático de terceros en tu repositorio en {% data variables.product.prodname_dotcom %}, necesitas que éstos se almacenen en un archivo SARIF que sea compatible con un subconjunto del modelo de JSON para SARIF 2.1.0 para el {% data variables.product.prodname_code_scanning %}. Si utilizas el motor de análisis estático predeterminado de {% data variables.product.prodname_codeql %}, tus resultados se mostrarán automáticamente en tu repositorio de {% data variables.product.prodname_dotcom %}.'
product: '{% data reusables.gated-features.code-scanning %}'
miniTocMaxHeadingLevel: 3
redirect_from:
@@ -20,70 +20,74 @@ topics:
- Code scanning
- Integration
- SARIF
ms.openlocfilehash: 96af3047cee774ce2ed865f127a21d33614ad2d9
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147785406'
---
{% data reusables.code-scanning.beta %}
## About SARIF support
## Acerca del soporte de SARIF
SARIF (Static Analysis Results Interchange Format) is an [OASIS Standard](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) that defines an output file format. The SARIF standard is used to streamline how static analysis tools share their results. {% data variables.product.prodname_code_scanning_capc %} supports a subset of the SARIF 2.1.0 JSON schema.
SARIF (Static Analysis Results Interchange Format) es un [estándar OASIS](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) que define un formato de archivo de salida. El estándar SARIF se utiliza para optimizar la manera en el que las herramientas de análisis estático comparten sus resultados. {% data variables.product.prodname_code_scanning_capc %} es compatible con un subconjunto del modelo SARIF 2.1.0 JSON.
To upload a SARIF file from a third-party static code analysis engine, you'll need to ensure that uploaded files use the SARIF 2.1.0 version. {% data variables.product.prodname_dotcom %} will parse the SARIF file and show alerts using the results in your repository as a part of the {% data variables.product.prodname_code_scanning %} experience. For more information, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/code-security/secure-coding/uploading-a-sarif-file-to-github)." For more information about the SARIF 2.1.0 JSON schema, see [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Documents/CommitteeSpecifications/2.1.0/sarif-schema-2.1.0.json).
Para cargar un archivo SARIF desde un motor de análisis estático de código desde un tercero, necesitaras asegurarte de que los archivos cargados utilicen la versión SARIF 2.1.0. {% data variables.product.prodname_dotcom %} analizará el archivo SARIF y mostrará las alertas utilizando los resultados en tu repositorio como parte de la experiencia del {% data variables.product.prodname_code_scanning %}. Para obtener más información, consulte "[Carga de un archivo SARIF en {% data variables.product.prodname_dotcom %}](/code-security/secure-coding/uploading-a-sarif-file-to-github)." Para obtener más información sobre el esquema de JSON SARIF 2.1.0, consulte [`sarif-schema-2.1.0.json`](https://github.com/oasis-tcs/sarif-spec/blob/master/Documents/CommitteeSpecifications/2.1.0/sarif-schema-2.1.0.json).
If you're using {% data variables.product.prodname_actions %} with the {% data variables.product.prodname_codeql_workflow %}{% ifversion codeql-runner-supported %}, using the {% data variables.product.prodname_codeql_runner %},{% endif %} or using the {% data variables.product.prodname_codeql_cli %}, then the {% data variables.product.prodname_code_scanning %} results will automatically use the supported subset of SARIF 2.1.0. For more information, see "[Setting up {% data variables.product.prodname_code_scanning %} for a repository](/code-security/secure-coding/setting-up-code-scanning-for-a-repository)"{% ifversion codeql-runner-supported %}, "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/running-codeql-runner-in-your-ci-system)",{% endif %} or "[Installing CodeQL CLI in your CI system](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system)."
Si estás utilizando {% data variables.product.prodname_actions %} con el {% data variables.product.prodname_codeql_workflow %}{% ifversion codeql-runner-supported %}, con el {% data variables.product.prodname_codeql_runner %},{% endif %} o con el {% data variables.product.prodname_codeql_cli %}, los resultados del {% data variables.product.prodname_code_scanning %} usarán automáticamente el subconjunto compatible de SARIF 2.1.0. Para más información, consulta "[Configuración de {% data variables.product.prodname_code_scanning %} para un repositorio](/code-security/secure-coding/setting-up-code-scanning-for-a-repository)"{% ifversion codeql-runner-supported %}, "[Ejecución de {% data variables.product.prodname_codeql_runner %} en tu sistema de CI](/code-security/secure-coding/running-codeql-runner-in-your-ci-system)",{% endif %} o "[Instalación de la CLI de CodeQL en tu sistema de CI](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system)".
You can upload multiple SARIF files for the same commit, and display the data from each file as {% data variables.product.prodname_code_scanning %} results. When you upload multiple SARIF files for a commit, you must indicate a "category" for each analysis. The way to specify a category varies according to the analysis method:
- Using the {% data variables.product.prodname_codeql_cli %} directly, pass the `--sarif-category` argument to the `codeql database analyze` command when you generate SARIF files. For more information, see "[Configuring CodeQL CLI in your CI system](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system#about-generating-code-scanning-results-with-codeql-cli)."
- Using {% data variables.product.prodname_actions %} with `codeql-action/analyze`, the category is set automatically from the workflow name and any matrix variables (typically, `language`). You can override this by specifying a `category` input for the action, which is useful when you analyze different sections of a mono-repository in a single workflow.
- Using {% data variables.product.prodname_actions %} to upload results from other static analysis tools, then you must specify a `category` input if you upload more than one file of results for the same tool in one workflow. For more information, see "[Uploading a {% data variables.product.prodname_code_scanning %} analysis with {% data variables.product.prodname_actions %}](/code-security/code-scanning/integrating-with-code-scanning/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)."
- If you are not using either of these approaches, you must specify a unique `runAutomationDetails.id` in each SARIF file to upload. For more information about this property, see [`runAutomationDetails` object](#runautomationdetails-object) below.
Puedes cargar varios archivos SARIF para la misma confirmación y mostrar los datos de cada archivo como resultados del {% data variables.product.prodname_code_scanning %}. Cuando cargas varios archivos de SARIF en una confirmación, debes indicar una "Categoría" para cada análisis. La forma de especificar una categoría varía de acuerdo con el método de análisis:
- Si usa directamente {% data variables.product.prodname_codeql_cli %}, puede enviar el argumento `--sarif-category` al comando `codeql database analyze` cuando genere los archivos SARIF. Para obtener más información, consulte "[Configuración de la CLI de CodeQL en el sistema de CI](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system#about-generating-code-scanning-results-with-codeql-cli)".
- Utilice {% data variables.product.prodname_actions %} con `codeql-action/analyze` para que la categoría se establezca automáticamente a partir del nombre del flujo de trabajo y las variables de matriz (normalmente, es `language`). Puede ignorar este ajuste si especifica una entrada en `category` para la acción, lo cual es útil cuando analiza diferentes secciones de un repositorio único en un flujo de trabajo simple.
- Si {% data variables.product.prodname_actions %} para cargar los resultados de otras herramientas de análisis estático, debe especificar una entrada en `category` si carga más de un archivo de resultados para la misma herramienta en un flujo de trabajo. Para obtener más información, consulte "[Carga de un análisis de {% data variables.product.prodname_code_scanning %} con {% data variables.product.prodname_actions %}](/code-security/code-scanning/integrating-with-code-scanning/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)".
- Si no usa ninguno de estos enfoques, debe especificar un `runAutomationDetails.id` único en cada archivo SARIF que se va a cargar. Para obtener más información acerca de esta propiedad, consulte [Objeto de `runAutomationDetails`](#runautomationdetails-object) a continuación.
If you upload a second SARIF file for a commit with the same category and from the same tool, the earlier results are overwritten. However, if you try to upload multiple SARIF files for the same tool and category in a single {% data variables.product.prodname_actions %} workflow run, the misconfiguration is detected and the run will fail.
Si cargas un archivo de SARIF para una confirmación con la misma categoría y desde la misma herramienta, los resultados anteriores se sobreescribirán. Sin embargo, si intentas cargar varios archivos SARIF para la misma herramienta y categoría en una ejecución de flujo de trabajo de {% data variables.product.prodname_actions %} sencilla, esta configuración errónea se detectará y la ejecución fallará.
{% data variables.product.prodname_dotcom %} uses properties in the SARIF file to display alerts. For example, the `shortDescription` and `fullDescription` appear at the top of a {% data variables.product.prodname_code_scanning %} alert. The `location` allows {% data variables.product.prodname_dotcom %} to show annotations in your code file. For more information, see "[Managing {% data variables.product.prodname_code_scanning %} alerts for your repository](/code-security/secure-coding/managing-code-scanning-alerts-for-your-repository)."
{% data variables.product.prodname_dotcom %} utiliza propiedades en el archivo SARIF para mostrar alertas. Por ejemplo, `shortDescription` y `fullDescription` aparecen en la parte superior de una alerta de {% data variables.product.prodname_code_scanning %}. `location` permite que {% data variables.product.prodname_dotcom %} muestre anotaciones en el archivo de código. Para obtener más información, consulte "[Administración de alertas de {% data variables.product.prodname_code_scanning %} para el repositorio](/code-security/secure-coding/managing-code-scanning-alerts-for-your-repository)".
If you're new to SARIF and want to learn more, see Microsoft's [`SARIF tutorials`](https://github.com/microsoft/sarif-tutorials) repository.
Si no está familiarizado con SARIF y quiere obtener más información, consulte el repositorio [`SARIF tutorials`](https://github.com/microsoft/sarif-tutorials) de Microsoft.
## Providing data to track {% data variables.product.prodname_code_scanning %} alerts across runs
## Proporcionar datos para realizar un seguimiento de las alertas de {% data variables.product.prodname_code_scanning %} entre ejecuciones
Each time the results of a new code scan are uploaded, the results are processed and alerts are added to the repository. To prevent duplicate alerts for the same problem, {% data variables.product.prodname_code_scanning %} uses fingerprints to match results across various runs so they only appear once in the latest run for the selected branch. This makes it possible to match alerts to the correct line of code when files are edited. The `ruleID` for a result has to be the same across analysis.
Cada vez que se cargan los resultados de un nuevo examen de código, los resultados se procesan y se agregan alertas al repositorio. Para prevenir las alertas duplicadas para el mismo problema, {% data variables.product.prodname_code_scanning %} utiliza huellas dactilares para empatara los resultados a través de diversas ejecuciones para que solo aparezcan una vez en la última ejecución para la rama seleccionada. Esto hace posible emparejar las alertas con la línea de código correcta cuando se editan los archivos. El `ruleID` para un resultado debe ser el mismo en todo el análisis.
### Reporting consistent filepaths
### Informes de rutas de archivo coherentes
The filepath has to be consistent across the runs to enable a computation of a stable fingerprint. If the filepaths differ for the same result, each time there is a new analysis a new alert will be created, and the old one will be closed. This will cause having multiple alerts for the same result.
La ruta de acceso de archivo debe ser coherente en las ejecuciones para habilitar un cálculo de una huella digital estable. Si las rutas de archivo difieren para el mismo resultado, cada vez que se crea un nuevo análisis, se creará una nueva alerta y se cerrará la antigua. Esto provocará que haya varias alertas para el mismo resultado.
### Including data for fingerprint generation
### Inclusión de datos para la generación de huellas digitales
{% data variables.product.prodname_dotcom %} uses the `partialFingerprints` property in the OASIS standard to detect when two results are logically identical. For more information, see the "[partialFingerprints property](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012611)" entry in the OASIS documentation.
{% data variables.product.prodname_dotcom %} usa la propiedad `partialFingerprints` del estándar OASIS para detectar si hay dos resultados idénticos desde el punto de vista lógico. Para obtener más información, consulte la entrada "[propiedad partialFingerprints](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012611)" en la documentación de OASIS.
SARIF files created by the {% data variables.product.prodname_codeql_workflow %}, {% ifversion codeql-runner-supported %}using the {% data variables.product.prodname_codeql_runner %}, {% endif %}or using the {% data variables.product.prodname_codeql_cli %} include fingerprint data. If you upload a SARIF file using the `upload-sarif` action and this data is missing, {% data variables.product.prodname_dotcom %} attempts to populate the `partialFingerprints` field from the source files. For more information about uploading results, see "[Uploading a SARIF file to {% data variables.product.prodname_dotcom %}](/code-security/secure-coding/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)."
Los archivos SARIF que crea el {% data variables.product.prodname_codeql_workflow %}, {% ifversion codeql-runner-supported %}con el {% data variables.product.prodname_codeql_runner %}, {% endif %}o con el {% data variables.product.prodname_codeql_cli %} incluyen datos de huellas digitales. Si carga un archivo SARIF con la acción `upload-sarif` y faltan estos datos, {% data variables.product.prodname_dotcom %} intenta rellenar el campo `partialFingerprints` a partir de los archivos de origen. Para obtener más información sobre la carga de resultados, consulte "[Carga de un archivo SARIF en {% data variables.product.prodname_dotcom %}](/code-security/secure-coding/uploading-a-sarif-file-to-github#uploading-a-code-scanning-analysis-with-github-actions)."
If you upload a SARIF file without fingerprint data using the `/code-scanning/sarifs` API endpoint, the {% data variables.product.prodname_code_scanning %} alerts will be processed and displayed, but users may see duplicate alerts. To avoid seeing duplicate alerts, you should calculate fingerprint data and populate the `partialFingerprints` property before you upload the SARIF file. You may find the script that the `upload-sarif` action uses a helpful starting point: https://github.com/github/codeql-action/blob/main/src/fingerprints.ts. For more information about the API, see "[Upload an analysis as SARIF data](/rest/reference/code-scanning#upload-an-analysis-as-sarif-data)."
Si carga un archivo SARIF sin datos de huella digital utilizando el punto de conexión de la API `/code-scanning/sarifs`, se procesarán y se mostrarán las alertas del {% data variables.product.prodname_code_scanning %}, pero es posible que los usuarios vean alertas duplicadas. Para evitar ver alertas duplicadas, debe calcular los datos de huella digital y rellenar la propiedad `partialFingerprints` antes de cargar el archivo SARIF. Puede que el script que utiliza la acción `upload-sarif` le resulte un buen punto de partida: https://github.com/github/codeql-action/blob/main/src/fingerprints.ts. Para obtener más información sobre la API, consulte "[Carga de un análisis como datos de SARIF](/rest/reference/code-scanning#upload-an-analysis-as-sarif-data)".
## Understanding rules and results
## Descripción de las reglas y los resultados
SARIF files support both rules and results. The information stored in these elements is similar but serves different purposes.
Los archivos SARIF admiten reglas y resultados. La información almacenada en estos elementos es similar, pero sirve para diferentes propósitos.
- Rules are an array of `reportingDescriptor` objects that are included in the `toolComponent` object. This is where you store details of the rules that are run during analysis. Information in these objects should change infrequently, typically when you update the tool.
- Las reglas son una matriz de objetos `reportingDescriptor` que se incluyen en el objeto `toolComponent`. Aquí es donde almacenas los detalles de las reglas que se ejecutan durante el análisis. La información de estos objetos debe cambiar con poca frecuencia, normalmente al actualizar la herramienta.
- Results are stored as a series of `result` objects under `results` in the `run` object. Each `result` object contains details for one alert in the codebase. Within the `results` object, you can reference the rule that detected the alert.
- Los resultados se almacenan como una serie de objetos `result` en `results` en el objeto `run`. Cada objeto `result` contiene detalles de una alerta en el código base. Dentro del objeto `results`, puedes hacer referencia a la regla que ha detectado la alerta.
When you compare SARIF files generated by analyzing different codebases with the same tool and rules, you should see differences in the results of the analyses but not in the rules.
Al comparar los archivos SARIF generados mediante el análisis de diferentes bases de código con la misma herramienta y las mismas reglas, tendrías que ver diferencias en los resultados de los análisis, pero no en las reglas.
## Specifying the root for source files
## Especificación de la raíz para los archivos de origen
{% data variables.product.prodname_code_scanning_capc %} interprets results that are reported with relative paths as relative to the root of the repository analyzed. If a result contains an absolute URI, the URI is converted to a relative URI. The relative URI can then be matched against a file committed to the repository.
{% data variables.product.prodname_code_scanning_capc %} interpreta los resultados que se notifican con rutas de acceso relativas en relación con la raíz del repositorio analizado. Si un resultado contiene un URI absoluto, el URI se convierte en un URI relativo. A continuación, el URI relativo se puede emparejar con un archivo confirmado en el repositorio.
You can provide the source root for conversion from absolute to relative URIs in one of the following ways.
Puedes proporcionar la raíz de origen para la conversión de URI absolutos a relativos de una de las siguientes maneras.
- [`checkout_path`](https://github.com/github/codeql-action/blob/c2c0a2908e95769d01b907f9930050ecb5cf050d/analyze/action.yml#L44-L47) input to the `github/codeql-action/analyze` action
- `checkout_uri` parameter to the SARIF upload API endpoint. For more information, see "[{% data variables.product.prodname_code_scanning_capc %}](/rest/code-scanning#upload-an-analysis-as-sarif-data)" in the REST API documentation
- [`invocation.workingDirectory.uri`](https://docs.oasis-open.org/sarif/sarif/v2.1.0/csprd01/sarif-v2.1.0-csprd01.html#_Toc9244365) property in the SARIF file
- [`checkout_path`](https://github.com/github/codeql-action/blob/c2c0a2908e95769d01b907f9930050ecb5cf050d/analyze/action.yml#L44-L47) entrada a la `github/codeql-action/analyze` acción
- `checkout_uri` parámetro al punto de conexión de la API de carga de SARIF. Para más información, consulta "[{% data variables.product.prodname_code_scanning_capc %}](/rest/code-scanning#upload-an-analysis-as-sarif-data)" en la documentación de la API REST
- [`invocation.workingDirectory.uri`](https://docs.oasis-open.org/sarif/sarif/v2.1.0/csprd01/sarif-v2.1.0-csprd01.html#_Toc9244365) propiedad en el archivo de SARIF
If you provide a source root, any location of an artifact specified using an absolute URI must use the same URI scheme. If there is a mismatch between the URI scheme for the source root and one or more of the absolute URIs, the upload is rejected.
Si proporciona una raíz de origen, cualquier ubicación de un artefacto especificado mediante un URI absoluto debe usar el mismo esquema de URI. Si hay una discrepancia entre el esquema de URI para la raíz de origen y uno o varios de los URI absolutos, se rechaza la carga.
For example, a SARIF file is uploaded using a source root of `file:///github/workspace`.
Por ejemplo, un archivo SARIF se carga mediante una raíz de origen de `file:///github/workspace`.
```
# Conversion of absolute URIs to relative URIs for location artifacts
@@ -92,133 +96,133 @@ file:///github/workspace/src/main.go -> src/main.go
file:///tmp/go-build/tmp.go -> file:///tmp/go-build/tmp.go
```
The file is successfully uploaded as both absolute URIs use the same URI scheme as the source root.
El archivo se carga correctamente, ya que ambos URI absolutos usan el mismo esquema de URI que la raíz de origen.
## Validating your SARIF file
## Validar tu archivo SARIF
<!--UI-LINK: When code scanning fails, the error banner shown in the Security > Code scanning alerts view links to this anchor.-->
You can check a SARIF file is compatible with {% data variables.product.prodname_code_scanning %} by testing it against the {% data variables.product.prodname_dotcom %} ingestion rules. For more information, visit the [Microsoft SARIF validator](https://sarifweb.azurewebsites.net/).
Puedes verificar si un archivo SARIF es compatible con el {% data variables.product.prodname_code_scanning %} si lo pruebas contra las reglas de ingestión de {% data variables.product.prodname_dotcom %}. Para obtener más información, visite el [validador de SARIF de Microsoft](https://sarifweb.azurewebsites.net/).
{% data reusables.code-scanning.upload-sarif-alert-limit %}
## Supported SARIF output file properties
## Propiedades compatibles de archivo de salida SARIF
If you use a code analysis engine other than {% data variables.product.prodname_codeql %}, you can review the supported SARIF properties to optimize how your analysis results will appear on {% data variables.product.prodname_dotcom %}.
Si utilizas un motor de análisis de código diferente a {% data variables.product.prodname_codeql %}, puedes revisar las propiedades SARIF compatibles para optimizar cómo aparecerán los resultados de tu análisis en {% data variables.product.prodname_dotcom %}.
{% note %}
**Note:** You must supply an explicit value for any property marked as "required". The empty string is not supported for required properties.
**Nota:** Debes proporcionar un valor explícito para cualquier propiedad marcada como "obligatoria". La cadena vacía no se admite para las propiedades necesarias.
{% endnote %}
Any valid SARIF 2.1.0 output file can be uploaded, however, {% data variables.product.prodname_code_scanning %} will only use the following supported properties.
Puedes cargar cualquier archivo de salida SARIF 2.1.0 válido, sin embargo, {% data variables.product.prodname_code_scanning %} utilizará únicamente las siguientes propiedades compatibles.
### `sarifLog` object
### Objecto `sarifLog`
| Name | Description |
| Nombre | Descripción |
|----|----|
| `$schema` | **Required.** The URI of the SARIF JSON schema for version 2.1.0. For example, `https://json.schemastore.org/sarif-2.1.0.json`. |
| `version` | **Required.** {% data variables.product.prodname_code_scanning_capc %} only supports SARIF version `2.1.0`.
| `runs[]` | **Required.** A SARIF file contains an array of one or more runs. Each run represents a single run of an analysis tool. For more information about a `run`, see the [`run` object](#run-object).
| `$schema` | **Obligatorio.** URI del esquema de JSON SARIF para la versión 2.1.0. Por ejemplo, `https://json.schemastore.org/sarif-2.1.0.json`. |
| `version` | **Obligatorio.** {% data variables.product.prodname_code_scanning_capc %} solo admite la versión `2.1.0` de SARIF.
| `runs[]` | **Obligatorio.** Un archivo SARIF contiene una matriz de una o varias ejecuciones. Cada ejecución representa una sola ejecución de una herramienta de análisis. Para obtener más información sobre un `run`, consulte el [objeto `run`](#run-object).
### `run` object
### Objecto `run`
{% data variables.product.prodname_code_scanning_capc %} uses the `run` object to filter results by tool and provide information about the source of a result. The `run` object contains the `tool.driver` tool component object, which contains information about the tool that generated the results. Each `run` can only have results for one analysis tool.
{% data variables.product.prodname_code_scanning_capc %} usa el objeto `run` para filtrar resultados por herramienta y proporcionar información sobre el origen de un resultado. El objeto `run` contiene el objeto de componente de herramienta `tool.driver`, que contiene información sobre la herramienta que generó los resultados. Cada `run` puede tener resultados para una sola herramienta de análisis.
| Name | Description |
| Nombre | Descripción |
|----|----|
| `tool.driver` | **Required.** A `toolComponent` object that describes the analysis tool. For more information, see the [`toolComponent` object](#toolcomponent-object). |
| `tool.extensions[]` | **Optional.** An array of `toolComponent` objects that represent any plugins or extensions used by the tool during analysis. For more information, see the [`toolComponent` object](#toolcomponent-object). |
| `invocation.workingDirectory.uri` | **Optional.** This field is used only when `checkout_uri` (SARIF upload API only) or `checkout_path` (% data variables.product.prodname_actions %} only) are not provided. The value is used to convert absolute URIs used in [`physicalLocation` objects](#physicallocation-object) to relative URIs. For more information, see "[Specifying the root for source files](#specifying-the-root-for-source-files)."|
| `results[]` | **Required.** The results of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the results on {% data variables.product.prodname_dotcom %}. For more information, see the [`result` object](#result-object).
| `tool.driver` | **Obligatorio.** Un objeto `toolComponent` que describe la herramienta de análisis. Para obtener más información, consulte el [objeto `toolComponent`](#toolcomponent-object). |
| `tool.extensions[]` | **Opcional.** Una matriz de objetos `toolComponent` que representan todos los complementos o extensiones usados por la herramienta durante el análisis. Para obtener más información, consulte el [objeto `toolComponent`](#toolcomponent-object). |
| `invocation.workingDirectory.uri` | **Opcional.** Este campo solo se usa cuando `checkout_uri` no se proporcionan (solo API de carga SARIF) o `checkout_path` (% data variables.product.prodname_actions %} solo). El valor se usa para convertir URI absolutos usados en [`physicalLocation` objetos](#physicallocation-object) en URI relativos. Para obtener más información, consulta "[Especificar la raíz para los archivos de origen](#specifying-the-root-for-source-files)".|
| `results[]` | **Obligatorio.** Resultados de la herramienta de análisis. {% data variables.product.prodname_code_scanning_capc %} muestra los resultados en {% data variables.product.prodname_dotcom %}. Para obtener más información, consulte el [objeto `result`](#result-object).
### `toolComponent` object
### Objecto `toolComponent`
| Name | Description |
| Nombre | Descripción |
|----|----|
| `name` | **Required.** The name of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the name on {% data variables.product.prodname_dotcom %} to allow you to filter results by tool. |
| `version` | **Optional.** The version of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. |
| `semanticVersion` | **Optional.** The version of the analysis tool, specified by the Semantic Versioning 2.0 format. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. For more information, see "[Semantic Versioning 2.0.0](https://semver.org/)" in the Semantic Versioning documentation. |
| `rules[]` | **Required.** An array of `reportingDescriptor` objects that represent rules. The analysis tool uses rules to find problems in the code being analyzed. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). |
| `name` | **Obligatorio.** Nombre de la herramienta de análisis. {% data variables.product.prodname_code_scanning_capc %} muestra el nombre en {% data variables.product.prodname_dotcom %} para permitirte filtrar los resultados por herramienta. |
| `version` | **Opcional.** Versión de la herramienta de análisis. {% data variables.product.prodname_code_scanning_capc %} utiliza el número de versión para rastrear cuando los resultados pudieran haber cambiado debido al cambio de versión en la herramienta en vez de debido a un cambio del código que se analiza. Si el archivo SARIF incluye el campo `semanticVersion`, el {% data variables.product.prodname_code_scanning %} no usa `version`. |
| `semanticVersion` | **Opcional.** Versión de la herramienta de análisis, especificada por el formato Versionamiento Semántico 2.0. {% data variables.product.prodname_code_scanning_capc %} utiliza el número de versión para rastrear cuando los resultados pudieran haber cambiado debido al cambio de versión en la herramienta en vez de debido a un cambio del código que se analiza. Si el archivo SARIF incluye el campo `semanticVersion`, el {% data variables.product.prodname_code_scanning %} no usa `version`. Para obtener más información, consulte "[Versionamiento Semántico 2.0.0](https://semver.org/)" en la documentación sobre Versionamiento Semántico. |
| `rules[]` | **Obligatorio.** Matriz de objetos `reportingDescriptor` que representan reglas. La herramienta de análisis utiliza reglas para encontrar problemas en el código que se analiza. Para obtener más información, consulte el [objeto `reportingDescriptor`](#reportingdescriptor-object). |
### `reportingDescriptor` object
### Objecto `reportingDescriptor`
This is where you store details of the rules that are run during analysis. Information in these objects should change infrequently, typically when you update the tool. For more information, see "[Understanding rules and results](#understanding-rules-and-results)" above.
Aquí es donde almacenas los detalles de las reglas que se ejecutan durante el análisis. La información de estos objetos debe cambiar con poca frecuencia, normalmente al actualizar la herramienta. Para obtener más información, consulta "[Descripción de las reglas y los resultados](#understanding-rules-and-results)" más arriba.
| Name | Description |
| Nombre | Descripción |
|----|----|
| `id` | **Required.** A unique identifier for the rule. The `id` is referenced from other parts of the SARIF file and may be used by {% data variables.product.prodname_code_scanning %} to display URLs on {% data variables.product.prodname_dotcom %}. |
| `name` | **Optional.** The name of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the name to allow results to be filtered by rule on {% data variables.product.prodname_dotcom %}. |
| `shortDescription.text` | **Required.** A concise description of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the short description on {% data variables.product.prodname_dotcom %} next to the associated results.
| `fullDescription.text` | **Required.** A description of the rule. {% data variables.product.prodname_code_scanning_capc %} displays the full description on {% data variables.product.prodname_dotcom %} next to the associated results. The max number of characters is limited to 1000.
| `defaultConfiguration.level` | **Optional.** Default severity level of the rule. {% data variables.product.prodname_code_scanning_capc %} uses severity levels to help you understand how critical the result is for a given rule. This value can be overridden by the `level` attribute in the `result` object. For more information, see the [`result` object](#result-object). Default: `warning`.
| `help.text` | **Required.** Documentation for the rule using text format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results.
| `help.markdown` | **Recommended.** Documentation for the rule using Markdown format. {% data variables.product.prodname_code_scanning_capc %} displays this help documentation next to the associated results. When `help.markdown` is available, it is displayed instead of `help.text`.
| `properties.tags[]` | **Optional.** An array of strings. {% data variables.product.prodname_code_scanning_capc %} uses `tags` to allow you to filter results on {% data variables.product.prodname_dotcom %}. For example, it is possible to filter to all results that have the tag `security`.
| `properties.precision` | **Recommended.** A string that indicates how often the results indicated by this rule are true. For example, if a rule has a known high false-positive rate, the precision should be `low`. {% data variables.product.prodname_code_scanning_capc %} orders results by precision on {% data variables.product.prodname_dotcom %} so that the results with the highest `level`, and highest `precision` are shown first. Can be one of: `very-high`, `high`, `medium`, or `low`.
| `properties.problem.severity` | **Recommended.** A string that indicates the level of severity of any alerts generated by a non-security query. This, with the `properties.precision` property, determines whether the results are displayed by default on {% data variables.product.prodname_dotcom %} so that the results with the highest `problem.severity`, and highest `precision` are shown first. Can be one of: `error`, `warning`, or `recommendation`.
| `properties.security-severity` | **Recommended.** A string representing a score that indicates the level of severity, between 0.0 and 10.0, for security queries (`@tags` includes `security`). This, with the `properties.precision` property, determines whether the results are displayed by default on {% data variables.product.prodname_dotcom %} so that the results with the highest `security-severity`, and highest `precision` are shown first. {% data variables.product.prodname_code_scanning_capc %} translates numerical scores as follows: over 9.0 is `critical`, 7.0 to 8.9 is `high`, 4.0 to 6.9 is `medium` and 3.9 or less is `low`.
| `id` | **Obligatorio.** Identificador único para la regla. Al `id` se hace referencia desde otras secciones del archivo SARIF, y se puede usar en el {% data variables.product.prodname_code_scanning %} para mostrar las URL en {% data variables.product.prodname_dotcom %}. |
| `name` | **Opcional.** Nombre de la regla. {% data variables.product.prodname_code_scanning_capc %} muestra el nombre para permitir que se filtren los resultados por regla en {% data variables.product.prodname_dotcom %}. |
| `shortDescription.text` | **Obligatorio.** Descripción concisa de la regla. {% data variables.product.prodname_code_scanning_capc %} muestra la descripción corta en {% data variables.product.prodname_dotcom %} junto a los resultados asociados.
| `fullDescription.text` | **Obligatorio.** Una descripción de la regla. {% data variables.product.prodname_code_scanning_capc %} muestra la descripción completa en {% data variables.product.prodname_dotcom %} junto a los resultados asociados. La cantidad máxma de caracteres se limita a 1000.
| `defaultConfiguration.level` | **Opcional.** Nivel de gravedad predeterminado de la regla. {% data variables.product.prodname_code_scanning_capc %} utiliza niveles de severidad para ayudarte a entender qué tan crítico es el resultado de una regla. El atributo `level` del objeto `result` puede invalidar este valor. Para obtener más información, consulte el [objeto `result`](#result-object). Predeterminado: `warning`.
| `help.text` | **Obligatorio.** Documentación de la regla con formato de texto. {% data variables.product.prodname_code_scanning_capc %} muestra esta documentación de ayuda junto a los resultados asociados.
| `help.markdown` | **Opción recomendada.** Documentación de la regla con formato de Markdown. {% data variables.product.prodname_code_scanning_capc %} muestra esta documentación de ayuda junto a los resultados asociados. Cuando `help.markdown` está disponible, se muestra en lugar de `help.text`.
| `properties.tags[]` | **Opcional.** Una matriz de cadenas. {% data variables.product.prodname_code_scanning_capc %} usa `tags` para permitirle filtrar resultados en {% data variables.product.prodname_dotcom %}. Por ejemplo, es posible filtrar todos los resultados que tengan la etiqueta `security`.
| `properties.precision` | **Opción recomendada.** Cadena que indica con qué frecuencia se cumplen los resultados indicados por esta regla. Por ejemplo, si una regla tiene una tasa alta de falsos positivos, la precisión debería ser `low`. {% data variables.product.prodname_code_scanning_capc %} ordena los resultados de acuerdo con su precisión en {% data variables.product.prodname_dotcom %} para que aquellos con el `level` y el `precision` más altos aparezcan primero. Puede ser `very-high`, `high`, `medium` o `low`.
| `properties.problem.severity` | **Opción recomendada.** Cadena que indica el nivel de gravedad de las alertas generadas por una consulta que no sea de seguridad. Esto, junto con la propiedad `properties.precision`, determina si los resultados se muestran de manera predeterminada en {% data variables.product.prodname_dotcom %} para que los resultados con el `problem.severity` y el `precision` más altos aparezcan primero. Puede ser de tipo `error`, `warning` o `recommendation`.
| `properties.security-severity` | **Opción recomendada.** Cadena que representa una puntuación que indica el nivel de gravedad, entre 0,0 y 10,0, de las consultas de seguridad (`@tags` incluye `security`). Esto, junto con la propiedad `properties.precision`, determina si los resultados se muestran de manera predeterminada en {% data variables.product.prodname_dotcom %} para que los resultados con el `security-severity` y el `precision` más altos aparezcan primero. {% data variables.product.prodname_code_scanning_capc %} traduce las puntuaciones numéricas de la siguiente manera: más de 9,0 es`critical`, entre 7,0 y 8,9 es `high`, entre 4,0 y 6,9 es `medium` y menos de 3,9 o 3,9 es `low`.
### `result` object
### Objecto `result`
Each `result` object contains details for one alert in the codebase. Within the `results` object, you can reference the rule that detected the alert. For more information, see "[Understanding rules and results](#understanding-rules-and-results)" above.
Cada objeto `result` contiene detalles de una alerta en el código base. Dentro del objeto `results`, puedes hacer referencia a la regla que ha detectado la alerta. Para obtener más información, consulta "[Descripción de las reglas y los resultados](#understanding-rules-and-results)" más arriba.
{% data reusables.code-scanning.upload-sarif-alert-limit %}
| Name | Description |
| Nombre | Descripción |
|----|----|
| `ruleId`| **Optional.** The unique identifier of the rule (`reportingDescriptor.id`). For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). {% data variables.product.prodname_code_scanning_capc %} uses the rule identifier to filter results by rule on {% data variables.product.prodname_dotcom %}.
| `ruleIndex`| **Optional.** The index of the associated rule (`reportingDescriptor` object) in the tool component `rules` array. For more information, see the [`run` object](#run-object). The allowed range for this property 0 to 2^63 - 1.
| `rule`| **Optional.** A reference used to locate the rule (reporting descriptor) for this result. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object).
| `level`| **Optional.** The severity of the result. This level overrides the default severity defined by the rule. {% data variables.product.prodname_code_scanning_capc %} uses the level to filter results by severity on {% data variables.product.prodname_dotcom %}.
| `message.text`| **Required.** A message that describes the result. {% data variables.product.prodname_code_scanning_capc %} displays the message text as the title of the result. Only the first sentence of the message will be displayed when visible space is limited.
| `locations[]`| **Required.** The set of locations where the result was detected up to a maximum of 10. Only one location should be included unless the problem can only be corrected by making a change at every specified location. **Note:** At least one location is required for {% data variables.product.prodname_code_scanning %} to display a result. {% data variables.product.prodname_code_scanning_capc %} will use this property to decide which file to annotate with the result. Only the first value of this array is used. All other values are ignored.
| `partialFingerprints`| **Required.** A set of strings used to track the unique identity of the result. {% data variables.product.prodname_code_scanning_capc %} uses `partialFingerprints` to accurately identify which results are the same across commits and branches. {% data variables.product.prodname_code_scanning_capc %} will attempt to use `partialFingerprints` if they exist. If you are uploading third-party SARIF files with the `upload-action`, the action will create `partialFingerprints` for you when they are not included in the SARIF file. For more information, see "[Providing data to track code scanning alerts across runs](#providing-data-to-track-code-scanning-alerts-across-runs)." **Note:** {% data variables.product.prodname_code_scanning_capc %} only uses the `primaryLocationLineHash`.
| `codeFlows[].threadFlows[].locations[]`| **Optional.** An array of `location` objects for a `threadFlow` object, which describes the progress of a program through a thread of execution. A `codeFlow` object describes a pattern of code execution used to detect a result. If code flows are provided, {% data variables.product.prodname_code_scanning %} will expand code flows on {% data variables.product.prodname_dotcom %} for the relevant result. For more information, see the [`location` object](#location-object).
| `relatedLocations[]`| A set of locations relevant to this result. {% data variables.product.prodname_code_scanning_capc %} will link to related locations when they are embedded in the result message. For more information, see the [`location` object](#location-object).
| `ruleId`| **Opcional.** Identificador único de la regla (`reportingDescriptor.id`). Para obtener más información, consulte el [objeto `reportingDescriptor`](#reportingdescriptor-object). {% data variables.product.prodname_code_scanning_capc %} utiliza el identificador de reglas para filtrar los resultados por regla en {% data variables.product.prodname_dotcom %}.
| `ruleIndex`| **Opcional.** Índice de la regla asociada (objeto `reportingDescriptor`) en la matriz `rules` de componentes de herramienta. Para obtener más información, consulte el [objeto `run`](#run-object). El rango permitido para esta propiedad de 0 to 2^63 - 1.
| `rule`| **Opcional.** Referencia usada para buscar la regla (descriptor de informes) de este resultado. Para obtener más información, consulte el [objeto `reportingDescriptor`](#reportingdescriptor-object).
| `level`| **Opcional.** Gravedad del resultado. Este nivel invalida la severidad predeterminada que se define en la regla. {% data variables.product.prodname_code_scanning_capc %} utiliza el nivel para filtrar los resultados en {% data variables.product.prodname_dotcom %} por severidad.
| `message.text`| **Obligatorio.** Mensaje que describe el resultado. {% data variables.product.prodname_code_scanning_capc %} muestra el texto del mensaje como el título del resultado. Se mostrará únicamente la primera oración del mensaje cuando el espacio visible esté limitado.
| `locations[]`| **Obligatorio.** Conjunto de ubicaciones donde se detectó el resultado (hasta un máximo de 10). Sólo se deberá incluir una ubicación a menos de que el problema solo pueda corregirse realizando un cambio en cada ubicación especificada. **Nota:** Se requiere al menos una ubicación para que {% data variables.product.prodname_code_scanning %} muestre el resultado. {% data variables.product.prodname_code_scanning_capc %} utilizará esta propiedad para decidir qué archivo anotar con el resultado. Únicamente si se utiliza el primer valor de este arreglo. Se ignorará al resto de los otros valores.
| `partialFingerprints`| **Obligatorio.** Conjunto de cadenas usadas para realizar un seguimiento de la identidad única del resultado. {% data variables.product.prodname_code_scanning_capc %} usa `partialFingerprints` para identificar con precisión los resultados que son iguales en todas las confirmaciones y ramas. {% data variables.product.prodname_code_scanning_capc %} intentará usar `partialFingerprints` si están presentes. Si va a cargar archivos SARIF de terceros con `upload-action`, la acción creará `partialFingerprints` automáticamente cuando no se incluyan en el archivo SARIF. Para obtener más información, consulta "[Proporcionar datos para realizar un seguimiento de las alertas de análisis de código entre ejecuciones](#providing-data-to-track-code-scanning-alerts-across-runs)". **Nota:** {% data variables.product.prodname_code_scanning_capc %} solo usa `primaryLocationLineHash`.
| `codeFlows[].threadFlows[].locations[]`| **Opcional.** Matriz de objetos `location` para un objeto `threadFlow`, que describe el progreso de un programa a través de un subproceso de ejecución. Un objeto `codeFlow` describe un patrón de ejecución de código utilizado para detectar un resultado. Si se proporcionan flujos de código, {% data variables.product.prodname_code_scanning %} los expandirá en {% data variables.product.prodname_dotcom %} para el resultado relevante. Para obtener más información, consulte el [objeto `location`](#location-object).
| `relatedLocations[]`| Un conjunto de ubicaciones relevantes para el resultado. {% data variables.product.prodname_code_scanning_capc %} vinculará las ubicaciones cuando se incorporen en el mensaje de resultado. Para obtener más información, consulte el [objeto `location`](#location-object).
### `location` object
### Objecto `location`
A location within a programming artifact, such as a file in the repository or a file that was generated during a build.
Una ubicación dentro de un artefacto de programación, tal como un archivo en el repositorio o un archivo que se generó durante una compilación.
| Name | Description |
| Nombre | Descripción |
|----|----|
| `location.id` | **Optional.** A unique identifier that distinguishes this location from all other locations within a single result object. The allowed range for this property 0 to 2^63 - 1.
| `location.physicalLocation` | **Required.** Identifies the artifact and region. For more information, see the [`physicalLocation`](#physicallocation-object).
| `location.message.text` | **Optional.** A message relevant to the location.
| `location.id` | **Opcional.** Identificador único que distingue esta ubicación de todas las demás ubicaciones dentro de un único objeto de resultado. El rango permitido para esta propiedad de 0 to 2^63 - 1.
| `location.physicalLocation` | **Obligatorio.** Identifica el artefacto y la región. Para obtener más información, consulte [`physicalLocation`](#physicallocation-object).
| `location.message.text` | **Opcional.** Mensaje relevante para la ubicación.
### `physicalLocation` object
### Objecto `physicalLocation`
| Name | Description |
| Nombre | Descripción |
|----|----|
| `artifactLocation.uri`| **Required.** A URI indicating the location of an artifact, usually a file either in the repository or generated during a build. For the best results we recommend that this is a relative path from the root of the GitHub repository being analyzed. For example, `src/main.js`. For more information about artifact URIs, see "[Specifying the root for source files](#specifying-the-root-for-source-files)."|
| `region.startLine` | **Required.** The line number of the first character in the region.
| `region.startColumn` | **Required.** The column number of the first character in the region.
| `region.endLine` | **Required.** The line number of the last character in the region.
| `region.endColumn` | **Required.** The column number of the character following the end of the region.
| `artifactLocation.uri`| **Obligatorio.** URI que indica la ubicación de un artefacto, normalmente un archivo del repositorio o generado durante una compilación. Para obtener los mejores resultados, se recomienda que se trata de una ruta de acceso relativa de la raíz del repositorio de GitHub que se está analizando. Por ejemplo, `src/main.js`. Para obtener más información sobre los URI de artefacto, consulta "[Especificación de la raíz para los archivos de origen](#specifying-the-root-for-source-files)".|
| `region.startLine` | **Obligatorio.** Número de línea del primer carácter de la región.
| `region.startColumn` | **Obligatorio.** Número de columna del primer carácter de la región.
| `region.endLine` | **Obligatorio.** Número de línea del último carácter de la región.
| `region.endColumn` | **Obligatorio.** Número de columna del carácter que sigue al final de la región.
### `runAutomationDetails` object
### Objecto `runAutomationDetails`
The `runAutomationDetails` object contains information that specifies the identity of a run.
El objeto `runAutomationDetails` contiene información que especifica la identidad de una ejecución.
{% note %}
**Note:** `runAutomationDetails` is a SARIF v2.1.0 object. If you're using the {% data variables.product.prodname_codeql_cli %}, you can specify the version of SARIF to use. The equivalent object to `runAutomationDetails` is `<run>.automationId` for SARIF v1 and `<run>.automationLogicalId` for SARIF v2.
**Nota:** `runAutomationDetails` es un objeto de SARIF v2.1.0. Si estás utilizando el {% data variables.product.prodname_codeql_cli %}, puedes especificar la versión de SARIF a utilizar. El objeto equivalente a `runAutomationDetails` es `<run>.automationId` para SARIF v1 y `<run>.automationLogicalId` para SARIF v2.
{% endnote %}
| Name | Description |
| Nombre | Descripción |
|----|----|
| `id`| **Optional.** A string that identifies the category of the analysis and the run ID. Use if you want to upload multiple SARIF files for the same tool and commit, but performed on different languages or different parts of the code. |
| `id`| **Opcional.** Cadena que identifica la categoría del análisis y el identificador de ejecución. Utilízala si quieres cargar varios archivos SARIF para la misma herramienta y confirmación, pero que se realice en diferentes lenguajes o partes del código. |
The use of the `runAutomationDetails` object is optional.
El uso del objeto `runAutomationDetails` es opcional.
The `id` field can include an analysis category and a run ID. We don't use the run ID part of the `id` field, but we store it.
El campo `id` puede incluir una categoría de análisis y un identificador de ejecución. No usamos la parte del identificador de ejecución del campo `id`, pero la almacenamos.
Use the category to distinguish between multiple analyses for the same tool or commit, but performed on different languages or different parts of the code. Use the run ID to identify the specific run of the analysis, such as the date the analysis was run.
Utiliza la categoría para distinguir entre los diversos análisis de la misma herramienta o confirmación, pero cuando se llevan a cabo en diferentes lenguajes o en partes diferentes del código. Utiliza la ID de ejecución para identificar la ejecución específica del análisis, tal como la fecha en la que este se ejecutó.
`id` is interpreted as `category/run-id`. If the `id` contains no forward slash (`/`), then the entire string is the `run_id` and the `category` is empty. Otherwise, `category` is everything in the string until the last forward slash, and `run_id` is everything after.
`id` se interpreta como `category/run-id`. Si `id` no contiene ninguna barra diagonal (`/`), la cadena completa es la `run_id` y la `category` está vacía. De lo contrario, `category` será todo lo que aparezca en la cadena hasta la última barra diagonal, y `run_id` el resto.
| `id` | category | `run_id` |
|----|----|----|
@@ -226,21 +230,21 @@ Use the category to distinguish between multiple analyses for the same tool or c
| my-analysis/tool1/ | my-analysis/tool1 | _no `run-id`_
| my-analysis for tool1 | _no category_ | my-analysis for tool1
- The run with an `id` of "my-analysis/tool1/2021-02-01" belongs to the category "my-analysis/tool1". Presumably, this is the run from February 2, 2021.
- The run with an `id` of "my-analysis/tool1/" belongs to the category "my-analysis/tool1" but is not distinguished from other runs in that category.
- The run whose `id` is "my-analysis for tool1 " has a unique identifier but cannot be inferred to belong to any category.
- La ejecución con un `id` de "my-analysis/tool1/2021-02-01" pertenece a la categoría "my-analysis/tool1". Supuestamente, esta es la ejecución del 2 de febrero de 2021.
- La ejecución con un `id` de "my-analysis/tool1/" pertenece a la cateogría "my-analysis/tool1", pero no se distingue de otras ejecuciones de esa categoría.
- La ejecución cuyo `id` es "my-analysis for tool1 " tiene un identificador único, pero no se puede inferir que pertenezca a alguna categoría.
For more information about the `runAutomationDetails` object and the `id` field, see [runAutomationDetails object](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012479) in the OASIS documentation.
Para obtener más información sobre el objeto `runAutomationDetails` y el campo `id`, consulte [Objeto runAutomationDetails](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012479) en la documentación de OASIS.
Note that the rest of the supported fields are ignored.
Nota que el resto de los campos compatibles se ignorarán.
## SARIF output file examples
## Ejemplos de archivo de salida SARIF
These example SARIF output files show supported properties and example values.
Estos ejemplos de archivos de salida SARIF muestran las propiedades compatibles y los valores de ejemplo.
### Example with minimum required properties
### Ejemplo con las propiedades mínimas requeridas
This SARIF output file has example values to show the minimum required properties for {% data variables.product.prodname_code_scanning %} results to work as expected. If you remove any properties, omit values, or use an empty string, this data will not be displayed correctly or sync on {% data variables.product.prodname_dotcom %}.
Este archivo de salida SARIF tiene valores de ejemplo para mostrar las propiedades mínimas requeridas para que los resultados de {% data variables.product.prodname_code_scanning %} funcionen como se espera. Si eliminas cualquier propiedad u omites valores, o si usas una cadena vacía, estos datos no se mostrarán correctamente ni se sincronizarán en {% data variables.product.prodname_dotcom %}.
```json
{
@@ -296,9 +300,9 @@ This SARIF output file has example values to show the minimum required propertie
}
```
### Example showing all supported SARIF properties
### Ejemplo que muestra todas las propiedades compatibles con SARIF
This SARIF output file has example values to show all supported SARIF properties for {% data variables.product.prodname_code_scanning %}.
Este archivo de salida SARIF tiene valores ejemplo para mostrar todas las propiedades de SARIF compatibles con {% data variables.product.prodname_code_scanning %}.
```json
{

35
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system.md
View File

@@ -1,7 +1,7 @@
---
title: About CodeQL code scanning in your CI system
title: Acerca del escaneo de código de CodeQL en tu sistema de IC
shortTitle: Code scanning in your CI
intro: 'You can analyze your code with {% data variables.product.prodname_codeql %} in a third-party continuous integration system and upload the results to {% data variables.product.product_location %}. The resulting {% data variables.product.prodname_code_scanning %} alerts are shown alongside any alerts generated within {% data variables.product.product_name %}.'
intro: 'Puedes analizar tu código con {% data variables.product.prodname_codeql %} en un sistema de integración contínua de terceros y cargar los resultados a {% data variables.product.product_location %}. Las alertas del {% data variables.product.prodname_code_scanning %} resultantes se muestran junto con cualquier alerta que se genere dentro de {% data variables.product.product_name %}.'
product: '{% data reusables.gated-features.code-scanning %}'
versions:
fpt: '*'
@@ -20,15 +20,20 @@ topics:
redirect_from:
- /code-security/secure-coding/about-codeql-code-scanning-in-your-ci-system
- /code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system
ms.openlocfilehash: 9f64b56bb5c766aaeb9a9fd59d8f7f009f19fa89
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147061454'
---
<!--UI-LINK: When GitHub Enterprise Server 3.1+ doesn't have GitHub Actions set up, the Security > Code scanning alerts view links to this article.-->
{% data reusables.code-scanning.beta %}
{% data reusables.code-scanning.enterprise-enable-code-scanning %}
{% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %}
## About {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system
## Acerca del {% data variables.product.prodname_code_scanning %} de {% data variables.product.prodname_codeql %} en tu sistema de IC
{% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)."
{% data reusables.code-scanning.about-code-scanning %} Para obtener información, consulta "[Acerca de {% data variables.product.prodname_code_scanning %} con {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)".
{% data reusables.code-scanning.codeql-context-for-actions-and-third-party-tools %}
@@ -36,30 +41,28 @@ redirect_from:
{% data reusables.code-scanning.codeql-cli-context-for-third-party-tools %}
{% ifversion fpt or ghes > 3.4 or ghae-issue-6251 or ghec %}
{% data reusables.code-scanning.about-analysis-origins-link %}
{% endif %}
{% ifversion fpt or ghes > 3.4 or ghae-issue-6251 or ghec %} {% data reusables.code-scanning.about-analysis-origins-link %} {% endif %}
{% data reusables.code-scanning.upload-sarif-ghas %}
## About the {% data variables.product.prodname_codeql_cli %}
## Acerca de {% data variables.product.prodname_codeql_cli %}
{% data reusables.code-scanning.what-is-codeql-cli %}
Use the {% data variables.product.prodname_codeql_cli %} to analyze:
Utiliza el {% data variables.product.prodname_codeql_cli %} para analizar:
- Dynamic languages, for example, JavaScript and Python.
- Compiled languages, for example, C/C++, C# and Java.
- Codebases written in a mixture of languages.
- Lenguajes dinámicos, por eje mplo, JavaScript y Python.
- Lenguajes compilados, por ejemplo, C/C++, C# y Java.
- Bases de código escritas en varios lenguajes.
For more information, see "[Installing {% data variables.product.prodname_codeql_cli %} in your CI system](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system)."
Para obtener más información, consulta "[Instalación de {% data variables.product.prodname_codeql_cli %} en el sistema de CI](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system)".
{% data reusables.code-scanning.licensing-note %}
{% ifversion ghes = 3.2 %}
<!-- Content for GHES 3.2 only. CodeQL CLI 2.6.2, which introduces full feature parity between CodeQL CLI and CodeQL runner, is officially recommended for GHES 3.0+ -->
Since version 2.6.3, the {% data variables.product.prodname_codeql_cli %} has had full feature parity with the {% data variables.product.prodname_codeql_runner %}.
Desde la versión 2.6.3, el {% data variables.product.prodname_codeql_cli %} ha tenido una paridad de características integral con el {% data variables.product.prodname_codeql_runner %}.
{% data reusables.code-scanning.deprecation-codeql-runner %}

190
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-runner-in-your-ci-system.md
View File

@@ -1,7 +1,7 @@
---
title: Configuring CodeQL runner in your CI system
title: Configurar el ejecutor de CodeQL en tu sistema de IC
shortTitle: Configure CodeQL runner
intro: 'You can configure how the {% data variables.product.prodname_codeql_runner %} scans the code in your project and uploads the results to {% data variables.product.prodname_dotcom %}.'
intro: 'Puedes configurar la forma en la que {% data variables.product.prodname_codeql_runner %} escanea el código en tu proyecto y en la que carga los resultados a {% data variables.product.prodname_dotcom %}.'
product: '{% data reusables.gated-features.code-scanning %}'
miniTocMaxHeadingLevel: 3
redirect_from:
@@ -24,33 +24,35 @@ topics:
- C/C++
- C#
- Java
ms.openlocfilehash: 4a1f114fa605f90ee4ccc82dcd30007f1ad17623
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147060894'
---
{% data reusables.code-scanning.deprecation-codeql-runner %} {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %}
## Acerca de configurar el {% data variables.product.prodname_code_scanning %} de {% data variables.product.prodname_codeql %} en tu sistema de IC
{% data reusables.code-scanning.deprecation-codeql-runner %}
{% data reusables.code-scanning.beta %}
{% data reusables.code-scanning.enterprise-enable-code-scanning %}
Para integrar el {% data variables.product.prodname_code_scanning %} en tu sistema de IC, puedes utilizar el {% data variables.product.prodname_codeql_runner %}. Para más información, vea "[Ejecución de {% data variables.product.prodname_codeql_runner %} en el sistema de CI](/code-security/secure-coding/running-codeql-runner-in-your-ci-system)".
## About configuring {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in your CI system
To integrate {% data variables.product.prodname_code_scanning %} into your CI system, you can use the {% data variables.product.prodname_codeql_runner %}. For more information, see "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/running-codeql-runner-in-your-ci-system)."
In general, you invoke the {% data variables.product.prodname_codeql_runner %} as follows.
En general, se invoca el {% data variables.product.prodname_codeql_runner %} de la siguiente manera.
```shell
$ /path/to-runner/codeql-runner-OS <COMMAND> <FLAGS>
```
`/path/to-runner/` depends on where you've downloaded the {% data variables.product.prodname_codeql_runner %} on your CI system. `codeql-runner-OS` depends on the operating system you use.
There are three versions of the {% data variables.product.prodname_codeql_runner %}, `codeql-runner-linux`, `codeql-runner-macos`, and `codeql-runner-win`, for Linux, macOS, and Windows systems respectively.
`/path/to-runner/` depende de si ha descargado el {% data variables.product.prodname_codeql_runner %} en el sistema de CI. `codeql-runner-OS` depende del sistema operativo que use.
Hay tres versiones de {% data variables.product.prodname_codeql_runner %}, `codeql-runner-linux`, `codeql-runner-macos` y `codeql-runner-win`, para Linux, macOS y Windows, respectivamente.
To customize the way the {% data variables.product.prodname_codeql_runner %} scans your code, you can use flags, such as `--languages` and `--queries`, or you can specify custom settings in a separate configuration file.
Para personalizar la forma en que {% data variables.product.prodname_codeql_runner %} examina el código, puede usar marcas, como `--languages` y `--queries`, o bien puede especificar valores personalizados en un archivo de configuración independiente.
## Scanning pull requests
## Escanear las solicitudes de extracción
Scanning code whenever a pull request is created prevents developers from introducing new vulnerabilities and errors into the code.
El escanear el código cada que se crea una solicitud de cambios previene que los desarrolladores introduzcan vulnerabilidades y errores nuevos a este.
To scan a pull request, run the `analyze` command and use the `--ref` flag to specify the pull request. The reference is `refs/pull/<PR-number>/head` or `refs/pull/<PR-number>/merge`, depending on whether you have checked out the HEAD commit of the pull request branch or a merge commit with the base branch.
Para examinar una solicitud de incorporación de cambios, ejecute el comando `analyze` y use la marca `--ref` para especificar la solicitud de incorporación de cambios. La referencia es `refs/pull/<PR-number>/head` o `refs/pull/<PR-number>/merge`, en función de si ha extraído del repositorio la confirmación HEAD de la rama de solicitud de incorporación de cambios o una confirmación de combinación con la rama base.
```shell
$ /path/to-runner/codeql-runner-linux analyze --ref refs/pull/42/merge
@@ -58,50 +60,50 @@ $ /path/to-runner/codeql-runner-linux analyze --ref refs/pull/42/merge
{% note %}
**Note**: If you analyze code with a third-party tool and want the results to appear as pull request checks, you must run the `upload` command and use the `--ref` flag to specify the pull request instead of the branch. The reference is `refs/pull/<PR-number>/head` or `refs/pull/<PR-number>/merge`.
**Nota**: Si analiza código con una herramienta de terceros y quiere que los resultados aparezcan como comprobaciones de solicitudes de incorporación de cambios, debe ejecutar el comando `upload` y usar la marca `--ref` para especificar la solicitud de incorporación de cambios en lugar de la rama. La referencia es `refs/pull/<PR-number>/head` o `refs/pull/<PR-number>/merge`.
{% endnote %}
## Overriding automatic language detection
## Invalidar la detección automática de lenguaje
The {% data variables.product.prodname_codeql_runner %} automatically detects and scans code written in the supported languages.
El {% data variables.product.prodname_codeql_runner %} detecta automáticamente y escanea el código que se ha escrito en los lenguajes compatibles.
{% data reusables.code-scanning.codeql-languages-bullets %}
{% data reusables.code-scanning.specify-language-to-analyze %}
To override automatic language detection, run the `init` command with the `--languages` flag, followed by a comma-separated list of language keywords. The keywords for the supported languages are {% data reusables.code-scanning.codeql-languages-keywords %}.
Para invalidar la detección automática del lenguaje, ejecute el comando `init` con la marca `--languages`, seguido de una lista separada por comas de palabras clave del lenguaje. Las palabras clave para los lenguajes compatibles son {% data reusables.code-scanning.codeql-languages-keywords %}.
```shell
$ /path/to-runner/codeql-runner-linux init --languages cpp,java
```
## Running additional queries
## Ejecutar consultas adicionales
{% data reusables.code-scanning.run-additional-queries %}
{% data reusables.code-scanning.codeql-query-suites-explanation %}
To add one or more queries, pass a comma-separated list of paths to the `--queries` flag of the `init` command. You can also specify additional queries in a configuration file.
Para agregar una o varias consultas, pase una lista separada por comas de rutas a la marca `--queries` del comando `init`. También puedes especificar consultas adicionales en un archivo de configuración.
If you also are using a configuration file for custom settings, and you are also specifying additional queries with the `--queries` flag, the {% data variables.product.prodname_codeql_runner %} uses the additional queries specified with the <nobr>`--queries`</nobr> flag instead of any in the configuration file.
If you want to run the combined set of additional queries specified with the flag and in the configuration file, prefix the value passed to <nobr>`--queries`</nobr> with the `+` symbol.
For more information, see "[Using a custom configuration file](#using-a-custom-configuration-file)."
Si también usa un archivo de configuración para los valores personalizados y además especifica consultas adicionales con la marca `--queries`, {% data variables.product.prodname_codeql_runner %} utilizará las consultas adicionales especificadas con la marca <nobr>`--queries`</nobr> en lugar de las del archivo de configuración.
Si quiere ejecutar el conjunto combinado de consultas adicionales especificadas con la marca y en el archivo de configuración, use el símbolo`+` como prefijo del valor que se pasa a <nobr>`--queries`</nobr>.
Para más información, vea "[Uso de un archivo de configuración personalizado](#using-a-custom-configuration-file)".
In the following example, the `+` symbol ensures that the {% data variables.product.prodname_codeql_runner %} uses the additional queries together with any queries specified in the referenced configuration file.
En el ejemplo siguiente, el símbolo `+` garantiza que el {% data variables.product.prodname_codeql_runner %} use las consultas adicionales junto con cualquier otra que se especifique en el archivo de configuración al que se hace referencia.
```shell
$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml
--queries +security-and-quality,octo-org/python-qlpack/show_ifs.ql@main
```
## Using a custom configuration file
## Uso de un archivo de configuración personalizado
Instead of passing additional information to the {% data variables.product.prodname_codeql_runner %} commands, you can specify custom settings in a separate configuration file.
En vez de pasar información adicional a los comandos de {% data variables.product.prodname_codeql_runner %}, puedes especificar ajustes personalizados en un archivo de configuración por separado.
The configuration file is a YAML file. It uses syntax similar to the workflow syntax for {% data variables.product.prodname_actions %}, as illustrated in the examples below. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)."
El archivo de configuración es un archivo de YAML. Utiliza una sintaxis similar a aquella del flujo de trabajo para {% data variables.product.prodname_actions %}, de acuerdo como se ilustra en los siguientes ejemplos. Para más información, vea "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions)".
Use the `--config-file` flag of the `init` command to specify the configuration file. The value of <nobr>`--config-file`</nobr> is the path to the configuration file that you want to use. This example loads the configuration file _.github/codeql/codeql-config.yml_.
Use la marca `--config-file` del comando `init`para especificar el archivo de configuración. El valor <nobr>`--config-file`</nobr> es la ruta al archivo de configuración que quiere usar. En este ejemplo se carga el archivo de configuración _.github/codeql/codeql-config.yml_.
```shell
$ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-config.yml
@@ -109,108 +111,108 @@ $ /path/to-runner/codeql-runner-linux init --config-file .github/codeql/codeql-c
{% data reusables.code-scanning.custom-configuration-file %}
### Example configuration files
### Archivos de configuración de ejemplo
{% data reusables.code-scanning.example-configuration-files %}
## Configuring {% data variables.product.prodname_code_scanning %} for compiled languages
## Configurar {% data variables.product.prodname_code_scanning %} para los lenguajes compilados
For the compiled languages C/C++, C#, and Java, {% data variables.product.prodname_codeql %} builds the code before analyzing it. {% data reusables.code-scanning.analyze-go %}
Para los lenguajes C/C++, C#, y Java, {% data variables.product.prodname_codeql %} compila el código antes de analizarlo. {% data reusables.code-scanning.analyze-go %}
For many common build systems, the {% data variables.product.prodname_codeql_runner %} can build the code automatically. To attempt to build the code automatically, run `autobuild` between the `init` and `analyze` steps. Note that if your repository requires a specific version of a build tool, you may need to install the build tool manually first.
Para varios sistemas de compilación comunes, el {% data variables.product.prodname_codeql_runner %} puede compilar el código automáticamente. Para intentar compilar el código automáticamente, ejecute `autobuild` entre los pasos `init` y `analyze`. Nota que, si tu repositorio necesita una versión específica de una herramienta de compilación, puede que necesites instalar dicha herramienta manualmente primero.
The `autobuild` process only ever attempts to build _one_ compiled language for a repository. The language automatically selected for analysis is the language with the most files. If you want to choose a language explicitly, use the `--language` flag of the `autobuild` command.
El proceso `autobuild` solo intenta crear _un_ lenguaje compilado para un repositorio. El lenguaje que se selecciona automáticamente para su análisis es aquél presente en más archivos. Si quiere elegir un lenguaje de forma explícita, use la marca `--language` del comando `autobuild`.
```shell
$ /path/to-runner/codeql-runner-linux autobuild --language csharp
```
If the `autobuild` command can't build your code, you can run the build steps yourself, between the `init` and `analyze` steps. For more information, see "[Running {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/running-codeql-runner-in-your-ci-system#compiled-language-example)."
Si el comando `autobuild` no puede compilar el código, puede ejecutar los pasos de compilación personalmente, entre los pasos `init` y `analyze`. Para más información, vea "[Ejecución de {% data variables.product.prodname_codeql_runner %} en el sistema de CI](/code-security/secure-coding/running-codeql-runner-in-your-ci-system#compiled-language-example)".
## Uploading {% data variables.product.prodname_code_scanning %} data to {% data variables.product.prodname_dotcom %}
## Carga de datos de {% data variables.product.prodname_code_scanning %} en {% data variables.product.prodname_dotcom %}
By default, the {% data variables.product.prodname_codeql_runner %} uploads results from {% data variables.product.prodname_code_scanning %} when you run the `analyze` command. You can also upload SARIF files separately, by using the `upload` command.
De manera predeterminada, {% data variables.product.prodname_codeql_runner %} carga los resultados de {% data variables.product.prodname_code_scanning %} al ejecutar el comando `analyze`. También puede cargar archivos SARIF por separado mediante el comando `upload`.
Once you've uploaded the data, {% data variables.product.prodname_dotcom %} displays the alerts in your repository.
- If you uploaded to a pull request, for example `--ref refs/pull/42/merge` or `--ref refs/pull/42/head`, then the results appear as alerts in a pull request check. For more information, see "[Triaging code scanning alerts in pull requests](/code-security/secure-coding/triaging-code-scanning-alerts-in-pull-requests)."
- If you uploaded to a branch, for example `--ref refs/heads/my-branch`, then the results appear in the **Security** tab for your repository. For more information, see "[Managing code scanning alerts for your repository](/code-security/secure-coding/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository)."
Una vez que hayas cargado los datos, {% data variables.product.prodname_dotcom %} mostrará las alertas en tu repositorio.
- Si ha realizado la carga en una solicitud de incorporación de cambios, por ejemplo `--ref refs/pull/42/merge` o `--ref refs/pull/42/head`, los resultados aparecen como alertas en una comprobación de solicitud de incorporación de cambios. Para más información, vea "[Evaluación de prioridades de alertas de análisis de código en solicitudes de incorporación de cambios](/code-security/secure-coding/triaging-code-scanning-alerts-in-pull-requests)".
- Si ha realizado la carga en una rama, por ejemplo `--ref refs/heads/my-branch`, los resultados aparecen en la pestaña **Seguridad** del repositorio. Para más información, vea "[Administración de alertas de análisis de código para el repositorio](/code-security/secure-coding/managing-code-scanning-alerts-for-your-repository#viewing-the-alerts-for-a-repository)".
## {% data variables.product.prodname_codeql_runner %} command reference
## Referencia de comandos de {% data variables.product.prodname_codeql_runner %}
The {% data variables.product.prodname_codeql_runner %} supports the following commands and flags.
El {% data variables.product.prodname_codeql_runner %} es compatible con los siguientes comandos y marcadores.
### `init`
Initializes the {% data variables.product.prodname_codeql_runner %} and creates a {% data variables.product.prodname_codeql %} database for each language to be analyzed.
Inicializa el {% data variables.product.prodname_codeql_runner %} y crea una base de datos de {% data variables.product.prodname_codeql %} para analizar cada lenguaje.
| Flag | Required | Input value |
| Marca | Obligatorio | Valor de entrada |
| ---- |:--------:| ----------- |
| `--repository` | ✓ | Name of the repository to initialize. |
| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. |
| <nobr>`--github-auth-stdin`</nobr> | ✓ | Read the {% data variables.product.prodname_github_apps %} token or personal access token from standard input. |
| `--languages` | | Comma-separated list of languages to analyze. By default, the {% data variables.product.prodname_codeql_runner %} detects and analyzes all supported languages in the repository. |
| `--queries` | | Comma-separated list of additional queries to run, in addition to the default suite of security queries. This overrides the `queries` setting in the custom configuration file. |
| `--config-file` | | Path to custom configuration file. |
| `--codeql-path` | | Path to a copy of the {% data variables.product.prodname_codeql %} CLI executable to use. By default, the {% data variables.product.prodname_codeql_runner %} downloads a copy. |
| `--temp-dir` | | Directory where temporary files are stored. The default is `./codeql-runner`. |
| `--tools-dir` | | Directory where {% data variables.product.prodname_codeql %} tools and other files are stored between runs. The default is a subdirectory of the home directory. |
| <nobr>`--checkout-path`</nobr> | | The path to the checkout of your repository. The default is the current working directory. |
| `--debug` | | None. Prints more verbose output. |
| <nobr>`--trace-process-name`</nobr> | | Advanced, Windows only. Name of the process where a Windows tracer of this process is injected. |
| <nobr>`--trace-process-level`</nobr> | | Advanced, Windows only. Number of levels up of the parent process where a Windows tracer of this process is injected. |
| `-h`, `--help` | | None. Displays help for the command. |
| `--repository` | ✓ | Nombre del repositorio a inicializar. |
| `--github-url` | ✓ | URL de la instancia de {% data variables.product.prodname_dotcom %} donde se hospeda tu repositorio. |
| <nobr>`--github-auth-stdin`</nobr> | ✓ | Lee el token de las {% data variables.product.prodname_github_apps %} o token de acceso personal desde la entrada estándar. |
| `--languages` | | Lista separada por comas de los lenguajes a analizar. Predeterminadamente, el {% data variables.product.prodname_codeql_runner %} detecta y analiza todos los lenguajes compatibles en el repositorio. |
| `--queries` | | Lista separada por comas de las consultas adicionales a ejecutar, adicionalmente a la suite predeterminada de consultas de seguridad. Esto invalida el valor `queries` en el archivo de configuración personalizado. |
| `--config-file` | | Ruta al archivo de configuración personalizado. |
| `--codeql-path` | | Ruta a una copia del CLI ejecutable de {% data variables.product.prodname_codeql %} a utilizar. Predeterminadamente, el {% data variables.product.prodname_codeql_runner %} descarga una copia. |
| `--temp-dir` | | Directorio donde se almacenan los archivos temporales. El valor predeterminado es `./codeql-runner`. |
| `--tools-dir` | | Directorio donde las herramientas de {% data variables.product.prodname_codeql %} y otros archivos se almacenan entre ejecuciones. El predeterminado es un subdirectorio del directorio principal. |
| <nobr>`--checkout-path`</nobr> | | La ruta a la confirmación de salida de tu repositorio. El predeterminado es el directorio de trabajo. |
| `--debug` | | Ninguno. Imprime una salida más verbosa. |
| <nobr>`--trace-process-name`</nobr> | | Avanzado y solo para Windows. Nombre del proceso en donde se inyecta un rastreador de Windows para este proceso. |
| <nobr>`--trace-process-level`</nobr> | | Avanzado y solo para Windows. Cantidad de niveles ascendentes del proceso padre en donde se inyecta un rastreador de Windows para este proceso. |
| `-h`, `--help` | | Ninguno. Muestra la ayuda para el comando. |
### `autobuild`
Attempts to build the code for the compiled languages C/C++, C#, and Java. For those languages, {% data variables.product.prodname_codeql %} builds the code before analyzing it. Run `autobuild` between the `init` and `analyze` steps.
Intenta compilar el código para los lenguajes compilados de C/C++, C#, y Java. Para estos lenguajes, {% data variables.product.prodname_codeql %} compila el código antes de analizarlo. Ejecute `autobuild` entre los pasos `init` y `analyze`.
| Flag | Required | Input value |
| Marca | Obligatorio | Valor de entrada |
| ---- |:--------:| ----------- |
| `--language` | | The language to build. By default, the {% data variables.product.prodname_codeql_runner %} builds the compiled language with the most files. |
| <nobr>`--temp-dir`</nobr> | | Directory where temporary files are stored. The default is `./codeql-runner`. |
| `--debug` | | None. Prints more verbose output. |
| <nobr> `-h`, `--help`</nobr> | | None. Displays help for the command. |
| `--language` | | El lenguaje a compilar. Predeterminadamente, el {% data variables.product.prodname_codeql_runner %} compila el lenguaje con más archivos. |
| <nobr>`--temp-dir`</nobr> | | Directorio donde se almacenan los archivos temporales. El valor predeterminado es `./codeql-runner`. |
| `--debug` | | Ninguno. Imprime una salida más verbosa. |
| <nobr> `-h`, `--help`</nobr> | | Ninguno. Muestra la ayuda para el comando. |
### `analyze`
Analyzes the code in the {% data variables.product.prodname_codeql %} databases and uploads results to {% data variables.product.product_name %}.
Analiza el código en las bases de datos de {% data variables.product.prodname_codeql %} y carga los resultados a {% data variables.product.product_name %}.
| Flag | Required | Input value |
| Marca | Obligatorio | Valor de entrada |
| ---- |:--------:| ----------- |
| `--repository` | ✓ | Name of the repository to analyze. |
| `--commit` | ✓ | SHA of the commit to analyze. In Git and in Azure DevOps, this corresponds to the value of `git rev-parse HEAD`. In Jenkins, this corresponds to `$GIT_COMMIT`. |
| `--ref` | ✓ | Name of the reference to analyze, for example `refs/heads/main` or `refs/pull/42/merge`. In Git or in Jenkins, this corresponds to the value of `git symbolic-ref HEAD`. In Azure DevOps, this corresponds to `$(Build.SourceBranch)`. |
| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. |
| <nobr>`--github-auth-stdin`</nobr> | ✓ | Read the {% data variables.product.prodname_github_apps %} token or personal access token from standard input. |
| <nobr>`--checkout-path`</nobr> | | The path to the checkout of your repository. The default is the current working directory. |
| `--no-upload` | | None. Stops the {% data variables.product.prodname_codeql_runner %} from uploading the results to {% data variables.product.product_name %}. |
| `--output-dir` | | Directory where the output SARIF files are stored. The default is in the directory of temporary files. |
| `--ram` | | Amount of memory to use when running queries. The default is to use all available memory. |
| <nobr>`--no-add-snippets`</nobr> | | None. Excludes code snippets from the SARIF output. |
| <nobr>`--category`<nobr> | | Category to include in the SARIF results file for this analysis. A category can be used to distinguish multiple analyses for the same tool and commit, but performed on different languages or different parts of the code. This value will appear in the `<run>.automationDetails.id` property in SARIF v2.1.0. |
| `--threads` | | Number of threads to use when running queries. The default is to use all available cores. |
| `--temp-dir` | | Directory where temporary files are stored. The default is `./codeql-runner`. |
| `--debug` | | None. Prints more verbose output. |
| `-h`, `--help` | | None. Displays help for the command. |
| `--repository` | ✓ | Nombre del repositorio que se analizará. |
| `--commit` | ✓ | SHA de la confirmación que se analizará. En Git y en Azure DevOps, esto se corresponde al valor de `git rev-parse HEAD`. En Jenkins, esto se corresponde a `$GIT_COMMIT`. |
| `--ref` | ✓ | Nombre de la referencia que se va a analizar, por ejemplo `refs/heads/main` o `refs/pull/42/merge`. En Git o en Jenkins, esto se corresponde al valor de `git symbolic-ref HEAD`. En Azure DevOps, esto se corresponde a `$(Build.SourceBranch)`. |
| `--github-url` | ✓ | URL de la instancia de {% data variables.product.prodname_dotcom %} donde se hospeda tu repositorio. |
| <nobr>`--github-auth-stdin`</nobr> | ✓ | Lee el token de las {% data variables.product.prodname_github_apps %} o token de acceso personal desde la entrada estándar. |
| <nobr>`--checkout-path`</nobr> | | La ruta a la confirmación de salida de tu repositorio. El predeterminado es el directorio de trabajo. |
| `--no-upload` | | Ninguno. Impide que {% data variables.product.prodname_codeql_runner %} cargue los resultados a {% data variables.product.product_name %}. |
| `--output-dir` | | Directorio en donde se almacenan los archivos SARIF de salida. El predeterminado está en el directorio de archivos temporales. |
| `--ram` | | Cantidad de memoria a utilizar cuando ejecutes consultas. El valor predeterminado es utilizar toda la memoria disponible. |
| <nobr>`--no-add-snippets`</nobr> | | Ninguno. Excluye los fragmentos de código de la salida de SARIF. |
| <nobr>`--category`<nobr> | | Categoría para incluir el archivo de resultados SARIF para este análisis. La categoría puede utilizarse pra distinguir análisis múltiples de la misma herramienta y confirmación, pero que se llevan a cabo en lenguajes diferentes o en partes diferentes del código. Este valor aparecerá en la propiedad `<run>.automationDetails.id` de SARIF v2.1.0. |
| `--threads` | | Cantidad de hilos a utilizar cuando se ejecutan las consultas. El valor predeterminado es utilizar todos los núcleos disponibles. |
| `--temp-dir` | | Directorio donde se almacenan los archivos temporales. El valor predeterminado es `./codeql-runner`. |
| `--debug` | | Ninguno. Imprime una salida más verbosa. |
| `-h`, `--help` | | Ninguno. Muestra la ayuda para el comando. |
### `upload`
Uploads SARIF files to {% data variables.product.product_name %}.
Carga los archivos SARIF a {% data variables.product.product_name %}.
{% note %}
**Note**: If you analyze code with the CodeQL runner, the `analyze` command uploads SARIF results by default. You can use the `upload` command to upload SARIF results that were generated by other tools.
**Nota**: Si analiza código con el ejecutor de CodeQL, el comando `analyze` carga los resultados de SARIF de forma predeterminada. Puede usar el comando `upload` para cargar los resultados SARIF que han generado otras herramientas.
{% endnote %}
| Flag | Required | Input value |
| Marca | Obligatorio | Valor de entrada |
| ---- |:--------:| ----------- |
| `--sarif-file` | ✓ | SARIF file to upload, or a directory containing multiple SARIF files. |
| `--repository` | ✓ | Name of the repository that was analyzed. |
| `--commit` | ✓ | SHA of the commit that was analyzed. In Git and in Azure DevOps, this corresponds to the value of `git rev-parse HEAD`. In Jenkins, this corresponds to `$GIT_COMMIT`. |
| `--ref` | ✓ | Name of the reference that was analyzed, for example `refs/heads/main` or `refs/pull/42/merge`. In Git or in Jenkins, this corresponds to the value of `git symbolic-ref HEAD`. In Azure DevOps, this corresponds to `$(Build.SourceBranch)`. |
| `--github-url` | ✓ | URL of the {% data variables.product.prodname_dotcom %} instance where your repository is hosted. |
| <nobr>`--github-auth-stdin`</nobr> | ✓ | Read the {% data variables.product.prodname_github_apps %} token or personal access token from standard input. |
| <nobr>`--checkout-path`</nobr> | | The path to the checkout of your repository. The default is the current working directory. |
| `--debug` | | None. Prints more verbose output. |
| `-h`, `--help` | | None. Displays help for the command. |
| `--sarif-file` | ✓ | El archivo SARIF a cargar, o un directorio que contiene varios archivos SARIF. |
| `--repository` | ✓ | Nombre del repositorio que se analizó. |
| `--commit` | ✓ | SHA de la confirmación que se analizó. En Git y en Azure DevOps, esto se corresponde al valor de `git rev-parse HEAD`. En Jenkins, esto se corresponde a `$GIT_COMMIT`. |
| `--ref` | ✓ | Nombre de la referencia que se ha analizado, por ejemplo `refs/heads/main` o `refs/pull/42/merge`. En Git o en Jenkins, esto se corresponde al valor de `git symbolic-ref HEAD`. En Azure DevOps, esto se corresponde a `$(Build.SourceBranch)`. |
| `--github-url` | ✓ | URL de la instancia de {% data variables.product.prodname_dotcom %} donde se hospeda tu repositorio. |
| <nobr>`--github-auth-stdin`</nobr> | ✓ | Lee el token de las {% data variables.product.prodname_github_apps %} o token de acceso personal desde la entrada estándar. |
| <nobr>`--checkout-path`</nobr> | | La ruta a la confirmación de salida de tu repositorio. El predeterminado es el directorio de trabajo. |
| `--debug` | | Ninguno. Imprime una salida más verbosa. |
| `-h`, `--help` | | Ninguno. Muestra la ayuda para el comando. |

61
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md
View File

@@ -1,7 +1,7 @@
---
title: Installing CodeQL CLI in your CI system
title: Instalar el CLI de CodeQL en tu sistema de IC
shortTitle: Install CodeQL CLI
intro: 'You can install the {% data variables.product.prodname_codeql_cli %} and use it to perform {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in a third-party continuous integration system.'
intro: 'Puedes instalar el {% data variables.product.prodname_codeql_cli %} y utilizarlo para llevar a cabo el {% data variables.product.prodname_code_scanning %} de {% data variables.product.prodname_codeql %} en un sistema de integración contínua de terceros.'
product: '{% data reusables.gated-features.code-scanning %}'
miniTocMaxHeadingLevel: 3
versions:
@@ -23,61 +23,66 @@ redirect_from:
- /code-security/secure-coding/running-codeql-cli-in-your-ci-system
- /code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-cli-in-your-ci-system
- /code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system
ms.openlocfilehash: 3d7c7dc3451b844b33fe0b14fd07f9a18ec81b10
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147052084'
---
{% data reusables.code-scanning.enterprise-enable-code-scanning %}
## About using the {% data variables.product.prodname_codeql_cli %} for {% data variables.product.prodname_code_scanning %}
## Acerca de utilizar el {% data variables.product.prodname_codeql_cli %} para el {% data variables.product.prodname_code_scanning %}
You can use the {% data variables.product.prodname_codeql_cli %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. {% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)." For recommended specifications (RAM, CPU cores, and disk) for running {% data variables.product.prodname_codeql %} analysis, see "[Recommended hardware resources for running {% data variables.product.prodname_codeql %}](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql)."
Puedes usar la {% data variables.product.prodname_codeql_cli %} para ejecutar {% data variables.product.prodname_code_scanning %} en el código que estás procesando en un sistema de integración continua (CI) de terceros. {% data reusables.code-scanning.about-code-scanning %} Para obtener información, consulta "[Acerca de {% data variables.product.prodname_code_scanning %} con {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)". Para obtener especificaciones recomendadas (RAM, núcleos de CPU y disco) para ejecutar el análisis de {% data variables.product.prodname_codeql %}, consulta "[Recursos de hardware recomendados para ejecutar {% data variables.product.prodname_codeql %}](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql)".
{% data reusables.code-scanning.what-is-codeql-cli %}
Alternatively, you can use {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_name %}. For information about {% data variables.product.prodname_code_scanning %} using actions, see "[Setting up {% data variables.product.prodname_code_scanning %} for a repository](/code-security/secure-coding/setting-up-code-scanning-for-a-repository)." For an overview of the options for CI systems, see "[About CodeQL {% data variables.product.prodname_code_scanning %} in your CI system](/code-security/secure-coding/about-codeql-code-scanning-in-your-ci-system)".
Como alternativa, puedes utilizar las {% data variables.product.prodname_actions %} en tu sistema de IC, o al {% data variables.product.prodname_code_scanning %} dentro de {% data variables.product.product_name %}. Para obtener información sobre {% data variables.product.prodname_code_scanning %} mediante acciones, consulta "[Configuración de {% data variables.product.prodname_code_scanning %} para un repositorio](/code-security/secure-coding/setting-up-code-scanning-for-a-repository)". Para obtener información general sobre las opciones de los sistemas de CI, consulta "[Acerca del {% data variables.product.prodname_code_scanning %} de CodeQL en el sistema de CI](/code-security/secure-coding/about-codeql-code-scanning-in-your-ci-system)".
{% data reusables.code-scanning.licensing-note %}
## Downloading the {% data variables.product.prodname_codeql_cli %}
## Descarga de {% data variables.product.prodname_codeql_cli %}
You should download the {% data variables.product.prodname_codeql %} bundle from https://github.com/github/codeql-action/releases. The bundle contains:
Debes descargar el conjunto de {% data variables.product.prodname_codeql %} desde https://github.com/github/codeql-action/releases. La agrupación contiene lo siguiente:
- {% data variables.product.prodname_codeql_cli %} product
- A compatible version of the queries and libraries from https://github.com/github/codeql
- Precompiled versions of all the queries included in the bundle
- El producto de {% data variables.product.prodname_codeql_cli %}
- Una versión compatible de las consultas y bibliotecas de https://github.com/github/codeql
- Versiones precompiladas de todas las consultas incluidas en la agrupación
{% ifversion ghes or ghae %}
{% note %}
For {% data variables.product.product_name %}{% ifversion ghes %} {{ allVersions[currentVersion].currentRelease }},{% endif %}, we recommend {% data variables.product.prodname_codeql_cli %} version {% data variables.product.codeql_cli_ghes_recommended_version %}.
{% note %} Para {% data variables.product.product_name %}{% ifversion ghes %} {{ allVersions[currentVersion].currentRelease }},{% endif %}, se recomienda la versión de {% data variables.product.prodname_codeql_cli %} {% data variables.product.codeql_cli_ghes_recommended_version %}.
{% endnote %}
{% endif %}
You should always use the {% data variables.product.prodname_codeql %} bundle as this ensures compatibility and also gives much better performance than a separate download of the {% data variables.product.prodname_codeql_cli %} and checkout of the {% data variables.product.prodname_codeql %} queries. If you will only be running the CLI on one specific platform, download the appropriate `codeql-bundle-PLATFORM.tar.gz` file. Alternatively, you can download `codeql-bundle.tar.gz`, which contains the CLI for all supported platforms.
Siempre debes utilizar Siempre debes utilizar el paquete de {% data variables.product.prodname_codeql %}, ya que este garantiza la compatibilidad y también te da un rendimiento mucho mejor que una descarga independiente del {% data variables.product.prodname_codeql_cli %} y una verificación de las consultas de {% data variables.product.prodname_codeql %}. Si solo vas a ejecutar la CLI en una plataforma específica, descarga el archivo `codeql-bundle-PLATFORM.tar.gz` adecuado. Como alternativa, puedes descargar `codeql-bundle.tar.gz`, que contiene la CLI para todas las plataformas compatibles.
{% data reusables.code-scanning.beta-codeql-packs-cli %}
## Setting up the {% data variables.product.prodname_codeql_cli %} in your CI system
## Configurar el {% data variables.product.prodname_codeql_cli %} en tu sistema de IC
You need to make the full contents of the {% data variables.product.prodname_codeql_cli %} bundle available to every CI server that you want to run CodeQL {% data variables.product.prodname_code_scanning %} analysis on. For example, you might configure each server to copy the bundle from a central, internal location and extract it. Alternatively, you could use the REST API to get the bundle directly from {% data variables.product.prodname_dotcom %}, ensuring that you benefit from the latest improvements to queries. Updates to the {% data variables.product.prodname_codeql_cli %} are released every 2-3 weeks. For example:
Necesitas habilitar el contenido integral del paquete de {% data variables.product.prodname_codeql_cli %} para cada servidor de IC en el que quieras ejecutar el análiss del {% data variables.product.prodname_code_scanning %} de CodeQL. Por ejemplo, puedes configurar cada servidor para copiar el paquete desde una ubicación intera y centrar y extraerlo. Como alternativa, puedes utilizar la API de REST para obtener el paquete directamente desde {% data variables.product.prodname_dotcom %} para garantizar que te beneificarás de las últimas mejoras a las consultas. Las actualizaciones del {% data variables.product.prodname_codeql_cli %} se lanzan cada 2 o 3 semanas. Por ejemplo:
```shell
$ wget https://{% ifversion fpt or ghec %}github.com{% else %}<em>HOSTNAME</em>{% endif %}/github/codeql-action/releases/latest/download/codeql-bundle-linux64.tar.gz
$ tar -xvzf ./codeql-bundle-linux64.tar.gz
```
After you extract the {% data variables.product.prodname_codeql_cli %} bundle, you can run the `codeql` executable on the server:
Después de extraer el paquete de {% data variables.product.prodname_codeql_cli %}, puedes ejecutar el archivo ejecutable `codeql` en el servidor:
- By executing `/<extraction-root>/codeql/codeql`, where `<extraction-root>` is the folder where you extracted the {% data variables.product.prodname_codeql_cli %} bundle.
- By adding `/<extraction-root>/codeql` to your `PATH`, so that you can run the executable as just `codeql`.
- Ejecutando `/<extraction-root>/codeql/codeql`, donde `<extraction-root>` es la carpeta donde has extraído el paquete {% data variables.product.prodname_codeql_cli %}.
- Agregando `/<extraction-root>/codeql` a `PATH`, para poder ejecutar el archivo ejecutable simplemente como `codeql`.
## Testing the {% data variables.product.prodname_codeql_cli %} set up
## Probar la configuración del {% data variables.product.prodname_codeql_cli %}
After you extract the {% data variables.product.prodname_codeql_cli %} bundle, you can run the following command to verify that the CLI is correctly set up to create and analyze databases.
Después de que extraes el paquete de {% data variables.product.prodname_codeql_cli %}, puedes ejecutar el siguiente comando para verificar que el CLI esté configurado correctamente para crear y analizar bases de datos.
- `codeql resolve qlpacks` if `/<extraction-root>/codeql` is on the `PATH`.
- `/<extraction-root>/codeql/codeql resolve qlpacks` otherwise.
- `codeql resolve qlpacks` si `/<extraction-root>/codeql` está en `PATH`.
- En caso contrario, es `/<extraction-root>/codeql/codeql resolve qlpacks`.
**Extract from successful output:**
**Extraer desde una salida satisfactoria:**
```
codeql/cpp-all (/<extraction-root>/qlpacks/codeql/cpp-all/<version>)
codeql/cpp-examples (/<extraction-root>/qlpacks/codeql/cpp-examples/<version>)
@@ -100,12 +105,12 @@ codeql/ruby-queries (/<extraction-root>/qlpacks/codeql/ruby-queries/<version>)
...
```
You should check that the output contains the expected languages and also that the directory location for the qlpack files is correct. The location should be within the extracted {% data variables.product.prodname_codeql_cli %} bundle, shown above as `<extraction root>`, unless you are using a checkout of `github/codeql`. If the {% data variables.product.prodname_codeql_cli %} is unable to locate the qlpacks for the expected languages, check that you downloaded the {% data variables.product.prodname_codeql %} bundle and not a standalone copy of the {% data variables.product.prodname_codeql_cli %}.
Debes verificar que la salida contenga los lenguajes esperados y también que la ubicación del directorio para el archivo de qlpack sea correcta. La ubicación debe ser dentro del paquete de {% data variables.product.prodname_codeql_cli %} extraído, que se muestra anteriormente como `<extraction root>`, a menos que estés utilizando una restauración de `github/codeql`. Si el {% data variables.product.prodname_codeql_cli %} no es capaz de localizar los qlpacks para los lenguajes esperados, verifica que hayas descargado el paquete de {% data variables.product.prodname_codeql %} y no una copia independiente del {% data variables.product.prodname_codeql_cli %}.
## Generating a token for authentication with {% data variables.product.product_name %}
## Generar un token para autenticarse con {% data variables.product.product_name %}
Each CI server needs a {% data variables.product.prodname_github_app %} or personal access token for the {% data variables.product.prodname_codeql_cli %} to use to upload results to {% data variables.product.product_name %}. You must use an access token or a {% data variables.product.prodname_github_app %} with the `security_events` write permission. If CI servers already use a token with this scope to checkout repositories from {% data variables.product.product_name %}, you could potentially allow the {% data variables.product.prodname_codeql_cli %} to use the same token. Otherwise, you should create a new token with the `security_events` write permission and add this to the CI system's secret store. For information, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" and "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)."
Cada servidor de IC necesita una {% data variables.product.prodname_github_app %} o un token de acceso personal para que utilice el {% data variables.product.prodname_codeql_cli %} para cargar los resultados a {% data variables.product.product_name %}. Debes usar un token de acceso o {% data variables.product.prodname_github_app %} con el permiso de escritura `security_events`. Si los servidores de IC utilizan un token con este alcance para verificar los repositorios de {% data variables.product.product_name %}, podrías permitir potencialmente que {% data variables.product.prodname_codeql_cli %} utilice el mismo token. De lo contrario, crea un token nuevo con el permiso de escritura `security_events` y agrégalo al almacén de secretos del sistema de CI. Para obtener información, consulta "[Compilación de {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" y "[Creación de un token de acceso personal](/github/authenticating-to-github/creating-a-personal-access-token)".
## Next steps
## Pasos siguientes
You're now ready to configure the CI system to run {% data variables.product.prodname_codeql %} analysis, generate results, and upload them to {% data variables.product.product_name %} where the results will be matched to a branch or pull request and displayed as {% data variables.product.prodname_code_scanning %} alerts. For detailed information, see "[Configuring {% data variables.product.prodname_codeql_cli %} in your CI system](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system)."
Ahora estás listo para configurar el sistema de IC para que ejecute el análisis de {% data variables.product.prodname_codeql %}, genere resultados y los cargue en {% data variables.product.product_name %} donde dichos resultados se empatarán con una rama o solicitud de cambios y se mostrarán como alertas del {% data variables.product.prodname_code_scanning %}. Para obtener información detallada, consulta "[Configuración de {% data variables.product.prodname_codeql_cli %} en el sistema de CI](/code-security/secure-coding/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system)".

126
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-runner-in-your-ci-system.md
View File

@@ -1,7 +1,7 @@
---
title: Running CodeQL runner in your CI system
title: Ejecutar el ejecutor de CodeQL en tu sistema de IC
shortTitle: Run CodeQL runner
intro: 'You can use the {% data variables.product.prodname_codeql_runner %} to perform {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} in a third-party continuous integration system.'
intro: 'Puedes utilizar el {% data variables.product.prodname_codeql_runner %} para llevar a cabo el {% data variables.product.prodname_code_scanning %} de {% data variables.product.prodname_codeql %} en un sistema de integración contínua de terceros.'
product: '{% data reusables.gated-features.code-scanning %}'
redirect_from:
- /github/finding-security-vulnerabilities-and-errors-in-your-code/running-code-scanning-in-your-ci-system
@@ -24,102 +24,102 @@ topics:
- Integration
- CI
- SARIF
ms.openlocfilehash: c4803ff75aa157bc89dc2bfa776c03b3a1cf305a
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '146178683'
---
<!--UI-LINK: When GitHub Enterprise Server <=3.0 doesn't have GitHub Actions set up, the Security > Code scanning alerts view links to this article.-->
{% ifversion codeql-runner-supported %}
{% data reusables.code-scanning.deprecation-codeql-runner %}
{% data reusables.code-scanning.beta %}
{% data reusables.code-scanning.enterprise-enable-code-scanning %}
{% data reusables.code-scanning.deprecation-codeql-runner %} {% data reusables.code-scanning.beta %} {% data reusables.code-scanning.enterprise-enable-code-scanning %}
## About the {% data variables.product.prodname_codeql_runner %}
## Acerca de {% data variables.product.prodname_codeql_runner %}
The {% data variables.product.prodname_codeql_runner %} is a tool you can use to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. {% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)."
El {% data variables.product.prodname_codeql_runner %} es una herramienta que puedes utilizar para ejecutar el {% data variables.product.prodname_code_scanning %} en el código que estás procesando en un sistema de integración contínua (IC) de terceros. {% data reusables.code-scanning.about-code-scanning %} Para obtener información, consulta "[Acerca de {% data variables.product.prodname_code_scanning %} con {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)".
In many cases it is easier to set up {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} using the {% data variables.product.prodname_codeql_cli %} directly in your CI system.
En muchos casos es más fácil configurar el {% data variables.product.prodname_code_scanning %} de {% data variables.product.prodname_codeql %} utilizando el {% data variables.product.prodname_codeql_cli %} directamente en tu sistema de IC.
Alternatively, you can use {% data variables.product.prodname_actions %} to run {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_name %}. For information, see "[Setting up {% data variables.product.prodname_code_scanning %} for a repository](/code-security/secure-coding/setting-up-code-scanning-for-a-repository)."
Como alternativa, puedes utilizar las {% data variables.product.prodname_actions %} en tu sistema de IC, o al {% data variables.product.prodname_code_scanning %} dentro de {% data variables.product.product_name %}. Para obtener información, consulta "[Configuración de {% data variables.product.prodname_code_scanning %} para un repositorio](/code-security/secure-coding/setting-up-code-scanning-for-a-repository)".
The {% data variables.product.prodname_codeql_runner %} is a command-line tool that runs {% data variables.product.prodname_codeql %} analysis on a checkout of a {% data variables.product.prodname_dotcom %} repository. You add the runner to your third-party system, then call the runner to analyze code and upload the results to {% data variables.product.product_name %}. These results are displayed as {% data variables.product.prodname_code_scanning %} alerts in the repository.
El {% data variables.product.prodname_codeql_runner %} es una herramienta de línea de comandos que ejecuta un análisis de {% data variables.product.prodname_codeql %} en un control de un repositorio de {% data variables.product.prodname_dotcom %}. Puedes agregar el ejecutor a tu sistema de terceros y, luego, llamarlo para que analice el código y cargue los resultados en {% data variables.product.product_name %}. Estos resultados se muestran como alertas del {% data variables.product.prodname_code_scanning %} en el repositorio.
{% note %}
**Note:**
{% ifversion fpt or ghec %}
* The {% data variables.product.prodname_codeql_runner %} uses the {% data variables.product.prodname_codeql %} CLI to analyze code and therefore has the same license conditions. It's free to use on public repositories that are maintained on {% data variables.product.prodname_dotcom_the_website %}, and available to use on private repositories that are owned by customers with an {% data variables.product.prodname_advanced_security %} license. For information, see "[{% data variables.product.product_name %} {% data variables.product.prodname_codeql %} Terms and Conditions](https://securitylab.github.com/tools/codeql/license)" and "[{% data variables.product.prodname_codeql %} CLI](https://codeql.github.com/docs/codeql-cli/)."
**Nota**: {% ifversion fpt or ghec %}
* El {% data variables.product.prodname_codeql_runner %} utiliza el CLI de {% data variables.product.prodname_codeql %} para analizar el código y, por lo tanto, tiene las mismas condiciones de licencia. Se puede utilizar gratuitamente en los repositorios que mantiene {% data variables.product.prodname_dotcom_the_website %}, y está disponible para utilizarse en aquellos que pertenecen a los clientes con una licencia de {% data variables.product.prodname_advanced_security %}. Para obtener información, vea "[Términos y condiciones de {% data variables.product.product_name %} {% data variables.product.prodname_codeql %}](https://securitylab.github.com/tools/codeql/license)" y "[CLI de {% data variables.product.prodname_codeql %}](https://codeql.github.com/docs/codeql-cli/)".
{% else %}
* The {% data variables.product.prodname_codeql_runner %} is available to customers with an {% data variables.product.prodname_advanced_security %} license.
{% endif %}
{% ifversion ghae %}
* The {% data variables.product.prodname_codeql_runner %} shouldn't be confused with the {% data variables.product.prodname_codeql %} CLI. The {% data variables.product.prodname_codeql %} CLI is a command-line interface that lets you create {% data variables.product.prodname_codeql %} databases for security research and run {% data variables.product.prodname_codeql %} queries.
For more information, see "[{% data variables.product.prodname_codeql_cli %}](https://codeql.github.com/docs/codeql-cli/)."
{% endif %}
{% endnote %}
* El {% data variables.product.prodname_codeql_runner %} se encuentra disponible para los clientes con una licencia de {% data variables.product.prodname_advanced_security %}.
{% endif %} {% ifversion ghae %}
* El {% data variables.product.prodname_codeql_runner %} no debe confundirse con el CLI de {% data variables.product.prodname_codeql %}. El CLI de {% data variables.product.prodname_codeql %} es una interface de línea de comandos que te permite crear bases de datos de {% data variables.product.prodname_codeql %} para investigaciones de seguridad y ejecutar consultas de{% data variables.product.prodname_codeql %}.
Para obtener más información, consulta "[{% data variables.product.prodname_codeql_cli %}](https://codeql.github.com/docs/codeql-cli/)".
{% endif %} {% endnote %}
## Downloading the {% data variables.product.prodname_codeql_runner %}
## Descargar el {% data variables.product.prodname_codeql_runner %}
You can download the {% data variables.product.prodname_codeql_runner %} from https://{% ifversion fpt or ghec %}github.com{% else %}<em>HOSTNAME</em>{% endif %}/github/codeql-action/releases. On some operating systems, you may need to change permissions for the downloaded file before you can run it.
Puedes descargar {% data variables.product.prodname_codeql_runner %} desde https://{% ifversion fpt or ghec %}github.com{% else %}<em>HOSTNAME</em>{% endif %}/github/codeql-action/releases. En algunos sistemas operativos, puede que necesites cambiar permisos para el archivo de descarga antes de que lo puedas ejecutar.
On Linux:
En Linux:
```shell
chmod +x codeql-runner-linux
```
On macOS:
En macOS:
```shell
chmod +x codeql-runner-macos
sudo xattr -d com.apple.quarantine codeql-runner-macos
```
On Windows, the `codeql-runner-win.exe` file usually requires no change to permissions.
En Windows, el archivo `codeql-runner-win.exe` normalmente no requiere ningún cambio en los permisos.
## Adding the {% data variables.product.prodname_codeql_runner %} to your CI system
## Agregar el {% data variables.product.prodname_codeql_runner %} a tu sistema de IC
Once you download the {% data variables.product.prodname_codeql_runner %} and verify that it can be executed, you should make the runner available to each CI server that you intend to use for {% data variables.product.prodname_code_scanning %}. For example, you might configure each server to copy the runner from a central, internal location. Alternatively, you could use the REST API to get the runner directly from {% data variables.product.prodname_dotcom %}, for example:
Una vez que descargas el {% data variables.product.prodname_codeql_runner %} y verificas que puede ejecutarse, debes poner el ejecutor disponible para cada servidor de IC que pretendas utilizar para el {% data variables.product.prodname_code_scanning %}. Por ejemplo, podrías configurar cada servidor para que copie el ejecutor desde una ubicación interna y central. Como alternativa, puedes utilizar la API de REST para obtener el ejecutor directamente de {% data variables.product.prodname_dotcom %}, por ejemplo:
```shell
wget https://{% ifversion fpt or ghec %}github.com{% else %}<em>HOSTNAME</em>{% endif %}/github/codeql-action/releases/latest/download/codeql-runner-linux
chmod +x codeql-runner-linux
```
In addition to this, each CI server also needs:
Además, cada servidor de IC necesitará también:
- A {% data variables.product.prodname_github_app %} or personal access token for the {% data variables.product.prodname_codeql_runner %} to use. You must use an access token with the `repo` scope, or a {% data variables.product.prodname_github_app %} with the `security_events` write permission, and `metadata` and `contents` read permissions. For information, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" and "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)."
- Access to the {% data variables.product.prodname_codeql %} bundle associated with this release of the {% data variables.product.prodname_codeql_runner %}. This package contains queries and libraries needed for {% data variables.product.prodname_codeql %} analysis, plus the {% data variables.product.prodname_codeql %} CLI, which is used internally by the runner. For information, see "[{% data variables.product.prodname_codeql %} CLI](https://codeql.github.com/docs/codeql-cli/)."
- Un token de {% data variables.product.prodname_github_app %} o de acceso personal para que lo use el {% data variables.product.prodname_codeql_runner %}. Debes usar un token de acceso con el ámbito `repo` o una {% data variables.product.prodname_github_app %} con el permiso de escritura `security_events` y los permisos de lectura `metadata` y `contents`. Para obtener información, consulta "[Compilación de {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" y "[Creación de un token de acceso personal](/github/authenticating-to-github/creating-a-personal-access-token)".
- Acceso al paquete de {% data variables.product.prodname_codeql %} asociado con este lanzamiento del {% data variables.product.prodname_codeql_runner %}. Este paquete contiene consultas y bibliotecas necesarias para el análisis de {% data variables.product.prodname_codeql %}, adicionado con el CLI de {% data variables.product.prodname_codeql %}, el cual utiliza internamente el ejecutor. Para obtener información, consulta "[CLI de {% data variables.product.prodname_codeql %}](https://codeql.github.com/docs/codeql-cli/)".
The options for providing access to the {% data variables.product.prodname_codeql %} bundle are:
Las opciones para proporcionar acceso al paquete de {% data variables.product.prodname_codeql %} son:
1. Allow the CI servers access to https://{% ifversion fpt or ghec %}github.com{% else %}<em>HOSTNAME</em>{% endif %}/github/codeql-action so that the {% data variables.product.prodname_codeql_runner %} can download the bundle automatically.
1. Manually download/extract the bundle, store it with other central resources, and use the <nobr>`--codeql-path`</nobr> flag to specify the location of the bundle in calls to initialize the {% data variables.product.prodname_codeql_runner %}.
1. Permitir que los servidores de CI accedan a https://{% ifversion fpt or ghec %}github.com{% else %}<em>HOSTNAME</em>{% endif %}/github/codeql-action para que el {% data variables.product.prodname_codeql_runner %} pueda descargar el paquete automáticamente.
1. Descargar o extraer el paquete manualmente, almacenarlo con otros recursos centrales y usar la marca <nobr>`--codeql-path`</nobr> para especificar la ubicación del paquete en las llamadas para inicializar el {% data variables.product.prodname_codeql_runner %}.
## Calling the {% data variables.product.prodname_codeql_runner %}
## Llamar al {% data variables.product.prodname_codeql_runner %}
You should call the {% data variables.product.prodname_codeql_runner %} from the checkout location of the repository you want to analyze. The two main commands are:
Debes llamar al {% data variables.product.prodname_codeql_runner %} desde la ubicación de verificación del repositorio que quieres analizar. Los dos comandos principales son:
1. `init` required to initialize the runner and create a {% data variables.product.prodname_codeql %} database for each language to be analyzed. These databases are populated and analyzed by subsequent commands.
1. `analyze` required to populate the {% data variables.product.prodname_codeql %} databases, analyze them, and upload results to {% data variables.product.product_name %}.
1. `init` que se requiere para inicializar el ejecutor y para crear una base de datos de {% data variables.product.prodname_codeql %} para que se analice cada lenguaje. Estas bases de datos se llenan y analizan mediante comandos subsecuentes.
1. `analyze` que se requiere para rellenar las bases de datos de {% data variables.product.prodname_codeql %}, analizarlas y cargar los resultados en {% data variables.product.product_name %}.
For both commands, you must specify the URL of {% data variables.product.product_name %}, the repository *OWNER/NAME*, and the {% data variables.product.prodname_github_apps %} or personal access token to use for authentication. You also need to specify the location of the CodeQL bundle, unless the CI server has access to download it directly from the `github/codeql-action` repository.
Para ambos comandos, debes especificar la URL de {% data variables.product.product_name %}, el *PROPIETARIO/NOMBRE* del repositorio y el token de {% data variables.product.prodname_github_apps %} o de acceso personal que se usará para la autenticación. También necesitas especificar la ubicación del paquete de CodeQL, a menos de que el servidor de CI tenga acceso para descargarlo directamente del repositorio de `github/codeql-action`.
You can configure where the {% data variables.product.prodname_codeql_runner %} stores the CodeQL bundle for future analysis on a server using the <nobr>`--tools-dir`</nobr> flag and where it stores temporary files during analysis using <nobr>`--temp-dir`</nobr>.
Puedes configurar en qué lugar el {% data variables.product.prodname_codeql_runner %} almacena la agrupación de CodeQL para el análisis futuro en un servidor mediante la marca <nobr>`--tools-dir`</nobr> y dónde almacena los archivos temporales durante el análisis mediante <nobr>`--temp-dir`</nobr>.
To view the command-line reference for the runner, use the `-h` flag. For example, to list all commands run: `codeql-runner-OS -h`, or to list all the flags available for the `init` command run: `codeql-runner-OS init -h` (where `OS` varies according to the executable that you are using). For more information, see "[Configuring {% data variables.product.prodname_code_scanning %} in your CI system](/code-security/secure-coding/configuring-codeql-runner-in-your-ci-system#codeql-runner-command-reference)."
Para ver la referencia de línea de comandos para el ejecutor, usa la marca `-h`. Por ejemplo, para enumerar todos los comandos ejecuta `codeql-runner-OS -h`, o bien para enumerar todas las marcas disponibles para el comando `init` ejecuta `codeql-runner-OS init -h` (donde `OS` varía según el ejecutable que se use). Para obtener más información, consulta "[Configuración de {% data variables.product.prodname_code_scanning %} en el sistema de CI](/code-security/secure-coding/configuring-codeql-runner-in-your-ci-system#codeql-runner-command-reference)".
{% data reusables.code-scanning.upload-sarif-alert-limit %}
### Basic example
### Ejemplo básico
This example runs {% data variables.product.prodname_codeql %} analysis on a Linux CI server for the `octo-org/example-repo` repository hosted on `{% data variables.command_line.git_url_example %}`. The process is very simple because the repository contains only languages that can be analyzed by {% data variables.product.prodname_codeql %} directly, without being built (that is, Go, JavaScript, Python, and TypeScript).
En este ejemplo se ejecuta el análisis de {% data variables.product.prodname_codeql %} en un servidor de CI de Linux para el repositorio `octo-org/example-repo` hospedado en `{% data variables.command_line.git_url_example %}`. El proceso es muy simple, ya que el repositorio contiene únicamente los lenguajes que puede analizar {% data variables.product.prodname_codeql %} directamente, sin que se tenga que compilar (es decir, Go, JavaScript, Python, y TypeScript).
In this example, the server has access to download the {% data variables.product.prodname_codeql %} bundle directly from the `github/codeql-action` repository, so there is no need to use the `--codeql-path` flag.
En este ejemplo, el servidor tiene acceso para descargar la agrupación {% data variables.product.prodname_codeql %} directamente desde el repositorio `github/codeql-action`, así que no hay necesidad de usar la marca `--codeql-path`.
1. Check out the repository to analyze.
1. Move into the directory where the repository is checked out.
1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected.
1. Verifica el repositorio a analizar.
1. Posiciónate en el directorio donde se seleccionó el repositorio.
1. Inicializa el {% data variables.product.prodname_codeql_runner %} y crea bases de datos de {% data variables.product.prodname_codeql %} para los lenguajes detectados.
```shell
$ echo "$TOKEN" | /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo
@@ -131,13 +131,13 @@ In this example, the server has access to download the {% data variables.product
{% data reusables.code-scanning.codeql-runner-analyze-example %}
### Compiled language example
### Ejemplo de lenguaje compilado
This example is similar to the previous example, however this time the repository has code in C/C++, C#, or Java. To create a {% data variables.product.prodname_codeql %} database for these languages, the CLI needs to monitor the build. At the end of the initialization process, the runner reports the command you need to set up the environment before building the code. You need to run this command, before calling the normal CI build process, and then running the `analyze` command.
Este ejemplo es similar al anterior, sin embargo, esta vez el repositorio tiene código en C/C++, C#, o Java. Para crear una base de datos de {% data variables.product.prodname_codeql %} para estos lenguajes, el CLI necesita monitorear la compilación. Al final del proceso de inicialización, el ejecutor reportará el comando que necesitas configurar en el ambiente antes de compilar el código. Necesitas ejecutar este comando antes de llamar al proceso normal de compilación de CI y ejecutar el comando `analyze`.
1. Check out the repository to analyze.
1. Move into the directory where the repository is checked out.
1. Initialize the {% data variables.product.prodname_codeql_runner %} and create {% data variables.product.prodname_codeql %} databases for the languages detected.
1. Verifica el repositorio a analizar.
1. Posiciónate en el directorio donde se seleccionó el repositorio.
1. Inicializa el {% data variables.product.prodname_codeql_runner %} y crea bases de datos de {% data variables.product.prodname_codeql %} para los lenguajes detectados.
```shell
$ echo "$TOKEN" | /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo-2
--github-url {% data variables.command_line.git_url_example %} --github-auth-stdin
@@ -148,37 +148,37 @@ This example is similar to the previous example, however this time the repositor
Please export these variables to future processes so that CodeQL can monitor the build, for example by running
". /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh".
```
1. Source the script generated by the `init` action to set up the environment to monitor the build. Note the leading dot and space in the following code snippet.
1. Proporciona el script que generó la acción `init` a fin de configurar el entorno para supervisar la compilación. Toma en cuenta el primer punto y espacio en el siguiente extracto de código.
```shell
$ . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh
```
1. Build the code. On macOS, you need to prefix the build command with the environment variable `$CODEQL_RUNNER`. For more information, see "[Troubleshooting {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/troubleshooting-codeql-runner-in-your-ci-system#no-code-found-during-the-build)."
1. Compilación del código. En macOS, necesitarás agregar un prefijo al comando de compilación con la variable de entorno `$CODEQL_RUNNER`. Para obtener más información, consulta "[Solución de problemas de {% data variables.product.prodname_codeql_runner %} en el sistema de CI](/code-security/secure-coding/troubleshooting-codeql-runner-in-your-ci-system#no-code-found-during-the-build)".
{% data reusables.code-scanning.codeql-runner-analyze-example %}
{% note %}
**Note:** If you use a containerized build, you need to run the {% data variables.product.prodname_codeql_runner %} in the container where your build task takes place.
**Nota**: Si usas una compilación contenedorizada, deberás ejecutar el {% data variables.product.prodname_codeql_runner %} en el contenedor donde tiene lugar la tarea de compilación.
{% endnote %}
## Further reading
## Información adicional
- "[Configuring {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/configuring-codeql-runner-in-your-ci-system)"
- "[Troubleshooting {% data variables.product.prodname_codeql_runner %} in your CI system](/code-security/secure-coding/troubleshooting-codeql-runner-in-your-ci-system)"
- "[Configuración del {% data variables.product.prodname_codeql_runner %} en el sistema de CI](/code-security/secure-coding/configuring-codeql-runner-in-your-ci-system)"
- "[Solución de problemas del {% data variables.product.prodname_codeql_runner %} en el sistema de CI](/code-security/secure-coding/troubleshooting-codeql-runner-in-your-ci-system)"
{% else %}
## About the {% data variables.product.prodname_codeql_runner %}
## Acerca de {% data variables.product.prodname_codeql_runner %}
The {% data variables.product.prodname_codeql_runner %} has been deprecated. [{% data variables.product.prodname_codeql_cli %}](https://github.com/github/codeql-cli-binaries/releases) version 2.7.6 has complete feature parity.
El {% data variables.product.prodname_codeql_runner %} ahora es obsoleto. La versión 2.7.6 de la [{% data variables.product.prodname_codeql_cli %}](https://github.com/github/codeql-cli-binaries/releases) tiene paridad de características completa.
For information on migrating to {% data variables.product.prodname_codeql_cli %}, see "[Migrating from the CodeQL runner to CodeQL CLI](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli)."
Para obtener información sobre la migración a {% data variables.product.prodname_codeql_cli %}, vea "[Migración del ejecutor de CodeQL a la CLI de CodeQL](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli)".
## Further reading
## Información adicional
- [CodeQL runner deprecation](https://github.blog/changelog/2021-09-21-codeql-runner-deprecation/) in the GitHub Blog
- [Desuso del ejecutor de CodeQL](https://github.blog/changelog/2021-09-21-codeql-runner-deprecation/) en el blog de GitHub
{% endif %}

193
translations/es-ES/content/code-security/dependabot/dependabot-alerts/browsing-security-advisories-in-the-github-advisory-database.md
View File

@@ -1,6 +1,6 @@
---
title: Browsing security advisories in the GitHub Advisory Database
intro: 'You can browse the {% data variables.product.prodname_advisory_database %} to find advisories for security risks in open source projects that are hosted on {% data variables.product.company_short %}.'
title: Exploración de los avisos de seguridad en GitHub Advisory Database
intro: 'Puedes examinar {% data variables.product.prodname_advisory_database %} para buscar avisos relacionados con los riesgos de seguridad en proyectos de código abierto hospedados en {% data variables.product.company_short %}.'
shortTitle: Browse Advisory Database
miniTocMaxHeadingLevel: 3
redirect_from:
@@ -20,168 +20,171 @@ topics:
- Dependabot
- Vulnerabilities
- CVEs
ms.openlocfilehash: 816d610c40a7551190a510a37a88dbe3de978dac
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147783155'
---
<!--Marketing-LINK: From /features/security/software-supply-chain page "Browsing security vulnerabilities in the GitHub Advisory Database".-->
## About the {% data variables.product.prodname_advisory_database %}
## Acerca de {% data variables.product.prodname_advisory_database %}
The {% data variables.product.prodname_advisory_database %} contains a list of known security vulnerabilities {% ifversion GH-advisory-db-supports-malware %}and malware, {% endif %}grouped in two categories: {% data variables.product.company_short %}-reviewed advisories and unreviewed advisories.
{% data variables.product.prodname_advisory_database %} contiene una lista de las vulnerabilidades de seguridad {% ifversion GH-advisory-db-supports-malware %}y malware {% endif %}que se conocen, agrupados en dos categorías: avisos revisados por {% data variables.product.company_short %} y avisos sin revisar.
{% data reusables.repositories.tracks-vulnerabilities %}
## About types of security advisories
## Acerca de los tipos de avisos de seguridad
{% data reusables.advisory-database.beta-malware-advisories %}
Each advisory in the {% data variables.product.prodname_advisory_database %} is for a vulnerability in open source projects{% ifversion GH-advisory-db-supports-malware %} or for malicious open source software{% endif %}.
Cada aviso en {% data variables.product.prodname_advisory_database %} se refiere a una vulnerabilidad en proyectos de código abierto{% ifversion GH-advisory-db-supports-malware %} o a software de código abierto malintencionado{% endif %}.
{% data reusables.repositories.a-vulnerability-is %} Vulnerabilities in code are usually introduced by accident and fixed soon after they are discovered. You should update your code to use the fixed version of the dependency as soon as it is available.
{% data reusables.repositories.a-vulnerability-is %} Por lo general, las vulnerabilidades en el código se introducen por accidente y se corrigen poco después de su detección. Debes actualizar el código para usar la versión corregida de la dependencia en cuanto esté disponible.
{% ifversion GH-advisory-db-supports-malware %}
In contrast, malicious software, or malware, is code that is intentionally designed to perform unwanted or harmful functions. The malware may target hardware, software, confidential data, or users of any application that uses the malware. You need to remove the malware from your project and find an alternative, more secure replacement for the dependency.
Por el contrario, el software malintencionado o malware es código diseñado intencionalmente para que lleve a cabo funciones dañinas o no deseadas. El malware puede estar dirigido a hardware, software, datos confidenciales o usuarios de cualquier aplicación que utilice el malware. Debes quitar el malware del proyecto y buscar un reemplazo alternativo más seguro para la dependencia.
{% endif %}
### {% data variables.product.company_short %}-reviewed advisories
### Avisos revisados por {% data variables.product.company_short %}
{% data variables.product.company_short %}-reviewed advisories are security vulnerabilities{% ifversion GH-advisory-db-supports-malware %} or malware{% endif %} that have been mapped to packages in ecosystems we support. We carefully review each advisory for validity and ensure that they have a full description, and contain both ecosystem and package information.
Los avisos revisados por {% data variables.product.company_short %} son vulnerabilidades de seguridad{% ifversion GH-advisory-db-supports-malware %} o malware{% endif %} que se asignaron a paquetes en ecosistemas a los que brindamos soporte. Revisamos cuidadosamente la validez de cada aviso y nos aseguramos de que tengan una descripción completa e información tanto del ecosistema como del paquete.
Generally, we name our supported ecosystems after the software programming language's associated package registry. We review advisories if they are for a vulnerability in a package that comes from a supported registry.
Por lo general, asignamos a los ecosistemas compatibles un nombre en función del registro de paquetes asociado del lenguaje de programación de software. Revisamos los avisos si corresponden a una vulnerabilidad de un paquete proveniente de un registro compatible.
- Composer (registry: https://packagist.org/){% ifversion GH-advisory-db-erlang-support %}
- Erlang (registry: https://hex.pm/){% endif %}
- Go (registry: https://pkg.go.dev/)
{%- ifversion fpt or ghec or ghes > 3.6 or ghae-issue-7508 %}
- GitHub Actions (https://github.com/marketplace?type=actions/) {% endif %}
- Maven (registry: https://repo.maven.apache.org/maven2)
- npm (registry: https://www.npmjs.com/)
- NuGet (registry: https://www.nuget.org/)
- pip (registry: https://pypi.org/)
- RubyGems (registry: https://rubygems.org/)
- Rust (registry: https://crates.io/)
- Composer (registro: https://packagist.org/){% ifversion GH-advisory-db-erlang-support %}
- Erlang (registro: https://hex.pm/){% endif %}
- Entra en (registro: https://pkg.go.dev/) {%- ifversion fpt or ghec or ghes > 3.6 or ghae-issue-7508 %}
- Acciones de GitHub (https://github.com/marketplace?type=actions/) {% endif %}
- Maven (registro: https://repo.maven.apache.org/maven2)
- npm (registro: https://www.npmjs.com/)
- NuGet (registro: https://www.nuget.org/)
- pip (registro: https://pypi.org/)
- RubyGems (registro: https://rubygems.org/)
- Rust (registro: https://crates.io/)
If you have a suggestion for a new ecosystem we should support, please open an [issue](https://github.com/github/advisory-database/issues) for discussion.
Si tienes alguna sugerencia sobre un ecosistema nuevo para el que deberíamos brindar soporte técnico, abre una [incidencia](https://github.com/github/advisory-database/issues) para analizarla.
If you enable {% data variables.product.prodname_dependabot_alerts %} for your repositories, you are automatically notified when a new {% data variables.product.company_short %}-reviewed advisory reports a vulnerability {% ifversion GH-advisory-db-supports-malware %}or malware{% endif %} for a package you depend on. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies)."
Si habilitas las {% data variables.product.prodname_dependabot_alerts %} para tu repositorio, recibirás una notificación automática cuando un aviso nuevo revisado por {% data variables.product.company_short %} informe de una vulnerabilidad {% ifversion GH-advisory-db-supports-malware %}o un malware{% endif %} en un paquete del que dependes. Para más información, vea "[Acerca de {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies)".
### Unreviewed advisories
### Avisos sin revisar
Unreviewed advisories are security vulnerabilites that we publish automatically into the {% data variables.product.prodname_advisory_database %}, directly from the National Vulnerability Database feed.
Las asesorías sin revisar son vulnerabilidades de seguridad que publicamos automáticamente en la {% data variables.product.prodname_advisory_database %}, directamente desde la fuente de la Base de Datos Nacional de Vulnerabilidades.
{% data variables.product.prodname_dependabot %} doesn't create {% data variables.product.prodname_dependabot_alerts %} for unreviewed advisories as this type of advisory isn't checked for validity or completion.
El {% data variables.product.prodname_dependabot %} no crea {% data variables.product.prodname_dependabot_alerts %} para las asesorías sin revisar, ya que este tipo de asesoría no se revisa en su validez o finalización.
## About information in security advisories
## Acerca de la información en los avisos de seguridad
Each security advisory contains information about the vulnerability{% ifversion GH-advisory-db-supports-malware %} or malware,{% endif %} which may include the description, severity, affected package, package ecosystem, affected versions and patched versions, impact, and optional information such as references, workarounds, and credits. In addition, advisories from the National Vulnerability Database list contain a link to the CVE record, where you can read more details about the vulnerability, its CVSS scores, and its qualitative severity level. For more information, see the "[National Vulnerability Database](https://nvd.nist.gov/)" from the National Institute of Standards and Technology.
Cada aviso de seguridad contiene información sobre la vulnerabilidad{% ifversion GH-advisory-db-supports-malware %} o el malware{% endif %} que puede incluir la descripción, la gravedad, el paquete afectado, el ecosistema del paquete, las versiones afectadas y las versiones a las que se aplicaron revisiones, el impacto e información opcional como referencias, soluciones alternativas y créditos. Adicionalmente, las asesorías de la National Vulnerability Database contiene un enlace al registro de CVE, en donde puedes leer más sobre los detalles de la vulnerabilidad, su puntuación de CVSS y su nivel de severidad cualitativo. Para obtener más información, vea la "[Base de datos nacional de vulnerabilidades](https://nvd.nist.gov/)" del Instituto Nacional de Estándares y Tecnología.
The severity level is one of four possible levels defined in the "[Common Vulnerability Scoring System (CVSS), Section 5](https://www.first.org/cvss/specification-document)."
- Low
- Medium/Moderate
- High
- Critical
El nivel de gravedad es uno de los cuatro niveles posibles definidos en el "[Sistema común de puntuación de vulnerabilidades (CVSS), sección 5](https://www.first.org/cvss/specification-document)".
- Bajo
- Medio/Moderado
- Alto
- Crítico
The {% data variables.product.prodname_advisory_database %} uses the CVSS levels described above. If {% data variables.product.company_short %} obtains a CVE, the {% data variables.product.prodname_advisory_database %} uses CVSS version 3.1. If the CVE is imported, the {% data variables.product.prodname_advisory_database %} supports both CVSS versions 3.0 and 3.1.
La {% data variables.product.prodname_advisory_database %} utiliza los niveles del CVSS tal como se describen anteriormente. Si {% data variables.product.company_short %} obtiene un CVE, la {% data variables.product.prodname_advisory_database %} utilizará el CVSS versión 3.1. Si se importa el CVE, la {% data variables.product.prodname_advisory_database %} será compatible tanto con la versión 3.0 como con la 3.1 del CVSS.
{% data reusables.repositories.github-security-lab %}
## Accessing an advisory in the {% data variables.product.prodname_advisory_database %}
## Acceder a una asesoría en la {% data variables.product.prodname_advisory_database %}
1. Navigate to https://github.com/advisories.
2. Optionally, to filter the list, use any of the drop-down menus.
![Dropdown filters](/assets/images/help/security/advisory-database-dropdown-filters.png)
{% tip %}
1. Vaya a https://github.com/advisories.
2. Opcionalmente, para filtrar la lista, utiliza cualquiera de los menúes desplegables.
![Filtros desplegables](/assets/images/help/security/advisory-database-dropdown-filters.png) {% tip %}
**Tip:** You can use the sidebar on the left to explore {% data variables.product.company_short %}-reviewed and unreviewed advisories separately.
**Sugerencia**: Puede utilizar la barra lateral de la izquierda para explorar las advertencias que revisa {% data variables.product.company_short %} y las no revisadas por separado.
{% endtip %}
3. Click an advisory to view details. By default, you will see {% data variables.product.company_short %}-reviewed advisories for security vulnerabilities. {% ifversion GH-advisory-db-supports-malware %}To show malware advisories, use `type:malware` in the search bar.{% endif %}
3. Haz clic en cualquier aviso para ver los detalles. De manera predeterminada, verás avisos revisados por {% data variables.product.company_short %} para las vulnerabilidades de seguridad. {% ifversion GH-advisory-db-supports-malware %}Para mostrar avisos de malware, usa `type:malware` en la barra de búsqueda.{% endif %}
{% note %}
The database is also accessible using the GraphQL API. {% ifversion GH-advisory-db-supports-malware %}By default, queries will return {% data variables.product.company_short %}-reviewed advisories for security vulnerabilities unless you specify `type:malware`.{% endif %} For more information, see the "[`security_advisory` webhook event](/webhooks/event-payloads/#security_advisory)."
También se puede acceder a la base de datos utilizando la API de GraphQL. {% ifversion GH-advisory-db-supports-malware %}De forma predeterminada, las consultas devolverán avisos revisados por {% data variables.product.company_short %} para las vulnerabilidades de seguridad a menos que se especifique `type:malware`.{% endif %} Para obtener más información, consulta el "[evento de webhook`security_advisory`](/webhooks/event-payloads/#security_advisory)".
{% endnote %}
## Editing an advisory in the {% data variables.product.prodname_advisory_database %}
You can suggest improvements to any advisory in the {% data variables.product.prodname_advisory_database %}. For more information, see "[Editing security advisories in the {% data variables.product.prodname_advisory_database %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/editing-security-advisories-in-the-github-advisory-database)."
## Editar una asesoría en la {% data variables.product.prodname_advisory_database %}
Puedes sugerir mejoras a cualquier asesoría en la {% data variables.product.prodname_advisory_database %}. Para más información, vea "[Edición de avisos de seguridad en {% data variables.product.prodname_advisory_database %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/editing-security-advisories-in-the-github-advisory-database)".
## Searching the {% data variables.product.prodname_advisory_database %}
## Buscar en la {% data variables.product.prodname_advisory_database %} por coincidencia exacta
You can search the database, and use qualifiers to narrow your search. For example, you can search for advisories created on a certain date, in a specific ecosystem, or in a particular library.
Puedes buscar la base de datos y utilizar los calificadores para definir más tu búsqueda. Por ejemplo, puedes buscar las asesorías que se hayan creado en una fecha, ecosistema o biblioteca específicos.
{% data reusables.time_date.date_format %} {% data reusables.time_date.time_format %}
{% data reusables.search.date_gt_lt %}
| Qualifier | Example |
| Calificador: | Ejemplo |
| ------------- | ------------- |
| `type:reviewed`| [**type:reviewed**](https://github.com/advisories?query=type%3Areviewed) will show {% data variables.product.company_short %}-reviewed advisories for security vulnerabilities. |
{% ifversion GH-advisory-db-supports-malware %}| `type:malware` | [**type:malware**](https://github.com/advisories?query=type%3Amalware) will show {% data variables.product.company_short %}-reviewed advisories for malware. |
{% endif %}| `type:unreviewed`| [**type:unreviewed**](https://github.com/advisories?query=type%3Aunreviewed) will show unreviewed advisories. |
| `GHSA-ID`| [**GHSA-49wp-qq6x-g2rf**](https://github.com/advisories?query=GHSA-49wp-qq6x-g2rf) will show the advisory with this {% data variables.product.prodname_advisory_database %} ID. |
| `CVE-ID`| [**CVE-2020-28482**](https://github.com/advisories?query=CVE-2020-28482) will show the advisory with this CVE ID number. |
| `ecosystem:ECOSYSTEM`| [**ecosystem:npm**](https://github.com/advisories?utf8=%E2%9C%93&query=ecosystem%3Anpm) will show only advisories affecting NPM packages. |
| `severity:LEVEL`| [**severity:high**](https://github.com/advisories?utf8=%E2%9C%93&query=severity%3Ahigh) will show only advisories with a high severity level. |
| `affects:LIBRARY`| [**affects:lodash**](https://github.com/advisories?utf8=%E2%9C%93&query=affects%3Alodash) will show only advisories affecting the lodash library. |
| `cwe:ID`| [**cwe:352**](https://github.com/advisories?query=cwe%3A352) will show only advisories with this CWE number. |
| `credit:USERNAME`| [**credit:octocat**](https://github.com/advisories?query=credit%3Aoctocat) will show only advisories credited to the "octocat" user account. |
| `sort:created-asc`| [**sort:created-asc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Acreated-asc) will sort by the oldest advisories first. |
| `sort:created-desc`| [**sort:created-desc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Acreated-desc) will sort by the newest advisories first. |
| `sort:updated-asc`| [**sort:updated-asc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Aupdated-asc) will sort by the least recently updated first. |
| `sort:updated-desc`| [**sort:updated-desc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Aupdated-desc) will sort by the most recently updated first. |
| `is:withdrawn`| [**is:withdrawn**](https://github.com/advisories?utf8=%E2%9C%93&query=is%3Awithdrawn) will show only advisories that have been withdrawn. |
| `created:YYYY-MM-DD`| [**created:2021-01-13**](https://github.com/advisories?utf8=%E2%9C%93&query=created%3A2021-01-13) will show only advisories created on this date. |
| `updated:YYYY-MM-DD`| [**updated:2021-01-13**](https://github.com/advisories?utf8=%E2%9C%93&query=updated%3A2021-01-13) will show only advisories updated on this date. |
| `type:reviewed`| [**type:reviewed**](https://github.com/advisories?query=type%3Areviewed) mostrará avisos revisados por {% data variables.product.company_short %} para las vulnerabilidades de seguridad. |
{% ifversion GH-advisory-db-supports-malware %}| `type:malware` | [**type:malware**](https://github.com/advisories?query=type%3Amalware) mostrará avisos revisados por {% data variables.product.company_short %} para malware. |
{% endif %}| `type:unreviewed`| [**type:unreviewed**](https://github.com/advisories?query=type%3Aunreviewed) mostrará las advertencias no revisadas. |
| `GHSA-ID`| [**GHSA-49wp-qq6x-g2rf**](https://github.com/advisories?query=GHSA-49wp-qq6x-g2rf) mostrará la advertencia con este id. de {% data variables.product.prodname_advisory_database %}. |
| `CVE-ID`| [**CVE-2020-28482**](https://github.com/advisories?query=CVE-2020-28482) mostrará la advertencia con este número de id. CVE. |
| `ecosystem:ECOSYSTEM`| [**ecosystem:npm**](https://github.com/advisories?utf8=%E2%9C%93&query=ecosystem%3Anpm) mostrará solo las advertencias que afecten a los paquetes de NPM. |
| `severity:LEVEL`| [**severity:high**](https://github.com/advisories?utf8=%E2%9C%93&query=severity%3Ahigh) solo mostrará advertencias con un nivel de gravedad alto. |
| `affects:LIBRARY`| [**affects:lodash**](https://github.com/advisories?utf8=%E2%9C%93&query=affects%3Alodash) mostrará solo advertencias que afecten a la biblioteca lodash. |
| `cwe:ID`| [**cwe:352**](https://github.com/advisories?query=cwe%3A352) solo mostrará advertencias con este número CWE. |
| `credit:USERNAME`| [**credit:octocat**](https://github.com/advisories?query=credit%3Aoctocat) solo mostrará advertencias acreditadas en la cuenta de usuario "octocat". |
| `sort:created-asc`| [**sort:created-asc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Acreated-asc) ordenará primero por las advertencias más antiguas. |
| `sort:created-desc`| [**sort:created-desc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Acreated-desc) ordenará primero por las advertencias más recientes. |
| `sort:updated-asc`| [**sort:updated-asc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Aupdated-asc) ordenará primero por la actualización menos reciente. |
| `sort:updated-desc`| [**sort:updated-desc**](https://github.com/advisories?utf8=%E2%9C%93&query=sort%3Aupdated-desc) ordenará primero por la actualización más reciente. |
| `is:withdrawn`| [**is:withdrawn**](https://github.com/advisories?utf8=%E2%9C%93&query=is%3Awithdrawn) mostrará solo advertencias que se han retirado. |
| `created:YYYY-MM-DD`| [**created:2021-01-13**](https://github.com/advisories?utf8=%E2%9C%93&query=created%3A2021-01-13) mostrará solo advertencias creadas en esta fecha. |
| `updated:YYYY-MM-DD`| [**updated:2021-01-13**](https://github.com/advisories?utf8=%E2%9C%93&query=updated%3A2021-01-13) mostrará solo advertencias actualizadas en esta fecha. |
## Viewing your vulnerable repositories
## Visualizar tus repositorios vulnerables
For any {% data variables.product.company_short %}-reviewed advisory in the {% data variables.product.prodname_advisory_database %}, you can see which of your repositories are affected by that security vulnerability{% ifversion GH-advisory-db-supports-malware %} or malware{% endif %}. To see a vulnerable repository, you must have access to {% data variables.product.prodname_dependabot_alerts %} for that repository. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies#access-to-dependabot-alerts)."
Para cualquier aviso revisado por {% data variables.product.company_short %} en {% data variables.product.prodname_advisory_database %}, puedes ver cuáles de los repositorios se ven afectados por esa vulnerabilidad de seguridad{% ifversion GH-advisory-db-supports-malware %} o malware{% endif %}. Para ver un repositorio vulnerable, debes tener acceso a las {% data variables.product.prodname_dependabot_alerts %} de este. Para más información, vea "[Acerca de {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies#access-to-dependabot-alerts)".
1. Navigate to https://github.com/advisories.
2. Click an advisory.
3. At the top of the advisory page, click **Dependabot alerts**.
![Dependabot alerts](/assets/images/help/security/advisory-database-dependabot-alerts.png)
4. Optionally, to filter the list, use the search bar or the drop-down menus. The "Organization" drop-down menu allows you to filter the {% data variables.product.prodname_dependabot_alerts %} per owner (organization or user).
![Search bar and drop-down menus to filter alerts](/assets/images/help/security/advisory-database-dependabot-alerts-filters.png)
5. For more details about the advisory, and for advice on how to fix the vulnerable repository, click the repository name.
1. Vaya a https://github.com/advisories.
2. Haz clic en una asesoría.
3. En la parte superior de la página de advertencias, haga clic en **Dependabot alerts** (Alertas de Dependabot).
![Alertas de Dependabot](/assets/images/help/security/advisory-database-dependabot-alerts.png)
4. Opcionalmente, para filtrar la lista, utiliza la barra de búsqueda o los menús desplegables. El menú desplegable de "Organización" te permite filtrar las {% data variables.product.prodname_dependabot_alerts %} por propietario (organización o usuario).
![Barra de búsqueda y menús desplegables para filtrar alertas](/assets/images/help/security/advisory-database-dependabot-alerts-filters.png)
5. Para más detalles sobre el aviso y consejos sobre cómo corregir el repositorio vulnerable, haz clic en el nombre del repositorio.
{% ifversion security-advisories-ghes-ghae %}
## Accessing the local advisory database on {% data variables.product.product_location %}
## Acceso a la base de datos de avisos local en {% data variables.product.product_location %}
If your site administrator has enabled {% data variables.product.prodname_github_connect %} for {% data variables.product.product_location %}, you can also browse reviewed advisories locally. For more information, see "[About {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/about-github-connect)".
Si el administrador del sitio ha habilitado {% data variables.product.prodname_github_connect %} para {% data variables.product.product_location %}, también puedes examinar los avisos revisados localmente. Para obtener más información, consulta "[Acerca de {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/about-github-connect)".
You can use your local advisory database to check whether a specific security vulnerability is included, and therefore whether you'd get alerts for vulnerable dependencies. You can also view any vulnerable repositories.
Puede usar la base de datos de avisos local para comprobar si se incluye una vulnerabilidad de seguridad específica y, por tanto, si recibirás alertas de las dependencias vulnerables. También puedes ver cualquier repositorio vulnerable.
1. Navigate to `https://HOSTNAME/advisories`.
2. Optionally, to filter the list, use any of the drop-down menus.
![Dropdown filters](/assets/images/help/security/advisory-database-dropdown-filters.png)
{% note %}
1. Vaya a `https://HOSTNAME/advisories`.
2. Opcionalmente, para filtrar la lista, utiliza cualquiera de los menúes desplegables.
![Filtros desplegables](/assets/images/help/security/advisory-database-dropdown-filters.png) {% note %}
**Note:** Only reviewed advisories will be listed. Unreviewed advisories can be viewed in the {% data variables.product.prodname_advisory_database %} on {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Accessing an advisory in the GitHub Advisory Database](#accessing-an-advisory-in-the-github-advisory-database)".
**Nota:** Solo se mostrarán avisos revisados. Los avisos no revisados se pueden ver en {% data variables.product.prodname_advisory_database %} en {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información, consulta "[Acceso a un aviso en la base de datos de avisos de GitHub](#accessing-an-advisory-in-the-github-advisory-database)".
{% endnote %}
3. Click an advisory to view details.{% ifversion GH-advisory-db-supports-malware %} By default, you will see {% data variables.product.company_short %}-reviewed advisories for security vulnerabilities. To show malware advisories, use `type:malware` in the search bar.{% endif %}
3. Haz clic en un aviso para ver los detalles. {% ifversion GH-advisory-db-supports-malware %} De forma predeterminada, verás los avisos revisados por {% data variables.product.company_short %} para las vulnerabilidades de seguridad. Si quieres ver los avisos de malware, usa `type:malware` en la barra de búsqueda.{% endif %}
You can also suggest improvements to any advisory directly from your local advisory database. For more information, see "[Editing advisories from {% data variables.product.product_location %}](/code-security/dependabot/dependabot-alerts/editing-security-advisories-in-the-github-advisory-database#editing-advisories-from-your-github-enterprise-server-instance)".
También puedes sugerir mejoras en cualquier aviso directamente desde la base de datos de avisos local. Para obtener más información, consulta "[Edición de avisos de {% data variables.product.product_location %}](/code-security/dependabot/dependabot-alerts/editing-security-advisories-in-the-github-advisory-database#editing-advisories-from-your-github-enterprise-server-instance)".
### Viewing vulnerable repositories for {% data variables.product.product_location %}
### Visualización de repositorios vulnerables para {% data variables.product.product_location %}
{% data reusables.repositories.enable-security-alerts %}
In the local advisory database, you can see which repositories are affected by each security vulnerability{% ifversion GH-advisory-db-supports-malware %} or malware{% endif %}. To see a vulnerable repository, you must have access to {% data variables.product.prodname_dependabot_alerts %} for that repository. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies#access-to-dependabot-alerts)."
En la base de datos de avisos local, puedes ver qué repositorios se ven afectados por cada vulnerabilidad de seguridad{% ifversion GH-advisory-db-supports-malware %} o malware{% endif %}. Para ver un repositorio vulnerable, debes tener acceso a las {% data variables.product.prodname_dependabot_alerts %} de este. Para más información, vea "[Acerca de {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies#access-to-dependabot-alerts)".
1. Navigate to `https://HOSTNAME/advisories`.
2. Click an advisory.
3. At the top of the advisory page, click **Dependabot alerts**.
![Dependabot alerts](/assets/images/help/security/advisory-database-dependabot-alerts.png)
4. Optionally, to filter the list, use the search bar or the drop-down menus. The "Organization" drop-down menu allows you to filter the {% data variables.product.prodname_dependabot_alerts %} per owner (organization or user).
![Search bar and drop-down menus to filter alerts](/assets/images/help/security/advisory-database-dependabot-alerts-filters.png)
5. For more details about the advisory, and for advice on how to fix the vulnerable repository, click the repository name.
1. Vaya a `https://HOSTNAME/advisories`.
2. Haz clic en una asesoría.
3. En la parte superior de la página de advertencias, haga clic en **Dependabot alerts** (Alertas de Dependabot).
![Alertas de Dependabot](/assets/images/help/security/advisory-database-dependabot-alerts.png)
4. Opcionalmente, para filtrar la lista, utiliza la barra de búsqueda o los menús desplegables. El menú desplegable de "Organización" te permite filtrar las {% data variables.product.prodname_dependabot_alerts %} por propietario (organización o usuario).
![Barra de búsqueda y menús desplegables para filtrar alertas](/assets/images/help/security/advisory-database-dependabot-alerts-filters.png)
5. Para más detalles sobre el aviso y consejos sobre cómo corregir el repositorio vulnerable, haz clic en el nombre del repositorio.
{% endif %}
## Further reading
## Información adicional
- MITRE's [definition of "vulnerability"](https://www.cve.org/ResourcesSupport/Glossary#vulnerability)
- [Definición de MITRE de "vulnerabilidad"](https://www.cve.org/ResourcesSupport/Glossary#vulnerability)

2
translations/es-ES/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md
View File

@@ -48,7 +48,7 @@ Your dotfiles repository might include your shell aliases and preferences, any t
You can configure {% data variables.product.prodname_codespaces %} to use dotfiles from any repository you own by selecting that repository in your [personal {% data variables.product.prodname_codespaces %} settings](https://github.com/settings/codespaces).
When you create a new codespace, {% data variables.product.prodname_dotcom %} clones your selected repository to the codespace environment, and looks for one of the following files to set up the environment.
When you create a new codespace, {% data variables.product.prodname_dotcom %} clones your selected dotfiles repository to the codespace environment, and looks for one of the following files to set up the environment.
* _install.sh_
* _install_

4
translations/es-ES/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md
View File

@@ -19,9 +19,9 @@ The lifecycle of a codespace begins when you create a codespace and ends when yo
When you want to work on a project, you can choose to create a new codespace or open an existing codespace. You might want to create a new codespace from a branch of your project each time you develop in {% data variables.product.prodname_codespaces %} or keep a long-running codespace for a feature. For more information, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace)."
If you choose to create a new codespace each time you work on a project, you should regularly push your changes so that any new commits are on {% data variables.product.prodname_dotcom %}. {% data reusables.codespaces.max-number-codespaces %} For more information, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)."
{% data reusables.codespaces.max-number-codespaces %} Similarly, if you reach the maximum number of active codespaces and you try to start another, you are prompted to stop one of your active codespaces.
If you choose to use a long-running codespace for your project, you should pull from your repository's default branch each time you start working in your codespace so that your environment has the latest commits. This workflow is very similar to if you were working with a project on your local machine.
If you choose to create a new codespace each time you work on a project, you should regularly push your changes so that any new commits are on {% data variables.product.prodname_dotcom %}. If you choose to use a long-running codespace for your project, you should pull from your repository's default branch each time you start working in your codespace so that your environment has the latest commits. This workflow is very similar to if you were working with a project on your local machine.
{% data reusables.codespaces.prebuilds-crossreference %}

121
translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace.md
View File

@@ -1,6 +1,6 @@
---
title: Creating a codespace
intro: You can create a codespace for a branch in a repository to develop online.
title: Crear un codespace
intro: Puedes crear un codespace para una rama en un repositorio para desarrollar en línea.
product: '{% data reusables.gated-features.codespaces %}'
redirect_from:
- /github/developing-online-with-github-codespaces/creating-a-codespace
@@ -14,26 +14,31 @@ topics:
- Fundamentals
- Developer
shortTitle: Create a codespace
ms.openlocfilehash: 16d6ebd7ca3bbf89e78d7fa025194250c37998b6
ms.sourcegitcommit: 81faf43a57101e75d40b5f8f77b9b129699e5d41
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/08/2022
ms.locfileid: '147865197'
---
## Acerca de la creación de codespaces
## About codespace creation
Puedes crear un codespace en {% data variables.product.prodname_dotcom_the_website %}, en {% data variables.product.prodname_vscode %} o utilizando el {% data variables.product.prodname_cli %}. {% data reusables.codespaces.codespaces-are-personal %}
You can create a codespace on {% data variables.product.prodname_dotcom_the_website %}, in {% data variables.product.prodname_vscode %}, or by using {% data variables.product.prodname_cli %}. {% data reusables.codespaces.codespaces-are-personal %}
Los codespaces se asocian con una rama específica de un repositorio y este repositorio no puede estar vacío. Puedes crear más de un codespace por repositorio o incluso por rama.
Codespaces are associated with a specific branch of a repository and the repository cannot be empty. You can create more than one codespace per repository or even per branch.
Cuando creas un codespace, se suscitan varios pasos para crear y conectarte a tu ambiente de desarrollo:
When you create a codespace, a number of steps happen to create and connect you to your development environment:
- Paso 1: se le asignan una MV y almacenamiento a tu codespace.
- Paso 2: Se crea el contenedor y se clona tu repositorio.
- Paso 3: Puedes conectarte al codespace.
- Paso 4: El codespace sigue con la configuración post-creación.
- Step 1: VM and storage are assigned to your codespace.
- Step 2: Container is created and your repository is cloned.
- Step 3: You can connect to the codespace.
- Step 4: Codespace continues with post-creation setup.
Para más información sobre lo que sucede al crear un codespace, vea "[Análisis en profundidad](/codespaces/getting-started/deep-dive)".
For more information on what happens when you create a codespace, see "[Deep Dive](/codespaces/getting-started/deep-dive)."
Para más información sobre el ciclo de vida de un codespace, consulte "[Ciclo de vida de Codespaces](/codespaces/developing-in-codespaces/codespaces-lifecycle)".
For more information on the lifecycle of a codespace, see "[Codespaces lifecycle](/codespaces/developing-in-codespaces/codespaces-lifecycle)."
If you want to use Git hooks for your codespace, then you should set up hooks using the [`devcontainer.json` lifecycle scripts](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts), such as `postCreateCommand`, during step 4. Since your codespace container is created after the repository is cloned, any [git template directory](https://git-scm.com/docs/git-init#_template_directory) configured in the container image will not apply to your codespace. Hooks must instead be installed after the codespace is created. For more information on using `postCreateCommand`, see the [`devcontainer.json` reference](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) in the {% data variables.product.prodname_vscode_shortname %} documentation.
Si quiere usar enlaces de Git para el codespace, debe configurarlos mediante los [scripts de ciclo de vida `devcontainer.json`](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts), como `postCreateCommand`, durante el paso 4. Como el contenedor de codespace se crea después de clonar el repositorio, cualquier [directorio de plantilla de Git](https://git-scm.com/docs/git-init#_template_directory) configurado en la imagen de contenedor no se aplicará al codespace. En su lugar, deben instalarse los ganchos después de que se crea el codespace. Para obtener más información sobre cómo usar `postCreateCommand`, consulta la referencia [`devcontainer.json`](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) en la documentación de {% data variables.product.prodname_vscode_shortname %}.
{% data reusables.codespaces.use-visual-studio-features %}
@@ -41,77 +46,77 @@ If you want to use Git hooks for your codespace, then you should set up hooks us
{% data reusables.codespaces.prebuilds-crossreference %}
## Access to {% data variables.product.prodname_github_codespaces %}
## Acceso a {% data variables.product.prodname_github_codespaces %}
When you have access to {% data variables.product.prodname_github_codespaces %}, you'll see a "Codespaces" tab within the **{% octicon "code" aria-label="The code icon" %} Code** drop-down menu when you view a repository.
Cuando tengas acceso a {% data variables.product.prodname_github_codespaces %}, verás una pestaña "Codespaces" en el menú desplegable **{% octicon "code" aria-label="The code icon" %} Código** cuando veas un repositorio.
You'll have access to {% data variables.product.prodname_github_codespaces %} under the following conditions:
Tendrás acceso a {% data variables.product.prodname_github_codespaces %} en las condiciones siguientes:
Either all of these are true:
* You are a member, or outside collaborator, of an organization that has enabled {% data variables.product.prodname_codespaces %} and set a spending limit.
* The organization owner has allowed you to create codespaces at the organization's expense.
* The repository for which you want to create a codespace is owned by this organization.
Cualquiera de estos son verdaderos:
* Eres miembro, o colaborador externo, de una organización que habilitó {% data variables.product.prodname_codespaces %} y configuró un límite de gastos.
* El propietario de la organización te ha permitido crear espacios de código a costa de la organización.
* El repositorio para el que desea screar un codespace es propiedad de esta organización.
Or both of these are true:
* You are participating in the beta of {% data variables.product.prodname_codespaces %} for individual users.
* Either you own the repository for which you want to create a codespace, or it is owned by an organization of which you are either a member or an outside collaborator.
O ambos son verdaderos:
* Participas en la versión beta de {% data variables.product.prodname_codespaces %} para usuarios individuales.
* Posees el repositorio para el que deseas crear un codespace o es propiedad de una organización de la que eres miembro o colaborador externo.
Before {% data variables.product.prodname_codespaces %} can be used in an organization, an owner or billing manager must have set a spending limit. For more information, see "[About spending limits for Codespaces](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces#about-spending-limits-for-codespaces)."
Antes de que puedas utilizar {% data variables.product.prodname_codespaces %} en una organización, un propietario o gerente de facturación debe haber configurado un límite de gastos. Para más información, vea "[Acerca de los límites de gasto para Codespaces](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces#about-spending-limits-for-codespaces)".
Organization owners can specify who can create and use codespaces at the organization's expense. Organization owners can also prevent any codespace usage being charged to the organization. For more information, see "[Enabling {% data variables.product.prodname_github_codespaces %} for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#choose-who-can-create-codespaces-that-are-billed-to-your-organization)."
Los propietarios de la organización pueden especificar quién puede crear y usar codespaces a costa de la organización. Los propietarios de la organización también pueden impedir que el uso de codespace se cobre a la organización. Para más información, consulta ["Habilitación de {% data variables.product.prodname_github_codespaces %} para la organización](/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization#choose-who-can-create-codespaces-that-are-billed-to-your-organization)".
## Creating a codespace
## Crear un codespace
{% webui %}
{% data reusables.repositories.navigate-to-repo %}
1. Under the repository name, use the "Branch" drop-down menu, and select the branch you want to create a codespace for.
1. Debajo del nombre de repositorio, utiliza el menú desplegable de "Rama" y selecciona aquella en la que quieras crear un codespace.
![Branch drop-down menu](/assets/images/help/codespaces/branch-drop-down.png)
![Menú desplegable de rama](/assets/images/help/codespaces/branch-drop-down.png)
1. Click the **{% octicon "code" aria-label="The code icon" %} Code** button, then click the **Codespaces** tab.
1. Haz clic en el botón **{% octicon "code" aria-label="The code icon" %} Código** y , a continuación, haz clic en la pestaña **Codespaces**.
![New codespace button](/assets/images/help/codespaces/new-codespace-button.png)
![Botón de codespace nuevo](/assets/images/help/codespaces/new-codespace-button.png)
1. Create your codespace, either using the default options, or after configuring advanced options:
1. Crea el codespace, ya sea con las opciones predeterminadas o después de configurar las opciones avanzadas:
* **Use the default options**
* **Uso de las opciones predeterminadas**
To create a codespace using the default options, click **Create codespace on BRANCH**.
Para crear un codespace con las opciones predeterminadas, haz clic en **Crear codespace en RAMA**.
Optionally, before clicking **Create codespace on BRANCH**, you can click the down arrow at the side of the button to see what machine type will be used for your codespace.
Opcionalmente, antes de hacer clic en **Crear codespace en RAMA**, puedes hacer clic en la flecha abajo situada al lado del botón para ver qué tipo de máquina se usará para el codespace.
![View the default machine type](/assets/images/help/codespaces/default-machine-type.png)
![Visualización del tipo de máquina predeterminado](/assets/images/help/codespaces/default-machine-type.png)
{% note %}
**Note**: The machine type with the lowest resources that are valid for the repository is selected by default.
**Nota**: El tipo de equipo con los recursos más bajos que son válidos para el repositorio está seleccionado de forma predeterminada.
{% endnote %}
* **Configure options**
* **Configurar opciones**
To configure advanced options for your codespace, such as a different machine type or a particular `devcontainer.json` file:
Para configurar opciones avanzadas para el codespace, como un tipo de máquina diferente o un archivo determinado `devcontainer.json`:
1. Click the down arrow at the side of the **Create codespace on BRANCH** button, then click **Configure and create codespace**.
1. Click the **Configure and create codespace** button.
1. On the options page for your codespace, choose your preferred options from the drop-down menus.
1. Haz clic en la flecha abajo situada al lado del botón **Crear codespace en RAMA** y, a continuación, haz clic en **Configurar y crear codespace**.
1. Haz clic en el botón **Configurar y crear codespace**.
1. En la página de opciones del codespace, elige tus opciones preferidas en los menús desplegables.
![The codespace options page](/assets/images/help/codespaces/advanced-options.png)
![Página de opciones de codespaces](/assets/images/help/codespaces/advanced-options.png)
{% note %}
**Notes**
**Notas**
* You can bookmark the options page to give you a quick way to create a codespace for this repository and branch.
* The [https://github.com/codespaces/new](https://github.com/codespaces/new) page provides a quick way to create a codespace for any repository and branch. You can get to this page quickly by typing `codespace.new` into your browser's address bar.
* For more information about the `devcontainer.json` file, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)."
* For more information about machine types, see "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)."
* Puedes marcar la página de opciones para poder crear rápidamente un codespace para este repositorio y esta rama.
* La página [https://github.com/codespaces/new](https://github.com/codespaces/new) proporciona una manera rápida de crear un codespace para cualquier repositorio y rama. Puedes acceder a esta página rápidamente escribiendo `codespace.new` en la barra de direcciones del explorador.
* Para obtener más información sobre el archivo `devcontainer.json`, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#devcontainerjson)".
* Para obtener más información, consulta "[Cambio del tipo de máquina para el codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)".
* {% data reusables.codespaces.codespaces-machine-type-availability %}
{% endnote %}
1. Click **Start session**.
1. Haz clic en **Iniciar sesión**.
{% endwebui %}
@@ -125,29 +130,29 @@ Organization owners can specify who can create and use codespaces at the organiz
{% data reusables.cli.cli-learn-more %}
To create a new codespace, use the `gh codespace create` subcommand.
Para crear un codespace, use el subcomando `gh codespace create`.
```shell
gh codespace create
```
You are prompted to choose a repository, a branch, a dev container configuration file (if more than one is available), and a machine type (if more than one is available).
Se te pedirá que elijas un repositorio, una rama, un archivo de configuración de contenedor de desarrollo (si hay más de uno disponible) y un tipo de máquina (si hay más de uno disponible).
Alternatively, you can use flags to specify some or all of the options:
Como alternativa, puedes utilizar marcadores para especificar algunas o todas las opciones:
```shell
gh codespace create -r <em>owner</em>/<em>repo</em> -b <em>branch</em> --devcontainer-path <em>path</em> -m <em>machine-type</em>
```
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.
En este ejemplo, reemplaza `owner/repo` por el identificador del repositorio. Reemplace a `branch` por el nombre de la rama o el hash SHA completo de la confirmación que quiera que se extraiga inicialmente en el codespace. Si usa la marca `-r` sin la marca `b`, el codespace se crea a partir de la rama predeterminada.
Replace `path` with the path to the dev container configuration file you want to use for the new codespace. If you omit this flag and more than one dev container file is available you will be prompted to choose one from a list. For more information about the dev container configuration file, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)."
Reemplaza `path` por la ruta de acceso al archivo de configuración de contenedor de desarrollo que desees usar para el nuevo codespace. Si omites este marcador y hay más de un tipo de archivo de contenedor de desarrollo disponible, se te pedirá que lo elijas en una lista. Para obtener más información sobre el archivo de configuración de contenedor de desarrollo, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers)".
Replace `machine-type` with a valid identifier for an available machine type. Identifiers are strings such as: `basicLinux32gb` and `standardLinux32gb`. The type of machines that are available depends on the repository, your personal account, and your location. If you enter an invalid or unavailable machine type, the available types are shown in the error message. If you omit this flag and more than one machine type is available you will be prompted to choose one from a list.
Reemplace `machine-type` por un identificador válido para un tipo de máquina disponible. Los identificadores son cadenas como: `basicLinux32gb` y `standardLinux32gb`. El tipo de máquinas que están disponibles depende del repositorio, la cuenta personal y la ubicación. Si ingresas un tipo de máquina no disponible o inválido, los tipos disponibles se mostrarán en el mensaje de error. Si omites este marcador y hay más de un tipo de máquina disponible, se te pedirá elegirlo de una lista.
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).
Para obtener los detalles completos de las opciones de este comando, consulta [el manual de {% data variables.product.prodname_cli %}](https://cli.github.com/manual/gh_codespace_create).
{% endcli %}
## Further reading
- "[Adding an 'Open in GitHub Codespaces' badge](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)"
## Información adicional
- "[Adición de un distintivo "Abrir en GitHub Codespaces"](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)"

42
translations/es-ES/content/codespaces/getting-started/deep-dive.md
View File

@@ -10,16 +10,16 @@ versions:
type: quick_start
topics:
- Codespaces
ms.openlocfilehash: 0c6f2aad203bfc11bcf5a9fbeaf3e7a187c4f180
ms.sourcegitcommit: 969a4bd906dd5a3366d404cf2fe125f671062397
ms.openlocfilehash: 5513956ea915701656e476681dbdbd6a2064b629
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 07/15/2022
ms.locfileid: '147145077'
ms.lasthandoff: 09/05/2022
ms.locfileid: '147783035'
---
{% data variables.product.prodname_github_codespaces %} es un entorno de desarrollo instantáneo basado en la nube que usa un contenedor para proporcionar lenguajes comunes, herramientas y utilidades para el desarrollo. {% data variables.product.prodname_codespaces %} también es configurable, lo cual te permite crear un ambiente de desarrollo personalizado para tu proyecto. Al configurar un ambiente de desarrollo personalizado para tu proyecto, puedes tener una configuración de codespace repetible para todos los usuarios de dicho proyecto.
## <a name="creating-your-codespace"></a>Crea tu codespace
## Crea tu codespace
Hay varios puntos de entrada para crear un codespace.
@@ -34,11 +34,11 @@ Una vez que hayas seleccionado la opción para crear un codespace y, opcionalmen
![Botón de abrir con codespaces](/assets/images/help/codespaces/new-codespace-button.png)
### <a name="step-1-vm-and-storage-are-assigned-to-your-codespace"></a>Paso 1: Se asigna una MV y un almacenamiento a tu codespace
### Paso 1: Se asigna una MV y un almacenamiento a tu codespace
Cuando se crea un codespace, se realiza un [clon superficial](https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/) del repositorio en una máquina virtual Linux dedicada y privada. El tener una MV dedicada garantiza que tengas un conjunto completo de recursos de cómputo disponibles para ti desde esa máquina. Si es necesario, esto también te permitirá tener acceso de raíz total a tu contenedor.
### <a name="step-2-container-is-created"></a>Paso 2: Se crea el contenedor
### Paso 2: Se crea el contenedor
{% data variables.product.prodname_codespaces %} utiliza un contenedor como el ambiente de desarrollo. Este contenedor se crea en función de las configuraciones que puede definir en un archivo `devcontainer.json` o Dockerfile en el repositorio. Si no [configura un contenedor](/codespaces/customizing-your-codespace/configuring-codespaces-for-your-project), {% data variables.product.prodname_codespaces %} usa una [imagen predeterminada](/codespaces/customizing-your-codespace/configuring-codespaces-for-your-project#using-the-default-configuration), que tiene muchos lenguajes y entornos de ejecución disponibles. Para obtener información sobre lo que contiene la imagen predeterminada, vea el repositorio [`vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers/tree/main/containers/codespaces-linux).
@@ -50,11 +50,11 @@ Como el repositorio se clona en la máquina virtual host antes de crear el conte
{% endnote %}
### <a name="step-3-connecting-to-the-codespace"></a>Paso 3: Conectarse al codespace
### Paso 3: Conectarse al codespace
Cuando tu contenedor se crea y se ejecuta cualquier otra inicialización, estarás conectado a tu codespace. Puedes conectarte a él mediante la web o [{% data variables.product.prodname_vscode_shortname %}](/codespaces/developing-in-codespaces/using-codespaces-in-visual-studio-code), o ambos, si es necesario.
### <a name="step-4-post-creation-setup"></a>Paso 4: Ajustes post-creación
### Paso 4: Ajustes post-creación
Una vez que se conecte al codespace, la configuración automatizada podría continuar la compilación en función de la configuración especificada en el archivo `devcontainer.json`. Es posible que vea que se ejecutan `postCreateCommand` y `postAttachCommand`.
@@ -65,9 +65,9 @@ Si tienes un repositorio público de dotfiles para {% data variables.product.pro
Finalmente, todo el historial del repositorio se copiará con un clon integral.
Durante la configuración post-creación, aún podrás utilizar la terminal integrada y editar tus archivos, pero ten cuidado de evitar cualquier condiciones de carrera entre tu trabajo y los comandos que se están ejecutando.
## <a name="-data-variablesproductprodname_codespaces--lifecycle"></a>Ciclo de vida de los {% data variables.product.prodname_codespaces %}
## Ciclo de vida de los {% data variables.product.prodname_codespaces %}
### <a name="saving-files-in-your-codespace"></a>Guardar archivos en tu codespace
### Guardar archivos en tu codespace
Conforme desarrollas en tu codespace, este guardará cualquier cambio en tus archivos cada algunos cuantos segundos. Tu codespace seguirá ejecutándose durante 30 minutos después de la última actividad. Después de este tiempo, este dejará de ejecutarse, pero puedes reiniciarlo ya sea desde la pestaña existente del buscador o desde la lista de codespaces existentes. Los cambios de archivo del editor y de la salida de la terminal se cuentan como actividad y, por lo tanto, tu codespace no se detendrá si la salida de la terminal sigue.
@@ -76,14 +76,14 @@ Conforme desarrollas en tu codespace, este guardará cualquier cambio en tus arc
**Nota**: Los cambios en un codespace de {% data variables.product.prodname_vscode_shortname %} no se guardan de forma automática, a menos que hayas habilitado [Guardar automáticamente](https://code.visualstudio.com/docs/editor/codebasics#_save-auto-save).
{% endnote %}
### <a name="closing-or-stopping-your-codespace"></a>Cerrar o detener tu codespace
### Cerrar o detener tu codespace
Para detener el codespace, puede [usar la {% data variables.product.prodname_vscode_command_palette %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces#suspending-or-stopping-a-codespace) [`Shift + Command + P` (Mac) / `Ctrl + Shift + P` (Windows)]. Si sales de tu codespace sin ejecutar el comando para detenerlo (por ejemplo, cerrar la pestaña del buscador) o si dejas el codespace ejecutándose sin interacción, este y sus procesos en ejecución seguirán hasta que ocurra una ventana de inactividad, después de la cual se detendrá el codespace. Predeterminadamente, la ventana de inactividad es de 30 minutos.
Par detener tu codespace, puedes [usar el {% data variables.product.prodname_vscode_command_palette %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces#suspending-or-stopping-a-codespace) (<kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (Mac) / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux)). Si sales de tu codespace sin ejecutar el comando para detenerlo (por ejemplo, cerrar la pestaña del buscador) o si dejas el codespace ejecutándose sin interacción, este y sus procesos en ejecución seguirán hasta que ocurra una ventana de inactividad, después de la cual se detendrá el codespace. Predeterminadamente, la ventana de inactividad es de 30 minutos.
Cuando cierras o detienes tu codespace, todos los cambios sin confirmar se preservan hasta que te conectes al codespace nuevamente.
## <a name="running-your-application"></a>Ejecutar tu aplicación
## Ejecutar tu aplicación
La redirección de puertos te otorga acceso a los puertos CRP dentro de tu codespace. Por ejemplo, si estás ejecutando una aplicación web por el puerto 4000 dentro de tu codespace, puedes reenviar ese puerto automáticamente para hacer la aplicación accesible desde tu buscador.
@@ -97,7 +97,7 @@ Si bien los puertos pueden reenviarse automáticamente, no son accesibles públi
El ejecutar tu aplicación cuando llegas por primera vez a tu codespace puede convertirse en un bucle de desarrollador interno rápido. Mientras editas, tus cambios se guardan automáticamente y se ponen disponibles en tu puerto reenviado. Para ver los cambios, regresa a la pestaña de la aplicación en ejecución en tu buscador y actualízala.
## <a name="committing-and-pushing-your-changes"></a>Confirmar y subir tus cambios
## Confirmar y subir tus cambios
Git se encuentra disponible predeterminadamente en tu codespace, entonces puedes confiar en tu flujo de trabajo existente de Git. Puedes trabajar con Git en el codespace mediante el terminal o con la interfaz de usuario de control de código fuente de [{% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/editor/versioncontrol). Para más información, vea "[Uso del control de código fuente en el codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)"
@@ -111,15 +111,15 @@ Puedes crear un codespace desde cualquier rama, confirmación o solicitud de cam
{% endnote %}
## <a name="personalizing-your-codespace-with-extensions"></a>Personalizar tu codespace con extensiones
## Personalizar tu codespace con extensiones
El uso de {% data variables.product.prodname_vscode_shortname %} en tu codespace te proporciona acceso a {% data variables.product.prodname_vscode_marketplace %} para que puedas agregar cualquier extensión que necesites. Para obtener información sobre cómo se ejecutan las extensiones en {% data variables.product.prodname_codespaces %}, consulta [Compatibilidad con el desarrollo remoto y Codespaces de GitHub](https://code.visualstudio.com/api/advanced-topics/remote-extensions) en la documentación de {% data variables.product.prodname_vscode_shortname %}.
Si ya usas {% data variables.product.prodname_vscode_shortname %}, puedes usar [Sincronizar configuración](https://code.visualstudio.com/docs/editor/settings-sync) para sincronizar automáticamente extensiones, configuraciones, temas y métodos abreviados de teclado entre la instancia local y los {% data variables.product.prodname_codespaces %} que crees.
## <a name="further-reading"></a>Información adicional
## Información adicional
- [Habilitación de {% data variables.product.prodname_codespaces %} para la organización](/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization)
- [Administración de la facturación de {% data variables.product.prodname_codespaces %} en la organización](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization)
- [Configuración del proyecto para Codespaces](/codespaces/setting-up-your-project-for-codespaces)
- [Ciclo de vida de Codespaces](/codespaces/developing-in-codespaces/codespaces-lifecycle)
- "[Habilitación de {% data variables.product.prodname_codespaces %} para tu organización](/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization)"
- "[Administración de la facturación de {% data variables.product.prodname_codespaces %} en tu organización](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization)"
- "[Configuración del proyecto para Codespaces](/codespaces/setting-up-your-project-for-codespaces)"
- "[Ciclo de vida de Codespaces](/codespaces/developing-in-codespaces/codespaces-lifecycle)"

112
translations/es-ES/content/codespaces/getting-started/quickstart.md
View File

@@ -1,7 +1,7 @@
---
title: 'Quickstart for {% data variables.product.prodname_github_codespaces %}'
title: 'Inicio rápido de {% data variables.product.prodname_github_codespaces %}'
shortTitle: 'Quickstart for {% data variables.product.prodname_codespaces %}'
intro: 'Try out {% data variables.product.prodname_github_codespaces %} in 5 minutes.'
intro: "Prueba {% data variables.product.prodname_github_codespaces %} en 5\_minutos."
allowTitleToDifferFromFilename: true
product: '{% data reusables.gated-features.codespaces %}'
versions:
@@ -12,103 +12,107 @@ topics:
- Codespaces
redirect_from:
- /codespaces/codespaces-quickstart
ms.openlocfilehash: ddf1e4ad5eff3b7c5be1638e424fb4a7493a3cd4
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147783123'
---
## Introducción
## Introduction
En esta guía, creará un codespace a partir de un repositorio de plantillas y explorará algunas de las características esenciales disponibles en el codespace.
In this guide, you'll create a codespace from a template repository and explore some of the essential features available to you within the codespace.
Desde esta guía de inicio rápido, aprenderás cómo crear un codespace, cómo conectarte a un puerto reenviado para ver tu aplicación ejecutándose, cómo utilizar el control de versiones en un codespace y cómo personalizar tu configuración con extensiones.
From this quickstart, you'll learn how to create a codespace, connect to a forwarded port to view your running application, use version control in a codespace, and personalize your setup with extensions.
Para más información sobre cómo funcionan exactamente {% data variables.product.prodname_github_codespaces %}, ve la guía complementaria "[Profundización en {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive)".
For more information on exactly how {% data variables.product.prodname_github_codespaces %} works, see the companion guide "[Deep dive into {% data variables.product.prodname_github_codespaces %}](/codespaces/getting-started/deep-dive)."
## Crea tu codespace
## Creating your codespace
1. Vaya al [repositorio de plantillas](https://github.com/github/haikus-for-codespaces) y seleccione **Usar esta plantilla**. {% data reusables.codespaces.open-codespace-from-template-repo %}
1. Navigate to the [template repository](https://github.com/github/haikus-for-codespaces) and select **Use this template**.
{% data reusables.codespaces.open-codespace-from-template-repo %}
## Ejecución de la aplicación
## Running the application
Una vez que se cree tu codespace, tu repositorio se clonará automáticamente en él. Ahora puedes ejecutar la aplicación y lanzarla en un buscador.
Once your codespace is created, your repository will be automatically cloned into it. Now you can run the application and launch it in a browser.
1. When the terminal becomes available, enter the command `npm run dev`. This example uses a Node.js project, and this command runs the script labeled "dev" in the _package.json_ file, which starts up the web application defined in the sample repository.
1. Cuando el terminal esté disponible, escribe el comando `npm run dev`. En este ejemplo se usa un proyecto de Node.js y este comando ejecuta el script con la etiqueta "dev" en el archivo _package.json_, que inicia la aplicación web definida en el repositorio de muestra.
![npm run dev in terminal](/assets/images/help/codespaces/codespaces-npm-run-dev.png)
![npm run dev en la temrinal](/assets/images/help/codespaces/codespaces-npm-run-dev.png)
If you're following along with a different application type, enter the corresponding start command for that project.
Si estás siguiendo la guía con un tipo de aplicación diferente, ingresa el comando de incio correspondiente para este.
1. When your application starts, the codespace recognizes the port the application is running on and displays a prompt to let you know it has been forwarded.
1. Cuando se inicia la aplicación, el codespace reconoce el puerto en el que se ejecuta la aplicación y muestra un mensaje para informarle de que se ha reenviado.
![Port forwarding toast](/assets/images/help/codespaces/quickstart-port-toast.png)
![Notificación de reenvío de puertos](/assets/images/help/codespaces/quickstart-port-toast.png)
1. Click **Open in Browser** to view your running application in a new tab.
1. Haga clic en **Abrir en el explorador** para ver la aplicación en ejecución en una pestaña nueva.
## Edit the application and view changes
## Editar la aplicación y ver los cambios
1. Switch back to your codespace and open the _haikus.json_ file by double-clicking it in the Explorer.
1. Vuelve al codespace y haz doble clic en el archivo _haikus.json_ para abrirlo en el Explorador.
1. Edit the `text` field of the first haiku to personalize the application with your own haiku.
1. Edite el campo `text` del primer haiku para personalizar la aplicación con un haiku propio.
1. Go back to the running application tab in your browser and refresh to see your changes.
1. Regresa a la pestaña de la aplicación en ejecución dentro de tu buscador y actualiza para ver los cambios.
{% octicon "light-bulb" aria-label="The lightbulb icon" %} If you've closed the tab, open the Ports panel and click the **Open in browser** icon for the running port.
{% octicon "light-bulb" aria-label="The lightbulb icon" %} Si ha cerrado la pestaña, abra el panel Puertos y haga clic en el icono **Abrir en el explorador** del puerto en ejecución.
![Port Forwarding Panel](/assets/images/help/codespaces/quickstart-forward-port.png)
![Panel de reenvío de puertos](/assets/images/help/codespaces/quickstart-forward-port.png)
## Committing and pushing your changes
## Confirmar y subir tus cambios
Now that you've made a few changes, you can use the integrated terminal or the source view to commit and push the changes back to the remote.
Ahora que hiciste algunos cambios, puedes utilizar la terminal integrada o la vista de código fuente para confirmar y subir los cambios al remoto.
{% data reusables.codespaces.source-control-display-dark %}
1. To stage your changes, click **+** next to the file you've changed, or next to **Changes** if you've changed multiple files and you want to stage them all.
1. Para agregar los cambios al "stage", haga clic en **+** junto al archivo que ha cambiado, o junto a **Cambios** si ha cambiado varios archivos y quiere agregarlos todos.
![Source control side bar with staging button highlighted](/assets/images/help/codespaces/codespaces-commit-stage.png)
![Barra lateral de control de código fuente con el botón de almacenamiento provisional resaltado](/assets/images/help/codespaces/codespaces-commit-stage.png)
1. Type a commit message describing the change you've made.
1. Teclea un mensaje de confirmación que describa el cambio que hiciste.
![Source control side bar with a commit message](/assets/images/help/codespaces/codespaces-commit-commit-message.png)
![Barra de control de código fuente con un mensaje de confirmación](/assets/images/help/codespaces/codespaces-commit-commit-message.png)
1. To commit your staged changes, click the check mark at the top the source control side bar.
1. Para confirmar tus cambios planeados, haz clic en la marca de verificación en la parte superior de la barra lateral del control de código fuente.
![Click the check mark icon](/assets/images/help/codespaces/codespaces-commit-checkmark-icon.png)
![Clic en el icono de marca de verificación](/assets/images/help/codespaces/codespaces-commit-checkmark-icon.png)
You can push the changes you've made. This applies those changes to the upstream branch on the remote repository. You might want to do this if you're not yet ready to create a pull request, or if you prefer to create a pull request on {% data variables.product.prodname_dotcom %}.
1. At the top of the side bar, click the ellipsis (**...**).
Puedes subir los cambios que has hecho. Esto aplica a aquellos de la rama ascendente en el repositorio remoto. Puede que necesites hacer eso si aún no estás listo para crear una solicitud de cambios o si prefieres crearla en {% data variables.product.prodname_dotcom %}.
1. En la parte superior de la barra lateral, haz clic en los puntos suspensivos ( **…** ).
![Ellipsis button for View and More Actions](/assets/images/help/codespaces/source-control-ellipsis-button-nochanges.png)
![Botón de puntos suspensivos para las acciones Ver y Más](/assets/images/help/codespaces/source-control-ellipsis-button-nochanges.png)
1. In the drop-down menu, click **Push**.
1. Go back to your new repository on {% data variables.product.prodname_dotcom %} and view the _haikus.json_ file. Check that the change you made in your codespace has been successfully pushed to the repository.
1. En el menú desplegable, haga clic en **Insertar**.
1. Vuelve al repositorio nuevo en {% data variables.product.prodname_dotcom %} y consulta el archivo _haikus.json_. Comprueba que el cambio realizado en el codespace se haya enviado correctamente al repositorio.
## Personalizing with an extension
## Personalizar con una extensión
Within a codespace, you have access to the {% data variables.product.prodname_vscode_marketplace %}. For this example, you'll install an extension that alters the theme, but you can install any extension that is useful for your workflow.
Dentro de un codespace, tienes acceso a {% data variables.product.prodname_vscode_marketplace %}. Para este ejemplo, instalarás una extensión que altera el tema, pero puedes instalar cualquier extensión que sea útil para tu flujo de trabajo.
{% note %}
**Note**: If you have [Settings Sync](https://code.visualstudio.com/docs/editor/settings-sync) turned on, any changes you make to your editor setup in the current codespace, such as changing your theme or keyboard bindings, are automatically synced to any other codespaces you open and any instances of {% data variables.product.prodname_vscode %} that are signed into your {% data variables.product.prodname_dotcom %} account.
**Nota:** Si has activado [Sincronización de ajustes](https://code.visualstudio.com/docs/editor/settings-sync), cualquier cambio que realices en la configuración del editor en el codespace actual, como cambiar el tema o los enlaces de teclado, se sincroniza automáticamente con cualquier otro codespace que abras y cualquier instancia de {% data variables.product.prodname_vscode %} que estén registrados en tu cuenta de {% data variables.product.prodname_dotcom %}.
{% endnote %}
1. In the left sidebar, click the Extensions icon.
1. En la barra lateral, haz clic en el icono de extensiones.
1. In the search bar, enter `fairyfloss` and install the fairyfloss extension.
1. En la barra de búsqueda, escriba `fairyfloss` e instale la extensión fairyfloss.
![Add an extension](/assets/images/help/codespaces/add-extension.png)
![Agregar una extensión](/assets/images/help/codespaces/add-extension.png)
1. Click **Install in Codespaces**.
1. Select the `fairyfloss` theme by selecting it from the list.
1. Haz clic en **Instalar en codespaces**.
1. Seleccione el tema `fairyfloss` en la lista.
![Select the fairyfloss theme](/assets/images/help/codespaces/fairyfloss.png)
![Seleccionar el tema de fairyfloss](/assets/images/help/codespaces/fairyfloss.png)
## Next Steps
## Pasos siguientes
You've successfully created, personalized, and run your first application within a codespace but there's so much more to explore! Here are some helpful resources for taking your next steps with {% data variables.product.prodname_codespaces %}.
- [Deep dive](/codespaces/getting-started/deep-dive): This quickstart presented some of the features of {% data variables.product.prodname_codespaces %}. The deep dive looks at these areas from a technical standpoint.
- [Setting up your project for {% data variables.product.prodname_codespaces %}](/codespaces/getting-started-with-codespaces): These guides provide information on setting up your project to use {% data variables.product.prodname_codespaces %} with specific languages.
- [Configuring {% data variables.product.prodname_codespaces %} for your project](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project): This guide provides details on creating a custom configuration for {% data variables.product.prodname_codespaces %} for your project.
Creaste, personalizaste y ejecutaste exitosamente tu primer aplicación dentro de un codespace, pero ¡hay mucho más que explorar! Estos son algunos recursos útiles para que realice los siguientes pasos con {% data variables.product.prodname_codespaces %}.
- [Análisis en profundidad](/codespaces/getting-started/deep-dive): en este inicio rápido se presentan algunas de las características de {% data variables.product.prodname_codespaces %}. La guía a fondo ve estas áreas desde un punto de vista técnico.
- [Configuración del proyecto para {% data variables.product.prodname_codespaces %}](/codespaces/getting-started-with-codespaces): en estas guías se proporciona información sobre cómo configurar el proyecto para usar {% data variables.product.prodname_codespaces %} con lenguajes específicos.
- [Configuración de {% data variables.product.prodname_codespaces %} para el proyecto](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project): en esta guía se proporcionan detalles sobre cómo crear una configuración personalizada de {% data variables.product.prodname_codespaces %} para el proyecto.
## Further reading
## Información adicional
- "[Enabling {% data variables.product.prodname_codespaces %} for your organization](/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization)"
- "[Managing billing for {% data variables.product.prodname_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization)"
- "[Habilitación de {% data variables.product.prodname_codespaces %} para ltu organización](/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization)"
- "[Administración de la facturación de {% data variables.product.prodname_codespaces %} en tu organización](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization)"

8
translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/index.md
View File

@@ -19,11 +19,11 @@ children:
- /restricting-the-visibility-of-forwarded-ports
- /restricting-the-idle-timeout-period
- /restricting-the-retention-period-for-codespaces
ms.openlocfilehash: d92214a4fd120b5e3833c84dfa453ce181cb1858
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.openlocfilehash: 98b47ce0337b3309c8318eebef001455a3ec5e52
ms.sourcegitcommit: 81faf43a57101e75d40b5f8f77b9b129699e5d41
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147145085'
ms.lasthandoff: 09/08/2022
ms.locfileid: '147865157'
---

71
translations/es-ES/content/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge.md Normal file
View File

@@ -0,0 +1,71 @@
---
title: Adición de un distintivo "Abrir en GitHub Codespaces"
shortTitle: Add a Codespaces badge
intro: Puedes agregar un distintivo a un archivo Markdown en el repositorio en el que la gente puede hacer clic para crear un codespace.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghec: '*'
type: how_to
topics:
- Codespaces
- Set up
product: '{% data reusables.gated-features.codespaces %}'
ms.openlocfilehash: 4a45c11adc5d09888e6bb65b49b9f997f5233fea
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147783138'
---
## Información general
Agregar un distintivo "Abrir en {% data variables.product.prodname_github_codespaces %}" a un archivo de Markdown proporciona a la gente una manera fácil de crear un codespace para el repositorio.
![Captura de pantalla de un distintivo de Codespaces en una página LÉAME](/assets/images/help/codespaces/codespaces-badge-on-readme.png)
Al crear un distintivo, puedes elegir opciones de configuración específicas para el codespace que creará el distintivo.
Cuando la gente haga clic en el distintivo, se les dirigirá a la página de opciones avanzadas para la creación del codespace, con las opciones que elegiste preseleccionadas. Para obtener más información sobre la página de opciones avanzadas, consulta "[Creación de un codespace](https://docs-internal-30445-bfc9ce.preview.ghdocs.com/en/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)".
En la página opciones avanzadas, los usuarios pueden cambiar la configuración preseleccionada si es necesario y, a continuación, hacer clic en **Crear codespace**.
{% note %}
**Nota**: Ten en cuenta que las personas que aún no tienen acceso a {% data variables.product.prodname_github_codespaces %} verán un mensaje 404 si hacen clic en este distintivo.
{% endnote %}
## Creación de un distintivo "Abrir en {% data variables.product.prodname_github_codespaces %}"
{% data reusables.repositories.navigate-to-repo %}
1. Debajo del nombre de repositorio, utiliza el menú desplegable de "Rama" y selecciona aquella en la que quieras crear el distintivo.
![Captura de pantalla del menú desplegable Rama](/assets/images/help/codespaces/branch-drop-down.png)
1. Haz clic en el botón **{% octicon "code" aria-label="The code icon" %} Código** y , a continuación, haz clic en la pestaña **Codespaces**.
![Captura de pantalla del botón Nuevo codespace](/assets/images/help/codespaces/new-codespace-button.png)
1. Haz clic en la flecha abajo situada al lado del botón **Crear codespace en RAMA**, haz clic en **Configurar y crear codespace** y, a continuación, haz clic en el botón **Configurar y crear codespace**.
![Captura de pantalla de la opción "Configurar y crear codespace"](/assets/images/help/codespaces/configure-and-create-option.png)
1. En la página opciones avanzadas para la creación del codespace, selecciona los valores que deseas que se preseleccionen en cada campo.
![Captura de pantalla de la página opciones avanzadas](/assets/images/help/codespaces/advanced-options.png)
1. Copie la dirección URL de la barra de direcciones del explorador.
1. Agrega el siguiente markdown a, por ejemplo, el `README.md` archivo del repositorio:
```Markdown{:copy}
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](COPIED-URL)
```
Por ejemplo:
```Markdown
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=0000000&machine=premiumLinux&devcontainer_path=.devcontainer%2Fdevcontainer.json&location=WestUs2)
```
En el ejemplo anterior, `0000000` será el número de referencia del repositorio. Los demás detalles de la dirección URL vienen determinados por los valores seleccionados en los campos de la página de opciones avanzadas.

30
translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/about-using-makecode-arcade-with-github-classroom.md
View File

@@ -1,31 +1,37 @@
---
title: About using MakeCode Arcade with GitHub Classroom
title: Acerca de utilizar MakeCode Arcade con GitHub Classroom
shortTitle: About using MakeCode Arcade
intro: 'You can configure MakeCode Arcade as the online IDE for assignments in {% data variables.product.prodname_classroom %}.'
intro: 'Puedes configurar a MakeCode Arcade como el IDE en línea para las tareas en {% data variables.product.prodname_classroom %}.'
versions:
fpt: '*'
redirect_from:
- /education/manage-coursework-with-github-classroom/student-experience-makecode
- /education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom
ms.openlocfilehash: f4786f67c7a9d0444e92d3c5560f4d86b6a0af7d
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '145119577'
---
## About MakeCode Arcade
## Acerca de MakeCode Arcade
MakeCode Arcade is an online integrated development environment (IDE) for developing retro arcade games using drag-and-drop block programming and JavaScript. Students can write, edit, run, test, and debug code in a browser with MakeCode Arcade. For more information about IDEs and {% data variables.product.prodname_classroom %}, see "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide)."
MakeCode Arcade es un ambiente de desarrollo integrado (IDE, por sus siglas en inglés) para desarrollar juegos retro de arcade utilizando una programación de arrastre de bloques y JavaScript. Con MakeCode Arcade, los alumnos pueden escribir, editar, ejecutar, probar y depurar código desde un buscador. Para obtener más información sobre los IDE y {% data variables.product.prodname_classroom %}, vea "[Integración de {% data variables.product.prodname_classroom %} con un IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide)".
{% data reusables.classroom.readme-contains-button-for-online-ide %}
The first time the student clicks the button to visit MakeCode Arcade, the student must sign into MakeCode Arcade with {% data variables.product.product_name %} credentials. After signing in, the student will have access to a development environment containing the code from the assignment repository, fully configured on MakeCode Arcade.
La primera vez que el alumno da clic en el botón para visitar a MakeCode Arcade, éste deberá ingresar en MakeCode Arcade con sus credenciales de {% data variables.product.product_name %}. Después de ingresar, el alumno tendrá acceso a un ambiente de desarrollo que contenga el código de un repositorio de tareas, completamente configurado en makeCode Arcade.
For more information about working on MakeCode Arcade, see the [MakeCode Arcade Tour](https://arcade.makecode.com/ide-tour) and [documentation](https://arcade.makecode.com/docs) on the MakeCode Arcade website.
Para obtener más información sobre cómo trabajar en MakeCode Arcade, vea el [Paseo por MakeCode Arcade](https://arcade.makecode.com/ide-tour) y la [documentación](https://arcade.makecode.com/docs) en el sitio web de MakeCode Arcade.
MakeCode Arcade does not support multiplayer-editing for group assignments. Instead, students can collaborate with Git and {% data variables.product.product_name %} features like branches and pull requests.
MakeCode Arcade no escompatible con edición de multijugadores para las tareas grupales. En vez de esto, los alumnos pueden colaborar con las características de Git y de {% data variables.product.product_name %} como las ramas y las solicitudes de cambios.
## About submission of assignments with MakeCode Arcade
## Acerca de la emissión de tareas con MakeCode Arcade
By default, MakeCode Arcade is configured to push to the assignment repository on {% data variables.product.product_location %}. After making progress on an assignment with MakeCode Arcade, students should push changes to {% data variables.product.product_location %} using the {% octicon "mark-github" aria-label="The GitHub mark" %}{% octicon "arrow-up" aria-label="The up arrow icon" %} button at the bottom of the screen.
Predeterminadamente, MakeCode Arcade se encuentra configurado para subir las tareas al repositorio designado para ellas en {% data variables.product.product_location %}. Después de que se haya progresado en una tarea de MakeCode Arcade, los alumnos deberán subir los cambios a {% data variables.product.product_location %} utilizando el {% octicon "arrow-up" aria-label="The up arrow icon" %} de la {% octicon "mark-github" aria-label="The GitHub mark" %} al final de la pantalla.
![MakeCode Arcade version control functionality](/assets/images/help/classroom/ide-makecode-arcade-version-control-button.png)
![Funcionalidad de control de versiones de MakeCode Arcade](/assets/images/help/classroom/ide-makecode-arcade-version-control-button.png)
## Further reading
## Información adicional
- "[About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)"
- "[Acerca de los archivos Léame](/github/creating-cloning-and-archiving-repositories/about-readmes)"

36
translations/es-ES/content/get-started/customizing-your-github-workflow/exploring-integrations/about-github-marketplace.md
View File

@@ -1,6 +1,6 @@
---
title: About GitHub Marketplace
intro: '{% data variables.product.prodname_marketplace %} contains tools that add functionality and improve your workflow.'
title: Acerca de Mercado GitHub
intro: '{% data variables.product.prodname_marketplace %} contiene herramientas que adicionan funcionalidad y mejoran tu flujo de trabajo.'
redirect_from:
- /articles/about-github-marketplace
- /github/customizing-your-github-workflow/about-github-marketplace
@@ -8,28 +8,34 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
ms.openlocfilehash: b105bd1ea712aff86e47891d2be24ce82f8d6b19
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '145112130'
---
You can discover, browse, and install free and paid tools, including {% data variables.product.prodname_github_apps %}, {% data variables.product.prodname_oauth_apps %}, and {% data variables.product.prodname_actions %}, in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace).
En [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace), puede descubrir, buscar e instalar herramientas gratuitas y de pago, incluidas {% data variables.product.prodname_github_apps %}, {% data variables.product.prodname_oauth_apps %} y {% data variables.product.prodname_actions %}.
If you purchase a paid tool, you'll pay for your tool subscription with the same billing information you use to pay for your {% data variables.product.product_name %} subscription, and receive one bill on your regular billing date. For more information, see "[About billing for {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)."
Si compras una herramienta paga, pagarás por tu suscripción a la herramienta con la misma información de facturación que usas para pagar la suscripción de {% data variables.product.product_name %} y recibirás una factura en tu fecha de facturación regular. Para más información, vea "[Acerca de la facturación de {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)".
You may also have the option to select a free 14-day trial on some tools. You can cancel at any time during your trial and you won't be charged, but you will automatically lose access to the tool. Your paid subscription will start at the end of the 14-day trial. For more information, see "[About billing for {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)."
También puedes tener la opción de seleccionar una prueba gratuita de 14 días en algunas herramientas. Puedes cancelar en cualquier momento durante tu prueba y no se te cobrará, pero automáticamente perderás acceso a la herramienta. Tu suscripción paga comenzará al finalizar la prueba de 14 días. Para más información, vea "[Acerca de la facturación de {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)".
## Finding tools on {% data variables.product.prodname_marketplace %}
## Encontrar herramientas en {% data variables.product.prodname_marketplace %}
You can discover, browse, and install apps and actions created by others on {% data variables.product.prodname_marketplace %}, see "[Searching {% data variables.product.prodname_marketplace %}](/search-github/searching-on-github/searching-github-marketplace)."
Puede descubrir, examinar e instalar aplicaciones y acciones creadas por otros usuarios en {% data variables.product.prodname_marketplace %}, vea "[Búsqueda en {% data variables.product.prodname_marketplace %}](/search-github/searching-on-github/searching-github-marketplace)".
{% data reusables.actions.actions-not-verified %}
Anyone can list a free {% data variables.product.prodname_github_app %} or {% data variables.product.prodname_oauth_app %} on {% data variables.product.prodname_marketplace %}. Publishers of paid apps are verified by {% data variables.product.company_short %} and listings for these apps are shown with a marketplace badge {% octicon "verified" aria-label="Verified creator badge" %}. You will also see badges for unverified and verified apps. These apps were published using the previous method for verifying individual apps. For more information about the current process, see "[About GitHub Marketplace](/developers/github-marketplace/about-github-marketplace)" and "[Requirements for listing an app](/developers/github-marketplace/requirements-for-listing-an-app)."
Cualquiera puede listar una {% data variables.product.prodname_github_app %} o {% data variables.product.prodname_oauth_app %} gratuita en {% data variables.product.prodname_marketplace %}. {% data variables.product.company_short %} verifica a los publicadores de las apps de pago y los listados de estas se muestran con una insignia de marketplace {% octicon "verified" aria-label="Verified creator badge" %}. También podrás ver insignias para las apps verificadas y sin verificar. Estas apps se publicaron utilizando el método anterior para verificar apps individuales. Para más información sobre el proceso actual, vea "[Acerca de GitHub Marketplace](/developers/github-marketplace/about-github-marketplace)" y "[Requisitos para ofertar una aplicación](/developers/github-marketplace/requirements-for-listing-an-app)".
## Building and listing a tool on {% data variables.product.prodname_marketplace %}
## Crear y hacer aparecer una herramienta en {% data variables.product.prodname_marketplace %}
For more information on creating your own tool to list on {% data variables.product.prodname_marketplace %}, see "[Apps](/developers/apps)" and "[{% data variables.product.prodname_actions %}](/actions)."
Para más información sobre cómo crear una herramienta propia para ofertas en {% data variables.product.prodname_marketplace %}, vea "[Aplicaciones](/developers/apps)" y "[{% data variables.product.prodname_actions %}](/actions)".
## Further reading
## Información adicional
- "[Purchasing and installing apps in {% data variables.product.prodname_marketplace %}](/articles/purchasing-and-installing-apps-in-github-marketplace)"
- "[Managing billing for {% data variables.product.prodname_marketplace %} apps](/articles/managing-billing-for-github-marketplace-apps)"
- "[{% data variables.product.prodname_marketplace %} support](/articles/github-marketplace-support)"
- "[Differences between GitHub Apps and OAuth Apps](/developers/apps/differences-between-github-apps-and-oauth-apps)"
- "[Compra e instalación de aplicaciones en {% data variables.product.prodname_marketplace %}](/articles/purchasing-and-installing-apps-in-github-marketplace)"
- "[Administración de la facturación para las aplicaciones de {% data variables.product.prodname_marketplace %}](/articles/managing-billing-for-github-marketplace-apps)"
- "[Compatibilidad con {% data variables.product.prodname_marketplace %}](/articles/github-marketplace-support)"
- "[Diferencias entre aplicaciones de GitHub y aplicaciones de OAuth](/developers/apps/differences-between-github-apps-and-oauth-apps)"

68
translations/es-ES/content/get-started/importing-your-projects-to-github/importing-source-code-to-github/adding-locally-hosted-code-to-github.md
View File

@@ -13,14 +13,14 @@ versions:
ghae: '*'
ghec: '*'
shortTitle: Add locally hosted code
ms.openlocfilehash: 5dc22ef9d8b5f11618bc90414c9d94fcdfe50462
ms.sourcegitcommit: 22d665055b1bee7a5df630385e734e3a149fc720
ms.openlocfilehash: 646ea2b0267ffebe546cf014ba7af74ab3c36284
ms.sourcegitcommit: f4e3a8d53078409382c84d26a350dae6e35ba3aa
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 07/13/2022
ms.locfileid: '145135793'
ms.lasthandoff: 09/06/2022
ms.locfileid: '147855044'
---
## <a name="about-adding-existing-source-code-to--data-variablesproductproduct_name-"></a>Acerca de cómo agregar código fuente existente a {% data variables.product.product_name %}
## Acerca de cómo agregar código fuente existente a {% data variables.product.product_name %}
Si ya tiene código fuente o repositorios almacenados localmente en el equipo o en la red privada, puede agregarlos a {% data variables.product.product_name %} escribiendo comandos en un terminal. Para ello, escriba comandos de Git directamente o bien use la {% data variables.product.prodname_cli %}.
@@ -34,7 +34,7 @@ Si ya tiene código fuente o repositorios almacenados localmente en el equipo o
{% data reusables.repositories.sensitive-info-warning %}
## <a name="adding-a-local-repository-to--data-variablesproductproduct_name--with--data-variablesproductprodname_cli-"></a>Agregar un repositorio local a {% data variables.product.product_name %} con la {% data variables.product.prodname_cli %}
## Agregar un repositorio local a {% data variables.product.product_name %} con la {% data variables.product.prodname_cli %}
1. En la línea de comandos, navega al directorio raíz de tu proyecto.
1. Inicializar el directorio local como un repositorio de Git.
@@ -55,18 +55,28 @@ Si ya tiene código fuente o repositorios almacenados localmente en el equipo o
1. Como alternativa, para omitir todas las solicitudes, proporcione la ruta de acceso al repositorio con la marca `--source` y pase una marca de visibilidad (`--public`, `--private` o `--internal`). Por ejemplo, `gh repo create --source=. --public`. Especifique un remoto con la marca `--remote`. Para insertar las confirmaciones, pase la marca `--push`. Para obtener más información acerca de los posibles argumentos, vea el [Manual de la CLI de GitHub](https://cli.github.com/manual/gh_repo_create).
## <a name="adding-a-local-repository-to--data-variablesproductproduct_name--using-git"></a>Agregar un repositorio local a {% data variables.product.product_name %} mediante Git
## Agregar un repositorio local a {% data variables.product.product_name %} mediante Git
{% mac %}
1. [Cree un repositorio](/repositories/creating-and-managing-repositories/creating-a-new-repository) en {% data variables.product.product_location %}. Para evitar errores, no inicialice el nuevo repositorio con el archivo *LÉAME*, la licencia o archivos `gitignore`. Puedes agregar estos archivos después de que tu proyecto se haya subido a {% data variables.product.product_name %}.
![Creación del menú desplegable Nuevo repositorio](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %}
3. Cambiar el directorio de trabajo actual en tu proyecto local.
4. Inicializar el directorio local como un repositorio de Git.
```shell
$ git init -b main
```
4. Utiliza el comando `init` para inicializar el directorio local como repositorio de Git. De forma predeterminada, la rama inicial se denomina `master`.
Si usas Git 2.28.0 o una versión posterior, puedes establecer el nombre de la rama predeterminada mediante `-b`.
``` shell
$ git init -b main
```
Si usas Git 2.27.1 o una versión anterior, puedes establecer el nombre de la rama predeterminada mediante `&& git symbolic-ref HEAD refs/heads/main`.
``` shell
$ git init && git symbolic-ref HEAD refs/heads/main
```
5. Agregar los archivos a tu nuevo repositorio local. Esto representa la primera confirmación.
```shell
$ git add .
# Adds the files in the local repository and stages them for commit. {% data reusables.git.unstage-codeblock %}
@@ -98,10 +108,19 @@ Si ya tiene código fuente o repositorios almacenados localmente en el equipo o
1. [Cree un repositorio](/articles/creating-a-new-repository) en {% data variables.product.product_location %}. Para evitar errores, no inicialice el nuevo repositorio con el archivo *LÉAME*, la licencia o archivos `gitignore`. Puedes agregar estos archivos después de que tu proyecto se haya subido a {% data variables.product.product_name %}.
![Creación del menú desplegable Nuevo repositorio](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %}
3. Cambiar el directorio de trabajo actual en tu proyecto local.
4. Inicializar el directorio local como un repositorio de Git.
```shell
$ git init -b main
```
4. Utiliza el comando `init` para inicializar el directorio local como repositorio de Git. De forma predeterminada, la rama inicial se denomina `master`.
Si usas Git 2.28.0 o una versión posterior, puedes establecer el nombre de la rama predeterminada mediante `-b`.
``` shell
$ git init -b main
```
Si usas Git 2.27.1 o una versión anterior, puedes establecer el nombre de la rama predeterminada mediante `&& git symbolic-ref HEAD refs/heads/main`.
``` shell
$ git init && git symbolic-ref HEAD refs/heads/main
```
5. Agregar los archivos a tu nuevo repositorio local. Esto representa la primera confirmación.
```shell
$ git add .
@@ -134,10 +153,19 @@ Si ya tiene código fuente o repositorios almacenados localmente en el equipo o
1. [Cree un repositorio](/articles/creating-a-new-repository) en {% data variables.product.product_location %}. Para evitar errores, no inicialice el nuevo repositorio con el archivo *LÉAME*, la licencia o archivos `gitignore`. Puedes agregar estos archivos después de que tu proyecto se haya subido a {% data variables.product.product_name %}.
![Creación del menú desplegable Nuevo repositorio](/assets/images/help/repository/repo-create.png) {% data reusables.command_line.open_the_multi_os_terminal %}
3. Cambiar el directorio de trabajo actual en tu proyecto local.
4. Inicializar el directorio local como un repositorio de Git.
```shell
$ git init -b main
```
4. Utiliza el comando `init` para inicializar el directorio local como repositorio de Git. De forma predeterminada, la rama inicial se denomina `master`.
Si usas Git 2.28.0 o una versión posterior, puedes establecer el nombre de la rama predeterminada mediante `-b`.
``` shell
$ git init -b main
```
Si usas Git 2.27.1 o una versión anterior, puedes establecer el nombre de la rama predeterminada mediante `&& git symbolic-ref HEAD refs/heads/main`.
``` shell
$ git init && git symbolic-ref HEAD refs/heads/main
```
5. Agregar los archivos a tu nuevo repositorio local. Esto representa la primera confirmación.
```shell
$ git add .
@@ -165,6 +193,6 @@ Si ya tiene código fuente o repositorios almacenados localmente en el equipo o
{% endlinux %}
## <a name="further-reading"></a>Información adicional
## Información adicional
- "[Agregar un archivo a un repositorio](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository#adding-a-file-to-a-repository-using-the-command-line)"

247
translations/es-ES/content/get-started/onboarding/getting-started-with-github-enterprise-cloud.md
View File

@@ -1,218 +1,223 @@
---
title: Getting started with GitHub Enterprise Cloud
intro: 'Get started with setting up and managing your {% data variables.product.prodname_ghe_cloud %} organization or enterprise account.'
title: Iniciar con GitHub Enterprise Cloud
intro: 'Inicia con la configuración y administración de tu cuenta organizacional o empresarial de {% data variables.product.prodname_ghe_cloud %}.'
versions:
fpt: '*'
ghec: '*'
ms.openlocfilehash: 249c89ad65bf9a9fc0140b8fb48e7bd0530ff594
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147389967'
---
This guide will walk you through setting up, configuring and managing your {% data variables.product.prodname_ghe_cloud %} account as an organization or enterprise owner.
Esta guía te mostrará cómo configurar, ajustar y administrar tu cuenta de {% data variables.product.prodname_ghe_cloud %} como organización o empresa.
{% data reusables.enterprise.ghec-cta-button %}
## Part 1: Choosing your account type
## Parte 1: Elegir tu tipo de cuenta
{% data variables.product.prodname_dotcom %} provides two types of Enterprise products:
{% data variables.product.prodname_dotcom %} proporciona dos tipos de productos empresariales:
- **{% data variables.product.prodname_ghe_cloud %}**
- **{% data variables.product.prodname_ghe_server %}**
The main difference between the products is that {% data variables.product.prodname_ghe_cloud %} is hosted by {% data variables.product.prodname_dotcom %}, while {% data variables.product.prodname_ghe_server %} is self-hosted.
La diferencia principal entre los productos es que {% data variables.product.prodname_dotcom %} hospeda a {% data variables.product.prodname_ghe_cloud %}, mientras que {% data variables.product.prodname_ghe_server %} es auto-hospedado.
{% data reusables.enterprise.about-github-for-enterprises %}
With {% data variables.product.prodname_ghe_cloud %}, you have the option of using {% data variables.product.prodname_emus %}. {% data reusables.enterprise-accounts.emu-short-summary %}
Con {% data variables.product.prodname_ghe_cloud %}, tienes la opción de utilizar {% data variables.product.prodname_emus %}. {% data reusables.enterprise-accounts.emu-short-summary %}
If you choose to let your members create and manage their own personal accounts instead, there are two types of accounts you can use with {% data variables.product.prodname_ghe_cloud %}:
Si en vez de esto eliges permitir que tus miembros creen y administren sus propias cuentas, hay dos tipos de cuentas que puedes utilizar con {% data variables.product.prodname_ghe_cloud %}:
- A single organization account
- An enterprise account that contains multiple organizations
- Una cuenta de organización simple
- Una cuenta empresarial que contiene varias organizaciones
### 1. Understanding the differences between an organization account and enterprise account
### 1. Descripción de las diferencias entre una cuenta de organización y una cuenta de empresa
Both organization and enterprise accounts are available with {% data variables.product.prodname_ghe_cloud %}. An organization is a shared account where groups of people can collaborate across many projects at once, and owners and administrators can manage access to data and projects. An enterprise account enables collaboration between multiple organizations, and allows owners to centrally manage policy, billing and security for these organizations. For more information on the differences, see "[Organizations and enterprise accounts](/organizations/collaborating-with-groups-in-organizations/about-organizations#organizations-and-enterprise-accounts)."
Tanto las cuentas de empresa como las de organización se encuentran disponibles con {% data variables.product.prodname_ghe_cloud %}. Una organización es una cuenta compartida en donde los grupos de personas pueden colaborar a través de varios proyectos a la vez y los propietarios y administradores pueden administrar el acceso a los datos y proyectos. Una cuenta empresarial habilita la colaboración entre organizaciones múltiples y permite a los propietarios administrar políticas centralmente, facturar y proporcionar seguridad a estas organizaciones. Para más información sobre las diferencias, vea "[Cuentas de organización y de empresa](/organizations/collaborating-with-groups-in-organizations/about-organizations#organizations-and-enterprise-accounts)".
If you choose an enterprise account, keep in mind that some policies can be set only at an organization level, while others can be enforced for all organizations in an enterprise.
Si eliges una cuenta empresarial, ten en mente que algunas políticas se configuran mejor a nivel organizacional, mientras que otras pueden requerirse para todas las organizaciones en una empresa.
Once you choose the account type you would like, you can proceed to setting up your account. In each of the sections in this guide, proceed to either the single organization or enterprise account section based on your account type.
Una vez que elijas el tipo de cuenta que te gustaría utilizar, puedes proceder a configurarla. En cada sección de esta guía, procede a ya sea la sección de organización simple o de cuenta empresarial de acuerdo con tu tipo de cuenta.
## Part 2: Setting up your account
To get started with {% data variables.product.prodname_ghe_cloud %}, you will want to create your organization or enterprise account and set up and view billing settings, subscriptions and usage.
### Setting up a single organization account with {% data variables.product.prodname_ghe_cloud %}
## Parte 2: Configurar tu cuenta
Para iniciar con {% data variables.product.prodname_ghe_cloud %}, necesitarás crear tu cuenta de organización o de empresa y configurar y ver los ajustes de facturación, suscripciones y uso.
### Configurar una cuenta de organización simple con {% data variables.product.prodname_ghe_cloud %}
#### 1. About organizations
Organizations are shared accounts where groups of people can collaborate across many projects at once. With {% data variables.product.prodname_ghe_cloud %}, owners and administrators can manage their organization with sophisticated user authentication and management, as well as escalated support and security options. For more information, see "[About organizations](/organizations/collaborating-with-groups-in-organizations/about-organizations)."
#### 2. Creating or upgrading an organization account
#### 1. Acerca de las organizaciones
Las organizaciones son cuentas compartidas en las que grupos de personas pueden colaborar en muchos proyectos a la vez. Con {% data variables.product.prodname_ghe_cloud %}, los propietarios y administradores pueden manejar su organización con una administración y autenticación de usuarios sofisticada, así como soporte escalado y opciones de seguridad. Para más información, vea "[Acerca de las organizaciones](/organizations/collaborating-with-groups-in-organizations/about-organizations)".
#### 2. Creación o actualización de una cuenta de organización
To use an organization account with {% data variables.product.prodname_ghe_cloud %}, you will first need to create an organization. When prompted to choose a plan, select "Enterprise". For more information, see "[Creating a new organization from scratch](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)."
Para utilizar una cuenta de organización con {% data variables.product.prodname_ghe_cloud %}, primero necesitarás crear una organización. Cuando se te pida elegir un plan, selecciona "Empresa". Para más información, vea "[Creación de una organización desde cero](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)".
Alternatively, if you have an existing organization account that you would like to upgrade, follow the steps in "[Upgrading your {% data variables.product.prodname_dotcom %} subscription](/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription#upgrading-your-organizations-subscription)."
#### 3. Setting up and managing billing
Como alternativa, si tiene una cuenta de organización existente que quiere actualizar, siga los pasos descritos en "[Actualización de la suscripción a {% data variables.product.prodname_dotcom %}](/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription#upgrading-your-organizations-subscription)".
#### 3. Configuración y administración de la facturación
When you choose to use an organization account with {% data variables.product.prodname_ghe_cloud %}, you'll first have access to a [30-day trial](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud). If you don't purchase {% data variables.product.prodname_enterprise %} or {% data variables.product.prodname_team %} before your trial ends, your organization will be downgraded to {% data variables.product.prodname_free_user %} and lose access to any advanced tooling and features that are only included with paid products. For more information, see "[Finishing your trial](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud#finishing-your-trial)."
Cuando decida usar una cuenta de organización con {% data variables.product.prodname_ghe_cloud %}, primero tendrá acceso a una [prueba de 30 días](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud). Si no compras {% data variables.product.prodname_enterprise %} o {% data variables.product.prodname_team %} antes de que termine tu periodo de prueba, tu organización bajará de nivel a {% data variables.product.prodname_free_user %} y perderá acceso a cualquier herramienta avanzada y características que solo se incluyan con los productos de pago. Para más información, vea "[Finalización de la prueba](/get-started/signing-up-for-github/setting-up-a-trial-of-github-enterprise-cloud#finishing-your-trial)".
Your organization's billing settings page allows you to manage settings like your payment method and billing cycle, view information about your subscription, and upgrade your storage and {% data variables.product.prodname_actions %} minutes. For more information on managing your billing settings, see "[Managing your {% data variables.product.prodname_dotcom %} billing settings](/billing/managing-your-github-billing-settings)."
La página de configuración de facturación de tu organización te permite administrar los ajustes como tu método de pago y ciclo de facturación, ver la información sobre tu suscripción y mejorar tu almacenamiento y minutos de {% data variables.product.prodname_actions %}. Para más información sobre cómo administrar la configuración de facturación, vea "[Administración de la configuración de facturación de {% data variables.product.prodname_dotcom %}](/billing/managing-your-github-billing-settings)".
Only organization members with the *owner* or *billing manager* role can access or change billing settings for your organization. A billing manager is a user who manages the billing settings for your organization and does not use a paid license in your organization's subscription. For more information on adding a billing manager to your organization, see "[Adding a billing manager to your organization](/organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization)."
Solo los miembros de la organización con los roles *propietario* o *administrador de facturación* pueden acceder a los valores de facturación de la organización o cambiarlos. Un gerente de facturación es un usuario que administra la configuración de facturación de tu organización y no utiliza una licencia en la suscripción de tu organización. Para más información sobre cómo agregar un administrador de facturación a la organización, vea "[Adición de un administrador de facturación a la organización](/organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization)".
### Setting up an enterprise account with {% data variables.product.prodname_ghe_cloud %}
### Configurar una cuenta empresarial con {% data variables.product.prodname_ghe_cloud %}
#### 1. About enterprise accounts
#### 1. Acerca de las cuentas de empresa
An enterprise account allows you to centrally manage policy and settings for multiple {% data variables.product.prodname_dotcom %} organizations, including member access, billing and usage and security. For more information, see "[About enterprise accounts](/enterprise-cloud@latest/admin/overview/about-enterprise-accounts)."
Una cuenta empresarial te permite administrar las políticas y ajustes centralmente para organizaciones múltiples de {% data variables.product.prodname_dotcom %}, incluyendo el acceso de los miembros, la facturación, el uso y la seguridad. Para más información, vea "[Acerca de las cuentas de empresa](/enterprise-cloud@latest/admin/overview/about-enterprise-accounts)".
#### 2. Creating an enterpise account
#### 2. Creación de una cuenta de empresa
{% data variables.product.prodname_ghe_cloud %} customers paying by invoice can create an enterprise account directly through {% data variables.product.prodname_dotcom %}. For more information, see "[Creating an enterprise account](/enterprise-cloud@latest/admin/overview/creating-an-enterprise-account)."
Los clientes de {% data variables.product.prodname_ghe_cloud %} que pagan mediante facturas pueden crear una cuenta de empresa directamente desde {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta "[Creación de una cuenta de empresa](/enterprise-cloud@latest/admin/overview/creating-an-enterprise-account)".
{% data variables.product.prodname_ghe_cloud %} customers not currently paying by invoice can contact [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact) to create an enterprise account for you.
Los clientes de {% data variables.product.prodname_ghe_cloud %} que actualmente no pagan mediante facturas pueden ponerse en contacto con el [equipo de ventas de {% data variables.product.prodname_dotcom %}](https://enterprise.github.com/contact) para que creen una cuenta de empresa en tu nombre.
#### 3. Adding organizations to your enterprise account
#### 3. Adición de organizaciones a la cuenta de empresa
You can create new organizations to manage within your enterprise account. For more information, see "[Adding organizations to your enterprise](/enterprise-cloud@latest/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise)."
Puedes crear nuevas organizaciones para administrar dentro de tu cuenta de empresa. Para más información, vea "[Adición de organizaciones a la empresa](/enterprise-cloud@latest/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise)".
Contact your {% data variables.product.prodname_dotcom %} sales account representative if you want to transfer an existing organization to your enterprise account.
#### 4. Viewing the subscription and usage for your enterprise account
You can view your current subscription, license usage, invoices, payment history, and other billing information for your enterprise account at any time. Both enterprise owners and billing managers can access and manage billing settings for enterprise accounts. For more information, see "[Viewing the subscription and usage for your enterprise account](/enterprise-cloud@latest/billing/managing-billing-for-your-github-account/viewing-the-subscription-and-usage-for-your-enterprise-account)."
Contacta a tu representante de cuenta de ventas de {% data variables.product.prodname_dotcom %} su quieres transferir una organización existente a tu cuenta empresarial.
#### 4. Visualización de la suscripción y el uso de la cuenta de empresa
Puedes ver tu suscripción actual, uso de licencia, facturas, historial de pagos y otra información de facturación de tu cuenta empresarial en cualquier momento. Tanto los propietarios de empresas como los gerentes de facturación pueden acceder y administrar la configuración de facturación para las cuentas empresariales. Para más información, vea "[Visualización de la suscripción y el uso de la cuenta de empresa](/enterprise-cloud@latest/billing/managing-billing-for-your-github-account/viewing-the-subscription-and-usage-for-your-enterprise-account)".
## Part 3: Managing your organization or enterprise members and teams with {% data variables.product.prodname_ghe_cloud %}
## Parte 3: Administrar los equipos y miembros de tu organización o empresa con {% data variables.product.prodname_ghe_cloud %}
### Managing members and teams in your organization
You can set permissions and member roles, create and manage teams, and give people access to repositories in your organization.
#### 1. Managing members of your organization
### Administrar a los miembros y equipos de tu organización
Puedes configurar los permisos y roles de los miembros, crear y administrar equipos y darles a las personas acceso a los repositorios de tu organización.
#### 1. Administración de miembros de la organización
{% data reusables.getting-started.managing-org-members %}
#### 2. Organization permissions and roles
#### 2. Permisos y roles de la organización
{% data reusables.getting-started.org-permissions-and-roles %}
#### 3. About and creating teams
#### 3. Acerca de los equipos y creación de equipos
{% data reusables.getting-started.about-and-creating-teams %}
#### 4. Managing team settings
#### 4. Administrar la configuración del equipo
{% data reusables.getting-started.managing-team-settings %}
#### 5. Giving people and teams access to repositories, project boards and apps
#### 5. Proporcionar acceso a repositorios, paneles de proyecto y aplicaciones a usuarios y equipos
{% data reusables.getting-started.giving-access-to-repositories-projects-apps %}
### Managing members of an enterprise account
Managing members of an enterprise is separate from managing members or teams in an organization. It is important to note that enterprise owners or administrators cannot access organization-level settings or manage members for organizations in their enterprise unless they are made an organization owner. For more information, see the above section, "[Managing members and teams in your organization](#managing-members-and-teams-in-your-organization)."
### Administrar a los miembros de una cuenta empresarial
Administrar a los miembros de una empresa es algo separado de administrar a los miembros o equipos de una organización. Es importante notar que los propietarios o administradores de una empresa no pueden acceder a los ajustes a nivel organizacional ni administrar a los miembros de las organizaciones en su empresa a menos de que se les haga un propietario de organización. Para más información, vea la sección anterior, "[Administración de miembros y equipos en la organización](#managing-members-and-teams-in-your-organization)".
If your enterprise uses {% data variables.product.prodname_emus %}, your members are fully managed through your identity provider. Adding members, making changes to their membership, and assigning roles is all managed using your IdP. For more information, see "[About {% data variables.product.prodname_emus %}](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users)."
Si tu empresa utiliza {% data variables.product.prodname_emus %}, tus miembros se administrarán integralmente mediante tu proveedor de identidad. Tanto la adición de miembros, hacer cambios a sus membrecías y asignar roles se administra utilizando tu IdP. Para más información, vea "[Acerca de {% data variables.product.prodname_emus %}](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users)".
If your enterprise does not use {% data variables.product.prodname_emus %}, follow the steps below.
Si tu empresa no utiliza {% data variables.product.prodname_emus %}, sigue estos pasos.
#### 1. Assigning roles in an enterprise
By default, everyone in an enterprise is a member of the enterprise. There are also administrative roles, including enterprise owner and billing manager, that have different levels of access to enterprise settings and data. For more information, see "[Roles in an enterprise](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)."
#### 2. Inviting people to manage your enterprise
You can invite people to manage your enterprise as enterprise owners or billing managers, as well as remove those who no longer need access. For more information, see "[Inviting people to manage your enterprise](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise)."
#### 1. Asignación de roles en una empresa
Predeterminadamente, cualquiera en una empresa es un miembro de ella. También existen roles administrativos, incluyendo el del propietario y gerente de facturación, que tienen niveles diferentes de acceso a los datos y ajustes de una empresa. Para más información, vea "[Roles en una empresa](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)".
#### 2. Invitación a usuarios a administrar la empresa
Puedes invitar a personas para que administren tu empresa como propietarios o gerentes de facturación, así como eliminar a los que ya no necesiten acceso. Para más información, vea "[Invitación a usuarios a administrar la empresa](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise)".
You can also grant enterprise members the ability to manage support tickets in the support portal. For more information, see "[Managing support entitlements for your enterprise](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/managing-support-entitlements-for-your-enterprise)."
#### 3. Viewing people in your enterprise
To audit access to enterprise-owned resources or user license usage, you can view every enterprise administrator, enterprise member, and outside collaborator in your enterprise. You can see the organizations that a member belongs to and the specific repositories that an outside collaborator has access to. For more information, see "[Viewing people in your enterprise](/admin/user-management/managing-users-in-your-enterprise/viewing-people-in-your-enterprise)."
También puedes otorgar a los miembros de la empresa la capacidad para que administren tickets de soporte en el portal de soporte. Para más información, vea "[Administración de derechos de soporte técnico para su empresa](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/managing-support-entitlements-for-your-enterprise)".
#### 3. Visualización de personas en la empresa
Para auditar el acceso a los recursos que pertenecen a la empresa o al uso de licencias de los usuarios, puedes ver a todos los administradores, miembros y colaboradores externos de tu empresa. Puedes ver las organizaciones a las cuales pertenece un miembro y especificar los repositorios a los cuales tiene acceso un colaborador. Para más información, vea "[Visualización de personas en la empresa](/admin/user-management/managing-users-in-your-enterprise/viewing-people-in-your-enterprise)".
## Part 4: Managing security with {% data variables.product.prodname_ghe_cloud %}
## Parte 4: Administrar la seguridad con {% data variables.product.prodname_ghe_cloud %}
* [Managing security for a single organization](#managing-security-for-a-single-organization)
* [Managing security for an {% data variables.product.prodname_emu_enterprise %}](#managing-security-for-an-enterprise-with-managed-users)
* [Managing security for an enterprise account without {% data variables.product.prodname_managed_users %}](#managing-security-for-an-enterprise-account-without-managed-users)
* [Administración de la seguridad de una sola organización](#managing-security-for-a-single-organization)
* [Administración de la seguridad de una {% data variables.product.prodname_emu_enterprise %}](#managing-security-for-an-enterprise-with-managed-users)
* [Administración de la seguridad de una cuenta de empresa sin {% data variables.product.prodname_managed_users %}](#managing-security-for-an-enterprise-account-without-managed-users)
### Managing security for a single organization
You can help keep your organization secure by requiring two-factor authentication, configuring security features, reviewing your organization's audit log and integrations, and enabling SAML single sign-on and team synchronization.
#### 1. Requiring two-factor authentication
### Administrar la seguridad para una sola organización
Puedes ayudar a que tu organización se mantenga protegida requiriendo autenticación bifactorial, configurando las características de seguridad, revisando las bitácoras de auditoría e integraciones de tu organización y habilitando el inicio de sesión único de SAML y la sincronización de equipos.
#### 1. Obligatoriedad de la autenticación en dos fases
{% data reusables.getting-started.requiring-2fa %}
#### 2. Configuring security features for your organization
#### 2. Configurar las características de seguridad de la organización
{% data reusables.getting-started.configuring-security-features %}
#### 3. Reviewing your organization's audit log and integrations
#### 3. Revisar el registro de auditoría y las integraciones de la organización
{% data reusables.getting-started.reviewing-org-audit-log-and-integrations %}
#### 4. Enabling and enforcing SAML single sign-on for your organization
If you manage your applications and the identities of your organization members with an identity provider (IdP), you can configure SAML single-sign-on (SSO) to control and secure access to organization resources like repositories, issues and pull requests. When members of your organization access organization resources that use SAML SSO, {% data variables.product.prodname_dotcom %} will redirect them to your IdP to authenticate. For more information, see "[About identity and access management with SAML single sign-on](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)."
#### 4. Habilitación y aplicación del inicio de sesión único de SAML para la organización
Si administras tus aplicaciones y las identidades de tus miembros de la organización con un proveedor de identidad (IdP), puedes configurar el inicio de sesión único (SSO) de SAML para controlar y proteger el acceso a los recursos organizacionales como los repositorios, propuestas y solicitudes de cambio. Cuando los miembros de tu organización acceden a los recursos de la misma que utilicen el SSO de SAML, {% data variables.product.prodname_dotcom %} los redireccionará a tu IdP para autenticarse. Para más información, vea "[Acerca de la administración de identidades y acceso con el inicio de sesión único de SAML](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)".
Organization owners can choose to disable, enable but not enforce, or enable and enforce SAML SSO. For more information, see "[Enabling and testing SAML single sign-on for your organization](/organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization)" and "[Enforcing SAML single sign-on for your organization](/organizations/managing-saml-single-sign-on-for-your-organization/enforcing-saml-single-sign-on-for-your-organization)."
#### 5. Managing team synchronization for your organization
Organization owners can enable team synchronization between your identity provider (IdP) and {% data variables.product.prodname_dotcom %} to allow organization owners and team maintainers to connect teams in your organization with IdP groups. For more information, see "[Managing team synchronization for your organization](/organizations/managing-saml-single-sign-on-for-your-organization/managing-team-synchronization-for-your-organization)."
Los propietarios de la organización pueden elegir inhabilitar, habilitar pero no requerir o habilitar y requerir el SSO de SAML. Para más información, vea ["Habilitación y prueba del inicio de sesión único de SAML para la organización](/organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization)" y "[Aplicación del inicio de sesión único de SAML para la organización](/organizations/managing-saml-single-sign-on-for-your-organization/enforcing-saml-single-sign-on-for-your-organization)".
#### 5. Administración de la sincronización de equipos para la organización
Los propietarios de la organización pueden habilitar la sincronización de equipos entre tu proveedor de identidad (IdP) y {% data variables.product.prodname_dotcom %} para permitir que los propietarios organizacionales y mantenedores de equipo conecten equipos en tu organización con los grupos de IdP. Para más información, vea "[Administración de la sincronización de equipos para la organización](/organizations/managing-saml-single-sign-on-for-your-organization/managing-team-synchronization-for-your-organization)".
### Managing security for an {% data variables.product.prodname_emu_enterprise %}
### Administrar la seguridad para una {% data variables.product.prodname_emu_enterprise %}
With {% data variables.product.prodname_emus %}, access and identity is managed centrally through your identity provider. Two-factor authentication and other login requirements should be enabled and enforced on your IdP.
Con {% data variables.product.prodname_emus %}, el acceso y la identidad se administran centralmente mediante tu proveedor de identidad. La autenticación bifactorial y otros requisitos de inicio de sesión deben habilitarse y requerirse en tu IdP.
#### 1. Enabling and SAML single sign-on and provisioning in your {% data variables.product.prodname_emu_enterprise %}
#### 1. Habilitación del inicio de sesión único de SAML y el aprovisionamiento en {% data variables.product.prodname_emu_enterprise %}
In an {% data variables.product.prodname_emu_enterprise %}, all members are provisioned and managed by your identity provider. You must enable SAML SSO and SCIM provisioning before you can start using your enterprise. For more information on configuring SAML SSO and provisioning for an {% data variables.product.prodname_emu_enterprise %}, see "[Configuring SAML single sign-on for Enterprise Managed Users](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/configuring-saml-single-sign-on-for-enterprise-managed-users)."
En una {% data variables.product.prodname_emu_enterprise %}, tu proveedor de identidad administra y aprovisiona a todos los miembros. Debes habilitar el SSO de SAML y el aprovisionamiento de SCIM antes de que puedas comenzar a utilizar tu empresa. Para más información sobre cómo configurar el inicio de sesión único y el aprovisionamiento de SAML para una instancia de {% data variables.product.prodname_emu_enterprise %}, vea "[Configuración del inicio de sesión único de SAML para usuarios administrados de la empresa](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/configuring-saml-single-sign-on-for-enterprise-managed-users)".
#### 2. Managing teams in your {% data variables.product.prodname_emu_enterprise %} with your identity provider
#### 2. Administración de equipos en {% data variables.product.prodname_emu_enterprise %} con el proveedor de identidades
You can connect teams in your organizations to security groups in your identity provider, managing membership of your teams and access to repositories through your IdP. For more information, see "[Managing team memberships with identity provider groups](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/managing-team-memberships-with-identity-provider-groups)."
Puedes conectar equipos en tus organizaciones a grupos de seguridad en tu proveedor de identidad, administrar la membrecía de tus equipos y acceder a repositorios mediante tu IdP. Para más información sobre cómo administrar equipos, vea "[Administración de pertenencias a equipos con grupos de proveedores de identidades](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/managing-team-memberships-with-identity-provider-groups)".
#### 3. Managing allowed IP addresses for organizations in your {% data variables.product.prodname_emu_enterprise %}
#### 3. Administración de direcciones IP permitidas para las organizaciones en {% data variables.product.prodname_emu_enterprise %}
You can configure an allow list for specific IP addresses to restrict access to assets owned by organizations in your {% data variables.product.prodname_emu_enterprise %}. For more information, see "[Enforcing policies for security settings in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-allowed-ip-addresses-for-organizations-in-your-enterprise)."
Puedes configurar una lista de direcciones permitidas para IP específicas para restringir el acceso a los activos que pertenecen a las organizaciones de tu {% data variables.product.prodname_emu_enterprise %}. Para más información, vea "[Aplicación de directivas de configuración de seguridad en la empresa](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-allowed-ip-addresses-for-organizations-in-your-enterprise)".
#### 4. Enforcing policies for Advanced Security features in your {% data variables.product.prodname_emu_enterprise %}
#### 4. Aplicación de directivas para las características de Seguridad avanzada en {% data variables.product.prodname_emu_enterprise %}
{% data reusables.getting-started.enterprise-advanced-security %}
### Managing security for an enterprise account without {% data variables.product.prodname_managed_users %}
To manage security for your enterprise, you can require two-factor authentication, manage allowed IP addresses, enable SAML single sign-on and team synchronization at an enterprise level, and sign up for and enforce GitHub Advanced Security features.
### Administrar la seguridad para una cuenta empresarial sin {% data variables.product.prodname_managed_users %}
Para administrar la seguridad de tu empresa, puedes requerir la autenticación bifactorial, administrar las direcciones IP permitidas, habilitar el inicio de sesión único de SAML y la sincronización de equipos a nivel empresaria y darte de alta para y requerir las características de la Seguridad Avanzada de GitHub.
#### 1. Requiring two-factor authentication and managing allowed IP addresses for organizations in your enterprise account
Enterprise owners can require that organization members, billing managers, and outside collaborators in all organizations owned by an enterprise account use two-factor authentication to secure their personal accounts. Before doing so, we recommend notifying all who have access to organizations in your enterprise. You can also configure an allow list for specific IP addresses to restrict access to assets owned by organizations in your enterprise account.
#### 1. Obligatoriedad de la autenticación en dos fases y administración de direcciones IP permitidas para las organizaciones en la cuenta de empresa
Los propietarios de empresa pueden requerir que los miembros de la organización, gerentes de facturación y colaboradores externos en todas las organizaciones que sean propiedad de una cuenta de empresa usen autenticación de dos factores para proteger sus cuentas personales. Antes de hacerlo, te recomendamos notificar a todos los que tengan acceso a las organizaciones de tu empresa. También puedes configurar una lista de direcciones IP permitidas específicas para restringir el acceso a los activos que pertenecen a las organizaciones en tu cuenta empresarial.
For more information on enforcing two-factor authentication and allowed IP address lists, see "[Enforcing policies for security settings in your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise)."
#### 2. Enabling and enforcing SAML single sign-on for organizations in your enterprise account
You can centrally manage access to your enterprise's resources, organization membership and team membership using your IdP and SAM single sign-on (SSO). Enterprise owners can enable SAML SSO across all organizations owned by an enterprise account. For more information, see "[About identity and access management for your enterprise](/enterprise-cloud@latest/admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise)."
Para más información sobre la aplicación de la autenticación en dos fases y las listas de direcciones IP permitidas, vea "[Aplicación de directivas para la configuración de seguridad en la empresa](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise)".
#### 2. Habilitación y aplicación del inicio de sesión único de SAML para organizaciones en la cuenta de empresa
Puedes administrar centralmente el acceso a los recursos de tu empresa, la membrecía organizacional y la de equipo utilizando tu IdP e inicio de sesión único (SSO) de SAML. Los propietarios de empresas pueden habilitar el SSO de SAML a través de todas las organizaciones que pertenezcan a una cuenta empresarial. Para más información, vea "[Acerca de la administración de identidades y acceso para la empresa](/enterprise-cloud@latest/admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise)".
#### 3. Managing team synchronization
You can enable and manage team synchronization between an identity provider (IdP) and {% data variables.product.prodname_dotcom %} to allow organizations owned by your enterprise account to manage team membership with IdP groups. For more information, see "[Managing team synchronization for organizations in your enterprise account](/enterprise-cloud@latest/admin/authentication/managing-identity-and-access-for-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise)."
#### 3. Administración de la sincronización de equipos
Puedes habilitar y administrar la sincronización de equipos entre un proveedor de identidad (IdP) y {% data variables.product.prodname_dotcom %} para permitir que las organizaciones que pertenezcan a tu cuenta empresarial administren la membrecía de los equipos con grupos de IdP. Para más información, vea "[Administración de la sincronización de equipos para organizaciones en la cuenta de empresa](/enterprise-cloud@latest/admin/authentication/managing-identity-and-access-for-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise)".
#### 4. Enforcing policies for Advanced Security features in your enterprise account
#### 4. Aplicación de directivas para las características de Seguridad avanzada en la cuenta de empresa
{% data reusables.getting-started.enterprise-advanced-security %}
## Part 5: Managing organization and enterprise level policies and settings
## Parte 5: Administrar políticas y ajustes a nivel de empresa y organización
### Managing settings for a single organization
To manage and moderate your organization, you can set organization policies, manage permissions for repository changes, and use organization-level community health files.
#### 1. Managing organization policies
### Administrar los ajustes para una sola organización
Para administrar y moderar tu organización, puedes configurar políticas de organización, administrar permisos para los cambios de repositorio y utilizar archivos de salud comunitaria a nivel de las organizaciones.
#### 1. Administración de directivas de la organización
{% data reusables.getting-started.managing-org-policies %}
#### 2. Managing repository changes
#### 2. Administrar cambios en el repositorio
{% data reusables.getting-started.managing-repo-changes %}
#### 3. Using organization-level community health files and moderation tools
#### 3. Usar archivos de mantenimiento y herramientas de moderación de la comunidad de nivel de organización
{% data reusables.getting-started.using-org-community-files-and-moderation-tools %}
### Managing settings for an enterprise account
To manage and moderate your enterprise, you can set policies for organizations within the enterprise, view audit logs, configure webhooks, and restrict email notifications.
#### 1. Managing policies for organizations in your enterprise account
### Administrar los ajustes de una cuenta empresarial
Para administrar y moderar tu empresa, puedes configurar políticas para las organizaciones dentro de la empresa, ver las bitácoras de auditoría, configurar webhooks y restringir las notificaciones por correo electrónico.
#### 1. Administración de directivas para organizaciones en la cuenta de empresa
You can choose to enforce a number of policies for all organizations owned by your enterprise, or choose to allow these policies to be set in each organization. Types of policies you can enforce include repository management, project board, and team policies. For more information, see "[Setting policies for your enterprise](/enterprise-cloud@latest/admin/policies)."
#### 2. Viewing audit logs, configuring webhooks, and restricting email notifications for your enterprise
You can view actions from all of the organizations owned by your enterprise account in the enterprise audit log. You can also configure webhooks to receive events from organizations owned by your enterprise account. For more information, see "[Reviewing audit logs for your enterprise](/enterprise-cloud@latest/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise)" and "[Monitoring your enterprise](/enterprise-cloud@latest/admin/monitoring-activity-in-your-enterprise)."
Puedes elegir el requerir varias políticas para todas las organizaciones que pertenezcan a tu empresa o elegir permitir que estas políticas se configuren en cada organización. Los tipos de políticas que puedes requerir incluyen la administración de repositorios, tablero de proyectos y políticas de equipo. Para más información, vea "[Configuración de directivas para la empresa](/enterprise-cloud@latest/admin/policies)".
#### 2. Visualización de registros de auditoría, configuración de webhooks y restricción de notificaciones por correo electrónico para la empresa
Puedes ver las acciones de todas las organizaciones que pertenezcan a tu cuenta empresarial en la bitácora de auditoría empresarial. También puedes configurar webhooks para recibir eventos de organizaciones que pertenecen a tu cuenta de empresa. Para más información, vea "[Revisión de los registros de auditoría de la empresa](/enterprise-cloud@latest/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise)" y "[Supervisión de la empresa](/enterprise-cloud@latest/admin/monitoring-activity-in-your-enterprise)".
You can also restrict email notifications for your enterprise account so that enterprise members can only use an email address in a verified or approved domain to receive notifications. For more information, see "[Restricting email notifications for your enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/restricting-email-notifications-for-your-enterprise)."
También puedes restringir las notificaciones por correo electrónico de tu cuenta empresarial para que los miembros de tu empresa solo puedan utilizar una dirección de correo electrónico en un dominio aprobado o verificado para recibir notificaciones. Para más información, vea "[Restricción de las notificaciones por correo electrónico para una empresa](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/restricting-email-notifications-for-your-enterprise)".
## Part 6: Customizing and automating your organization or enterprise's work on {% data variables.product.prodname_dotcom %}
Members of your organization or enterprise can use tools from the {% data variables.product.prodname_marketplace %}, the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API, and existing {% data variables.product.product_name %} features to customize and automate your work.
## Parte 6: Personalizar y automatizar el trabajo de tu organización o empresa en {% data variables.product.prodname_dotcom %}
Los miembros de tu organización o empresa pueden utilizar herramientas desde {% data variables.product.prodname_marketplace %}, la API de {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} y las características existentes de {% data variables.product.product_name %} para personalizar y automatizar tu trabajo.
### 1. Using {% data variables.product.prodname_marketplace %}
### 1. Uso de {% data variables.product.prodname_marketplace %}
{% data reusables.getting-started.marketplace %}
### 2. Using the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API
### 2. Uso de la API de {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %}
{% data reusables.getting-started.api %}
### 3. Building {% data variables.product.prodname_actions %}
### 3. Creación de {% data variables.product.prodname_actions %}
{% data reusables.getting-started.actions %}
### 4. Publishing and managing {% data variables.product.prodname_registry %}
### 4. Publicación y administración de {% data variables.product.prodname_registry %}
{% data reusables.getting-started.packages %}
### 5. Using {% data variables.product.prodname_pages %}
{% data variables.product.prodname_pages %} is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository and publishes a website. You can manage the publication of {% data variables.product.prodname_pages %} sites at the organization level. For more information, see "[Managing the publication of {% data variables.product.prodname_pages %} sites for your organization](/organizations/managing-organization-settings/managing-the-publication-of-github-pages-sites-for-your-organization)" and "[About {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages)."
## Part 7: Participating in {% data variables.product.prodname_dotcom %}'s community
### 5. Uso de {% data variables.product.prodname_pages %}
{% data variables.product.prodname_pages %} es un servicio de hospedaje de sitios estáticos que toma archivos de HTML, CSS y JavaScript directamente desde un repositorio y publica un sitio web. Puedes administrar la publicación de los sitios de {% data variables.product.prodname_pages %} a nivel organizacional. Para más información, vea "[Administración de la publicación de sitios de {% data variables.product.prodname_pages %} para la organización](/organizations/managing-organization-settings/managing-the-publication-of-github-pages-sites-for-your-organization)" y "[Acerca de {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages)".
## Parte 7: Participar en la comunidad de {% data variables.product.prodname_dotcom %}
Members of your organization or enterprise can use GitHub's learning and support resources to get the help they need. You can also support the open source community.
Los miembros de tu organización o empresa pueden utilizar los recursos de apoyo y aprendizaje de GitHub para obtener la ayuda que necesitan. También puedes apoyar a la comunidad de código abierto.
### 1. Reading about {% data variables.product.prodname_ghe_cloud %} on {% data variables.product.prodname_docs %}
You can read documentation that reflects the features available with {% data variables.product.prodname_ghe_cloud %}. For more information, see "[About versions of {% data variables.product.prodname_docs %}](/get-started/learning-about-github/about-versions-of-github-docs)."
### 1. Lectura sobre {% data variables.product.prodname_ghe_cloud %} en {% data variables.product.prodname_docs %}
Puedes leer la documentación que refleje las características disponibles en {% data variables.product.prodname_ghe_cloud %}. Para más información, vea "[Acerca de las versiones de {% data variables.product.prodname_docs %}](/get-started/learning-about-github/about-versions-of-github-docs)".
### 2. Learning with {% data variables.product.prodname_learning %}
Members of your organization or enterprise can learn new skills by completing fun, realistic projects in your very own GitHub repository with [{% data variables.product.prodname_learning %}](https://skills.github.com/). Each course is a hands-on lesson created by the GitHub community and taught by a friendly bot.
### 2. Aprendizaje con {% data variables.product.prodname_learning %}
Los miembros de la organización o la empresa pueden aprender aptitudes nuevas si completan proyectos divertidos y realistas en su propio repositorio de GitHub con [{% data variables.product.prodname_learning %}](https://skills.github.com/). Cada curso es una lección práctica que ha creado la comunidad de GitHub y lo imparte un simpático bot.
For more information, see "[Git and {% data variables.product.prodname_dotcom %} learning resources](/github/getting-started-with-github/quickstart/git-and-github-learning-resources)."
### 3. Supporting the open source community
Para más información, vea "[Recursos de aprendizaje para Git y {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/quickstart/git-and-github-learning-resources)".
### 3. Apoyo para la comunidad de código abierto
{% data reusables.getting-started.sponsors %}
### 4. Contacting {% data variables.contact.github_support %}
### 4. Contacto con {% data variables.contact.github_support %}
{% data reusables.getting-started.contact-support %}
{% data variables.product.prodname_ghe_cloud %} allows you to submit priority support requests with a target eight-hour response time. For more information, see "[{% data variables.product.prodname_ghe_cloud %} support](/github/working-with-github-support/github-enterprise-cloud-support)."
{% data variables.product.prodname_ghe_cloud %} te permite emitir solicitudes de soporte prioritario con un tiempo de respuesta de ocho horas. Para más información, vea "[Soporte técnico de {% data variables.product.prodname_ghe_cloud %}](/github/working-with-github-support/github-enterprise-cloud-support)".

41
translations/es-ES/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects.md
View File

@@ -1,41 +1,46 @@
---
title: 'Managing visibility of your {% data variables.projects.projects_v2 %}'
title: 'Administración de la visibilidad de las instancias de {% data variables.projects.projects_v2 %}'
shortTitle: 'Managing {% data variables.projects.project_v2 %} visibility'
intro: 'Learn about setting your {% data variables.projects.project_v2 %} to private or public visibility.'
intro: 'Obtén información sobre cómo establecer {% data variables.projects.project_v2 %} en visibilidad privada o pública.'
miniTocMaxHeadingLevel: 3
versions:
feature: "projects-v2"
feature: projects-v2
redirect_from:
- /issues/trying-out-the-new-projects-experience/managing-the-visibility-of-your-projects
type: tutorial
topics:
- Projects
allowTitleToDifferFromFilename: true
permissions: 'Organization owners can manage the visibility of project boards in their organization. Organization owners can also allow collaborators with admin permissions to manage project visibility. Visibility of user projects can be managed by the owner of the project and collaborators with admin permissions.'
permissions: Organization owners can manage the visibility of project boards in their organization. Organization owners can also allow collaborators with admin permissions to manage project visibility. Visibility of user projects can be managed by the owner of the project and collaborators with admin permissions.
ms.openlocfilehash: 0fcd51dc996f28103179835f05fc74941eb1daee
ms.sourcegitcommit: fd8ebcd1ce75cc30bf063dbcc886e3df98c4c871
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/06/2022
ms.locfileid: '147854064'
---
## Acerca de la visibilidad de los proyectos
## About project visibility
Los proyectos pueden ser públicos o privados. En el caso de los proyectos públicos, toda persona con acceso a internet puede verlos. Para el caso de los proyectos privados, solo podrán verlos los usuarios a los que se les otorgó por lo menos acceso de lectura.
Projects can be public or private. For public projects, everyone on the internet can view the project. For private projects, only users granted at least read access can see the project.
Solo se afecta la visibilidad del proyecto; para ver un elemento en el proyecto, alguien debe tener los permisos requeridos para el repositorio al cual pertenece este. Si tu proyecto incluye elementos de un repositorio privado, las personas que no sean colaboradores en el repositorio no podrán ver elementos de este.
Only the project visibility is affected; to view an item on the project, someone must have the required permissions for the repository that the item belongs to. If your project includes items from a private repository, people who are not collaborators in the repository will not be able to view items from that repository.
![Proyecto con un elemento oculto](/assets/images/help/projects/hidden-items.png)
![Project with hidden item](/assets/images/help/projects/hidden-items.png)
Los administradores de proyectos y los propietarios de la organización pueden controlar la visibilidad del proyecto. Los propietarios de la organización{% ifversion project-visibility-policy %} y los propietarios de empresa{% endif %} pueden restringir la capacidad de cambiar la visibilidad del proyecto solo a los propietarios de la organización.
Project admins and organization owners can control project visibility. Organization owners{% ifversion project-visibility-policy %} and enterprise owners{% endif %} can restrict the ability to change project visibility to just organization owners.
En proyectos públicos y privados, las conclusiones solo son visibles para los usuarios con permisos de escritura para el proyecto.
In public and private projects, insights are only visible to users with write permissions for the project.
En los proyectos privados que pertenecen a las organizaciones, los avatares de los usuarios que actualmente hacen actualizaciones al mismo se muestran en su IU.
In private, organization-owned projects, the avatars of users who are current making updates to the project are displayed in the project UI.
Los administradores de proyecto también pueden administrar el acceso administrativo y de escritura al mismo, así como controlar el acceso para los usuarios individuales. Para más información, consulta "[Administración del acceso a los proyectos](/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects)".
Project admins can also manage write and admin access to their project and control read access for individual users. For more information, see "[Managing access to your projects](/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects)."
## Changing project visibility
## Cambiar la visibilidad de proyecto
{% data reusables.projects.project-settings %}
1. Next to **Visibility** in the "Danger zone", select **Private** or **Public**.
![Screenshot showing the visibility controls](/assets/images/help/projects-v2/visibility.png)
1. Junto a **Visibilidad** en "Zona de peligro", selecciona **Privado** o **Público**.
![Captura de pantalla en la que se muestran los controles de visibilidad](/assets/images/help/projects-v2/visibility.png)
## Further reading
## Información adicional
- [Allowing project visibility changes in your organization](/organizations/managing-organization-settings/allowing-project-visibility-changes-in-your-organization)
- [Cambios en la visibilidad del proyecto permitidos en la organización](/organizations/managing-organization-settings/allowing-project-visibility-changes-in-your-organization)

47
translations/es-ES/content/organizations/managing-organization-settings/allowing-project-visibility-changes-in-your-organization.md
View File

@@ -1,39 +1,40 @@
---
title: 'Allowing project visibility changes in your organization'
intro: 'Organization owners can allow members with admin permissions to adjust the visibility of {% data variables.projects.projects_v2_and_v1 %} in their organization.'
title: Cambios en la visibilidad del proyecto permitidos en la organización
intro: 'Los propietarios de la organización pueden permitir que los miembros con permisos de administrador ajusten la visibilidad de {% data variables.projects.projects_v2_and_v1 %} de su organización.'
versions:
feature: "classic-project-visibility-permissions-or-projects-v2"
feature: classic-project-visibility-permissions-or-projects-v2
topics:
- Organizations
- Projects
shortTitle: 'Project visibility permissions'
shortTitle: Project visibility permissions
allowTitleToDifferFromFilename: true
permissions: Organization owners can allow {% data variables.projects.project_v2_and_v1 %} visibility changes for an organization.
permissions: 'Organization owners can allow {% data variables.projects.project_v2_and_v1 %} visibility changes for an organization.'
ms.openlocfilehash: 784b0f35ff86a1a2620a0c96d4e951a8ca28e136
ms.sourcegitcommit: fd8ebcd1ce75cc30bf063dbcc886e3df98c4c871
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/06/2022
ms.locfileid: '147854088'
---
## Acerca de los cambios de visibilidad de los proyectos
## About visibility changes for projects
Puedes restringir quién puede cambiar la visibilidad de {% data variables.projects.projects_v2_and_v1 %} de la organización, por ejemplo, limitar los miembros que pueden cambiar {% data variables.projects.projects_v2_and_v1 %} de privado a público.
You can restrict who has the ability to change the visibility of {% data variables.projects.projects_v2_and_v1 %} in your organization, such as restricting members from changing {% data variables.projects.projects_v2_and_v1 %} from private to public.
También puedes limitar la capacidad de cambiar la visibilidad de {% data variables.projects.project_v2_and_v1 %} solo a los propietarios de la organización, o bien permitir que cualquiera con permisos de administración pueda cambiar la visibilidad.
You can limit the ability to change {% data variables.projects.project_v2_and_v1 %} visibility to just organization owners, or you can allow anyone granted admin permissions to change the visibility.
{% ifversion project-visibility-policy %}
This option may not be available to you if an enterprise owner restricts visibility changes for {% data variables.projects.projects_v2_and_v1 %} at the enterprise level. For more information, see "[Enforcing policies for projects in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-projects-in-your-enterprise)."
{% ifversion project-visibility-policy %} Es posible que esta opción no esté disponible si un propietario de la empresa restringe los cambios de visibilidad para {% data variables.projects.projects_v2_and_v1 %} en el nivel empresarial. Para más información, consulta "[Requerir políticas para proyectos en tu empresa](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-projects-in-your-enterprise)".
{% endif %}
## Allowing members to change project visibilities
## Permitir que los miembros cambien las visibilidades del proyecto
{% data reusables.profile.access_org %}
{% data reusables.profile.org_settings %}
1. In the "Code, planning, and automation" section of the sidebar, click **{% octicon "table" aria-label="The table icon" %} Projects**.
1. To allow members to adjust project visibility, select **Allow members to change project visibilities for this organization**.
![Screenshot showing checkbox to set visibility changes](/assets/images/help/projects-v2/visibility-change-checkbox.png)
1. Click **Save**.
{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %}
1. En la sección de "Código, planificación y automatización" de la barra lateral, haz clic en **{% octicon "table" aria-label="The table icon" %} Proyectos**.
1. Para permitir que los miembros ajusten la visibilidad del proyecto, selecciona **Permitir que los miembros cambien las visibilidades del proyecto para esta organización**.
![Captura de pantalla en la que se muestra la casilla para establecer los cambios de visibilidad](/assets/images/help/projects-v2/visibility-change-checkbox.png)
1. Haga clic en **Save**(Guardar).
## Further reading
## Información adicional
{% ifversion projects-v2 %}
- "[Managing visibility of your {% data variables.projects.projects_v2 %}](/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects)"
{%- endif %}{%- ifversion projects-v1 %}
- "[Changing {% data variables.product.prodname_project_v1 %} visibility](/issues/organizing-your-work-with-project-boards/managing-project-boards/changing-project-board-visibility)"
{% endif %}
- "[Administración de la visibilidad de {% data variables.projects.projects_v2 %}](/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects)" {%- endif %}{%- ifversion projects-v1 %}
- "[Cambio de la visibilidad de {% data variables.product.prodname_project_v1 %}](/issues/organizing-your-work-with-project-boards/managing-project-boards/changing-project-board-visibility)" {% endif %}

44
translations/es-ES/content/organizations/managing-organization-settings/disabling-project-boards-in-your-organization.md
View File

@@ -1,6 +1,6 @@
---
title: 'Disabling {% ifversion projects-v2 %}projects{% else %}project boards{% endif %} in your organization'
intro: 'Organization owners can turn off {% ifversion projects-v2 %}organization-wide {% data variables.projects.projects_v2 %}, organization-wide {% data variables.projects.projects_v1_boards %}, and repository-level {% data variables.projects.projects_v1_boards %}{% else %}organization-wide project boards and repository project boards{% endif %} in an organization.'
title: 'Deshabilitación de {% ifversion projects-v2 %}proyectos{% else %}paneles de proyecto{% endif %} en la organización'
intro: 'Los propietarios de la organización pueden desactivar instancias de {% data variables.projects.projects_v2 %} {% ifversion projects-v2 %}para toda la organización, instancias de {% data variables.projects.projects_v1_boards %} para toda la organización e instancias de {% data variables.projects.projects_v1_boards %} de nivel de repositorio {% else %}paneles de proyecto para toda la organización y paneles de proyecto de repositorio{% endif %} en una organización.'
redirect_from:
- /github/managing-your-work-on-github/managing-project-boards/disabling-project-boards-in-your-organization
- /articles/disabling-project-boards-in-your-organization
@@ -14,32 +14,36 @@ topics:
- Pull requests
shortTitle: Disable projects
allowTitleToDifferFromFilename: true
ms.openlocfilehash: e1e2aed1e7c689bee83dabc4a6750f8976206f4a
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147423328'
---
After you disable organization-wide project boards, it won’t be possible to create new project boards at the organization level, and any existing organization-level project boards will become inaccessible at their previous URLs. Project boards in repositories in the organization are not affected. {% ifversion projects-v2 %}These settings apply to {% data variables.projects.projects_v2 %} and {% data variables.projects.projects_v1_boards %}.{% endif %}
Una vez que inhabilites tableros de proyecto que se usan en toda la organización, ya no se podrán crear nuevos tableros de proyecto a nivel de la organización, y ya no se podrá acceder a ningún tablero de proyecto existente a nivel de la organización en su URL anterior. Los tableros de proyecto en los repositorios de la organización no se ven afectados. {% ifversion projects-v2 %}Estos valores se aplican a {% data variables.projects.projects_v2 %} y {% data variables.projects.projects_v1_boards %}.{% endif %}
After you disable repository project boards in an organization, it won't be possible to create new project boards in any repositories in the organization, and any existing project boards in repositories in the organization will become inaccessible at their previous URLs. Project boards at the organization level are not affected.
Una vez que inhabilites tableros de proyecto de repositorios en una organización, ya no se podrán crear nuevos tableros de proyecto en ningún repositorio de la organización, y ya no se podrá acceder a ningún tablero de proyecto de los repositorios existentes en la organización en sus URL anteriores. Los tableros de proyecto a nivel de la organización no se ven afectados.
When you disable project boards, you will no longer see project board information in timelines or [audit logs](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization).
Al deshabilitar los paneles de proyecto, ya no verá información del panel de proyecto en escalas de tiempo ni [registros de auditoría](/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization).
{% data reusables.profile.access_org %}
{% data reusables.profile.org_settings %}
{% ifversion fpt or ghec or ghes > 3.4 or ghae-issue-5658 %}
1. In the "Code planning, and automation" section of the sidebar, click **{% octicon "table" aria-label="The table icon" %} Projects**.
{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% ifversion fpt or ghec or ghes > 3.4 or ghae-issue-5658 %}
1. En la sección de "Planeación de código y automatización" de la barra lateral, haz clic en **{% octicon "table" aria-label="The table icon" %} Proyectos**.
{% endif %}
1. Decide whether to disable organization-wide project boards, disable repository project boards in the organization, or both. Then, under "Projects":
- To disable organization-wide project boards, unselect **Enable projects for the organization**.
- To disable repository project boards in the organization, unselect **Enable projects for all repositories**.
![Checkboxes to disable projects for an organization or for all of an organization's repositories](/assets/images/help/projects/disable-org-projects-checkbox.png)
1. Click **Save**.
1. Decide si deseas inhabilitar los tableros de proyecto que se usan en toda la organización, los tableros de proyecto de los repositorios de la organización, o ambos. Luego, en "Proyectos":
- Para deshabilitar los paneles de proyecto que se usan en toda la organización, anula la selección de **Habilitar proyectos para la organización**.
- Para deshabilitar los paneles de proyecto de los repositorios en la organización, anula la selección de **Habilitar proyectos para todos los repositorios**.
![Casillas para deshabilitar los proyectos para una organización o para todos los repositorios de una organización](/assets/images/help/projects/disable-org-projects-checkbox.png)
1. Haga clic en **Save**(Guardar).
{% data reusables.organizations.disable_project_board_results %}
## Further reading
## Información adicional
{% ifversion projects-v2 %}- "[About {% data variables.product.prodname_projects_v2 %}](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)"{% endif %}
- "[About {% data variables.product.prodname_projects_v1 %}](/articles/about-project-boards)"
- "[Closing a {% data variables.projects.projects_v1_board %}](/articles/closing-a-project-board)"
- "[Deleting a {% data variables.projects.projects_v1_board %}](/articles/deleting-a-project-board)"
- "[Disabling {% data variables.projects.projects_v1_boards %} in a repository](/articles/disabling-project-boards-in-a-repository)"
{% ifversion projects-v2 %}- "[Acerca de {% data variables.product.prodname_projects_v2 %}](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)"{% endif %}
- "[Acerca de {% data variables.product.prodname_projects_v1 %}](/articles/about-project-boards)"
- "[Cierre de una instancia de {% data variables.projects.projects_v1_board %}](/articles/closing-a-project-board)"
- "[Eliminación de una instancia de {% data variables.projects.projects_v1_board %}](/articles/deleting-a-project-board)"
- "[Deshabilitación de {% data variables.projects.projects_v1_boards %} en un repositorio](/articles/disabling-project-boards-in-a-repository)"

84
translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md
View File

@@ -1,6 +1,6 @@
---
title: Acerca de los propietarios de código
intro: Puedes usar un archivo CODEOWNERS para definir individuos o equipos que sean responsables del código en un repositorio.
title: About code owners
intro: You can use a CODEOWNERS file to define individuals or teams that are responsible for code in a repository.
redirect_from:
- /articles/about-codeowners
- /articles/about-code-owners
@@ -14,56 +14,52 @@ versions:
ghec: '*'
topics:
- Repositories
ms.openlocfilehash: 2935467bb9fa36651dff84c800098443b435da35
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147430385'
---
Las personas con permisos administrativos o de propietario pueden configurar un archivo CODEOWNERS en un repositorio.
People with admin or owner permissions can set up a CODEOWNERS file in a repository.
Las personas que elijas como propietarios del código deben tener permisos de escritura para el repositorio. Cuando el propietario del código es un equipo, ese equipo debe ser visible y tener permisos de escritura, incluso si todos los miembros individuales del equipo ya tienen permisos de escritura, a través de la membresía de la organización o a través de la membresía de otro equipo.
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.
## Acerca de los propietarios de código
## About code owners
Cuando alguien abre una solicitud de extracción que modifica el código que pertenece a alguien, automáticamente se les solicita una revisión a los propietarios del mismo. Lo que no se solicita automáticamente a estos propietarios es la revisión de los borradores de solicitudes de extracción. Para más información sobre el borrador de solicitudes de incorporación de cambios, vea "[Acerca de las solicitudes de incorporación de cambios](/github/collaborating-with-issues-and-pull-requests/about-pull-requests#draft-pull-requests)". Se notificará automáticamente a los dueños del código cuando marques un borrador de solicitud de extracción como listo para revisión. Si conviertes una solicitud de extracción en borrador, las personas que ya estén suscritas a las notificaciones no se darán de baja automáticamente. Para más información, vea "[Cambio de la fase de una solicitud de incorporación de cambios](/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request)".
Code owners are automatically requested for review when someone opens a pull request that modifies code that they own. Code owners are not automatically requested to review draft pull requests. For more information about draft pull requests, see "[About pull requests](/github/collaborating-with-issues-and-pull-requests/about-pull-requests#draft-pull-requests)." When you mark a draft pull request as ready for review, code owners are automatically notified. If you convert a pull request to a draft, people who are already subscribed to notifications are not automatically unsubscribed. For more information, see "[Changing the stage of a pull request](/github/collaborating-with-issues-and-pull-requests/changing-the-stage-of-a-pull-request)."
Cuando alguien con permisos administrativos o de propietario ha activado las revisiones requeridas, opcionalmente, también pueden solicitar aprobación de un propietario del código antes de que el autor pueda fusionar una solicitud de extracción en el repositorio. Para más información, vea "[Acerca de las ramas protegidas](/github/administering-a-repository/about-protected-branches#require-pull-request-reviews-before-merging)".
When someone with admin or owner permissions has enabled required reviews, they also can optionally require approval from a code owner before the author can merge a pull request in the repository. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches#require-pull-request-reviews-before-merging)."
Si un archivo tiene un propietario del código, puedes ver quién es éste antes de que abras una solicitud de extracción. Puede buscar el archivo en el repositorio y pasar el puntero por {% octicon "shield-lock" aria-label="The edit icon" %}.
If a file has a code owner, you can see who the code owner is before you open a pull request. In the repository, you can browse to the file and hover over {% octicon "shield-lock" aria-label="The edit icon" %}.
![Dueño del código de un archivo en un repositorio](/assets/images/help/repository/code-owner-for-a-file.png)
![Code owner for a file in a repository](/assets/images/help/repository/code-owner-for-a-file.png)
## Ubicación del archivo CODEOWNERS
## CODEOWNERS file location
Para usar un archivo CODEOWNERS, cree un nuevo archivo denominado `CODEOWNERS` en el directorio raíz, `docs/`, o `.github/` del repositorio, en la rama donde desea agregar los propietarios del código.
To use a CODEOWNERS file, create a new file called `CODEOWNERS` in the root, `docs/`, or `.github/` directory of the repository, in the branch where you'd like to add the code owners.
Cada archivo CODEOWNERS asigna los propietarios del código para una única rama en el repositorio. Por lo tanto, puede asignar diferentes propietarios de código para diferentes ramas, como `@octo-org/codeowners-team` para una base de código en la rama predeterminada y `@octocat` para un sitio de {% data variables.product.prodname_pages %} en la rama `gh-pages`.
Each CODEOWNERS file assigns the code owners for a single branch in the repository. Thus, you can assign different code owners for different branches, such as `@octo-org/codeowners-team` for a code base on the default branch and `@octocat` for a {% data variables.product.prodname_pages %} site on the `gh-pages` branch.
Para que los propietarios del código reciban las solicitudes de revisión, el archivo CODEOWNERS debe estar en la rama base de la solicitud de extracción. Por ejemplo, si asigna `@octocat` como propietario del código para los archivos *.js* en la rama `gh-pages` del repositorio, `@octocat` recibirá solicitudes de revisión cuando se abra una solicitud de incorporación de cambios con cambios en los archivos *.js* archivos entre la rama principal y `gh-pages`.
For code owners to receive review requests, the CODEOWNERS file must be on the base branch of the pull request. For example, if you assign `@octocat` as the code owner for *.js* files on the `gh-pages` branch of your repository, `@octocat` will receive review requests when a pull request with changes to *.js* files is opened between the head branch and `gh-pages`.
{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-4675 %}
## Tamaño de archivo de CODEOWNERS
## CODEOWNERS file size
Los archivos de CODEOWNERS deben ser de menos de 3 MB. Un archivo de CODEOWNERS que sobrepase este límite no se cargará, lo cual significa que la información de los propietarios de código no se mostrará y que no se solicitará que los propietarios de código adecuados revisen los cambios en una solicitud de cambios.
CODEOWNERS files must be under 3 MB in size. A CODEOWNERS file over this limit will not be loaded, which means that code owner information is not shown and the appropriate code owners will not be requested to review changes in a pull request.
Para reducir el tamaño de tu archivo de CODEOWNERS, considera utilizar patrones de comodín para consolidar varias entradas en una.
To reduce the size of your CODEOWNERS file, consider using wildcard patterns to consolidate multiple entries into a single entry.
{% endif %}
## Sintáxis de CODEOWNERS
## CODEOWNERS syntax
Un archivo CODEOWNERS usa un patrón que sigue casi todas las mismas reglas que se usan en los archivos [gitignore](https://git-scm.com/docs/gitignore#_pattern_format), con [algunas excepciones](#syntax-exceptions). El patrón va seguido de uno o varios nombres de usuario o de equipo de {% data variables.product.prodname_dotcom %} con el formato estándar `@username` o `@org/team-name`. Los usuarios y los equipos deben tener acceso explícito de `write` al repositorio aunque los miembros del equipo ya tengan acceso.
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%}En la mayoría de los casos, {% else %}{% endif %} también puedes hacer referencia a un usuario por la dirección de correo electrónico que se ha agregado a su cuenta en {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, por ejemplo `user@example.com`. {% ifversion fpt or ghec %} No puedes usar una dirección de correo electrónico para hacer referencia a un {% data variables.product.prodname_managed_user %}. Para obtener más información sobre {% data variables.product.prodname_managed_users %}, consulta "[Acerca de {% 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 %}" en la documentación de {% data variables.product.prodname_ghe_cloud %}.{% else %}."{% endif %}{% endif %}
{% 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 %}
Las rutas de CODEOWNERS distinguen entre mayúsculas y minúsculas, ya que {% data variables.product.prodname_dotcom %} utiliza un sistema de archivos que también lo hace. Ya que {% data variables.product.prodname_dotcom %} evalúa a los CODEOWNERS, incluso los sistemas que distinguen entre mayúsculas y minúsculas (por ejemplo, macOS) deben utilizar rutas y archivos que utilicen mayúsculas y minúsculas correctamente en el archivo de CODEOWNERS.
CODEOWNERS paths are case sensitive, because {% data variables.product.prodname_dotcom %} uses a case sensitive file system. Since CODEOWNERS are evaluated by {% data variables.product.prodname_dotcom %}, even systems that are case insensitive (for example, macOS) must use paths and files that are cased correctly in the CODEOWNERS file.
{% ifversion codeowners-errors %} Si alguna línea del archivo CODEOWNERS contiene una sintaxis inválida, dicha línea se omitirá. Cuando navegas al archivo de CODEOWNERS en tu repositorio en {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, puedes ver todos los errores resaltados. También se puede acceder a una lista de los errores del archivo CODEOWNERS de cualquier repositorio a través de la API. Para obtener más información, consulte "[Repositorios](/rest/reference/repos#list-codeowners-errors)" en la documentación de la API de REST.
{% else %} Si cualquier línea del archivo CODEOWNERS contiene una sintaxis inválida, el archivo no se detectará y no se utilizará para solicitar revisiones.
{% ifversion codeowners-errors %}
If any line in your CODEOWNERS file contains invalid syntax, that line will be skipped. When you navigate to the CODEOWNERS file in your repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, you can see any errors highlighted. A list of errors in a repository's CODEOWNERS file is also accessible via the API. For more information, see "[Repositories](/rest/reference/repos#list-codeowners-errors)" in the REST API documentation.
{% else %}
If any line in your CODEOWNERS file contains invalid syntax, the file will not be detected and will not be used to request reviews.
{% endif %}
### Ejemplo de un archivo CODEOWNERS
### Example of a CODEOWNERS file
```
# This is a comment.
# Each line is a file pattern followed by one or more owners.
@@ -120,20 +116,24 @@ apps/ @octocat
/apps/ @octocat
/apps/github
```
### Excepciones de sintaxis
Hay algunas reglas de sintaxis para los archivos de gitignore que no funcionan con los archivos de CODEOWNERS:
- Agregar un carácter de escape a un patrón que comience por `#` utilizando `\` para que se le trate como un patrón y no como un comentario
- Usar `!` para negar un patrón
- Usar `[ ]` para definir un intervalo de caracteres
## Protección de rama y de CODEOWNERS
Los propietarios de los repositorios pueden agregar reglas de protección de rama para asegurarse de que los propietarios de los archivos que se modificaron revisen el código que cambió. Para más información, vea "[Acerca de las ramas protegidas](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches)".
{% warning %}
**Warning:** There are some syntax rules for gitignore files that *do not work* in CODEOWNERS files:
- Escaping a pattern starting with `#` using `\` so it is treated as a pattern and not a comment
- Using `!` to negate a pattern
- Using `[ ]` to define a character range
{% endwarning %}
## CODEOWNERS and branch protection
Repository owners can add branch protection rules to ensure that changed code is reviewed by the owners of the changed files. For more information, see "[About protected branches](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches)."
## Información adicional
## Further reading
- "[Creación de archivos](/articles/creating-new-files)"
- "[Invitación a colaboradores a un repositorio personal](/articles/inviting-collaborators-to-a-personal-repository)"
- "[Administración del acceso de un individuo a un repositorio de la organización](/articles/managing-an-individual-s-access-to-an-organization-repository)"
- "[Administración del acceso de equipo a un repositorio de la organización](/articles/managing-team-access-to-an-organization-repository)"
- "[Ver una revisión de solicitud de incorporación de cambios](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/viewing-a-pull-request-review)"
- "[Creating new files](/articles/creating-new-files)"
- "[Inviting collaborators to a personal repository](/articles/inviting-collaborators-to-a-personal-repository)"
- "[Managing an individual's access to an organization repository](/articles/managing-an-individual-s-access-to-an-organization-repository)"
- "[Managing team access to an organization repository](/articles/managing-team-access-to-an-organization-repository)"
- "[Viewing a pull request review](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/viewing-a-pull-request-review)"

58
translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md
View File

@@ -1,6 +1,6 @@
---
title: About READMEs
intro: 'You can add a README file to your repository to tell other people why your project is useful, what they can do with your project, and how they can use it.'
title: Acerca de los archivos README
intro: 'Puedes agregar un archivo README a tu repositorio para comentarle a otras personas por qué tu proyecto es útil, qué pueden hacer con tu proyecto y cómo lo pueden usar.'
redirect_from:
- /articles/section-links-on-readmes-and-blob-pages
- /articles/relative-links-in-readmes
@@ -14,25 +14,31 @@ versions:
ghec: '*'
topics:
- Repositories
ms.openlocfilehash: 4a6ea66a42a6267ec4306d6ee5cff3fef739f8a6
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147783067'
---
## About READMEs
## Acerca de los archivos README
You can add a README file to a repository to communicate important information about your project. A README, along with a repository license{% ifversion fpt or ghes > 3.2 or ghae-issue-4651 or ghec %}, citation file{% endif %}{% ifversion fpt or ghec %}, contribution guidelines, and a code of conduct{% elsif ghes %} and contribution guidelines{% endif %}, communicates expectations for your project and helps you manage contributions.
Puedes agregar un archivo README a un repositorio para comunicar información importante sobre tu proyecto. El contar con un README, en conjunto con una licencia de repositorio{% ifversion fpt or ghes > 3.2 or ghae-issue-4651 or ghec %}, archivo de citas{% endif %}{% ifversion fpt or ghec %}, lineamientos de contribución y código de conducta{% elsif ghes %} y lineamientos de contribución{% endif %}, comunica las expectativas de tu proyecto y te ayuda a administrar las contribuciones.
For more information about providing guidelines for your project, see {% ifversion fpt or ghec %}"[Adding a code of conduct to your project](/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project)" and {% endif %}"[Setting up your project for healthy contributions](/communities/setting-up-your-project-for-healthy-contributions)."
Para obtener más información sobre cómo proporcionar instrucciones para el proyecto, consulta {% ifversion fpt or ghec %}"[Adición de un código de conducta al proyecto](/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project)" y {% endif %}"[Configuración del proyecto para contribuciones correctas](/communities/setting-up-your-project-for-healthy-contributions)".
A README is often the first item a visitor will see when visiting your repository. README files typically include information on:
- What the project does
- Why the project is useful
- How users can get started with the project
- Where users can get help with your project
- Who maintains and contributes to the project
Un archivo README suele ser el primer elemento que verá un visitante cuando entre a tu repositorio. Los archivos README habitualmente incluyen información sobre:
- Qué hace el proyecto.
- Por qué el proyecto es útil.
- Cómo pueden comenzar los usuarios con el proyecto.
- Dónde pueden recibir ayuda los usuarios con tu proyecto
- Quién mantiene y contribuye con el proyecto.
If you put your README file in your repository's hidden `.github`, root, or `docs` directory, {% data variables.product.product_name %} will recognize and automatically surface your README to repository visitors.
Si colocas tu archivo README en el directorio `.github`, raíz o `docs` oculto de tu repositorio, {% data variables.product.product_name %} lo reconocerá y automáticamente expondrá tu archivo README a los visitantes del repositorio.
If a repository contains more than one README file, then the file shown is chosen from locations in the following order: the `.github` directory, then the repository's root directory, and finally the `docs` directory.
Si un repositorio contiene más de un archivo README, el archivo que se muestra se elige de las ubicaciones en el siguiente orden: el directorio `.github`, luego el directorio raíz del repositorio y finalmente el directorio `docs`.
![Main page of the github/scientist repository and its README file](/assets/images/help/repository/repo-with-readme.png)
![Página principal del repositorio github/scientist y su archivo README](/assets/images/help/repository/repo-with-readme.png)
{% ifversion fpt or ghes or ghec %}
@@ -40,30 +46,28 @@ If a repository contains more than one README file, then the file shown is chose
{% endif %}
![README file on your username/username repository](/assets/images/help/repository/username-repo-with-readme.png)
![El archivo de README en tu nombre de usuario/repositorio de nombre de usuario](/assets/images/help/repository/username-repo-with-readme.png)
## Auto-generated table of contents for README files
## Índice auto-generado de los archivos README
For the rendered view of any Markdown file in a repository, including README files, {% data variables.product.product_name %} will automatically generate a table of contents based on section headings. You can view the table of contents for a README file by clicking the {% octicon "list-unordered" aria-label="The unordered list icon" %} menu icon at the top left of the rendered page.
Para la versión interpretada de cualquier archivo de lenguaje de marcado en un repositorio, incluyendo los archivos README, {% data variables.product.product_name %} generará un índice automáticamente con base en los encabezados de sección. Puedes ver el índice de un archivo README si haces clic en el icono de menú {% octicon "list-unordered" aria-label="The unordered list icon" %} en la parte superior izquierda de la página interpretada.
![README with automatically generated TOC](/assets/images/help/repository/readme-automatic-toc.png)
![README con TOC generado automáticamente](/assets/images/help/repository/readme-automatic-toc.png)
## Section links in README files and blob pages
## Enlaces de sección en los archivos README y las páginas blob
{% data reusables.repositories.section-links %}
## Relative links and image paths in README files
## Enlaces relativos y rutas con imágenes en los archivos README
{% data reusables.repositories.relative-links %}
## Wikis
A README should contain only the necessary information for developers to get started using and contributing to your project. Longer documentation is best suited for wikis. For more information, see "[About wikis](/communities/documenting-your-project-with-wikis/about-wikis)."
Un archivo README debe contener solo la información necesaria para que los desarrolladores comiencen a hacer contribuciones en tu proyecto. La documentación más grande es mejor para los wikis. Para obtener más información, consulta "[Acerca de las wikis](/communities/documenting-your-project-with-wikis/about-wikis)".
## Further reading
## Información adicional
- "[Adding a file to a repository](/articles/adding-a-file-to-a-repository)"
- 18F's "[Making READMEs readable](https://github.com/18F/open-source-guide/blob/18f-pages/pages/making-readmes-readable.md)"
{%- ifversion fpt or ghec %}
- "[Adding an 'Open in GitHub Codespaces' badge](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)"
{%- endif %}
- "[Agregar un archivo a un repositorio](/articles/adding-a-file-to-a-repository)"
- 18F's "[Convertir en legible archivos READMEs](https://github.com/18F/open-source-guide/blob/18f-pages/pages/making-readmes-readable.md)" {%- ifversion fpt or ghec %}
- "[Adición de un distintivo "Abrir en GitHub Codespaces"](/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge)" {%- endif %}

938
translations/es-ES/content/rest/guides/getting-started-with-the-rest-api.md
View File

File diff suppressed because it is too large Load Diff

21
translations/es-ES/content/rest/users/ssh-signing-keys.md Normal file
View File

@@ -0,0 +1,21 @@
---
title: Claves de firma SSH
intro: ''
versions:
fpt: '*'
ghes: '>=3.7'
ghec: '*'
topics:
- API
miniTocMaxHeadingLevel: 3
allowTitleToDifferFromFilename: true
ms.openlocfilehash: 758f7897f965323e3675bf6b0ac1d295a3338f05
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147773908'
---
## Acerca de las API de usuarios para firma SSH
{% data reusables.user-settings.user-api %}

130
translations/es-ES/content/support/learning-about-github-support/about-github-support.md
View File

@@ -1,6 +1,6 @@
---
title: About GitHub Support
intro: You can contact GitHub Support for help troubleshooting issues you encounter while using GitHub.
title: Acerca del Soporte de GitHub
intro: Puedes contactar al Soporte de GitHub para que te ayude a solucionar los problemas que te encuentras al utilizar GitHub.
shortTitle: About GitHub Support
versions:
fpt: '*'
@@ -21,34 +21,38 @@ redirect_from:
- /enterprise-server/admin/enterprise-support/about-support-for-advanced-security
topics:
- Support
ms.openlocfilehash: 87bee3904b20ef6b145716b1fa6ec445f16793d8
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: '147400422'
---
## Acerca de {% data variables.contact.github_support %}
## About {% data variables.contact.github_support %}
Las opciones de soporte disponibles para los usuarios de {% data variables.product.prodname_dotcom %} depende de los productos que utilizan sus cuentas personales, de cualquier organización o empresa de las cuales sean miembros y de cualquier instancia de {% data variables.product.prodname_ghe_server %} que administren. Cada producto incluye un nivel predeterminado de soporte y las cuentas que utilizan {% data variables.product.prodname_enterprise %} pueden comprar {% data variables.contact.premium_support %}.
The support options available to {% data variables.product.prodname_dotcom %} users depend on the products used by their personal accounts, any organizations or enterprises they are members of, and any {% data variables.product.prodname_ghe_server %} instances they manage. Each product includes a default level of support and accounts that use {% data variables.product.prodname_enterprise %} can purchase {% data variables.contact.premium_support %}.
{% ifversion fpt %}
If you're a member of an organization that uses {% data variables.product.prodname_enterprise %}, you can use the drop-down menu in the upper-right corner of {% data variables.product.prodname_docs %} to view a version of these articles appropriate to your product. For more information, see "[About versions of GitHub Docs](/get-started/learning-about-github/about-versions-of-github-docs)."
{% ifversion fpt %} Si eres miembro de una organización que utilice {% data variables.product.prodname_enterprise %}, puedes utilizar el menú desplegable en la esquina superior derecha de {% data variables.product.prodname_docs %} para ver una versión de estos artículos que sea adecuada para tu producto. Para obtener más información, consulta "[Acerca de las versiones de GitHub Docs](/get-started/learning-about-github/about-versions-of-github-docs)".
{% endif %}
{% ifversion not ghae %}
| | {% data variables.product.prodname_gcf %} | Standard support | Premium support |
| | {% data variables.product.prodname_gcf %} | Soporte técnico Standard | Soporte premium |
|----|---------------|-------|---------------|
| {% data variables.product.prodname_free_user %} | {% octicon "check" aria-label="Check" %} | | |
| {% data variables.product.prodname_pro %} | {% octicon "check" aria-label="Check" %} | {% octicon "check" aria-label="Check" %} | |
| {% data variables.product.prodname_team %} | {% octicon "check" aria-label="Check" %} | {% octicon "check" aria-label="Check" %} | |
| {% data variables.product.prodname_ghe_cloud %} | {% octicon "check" aria-label="Check" %} | {% octicon "check" aria-label="Check" %} | Available to purchase |
| {% data variables.product.prodname_ghe_server %} | {% octicon "check" aria-label="Check" %} | {% octicon "check" aria-label="Check" %} | Available to purchase |
| {% data variables.product.prodname_ghe_cloud %} | {% octicon "check" aria-label="Check" %} | {% octicon "check" aria-label="Check" %} | Disponible para comprar |
| {% data variables.product.prodname_ghe_server %} | {% octicon "check" aria-label="Check" %} | {% octicon "check" aria-label="Check" %} | Disponible para comprar |
{% endif %}
{% ifversion ghes %}
You can contact {% data variables.contact.enterprise_support %} through the {% data variables.contact.contact_enterprise_portal %} for help with:
- Installing and using {% data variables.product.product_name %}
- Identifying and verifying the causes of suspected errors
- Installing and using {% data variables.product.prodname_advanced_security %}
Puedes ponerte en contacto con {% data variables.contact.enterprise_support %} a través de {% data variables.contact.contact_enterprise_portal %} para obtener ayuda:
- Instalación y uso de {% data variables.product.product_name %}
- Inspeccionar y verificar las causas de errores sospechados
- Instalación y uso de {% data variables.product.prodname_advanced_security %}
{% endif %}
@@ -56,126 +60,115 @@ You can contact {% data variables.contact.enterprise_support %} through the {% d
{% data reusables.support.premium-support-features %}
For more information, see "[About GitHub Premium Support](/support/about-github-support/about-github-premium-support)."
Para obtener más información, consulta "[Acerca del soporte técnico premium de GitHub](/support/about-github-support/about-github-premium-support)".
{% endif %}
{% ifversion fpt or ghec or ghae %}
Before contacting {% data variables.contact.github_support %}, check if there are currently any incidents affecting services on {% data variables.product.product_name %} on
{%- ifversion fpt or ghec %}
[{% data variables.product.prodname_dotcom %} Status](https://githubstatus.com/)
{%- elsif ghae %}
[{% data variables.product.product_name %} Status](https://ghestatus.com/)
{%- endif %}. For more information, see "[About GitHub status](#about-github-status)."
Antes de contactar con {% data variables.contact.github_support %}, comprueba si actualmente hay algún incidente que afecte a los servicios de {% data variables.product.product_name %} en los {%- ifversion fpt or ghec %} [estados de {% data variables.product.prodname_dotcom %}](https://githubstatus.com/) {%- elsif ghae %} [y {% data variables.product.product_name %}](https://ghestatus.com/) {%- endif %}. Para obtener más información, consulta "[Acerca del estado de GitHub](#about-github-status)".
{% endif %}
{% ifversion fpt %}
{% data reusables.support.free-and-paid-support %}
{% ifversion fpt %} {% data reusables.support.free-and-paid-support %}
To report account, security, and abuse issues, or to receive assisted support for a paid account, visit the {% data variables.contact.contact_support_portal %}. For more information, see "[Creating a support ticket](/support/contacting-github-support/creating-a-support-ticket)."
Para reportar incidentes de cuenta, seguridad y abuso, o para recibir soporte asistido para una cuenta de pago, visita el {% data variables.contact.contact_support_portal %}. Para obtener más información, consulta "[Creación de una incidencia de soporte técnico](/support/contacting-github-support/creating-a-support-ticket)".
{% endif %}
{% ifversion fpt %}
If you have any paid product or are a member of an organization with a paid product, you can contact {% data variables.contact.github_support %} in English.
{% else %}
With {% data variables.product.product_name %}, you have access to support in English and Japanese.
{% ifversion fpt %} Si tienes productos de pago o eres miembro de una organización que los tenga, puedes contactar al {% data variables.contact.github_support %} en inglés.
{% else %} Gracias a {% data variables.product.product_name %}, tienes acceso a soporte técnico en inglés y japonés.
{% endif %}
{% ifversion ghes or ghec %}
To contact {% data variables.contact.github_support %}, visit the {% data variables.contact.contact_support_portal %}. For more information, see "[Creating a support ticket](/support/contacting-github-support/creating-a-support-ticket)."
Para contactar al {% data variables.contact.github_support %}, visita el {% data variables.contact.contact_support_portal %}. Para obtener más información, consulta "[Creación de una incidencia de soporte técnico](/support/contacting-github-support/creating-a-support-ticket)".
{% elsif ghae %}
You can contact {% data variables.contact.enterprise_support %} through the {% data variables.contact.ae_azure_portal %} to report issues in writing. For more information, see "[Creating a support ticket](/support/contacting-github-support/creating-a-support-ticket)."
Puedes contactar al {% data variables.contact.enterprise_support %} a través del {% data variables.contact.ae_azure_portal %} para reportar los problemas por escrito. Para obtener más información, consulta "[Creación de una incidencia de soporte técnico](/support/contacting-github-support/creating-a-support-ticket)".
{% endif %}
{% ifversion not ghae %}
Email communication from GitHub Support will always be sent from either a `github.com` or `githubsupport.com` address.
{% ifversion not ghae %} Las comunicaciones por correo electrónico del soporte técnico de GitHub siempre se enviarán desde una dirección `github.com` o `githubsupport.com`.
{% endif %}
## Scope of support
## Alcance del soporte técnico
{% data reusables.support.scope-of-support %}
{% ifversion ghec or fpt or ghae %}
## About GitHub status
## Acerca del estado de GitHub
You can check for any incidents currently affecting {% data variables.product.product_name %} services and view information about past incidents on {% data variables.product.prodname_dotcom %}'s [Status page]({% ifversion fpt or ghec %}https://githubstatus.com{% elsif ghae %}https://ghestatus.com{% endif %}).
Puedes comprobar cualquier incidente que afecte actualmente a los servicios de {% data variables.product.product_name %} y ver la información sobre los incidentes anteriores en la [Página de estado]({% ifversion fpt or ghec %}https://githubstatus.com{% elsif ghae %}https://ghestatus.com{% endif %}) de {% data variables.product.prodname_dotcom %}.
You can also subscribe and get alerted via email, text message, and webhook whenever there's an incident affecting {% data variables.product.product_name %}.
También puedes suscribirte y obtener alertas por correo electrónico, mensaje de texto y webhook cada vez que exista un incidente que afecte a {% data variables.product.product_name %}.
{% endif %}
{% ifversion ghec or ghes %}
## About support entitlement
## Acerca de los derechos de soporte
Enterprise owners and billing managers automatically have a support entitlement, which enables them to create, view, and comment on support tickets associated with their enterprise account.
Los propietarios de las empresas y administradores de facturación automáticamente tendrán derecho a soporte, lo cual los faculta para crear, ver y comentar en los tickets de soporte asociados con sus cuentas empresariales.
Enterprise owners can also add support entitlements to members of organizations owned by their enterprise account, allowing those members to create, view, and comment on support tickets. For more information, see "[Managing support entitlements for your enterprise](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/managing-support-entitlements-for-your-enterprise)."
Los propietarios de las empresas también pueden agregar derechos de soporte para los miembros de las organizaciones que pertenezcan a sus cuentas empresariales, permitiéndoles crear, ver y comentar en los tickets de soporte. Para más información, vea "[Administración de derechos de soporte técnico para su empresa](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/managing-support-entitlements-for-your-enterprise)".
{% endif %}
{% ifversion fpt or ghec %}
## Granting {% data variables.contact.github_support %} temporary access to a private repository
## Otorgar a {% data variables.contact.github_support %} acceso temporario a un repositorio privado
If {% data variables.contact.github_support %} needs to access a private repository to address your support request, the owner of the repository will receive an email with a link to accept or decline temporary access. The owner will have 20 days to accept or decline the request before the request expires. If the owner accepts the request, {% data variables.contact.github_support %} will have access the repository for five days.
Si {% data variables.contact.github_support %} necesita acceder a un repositorio privado para tratar tu solicitud de soporte, el dueño de éste recibirá un correo electrónico con un enlace para aceptar o rechazar el acceso temporal. El propietario tendrá 20 días para aceptar o rechazar la solicitud antes de que ésta caduque. Si el propietario acepta la solicitud, {% data variables.contact.github_support %} tendrá acceso al repositorio por cinco días.
{% data variables.contact.github_support %} will never access your private repositories without your explicit consent. For more information, see the [Terms of Service](/free-pro-team@latest/github/site-policy/github-terms-of-service#3-access).
{% data variables.contact.github_support %} jamás accederá a tus repositorios privados sin tu consentimiento explícito. Para obtener más información, consulta los [términos del servicio](/free-pro-team@latest/github/site-policy/github-terms-of-service#3-access).
{% endif %}
{% ifversion ghec or ghes %}
## Contacting GitHub Sales and GitHub Training
## Contactar a las Ventas de GitHub y a la Capacitación de GitHub
For pricing, licensing, renewals, quotes, payments, and other related questions, contact {% data variables.contact.contact_enterprise_sales %} or call [+1 (877) 448-4820](tel:+1-877-448-4820).
Para las preguntas relacionadas con precios, adquisición de licencias, renovaciones, cotizaciones, pagos y otras cuestiones relacionadas, contacta con {% data variables.contact.contact_enterprise_sales %} o llama al [+1 (877) 448-4820](tel:+1-877-448-4820).
To learn more about training options, including customized trainings, see [{% data variables.product.company_short %}'s training site](https://services.github.com/).
Para obtener más información sobre las opciones de capacitación, incluidos los aprendizajes personalizados, consulta el [sitio de formación de {% data variables.product.company_short %}](https://services.github.com/).
{% note %}
**Note:** Training is included in the {% data variables.product.premium_plus_support_plan %}. For more information, see "[About GitHub Premium Support](/support/about-github-support/about-github-premium-support)."
**Nota:** La capacitación está incluida en el {% data variables.product.premium_plus_support_plan %}. Para obtener más información, consulta "[Acerca del soporte técnico premium de GitHub](/support/about-github-support/about-github-premium-support)".
{% endnote %}
{% endif %}
{% ifversion ghes or ghec %}
## Hours of operation
## Horario
### Support in English
### Soporte en inglés
For standard non-urgent issues, we offer support in English 24 hours per day, 5 days per week, excluding weekends and national U.S. holidays. The standard response time is 24 hours.
Para cuestiones estándar no urgentes, ofrecemos soporte en inglés las 24 horas del día, 5 días a la semana, excepto fines de semana y feriados nacionales en EE.○UU. El tiempo de respuesta estándar es 24 horas.
{% ifversion ghes %}
For urgent issues, we are available 24 hours per day, 7 days per week, even during national U.S. holidays.
{% ifversion ghes %} Para incidencias urgentes, estamos disponibles las 24 horas del día, 7 días a la semana, incluso en días festivos en EE. UU.
{% endif %}
### Support in Japanese
### Soporte en japonés
For standard non-urgent issues, support in Japanese is available Monday through Friday from 9:00 AM to 5:00 PM JST, excluding national holidays in Japan.
Para incidencias estándares no urgentes, el soporte técnico en japonés se encuentra disponible de lunes a viernes, de 9:00 a.m. a 5:00 p.m. (hora estándar en Japón), excepto los días festivos nacionales en Japón.
{% ifversion ghes %}
For urgent issues, we offer support in English 24 hours per day, 7 days per week, even during national U.S. holidays.
{% ifversion ghes %} Para incidencias urgentes, ofrecemos soporte técnico en inglés 24 horas al día, 7 días por semana, incluso durante los días festivos en EE. UU.
{% endif %}
For a complete list of U.S. and Japanese national holidays observed by {% data variables.contact.enterprise_support %}, see "[Holiday schedules](#holiday-schedules)."
Para conocer una lista de los festivos nacionales de EE. UU. y Japón que sigue {% data variables.contact.enterprise_support %}, consulta la [Programación de festivos](#holiday-schedules)".
## Holiday schedules
## Cronograma de feriados
For urgent issues, we can help you in English 24 hours per day, 7 days per week, including on U.S. and Japanese holidays.
Para cuestiones urgentes, podemos ayudarte los 24 horas del día, los 7 días de la semana, incluidos los feriados en EE. UU. y Japón.
### Holidays in the United States
### Feriados en los Estados Unidos
{% data variables.contact.enterprise_support %} observes these U.S. holidays, although our global support team is available to answer urgent tickets.
{% data variables.contact.enterprise_support %} respeta estos días feriados en los EE.UU, aunque nuestro equipo de soporte global se encuentra disponible para atender tickets urgentes.
{% data reusables.enterprise_enterprise_support.support-holiday-availability %}
### Holidays in Japan
### Feriados en Japón
{% data variables.contact.enterprise_support %} does not provide Japanese-language support on December 28th through January 3rd as well as on the holidays listed in [国民の祝日について - 内閣府](https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html).
{% data variables.contact.enterprise_support %} no ofrece soporte técnico en japonés del 28 de diciembre al 3 de enero, así como en los festivos que se indican en [国民の祝日について - 内閣府](https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html).
{% ifversion ghes %}{% data reusables.enterprise_enterprise_support.installing-releases %}{% endif %}
@@ -183,18 +176,15 @@ For urgent issues, we can help you in English 24 hours per day, 7 days per week,
{% ifversion ghec or ghes or ghae %}
## Resolving and closing support tickets
## Resolver y cerrar tickets de soporte
{% data reusables.support.enterprise-resolving-and-closing-tickets %}
{% endif %}
## Further reading
## Información adicional
{%- ifversion ghes %}
- Section 10 on Support in the "[{% data variables.product.prodname_ghe_server %} License Agreement](https://enterprise.github.com/license)"
{%- endif %}
- "[Creating a support ticket](/support/contacting-github-support/creating-a-support-ticket)"
{%- ifversion not ghae %}
- "[Viewing and updating support tickets](/support/contacting-github-support/viewing-and-updating-support-tickets)"
{%- endif %}
- Sección 10 sobre soporte técnico en el "[Contrato de licencia de {% data variables.product.prodname_ghe_server %}](https://enterprise.github.com/license)" {%- endif %}
- "[Creación de una incidencia de soporte técnico](/support/contacting-github-support/creating-a-support-ticket)" {%- ifversion not ghae %}
- "[Visualización y actualización de incidencias de soporte técnico](/support/contacting-github-support/viewing-and-updating-support-tickets)" {%- endif %}

12
translations/es-ES/data/reusables/accounts/create-account.md
View File

@@ -1,2 +1,10 @@
1. Go to {% data variables.product.company_short %}'s [Pricing]({% data variables.product.pricing_url %}) page.
2. Read the information about the different products and subscriptions that {% data variables.product.company_short %} offers, then click the upgrade button under the subscription you'd like to choose.
---
ms.openlocfilehash: 27ad8b0bdd1128bf259b15a401bda19cb25a3b17
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: "145114977"
---
1. Vaya a la página de [precios]({% data variables.product.pricing_url %}) de {% data variables.product.company_short %}.
2. Lea la información acerca de los diferentes productos y suscripciones que {% data variables.product.company_short %} ofrece y, después, haga clic en el botón actualizar de la suscripción que quiere elegir.

20
translations/es-ES/data/reusables/actions/contacting-support.md
View File

@@ -1,9 +1,17 @@
If you need help with anything related to workflow configuration, such as syntax, {% data variables.product.prodname_dotcom %}-hosted runners, or building actions, look for an existing topic or start a new one in the [{% data variables.product.prodname_github_community %}'s {% data variables.product.prodname_actions %} and {% data variables.product.prodname_registry %} category](https://github.com/orgs/github-community/discussions/categories/actions-and-packages).
---
ms.openlocfilehash: 32cd1f25aa5b28e9f6529d19538a52caa347d36f
ms.sourcegitcommit: da73949b8f8bd71d40247f1f9c49f8f4c362ecd0
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 07/28/2022
ms.locfileid: "147432044"
---
Si necesitas ayuda con lo que sea relacionado con la configuración de flujo de trabajo, tal como la sintaxis, los ejecutores hospedados en {% data variables.product.prodname_dotcom %}, o la creación de acciones, busca un tema existente o inicia uno nuevo en la [categoría de {% data variables.product.prodname_actions %} y {% data variables.product.prodname_registry %} de {% data variables.product.prodname_github_community %}](https://github.com/orgs/github-community/discussions/categories/actions-and-packages).
If you have feedback or feature requests for {% data variables.product.prodname_actions %}, share those in the {% data variables.contact.contact_feedback_actions %}.
Si tienes algún tipo de retroalimentación o solicitudes de características para {% data variables.product.prodname_actions %}, compártelas en el {% data variables.contact.contact_feedback_actions %}.
Contact {% data variables.contact.contact_support %} for any of the following, whether your use or intended use falls into the usage limit categories:
Contacta a {% data variables.contact.contact_support %} para cualquiera de los siguientes, que tu tipo de uso o el tipo de uso que pretendes tener caiga en las siguientes categorías de limitación:
* If you believe your account has been incorrectly restricted
* If you encounter an unexpected error when executing one of your actions
* If you encounter a situation where existing behavior contradicts expected, but not always documented, behavior
* Si crees que tu cuenta se ha restringido de manera incorrecta
* Si llegas un error inesperado cuando ejecutas una de tus acciones, por ejemplo: una ID única
* Si llegas a una situación en donde el comportamiento existente contradice a aquél que se espera, pero no siempre se documenta

10
translations/es-ES/data/reusables/code-scanning/codeql-context-for-actions-and-third-party-tools.md
View File

@@ -1 +1,9 @@
You can run {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} within {% data variables.product.product_name %} using {% data variables.product.prodname_actions %}. Alternatively, if you use a third-party continuous integration or continuous delivery/deployment (CI/CD) system, you can run {% data variables.product.prodname_codeql %} analysis in your existing system and upload the results to {% data variables.product.product_location %}.
---
ms.openlocfilehash: 4a60a2f573a8aebe309f1db397e38cd41ef8eeac
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: "145113314"
---
Puedes ejecutar el {% data variables.product.prodname_code_scanning %} de {% data variables.product.prodname_codeql %} dentro de {% data variables.product.product_name %} utilizando {% data variables.product.prodname_actions %}. Como alternativa, si utilizas un sistema de integración o despliegue/entrega contínua (IC/ID) de terceros, puedes ejecutar un análisis de {% data variables.product.prodname_codeql %} en tu sistema existente y cargar los resultados a {% data variables.product.product_location %}.

10
translations/es-ES/data/reusables/code-scanning/codeql-query-suites.md
View File

@@ -1,12 +1,12 @@
---
ms.openlocfilehash: a6a1c65e6cd8e475eda09d96a8e23873374f3216
ms.sourcegitcommit: 22d665055b1bee7a5df630385e734e3a149fc720
ms.openlocfilehash: 7ef928cc8f56a997197c06b1aa3bbfa5e718a174
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 07/13/2022
ms.locfileid: "145113306"
ms.lasthandoff: 09/05/2022
ms.locfileid: "147785210"
---
| Conjunto de consultas | Descripción |
| :- | :- |
| `security-extended` | Consultas de menor gravedad y precisión que las consultas predeterminadas |
| `security-extended` | Consultas del conjunto predeterminado, además de consultas de gravedad y precisión más bajas |
| `security-and-quality` | Consultas de `security-extended`, además de consultas de mantenimiento y confiabilidad. |

10
translations/es-ES/data/reusables/code-scanning/edit-workflow.md
View File

@@ -1 +1,9 @@
Typically, you don't need to edit the default workflow for {% data variables.product.prodname_code_scanning %}. However, if required, you can edit the workflow to customize some of the settings. For example, you can edit {% data variables.product.prodname_dotcom %}'s {% data variables.product.prodname_codeql_workflow %} to specify the frequency of scans, the languages or directories to scan, and what {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} looks for in your code. You might also need to edit the {% data variables.product.prodname_codeql_workflow %} if you use a specific set of commands to compile your code.
---
ms.openlocfilehash: 42eb8f9784122f0576355c605691982b26fb9f19
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: "145113297"
---
Habitualmente, no necesitas editar el flujo de trabajo predeterminado para {% data variables.product.prodname_code_scanning %}. Sin embargo, si lo requieres, puedes editar el flujo de trabajo para personalizar algunos de los ajustes. Por ejemplo, puedes editar el {% data variables.product.prodname_codeql_workflow %} de {% data variables.product.prodname_dotcom %} para especificar la frecuencia de los escaneos, los idiomas o los directorios a escanear, y qué debe buscar el {% data variables.product.prodname_codeql %} del {% data variables.product.prodname_code_scanning %} en tu código. También podrías necesitar editar el {% data variables.product.prodname_codeql_workflow %} si utilizas un conjunto de comandos específicos para compilar tu código.

9
translations/es-ES/data/reusables/codespaces/max-number-codespaces.md Normal file
View File

@@ -0,0 +1,9 @@
---
ms.openlocfilehash: 7e31c324900e21824e8214e6dcd453aa95ee85eb
ms.sourcegitcommit: 81faf43a57101e75d40b5f8f77b9b129699e5d41
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/08/2022
ms.locfileid: "147865215"
---
Puedes tener hasta 10 codespaces a la vez. Una vez que tengas 10 codespaces, deberás borrar alguno antes de que puedas crear uno nuevo.

9
translations/es-ES/data/reusables/gated-features/hosted-runners.md Normal file
View File

@@ -0,0 +1,9 @@
---
ms.openlocfilehash: 2d2d2bc1f01e722c0f30cf11b642033a762c429c
ms.sourcegitcommit: 63599cf9fbe175975abc95cb62fe740b9a1c1dc2
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/06/2022
ms.locfileid: "147853686"
---
La característica {% data variables.actions.hosted_runner %} está actualmente en versión beta para organizaciones y empresas que usan los planes {% data variables.product.prodname_team %} o {% data variables.product.prodname_ghe_cloud %} y está sujeto a cambios. Para solicitar acceso a la versión beta, visita la [página de registro](https://github.com/features/github-hosted-runners/signup).

10
translations/es-ES/data/reusables/getting-started/marketplace.md
View File

@@ -1 +1,9 @@
{% data variables.product.prodname_marketplace %} contains integrations that add functionality and improve your workflow. You can discover, browse, and install free and paid tools, including {% data variables.product.prodname_github_app %}s, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_actions %}, in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace). For more information, see "[About {% data variables.product.prodname_marketplace %}](/github/customizing-your-github-workflow/exploring-integrations/about-github-marketplace)."
---
ms.openlocfilehash: 9bef018102d679fa9379d73fcaa9d7133ef41192
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: "145110425"
---
{% data variables.product.prodname_marketplace %} contiene integraciones que agregan funcionalidad y mejoran tu flujo de trabajo. En [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace), puede descubrir, buscar e instalar herramientas gratuitas y de pago, incluidas {% data variables.product.prodname_github_app %}, {% data variables.product.prodname_oauth_app %} y {% data variables.product.prodname_actions %}. Para más información, vea "[Acerca de {% data variables.product.prodname_marketplace %}](/github/customizing-your-github-workflow/exploring-integrations/about-github-marketplace)".

12
translations/es-ES/data/reusables/gpg/x-509-key.md
View File

@@ -1,15 +1,15 @@
---
ms.openlocfilehash: 3aa2f76a2abdf35ef89c8e083cf01e5a021d23eb
ms.sourcegitcommit: 22d665055b1bee7a5df630385e734e3a149fc720
ms.openlocfilehash: 3661ae0cbef8282faa12b3d71bef77d503fcc0c6
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 07/13/2022
ms.locfileid: "145110114"
ms.lasthandoff: 09/05/2022
ms.locfileid: "147785414"
---
### <a name="telling-git-about-your-x509-key"></a>Informarle a Git acerca de tu llave X.509
## Informarle a Git acerca de tu llave X.509
Puede usar [smimesign](https://github.com/github/smimesign) para firmar confirmaciones y etiquetas mediante S/MIME en lugar de GPG.
Puedes usar [smimesign](https://github.com/github/smimesign) para firmar confirmaciones y etiquetas mediante S/MIME.
{% data reusables.gpg.smime-git-version %}

10
translations/es-ES/data/reusables/project-management/project-board-visibility.md
View File

@@ -1 +1,9 @@
By default, user-owned and organization-wide {% data variables.projects.projects_v1_boards %} are private and only visible to people with read, write, or admin permissions to the {% data variables.projects.projects_v1_board %}. {% ifversion ghae %}An internal{% else %}A public{% endif %} {% data variables.projects.projects_v1_board %} is visible to {% ifversion ghae %}any with access to your enterprise{% else %}anyone{% endif %} with the {% data variables.projects.projects_v1_board %}'s URL. Repository-level {% data variables.projects.projects_v1_boards %} share the visibility of their repository. That is, a private repository will have a private project, and this visibility cannot be changed.
---
ms.openlocfilehash: 6f5f7b9a1ef172b471215d5ea66d834fb00e19d7
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
ms.translationtype: HT
ms.contentlocale: es-ES
ms.lasthandoff: 09/05/2022
ms.locfileid: "147423696"
---
De forma predeterminada, las instancias de {% data variables.projects.projects_v1_boards %} propiedad del usuario y de toda la organización son privadas y solo son visibles para los usuarios con permisos de lectura, escritura o administrador en la instancia de {% data variables.projects.projects_v1_board %}. {% ifversion ghae %}Una instancia de {% data variables.projects.projects_v1_board %} interna{% else %} pública{% endif %} es visible para {% ifversion ghae %}cualquiera con acceso a la empresa{% else %}cualquiera{% endif %} con la URL de la instancia de {% data variables.projects.projects_v1_board %}. Las instancias de {% data variables.projects.projects_v1_boards %} de nivel de repositorio comparten la visibilidad de su repositorio. Esto significa que un repositorio privado tendrá un proyecto privado y esta visibilidad no se podrá cambiar.

35
translations/log/msft-es-resets.csv
View File

@@ -255,7 +255,6 @@ translations/es-ES/data/reusables/rest-reference/webhooks/webhooks.md,file delet
translations/es-ES/data/reusables/security-center/beta.md,file deleted because it no longer exists in main
translations/es-ES/data/reusables/security-center/permissions.md,file deleted because it no longer exists in main
translations/es-ES/data/reusables/server-statistics/release-phase.md,file deleted because it no longer exists in main
translations/es-ES/content/actions/automating-builds-and-tests/about-continuous-integration.md,broken liquid tags
translations/es-ES/content/actions/creating-actions/publishing-actions-in-github-marketplace.md,broken liquid tags
translations/es-ES/content/actions/deployment/about-deployments/deploying-with-github-actions.md,broken liquid tags
translations/es-ES/content/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect.md,broken liquid tags
@@ -267,9 +266,6 @@ translations/es-ES/content/actions/publishing-packages/publishing-nodejs-package
translations/es-ES/content/actions/using-github-hosted-runners/about-github-hosted-runners.md,broken liquid tags
translations/es-ES/content/actions/using-workflows/reusing-workflows.md,broken liquid tags
translations/es-ES/content/actions/using-workflows/workflow-commands-for-github-actions.md,broken liquid tags
translations/es-ES/content/actions/using-workflows/workflow-syntax-for-github-actions.md,broken liquid tags
translations/es-ES/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance.md,broken liquid tags
translations/es-ES/content/admin/configuration/configuring-github-connect/managing-github-connect.md,broken liquid tags
translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md,broken liquid tags
translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-email-for-notifications.md,broken liquid tags
translations/es-ES/content/admin/configuration/configuring-your-enterprise/site-admin-dashboard.md,broken liquid tags
@@ -277,9 +273,7 @@ translations/es-ES/content/admin/enterprise-management/updating-the-virtual-mach
translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md,broken liquid tags
translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference.md,broken liquid tags
translations/es-ES/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-vmware.md,broken liquid tags
translations/es-ES/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md,broken liquid tags
translations/es-ES/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/streaming-the-audit-log-for-your-enterprise.md,broken liquid tags
translations/es-ES/content/admin/overview/about-upgrades-to-new-releases.md,broken liquid tags
translations/es-ES/content/authentication/connecting-to-github-with-ssh/about-ssh.md,broken liquid tags
translations/es-ES/content/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account.md,broken liquid tags
translations/es-ES/content/authentication/managing-commit-signature-verification/about-commit-signature-verification.md,broken liquid tags
@@ -291,20 +285,9 @@ translations/es-ES/content/authentication/managing-commit-signature-verification
translations/es-ES/content/authentication/troubleshooting-commit-signature-verification/checking-your-commit-and-tag-signature-verification-status.md,broken liquid tags
translations/es-ES/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md,broken liquid tags
translations/es-ES/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md,broken liquid tags
translations/es-ES/content/billing/managing-licenses-for-visual-studio-subscriptions-with-github-enterprise/about-visual-studio-subscriptions-with-github-enterprise.md,broken liquid tags
translations/es-ES/content/code-security/adopting-github-advanced-security-at-scale/phase-2-preparing-to-enable-at-scale.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-alerts.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/integrating-with-code-scanning/index.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-runner-in-your-ci-system.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md,broken liquid tags
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-runner-in-your-ci-system.md,broken liquid tags
translations/es-ES/content/code-security/dependabot/dependabot-alerts/browsing-security-advisories-in-the-github-advisory-database.md,broken liquid tags
translations/es-ES/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md,broken liquid tags
translations/es-ES/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md,broken liquid tags
translations/es-ES/content/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file.md,broken liquid tags
@@ -314,9 +297,7 @@ translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespa
translations/es-ES/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md,broken liquid tags
translations/es-ES/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md,broken liquid tags
translations/es-ES/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md,broken liquid tags
translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace.md,broken liquid tags
translations/es-ES/content/codespaces/developing-in-codespaces/deleting-a-codespace.md,broken liquid tags
translations/es-ES/content/codespaces/getting-started/quickstart.md,broken liquid tags
translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md,broken liquid tags
translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md,broken liquid tags
translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md,broken liquid tags
@@ -329,18 +310,12 @@ translations/es-ES/content/communities/documenting-your-project-with-wikis/about
translations/es-ES/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account.md,rendering error
translations/es-ES/content/developers/apps/building-github-apps/authenticating-with-github-apps.md,broken liquid tags
translations/es-ES/content/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app.md,broken liquid tags
translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/about-using-makecode-arcade-with-github-classroom.md,broken liquid tags
translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md,broken liquid tags
translations/es-ES/content/get-started/customizing-your-github-workflow/exploring-integrations/about-github-marketplace.md,broken liquid tags
translations/es-ES/content/get-started/exploring-projects-on-github/following-organizations.md,broken liquid tags
translations/es-ES/content/get-started/onboarding/getting-started-with-github-enterprise-cloud.md,broken liquid tags
translations/es-ES/content/get-started/quickstart/be-social.md,broken liquid tags
translations/es-ES/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects.md,broken liquid tags
translations/es-ES/content/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue.md,broken liquid tags
translations/es-ES/content/issues/tracking-your-work-with-issues/planning-and-tracking-work-for-your-team-or-project.md,broken liquid tags
translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md,broken liquid tags
translations/es-ES/content/organizations/managing-organization-settings/allowing-project-visibility-changes-in-your-organization.md,broken liquid tags
translations/es-ES/content/organizations/managing-organization-settings/disabling-project-boards-in-your-organization.md,broken liquid tags
translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md,broken liquid tags
translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md,broken liquid tags
translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md,broken liquid tags
@@ -348,28 +323,20 @@ translations/es-ES/content/packages/learn-github-packages/introduction-to-github
translations/es-ES/content/packages/learn-github-packages/viewing-packages.md,broken liquid tags
translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md,broken liquid tags
translations/es-ES/content/pages/getting-started-with-github-pages/creating-a-github-pages-site.md,broken liquid tags
translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md,broken liquid tags
translations/es-ES/content/rest/guides/getting-started-with-the-rest-api.md,broken liquid tags
translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md,broken liquid tags
translations/es-ES/content/rest/overview/other-authentication-methods.md,broken liquid tags
translations/es-ES/content/rest/overview/resources-in-the-rest-api.md,broken liquid tags
translations/es-ES/content/support/learning-about-github-support/about-github-support.md,broken liquid tags
translations/es-ES/data/learning-tracks/code-security.yml,broken liquid tags
translations/es-ES/data/release-notes/github-ae/2021-06/2021-12-06.yml,broken liquid tags
translations/es-ES/data/reusables/accounts/create-account.md,broken liquid tags
translations/es-ES/data/reusables/actions/actions-billing.md,broken liquid tags
translations/es-ES/data/reusables/actions/actions-do-not-trigger-workflows.md,broken liquid tags
translations/es-ES/data/reusables/actions/contacting-support.md,broken liquid tags
translations/es-ES/data/reusables/actions/enterprise-storage-ha-backups.md,broken liquid tags
translations/es-ES/data/reusables/actions/jobs/section-running-jobs-in-a-container.md,broken liquid tags
translations/es-ES/data/reusables/actions/self-hosted-runner-add-to-enterprise.md,broken liquid tags
translations/es-ES/data/reusables/code-scanning/codeql-context-for-actions-and-third-party-tools.md,broken liquid tags
translations/es-ES/data/reusables/code-scanning/edit-workflow.md,broken liquid tags
translations/es-ES/data/reusables/code-scanning/example-configuration-files.md,broken liquid tags
translations/es-ES/data/reusables/code-scanning/run-additional-queries.md,broken liquid tags
translations/es-ES/data/reusables/codespaces/rebuild-command.md,broken liquid tags
translations/es-ES/data/reusables/getting-started/marketplace.md,broken liquid tags
translations/es-ES/data/reusables/package_registry/authenticate-packages.md,broken liquid tags
translations/es-ES/data/reusables/policies/abuse.md,rendering error
translations/es-ES/data/reusables/project-management/project-board-visibility.md,broken liquid tags
translations/es-ES/data/reusables/release-notes/ghas-3.4-secret-scanning-known-issue.md,broken liquid tags
translations/es-ES/data/reusables/sponsors/feedback.md,broken liquid tags
1 file reason
255 translations/es-ES/data/reusables/security-center/beta.md file deleted because it no longer exists in main
256 translations/es-ES/data/reusables/security-center/permissions.md file deleted because it no longer exists in main
257 translations/es-ES/data/reusables/server-statistics/release-phase.md file deleted because it no longer exists in main
translations/es-ES/content/actions/automating-builds-and-tests/about-continuous-integration.md broken liquid tags
258 translations/es-ES/content/actions/creating-actions/publishing-actions-in-github-marketplace.md broken liquid tags
259 translations/es-ES/content/actions/deployment/about-deployments/deploying-with-github-actions.md broken liquid tags
260 translations/es-ES/content/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect.md broken liquid tags
266 translations/es-ES/content/actions/using-github-hosted-runners/about-github-hosted-runners.md broken liquid tags
267 translations/es-ES/content/actions/using-workflows/reusing-workflows.md broken liquid tags
268 translations/es-ES/content/actions/using-workflows/workflow-commands-for-github-actions.md broken liquid tags
translations/es-ES/content/actions/using-workflows/workflow-syntax-for-github-actions.md broken liquid tags
translations/es-ES/content/admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance.md broken liquid tags
translations/es-ES/content/admin/configuration/configuring-github-connect/managing-github-connect.md broken liquid tags
269 translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance.md broken liquid tags
270 translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-email-for-notifications.md broken liquid tags
271 translations/es-ES/content/admin/configuration/configuring-your-enterprise/site-admin-dashboard.md broken liquid tags
273 translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md broken liquid tags
274 translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference.md broken liquid tags
275 translations/es-ES/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-vmware.md broken liquid tags
translations/es-ES/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md broken liquid tags
276 translations/es-ES/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/streaming-the-audit-log-for-your-enterprise.md broken liquid tags
translations/es-ES/content/admin/overview/about-upgrades-to-new-releases.md broken liquid tags
277 translations/es-ES/content/authentication/connecting-to-github-with-ssh/about-ssh.md broken liquid tags
278 translations/es-ES/content/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account.md broken liquid tags
279 translations/es-ES/content/authentication/managing-commit-signature-verification/about-commit-signature-verification.md broken liquid tags
285 translations/es-ES/content/authentication/troubleshooting-commit-signature-verification/checking-your-commit-and-tag-signature-verification-status.md broken liquid tags
286 translations/es-ES/content/billing/managing-billing-for-github-actions/about-billing-for-github-actions.md broken liquid tags
287 translations/es-ES/content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md broken liquid tags
translations/es-ES/content/billing/managing-licenses-for-visual-studio-subscriptions-with-github-enterprise/about-visual-studio-subscriptions-with-github-enterprise.md broken liquid tags
translations/es-ES/content/code-security/adopting-github-advanced-security-at-scale/phase-2-preparing-to-enable-at-scale.md broken liquid tags
translations/es-ES/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-alerts.md broken liquid tags
translations/es-ES/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql.md broken liquid tags
288 translations/es-ES/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md broken liquid tags
289 translations/es-ES/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository.md broken liquid tags
translations/es-ES/content/code-security/code-scanning/integrating-with-code-scanning/index.md broken liquid tags
translations/es-ES/content/code-security/code-scanning/integrating-with-code-scanning/sarif-support-for-code-scanning.md broken liquid tags
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/about-codeql-code-scanning-in-your-ci-system.md broken liquid tags
290 translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system.md broken liquid tags
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-runner-in-your-ci-system.md broken liquid tags
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md broken liquid tags
translations/es-ES/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/running-codeql-runner-in-your-ci-system.md broken liquid tags
translations/es-ES/content/code-security/dependabot/dependabot-alerts/browsing-security-advisories-in-the-github-advisory-database.md broken liquid tags
291 translations/es-ES/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md broken liquid tags
292 translations/es-ES/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md broken liquid tags
293 translations/es-ES/content/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file.md broken liquid tags
297 translations/es-ES/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md broken liquid tags
298 translations/es-ES/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md broken liquid tags
299 translations/es-ES/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md broken liquid tags
translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace.md broken liquid tags
300 translations/es-ES/content/codespaces/developing-in-codespaces/deleting-a-codespace.md broken liquid tags
translations/es-ES/content/codespaces/getting-started/quickstart.md broken liquid tags
301 translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md broken liquid tags
302 translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization.md broken liquid tags
303 translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md broken liquid tags
310 translations/es-ES/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account.md rendering error
311 translations/es-ES/content/developers/apps/building-github-apps/authenticating-with-github-apps.md broken liquid tags
312 translations/es-ES/content/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app.md broken liquid tags
translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/about-using-makecode-arcade-with-github-classroom.md broken liquid tags
313 translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md broken liquid tags
translations/es-ES/content/get-started/customizing-your-github-workflow/exploring-integrations/about-github-marketplace.md broken liquid tags
314 translations/es-ES/content/get-started/exploring-projects-on-github/following-organizations.md broken liquid tags
translations/es-ES/content/get-started/onboarding/getting-started-with-github-enterprise-cloud.md broken liquid tags
315 translations/es-ES/content/get-started/quickstart/be-social.md broken liquid tags
translations/es-ES/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects.md broken liquid tags
316 translations/es-ES/content/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue.md broken liquid tags
317 translations/es-ES/content/issues/tracking-your-work-with-issues/planning-and-tracking-work-for-your-team-or-project.md broken liquid tags
318 translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization.md broken liquid tags
translations/es-ES/content/organizations/managing-organization-settings/allowing-project-visibility-changes-in-your-organization.md broken liquid tags
translations/es-ES/content/organizations/managing-organization-settings/disabling-project-boards-in-your-organization.md broken liquid tags
319 translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md broken liquid tags
320 translations/es-ES/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md broken liquid tags
321 translations/es-ES/content/packages/learn-github-packages/deleting-and-restoring-a-package.md broken liquid tags
323 translations/es-ES/content/packages/learn-github-packages/viewing-packages.md broken liquid tags
324 translations/es-ES/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md broken liquid tags
325 translations/es-ES/content/pages/getting-started-with-github-pages/creating-a-github-pages-site.md broken liquid tags
326 translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md broken liquid tags
translations/es-ES/content/rest/guides/getting-started-with-the-rest-api.md broken liquid tags
327 translations/es-ES/content/rest/overview/other-authentication-methods.md broken liquid tags
328 translations/es-ES/content/rest/overview/resources-in-the-rest-api.md broken liquid tags
translations/es-ES/content/support/learning-about-github-support/about-github-support.md broken liquid tags
329 translations/es-ES/data/learning-tracks/code-security.yml broken liquid tags
330 translations/es-ES/data/release-notes/github-ae/2021-06/2021-12-06.yml broken liquid tags
translations/es-ES/data/reusables/accounts/create-account.md broken liquid tags
331 translations/es-ES/data/reusables/actions/actions-billing.md broken liquid tags
332 translations/es-ES/data/reusables/actions/actions-do-not-trigger-workflows.md broken liquid tags
translations/es-ES/data/reusables/actions/contacting-support.md broken liquid tags
333 translations/es-ES/data/reusables/actions/enterprise-storage-ha-backups.md broken liquid tags
334 translations/es-ES/data/reusables/actions/jobs/section-running-jobs-in-a-container.md broken liquid tags
335 translations/es-ES/data/reusables/actions/self-hosted-runner-add-to-enterprise.md broken liquid tags
translations/es-ES/data/reusables/code-scanning/codeql-context-for-actions-and-third-party-tools.md broken liquid tags
translations/es-ES/data/reusables/code-scanning/edit-workflow.md broken liquid tags
336 translations/es-ES/data/reusables/code-scanning/example-configuration-files.md broken liquid tags
337 translations/es-ES/data/reusables/code-scanning/run-additional-queries.md broken liquid tags
338 translations/es-ES/data/reusables/codespaces/rebuild-command.md broken liquid tags
translations/es-ES/data/reusables/getting-started/marketplace.md broken liquid tags
339 translations/es-ES/data/reusables/package_registry/authenticate-packages.md broken liquid tags
340 translations/es-ES/data/reusables/policies/abuse.md rendering error
translations/es-ES/data/reusables/project-management/project-board-visibility.md broken liquid tags
341 translations/es-ES/data/reusables/release-notes/ghas-3.4-secret-scanning-known-issue.md broken liquid tags
342 translations/es-ES/data/reusables/sponsors/feedback.md broken liquid tags