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:

   • Downloads do Visual Studio, que é o método mais simples (role para baixo até Todos os downloads, Azure DevOps Server 2019)
   • Visual Studio Dev Essentials
   • Centro de Serviços de Licenciamento por Volume

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.

   

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.

  

  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.

  

  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.

• 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.

   

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 – Básico e selecione Avançar.

   

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

   

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.

   

   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.

   

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.

   

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.

   

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.

   

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.

   

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.

    

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.

    

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.

   

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

   

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.

   

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

   

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.

   

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.

   

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.

   

   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.

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.

   

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.

   

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.

   

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/.

   

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.

   

   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:

Introdução como administrador

Para desenvolvedores:

Comece a rastrear o trabalho ou o código com o Git

Artigos relacionados

• Instalar e configurar o Azure DevOps local
• Criar um projeto
• Requisitos para o Azure DevOps local
• Notas de versão
• Atualizar sua implantação para a versão mais recente do Azure DevOps Server