创建企业空间、项目、用户和平台角色

本快速入门演示如何创建企业空间、用户和平台角色。同时,您将学习如何在企业空间中创建项目和 DevOps 项目,用于运行工作负载。完成本教程后,您将熟悉 KubeSphere 的多租户管理系统,并使用本教程中创建的资源(例如企业空间和帐户等)完成其他教程中的操作。

准备工作

KubeSphere 需要安装在您的机器中。

架构

KubeSphere 的多租户系统分三个层级,即集群、企业空间和项目。KubeSphere 中的项目等同于 Kubernetes 的命名空间

您需要创建一个新的企业空间进行操作,而不是使用系统企业空间,系统企业空间中运行着系统资源,绝大部分仅供查看。出于安全考虑,强烈建议给不同的租户授予不同的权限在企业空间中进行协作。

您可以在一个 KubeSphere 集群中创建多个企业空间,每个企业空间下可以创建多个项目。KubeSphere 为每个级别默认设有多个内置角色。此外,您还可以创建拥有自定义权限的角色。KubeSphere 多层次结构适用于具有不同团队或组织以及每个团队中需要不同角色的企业用户。

动手实验

步骤 1:创建用户

安装 KubeSphere 之后,您需要向平台添加具有不同角色的用户,以便他们可以针对自己授权的资源在不同的层级进行工作。一开始,系统默认只有一个用户 admin,具有 platform-admin 角色。在本步骤中,您将创建一个示例用户 ws-manager

  1. admin 身份使用默认帐户和密码 (admin/P@88w0rd) 登录 Web 控制台。

    提示

    出于安全考虑,强烈建议您在首次登录控制台时更改密码。若要更改密码,在右上角的下拉列表中选择用户设置,在密码设置中设置新密码,您也可以在用户设置 > 基本信息中修改控制台语言。
  2. 点击左上角的平台管理,然后选择访问控制。在左侧导航栏中,选择平台角色。内置角色的描述信息如下表所示。

    内置角色描述
    platform-self-provisioner创建企业空间并成为所创建企业空间的管理员。
    platform-regular平台普通用户,在被邀请加入企业空间或集群之前没有任何资源操作权限。
    platform-admin平台管理员,可以管理平台内的所有资源。

    备注

    内置角色由 KubeSphere 自动创建,无法编辑或删除。
  3. 用户中,点击创建。在弹出的对话框中,提供所有必要信息(带有*标记)。在平台角色下拉列表,选择platform-self-provisioner

    完成后,点击确定。新创建的用户将显示在用户页面。

    备注

    如果您在此处未指定平台角色,该用户将无法执行任何操作。您需要在创建企业空间后,将该用户邀请至企业空间。
  4. 重复以上的步骤创建新用户,这些用户将在其他的教程中使用。

    提示

    • 帐户登出请点击右上角的用户名,然后选择登出
    • 下面仅为示例用户名,请根据实际情况修改。
    用户指定的平台角色用户权限
    ws-adminplatform-regular被邀请到企业空间后,管理该企业空间中的所有资源(在此示例中,此用户用于邀请新成员加入该企业空间)。
    project-adminplatform-regular创建和管理项目以及 DevOps 项目,并邀请新成员加入项目。
    project-regularplatform-regularproject-regular 将由 project-admin 邀请至项目或 DevOps 项目。该用户将用于在指定项目中创建工作负载、流水线和其他资源。
  5. 用户页面,查看创建的用户。

    备注

    您可以点击用户名称后的 图标选择启用或禁用某个用户。您也可以勾选多个用户进行批量操作。

步骤 2:创建企业空间

作为管理项目、DevOps 项目和组织成员的基本逻辑单元,企业空间是 KubeSphere 多租户系统的基础。

  1. 在左侧导航栏,选择企业空间。企业空间列表中已列出默认企业空间 system-workspace,该企业空间包含所有系统项目。其中运行着与系统相关的组件和服务,您无法删除该企业空间。

  2. 在企业空间列表页面,点击创建,输入企业空间的名称(例如 demo-workspace),并将用户 ws-admin 设置为企业空间管理员。完成后,点击创建

    备注

    如果您已启用多集群功能,您需要为企业空间分配一个或多个可用集群,以便项目可以在集群中创建。
  3. 登出控制台,然后以 ws-admin 身份重新登录。在企业空间设置中,选择企业空间成员,然后点击邀请

  4. 邀请 project-adminproject-regular 进入企业空间,分别授予 demo-workspace-self-provisionerdemo-workspace-viewer 角色,点击确定

    备注

    实际角色名称的格式:<workspace name>-<role name>。例如,在名为 demo-workspace 的企业空间中,角色 viewer 的实际角色名称为 demo-workspace-viewer
  5. project-adminproject-regular 都添加到企业空间后,点击确定。在企业空间成员中,您可以看到列出的三名成员。

    用户分配的企业空间角色角色权限
    ws-admindemo-workspace-admin管理指定企业空间中的所有资源(在此示例中,此用户用于邀请新成员加入企业空间)。
    project-admindemo-workspace-self-provisioner创建和管理项目以及 DevOps 项目,并邀请新成员加入项目。
    project-regulardemo-workspace-viewerproject-regular 将由 project-admin 邀请至项目或 DevOps 项目。该用户将用于在指定项目中创建工作负载、流水线和其他资源。

步骤 3:创建项目

在此步骤中,您需要使用在上一步骤中创建的帐户 project-admin 来创建项目。KubeSphere 中的项目与 Kubernetes 中的命名空间相同,为资源提供了虚拟隔离。有关更多信息,请参见命名空间

  1. project-admin 身份登录 KubeSphere Web 控制台,在项目中,点击创建

  2. 输入项目名称(例如 demo-project),点击确定。您还可以为项目添加别名和描述。

  3. 项目中,点击刚创建的项目查看其详情页面。

  4. 在项目的概览页面,默认情况下未设置项目配额。您可以点击编辑配额并根据需要指定资源请求和限制(例如:CPU 和内存的限制分别设为 1 Core 和 1000 Gi)。

  5. 项目设置 > 项目成员中,邀请 project-regular 至该项目,并授予该用户 operator 角色。

    信息

    具有 operator 角色的用户是项目维护者,可以管理项目中除用户和角色以外的资源。
  6. 在创建应用路由(即 Kubernetes 中的 Ingress)之前,需要启用该项目的网关。网关是在项目中运行的 NGINX Ingress 控制器。若要设置网关,请转到项目设置中的网关设置,然后点击设置网关。此步骤中仍使用帐户 project-admin

  7. 选择访问方式 NodePort,然后点击确定

  8. 网关设置下,可以在页面上看到网关地址以及 http/https 的端口。

    备注

    如果要使用 LoadBalancer 暴露服务,则需要使用云厂商的 LoadBalancer 插件。如果您的 Kubernetes 集群在裸机环境中运行,建议使用 OpenELB 作为 LoadBalancer 插件。

步骤 4:创建角色

完成上述步骤后,您已了解可以为不同级别的用户授予不同角色。先前步骤中使用的角色都是 KubeSphere 提供的内置角色。在此步骤中,您将学习如何创建自定义角色以满足工作需求。

  1. 再次以 admin 身份登录 KubeSphere Web 控制台,转到访问控制

  2. 点击左侧导航栏中的平台角色,再点击右侧的创建

    备注

    平台角色页面的预设角色无法编辑或删除。
  3. 创建平台角色对话框中,设置角色标识符(例如,clusters-admin)、角色名称和描述信息,然后点击编辑权限

    备注

    本示例演示如何创建负责集群管理的角色。
  4. 编辑权限对话框中,设置角色权限(例如,选择集群管理)并点击确定

    备注

    • 在本示例中,角色 clusters-admin 包含集群管理集群查看权限。
    • 一些权限依赖于其他权限,依赖项由每项权限下的依赖于字段指定。
    • 选择权限后,将自动选择它所依赖的权限。
    • 若要取消选择权限,则需要首先取消选择其从属权限。
  5. 平台角色页面,可以点击所创建角色的名称查看角色详情,点击 以编辑角色、编辑角色权限或删除该角色。

  6. 用户页面,可以在创建帐户或编辑现有帐户时为帐户分配该角色。

步骤 5:创建 DevOps 项目(可选)

备注

若要创建 DevOps 项目,需要预先启用 KubeSphere DevOps 系统,该系统是个可插拔的组件,提供 CI/CD 流水线、Binary-to-Image 和 Source-to-Image 等功能。有关如何启用 DevOps 的更多信息,请参见 KubeSphere DevOps 系统
  1. project-admin 身份登录控制台,在 DevOps 项目中,点击创建

  2. 输入 DevOps 项目名称(例如 demo-devops),然后点击确定,也可以为该项目添加别名和描述。

  3. 点击刚创建的项目查看其详细页面。

  4. 转到 DevOps 项目设置,然后选择 DevOps 项目成员。点击邀请授予 project-regular 用户 operator 的角色,允许其创建流水线和凭证。

至此,您已熟悉 KubeSphere 的多租户管理系统。在其他教程中,project-regular 帐户还将用于演示如何在项目或 DevOps 项目中创建应用程序和资源。

通过邮件接收 KubeSphere 最新的技术博客与产品更新的通知


感谢您的反馈。如果您有关于如何使用 KubeSphere 的具体问题,请在 Slack 上提问。如果您想报告问题或提出改进建议,请在 GitHub 存储库中打开问题。