Partilhar via


resources.containers.container definition

Um recurso de contentor referencia uma imagem de contentor.

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.

Definições que referenciam esta definição: resources.containers

Propriedades

container cadeia. Necessário como primeira propriedade.
ID do contentor. Valores aceitáveis: [-_A-Za-z0-9]*.

image cadeia. Obrigatório.
Etiqueta de imagem de contentor.

type cadeia.
Tipo de registo, como ACR ou GCR.

triggerresources.containers.container.trigger.
Especifique nenhum para desativar, verdadeiro para acionar em todas as etiquetas de imagem ou utilize a sintaxe completa, conforme descrito nos exemplos seguintes.

endpoint cadeia.
ID do ponto final de serviço a ligar a um registo de contentor privado. As expressões de modelo são suportadas.

endpoint cadeia.
ID do ponto final de serviço a ligar a um registo de contentor privado.

env dicionário de cadeia.
Variáveis a mapear para o ambiente do contentor.

mapDockerSocketbooleano.
Defina este sinalizador como falso para forçar o agente a não configurar o volume /var/run/docker.sock nas tarefas de contentor.

options cadeia.
Opções para passar para o anfitrião do contentor. As expressões de modelo são suportadas.

options cadeia.
Opções para passar para o anfitrião do contentor.

ports lista de cadeias de carateres.
Portas a expor no contentor. As expressões de modelo são suportadas.

ports lista de cadeias de carateres.
Portas a expor no contentor.

volumes lista de cadeias de carateres.
Volumes a montar no contentor. As expressões de modelo são suportadas.

volumes lista de cadeias de carateres.
Volumes a montar no contentor.

mountReadOnlymountReadOnly.
Volumes para montar só de leitura, a predefinição é tudo falso.

azureSubscription cadeia.
Subscrição do Azure (ligação do serviço ARM) para o registo de contentor.

resourceGroup cadeia.
Grupo de recursos do ACR.

registry cadeia.
Registo para imagens de contentor.

repository cadeia.
Nome do repositório de imagens de contentor no ACR.

localImagebooleano.
Quando verdadeiro, utiliza uma imagem com etiqueta local em vez de utilizar docker pull para obter a imagem. A predefinição é false.

Esta propriedade é útil apenas para agentes autoalojados onde a imagem já está presente no computador do agente.

Observações

As tarefas de contentor permitem isolar as suas ferramentas e dependências dentro de um contentor.

O agente inicia uma instância do contentor especificado e, em seguida, executa os passos dentro do mesmo. A container palavra-chave permite-lhe especificar as imagens de contentor.

Os contentores de serviço são executados juntamente com uma tarefa para fornecer várias dependências, como bases de dados.

As expressões de modelo são suportadas para endpointas propriedades , volumes, portse options de um recurso de contentor num pipeline YAML.

Exemplos

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

Ver também

Definir recursos no YAML