Compartilhar via


Instalar o Azure DevOps local em um único servidor

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

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 de "serveradmin".

    • ALTERAR QUALQUER LOGIN, CRIAR QUALQUER BANCO DE DADOS e EXIBIR QUALQUER DEFINIÇÃO para permissões no escopo do servidor.

    • Permissão de 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 fornecem 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 Assistente de Primeiros Passos, ou retornar posteriormente e iniciar o 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.

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 utilizado no cenário básico é NT AUTHORITY\NETWORK SERVICE em cenários associados a um 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.

    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ância do 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.

    Screenshot da página da 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 Aplicação, escolha as configurações do site que você deseja usar, incluindo se deve utilizar 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 Aplicações, 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 fornecem 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.

  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.

  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.

  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 URL do Azure DevOps Server para se conectar ao portal web do seu servidor configurado.

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

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, nova página de Implantação - Avançado, 2022.

  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 das Configurações Avançadas, selecione Conta.

  7. Na página Camada de Aplicação, escolha as configurações do site que você deseja usar, incluindo se deve utilizar 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 fornecem 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.

  9. Na página Coleção de Projetos, mantenha 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.

  10. 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 da seção Avançado, Revisão.

  11. Na página Verificações de prontidão, o sistema executa uma verificação final para garantir que a configuração seja válida. 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 de prontidão avançadas.

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

  13. 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 URL do Azure DevOps Server para se conectar ao portal web do seu 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, veja Compartilhar a missão do projeto, ver a atividade do projeto.

Próximas etapas

Para administradores:

Para desenvolvedores:

::: moniker-end