Compartilhar via


Definição de jobs.job.container

Trabalhos de contêiner permitem que você execute trabalhos em um contêiner em vez do host do agente.

Definições que fazem referência a essa definição: de pipeline, jobs.job, jobs.deployment

Implementações

Implementação Descrição
contêiner: de cadeia de caracteres Especifique o contêiner de trabalho por alias.
contêiner: de imagem Especifique o contêiner de trabalho usando opções e marca de imagem.

contêiner: cadeia de caracteres

Especifique o contêiner de trabalho por alias.

container: string # Specify job container by alias.

container cadeia de caracteres.

Especifique o contêiner de trabalho por alias.

Observações

O alias pode ser o nome de uma imagem ou pode ser uma referência a um recurso de contêiner .

Exemplos

O exemplo a seguir busca a imagem do ubuntu marcada como 18.04 de hub do Docker e, em seguida, inicia o contêiner. Quando o comando printenv é executado, ele acontece dentro do contêiner ubuntu:18.04.

pool:
  vmImage: 'ubuntu-18.04'

container: ubuntu:18.04

steps:
- script: printenv

contêiner: imagem

Especifique o contêiner de trabalho usando opções e marca de imagem.

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.

Propriedades

image cadeia de caracteres. Obrigatório
marca de imagem contêiner.

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

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

mapDockerSocket booliano.
Definir 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 cadeia de caracteres.
Opções para passar para o host de contêiner.

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.

mountReadOnly somente leitura montada.
Volumes para montar somente leitura, o padrão é tudo falso.

Exemplos

Use options para configurar a inicialização do contêiner.

container:
  image: ubuntu:18.04
  options: --hostname container-test --ip 192.168.0.1

steps:
- script: echo hello

No exemplo a seguir, os contêineres são definidos na seção de recursos. Cada contêiner é referenciado posteriormente, referindo-se ao alias atribuído.

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

Consulte também