Compartilhar via


Carregar tarefas na coleção de projetos

Serviços do Azure DevOps

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

    Recomendamos os tokens mais seguros do Microsoft Entra em vez de tokens de acesso pessoal de maior risco. Saiba mais sobre nossos esforços para reduzir o uso do PAT. Examine nossas diretrizes de autenticação para escolher o mecanismo de autenticação correto 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.