New translation batch for es (#24668)
* Add crowdin translations * Run script/i18n/homogenize-frontmatter.js * Run script/i18n/fix-translation-errors.js * Run script/i18n/lint-translation-files.js --check parsing * run script/i18n/reset-files-with-broken-liquid-tags.js --language=es * run script/i18n/reset-known-broken-translation-files.js Co-authored-by: Kevin Heis <heiskr@users.noreply.github.com>
This commit is contained in:
docubot
@@ -46,7 +46,7 @@ Para dar seguimiento a las notificaciones, podrías considerar la pregunta "¿En
|
||||
|
||||
Por ejemplo, puedes decidir dar seguimiento en este orden:
|
||||
- Los informes de problemas y solicitudes de extracción a los que estás asignado. Inmediatamente cierra cualquier informe de problemas o solicitudes de extracción que puedas y añade actualizaciones. Guarda las notificaciones que desees revisar después conforme lo necesites.
|
||||
- Revisa las notificaciones en la bandeja de guardados, especialmente las que no leídas. Si el hilo ya no es relevante, desmarca {% octicon "bookmark" aria-label="The bookmark icon" %} para eliminar la notificación de la bandeja de guardados, y márcala como no guardada.
|
||||
- Revisa las notificaciones en la bandeja de guardados, especialmente las que no leídas. If the thread is no longer relevant, deselect {% octicon "bookmark" aria-label="The bookmark icon" %} to remove the notification from the saved inbox and unsave it.
|
||||
|
||||
## Administrar notificaciones de prioridad más baja
|
||||
|
||||
|
||||
@@ -28,7 +28,7 @@ Para obtener más información acerca de cómo se calculan las contribuciones, c
|
||||
{% note %}
|
||||
|
||||
**Notas:**
|
||||
- La conexión entre tus cuentas está regulada por la <a href="/articles/github-privacy-statement/" class="dotcom-only">Declaración de privacidad de GitHub</a>, y los usuarios que habilitan la conexión aceptan los Términos de servicio de GitHub<a href="/articles/github-terms-of-service/" class="dotcom-only"></a>.
|
||||
- The connection between your accounts is governed by [GitHub's Privacy Statement](/free-pro-team@latest/github/site-policy/github-privacy-statement/) and users enabling the connection agree to the [GitHub's Terms of Service](/free-pro-team@latest/github/site-policy/github-terms-of-service).
|
||||
|
||||
- Antes de que puedas conectar tu perfil de {% ifversion fpt or ghec %}{% data variables.product.prodname_enterprise %}{% else %}{% data variables.product.product_name %}{% endif %} a tu perfil de {% data variables.product.prodname_dotcom_the_website %}, tu empresa debe habilitar {% data variables.product.prodname_github_connect %} y también el compartir contribuciones entre los ambientes. Para obtener más información, contacta a tu propietario de empresa.
|
||||
|
||||
|
||||
@@ -88,7 +88,7 @@ Para más información, consulta [`actions/cache`](https://github.com/actions/ca
|
||||
### Parámetros de entrada para la acción `chache`
|
||||
|
||||
- `key`: **Obligatorio** La clave que se crea cuando se guarda una memoria caché y la clave utilizada para buscar una caché. Puede ser cualquier combinación de variables, valores de contexto, cadenas estáticas y funciones. Las claves tienen una longitud máxima de 512 caracteres y las claves más largas que la longitud máxima provocarán un error en la acción.
|
||||
- `path`: **Obligatorio** La ruta del archivo en el ejecutor para almacenar en caché o restaurar. La ruta debe ser absoluta o relativa al directorio de trabajo.
|
||||
- `path`: **Obligatorio** La ruta del archivo en el ejecutor para almacenar en caché o restaurar. The path can be an absolute path or relative to the workspace directory.
|
||||
- Las rutas pueden ser tanto directorios o solo archivos, y los patrones estilo glob son compatibles.
|
||||
- Con la `v2` de la acción `cache`, puedes especificar una ruta sencilla o puedes agregar rutas múltiples en líneas separadas. Por ejemplo:
|
||||
```
|
||||
|
||||
@@ -238,7 +238,7 @@ jobs:
|
||||
|
||||
## Limpiar tu código
|
||||
|
||||
El siguiente ejemplo instala `rubocop` y lo utiliza para limpiar todos los archivos. Para obtener más información, consulta la sección [Rubocop](https://github.com/rubocop-hq/rubocop). Puedes [configurar Rubocop](https://docs.rubocop.org/rubocop/configuration.html) para decidir cuáles serán las reglas de limpieza específicas.
|
||||
El siguiente ejemplo instala `rubocop` y lo utiliza para limpiar todos los archivos. For more information, see [RuboCop](https://github.com/rubocop-hq/rubocop). Puedes [configurar Rubocop](https://docs.rubocop.org/rubocop/configuration.html) para decidir cuáles serán las reglas de limpieza específicas.
|
||||
|
||||
```yaml
|
||||
{% data reusables.actions.actions-not-certified-by-github-comment %}
|
||||
|
||||
@@ -16,193 +16,9 @@ versions:
|
||||
shortTitle: Eventos que desencadenan flujos de trabajo
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-beta %}
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
## About events that trigger workflows
|
||||
|
||||
## Acerca de los activadores de los flujos de trabajo
|
||||
|
||||
Los activadores de los flujos de trabajo son eventos que ocasionan que se ejecute un flujo de trabajo. Estos eventos pueden ser:
|
||||
|
||||
- Eventos que ocurren en el repositorio de tu flujo de trabajo
|
||||
- Eventos que ocurren fuera de {% data variables.product.product_name %} y activan un evento de `repository_dispatch` en {% data variables.product.product_name %}
|
||||
- Tiempos programados
|
||||
- Manual
|
||||
|
||||
Por ejemplo, puedes configurar tu flujo de trabajo para que se ejecute cuando se realiza una subida a la rama predeterminada de tu repositorio, cuando se crea un lanzamiento o cuando se abre una propuesta.
|
||||
|
||||
Los activadores de los flujos de trabajo se definen con la clave `on`. Para obtener más información, consulta la sección "[Sintaxis del flujo de trabajo para las {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)".
|
||||
|
||||
Los siguientes pasos se producen para activar una ejecución de flujo de trabajo:
|
||||
|
||||
1. Un eventto ocurre en tu repositorio. El evento tiene un SHA de confirmación asociado y una ref de Git.
|
||||
1. {% data variables.product.product_name %} busca el directorio `.github/workflows` en tu repositorio para el caso de los archivos de flujo de trabajo que están presentes en el SHA de confirmación asociado o Git Ref del evento.
|
||||
|
||||
1. Un flujo de trabajo se activará para cualquier flujo de trabajo que tenga valores de `on:` que empaten con el evento que s eactivó. Algunos eventos también requieren que el flujo de trabajo esté presente en la rama predeterminada del repositorio para poder ejecutarse.
|
||||
|
||||
Cada ejecución de flujo de trabajo utiliza la versión de este que esté presente en el SHA de confirmación asociado o Git Ref del evento. Cuando se ejecuta un flujo de trabajo, {% data variables.product.product_name %} establece las variables de entorno `GITHUB_SHA` (confirmar SHA) y `GITHUB_REF` (referencia de Git) en el entorno del ejecutor. Para obtener más información, consulta "[Usar variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)".
|
||||
|
||||
### Activar un flujo de trabajo desde otro
|
||||
|
||||
{% data reusables.github-actions.actions-do-not-trigger-workflows %} Para obtener más información, consulta "[Autenticar con el GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)".
|
||||
|
||||
Si no quieres activar un flujo de trabajo dentro una ejecución de flujo de trabajo, puedes utilizar un token de acceso personal en vez de un `GITHUB_TOKEN` para activar los eventos que requieren tu token. Necesitaras crear un token de acceso personal y almacenarlo como un secreto. Para minimizar tus costos de uso de {% data variables.product.prodname_actions %}, asegúrate de no crear ejecuciones de flujo de trabajo recurrentes o involuntarias. Para obtener más información acerca de cómo crear un token de acceso personal, consulta la sección "[Crear un token de acceso personal](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)". Para obtener más información sobre cómo almacenr un token de acceso personal como secreto, consulta la sección "[Crear y almacenar secretos cifrados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)".
|
||||
|
||||
Por ejemplo, el siguiente flujo de trabajo utiliza un token de acceso personal (almacenado como secreto y llamado `MY_TOKEN`) para agregar una etiqueta a una propuesta de cambios a través del cli.{% data variables.product.prodname_cli %}. Cualquier flujo de trabajo que se ejecute cuando una etiqueta se agrega se ejecutará una vez mediante este espejo.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
issues:
|
||||
types:
|
||||
- opened
|
||||
|
||||
jobs:
|
||||
label_issue:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- env:
|
||||
GITHUB_TOKEN: {% raw %}${{ secrets.MY_TOKEN }}{% endraw %}
|
||||
ISSUE_URL: {% raw %}${{ github.event.issue.html_url }}{% endraw %}
|
||||
run: |
|
||||
gh issue edit $ISSUE_URL --add-label "triage"
|
||||
```
|
||||
|
||||
Por el contrario, el siguiente flujo de trabajo utiliza un `GITHUB_TOKEN` para agregar una etiqueta a una propuesta. No activará ningún flujo de trabajo que se ejecute cuando se agregue una etiqueta.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
issues:
|
||||
types:
|
||||
- opened
|
||||
|
||||
jobs:
|
||||
label_issue:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- env:
|
||||
GITHUB_TOKEN: {% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %}
|
||||
ISSUE_URL: {% raw %}${{ github.event.issue.html_url }}{% endraw %}
|
||||
run: |
|
||||
gh issue edit $ISSUE_URL --add-label "triage"
|
||||
```
|
||||
|
||||
## Utilizar eventos para activar flujos de trabajo
|
||||
|
||||
Utiliza la clave `on` para especificar qué eventos activan tu flujo de trabajo. Para obtener más información acerca de los eventos, consulta los "[Eventos disponibles](#available-events)" más adelante.
|
||||
|
||||
{% data reusables.github-actions.actions-on-examples %}
|
||||
|
||||
## Utilizar la información de los eventos
|
||||
|
||||
La información acerca del evento que activó una ejecución de flujo de trabajo se encuentra disponible en el contexto `github.event`. Las propiedades en el contexto `github.event` dependen del tipo de evento que activó el flujo de trabajo. Por ejemplo, un flujo de trabajo que se activa cuando se etiqueta una propuesta tendrá la información sobre la propuesta y etiqueta.
|
||||
|
||||
### Ver todas las propiedades de un evento
|
||||
|
||||
Referencia la documentación de evento de webhook para las propiedades comunes y cargas útiles de ejemplo. Para obtener más información, consulta la sección "[eventos y cargas útiles de los webhooks](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads)".
|
||||
|
||||
También puedes imprimir todo el contexto `github.event` para ver qué propiedades están disponibles para el evento que activó tu flujo de trabajo:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
print_context:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- env:
|
||||
EVENT_CONTEXT: {% raw %}${{ toJSON(github.event) }}{% endraw %}
|
||||
run: |
|
||||
echo $EVENT_CONTEXT
|
||||
```
|
||||
|
||||
### Acceder y utilizar las propiedades de evento
|
||||
|
||||
Puedes utilizar el contexto `github.event` en tu flujo de trabajo. Por ejemplo, el siguiente flujo de trabajo se ejecuta cuando se abre una solicitud de cambios que cambia a `package*.json`, `.github/CODEOWNERS` o `.github/workflows/**`. Si el autor de la solicitud de cambios (`github.event.pull_request.user.login`) no es `octobot` o `dependabot[bot]`, entonces el flujo de trabajo utilizará el {% data variables.product.prodname_cli %} para etiquetar y comentar en la solicitud de cambios (`github.event.pull_request.number`).
|
||||
|
||||
```yaml
|
||||
on:
|
||||
pull_request:
|
||||
types:
|
||||
- opened
|
||||
paths:
|
||||
- '.github/workflows/**'
|
||||
- '.github/CODEOWNERS'
|
||||
- 'package*.json'
|
||||
|
||||
jobs:
|
||||
triage:
|
||||
if: >-
|
||||
github.event.pull_request.user.login != 'octobot' &&
|
||||
github.event.pull_request.user.login != 'dependabot[bot]'
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: "Comment about changes we can't accept"
|
||||
env:
|
||||
GITHUB_TOKEN: {% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %}
|
||||
PR: {% raw %}${{ github.event.pull_request.html_url }}{% endraw %}
|
||||
run: |
|
||||
gh pr edit $PR --add-label 'invalid'
|
||||
gh pr comment $PR --body 'It looks like you edited `package*.json`, `.github/CODEOWNERS`, or `.github/workflows/**`. No permitimos contribuciones a estos archivos. Por favor, revisa nuestros [lineamientos de contribución](https://github.com/octo-org/octo-repo/blob/main/CONTRIBUTING.md) para ver qué tipo de contribuciones se aceptan.'
|
||||
```
|
||||
|
||||
Para obtener más información sobre los contextos, consulta la sección "[Contextos](/actions/learn-github-actions/contexts)". Para obtener más información sobre las cargas útiles de los eventos, consulta la sección "[Eventos y cargas útiles de los webhooks](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads)".
|
||||
|
||||
## Controlar aún más la forma en la que se ejecutará tu flujo de trabajo
|
||||
|
||||
Si quieres un control más granular que el que proporcionan los eventos, tipos de actividad de eventos o filtros de evento, puedes utilizar condicionales{% ifversion fpt or ghae or ghes > 3.1 or ghec %} y ambientes{% endif %} para controlar si se ejecutarán los jobs o pasos individuales en tu flujo de trabajo.
|
||||
|
||||
### Utilziar condicionales
|
||||
|
||||
Puedes utilizar condicionales para controlar aún más si se ejecutarán los jobs o pasos de tu flujo de trabajo. Por ejemplo, si quieres que el flujo de trabajo se ejecute cuando se agrega una etiqueta específica a una propuesta, puedes activar el tipo de actividad de evento `issues labeled` y utilizar una condicional para verificar qué etiqueta activó el flujo de trabajo. El siguiente flujo de trabajo se ejecutará cuando se agregue cualquier etiqueta a una propuesta en su repositorio, pero el job `run_if_label_matches` solo se ejecutará si la etiqueta se nombra `bug`.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
issues:
|
||||
types:
|
||||
- labeled
|
||||
|
||||
jobs:
|
||||
run_if_label_matches:
|
||||
if: github.event.label.name == 'bug'
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- run: echo 'The label was bug'
|
||||
```
|
||||
|
||||
Para obtener más información, consulta la sección "[Expresiones](/actions/learn-github-actions/expressions)".
|
||||
|
||||
{% ifversion fpt or ghae or ghes > 3.1 or ghec %}
|
||||
### Utilizar ambientes para activar jobs de flujos de trabajo manualmente
|
||||
|
||||
Si quieres activar manualmente un job específico en un flujo de trabajo, puedes utilizar un ambiente que requiera aprobación de un equipo o usuario específico. Primero, configura un ambiente con revisores requeridos. Para obtener más información, consulta la sección "[Utilizar ambientes para despliegue](/actions/deployment/targeting-different-environments/using-environments-for-deployment)". Luego, referencia el nombre del ambiente en un job de tu flujo de trabajo utilizando la clave `environment:`. No se ejecutará ningún job que referencie el ambiente hasta que por lo menos un revisor lo apruebe.
|
||||
|
||||
Por ejemplo, el siguiente fluljo de trabajo se ejecutará siempre que haya una subida a la rama principal (main). El job `build` siempre se ejecutará. El job `publish` solo se ejecutará después de que el job `build` se complete con éxito (debido a `needs: [build]`) y después de que pasen todas las reglas (incluyendo a los revisores requeridos) para el ambiente llamado `production` (debido a `environment: production`).
|
||||
|
||||
```yaml
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: build
|
||||
echo 'building'
|
||||
|
||||
publish:
|
||||
needs: [build]
|
||||
runs-on: ubuntu-latest
|
||||
environment: production
|
||||
steps:
|
||||
- name: publish
|
||||
echo 'publishing'
|
||||
```
|
||||
|
||||
{% note %}
|
||||
|
||||
{% data reusables.gated-features.environments %}
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
Los activadores de los flujos de trabajo son eventos que ocasionan que se ejecute un flujo de trabajo. For more information about how to use workflow triggers, see "[Triggering a workflow](/actions/using-workflows/triggering-a-workflow)."
|
||||
|
||||
## Eventos disponibles
|
||||
|
||||
@@ -715,7 +531,7 @@ on:
|
||||
|
||||
Ejecuta tu flujo de trabajo cuando se crea o modifica una columna en un tablero de proyecto. Para ver la actividad relacionada con las tarjetas o tableros de proyecto, utiliza el evento [`project`](#project) o [`project_card`](#project_card) en su lugar. Para obtener más información acerca de los tableros de proyecto, consulta la sección "[Acerca de los tableros de proyecto](/issues/organizing-your-work-with-project-boards/managing-project-boards/about-project-boards)". Para obtener más información sobre las API de columna de proyecto, consulta la sección "[ProjectColumn](/graphql/reference/objects#projectcolumn)" en la documentación de la API de GraphQL o "[Columnas de proyecto](/rest/reference/projects#columns)" en la documentación de la API de REST.
|
||||
|
||||
Por ejemplo, puedes ejecutar un flujo de trabajo cuando una columna de proyecto ha sido `creado` o `eliminado`.
|
||||
Por ejemplo, puedes ejecutar un flujo de trabajo cuando una columna de proyecto ha sido `created` o `deleted`.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -889,7 +705,7 @@ Para ejecutar tu flujo de trabajo cuando se crea, edita o borra un comentario en
|
||||
|
||||
Ejecuta tu flujo de trabajo cuando se emite, edita o descarta una revisión de una solicitud de cambios. Una revisión de solicitud de cambios es un grupo de comentarios de dicha revisión junto con un comentario del cuerpo y un estado. Para encontrar actividad relacionada con los comentarios o comentarios de revisión de una solicitud de cambios, utiliza los eventos [`pull_request_review_comment`](#pull_request_review_comment) o [`issue_comment`](#issue_comment) en su lugar. Para obtener más información acerca de las API de revisión de solicitudes de cambio, consulta la sección "[PullRequestReview](/graphql/reference/objects#pullrequest)" en la documentación de la API de GraphQL o "[Revisiones de solicitudes de cambio](/rest/reference/pulls#reviews)" en la documentación de la API de REST.
|
||||
|
||||
Por ejemplo, puedes ejecutar un flujo de trabajo cuando una revisión de solicitud de extracción ha sido `edited` (editada) o `dismissed` (descartada).
|
||||
Por ejemplo, puedes ejecutar un flujo de trabajo cuando una revisión de solicitud de extracción ha sido `editada` o `descartada`.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -930,7 +746,7 @@ jobs:
|
||||
|
||||
Ejecuta tu flujo de trabajo cuando se modifica un comentario de una revisión de solicitud de cambios. Un comentario de revisión de una solicitud de cambios es un comentario en el diff de dicha solicitud. Para encontrar actividad relacionada con las revisiones o comentarios de las solicitudes de cambio, utiliza los eventos [`pull_request_review`](#pull_request_review) o [`issue_comment`](#issue_comment) en su lugar. Para obtener más información acerca de las API de comentarios de las revisiones de solicitudes de cambio, consulta la sección "[PullRequestReviewComment](/graphql/reference/objects#pullrequestreviewcomment)" en la documentación de la API de GraphQL o "[Comentarios de revisión](/rest/reference/pulls#comments)" en la documentación de la API de REST.
|
||||
|
||||
Por ejemplo, puedes ejecutar un flujo de trabajo cuando un comentario de revisión de solicitud de extracción ha sido `created` o `deleted`.
|
||||
Por ejemplo, puedes ejecutar un flujo de trabajo cuando un comentario de revisión de solicitud de extracción ha sido `creado` o `eliminado`.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -1061,7 +877,7 @@ on:
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota:** La carga disponible del webhook para las acciones de GitHub no incluye los atributos `added`, `removed` y `modified` en el objeto `commit`. Puedes recuperar el objeto de confirmación completo utilizando la API. Para obtener información, consulta la sección "[Confirmación](/graphql/reference/objects#commit)" en la documentación de la API de GraphQL o "[Obtén una confirmación](/rest/reference/commits#get-a-commit)" en la documentación de la API de REST.
|
||||
**Nota:** La carga disponible del webhook para las Acciones de GitHub no incluye los atributos `añadidos`, `eliminados`, y `modificados` en el objeto de `confirmación`. Puedes recuperar el objeto de confirmación completo utilizando la API. Para obtener información, consulta la sección "[Confirmación](/graphql/reference/objects#commit)" en la documentación de la API de GraphQL o "[Obtén una confirmación](/rest/reference/commits#get-a-commit)" en la documentación de la API de REST.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
@@ -1204,7 +1020,7 @@ on:
|
||||
|
||||
Ejecuta tu flujo de trabajo cuando ocurre una actividad de lanzamiento en tu repositorio. Para obtener más información sobre las API de lanzamiento, consulta la sección de "[Lanzamiento](/graphql/reference/objects#release)" en la documentación de la API de GraphQL o "[Lanzamientos](/rest/reference/repos#releases)" en la documentación de la API de REST.
|
||||
|
||||
Por ejemplo, puedes ejecutar un flujo de trabajo cuando un lanzamiento ha sido `publish`.
|
||||
Por ejemplo, puedes ejecutar un flujo de trabajo cuando un lanzamiento ha sido `publicado`.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -1300,7 +1116,7 @@ Puedes usar estos operadores en cualquiera de los cinco campos:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
Puedes usar [contrab guru](https://crontab.guru/) para generar tu sintaxis de cron y confirmar a qué hora se ejecutará. Para que puedas comenzar, hay también una lista de [ejemplos de crontab guru](https://crontab.guru/examples.html).
|
||||
Puedes usar [contrab guru](https://crontab.guru/) para ayudar a generar tu sintaxis de cron y confirmar a qué hora se ejecutará. Para que puedas comenzar, hay también una lista de [ejemplos de crontab guru](https://crontab.guru/examples.html).
|
||||
|
||||
Las notificaciones para los flujos de trabajo programados se envían al usuario que modificó por última vez la sintaxis de cron en el archivo de flujo de trabajo. Para obtener más información, consulta la sección "[Notificaciones para las ejecuciones de flujo de trabajo](/actions/guides/about-continuous-integration#notifications-for-workflow-runs)".
|
||||
|
||||
@@ -1314,7 +1130,7 @@ Las notificaciones para los flujos de trabajo programados se envían al usuario
|
||||
|
||||
Ejecuta tu flujo de trabajo cuando cambia el estado de una confirmación de Git. Por ejemplo, las confirmaciones pueden marcarse como `error`, `failure`, `pending` o `success`. Si quieres proporcionar más detalles sobre el cambio de estado, puede que quieras utilizar el evento [`check_run`](#check_run). Para obtener más información sobre las API de estado de confirmación, consulta la sección "[Estado](/graphql/reference/objects#statue)" en la documentación de la API de GraphQL o "[Estados](/rest/reference/commits#commit-statuses)" en la documentación de la API de REST.
|
||||
|
||||
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento `status`.
|
||||
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento de `estado`.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
|
||||
@@ -110,7 +110,7 @@ Puedes definir entradas y secretos, las cuales pueden pasarse desde el flujo de
|
||||
runs-on: ubuntu-latest
|
||||
environment: production
|
||||
steps:
|
||||
- uses: ./.github/actions/my-action@v1
|
||||
- uses: ./.github/actions/my-action
|
||||
with:
|
||||
username: ${{ inputs.username }}
|
||||
token: ${{ secrets.envPAT }}
|
||||
@@ -151,7 +151,7 @@ jobs:
|
||||
name: Pass input and secrets to my-action
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: ./.github/actions/my-action@v1
|
||||
- uses: ./.github/actions/my-action
|
||||
with:
|
||||
username: ${{ inputs.username }}
|
||||
token: ${{ secrets.token }}
|
||||
|
||||
@@ -12,36 +12,235 @@ topics:
|
||||
- Workflows
|
||||
- CI
|
||||
- CD
|
||||
miniTocMaxHeadingLevel: 4
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-beta %}
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
|
||||
## Resumen
|
||||
## Acerca de los activadores de los flujos de trabajo
|
||||
|
||||
{% data reusables.actions.workflows.section-triggering-a-workflow %}
|
||||
Los activadores de los flujos de trabajo son eventos que ocasionan que se ejecute un flujo de trabajo. Estos eventos pueden ser:
|
||||
|
||||
## Defining event types
|
||||
- Eventos que ocurren en el repositorio de tu flujo de trabajo
|
||||
- Eventos que ocurren fuera de {% data variables.product.product_name %} y activan un evento de `repository_dispatch` en {% data variables.product.product_name %}
|
||||
- Tiempos programados
|
||||
- Manual
|
||||
|
||||
{% data reusables.actions.workflows.section-triggering-a-workflow-types %}
|
||||
Por ejemplo, puedes configurar tu flujo de trabajo para que se ejecute cuando se realiza una subida a la rama predeterminada de tu repositorio, cuando se crea un lanzamiento o cuando se abre una propuesta.
|
||||
|
||||
## Apuntar a ramas específicas
|
||||
Los activadores de los flujos de trabajo se definen con la clave `on`. Para obtener más información, consulta la sección "[Sintaxis del flujo de trabajo para las {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)".
|
||||
|
||||
Los siguientes pasos se producen para activar una ejecución de flujo de trabajo:
|
||||
|
||||
1. Un eventto ocurre en tu repositorio. El evento tiene un SHA de confirmación asociado y una ref de Git.
|
||||
1. {% data variables.product.product_name %} busca el directorio `.github/workflows` en tu repositorio para el caso de los archivos de flujo de trabajo que están presentes en el SHA de confirmación asociado o Git Ref del evento.
|
||||
1. Un flujo de trabajo se activará para cualquier flujo de trabajo que tenga valores de `on:` que empaten con el evento que s eactivó. Algunos eventos también requieren que el flujo de trabajo esté presente en la rama predeterminada del repositorio para poder ejecutarse.
|
||||
|
||||
Cada ejecución de flujo de trabajo utiliza la versión de este que esté presente en el SHA de confirmación asociado o Git Ref del evento. Cuando se ejecuta un flujo de trabajo, {% data variables.product.product_name %} establece las variables de entorno `GITHUB_SHA` (confirmar SHA) y `GITHUB_REF` (referencia de Git) en el entorno del ejecutor. Para obtener más información, consulta "[Usar variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)".
|
||||
|
||||
### Activar un flujo de trabajo desde otro
|
||||
|
||||
{% data reusables.github-actions.actions-do-not-trigger-workflows %} Para obtener más información, consulta "[Autenticar con el GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)".
|
||||
|
||||
Si no quieres activar un flujo de trabajo dentro una ejecución de flujo de trabajo, puedes utilizar un token de acceso personal en vez de un `GITHUB_TOKEN` para activar los eventos que requieren tu token. Necesitaras crear un token de acceso personal y almacenarlo como un secreto. Para minimizar tus costos de uso de {% data variables.product.prodname_actions %}, asegúrate de no crear ejecuciones de flujo de trabajo recurrentes o involuntarias. Para obtener más información acerca de cómo crear un token de acceso personal, consulta la sección "[Crear un token de acceso personal](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)". Para obtener más información sobre cómo almacenr un token de acceso personal como secreto, consulta la sección "[Crear y almacenar secretos cifrados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)".
|
||||
|
||||
Por ejemplo, el siguiente flujo de trabajo utiliza un token de acceso personal (almacenado como secreto y llamado `MY_TOKEN`) para agregar una etiqueta a una propuesta de cambios a través del cli.{% data variables.product.prodname_cli %}. Cualquier flujo de trabajo que se ejecute cuando una etiqueta se agrega se ejecutará una vez mediante este espejo.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
issues:
|
||||
types:
|
||||
- opened
|
||||
|
||||
jobs:
|
||||
label_issue:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- env:
|
||||
GITHUB_TOKEN: {% raw %}${{ secrets.MY_TOKEN }}{% endraw %}
|
||||
ISSUE_URL: {% raw %}${{ github.event.issue.html_url }}{% endraw %}
|
||||
run: |
|
||||
gh issue edit $ISSUE_URL --add-label "triage"
|
||||
```
|
||||
|
||||
Por el contrario, el siguiente flujo de trabajo utiliza un `GITHUB_TOKEN` para agregar una etiqueta a una propuesta. No activará ningún flujo de trabajo que se ejecute cuando se agregue una etiqueta.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
issues:
|
||||
types:
|
||||
- opened
|
||||
|
||||
jobs:
|
||||
label_issue:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- env:
|
||||
GITHUB_TOKEN: {% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %}
|
||||
ISSUE_URL: {% raw %}${{ github.event.issue.html_url }}{% endraw %}
|
||||
run: |
|
||||
gh issue edit $ISSUE_URL --add-label "triage"
|
||||
```
|
||||
|
||||
## Utilizar eventos para activar flujos de trabajo
|
||||
|
||||
Utiliza la clave `on` para especificar qué eventos activan tu flujo de trabajo. For more information about events you can use, see "[Events that trigger workflows](/actions/using-workflows/events-that-trigger-workflows)."
|
||||
|
||||
### Utilizar un evento simple
|
||||
|
||||
{% data reusables.github-actions.on-single-example %}
|
||||
|
||||
### Utilizar eventos múltiples
|
||||
|
||||
{% data reusables.github-actions.on-multiple-example %}
|
||||
|
||||
### Utilizar los tipos de actividad y filtros con eventos múltiples
|
||||
|
||||
You can use activity types and filters to further control when your workflow will run. For more information, see [Using event activity types](#using-event-activity-types) and [Using filters](#using-filters). {% data reusables.github-actions.actions-multiple-types %}
|
||||
|
||||
## Using event activity types
|
||||
|
||||
{% data reusables.github-actions.actions-activity-types %}
|
||||
|
||||
## Utilizar filtros
|
||||
|
||||
{% data reusables.github-actions.actions-filters %}
|
||||
|
||||
### Using filters to target specific branches for pull request events
|
||||
|
||||
{% data reusables.actions.workflows.section-triggering-a-workflow-branches %}
|
||||
|
||||
## Running on specific branches or tags
|
||||
### Using filters to target specific branches or tags for push events
|
||||
|
||||
{% data reusables.actions.workflows.section-run-on-specific-branches-or-tags %}
|
||||
|
||||
## Specifying which branches the workflow can run on
|
||||
|
||||
{% data reusables.actions.workflows.section-specifying-branches %}
|
||||
|
||||
## Using specific file paths
|
||||
### Using filters to target specific paths for pull request or push events
|
||||
|
||||
{% data reusables.actions.workflows.section-triggering-a-workflow-paths %}
|
||||
|
||||
## Using a schedule
|
||||
### Using filters to target specific branches for workflow run events
|
||||
|
||||
{% data reusables.actions.workflows.section-triggering-a-workflow-schedule %}
|
||||
{% data reusables.actions.workflows.section-specifying-branches %}
|
||||
|
||||
## Defining inputs for manually triggered workflows
|
||||
|
||||
{% data reusables.github-actions.workflow-dispatch-inputs %}
|
||||
|
||||
## Utilizar la información de los eventos
|
||||
|
||||
La información acerca del evento que activó una ejecución de flujo de trabajo se encuentra disponible en el contexto `github.event`. Las propiedades en el contexto `github.event` dependen del tipo de evento que activó el flujo de trabajo. Por ejemplo, un flujo de trabajo que se activa cuando se etiqueta una propuesta tendrá la información sobre la propuesta y etiqueta.
|
||||
|
||||
### Ver todas las propiedades de un evento
|
||||
|
||||
Referencia la documentación de evento de webhook para las propiedades comunes y cargas útiles de ejemplo. Para obtener más información, consulta la sección "[eventos y cargas útiles de los webhooks](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads)".
|
||||
|
||||
También puedes imprimir todo el contexto `github.event` para ver qué propiedades están disponibles para el evento que activó tu flujo de trabajo:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
print_context:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- env:
|
||||
EVENT_CONTEXT: {% raw %}${{ toJSON(github.event) }}{% endraw %}
|
||||
run: |
|
||||
echo $EVENT_CONTEXT
|
||||
```
|
||||
|
||||
### Acceder y utilizar las propiedades de evento
|
||||
|
||||
Puedes utilizar el contexto `github.event` en tu flujo de trabajo. Por ejemplo, el siguiente flujo de trabajo se ejecuta cuando se abre una solicitud de cambios que cambia a `package*.json`, `.github/CODEOWNERS` o `.github/workflows/**`. Si el autor de la solicitud de cambios (`github.event.pull_request.user.login`) no es `octobot` o `dependabot[bot]`, entonces el flujo de trabajo utilizará el {% data variables.product.prodname_cli %} para etiquetar y comentar en la solicitud de cambios (`github.event.pull_request.number`).
|
||||
|
||||
```yaml
|
||||
on:
|
||||
pull_request:
|
||||
types:
|
||||
- opened
|
||||
paths:
|
||||
- '.github/workflows/**'
|
||||
- '.github/CODEOWNERS'
|
||||
- 'package*.json'
|
||||
|
||||
jobs:
|
||||
triage:
|
||||
if: >-
|
||||
github.event.pull_request.user.login != 'octobot' &&
|
||||
github.event.pull_request.user.login != 'dependabot[bot]'
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: "Comment about changes we can't accept"
|
||||
env:
|
||||
GITHUB_TOKEN: {% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %}
|
||||
PR: {% raw %}${{ github.event.pull_request.html_url }}{% endraw %}
|
||||
run: |
|
||||
gh pr edit $PR --add-label 'invalid'
|
||||
gh pr comment $PR --body 'It looks like you edited `package*.json`, `.github/CODEOWNERS`, or `.github/workflows/**`. No permitimos contribuciones a estos archivos. Por favor, revisa nuestros [lineamientos de contribución](https://github.com/octo-org/octo-repo/blob/main/CONTRIBUTING.md) para ver qué tipo de contribuciones se aceptan.'
|
||||
```
|
||||
|
||||
Para obtener más información sobre los contextos, consulta la sección "[Contextos](/actions/learn-github-actions/contexts)". Para obtener más información sobre las cargas útiles de los eventos, consulta la sección "[Eventos y cargas útiles de los webhooks](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads)".
|
||||
|
||||
## Controlar aún más la forma en la que se ejecutará tu flujo de trabajo
|
||||
|
||||
Si quieres un control más granular que el que proporcionan los eventos, tipos de actividad de eventos o filtros de evento, puedes utilizar condicionales{% ifversion fpt or ghae or ghes > 3.1 or ghec %} y ambientes{% endif %} para controlar si se ejecutarán los jobs o pasos individuales en tu flujo de trabajo.
|
||||
|
||||
### Utilziar condicionales
|
||||
|
||||
Puedes utilizar condicionales para controlar aún más si se ejecutarán los jobs o pasos de tu flujo de trabajo. Por ejemplo, si quieres que el flujo de trabajo se ejecute cuando se agrega una etiqueta específica a una propuesta, puedes activar el tipo de actividad de evento `issues labeled` y utilizar una condicional para verificar qué etiqueta activó el flujo de trabajo. El siguiente flujo de trabajo se ejecutará cuando se agregue cualquier etiqueta a una propuesta en su repositorio, pero el job `run_if_label_matches` solo se ejecutará si la etiqueta se nombra `bug`.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
issues:
|
||||
types:
|
||||
- labeled
|
||||
|
||||
jobs:
|
||||
run_if_label_matches:
|
||||
if: github.event.label.name == 'bug'
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- run: echo 'The label was bug'
|
||||
```
|
||||
|
||||
Para obtener más información, consulta la sección "[Expresiones](/actions/learn-github-actions/expressions)".
|
||||
|
||||
{% ifversion fpt or ghae or ghes > 3.1 or ghec %}
|
||||
|
||||
### Utilizar ambientes para activar jobs de flujos de trabajo manualmente
|
||||
|
||||
Si quieres activar manualmente un job específico en un flujo de trabajo, puedes utilizar un ambiente que requiera aprobación de un equipo o usuario específico. Primero, configura un ambiente con revisores requeridos. Para obtener más información, consulta la sección "[Utilizar ambientes para despliegue](/actions/deployment/targeting-different-environments/using-environments-for-deployment)". Luego, referencia el nombre del ambiente en un job de tu flujo de trabajo utilizando la clave `environment:`. No se ejecutará ningún job que referencie el ambiente hasta que por lo menos un revisor lo apruebe.
|
||||
|
||||
Por ejemplo, el siguiente fluljo de trabajo se ejecutará siempre que haya una subida a la rama principal (main). El job `build` siempre se ejecutará. El job `publish` solo se ejecutará después de que el job `build` se complete con éxito (debido a `needs: [build]`) y después de que pasen todas las reglas (incluyendo a los revisores requeridos) para el ambiente llamado `production` (debido a `environment: production`).
|
||||
|
||||
```yaml
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: build
|
||||
echo 'building'
|
||||
|
||||
publish:
|
||||
needs: [build]
|
||||
runs-on: ubuntu-latest
|
||||
environment: production
|
||||
steps:
|
||||
- name: publish
|
||||
echo 'publishing'
|
||||
```
|
||||
|
||||
{% note %}
|
||||
|
||||
{% data reusables.gated-features.environments %}
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
|
||||
## Eventos disponibles
|
||||
|
||||
For a full list of available events, see "[Events that trigger workflows](/actions/using-workflows/events-that-trigger-workflows)."
|
||||
|
||||
@@ -149,7 +149,7 @@ jobs:
|
||||
|
||||
steps:
|
||||
- name: Pass the received secret to an action
|
||||
uses: ./.github/actions/my-action@v1
|
||||
uses: ./.github/actions/my-action
|
||||
with:
|
||||
token: ${{ secrets.access-token }}
|
||||
```
|
||||
@@ -171,42 +171,7 @@ A boolean specifying whether the secret must be supplied.
|
||||
|
||||
## `on.workflow_dispatch.inputs`
|
||||
|
||||
When using the `workflow_dispatch` event, you can optionally specify inputs that are passed to the workflow.
|
||||
|
||||
The triggered workflow receives the inputs in the `github.event.inputs` context. For more information, see "[Contexts](/actions/learn-github-actions/contexts#github-context)."
|
||||
|
||||
### Example
|
||||
```yaml
|
||||
on:
|
||||
workflow_dispatch:
|
||||
inputs:
|
||||
logLevel:
|
||||
description: 'Log level'
|
||||
required: true
|
||||
default: 'warning' {% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5511 %}
|
||||
type: choice
|
||||
options:
|
||||
- info
|
||||
- warning
|
||||
- debug {% endif %}
|
||||
tags:
|
||||
description: 'Test scenario tags'
|
||||
required: false {% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5511 %}
|
||||
type: boolean
|
||||
environment:
|
||||
description: 'Environment to run tests against'
|
||||
type: environment
|
||||
required: true {% endif %}
|
||||
|
||||
jobs:
|
||||
print-tag:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Print the input tag to STDOUT
|
||||
run: echo {% raw %} The tag is ${{ github.event.inputs.tag }} {% endraw %}
|
||||
```
|
||||
|
||||
{% data reusables.github-actions.workflow-dispatch-inputs %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
## `permissions`
|
||||
|
||||
@@ -47,7 +47,7 @@ Por defecto, el redireccionamiento `collectd` está inhabilitado en {% data vari
|
||||
|
||||
## Exportar los datos collectd con `ghe-export-graphs`
|
||||
|
||||
La herramienta de la línea de comando `ghe-export-graphs` exportará los datos que `collectd` almacene en las bases de datos RRD. Este comando convierte los datos a XML y los exporta a un tarball único (.tgz).
|
||||
La herramienta de la línea de comando `ghe-export-graphs` exportará los datos que `collectd` almacene en las bases de datos RRD. This command turns the data into XML and exports it into a single tarball (`.tgz`).
|
||||
|
||||
Su uso principal es proporcionarle al equipo de {% data variables.contact.contact_ent_support %} los datos sobre el desempeño de una VM, sin la necesidad de descargar un paquete de soporte completo. No se debe incluir en tus exportaciones de copias de seguridad regulares y no existe una contraparte de importación. Si te contactas con {% data variables.contact.contact_ent_support %}, puede que te solicitemos estos datos para ayudarte a solucionar los problemas.
|
||||
|
||||
|
||||
@@ -40,12 +40,12 @@ Antes de iniciar {% data variables.product.product_location %} en Azure, deberá
|
||||
|
||||
{% data reusables.enterprise_installation.create-ghe-instance %}
|
||||
|
||||
1. Encuentra la imagen de aparato más reciente {% data variables.product.prodname_ghe_server %}. Para obtener más información sobre el comando `vm image list`, consulta "[lista de imagen vm de az](https://docs.microsoft.com/cli/azure/vm/image?view=azure-cli-latest#az_vm_image_list)" en la documentación de Microsoft.
|
||||
1. Encuentra la imagen de aparato más reciente {% data variables.product.prodname_ghe_server %}. For more information about the `vm image list` command, see "[`az vm image list`](https://docs.microsoft.com/cli/azure/vm/image?view=azure-cli-latest#az_vm_image_list)" in the Microsoft documentation.
|
||||
```shell
|
||||
$ az vm image list --all -f GitHub-Enterprise | grep '"urn":' | sort -V
|
||||
```
|
||||
|
||||
2. Crea una nueva VM utilizando la imagen de aparato que encontraste. Para obtener más información, consulta "[crear vm de az](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_create)" en la documentación de Microsoft.
|
||||
2. Crea una nueva VM utilizando la imagen de aparato que encontraste. For more information, see "[`az vm create`](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_create)" in the Microsoft documentation.
|
||||
|
||||
Aprueba opciones para el nombre de tu VM, el grupo de recurso, el tamaño de tu VM, el nombre de tu región Azure preferida, el nombre de la imagen de tu aparato VM que enumeraste en el paso anterior y el almacenamiento SKU para un almacenamiento prémium. Para obtener más información sobre grupos de recursos, consulta "[Grupos de recursos](https://docs.microsoft.com/azure/azure-resource-manager/resource-group-overview#resource-groups)" en la documentación de Microsoft.
|
||||
|
||||
@@ -53,7 +53,7 @@ Antes de iniciar {% data variables.product.product_location %} en Azure, deberá
|
||||
$ az vm create -n <em>VM_NAME</em> -g <em>RESOURCE_GROUP</em> --size <em>VM_SIZE</em> -l <em>REGION</em> --image <em>APPLIANCE_IMAGE_NAME</em> --storage-sku Premium_LRS
|
||||
```
|
||||
|
||||
3. Configura los parámetros de seguridad en tu VM para abrir los puertos requeridos. Para obtener más información, consulta "[abrir puerto de vm de az](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_open_port)" en la documentación de Microsoft. Consulta la tabla de abajo para obtener una descripción de cada puerto para determinar qué puertos debes abrir.
|
||||
3. Configura los parámetros de seguridad en tu VM para abrir los puertos requeridos. For more information, see "[`az vm open-port`](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_open_port)" in the Microsoft documentation. Consulta la tabla de abajo para obtener una descripción de cada puerto para determinar qué puertos debes abrir.
|
||||
|
||||
```shell
|
||||
$ az vm open-port -n <em>VM_NAME</em> -g <em>RESOURCE_GROUP</em> --port <em>PORT_NUMBER</em>
|
||||
@@ -63,7 +63,7 @@ Antes de iniciar {% data variables.product.product_location %} en Azure, deberá
|
||||
|
||||
{% data reusables.enterprise_installation.necessary_ports %}
|
||||
|
||||
4. Crea y adjunta un disco de datos administrados nuevo a la MV y configura el tamaño con base en la cantidad de licencias que tengas. Todos los discos administrados de Azure que se crearon desde el 10 de junio de 2017 están cifrados en reposo predeterminadamente con el Cifrado de Servicio de Almacenamiento (SSE). Para obtener más información sobre el comando `az vm disk attach`, consulta la sección "[az vm disk attach](https://docs.microsoft.com/cli/azure/vm/disk?view=azure-cli-latest#az_vm_disk_attach)" en la documentación de Microsoft.
|
||||
4. Crea y adjunta a la VM un nuevo disco de datos descifrado y configura su tamaño con base en la cantidad de licencias que tengas. For more information, see "[`az vm disk attach`](https://docs.microsoft.com/cli/azure/vm/disk?view=azure-cli-latest#az_vm_disk_attach)" in the Microsoft documentation.
|
||||
|
||||
Aprueba opciones para el nombre de tu VM (por ejemplo, `ghe-acme-corp`), el grupo de recurso, el almacenamiento prémium de SKU, el tamaño del disco (por ejemplo, `100`) y un nombre para el VHD resultante.
|
||||
|
||||
@@ -79,7 +79,7 @@ Antes de iniciar {% data variables.product.product_location %} en Azure, deberá
|
||||
|
||||
## Configurara la máquina virtual {% data variables.product.prodname_ghe_server %}
|
||||
|
||||
1. Antes de configurar el VM, debes esperar que pase al estado ReadyRole. Controla el estado del VM con el comando `vm list`. Para obtener más información, consulta "[lista de vm de az](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_list)" en la documentación de Microsoft.
|
||||
1. Antes de configurar el VM, debes esperar que pase al estado ReadyRole. Controla el estado del VM con el comando `vm list`. For more information, see "[`az vm list`](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_list)" in the Microsoft documentation.
|
||||
```shell
|
||||
$ az vm list -d -g <em>RESOURCE_GROUP</em> -o table
|
||||
> Name ResourceGroup PowerState PublicIps Fqdns Location Zones
|
||||
|
||||
@@ -33,7 +33,7 @@ Si eso funcionó, ¡fantástico! De lo contrario, puede que debas [seguir nuestr
|
||||
|
||||
Si puedes ingresar a `git@ssh.{% data variables.command_line.backticks %}` por SSH a través del puerto 443, podrás reemplazar los parámetros SSH para forzar que cualquier conexión a {% data variables.product.product_location %} se ejecute a través de ese servidor y puerto.
|
||||
|
||||
Para establecer esto en tus parámetros ssh, edita el archivo en `~/.ssh/config` y agrega esta sección:
|
||||
To set this in your SSH confifguration file, edit the file at `~/.ssh/config`, and add this section:
|
||||
|
||||
```
|
||||
Host {% data variables.command_line.codeblock %}
|
||||
|
||||
@@ -50,7 +50,7 @@ Estos ejemplos asumen que el código fuente se verificó en el directorio de tra
|
||||
|
||||
Estos ejemplos también asumen que el {% data variables.product.prodname_codeql_cli %} se coloca en la RUTA correcta.
|
||||
|
||||
En estos ejemplos, un token de{% data variables.product.prodname_dotcom %} con alcance suficiente se almacena en la variable de ambiente `$TOKEN` y se pasa por los comandos de ejemplo a través de stdin o se almacena en la variable de ambiente `$GITHUB_TOKEN`.
|
||||
In these examples, a {% data variables.product.prodname_dotcom %} token with suitable scopes is stored in the `$TOKEN` environment variable and passed to the example commands via `stdin`, or is stored in the `$GITHUB_TOKEN` environment variable.
|
||||
|
||||
El nombre de ref y el SHA de confirmación que se verifican y analizan en estos ejemplos se conocen durante el flujo de trabajo. En el caso de las ramas, utiliza `refs/heads/BRANCH-NAME` como el ref. En el caso de la confirmación de encabezado de una solicitud de cambios, utiliza `refs/pulls/NUMBER/head`. En el caso de una confirmación de fusión generada por {% data variables.product.prodname_dotcom %} para una solicitud de cambios, utiliza `refs/pulls/NUMBER/merge`. Todos los siguientes ejemplos utilizan `refs/heads/main`. Si utilizas un nombre de rama diferente, debes modificar el código de muestra.
|
||||
|
||||
|
||||
@@ -51,4 +51,4 @@ If you are using private repositories, you will have to grant Dependabot access
|
||||
|
||||
If you are using private registries, you will have to add your existing Dependabot Preview secrets to your repository's or organization's "Dependabot secrets". For more information, see "[Managing encrypted secrets for Dependabot](/code-security/supply-chain-security/managing-encrypted-secrets-for-dependabot)".
|
||||
|
||||
If you have any questions or need help migrating, you can view or open issues in the [dependabot/dependabot-core](https://github.com/dependabot/dependabot-core/issues/new?assignees=%40dependabot%2Fpreview-migration-reviewers&labels=E%3A+preview-migration&template=migration-issue.md&title=) repository.
|
||||
If you have any questions or need help migrating, you can view or open issues in the [`dependabot/dependabot-core`](https://github.com/dependabot/dependabot-core/issues/new?assignees=%40dependabot%2Fpreview-migration-reviewers&labels=E%3A+preview-migration&template=migration-issue.md&title=) repository.
|
||||
|
||||
@@ -19,7 +19,7 @@ Para aprender más sobre los precios de los {% data variables.product.prodname_c
|
||||
|
||||
{% data reusables.codespaces.codespaces-billing %}
|
||||
|
||||
- Como propietario o gerente de facturación de una organización, puedes administrar la facturación de {% data variables.product.prodname_codespaces %} para tu organización: ["Acerca de la facturación para Codespaces"](/billing/managing-billing-for-github-codespaces/about-billing-for-codespaces)
|
||||
- As an organization owner or a billing manager you can manage {% data variables.product.prodname_codespaces %} billing for your organization: ["About billing for Codespaces"](/billing/managing-billing-for-github-codespaces/about-billing-for-codespaces)
|
||||
|
||||
- Hay una guía para los usuarios que explica cómo funciona la facturación: ["Entender la facturación para los Codespaces"](/codespaces/codespaces-reference/understanding-billing-for-codespaces)
|
||||
|
||||
|
||||
@@ -33,7 +33,7 @@ This guide shows you how to set up your Java project in {% data variables.produc
|
||||
|
||||
If you don’t see this option, {% data variables.product.prodname_codespaces %} isn't available for your project. See [Access to {% data variables.product.prodname_codespaces %}](/codespaces/developing-in-codespaces/creating-a-codespace#access-to-codespaces) for more information.
|
||||
|
||||
When you create a codespace, your project is created on a remote VM that is dedicated to you. By default, the container for your codespace has many languages and runtimes including Java, nvm, npm, and yarn. It also includes a common set of tools like git, wget, rsync, openssh, and nano.
|
||||
When you create a codespace, your project is created on a remote VM that is dedicated to you. By default, the container for your codespace has many languages and runtimes including Java, nvm, npm, and Yarn. It also includes a common set of tools like git, wget, rsync, openssh, and nano.
|
||||
|
||||
You can customize your codespace by adjusting the amount of vCPUs and RAM, [adding dotfiles to personalize your environment](/codespaces/setting-up-your-codespace/personalizing-codespaces-for-your-account), or by modifying the tools and scripts installed.
|
||||
|
||||
|
||||
@@ -26,7 +26,7 @@ El nombre del codespace también se incluye en muchos otros archivos de bitácor
|
||||
|
||||
### ID de los codespaces
|
||||
|
||||
Cada codespace también tiene un ID (identificador). Este no se muestra predeterminadamente en {% data variables.product.prodname_vscode %}, así que podrías tener que actualizar los ajustes para la extensión de {% data variables.product.prodname_github_codespaces %} antes de que puedas acceder a la ID.
|
||||
Every codespace also has an ID (identifier). Este no se muestra predeterminadamente en {% data variables.product.prodname_vscode %}, así que podrías tener que actualizar los ajustes para la extensión de {% data variables.product.prodname_github_codespaces %} antes de que puedas acceder a la ID.
|
||||
|
||||
1. En {% data variables.product.prodname_vscode %}, ya sea la versión de buscador o de escritorio, en la barra de actividad a la izquierda, haz clic en **Explorador remoto** para que se muestren los detalles del codespace.
|
||||
2. Si la barra lateral incluye una sección de "Rendimiento del Codespace", pasa el puntero del mouse sobre "ID del Codespace" y haz clic en el icono de portapapeles para copiar la ID.
|
||||
|
||||
@@ -449,8 +449,8 @@ Mientras que la mayoría de tu interacción con la API deberá darse utilizando
|
||||
{% ifversion fpt or ghec %}
|
||||
#### Sincronización de Equipos de la Organización
|
||||
|
||||
* [Listar los grupos de IdP de un equipo](/rest/reference/teams#list-idp-groups-for-a-team)
|
||||
* [Crear o actualizar las conexiones de un grupo de IdP](/rest/reference/teams#create-or-update-idp-group-connections)
|
||||
* [List IdP groups for a team](/rest/reference/teams#list-idp-groups-for-a-team)
|
||||
* [Create or update IdP group connections](/rest/reference/teams#create-or-update-idp-group-connections)
|
||||
* [Listar grupos de IdP para una organización](/rest/reference/teams#list-idp-groups-for-an-organization)
|
||||
{% endif %}
|
||||
|
||||
|
||||
@@ -54,7 +54,7 @@ $ git clone https://github.com/github-developer/github-app-template.git
|
||||
|
||||
## Paso 1. Inicia un canal nuevo de Smee
|
||||
|
||||
Para ayudar a que GitHub envíe webhooks a tu máquina local sin exponerla al internet, puedes utilizar una herramienta llamada Smee. Primero, dirígete a https://smee.io y da clic en **Iniciar un canal nuevo**. Si ya estás a gusto con otras herramientas que exponen tu máquina local al internet como [ngrok](https://dashboard.ngrok.com/get-started) o [localtunnel](https://localtunnel.github.io/www/), siéntete libre para utilizarlas.
|
||||
Para ayudar a que GitHub envíe webhooks a tu máquina local sin exponerla al internet, puedes utilizar una herramienta llamada Smee. Primero, dirígete a https://smee.io y da clic en **Iniciar un canal nuevo**. If you're already comfortable with other tools that expose your local machine to the internet like [`ngrok`](https://dashboard.ngrok.com/get-started) or [`localtunnel`](https://localtunnel.github.io/www/), feel free to use those.
|
||||
|
||||
|
||||
|
||||
@@ -91,7 +91,7 @@ Posteriormente, regresa a la terminal y sigue estos pasos para ejecutar el clien
|
||||
|
||||
El comando `smee --url <unique_channel>` le dice a Smee que reenvíe todos los eventos de webhook que reciba el canal de Smee al cliente de Smee que se ejecuta en tu computadora. La opción `--path /event_handler` reenvía los eventos a la ruta `/event_handler`, lo cual cubriremos en una [sección subsecuente](#step-5-review-the-github-app-template-code). La opción `--port 3000` especifica al puerto 3000, el cual es aquél que escuchará tu servidor. Si utilizas Smee, tu máquina no necesita estar abierta al internet público para recibir webhooks de GitHub. También puedes abrir la URL de Smee en tu buscador para inspeccionar las cargas útiles de los webhooks como vayan llegando.
|
||||
|
||||
Te recomendamos dejar abierta esta ventana de terminal y mantener a Smee conectado mientras completas el resto de los pasos de esta guía. Aunque _puedes_ desconectar y reconectar el cliente de Smee sin perder tu dominio único (a diferencia de con ngrok), puede que te sea más fácil dejarlo conectado y llevar a cabo otras tareas en la línea de comandos en una ventana diferente de la terminal.
|
||||
Te recomendamos dejar abierta esta ventana de terminal y mantener a Smee conectado mientras completas el resto de los pasos de esta guía. Although you _can_ disconnect and reconnect the Smee client without losing your unique domain (unlike `ngrok`), you may find it easier to leave it connected and do other command-line tasks in a different Terminal window.
|
||||
|
||||
## Paso 2. Registrar una GitHub App nueva
|
||||
|
||||
@@ -131,7 +131,7 @@ Verás un formato en el cual puedes ingresar detalles sobre tu app. Consulta la
|
||||
|
||||
Después de que creas tu app, se te llevará de regreso a la [página de configuración de la app](https://github.com/settings/apps). Tienes dos cosas más para hacer aquí:
|
||||
|
||||
* **Generar una llave privada para tu app.** Esto es necesario para autenticar tu app más adelante. Baja en la página y da clic en **Generar una llave privada**. Guarda el archivo PEM resultante (que tiene un nombre algo similar a _`app-name`_-_`date`_-private-key.pem) en un directorio en donde lo puedas volver a encontrar después.
|
||||
* **Generar una llave privada para tu app.** Esto es necesario para autenticar tu app más adelante. Baja en la página y da clic en **Generar una llave privada**. Save the resulting `PEM` file (called something like _`app-name`_-_`date`_-`private-key.pem`) in a directory where you can find it again.
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -157,7 +157,7 @@ end
|
||||
|
||||
Este código llama a la terminal "[Crear una ejecución de verificación](/rest/reference/checks#create-a-check-run)" utilizando el [método create_check-run](https://rdoc.info/gems/octokit/Octokit%2FClient%2FChecks:create_check_run).
|
||||
|
||||
Solo se requieren dos parámetros de entrada para crear una ejecución de flujo de trabajo: `name` y `head_sha`. Utilizaremos a [Rubocop](https://rubocop.readthedocs.io/en/latest/) para implementar la prueba de IC más adelante en esta guía de inicio rápido, y esto es por lo que se utiliza el nombre "Octo Rubocop" aquí, pero puedes elegir cualquier nombre que quieras para la ejecución de verificación.
|
||||
Solo se requieren dos parámetros de entrada para crear una ejecución de flujo de trabajo: `name` y `head_sha`. We will use [RuboCop](https://rubocop.readthedocs.io/en/latest/) to implement the CI test later in this quickstart, which is why the name "Octo RuboCop" is used here, but you can choose any name you'd like for the check run.
|
||||
|
||||
Ahora mismo, solo estás proporcionando los parámetros requeridos para echar a andar la funcionalidad básica, pero actualizarás la ejecución de verificación más adelante mientras recolectes más información acerca de la ejecución de verificación. Predeterminadamente, GitHub configura el `Estado` como `queued`.
|
||||
|
||||
|
||||
@@ -29,7 +29,7 @@ La página de perspectivas muestra estas métricas de rendimiento para el period
|
||||
|
||||
* **Valor de la suscripción:** La ganancia total posible (en dólares estadounidenses) de las suscripciones. Este valor representa la ganancia posible si no se cancela ningún plan o periodo de prueba gratuito para que todas las transacciones de tarjetas bancarias tengan éxito. El valor de la suscripción incluye el valor total de los planes que comeinzan con un periodo de prueba gratuito en el periodo de tiempo seleccionado, aún cuando no hay transacciones financieras en dicho periodo de tiempo. El valor de la suscripción también incluye un valor completo de los planes actualizados en el periodo de tiempo seleccionado pero no incluye la cantidad prorrateada. Para ver y descargar las transacciones individuales, consulta la sección "[transacciones de GitHub Marketplace](/marketplace/github-marketplace-transactions/)".
|
||||
* **Visitantes:** Cantidad de personas que han visto una página en tu listado de GitHub Apps. Esta cantidad incluye tanto a los visitantes que han iniciado sesión como a los que salen de sesión.
|
||||
* **Visualizaciones de página:** Cantidad de visualizaciones que han recibido las páginas en tu listado de GitHub Apps. Un solo visitante puede generar más de una visualización de página.
|
||||
* **Visualizaciones de página:** Cantidad de visualizaciones que han recibido las páginas en tu listado de GitHub Apps. A single visitor can generate more than one page view.
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ Una vez que el listado de tu app cumpla con los requisitos de {% data variables.
|
||||
|
||||
|
||||
|
||||
2. Para emitir tu listado de app completo, haz clic en **Solicitar publicación**.
|
||||
2. To submit your completed app listing, click **Request publish**.
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -59,7 +59,7 @@ Cuando un cliente compra tu app, debes enviar a dicho cliente a través del fluj
|
||||
|
||||
* Si tu app es una {% data variables.product.prodname_oauth_app %}, inicia el flujo de autorización tan pronto como {% data variables.product.product_name %} redirija al cliente a la **URL de instalación**. Sigue los pasos de la sección "[Autorizar las {% data variables.product.prodname_oauth_apps %}](/apps/building-oauth-apps/authorizing-oauth-apps/)".
|
||||
|
||||
Para cualquier tipo de app, el primer paso es redirigir al cliente a https://github.com/login/oauth/authorize.
|
||||
For either type of app, the first step is to redirect the customer to [https://github.com/login/oauth/authorize](https://github.com/login/oauth/authorize).
|
||||
|
||||
Después de que el ciente complete la autorización, tu app recibirá un token de acceso de OAuth para el cliente. Necesitas este token para el siguiente paso.
|
||||
|
||||
|
||||
@@ -50,7 +50,7 @@ Para motivar a las personas a mejorar el plan, puedes mostrar una URL de mejora
|
||||
|
||||
Puedes redirigir a los usuarios desde la IU de tu app para que mejoren su plan en GitHub a través de una URL de mejora:
|
||||
|
||||
```
|
||||
```text
|
||||
https://www.github.com/marketplace/<LISTING_NAME>/upgrade/<LISTING_PLAN_NUMBER>/<CUSTOMER_ACCOUNT_ID>
|
||||
```
|
||||
|
||||
|
||||
@@ -78,7 +78,7 @@ Consulta [nuestra guía sobre la automatización de tokens en Git][git-automatio
|
||||
|
||||
#### Configuración
|
||||
|
||||
1. [Ejecuta el procedimiento de `ssh-keygen`][generating-ssh-keys] en tu servidor, y recuerda en donde guardaste el par de llaves pública/privada de rsa.
|
||||
1. [Run the `ssh-keygen` procedure][generating-ssh-keys] on your server, and remember where you save the generated public and private rsa key pair key pair.
|
||||
2. En la esquina superior derecha de cualquier página de {% data variables.product.product_name %}, da clic en tu foto de perfil y luego da clic en **Tu perfil**. 
|
||||
3. En tu página de perfil, da clic en **Repositorios** y luego en el nombre de tu repositorio. 
|
||||
4. Desde tu repositorio, da clic en **Configuración**. 
|
||||
@@ -182,6 +182,7 @@ Esto significa que no puedes automatizar la creación de las cuentas. Pero si qu
|
||||
|
||||
[ssh-agent-forwarding]: /guides/using-ssh-agent-forwarding/
|
||||
[generating-ssh-keys]: /articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/#generating-a-new-ssh-key
|
||||
[generating-ssh-keys]: /articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/#generating-a-new-ssh-key
|
||||
[tos]: /free-pro-team@latest/github/site-policy/github-terms-of-service/
|
||||
[git-automation]: /articles/git-automation-with-oauth-tokens
|
||||
[git-automation]: /articles/git-automation-with-oauth-tokens
|
||||
|
||||
@@ -79,7 +79,7 @@ Aquí te mostramos algunos puntos en los cuales tener cuidado cuando intentes so
|
||||
|
||||
### Debes utilizar una URL con SSH para revisar el código
|
||||
|
||||
El reenvío SSH funciona únicamente con URL con SSH, no con aquellas de HTTP(s). Revisa el archivo *.git/config* en tu servidor y asegúrate de que la URL es de estilo SSH como se muestra a continuación:
|
||||
El reenvío SSH funciona únicamente con URL con SSH, no con aquellas de HTTP(s). Revisa el archivo `.git/config` en tu servidor y asegúrate de que la URL es de estilo SSH como se muestra a continuación:
|
||||
|
||||
```shell
|
||||
[remote "origin"]
|
||||
@@ -107,7 +107,7 @@ $ exit
|
||||
# Returns to your local command prompt
|
||||
```
|
||||
|
||||
En este ejemplo, el archivo *~/.ssh/config* se carga primero, luego se lee el */etc/ssh_config*. Podemos inspeccionar ese archivo para ver si está anulando nuestras opciones si ejecutamos los siguientes comandos:
|
||||
En este ejemplo, el archivo `~/.ssh/config` se carga primero, luego se lee el `/etc/ssh_config`. Podemos inspeccionar ese archivo para ver si está anulando nuestras opciones si ejecutamos los siguientes comandos:
|
||||
|
||||
```shell
|
||||
$ cat /etc/ssh_config
|
||||
@@ -117,7 +117,7 @@ $ cat /etc/ssh_config
|
||||
> ForwardAgent no
|
||||
```
|
||||
|
||||
En este ejemplo, nuestro archivo */etc/ssh_config* dice específicamente `ForwardAgent no`, lo cual es una manera de bloquear el reenvío del agente. Si borramos esta línea del archivo deberíamos poder hacer funcionar el reenvío del agente nuevamente.
|
||||
En este ejemplo, nuestro archivo `/etc/ssh_config` dice específicamente `ForwardAgent no`, lo cual es una manera de bloquear el reenvío del agente. Si borramos esta línea del archivo deberíamos poder hacer funcionar el reenvío del agente nuevamente.
|
||||
|
||||
### Tu servidor debe permitir el reenvío del agente SSH en las conexiones entrantes
|
||||
|
||||
|
||||
@@ -22,9 +22,9 @@ Crear un webhook es un proceso de dos pasos. Primero necesitas configurar la for
|
||||
|
||||
## Exponer un host local al internet
|
||||
|
||||
Para los propósitos de este tutorial, utilizaremos un servidor local para recibir imágenes de {% data variables.product.prodname_dotcom %}. Así que, primero que nada, necesitamos exponer nuestro ambiente de desarrollo local al internet. Utilizaremos ngrok para hacerlo. ngrok está disponible, gratuitamente, para los sistemas operativos principales. Para obtener más información, consulta [la página de descarga de ngrok](https://ngrok.com/download).
|
||||
Para los propósitos de este tutorial, utilizaremos un servidor local para recibir imágenes de {% data variables.product.prodname_dotcom %}. Así que, primero que nada, necesitamos exponer nuestro ambiente de desarrollo local al internet. Utilizaremos ngrok para hacerlo. ngrok está disponible, gratuitamente, para los sistemas operativos principales. For more information, see [the `ngrok` download page](https://ngrok.com/download).
|
||||
|
||||
Después de instalar ngrok, puedes exponer a tu host local si ejecutas `./ngrok http 4567` en la línea de comandos. el número de puerto en el que nuestro servidor escuchará mensajes es el 4567. Deberías ver una línea que se ve más o menos así:
|
||||
After installing `ngrok`, you can expose your localhost by running `./ngrok http 4567` on the command line. el número de puerto en el que nuestro servidor escuchará mensajes es el 4567. Deberías ver una línea que se ve más o menos así:
|
||||
|
||||
```shell
|
||||
$ Forwarding http://7e9ea9dc.ngrok.io -> 127.0.0.1:4567
|
||||
|
||||
@@ -9,5 +9,6 @@ children:
|
||||
- /managing-discussions-in-your-repository
|
||||
- /managing-categories-for-discussions-in-your-repository
|
||||
- /moderating-discussions
|
||||
- /viewing-insights-for-your-discussions
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: Viewing insights for your discussions
|
||||
intro: 'Discussions insights provide data about your discussions'' activity, views, and contributors.'
|
||||
permissions: Repository administrators and people with maintain access to a repository can view the discussions insights dashboard.
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Discussions
|
||||
shortTitle: View discussions insights
|
||||
---
|
||||
|
||||
## About the discussions insights dashboard
|
||||
|
||||
You can use discussions insights to help understand the contribution activity, page views, and growth of your repository's discussions community.
|
||||
- **Contribution activity** shows the count of total contributions to discussions, issues, and pull requests.
|
||||
- **Discussions page views** shows the total page views for discussions, segmented by logged in versus anonymous viewers.
|
||||
- **Discussions daily contributors** shows the daily count of unique users who have reacted, upvoted, marked an answer, commented, or posted in the selected time period.
|
||||
- **Discussions new contributors** shows the daily count of unique new users who have reacted, upvoted, marked an answer, commented, or posted in the selected time period.
|
||||
|
||||
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip:** To view the exact data for a time period, hover over that time period in the graph.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
## Viewing discussions insights
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.accessing-repository-graphs %}
|
||||
3. En la barra lateral izquierda, haz clic en **Community** (Comunidad). 
|
||||
1. Optionally, in the upper-right corner of the page, select the **Period** dropdown menu and click the time period for which you want to view data: **30 days**, **3 months**, or **1 year**. 
|
||||
@@ -49,7 +49,7 @@ shortTitle: Editores de texto asociados
|
||||
## Usar TextMate como editor
|
||||
|
||||
1. Instala [TextMate](https://macromates.com/).
|
||||
2. Instala la utilidad de shell `mate` de TextMate. Para obtener más información, consulta "[mate y rmate](https://macromates.com/blog/2011/mate-and-rmate/)" en la documentación de TextMate.
|
||||
2. Instala la utilidad de shell `mate` de TextMate. For more information, see "[`mate` and `rmate`](https://macromates.com/blog/2011/mate-and-rmate/)" in the TextMate documentation.
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
4. Escribe este comando:
|
||||
```shell
|
||||
|
||||
@@ -12,15 +12,15 @@ versions:
|
||||
shortTitle: Propiedades compatibles con GitHub
|
||||
---
|
||||
|
||||
## Archivos ejecutables (svn:executable)
|
||||
## Executable files (`svn:executable`)
|
||||
|
||||
Convertimos propiedades `svn:executable` al actualizar el modo archivo directamente antes de agregarlo al repositorio de Git.
|
||||
|
||||
## Tipos MIME (svn:mime-type)
|
||||
## MIME types (`svn:mime-type`)
|
||||
|
||||
{% data variables.product.product_name %} internalmente rastrea las propiedades mime-type de los archivos y las confirmaciones que los agregaron.
|
||||
|
||||
## Ignorar elementos sin versión (svn:ignore)
|
||||
## Ignoring unversioned items (`svn:ignore`)
|
||||
|
||||
Si has configurado que los archivos y los directorios se ignoren en Subversion, {% data variables.product.product_name %} los rastrearemos de manera interna. Los archivos ignorados por los clientes de Subversion son completamente distintos a las entradas en un archivo *.gitignore*.
|
||||
|
||||
|
||||
@@ -57,9 +57,9 @@ Este procedimiento es suficientemente permisivo para permitir que pasen muchos e
|
||||
Después del filtrado, quedaron 473 sugerencias. Pero estas pueden presentarse en formas diferentes:
|
||||
|
||||
1. Algunas eran básicamente solo repeticiones de otro caso que pasó el filtrado. Por ejemplo, algunas veces, el Copiloto de {% data variables.product.prodname_dotcom %} hizo una sugerencia, el desarrollador tecleó una línea de comentario y el Copiloto de {% data variables.product.prodname_dotcom %} ofreció una sugerencia muy similar nuevamente. Eliminé estos casos del análisis como duplicados.
|
||||
2. Algunas secuencias fueron largas y repetitivas. Como el siguiente ejemplo, en donde los bloques repetidos de `<p>` se encontraban, por supuesto, en algún lugar del conjunto de entrenamiento: <br><br>mTales sugerencias pueden ser útiles (casos de prueba, regexes) o inútiles (como sospecho que lo es este caso). Pero, de cualquier forma, no encajan en la idea de aprender por repetición que tenía cuando comencé esta investigación.
|
||||
2. Algunas secuencias fueron largas y repetitivas. Like the following example, where the repeated blocks of `‘<p>’` are of course found somewhere in the training set: <br><br> Such suggestions can be helpful (test cases, regular expressions) or not helpful (like this case, I suspect). Pero, de cualquier forma, no encajan en la idea de aprender por repetición que tenía cuando comencé esta investigación.
|
||||
3. Algunos fueron inventarios estándar, como los números naturales o los primos o los servicios de cotización instantánea del mercado de valores o el alfabeto griego: <br>
|
||||
4. Algunas formas eran comúnes y directas, incluso tal vez universales, de hacer las cosas con muy pocos grados de libertad. Por ejemplo, la parte media de lo siguiente me parece, por mucho, la forma estándar de utilizar el paquete de BautifulSoup para analizar una lista de wikipedia. De hecho, el fragmento de código coincidente que se encontró en los datos de entrenamiento del Copiloto de {% data variables.product.prodname_dotcom %}<sup id="anchor5">[5](#footnote5)</sup> utiliza este código para analizar un artículo diferente y sigue haciendo cosas diferentes con los resultados. <br> <br>Esto tampoco encaja en mi idea de una cita. Es un poco como cuando alguien dice " voy a sacar la basura; vuelvo pronto" -- se trata de una declaración factual, no de una cita, aún cuando la frase particular se emitió muchas veces anteriormente.
|
||||
4. Algunas formas eran comúnes y directas, incluso tal vez universales, de hacer las cosas con muy pocos grados de libertad. For example, the middle part of the following strikes me as very much the standard way of using the BeautifulSoup package to parse a Wikipedia list. De hecho, el fragmento de código coincidente que se encontró en los datos de entrenamiento del Copiloto de {% data variables.product.prodname_dotcom %}<sup id="anchor5">[5](#footnote5)</sup> utiliza este código para analizar un artículo diferente y sigue haciendo cosas diferentes con los resultados. <br> <br>Esto tampoco encaja en mi idea de una cita. Es un poco como cuando alguien dice " voy a sacar la basura; vuelvo pronto" -- se trata de una declaración factual, no de una cita, aún cuando la frase particular se emitió muchas veces anteriormente.
|
||||
5. Y luego están el resto de los casos. Aquellos que por lo menos tuvieron una superposición específica ya sea en el código o en los comentarios. Estos son los que más me interesan y en lo que me voy a concentrar de ahora en adelante.
|
||||
|
||||
Este agrupamiento en buckets tiene necesariamente algunos casos límite<sup id="anchor6">[6](#footnote6)</sup> y tu millaje puede variar dependiendo de cómo creas que deben clasificarse. Posiblemente incluso estés en desacuerdo con todo el conjunto de buckets en primera instancia.
|
||||
|
||||
@@ -50,7 +50,7 @@ To search for specific events, use the `action` qualifier in your query. Actions
|
||||
| [`enterprise`](#enterprise-category-actions) | Contains activities related to enterprise settings. | {% endif %}
|
||||
| [`hook`](#hook-category-actions) | Contains all activities related to webhooks.
|
||||
| [`integration_installation_request`](#integration_installation_request-category-actions) | Contains all activities related to organization member requests for owners to approve integrations for use in the organization. |
|
||||
| [`ip_allow_list`](#ip_allow_list) | Contains activitites related to enabling or disabling the IP allow list for an organization.
|
||||
| [`ip_allow_list`](#ip_allow_list) | Contains activities related to enabling or disabling the IP allow list for an organization.
|
||||
| [`ip_allow_list_entry`](#ip_allow_list_entry) | Contains activities related to the creation, deletion, and editing of an IP allow list entry for an organization.
|
||||
| [`issue`](#issue-category-actions) | Contains activities related to deleting an issue. {% ifversion fpt or ghec %}
|
||||
| [`marketplace_agreement_signature`](#marketplace_agreement_signature-category-actions) | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement.
|
||||
|
||||
@@ -31,24 +31,11 @@ Alternatively, you can configure SAML SSO for an enterprise using Okta. SCIM for
|
||||
|
||||
## Agregar la aplicación {% data variables.product.prodname_ghe_cloud %} en Okta
|
||||
|
||||
{% data reusables.saml.okta-sign-into-your-account %}
|
||||
1. Navigate to the [Github Enterprise Cloud - Organization](https://www.okta.com/integrations/github-enterprise-cloud-organization) application in the Okta Integration Network and click **Add Integration**.
|
||||
1. Opcionalmente, a la derecha de la "Etiqueta de aplicación", teclea un nombre descriptivo para la aplicación.
|
||||
1. En el campo **Organización de GitHub**, teclea el nombre de tu organización de {% data variables.product.product_location %}. Por ejemplo, si la URL de de tu organizaciòn es https://github.com/octo-org, el nombre de organizaciòn serìa `octo-org`.
|
||||
1. Haz clic en **Done** (listo).
|
||||
|
||||
## Habilitar y probar el SSO de SAML
|
||||
|
||||
{% data reusables.saml.okta-sign-into-your-account %}
|
||||
{% data reusables.saml.okta-dashboard-click-applications %}
|
||||
{% data reusables.saml.okta-applications-click-ghec-application-label %}
|
||||
{% data reusables.saml.assign-yourself-to-okta %}
|
||||
{% data reusables.saml.okta-sign-on-tab %}
|
||||
{% data reusables.saml.okta-view-setup-instructions %}
|
||||
1. Habilita y prueba el SSO de SAML en {% data variables.product.prodname_dotcom %} utilizando la URL de registro, URL del emisor, y certificados pùblicos de la guìa "Còmo configurar SAML 2.0". Para obtener más información, consulta "[Habilitar y probar el inicio de sesión único para tu organización](/organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization#enabling-and-testing-saml-single-sign-on-for-your-organization)".
|
||||
|
||||
## Configurar el aprovisionamiento de acceso con SCIM en Okta
|
||||
|
||||
{% data reusables.saml.okta-dashboard-click-applications %}
|
||||
{% data reusables.saml.okta-applications-click-ghec-application-label %}
|
||||
{% data reusables.saml.okta-provisioning-tab %}
|
||||
|
||||
@@ -191,7 +191,7 @@ You can restore a deleted package or version if:
|
||||
- You restore the package within 30 days of its deletion.
|
||||
- The same package namespace and version is still available and not reused for a new package.
|
||||
|
||||
For example, if you have a deleted rubygem package named `octo-package` that was scoped to the repo `octo-repo-owner/octo-repo`, then you can only restore the package if the package namespace `rubygem.pkg.github.com/octo-repo-owner/octo-repo/octo-package` is still available, and 30 days have not yet passed.
|
||||
For example, if you have a deleted RubyGems package named `octo-package` that was scoped to the repo `octo-repo-owner/octo-repo`, then you can only restore the package if the package namespace `rubygem.pkg.github.com/octo-repo-owner/octo-repo/octo-package` is still available, and 30 days have not yet passed.
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
To restore a deleted package, you must also meet one of these permission requirements:
|
||||
|
||||
@@ -23,7 +23,7 @@ shortTitle: RubyGems registry
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- You must have rubygems 2.4.1 or higher. To find your rubygems version:
|
||||
- You must have RubyGems 2.4.1 or higher. To find your RubyGems version:
|
||||
|
||||
```shell
|
||||
$ gem --version
|
||||
@@ -86,7 +86,7 @@ If you don't have a *~/.gemrc* file, create a new *~/.gemrc* file using this exa
|
||||
|
||||
```
|
||||
|
||||
To authenticate with Bundler, configure Bundler to use your personal access token, replacing *USERNAME* with your {% data variables.product.prodname_dotcom %} username, *TOKEN* with your personal access token, and *OWNER* with the name of the user or organization account that owns the repository containing your project.{% ifversion ghes %} Replace `REGISTRY-URL` with the URL for your instance's Rubygems registry. If your instance has subdomain isolation enabled, use `rubygems.HOSTNAME`. If your instance has subdomain isolation disabled, use `HOSTNAME/_registry/rubygems`. In either case, replace *HOSTNAME* with the hostname of your {% data variables.product.prodname_ghe_server %} instance.{% elsif ghae %}Replace `REGISTRY-URL` with the URL for your instance's Rubygems registry, `rubygems.HOSTNAME`. Replace *HOSTNAME* with the hostname of {% data variables.product.product_location %}.{% endif %}
|
||||
To authenticate with Bundler, configure Bundler to use your personal access token, replacing *USERNAME* with your {% data variables.product.prodname_dotcom %} username, *TOKEN* with your personal access token, and *OWNER* with the name of the user or organization account that owns the repository containing your project.{% ifversion ghes %} Replace `REGISTRY-URL` with the URL for your instance's RubyGems registry. If your instance has subdomain isolation enabled, use `rubygems.HOSTNAME`. If your instance has subdomain isolation disabled, use `HOSTNAME/_registry/rubygems`. In either case, replace *HOSTNAME* with the hostname of your {% data variables.product.prodname_ghe_server %} instance.{% elsif ghae %}Replace `REGISTRY-URL` with the URL for your instance's Rubygems registry, `rubygems.HOSTNAME`. Replace *HOSTNAME* with the hostname of {% data variables.product.product_location %}.{% endif %}
|
||||
|
||||
```shell
|
||||
$ bundle config https://{% ifversion fpt or ghec %}rubygems.pkg.github.com{% else %}REGISTRY-URL{% endif %}/<em>OWNER USERNAME:TOKEN</em>
|
||||
|
||||
@@ -116,7 +116,7 @@ Para mostrar tu archivo 3D en algún otro lugar de Internet, modifica esta plant
|
||||
<script src="https://embed.github.com/view/3d/<username>/<repo>/<ref>/<path_to_file>"></script>
|
||||
```
|
||||
|
||||
Por ejemplo, si la URL de tu modelo es [github.com/skalnik/secret-bear-clip/blob/master/stl/clip.stl](https://github.com/skalnik/secret-bear-clip/blob/master/stl/clip.stl), tu código para insertar sería:
|
||||
For example, if your model's URL is [`github.com/skalnik/secret-bear-clip/blob/master/stl/clip.stl`](https://github.com/skalnik/secret-bear-clip/blob/master/stl/clip.stl), your embed code would be:
|
||||
|
||||
```html
|
||||
<script src="https://embed.github.com/view/3d/skalnik/secret-bear-clip/master/stl/clip.stl"></script>
|
||||
|
||||
@@ -390,7 +390,7 @@ $ {% data variables.product.api_url_pre %}/users/defunkt
|
||||
|
||||
El estado `304` indica que el recurso no ha cambiado desde la última vez que lo solicitamos y que la respuesta no contendrá ningún cuerpo. As a bonus, `304` responses don't count against your [rate limit][rate-limiting].
|
||||
|
||||
¡Qué! ¡Ahora conoces lo básico de la API de {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %}!
|
||||
¡Ahora conoces lo básico de la API de {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %}!
|
||||
|
||||
* Autenticación básica & de OAuth
|
||||
* Obtener y crear repositorios e informes de problemas
|
||||
|
||||
@@ -25,4 +25,4 @@ children:
|
||||
- /getting-started-with-the-checks-api
|
||||
---
|
||||
|
||||
Se pretende que esta sección de la documentación te inicie con las aplicaciones reales de la API de {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %}. Abordaremos todo lo que necesitas saber, desde la autenticación, hasta manipular los resultados, e incluso hasta combiar los resultados con otras apps. Cada tutorial en esta sección tendrá un proyecto, y cada proyecto se almacenará y documentará en nuestro repositorio público de [platform-samples](https://github.com/github/platform-samples). 
|
||||
Se pretende que esta sección de la documentación te inicie con las aplicaciones reales de la API de {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %}. Abordaremos todo lo que necesitas saber, desde la autenticación, hasta manipular los resultados, e incluso hasta combiar los resultados con otras apps. Cada tutorial en esta sección tendrá un proyecto, y cada proyecto se almacenará y documentará en nuestro repositorio público de [platform-samples](https://github.com/github/platform-samples). 
|
||||
|
||||
@@ -47,19 +47,19 @@ El calificador `sort:reactions` clasifica por la cantidad o el tipo de reaccione
|
||||
|
||||
El calificador `sort:author-date` clasifica por fecha de autor descendente o ascendente.
|
||||
|
||||
| Qualifier | Ejemplo |
|
||||
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `sort:author-date` or `sort:author-date-desc` | [**feature org:github sort:author-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date&type=Commits) encuentra confirmaciones que contienen la palabra "feature" en repositorios propiedad de {% data variables.product.product_name %}, clasificadas por fecha de autor descendente. |
|
||||
| `sort:author-date-asc` | [**feature org:github sort:author-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date-asc&type=Commits) encuentra confirmaciones que contienen la palabra "feature" en repositorios propiedad de {% data variables.product.product_name %}, clasificadas por fecha de autor ascendente. |
|
||||
| Qualifier | Ejemplo |
|
||||
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `sort:author-date` or `sort:author-date-desc` | [**feature org:github sort:author-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date&type=Commits) encuentra confirmaciones que contienen la palabra "feature" en repositorios propiedad de {% data variables.product.product_name %}, clasificadas por fecha de autor descendente. |
|
||||
| `sort:author-date-asc` | [**`feature org:github sort:author-date-asc`**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Aauthor-date-asc&type=Commits) matches commits containing the word "feature" in repositories owned by {% data variables.product.product_name %}, sorted by ascending author date. |
|
||||
|
||||
## Clasificar por fecha de persona que confirma el cambio
|
||||
|
||||
El calificador `sort:committer-date` clasifica por fecha de persona que confirma el cambio descendente o ascendente.
|
||||
|
||||
| Qualifier | Ejemplo |
|
||||
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `sort:committer-date` or `sort:committer-date-desc` | [**feature org:github sort:committer-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date&type=Commits) encuentra confirmaciones que contienen la palabra "feature" en repositorios propiedad de {% data variables.product.product_name %}, clasificadas por fecha de la persona que confirma el cambio descendente. |
|
||||
| `sort:committer-date-asc` | [**feature org:github sort:committer-date-asc**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date-asc&type=Commits) encuentra confirmaciones que contienen la palabra "feature" en repositorios propiedad de {% data variables.product.product_name %}, clasificadas por fecha ascendente de la persona que confirma el cambio. |
|
||||
| Qualifier | Ejemplo |
|
||||
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `sort:committer-date` or `sort:committer-date-desc` | [**feature org:github sort:committer-date**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date&type=Commits) encuentra confirmaciones que contienen la palabra "feature" en repositorios propiedad de {% data variables.product.product_name %}, clasificadas por fecha de la persona que confirma el cambio descendente. |
|
||||
| `sort:committer-date-asc` | [**`feature org:github sort:committer-date-asc`**](https://github.com/search?utf8=%E2%9C%93&q=feature+org%3Agithub+sort%3Acommitter-date-asc&type=Commits) matches commits containing the word "feature" in repositories owned by {% data variables.product.product_name %}, sorted by ascending committer date. |
|
||||
|
||||
## Clasificar por fecha de actualización
|
||||
|
||||
|
||||
@@ -73,9 +73,10 @@ Puedes excluir resultados que contengan una determinada palabra utilizando la si
|
||||
|
||||
Otra manera de reducir los resultados de búsqueda es excluir determinados subconjuntos. Puedes usar como prefijo de cualquier calificador de búsqueda un `-` para excluir todos los resultados que coincidan con ese calificador.
|
||||
|
||||
| Consulta | Ejemplo |
|
||||
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| <code>-<em>CALIFICADOR</em></code> | **[menciones:defunkt -org:github](https://github.com/search?utf8=%E2%9C%93&q=mentions%3Adefunkt+-org%3Agithub&type=Issues)** busca propuestas que mencionan a @defunkt y no estén en repositorios de la organización de GitHub. |
|
||||
| Consulta | Ejemplo |
|
||||
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| <code>-<em>CALIFICADOR</em></code> | **[`cats stars:>10 -language:javascript`](https://github.com/search?q=cats+stars%3A>10+-language%3Ajavascript&type=Repositories)** matches repositories with the word "cats" that have more than 10 stars but are not written in JavaScript. |
|
||||
| | **[`mentions:defunkt -org:github`](https://github.com/search?utf8=%E2%9C%93&q=mentions%3Adefunkt+-org%3Agithub&type=Issues)** matches issues mentioning @defunkt that are not in repositories in the GitHub organization |
|
||||
|
||||
## Utiliza comillas para las consultas con espacios en blanco
|
||||
|
||||
|
||||
@@ -65,7 +65,7 @@ You can use the `path` qualifier to search for source code that appears at a spe
|
||||
| ------------- | -------------
|
||||
| <code>path:/</code> | [**octocat filename:readme path:/**](https://github.com/search?utf8=%E2%9C%93&q=octocat+filename%3Areadme+path%3A%2F&type=Code) matches _readme_ files with the word "octocat" that are located at the root level of a repository.
|
||||
| <code>path:<em>DIRECTORY</em></code> | [**form path:cgi-bin language:perl**](https://github.com/search?q=form+path%3Acgi-bin+language%3Aperl&type=Code) matches Perl files with the word "form" in the <em>cgi-bin</em> directory, or in any of its subdirectories.
|
||||
| <code>path:<em>PATH/TO/DIRECTORY</em></code> | [**console path:app/public language:javascript**](https://github.com/search?q=console+path%3A%22app%2Fpublic%22+language%3Ajavascript&type=Code) matches JavaScript files with the word "console" in the <em>app/public</em> directory, or in any of its subdirectories (even if they reside in <em>app/public/js/form-validators</em>).
|
||||
| <code>path:<em>PATH/TO/DIRECTORY</em></code> | [**`console path:app/public language:javascript`**](https://github.com/search?q=console+path%3A%22app%2Fpublic%22+language%3Ajavascript&type=Code) matches JavaScript files with the word "console" in the <em>app/public</em> directory, or in any of its subdirectories (even if they reside in <em>app/public/js/form-validators</em>).
|
||||
|
||||
## Search by language
|
||||
<!-- If you make changes to this feature, update /getting-started-with-github/github-language-support to reflect any changes. -->
|
||||
|
||||
@@ -31,10 +31,10 @@ Solo puedes buscar paquetes en {% data variables.product.product_name %}, no en
|
||||
|
||||
Para encontrar paquetes que sean propiedad de cierto usuario u organización, utiliza el calificador `user` u `org`.
|
||||
|
||||
| Qualifier | Ejemplo |
|
||||
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| <code>user:<em>USERNAME</em></code> | [**user:codertocat**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) coincidirá con paquetes que sean propiedad de @codertocat |
|
||||
| <code>org:<em>ORGNAME</em></code> | [**org:github**](https://github.com/search?q=org%3Agithub&type=RegistryPackages) coincidirá con paquetes que sean propiedad de la organización {% data variables.product.prodname_dotcom %}
|
||||
| Qualifier | Ejemplo |
|
||||
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| <code>user:<em>USERNAME</em></code> | [**`user:codertocat`**](https://github.com/search?q=user%3Acodertocat&type=RegistryPackages) matches packages owned by @codertocat |
|
||||
| <code>org:<em>ORGNAME</em></code> | [**`org:github`**](https://github.com/search?q=org%3Agithub&type=RegistryPackages) matches packages owned by the {% data variables.product.prodname_dotcom %} organization |
|
||||
|
||||
## Filtrar por visibilidad del paquete
|
||||
|
||||
|
||||
@@ -111,17 +111,17 @@ Ambos toman una fecha como su parámetro. {% data reusables.time_date.date_forma
|
||||
|
||||
Puedes buscar repositorios con base en el lenguaje de programación del código que contienen.
|
||||
|
||||
| Qualifier | Ejemplo |
|
||||
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| <code>language:<em>LANGUAGE</em></code> | [**rails language:javascript**](https://github.com/search?q=rails+language%3Ajavascript&type=Repositories) encuentra repositorios con la palabra "rails" que están escritos en JavaScript. |
|
||||
| Qualifier | Ejemplo |
|
||||
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| <code>language:<em>LANGUAGE</em></code> | [**`rails language:javascript`**](https://github.com/search?q=rails+language%3Ajavascript&type=Repositories) matches repositories with the word "rails" that are written in JavaScript. |
|
||||
|
||||
## Buscar por tema
|
||||
|
||||
Puedes encontrar todos los repositorios que se clasifiquen con un tema particular. Para obtener más información, consulta "[Clasificar tu repositorio con temas](/github/administering-a-repository/classifying-your-repository-with-topics)".
|
||||
|
||||
| Qualifier | Ejemplo |
|
||||
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| <code>topic:<em>TOPIC</em></code> | [**topic:jekyll**](https://github.com/search?utf8=%E2%9C%93&q=topic%3Ajekyll&type=Repositories&ref=searchresults) encuentra repositorios que se han clasificado con el tema "jekyll." |
|
||||
| Qualifier | Ejemplo |
|
||||
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| <code>topic:<em>TOPIC</em></code> | [**`topic:jekyll`**](https://github.com/search?utf8=%E2%9C%93&q=topic%3Ajekyll&type=Repositories&ref=searchresults) matches repositories that have been classified with the topic "Jekyll." |
|
||||
|
||||
## Buscar por cantidad de temas
|
||||
|
||||
@@ -178,10 +178,10 @@ Puedes buscar los repositorios con base en si se archivaron o no. Para obtener m
|
||||
|
||||
Puedes buscar repositorios que tienen una cantidad mínima de propuestas etiquetadas como `help-wanted` (se necesita ayuda) o `good-first-issue` (buena propuesta inicial) con los calificadores `help-wanted-issues:>n` y `good-first-issues:>n`. Para encontrar más información, consulta "[Fomentar las contribuciones útiles a tu proyecto con etiquetas](/communities/setting-up-your-project-for-healthy-contributions/encouraging-helpful-contributions-to-your-project-with-labels)."
|
||||
|
||||
| Qualifier | Ejemplo |
|
||||
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| `good-first-issues:>n` | [**good-first-issues:>2 javascript**](https://github.com/search?utf8=%E2%9C%93&q=javascript+good-first-issues%3A%3E2&type=) encuentra repositorios con más de dos propuestas etiquetadas como `good-first-issue` y que contienen la palabra "javascript." |
|
||||
| `help-wanted-issues:>n` | [**help-wanted-issues:>4 react**](https://github.com/search?utf8=%E2%9C%93&q=react+help-wanted-issues%3A%3E4&type=) encuentra repositorios con más de cuatro propuestas etiquetadas como `help-wanted` y que contienen la palabra "React." |
|
||||
| Qualifier | Ejemplo |
|
||||
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| `good-first-issues:>n` | [**`good-first-issues:>2 javascript`**](https://github.com/search?utf8=%E2%9C%93&q=javascript+good-first-issues%3A%3E2&type=) matches repositories with more than two issues labeled `good-first-issue` and that contain the word "javascript." |
|
||||
| `help-wanted-issues:>n` | [**help-wanted-issues:>4 react**](https://github.com/search?utf8=%E2%9C%93&q=react+help-wanted-issues%3A%3E4&type=) encuentra repositorios con más de cuatro propuestas etiquetadas como `help-wanted` y que contienen la palabra "React." |
|
||||
|
||||
## Búsqueda basada en la capacidad de patrocinar
|
||||
|
||||
|
||||
@@ -108,7 +108,7 @@ The `mentions` qualifier finds issues that mention a certain user. For more info
|
||||
|
||||
| Qualifier | Example
|
||||
| ------------- | -------------
|
||||
| <code>mentions:<em>USERNAME</em></code> | [**resque mentions:defunkt**](https://github.com/search?q=resque+mentions%3Adefunkt&type=Issues) matches issues with the word "resque" that mention @defunkt.
|
||||
| <code>mentions:<em>USERNAME</em></code> | [**`resque mentions:defunkt`**](https://github.com/search?q=resque+mentions%3Adefunkt&type=Issues) matches issues with the word "resque" that mention @defunkt.
|
||||
|
||||
## Search by team mention
|
||||
|
||||
@@ -116,7 +116,7 @@ For organizations and teams you belong to, you can use the `team` qualifier to f
|
||||
|
||||
| Qualifier | Example
|
||||
| ------------- | -------------
|
||||
| <code>team:<em>ORGNAME/TEAMNAME</em></code> | **team:jekyll/owners** matches issues where the `@jekyll/owners` team is mentioned.
|
||||
| <code>team:<em>ORGNAME/TEAMNAME</em></code> | **`team:jekyll/owners`** matches issues where the `@jekyll/owners` team is mentioned.
|
||||
| | **team:myorg/ops is:open is:pr** matches open pull requests where the `@myorg/ops` team is mentioned.
|
||||
|
||||
## Search by commenter
|
||||
@@ -299,7 +299,7 @@ This qualifier takes a date as its parameter. {% data reusables.time_date.date_f
|
||||
|
||||
| Qualifier | Example
|
||||
| ------------- | -------------
|
||||
| <code>merged:<em>YYYY-MM-DD</em></code> | [**language:javascript merged:<2011-01-01**](https://github.com/search?q=language%3Ajavascript+merged%3A%3C2011-01-01+&type=Issues) matches pull requests in JavaScript repositories that were merged before 2011.
|
||||
| <code>merged:<em>YYYY-MM-DD</em></code> | [**`language:javascript merged:<2011-01-01`**](https://github.com/search?q=language%3Ajavascript+merged%3A%3C2011-01-01+&type=Issues) matches pull requests in JavaScript repositories that were merged before 2011.
|
||||
| | [**fast in:title language:ruby merged:>=2014-05-01**](https://github.com/search?q=fast+in%3Atitle+language%3Aruby+merged%3A%3E%3D2014-05-01+&type=Issues) matches pull requests in Ruby with the word "fast" in the title that were merged after May 2014.
|
||||
|
||||
## Search based on whether a pull request is merged or unmerged
|
||||
@@ -308,7 +308,7 @@ You can filter pull requests based on whether they're merged or unmerged using t
|
||||
|
||||
| Qualifier | Example
|
||||
| ------------- | -------------
|
||||
| `is:merged` | [**bugfix is:pr is:merged**](https://github.com/search?utf8=%E2%9C%93&q=bugfix+is%3Apr+is%3Amerged&type=) matches merged pull requests with the word "bugfix."
|
||||
| `is:merged` | [**bug is:pr is:merged**](https://github.com/search?utf8=%E2%9C%93&q=bugfix+is%3Apr+is%3Amerged&type=) matches merged pull requests with the word "bug."
|
||||
| `is:unmerged` | [**error is:unmerged**](https://github.com/search?utf8=%E2%9C%93&q=error+is%3Aunmerged&type=) matches closed issues and pull requests with the word "error."
|
||||
|
||||
## Search based on whether a repository is archived
|
||||
|
||||
@@ -2,6 +2,7 @@ date: '2021-12-07'
|
||||
sections:
|
||||
security_fixes:
|
||||
- 'Support bundles could include sensitive files if they met a specific set of conditions.'
|
||||
- 'A UI misrepresentation vulnerability was identified in GitHub Enterprise Server that allowed more permissions to be granted during a GitHub App''s user-authorization web flow than was displayed to the user during approval. This vulnerability affected all versions of GitHub Enterprise Server prior to 3.3 and was fixed in versions 3.2.5, 3.1.13, 3.0.21. This vulnerability was reported via the GitHub Bug Bounty program and has been assigned [CVE-2021-41598](https://www.cve.org/CVERecord?id=CVE-2021-41598).'
|
||||
bugs:
|
||||
- 'El ejecutar `ghe-config-apply` pudo fallar en ocasiones debido a problemas con los permisos en /data/user/tmp/pages`.'
|
||||
- 'A misconfiguration in the Management Console caused scheduling errors.'
|
||||
|
||||
@@ -2,6 +2,7 @@ date: '2021-12-07'
|
||||
sections:
|
||||
security_fixes:
|
||||
- 'Support bundles could include sensitive files if they met a specific set of conditions.'
|
||||
- 'A UI misrepresentation vulnerability was identified in GitHub Enterprise Server that allowed more permissions to be granted during a GitHub App''s user-authorization web flow than was displayed to the user during approval. This vulnerability affected all versions of GitHub Enterprise Server prior to 3.3 and was fixed in versions 3.2.5, 3.1.13, 3.0.21. This vulnerability was reported via the GitHub Bug Bounty program and has been assigned [CVE-2021-41598](https://www.cve.org/CVERecord?id=CVE-2021-41598).'
|
||||
bugs:
|
||||
- 'El ejecutar `ghe-config-apply` pudo fallar en ocasiones debido a problemas con los permisos en /data/user/tmp/pages`.'
|
||||
- 'A misconfiguration in the Management Console caused scheduling errors.'
|
||||
|
||||
@@ -2,11 +2,12 @@ date: '2021-12-07'
|
||||
sections:
|
||||
security_fixes:
|
||||
- 'Support bundles could include sensitive files if they met a specific set of conditions.'
|
||||
- 'A UI misrepresentation vulnerability was identified in GitHub Enterprise Server that allowed more permissions to be granted during a GitHub App''s user-authorization web flow than was displayed to the user during approval. This vulnerability affected all versions of GitHub Enterprise Server prior to 3.3 and was fixed in versions 3.2.5, 3.1.13, 3.0.21. This vulnerability was reported via the GitHub Bug Bounty program and has been assigned [CVE-2021-41598](https://www.cve.org/CVERecord?id=CVE-2021-41598).'
|
||||
bugs:
|
||||
- 'In some cases when Actions was not enabled, `ghe-support-bundle` reported an unexpected message `Unable to find MS SQL container.`'
|
||||
- 'Running `ghe-config-apply` could sometimes fail because of permission issues in `/data/user/tmp/pages`.'
|
||||
- 'El ejecutar `ghe-config-apply` pudo fallar en ocasiones debido a problemas con los permisos en /data/user/tmp/pages`.'
|
||||
- 'A misconfiguration in the Management Console caused scheduling errors.'
|
||||
- 'Docker would hold log files open after a log rotation.'
|
||||
- 'Docker retuvo los archivos de bitácora abiertos después de una rotación de bitácoras.'
|
||||
- 'Migrations could get stuck due to incorrect handling of `blob_path` values that are not UTF-8 compatible.'
|
||||
- 'GraphQL requests did not set the GITHUB_USER_IP variable in pre-receive hook environments.'
|
||||
- 'Pagination links on org audit logs would not persist query parameters.'
|
||||
|
||||
@@ -52,7 +52,7 @@ on:
|
||||
- '!sub-project/docs/**'
|
||||
```
|
||||
|
||||
### Comparaciones de diferencias de Git
|
||||
#### Comparaciones de diferencias de Git
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -0,0 +1,22 @@
|
||||
Algunos eventos tienen tipos de actividad que te proporcionan más control sobre cuándo debería ejecutarse tu flujo de trabajo. Use `on.<event_name>.types` to define the type of event activity that will trigger a workflow run.
|
||||
|
||||
Por ejemplo, el evento `issue_comment` tiene los tipos de actividad `created`, `edited` y `deleted`. Si tu flujo de trabajo activa el evento `label`, este se ejecutará cada que se cree, edite o borre una etiqueta. Si especificas el tipo de actividad `created` para el evento `label`, tu flujo de trabajo se ejecutará cuando se cree una etiqueta pero no cuando esta se borre o edite.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
label:
|
||||
types:
|
||||
- created
|
||||
```
|
||||
|
||||
Si especificas tipos de actividad múltiples, solo uno de ellos necesitará ocurrir para que se active tu flujo de trabajo. Si ocurren tipos de actividad de eventos activadores múltiples al mismo tiempo para tu flujo de trabajo, se activarán ejecuciones de flujo de trabajo múltiples. Por ejemplo, el siguiente flujo de trabajo se activa cuando se abre o etiqueta una propuesta. Si se abre una propuesta con dos etiquetas, iniciarán tres ejecuciones de flujo de trabajo: una para el evento de la propuesta abierta y dos para los eventos etiquetados de las dos propuestas.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
issue:
|
||||
types:
|
||||
- opened
|
||||
- labeled
|
||||
```
|
||||
|
||||
Para obtener más información acerca de cada evento y sus tipos de actividad, consulta "[Eventos que desencadenan flujos de trabajo](/actions/using-workflows/events-that-trigger-workflows)".
|
||||
@@ -0,0 +1,11 @@
|
||||
Algunos eventos tienen filtros que te dan más control sobre qué flujo de trabajo debería ejecutarse.
|
||||
|
||||
Por ejemplo, el evento `push` tiene un filtro `branches` que ocasiona que tu flujo de trabajo se ejecute únicamente cuando ocurra una subida a una rama que empate con el filtro `branches`, en vez de cuando ocurra una subida.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
- 'releases/**'
|
||||
```
|
||||
@@ -0,0 +1,18 @@
|
||||
Si especificas los tipos de actividad o filtros para un evento y tu flujo de trabajo activa eventos múltiples, deberás configurar cada uno de ellos por separado. Debes agregar dos puntos (`:`) a todos los eventos, incluyendo aquellos sin configuración.
|
||||
|
||||
Por ejemplo, un flujo de trabajo con el siguiente valor `on` se ejecutará cuando:
|
||||
|
||||
- Se crea una etiqueta
|
||||
- Se hace una subida a la rama `main` en el repositorio
|
||||
- Se hace una subida a la rama habilitada por {% data variables.product.prodname_pages %}
|
||||
|
||||
```yaml
|
||||
on:
|
||||
label:
|
||||
types:
|
||||
- created
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
page_build:
|
||||
```
|
||||
@@ -1,75 +1,19 @@
|
||||
### Utilizar un evento simple
|
||||
|
||||
Por ejemplo, un flujo de trabajo con el siguiente valor de `on` se ejecutará cuando se realice una subida a cualquier rama en el repositorio del flujo de trabajo:
|
||||
|
||||
```yaml
|
||||
on: push
|
||||
```
|
||||
{% data reusables.github-actions.on-single-example %}
|
||||
|
||||
### Utilizar eventos múltiples
|
||||
|
||||
Puedes especificar eventos sencillos o múltiples. Por ejemplo, un flujo de trabajo con el siguiente valor de `on` se ejecutará cuando se haga una subida a cualquier rama del repositorio o cuando alguien lo bifurque:
|
||||
|
||||
```yaml
|
||||
on: [push, fork]
|
||||
```
|
||||
|
||||
Si especificas eventos múltiples, únicamente uno de ellos necesitará ocurrir para que se active tu flujo de trabajo. Si ocurren eventos múltiples de activación para tu flujo de trabajo al mismo tiempo, se activarán las ejecuciones de flujo de trabajo múltiples.
|
||||
{% data reusables.github-actions.on-multiple-example %}
|
||||
|
||||
### Utilizar tipos de actividad
|
||||
|
||||
Algunos eventos tienen tipos de actividad que te proporcionan más control sobre cuándo debería ejecutarse tu flujo de trabajo.
|
||||
|
||||
Por ejemplo, el evento `issue_comment` tiene los tipos de actividad `created`, `edited` y `deleted`. Si tu flujo de trabajo activa el evento `label`, este se ejecutará cada que se cree, edite o borre una etiqueta. Si especificas el tipo de actividad `created` para el evento `label`, tu flujo de trabajo se ejecutará cuando se cree una etiqueta pero no cuando esta se borre o edite.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
label:
|
||||
types:
|
||||
- created
|
||||
```
|
||||
|
||||
Si especificas tipos de actividad múltiples, solo uno de ellos necesitará ocurrir para que se active tu flujo de trabajo. Si ocurren tipos de actividad de eventos activadores múltiples al mismo tiempo para tu flujo de trabajo, se activarán ejecuciones de flujo de trabajo múltiples. Por ejemplo, el siguiente flujo de trabajo se activa cuando se abre o etiqueta una propuesta. Si se abre una propuesta con dos etiquetas, iniciarán tres ejecuciones de flujo de trabajo: una para el evento de la propuesta abierta y dos para los eventos etiquetados de las dos propuestas.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
issue:
|
||||
types:
|
||||
- opened
|
||||
- labeled
|
||||
```
|
||||
{% data reusables.github-actions.actions-activity-types %}
|
||||
|
||||
### Utilizar filtros
|
||||
|
||||
Algunos eventos tienen filtros que te dan más control sobre qué flujo de trabajo debería ejecutarse.
|
||||
|
||||
Por ejemplo, el evento `push` tiene un filtro `branches` que ocasiona que tu flujo de trabajo se ejecute únicamente cuando ocurra una subida a una rama que empate con el filtro `branches`, en vez de cuando ocurra una subida.
|
||||
|
||||
```yaml
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
- 'releases/**'
|
||||
```
|
||||
{% data reusables.github-actions.actions-filters %}
|
||||
|
||||
### Utilizar los tipos de actividad y filtros con eventos múltiples
|
||||
|
||||
Si especificas los tipos de actividad o filtros para un evento y tu flujo de trabajo activa eventos múltiples, deberás configurar cada uno de ellos por separado. Debes agregar dos puntos (`:`) a todos los eventos, incluyendo aquellos sin configuración.
|
||||
|
||||
Por ejemplo, un flujo de trabajo con el siguiente valor `on` se ejecutará cuando:
|
||||
|
||||
- Se crea una etiqueta
|
||||
- Se hace una subida a la rama `main` en el repositorio
|
||||
- Se hace una subida a la rama habilitada por {% data variables.product.prodname_pages %}
|
||||
|
||||
```yaml
|
||||
on:
|
||||
label:
|
||||
types:
|
||||
- created
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
page_build:
|
||||
```
|
||||
{% data reusables.github-actions.actions-multiple-types %}
|
||||
@@ -0,0 +1,7 @@
|
||||
Puedes especificar eventos sencillos o múltiples. Por ejemplo, un flujo de trabajo con el siguiente valor de `on` se ejecutará cuando se haga una subida a cualquier rama del repositorio o cuando alguien lo bifurque:
|
||||
|
||||
```yaml
|
||||
on: [push, fork]
|
||||
```
|
||||
|
||||
Si especificas eventos múltiples, únicamente uno de ellos necesitará ocurrir para que se active tu flujo de trabajo. Si ocurren eventos múltiples de activación para tu flujo de trabajo al mismo tiempo, se activarán las ejecuciones de flujo de trabajo múltiples.
|
||||
@@ -0,0 +1,5 @@
|
||||
Por ejemplo, un flujo de trabajo con el siguiente valor de `on` se ejecutará cuando se realice una subida a cualquier rama en el repositorio del flujo de trabajo:
|
||||
|
||||
```yaml
|
||||
on: push
|
||||
```
|
||||
@@ -0,0 +1,34 @@
|
||||
Cuando se utiliza el evento `workflow_dispatch`, puedes especificar opcionalmente entradas que se pasan al flujo de trabajo.
|
||||
|
||||
El flujo de trabajo que se activa recibe las entradas en el contexto de `github.event.inputs`. Para obtener más información, consulta "[Contextos](/actions/learn-github-actions/contexts#github-context)".
|
||||
|
||||
```yaml
|
||||
on:
|
||||
workflow_dispatch:
|
||||
inputs:
|
||||
logLevel:
|
||||
description: 'Log level'
|
||||
required: true
|
||||
default: 'warning' {% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5511 %}
|
||||
type: choice
|
||||
options:
|
||||
- info
|
||||
- warning
|
||||
- debug {% endif %}
|
||||
tags:
|
||||
description: 'Test scenario tags'
|
||||
required: false {% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5511 %}
|
||||
type: boolean
|
||||
environment:
|
||||
description: 'Environment to run tests against'
|
||||
type: environment
|
||||
required: true {% endif %}
|
||||
|
||||
jobs:
|
||||
print-tag:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Print the input tag to STDOUT
|
||||
run: echo {% raw %} The tag is ${{ github.event.inputs.tag }} {% endraw %}
|
||||
```
|
||||
Reference in New Issue
Block a user