Compartir a través de


Definición de resources.containers.container

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.
  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.
  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.
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.
containers:
- container: string # Required as first property. Alias of the container.
  type: string # Type of the registry like ACR or GCR.
  endpoint: string # ID of the service endpoint connecting to a private container registry.
  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.
  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.
id. del contenedor. Valores aceptables: [-_A-Za-z0-9]*.

image cadena. Obligatorio.
etiqueta de imagen de contenedor.

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

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

azureSubscription cadena.
suscripción de Azure (conexión del servicio ARM) para el registro de contenedor.

resourceGroup cadena.
grupo de recursos para ACR.

registry cadena.
Registro para imágenes de contenedor.

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

localImage booleano .
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.

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

endpoint cadena.
identificador del punto de conexión de servicio que se conecta a un registro de contenedor privado.

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

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

options cadena.
Opciones para pasar al host de contenedor. se admiten expresiones de plantilla.

options cadena.
Opciones para pasar al host de contenedor.

ports lista de cadenas.
Puertos que se van a exponer en el contenedor. se admiten expresiones de plantilla.

ports lista de cadenas.
Puertos que se van a exponer en el contenedor.

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

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

mountReadOnly mountReadOnly.
Volúmenes para montar solo lectura, el valor predeterminado es false.

Observaciones

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 dentro de él. La palabra clave container permite especificar las imágenes de contenedor.

contenedores de servicio ejecutar junto con un trabajo para proporcionar varias dependencias como bases de datos.

se admiten expresiones de plantilla para endpoint, volumes, portsy options propiedades 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

Consulte también

Definir recursos en el DE YAML