前言
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 管理界面。