NewsBlur
1.0.0
* Docker
* Docker-compose
Cloner ce dépôt
Exécutez make nb pour créer tous les conteneurs NewsBlur. Cela configurera toutes les bases de données nécessaires, les applications Django frontales, les tâches de céleri, les applications de nœuds, le moniteur et les métriques de base de données Flask, nginx et un équilibreur de charge haproxy.
Accédez à :
https://localhost
Remarque : Vous serez averti que vous utilisez un certificat auto-signé. Afin de contourner cet avertissement, vous devez taper « thisisunsafe » conformément à ce billet de blog.
Exécutez le script de domaine personnalisé
bash ./utils/custom_domain.sh <domain name>
Ce script fera ce qui suit :
NEWSBLUR_URL et SESSION_COOKIE_DOMAIN dans newsblur_web/docker_local_settings.pyconfig/fixtures/bootstrap.json Vous pouvez également changer de domaine : bash ./utils/custom_domain.sh <old domain> <new domain>
Si vous utilisez un sous-domaine personnalisé, vous souhaiterez également l'ajouter à ALLOWED_SUBDOMAINS dans apps/reader/views.py
Un moyen de vous assurer que vous avez mis à jour tous les bons endroits :
Si la chaîne après Domain= n'est pas le domaine que vous utilisez pour accéder au site Web, votre configuration a toujours besoin de votre domaine personnalisé.
Vous pouvez également confirmer qu'il existe une incompatibilité de nom de domaine dans la base de données en exécutant make shell et en tapant Site.objects.all()[0] pour afficher le domaine attendu par NewsBlur.
Pour que docker-compose fonctionne avec votre base de données, mettez à niveau votre base de données locale vers la version docker-compose, puis volumisez le chemin des données de la base de données en modifiant la partie ./docker/volumes/ de la directive volume dans le service pour pointer vers celui de votre base de données locale. répertoire de données.
Pour que docker-compose fonctionne avec une ancienne version de base de données, modifiez la version de l'image du service de base de données dans le fichier docker-compose.
Apporter des modifications :
make .make rebuild .make nb . Ajout de packages Python : actuellement, le fichier docker-compose.yml utilise l'image newsblur/newsblur_python3. Il est construit à l'aide du Dockerfile trouvé dans docker/newsblur_base_image.Dockerfile . En raison de la façon dont l'image Docker est configurée, vous devrez créer votre propre image et demander à votre fichier docker-compose.yml de l'utiliser. Veuillez suivre les étapes suivantes pour ce faire.
image: newsblur/newsblur_python3build: context: . dockerfile: docker/newsblur_base_image.Dockerfilemake nb pour reconstruire vos conteneurs docker-composeDébogage de Python
import pdb; pdb.set_trace() dans le code Python où vous souhaitez démarrer le débogage et exécuter make puis make debug .Utiliser le shell Django dans Docker
make shell pour ouvrir le shell Django dans le conteneur newsblur_web.NewsBlur est livré avec une suite de tests qui teste les fonctionnalités du rss_feeds, du lecteur et de l'importateur de flux. Pour exécuter la suite de tests :
`make test`
Les tests de performances utilisent l'outil de test de performances Locust. Pour exécuter des tests de performances via CLI, utilisez make perf-cli users=1 rate=1 host=https://localhost . N'hésitez pas à modifier les variables d'utilisateurs, de taux et d'hôte dans la commande pour répondre à vos besoins.
Vous pouvez également exécuter des tests de performances Locust à l'aide d'une interface utilisateur en exécutant make perf-ui , puis en accédant à http://127.0.0.1:8089. Cela vous permet de tracer et d'exporter vos données de performances.
Pour exécuter Locust à l'aide de Docker, exécutez simplement make perf-docker et accédez à http://127.0.0.1:8089
NewsBlur est sous licence MIT. (Voir LICENCE)
