Instale o MongoDB Community Edition no Amazon Linux
Nesta página
Observação
MongoDB Atlas
O MongoDB Atlas é uma opção de serviço MongoDB hospedado em nuvem que não requer sobrecarga de instalação e oferece camada grátis para começar.
Visão geral
Use este tutorial para instalar a edição MongoDB 7.0 Community no Amazon Linux usando o gerenciador de pacotes yum
.
Verifique a distribuição do Linux
Você pode verificar qual distribuição Linux você está executando ao executar o seguinte comando na linha de comando:
grep ^NAME /etc/*release
O resultado deve ser Amazon Linux ou Amazon Linux AMI. Se estiver usando uma distribuição Linux diferente, consulte asinstruções de instalação para sua plataforma.
Versão do MongoDB
Este tutorial instala o MongoDB 7.0 Community Edition. Para instalar uma versão diferente do MongoDB Community, use o menu suspenso de versão no canto superior esquerdo desta página para selecionar a documentação dessa versão.
Considerações
Suporte a plataformas
O MongoDB 7.0 Community Edition oferece suporte à seguinte versão do Amazon Linuxde 64 bits na arquitetura x86_64:
Amazon Linux 2023
Amazon Linux 2
O MongoDB oferece suporte somente às versões de bits desta plataforma.
O MongoDB 7.0 Community Edition no Amazon Linux também suporta a arquitetura ARM64 em plataformas selecionadas.
Consulte Suporte da Plataforma para obter mais informações.
Notas de produção
Antes de implantar o MongoDB em um ambiente de produção, considere o documento Notas de produção para implantações autogerenciadas, que oferece considerações de desempenho e recomendações de configuração para implantações de produção do MongoDB.
Instale o MongoDB Community Edition
Siga estas etapas para instalar o MongoDB Community Edition usando o gerenciador de pacotes yum
. Selecione a aba para a sua versão do Amazon Linux:
Configure o sistema de gerenciamento de pacotes (yum
).
Crie um arquivo /etc/yum.repos.d/mongodb-org-7.0.repo
para instalar o MongoDB diretamente utilizando o yum
:
[mongodb-org-7.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/7.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://pgp.mongodb.com/server-7.0.asc
[mongodb-org-7.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/amazon/2/mongodb-org/7.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://pgp.mongodb.com/server-7.0.asc
Você também pode baixar os .rpm
arquivos diretamente do repositório MongoDB. As transferências são organizadas pela versão do Amazon Linux 2023 (por exemplo 2023
), depois a versão do MongoDB (por exemplo, 7.0
), depois a arquitetura (por exemplo, x86_64
).
Antes do MongoDB 5.0, as versões ímpares do MongoDB, como 4.3
, eram versões de desenvolvimento. Começando com o MongoDB 5.1, o MongoDB tem Rapid Releases trimestralmente. Para obter mais informações sobre as diferenças entre versões de suporte rápido e de longo prazo, consulte MongoDB Versioning.
Para instalar a versão estável mais recente do MongoDB, emita o seguinte comando:
sudo yum install -y mongodb-org
Como alternativa, para instalar uma versão específica do MongoDB, especifique cada pacote de componente individualmente e anexe o número da versão ao nome do pacote , como no exemplo a seguir:
sudo yum install -y mongodb-org-7.0.14 mongodb-org-database-7.0.14 mongodb-org-server-7.0.14 mongodb-mongosh mongodb-org-mongos-7.0.14 mongodb-org-tools-7.0.14
Observação
yum
atualiza pacotes automaticamente quando novas versões são disponibilizadas. Se você quiser impedir atualizações do MongoDB, fixe o pacote adicionando a seguinte diretriz exclude
ao seu arquivo /etc/yum.conf
:
exclude=mongodb-org,mongodb-org-database,mongodb-org-server,mongodb-mongosh,mongodb-org-mongos,mongodb-org-tools
Execute o MongoDB Community Edition
Considerações ulimit
A maioria dos sistemas operacionais do tipo Unix limita os recursos do sistema que um processo pode usar. Esses limites podem impacto negativamente a operação do MongoDB e devem ser ajustados. Consulte Configurações do UNIX ulimit
para sistemas autogerenciados para obter as configurações recomendadas para sua plataforma.
Observação
Se o valor ulimit
para o número de arquivos abertos estiver em 64000
, o MongoDB gerará um aviso de inicialização.
Diretórios
Por padrão, uma instância MongoDB armazena:
seus arquivos de dados em
/var/lib/mongo
seus arquivos de log em
/var/log/mongodb
Se você instalou pelo gerenciador de pacotes, estes diretórios padrão serão criados durante a instalação.
Se você instalou manualmente baixando os tarballs, você poderá criar os diretórios utilizando o mkdir -p <directory>
ou sudo mkdir -p
<directory>
dependendo do usuário que executará MongoDB. (Veja as páginas de manual do Linux para obter informações sobre mkdir
e sudo
.)
Por padrão, o MongoDB é executado com a conta de usuário mongod
. Se você alterar o usuário que executa o processo MongoDB, também deverá modificar a permissão /var/lib/mongo
para /var/log/mongodb
os diretórios e para conceder a este usuário acesso a estes diretórios.
Para especificar um diretório de arquivo de log diferente e diretório de arquivo de dados, edite as configurações do systemLog.path
e storage.dbPath
no /etc/mongod.conf
. Certifique-se de que o usuário que executa o MongoDB tenha acesso a esses diretórios.
Procedimento
Siga estas etapas para executar o MongoDB Community Edition. Estas instruções pressupõem que você esteja usando as configurações padrão.
Sistema de Inicialização
Para executar e gerenciar seu processo do mongod
, você utilizará o sistema de inicialização integrado do sistema operacional. Versões recentes do Linux tendem a utilizar systemd (que utiliza o comando systemctl
), enquanto versões mais antigas do Linux tendem a utilizar System V init (que utiliza o comando service
).
Se você não tiver certeza de qual sistema de inicialização sua plataforma usa, execute o seguinte comando:
ps --no-headers -o comm 1
Em seguida, selecione a aba apropriada abaixo com base no resultado:
systemd
- selecione a aba systemd (systemctl) abaixo.init
- selecione a aba System V Init (service) abaixo.
Inicie o MongoDB.
Você pode iniciar o processo mongod
emitindo o seguinte comando:
sudo systemctl start mongod
Se receber um erro semelhante ao seguinte ao iniciar o mongod
:
Failed to start mongod.service: Unit mongod.service not found.
Execute o seguinte comando primeiro:
sudo systemctl daemon-reload
Em seguida, execute o comando de inicialização acima novamente.
Verifique se o MongoDB foi iniciado com sucesso.
Você pode verificar se o processo mongod
começou com sucesso emitindo o seguinte comando:
sudo systemctl status mongod
Opcionalmente, você pode garantir que o MongoDB iniciará após reinicialização do sistema emitindo o seguinte comando:
sudo systemctl enable mongod
Pare o MongoDB.
Conforme necessário, você pode interromper o processo mongod
emitindo o seguinte comando:
sudo systemctl stop mongod
Reinicie o MongoDB.
Você pode reiniciar o processo mongod
emitindo o seguinte comando:
sudo systemctl restart mongod
Você pode acompanhar o estado do processo em busca de erros ou mensagens importantes
observando o resultado no arquivo /var/log/mongodb/mongod.log
.
Comece a usar o MongoDB.
Inicie uma sessão mongosh
na mesma máquina host que o mongod
. Você pode executar mongosh
sem nenhuma opção de linha de comando para se conectar a um mongod
que esteja sendo executado em seu host local com a porta padrão 27017.
mongosh
Para obter mais informações sobre como se conectar usando mongosh
, como se conectar a uma instância mongod
em execução em um host e/ou porta diferente, consulte a documentação do mongosh.
Para ajudá-lo a começar a usar o MongoDB, o MongoDB fornece Guias de Introdução em várias edições de driver. Para obter a documentação do driver, consulte Iniciar o desenvolvimento com o MongoDB.
Inicie o MongoDB.
Você pode iniciar o processo mongod
emitindo o seguinte comando:
sudo service mongod start
Verifique se o MongoDB foi iniciado com sucesso.
Você pode verificar se o processo mongod
começou com sucesso verificando o conteúdo do arquivo de log em /var/log/mongodb/mongod.log
para uma linha de leitura
[initandlisten] waiting for connections on port <port>
onde <port>
é a porta configurada em /etc/mongod.conf
, 27017
por padrão.
Opcionalmente, você pode garantir que o MongoDB iniciará após reinicialização do sistema emitindo o seguinte comando:
sudo chkconfig mongod on
Pare o MongoDB.
Conforme necessário, você pode interromper o processo mongod
emitindo o seguinte comando:
sudo service mongod stop
Reinicie o MongoDB.
Você pode reiniciar o processo mongod
emitindo o seguinte comando:
sudo service mongod restart
Você pode acompanhar o estado do processo em busca de erros ou mensagens importantes
observando o resultado no arquivo /var/log/mongodb/mongod.log
.
Comece a usar o MongoDB.
Inicie uma sessão mongosh
na mesma máquina host que o mongod
. Você pode executar mongosh
sem nenhuma opção de linha de comando para se conectar a um mongod
que esteja sendo executado em seu host local com a porta padrão 27017.
mongosh
Para obter mais informações sobre como se conectar usando mongosh
, como se conectar a uma instância mongod
em execução em um host e/ou porta diferente, consulte a documentação do mongosh.
Para ajudá-lo a começar a usar o MongoDB, o MongoDB fornece Guias de Introdução em várias edições de driver. Para obter a documentação do driver, consulte Iniciar o desenvolvimento com o MongoDB.
Desinstale o MongoDB Community Edition
Para remover completamente o MongoDB de um sistema, você deve remover os próprios aplicativos MongoDB, os arquivos de configuração e quaisquer diretórios que contenham dados e registros. A seção a seguir orienta você nas etapas necessárias.
Aviso
Esse processo removerá completamente o MongoDB, sua configuração e todos os bancos de dados. Este processo não é reversível, portanto, certifique-se de fazer backup de todas as suas configurações e dados antes de continuar.
Pare o MongoDB.
Interrompa o processo mongod
com o seguinte comando:
sudo service mongod stop
Informações adicionais
Vinculação ao localhost por padrão
By default, MongoDB launches with bindIp
set to 127.0.0.1
, which binds to the localhost network interface. This means that the mongod
can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod
, and the mongod
will not be able to initialize a replica set unless this value is set to a valid network interface which is accessible from the remote clients.
Este valor pode ser configurado de duas maneiras:
no arquivo de configuração do MongoDB com
bindIp
, oupor meio do argumento linha de comando
--bind_ip
Aviso
Antes de vincular sua instância a um endereço IP acessível publicamente, você deve proteger seu cluster contra o acesso não autorizado. Para obter uma lista completa de recomendações de segurança, consulte Lista de verificação de segurança para implantações autogerenciadas. No mínimo, considere habilitar a autenticação e fortalecer a infraestrutura de rede.
Para obter mais informações sobre como configurar bindIp
, consulte Vinculação de IP em implementações autogerenciadas.
Pacotes do MongoDB Community Edition
O MongoDB Community Edition está disponível em seu próprio repositório dedicado e contém os seguintes pacotes com suporte oficial:
Nome do Pacote | Descrição | ||||||
---|---|---|---|---|---|---|---|
| Um | ||||||
| Um
| ||||||
| Contém o MongoDB Shell ( | ||||||
| Um
|