Instalar o Azure DevOps localmente 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 referenciar 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 SQL Server Express, configure uma versão com suporte do SQL Server. Ao configurar SQL Server para o Azure DevOps localmente, instale no mínimo o Mecanismo de Banco de Dados e Full-Text e Extrações Semânticas para recursos de Pesquisa.

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

   • Permissão CONTROL no banco de dados master.

     A associação à 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 Pesquisa, você precisa fornecer um nome de usuário e uma senha. Instalar e configurar Pesquisa dá suporte a 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

   Pesquisa também requer o Oracle Server JRE 8 (Atualização 60 ou superior). Você pode baixar e instalar ou atualizar para a versão mais recente aceitando o Oracle Binary Code License Agreement for Server JRE e selecionando Configurar. Observe que isso definirá a variável de ambiente JAVA_HOME para apontar para o diretório de instalação java e que o JRE do servidor não fornece atualizações automáticas.

5. Ao configurar a camada de aplicativo, você tem uma opção de configurações de site. Examine 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 inicia o assistente Azure DevOps Server Configuration Center.

3. Você pode configurar sua instalação escolhendo Assistente para Iniciar 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 o 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 configuração.
  • SQL Server Instância: selecione se deseja instalar SQL Server Express ou usar uma instância de SQL Server existente.
  • Camada de Aplicativo: selecione as configurações do site a serem usadas, o que inclui usar associações HTTP ou HTTPS. Para obter mais informações, consulte Configurações do site.
  • Pesquisa: selecione se deseja instalar e configurar recursos do Code Pesquisa 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 ter controle total sobre todas as entradas.

  

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

  • Conta: selecione a conta de serviço em que os processos são executados. O valor padrão usado no cenário Básico está 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 habilitar 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 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, em seguida, selecione Avançar.

   

4. Na página Idioma , escolha a opção Idioma preferencial e selecione Avançar.

   

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

   

   Se você escolheu Usar uma Instância de SQL Server existente, 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, que inclui se deseja usar associações HTTP ou HTTPS e escolha Avançar. Para obter mais informações, consulte Configurações do site.

   

7. Na página Pesquisa, selecione se deseja instalar e configurar Pesquisa recursos ou usar um serviço de pesquisa existente. Instalar e configurar Pesquisa dá suporte a 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 Revisão , examine suas seleções e, em seguida, 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 preparaçã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 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 Concluir , examine os resultados da configuração. Examine os resultados da configuração e escolha Copiar Caminho Completo para copiar o link para o arquivo de log de configuração. Escolha o link Azure DevOps Server URL para se conectar ao portal da Web do servidor configurado.

    

Configurar usando a opção Avançado

Esta seção explica como configurar seu Azure DevOps Server usando a opção Avançado.

Observação

Os procedimentos para instalar uma nova implantação com a opção Avançado são semelhantes para todas as versões do Azure DevOps Server e do Team Foundation Server 2018, exceto que o Reporting não tem suporte 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 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, em seguida, selecione Avançar.

   

4. Na página Idioma , escolha a opção Idioma preferencial e selecione Avançar.

   

5. Na página Banco de Dados, especifique a instância de SQL Server configurada 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, que inclui se deseja usar associações HTTP ou HTTPS e escolha Avançar. Para obter mais informações, consulte Configurações do site.

   

8. Na página Pesquisa, selecione se deseja instalar e configurar Pesquisa recursos ou usar um serviço de pesquisa existente. Instalar e configurar Pesquisa dá suporte a 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 para 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 personalização de processo e processos herdados.

2. Na página Revisão , examine suas seleções e, em seguida, 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 Preparaçã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 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 Concluir , examine os resultados da configuração. Examine os resultados da configuração e escolha Copiar Caminho Completo para copiar o link para o arquivo de log de configuração. Escolha o link Azure DevOps Server URL 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 o projeto for criado, a página de resumo do projeto será exibida. Para saber mais, confira Compartilhar sua missão de projeto, exibir a atividade do projeto.

Próximas etapas

Para administradores:

Introdução como administrador

Para desenvolvedores:

Iniciar o acompanhamento do trabalho ou do 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
• Atualize sua implantação para a versão mais recente do Azure DevOps Server