Alterar configurações de cache para um servidor de camada de aplicativo

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

Você pode ajudar a aumentar ou equilibrar o desempenho em sua implantação de Azure DevOps Server alterando as configurações do cache para arquivos que estão sob controle de versão no servidor da camada de aplicativo. Por padrão, esse cache é habilitado para que os usuários possam baixar arquivos rapidamente do cache, em vez de diretamente do banco de dados. Como administrador, você pode alterar as configurações desse cache a qualquer momento.

Você pode realizar essas tarefas editando o arquivo web.config para controle de versão, que está localizado no diretório de instalação no servidor da camada de aplicativo.

Observação

Por padrão, o diretório de instalação da camada de aplicativo é %programfiles%\Azure DevOps Server 2019\Application Tier\Web Services.

Pré-requisitos

Para executar esses procedimentos, você deve ser membro do grupo de segurança Administradores no servidor da camada de aplicativo do Azure DevOps.

Para obter mais informações, consulte Controle de Conta de Usuário.

Especificar uma pasta raiz de cache diferente

  1. No servidor da camada de aplicativo, crie uma pasta de cache.

    Você pode criar a pasta em um disco local, no caminho UNC ou em uma unidade montada. Por exemplo, você pode criar a seguinte pasta:

    d:\temp\cacheroot

    Importante

    A pasta cache armazena informações confidenciais que não são criptografadas. Portanto, você deve verificar se apenas a conta de serviço da camada de aplicativo (TFSService) tem permissões Modificar para essa pasta.

  2. Abra o menu de atalho da pasta e selecione Propriedades.

    A caixa de diálogo Propriedades da pasta é aberta.

  3. Na guia Segurança , selecione Editar.

    A caixa de diálogo Permissões é aberta.

  4. Selecione Adicionar.

    A caixa de diálogo Selecionar Usuários, Computadores ou Grupos é aberta.

  5. Adicione o grupo local TFS_APPTIER_SERVICE_WPG e selecione OK.

  6. Selecione a caixa Modificar marcar, desmarque todas as outras caixas marcar e selecione OK.

  7. No Windows Explorer (ou Explorador de Arquivos), navegue até %programfiles%\Azure DevOps Server 2019\Camada de Aplicativo\Serviços Web.

  8. Abra o arquivo web.config em um editor de texto ou XML e localize a <appSettings> seção.

  9. Adicione uma linha à appSettings seção para apontar para a pasta que você acabou de criar:

    <add key="dataDirectory" value="NewCacheRootFolderLocation" />
    

    Por exemplo, você adicionaria a seguinte linha se criasse uma pasta raiz de cache chamada cacheroot no diretório temporário de um disco rígido, como no exemplo anterior:

    <add key="dataDirectory" value="d:\temp\cacheroot" />
    
  10. Salve e feche o arquivo deweb.config .

    Observação

    Para maximizar o desempenho, copie os arquivos da pasta de cache antiga para a nova pasta de cache.

  11. Abra uma janela do Prompt de Comando, insira iisreset e pressione ENTER.

  12. Exclua a pasta raiz do cache antigo.

    Observação

    Por padrão, a pasta raiz do cache está localizada em %programfiles%\Azure DevOps Server 2019\Version Control Proxy\Web Services\VersionControlProxy\Data.

Alterar limites para remover arquivos do cache

Você pode alterar o limite máximo da quantidade de espaço de armazenamento que o servidor da camada de aplicativo pode usar para armazenar arquivos em cache. Quando esse limite é atingido, uma rotina de limpeza abre espaço para arquivos recém-solicitados excluindo os arquivos com os tempos de acesso mais antigos.

Alterar o limite no qual os arquivos antigos são removidos do cache

  1. No servidor da camada de aplicativo, abra o Windows Explorer (ou Explorador de Arquivos) e navegue até \%programfiles%\Azure DevOps Server 2019\Application Tier\Web Services.

  2. Abra o arquivo web.config em um editor de texto ou XML e localize o \<appSettings\> elemento .

  3. Adicione um dos seguintes elementos:

    • Para especificar uma porcentagem de espaço em disco disponível para preencher antes que os arquivos antigos sejam removidos, adicione o PercentageBasedPolicy elemento . Você deve especificar um número inteiro como o valor desse elemento.

      Por exemplo, a linha a seguir especifica que o cache deve preencher até 60% da capacidade de espaço em disco disponível antes que os arquivos antigos sejam removidos:

      <add key="PercentageBasedPolicy" value="60" />
      
    • Para especificar um tamanho fixo em MB para que o cache alcance antes que os arquivos antigos sejam removidos, adicione o FixedSizeBasedPolicy elemento . Você deve especificar um número inteiro como o valor desse elemento.

      Por exemplo, a linha a seguir especifica que o cache deve atingir 500 MB antes que os arquivos antigos sejam removidos:

      <add key="FixedSizeBasedPolicy" value="500" />
      

      Observação

      Se os FixedSizeBasedPolicy elementos e PercentageBasedPolicy forem especificados, o valor do FixedSizeBasedPolicy elemento será usado em vez do valor do PercentageBasedPolicy elemento.

  4. Salve e feche o arquivo deweb.config .

  5. Abra uma janela do Prompt de Comando, insira iisreset e pressione ENTER.

Alterar a quantidade de cache para gratuita ao remover arquivos antigos

  1. No servidor da camada de aplicativo, abra o Windows Explorer (ou Explorador de Arquivos) e navegue até %programfiles%\Azure DevOps Server 2019\Application Tier\Web Services\.

  2. Abra o arquivo web.config em um editor de texto ou XML, localize o <appSettings> elemento e adicione o CacheDeletionPercent elemento .

    Por exemplo, a linha a seguir especifica liberar 50% do cache ao remover arquivos antigos:

    <add key="CacheDeletionPercent" value="50" />
    
  3. Salve e feche o arquivo deweb.config .

  4. Abra uma janela do Prompt de Comando, insira iisreset e pressione ENTER.

Artigo relacionado