{"meta":{"title":"Uso de bloques predefinidos en el flujo de trabajo","intro":"Puedes usar y personalizar acciones escritas previamente para impulsar el flujo de trabajo.","product":"GitHub Actions","breadcrumbs":[{"href":"/es/actions","title":"GitHub Actions"},{"href":"/es/actions/how-tos","title":"Procedimientos"},{"href":"/es/actions/how-tos/write-workflows","title":"Escribir flujos de trabajo"},{"href":"/es/actions/how-tos/write-workflows/choose-what-workflows-do","title":"Seleccionar qué hacen los flujos de trabajo"},{"href":"/es/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions","title":"Búsqueda y personalización de acciones"}],"documentType":"article"},"body":"# Uso de bloques predefinidos en el flujo de trabajo\n\nPuedes usar y personalizar acciones escritas previamente para impulsar el flujo de trabajo.\n\n## Buscar las acciones de Marketplace en el editor de flujo de trabajo\n\nPuedes buscar y explorar acciones directamente en el editor de flujo de trabajo de tu repositorio. Desde la barra lateral, puedes buscar una acción específica, ver las acciones destacadas y explorar las categorías destacadas. También puede ver el número de estrellas que ha recibido una acción de la GitHub comunidad.\n\n1. En tu repositorio, navega hasta el archivo de flujo de trabajo que deseas editar.\n2. En la esquina superior derecha de la vista de archivo, para abrir el editor de flujo de trabajo, haga clic en .\n\n\n\n1. A la derecha del editor, use la GitHub Marketplace barra lateral para examinar las acciones. Las acciones con la insignia indican que GitHub ha verificado al creador de la acción como una organización asociada.\n\n\n\n## Agregar una acción a tu flujo de trabajo\n\nPuedes agregar una acción a tu flujo de trabajo si la referencias en tu archivo de flujo de trabajo. Las acciones que utilizas en tu flujo de trabajo pueden definirse en:\n\n* El mismo repositorio que el archivo de flujo de trabajo\n* Cualquier repositorio público\n* Imagen de contenedor de Docker publicada en Docker Hub\n\nPuede ver las acciones a las que se hace referencia en GitHub Actions los flujos de trabajo como dependencias en el gráfico de dependencias del repositorio que contiene los flujos de trabajo. Para más información, consulta \"[Gráfica de dependencias](/es/code-security/concepts/supply-chain-security/dependency-graph)\".\n\n> \\[!NOTE]\n> Para mejorar la seguridad, GitHub Actions no admite redireccionamientos de acciones o flujos de trabajo reutilizables. Esto significa que cuando se cambia el propietario, el nombre del repositorio de una acción o el nombre de una acción, cualquier flujo de trabajo que utilice esa acción con el nombre anterior dará error.\n\n### Adición de una acción desde GitHub Marketplace\n\nLas páginas de listado de acciones incluyen la versión de la acción y la sintaxis de flujo de trabajo que se requiere para utilizar dicha acción. Para mantener estable a tu flujo de trabajo, aún cuando se hagan actualizaciones en una acción, puedes referenciar la versión de la acción a utilizar si especificas el número de etiqueta de Git o de Docker en tu archivo de flujo de trabajo.\n\n1. Navega hasta la acción que deseas usar en tu flujo de trabajo.\n2. Haga clic para ver la lista completa de Marketplace para la acción.\n3. En \"Instalación\", haga clic para copiar la sintaxis del flujo de trabajo.\n\n\n\n1. Pega la sintaxis como un nuevo paso en tu flujo de trabajo. Para más información, consulta [Sintaxis del flujo de trabajo para Acciones de GitHub](/es/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idsteps).\n2. Si la accion requiere que proprociones información de entrada, configúrala en tu flujo de trabajo. Para obtener información sobre las entradas que puede requerir una acción, consulta [Uso de bloques predefinidos en el flujo de trabajo](/es/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions#using-inputs-and-outputs-with-an-action).\n\nTambién puede habilitar Dependabot version updates para las acciones que agregue al flujo de trabajo. Para más información, consulta [Mantener tus acciones actualizadas con el Dependabot](/es/code-security/how-tos/secure-your-supply-chain/secure-your-dependencies/auto-update-actions).\n\n### Agregar una acción desde el mismo repositorio\n\nSi una acción se define en el mismo repositorio donde el archivo de flujo de trabajo usa la acción, puede hacer referencia a la acción con la referencia del `$/path/to/dir` repositorio propio o con la sintaxis o `{owner}/{repo}@{ref}` en el `./path/to/dir` archivo de flujo de trabajo. La `$/` sintaxis no está disponible en GitHub Enterprise Server.\n\nEjemplo de estructura de archivo de repositorio:\n\n```shell\n|-- hello-world (repository)\n| |__ .github\n| └── workflows\n| └── my-first-workflow.yml\n| └── actions\n| |__ hello-world-action\n| └── action.yml\n```\n\nSe recomienda hacer referencia a la acción con la referencia del `$/path/to/dir` repositorio propio. Esto se resuelve en el mismo repositorio en la confirmación en ejecución, por lo que no es necesario desproteger primero el repositorio. Para obtener más información sobre cómo `$/` se compara con `{owner}/{repo}@{ref}` y `./`, vea [Sintaxis del flujo de trabajo para Acciones de GitHub](/es/actions/reference/workflows-and-actions/workflow-syntax#example-using-an-action-in-the-same-repository-as-the-workflow-at-the-running-commit-recommended).\n\nArchivo de flujo de trabajo de ejemplo mediante `$/`:\n\n```yaml\njobs:\n my_first_job:\n runs-on: ubuntu-latest\n steps:\n # This step references an action in the same repository at the\n # running commit. No repository checkout is required.\n - name: Use hello-world-action\n uses: $/.github/actions/hello-world-action\n```\n\nTambién puede hacer referencia a la acción con la sintaxis relativa `./path/to/dir` , pero es más propenso a errores. La ruta de acceso es relativa (`./`) al directorio de trabajo predeterminado (`github.workspace`, `$GITHUB_WORKSPACE`), por lo que requiere un paso de desprotección y, si la acción desproteger el repositorio en una ubicación distinta del flujo de trabajo, se debe actualizar la ruta de acceso relativa.\n\nArchivo de flujo de trabajo de ejemplo mediante `./`:\n\n```yaml\njobs:\n my_first_job:\n runs-on: ubuntu-latest\n steps:\n # This step checks out a copy of your repository.\n - name: My first step - check out repository\n uses: actions/checkout@v6\n # This step references the directory that contains the action.\n - name: Use local hello-world-action\n uses: ./.github/actions/hello-world-action\n```\n\nEl archivo `action.yml` se usa a fin de proporcionar metadatos para la acción. Obtenga información sobre el contenido de este archivo en [Guía de referencia de la sintaxis de metadatos](/es/actions/reference/workflows-and-actions/metadata-syntax).\n\n### Agregar una acción desde un repositorio diferente\n\nSi se define una acción en un repositorio diferente al del archivo de flujo de trabajo, puede hacer referencia a la acción con la sintaxis `{owner}/{repo}@{ref}` en el archivo de flujo de trabajo.\n\nLa acción debe almacenarse en un repositorio.\n\n```yaml\njobs:\n my_first_job:\n steps:\n - name: My first step\n uses: actions/setup-node@v7\n```\n\n### Hacer referencia a un contenedor en Docker Hub\n\nSi una acción se define en una imagen de contenedor de Docker publicada en Docker Hub, debe hacer referencia a la acción con la sintaxis de `docker://{image}:{tag}` en el archivo de flujo de trabajo. Para proteger el código y los datos, se recomienda comprobar la integridad de la imagen de contenedor de Docker desde Docker Hub antes de usarla en el flujo de trabajo.\n\n```yaml\njobs:\n my_first_job:\n steps:\n - name: My first step\n uses: docker://alpine:3.8\n```\n\nPara obtener algunos ejemplos de acciones de Docker, consulta el [flujo de trabajo Docker-image.yml](https://github.com/actions/starter-workflows/blob/main/ci/docker-image.yml) y [Creación de una acción de contenedor de Docker](/es/actions/tutorials/use-containerized-services/create-a-docker-container-action).\n\n### Fortalecimiento de la seguridad para el uso de acciones en flujos de trabajo\n\nGitHub proporciona características de seguridad que puede usar para aumentar la seguridad de los flujos de trabajo. Puede usar las funciones integradas de GitHub para asegurarse de recibir notificaciones sobre vulnerabilidades en las acciones que usa, o para automatizar el proceso de mantener actualizadas las acciones de sus flujos de trabajo. Para más información, consulta [Referencia de uso seguro](/es/actions/reference/security/secure-use).\n\n## Utilizar la administración de lanzamientos para tus acciones personalizadas\n\nLos creadores de una acción comunitaria tienen la opción de utilizar etiquetas, ramas, o valores de SHA para administrar los lanzamientos de la acción. Similar a cualquier dependencia, debes indicar la versión de la acción que te gustaría utilizar basándote en tu comodidad con aceptar automáticamente las actualizaciones para dicha acción.\n\nDesignarás la versión de la acción en tu archivo de flujo de trabajo. Revisa la documentación de la acción para encontrar información de su enfoque sobre la administración de lanzamientos, y para ver qué etiqueta, rama, o valor de SHA debes utilizar.\n\n> \\[!NOTE]\n> Se recomienda utilizar un valor SHA al emplear acciones de terceros. Sin embargo, es importante tener en cuenta que Dependabot solo creará Dependabot alerts para GitHub Actions vulnerables que usan versionado semántico. Para más información, consulta [Referencia de uso seguro](/es/actions/reference/security/secure-use#using-third-party-actions) y [Alertas de Dependabot](/es/code-security/concepts/supply-chain-security/dependabot-alerts).\n\n### Usar etiquetas\n\nLas etiquetas son útiles para que te permitan decidir cuándo cambiar entre versiones mayores y menores, pero son más efímeras y el mantenedor puede moverlas o borrarlas. Este ejemplo se muestra cómo seleccionar una acción etiquetada como `v1.0.1`:\n\n```yaml\nsteps:\n - uses: actions/javascript-action@v1.0.1\n```\n\n### Utilizar SHAs\n\nSi necesitas utilizar un versionamiento más confiable, debes utilizar el valor de SHA asociado con la versión de la acción. Los SHA son inmutables y, por lo tanto, más confiables que las etiquetas o las ramas. Sin embargo, este acercamiento significa que no recibirás actualizaciones para una acción automáticamente, incluyendo las correcciones de errores y actualizaciones de seguridad. Debes utilizar un valor SHA completo de la confirmación y no un valor abreviado.\nAl seleccionar un SHA, debe comprobar que se encuentra en el repositorio de la acción y no en una bifurcación de repositorio. Este ejemplo toma como objetivo el SHA de una acción:\n\n```yaml\nsteps:\n - uses: actions/javascript-action@a824008085750b8e136effc585c3cd6082bd575f\n```\n\n### Utilizar ramas\n\nEl especificar una rama destino para la acción significa que ésta siempre ejecutará la versión que se encuentre actualmente en dicha rama. Este enfoque puede crear problemas si una actualización a la rama incluye cambios disruptivos. Este ejemplo tiene como destino una rama denominada `@main`:\n\n```yaml\nsteps:\n - uses: actions/javascript-action@main\n```\n\nPara más información, consulta [Administración de acciones personalizadas](/es/actions/how-tos/create-and-publish-actions/manage-custom-actions#using-release-management-for-actions).\n\n## Utilizar entradas y salidas con una acción\n\nUna acción a menudo acepta o requiere entradas y genera salidas que puedes utilizar. Por ejemplo, una acción podría requerir que especifiques una ruta a un archivo, el nombre de una etiqueta, u otros datos que utilizará como parte del procesamiento de la misma.\n\nPara ver las entradas y salidas de una acción, revisa `action.yml` en el directorio raíz del repositorio.\n\nEn este ejemplo `action.yml`, la palabra clave `inputs` define una entrada necesaria denominada `file-path` e incluye un valor predeterminado que se usará si no se especifica ninguno. La palabra clave `outputs` define una salida denominada `results-file`, que indica dónde buscar los resultados.\n\n```yaml\nname: \"Example\"\ndescription: \"Receives file and generates output\"\ninputs:\n file-path: # id of input\n description: \"Path to test script\"\n required: true\n default: \"test-file.js\"\noutputs:\n results-file: # id of output\n description: \"Path to results file\"\n```"}