Como instalar o Bazel no Ubuntu

Informar um problema Ver código-fonte

Esta página descreve as opções para instalar o Bazel no Ubuntu. Ele também fornece links para os scripts de conclusão do Bazel e o instalador binário, se necessário, como uma opção de backup (por exemplo, se você não tiver acesso de administrador).

Plataformas Linux do Ubuntu compatíveis:

  • 22,04 (LTS)
  • 20,04 (LTS)
  • 18,04 (LTS)

O Bazel precisa ser compatível com outras versões do Ubuntu e com o "stretch" do Debian. No entanto, isso não foi testado e nem sempre funciona.

Instale o Bazel no Ubuntu usando um dos seguintes métodos:

Observação: para sistemas baseados em ARM, o repositório APT não contém uma versão arm64, e não há um instalador binário disponível. Use o Bazelisk ou compile a partir da fonte.

O Bazel inclui dois scripts de conclusão. Depois de instalar o Bazel, você poderá:

Como usar o repositório apt do Bazel

Etapa 1: adicionar o URI de distribuição do Bazel como uma origem do pacote

Observação: esta é uma etapa única de configuração.

sudo apt install apt-transport-https curl gnupg -y
curl -fsSL https://bazel.build/bazel-release.pub.gpg | gpg --dearmor >bazel-archive-keyring.gpg
sudo mv bazel-archive-keyring.gpg /usr/share/keyrings
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/bazel-archive-keyring.gpg] https://storage.googleapis.com/bazel-apt stable jdk1.8" | sudo tee /etc/apt/sources.list.d/bazel.list

O nome do componente "jdk1.8" é mantido apenas por motivos legados e não está relacionado às versões compatíveis ou incluídas do JDK. As versões do Bazel são independentes da versão Java. Alterar o nome do componente "jdk1.8" prejudicaria os usuários existentes do repositório.

Etapa 2: instalar e atualizar o Bazel

sudo apt update && sudo apt install bazel

Depois de instalado, é possível fazer upgrade para uma versão mais recente do Bazel como parte das atualizações normais do sistema:

sudo apt update && sudo apt full-upgrade

O pacote bazel sempre instala a versão estável mais recente do Bazel. É possível instalar versões específicas e mais antigas do Bazel, além da mais recente, como esta:

sudo apt install bazel-1.0.0

O Bazel 1.0.0 será instalado como /usr/bin/bazel-1.0.0 no seu sistema. Isso pode ser útil se você precisar de uma versão específica do Bazel para criar um projeto, por exemplo, porque ele usa um arquivo .bazelversion para declarar explicitamente com qual versão do Bazel ele precisa ser criado.

Opcionalmente, você pode definir bazel para uma versão específica criando um link simbólico:

sudo ln -s /usr/bin/bazel-1.0.0 /usr/bin/bazel
bazel --version  # 1.0.0

Etapa 3: instalar um JDK (opcional)

O Bazel inclui um JRE particular empacotado como ambiente de execução e não exige a instalação de qualquer versão específica do Java.

No entanto, se quiser compilar o código Java usando o Bazel, você precisará instalar um JDK.

sudo apt install default-jdk

Como usar o instalador binário

Geralmente, você precisa usar o repositório apt, mas o instalador binário pode ser útil se você não tiver permissões de administrador na máquina ou não puder adicionar repositórios personalizados.

É possível fazer o download dos instaladores binários na página de versões do GitHub do Bazel.

O instalador contém o binário do Bazel e o extrai para a pasta $HOME/bin. Algumas bibliotecas adicionais precisam ser instaladas manualmente para que o Bazel funcione.

Etapa 1: instalar os pacotes necessários

O Bazel precisa de um compilador C++ e descompactar / zip para trabalhar:

sudo apt install g++ unzip zip

Se você quiser compilar o código Java usando o Bazel, instale um JDK:

sudo apt-get install default-jdk

Etapa 2: executar o instalador

Em seguida, faça o download do instalador binário do Bazel chamado bazel-version-installer-linux-x86_64.sh na página de versões do Bazel no GitHub (em inglês).

Execute-o da seguinte maneira:

chmod +x bazel-version-installer-linux-x86_64.sh
./bazel-version-installer-linux-x86_64.sh --user

A sinalização --user instala o Bazel no diretório $HOME/bin do sistema e define o caminho .bazelrc como $HOME/.bazelrc. Use o comando --help para ver outras opções de instalação.

Etapa 3: configurar o ambiente

Se você executou o instalador do Bazel com a sinalização --user acima, o executável do Bazel foi instalado no diretório $HOME/bin. É uma boa ideia adicionar esse diretório aos caminhos padrão, da seguinte maneira:

export PATH="$PATH:$HOME/bin"

Também é possível adicionar esse comando ao arquivo ~/.bashrc ou ~/.zshrc para torná-lo permanente.

Como usar o contêiner do Docker do Bazel

Publicamos o contêiner do Docker com o Bazel instalado para cada versão em gcr.io/bazel-public/bazel. Use o contêiner do Docker da seguinte maneira:

$ docker pull gcr.io/bazel-public/bazel:<bazel version>

O contêiner do Docker é criado de acordo com estas etapas.