resources.containers.container definition

Un recurso de contenedor hace referencia a una imagen de contenedor.

containers:
- container: string # Required as first property. Alias of the container.
  image: string # Required. Container image tag.
  type: string # Type of the registry like ACR or GCR.
  trigger: trigger | none | true # Specify none to disable, true to trigger on all image tags, or use the full syntax as described in the following examples.
  endpoint: string # ID of the service endpoint connecting to a private container registry.
  env: # Variables to map into the container's environment.
    string: string # Name/value pairs
  mapDockerSocket: boolean # Set this flag to false to force the agent not to setup the /var/run/docker.sock volume on container jobs.
  options: string # Options to pass into container host.
  ports: [ string ] # Ports to expose on the container.
  volumes: [ string ] # Volumes to mount on the container.
  mountReadOnly: # Volumes to mount read-only, the default is all false.
    work: boolean # Mount the work directory as readonly.
    externals: boolean # Mount the externals directory as readonly.
    tools: boolean # Mount the tools directory as readonly.
    tasks: boolean # Mount the tasks directory as readonly.
  azureSubscription: string # Azure subscription (ARM service connection) for container registry.
  resourceGroup: string # Resource group for your ACR.
  registry: string # Registry for container images.
  repository: string # Name of the container image repository in ACR.
  localImage: boolean # When true, uses a locally tagged image instead of using docker pull to get the image. The default is false.

Definiciones que hacen referencia a esta definición: resources.containers

Propiedades

container Cadena. Obligatorio como primera propiedad.
Identificador del contenedor. Valores aceptables: [-_A-Za-z0-9]*.

image Cadena. Necesario.
Etiqueta de imagen de contenedor.

type Cadena.
Tipo del registro, como ACR o GCR.

triggerresources.containers.container.trigger.
Especifique ninguno para deshabilitar, true para desencadenar en todas las etiquetas de imagen o use la sintaxis completa, como se describe en los ejemplos siguientes.

endpoint Cadena.
Identificador del punto de conexión de servicio que se conecta a un registro de contenedor privado. Se admiten expresiones de plantilla.

env diccionario de cadenas.
Variables que se van a asignar al entorno del contenedor.

mapDockerSocketbooleano.
Establezca esta marca en false para forzar que el agente no configure el volumen /var/run/docker.sock en los trabajos de contenedor.

options Cadena.
Opciones para pasar al host de contenedor. Se admiten expresiones de plantilla.

ports lista de cadenas.
Puertos que se exponen en el contenedor. Se admiten expresiones de plantilla.

volumes lista de cadenas.
Volúmenes que se van a montar en el contenedor. Se admiten expresiones de plantilla.

mountReadOnlymountReadOnly.
Los volúmenes para montar solo lectura, el valor predeterminado es false.

azureSubscription Cadena.
Suscripción de Azure (conexión de servicio arm) para el registro de contenedor.

resourceGroup Cadena.
Grupo de recursos de ACR.

registry Cadena.
Registro para imágenes de contenedor.

repository Cadena.
Nombre del repositorio de imágenes de contenedor en ACR.

localImagebooleano.
Cuando es true, usa una imagen etiquetada localmente en lugar de usar docker pull para obtener la imagen. El valor predeterminado es false.

Esta propiedad solo es útil para los agentes autohospedados en los que la imagen ya está presente en el equipo del agente.

Comentarios

Los trabajos de contenedor permiten aislar las herramientas y las dependencias dentro de un contenedor.

El agente inicia una instancia del contenedor especificado y, a continuación, ejecuta los pasos que hay dentro. La palabra clave container le permite especificar las imágenes de contenedor.

Los contenedores de servicio se ejecutan junto con un trabajo para proporcionar varias dependencias, como las bases de datos.

Las expresiones de plantilla se admiten para endpointlas propiedades , volumes, portsy options de un recurso de contenedor en una canalización YAML.

Ejemplos

resources:
  containers:
  - container: linux
    image: ubuntu:16.04
  - container: windows
    image: myprivate.azurecr.io/windowsservercore:1803
    endpoint: my_acr_connection
  - container: my_service
    image: my_service:tag
    ports:
    - 8080:80 # bind container port 80 to 8080 on the host machine
    - 6379 # bind container port 6379 to a random available port on the host machine
    volumes:
    - /src/dir:/dst/dir # mount /src/dir on the host into /dst/dir in the container

Vea también

Definir recursos en YAML