NewsBlur 다운로드 - NewsBlur 소스 코드 다운로드

NewsBlur

파이썬

1.0.0

다운로드

뉴스블러

NewsBlur는 사람들을 모아 세상에 대해 이야기하는 개인 뉴스 리더입니다. 오래된 악기의 새로운 소리.
www.newsblur.com.
사무엘 클레이가 만들었습니다.
X/트위터: @samuelclay 및 @newsblur.

특징

원본 사이트를 보여줍니다(믿으려면 직접 봐야 합니다).
태그, 키워드, 작가 등을 기준으로 읽고 싶지 않은 이야기를 숨깁니다.
동일한 기준에 따라 읽고 싶은 이야기를 강조 표시합니다.

기술

서버 측

Python 3.7+: 선택 언어입니다.
Django: Python으로 작성된 웹 프레임워크로 모든 페이지를 제공하는 데 사용됩니다.
Celery & RabbitMQ: RSS 피드를 가져오고 구문 분석하는 데 사용되는 비동기 대기열 서버입니다.
MongoDB, Pymongo 및 Mongoengine: 스토리 저장, 스토리 읽기, 피드/페이지 가져오기 기록 및 프록시 사이트에 사용되는 비관계형 데이터베이스입니다.
PostgreSQL: 피드, 구독 및 사용자 계정을 저장하는 데 사용되는 관계형 데이터베이스입니다.
Redis: 강에 대한 스토리를 수집하고, 스토리 ID를 저장하고, 피드 가져오기 일정을 관리하고, NewsBlur에서 사용하는 아주 작은 캐싱을 관리하는 데 사용되는 프로그래머 데이터베이스입니다.
Elasticsearch: 데이터베이스 검색, 스토리 검색에 사용됩니다. 선택 과목.

클라이언트 측 및 디자인

jQuery: 크로스 브라우저 호환 JavaScript 코드입니다. IE는 노력 없이 작동합니다.
Underscore.js: JavaScript용 함수형 프로그래밍. 없어서는 안될.
Backbone.js: 웹 앱용 프레임워크입니다. 또한 필수 불가결합니다.
기타 jQuery 플러그인: 크기 조정 가능한 레이아웃부터 진행률 표시줄, 정렬 가능, 날짜 처리, 색상, 모서리, JSON, 애니메이션까지 모든 것. 전체 목록을 확인하세요.

전제 조건

 * Docker
* Docker-compose

설치 지침

이 저장소 복제
make nb 실행하여 모든 NewsBlur 컨테이너를 빌드합니다. 그러면 필요한 모든 데이터베이스, 프런트엔드 django 앱, 셀러리 작업, 노드 앱, 플라스크 데이터베이스 모니터 및 메트릭, nginx 및 haproxy 로드 밸런서가 설정됩니다.
다음으로 이동하세요:
```
 https://localhost
```
참고: 자체 서명된 인증서를 사용하고 있다는 경고가 표시됩니다. 이 경고를 피하려면 이 블로그 게시물에 따라 "thisisunsafe"를 입력해야 합니다.

사용자 정의 도메인 사용

사용자 정의 도메인 스크립트 실행
```
 bash ./utils/custom_domain.sh <domain name>
```
이 스크립트는 다음을 수행합니다.
- newsblur_web/docker_local_settings.py 에서 NEWSBLUR_URL 및 SESSION_COOKIE_DOMAIN 변경합니다.
- config/fixtures/bootstrap.json 에서 도메인을 변경하세요.

도메인을 변경할 수도 있습니다: bash ./utils/custom_domain.sh <old domain> <new domain>

맞춤 하위 도메인을 사용하는 경우 apps/reader/views.py 의 ALLOWED_SUBDOMAINS 에도 추가하는 것이 좋습니다.
올바른 장소를 모두 업데이트했는지 확인하는 방법:
- 브라우저에서 웹사이트 주소로 이동하세요.
- 개발자 도구를 열고 네트워크 탭을 확인하세요.
- 로그인을 시도하세요
- 개발자 도구를 다시 살펴보면 /login에 대한 POST 호출이 있어야 합니다.
- 해당 호출에 대한 응답 헤더를 관찰하십시오.
- "set-cookie" 헤더의 값에는 "Domain=" 문자열이 포함되어야 합니다.
Domain= 뒤의 문자열이 웹 사이트에 액세스하는 데 사용하는 도메인이 아닌 경우 구성에는 여전히 사용자 정의 도메인이 필요합니다.
또한 make shell 실행하고 Site.objects.all()[0] 입력하여 NewsBlur가 예상하는 도메인을 표시함으로써 데이터베이스에 도메인 이름 불일치가 있는지 확인할 수도 있습니다.

기존 데이터베이스로 docker-compose 작업 만들기

docker-compose가 데이터베이스에서 작동하도록 하려면 로컬 데이터베이스를 docker-compose 버전으로 업그레이드한 다음 서비스에서 볼륨 지시문의 ./docker/volumes/ 부분을 로컬 데이터베이스의 경로를 가리키도록 변경하여 데이터베이스 데이터 경로를 볼륨화합니다. 데이터 디렉토리.

docker-compose가 이전 데이터베이스 버전과 작동하도록 하려면 docker-compose 파일에서 데이터베이스 서비스의 이미지 버전을 변경하세요.

기부 지침

변경:
- Python 또는 JavaScript 코드에 변경 사항을 적용하려면 make 명령을 사용합니다.
- docker-compose.yml 파일에 변경 사항을 적용하려면 make rebuild 명령을 사용하십시오.
- docker/haproxy/haproxy.conf 파일, 노드 패키지 또는 새로운 데이터베이스 마이그레이션에 변경 사항을 적용하려면 make nb 명령을 사용해야 합니다.
Python 패키지 추가: 현재 docker-compose.yml 파일은 newsblur/newsblur_python3 이미지를 사용합니다. docker/newsblur_base_image.Dockerfile 에 있는 Dockerfile을 사용하여 빌드되었습니다. Docker 이미지 설정 방법으로 인해 고유한 이미지를 생성하고 이를 사용하도록 docker-compose.yml 파일에 지시해야 합니다. 그렇게 하려면 다음 단계를 따르십시오.
1. config/requirements.txt에 새 사이트 패키지를 추가하세요.
2. docker-compose.yml 파일에 다음 코드 줄을 추가하여 image: newsblur/newsblur_python3
build: context: . dockerfile: docker/newsblur_base_image.Dockerfile
1. docker-compose 컨테이너를 다시 빌드하려면 make nb 명령을 실행하세요.
Python 디버깅
- 코드를 디버그하려면 import pdb; pdb.set_trace() 디버깅을 시작하려는 Python 코드에 import pdb; pdb.set_trace() 하고 make 실행한 다음 make debug 실행하세요.
Docker 내에서 Django 셸 사용
- docker 컨테이너가 작동 중인지 확인하고 make shell 실행하여 newsblur_web 컨테이너 내의 Django 쉘을 엽니다.

단위 및 통합 테스트 실행

NewsBlur에는 rss_feeds, 리더 및 피드 가져오기 기능을 테스트하는 테스트 모음이 함께 제공됩니다. 테스트 스위트를 실행하려면:

 `make test`

성능 테스트 실행

성능 테스트는 locust 성능 테스트 도구를 사용합니다. CLI를 통해 성능 테스트를 실행하려면 make perf-cli users=1 rate=1 host=https://localhost 사용하세요. 필요에 맞게 명령에서 사용자, 속도 및 호스트 변수를 자유롭게 변경하십시오.

make perf-ui 실행한 다음 http://127.0.0.1:8089로 이동하여 UI를 사용하여 locust 성능 테스트를 실행할 수도 있습니다. 이를 통해 성과 데이터를 차트로 작성하고 내보낼 수 있습니다.

docker를 사용하여 locust를 실행하려면 make perf-docker 실행하고 http://127.0.0.1:8089로 이동하세요.