Como instalar o MongoDB no Ubuntu (e derivados)

Apesar da grande leva de opções de bancos de dados não relacionais no mercado como Redis, Cassandra, DynamoDB, entre outros, sem dúvidas o MongoDB conquistou seu lugar aos que armazenam dados não relacionais. Veja neste tutorial como você poderá instalar este banco em distribuições linux como Ubuntu e os seus derivados como Linux Mint, ElementaryOS e etc.

Importe a chave pública

Abra seu terminal favorito e cole o seguinte comando:

wget -qO - https://www.mongodb.org/static/pgp/server-4.2.asc | sudo apt-key add -

O que isso faz é instalar a chave pública do MongoDB no gerenciador de pacotes do seu sistema (no caso do Ubuntu e derivados, o apt. Então você deverá receber um "OK". Caso algum erro ocorrer, provavelmente o gnupg não está instalado em seu sistema. Isso poderá ser feito com o seguinte comando:

sudo apt install gnupg

Então, ao terminar, apenas importe novamente a chave descrita no início desse tópico.

Adicione o pacote oficial do MongoDB

Após instalar a chave com sucesso, precisamos agora adicionar o pacote oficial do MongoDB em nossa máquina, e isso pode ser feito com o seguinte comando:

# Ubuntu 18.04 (Bionic)
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.2.list

# Ubuntu 16.04 (Xenial)
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/4.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.2.list

Atualize o repositório APT

Após isso, apenas atualize seus pacotes apt com o seguinte comando:

sudo apt update

Instalando o MongoDB

Finalmente podemos instalar o nosso MongoDB com o simples comando:

sudo apt install -y mongodb-org

Ps: o -y no comando serve para que a confirmação de instalação seja autorizada sem a necessidade de você mesmo dizer que sim (já que no caso, ao usar essa flag você diz "yes" para a confirmação de instalação. Se você quiser verificar quais pacotes de dependencias serão instalados, omita essa flag, e então autorize manualmente quando você for solicitado no processo de instalação.

Isto instalará a última versão community estável disponível, que no momento em que esse post está sendo escrito é a 4.2. Feito isso você já deve ter instalado com sucesso o banco.

Para confirmar que tudo está ok, verifique se ambos cliente e server do mongo estão instalados com os comandos abaixo:

# Mostrará a versão do seu client mongo:
mongod --version

# Mostrará a versão do seu server mongo:
mongo --version

Se o console retornar os dados referente a versão instalada, parabains!, seu MongoDB está instalado!

Mas antes de começar a usar, você precisa iniciar o serviço que roda o Mongo em sua máquina, o que nos leva ao proximo tópico.

Iniciando e parando o serviço do MongoDB

Antes de tentar iniciar, verifique o status do serviço e veja se ele já não está rodando com o comando a seguir:

sudo systemctl status mongod

Verifique nas linhas que iniciam com "Loaded" e "Active": se estiverem com status disabled e inactive (dead) respectivamente então o seu banco nem está rodando e nem está configurado para inicializar junto da sua máquina ao ligar/reiniciar. Para ativar ambos, rode o seguinte comando:

Ativando o serviço

# Inicializa o serviço
sudo systemctl start mongod

# Ajusta para inicializar junto ao seu sistema operacional
sudo systemctl enable mongod

Agora rode novamente a verificação de status para ver se tudo está funcionando corretamente com o comando sudo systemctl status mongod e procure novamente se em "Loaded" você vê a palavra enabled e em "Active" a palavra Active (running), e caso sim, tudo está ok.

Reiniciando o serviço

Se por algum motivo você precisa reiniciar o serviço do seu MongoDB, use o comando abaixo:

sudo systemctl restart mongod

Encerrando/matando o serviço

E por fim, caos dejese matar todo o serviço do MongoDB da sua máquina, impedindo que o mesmo rode, apenas use o comando abaixo:

sudo systemctl stop mongod

Lembrando que uma vez encerrado você pode iniciá-lo novamente usando o comando sudo systemctl start mongod

Configurações avançadas

Neste post não entraremos em detalhes de configurações avançadas, mas para seu conhecimento, o arquivo de configuração do MongoDB em sua máquina geralmente fica no caminho: /etc/mongod.conf.

veja mais detalhes na documentação oficial, disponível NESTE LINK.

Considerações finais

Finalizando todo o processo, você deverá ter em sua máquina o MongoDB rodando sem problemas. Este post serviu para preparar o solo para futuros posts sobre esse banco de dados, então aguarde mais tutoriais sobre e até o próximo post!