Share via


definição resources.containers.container

Um recurso de contêiner faz referência a uma imagem de contêiner.

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 fazem referência a essa definição: resources.containers

Propriedades

container String. Obrigatório como primeira propriedade.
ID do contêiner. Valores aceitáveis: [-_A-Za-z0-9]*.

image String. Obrigatórios.
Marca de imagem de contêiner.

type String.
Tipo do registro, como ACR ou GCR.

triggerresources.containers.container.trigger.
Especifique nenhum para desabilitar, true para disparar em todas as marcas de imagem ou use a sintaxe completa, conforme descrito nos exemplos a seguir.

endpoint String.
ID do ponto de extremidade de serviço que se conecta a um registro de contêiner privado. Há suporte para expressões de modelo.

endpoint String.
ID do ponto de extremidade de serviço que se conecta a um registro de contêiner privado.

env dicionário de cadeia de caracteres.
Variáveis a serem mapeadas para o ambiente do contêiner.

mapDockerSocketbooliano.
Defina esse sinalizador como false para forçar o agente a não configurar o volume /var/run/docker.sock em trabalhos de contêiner.

options String.
Opções para passar para o host de contêiner. Há suporte para expressões de modelo.

options String.
Opções para passar para o host de contêiner.

ports lista de cadeias de caracteres.
Portas a serem expostas no contêiner. Há suporte para expressões de modelo.

ports lista de cadeias de caracteres.
Portas a serem expostas no contêiner.

volumes lista de cadeias de caracteres.
Volumes a serem montados no contêiner. Há suporte para expressões de modelo.

volumes lista de cadeias de caracteres.
Volumes a serem montados no contêiner.

mountReadOnlymountReadOnly.
Volumes para montar somente leitura, o padrão é tudo false.

azureSubscription String.
Assinatura do Azure (conexão de serviço arm) para registro de contêiner.

resourceGroup String.
Grupo de recursos para o ACR.

registry String.
Registro para imagens de contêiner.

repository String.
Nome do repositório de imagens de contêiner no ACR.

localImagebooliano.
Quando true, usa uma imagem marcada localmente em vez de usar o docker pull para obter a imagem. O padrão é false.

Essa propriedade é útil apenas para agentes auto-hospedados em que a imagem já está presente no computador do agente.

Comentários

Os trabalhos de contêiner permitem isolar suas ferramentas e dependências dentro de um contêiner.

O agente inicia uma instância do contêiner especificado e executa etapas dentro dela. A palavra-chave container permite que você especifique suas imagens de contêiner.

Os contêineres de serviço são executados junto com um trabalho para fornecer várias dependências, como bancos de dados.

As expressões de modelo têm suporte para endpointas propriedades , volumes, portse options de um recurso de contêiner em um 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

Confira também

Definir recursos no YAML