Partager via


définition resources.containers.container

Une ressource conteneur fait référence à une image conteneur.

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.
containers:
- container: string # Required as first property. Alias of the container.
  endpoint: string # ID of the service endpoint connecting to a private container registry.
  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.

Définitions qui font référence à cette définition : resources.containers

Propriétés

container String. Obligatoire comme première propriété.
ID du conteneur. Valeurs acceptables : [-_A-Za-z0-9]*.

image String. Obligatoire.
Balise d’image conteneur.

type String.
Type du registre comme ACR ou GCR.

triggerresources.containers.container.trigger.
Spécifiez aucun à désactiver, true pour déclencher sur toutes les balises d’image ou utilisez la syntaxe complète comme décrit dans les exemples suivants.

endpoint String.
ID du point de terminaison de service qui se connecte à un registre de conteneurs privé. Les expressions de modèle sont prises en charge.

endpoint String.
ID du point de terminaison de service qui se connecte à un registre de conteneurs privé.

env dictionnaire de chaînes.
Variables à mapper dans l’environnement du conteneur.

mapDockerSocketbooléen.
Définissez cet indicateur sur false pour forcer l’agent à ne pas configurer le volume /var/run/docker.sock sur les travaux de conteneur.

options String.
Options à passer à l’hôte de conteneur. Les expressions de modèle sont prises en charge.

options String.
Options à passer à l’hôte de conteneur.

ports liste de chaînes.
Ports à exposer sur le conteneur. Les expressions de modèle sont prises en charge.

ports liste de chaînes.
Ports à exposer sur le conteneur.

volumes liste de chaînes.
Volumes à monter sur le conteneur. Les expressions de modèle sont prises en charge.

volumes liste de chaînes.
Volumes à monter sur le conteneur.

mountReadOnlymountReadOnly.
Volumes à monter en lecture seule, la valeur par défaut est toutes false.

azureSubscription String.
Abonnement Azure (connexion au service ARM) pour le registre de conteneurs.

resourceGroup String.
Groupe de ressources pour votre ACR.

registry String.
Registre pour les images conteneur.

repository String.
Nom du référentiel d’images conteneur dans ACR.

localImagebooléen.
Quand la valeur est true, utilise une image étiquetée localement au lieu d’utiliser docker pull pour obtenir l’image. La valeur par défaut est false.

Cette propriété est utile uniquement pour les agents auto-hébergés où l’image est déjà présente sur l’ordinateur de l’agent.

Remarques

Les travaux de conteneur vous permettent d’isoler vos outils et dépendances à l’intérieur d’un conteneur.

L’agent lance une instance de votre conteneur spécifié, puis exécute les étapes à l’intérieur de celui-ci. Le container mot clé vous permet de spécifier vos images conteneur.

Les conteneurs de service s’exécutent en même temps qu’un travail pour fournir diverses dépendances telles que des bases de données.

Les expressions de modèle sont prises en charge pour endpointles propriétés , volumes, portset options d’une ressource de conteneur dans un pipeline YAML.

Exemples

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

Voir aussi

Définir des ressources dans YAML