Compartilhar via

Carregar tarefas na coleção de projetos

  • Artigo

Azure DevOps Services

Aprenda a carregar tarefas na organização para tarefas personalizadas ou tarefas prontas para uso no Azure DevOps usando o Node CLI para Azure DevOps (tfx-cli).

Por exemplo, essa diretriz pode ajudar a atualizar tarefas "pré-configuradas" no Azure DevOps Server.

Importante

Ao carregar tarefas integradas em uma instância local, alguns recursos de tarefa podem não ter suporte devido à versão antiga do agente ou à falta de suporte pelo Servidor Azure DevOps.

Para obter mais informações sobre tfx-cli, consulte a CLI do Node para Azure DevOps no GitHub.

Pré-requisitos

Para carregar tarefas na coleção de projetos, você precisa de pré-requisitos:

  • A versão mais recente do Node.js.

  • A CLI do Nó para o Azure DevOps para carregar tarefas.

    • Instalar a tfx-cli usando npm, um componente de Node.js executando:
      npm install -g tfx-cli

  • Permissões para atualizar a coleção de projetos necessária, PAT gerado com escopo Ambiente (Leitura e Gravação) para poder carregar tarefas na coleção de projetos.

    Importante

    É recomendável usar tokens do Microsoft Entra. Para obter mais informações sobre nossos esforços para reduzir o uso do PAT, consulte nosso blog. Examine nossas diretrizes de autenticação para escolher o mecanismo de autenticação apropriado para suas necessidades.

Entrar no Tfx-cli com o token de acesso pessoal

Entre no Azure DevOps com tfx-cli para carregar tarefas de pipeline na coleção de projetos.

Importante

Um token de acesso pessoal é exigido por padrão para autenticação na coleção de projetos no Azure DevOps. Criar PAT (token de acesso pessoal) com escopo de Ambiente (Leitura e Gerenciamento). Você pode usar outras maneiras de autorizar com tfx-cli. Para obter mais informações, consulte Autenticar na CLI multiplataforma para o Azure DevOps.

Para entrar, especifique o caminho para a coleção de projetos como URL. O nome padrão da coleção de projetos é DefaultCollection.

Para o Azure DevOps Services, o caminho para a coleção de projetos teria o seguinte formato: https://{Azure DevOps organization name}.visualstudio.com/DefaultCollection

Para o Azure DevOps Server, a URL de coleção de projetos padrão depende da localização do servidor de URL e do modelo: http://{Azure DevOps Server url}/DefaultCollection

Insira o seguinte comando e forneça informações solicitadas:

~$ tfx login

Carregando tarefas para a coleção de projetos

Dica

Se você precisar atualizar as tarefas de pipeline na caixa, poderá clonar o repositório azure-pipelines-tasks e criar tarefas necessárias seguindo a diretriz – como criar tarefas.

Agora você pode começar a enviar a tarefa usando tfx-cli.

Insira o seguinte comando:

tfx build tasks upload --task-path <PATH_TO_TASK>

Nota

PATH_TO_TASK é o caminho para a pasta com a tarefa compilada. Para obter mais informações sobre como usar a tfx-cli, consulte Documentação do Nó da CLI para Azure DevOps.