网站搭建吧,网络维护人员是做什么的,制作网站图文教程,旅游网站建设 策划书随着技术的成熟和 AI 的崛起#xff0c;很多原本需要团队协作才能完成的工作现在都可以通过自动化和智能化的方式完成。于是乎#xff0c;单个开发者的能力得到了极大的提升 - 借助各种工具#xff0c;一个人就可以完成开发、测试、运维等整条链路上的工作#xff0c;渡劫飞…随着技术的成熟和 AI 的崛起很多原本需要团队协作才能完成的工作现在都可以通过自动化和智能化的方式完成。于是乎单个开发者的能力得到了极大的提升 - 借助各种工具一个人就可以完成开发、测试、运维等整条链路上的工作渡劫飞升成为真正的 “全干工程师”。
之前我们分享过一些入门级的 Hello World 教程。今天我想通过一个实际的业务案例来展示 Devbox 并非只能开发玩具而是一个真正的生产力工具。
Sealos 平台上有很多应用其中很多管控层面的应用都是使用 Cursor Go Next.js 开发的。我们的开发环境直接使用 Sealos Devbox上线也是通过 Devbox 一键完成。这种开发模式让我们团队拥有了非常高效的作战能力 - 大部分重复性工作都通过自动化或 AI 完成让开发者可以专注于核心业务逻辑。 以 Sealos 中的 AI Proxy 应用为例这是一个典型的前后端分离架构的应用主要由两部分组成
基于 Next.js 开发的前端应用和 BFF 层。BFF 层负责用户鉴权并将经过验证的请求转发给后端服务。使用 Golang 开发的后端服务负责核心业务逻辑包括 token 存储、日志记录和请求转发等功能。 接下来我将详细介绍如何高效地开发这样一个生产级别的系统。
Golang 后端
创建开发环境
首先在 Sealos Cloud 中打开 Debox 应用创建一个新项目选择 Go 作为运行环境选择 1.23 版本。 Devbox 为开发者提供了几个非常实用的功能
灵活的资源配置可以根据项目需求自由调整 CPU 和内存选择合适配置既保证性能又能控制成本。一键启用 HTTPS系统自动分配安全域名再也不用为配置 SSL 证书发愁。全自动域名管理从开发到测试环境域名配置全程由系统处理开发者可以专注于代码本身。
创建完成后几秒钟即可启动开发环境。
环境准备好后我们直接用 Cursor 连接开发环境。在操作选项中选择使用 Cursor 连接 首次打开会提示安装 Devbox 插件安装后即可自动连接开发环境。 导入项目到 Cursor
首先 Fork Sealos 源码到自己的仓库然后再将你自己的仓库克隆到 Devbox 开发环境 测试环境开发
在 Cursor 的面板中切换到 “Databse” 标签页然后点击箭头指向的按钮在浏览器中打开 Sealos 的数据库应用 然后创建 PostgreSQL 和 Redis 实例。 回到 Cursor 面板的 “Database” 标签页点击刷新即可看到刚创建的数据库实例点击可复制连接信息 在终端中启动服务
export ADMIN_KEYsealos-admin
export SQL_DSN复制的pgsql连接串/postgres
export REDIS_CONN_STRING复制的redis连接串
go run . --port 8080
提示 server stared 即为启动成功 在 Cursor 面板的 “Network” 标签页中点击地址栏右侧的 按钮然后在弹窗中选择 “Copy”将地址复制到自己电脑上使用 curl 进行测试
curl https://mmznjndvzdrv.sealoshzh.site/api/status -H Authorization: sealos-admin 接口返回没有问题。
优化数据库设计
在开发过程中我们发现数据库中 Group 和 Token 之间的外键约束增加了系统维护的复杂度。为了简化这一关系我们可以将外键约束改为程序层面的显式调用这样可以让代码逻辑更加清晰和可控。
首先切换到 fix-aiproxy 分支 在 sealos/service/aiproxy/model/group.go 文件中我们需要将 Group 结构体中一个外键约束改成在程序内显示调用更新和删除来降低维护心智。
这里我选择使用 Cursor 的 Chat 功能让 AI 自己写代码最后生成的结果如下 这种实现方式的优势在于当删除 Group 时相关的 Token 删除操作会在同一个事务中完成。由于是在事务内进行我们不需要担心删除失败或系统宕机导致的数据不一致问题。
我们可以通过一系列测试来验证这个优化是否达到预期效果。首先编译并运行服务
go build . ./aiproxy --port 8080
然后通过以下 API 调用来测试完整的 Group 和 Token 生命周期
# 创建一个group
curl https://gawavirgsomu.sealosbja.site/api/group/ -H Authorization: sealos-admin -d {id: ns-admin
}# 创建一个token
curl https://gawavirgsomu.sealosbja.site/api/token/ns-admin -H Authorization: sealos-admin -d {name: token 1
}# 查询token
curl https://gawavirgsomu.sealosbja.site/api/tokens/ -H Authorization: sealos-admin# 删除group
curl https://gawavirgsomu.sealosbja.site/api/group/ns-admin -H Authorization: sealos-admin -X DELETE# 再次查询token
curl https://gawavirgsomu.sealosbja.site/api/tokens/ -H Authorization: sealos-admin 测试结果符合预期确认优化方案可行。接下来我们就可以提交这些更改并创建 Pull Request 了。
上线到生产环境
首先在 Cursor 目录顶层的 endpoint.sh 中设置启动命令在文件中添加以下启动配置
cd sealos/service/aiproxy
export ADMIN_KEYsealos-admin
# 可以再创建一个单独的生产环境数据库与开发环境隔离
export SQL_DSN复制的pgsql连接串/postgres
export REDIS_CONN_STRING复制的redis连接串
# 使用编译好的二进制文件
./aiproxy --port 8080 然后来到 Devbox 发布页面发布版本 点击发布按钮后等待发布流程完成。发布成功后点击 “上线” 按钮进入部署页面然后点击 “部署应用” 即可 部署完成后进入应用的详情页面等待应用变成 running 状态然后复制公网地址 这个公网地址就是生产环境的域名我们可以使用生产环境的域名进行测试
# 这里使用的是生产环境的域名
curl https://jpesudzryuhp.sealosbja.site/api/tokens/ -H Authorization: sealos-admin 完美
Next.js 前端
前端项目搭建
前端环境的搭建与后端类似具体步骤如下
在 Devbox 中创建一个 Node.js 环境版本选择 20端口改成 3000。由于 pnpm 安装依赖比较消耗资源建议选择 4c 16G 的配置。然后克隆你自己 Fork 的 Sealos 仓库git clone https://github.com/xxx/sealos.git。AI Proxy 的前端代码位于 sealos/frontend/providers/aiproxy 目录。 切换到 sealos/frontend 目录首先修改 sealos/frontend/package.josn 文件去除 node 版本限制直接删除 node: 20.4.0 和 pnpm: 8.9.0 这两行即可这一步很重要不然代码构建依赖会不成功。 执行命令 pnpm i 安装依赖。 执行命令 pnpm -r --filter ./packages/client-sdk run build 构建 client-sdk 包。 为了让 Cursor 的 i18n 插件正常工作我们需要将项目根目录切换到 sealos/frontend/providers/aiproxy 切换目录后建议安装所有 recommended 插件以获得最佳的开发体验 之前只是构建出了 Sealos Desktop SDK并没有安装 aiproxy 的依赖aiproxy 的依赖需要在 aiproxy 工作目录下 sealos/frontend/providers/aiproxy 进行安装。直接执行命令 pnpm i 安装即可
对接后端环境
项目搭建完成后我们需要配置环境变量来对接后端服务。在项目根目录创建一个 .env 文件需要配置以下几个关键变量
NEXT_PUBLIC_MOCK_USER
AI_PROXY_BACKEND_KEY
APP_TOKEN_JWT_KEYtest123
AI_PROXY_BACKEND
AI_PROXY_BACKEND_INTERNAL
ADMIN_NAMESPACES
NEXT_PUBLIC_MOCK_USER由于 AI Proxy 是 Sealos Desktop 的一部分用户认证通过 JWT Token 实现AI Proxy 只做解析 TokenJWT Token 的签发由 Sealos Desktop 完成。在开发阶段我们需要 mock 一个 JWT Token。NEXT_PUBLIC_MOCK_USER 的值就是 mock 出来的 JWT Token。可以使用在线工具 https://www.lddgo.net/encrypt/jwt-generate 生成。 mock 数据如下 {workspaceId : test
} APP_TOKEN_JWT_KEYJWT Token 的密钥 (随便写) AI_PROXY_BACKEND_KEY后端 API 的访问密钥 (也就是后端项目的 ADMIN_KEY) AI_PROXY_BACKEND后端服务的公网地址 AI_PROXY_BACKEND_INTERNAL后端服务的内网地址 (开发测试阶段可以不填) ADMIN_NAMESPACES管理员用户名开发时填 test 就行和 token 中的 “workspaceId”“test” 保持一致
环境变量配置完成后运行 pnpm dev 即可启动开发服务器。项目的发布和部署流程与前面介绍的后端开发流程完全一致。 总结
Sealos AI Proxy 前端项目采用了经典的 Next.js App Router 架构其中 app/[lng] 目录用于页面路由app/api 目录则用于后端 API 路由。
在这个项目中Next.js 的后端实际上是一个中间层它主要负责用户认证相关的业务逻辑并将经过认证的请求转发给真正的 Golang 后端服务。这种分层设计可以让 Golang 后端专注于核心业务逻辑不需要关心认证等基础设施从而提高了代码的灵活性和可移植性。
