Creación y establecimiento como destino de un entorno

Azure Pipelines | Azure DevOps Server 2020

Un entorno es una colección de recursos a los que puede dirigirse con implementaciones de una canalización. Los ejemplos típicos de nombres de entorno son Dev, Test, QA, Staging y Production.

Los entornos proporcionan las siguientes ventajas.

Aunque un entorno es una agrupación de recursos, los propios recursos representan los destinos de implementación reales. Actualmente se admiten los tipos de recursos de kubernetes y de máquina virtual.

Creación de un entorno

1. Inicie sesión en su organización y https://dev.azure.com/{yourorganization} seleccione el proyecto.

2. Seleccione Pipelinesenvironments Createenvironment (Crear entorno).

   

3. Escriba la información del entorno y, a continuación, seleccione Crear. Los recursos se pueden agregar a un entorno existente más adelante.

   

Use también una canalización para crear e implementar en entornos. Para obtener más información, vea la guía paso a paso.

Destino de un entorno desde un trabajo de implementación

Un trabajo de implementación es una colección de pasos que se ejecutarán secuencialmente. Un trabajo de implementación se puede usar para dirigirse a todo un entorno (grupo de recursos), como se muestra en el siguiente fragmento de código yaml.

- stage: deploy
  jobs:
  - deployment: DeployWeb
    displayName: deploy Web App
    pool:
      vmImage: 'Ubuntu-latest'
    # creates an environment if it doesn't exist
    environment: 'smarthotel-dev'
    strategy:
      runOnce:
        deploy:
          steps:
          - script: echo Hello world

Destino de un recurso específico dentro de un entorno desde el trabajo de implementación

Puede establecer el ámbito del destino de la implementación en un recurso determinado dentro del entorno. A continuación, puede registrar el historial de implementación en un recurso específico dentro del entorno. Los pasos del trabajo de implementación heredan automáticamente los detalles de conexión de servicio del recurso de destino del trabajo de implementación.

environment: 'smarthotel-dev.bookings'
strategy: 
 runOnce:
   deploy:
     steps:
     - task: KubernetesManifest@0
       displayName: Deploy to Kubernetes cluster
       inputs:
         action: deploy
         namespace: $(k8sNamespace)
         manifests: $(System.ArtifactsDirectory)/manifests/*
         imagePullSecrets: $(imagePullSecret)
         containers: $(containerRegistry)/$(imageRepository):$(tag)
         # value for kubernetesServiceConnection input automatically passed down to task by environment.resource input

Entorno en detalles de ejecución

Todos los entornos a los que se dirigirán los trabajos de implementación de una ejecución específica de una canalización se pueden encontrar en la pestaña Entornos de los detalles de ejecución de la canalización.

Si usa un clúster privado de AKS, la pestaña Entornos no está disponible.

Aprobaciones

Controlar manualmente cuándo se debe ejecutar una fase mediante comprobaciones de aprobación. Use comprobaciones de aprobación para controlar las implementaciones en entornos de producción. Las comprobaciones están disponibles para que el propietario del recurso controle cuándo una fase de una canalización consume un recurso. Como propietario de un recurso, como un entorno, puede definir aprobaciones y comprobaciones que deben satisfacerse antes de que se inicie una fase que consume ese recurso.

Se admiten comprobaciones de aprobación manuales en entornos. Para obtener más información, vea Aprobaciones.

Los roles de creador, administrador y usuario pueden administrar aprobaciones y comprobaciones. El rol Lector no puede administrar las aprobaciones y comprobaciones.

Historial de implementación

La vista del historial de implementación dentro de los entornos proporciona las siguientes ventajas.

• Ver trabajos de todas las canalizaciones destinadas a un entorno específico. Por ejemplo, dos microservicios, cada uno con su propia canalización, se implementan en el mismo entorno. La lista del historial de implementaciones ayuda a identificar todas las canalizaciones que afectan a este entorno y también ayuda a visualizar la secuencia de implementaciones por cada canalización.

  

• Explore en profundidad los detalles del trabajo para ver la lista de confirmaciones y elementos de trabajo que se implementaron recientemente en el entorno.

  

Seguridad

Permisos de usuario

Controlar quién puede crear, ver, usar y administrar los entornos con permisos de usuario. Hay cuatro roles: Creador (ámbito: todos los entornos), Lector, Usuario y Administrador. En el panel de permisos de usuario del entorno específico, puede establecer los permisos que se heredan y puede invalidar los roles de cada entorno.

1. Vaya al entorno específico que desea autorizar.
2. Seleccione Seguridad para ver la configuración.
3. Seleccione Permisos de usuario+Agregar usuario o grupo y, a continuación, seleccione un rol adecuado.

Permisos de canalización

Use permisos de canalización para autorizar todas o las canalizaciones seleccionadas para la implementación en el entorno.

• Para quitar El acceso abierto en el entorno o recurso, seleccione Restringir permiso en Permisos de canalización.
• Para permitir que canalizaciones específicas se implemente en un entorno o recurso específico, seleccione + y elija en la lista de canalizaciones.

Pasos siguientes

Definición de aprobaciones y comprobaciones

Preguntas más frecuentes

P: ¿Por qué aparece un mensaje de error al intentar crear un entorno?

A. Si ve el mensaje "Acceso denegado: {Usuario} necesita crear permisos para realizar la acción", compruebe los permisos de nivel de organización. Vaya a Organización Configuraciónusuarios y compruebe si tiene el rol de parte interesada. El rol de partes interesadas no puede crear entornos. Cambie el nivel de acceso y compruebe si puede crear entornos. Para obtener más información, vea Preguntas más frecuentes sobre administración de usuarios y permisos.

P: ¿Por qué aparece el error "Job XXXX: Environment XXXX could not be found. ¿El entorno no existe o no se ha autorizado para su uso"?

A. Estas son algunas de las posibles razones del error:

• Al crear una canalización de YAML y hacer referencia a un entorno que no existe en el archivo YAML, Azure Pipelines crea automáticamente el entorno en algunos casos:

  • Use el Asistente para la creación de canalizaciones de YAML en Azure Pipelines web y haga referencia a un entorno que aún no se ha creado.
  • Actualice el archivo YAML mediante el editor web Azure Pipelines y guarde la canalización después de agregar una referencia a un entorno que no existe.

• En los flujos siguientes, Azure Pipelines no tiene información sobre el usuario que crea el entorno: actualiza el archivo YAML mediante otro editor de código externo, agrega una referencia a un entorno que no existe y, a continuación, hace que se desencadene una canalización de integración manual o continua. En este caso, Azure Pipelines no conoce al usuario. Anteriormente, se controló este caso agregando todos los colaboradores del proyecto al rol de administrador del entorno. Cualquier miembro del proyecto podría cambiar estos permisos e impedir que otros usuarios accedan al entorno.

• Si usa parámetros en tiempo de ejecución para crear el entorno, se producirá un error, ya que estos parámetros se expanden en tiempo de ejecución. La creación del entorno se produce en tiempo de compilación, por lo que tenemos que usar variables para crear el entorno.

• Un usuario con el nivel de acceso de las partes interesadas no puede crear el entorno, ya que las partes interesadas no acceden al repositorio.

Artículos relacionados

• Definición de variables
• Definición de recursos en YAML