From 8535e827eae2bca492974f04ddcec82d3ed75fdc Mon Sep 17 00:00:00 2001 From: Felixnoo Date: Fri, 5 Feb 2021 17:57:59 +0800 Subject: [PATCH] Jenkins System Settings ZH reviewed. Signed-off-by: Felixnoo --- .../how-to-use/jenkins-setting.md | 62 +++++++++--------- .../jenkins-system-settings}/app-config.png | Bin .../cluster-management.png | Bin .../configuration-as-code.png | Bin .../edit-configmap.png | Bin .../jenkins-system-settings}/edit-jenkins.png | Bin .../jenkins-dashboard.png | Bin .../manage-jenkins.png | Bin .../jenkins-system-settings}/more-list.png | Bin 9 files changed, 32 insertions(+), 30 deletions(-) rename static/images/docs/{devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh => zh-cn/devops-user-guide/use-devops/jenkins-system-settings}/app-config.png (100%) rename static/images/docs/{devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh => zh-cn/devops-user-guide/use-devops/jenkins-system-settings}/cluster-management.png (100%) rename static/images/docs/{devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh => zh-cn/devops-user-guide/use-devops/jenkins-system-settings}/configuration-as-code.png (100%) rename static/images/docs/{devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh => zh-cn/devops-user-guide/use-devops/jenkins-system-settings}/edit-configmap.png (100%) rename static/images/docs/{devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh => zh-cn/devops-user-guide/use-devops/jenkins-system-settings}/edit-jenkins.png (100%) rename static/images/docs/{devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh => zh-cn/devops-user-guide/use-devops/jenkins-system-settings}/jenkins-dashboard.png (100%) rename static/images/docs/{devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh => zh-cn/devops-user-guide/use-devops/jenkins-system-settings}/manage-jenkins.png (100%) rename static/images/docs/{devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh => zh-cn/devops-user-guide/use-devops/jenkins-system-settings}/more-list.png (100%) diff --git a/content/zh/docs/devops-user-guide/how-to-use/jenkins-setting.md b/content/zh/docs/devops-user-guide/how-to-use/jenkins-setting.md index ff6487eb9..37392b639 100644 --- a/content/zh/docs/devops-user-guide/how-to-use/jenkins-setting.md +++ b/content/zh/docs/devops-user-guide/how-to-use/jenkins-setting.md @@ -1,44 +1,46 @@ --- title: "Jenkins 系统设置" keywords: 'Kubernetes, KubeSphere, Jenkins, CasC' -description: '如何在 KubeSphere 中设置 Jenkins.' +description: '如何在 KubeSphere 中设置 Jenkins。' linkTitle: 'Jenkins 系统设置' Weight: 11240 --- -Jenkins 强大而灵活，已经成为 CI/CD 工作流事实上的标准。 但是，许多插件要求用户先设置系统级配置，然后才能使用。 -KubeSphere DevOps 系统提供基于 Jenkins 的容器化 CI/CD 功能。为了为用户提供可调度的 Jenkins 环境，KubeSphere 使用 **Configuration-as-Code** 进行 Jenkins 系统设置，这要求用户登录 Jenkins 仪表板并在修改后重新加载配置。在当前版本中，Jenkins 系统设置在 KubeSphere 控制台上不可用，即将发布的版本将支持该设置。 -本教程演示了如何在 Jenkins 仪表板上设置 Jenkins 并重新加载配置。 +Jenkins 强大而灵活，已经成为 CI/CD 工作流的事实标准。但是，许多插件要求用户先设置系统级配置，然后才能使用。 -## 先决条件 +KubeSphere DevOps 系统提供基于 Jenkins 的容器化 CI/CD 功能。为了向用户提供可调度的 Jenkins 环境，KubeSphere 使用 **Configuration-as-Code** 进行 Jenkins 系统设置，这要求用户登录 Jenkins 仪表板并在修改配置后重新加载。Jenkins 系统设置在 KubeSphere 当前版本的控制台上不可用，即将发布的版本将支持该设置。 + +本教程演示如何在 Jenkins 仪表板上设置 Jenkins 并重新加载配置。 + +## 准备工作 您已启用 [KubeSphere DevOps 系统](../../../pluggable-components/devops/)。 ## 修改 ConfigMap -建议您通过Configuration-as-Code（CasC）在 KubeSphere 中配置 Jenkins。 内置的 Jenkins CasC 文件存储为 [ConfigMap](../../../project-user-guide/configuration/configmaps/)。 +建议您通过 Configuration-as-Code (CasC) 在 KubeSphere 中配置 Jenkins。内置 Jenkins CasC 文件存储为 [ConfigMap](../../../project-user-guide/configuration/configmaps/)。 -1. 以 kubeSphere 管理员（`admin`）身份登录， 单击左上角的**平台管理**，然后选择**集群管理**。 +1. 以 `admin` 身份登录 KubeSphere，点击左上角的**平台管理**，然后选择**集群管理**。 - ![cluster-management](/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/cluster-management.png) + ![集群管理](/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/cluster-management.png) -2. 如果您已经在导入成员集群时启用了[多集群特性](../../../multicluster-management)，那么您可以选择一个特定集群以查看其应用程序资源。 如果尚未启用该特性，请直接参考下一步。 +2. 如果您已经启用[多集群功能](../../../multicluster-management)并已导入 Member 集群，您可以选择一个特定集群来编辑 ConfigMap。如果您尚未启用多集群功能，请直接参考下一步。 -3. 从导航栏中，在**配置中心**下选择**配置**。 在**配置**页面上，从下拉列表中选择 `kubesphere-devops-system`，然后单击 `jenkins-casc-config`。 +3. 在左侧导航栏中选择**配置中心**下的**配置**。在**配置**页面上，从下拉列表中选择 `kubesphere-devops-system`，然后点击 `jenkins-casc-config`。 - ![edit-configmap](/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/edit-configmap.png) + ![编辑 ConfigMap](/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/edit-configmap.png) -4. 在详细信息页面上，从**更多操作**下拉列表中单击**编辑配置文件（YAML 文件）**。 +4. 在详情页面上，点击**更多操作**，在下拉列表中选择**编辑配置文件**。 - ![more-list](/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/more-list.png) + ![more-list](/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/more-list.png) -5. 如下所示，`jenkins-casc-config` 的配置模板是一个 YAML 文件。 您可以在 ConfigMap 的代理（Kubernetes Jenkins agent）中修改容器镜像、标签等内容，或者在 podTemplate 中添加容器。 完成后，单击**更新**。 +5. `jenkins-casc-config` 的配置模板是一个 YAML 文件，如下图所示。您可以在 ConfigMap 的代理 (Kubernetes Jenkins Agent) 中修改容器镜像、标签等内容，或者在 podTemplate 中添加容器。完成操作后，点击**更新**。 - ![edit-jenkins](/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/edit-jenkins.png) + ![编辑 Jenkins](/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/edit-jenkins.png) ## 登录 Jenkins 重新加载配置 -修改 `jenkins-casc-config` 后，需要在 Jenkins 仪表板上的 **Configuration as Code** 页面上重新加载更新的系统配置。 这是因为直接通过 Jenkins 仪表板配置的系统设置可能在 Jenkins 重新调度之后被 CasC（`Configuration as Code`） 配置覆盖。 +修改 `jenkins-casc-config` 后，您需要在 Jenkins 仪表板的 **Configuration as Code** 页面上重新加载更新后的系统配置。这是因为直接通过 Jenkins 仪表板配置的系统设置可能在 Jenkins 重新调度之后被 CasC 配置覆盖。 1. 执行以下命令获取 Jenkins 的地址。 @@ -48,38 +50,38 @@ KubeSphere DevOps 系统提供基于 Jenkins 的容器化 CI/CD 功能。为了 echo http://$NODE_IP:$NODE_PORT ``` -2. 您可以看到如下所示的预期输出，它告诉您 Jenkins 的 IP 地址和端口号。 +2. 您可以看到如下所示的预期输出，获取 Jenkins 的 IP 地址和端口号。 ```bash http://10.77.1.201:30180 ``` -3. 使用地址 `http://Node IP:Port Number` 访问 Jenkins。安装 KubeSphere 时，默认情况下也会安装 Jenkins 仪表板。 Jenkins 配置了 KubeSphere LDAP，这意味着您可以直接使用 KubeSphere 帐户（例如 `admin/P@88w0rd`）登录 Jenkins。 +3. 使用地址 `http://Node IP:Port Number` 访问 Jenkins。安装 KubeSphere 时，默认情况下也会安装 Jenkins 仪表板。Jenkins 还配置有 KubeSphere LDAP，这意味着您可以直接使用 KubeSphere 帐户（例如 `admin/P@88w0rd`）登录 Jenkins。 - ![jenkins-dashboard](/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/jenkins-dashboard.png) + ![Jenkins 仪表板](/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/jenkins-dashboard.png) {{< notice note >}} - 您可能需要设置必要的端口转发规则并打开端口 `30180` 才能访问安全组中的 Jenkins，具体取决于您的实例部署的位置。 + 取决于您的实例的部署位置，您可能需要设置必要的端口转发规则并在您的安全组中放行端口 `30180`，以便访问 Jenkins。 - {{}} + {{}} -4. 登录仪表板后，从导航栏中单击 **Manage Jenkins**。 +4. 登录仪表板后，点击导航栏中的 **Manage Jenkins**。 - ![manage-jenkins](/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/manage-jenkins.png) + ![manage-jenkins](/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/manage-jenkins.png) -5. 向下翻页并单击 **Configuration as Code**. +5. 向下翻页并点击 **Configuration as Code**. - ![configuration-as-code](/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/configuration-as-code.png) + ![configuration-as-code](/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/configuration-as-code.png) -6. 要重新加载在 ConfigMap 中修改的配置，请单击 **Apply new configuration**。. +6. 要重新加载 ConfigMap 中已修改的配置，请点击 **Apply new configuration**。 - ![app-config](/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/app-config.png) + ![应用配置](/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/app-config.png) -7. 有关如何通过 CasC 设置 Jenkins 的更多信息，请参阅 [Jenkins 文档](https://github.com/jenkinsci/configuration-as-code-plugin)。 +7. 有关如何通过 CasC 设置 Jenkins 的更多信息，请参见 [Jenkins 文档](https://github.com/jenkinsci/configuration-as-code-plugin)。 {{< notice note >}} -在当前版本中，并非所有插件都支持 CasC 设置。 CasC 将仅覆盖通过 CasC 设置的插件配置。 + 在当前版本中，并非所有插件都支持 CasC 设置。CasC 仅会覆盖通过 CasC 设置的插件配置。 - {{}} \ No newline at end of file + {{}} \ No newline at end of file diff --git a/static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/app-config.png b/static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/app-config.png similarity index 100% rename from static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/app-config.png rename to static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/app-config.png diff --git a/static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/cluster-management.png b/static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/cluster-management.png similarity index 100% rename from static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/cluster-management.png rename to static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/cluster-management.png diff --git a/static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/configuration-as-code.png b/static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/configuration-as-code.png similarity index 100% rename from static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/configuration-as-code.png rename to static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/configuration-as-code.png diff --git a/static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/edit-configmap.png b/static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/edit-configmap.png similarity index 100% rename from static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/edit-configmap.png rename to static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/edit-configmap.png diff --git a/static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/edit-jenkins.png b/static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/edit-jenkins.png similarity index 100% rename from static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/edit-jenkins.png rename to static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/edit-jenkins.png diff --git a/static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/jenkins-dashboard.png b/static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/jenkins-dashboard.png similarity index 100% rename from static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/jenkins-dashboard.png rename to static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/jenkins-dashboard.png diff --git a/static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/manage-jenkins.png b/static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/manage-jenkins.png similarity index 100% rename from static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/manage-jenkins.png rename to static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/manage-jenkins.png diff --git a/static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/more-list.png b/static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/more-list.png similarity index 100% rename from static/images/docs/devops-user-guide-zh/using-devops-zh/jenkins-system-settings-zh/more-list.png rename to static/images/docs/zh-cn/devops-user-guide/use-devops/jenkins-system-settings/more-list.png