在Google Cloud Platform上部署Briefer项目的完整指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00781/article/details/148549595

在Google Cloud Platform上部署Briefer项目的完整指南

briefer Dashboards and notebooks in a single place. Create powerful and flexible dashboards using code, or build beautiful Notion-like notebooks and share them with your team. 项目地址: https://gitcode.com/gh_mirrors/br/briefer

前言

Briefer是一款优秀的云原生应用，本文将详细介绍如何在Google Cloud Platform(GCP)上部署Briefer项目。通过本教程，您将学会如何创建GCE虚拟机实例、安装Docker容器环境、运行Briefer应用，以及可选地配置Nginx反向代理实现公网访问。

准备工作

在开始部署前，请确保您已具备以下条件：

有效的Google Cloud Platform账户
已开通Google Cloud Console访问权限
配置好用于访问GCP实例的SSH密钥

第一步：创建计算引擎实例

登录Google Cloud Console，导航至"Compute Engine > VM instances"
点击"Create Instance"按钮创建新实例
推荐配置如下（可根据实际需求调整）：
- vCPU核心数：2核
- 内存容量：8GB
- 磁盘空间：10GB平衡型
- IOPS：3060（预配置）
- 处理能力：155（预配置）

专家建议：上述配置适合大多数使用场景。如果您的项目规模较大或预期有高并发访问，可适当提升配置规格；反之，对于测试或开发环境，可适当降低配置以节省成本。

为实例命名后点击"Create"完成创建
实例初始化完成后，通过SSH连接到该实例

第二步：安装Docker环境

在GCE实例上执行以下命令安装Docker：

更新系统软件包：

sudo apt update && sudo apt upgrade -y

安装HTTPS仓库所需的依赖包：

sudo apt install apt-transport-https ca-certificates curl software-properties-common

添加Docker官方仓库：

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"
sudo apt update

安装Docker CE版本：

sudo apt install docker-ce -y

将当前用户加入docker用户组：

sudo usermod -aG docker ${USER}

验证Docker安装是否成功：

docker ps

注意：执行完用户组变更后，建议重新登录SSH会话使变更生效。

第三步：运行Briefer应用

安装完成Docker后，使用以下命令启动Briefer容器：

docker run -d \
  -p 3000:3000 \
  -v briefer_psql_data:/var/lib/postgresql/data \
  -v briefer_jupyter_data:/home/jupyteruser \
  -v briefer_briefer_data:/home/briefer \
  briefercloud/briefer

参数说明：

-d：后台运行容器
-p 3000:3000：将容器3000端口映射到主机3000端口
-v：挂载数据卷，确保数据持久化

验证Briefer是否正常运行：

curl http://<您的公网IP>:3000

安全警告：默认情况下，Briefer不允许通过HTTP协议访问。如需临时启用HTTP访问，需在docker run命令中添加--env ALLOW_HTTP=true参数。生产环境强烈建议配置SSL证书使用HTTPS协议。

第四步（可选）：配置Nginx反向代理

为实现更专业的公网访问方案，建议配置Nginx作为反向代理：

安装Nginx：

sudo apt install nginx -y
sudo systemctl start nginx
sudo systemctl enable nginx

创建Nginx配置文件：

sudo nano /etc/nginx/sites-available/briefer

推荐配置内容如下：

server {
    listen 80;
    server_name _;
    client_max_body_size 0;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_request_buffering off;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
    }
}

启用配置并重启Nginx：

sudo ln -s /etc/nginx/sites-available/briefer /etc/nginx/sites-enabled/
sudo rm /etc/nginx/sites-enabled/default
sudo nginx -t
sudo systemctl restart nginx

配置完成后，Briefer将通过80端口提供服务，无需在URL中指定3000端口。