definition "resources.containers.container"

Eine Containerressource verweist auf ein Containerimage.

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.

Definitionen, die auf diese Definition verweisen: resources.containers

Eigenschaften

container Zeichenfolge. Erforderlich als erste Eigenschaft.
-ID für den Container. Zulässige Werte: [-_A-Za-z0-9]*.

image Zeichenfolge. Erforderlich.
Containerimagetag.

type Zeichenfolge.
Typ der Registrierung wie ACR oder GCR.

trigger resources.containers.container.trigger.
Angeben, dass keine deaktiviert werden soll, "true", um für alle Bildtags auszulösen, oder verwenden Sie die vollständige Syntax, wie in den folgenden Beispielen beschrieben.

endpoint Zeichenfolge.
ID des Dienstendpunkts, der eine Verbindung mit einer privaten Containerregistrierung herstellt. Vorlagenausdrücke werdenunterstützt.

env Zeichenfolgenwörterbuch.
Variablen, die in der Umgebung des Containers zugeordnet werden sollen.

mapDockerSocket booleschen.
Legen Sie dieses Kennzeichen auf "false" fest, um zu erzwingen, dass der Agent das Volume "/var/run/docker.sock" für Containeraufträge nicht einrichten kann.

options Zeichenfolge.
Optionen, die an containerhost übergeben werden sollen. Vorlagenausdrücke werdenunterstützt.

ports Zeichenfolgenliste.
Ports, die für den Container verfügbar gemacht werden sollen. Vorlagenausdrücke werdenunterstützt.

volumes Zeichenfolgenliste.
Volumes, die auf dem Container bereitgestellt werden sollen. Vorlagenausdrücke werdenunterstützt.

mountReadOnly mountReadOnly.
Volumes, die schreibgeschützt bereitgestellt werden sollen, ist der Standardwert "false".

azureSubscription Zeichenfolge.
Azure-Abonnement (ARM-Dienstverbindung) für die Containerregistrierung.

resourceGroup Zeichenfolge.
Ressourcengruppe für Ihr ACR.

registry Zeichenfolge.
Registrierung für Containerimages.

repository Zeichenfolge.
Name des Containerimage-Repositorys in ACR.

localImage booleschen.
Wenn dies der Fall ist, verwendet ein lokal markiertes Image, anstatt docker pull zum Abrufen des Images zu verwenden. Der Standardwert ist "false".

Diese Eigenschaft ist nur für selbst gehostete Agents nützlich, bei denen das Image bereits auf dem Agentcomputer vorhanden ist.

Bemerkungen

Containeraufträge es Ihnen ermöglichen, Ihre Tools und Abhängigkeiten innerhalb eines Containers zu isolieren.

Der Agent startet eine Instanz Ihres angegebenen Containers und führt danach Schritte darin aus. Mit dem Schlüsselwort container können Sie Ihre Containerimages angeben.

Dienstcontainer zusammen mit einem Auftrag ausgeführt werden, um verschiedene Abhängigkeiten wie Datenbanken bereitzustellen.

Vorlagenausdrücke werden für endpoint, volumes, portsund options Eigenschaften einer Containerressource in einer YAML-Pipeline unterstützt.

Beispiele

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

Siehe auch

Definieren von Ressourcen in YAML-