Partilhar via


Registrar um agente usando o fluxo de código do dispositivo

Você pode registrar um agente usando o fluxo de código de dispositivo a partir da versão 3.227.1 do agente, especificando AAD quando solicitado o tipo de autenticação do agente.

Conceder ao usuário acesso ao pool de agentes

Antes de registrar um agente usando o fluxo de código de dispositivo, você deve conceder ao usuário desejado permissão para acessar o pool de agentes.

  1. Abra um navegador e navegue até a guia Pools de agentes para sua organização do Azure Pipelines.

    1. Inicie sessão na sua organização (https://dev.azure.com/{yourorganization}).

    2. Escolha Azure DevOps, Configurações da organização.

      Escolha Configurações da organização.

    3. Escolha Pools de agentes.

      Escolha a guia Pools de agentes.

  2. Selecione o pool de agentes desejado no lado direito da página e, em seguida, escolha Segurança. Escolha Adicionar e adicione o usuário com a função de Administrador .

    Captura de tela da guia de segurança do pool de agentes.

  3. Se a conta de usuário que você vai usar não for mostrada, peça a um administrador para adicioná-la, concedendo à conta a função de administrador para o pool de agentes. O administrador pode ser um administrador do pool de agentes, um proprietário da organização do Azure DevOps ou um administrador do TFS ou do Azure DevOps Server.

    Se for um agente de grupo de implantação, o administrador pode ser um administrador de grupo de implantação, um proprietário de organização do Azure DevOps ou um administrador do TFS ou do Azure DevOps Server.

    Você pode adicionar a conta desejada à função de administrador do grupo de implantação na guia Segurança na página Grupos de Implantação no Azure Pipelines.

Nota

Se vir uma mensagem como esta: Desculpe, não foi possível adicionar a identidade. Por favor, tente uma identidade diferente. ou Não é possível modificar a função para identidade própria. Tente com uma identidade diferente., você provavelmente seguiu as etapas acima para um proprietário da organização ou administrador do TFS ou do Azure DevOps Server. Você não precisa fazer nada; Você já tem permissão para administrar o pool de agentes.

Se você estiver adicionando a conta de usuário ao grupo de segurança do pool de agentes usando Configurações do Projeto, Pools de agentes, primeiro deverá adicionar a conta de usuário como um usuário da organização com nível de Acesso Básico (recomendado) ou superior.

Registrar o agente usando o fluxo de código do dispositivo

  1. Especifique AAD quando solicitado o tipo de autenticação durante a configuração do agente para usar uma entidade de serviço para autenticar durante o registro do agente. Você receberá um prompt semelhante à seguinte mensagem: Por favor, termine o fluxo de código do dispositivo no navegador (https://microsoft.com/devicelogin), código do usuário: A12WDTGEFD

  2. Vá para o link especificado, insira o código de usuário e conclua o processo de login lá.

  3. Especifique o nome do pool de agentes para o qual você concedeu permissão de administrador para a Entidade de Serviço e continue as etapas de registro do agente.