Carregar tarefas para a coleção de projetos

Serviços de DevOps do Azure

Saiba como enviar tarefas para sua organização, seja para tarefas personalizadas ou predefinidas no Azure DevOps, usando o Node CLI para Azure DevOps (tfx-cli).

Por exemplo, esta diretriz pode ajudar a atualizar tarefas prontas para uso no Servidor de DevOps do Azure.

Importante

Ao carregar tarefas pré-definidas para uma instância local, algumas funcionalidades das tarefas podem não ter suporte devido à versão antiga do agente ou à falta de suporte por parte do Azure DevOps Server.

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

Pré-requisitos

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

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

• O CLI do Node para o Azure DevOps para carregar tarefas.

  • Instale tfx-cli usando npm, um componente do Node.js, executando o seguinte comando:

    npm install -g tfx-cli
  

• É necessário ter permissões para atualizar a coleção de projetos, com um PAT gerado com o escopo Ambiente (Leitura & Gravação), para poder carregar tarefas na coleção de projetos.

  Importante

  Recomendamos os tokens Microsoft Entra mais seguros do que os tokens de acesso pessoal de maior risco. Saiba mais sobre os nossos esforços para reduzir a utilização de PAT. Reveja as nossas orientações de autenticação para escolher o mecanismo de autenticação certo para as suas necessidades.

Tfx-cli faça login com token de acesso pessoal

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

Importante

Um token de acesso pessoal é necessário por padrão para autenticação na coleção de projetos no Azure DevOps. Crie token de acesso pessoal (PAT) com escopo Ambiente (Ler & gerenciar). Você pode usar outras maneiras de autorizar com tfx-cli. Para obter mais informações, consulte Autenticar na CLI de plataforma cruzada 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 os Serviços de DevOps do Azure, o caminho para a coleção de projetos teria o seguinte formato: https://{Azure DevOps organization name}.visualstudio.com/DefaultCollection

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

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

~$ tfx login

Carregando tarefas para a coleção de projetos

Dica

Se precisar atualizar tarefas de pipeline in-the-box, pode clonar o repositório azure-pipelines-tasks e criar as tarefas necessárias seguindo as instruções em 'como construir tarefas'.

Agora podes começar a fazer o upload da tarefa usando tfx-cli.

Digite o seguinte comando:

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

Observação

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