简要说明
Sentry 官网：sentry.io
- Sentry 私有化部署官方 Docker 容器
- Sentry 官方推荐的自托管平台 需使用 Docker & Docker Compose。
- Windows 下需安装 Docker Desktop 即可支持 。Docker & Docker Compose
- Windows 下使用 Docker 安装 Sentry 需要 WSL 2 支持 。
WSL 2 需注意
如果运行的是 Windows 10 版本1903 或 1909，请在 Windows 菜单中打开“设置”，导航到“更新和安全性”，然后选择“检查更新”。 内部版本号必须是 18362.1049+ 或 18363.1049+，次要内部版本号需要高于 .1049。 阅读详细信息：WSL 2 即将支持 Windows 10 版本 1903 和 1909。如果系统版本不符合则需要去微软官网下载手动补丁升级。
参考：
wsl & linux
完成 wsl 2 升级后，从微软商店上下载 Ubuntu 18.04 TLS，下载完成后执行如下命令。
# 将 Ubuntu 18.04 转换为 wsl 2 内核执行。
wsl --set-version Ubuntu-18.04 2
正常安装步骤
1. 安装 Sentry 的 Docker 镜像容器
进入 wsl 后，这里有两种方式进行安装，安装需 clone 官方 Docker 容器，可按自己喜好选择。
- 在 Ubuntu 下直接 git clone 容器。
- 在 Windows git clone 容器。
1.1. Ubuntu clone
clone 完成后进入项目文件夹根目录，然后执行 ./install.sh
1.2. Windows clone
wsl 默认会将 Windows 文件夹系统挂载在根下 /mnt 目录里。
进入 clone 的项目文件夹根目录，然后执行 ./install.sh
2. 创建账号&密码
如果网络不错那么很快就会将容器安装完成，这时候会提示如下信息。
# 现在是否需要创建你的账户？默认：是
Would you like to create a user account now? [Y/n]:
# 输入邮箱
Email:
# 输入密码，注意密码输入是不可见的，所以注意大小写。输入完成后会再确认。
Password:
3. 创建完成
账号信息输入完成后，等待一会儿生成账号后就能看到 Docker Desktop 里已经安装完成了。
这时候会提示让执行启动 docker 服务。执行 docker-compose up -d 命令即可。
注意：如果执行报错则加上 sudo 赋予权限执行。
-----------------------------------------------------------------
You're all done! Run the following command to get Sentry running:
docker-compose up -d
-----------------------------------------------------------------
注意：当容器图表显示为红色/橙色的时候需要看看是否服务都启动完成了。
4. 进入 Sentry 管理页面
当容器的服务都启动完成后，找到如下服务并打开即可进入 Sentry 管理页面。
Sentry 管理页面
输入第2步创建的账号密码即可作为管理员登录系统。
Ok. 自此已经完成了 Sentry 私有化部署的安装与运行，剩下的就是依据官方文档里的配置对项目进行配置即可。
错误记录
1. An error occurred, caught SIGERR on line 8
执行 Sentry 提供的镜像 docker ./install.sh 提示错误信息如下。
▶ Parsing command line ...
▶ Initializing Docker Compose ...
▶ Setting up error handling ...
▶ Checking for latest commit ...
skipped
▶ Checking minimum requirements ...
An error occurred, caught SIGERR on line 8
Cleaning up...
优先检查 docker 是否已安装，服务是否已启动。如未安装则执行以下命令。
# 1. 安装https的过度服务包以及通用证书支持
sudo apt-get -y install apt-transport-https ca-certificates curl
# 2. 获取 docker pgp 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
# 3. 设定 docker 安装源
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
# 4. 更新软件源
sudo apt-get update
# 5. 安装 docker 客户端
sudo apt-get -y install docker-ce-cli
如已安装，则继续执行 ./install.sh 提示错误信息如下。
▶ Parsing command line ...
▶ Initializing Docker Compose ...
▶ Setting up error handling ...
▶ Checking for latest commit ...
skipped
▶ Checking minimum requirements ...
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?
An error occurred, caught SIGERR on line 8
Cleaning up...
执行添加提示内容，即是 docker 的环境变量。
vi ~/.bashrc
# 移入最后一行写入如下信息
export DOCKER_HOST='unix:///var/run/docker.sock'
2. docker: unrecognized service
使用 sudo service docker restart 重启 docker 服务时提示错误信息如下。
docker: unrecognized service
如 docker 客户端已安装且环境变量已配置的情况下执行如下命令。
sudo docker ps
执行后如出现 Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? 提示错误信息，则需要打开 Docker Desktop -> 设置，确认如下选项已启用，如果未启用则手动启用。
Apply & Restart（应用 & 重启）后执行命令
sudo docker ps
# 提示信息
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
重新执行 ./install.sh 提示错误信息如下。
▶ Parsing command line ...
▶ Initializing Docker Compose ...
▶ Setting up error handling ...
▶ Checking for latest commit ...
skipped
▶ Checking minimum requirements ...
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.24/version": dial unix /var/run/docker.sock: connect: permission denied
An error occurred, caught SIGERR on line 8
Cleaning up...
小问题，权限不够而已，直接执行 sudo ./install.sh 即可。
版权声明：
本文版权属于作者 林小帅，未经授权不得转载及二次修改。
转载或合作请在下方留言及联系方式。
