Implementación de un contenedor personalizado en Azure App Service con Azure Pipelines

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Con Azure Pipelines, se puede compilar, probar e implementar automáticamente aplicaciones web en un contenedor de aplic. web de Azure App Service en Linux. En este artículo, aprenderá a usar canalizaciones YAML o clásicas para:

• Compile y publique una imagen de Docker en Azure Container Registry.
• Cree una aplicación web de Azure.
• Implemente un contenedor en Azure App Service.
• Desplegar en ranuras de implementación.

Requisitos previos

Producto	Requisitos
Azure DevOps	- Una organización y un proyecto de Azure DevOps. cree una de forma gratuita. - Permisos:     - Para conceder acceso a todas las canalizaciones del proyecto: debe ser miembro del grupo Administradores de proyectos.     - Para crear conexiones de servicio: debe tener el rol Administrador o Creador para las conexiones de servicio. - Tener la capacidad de ejecutar canalizaciones en agentes hospedados por Microsoft. Puede comprar un trabajo paralelo o solicitar un nivel gratis.
GitHub (en inglés)	- Una cuenta de GitHub .
Celeste	- Una instancia de Azure Container Registry. Cree un registro de contenedor de Azure si aún no tiene uno.

Obtención del código

Bifurque la siguiente aplicación de ejemplo en GitHub.

Java

https://github.com/spring-guides/gs-spring-boot-docker.git

JavaScript

https://github.com/MicrosoftDocs/pipelines-javascript-docker

Pitón

https://github.com/Microsoft/python-sample-vscode-flask-tutorial

.NET Core

https://github.com/MicrosoftDocs/pipelines-dotnet-core-docker

Compilación y publicación de la imagen de Docker en Azure Container Registry

Para completar esta sección correctamente, debe tener una Azure Container Registry. Consulte la sección Requisitos previos para más información.

1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

2. Seleccione Canalizaciones y, luego, Nueva canalización.

3. Seleccione GitHub cuando se le solicite la ubicación del código fuente y, a continuación, seleccione el repositorio.

4. Seleccione Docker: build and push an image to Azure Container Registry pipeline template (Docker: compilar e insertar una imagen en Azure Container Registry plantilla de canalización).

   

5. En Suscripción de Azure, seleccione su suscripción y, luego, elija Continuar.

6. Seleccione el registro de contenedor en el menú desplegable y, a continuación, seleccione Validar y configurar.

   

7. Revise la plantilla YAML de canalización y, a continuación, seleccione Guardar y ejecutar para compilar y publicar la imagen de Docker en Azure Container Registry.

   trigger:
   - main
   
   resources:
   - repo: self
   
   variables:
       # Container registry service connection established during pipeline creation
       dockerRegistryServiceConnection: '{{ containerRegistryConnection.Id }}'
       imageRepository: 'javascriptdocker'
       containerRegistry: 'sampleappcontainerregistry.azurecr.io'
       dockerfilePath: '$(Build.SourcesDirectory)/app/Dockerfile'
       tag: '$(Build.BuildId)'
   
       # Agent VM image name
       vmImageName: 'ubuntu-latest'
   
   stages:
   - stage: Build
       displayName: Build and push stage
       jobs:
       - job: Build
       displayName: Build
       pool:
           vmImage: $(vmImageName)
       steps:
       - task: Docker@2
           displayName: Build and push an image to container registry
           inputs:
           command: buildAndPush
           repository: $(imageRepository)
           dockerfile: $(dockerfilePath)
           containerRegistry: $(dockerRegistryServiceConnection)
           tags: |
               $(tag)
   

8. Para ver la imagen de Docker publicada una vez completada la ejecución de la canalización, vaya al registro de contenedor en Azure Portal y seleccione Repositorios.

   

9. Para implementar la imagen desde el registro de contenedor, habilite la cuenta de usuario administrador. Vaya al registro de contenedor en Azure Portal y seleccione Claves de acceso. A continuación, seleccione el botón de conmutación para habilitar el usuario administrador.

Crear una aplicación web de

1. Acceda a Portal Azure.

2. Seleccione Crear un recurso>Contenedores y, a continuación, elija Aplicación web para contenedores.

   

3. Escriba un nombre para la nueva aplicación web y cree un nuevo grupo de recursos. Seleccione Linux como Sistema operativo.

   

4. En la sección Planes de precios , seleccione el plan F1 Gratis.

5. Seleccione Revisar y crear. Revise la configuración y seleccione Crear cuando haya terminado.

Implementación en Web App for Containers

YAML

En este YAML, compilará e insertará una imagen de Docker en un registro de contenedor y, a continuación, la implementará en Azure Web App for Containers. En la fase de compilación, compilará e insertará una imagen de Docker en un Azure Container Registry con la tarea Docker@2. La tarea AzureWebAppContainer@1 implementa la imagen en Web App for Containers.

trigger:
- main

resources:
- repo: self

variables: 
  ## Add this under variables section in the pipeline
  azureSubscription: <Name of the Azure subscription>
  appName: <Name of the Web App>
  containerRegistry: <Name of the Azure container registry>
  dockerRegistryServiceConnection: '4fa4efbc-59af-4c0b-8637-1d5bf7f268fc'
  imageRepository: <Name of image repository>
  dockerfilePath: '$(Build.SourcesDirectory)/Dockerfile'
  tag: '$(Build.BuildId)'

  vmImageName: 'ubuntu-latest'

stages:
- stage: Build
  displayName: Build and push stage
  jobs:
  - job: Build
    displayName: Build
    pool:
      vmImage: $(vmImageName)
    steps:
    - task: Docker@2
      displayName: Build and push an image to container registry
      inputs:
        command: buildAndPush
        repository: $(imageRepository)
        dockerfile: $(dockerfilePath)
        containerRegistry: $(dockerRegistryServiceConnection)
        tags: |
          $(tag)


    ## Add the below snippet at the end of your pipeline
    - task: AzureWebAppContainer@1
      displayName: 'Azure Web App on Container Deploy'
      inputs:
        azureSubscription: $(azureSubscription)
        appName: $(appName)
        containers: $(containerRegistry)/$(imageRepository):$(tag)

Clásico

1. En el proyecto, seleccione Canalizaciones y, a continuación, seleccione Versión.

2. Seleccione Nueva canalización para crear una nueva canalización de versión.

3. Seleccione la plantilla Implementación de Azure App Service

   

4. Seleccione Tareas y desvincule todo en la fase 1 para desvincular todos los parámetros de canalización.

   

5. Seleccione la tarea Implementar Azure App Service y rellene los campos obligatorios. Cuando haya terminado, haga clic en Guardar.

   

6. Seleccione Crear versión y, a continuación, elija Fase 1 en el menú desplegable. Seleccione Crear cuando haya terminado.

   

7. Mantenga el puntero sobre Etapa 1 de la canalización y, a continuación, seleccione Implementar para incluir en la cola e iniciar la implementación.

   

8. Los registros del pipeline deberían tener un aspecto similar al de esta captura de pantalla.

   

9. Vaya a la aplicación web recién implementada para comprobar la implementación.

   

Implementación en ranuras de implementación

YAML

Configure el contenedor de Azure Web App para tener varias ranuras. Las ranuras le permiten implementar la aplicación de forma segura y probarla antes de ponerla a disposición de los clientes. Obtenga más información en Creación de entornos de ensayo.

El siguiente fragmento de código YAML muestra cómo implementar en un espacio de ensayo y, a continuación, cambiar a un espacio de producción:

- task: AzureWebAppContainer@1
  inputs:
    azureSubscription: '<Azure service connection>'
    appName: '<Name of the web app>'
    containers: $(containerRegistry)/$(imageRepository):$(tag)
    deployToSlotOrASE: true
    resourceGroupName: '<Name of the resource group>'
    slotName: staging

- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: '<Azure service connection>'
    WebAppName: '<name of web app>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

Clásico

Puede configurar el contenedor de Aplicación web de Azure para que tenga varias ranuras. Las ranuras permiten implementar la aplicación de forma segura y probarla antes de ponerla a disposición de los clientes. Utilice la opción Implementar en ranura en la tarea Contenedor de Azure Web App para especificar la ranura en la que se va a implementar. Cambie las ranuras mediante la tarea Administrar el servicio de aplicaciones de Azure.

Preguntas más frecuentes

P: ¿Cómo puedo encontrar mis credenciales del registro de Docker?

R: Vaya a Azure Portal y seleccione la aplicación web para contenedores. Seleccione Configuración>de la aplicación y, a continuación, seleccione para mostrar el valor.

Artículos relacionados

• Implementación en Azure
• Uso de plantillas de Resource Manager
• Definir y destino de entornos