À propos du projet
Apache CouchDB est un projet de base de données open-source sous la Fondation Apache Software. Il est décrit comme une base de données de synchronisation multi-primaire transparente avec une API HTTP/JSON intuitive, conçue pour la fiabilité. Le README se concentre sur l'installation, la documentation, la vérification, la configuration de développement et les conseils de contribution plutôt que de détailler l'architecture interne.
Les instructions d'installation sont divisées par plateforme : INSTALL.Unix couvre les systèmes de type Unix, y compris macOS et Ubuntu, tandis que INSTALL.Windows couvre Microsoft Windows. Les utilisateurs sont invités à suivre le guide approprié pour leur système. En cas de problème, le README renvoie à une section de dépannage dans la documentation officielle.
La documentation est hébergée sur docs.couchdb.org et comprend un journal des modifications sous la section « whatsnew ». Des conseils de dépannage pour les messages d'erreur cryptiques sont disponibles sur la page install/troubleshooting. Pour une aide générale, le projet renvoie à ses listes de diffusion et à un canal IRC sur Libera.Chat (#couchdb). Les listes de diffusion sont décrites comme une source de soutien et de connaissances, et le site web officiel fournit plus d'informations sur les ressources communautaires.
Pour vérifier une installation, le README suggère d'exécuter une suite de tests de base en naviguant vers l'URL locale Fauxton à http://127.0.0.1:5984/_utils/#verifyinstall.
Pour le développement, le README propose deux voies. Un démarrage rapide utilise un badge VS Code Remote - Containers qui, lorsqu'il est cliqué, installe l'extension Remote - Containers si nécessaire, clone la source dans un volume de conteneur et démarre un conteneur de développement. Ce devcontainer exécute automatiquement ./configure && make lors de la première création, ce qui peut prendre du temps supplémentaire, mais permet ensuite d'exécuter des commandes telles que ./dev/run, ./dev/run --admin=admin:admin, ./dev/run --with-admin-party-please et make check immédiatement. Les démarrages suivants devraient être rapides.
La configuration manuelle du développement est documentée dans README-DEV.rst. En bref, les développeurs installent les dépendances nécessaires listées dans les documents d'installation, puis exécutent ./configure && make. Après compilation, make install n'est pas requis ; à la place, ./dev/run démarre trois nœuds. Une couche de cache haproxy optionnelle peut être ajoutée devant le cluster avec ./dev/run --with-haproxy --haproxy=/path/to/haproxy. Le cluster local écoute sur le port 5984. Pour les développeurs Fauxton, le README note que la correction de la fête admin ne fonctionne pas via le bouton dans Fauxton ; à la place, exécutez ./dev/run avec le drapeau admin, par exemple ./dev/run --admin=username:password. Omettre le drapeau laisse une fête admin.
Les conseils de contribution sont disponibles dans CONTRIBUTING.md dans le dépôt. Le README reconnaît également les supporters du projet, y compris IBM Cloudant, MacStadium, Neighbourhoodie, DigitalOcean et netcup, avec des logos et des liens.
Un avis sur les logiciels cryptographiques explique que la distribution inclut des logiciels cryptographiques et que les lois locales peuvent restreindre l'importation, la possession, l'utilisation ou la réexportation. Il fait référence à l'Arrangement de Wassenaar pour plus d'informations. Le Bureau de l'industrie et de la sécurité du Département du commerce des États-Unis a classé le logiciel comme ECCN 5D002.C.1, couvrant les logiciels de sécurité de l'information utilisant ou effectuant des fonctions cryptographiques avec des algorithmes asymétriques. La forme et la manière de distribution de la Fondation Apache Software le rendent éligible à l'exportation sous l'exception de licence ENC Technology Software Unrestricted (TSU) pour le code objet et le code source. Le README note que CouchDB inclut un client HTTP (ibrowse) avec fonctionnalité SSL dans le cadre du logiciel cryptographique inclus.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.