{"meta":{"title":"Administrar entornos para la implementación","intro":"Puede crear entornos y asegurarlos con las reglas de protección de implementación. Un trabajo que haga referencia a un entorno debe seguir cualquier regla de protección para el entorno antes de ejecutar o acceder a los secretos de dicho entorno.","product":"GitHub Actions","breadcrumbs":[{"href":"/es/actions","title":"GitHub Actions"},{"href":"/es/actions/how-tos","title":"Procedimientos"},{"href":"/es/actions/how-tos/deploy","title":"Desplegar"},{"href":"/es/actions/how-tos/deploy/configure-and-manage-deployments","title":"Configura y administra implementaciones"},{"href":"/es/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments","title":"Administrar entornos"}],"documentType":"article"},"body":"# Administrar entornos para la implementación\n\nPuede crear entornos y asegurarlos con las reglas de protección de implementación. Un trabajo que haga referencia a un entorno debe seguir cualquier regla de protección para el entorno antes de ejecutar o acceder a los secretos de dicho entorno.\n\n## Requisitos previos\n\n> \\[!NOTE]\n> Los usuarios con planes GitHub Free solo pueden configurar entornos para repositorios públicos. Si conviertes un repositorio de público a privado, cualquier regla de protección o secretos de ambiente que hubieses configurado se ingorarán y no podrás configurar ningún ambiente. Si conviertes tu repositorio en público nuevamente, tendrás acceso a cualquier regla de protección y secreto de ambiente que hubieras configurado previamente.\n>\n> Los usuarios con GitHub Team y las organizaciones con GitHub Pro pueden configurar entornos para repositorios privados. Para más información, consulta [planes de GitHub](/es/get-started/learning-about-github/githubs-plans).\n\n* Para obtener información general sobre los entornos, consulta [Implementación con GitHub Actions](/es/actions/concepts/use-cases/deploying-with-github-actions#using-environments).\n* Para obtener información sobre las reglas disponibles, consulta [Implementaciones y entornos](/es/actions/reference/deployments-and-environments).\n\n## Creación de un entorno\n\nPara configurar un entorno en un repositorio de cuenta personal, debes ser el propietario del repositorio. Para configurar un entorno en el repositorio de una organización, debe tener acceso `admin`.\n\n> \\[!NOTE]\n>\n> * La creación de un entorno en un repositorio privado está disponible para las organizaciones con GitHub Team y usuarios con GitHub Pro.\n> * Algunas características de los entornos no están disponibles o lo están de forma limitada para los repositorios privados. Si no puedes acceder a una característica descrita en las siguientes instrucciones, consulta la documentación correspondiente en el paso correspondiente para más información sobre disponibilidad.\n\n1. En GitHub, navegue hasta la página principal del repositorio.\n2. Debajo del nombre del repositorio, haz clic en ** Settings**. Si no puedes ver la pestaña \"Configuración\", selecciona el menú desplegable **** y, a continuación, haz clic en **Configuración**.\n\n \n3. En la barra lateral de la izquierda, haz clic en **Entornos**.\n4. Haga clic en **New environment** (Nuevo entorno).\n5. Escriba un nombre para el entorno y, después, haga clic en **Configurar entorno**. Los nombres de ambiente no distinguen entre mayúsculas y minúsculas. Un nombre de ambiente no deberá exceder los 255 caracteres y deberá ser único dentro del repositorio.\n6. Opcionalmente, puedes especificar personas o equipos que deben aprobar las tareas del flujo de trabajo que utilicen este entorno. Para más información, consulta [Implementaciones y entornos](/es/actions/reference/deployments-and-environments#required-reviewers).\n 1. Seleccione **Revisores obligatorios**.\n 2. Ingresa hasta 6 personas o equipos. Solo uno de los revisores requeridos necesita aprobar el trabajo para que continúe.\n 3. Opcionalmente, para evitar que los usuarios aprueben las ejecuciones de flujos de trabajo que han desencadenado, selecciona **Prevent self-review**.\n 4. Haga clic en **Save protection rules**.\n7. Opcionalmente, especifica la cantidad de tiempo que esperar antes de permitir que las tareas de flujo de trabajo que utilizan este entorno continúen. Para más información, consulta [Implementaciones y entornos](/es/actions/reference/deployments-and-environments#wait-timer).\n 1. Seleccione **Wait timer**.\n 2. Ingresa la cantidad de minutos a esperar.\n 3. Haga clic en **Save protection rules**.\n8. Opcionalmente, no permita omitir las reglas de protección configuradas. Para más información, consulta [Implementaciones y entornos](/es/actions/reference/deployments-and-environments#allow-administrators-to-bypass-configured-protection-rules).\n 1. Anule la selección de **Permitir que los administradores omitan las reglas de protección configuradas**.\n 2. Haga clic en **Save protection rules**.\n9. Opcionalmente, habilite las reglas de protección de implementación personalizadas que se hayan creado con GitHub Apps. Para más información, consulta [Implementaciones y entornos](/es/actions/reference/deployments-and-environments#custom-deployment-protection-rules).\n 1. Seleccione la regla de protección personalizada que quiere habilitar.\n 2. Haga clic en **Save protection rules**.\n10. De manera opcional, especifica qué ramas y etiquetas se pueden implementar en este entorno. Para más información, consulta [Implementaciones y entornos](/es/actions/reference/deployments-and-environments#deployment-branches-and-tags).\n 1. Seleccione la opción deseada en la lista desplegable **Deployment branches**.\n\n 2. Si has elegido **Selected branches and tags**, para agregar una nueva regla, haz clic en **Agregar regla de rama o etiqueta de despliegue**.\n\n 3. En el menú desplegable \"Ref type\", haz clic en ** Branch** o ** Tag** en función de la regla que quieras aplicar.\n\n 4. Escribe el patrón de nombre de la rama o etiqueta que quieres permitir.\n\n > \\[!NOTE]\n > Los patrones de nombre deben configurarse para ramas o etiquetas de forma individual.\n\n 5. Haga clic en **Agregar regla**.\n11. Opcionalmente, agrega secretos de ambiente. Estos secretos solo están disponibles para los trabajos de flujo de trabajo que utilicen el entorno. Además, las tareas de flujo de trabajo que utilicen este entorno solo pueden acceder a estos secretos después de que todas las reglas configuradas (por ejemplo, revisores requeridos) se cumplan. Para más información, consulta [Implementaciones y entornos](/es/actions/reference/deployments-and-environments#environment-secrets).\n 1. En **Environment secrets**, haga clic en **Add Secret**.\n 2. Ingresa el nombre del secreto.\n 3. Ingresa el valor secreto.\n 4. Haga clic en **Añadir secreto**.\n12. Opcionalmente, agrega variables de entorno. Estas variables solo están disponibles para los trabajos de flujo de trabajo que usan el entorno y solo son accesibles mediante el contexto [`vars`](/es/actions/learn-github-actions/contexts#vars-context). Para más información, consulta [Implementaciones y entornos](/es/actions/reference/deployments-and-environments#environment-variables).\n 1. En **Variables de entorno**, haz clic en **Agregar variable**.\n 2. Establece el nombre de la variable.\n 3. Establece el valor de la variable.\n 4. Haz clic en **Agregar variable**.\n\nTambién puedes crear y configurar ambientes a través de la API de REST. Para más información, consulta [Puntos de conexión de la API de REST para entornos de implementación](/es/rest/deployments/environments), [Puntos de conexión de API de REST para secretos de Acciones de GitHub](/es/rest/actions/secrets), [Puntos de conexión de la API REST para variables de GitHub Actions](/es/rest/actions/variables) y [Puntos de conexión de la API de REST para directivas de rama de implementación](/es/rest/deployments/branch-policies).\n\nEl ejecutar un flujo de trabajo que referencie un ambiente que no existe creará un ambiente con el nombre referenciado. Si el entorno se crea al ejecutar compilaciones implícitas de páginas (por ejemplo, a partir de una rama o una carpeta de origen), la rama de origen se añadirá como regla de protección al entorno. De lo contrario, el entorno recién creado no tendrá configurada ninguna regla de protección o secreto. Cualquiera que pueda editar flujos de trabajo en el repositorio podrá crear ambientes a través de un archivo de flujo de trabajo, pero solo los administradoresd e repositorio pueden configurar el ambiente.\n\n## Borrar un ambiente\n\nPara configurar un entorno en un repositorio de cuenta personal, debes ser el propietario del repositorio. Para configurar un entorno en el repositorio de una organización, debe tener acceso `admin`.\n\nEl borrar un ambiente borrará todos los secretos y reglas de protección asociadas con éste. Cualquier job que esté actualmente en espera porque depende de las reglas de protección del ambiente que se borró, fallará automáticamente.\n\n1. En GitHub, navegue hasta la página principal del repositorio.\n2. Debajo del nombre del repositorio, haz clic en ** Settings**. Si no puedes ver la pestaña \"Configuración\", selecciona el menú desplegable **** y, a continuación, haz clic en **Configuración**.\n\n \n3. En la barra lateral de la izquierda, haz clic en **Entornos**.\n4. Junto al entorno que quieras borrar, haz clic en .\n5. Haga clic en **Entiendo, eliminar este entorno**.\n\nTambién puyedes borrar ambientes a través de la API de REST. Para más información, consulta [Puntos de conexión de la API de REST para repositorios](/es/rest/repos#environments).\n\n## Cómo se relacionan los ambientes con los desplilegues\n\nCuando se ejecuta un trabajo de flujo de trabajo que hace referencia a un entorno, crea un objeto de implementación con la propiedad `environment` establecida en el nombre del entorno. A medida que avanza el flujo de trabajo, también crea objetos de estado de implementación con la propiedad `environment` establecida en el nombre del entorno, la propiedad `environment_url` establecida en la URL del entorno (si se ha especificado en el flujo de trabajo) y la propiedad `state` establecida en el estado del trabajo.\n\nPuedes acceder a estos objetos a través de la API de REST o la API de GraphQL. También puedes suscribirte a estos eventos de webhook. Para obtener más información, consulta [Puntos de conexión de la API de REST para repositorios](/es/rest/repos#deployments), [Objetos](/es/graphql/reference/objects#deployment) (GraphQL API) o [Eventos y cargas de webhook](/es/webhooks-and-events/webhooks/webhook-events-and-payloads#deployment).\n\n## Pasos siguientes\n\nGitHub Actions proporciona varias características para administrar tus despliegues. Para más información, consulta [Implementación con GitHub Actions](/es/actions/deployment/about-deployments/deploying-with-github-actions)."}