Skip to content

项目管理

项目功能使企业内的多个组织或部门能够独立使用和管理各自的 MQTT 集群。通过为不同角色分配权限,可以实现对平台能力的更细化管理。基于项目的结构,每个组织或部门都可以独立管理其所属的 MQTT 集群,并实现资源与账单的隔离。在多项目机制下,所有部署必须创建在某个项目下,且每个部署只能属于一个项目。

查看项目

您可以通过控制台的多个入口查看和管理项目:

  • 在控制台首页的项目管理区块中,点击查看所有项目
  • 或者,在左侧导航栏点击项目管理

进入项目管理页面,您将看到所有已创建的项目。每个项目卡片展示以下信息:

  • 项目名称与描述
  • EMQX Broker 概览,包括:
    • Broker 总数
    • 运行中的 Broker 数量
    • 已停止的 Broker 数量

TIP

如果您是项目管理员或项目使用者角色,只能访问您被授权查看的项目。有关各角色对应的项目管理权限,请参见角色与权限

default_project

点击项目卡片可进入项目概览页面,在该页面中可以创建和管理该项目下的部署。

创建项目

您可以在项目管理页面或控制台**首页(概览)**页面中点击 + 新建项目来创建新项目。

  1. 进入项目管理或控制台首页
  2. 点击 + 新建项目
  3. 在弹出的新建项目对话框中,填写项目名称和备注(备注为必填项)。
  4. 点击确认创建项目。

注意

EMQX Platform 控制台最多支持创建 20 个项目。

create_project

在项目下创建部署

要创建部署,您需要先进入目标项目:

  1. 点击项目卡片进入项目概览页面。
  2. 在项目概览页面中,有以下两种方式可创建部署:
    • 直接点击页面中的 + 新建部署
    • 或点击左侧菜单中的 EMQX Broker,在该页面中点击 + 新建部署

有关部署的详细创建步骤,请参见:创建部署章节。

为提升多部署场景下的管理效率,项目页面顶部的面包屑导航支持下拉切换项目与部署,实现快速跳转与自动刷新页面数据。

breadcrumb-switching

移动部署至其他项目

  1. 点击部署卡片右上角的菜单按钮,选择移动到

    move_project_menu
  2. 在弹出的下拉菜单中选择目标项目。

  3. 点击确认后,部署将被移动到所选项目中。

编辑项目名称与备注

TIP

主账号用户(管理员账户) 可以编辑项目名称和备注。详见:管理子账号

  1. 点击目标项目卡片进入项目。
  2. 在左侧菜单中点击项目设置
  3. 基础设置区块中修改项目名称与备注。
  4. 点击保存
update_project_menu

删除项目

TIP

主账号用户(管理员账户) 可以删除项目。详见:管理子账号

注意

删除项目前,请确保该项目下没有任何部署。

  1. 点击目标项目卡片进入项目。
  2. 在左侧菜单中点击项目设置
  3. 滚动至页面底部,点击删除项目按钮。
  4. 确认提示后点击确认执行删除操作。

添加项目成员

如果您是管理员角色,可以将团队成员分配至项目中,包括创建新成员账户或添加已有成员账户,以实现更灵活的协作和权限控制。

  1. 点击目标项目卡片进入项目。

  2. 在左侧菜单中点击项目设置

  3. 项目成员区块中点击**+ 添加**。在弹出的添加项目成员对话框中:

    • 可选择添加新建用户已有用户

    • 若为新建用户

      • 输入有效的成员账号(邮箱地址)
      • 设置登录**密码****
      • 可填写备注(可选)
      • 选择角色
        • 项目管理员
        • 项目使用者
  4. 点击确认即可添加成员至项目。您可以重复此操作添加更多成员。

add_project_memeber