Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Faça upload de tarefas de pipeline personalizadas ou padrão para sua organização do Azure DevOps ou a coleção de projetos do Azure DevOps Server usando a CLI do Node para Azure DevOps (tfx-cli).
Importante
Quando você carrega tarefas in-the-box em uma instância do Servidor do Azure DevOps, alguns recursos de tarefa podem não ter suporte devido à versão do agente ou à falta de suporte no lado do servidor.
Para obter mais informações sobre tfx-cli, consulte a CLI do Node para Azure DevOps no GitHub.
Pré-requisitos
| Categoria | Requirements |
|---|---|
| Permissões | Associação ao grupo Administradores do Pool de Agentes no nível da organização ou da coleção. Consulte grupos de segurança, contas de serviço e permissões. |
| Tokens | Um PAT (token de acesso pessoal) com o escopo pools de agentes (ler e gerenciar) ou um token do Microsoft Entra. Os tokens Entra são recomendados em vez de PATs para melhor segurança. |
| Ferramentas |
Versão mais recente do Node.js e do tfx-cli instalados globalmente: npm install -g tfx-cli |
Entrar com tfx-cli
Entre no Azure DevOps usando o tfx-cli antes de carregar tarefas. Para obter mais opções de autenticação, consulte a autenticação da CLI multiplataforma para o Azure DevOps.
Execute o seguinte comando e forneça a URL de serviço e o PAT quando solicitado:
tfx login
Use a URL de serviço que corresponde ao seu ambiente:
| Ambiente | Formato de URL |
|---|---|
| Azure DevOps Services | https://dev.azure.com/{organization} |
| Azure DevOps Server | http://{server}:{port}/DefaultCollection |
Carregar tarefas
Dica
Se você precisar atualizar as tarefas de pipeline integradas, poderá clonar o repositório azure-pipelines-tasks. Em seguida, crie as tarefas necessárias seguindo a diretriz : como criar tarefas.
Carregue uma tarefa usando tfx-cli:
tfx build tasks upload --task-path <PATH_TO_TASK>
PATH_TO_TASK é o caminho para a pasta que contém a tarefa compilada, incluindo task.json.
Importante
Agentes de pipeline armazenam em cache as tarefas por versão. Se você modificar uma tarefa e carregá-la novamente com o mesmo número de versão, os agentes continuarão a usar a cópia armazenada em cache. Sempre incremente pelo menos a versão patch em task.json antes de carregar uma tarefa atualizada.
Verificar o carregamento
Confirme se sua tarefa foi carregada com êxito:
tfx build tasks list
A saída lista todas as tarefas no servidor, incluindo o id, name e version de cada tarefa.
Excluir uma tarefa
Remova uma tarefa carregada especificando sua ID. Obtenha a ID da tarefa da tfx build tasks list saída.
tfx build tasks delete --task-id <TASK_ID>
Aviso
Excluir uma tarefa a removerá do servidor. Qualquer pipeline que faça referência à tarefa excluída falhará na próxima execução.
Solução de problemas
| Erro | Motivo | Corrigir |
|---|---|---|
| 401 Não autorizado | O PAT expirou, foi revogado ou está ausente do escopo de |
Crie um NOVO PAT com o escopo correto. |
| 403 Proibido | Sua conta não está no grupo Administradores do Pool de Agentes . | Peça a um administrador da organização para adicioná-lo. |
| A tarefa já existe | Carreguei a mesma versão que já está no servidor. | Atualize a versão do patch em task.json e faça upload novamente. |
Para obter mais informações sobre tfx-cli, consulte a documentação da CLI do Node para Azure DevOps.