Compartilhar via


JenkinsDownloadArtifacts@1 – Tarefa de download de artefatos v1 do Jenkins

Use essa tarefa para baixar artefatos produzidos por um trabalho do Jenkins.

Sintaxe

# Jenkins download artifacts v1
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@1
  inputs:
    jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type. 
    saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
  # Advanced
    jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
    #jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
    #itemPattern: '**' # string. Item Pattern. Default: **.
    #downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
    #startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from. 
    #artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName. 
  # Propagated Artifacts
    #propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
    #artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
    #ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription. 
    #storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name. 
    #containerName: # string. Required when propagatedArtifacts == true. Container Name. 
    #commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.

Entradas

jenkinsServerConnection - de conexão de serviço do Jenkins
Alias de entrada: serverEndpoint. string. Obrigatório

Especifica a conexão de serviço para sua instância do Jenkins. Para criar uma nova conexão de serviço, clique no link Gerenciar.


jobName - nome do trabalho
string. Obrigatório

Especifica o nome do trabalho jenkins do qual baixar artefatos. Isso deve corresponder exatamente ao nome do trabalho no servidor Jenkins.


jenkinsJobType - tipo de trabalho jenkins
string. Opcional. Use quando jobName = invalidjobName.

Especifica automaticamente o tipo de trabalho Jenkins.


saveTo - Salvar em
string. Obrigatório Valor padrão: jenkinsArtifacts.

Especifica o diretório em que os artefatos jenkins são baixados e salvos. Esse diretório será criado se ele não existir.


jenkinsBuild - Baixar artefatos produzidos pelo
string. Obrigatório Valores permitidos: LastSuccessfulBuild (última compilação bem-sucedida), BuildNumber (número de build). Valor padrão: LastSuccessfulBuild.

Baixa artefatos produzidos pela última compilação bem-sucedida ou de uma instância de build específica.


jenkinsBuildNumber - número de build do Jenkins
string. Necessário quando jenkinsBuild == BuildNumber. Valor padrão: 1.

Baixa artefatos produzidos por essa compilação.


itemPattern - padrão de item
string. Valor padrão: **.

Especifica os arquivos a serem baixados como um padrão de minimatch de várias linhas. Mais informações sobre padrões de correspondência de arquivos.

O padrão padrão ** baixa todos os arquivos em todos os artefatos produzidos pelo trabalho do Jenkins. Para baixar todos os arquivos na queda do artefato, use drop/**.


downloadCommitsAndWorkItems - baixar commits e workitems
boolean. Valor padrão: false.

Permite baixar as confirmações e os detalhes do item de trabalho associados ao Trabalho jenkins.


startJenkinsBuildNumber - Baixar confirmações e itens de trabalho de
string. Opcional. Use quando downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber.

Inicia o número de build para baixar confirmações e itens de trabalho. Se fornecido, todos os commits e itens de trabalho entre o número de build inicial e o número de build fornecido como entrada para baixar artefatos são baixados.


artifactDetailsFileNameSuffix - de Nome de Arquivo de Confirmação e WorkItem
string. Opcional. Use quando downloadCommitsAndWorkItems == invalid.

Especifica o sufixo de nome de arquivo para commits e anexos de item de trabalho. Os anexos são criados com commits_{suffix}.json e workitem_{suffix}.json. Se essa entrada não for fornecida, os anexos serão criados com os nomes commits.json e workitems.json.


propagatedArtifacts - Artifacts são propagados para o do Azure
boolean. Valor padrão: false.

Use essa entrada se os artefatos jenkins forem propagados para o Azure. Para carregar artefatos jenkins no Azure, consulte este de plug-in do Jenkins.


artifactProvider - do Provedor de Artefatos
string. Necessário quando propagatedArtifacts == notValid. Valores permitidos: azureStorage (Armazenamento do Azure). Valor padrão: azureStorage.

Especifica o provedor de armazenamento externo usado no trabalho do Jenkins para carregar os artefatos.


ConnectedServiceNameARM - assinatura do Azure
string. Necessário quando propagatedArtifacts == true.

Especifica a assinatura do Azure Resource Manager para os artefatos.


storageAccountName - nome da conta de armazenamento
string. Necessário quando propagatedArtifacts == true.

Especifica contas de armazenamento do Azure Classic ou do Resource Manager. Selecione o nome da conta de armazenamento em que os artefatos são propagados.


de nome do contêiner containerName -
string. Necessário quando propagatedArtifacts == true.

Especifica o nome do contêiner na conta de armazenamento em que os artefatos são carregados.


commonVirtualPath - de caminho virtual comum
string. Opcional. Use quando propagatedArtifacts == true.

Especifica o caminho para os artefatos dentro do contêiner de armazenamento do Azure.


Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

Use essa tarefa para baixar artefatos produzidos por um trabalho do Jenkins.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.144.0 ou superior
Categoria de tarefa Utilidade
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente Todas as versões de agente com suporte.
Categoria de tarefa Utilidade