Como instalar o Bazel no Ubuntu

Esta página descreve as opções para instalar o Bazel no Ubuntu. Ela 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 Ubuntu Linux com suporte:

• 20.04 (LTS)
• 18.04 (LTS)

O Bazel precisa ser compatível com outras versões do Ubuntu e com o Debian "stretch" e versões mais recentes, mas não é testado e não há garantia de que funcione.

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

• Recomendado: usar o Bazelisk
• Usar nosso repositório APT personalizado
• Usar o instalador binário
• Compilar o Bazel da origem

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

O Bazel vem com dois scripts de conclusão. Depois de instalar o Bazel, você pode:

• Acessar o script de conclusão do bash
• Instalar o script de conclusão do zsh

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

Como usar o repositório apt do Bazel

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

sudo apt install apt-transport-https curl gnupg
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 do JDK com suporte ou incluídas. As versões do Bazel são agnósticas da versão Java. A mudança do nome do componente "jdk1.8" interromperia os usuários atuais do repositório.

Etapa 2: instalar e atualizar o Bazel

sudo apt update && sudo apt install bazel

Depois de instalado, você pode 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

Isso instala o Bazel 1.0.0 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.

Se preferir, defina 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 e agrupado como ambiente de execução e não exige que você instale uma versão específica do Java.

No entanto, se você quiser criar código Java usando o Bazel, instale um JDK.

# Ubuntu 16.04 (LTS) uses OpenJDK 8 by default:
sudo apt install openjdk-8-jdk
# Ubuntu 18.04 (LTS) uses OpenJDK 11 by default:
sudo apt install openjdk-11-jdk

Como usar o instalador binário

Geralmente, é recomendável 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.

Os instaladores binários podem ser baixados na página de versões do Bazel no GitHub.

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 unzip / zip para funcionar:

sudo apt install g++ unzip zip

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

# Ubuntu 16.04 (LTS) uses OpenJDK 8 by default:
sudo apt-get install openjdk-8-jdk
# Ubuntu 18.04 (LTS) uses OpenJDK 11 by default:
sudo apt-get install openjdk-11-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.

Execute-o da seguinte maneira:

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

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

Etapa 3: configurar seu ambiente

Se você executou o instalador do Bazel com o flag --user acima, o executável do Bazel será instalado no diretório $HOME/bin. É recomendável 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.