凭证管理

凭证是包含敏感信息的对象，例如用户名和密码、SSH 密钥和令牌 (Token)。当 KubeSphere DevOps 流水线运行时，会与外部环境中的对象进行交互，以执行一系列任务，包括拉取代码、推送和拉取镜像以及运行脚本等。此过程中需要提供相应的凭证，而这些凭证不会明文出现在流水线中。

具有必要权限的 DevOps 项目用户可以为 Jenkins 流水线配置凭证。用户在 DevOps 项目中添加或配置这些凭证后，便可以在 DevOps 项目中使用这些凭证与第三方应用程序进行交互。

目前，您可以在 DevOps 项目中创建以下 4 种类型的凭证：

• 用户名和密码：用户名和密码，可以作为单独的组件处理，或者作为用冒号分隔的字符串（格式为 username:password）处理，例如 GitHub 和 GitLab帐户。
• SSH 密钥：带有私钥的用户名，SSH 公钥/私钥对。
• 访问令牌：具有访问权限的令牌。
• kubeconfig：用于配置跨集群认证。

本教程演示如何在 DevOps 项目中创建和管理凭证。有关如何使用凭证的更多信息，请参见使用 Jenkinsfile 创建流水线和使用图形编辑面板创建流水线。

准备工作

• 您已启用 KubeSphere DevOps 系统。
• 您需要有一个企业空间、一个 DevOps 项目和一个用户 (project-regular)，并已邀请此帐户至 DevOps 项目中且授予 operator 角色。如果尚未准备好，请参见创建企业空间、项目、用户和角色。

创建凭证

1. 以 project-regular 身份登录 KubeSphere 控制台。

2. 进入您的 DevOps 项目，在左侧导航栏，选择DevOps 项目设置 > 凭证。

3. 在右侧的凭证区域，点击创建。

4. 在弹出的创建凭证对话框，输入凭证名称，并选择凭证类型。不同的凭证类型需要设置的参数不同，具体请参考以下内容。

创建用户名和密码凭证

以创建 GitHub 用户凭证为例，您需要设置以下参数：

• 名称：设置凭证名称，如 github-id。
• 类型：选择用户名和密码。
• 用户名：输入您的 GitHub 用户名。
• 密码/令牌：输入您的 GitHub 令牌。
• 描述：凭证的简介。

创建 SSH 密钥凭证

您需要设置以下参数：

• 名称：设置凭证名称。
• 类型：选择SSH 密钥。
• 用户名：输入您的用户名。
• 私钥：输入您的 SSH 密钥。
• 密码短语：输入密码短语。为了更好保护您的账户安全，建议设置该参数。
• 描述：凭证的简介。

创建访问令牌凭证

您需要设置以下参数：

• 名称：设置凭证名称。
• 类型：选择访问令牌。
• 令牌：输入您的令牌。
• 描述：凭证的简介。

创建 kubeconfig 凭证

您需要设置以下参数：

• 名称：设置凭证名称，例如 demo-kubeconfig。
• 类型：选择kubeconfig。
• 内容：系统自动获取当前 Kubernetes 集群的 kubeconfig 文件内容，并自动填充该字段，您无须做任何更改。但是访问其他集群时，您可能需要更改 kubeconfig。
• 描述：凭证的简介。

查看和管理凭证

1. 点击已创建的凭证，进入其详情页面，您可以查看帐户详情和与此凭证相关的所有事件。

2. 您也可以在此页面上编辑或删除凭证。请注意，编辑凭证时，KubeSphere 不会显示现有用户名或密码信息。如果输入新的用户名和密码，则前一个将被覆盖。

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