Implementação do cliente/servidor

<ph-0-0>

O sistema Bazel é implementado como um processo de servidor de longa duração. Isso permite que ele realize muitas otimizações que não são possíveis com uma implementação orientada por lote, como armazenamento em cache de arquivos BUILD, gráficos de dependência e outros metadados de um build para o próximo. Isso melhora a velocidade de builds incrementais e permite que comandos diferentes, como build e query, compartilhem o mesmo cache de pacotes carregados, tornando as consultas muito rápidas. Cada servidor pode processar no máximo uma invocação por vez. Outras invocações simultâneas bloquearão ou falharão rapidamente (consulte --block_for_lock).

Ao executar bazel, você executa o cliente. O cliente encontra o servidor com base na base de saída, que, por padrão, é determinada pelo caminho do diretório base do espaço de trabalho e pelo ID de usuário. Portanto, se você criar em vários espaços de trabalho, terá várias bases de saída e, portanto, vários processos do servidor do Bazel. Vários usuários na mesma estação de trabalho podem criar simultaneamente no mesmo espaço de trabalho porque as bases de saída deles serão diferentes (IDs de usuário distintos).

Se o cliente não encontrar uma instância do servidor em execução, uma nova será iniciada. Ele faz isso verificando se a base de saída já existe, o que implica que o arquivo blaze já foi descompactado. Caso contrário, se a base de saída não existir, o cliente vai descompactar os arquivos e definir os mtimes como uma data de nove anos no futuro. Depois de instalado, o cliente confirma que os mtimes dos arquivos descompactados são iguais à data mais distante para garantir que não tenha ocorrido nenhuma adulteração da instalação.

O processo do servidor será interrompido após um período de inatividade (três horas, por padrão, que pode ser modificado usando a opção de inicialização --max_idle_secs). Na maior parte, o fato de haver um servidor em execução é invisível para o usuário, mas às vezes é útil ter isso em mente. Por exemplo, se você estiver executando scripts que executam muitos builds automatizados em diretórios diferentes, é importante garantir que não acumule muitos servidores inativos. Para fazer isso, encerre-os explicitamente quando terminar de usá-los ou especifique um tempo limite curto.

O nome de um processo do servidor do Bazel aparece na saída de ps x ou ps -e f como bazel(dirname), em que dirname é o nome base do diretório que inclui a raiz do diretório do espaço de trabalho. Exemplo:

ps -e f
16143 ?        Sl     3:00 bazel(src-johndoe2) -server -Djava.library.path=...

Assim, fica mais fácil descobrir qual processo do servidor pertence a um determinado espaço de trabalho. Esteja ciente de que, com algumas outras opções para ps, os processos do servidor do Bazel podem ser nomeados apenas como java. Os servidores do Bazel podem ser interrompidos usando o comando shutdown.

Ao executar bazel, o cliente primeiro verifica se o servidor é a versão apropriada. Caso contrário, o servidor será interrompido e um novo será iniciado. Isso garante que o uso de um processo de servidor de longa duração não interfira no controle de versões adequado.