définition jobs.job.container
Les travaux de conteneur vous permettent d’exécuter des travaux sur un conteneur au lieu de l’hôte de l’agent.
Définitions qui font référence à cette définition : pipeline, jobs.job, jobs.deployment
Implémentations
Implémentation | Description |
---|---|
conteneur : chaîne | Spécifiez le conteneur de travaux par alias. |
conteneur : image | Spécifiez le conteneur de travaux à l’aide d’une balise d’image et d’options. |
conteneur : chaîne
Spécifiez le conteneur de travaux par alias.
container: string # Specify job container by alias.
container
String.
Spécifiez le conteneur de travaux par alias.
Notes
L’alias peut être le nom d’une image ou une référence à une ressource de conteneur.
Exemples
L’exemple suivant extrait l’image ubuntu étiquetée 18.04 à partir de Docker Hub, puis démarre le conteneur. Lorsque la commande s’exécute printenv
, elle se produit à l’intérieur du conteneur ubuntu:18.04.
pool:
vmImage: 'ubuntu-18.04'
container: ubuntu:18.04
steps:
- script: printenv
conteneur : image
Spécifiez le conteneur de travaux à l’aide d’une balise d’image et d’options.
container:
image: string # Required. Container image tag.
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.
Propriétés
image
String. Obligatoire.
Balise d’image conteneur.
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.
mapDockerSocket
boolé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 à transmettre à l’hôte de conteneur.
ports
string list.
Ports à exposer sur le conteneur.
volumes
string list.
Volumes à monter sur le conteneur.
mountReadOnly
mountReadOnly.
Volumes à monter en lecture seule, la valeur par défaut est false.
conteneur : image
Spécifiez le conteneur de travaux à l’aide d’une balise d’image et d’options.
container:
image: string # Required. Container image tag.
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.
Propriétés
image
String. Obligatoire.
Balise d’image conteneur.
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.
mapDockerSocket
boolé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 à transmettre à l’hôte de conteneur.
ports
string list.
Ports à exposer sur le conteneur.
volumes
string list.
Volumes à monter sur le conteneur.
conteneur : image
Spécifiez le conteneur de travaux à l’aide d’une balise d’image et d’options.
container:
image: string # Required. Container image tag.
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
options: string # Options to pass into container host.
ports: [ string ] # Ports to expose on the container.
volumes: [ string ] # Volumes to mount on the container.
Propriétés
image
String. Obligatoire.
Balise d’image conteneur.
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.
options
String.
Options à transmettre à l’hôte de conteneur.
ports
string list.
Ports à exposer sur le conteneur.
volumes
string list.
Volumes à monter sur le conteneur.
Exemples
Utilisez options
pour configurer le démarrage du conteneur.
container:
image: ubuntu:18.04
options: --hostname container-test --ip 192.168.0.1
steps:
- script: echo hello
Dans l’exemple suivant, les conteneurs sont définis dans la section ressources. Chaque conteneur est ensuite référencé ultérieurement, en faisant référence à son alias attribué.
resources:
containers:
- container: u14
image: ubuntu:14.04
- container: u16
image: ubuntu:16.04
- container: u18
image: ubuntu:18.04
jobs:
- job: RunInContainer
pool:
vmImage: 'ubuntu-18.04'
strategy:
matrix:
ubuntu14:
containerResource: u14
ubuntu16:
containerResource: u16
ubuntu18:
containerResource: u18
container: $[ variables['containerResource'] ]
steps:
- script: printenv