自托管Sentry文档翻译

大部分翻译出来了，部分翻译的不是很通顺，可以结合官方文档阅读。

Sentry除了开源代码之外，还提供并维护了一个最小的设置，对于简单的用例来说，它是现成的. 同时对于展示相关的配置和有用。简单起见，我们采用 Docker和Docker Compose, 并提供安装、升级脚本.

开始

我们的建议是下载 最新的self-hosted repository, 然后运行在目录中 ./install.sh . 它会完成所有的东西, 包括一个基础的配置, 然后让你运行 docker-compose up -d 启动 Sentry. Sentry 默认绑定 9000 端口. 访问 http://127.0.0.1:9000.

配置

1. sentry/config.yml—包含大部分的配置. 这个文件在安装的时候，根据sentry/config.example.yml 生成. 这文件大部分配置都有注释说明。 下面是以下常用配置:

   1. system.url-prefix (安装完成后，我们会提示您在欢迎屏幕上进行设置)

   2. mail.* (虽然我们提供了一个基本的SMTP服务器)

   3. GitHub, Slack 等的集成.

2. sentry/sentry.conf.py—包含更多高级配置. 这个文件在安装的时候，根据 sentry/sentry.conf.example.py 生成.

3. 环境变量—可用的 keys 定义在 .env. 在这里定义的环境变量，会覆盖默认值。避免 Git 改变, 只需创建一个 .env.custom 文件，并写入你的系统依赖的环境变量. 你可以通过运行 docker-compose --env-file /path/to/.env.custom up -d实现.

4. Geolocation 使用一个自定义的配置文件，适应基础技术 

更多的配置：the configuration section of our developer documentation.

注意

一旦你改变了配置, 你需要重启Sentry 服务，通过运行 docker-compose restart web worker cron sentry-cleanup (或者 docker-compose restart 重启所有的东西).

配置主题

以下是与自托管相关的特定配置主题的进一步信息：

• Custom CA Roots
• Email
• Geolocation
• Single Sign-On (SSO)

生产

我们建议在你的sentry之前，使用一个专用的负载均衡器，绑定特定的域名或者子域名. 一个负载均衡器作为 SSL/TLS 终端和作为Docker Compose内部网络 转发客户端地址，将给你很好的 Sentry 体验. 我们建议配置一个负载均衡健康检查，使用http协议检查 /_health/. 正常返回200错误返回 500.

如果你为sentry设置了负载均衡或者反向代理, 你需要修改 config.yml中的system.url-prefix。 你还要更新sentry/sentry.conf.py中的 SSL/TLS , 否则，你可能会遇到 CSRF-related 错误 

所有配置都是单节点的，官方不提供扩展方面的支持，如果流量比较高，需要用官方的服务。