15308555518/ website
1
0
Fork 0
mirror of https://github.com/kubesphere/website.git synced 2025-12-26 00:12:48 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
website/content/zh/docs/quick-start/create-workspace-and-projec...
Sherlock113 5676fa0619 fix some zh-cn website links 
Signed-off-by: Sherlock113 <sherlockxu@yunify.com>
2020-11-20 13:46:44 +08:00

13 KiB
Raw Blame History

title keywords description linkTitle weight
创建企业空间、项目、帐户和角色 KubeSphere, Kubernetes, Multi-tenant, Workspace, Account, Role, Project Create Workspace, Project, Account and Role 创建企业空间、项目、帐户和角色 3030

目标

本指南演示如何创建以下教程所需的角色和用户帐户。同时，您将学习如何在工作负载运行的企业空间中创建项目和 DevOps 工程。本教程之后，您将熟悉 KubeSphere 多租户管理系统。

先决条件

KubeSphere 需要安装在您的服务器中。

估计时间

大约15分钟。

架构

KubeSphere 的多租户系统具有群集、企业空间和项目三个层次的层次结构。KubeSphere 中的项目是 Kubernetes 命名空间。

您可以在 Kubernetes 集群中创建多个企业空间。在每个企业空间下，您还可以创建多个项目。

每个级别都有多个内置角色。此外，KubeSphere 还允许您使用自定义授权创建角色。KubeSphere 层次结构适用于具有不同团队或组以及每个团队中不同角色的企业用户。

动手实验

任务 1：创建帐户

安装 KubeSphere 之后，您需要向平台添加具有不同角色的不同用户，以便他们可以在各种资源上以不同级别工作。 最初，您只有一个默认帐户 admin ，被授予角色platform-admin。 在第一个任务中，您将创建一个帐户 user-manager，并进一步创建更多像user-manager的账户。

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

{{< notice tip >}}

为了帐户安全，强烈建议您在首次登录控制台时更改密码。 要更改密码，请在右上角的下拉菜单中选择用户设置。 在密码设置中，设置一个新密码。

{{</ notice >}}

  1. 登录控制台后，单击左上角的平台管理，然后选择访问控制。

    access-control

在帐户角色中，有四个可用的内置角色，如下所示。 接下来要创建的帐户将被分配为users-manager角色。

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

{{< notice note >}}

内置角色由 KubeSphere 自动创建，无法编辑或删除。

{{</ notice >}}

  1. 在账户管理中，点击创建。 在弹出窗口中，提供所有必需的信息（带有*标记），然后为角色选择users-manager。 请参考下图作为示例。

create-account

完成后，单击确定。 新创建的帐户将显示在帐户管理中的帐户列表中。

  1. 注销登录，退出控制台，然后使用user-manager帐户重新登录，创建四个帐户，这些帐户将在以下教程中使用。

{{< notice tip >}}

要注销，请单击右上角的用户名，然后选择登出。

{{</ notice >}}

有关您需要创建的四个帐户的详细信息，请参阅下表。

账户名 角色 描述信息
ws-manager workspaces-manager 创建和管理所有企业空间。
ws-admin platform-regular 管理指定工作空间中的所有资源（在此示例中，此帐户用于邀请新成员加入工作空间）。
project-admin platform-regular 创建和管理项目以及 DevOps 项目，并邀请新成员加入项目。
project-regular platform-regular project-regular将被 project-admin邀请到一个项目或 DevOps 项目。 该帐户将用于在指定项目中创建工作负载，pipelines 和其他资源。
  1. 验证创建的四个帐户。

account-list

任务2：创建企业空间

在此任务中，您需要使用上一个任务中创建的帐户ws-manager创建一个工作空间。 作为项目，DevOps项目和组织成员的基本管理逻辑单元，企业空间是 KubeSphere 多租户系统的基础。

  1. 以ws-manager身份登录 KubeSphere ，它具有管理平台上所有企业空间的权限。 点击左上角的平台管理。 在工作空间中，您可以看到仅列出了一个默认工作空间，其中system-workspace在其中运行与系统相关的组件和服务。 您不允许删除该工作空间。

create-workspace

  1. 单击右侧的创建，将新工作空间命名为demo-workspace，并将用户ws-admin设置为工作空间管理员，如下图所示：

create-workspace

完成后，单击创建。

  1. 登出控制台，然后以ws-admin身份重新登录。 在企业空间设置中，选择企业成员，然后单击邀请成员。

invite-member

  1. 邀请project-admin和project-regular进入企业空间。 分别授予他们self-provisioner和 workspace-viewer角色。

{{< notice note >}}

实际的角色名称遵循命名约定：workspace name-role name。 例如，在名为demo的工作空间中，角色 workspace-viewer的实际角色名称是demo-workspace-viewer。

{{</ notice >}}

invite-member

  1. 将project-admin和project-regular都添加到企业空间后，单击确定。 在企业成员中，您可以看到列出的三个成员。
账户名 角色 描述信息
ws-admin workspace-admin 管理指定工作空间中的所有资源（在此示例中，此帐户用于邀请新成员加入工作空间）。
project-admin workspace-self-provisioner 创建和管理项目以及 DevOps 工程，并邀请新成员加入项目。
project-regular workspace-viewer project-regular将被 project-admin邀请到一个项目或 DevOps 工程。 该帐户将用于在指定项目中创建工作负载，pipelines 和其他资源。

任务3：创建一个项目

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

  1. 以project-admin身份登录 KubeSphere 。 在项目管理中，单击创建。

kubesphere-projects

  1. 输入项目名称（例如demo-project），然后点击确定以完成。 您还可以为项目添加别名和描述。

demo-project

  1. 在项目管理中，单击刚刚创建的项目以查看其详细信息。

click-demo-project

  1. 在项目的概述页面中，默认情况下未设置项目配额。 您可以单击设置并根据需要指定资源请求和限制（例如：1个CPU内核和1000Gi内存）。

project-overview

set-quota

  1. 邀请project-regular参与该项目，并授予该用户operator角色。 请参考下图以了解具体步骤。

{{< notice info >}}

被授予角色 operator的用户将是项目维护者，他可以管理项目中用户和角色以外的资源。

{{</ notice >}}

设置网关

在创建路由之前，您需要为该项目启用网关。 网关是在项目中运行的 NGINX Ingress 控制器。

{{< notice info >}}

路由是指 Kubernetes 中的 Ingress ，这是一个 API 对象，用于管理对集群中服务（通常是 HTTP ）的外部访问。

{{</ notice >}}

  1. 要设置网关，请转到项目设置中的高级设置，然后单击设置网关。 此步骤中仍使用帐户project-admin。

set-gateway

  1. 选择访问方式 NodePort ，然后单击保存。

nodeport

  1. 在外网访问下，可以在页面上看到网关地址和 http/https 的端口。

{{< notice note >}}

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

{{</ notice >}}

NodePort-setting-done

任务4：创建角色

完成上述任务后，您将知道可以为不同级别的用户授予不同角色。 先前任务中使用的角色都是 KubeSphere 本身创建的内置角色。 在此任务中，您将学习如何自己定义角色以满足工作需求。

  1. 再次以admin身份登录控制台，然后转到访问控制。
  2. 在帐户角色中，列出了四个无法删除或编辑的系统角色。 点击创建并设置角色标识符。 在这个例子中，将创建一个名为roles-manager的角色。

create-role

{{< notice note >}}

建议您输入角色说明，以说明角色的用途。 此处创建的角色将仅负责角色管理，包括添加和删除角色。

{{</ notice >}}

点击编辑权限以继续。

  1. 在访问控制中，选择您希望授予该角色的用户所拥有的授权。 例如，为此角色选择了用户查看，角色管理和角色查看。 单击确定完成。

edit-authorization

{{< notice note >}}

依赖于意味着需要首先选择主要授权（在依赖于之后列出的授权），以便可以分配附属授权。

{{</ notice >}}

  1. 新创建的角色将列在帐户角色中。 您可以单击右侧的三个点对其进行编辑。

roles-manager

  1. 在账户管理中，您可以添加一个新帐户并将其授予角色角色roles-manager，也可以通过编辑将现有帐户的角色更改为roles-manager。

edit-role

{{< notice note >}}

roles-manager的角色与users-manager重叠，而后者也可以进行用户管理。 本示例仅用于演示目的。 您可以根据需要创建自定义角色。

{{</ notice >}}

任务5：创建一个 DevOps 工程（可选）

{{< notice note >}}

要创建 DevOps 工程，您需要预先安装KubeSphere DevOps 系统，该系统是可插入的组件，提供 CI/CD pipelines，二进制到镜像，源码到镜像功能等。 有关如何启用 DevOps 的更多信息，请参见 KubeSphere DevOps System。

{{</ notice >}}

  1. 以project-admin身份登录控制台以完成此任务。 在 DevOps 工程中，单击创建。

devops-project

  1. 输入 DevOps 工程名称（例如demo-devops），然后点击确定。 您还可以为项目添加别名和描述。

devops-project

  1. 在 DevOps 工程中，单击刚创建的工程以查看其详细信息。

new-devops-project

  1. 转到工程管理，然后选择工程成员。 单击邀请成员以授予project-regular operator的角色，该操作员可以创建 pipelines 和凭证。

devops-invite-member

恭喜你！您现在已经熟悉 KubeSphere 的多租户管理系统。 在接下来的几篇教程中，project-regular帐户还将用于演示如何在项目或 DevOps 工程中创建应用程序和资源。