Senate

项目

将服务组织到逻辑分组中

项目

项目帮助你将相关服务组织到逻辑分组中。使用项目管理多服务应用或分离环境。

概述

项目是一个简单的分组机制:

  • 服务可以属于一个项目
  • 项目对网络或部署没有影响
  • 纯粹用于组织——按项目筛选和查看服务

项目概述

创建项目

  1. 导航到 Projects
  2. 点击 New Project
  3. 输入项目详情:
字段描述必填
Name项目名称
Description可选描述
  1. 点击 Create

项目结构

典型项目可能包含:

my-webapp/
├── frontend     (Next.js 应用)
├── backend      (Node.js API)
├── database     (PostgreSQL)
├── cache        (Redis)
└── worker       (后台任务)

将服务分配到项目

创建服务时

  1. New Service 表单中
  2. 从下拉菜单选择项目
  3. 创建服务

对于现有服务

目前,项目分配在创建时设置。要更改服务的项目,需要重新创建服务。

查看项目服务

  1. 进入 Projects
  2. 点击一个项目
  3. 查看该项目中的所有服务

或从 Services 页面,按项目筛选。

用例

多服务应用

将单个应用的所有服务分组:

  • 前端和后端
  • API 网关
  • 数据库
  • 缓存
  • 消息队列

环境分离

为每个环境创建项目:

  • myapp-development
  • myapp-staging
  • myapp-production

客户/团队组织

对于代理机构或多租户设置:

  • client-a
  • client-b
  • internal-tools

项目导航

查看属于项目的服务时:

  • 侧边栏显示项目上下文
  • 快速导航到其他项目服务
  • 返回按钮返回项目视图

管理项目

编辑项目

  1. 进入 Projects
  2. 点击项目菜单(⋮)
  3. 选择 Edit
  4. 更新名称或描述
  5. Save

删除项目

  1. 进入 Projects
  2. 点击项目菜单(⋮)
  3. 选择 Delete
  4. 确认删除

删除项目不会删除其服务。服务变为未分配状态。

最佳实践

命名规范

使用一致的命名:

{app}-{environment}
{client}-{app}
{team}-{service-group}

项目内的服务命名

包含项目上下文:

myapp-frontend
myapp-api
myapp-db

或保持通用名称(项目提供上下文):

frontend
api
db

项目 vs 服务器

概念用途
项目逻辑分组、组织
服务器物理部署目标

同一项目中的服务可以运行在不同的服务器上。

未来功能

计划的项目增强:

  • 批量操作(全部部署、全部停止)
  • 项目级环境变量
  • 带有聚合指标的项目面板
  • 导出/导入项目配置

相关内容

目录