tarefa UniversalPackages@0 - Pacotes universais v0

Use essa tarefa para baixar ou empacotar e publicar Pacotes Universais.

Sintaxe

# Universal packages v0
# Download or publish Universal Packages.
- task: UniversalPackages@0
  inputs:
    command: 'download' # 'download' | 'publish'. Required. Command. Default: download.
    downloadDirectory: '$(System.DefaultWorkingDirectory)' # string. Required when command = download. Destination directory. Default: $(System.DefaultWorkingDirectory).
    #publishDirectory: '$(Build.ArtifactStagingDirectory)' # string. Required when command = publish. Path to file(s) to publish. Default: $(Build.ArtifactStagingDirectory).
  # Feed & package details
    feedsToUse: 'internal' # 'internal' | 'external'. Alias: internalOrExternalDownload. Required when command = download. Feed location. Default: internal.
    #externalFeedCredentials: # string. Alias: externalEndpoint. Optional. Use when internalOrExternalDownload = external && command = download. organization/collection connection. 
    #vstsFeed: # string. Alias: feedListDownload. Required when internalOrExternalDownload = internal && command = download. Feed. 
    #vstsFeedPackage: # string. Alias: packageListDownload. Required when internalOrExternalDownload = internal && command = download. Package name. 
    #vstsPackageVersion: # string. Alias: versionListDownload. Required when internalOrExternalDownload = internal && command = download. Version. 
    #feedDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Feed (or Project/Feed if the feed was created in a project). 
    #packageDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Package name. 
    #versionDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Version. 
  # Feed & package details
    #feedsToUsePublish: 'internal' # 'internal' | 'external'. Alias: internalOrExternalPublish. Required when command = publish. Feed location. Default: internal.
    #publishFeedCredentials: # string. Alias: externalEndpoints. Required when internalOrExternalPublish = external && command = publish. organization/collection connection. 
    #vstsFeedPublish: # string. Alias: feedListPublish. Required when internalOrExternalPublish = internal && command = publish. Destination Feed. 
    #vstsFeedPackagePublish: # string. Alias: packageListPublish. Required when internalOrExternalPublish = internal && command = publish. Package name. 
    #feedPublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Feed (or Project/Feed if the feed was created in a project). 
    #packagePublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Package name. 
    #versionOption: 'patch' # 'major' | 'minor' | 'patch' | 'custom'. Alias: versionPublishSelector. Required when command = publish. Version. Default: patch.
    #versionPublish: # string. Required when versionPublishSelector = custom && command = publish. Custom version. 
    #packagePublishDescription: # string. Optional. Use when command = publish. Description. 
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && internalOrExternalPublish = internal. Publish pipeline metadata. Default: true.
    #verbosity: 'None' # 'None' | 'Trace' | 'Debug' | 'Information' | 'Warning' | 'Error' | 'Critical'. Verbosity. Default: None.
  # Output
    #publishedPackageVar: # string. Optional. Use when command = publish. Package Output Variable.

Entradas

command - Comando
string. Obrigatórios. Valores Permitidos: download e publish. Valor padrão: download.

Especifica o comando NuGet a ser executado.

downloadDirectory - Diretório de destino
string. Obrigatório quando command = download. Valor padrão: $(System.DefaultWorkingDirectory).

Especifica o caminho da pasta em que a tarefa baixa o conteúdo do pacote.

feedsToUse - Local do feed
Alias de entrada: internalOrExternalDownload. string. Obrigatório quando command = download. Valores permitidos: internal (Esta organização/coleção) external (Outra organização/coleção). Valor padrão: internal.

Especifica um feed desta coleção ou de outra coleção no Azure Artifacts.

externalFeedCredentials - conexão de organização/coleção
Alias de entrada: externalEndpoint. string. Opcional. Use quando internalOrExternalDownload = external && command = download.

Especifica as credenciais a serem usadas para registros externos localizados no selecionado NuGet.config. Para feeds nesta organização ou coleção, deixe isso em branco; As credenciais do build são usadas automaticamente.

vstsFeed - Alimentar
Alias de entrada: feedListDownload. string. Obrigatório quando internalOrExternalDownload = internal && command = download.

Inclui o feed selecionado. Você deve ter o Azure Artifacts instalado e licenciado para selecionar um feed aqui. Especifica o FeedName para um feed no escopo da organização e projectName/FeedName ou ProjectID/FeedID para um feed no escopo do projeto.

vstsFeedPackage - Nome do pacote
Alias de entrada: packageListDownload. string. Obrigatório quando internalOrExternalDownload = internal && command = download.

Especifica o nome do pacote para a tarefa a ser baixada.

vstsPackageVersion - Versão
Alias de entrada: versionListDownload. string. Obrigatório quando internalOrExternalDownload = internal && command = download.

Especifica a versão do pacote ou usa uma variável que contém a versão a ser baixada. Essa entrada também pode ser uma expressão curinga, como *, para obter a versão mais alta. Exemplos: 1.* obtém a versão mais alta com a versão principal 1 e 1.2.* obtém a versão de patch mais alta com a versão principal 1 e a versão secundária 2.

feedDownloadExternal - Feed (ou Projeto/Feed se o feed foi criado em um projeto)
string. Obrigatório quando internalOrExternalDownload = external && command = download.

Especifica um feed em outra organização/coleção.

Para feeds com escopo de projeto, o valor deve ser Project/Feed, em que Project é o nome ou a ID do projeto e Feed é o nome/ID do feed. Para feeds no escopo da organização, o valor deve ser apenas o nome do feed.

packageDownloadExternal - Nome do pacote
string. Obrigatório quando internalOrExternalDownload = external && command = download.

Especifica o nome do pacote a ser baixado.

versionDownloadExternal - Versão
string. Obrigatório quando internalOrExternalDownload = external && command = download.

Especifica a versão do pacote ou usa uma variável que contém a versão a ser baixada. Essa entrada também pode ser uma expressão curinga, como *, para obter a versão mais alta. Exemplos: 1.* obtém a versão mais alta com a versão principal 1 e 1.2.* obtém a versão de patch mais alta com a versão principal 1 e a versão secundária 2. Não há suporte para padrões curinga com pacotes de pré-lançamento.

publishDirectory - Caminho para o(s) (s) arquivo(s) a ser publicado
string. Obrigatório quando command = publish. Valor padrão: $(Build.ArtifactStagingDirectory).

Especifica o caminho para a lista de arquivos a serem publicados.

feedsToUsePublish - Local do feed
Alias de entrada: internalOrExternalPublish. string. Obrigatório quando command = publish. Valores permitidos: internal (Esta organização/coleção) external (Outra organização/coleção). Valor padrão: internal.

Especifica um feed desta coleção ou de outra coleção no Azure Artifacts.

publishFeedCredentials - conexão de organização/coleção
Alias de entrada: externalEndpoints. string. Obrigatório quando internalOrExternalPublish = external && command = publish.

Especifica as credenciais a serem usadas para feeds externos.

vstsFeedPublish - Feed de Destino
Alias de entrada: feedListPublish. string. Obrigatório quando internalOrExternalPublish = internal && command = publish.

Especifica o projeto e o nome/GUID do feed no qual publicar.

publishPackageMetadata - Publicar metadados de pipeline
boolean. Opcional. Use quando command = publish && internalOrExternalPublish = internal. Valor padrão: true.

Associa os metadados desse pipeline de build/lançamento (como a execução nº e as informações do código-fonte) ao pacote.

vstsFeedPackagePublish - Nome do pacote
Alias de entrada: packageListPublish. string. Obrigatório quando internalOrExternalPublish = internal && command = publish.

Especifica uma ID de pacote para publicar ou criar uma nova ID de pacote se você nunca publicou uma versão desse pacote antes. Os nomes de pacote devem ser minúsculos e só podem usar letras, números e traços (-).

feedPublishExternal - Feed (ou Projeto/Feed se o feed foi criado em um projeto)
string. Obrigatório quando internalOrExternalPublish = external && command = publish.

Especifica o nome do feed externo no qual publicar.

Se o feed foi criado em um projeto, o valor deve ser Project/Feed, em que Project é o nome ou a ID do projeto e Feed é o nome do feed. Se o feed não tiver sido criado em um projeto, o valor deverá ser apenas o nome do feed.

packagePublishExternal - Nome do pacote
string. Obrigatório quando internalOrExternalPublish = external && command = publish.

Especifica o nome do pacote ao publicar em um feed externo.

versionOption - Versão
Alias de entrada: versionPublishSelector. string. Obrigatório quando command = publish. Valores permitidos: major (próximo principal), minor (próximo secundário), patch (próximo patch), custom. Valor padrão: patch.

Especifica uma estratégia de incremento de versão. O custom valor a ser inserido manualmente na versão do pacote. Para novos pacotes, a primeira versão será 1.0.0 se você especificar major, 0.1.0 se especificar minorou 0.0.1 se especificar patch. Consulte a Especificação de controle de versão semântico para obter mais informações.

versionPublish - Versão personalizada
string. Obrigatório quando versionPublishSelector = custom && command = publish.

Especifica um esquema de versão personalizado para o pacote.

packagePublishDescription - Descrição
string. Opcional. Use quando command = publish.

Especifica a descrição do conteúdo do pacote e/ou as alterações feitas nesta versão do pacote.

verbosity - Verbosidade
string. Valores permitidos: None, Trace, Debug, Information, Warning, Error, . Critical Valor padrão: None.

Especifica a quantidade de detalhes exibidos na saída.

publishedPackageVar - Variável de saída do pacote
string. Opcional. Use quando command = publish.

Especifica um nome para a variável que conterá o nome e a versão do pacote publicados.

Opções de controle da tarefa

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

Variáveis de saída

Nenhum.

Comentários

Use essa tarefa para baixar ou empacotar e publicar Pacotes Universais.

Meu pipeline precisa acessar um feed em um projeto diferente

Se o pipeline estiver em execução em um projeto diferente do projeto que hospeda o feed, você precisará configurar o outro projeto para permitir o acesso de leitura/gravação ao serviço de build. Confira Permissões de pacote no Azure Pipelines para obter mais detalhes.

Exemplos

A maneira mais simples de começar a usar a tarefa Pacote Universal é usar o editor de tarefas pipelines para gerar o YAML. Em seguida, você pode copiar o código gerado no arquivo do projeto azure-pipelines.yml. Neste exemplo, a amostra demonstra como gerar rapidamente o YAML usando um pipeline que cria um PWA (aplicativo Web progressivo) GatsbyJS.

Os Pacotes Universais são um modo útil de encapsular e versão de um aplicativo Web. Empacotar um aplicativo Web em um Pacote Universal permite reversões rápidas para uma versão específica do seu site e elimina a necessidade de criar o site no pipeline de implantação.

Esse pipeline de exemplo demonstra como buscar uma ferramenta de um feed em seu projeto. A tarefa Pacote Universal é usada para baixar a ferramenta, executar um build e novamente usa a tarefa Pacote Universal para publicar todo o PWA do GatsbyJS compilado em um feed como um Pacote Universal com versão.

Baixar um pacote com a tarefa Pacote Universal

A segunda tarefa no projeto de exemplo usa a tarefa Pacote Universal para buscar uma ferramenta, imagemagick, de um feed que está dentro de um projeto diferente na mesma organização. A ferramenta imagemagick é exibida pela etapa de build subsequente para redimensionar imagens.

1. Adicione a tarefa Pacote Universal clicando no ícone de adição, digitando "universal" na caixa de pesquisa e clicando no botão Adicionar para adicionar a tarefa ao pipeline.

   

2. Clique na tarefa Pacote Universal recém-adicionada e no Comando para Download.

3. Escolha o Diretório de destino a ser usado para o download da ferramenta.

4. Selecione um Feed de origem que contenha a ferramenta, defina o Nome do pacote e escolha Versão da ferramenta imagemagick no Feed de origem.

   

5. Depois de concluir os campos, clique em Exibir YAML para ver o YAML gerado.

   

6. O construtor de tarefas Pacote Universal gera YAML simplificado que contém valores não padrão. Copie o YAML gerado em seu azure-pipelines.yml arquivo na raiz do repositório git do projeto.

   # Download Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal download'
     inputs:
       downloadDirectory: Application
       vstsFeed: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000001'
       vstsFeedPackage: imagemagick
       vstsPackageVersion: 1.0.0
   

Publicar um pacote com a tarefa Pacote Universal

A última etapa neste pipeline de exemplo usa a tarefa Pacote Universal para carregar o PWA do Gatsby pronto para produção produzido pela etapa Run gatsby build para um feed como um Pacote Universal com versão. Uma vez em um feed, você tem uma cópia permanente do site completo que pode ser implantada no provedor de hospedagem e iniciada com gatsby serve.

1. Adicione outra tarefa pacote universal ao final do pipeline clicando no ícone de adição, digitando "universal" na caixa de pesquisa e clicando no botão Adicionar para adicionar a tarefa ao pipeline. Essa tarefa reúne todos os ativos prontos para produção produzidos pela etapa Run gatsby build, produz um Pacote Universal com versão e publica o pacote em um feed.

   

2. Defina o Comando como Publish.

3. Defina Caminho para arquivo(s) para publicar no diretório que contém o projeto GatsbyJS.package.json

4. Escolha um feed de destino, um nome de pacote e defina sua estratégia de controle de versão.

   

5. Depois de concluir os campos necessários, clique em Exibir YAML.

6. Copie o YAML resultante para seu arquivo azure-pipelines.yml como antes. O YAML desse projeto de exemplo é exibido abaixo.

   # Publish Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal publish'
     inputs:
       command: publish
       publishDirectory: Application
       vstsFeedPublish: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000002' # You can also use '<projectName>/<feedName>' instead of the GUIDs
       vstsFeedPackagePublish: mygatsbysite
       packagePublishDescription: 'A test package'
   

Esse exemplo demonstrou como usar o construtor de tarefas Pipelines para gerar rapidamente o YAML para a tarefa Pacote Universal, que pode ser colocada em seu arquivo azure-pipelines.yml. O construtor de tarefas Pacote Universal dá suporte a todas as configurações avançadas que podem ser criadas com os argumentos da tarefa Pacote Universal.

Observação

Não há suporte para a publicação de um pacote diretamente em um modo de exibição no Azure Artifacts. Você deve publicar o pacote no feed primeiro e, em seguida, promovê-lo a uma exibição.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Executa em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	2.144.0 ou superior
Categoria da tarefa	Pacote