Como Instalar o Apache Couch DB no AlmaLinux 9

Apache CouchDB é um banco de dados NoSQL e orientado a documentos de código aberto que suporta múltiplos formatos e protocolos para armazenar seus dados. É escrito em Erlang e pode ser executado como um banco de dados de alto desempenho em um único nó.

O Apache CouchDB permite que você use JSON para armazenar dados, e também fornece uma interface web para gerenciar o sistema CouchDB e uma API HTTP que permite consultar dados facilmente.

Neste guia, vamos orientá-lo na instalação do Apache CouchDB no servidor AlmaLinux 9. Você instalará o Apache CouchDB em um cluster de nó único e configurará um usuário administrador e o firewalld para o CouchDB. Além disso, você aprenderá como criar um banco de dados e um documento no Apache CouchDB via interface web e API HTTP com Curl.

Pré-requisitos

Para completar este guia, você deve ter o seguinte:

• Um servidor AlmaLinux 9.
• Um usuário não-root com privilégios de administrador.
• Um SELinux em modo permissivo.

Configurando o Repositório do Apache CouchDB

O Apache CouchDB é um banco de dados NoSQL multiplataforma que pode ser instalado em Linux, Windows, macOS e FreeBSD, e em tecnologias de contêiner como Docker e Kubernetes. Para distribuições baseadas em RHEL, você instalará o CouchDB a partir do repositório oficial via DNF.

Primeiro, execute o seguinte comando para instalar o dnf-plugins-core no seu servidor AlmaLinux.

sudo dnf install dnf-plugins-core -y

Adicione o repositório do Apache CouchDB ao seu sistema usando o seguinte comando

sudo dnf config-manager --add-repo https://couchdb.apache.org/repo/couchdb.repo

Agora, execute o comando dnf abaixo e verifique os repositórios disponíveis no seu sistema. Certifique-se de que o repositório do Apache CouchDB foi adicionado.

sudo dnf repolist

Após adicionar o repositório, instale o pacote Apache CouchDB usando o comando dnf abaixo.

sudo dnf install couchdb

Digite y e pressione ENTER para prosseguir.

Além disso, quando solicitado sobre a chave GPG do Apache CouchDB, digite y para adicionar a chave ao seu sistema.

Uma vez que a instalação estiver concluída, prossiga.

Instalando o Apache CouchDB via Repositório

Após instalar o CouchDB via DNF, você modificará a configuração padrão do CouchDB, configurará o cluster de nó único, configurará o usuário administrador e a senha, e então configurará o endereço HTTP com um endereço IP local do servidor.

Abra a configuração padrão /opt/couchdb/etc/local.ini usando o comando do editor nano.

sudo nano /opt/couchdb/etc/local.ini

Dentro da seção ‘[couchdb]‘, adicione a seguinte linha para configurar o Apache CouchDB como nó único.

[couchdb]  
single_node=true

Salve e feche o arquivo quando terminar.

Em seguida, crie uma nova configuração /opt/couchdb/etc/local.d/10-admins.ini usando o seguinte comando do editor nano.

sudo nano /opt/couchdb/etc/local.d/10-admins.ini

Adicione a configuração abaixo ao arquivo e certifique-se de alterar o usuário administrador e a senha com seus dados. Esta senha em texto simples será criptografada automaticamente ao executar o Apache CouchDB.

[admins]  
admin = password

Salve e feche o arquivo quando terminar.

Agora abra a configuração padrão /opt/couchdb/etc/default.ini usando o comando do editor nano abaixo.

sudo nano /opt/couchdb/etc/default.ini

Dentro da seção ‘[chttpd]‘, altere o ‘ bind_address ‘ padrão para o seu endereço IP local. Isso permite que você acesse a partir do seu computador local.

[chttpd]  
bind_address = 192.168.5.50

Salve e feche o arquivo quando terminar.

Depois disso, execute o comando systemctl abaixo para iniciar e habilitar o serviço couchdb.

sudo systemctl start couchdb  
sudo systemctl enable couchdb

Por fim, verifique o serviço couchdb usando o comando abaixo para garantir que o serviço está em execução.

sudo systemctl status couchdb

Se o couchdb estiver em execução, você deve obter a saída como ‘ active (running) ‘.

Configurando o Firewalld

Agora que o CouchDB está em execução, você configurará o firewalld para abrir as portas 5984/tcp e 4369/tcp e permitir o acesso à sua instalação do Apache CouchDB.

Execute o seguinte comando para abrir as portas 5984/tcp e 4369/tcp para o Apache CouchDB.

sudo firewall-cmd --permanent --add-port={5984/tcp,4369/tcp}

Recarregue o firewalld para aplicar suas alterações.

sudo firewall-cmd --reload

Em seguida, verifique a lista de portas disponíveis no firewalld usando o comando abaixo. Certifique-se de que as portas 5984/tcp e 4369/tcp estão disponíveis.

sudo firewall-cmd --list-all

Por fim, execute o comando curl abaixo para verificar o Apache CouchDB.

curl http://192.168.5.50:5984/

Ou, você pode instalar ‘jq‘ via DNF e analisar a saída JSON para torná-la legível.

sudo dnf install -y

Analise a saída JSON usando o comando assim:

curl http://192.168.5.50:5984/ | jq .

Se sua instalação do CouchDB for bem-sucedida, você deve obter o seguinte.

Acessando a Administração Web do Apache CouchDB

Neste ponto, você configurou o Apache CouchDB e o firewalld, e está pronto para acessar a instalação do CouchDB.

Para acessar o Apache CouchDB, visite o endereço IP do seu servidor seguido da porta 5984 (ou seja: http://192.168.5.50:5984/_utils#setup) usando seu navegador web favorito. Você deve obter a página de login do Apache CouchDB.

Digite seu usuário administrador e senha, em seguida, clique em Login.

Se você tiver o nome de usuário e a senha corretos, você deve obter o painel de administração do Apache CouchDB.

Gerenciando Banco de Dados no Apache CouchDB

Agora que você fez login no painel de administração do Apache CouchDB, o próximo passo é aprender como criar um banco de dados e inserir dados no CouchDB via interface web e API HTTP com Curl.

Gerenciamento de Operações Básicas via Interface Web

Antes de começar, certifique-se de que você está logado no painel de administração do Apache CouchDB.

Primeiro, você criará um novo banco de dados via a interface web do Apache CouchDB:

Clique no menu Databases e clique no botão Create Database.

Digite o nome do novo banco de dados e clique em Create.

Agora que você criou um banco de dados no Apache CouchDB, clique no nome do seu banco de dados.

Para criar um novo documento, clique no botão Create Document.

Digite seus dados JSON e, em seguida, clique em Create Document para confirmar.

{  
     "item": "apple",  
   "prices": {  
       "Fresh Mart": 1.59,  
       "Price Max": 5.99,  
       "Apples Express": 0.79  
   }  
}

Uma vez que o documento é criado, você deve obter o resultado ‘ Saving document ‘.

Nos detalhes do seu banco de dados, clique na aba Table, e você deve ver o documento JSON que você criou.

Se você precisar modificar o documento, clique no nome do documento, edite seu documento e, em seguida, clique em Save Changes. Além disso, você pode excluir documentos a partir daí com o botão de exclusão no menu à direita.

Operações Básicas de Banco de Dados com Curl

Na seção seguinte, você aprenderá como criar um banco de dados e inserir dados no Apache CouchDB via API HTTP usando Curl.

Primeiro, execute o seguinte comando para autenticar-se no Apache CouchDB e listar os bancos de dados disponíveis via curl. Certifique-se de alterar o usuário administrador e a senha com seus dados.

curl -X GET http://admin:[email protected]:5984/_all_dbs | jq .

Se bem-sucedido, você deve ver o banco de dados fruits que você criou via a interface web disponível.

Agora, crie um novo banco de dados CouchDB usando a opção PUT em um curl como o seguinte.

curl -X PUT http://admin:[email protected]:5984/players | jq .

Uma vez que o banco de dados é criado, você deve obter uma saída como a seguinte:

Uma vez que o banco de dados é criado, verifique os detalhes do banco de dados players usando o comando abaixo.

curl -X GET http://admin:[email protected]:5984/players | jq .

A seguinte saída será exibida:

Em seguida, para criar um novo documento e inserir dados no CouchDB, use o seguinte comando curl.

curl -X PUT http://admin:[email protected]:5984/players/documents \  
-d '{"Name": "Nikola Jokic", "Team": "Denver Nuggets"}' | jq .

Quando bem-sucedido, você deve obter a saída ‘“ ok“: true’.

Verifique os detalhes do seu documento usando o comando abaixo. Você deve ver que seu documento está disponível no Apache CouchDB.

curl -X GET http://admin:[email protected]:5984/players/documents

Você deve ver os dados que você adicionou, como os seguintes.

Conclusão

Parabéns! Você instalou com sucesso o Apache CouchDB no servidor AlmaLinux 9. Você também configurou um cluster de nó único, adicionou um usuário administrador e senha, e também configurou o CouchDB para rodar no endereço IP interno.

Além disso, você também aprendeu como criar um novo banco de dados e inserir dados no CouchDB via interface web e API HTTP com Curl. Agora, você pode adicionar mais nós e configurar um cluster Apache CouchDB para maximizar seu desempenho.