UniversalPackages@0 - Tarefa Universal packages v0

Use esta 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.

Insumos

command - de comando
string. Necessário. Valores permitidos: download, publish. Valor padrão: download.

Especifica o comando Universal Package a ser executado.

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

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

feedsToUse - de localização do feed
Alias de entrada: internalOrExternalDownload. string. Necessá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 - de conexão de organização/coleta
Alias de entrada: externalEndpoint. string. Opcional. Use quando internalOrExternalDownload = external && command = download.

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

vstsFeed - Feed
Alias de entrada: feedListDownload. string. Necessário quando internalOrExternalDownload = internal && command = download.

Inclui o feed selecionado. Você deve ter os Artefatos do Azure instalados e licenciados para selecionar um feed aqui. Especifica o FeedName para um feed com escopo da organização e projectName/FeedName ou ProjectID/FeedID para um feed com escopo de projeto.

vstsFeedPackage - Nome do pacote
Alias de entrada: packageListDownload. string. Necessá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. Necessário quando internalOrExternalDownload = internal && command = download.

Especifica a versão do pacote ou usa uma variável que contém a versão para download. 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 tiver sido criado em um projeto)
string. Necessá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, onde Project é o nome ou ID do projeto e Feed é o nome/ID do feed. Para feeds com escopo da organização, o valor deve ser apenas o nome do feed.

packageDownloadExternal - Nome do pacote
string. Necessário quando internalOrExternalDownload = external && command = download.

Especifica o nome do pacote a ser baixado.

versionDownloadExternal - Versão
string. Necessário quando internalOrExternalDownload = external && command = download.

Especifica a versão do pacote ou usa uma variável que contém a versão para download. 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. Os padrões curinga não são suportados com pacotes de pré-lançamento.

publishDirectory - Caminho do(s) arquivo(s) para publicar
string. Necessário quando command = publish. Valor padrão: $(Build.ArtifactStagingDirectory).

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

feedsToUsePublish - de localização do feed
Alias de entrada: internalOrExternalPublish. string. Necessá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 - de conexão de organização/coleta
Alias de entrada: externalEndpoints. string. Necessário quando internalOrExternalPublish = external && command = publish.

Especifica as credenciais a serem usadas para feeds externos.

vstsFeedPublish - Feed de destino
Alias de entrada: feedListPublish. string. Necessário quando internalOrExternalPublish = internal && command = publish.

Especifica o projeto e o nome/GUID do feed para publicação.

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

Associa os metadados desse pipeline de compilação/liberação (como run # e informações de código-fonte) ao pacote.

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

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

feedPublishExternal - Feed (ou Projeto/Feed se o feed tiver sido criado em um projeto)
string. Necessá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, onde Project é o nome ou ID do projeto e Feed é o nome do feed. Se o feed não foi criado em um projeto, o valor deve ser apenas o nome do feed.

packagePublishExternal - Nome do pacote
string. Necessá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. Necessário quando command = publish. Valores permitidos: major (Próximo maior), minor (Próximo menor), patch (Próximo patch) custom. Valor padrão: patch.

Especifica uma estratégia de incremento de versão. O valor custom para inserir a versão do pacote manualmente. 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 o de especificações de versionamento semântico do para obter mais informações.

versionPublish - Versão personalizada
string. Necessá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 - Verbosity
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 controlo de tarefas

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

Variáveis de saída

Nenhuma.

Comentários

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

Meu pipeline precisa acessar um feed em um projeto diferente

Se o pipeline estiver sendo executado em um projeto diferente do projeto que hospeda o feed, você deverá configurar o outro projeto para conceder acesso de leitura/gravação ao serviço de compilação. Consulte permissões de pacote no de Pipelines do Azure para obter mais detalhes.

Exemplos

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

Os Pacotes Universais são uma maneira útil de encapsular e fazer a 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.

Este pipeline de exemplo demonstra como buscar uma ferramenta de um feed em seu projeto. A tarefa Pacote Universal é usada para baixar a ferramenta, executar uma compilação e novamente usa a tarefa Pacote Universal para publicar todo o PWA GatsbyJS compilado em um feed como um Pacote Universal versionado.

Baixar um pacote com a tarefa Pacote Universal

A segunda tarefa no projeto de exemplo usa a tarefa Universal Package para buscar uma ferramenta, imagemagick, de um feed que está dentro de um projeto diferente na mesma organização. A ferramenta, imagemagick, é exigida pela etapa de construção 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 seu pipeline.

   

2. Clique na tarefa Universal Package recém-adicionada e no Command para .

3. Escolha o diretório Destino usar para o download da ferramenta.

4. Selecione uma fonte Feed que contenha a ferramenta, defina o nome do pacote e escolha Versão da ferramenta imagemagick noFeed de de origem.

   

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

   

6. O Universal Package construtor de tarefas gera YAML simplificado que contém valores não padrão. Copie o YAML gerado em seu arquivo azure-pipelines.yml na raiz do repositório git do seu 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 Gatsby pronto para produção que foi produzido pela etapa Run gatsby build para um feed como um Pacote Universal versionado. Uma vez em um feed, você tem uma cópia permanente do seu site completo que pode ser implantada no provedor de hospedagem e iniciada com gatsby serve.

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

   

2. Defina o Command como Publish.

3. Defina Caminho para arquivo(s) para publicá no diretório que contém a package.jsondo seu projeto GatsbyJS.

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

   

5. Depois de preencher os campos obrigatórios, clique em Ver YAML.

6. Copie o YAML resultante para o arquivo azure-pipelines.yml como antes. O YAML para este 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'
   

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

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 em seu feed primeiro e, em seguida, promovê-lo para uma exibição.

Requerimentos

Exigência	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente, DeploymentGroup
Exigências	Nenhum
Capacidades	Esta tarefa não satisfaz quaisquer exigências 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 de tarefa	Embalagem