jobs.job.container definition
Mit Containeraufträgen können Sie Aufträge in einem Container anstelle des Agenthosts ausführen.
Definitionen, die auf diese Definition verweisen: pipeline, jobs.job, jobs.deployment
Implementierungen
Implementierung | Beschreibung |
---|---|
Container: Zeichenfolge | Geben Sie den Auftragscontainer nach Alias an. |
Container: Image | Geben Sie den Auftragscontainer mithilfe des Imagetags und der Optionen an. |
Container: Zeichenfolge
Geben Sie den Auftragscontainer nach Alias an.
container: string # Specify job container by alias.
container
Schnur.
Geben Sie den Auftragscontainer nach Alias an.
Bemerkungen
Der Alias kann der Name eines Images oder ein Verweis auf eine Containerressource sein.
Beispiele
Im folgenden Beispiel wird das Ubuntu-Image 18.04 von Docker Hub abgerufen und dann der Container gestartet. Wenn der printenv
Befehl ausgeführt wird, geschieht er im Container ubuntu:18.04.
pool:
vmImage: 'ubuntu-18.04'
container: ubuntu:18.04
steps:
- script: printenv
Container: Image
Geben Sie den Auftragscontainer mithilfe des Imagetags und der Optionen an.
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.
Eigenschaften
image
Schnur. Erforderlich.
Containerimagetag.
endpoint
Schnur.
ID des Dienstendpunkts, der eine Verbindung mit einer privaten Containerregistrierung herstellt.
env
Zeichenfolgenwörterbuch.
Variablen, die der Umgebung des Containers zugeordnet werden sollen.
mapDockerSocket
Boolesch.
Legen Sie dieses Flag auf false fest, um zu erzwingen, dass der Agent das Volume /var/run/docker.sock nicht für Containeraufträge einrichten darf.
options
Schnur.
Optionen zum Übergeben an den Containerhost.
ports
Zeichenfolgenliste.
Ports, die für den Container verfügbar gemacht werden sollen.
volumes
Zeichenfolgenliste.
Volumes, die im Container bereitgestellt werden sollen.
mountReadOnly
mountReadOnly.
Volumes, die schreibgeschützt eingebunden werden sollen, ist der Standardwert false.
Container: Image
Geben Sie den Auftragscontainer mithilfe des Imagetags und der Optionen an.
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.
Eigenschaften
image
Schnur. Erforderlich.
Containerimagetag.
endpoint
Schnur.
ID des Dienstendpunkts, der eine Verbindung mit einer privaten Containerregistrierung herstellt.
env
Zeichenfolgenwörterbuch.
Variablen, die der Umgebung des Containers zugeordnet werden sollen.
mapDockerSocket
Boolesch.
Legen Sie dieses Flag auf false fest, um zu erzwingen, dass der Agent das Volume /var/run/docker.sock nicht für Containeraufträge einrichten darf.
options
Schnur.
Optionen zum Übergeben an den Containerhost.
ports
Zeichenfolgenliste.
Ports, die für den Container verfügbar gemacht werden sollen.
volumes
Zeichenfolgenliste.
Volumes, die im Container bereitgestellt werden sollen.
Container: Image
Geben Sie den Auftragscontainer mithilfe des Imagetags und der Optionen an.
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.
Eigenschaften
image
Schnur. Erforderlich.
Containerimagetag.
endpoint
Schnur.
ID des Dienstendpunkts, der eine Verbindung mit einer privaten Containerregistrierung herstellt.
env
Zeichenfolgenwörterbuch.
Variablen, die der Umgebung des Containers zugeordnet werden sollen.
options
Schnur.
Optionen zum Übergeben an den Containerhost.
ports
Zeichenfolgenliste.
Ports, die für den Container verfügbar gemacht werden sollen.
volumes
Zeichenfolgenliste.
Volumes, die im Container bereitgestellt werden sollen.
Beispiele
Verwenden Sie options
zum Konfigurieren des Containerstarts.
container:
image: ubuntu:18.04
options: --hostname container-test --ip 192.168.0.1
steps:
- script: echo hello
Im folgenden Beispiel werden die Container im Abschnitt „resources“ definiert. Auf jeden Container wird später verwiesen, indem auf den ihm zugewiesenen Alias verwiesen wird.
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