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.
trigger
resources.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.
mapDockerSocket
booleano.
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.
mountReadOnly
mountReadOnly.
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.
localImage
booleano.
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 endpoint
as propriedades , volumes
, ports
e 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