前言

Sentry 是一个开源的全栈错误跟踪系统,支持广泛的平台。线上版本的 Sentry 是一项付费服务​​,但它也为开发者提供了免费计划。如果我们有大量项目连接到 Sentry,免费计划就不再够用,因为它每月有 5000 个 Event 的限制。可以升级到付费计划或在自己的服务器上部署 Sentry。由于 Sentry 是一个开源系统,因此可以在线获取代码以部署在您自己的基础设施上。

在这篇文章中,我们将逐步介绍在我们自己的服务器上部署 Sentinel 的步骤。

最低要求

  • Docker 19.03.6+
  • Compose 1.28.0+
  • 4 CPU Cores
  • 8 GB RAM
  • 20 GB Free Disk Space

安装 Docker

先让我们尝试输入命令 docker ,会得到“命令未找到”的提示,还有如何安装的建议:

Command 'docker' not found, but can be installed with:
sudo apt install docker.io

所以,你只需要按照系统的提示,“照葫芦画瓢”输入命令,安装 docker.io 就可以了。为了方便,你还可以使用 -y 参数来避免确认,实现自动化操作:

sudo apt install -y docker.io #安装Docker Engine

刚才说过,Docker Engine不像Docker Desktop那样可以安装后就直接使用,必须要做一些手工调整才能用起来,所以你还要在安装完毕后执行下面的两条命令:

sudo service docker start         #启动docker服务
sudo usermod -aG docker ${USER}   #当前用户加入docker组

第一个 service docker start 是启动 Docker 的后台服务,第二个 usermod -aG 是把当前的用户加入 Docker 的用户组。这是因为操作 Docker 必须要有 root 权限,而直接使用 root 用户不够安全,加入 Docker 用户组是一个比较好的选择,这也是 Docker 官方推荐的做法。当然,如果只是为了图省事,你也可以直接切换到 root 用户来操作 Docker。

安装 Docker Composer

sudo curl -SL https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-linux-x86_64 -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 来查看版本。

docker-compose version

Docker Compose version v2.20.2

安装 Sentry

使用脚本安装是最快的方法,如果需要自定义配置可以更改官方提供的脚本。

git clone https://github.com/getsentry/self-hosted sentry

上面的代码会将库克隆到名为 Sentry 的文件夹中。可以通过将命令末尾的 Sentry 更改为想要的名称来更改。然后 cd 进入刚刚创建的目录并运行以下命令开始安装过程:

./install

安装过程中,会出现提示询问我们是否要创建用户。如果想要安装不会被提示终端,可以运行:

./install.sh --skip-user-prompt

安装需要一段时间,如果安装成功你应该看到以下内容

现在我们可以运行提示的命令并且启动 Sentry

docker-compose up -d

命令执行完毕之后我们可以通过 http://{server_ip}:9000/ 来访问 Sentry

创建用户

如果在运行安装命令时使用了 --skip-user-prompt,则需要通过终端创建用户。

alias sentry="docker-compose run --rm web"
sentry createuser

总结

这篇文章我们介绍了如果在本地安装 Sentry 并快速部署,下一章我们会通过 Caddy 进行反向代理来通过域名进行访问 Sentry 管理界面。

参考

https://github.com/getsentry/self-hosted