* Docker
* Docker-compose
Клонировать этот репозиторий
Запустите make nb
, чтобы собрать все контейнеры NewsBlur. Это позволит настроить все необходимые базы данных, интерфейсные приложения django, задачи celery, приложения узлов, монитор и метрики базы данных flask, nginx и балансировщик нагрузки haproxy.
Перейдите к:
https://localhost
Примечание. Вас предупредят, что вы используете самозаверяющий сертификат. Чтобы обойти это предупреждение, вы должны ввести «thisisunsafe», как указано в этом сообщении в блоге.
Запустите скрипт личного домена
bash ./utils/custom_domain.sh <domain name>
Этот скрипт сделает следующее:
NEWSBLUR_URL
и SESSION_COOKIE_DOMAIN
в newsblur_web/docker_local_settings.py
config/fixtures/bootstrap.json
Вы также можете изменить домены: bash ./utils/custom_domain.sh <old domain> <new domain>
Если вы используете собственный поддомен, вам также необходимо добавить его в ALLOWED_SUBDOMAINS
в apps/reader/views.py
Способ убедиться, что вы обновили все правильные места:
Если строка после Domain=
не является доменом, который вы используете для доступа к веб-сайту, то для вашей конфигурации все равно нужен личный домен.
Вы также можете убедиться, что в базе данных есть несоответствие доменного имени, запустив make shell
и набрав Site.objects.all()[0]
чтобы показать домен, который ожидает NewsBlur.
Чтобы docker-compose работал с вашей базой данных, обновите локальную базу данных до версии docker-compose, а затем увеличьте объем пути к данным базы данных, изменив часть ./docker/volumes/
директивы тома в службе, чтобы она указывала на вашу локальную базу данных. каталог данных.
Чтобы docker-compose работал со старой версией базы данных, измените версию образа службы базы данных в файле docker-compose.
Внесение изменений:
make
.make rebuild
.make nb
. Добавление пакетов Python. В настоящее время файл docker-compose.yml использует изображение newsblur/newsblur_python3. Он создан с использованием файла Dockerfile, найденного в docker/newsblur_base_image.Dockerfile
. Из-за того, как настроен образ Docker, вам нужно будет создать свой собственный образ и указать файлу docker-compose.yml использовать его. Для этого выполните следующие действия.
image: newsblur/newsblur_python3
build: context: . dockerfile: docker/newsblur_base_image.Dockerfile
make nb
, чтобы перестроить контейнеры, созданные для docker.Отладка Python
import pdb; pdb.set_trace()
в код Python, где вы хотите начать отладку, и запустите make
, а затем make debug
.Использование оболочки Django в Docker
make shell
, чтобы открыть оболочку Django в контейнере newsblur_web.NewsBlur поставляется в комплекте с набором тестов, который проверяет функциональность rss_feeds, программы чтения и импортера каналов. Чтобы запустить набор тестов:
`make test`
В тестах производительности используется инструмент тестирования производительности Locus. Чтобы запустить тесты производительности через CLI, используйте make perf-cli users=1 rate=1 host=https://localhost
. Не стесняйтесь изменять переменные пользователей, скорости и хоста в команде в соответствии с вашими потребностями.
Вы также можете запустить тесты производительности Locust с помощью пользовательского интерфейса, запустив make perf-ui
и затем перейдя по адресу http://127.0.0.1:8089. Это позволяет вам составлять диаграммы и экспортировать данные о производительности.
Чтобы запустить locust с помощью Docker, просто запустите make perf-docker
и перейдите по адресу http://127.0.0.1:8089.
NewsBlur распространяется по лицензии MIT. (См. ЛИЦЕНЗИЮ)