Sobre o projeto
Apache CouchDB é um projeto de banco de dados de código aberto sob a Apache Software Foundation. É descrito como um banco de dados de sincronização multi-primária contínua, com uma API HTTP/JSON intuitiva, projetado para confiabilidade. O README foca em instalação, documentação, verificação, configuração de desenvolvimento e orientações de contribuição, em vez de detalhar a arquitetura interna.
As instruções de instalação são divididas por plataforma: INSTALL.Unix cobre sistemas Unix-like, incluindo macOS e Ubuntu, enquanto INSTALL.Windows cobre Microsoft Windows. Os usuários são direcionados a seguir o guia apropriado para seu sistema. Se ocorrerem problemas, o README aponta para uma seção de solução de problemas na documentação oficial.
A documentação está hospedada em docs.couchdb.org e inclui um changelog na seção "whatsnew". Orientações para solução de problemas de mensagens de erro crípticas estão disponíveis na página install/troubleshooting. Para ajuda geral, o projeto aponta para suas listas de discussão e um canal IRC na Libera.Chat (#couchdb). As listas de discussão são descritas como uma fonte de suporte e conhecimento, e o site oficial fornece mais informações sobre recursos da comunidade.
Para verificar uma instalação, o README sugere executar um conjunto básico de testes navegando para a URL local do Fauxton em http://127.0.0.1:5984/_utils/#verifyinstall.
Para desenvolvimento, o README oferece dois caminhos. Um quickstart usa um selo VS Code Remote - Containers que, ao ser clicado, instala a extensão Remote - Containers se necessário, clona o código-fonte em um volume de contêiner e inicia um contêiner de desenvolvimento. Este devcontainer executa automaticamente ./configure && make na primeira criação, o que pode levar tempo extra, mas depois permite executar comandos como ./dev/run, ./dev/run --admin=admin:admin, ./dev/run --with-admin-party-please e make check imediatamente. Inicializações subsequentes devem ser rápidas.
A configuração manual de desenvolvimento está documentada em README-DEV.rst. Em resumo, os desenvolvedores instalam as dependências necessárias listadas nos documentos de instalação e depois executam ./configure && make. Após a compilação, make install não é necessário; em vez disso, ./dev/run inicia três nós. Uma camada opcional de cache haproxy pode ser adicionada na frente do cluster com ./dev/run --with-haproxy --haproxy=/caminho/para/haproxy. O cluster local escuta na porta 5984. Para desenvolvedores do Fauxton, o README observa que corrigir o admin party não funciona através do botão no Fauxton; em vez disso, execute ./dev/run com o sinalizador admin, por exemplo, ./dev/run --admin=nomeusuario:senha. Omitir o sinalizador deixa um admin party.
Orientações de contribuição estão disponíveis em CONTRIBUTING.md no repositório. O README também reconhece apoiadores do projeto, incluindo IBM Cloudant, MacStadium, Neighbourhoodie, DigitalOcean e netcup, com logotipos e links.
Um aviso de software criptográfico explica que a distribuição inclui software criptográfico e que leis locais podem restringir importação, posse, uso ou reexportação. Ele referencia o Arranjo de Wassenaar para mais informações. O Departamento de Comércio dos EUA, Bureau of Industry and Security, classificou o software como ECCN 5D002.C.1, cobrindo software de segurança da informação que usa ou executa funções criptográficas com algoritmos assimétricos. A forma e maneira de distribuição da Apache Software Foundation o tornam elegível para exportação sob a Exceção de Licença ENC Technology Software Unrestricted (TSU), tanto para código objeto quanto para código-fonte. O README observa que o CouchDB inclui um cliente HTTP (ibrowse) com funcionalidade SSL como parte do software criptográfico incluído.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.