技術標籤：專案管理linuxdockercentos伺服器運維

Sentry 平臺部署及維護

一、環境

單臺伺服器
https://github.com/getsentry/onpremise

Requirements

Docker 19.03.6+
Compose 1.24.1+
8 GB RAM
Python 3.6.8 (預設安裝需要3，指定引數也能裝2的)

二、部署步驟

1、安裝docker環境
參考：略

2、安裝 docker-compose
文件：https://docs.docker.com/compose/install/

sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
docker-compose --version
 

3、部署sentry

git clone https://github.com/getsentry/onpremise.git
cd onpremise

4、修改配置檔案
cd到專案目錄，配置檔案均在sentry資料夾內，環境變數檔案env在專案跟目錄下

sentry/config.example.yml
sentry/sentry.conf.example.py
.env                                  #規定了下載哪個版本的sentry，預設是最新開發版

第一次啟動時，請在以上三個檔案內修改，當執行./install.sh 後，會生成新的配置檔案

config.yml
sentry.conf.py
 

後續就只更改以上兩個配置檔案

config.yml
設定郵箱，其他配置可酌情設定，預設mailbackend python3 寫法如下。2和3的寫法不同要注意
mail.backend: 'django_smtp_ssl.SSLEmailBackend' # Use dummy if you want to disable email entirely
mail.host: 'smtp.exmail.qq.com'
mail.port: 465
mail.username: '****@qq.com'
mail.password: '********'
mail.use-tls: true              #這個配置注意，如果配置還是不能傳送郵件，改為false
The email address to send on behalf of
mail.from: '****@qq.com'
 

郵箱密碼為客戶端授權密碼！不是登入密碼，在企業郵箱中設定

5、安裝
./install.sh （不推薦，安裝的是最新dev版）

安裝指定版本

SENTRY_IMAGE=getsentry/sentry:21.1.0 ./install.sh 

中間要求輸入郵箱和密碼

[[email protected] onpremise]# SENTRY_IMAGE=getsentry/sentry:21.1.0 ./install.sh
…
Created internal Sentry project (slug=internal, id=1)

Would you like to create a user account now? [Y/n]: y
Email: ****@qq.com
Password:

6、啟動
啟動

 docker-compose up -d

重啟

docker-compose restart

重啟部分，載入配置檔案（當修改config.yml或者sentry.conf.py）

docker-compose restart web worker cron sentry-cleanup

6.1 載入配置

第一種方法

進入容器sentry_onpremise_worker_1，直接編輯配置檔案，然後重啟docker。重啟後更改的配置檔案會直接拷貝到宿主機當時安裝sentry專案根目錄下的sentry資料夾

[[email protected] containers]# docker exec -it cd77d876d944 bash
[email protected]:/# cd /etc/sentry/
[email protected]:/etc/sentry# ls
Dockerfile config.example.yml config.yml config.yml_default requirements.example.txt requirements.txt sentry.conf.example.py sentry.conf.py
 
 
[[email protected] containers]# docker restart cd77d876d944

第二種方法

更改./install.sh 指令碼所在目錄下sentry資料夾內的配置檔案，使用 docker-compose restart web worker cron sentry-cleanup 載入配置檔案

第一種方法不是很推薦，因為更改配置後web頁面上還是會顯示舊的引數，但不影響使用！使用第二種訪問web頁面會正常顯示

7、訪問

http://127.0.0.1:9000

sentry是不帶ssl的，需要自行搭建nginx

三、問題

1、SMTPAuthenticationError: (535, b’Error: authentication failed’)
請檢查郵箱密碼是否正確

2、ModuleNotFoundError: No module named ‘django_smtp_ssl’
缺少模組,安裝

docker ps

CONTAINER ID IMAGE                  COMMAND                 CREATED     STATUS      PORTS                NAMES
eef28970d99b nginx:1.16             "nginx -g 'daemon of…" 3 weeks ago Up 21 hours 0.0.0.0:9000->80/tcp sentry_onpremise_nginx_1
b402b93d506c sentry-onpremise-local "/bin/sh -c 'exec /d…" 3 weeks ago Up 21 hours 9000/tcp             sentry_onpremise_web_1
cd77d876d944 sentry-onpremise-local "/bin/sh -c 'exec /d…" 3 weeks ago Up 21 hours 9000/tcp             sentry_onpremise_worker_1

有兩個地方需要安裝模組
sentry_onpremise_web_1 測試郵件功能在這個容器
sentry_onpremise_worker_1 郵件收發在work節點

docker exec -it b402b93d506c bash
pip install django-smtp-ssl
 
docker exec -it cd77d876d944 bash
pip install django-smtp-ssl

3、 獲取客戶端ip

架構上是 nginx —> sentry ，前面加了一個nginx ，而sentry本身是有nginx 的，所以sentry 的自動nginx配置需要修改下

配置再 安裝目錄 nginx/nginx.conf

更改新增如下配置

proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Request-Id $request_id;

set_real_ip_from 172.21.0.1;           # br網絡卡ip
real_ip_header X-Forwarded-For;
real_ip_recursive on;

然後進入sentry nginx容器 reload

四、備份

參考：

https://github.com/getsentry/onpremise/issues/364
https://docs.docker.com/storage/volumes/#backup-restore-or-migrate-data-volumes

由於是通過docker-compose安裝的，只需要備份邏輯卷

檢視所有邏輯卷 docker volume ls

DRIVER    VOLUME NAME
local     sentry-clickhouse
local     sentry-data
local     sentry-kafka
local     sentry-postgres
local     sentry-redis
local     sentry-symbolicator
local     sentry-zookeeper
local     sentry_onpremise_sentry-clickhouse-log
local     sentry_onpremise_sentry-kafka-log
local     sentry_onpremise_sentry-secrets
local     sentry_onpremise_sentry-smtp
local     sentry_onpremise_sentry-smtp-log
local     sentry_onpremise_sentry-zookeeper-log

需要備份邏輯卷

local     sentry-clickhouse
local     sentry-data
local     sentry-kafka
local     sentry-postgres              大多數資料都在Postgres中  
local     sentry-redis
local     sentry-symbolicator
local     sentry-zookeeper

docker exec -t $POSTGRES_CONTAINER_NAME pg_dump -c -U postgres postgres | gzip > $BACKUP_PATH

官方後續會推出 sentry 備份方案