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 do Ubuntu Linux compatíveis:
- 22.04 (LTS)
- 20.04 (LTS)
- 18.04 (LTS)
O Bazel precisa ser compatível com outras versões do Ubuntu e do Debian "stretch" e mais recentes, mas não foi testado e não há garantia de que funcione.
Instale o Bazel no Ubuntu usando um destes métodos:
- Recomendado: usar o Bazelisk
- Usar nosso repositório APT personalizado
- Usar o instalador binário
- Usar o contêiner do Bazel Docker
- 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:
- Acesse o script de conclusão de bash.
- Instale o script de preenchimento zsh.
Como usar o repositório apt do Bazel
Etapa 1: adicionar o URI de distribuição do Bazel como uma origem de pacote
Observação:esta é uma etapa de configuração única.
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 de legado e não se relaciona a versões do JDK incluídas ou com suporte. As versões do Bazel não dependem da versão do Java. Mudar o nome do componente "jdk1.8" vai interromper os usuários atuais do repositório.
Etapa 2: instalar e atualizar o Bazel
sudo apt update && sudo apt install bazel
Depois de instalar, 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 versão 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.
Como alternativa, é possível definir bazel
como 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 agrupado e privado como ambiente de execução e não exige que você instale nenhuma versão específica do Java.
No entanto, se você quiser criar código Java usando o Bazel, será necessário instalar um JDK.
sudo apt install default-jdk
Como usar o instalador binário
Em geral, use 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 lançamentos do GitHub do Bazel.
O instalador contém o binário do Bazel e o extrai na 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 descompactação / compactação para funcionar:
sudo apt install g++ unzip zip
Se você quiser criar 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 (link em inglês).
Execute da seguinte maneira:
chmod +x bazel-version-installer-linux-x86_64.sh
./bazel-version-installer-linux-x86_64.sh --user
A 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 o ambiente
Se você executou o instalador do Bazel com a flag --user
conforme mostrado 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.
Como usar o contêiner do Bazel Docker
Publicamos o contêiner do Docker com o Bazel instalado para cada versão do Bazel em gcr.io/bazel-public/bazel
.
É possível usar o contêiner do Docker da seguinte maneira:
$ docker pull gcr.io/bazel-public/bazel:<bazel version>
O contêiner do Docker é criado seguindo estas etapas.