Compartilhar via


Instalar o Azure DevOps local em um único servidor

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

A maneira mais simples de configurar Azure DevOps Server é colocar tudo em um único servidor. Para confirmar se essa configuração é apropriada para sua equipe, consulte as recomendações de hardware. Caso contrário, considere uma configuração de servidor duplo ou de vários servidores .

Se você estiver atualizando de uma versão anterior, saiba mais sobre compatibilidade, notas de versão e introdução à atualização.

Observação

Os procedimentos para instalar uma nova implantação são semelhantes para todas as versões do Azure DevOps Server. As imagens mostradas neste artigo podem fazer referência Azure DevOps Server 2022 ou Azure DevOps Server 2019, no entanto, as informações configuradas são as mesmas, a menos que indicado de outra forma.

Pré-requisitos

  1. Prepare um único computador que atenda aos requisitos do sistema.

  2. Se você não planeja usar o SQL Server Express, configure uma versão com suporte do SQL Server. Ao configurar o SQL Server para Azure DevOps local, instale no mínimo os recursos Mecanismo de Banco de Dados e Extrações Semânticas e de Texto Completo para Pesquisa.

    Recomendamos que você use o SQL Server Express apenas para implantações pessoais ou de avaliação. As cópias pagas do Azure DevOps local incluem uma licença SQL Server Standard. Para obter mais informações, consulte Azure DevOps Server preços e preços do Team Foundation Server. Se você usar a licença incluída, poderá usá-la apenas para bancos de dados criados com esses produtos.

  3. A conta usada para configurar a instalação deve ser membro da função de servidor sysadmin no SQL Server.

    Observação

    A instalação do Azure DevOps local envolve um conjunto complexo de operações que exigem um alto grau de privilégio. Essas operações incluem a criação de bancos de dados, o provisionamento de logons para contas de serviço e muito mais. Tecnicamente, tudo o que é necessário é:

    • Associação na função serveradmin.

    • ALTER ANY LOGIN, CREATE ANY DATABASE e VIEW ANY DEFINITION permissões no escopo do servidor.

    • CONTROL no banco de dados principal.

      A associação na função de servidor sysadmin confere todas essas associações e permissões. É a maneira mais fácil de garantir que a configuração seja bem-sucedida. Se necessário, você pode revogar essas associações e permissões após a instalação.

  4. Para dar suporte à instalação e configuração da extensão de Pesquisa , você precisa fornecer um nome de usuário e senha. A instalação e a configuração da Pesquisa dão suporte aos recursos de pesquisa de Código, Item de Trabalho e Wiki. Para obter mais informações, consulte Configurar pesquisa. Observe que os nomes de usuário não podem incluir um hífen ou caracteres especiais.

    Observação

    A pesquisa também requer o Oracle Server JRE 8 (Atualização 60 ou superior). Você pode fazer download e instalar ou atualizar para a versão mais recente aceitando o Contrato de Licença de Código Binário da Oracle para o JRE do Servidor e selecionando Configurar. Observe que isso definirá a variável de ambiente JAVA_HOME para apontar para o diretório de instalação do Java e que o Server JRE não fornece atualizações automáticas.

  5. Ao definir a camada de aplicativo, você pode escolher as configurações do site. Revise as configurações do site para entender as opções e os requisitos.

Baixar e instalar

  1. Baixe Azure DevOps Server por meio de um dos seguintes canais:

  2. Inicie a instalação.

    O instalador copia arquivos em seu computador e, em seguida, inicia o assistente do Centro de Configuração Azure DevOps Server.

  3. Você pode configurar sua instalação escolhendo Iniciar Assistente ou retornar posteriormente e iniciar o assistente do Assistente de Configuração do Servidor, conforme descrito na próxima seção.

    Captura de tela do Centro de Configuração, Assistente de Início, Assistente de Início, Azure DevOps Server 2022.

    Aqui, mostramos o assistente fornecido para Azure DevOps Server 2019 Captura de tela do Centro de Configuração, Assistente para Iniciar, Azure DevOps Server 2019.

Escolha Básico ou Avançado para uma nova implantação

A primeira etapa para configurar seu servidor é escolher entre as duas opções de implantação.

  • Escolha o cenário Nova Implantação – Básico para instalar em um único servidor. Esse cenário é otimizado para simplificar usando opções padrão para a maioria das entradas.

    Captura de tela do Assistente de Configuração do Servidor, Nova implantação, opção Básica selecionada, 2022.

    Com o cenário Nova Implantação - Básico , você especificará as seguintes configurações:

    • Idioma: Selecione o idioma a ser usado para configurar.
    • Instância do SQL Server: selecione se deseja instalar o SQL Server Express ou usar uma instância existente do SQL Server.
    • Camada de Aplicativo: selecione as configurações do site a serem usadas, o que inclui o uso de associações HTTP ou HTTPS. Para obter mais informações, consulte Configurações do site.
    • Pesquisar: selecione se deseja instalar e configurar os recursos de Pesquisa de Código ou usar um serviço de pesquisa existente. Para obter mais informações, consulte Configurar pesquisa.
  • Escolha o cenário Nova Implantação – Avançado quando quiser controle total sobre todas as entradas.

    Captura de tela do Assistente de Configuração do Servidor, Nova implantação, opção Avançada selecionada, 2022.

    Você especificará as seguintes configurações adicionais:

    • Conta: selecione a conta de serviço com a qual seus processos são executados. O valor padrão usado no cenário Básico é NT AUTHORITY\NETWORK SERVICE em cenários ingressados no domínio e LOCAL SERVICE em cenários de grupo de trabalho.
    • Camada de aplicativo:
      • Em Configurações de SSH, selecione se deseja ativar o SSH e a porta em que ele deve escutar. O valor padrão usado no cenário Básico é configurar o SSH na porta 22.
      • Em Local do Cache de Arquivos, selecione o local do cache de arquivos usado para recursos acessados com frequência. O valor padrão usado no cenário Básico é o caminho AzureDevOpsServerData\ApplicationTier\_fileCache na unidade local, que tem mais espaço livre.
    • Coleção de Projetos: especifique o nome da coleção de projetos a ser usada para armazenar seus projetos. O comportamento padrão do cenário básico é criar uma coleção de projetos chamada DefaultCollection.
    • Conta: selecione a conta de serviço com a qual seus processos são executados. O valor padrão usado no cenário Básico é NT AUTHORITY\NETWORK SERVICE em cenários ingressados no domínio e LOCAL SERVICE em cenários de grupo de trabalho.
    • Camada de aplicativo:
      • Em Configurações de SSH, selecione se deseja ativar o SSH e a porta em que ele deve escutar. O valor padrão usado no cenário Básico é configurar o SSH na porta 22.
      • Em Local do Cache de Arquivos, selecione o local do cache de arquivos usado para recursos acessados com frequência. O valor padrão usado no cenário Básico é o caminho AzureDevOpsServerData\ApplicationTier\_fileCache na unidade local, que tem mais espaço livre.
    • Relatórios: (Opcional) Escolha se deseja usar o SQL Server Reporting Services para criar relatórios. Você precisará especificar as seguintes informações para dar suporte a essa seleção:
      • Instância do Reporting Services
      • URL do servidor de relatório
      • URL do Gerenciador de Relatórios
      • Instância do SQL Server Analysis Services
      • Nome da conta do leitor de relatório
    • Coleção de Projetos: especifique o nome da coleção de projetos a ser usada para armazenar seus projetos. O comportamento padrão do cenário básico é criar uma coleção de projetos chamada DefaultCollection.
  • Depois de examinar suas seleções e selecionar Verificar, o assistente executa verificações de preparação para validar seu ambiente e suas seleções de configuração. Se for bem-sucedido, você poderá configurar sua implantação. Caso contrário, corrija os erros e execute novamente as verificações de preparação.

Configurar usando a opção Básico

Esta seção orienta você na configuração do Azure DevOps Server usando a opção Básica selecionada na página Assistente de Configuração do Servidor, Nova Implantação .

  1. Na página de boas-vindas , escolha suas opções e selecione Avançar.

    Captura de tela do Assistente de Configuração do Servidor, página de boas-vindas, 2022.

  2. Na página Nova Implantação, escolha o tipo de implantação e selecione Avançar.

    Captura de tela do Assistente de Configuração do Servidor, página Nova Implantação, 2022.

  3. Na próxima página, escolha Nova Implantação – Básico e selecione Avançar.

    Captura de tela do Assistente de Configuração do Servidor, página Nova Implantação - Básico, 2022.

  4. Na página Idioma, escolha sua opção de idioma preferida e selecione Avançar.

    Captura de tela da página de idioma.

  5. Na página Instânciado SQL Server, selecione a instância do SQL Server que você deseja usar. Para fins de avaliação, escolha Instalar o SQL Server Express. Para fins de produção, escolha Usar uma instância existente do SQL Server. Em seguida, escolha Avançar.

    SScreenshot da página Instância do SQL Server.

    Se você escolher Usar uma instância existente do SQL Server, insira as informações do banco de dados na próxima página e escolha Testar para verificar. Em seguida, escolha Avançar.

    Captura de tela da página do banco de dados.

  6. Na página Camada de Aplicativo , escolha as configurações do site que você deseja usar, o que inclui o uso de associações HTTP ou HTTPS e, em seguida, escolha Avançar. Para obter mais informações, consulte Configurações do site.

    Captura de tela do Assistente de Configuração do Servidor, página Camada de Aplicativo, 2022.

  7. Na página Pesquisar, selecione se deseja instalar e configurar os recursos de Pesquisa ou usar um serviço de pesquisa existente. A instalação e a configuração da Pesquisa dão suporte aos recursos de pesquisa de Código, Item de Trabalho e Wiki. Para obter mais informações, consulte Configurar pesquisa. Escolha Próxima.

    Captura de tela do Assistente de Configuração do Servidor, página de pesquisa, 2022.

    Captura de tela da página de pesquisa para Azure DevOps Server 2019.

  8. Na página Revisar, revise suas seleções e escolha Verificar, o assistente executa verificações de preparação para validar seu ambiente e suas seleções de configuração. Se for bem-sucedido, você poderá configurar sua implantação. Caso contrário, corrija os erros e execute novamente as verificações de preparação.

    Captura de tela do Assistente de Configuração do Servidor, página de revisão, 2022.

  9. Verificações de prontidão. Quando todas as verificações forem aprovadas, você estará pronto para concluir a configuração. Escolha Configurar.

    Dica

    Você pode retornar a qualquer página anterior escolhendo Anterior ou o nome da página no painel esquerdo. Se você alterar uma definição de configuração, precisará verificar as configurações escolhendo Clique aqui para executar novamente as Verificações de preparação.

    Captura de tela do Assistente de Configuração de Servidor, página Verificações de Preparação, Azure DevOps Server 2022.

    Captura de tela da página Configurar início, Azure DevOps Server 2019.

  10. O assistente avança para a página Configurar e começa a configurar cada recurso e exibe o progresso. Essa etapa pode levar vários minutos. Se todas as configurações forem bem-sucedidas, você receberá a seguinte mensagem de êxito. Selecione Avançar.

    Captura de tela do Assistente de Configuração do Servidor, página de configuração, progresso da configuração, 2022.

    Captura de tela do progresso da configuração, 2019.

  11. Na página Concluído, revise os resultados da configuração. Revise os resultados da configuração e escolha Copy Full Path (Copiar caminho completo) para copiar o link para o arquivo de log de configuração. Escolha o link de URL Azure DevOps Server para se conectar ao portal da Web do servidor configurado.

    Captura de tela do Assistente de Configuração do Servidor, página Concluído, Progresso concluído, 2022.

    Neste exemplo, o link é /http:aaronha001/.

    Captura de tela do Assistente de Configuração do Servidor, página Concluído, Progresso concluído, 2019.

Configurar usando a opção Avançado

Esta seção orienta você na configuração do Azure DevOps Server usando a opção Avançado .

Observação

Os procedimentos para instalar uma nova implantação com a opção Avançada são semelhantes para todas as versões do Azure DevOps Server e Team Foundation Server 2018, exceto que não há suporte para relatórios para Azure DevOps Server 2022 e versões posteriores. As imagens mostradas nesta seção fazem referência Azure DevOps Server 2019, no entanto, as informações configuradas são as mesmas, a menos que indicado de outra forma.

  1. Na página de boas-vindas , escolha suas opções e selecione Avançar.

  2. Na página Nova Implantação , escolha o tipo de implantação e selecione Avançar.

  3. Na próxima página, escolha Nova Implantação – Avançado e selecione Avançar.

    Captura de tela do Assistente de Configuração do Servidor, página Nova Implantação - Avançado, 2022.

    Captura de tela de Nova implantação, seleção avançada.

  4. Na página Idioma, escolha sua opção de idioma preferida e selecione Avançar.

    Captura de tela do Avançado, selecione Idioma, qualquer versão.

  5. Na página Banco de Dados , especifique a instância do SQL Server que você configurou para uso com Azure DevOps Server. Em seguida, escolha Avançar.

    Captura de tela do Avançado, selecione Banco de dados.

  6. Na página Conta , especifique a conta de serviço a ser usada.

    Captura de tela do Avançado, selecione Conta.

  7. Na página Camada de Aplicativo , escolha as configurações do site que você deseja usar, o que inclui o uso de associações HTTP ou HTTPS e, em seguida, escolha Avançar. Para obter mais informações, consulte Configurações do site.

    Captura de tela da página Seleção avançada, Camada de Aplicativo.

  8. Na página Pesquisar, selecione se deseja instalar e configurar os recursos de Pesquisa ou usar um serviço de pesquisa existente. A instalação e a configuração da Pesquisa dão suporte aos recursos de pesquisa de Código, Item de Trabalho e Wiki. Para obter mais informações, consulte Configurar pesquisa. Escolha Próxima.

    Captura de tela da página de pesquisa avançada.

  1. Na página Relatórios, desmarque a caixa de seleção Configurar Relatórios se você não planeja usar o SQL Server Reporting Services ou ainda não instalou o SQL Server Analysis Services e o SQL Server Reporting Services. Caso contrário, mantenha a caixa marcada e escolha Avançar.

    Captura de tela de Avançado, selecione Relatórios.

  2. Serviços de relatórios. Insira o nome do servidor em que você instalou o SQL Server Reporting Services. Em seguida, escolha Preencher URLs. Escolha Próxima.

    Captura de tela do Advanced, Reporting Services

  3. Analysis Services. Insira o nome do servidor em que você instalou o SQL Server Reporting Services e escolha Testar. Escolha Próxima.

    Captura de tela do Advanced, Analysis Services

  4. Conta do Leitor de Relatório. Insira as credenciais da conta de serviço que você configurou para relatórios e escolha Testar. Escolha Próxima.

    Captura de tela da conta avançada do leitor de relatórios

  1. Na página Coleção de projetos, deixe a caixa de seleção Criar uma nova coleção de projetos de equipe marcada. Você deve ter pelo menos uma coleção de projetos na qual definir projetos. Deixe o nome do projeto como está, DefaultCollection, ou dê a ele um novo nome e, opcionalmente, uma descrição.

    Captura de tela da página Avançado, Coleção de Projetos.

    Observação

    A coleção de projetos é criada para usar o modelo de processo herdado, que dá suporte à personalização por meio do portal da Web. Você pode criar outras coleções de projetos conforme necessário para dar suporte ao modelo de processo XML local posteriormente. Consulte Gerenciar coleções de projetos. Para saber mais sobre o modelo de processo de herança, consulte Sobre a personalização de processos e processos herdados.

    Observação

    Quando os serviços de relatório forem definidos, a coleção de projetos criada dará suporte ao modelo de processo XML local para personalizar o acompanhamento de trabalho. Para criar uma coleção que usa o modelo de processo de herança, você precisará adicionar uma coleção de projetos que não esteja configurada com o Reporting Services. Consulte Gerenciar coleções de projetos. Para saber mais sobre o modelo de processo de herança, consulte Sobre a personalização de processos e processos herdados.

  2. Na página Revisar, revise suas seleções e escolha Verificar, o assistente executa verificações de preparação para validar seu ambiente e suas seleções de configuração. Se for bem-sucedido, você poderá configurar sua implantação. Caso contrário, corrija os erros e execute novamente as verificações de preparação.

    Captura de tela do Avançado, Revisão.

  3. Na página Verificações de prontidão, o sistema executa uma passagem final para garantir que as definições de configuração sejam válidas. Quando todas as verificações forem aprovadas, você estará pronto para concluir a configuração. Escolha Configurar.

    Dica

    Você pode retornar a qualquer página anterior escolhendo Anterior ou o nome da página no painel esquerdo. Se você alterar uma definição de configuração, precisará verificar as configurações escolhendo Clique aqui para executar novamente as Verificações de preparação.

    Captura de tela de verificações avançadas de prontidão.

  4. O assistente avança para a página Configurar e começa a configurar cada recurso e exibe o progresso. Essa etapa pode levar vários minutos. Se todas as configurações forem bem-sucedidas, você receberá a seguinte mensagem de êxito. Selecione Avançar.

    Captura de tela da página Avançado, Configurar.

  5. Na página Concluído, revise os resultados da configuração. Revise os resultados da configuração e escolha Copy Full Path (Copiar caminho completo) para copiar o link para o arquivo de log de configuração. Escolha o link de URL Azure DevOps Server para se conectar ao portal da Web do servidor configurado.

    Neste exemplo, o link é /http:aaronha001/.

    Captura de tela da configuração avançada, página completa.

Criar um projeto

Seu portal da Web será aberto na página Criar um projeto .

  1. Forneça um nome de projeto e uma descrição opcional. O nome do projeto não pode conter espaços ou caracteres especiais (como / : \ ~ & % ; @ ' " ? <> | # $ * } { , + = [ ]), não pode começar com um sublinhado, não pode começar ou terminar com um ponto e deve ter 64 caracteres ou menos.

    As configurações padrão definem um repositório Git para controle de versão e o processo Agile para acompanhamento de trabalho. Para escolher opções diferentes, expanda Avançado.

    Captura de tela do portal da web, caixa de diálogo Criar projeto.

    Para obter uma comparação das opções de controle de versão, consulte Escolher o controle de versão correto para seu projeto. Para obter uma revisão dos processos de acompanhamento de trabalho, consulte Escolher um processo.

  2. Depois que seu projeto for criado, a página de resumo do projeto será exibida. Para saber mais, consulte Compartilhar a missão do projeto, exibir a atividade do projeto.

Próximas etapas

Para administradores:

Para desenvolvedores: