Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022
Carregue tarefas personalizadas ou de pipeline pré-definidas para a sua organização Azure DevOps ou para a coleção de projetos do Azure DevOps Server, usando o tfx-cli (Node CLI para Azure DevOps).
Importante
Quando carregar tarefas integradas para uma instância do Azure DevOps Server, algumas funcionalidades de tarefa podem não ser suportadas devido à versão do agente ou à falta de suporte do lado do servidor.
Para obter mais informações sobre tfx-cli, consulte a CLI do Node de para o Azure DevOps no GitHub.
Pré-requisitos
| Categoria | Requerimentos |
|---|---|
| Permissões | Participação no grupo de Administradores do Pool de Agentes ao nível da organização ou da coleção. Consulte Grupos de Segurança, contas de serviço e permissões. |
| Tokens | Um token de acesso pessoal (PAT) com o âmbito Agent Pools (Read & manage), ou um token Microsoft Entra. Os tokens Entra são recomendados em vez dos PATs para maior segurança. |
| Tools |
Versão mais recente do Node.js e tfx-cli instalada globalmente: npm install -g tfx-cli |
Iniciar sessão com tfx-cli
Inicie sessão no Azure DevOps usando tfx-cli antes de carregar tarefas. Para mais opções de autenticação, veja Autenticação CLI multiplataforma para Azure DevOps.
Execute o seguinte comando e forneça o URL do serviço e o PAT quando solicitado:
tfx login
Use a URL do serviço que corresponda ao seu ambiente:
| Meio Ambiente | Formato do URL |
|---|---|
| Serviços de DevOps do Azure | https://dev.azure.com/{organization} |
| Azure DevOps Server | http://{server}:{port}/DefaultCollection |
Tarefas de upload
Dica
Se precisar de atualizar as tarefas pré-definidas do pipeline, pode clonar o repositório azure-pipelines-tasks. Depois, constrói as tarefas necessárias seguindo as orientações – como construir 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
Os agentes do pipeline armazenam em cache as tarefas por versão. Se modificares uma tarefa e a voltares a carregar com o mesmo número de versão, os agentes continuam a usar a cópia em cache. Adiciona sempre pelo menos a versão task.json do patch antes de carregares uma tarefa atualizada.
Verifique o upload
Confirme que a sua tarefa foi carregada com sucesso:
tfx build tasks list
A saída lista todas as tarefas no servidor, incluindo o id, o name e o version de cada tarefa.
Eliminar uma tarefa
Remova uma tarefa carregada especificando o seu ID. Obtenha o ID da tarefa a partir da tfx build tasks list saída.
tfx build tasks delete --task-id <TASK_ID>
Advertência
Eliminar uma tarefa remove-a do servidor. Qualquer pipeline que faça referência à tarefa eliminada falha na próxima execução.
Troubleshooting
| Erro | Motivo | Corrigir |
|---|---|---|
| 401 Não Autorizado | O PAT expirou, foi revogado ou não tem as permissões do Pool de Agentes (Ler e gerir). | Crie um novo PAT com o âmbito correto. |
| 403 Proibido | A tua conta não está no grupo de Administradores do Pool de Agentes . | Pede a um administrador da organização para te adicionar. |
| A tarefa já existe | Carreguei a mesma versão que já está no servidor. | Aumenta a versão de patch em task.json e faz upload novamente. |
Para mais informações sobre tfx-cli, consulte o Node CLI para documentação Azure DevOps.