From 9a2a3a34d7f7dc1aefc0c0618c0f490555c954ef Mon Sep 17 00:00:00 2001 From: zhuxiujuan28 <562873187@qq.com> Date: Mon, 14 Oct 2024 16:26:37 +0800 Subject: [PATCH 1/2] add extension use chapter Signed-off-by: zhuxiujuan28 <562873187@qq.com> --- .../02-install-a-demo-extension.adoc | 50 + .../01-install-components-pdf.adoc | 2 +- .../02-install-a-demo-extension.adoc | 44 + .../01-install-components-pdf.adoc | 2 +- .../02-cluster-visibility/_index.adoc | 9 +- .../01-add-a-member-cluster/_index.adoc | 3 +- ...pository-with-a-helm-chart-repository.adoc | 39 - .../01-devops/01-overview.adoc | 44 + .../01-create-a-devops-project.adoc | 54 + .../02-view-a-devops-project-list.adoc | 74 + .../03-edit-devops-project-information.adoc | 51 + .../04-delete-devops-projects.adoc | 63 + .../01-devops/02-devops-projects/_index.adoc | 13 + .../01-devops-project-management.adoc | 73 + ...ipeline-using-graphical-editing-panel.adoc | 500 +++++++ ...2-create-a-pipeline-using-jenkinsfile.adoc | 455 ++++++ .../03-use-pipeline-templates.adoc | 123 ++ .../04-gitlab-multibranch-pipeline.adoc | 225 +++ .../02-pipelines/05-pipeline-settings.adoc | 202 +++ .../02-pipelines/06-pipeline-webhook.adoc | 77 ++ .../02-pipelines/07-jenkins-setting.adoc | 55 + .../08-jenkins-shared-library.adoc | 150 ++ .../02-pipelines/09-jenkins-email.adoc | 62 + .../02-pipelines/10-choose-jenkins-agent.adoc | 219 +++ .../11-customize-jenkins-agent.adoc | 85 ++ .../03-how-to-use/02-pipelines/_index.adoc | 9 + ...3-use-gitops-for-continous-deployment.adoc | 255 ++++ .../04-import-code-repositories.adoc | 100 ++ .../01-credential-management.adoc | 184 +++ .../02-role-and-member-management.adoc | 118 ++ .../03-add-cd-allowlist.adoc | 31 + .../05-devops-settings/04-set-ci-node.adoc | 41 + .../05-devops-settings/_index.adoc | 10 + .../01-devops/03-how-to-use/_index.adoc | 10 + .../04-how-to-integrate/01-sonarqube.adoc | 372 +++++ .../04-how-to-integrate/02-harbor.adoc | 171 +++ .../01-devops/04-how-to-integrate/_index.adoc | 10 + .../11-use-extensions/01-devops/_index.adoc | 16 + .../01-create-an-app-template.adoc | 62 + .../02-view-an-app-template-list.adoc | 63 + .../03-view-app-template-details.adoc | 106 ++ .../04-edit-app-template-information.adoc | 70 + ...stall-an-app-by-using-an-app-template.adoc | 82 ++ .../06-upload-an-app-version.adoc | 47 + .../08-delete-an-app-version.adoc | 50 + .../09-download-a-helm-chart-package.adoc | 44 + ...lease-an-app-version-to-the-app-store.adoc | 53 + .../11-delete-an-app-template.adoc | 47 + .../01-app-templates/_index.adoc | 11 + .../02-app-management/_index.adoc | 22 + .../01-apps/01-view-an-app-template-list.adoc | 69 + .../01-apps/02-view-app-template-details.adoc | 105 ++ .../01-apps/04-edit-an-app-template.adoc | 65 + .../01-apps/06-publish-an-app-template.adoc | 48 + .../08-cancel-release-an-app-version.adoc | 45 + .../01-apps/09-delete-an-app-version.adoc | 41 + .../01-apps/10-suspend-an-app-template.adoc | 45 + .../01-apps/12-delete-an-app-template.adoc | 37 + .../01-apps/_index.adoc | 10 + .../01-manage-app-categories.adoc | 56 + .../02-set-the-category-of-an-app.adoc | 42 + .../02-app-categories/_index.adoc | 13 + .../01-review-an-app-version.adoc | 53 + .../02-view-app-review-records.adoc | 76 + .../03-app-review/_index.adoc | 13 + .../01-add-an-app-repository.adoc | 48 + .../02-view-an-app-repository-list.adoc | 69 + .../03-edit-an-app-repository.adoc | 44 + .../05-delete-an-app-repository.adoc | 47 + .../04-app-repositories/_index.adoc | 13 + .../01-view-an-app-list.adoc | 70 + .../02-view-app-instance-details.adoc | 83 ++ .../04-edit-an-app-information.adoc | 39 + .../06-delete-an-app-instance.adoc | 38 + .../08-deploy-an-app-from-the-app-store.adoc | 71 + ...0-deploy-an-app-using-an-app-template.adoc | 70 + .../05-app-deployment/_index.adoc | 11 + .../03-app-store-management/_index.adoc | 17 + .../02-app-store/_index.adoc | 18 + .../01-apps/03-manually-compose-an-app.adoc | 66 + .../01-apps/04-view-an-app-list.adoc | 68 + .../01-apps/05-view-composed-app-details.adoc | 124 ++ .../01-apps/06-edit-app-information.adoc | 38 + .../01-apps/07-add-a-service.adoc | 72 + .../01-apps/08-add-an-app-route.adoc | 42 + .../01-apps/10-delete-apps.adoc | 61 + .../03-service-mesh/01-apps/_index.adoc | 30 + .../01-create-a-grayscale-release-task.adoc | 201 +++ ...02-view-a-grayscale-release-task-list.adoc | 52 + ...3-view-grayscale-release-task-details.adoc | 61 + ...switch-versions-blue-green-deployment.adoc | 38 + ...fic-distribution-ratio-canary-release.adoc | 40 + ...-settings-of-a-grayscale-release-task.adoc | 56 + .../07-delete-a-grayscale-release-task.adoc | 52 + .../02-grayscale-release/_index.adoc | 27 + .../03-service-mesh/_index.adoc | 25 + .../01-log-in-and-go-to-a-project.adoc | 40 + .../04-kubefed/00-web-console/_index.adoc | 11 + .../01-create-a-project.adoc | 57 + .../02-view-a-project-list.adoc | 69 + .../03-edit-project-information.adoc | 40 + .../04-edit-project-annotations.adoc | 48 + .../05-add-a-cluster.adoc | 59 + .../06-delete-projects.adoc | 49 + .../01-manage-multi-project/_index.adoc | 11 + .../01-view-project-overall-information.adoc | 54 + .../04-kubefed/02-overview/_index.adoc | 9 + .../01-apps/01-compose-an-app.adoc | 67 + .../01-apps/02-view-an-app-list.adoc | 73 + .../01-apps/03-view-app-details.adoc | 82 ++ .../01-apps/04-delete-apps.adoc | 44 + .../01-apps/_index.adoc | 13 + ...reate-a-stateful-or-stateless-service.adoc | 299 ++++ .../02-services/02-view-a-service-list.adoc | 74 + .../02-services/03-view-service-details.adoc | 37 + .../04-edit-service-information.adoc | 33 + .../02-services/05-edit-service-settings.adoc | 33 + ...edit-service-external-access-settings.adoc | 41 + .../02-services/07-delete-services.adoc | 50 + .../02-services/_index.adoc | 10 + .../03-workloads/01-create-a-workload.adoc | 290 ++++ .../03-workloads/02-view-a-workload-list.adoc | 43 + .../03-view-workload-details.adoc | 41 + .../04-edit-workload-information.adoc | 37 + .../05-adjust-the-number-of-pod-replicas.adoc | 40 + .../03-workloads/06-stop-workloads.adoc | 37 + .../07-edit-workload-settings.adoc | 225 +++ .../03-workloads/08-delete-workloads.adoc | 59 + .../03-workloads/_index.adoc | 27 + .../04-routes/01-create-a-route.adoc | 41 + .../04-routes/02-view-a-route-list.adoc | 39 + .../04-routes/03-view-route-details.adoc | 37 + .../04-routes/04-edit-route-information.adoc | 33 + .../04-routes/05-edit-routing-rules.adoc | 32 + .../04-routes/06-edit-route-annotations.adoc | 33 + .../04-routes/07-delete-routes.adoc | 45 + .../04-routes/_index.adoc | 13 + .../03-application-workloads/_index.adoc | 11 + .../01-create-a-persistent-volume-claim.adoc | 37 + ...2-view-a-persistent-volume-claim-list.adoc | 39 + ...-view-persistent-volume-claim-details.adoc | 38 + ...t-persistent-volume-claim-information.adoc | 33 + .../05-delete-persistent-volume-claims.adoc | 48 + .../04-peristent-volume-claims/_index.adoc | 13 + .../01-secrets/01-create-a-secret.adoc | 37 + .../01-secrets/02-view-a-secret-list.adoc | 39 + .../01-secrets/03-view-secret-details.adoc | 37 + .../04-edit-secret-information.adoc | 33 + .../01-secrets/05-edit-secret-settings.adoc | 33 + .../01-secrets/06-delete-secrets.adoc | 46 + .../05-configuration/01-secrets/_index.adoc | 11 + .../02-configmaps/01-create-a-configmap.adoc | 37 + .../02-view-a-configmap-list.adoc | 39 + .../03-view-configmap-details.adoc | 37 + .../04-edit-configmap-information.adoc | 33 + .../05-edit-configmap-settings.adoc | 33 + .../02-configmaps/06-delete-configmaps.adoc | 46 + .../02-configmaps/_index.adoc | 13 + .../04-kubefed/05-configuration/_index.adoc | 11 + .../01-view-project-basic-information.adoc | 45 + .../02-edit-project-information.adoc | 46 + .../03-edit-annotation.adoc | 41 + .../01-basic-information/04-add-cluster.adoc | 41 + .../05-edit-default-container-quotas.adoc | 37 + .../06-delete-a-project.adoc | 38 + .../01-basic-information/_index.adoc | 11 + .../01-view-project-quotas.adoc | 35 + .../02-edit-project-quotas.adoc | 35 + .../02-project-quotas/_index.adoc | 10 + .../06-project-settings/_index.adoc | 8 + .../11-use-extensions/04-kubefed/_index.adoc | 16 + .../01-platform-services/01-intro.adoc | 125 ++ .../01-platform-services/_index.adoc | 6 + .../01-write-data-to-kafka.adoc | 293 ++++ .../02-read-data-from-kafka.adoc | 171 +++ .../03-configure-platform-service.adoc | 24 + .../01-vector/02-etl-solution/_index.adoc | 11 + .../01-vector/_index.adoc | 30 + .../02-logging/01-config.adoc | 76 + .../02-logging/03-use-log-query-tools.adoc | 52 + .../01-enable-logsidecar.adoc | 48 + .../02-enable-project-log-collection.adoc | 58 + .../03-enable-collect-volume-logs.adoc | 49 + .../02-logging/05-log-collection/_index.adoc | 23 + .../01-config-opensearch.adoc | 151 ++ .../01-add-a-log-receiver.adoc | 54 + .../02-view-a-log-receiver-list.adoc | 67 + .../03-view-log-receiver-details.adoc | 47 + .../04-edit-log-receiver-settings.adoc | 56 + .../05-enable-and-disable-log-receiver.adoc | 43 + .../06-delete-a-log-receiver.adoc | 43 + .../03-manage-log-receivers/_index.adoc | 20 + .../02-logging/06-log-receivers/_index.adoc | 19 + .../02-logging/_index.adoc | 28 + .../03-events/01-use-event-query-tools.adoc | 36 + .../03-events/_index.adoc | 27 + .../04-auditing/01-use-audit-query-tools.adoc | 117 ++ .../04-auditing/_index.adoc | 29 + .../01-cluster-monitoring-overview.adoc | 80 ++ .../02-workspace-monitoring-overview.adoc | 76 + .../03-project-monitoring-overview.adoc | 69 + .../05-monitoring/01-overview/_index.adoc | 8 + .../01-view-cluster-status-overview.adoc | 64 + .../02-view-physical-resource-status.adoc | 81 ++ .../03-view-etcd-status.adoc | 92 ++ .../04-view-api-server-status.adoc | 60 + .../05-view-scheduler-monitoring-data.adoc | 63 + ...6-view-nodes-ranked-by-resource-usage.adoc | 45 + .../03-cluster-status/_index.adoc | 10 + .../01-view-resource-usage.adoc | 62 + ...iew-projects-ranked-by-resource-usage.adoc | 45 + .../04-application-resources/_index.adoc | 11 + ...-create-a-custom-monitoring-dashboard.adoc | 41 + ...02-view-a-custom-monitoring-dashboard.adoc | 32 + ...stom-monitoring-dashboard-information.adoc | 33 + ...04-edit-a-custom-monitoring-dashboard.adoc | 32 + ...5-delete-custom-monitoring-dashboards.adoc | 44 + .../05-custom-monitoring/_index.adoc | 19 + .../08-edit-a-metrics-exporter.adoc | 46 + .../05-monitoring/_index.adoc | 47 + .../01-create-a-rule-group.adoc | 100 ++ .../02-view-a-rule-group-list.adoc | 46 + .../03-view-rule-group-details.adoc | 39 + .../04-edit-rule-group-information.adoc | 43 + .../03-rule-groups/05-edit-alert-rules.adoc | 43 + .../06-disable-and-enable-rule-groups.adoc | 55 + .../03-rule-groups/07-delete-rule-groups.adoc | 47 + .../08-reset-built-in-rule-groups.adoc | 61 + .../06-alerting/03-rule-groups/_index.adoc | 24 + .../04-alerts/01-view-an-alert-list.adoc | 46 + .../06-alerting/04-alerts/_index.adoc | 13 + .../06-alerting/_index.adoc | 93 ++ .../07-whizard/01-enable-whizard.adoc | 89 ++ ...-monitoring-data-of-multiple-clusters.adoc | 86 ++ .../03-resource-ranking.adoc | 51 + .../03-resource-monitoring/_index.adoc | 7 + .../01-create-a-rule-group.adoc | 157 +++ .../02-view-a-rule-group-list.adoc | 56 + .../03-view-rule-group-details.adoc | 40 + .../04-edit-rule-group-information.adoc | 43 + .../01-rule-groups/05-edit-alert-rules.adoc | 48 + .../06-disable-and-enable-rule-groups.adoc | 62 + .../01-rule-groups/07-delete-rule-groups.adoc | 68 + .../08-reset-built-in-rule-groups.adoc | 54 + .../01-rule-groups/_index.adoc | 12 + .../02-alerts/01-view-an-alert-list.adoc | 45 + .../05-alert-management/02-alerts/_index.adoc | 14 + .../05-alert-management/_index.adoc | 10 + .../01-pod/01-query-pod.adoc | 63 + .../07-resource-query/01-pod/_index.adoc | 6 + .../07-whizard/07-resource-query/_index.adoc | 7 + .../07-whizard/11-set-alert-components.adoc | 148 ++ .../07-whizard/_index.adoc | 16 + .../01-create-rules-for-auditing.adoc | 80 ++ .../02-example-rules-for-auditing.adoc | 1227 +++++++++++++++++ .../03-create-rules-for-logs.adoc | 105 ++ .../09-events-altering/_index.adoc | 38 + .../01-set-email-notification.adoc | 63 + .../02-set-feishu-notification.adoc | 74 + .../03-set-dingtalk-notification.adoc | 76 + .../04-set-wecom-notification.adoc | 87 ++ .../05-set-slack-notification.adoc | 62 + .../06-set-webhook-notification.adoc | 73 + .../01-notification-channels/_index.adoc | 12 + .../01-set-subscription.adoc | 75 + .../02-view-subscription.adoc | 58 + .../03-edit-subscription.adoc | 67 + .../04-delete-subscription.adoc | 50 + .../02-notification-subscription/_index.adoc | 13 + .../01-create-a-silence-policy.adoc | 67 + .../02-edit-silence-policy-information.adoc | 53 + .../03-edit-silence-conditions.adoc | 47 + .../04-edit-silence-time.adoc | 59 + .../05-delete-silence-policies.adoc | 63 + .../06-change-the-notification-language.adoc | 41 + .../03-notification-settings/_index.adoc | 12 + .../03-view-notification-history.adoc | 94 ++ .../04-notification-history/_index.adoc | 7 + .../01-set-email-notification.adoc | 45 + .../02-set-feishu-notification.adoc | 62 + .../03-set-dingtalk-notification.adoc | 64 + .../04-set-wecom-notification.adoc | 75 + .../05-set-slack-notification.adoc | 50 + .../06-set-webhook-notification.adoc | 61 + .../05-users-notification/_index.adoc | 19 + .../07-message-config/01-wechat-template.adoc | 102 ++ .../07-message-config/_index.adoc | 6 + .../11-notifications/_index.adoc | 31 + .../15-opensearch/01-intro.adoc | 23 + .../15-opensearch/_index.adoc | 24 + .../16-grafana/01-built-in-dashboards.adoc | 67 + .../16-grafana/05-add-data-source.adoc | 45 + .../16-grafana/07-create-dashboards.adoc | 41 + .../16-grafana/_index.adoc | 58 + .../17-loki/01-display-loki-data.adoc | 72 + .../17-loki/_index.adoc | 22 + .../05-observability-platform/_index.adoc | 36 + .../01-create-a-network-policy.adoc | 56 + .../02-view-a-network-policy-list.adoc | 54 + .../03-view-network-policy-details.adoc | 111 ++ .../04-edit-network-policy-information.adoc | 55 + .../05-edit-network-policy-yaml.adoc | 44 + .../06-delete-network-policies.adoc | 64 + .../01-workspace-network-isolation.adoc | 36 + .../02-project-network-isolation.adoc | 148 ++ .../07-network-isolation/_index.adoc | 27 + .../01-network-policies/_index.adoc | 16 + .../01-create-a-pod-ip-pool.adoc | 153 ++ .../02-view-a-pod-ip-pool-list.adoc | 77 ++ .../03-view-pod-ip-pool-details.adoc | 89 ++ .../04-assign-a-project-to-a-ip-pool.adoc | 47 + .../05-edit-pod-ip-pool-information.adoc | 55 + .../02-pod-ip-pools/06-edit-overlay-mode.adoc | 72 + .../07-edit-yaml-for-a-pod-ip-pool.adoc | 51 + .../08-disable-and-enable-pod-ip-pool.adoc | 56 + .../09-delete-pod-ip-pools.adoc | 68 + .../11-network/02-pod-ip-pools/_index.adoc | 12 + .../11-use-extensions/11-network/_index.adoc | 19 + .../01-enable-a-project-gateway.adoc | 44 + .../02-view-project-gateway-information.adoc | 38 + .../03-view-project-gateway-details.adoc | 37 + .../04-edit-project-gateway-settings.adoc | 37 + .../05-disable-a-project-gateway.adoc | 38 + .../12-gateway/01-project-gateway/_index.adoc | 23 + .../01-enable-workspace-gateway.adoc | 52 + .../02-view-workspace-gateway-info.adoc | 47 + .../03-view-workspace-gateway-details.adoc | 37 + .../04-edit-workspace-gateway-settings.adoc | 37 + .../05-disable-workspace-gateway.adoc | 39 + .../02-workspace-gateway/_index.adoc | 20 + .../01-enable-a-cluster-gateway.adoc | 52 + .../02-view-gateway-information.adoc | 44 + .../03-view-cluster-gateway-details.adoc | 40 + .../04-edit-cluster-gateway-settings.adoc | 39 + .../05-disable-a-cluster-gateway.adoc | 42 + .../07-issue-no-gateway-log-in-member.adoc | 46 + .../12-gateway/03-cluster-gateway/_index.adoc | 21 + .../05-routes/01-create-a-route.adoc | 42 + .../05-routes/02-view-a-route-list.adoc | 42 + .../05-routes/03-view-route-details.adoc | 40 + ...4-access-a-backend-service-of-a-route.adoc | 42 + .../05-routes/05-edit-route-information.adoc | 36 + .../05-routes/06-edit-routing-rules.adoc | 36 + .../05-routes/07-edit-route-annotations.adoc | 36 + .../05-routes/08-delete-routes.adoc | 49 + .../12-gateway/05-routes/_index.adoc | 11 + .../11-use-extensions/12-gateway/_index.adoc | 38 + .../13-ingress-utils/01-add-a-domain.adoc | 64 + .../02-view-a-domain-list.adoc | 52 + .../03-edit-domain-information.adoc | 32 + .../13-ingress-utils/06-delete-domains.adoc | 47 + .../13-ingress-utils/_index.adoc | 19 + .../01-create-a-volume-snapshot.adoc | 66 + .../02-view-a-volume-snapshot-list.adoc | 45 + .../03-view-volume-snapshot-details.adoc | 41 + ...sistent-volume-from-a-volume-snapshot.adoc | 41 + .../05-delete-volume-snapshots.adoc | 51 + ...6-view-a-volume-snapshot-content-list.adoc | 80 ++ ...-view-volume-snapshot-content-details.adoc | 84 ++ ...t-volume-snapshot-content-information.adoc | 57 + .../09-delete-a-volume-snapshot-content.adoc | 82 ++ .../03-volume-snapshots/_index.adoc | 18 + .../01-create-a-volume-snapshot-class.adoc | 81 ++ .../02-view-a-volume-snapshot-class-list.adoc | 69 + ...03-view-volume-snapshot-class-details.adoc | 83 ++ ...dit-volume-snapshot-class-information.adoc | 55 + .../05-delete-volume-snapshot-classes.adoc | 65 + .../04-volume-snapshot-classes/_index.adoc | 13 + .../01-set-authorization-rules.adoc | 57 + .../02-set-auto-expansion.adoc | 71 + .../15-storage/05-storage-classes/_index.adoc | 14 + .../11-use-extensions/15-storage/_index.adoc | 35 + .../11-use-extensions/16-dmp/01-intro.adoc | 11 + .../v4.1/11-use-extensions/16-dmp/_index.adoc | 7 + .../17-kubeedge/01-add-an-edge-node.adoc | 138 ++ .../02-view-an-edge-node-list.adoc | 68 + .../17-kubeedge/03-delete-an-edge-node.adoc | 71 + .../11-use-extensions/17-kubeedge/_index.adoc | 29 + ...ster-the-deployment-as-a-microservice.adoc | 300 ++++ .../02-view-a-microservice-list.adoc | 62 + .../03-edit-the-weight-of-a-microservice.adoc | 45 + ...roservice-instance-offline-and-online.adoc | 43 + .../01-microservices/_index.adoc | 11 + ...1-create-a-microservice-configuration.adoc | 53 + ...iew-a-microservice-configuration-list.adoc | 65 + ...ew-microservice-configuration-details.adoc | 56 + .../04-edit-a-microservice-configuration.adoc | 39 + ...eplicate-a-microservice-configuration.adoc | 51 + ...oll-back-a-microservice-configuration.adoc | 44 + ...07-delete-microservice-configurations.adoc | 57 + .../_index.adoc | 20 + .../01-create-a-microservice-gateway.adoc | 53 + ...view-microservice-gateway-information.adoc | 78 ++ .../03-view-microservice-gateway-details.adoc | 73 + ...04-edit-microservice-gateway-settings.adoc | 47 + .../05-delete-a-microservice-gateway.adoc | 45 + .../03-microservice-gateway/_index.adoc | 13 + .../18-spring-cloud/_index.adoc | 15 + ...member-cluster-using-proxy-connection.adoc | 110 ++ .../11-use-extensions/19-tower/_index.adoc | 20 + .../01-create-a-constraint-template.adoc | 57 + .../03-view-constraint-template-details.adoc | 62 + .../04-edit-constraint-template-yaml.adoc | 37 + .../07-delete-constraint-templates.adoc | 46 + .../01-constraint-templates/_index.adoc | 11 + .../01-create-a-constraint.adoc | 72 + .../02-view-a-constraint-list.adoc | 57 + .../03-view-constraint-details.adoc | 56 + .../04-edit-constraint-yaml.adoc | 37 + .../02-constraints/07-delete-constraints.adoc | 45 + .../20-gatekeeper/02-constraints/_index.adoc | 10 + .../20-gatekeeper/_index.adoc | 23 + .../01-config-oauth2-proxy.adoc | 259 ++++ .../21-oauth2-proxy/_index.adoc | 18 + .../22-nvidia-gpu-operator/01-intro.adoc | 20 + .../22-nvidia-gpu-operator/_index.adoc | 8 + .../23-cert-manager/01-intro.adoc | 20 + .../23-cert-manager/_index.adoc | 8 + .../docs/v4.1/11-use-extensions/_index.adoc | 10 + content/zh/docs/v4.1/25-reference/_index.adoc | 1 - 420 files changed, 24636 insertions(+), 52 deletions(-) create mode 100644 content/en/docs/v4.1/02-quickstart/02-install-a-demo-extension.adoc create mode 100644 content/zh/docs/v4.1/02-quickstart/02-install-a-demo-extension.adoc delete mode 100644 content/zh/docs/v4.1/08-workspace-management/05-app-management/02-app-repositories/04-sync-an-app-repository-with-a-helm-chart-repository.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/01-overview.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/01-create-a-devops-project.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/02-view-a-devops-project-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/03-edit-devops-project-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/04-delete-devops-projects.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/01-devops-project-management.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/01-create-a-pipeline-using-graphical-editing-panel.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/02-create-a-pipeline-using-jenkinsfile.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/03-use-pipeline-templates.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/04-gitlab-multibranch-pipeline.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/05-pipeline-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/06-pipeline-webhook.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/07-jenkins-setting.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/08-jenkins-shared-library.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/09-jenkins-email.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/10-choose-jenkins-agent.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/11-customize-jenkins-agent.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/03-use-gitops-for-continous-deployment.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/04-import-code-repositories.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/01-credential-management.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/02-role-and-member-management.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/03-add-cd-allowlist.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/04-set-ci-node.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/01-sonarqube.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/02-harbor.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/01-devops/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/01-create-an-app-template.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/02-view-an-app-template-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/03-view-app-template-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/04-edit-app-template-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/05-install-an-app-by-using-an-app-template.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/06-upload-an-app-version.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/08-delete-an-app-version.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/09-download-a-helm-chart-package.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/10-release-an-app-version-to-the-app-store.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/11-delete-an-app-template.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/01-view-an-app-template-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/02-view-app-template-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/04-edit-an-app-template.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/06-publish-an-app-template.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/08-cancel-release-an-app-version.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/09-delete-an-app-version.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/10-suspend-an-app-template.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/12-delete-an-app-template.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/01-manage-app-categories.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/02-set-the-category-of-an-app.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/01-review-an-app-version.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/02-view-app-review-records.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/01-add-an-app-repository.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/02-view-an-app-repository-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/03-edit-an-app-repository.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/05-delete-an-app-repository.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/01-view-an-app-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/02-view-app-instance-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/04-edit-an-app-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/06-delete-an-app-instance.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/08-deploy-an-app-from-the-app-store.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/10-deploy-an-app-using-an-app-template.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/02-app-store/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/03-manually-compose-an-app.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/04-view-an-app-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/05-view-composed-app-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/06-edit-app-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/07-add-a-service.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/08-add-an-app-route.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/10-delete-apps.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/01-create-a-grayscale-release-task.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/02-view-a-grayscale-release-task-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/03-view-grayscale-release-task-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/04-switch-versions-blue-green-deployment.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/05-adjust-traffic-distribution-ratio-canary-release.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/06-edit-settings-of-a-grayscale-release-task.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/07-delete-a-grayscale-release-task.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/03-service-mesh/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/00-web-console/01-log-in-and-go-to-a-project.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/00-web-console/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/01-create-a-project.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/02-view-a-project-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/03-edit-project-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/04-edit-project-annotations.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/05-add-a-cluster.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/06-delete-projects.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/02-overview/01-view-project-overall-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/02-overview/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/01-compose-an-app.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/02-view-an-app-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/03-view-app-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/04-delete-apps.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/01-create-a-stateful-or-stateless-service.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/02-view-a-service-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/03-view-service-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/04-edit-service-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/05-edit-service-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/06-edit-service-external-access-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/07-delete-services.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/01-create-a-workload.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/02-view-a-workload-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/03-view-workload-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/04-edit-workload-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/05-adjust-the-number-of-pod-replicas.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/06-stop-workloads.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/07-edit-workload-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/08-delete-workloads.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/01-create-a-route.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/02-view-a-route-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/03-view-route-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/04-edit-route-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/05-edit-routing-rules.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/06-edit-route-annotations.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/07-delete-routes.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/01-create-a-persistent-volume-claim.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/02-view-a-persistent-volume-claim-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/03-view-persistent-volume-claim-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/04-edit-persistent-volume-claim-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/05-delete-persistent-volume-claims.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/01-create-a-secret.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/02-view-a-secret-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/03-view-secret-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/04-edit-secret-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/05-edit-secret-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/06-delete-secrets.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/01-create-a-configmap.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/02-view-a-configmap-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/03-view-configmap-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/04-edit-configmap-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/05-edit-configmap-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/06-delete-configmaps.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/01-view-project-basic-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/02-edit-project-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/03-edit-annotation.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/04-add-cluster.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/05-edit-default-container-quotas.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/06-delete-a-project.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/01-view-project-quotas.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/02-edit-project-quotas.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/04-kubefed/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-platform-services/01-intro.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-platform-services/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/01-write-data-to-kafka.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/02-read-data-from-kafka.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/03-configure-platform-service.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/01-config.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/03-use-log-query-tools.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/01-enable-logsidecar.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/02-enable-project-log-collection.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/03-enable-collect-volume-logs.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/01-config-opensearch.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/01-add-a-log-receiver.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/02-view-a-log-receiver-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/03-view-log-receiver-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/04-edit-log-receiver-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/05-enable-and-disable-log-receiver.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/06-delete-a-log-receiver.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/03-events/01-use-event-query-tools.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/03-events/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/04-auditing/01-use-audit-query-tools.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/04-auditing/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/01-cluster-monitoring-overview.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/02-workspace-monitoring-overview.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/03-project-monitoring-overview.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/01-view-cluster-status-overview.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/02-view-physical-resource-status.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/03-view-etcd-status.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/04-view-api-server-status.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/05-view-scheduler-monitoring-data.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/06-view-nodes-ranked-by-resource-usage.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/01-view-resource-usage.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/02-view-projects-ranked-by-resource-usage.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/01-create-a-custom-monitoring-dashboard.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/02-view-a-custom-monitoring-dashboard.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/03-edit-custom-monitoring-dashboard-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/04-edit-a-custom-monitoring-dashboard.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/05-delete-custom-monitoring-dashboards.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/08-edit-a-metrics-exporter.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/01-create-a-rule-group.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/02-view-a-rule-group-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/03-view-rule-group-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/04-edit-rule-group-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/05-edit-alert-rules.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/06-disable-and-enable-rule-groups.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/07-delete-rule-groups.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/08-reset-built-in-rule-groups.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/04-alerts/01-view-an-alert-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/04-alerts/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/01-enable-whizard.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/01-view-monitoring-data-of-multiple-clusters.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/03-resource-ranking.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/01-create-a-rule-group.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/02-view-a-rule-group-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/03-view-rule-group-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/04-edit-rule-group-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/05-edit-alert-rules.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/06-disable-and-enable-rule-groups.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/07-delete-rule-groups.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/08-reset-built-in-rule-groups.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/02-alerts/01-view-an-alert-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/02-alerts/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/01-pod/01-query-pod.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/01-pod/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/11-set-alert-components.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/01-create-rules-for-auditing.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/02-example-rules-for-auditing.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/03-create-rules-for-logs.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/01-set-email-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/02-set-feishu-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/03-set-dingtalk-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/04-set-wecom-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/05-set-slack-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/06-set-webhook-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/01-set-subscription.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/02-view-subscription.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/03-edit-subscription.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/04-delete-subscription.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/01-create-a-silence-policy.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/02-edit-silence-policy-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/03-edit-silence-conditions.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/04-edit-silence-time.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/05-delete-silence-policies.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/06-change-the-notification-language.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/04-notification-history/03-view-notification-history.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/04-notification-history/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/01-set-email-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/02-set-feishu-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/03-set-dingtalk-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/04-set-wecom-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/05-set-slack-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/06-set-webhook-notification.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/07-message-config/01-wechat-template.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/07-message-config/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/15-opensearch/01-intro.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/15-opensearch/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/01-built-in-dashboards.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/05-add-data-source.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/07-create-dashboards.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/17-loki/01-display-loki-data.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/17-loki/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/05-observability-platform/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/01-create-a-network-policy.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/02-view-a-network-policy-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/03-view-network-policy-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/04-edit-network-policy-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/05-edit-network-policy-yaml.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/06-delete-network-policies.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/01-workspace-network-isolation.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/02-project-network-isolation.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/01-create-a-pod-ip-pool.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/02-view-a-pod-ip-pool-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/03-view-pod-ip-pool-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/04-assign-a-project-to-a-ip-pool.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/05-edit-pod-ip-pool-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/06-edit-overlay-mode.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/07-edit-yaml-for-a-pod-ip-pool.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/08-disable-and-enable-pod-ip-pool.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/09-delete-pod-ip-pools.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/11-network/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/01-enable-a-project-gateway.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/02-view-project-gateway-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/03-view-project-gateway-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/04-edit-project-gateway-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/05-disable-a-project-gateway.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/01-enable-workspace-gateway.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/02-view-workspace-gateway-info.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/03-view-workspace-gateway-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/04-edit-workspace-gateway-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/05-disable-workspace-gateway.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/01-enable-a-cluster-gateway.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/02-view-gateway-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/03-view-cluster-gateway-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/04-edit-cluster-gateway-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/05-disable-a-cluster-gateway.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/07-issue-no-gateway-log-in-member.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/01-create-a-route.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/02-view-a-route-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/03-view-route-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/04-access-a-backend-service-of-a-route.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/05-edit-route-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/06-edit-routing-rules.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/07-edit-route-annotations.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/08-delete-routes.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/12-gateway/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/01-add-a-domain.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/02-view-a-domain-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/03-edit-domain-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/06-delete-domains.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/01-create-a-volume-snapshot.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/02-view-a-volume-snapshot-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/03-view-volume-snapshot-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/04-create-a-persistent-volume-from-a-volume-snapshot.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/05-delete-volume-snapshots.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/06-view-a-volume-snapshot-content-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/07-view-volume-snapshot-content-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/08-edit-volume-snapshot-content-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/09-delete-a-volume-snapshot-content.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/01-create-a-volume-snapshot-class.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/02-view-a-volume-snapshot-class-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/03-view-volume-snapshot-class-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/04-edit-volume-snapshot-class-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/05-delete-volume-snapshot-classes.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/01-set-authorization-rules.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/02-set-auto-expansion.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/15-storage/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/16-dmp/01-intro.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/16-dmp/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/17-kubeedge/01-add-an-edge-node.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/17-kubeedge/02-view-an-edge-node-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/17-kubeedge/03-delete-an-edge-node.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/17-kubeedge/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/01-create-a-deployment-and-register-the-deployment-as-a-microservice.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/02-view-a-microservice-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/03-edit-the-weight-of-a-microservice.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/04-take-a-microservice-instance-offline-and-online.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/01-create-a-microservice-configuration.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/02-view-a-microservice-configuration-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/03-view-microservice-configuration-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/04-edit-a-microservice-configuration.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/05-replicate-a-microservice-configuration.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/06-roll-back-a-microservice-configuration.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/07-delete-microservice-configurations.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/01-create-a-microservice-gateway.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/02-view-microservice-gateway-information.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/03-view-microservice-gateway-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/04-edit-microservice-gateway-settings.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/05-delete-a-microservice-gateway.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/19-tower/02-add-a-member-cluster-using-proxy-connection.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/19-tower/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/01-create-a-constraint-template.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/03-view-constraint-template-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/04-edit-constraint-template-yaml.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/07-delete-constraint-templates.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/01-create-a-constraint.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/02-view-a-constraint-list.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/03-view-constraint-details.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/04-edit-constraint-yaml.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/07-delete-constraints.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/21-oauth2-proxy/01-config-oauth2-proxy.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/21-oauth2-proxy/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/22-nvidia-gpu-operator/01-intro.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/22-nvidia-gpu-operator/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/23-cert-manager/01-intro.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/23-cert-manager/_index.adoc create mode 100644 content/zh/docs/v4.1/11-use-extensions/_index.adoc diff --git a/content/en/docs/v4.1/02-quickstart/02-install-a-demo-extension.adoc b/content/en/docs/v4.1/02-quickstart/02-install-a-demo-extension.adoc new file mode 100644 index 000000000..6be6a5b0d --- /dev/null +++ b/content/en/docs/v4.1/02-quickstart/02-install-a-demo-extension.adoc @@ -0,0 +1,50 @@ +--- +title: "Install Demo Extensions" +linkTitle: "Install Demo Extensions" +keywords: "Kubernetes,KubeSphere, Quick Start, Installation, Extensions, Example, DevOps" +description: "Show how to install extensions with DevOps as an example." +weight: 02 +--- + +KubeSphere extensions run on KubeSphere Core to extend and enhance the capabilities of KubeSphere, further meeting different business requirements of enterprises. + +This section demonstrates how to install extensions in the {ks_product-en} web console, taking DevOps as an example. After the DevOps installation is complete, you can create DevOps projects in a workspace. +// For more information on DevOps projects, please refer to link:../../11-use-extensions/01-devops/[DevOps]. + + +== Prerequisites + +You should have the **platform-admin** role on {ks_product-en} platform. For more information, please refer to link:../../05-users-and-roles/01-users/[Users] and link:../../05-users-and-roles/02-platform-roles/[Platform Roles]. + + +== Installation Steps + +. Log in to the {ks_product-en} web console with a user having the **platform-admin** role. +. Click **Extensions Center** to view the list of extensions. +. Click DevOps to enter its details page. +. Click **Manage > Install** to enter the installation process. +. On the **Version Selection** tab of the installation dialog, select the version number of DevOps and install all required dependencies (if any). Then click **Next**. ++ +-- +//note +[.admon.note,cols="a"] +|=== +|Note + +| +During the installation, it detects whether the extension has dependencies. Dependencies are categorized as required and optional. + +If a required dependency is **Not Ready**, you need to install the required version first to ensure the normal use of the extension. Optional dependencies do not affect the installation of the extension. +|=== +-- + +. On the **Extensions Installation** tab, make optional modifications to the configuration of DevOps (if needed), and then click **Start Installation**. + ++ +image:/images/ks-qkcp/en/v4.0/install-extensions.png[,100%] + +. On the **Cluster Selection** tab, select clusters by name or label. Multiple clusters can be selected. + +. On the **Diff Config** tab, edit the selected cluster's YAML file, or leave it unchanged to use the default configuration. Then click **OK** to start configuring the cluster agent. + +Once the installation is complete, the extension is enabled by default. You can configure, upgrade, disable, or uninstall extensions in the extensions center. \ No newline at end of file diff --git a/content/en/docs/v4.1/06-extension-user-guide/01-install-components-pdf.adoc b/content/en/docs/v4.1/06-extension-user-guide/01-install-components-pdf.adoc index 6c3e05c2f..9211da580 100644 --- a/content/en/docs/v4.1/06-extension-user-guide/01-install-components-pdf.adoc +++ b/content/en/docs/v4.1/06-extension-user-guide/01-install-components-pdf.adoc @@ -18,7 +18,7 @@ You should have the **platform-admin** role on {ks_product-en} platform. For mor . Click **Extensions Center** to view the list of extensions. -. Click the name of an uninstalled extension to access the installation page. +. Click the name of an uninstalled extension, and then click **Manage > Install** to access the installation page. . On the **Version Selection** tab of the installation dialog, select the version of the extension and install all required dependencies (if any). Click **Next**. + diff --git a/content/zh/docs/v4.1/02-quickstart/02-install-a-demo-extension.adoc b/content/zh/docs/v4.1/02-quickstart/02-install-a-demo-extension.adoc new file mode 100644 index 000000000..fc424d18e --- /dev/null +++ b/content/zh/docs/v4.1/02-quickstart/02-install-a-demo-extension.adoc @@ -0,0 +1,44 @@ +--- +title: "安装示例组件" +linkTitle: "安装示例组件" +keywords: "Kubernetes, KubeSphere, 快速入门, 安装组件, 示例, DevOps" +description: "以 DevOps 安装为例,演示如何安装扩展组件。" +weight: 02 +--- + +KubeSphere 扩展组件,运行在 KubeSphere Core 之上,用来扩展并增强 KubeSphere 产品能力,以进一步满足企业各类型的业务需求。 + +本节以安装 DevOps 为例,演示如何在{ks_product_left} Web 控制台安装扩展组件。DevOps 安装完成后,即可在企业空间中创建 DevOps 项目。有关组件使用的更多信息,请参阅link:../../11-use-extensions/[扩展组件使用]章节。 + +== 前提条件 + +您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../05-users-and-roles/01-users/[用户]和link:../../05-users-and-roles/02-platform-roles/[平台角色]。 + +== 安装步骤 + +. 以具有 **platform-admin** 角色的用户登录{ks_product_left} Web 控制台。 +. 点击**扩展中心**,查看扩展组件列表。 +. 点击 DevOps 名称,进入组件安装页面。 +. 在组件安装对话框的**版本选择**页签,选择 DevOps 的版本号,并安装好所有必装组件(若有),点击**下一步**。 ++ +[.admon.note,cols="a"] +|=== +|说明 + +| +安装检测时,会识别扩展组件是否有依赖组件。依赖组件分为必装组件和选装组件。 + +若必装组件的状态为**未就绪**,您需要先行安装正确版本的必装组件,以确保扩展组件的正常使用。而选装组件不会影响扩展组件的安装。 +|=== + +. 在**扩展组件安装**页签,修改 DevOps 的配置后(可选),点击**开始安装**即开始安装 DevOps。 ++ +image:/images/ks-qkcp/zh/v4.0/install-extensions.png[,100%] + +. 在**集群选择**页签,根据名称、标识选择集群,可选择多个集群。 + +. 在**差异化配置**页签,分别编辑选中集群的 YAML 配置,也可不修改,使用初始默认配置。点击**确定**,开始配置集群 Agent。 + +安装完成后,默认启用该组件。您可以在扩展中心配置、升级、禁用、卸载扩展组件。 + + diff --git a/content/zh/docs/v4.1/06-extension-user-guide/01-install-components-pdf.adoc b/content/zh/docs/v4.1/06-extension-user-guide/01-install-components-pdf.adoc index 9108d088a..4516131fe 100644 --- a/content/zh/docs/v4.1/06-extension-user-guide/01-install-components-pdf.adoc +++ b/content/zh/docs/v4.1/06-extension-user-guide/01-install-components-pdf.adoc @@ -20,7 +20,7 @@ weight: 01 . 点击**扩展中心**,查看扩展组件列表。 -. 点击未安装的扩展组件名称,进入组件安装页面。 +. 点击未安装的扩展组件名称,然后点击**管理 > 安装**,进入组件安装页面。 . 在组件安装对话框的**版本选择**页签,选择扩展组件的版本号,并安装好所有必装组件,点击**下一步**。 diff --git a/content/zh/docs/v4.1/07-cluster-management/09-cluster-settings/02-cluster-visibility/_index.adoc b/content/zh/docs/v4.1/07-cluster-management/09-cluster-settings/02-cluster-visibility/_index.adoc index bc2f933c6..ad90582c0 100644 --- a/content/zh/docs/v4.1/07-cluster-management/09-cluster-settings/02-cluster-visibility/_index.adoc +++ b/content/zh/docs/v4.1/07-cluster-management/09-cluster-settings/02-cluster-visibility/_index.adoc @@ -13,11 +13,4 @@ weight: 02 * 您可以将一个集群授权给多个企业空间,从而允许企业空间中的资源运行在该集群上。 -ifeval::["{file_output_type}" == "html"] -* 您也可以将多个集群授权给同一个企业空间,从而在企业空间中创建联邦项目。 -// 有关联邦项目的更多信息,请参阅link:../../../11-use-extensions/04-kubefed[联邦项目]。 -endif::[] - -ifeval::["{file_output_type}" == "pdf"] -* 您也可以将多个集群授权给同一个企业空间,从而在企业空间中创建联邦项目。有关联邦项目的更多信息,请参阅《{ks_product_right}扩展组件使用指南》的“联邦集群应用管理”章节。 -endif::[] +* 您也可以将多个集群授权给同一个企业空间,从而在企业空间中创建联邦项目。有关联邦项目的更多信息,请参阅link:../../../11-use-extensions/04-kubefed[联邦项目]。 diff --git a/content/zh/docs/v4.1/07-cluster-management/10-multi-cluster-management/01-clusters/01-add-a-member-cluster/_index.adoc b/content/zh/docs/v4.1/07-cluster-management/10-multi-cluster-management/01-clusters/01-add-a-member-cluster/_index.adoc index 53ed578c6..3eb88c777 100644 --- a/content/zh/docs/v4.1/07-cluster-management/10-multi-cluster-management/01-clusters/01-add-a-member-cluster/_index.adoc +++ b/content/zh/docs/v4.1/07-cluster-management/10-multi-cluster-management/01-clusters/01-add-a-member-cluster/_index.adoc @@ -22,8 +22,7 @@ weight: 01 |说明 | -若要使用代理连接,{ks_product_both}平台需要安装并启用 **KubeSphere 多集群代理连接**扩展组件。 -// 有关更多信息,请参阅link:../../../../11-use-extensions/19-tower/02-add-a-member-cluster-using-proxy-connection/[通过代理连接添加成员集群]。 +若要使用代理连接,{ks_product_both}平台需要安装并启用 **KubeSphere 多集群代理连接**扩展组件。有关更多信息,请参阅link:../../../../11-use-extensions/19-tower/02-add-a-member-cluster-using-proxy-connection/[通过代理连接添加成员集群]。 |=== diff --git a/content/zh/docs/v4.1/08-workspace-management/05-app-management/02-app-repositories/04-sync-an-app-repository-with-a-helm-chart-repository.adoc b/content/zh/docs/v4.1/08-workspace-management/05-app-management/02-app-repositories/04-sync-an-app-repository-with-a-helm-chart-repository.adoc deleted file mode 100644 index b5922a71f..000000000 --- a/content/zh/docs/v4.1/08-workspace-management/05-app-management/02-app-repositories/04-sync-an-app-repository-with-a-helm-chart-repository.adoc +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: "使应用仓库和 Helm Chart 仓库同步" -linkTitle: "使应用仓库和 Helm Chart 仓库同步" -keywords: "Kubernetes, KubeSphere, 企业空间, 应用仓库, 使应用仓库和 Helm Chart 仓库同步" -description: "介绍如何同步应用仓库和 Helm Chart 仓库。" -draft: true -weight: 04 ---- - - -:ks_permission: **应用仓库管理** -:ks_navigation: **应用管理 > 应用仓库** - - -本节介绍如何使应用仓库和 Helm Chart 仓库同步。 - -如果您在添加应用仓库时已设置同步周期,系统将根据同步周期自动同步应用仓库和 Helm Chart 仓库。您也可以按照本节介绍的步骤手动使应用仓库和 Helm Chart 仓库同步。 - - -== 前提条件 - -include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] - - -== 操作步骤 - -include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] - -+ - -include::../../../../../_ks_components/oper-navigate.adoc[] - -+ - -. 选择需要同步的应用仓库左侧的复选框,然后在列表上方点击**同步**。 -+ --- -系统将根据 Helm Chart 仓库更新应用仓库。 --- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/01-overview.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/01-overview.adoc new file mode 100644 index 000000000..dd5beb678 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/01-overview.adoc @@ -0,0 +1,44 @@ +--- +title: "概述" +keywords: "Kubernetes, {ks_product}, DevOps, 概述" +description: "介绍 DevOps 的基本原理。" +weight: 01 +--- + +DevOps 提供一系列持续集成 (CI) 和持续交付 (CD) 工具,可以使 IT 和软件开发团队之间的流程实现自动化。在 CI/CD 工作流中,每次集成都通过自动化构建来验证,包括编码、发布和测试,从而帮助开发者提前发现集成错误,团队也可以快速、安全、可靠地将内部软件交付到生产环境。 + +不过,传统的 Jenkins Controller-Agent 架构(即多个 Agent 为一个 Controller 工作)有以下不足。 + +* 如果 Controller 宕机,整个 CI/CD 流水线会崩溃。 +* 资源分配不均衡,一些 Agent 的流水线任务 (Job) 出现排队等待,而其他 Agent 处于空闲状态。 +* 不同的 Agent 可能配置环境不同,并需要使用不同的编码语言。这种差异会给管理和维护带来不便。 + +DevOps 组件支持源代码管理工具,例如 GitHub、Git 和 Bitbucket,支持通过图形编辑面板 (Jenkinsfile out of SCM) 构建 CI/CD 流水线,或者从代码仓库 (Jenkinsfile in SCM) 创建基于 Jenkinsfile 的流水线。 + +== 功能 + +DevOps 组件提供以下功能: + +* 独立的 DevOps 项目,提供访问可控的 CI/CD 流水线。 +* 开箱即用的 DevOps 功能,无需复杂的 Jenkins 配置。 +// * 支持 S2I(Source-to-Image),快速交付镜像。 +* link:../03-how-to-use/02-pipelines/02-create-a-pipeline-using-jenkinsfile/[基于 Jenkinsfile 的流水线],提供一致的用户体验,支持多个代码仓库。 +* link:../03-how-to-use/02-pipelines/01-create-a-pipeline-using-graphical-editing-panel/[图形编辑面板],用于创建流水线,学习成本低。 +* 强大的工具集成机制,例如 link:../04-how-to-integrate/01-sonarqube/[SonarQube],用于代码质量检查。 +* 基于 ArgoCD 的持续交付能力,自动化部署到多集群环境。 + +== DevOps 流水线工作流 + +DevOps CI/CD 流水线基于底层 Kubernetes Jenkins Agent 运行。这些 Jenkins Agent 可以动态扩缩,即根据任务状态进行动态供应或释放。Jenkins Controller 和 Agent 以 Pod 的形式运行在{ks_product_both}节点上。Controller 运行在其中一个节点上,其配置数据存储在一个持久卷声明中。Agent 运行在各个节点上,但可能不会一直处于运行状态,而是根据需求动态创建并自动删除。 + +当 Jenkins Controller 收到构建请求,会根据标签动态创建运行在 Pod 中的 Jenkins Agent 并注册到 Controller 上。当 Agent 运行完任务后,将会被释放,相关的 Pod 也会被删除。 + +== 动态供应 Jenkins Agent + +动态供应 Jenkins Agent 有以下优势: + +**资源分配合理**:动态分配已创建的 Agent 至空闲节点,避免因单个节点资源利用率高而导致任务排队等待。 + +**高可扩缩性**:当集群因资源不足而导致任务长时间排队等待时,支持向集群新增节点。 + +**高可用性**:当 Jenkins Controller 故障时,DevOps 会自动创建一个新的 Jenkins Controller 容器,并将持久卷挂载至新创建的容器,保证数据不会丢失,从而实现集群高可用。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/01-create-a-devops-project.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/01-create-a-devops-project.adoc new file mode 100644 index 000000000..729e570cb --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/01-create-a-devops-project.adoc @@ -0,0 +1,54 @@ +--- +title: "创建 DevOps 项目" +keywords: "Kubernetes, {ks_product}, 企业空间, DevOps 项目, 创建 DevOps 项目" +description: "介绍如何创建 DevOps 项目。" +weight: 01 +--- + +:ks_permission:  **DevOps 项目创建** +:ks_navigation:  **DevOps 项目** + + +本节介绍如何创建 DevOps 项目。 + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + +. 在 **DevOps 项目**页面,点击**创建**。 + +. 在**创建 DevOps 项目**对话框,设置 DevOps 项目的参数,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|DevOps 项目的名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母开头并以小写字母或数字结尾,最长 63 个字符。 + +include::../../../../_custom/workspaceManagement/devopsProjects/devopsProject-para-aliasAndDescription.adoc[] + +|集群设置 +|可供 DevOps 项目使用的集群。DevOps 项目中的资源运行在此处选择的集群中。 +|=== + +DevOps 项目创建完成后,您可以邀请用户加入 DevOps 项目并在 DevOps 项目中部署业务。 + +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/02-view-a-devops-project-list.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/02-view-a-devops-project-list.adoc new file mode 100644 index 000000000..aa50a470c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/02-view-a-devops-project-list.adoc @@ -0,0 +1,74 @@ +--- +title: "查看 DevOps 项目列表" +keywords: "Kubernetes, {ks_product}, 企业空间, DevOps 项目, 查看 DevOps 项目列表" +description: "介绍如何查看 DevOps 项目列表。" +weight: 02 +--- + + +:ks_permission:  **DevOps 项目查看** +:ks_navigation:  **DevOps 项目** + + +本节介绍如何查看 DevOps 项目列表。 + + +== 前提条件 + + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +* DevOps 项目列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|DevOps 项目的名称。 + +|状态 +|DevOps 项目当前的状态。 + +* **成功**:DevOps 项目已创建成功并且可用。 + +* **等待中**:DevOps 项目正在创建中。 + +* **删除中**:DevOps 项目正在删除中。 + +|创建者 +|创建 DevOps 项目的用户。 + +|创建时间 +|DevOps 项目的创建时间。 +|=== +-- + +* 在列表上方点击搜索框并输入关键字,可搜索名称包含特定关键字的 DevOps 项目。 + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] + +* 在列表中点击一个 DevOps 项目的名称可打开 DevOps 项目管理页面。您可以在 DevOps 项目管理页面查看和管理 DevOps 项目中的资源。 + + +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/03-edit-devops-project-information.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/03-edit-devops-project-information.adoc new file mode 100644 index 000000000..3945c29a4 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/03-edit-devops-project-information.adoc @@ -0,0 +1,51 @@ +--- +title: "编辑 DevOps 项目信息" +keywords: "Kuberentes, {ks_product}, 企业空间管理, DevOps 项目, 编辑 DevOps 项目信息" +description: "介绍如何编辑 DevOps 项目信息。" +weight: 03 +--- + +:ks_permission:  **DevOps 项目管理** +:ks_navigation:  **DevOps 项目** + + +本节介绍如何编辑项目信息。 + +您可以编辑项目的别名和描述。{ks_product_right}不支持编辑已创建 DevOps 项目的名称。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的 DevOps 项目右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑信息**。 + +. 在**编辑信息**对话框,设置 DevOps 项目的别名和描述,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../_custom/workspaceManagement/devopsProjects/devopsProject-para-aliasAndDescription.adoc[] +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/04-delete-devops-projects.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/04-delete-devops-projects.adoc new file mode 100644 index 000000000..5af3b4174 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/04-delete-devops-projects.adoc @@ -0,0 +1,63 @@ +--- +title: "删除 DevOps 项目" +keywords: "Kuberentes, {ks_product}, 企业空间管理, DevOps 项目, 删除 DevOps 项目" +description: "介绍如何编辑删除 DevOps 项目。" +weight: 04 +--- + +:ks_permission:  **DevOps 项目管理** +:ks_navigation:  **DevOps 项目** + +本节介绍如何删除 DevOps 项目。 + +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +DevOps 项目删除后不能恢复,同时 DevOps 项目中的所有的资源也将被删除,请谨慎执行此操作。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + + +== 删除单个项目 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要删除的 DevOps 项目右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除 DevOps 项目**对话框,输入 DevOps 项目的名称,然后点击**确定**。 + + +== 批量删除项目 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 选择需要删除的 DevOps 项目左侧的复选框,然后在 DevOps 项目列表上方点击**删除**。 + +. 在**批量删除 DevOps 项目**对话框,输入 DevOps 项目的名称,然后点击**确定**。 ++ +-- +include::../../../../_custom/note-separateNamesByComma.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/_index.adoc new file mode 100644 index 000000000..085757184 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/02-devops-projects/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "管理 DevOps 项目" +keywords: "Kubernetes, {ks_product}, 企业空间, DevOps 项目" +description: "介绍如何查看 DevOps 项目信息以及管理 DevOps 项目。" +weight: 02 +layout: "second" +--- + + + +本节介绍如何管理 DevOps 项目。 + +DevOps 项目为用户提供了持续集成和持续部署(CI/CD)功能。您可以在 DevOps 项目中将{ks_product_both}与第三方代码仓库对接,然后通过流水线或持续部署使源代码变化自动更新到目标环境中。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/01-devops-project-management.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/01-devops-project-management.adoc new file mode 100644 index 000000000..c2918d1b0 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/01-devops-project-management.adoc @@ -0,0 +1,73 @@ +--- +title: "创建和管理 DevOps 项目" +keywords: "Kubernetes, {ks_product}, DevOps 项目, DevOps 项目管理" +description: "演示如何创建和管理 DevOps 项目。" +weight: 01 +--- + +本节演示如何创建和管理 DevOps 项目。 + +== 前提条件 + +ifeval::["{file_output_type}" == "html"] +* 已创建一个企业空间和一个用户 (**project-admin**),需要邀请该用户至该企业空间并赋予 **workspace-self-provisioner** 角色。有关更多信息,请参阅link:../../../../02-quickstart/03-control-user-permissions[控制用户权限]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +* 已创建一个企业空间和一个用户 (**project-admin**),需要邀请该用户至该企业空间并赋予 **workspace-self-provisioner** 角色。有关更多信息,请参阅《{ks_product_right}快速入门》的“控制用户权限”章节。 +endif::[] + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + + + +== 创建 DevOps 项目 + +. 以 **project-admin** 用户登录{ks_product_both} Web 控制台,进入一个企业空间。 + +. 点击 **DevOps 项目**,然后点击**创建**。 + +. 输入 DevOps 项目的基本信息,然后点击**确定**。 ++ +-- +* **名称**:DevOps 项目的简明名称,便于用户识别,例如 **demo-devops**。 + +* **别名**:DevOps 项目的别名。 + +* **描述信息**:DevOps 项目的简要介绍。 + +* **集群设置**:在当前版本中,DevOps 项目无法同时跨多个集群运行。如果有多个集群,则必须选择一个集群来运行 DevOps 项目。 +-- + +. DevOps 项目创建后,会显示在 DevOps 项目页面的列表中。 + + +== 查看 DevOps 项目 + +点击刚刚创建的 DevOps 项目,转到其详情页面。 + +在 DevOps 项目中,用户可以创建 CI/CD 流水线、凭证,以及管理项目成员和角色。根据权限不同,用户在 DevOps 项目中可以执行的操作也不同。 + +* 流水线 ++ +-- +流水线是一系列插件的集合,支持持续地集成、测试和构建代码。流水线将持续集成 (CI) 和持续交付 (CD) 进行结合,提供精简的工作流,使您的代码可以自动交付给任何目标。 +-- + +* 凭证 ++ +-- +具有相应权限的 DevOps 项目用户可以为流水线配置凭证,以便与外部环境进行交互。用户在 DevOps 项目中添加凭证后,DevOps 项目就可以使用这些凭证与第三方应用程序(例如 GitHub、GitLab 和 Docker Hub)进行交互。有关更多信息,请参阅link:../../03-how-to-use/05-devops-settings/01-credential-management/[凭证管理]。 +-- + +* 成员和角色 ++ +-- +与项目相似,DevOps 项目也需要为用户授予角色,以便用户在 DevOps 项目拥有不同的权限。项目管理员(例如 **project-admin**)负责邀请用户并授予他们不同的角色。有关更多信息,请参阅link:../../03-how-to-use/05-devops-settings/02-role-and-member-management/[角色和成员管理]。 +-- + +== 编辑或删除 DevOps 项目 + +. 点击 **DevOps 项目设置**下的**基本信息**,查看当前 DevOps 项目的概述,如项目角色和项目成员的数量、项目名称和项目创建者等。 + +. 点击右侧的**管理**按钮,编辑此 DevOps 项目的基本信息或删除 DevOps 项目。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/01-create-a-pipeline-using-graphical-editing-panel.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/01-create-a-pipeline-using-graphical-editing-panel.adoc new file mode 100644 index 000000000..a9d35ddb8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/01-create-a-pipeline-using-graphical-editing-panel.adoc @@ -0,0 +1,500 @@ +--- +title: "使用图形编辑面板创建流水线" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线, 使用图形编辑面板创建流水线" +description: "介绍如何使用图形编辑面板创建流水线。" +weight: 01 +--- + + +DevOps 中的图形编辑面板包含用于 Jenkins link:https://www.jenkins.io/zh/doc/book/pipeline/#阶段[阶段 (Stage)] 和link:https://www.jenkins.io/zh/doc/book/pipeline/#步骤[步骤 (Step)] 的所有必要操作。DevOps 支持直接在交互式面板上定义这些阶段和步骤,无需创建任何 Jenkinsfile。 + +本文档演示如何在{ks_product_both}中使用图形编辑面板创建流水线。在整个过程中,DevOps 将根据编辑面板上的设置自动生成 Jenkinsfile,您无需手动创建 Jenkinsfile。待流水线成功运行,它会将镜像推送至 Docker Hub。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已有一个 link:http://www.dockerhub.com/[Docker Hub] 账户。 + +* 已创建一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../../05-devops-settings/02-role-and-member-management[角色和成员管理]。 + +* 已设置 CI 专用节点用于运行流水线。请参阅link:../../05-devops-settings/04-set-ci-node/[为缓存依赖项设置 CI 节点]。 + +* 配置电子邮件服务器用于接收流水线通知(可选)。 +请参阅link:../09-jenkins-email/[为流水线设置电子邮件服务器]。 + +* 配置 SonarQube 将代码分析纳入流水线中(可选)。 +请参阅link:../../../04-how-to-integrate/01-sonarqube/[将 SonarQube 集成到流水线]。 + + +== 流水线概述 + +本示例流水线包括以下阶段。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +* **阶段 1:Checkout SCM**:从 GitHub 仓库拉取源代码。 + +* **阶段 2:单元测试**:待该测试通过后才会进行下一阶段。 + +* **阶段 3:代码分析**:配置 SonarQube 用于静态代码分析。 + +* **阶段 4:构建并推送**:构建镜像并附上标签 **snapshot-$BUILD_NUMBER** 推送至 Docker Hub,其中 **$BUILD_NUMBER** 是流水线运行记录列表中的记录的运行 ID。 + +* **阶段 5:制品**:生成一个制品(JAR 文件包)并保存。 + +// * **阶段 6:部署至开发环境**:在开发环境中创建一个部署和一个服务。该阶段需要进行审核,部署成功运行后,会发送电子邮件通知。 +|=== + + +== 步骤 1:创建凭证 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目,在 **DevOps 项目设置**下的**凭证**页面创建以下凭证。有关如何创建凭证的更多信息,请参阅link:../../05-devops-settings/01-credential-management/[凭证管理]。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +如果您的账户或密码中包含任何特殊字符,例如 **@** 和 **$**,可能会因为无法识别而在流水线运行时导致错误。在这种情况下,请先在一些第三方网站(例如 link:https://www.urlencoder.org/[urlencoder])上对账户或密码进行编码,然后将输出结果复制粘贴作为您的凭证信息。 + +|=== + +[%header,cols="1a,2a,2a"] +|=== +|凭证 ID |类型 |用途 + +|dockerhub-id +|用户名和密码 +|Docker Hub + +// |demo-kubeconfig +// |kubeconfig +// |Kubernetes +|=== +-- + +. 再为 SonarQube 创建一个凭证 (**sonar-token**),用于上述的阶段 3(代码分析)。凭证类型选择**访问令牌**,在**令牌**字段输入 SonarQube 令牌,请参阅link:../../../04-how-to-integrate/01-sonarqube/[为新项目创建 SonarQube 令牌 (Token)]。点击**确定**完成操作。 + +. 创建完成后,您将在凭证页面看到已创建的凭证。 + +// == 步骤 2:创建项目 + +// 本示例中,流水线会将 link:https://github.com/kubesphere/devops-maven-sample/tree/sonarqube[sample] 应用部署至一个项目。因此,需要创建一个项目(例如 **kubesphere-sample-dev**)。待流水线成功运行,将在该项目中自动创建该应用的部署和服务。 + +// . 使用 **project-admin** 账户创建项目,该用户也将是 CI/CD 流水线的审核员。 + +// . 邀请 **project-regular** 账户至该项目,并授予 **operator** 角色。 + + +== 步骤 2:创建流水线 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目,在**流水线**页面点击**创建**。 + +. 在弹出的对话框中,将其命名为 **graphical-pipeline**,点击**下一步**。 + +. 在**高级设置**页面,点击**添加**,添加以下字符串参数。这些参数将用于流水线的 Docker 命令。添加完成后,点击**创建**。 ++ +-- +[%header,cols="1a,2a,2a,2a"] +|=== +|参数类型 |名称 |值 |参数说明 + +|字符串 +|REGISTRY +|`docker.io` +|镜像仓库地址。本示例使用 **docker.io**。 + +|字符串 +|DOCKERHUB_NAMESPACE +|您的 Docker ID +|您的 Docker Hub 账户或该账户下的组织名称。 + +|字符串 +|APP_NAME +|`devops-sample` +|应用名称。本示例使用 **devops-sample**。 +|=== + +// note +[.admon.note,cols="a"] +|=== +|说明 + +| +有关其他字段,请直接使用默认值或者参阅link:../05-pipeline-settings/[流水线设置]以自定义配置。 +|=== +-- + +== 步骤 3:编辑流水线 + +. 点击流水线名称进入其详情页面。 + +. 要使用图形编辑面板,点击**流水线配置**页签下的**编辑流水线**。在弹出的对话框中: + +* 点击**自定义流水线**,按照以下步骤设置各个阶段。 + +* 或使用 DevOps 提供的link:../03-use-pipeline-templates/[内置流水线模板]。 + +. 点击**下一步**,然后点击**创建**。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +流水线详情页面的**同步状态**,显示了{ks_product_both}和 Jenkins 之间的同步结果。也可点击**编辑 Jenkinsfile** 手动为流水线创建一个 Jenkinsfile。 + +|=== + +=== 阶段 1:拉取源代码 (Checkout SCM) + +图形编辑面板包括两个区域:左侧的**画布**和右侧的**内容**。它会根据您对不同阶段和步骤的配置自动生成一个 Jenkinsfile,为开发者提供更加用户友好的操作体验。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +流水线包括link:https://www.jenkins.io/zh/doc/book/pipeline/syntax/#声明式流水线[声明式流水线]和link:https://www.jenkins.io/zh/doc/book/pipeline/syntax/#脚本化流水线[脚本化流水线]。目前,支持使用该面板创建声明式流水线。有关流水线语法的更多信息,请参阅 link:https://www.jenkins.io/zh/doc/book/pipeline/syntax/[Jenkins 文档]。 + +|=== + +. 在图形编辑面板上,从**类型**下拉列表中选择 **node**,从 **Label** 下拉列表中选择 **maven**。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +**Agent** 用于定义执行环境。**Agent** 指令指定 Jenkins 执行流水线的位置和方式。有关更多信息,请参阅link:../10-choose-jenkins-agent/[选择 Jenkins Agent]。 + +|=== + +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/graphical_panel.png[,100%] +-- + +. 点击左侧的加号图标来添加阶段。点击**添加步骤**上方的文本框,然后在右侧的**名称**字段中为该阶段设置名称(例如 **Checkout SCM**)。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/edit_panel.png[,100%] + +. 点击**添加步骤**。在列表中选择 **Git Clone**,以从 GitHub 拉取示例代码。在弹出的对话框中,填写必需的字段。点击**确定**完成操作。 ++ +-- +* **URL**:输入 GitHub 仓库地址 link:https://github.com/kubesphere/devops-maven-sample.git[]。注意,这里是示例地址,请使用自己的仓库地址。 + +* **凭证 ID**:本示例中无需输入凭证 ID。 + +* **分支**:输入 **v4.1.0-sonarqube**。如果不需要代码分析阶段,则使用默认的 v4.1.0 分支。 + +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/enter_repo_url.png[,100%] +-- + +=== 阶段 2:单元测试 + +. 点击阶段 1 右侧的加号图标添加新的阶段,以在容器中执行单元测试。将它命名为 **Unit Test**。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/unit_test.png[,100%] + +. 点击**添加步骤**,在列表中选择**指定容器**。将其命名为 **maven** 然后点击**确定**。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/container_maven.png[,100%] + +. 点击 **maven** 容器步骤下的**添加嵌套步骤**,在列表中选择 **shell** 并输入以下命令。点击**确定**保存操作。 ++ +-- +[,bash] +---- +mvn clean test +---- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +在图形编辑面板上,可指定在给定阶段指令中执行的一系列link:https://www.jenkins.io/zh/doc/book/pipeline/syntax/#steps[步骤]。 +|=== +-- + +=== 阶段 3:代码分析(可选) + +本阶段使用 SonarQube 用于测试代码。如果不需要代码分析,可以跳过该阶段。 + +. 点击 **Unit Test** 阶段右侧的加号图标添加一个阶段,以在容器中进行 SonarQube 代码分析。将它命名为 **Code Analysis**。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/code_analysis_stage.png[,100%] + +. 在 **Code Analysis** 中,点击**添加步骤**,选择**指定容器**。将其命名为 **maven** 然后点击**确定**。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/maven_container.png[,100%] + +. 点击 **maven** 容器步骤下的**添加嵌套步骤**,以添加一个嵌套步骤。点击**添加凭证**并从**凭证 ID** 列表中选择 SonarQube 令牌 (**sonar-token**)。在**文本变量**中输入 **SONAR_TOKEN**,然后点击**确定**。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/sonarqube_credentials.png[,100%] + +. 在**添加凭证**步骤下,点击**添加嵌套步骤**为其添加一个嵌套步骤。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/nested_step.png[,100%] + +. 点击 **Sonarqube 配置**,在弹出的对话框中保持默认名称 **sonar** 不变,点击**确定**保存操作。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/sonar_env.png[,100%] + +. 在 **Sonarqube 配置**步骤下,点击**添加嵌套步骤**为其添加一个嵌套步骤。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/add_nested_step.png[,100%] + +. 点击 **shell** 并在命令行中输入以下命令,用于 sonarqube 认证和分析,点击**确定**完成操作。 ++ +-- +[,bash] +---- +mvn sonar:sonar -Dsonar.login=$SONAR_TOKEN +---- +-- + +. 点击**指定容器**步骤下的**添加嵌套步骤**(第三个),选择**超时**。在时间中输入 **1** 并将单位选择为**小时**,点击**确定**完成操作。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/add_nested_step_2.png[,100%] ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/timeout_set.png[,100%] + +. 点击**超时**步骤下的**添加嵌套步骤**,选择**代码质量检查 (SonarQube)**。在弹出的对话框中选择**检查通过后开始后续任务**。点击**确定**保存操作。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/waitforqualitygate_set.png[,100%] ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/sonar_ready.png[,100%] + + +=== 阶段 4:构建并推送镜像 + +. 点击前一个阶段右侧的加号图标添加一个新的阶段,以构建并推送镜像至 Docker Hub。将其命名为 **Build and Push**。 + +. 在 **Build and Push** 中,点击**添加步骤**,选择**指定容器**,将其命名为 **maven**,然后点击**确定**。 + +. 点击 **maven** 容器步骤下的**添加嵌套步骤**,在列表中选择 **shell** 并在弹出窗口中输入以下命令,点击**确定**完成操作。 ++ +-- +[,bash] +---- +mvn -Dmaven.test.skip=true clean package +---- +-- + +. 再次点击**添加嵌套步骤**,选择 **shell**。在命令行中输入以下命令,以根据 link:https://github.com/kubesphere/devops-maven-sample/blob/sonarqube/Dockerfile-online[Dockerfile] 构建 Docker 镜像。点击**确定**确认操作。 ++ +-- +[,bash] +---- +docker build -f Dockerfile-online -t $REGISTRY/$DOCKERHUB_NAMESPACE/$APP_NAME:SNAPSHOT-$BUILD_NUMBER . +---- +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/shell_command.png[,100%] +-- + +. 再次点击**添加嵌套步骤**,选择**添加凭证**。在弹出的对话框中填写以下字段,点击**确定**确认操作。 ++ +-- +* **凭证名称**:选择您创建的 Docker Hub 凭证,例如 **dockerhub-id**。 +* **用户名变量**:输入 **DOCKER_USERNAME**。 +* **密码变量**:输入 **DOCKER_PASSWORD**。 + +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/docker_credential.png[,100%] + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +出于安全原因,账户信息在脚本中显示为变量。 + +|=== +-- + +. 在**添加凭证**步骤中点击**添加嵌套步骤**(第一个)。选择 **shell** 并在弹出窗口中输入以下命令,用于登录 Docker Hub。点击**确定**确认操作。 ++ +-- +[,bash] +---- +echo "$DOCKER_PASSWORD"|docker login $REGISTRY -u "$DOCKER_USERNAME" --password-stdin +---- + +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/login_docker_command.png[,100%] +-- + +. 在**添加凭证**步骤中点击**添加嵌套步骤**。选择 **shell** 并输入以下命令,将 SNAPSHOT 镜像推送至 Docker Hub。点击**确定**完成操作。 ++ +-- +[,bash] +---- +docker push $REGISTRY/$DOCKERHUB_NAMESPACE/$APP_NAME:SNAPSHOT-$BUILD_NUMBER +---- +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/push_to_docker.png[,100%] +-- + +=== 阶段 5:生成制品 + +. 点击 **Build and Push** 阶段右侧的加号图标添加一个新的阶段,以保存制品,将其命名为 **Artifacts**。本示例使用 JAR 文件包。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/add_artifact_stage.png[,100%] + +. 选中 **Artifacts** 阶段,点击**添加步骤**,选择**保存制品**。在弹出的对话框中输入 **target/*.jar**,将其设置为 Jenkins 中制品的保存路径。点击**确定**完成操作。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/artifact_info.png[,100%] + +// === 阶段 6:部署至开发环境 + +// . 点击 **Artifacts** 阶段右侧的加号图标添加最后一个阶段,将其命名为 **Deploy to Dev**。该阶段用于将资源部署至您的开发环境(即 **kubesphere-sample-dev** 项目)。 +// + +// image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/deploy_to_dev.png[,100%] + +// . 点击 **Deploy to Dev** 阶段下的**添加步骤**,在列表中选择**审核**,然后在**消息**字段中填入 **@project-admin**,即 **project-admin** 账户在流水线运行到该阶段时会进行审核。点击**确定**保存操作。 +// + +// -- +// image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/input_message.png[,100%] +// //note +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 在{ks_product_both}中,能够运行流水线的账户也能够继续或终止该流水线。 + +// 此外,流水线创建者、拥有该项目管理员角色的用户或者您指定的账户也有权限继续或终止流水线。 + +// |=== +// -- + +// . 再次点击 **Deploy to Dev** 阶段下的**添加步骤**。在列表中选择**指定容器**,将其命名为 **maven**,然后点击**确定**。 + +// . 点击 **maven** 容器步骤下的**添加嵌套步骤**。在列表中选择**添加凭证**,在弹出的对话框中填写以下字段,然后点击**确定**。 +// + +// -- +// * 凭证名称:选择您创建的 kubeconfig 凭证,例如 **demo-kubeconfig**。 + +// * kubeconfig 变量:输入 **KUBECONFIG_CONTENT**。 +// -- + +// . 点击**添加凭证**步骤下的**添加嵌套步骤**。在列表中选择 **shell**,在弹出的对话框中输入以下命令,然后点击**确定**。 +// + +// -- +// [,bash] +// ---- +// mkdir ~/.kube +// echo "$KUBECONFIG_CONTENT" > ~/.kube/config +// envsubst < deploy/no-branch-dev/devops-sample-svc.yaml | kubectl apply -f - +// envsubst < deploy/no-branch-dev/devops-sample.yaml | kubectl apply -f - +// ---- +// -- + +// . 如果想在流水线运行成功时接收电子邮件通知,请点击**添加步骤**,选择**邮件**,以添加电子邮件信息。注意,配置电子邮件服务器是可选操作,如果跳过该步骤,依然可以运行流水线。 +// + +// -- +// //note +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 有关配置电子邮件服务器的更多信息,请参阅link:../09-jenkins-email/[为{ks_product_both}流水线设置电子邮件服务器]。 + +// |=== +// -- + +// . 待完成上述步骤,在右下角点击**确定**,结束编辑流水线。该流水线将展示完整的工作流,并且清晰列示每个阶段。 +// + +// -- +// 在用图形编辑面板定义流水线时,DevOps 会自动创建相应的 Jenkinsfile。点击**编辑 Jenkinsfile** 查看该 Jenkinsfile。 + +// //note +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 在**流水线**列表页面,点击该流水线右侧的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],选择**复制**来创建该流水线的副本。 +// |=== +// -- + +== 步骤 4:运行流水线 + +. 使用图形编辑面板创建的流水线需要手动运行。点击**运行**,弹出的对话框会显示link:#_步骤_2创建流水线[步骤 2:创建流水线]中已定义的三个字符串参数。点击**确定**来运行流水线。 +// . 使用图形编辑面板创建的流水线需要手动运行。点击**运行**,弹出的对话框会显示link:#_步骤_3创建流水线[步骤 3:创建流水线]中已定义的三个字符串参数。点击**确定**来运行流水线。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/run_pipeline.png[,100%] + +. 点击**运行记录**页签,查看流水线的运行状态,点击记录查看详情。 + +. 流水线如果运行到 **Push with Tag** 阶段,会在此阶段暂停,需要具有审核权限的用户点击**继续**。 +// . 稍等片刻,流水线如果运行成功,会在 **Deploy to Dev** 阶段停止。**project-admin** 作为流水线的审核员,需要进行审批,然后资源才会部署至开发环境。 + +. 以 **project-admin** 用户登录{ks_product_both} Web 控制台,点击**企业空间管理**并进入您的 DevOps 项目,点击 **graphical-pipeline** 流水线。在**运行记录**页签下,点击要审核的记录,点击**继续**以批准流水线。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +如果要同时运行多个不包含多分支的流水线,在**流水线**列表页面,全部选中这些流水线,然后点击**运行**来批量运行它们。 +|=== + +== 步骤 5:查看流水线详情 + +. 以 **project-regular** 用户登录 {ks_product_both} Web 控制台,点击**企业空间管理**并进入您的 DevOps 项目,点击 **graphical-pipeline** 流水线。 + +. 在**运行记录**页签下,点击**状态**下的记录,进入**运行记录**详情页。如果任务状态为**成功**,流水线所有阶段都会显示**成功**。 + +. 在**运行日志**页签下,点击每个阶段查看其详细日志。点击**查看完整日志**,根据日志排除故障和问题,也可以将日志下载到本地进行进一步分析。 + +== 步骤 6:下载制品 + +在**运行记录**详情页,点击**制品**页签,然后点击制品右侧的图标下载该制品。 + +== 步骤 7:查看代码分析结果 + +在**代码检查**页面,查看由 SonarQube 提供的本示例流水线的代码分析结果。如果没有事先配置 SonarQube,则该部分不可用。有关更多信息,请参阅link:../../../04-how-to-integrate/01-sonarqube/[将 SonarQube 集成到流水线]。 + +== 步骤 8:验证 Kubernetes 资源 + +如果流水线的每个阶段都成功运行,则会自动构建一个 Docker 镜像并推送至您的 Docker Hub 仓库。 +// 如果流水线的每个阶段都成功运行,则会自动构建一个 Docker 镜像并推送至您的 Docker Hub 仓库。最终,流水线会在您事先设置的项目中自动创建一个部署和一个服务。 + +// . 进入项目(本示例中即 **kubesphere-sample-dev**),点击**应用负载**下的**工作负载**,查看流水线自动创建的部署。 + +// . 点击**应用负载**下的**服务**,查看示例服务通过 NodePort 暴露的端口号。使用 **:** 访问该服务。 +// + +// -- +// //note +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 访问服务前,您可能需要配置端口转发规则并在安全组中放行该端口。 + +// |=== +// -- + +. 流水线成功运行后,会推送一个镜像至 Docker Hub。登录 Docker Hub 查看结果。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-graphical-editing-panel/dockerhub_image.png[,100%] + +. 该应用名称为 **APP_NAME** 的值,本示例中即 **devops-sample**。Tag 为 **SNAPSHOT-$BUILD_NUMBER** 的值,**$BUILD_NUMBER** 即**运行记录**页签下记录的**运行 ID**。 + +// . 如果您在link:#_阶段_6部署至开发环境[阶段 6:部署至开发环境]配置了电子邮件服务器并添加了电子邮件信息,运行完成后还会收到邮件通知。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/02-create-a-pipeline-using-jenkinsfile.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/02-create-a-pipeline-using-jenkinsfile.adoc new file mode 100644 index 000000000..785d77fb4 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/02-create-a-pipeline-using-jenkinsfile.adoc @@ -0,0 +1,455 @@ +--- +title: "使用 Jenkinsfile 创建流水线" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线, 使用 Jenkinsfile 创建流水线" +description: "介绍如何使用 Jenkinsfile 创建流水线。" +weight: 02 +--- + +Jenkinsfile 是一个文本文件,包含 Jenkins 流水线的定义,并被检入源代码控制仓库。Jenkinsfile 将整个工作流存储为代码,因此它是代码审查和流水线迭代过程的基础。有关更多信息,请参阅 link:https://www.jenkins.io/zh/doc/book/pipeline/jenkinsfile/[Jenkins 官方文档]。 + +本文档演示如何基于 GitHub 仓库中的 Jenkinsfile 创建流水线。 +// 本文档演示如何基于 GitHub 仓库中的 Jenkinsfile 创建流水线,并使用该流水线将示例应用程序分别部署到可从外部访问的开发环境和生产环境。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +DevOps 支持创建两种类型的流水线:一种是本文档中介绍的基于 SCM 中 Jenkinsfile 创建的流水线,另一种是link:../01-create-a-pipeline-using-graphical-editing-panel/[通过图形编辑面板创建的流水线]。 + +Jenkinsfile in SCM 需要源代码管理 (SCM) 中有内置 Jenkinsfile,换句话说,Jenkinsfile 必须是 SCM 的一部分。DevOps 系统会根据代码仓库的现有 Jenkinsfile 自动构建 CI/CD 流水线。通过定义工作流,例如 **stage** 和 **step** 可以满足特定的构建、测试和部署要求。 + +|=== + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已有一个 link:https://hub.docker.com/[Docker Hub] 账户和一个 link:https://github.com/[GitHub] 账户。 + +* 已创建一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../../05-devops-settings/02-role-and-member-management[角色和成员管理]。 + +* 已设置 CI 专用节点用于运行流水线。请参阅link:../../05-devops-settings/04-set-ci-node/[为依赖项缓存设置 CI 节点]。 + +* 已安装和配置 SonarQube(可选)。请参阅link:../../../04-how-to-integrate/01-sonarqube/[将 SonarQube 集成到流水线]。如果跳过这一部分,则没有下面的 **SonarQube 分析**阶段。 + +== 流水线概述 + +本示例流水线包括以下阶段。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +* **阶段 1:Checkout SCM**:从 GitHub 仓库检出源代码。 + +* **阶段 2:单元测试**:待该测试通过后才会进行下一阶段。 + +* **阶段 3:SonarQube 分析**:SonarQube 代码质量分析。 + +* **阶段 4:构建并推送快照镜像**:根据**策略设置**中选定的分支来构建镜像,并将 **SNAPSHOT-$BRANCH_NAME-$BUILD_NUMBER** 标签推送至 Docker Hub,其中 **$BUILD_NUMBER** 是流水线运行记录列表中的记录的运行 ID。 + +* **阶段 5:推送最新镜像**:将 v4.1.0-sonarqube 分支标记为 **latest**,并推送至 Docker Hub。 + +// * **阶段 6:部署至开发环境**:将 v4.1.0-sonarqube 分支部署到开发环境,此阶段需要审核。 + +* **阶段 6:带标签推送**:生成标签并发布到 GitHub,该标签会推送到 Docker Hub。 + +// * **阶段 8:部署至生产环境**:将已发布的标签部署到生产环境。 + +|=== + +== 步骤 1:创建凭证 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目,在 **DevOps 项目设置**下的**凭证**页面创建以下凭证。有关如何创建凭证的更多信息,请参阅link:../../05-devops-settings/01-credential-management/[凭证管理]。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +如果您的账户或密码中包含任何特殊字符,例如 **@** 和 **$**,可能会因为无法识别而在流水线运行时导致错误。在这种情况下,请先在一些第三方网站(例如 link:https://www.urlencoder.org/[urlencoder])上对账户或密码进行编码,然后将输出结果复制粘贴作为您的凭证信息。 +|=== + +[%header,cols="1a,2a,2a"] +|=== +|凭证 ID |类型 |用途 + +|dockerhub-id +|用户名和密码 +|Docker Hub + +|github-id +|用户名和密码 +|GitHub + +// |demo-kubeconfig +// |kubeconfig +// |Kubernetes +|=== +-- + +. 再为 SonarQube 创建一个凭证 (**sonar-token**),用于上述的阶段 3(代码分析)。凭证类型选择**访问令牌**,在**令牌**字段输入 SonarQube 令牌,请参阅link:../../../04-how-to-integrate/01-sonarqube/[为新项目创建 SonarQube 令牌 (Token)]。点击**确定**完成操作。 + +. 还需要创建具有如下图所示权限的 GitHub 个人访问令牌 (PAT),然后在 DevOps 项目中,使用生成的令牌创建用于 GitHub 认证的账户凭证(例如,**github-token**)。 ++ +-- +image:/images/ks-qkcp/zh/devops-user-guide/use-devops/create-a-pipeline-using-a-jenkinsfile/github-token-scope.png[,100%] +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +如需创建 GitHub 个人访问令牌,请转到您 GitHub 账户的 **Settings**,点击 **Developer settings**,选择 **Personal access tokens**,然后点击 **Generate new token**。 + +|=== +-- + +. 您将在凭证页面看到已创建的凭证。 + + +== 步骤 2:在 GitHub 仓库中修改 Jenkinsfile + +. 登录 GitHub 并 Fork GitHub 仓库 link:https://github.com/kubesphere/devops-maven-sample[devops-maven-sample] 的所有分支至您的 GitHub 个人账户。 + +. 在您自己的 GitHub 仓库 **devops-maven-sample** 中,切换到 v4.1.0-sonarqube 分支,点击根目录中的文件 **Jenkinsfile-online**。 + +. 点击右侧的编辑图标,编辑环境变量。 ++ +-- +[%header,cols="1a,2a,2a"] +|=== +|条目 |值 |描述信息 + +|DOCKER_CREDENTIAL_ID +|dockerhub-id +|您在{ks_product_both}中为 Docker Hub 账户设置的**名称**。 + +|GITHUB_CREDENTIAL_ID +|github-id +|您在{ks_product_both}中为 GitHub 账户设置的**名称**,用于将标签推送至您的 GitHub 仓库。 + +// |KUBECONFIG_CREDENTIAL_ID +// |demo-kubeconfig +// |您在{ks_product_both}中为 kubeconfig 设置的**名称**,用于访问运行中的 Kubernetes 集群。 + +|REGISTRY +|docker.io +|默认为 **docker.io**,用作推送镜像的地址。 + +|DOCKERHUB_NAMESPACE +|your-dockerhub-id +|请替换为您的 Docker Hub 账户名,也可以替换为该账户下的 Organization 名称。 + +|GITHUB_ACCOUNT +|your-github-id +|请替换为您的 GitHub 账户名。例如,如果您的 GitHub 地址是 link:https://github.com/kubesphere/[],则您的 GitHub 账户名为 **kubesphere**,也可以替换为该账户下的 Organization 名称。 + +|APP_NAME +|devops-maven-sample +|应用名称。 + +|SONAR_CREDENTIAL_ID +|sonar-token +|您在{ks_product_both}中为 SonarQube 令牌设置的**名称**,用于代码质量检测。 +|=== + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +Jenkinsfile 中 **mvn** 命令的参数 **-o** 表示开启离线模式。本教程中已下载相关依赖项,以节省时间并适应某些环境中的网络干扰。离线模式默认开启。 + +|=== +-- + +. 编辑环境变量后,点击 **Commit changes**,更新 v4.1.0-sonarqube 分支中的文件。 + + +// == 步骤 3:创建项目 + +// 创建两个项目,例如 **kubesphere-sample-dev** 和 **kubesphere-sample-prod**,分别代表开发环境和生产环境。待流水线成功运行,将在这两个项目中自动创建应用程序的相关部署 (Deployment) 和服务 (Service)。 + +// //note +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 您需要提前创建 **project-admin** 账户,用作 CI/CD 流水线的审核者。 + +// |=== + +// . 以 **project-admin** 用户登录{ks_product_left},在创建 DevOps 项目的企业空间中创建以下两个项目。 +// + +// -- +// [%header,cols="1a,1a"] +// |=== +// |项目名称|别名 + +// |kubesphere-sample-dev +// |development environment + +// |kubesphere-sample-prod +// |production environment +// |=== +// -- + +// . 邀请 **project-regular** 账户至这两个项目,并赋予 **operator** 角色。 + +== 步骤 3:创建流水线 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目,在**流水线**页面点击**创建**。 + +. 在弹出的对话框中,将其命名为 **jenkinsfile-in-scm**。 + +. 在**流水线类别**下,选择**多分支流水线**。 + +. 在**代码仓库**下,选择一个代码仓库,点击**下一步**继续。 ++ +-- +若没有可用的代码仓库,点击下方的**创建代码仓库**。有关更多信息,请参阅link:../../04-import-code-repositories/[导入代码仓库]。 +-- + +.. 在**导入代码仓库**对话框,输入代码仓库名称(自定义),点击选择代码仓库。 + +.. 在 **GitHub** 页签,从**凭证**的下拉菜单中选择 **github-token**,然后点击**确定**。 + +.. 在 GitHub 列表中,选择您的 GitHub 账户,与该令牌相关的所有仓库将在右侧列出。选择 **devops-maven-sample** 并点击**选择**。 + +.. 点击**确定**选择您的代码仓库。 + + +. 在**高级设置**中,勾选**删除旧分支**。本教程中,建议**分支保留天数(天)**和**分支最大数量**使用默认值。 ++ +-- +删除旧分支意味着您将一并丢弃分支记录。分支记录包括控制台输出、已归档制品以及特定分支相关的其他元数据。更少的分支意味着您可以节省 Jenkins 正在使用的磁盘空间。DevOps 提供两个选项来确定何时丢弃旧分支: + +* 分支保留天数(天):超过保留期限的分支将被删除。 + +* 分支最大数量:分支数量超过最大数量时,删除最旧的分支。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +**分支保留天数(天)**和**分支最大数量**可以同时应用于分支。只要某个分支满足其中一个字段所设置的条件,则会删除该分支。例如,如果您将保留天数和最大分支数分别指定为 2 和 3,待某个分支的保留天数超过 2 或者分支保留数量超过 3,则会删除该分支。DevOps 默认用 7 和 5 预填充这两个字段。 + +|=== +-- + +. 在**策略设置**中,DevOps 默认提供四种策略。本示例不会使用**从 Fork 仓库中发现 PR** 这条策略,因此您可以删除该策略。对于其他策略,无需修改设置,直接使用默认值即可。 ++ +-- +Jenkins 流水线运行时,开发者提交的 Pull Request (PR) 也将被视为一个单独的分支。 + +**发现分支** + +* **排除已提交 PR 的分支**:不扫描源分支,例如源仓库的 master 分支。需要合并这些分支。 +* **只包括已提交 PR 的分支**:仅扫描 PR 分支。 +* **包括所有分支**:拉取源仓库中的所有分支。 + +**从原仓库发现 PR** + +* **拉取 PR 合并后的代码**:PR 合并到目标分支后,基于源代码创建并运行流水线。 +* **拉取 PR 提交时的代码**:根据 PR 本身的源代码创建并运行流水线。 +* **分别创建两个流水线**:创建两个流水线,一个流水线使用 PR 与目标分支合并后的源代码版本,另一个使用 PR 本身的源代码版本。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +选择 GitHub 作为代码仓库,才能启用此处的**策略设置**设置。 + +|=== +-- + +. 向下滚动到**脚本路径**,将其更改为 **Jenkinsfile-online**,这是示例仓库中位于根目录下的 Jenkinsfile 的文件名。该字段指定代码仓库中的 Jenkinsfile 路径。它表示仓库的根目录。如果文件位置变更,则脚本路径也需要更改。 + +. 在**扫描触发器**中,勾选**定时扫描**并设置时间间隔为 **5 分钟**。点击**创建**完成配置。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +设置特定的时间间隔让流水线扫描远程仓库,以便根据您在**策略设置**中设置的策略来检测代码更新或新的 PR。 + +|=== + + +== 步骤 4:运行流水线 + +. 流水线创建后,会展示在列表中。点击流水线名称查看其详情页。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +* 在**流水线**列表页面,点击该流水线右侧的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],选择**复制**来创建该流水线的副本。 +* 如果要同时运行多个不包含多分支的流水线,在**流水线**列表页面,全部选中这些流水线,然后点击**运行**来批量运行它们。 +* 流水线详情页面的**同步状态**,显示了{ks_product_both}和 Jenkins 之间的同步结果。若同步成功,将显示**成功**以及绿色的对号图标。 + +|=== +-- + +. 在**运行记录**页签下,正在扫描多个分支。点击右侧的**运行**,流水线将根据您设置的行为策略来运行。从下拉列表中选择 **v4.1.0-sonarqube** 分支,然后添加标签号,例如 **v0.0.2**。点击**确定**开始运行。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +* 如果您在此页面上未看到任何运行记录,则需要手动刷新浏览器或点击**更多操作**按钮中的**扫描仓库**。 +* 标签名称用于在 GitHub 和 Docker Hub 中指代新生成的发布版本和镜像。现有标签名称不能再次用于字段 **TAG_NAME**。否则,流水线将无法成功运行。 + +|=== +-- + +. 稍等片刻,点击运行记录查看详情。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +运行失败可能由不同因素所引起。本示例中,在上述步骤中编辑分支的环境变量时,仅更改了 v4.1.0-sonarqube 分支的 Jenkinsfile。而 v4.1.0 分支中的这些变量没有修改(使用了错误的 GitHub 和 Docker Hub 账户),从而导致失败。其他原因如网络问题、Jenkinsfile 中的编码不正确等也可能导致运行失败。 + +在运行记录详情页的**运行日志**页签下,查看其日志的详细信息,根据日志排除故障和问题。 +|=== +-- + +. 流水线如果运行到 **Push with Tag** 阶段,会在此阶段暂停,需要具有审核权限的用户点击**继续**。 +// . 流水线如果运行成功,会在 **deploy to dev** 阶段暂停,需要具有审核权限的用户点击**继续**。 ++ +-- +// 在 Jenkinsfile 中定义了三个阶段 **deploy to dev**、**push with tag** 和 **deploy to production**,每个阶段都需要审核。因此在运行到这些阶段时,流水线会暂停,等待审核。 + +在开发或生产环境中,可能需要具有更高权限的人员(例如版本管理员)来审核流水线、镜像以及代码分析结果。他们有权决定流水线是否能进入下一阶段。在 Jenkinsfile 中,支持使用 **input** 来指定审核流水线的用户。如果想指定一个用户(例如 **project-admin**)来审核,可以在 Jenkinsfile 中添加一个字段。如果有多个用户,则需要通过逗号进行分隔,如下所示: + +[,bash] +---- +input(id: 'release-image-with-tag', message: 'release image with tag?', submitter: 'project-admin,project-admin1') +---- +-- + +. 以具有流水线审核权限的用户登录{ks_product_both} Web 控制台,点击**企业空间管理**并进入您的 DevOps 项目,点击流水线名称进入详情页。在**运行记录**页签下,点击要审核的记录,点击**继续**以批准流水线。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +在{ks_product_both}中,如果不指定审核员,那么能够运行流水线的账户也能够继续或终止该流水线。此外,流水线创建者、拥有该项目管理员角色的用户或者您指定的账户也有权限继续或终止流水线。 +|=== + +== 步骤 5:检查流水线状态 + +. 在运行记录的**流水线**页签下,查看流水线的运行状态。流水线在刚创建时会初始化几分钟。示例流水线有八个阶段,它们已在 link:https://github.com/kubesphere/devops-maven-sample/blob/sonarqube/Jenkinsfile-online[Jenkinsfile-online] 中单独定义。 + +. 点击**运行日志**页签查看流水线运行日志。点击每个阶段查看其详细日志。点击**查看完整日志**,根据日志排除故障和问题,也可以将日志下载到本地进行进一步分析。 + +== 步骤 6:验证结果 + +. 流水线成功运行后,点击**代码检查**通过 SonarQube 查看结果。 + +. 按照 Jenkinsfile 中的定义,通过流水线构建的 Docker 镜像也已成功推送到 Docker Hub。在 Docker Hub 中,您会看到带有标签 **v0.0.2** 的镜像,该标签在流水线运行之前已指定。 + +. 同时,GitHub 中会生成一个新标签和一个新发布版本。 + +// . 示例应用程序将部署到 **kubesphere-sample-dev** 和 **kubesphere-sample-prod**,并创建相应的部署和服务。转到这两个项目,预期结果如下所示: +// + +// -- +// [%header,cols="1a,2a,2a,2a,2a"] +// |=== +// |环境 |URL |命名空间 |部署 |服务 + +// |开发环境 +// |http://{$NodeIP}:{$30861} +// |kubesphere-sample-dev +// |ks-sample-dev +// |ks-sample-dev + +// |生产环境 +// |http://{$NodeIP}:{$30961} +// |kubesphere-sample-prod +// |ks-sample +// |ks-sample +// |=== + +// //note +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 您可能需要在您的安全组中放行该端口,以便通过 URL 访问应用程序。 + +// |=== +// -- + +// == 步骤 7:访问示例服务 + +// . 以 **platform-admin** 用户登录{ks_product_both} Web 控制台。 + +// . 进入 **kubesphere-sample-dev** 项目,在**应用负载**下的**服务**中点击 **ks-sample-dev**。在详情页获取 Endpoint 用于访问该服务。 + +// . 在右下角的**工具箱**中使用 **kubectl** 执行如下命令: +// + +// [,bash] +// ---- +// curl 10.233.120.230:8080 +// ---- + + +// . 预期输出: +// + +// -- +// [,bash] +// ---- +// Really appreciate your star, that's the power of our life. +// ---- +// //note +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 使用 **curl** 访问 Endpoint,或者访问 {$Virtual IP}:{$Port} 或 {$Node IP}:{$NodePort}。 + +// |=== +// -- + +// . 也可以在项目 **kubesphere-sample-prod** 中测试服务,您将看到相同的输出结果。 +// + +// [,bash] +// ---- +// $ curl 10.233.120.236:8080 +// Really appreciate your star, that's the power of our life. +// ---- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/03-use-pipeline-templates.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/03-use-pipeline-templates.adoc new file mode 100644 index 000000000..d9ffd52fd --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/03-use-pipeline-templates.adoc @@ -0,0 +1,123 @@ +--- +title: "使用流水线模板创建流水线" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线" +description: "介绍如何使用流水线模板创建流水线。" +weight: 03 +--- + +本文档演示如何在{ks_product_both}上使用流水线模板创建流水线。 + +DevOps 提供图形编辑面板,支持通过交互式操作来定义 Jenkins 流水线的阶段和步骤。内置多个流水线模板,如 Node.js、Maven 以及 Golang,使用户能够快速创建对应模板的流水线。DevOps 还提供 CI 以及 CI & CD 流水线模板,但是这两个模板难以满足定制化需求,建议您采用其它内置模板或直接自定义流水线。 + +* CI 流水线模板 ++ +-- +CI 流水线模板包含两个阶段。**clone code** 阶段用于检出代码,**build & push** 阶段用于构建镜像并将镜像推送至 Docker Hub。先为代码仓库和 Docker Hub 仓库创建凭证,然后在相应的步骤中设置仓库的 URL 以及凭证。完成编辑后,流水线即可开始运行。 +-- + +* CI & CD 流水线模板 ++ +-- +CI & CD 流水线模板包含六个阶段。有关每个阶段的更多信息,请参阅link:../02-create-a-pipeline-using-jenkinsfile/[使用 Jenkinsfile 创建流水线]。先为代码仓库、Docker Hub 仓库创建凭证,然后在相应的步骤中设置仓库的 URL 以及凭证。完成编辑后,流水线即可开始运行。 +// CI & CD 流水线模板包含六个阶段。有关每个阶段的更多信息,请参阅link:../02-create-a-pipeline-using-jenkinsfile/[使用 Jenkinsfile 创建流水线]。先为代码仓库、Docker Hub 仓库和集群的 kubeconfig 创建凭证,然后在相应的步骤中设置仓库的 URL 以及凭证。完成编辑后,流水线即可开始运行。 +-- + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已创建一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../../05-devops-settings/02-role-and-member-management[角色和成员管理]。 + + +== 操作步骤 + +下面以 Node.js 为例演示如何使用内置流水线模板。使用 Maven 以及 Golang 流水线模板的操作基本相同。 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目,在**流水线**页面点击**创建**。 + +. 在弹出的对话框中,输入流水线名称,点击**下一步**,然后点击**创建**。 + +. 点击已创建的流水线,在**流水线配置**页签下,点击**编辑流水线**。 + +. 在**创建流水线**对话框,点击 **Node.js**,然后点击**下一步**。 + +. 在**参数设置**页签,按照实际情况设置以下参数,点击**创建**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|GitURL +|需要克隆的项目仓库的地址。 + +|GitRevision +|需要检出的分支。 + +|NodeDockerImage +|Node.js 的 Docker 镜像版本。 + +|InstallScript +|安装依赖项的 Shell 脚本。 + +|TestScript +|项目测试的 Shell 脚本。 + +|BuildScript +|构建项目的 Sell 脚本。 + +|ArtifactsPath +|制品文件所在的路径。 +|=== +-- + +. 在左侧的可视化编辑页面,系统默认已添加一系列步骤,点击**添加步骤**或**添加并行阶段**进行修改。 + +. 点击一个步骤,在页面右侧,您可以执行以下操作。编辑完成后,点击**确定**。 ++ +-- +* 修改阶段名称。 + +* 删除阶段。 + +* 设置代理类型。 + +* 添加条件。 + +* 编辑或删除某一任务。 + +* 添加步骤或嵌套步骤。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +请参阅link:../01-create-a-pipeline-using-graphical-editing-panel/[使用图形编辑面板创建流水线],了解如何在流水线模板中自定义步骤和阶段。 + +|=== +-- + +. 在右侧的**代理**区域,选择代理类型,默认值为 **kubernetes**,点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|代理类型|说明 + +|any +|调用默认的 base pod 模板创建 Jenkins agent 运行流水线。 + +|node +|调用指定类型的 pod 模板创建 Jenkins agent 运行流水线,可配置的 label 标签为 base、java、nodejs、maven、go 等。 + +|kubernetes +|通过 yaml 文件定义的标准 kubernetes pod 模板运行 agent,执行流水线任务。 +|=== +-- + +. 查看已创建的流水线模板详情,点击**运行**即可运行该流水线。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/04-gitlab-multibranch-pipeline.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/04-gitlab-multibranch-pipeline.adoc new file mode 100644 index 000000000..81665bbdd --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/04-gitlab-multibranch-pipeline.adoc @@ -0,0 +1,225 @@ +--- +title: "使用 GitLab 创建多分支流水线" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线" +description: "介绍如何使用 GitLab 创建多分支流水线。" +weight: 04 +--- + + +link:https://gitlab.com/users/sign_in[GitLab] 是一款基于 web 的 Git 仓库管理工具,支持公开和私有仓库,并提供了全面的 DevOps 功能,包括源代码管理、代码审查、问题跟踪、持续集成等。通过 GitLab,团队能够在一个平台上高效协作,完成从代码编写到部署的整个软件开发过程。 + +{ks_product_right}支持在 DevOps 项目中使用 GitLab 创建多分支流水线。本文档演示如何使用 GitLab 创建多分支流水线。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已创建一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../../05-devops-settings/02-role-and-member-management[角色和成员管理]。 + +* 已有一个 link:https://gitlab.com/users/sign_in[GitLab] 账户以及一个 link:https://hub.docker.com/[Docker Hub] 账户。 + +== 步骤 1:创建凭证 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目,在 **DevOps 项目设置**下的**凭证**中创建以下凭证。有关如何创建凭证的更多信息,请参阅link:../../05-devops-settings/01-credential-management/[凭证管理]。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +如果您的账户或密码中包含任何特殊字符,例如 **@** 和 **$**,则可能会因为无法识别而在流水线运行时导致错误。在此情况下,您需要先在第三方网站(例如 link:https://www.urlencoder.org/[urlencoder])上对账户或密码进行编码,然后将输出结果复制粘贴作为您的凭证信息。 + +|=== + +[%header,cols="1a,2a,2a"] +|=== +|凭证 ID|类型|用途 + +|dockerhub-id +|用户名和密码 +|Docker Hub + +|gitlab-id +|用户名和密码 +|GitLab + +// |demo-kubeconfig +// |kubeconfig +// |Kubernetes +|=== +-- + +. 创建完成后,您将在凭证页面看到已创建的凭证。 + + +== 步骤 2:在 GitLab 仓库中编辑 Jenkinsfile + +. 登录 GitLab 并创建一个公开项目。点击**新建项目 > 导入项目**,选择**从 URL 导入仓库**,输入 link:https://github.com/kubesphere/devops-maven-sample[devops-maven-sample] 的 URL,可见性级别选择**公开**,然后点击**新建项目**。 + +. 在刚刚创建的项目中,从 v4.1.0 分支中创建一个新分支,命名为 **gitlab-demo**。 + +. 在 **gitlab-demo** 分支中,点击根目录中的 **Jenkinsfile-online** 文件。 + +. 点击**编辑**,分别将 **GITHUB_CREDENTIAL_ID**、**GITHUB_ACCOUNT** 以及 **@github.com** 更改为 **GITLAB_CREDENTIAL_ID**、**GITLAB_ACCOUNT** 以及 **@gitlab.com**,然后编辑下表所列条目。还要将 **push latest** 中 **branch** 的值更改为 **gitlab-demo**。 +// . 点击**编辑**,分别将 **GITHUB_CREDENTIAL_ID**、**GITHUB_ACCOUNT** 以及 **@github.com** 更改为 **GITLAB_CREDENTIAL_ID**、**GITLAB_ACCOUNT** 以及 **@gitlab.com**,然后编辑下表所列条目。还要将 **push latest** 和 **deploy to dev** 中 **branch** 的值更改为 **gitlab-demo**。 ++ +-- +[%header,cols="1a,2a,2a"] +|=== +|条目|值|描述信息 + +|GITLAB_CREDENTIAL_ID +|gitlab-id +|您在{ks_product_both}中为自己的 GitLab 账户设置的**名称**,用于将标签推送至您的 GitLab 仓库。 + +|DOCKERHUB_NAMESPACE +|your-dockerhub-id +|请替换为您的 Docker Hub 账户名,也可以替换为该账户下的 Organization 名称。 + +|GITLAB_ACCOUNT +|your-gitlab-id +|请替换为您的 GitLab 账户名,也可以使用该账户的用户组名称。 +|=== + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +有关 Jenkinsfile 中环境变量的更多信息,请参阅link:../02-create-a-pipeline-using-jenkinsfile/[使用 Jenkinsfile 创建流水线]。 + +|=== +-- + +. 点击 **Commit changes** 更新该文件。 + + +// == 步骤 3:创建项目 + +// 创建两个项目,例如 **kubesphere-sample-dev** 和 **kubesphere-sample-prod**,分别代表开发环境和生产环境。待流水线成功运行,将在这两个项目中自动创建应用程序的相关部署 (Deployment) 和服务 (Service)。 + +// 有关更多信息,请参阅link:../02-create-a-pipeline-using-jenkinsfile/#_步骤_2在_github_仓库中修改_jenkinsfile[使用 Jenkinsfile 创建流水线]。 + +== 步骤 3:创建流水线 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目,在**流水线**页面点击**创建**。 + +. 在弹出的对话框中,将其命名为 **gitlab-multi-branch**。 + +. 在**流水线类别**下,选择**多分支流水线**。 + +. 在**代码仓库**下,选择一个代码仓库,点击**下一步**继续。 ++ +-- +若没有可用的代码仓库,点击下方的**创建代码仓库**。有关更多信息,请参阅link:../../04-import-code-repositories/[导入代码仓库]。 +-- + +.. 在**导入代码仓库**对话框,输入代码仓库名称(自定义),点击选择代码仓库。 + +.. 在 **GitLab** 页签下的 **GitLab 服务器地址**中选择默认选项 link:https://gitlab.com[],在**项目组/所有者**中输入该 GitLab 项目所属组的名称,然后从**代码仓库**的下拉菜单中选择 **devops-maven-sample** 仓库。点击右下角的image:/images/ks-qkcp/zh/icons/check-dark.svg[check,18,18],然后点击**下一步**。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +如需使用 GitLab 私有仓库,请参考以下步骤: + +* 在 GitLab 上前往**用户设置 > 访问令牌**,创建拥有 API 和 read_repository 权限的个人访问令牌。 + +* link:../../../04-how-to-integrate/01-sonarqube/[登录 Jenkins 面板],前往**系统管理 > Manage Credentials**,使用您的 GitLab 令牌创建 Jenkins 凭证,用于访问 GitLab。然后前往**系统管理 > 系统配置**,在 **GitLab 服务**中添加该凭证。 + +* 在 DevOps 项目中,选择 **DevOps 项目设置 > 凭证**,使用您的 GitLab 令牌创建一个凭证。创建流水线时,在 **GitLab** 页签的**凭证**中指定该凭证,以便流水线能够从您的 GitLab 私有仓库中拉取代码。 + +|=== +-- + +. 在**高级设置**页签中,将**脚本路径**更改为 **Jenkinsfile-online** 然后点击**创建**。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +该字段指定代码仓库中的 Jenkinsfile 路径,它表示该仓库的根目录。如果文件位置变更,则脚本路径也需要更改。 + +|=== +-- + + +== 步骤 4:运行流水线 + +. 流水线创建后,会展示在列表中。点击流水线名称查看其详情页。 +. 点击右侧的**运行**。在弹出的对话框中,从下拉菜单中选择 **gitlab-demo** 并添加一个标签号,比如 **v0.0.2**。点击**确定**来触发一个新运行。 +. 稍等片刻,点击运行记录查看详情。 +. 流水线如果运行到 **Push with Tag** 阶段,会在此阶段暂停,需要具有审核权限的用户点击**继续**。 +// . 流水线如果运行成功,会在 **Deploy to Dev** 阶段暂停,需要具有审核权限的用户点击**继续**。 +// + +// -- +// //note +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 在 Jenkinsfile 中定义了三个阶段 **deploy to dev**、**push with tag** 和 **deploy to production**,每个阶段都需要审核。因此在运行到这些阶段时,流水线会暂停,等待审核。 +// |=== +// -- + + +== 步骤 5:检查流水线状态 + +. 在运行记录的**流水线**页签下,查看流水线的运行状态。 + +. 点击**运行日志**页签查看流水线运行日志。点击每个阶段查看其详细日志。点击**查看完整日志**,根据日志排除故障和问题,也可以将日志下载到本地进行进一步分析。 + + +== 步骤 6:验证结果 + +. 按照 Jenkinsfile 中的定义,通过流水线构建的 Docker 镜像也已成功推送到 Docker Hub。在 Docker Hub 中,您会看到带有标签 **v0.0.2** 的镜像,该标签在流水线运行之前已指定。 + +. 同时,GitLab 中也已生成一个新标签。 + +// . 示例应用程序将部署到 **kubesphere-sample-dev** 和 **kubesphere-sample-prod**,并创建相应的部署和服务。转到这两个项目,预期结果如下所示: + +// + +// -- +// [%header,cols="1,2,2,1,1"] +// |=== +// |环境|URL|命名空间|部署|服务 + +// |开发环境 +// |http://{$NodeIP}:{$30861} +// |kubesphere-sample-dev +// |ks-sample-dev +// |ks-sample-dev + +// |生产环境 +// |http://{$NodeIP}:{$30961} +// |kubesphere-sample-prod +// |ks-sample +// |ks-sample +// |=== + +// //note +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 您可能需要在安全组中打开端口,以便使用 URL 访问该应用。有关更多信息,请参阅link:../02-create-a-pipeline-using-jenkinsfile/#_步骤_8访问示例服务[访问示例服务]。 + +// |=== +// -- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/05-pipeline-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/05-pipeline-settings.adoc new file mode 100644 index 000000000..be22090da --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/05-pipeline-settings.adoc @@ -0,0 +1,202 @@ +--- +title: "设置流水线" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线" +description: "介绍如何自定义流水线配置。" +weight: 05 +--- + + +创建流水线时,可以通过各种设置来自定义流水线配置。 + +流水线创建后,进入流水线详情页,点击**编辑信息**和更多操作中的**编辑设置**,也可以编辑流水线的配置。 + +本文档详细介绍如何设置流水线。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已创建一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../../05-devops-settings/02-role-and-member-management[角色和成员管理]。 + + +== 基本信息 + +在**基本信息**页签,您可以自定义以下信息: + +* **名称**:流水线的名称,同一个 DevOps 项目内的流水线不能重名。 + +* **DevOps 项目**:流水线所属的 DevOps 项目。 + +* **描述**:描述流水线的附加信息,描述信息不超过 256 个字符。 + +* **流水线类别**:普通流水线或多分支流水线。若选择多分支流水线,则需要选择一个代码仓库。 + +* **代码仓库(可选)**:选择一个代码仓库作为流水线的代码源,可选择 GitHub、GitLab、Bitbucket、以及 Git 作为代码源。 ++ +==== +* GitHub ++ +-- +如果选择 **GitHub**,则必须指定用于访问 GitHub 的凭证。如果您已预先使用您的 GitHub 令牌创建了凭证,则从下拉菜单中选择已有凭证,或者点击**创建凭证**来创建新凭证。选择凭证后,点击**确定**,即可在右侧选择您的仓库。完成所有操作后,点击image:/images/ks-qkcp/zh/icons/check-dark.svg[check,18,18]。 +-- + +* GitLab ++ +-- +如果选择 **GitLab**,则必须指定 GitLab 服务器地址、项目组/所有者和代码仓库。如果访问代码仓库需要凭证,则需要指定一个凭证。完成所有操作后,点击image:/images/ks-qkcp/zh/icons/check-dark.svg[check,18,18]。 +-- + +* Bitbucket ++ +-- +如果选择 **Bitbucket**,则需要输入您的 Bitbucket 服务器地址。预先使用您的 Bitbucket 用户名和密码创建一个凭证,或者点击**创建凭证**来创建一个新凭证。输入信息后点击**确定**,即可在右侧选择您的仓库。完成所有操作后,点击image:/images/ks-qkcp/zh/icons/check-dark.svg[check,18,18]。 +-- + +* Git ++ +-- +如果选择 **Git**,则需要指定仓库 URL。如果访问代码仓库需要凭证,则需要指定一个凭证,或者点击**创建凭证**来添加新凭证。完成所有操作后,点击image:/images/ks-qkcp/zh/icons/check-dark.svg[check,18,18]。 +-- +==== + +== 高级设置 + +=== 指定代码仓库 + +如果指定了一个代码仓库,则可以在**高级设置**页签上自定义以下配置: + +* 分支设置 ++ +-- +**删除旧分支**:自动删除旧分支。分支记录将一起被删除。分支记录包括控制台输出、已归档制品以及特定分支相关的其他元数据。更少的分支意味着您可以节省 Jenkins 正在使用的磁盘空间。DevOps 提供两个选项来确定何时丢弃旧分支: + +* **分支保留天数(天)**:超过保留期限的分支将被删除。 + +* **分支最大数量**:分支数量超过最大数量时,删除最旧的分支。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +**分支保留天数(天)**和**分支最大数量**可以同时应用于分支。只要某个分支满足其中一个字段所设置的条件,则会删除该分支。例如,如果您将保留天数和最大分支数分别指定为 2 和 3,待某个分支的保留天数超过 2 或者分支保留数量超过 3,则会删除该分支。DevOps 默认用 7 和 5 预填充这两个字段。 + +|=== +-- + +* 策略设置 ++ +-- +在**策略设置**中,DevOps 默认提供四种策略。Jenkins 流水线运行时,开发者提交的 PR (Pull Request) 也将被视为一个单独的分支。 + +**发现分支** + +* **排除已提交 PR 的分支**:已提交 PR 的分支将被排除。 +* **只包括已提交 PR 的分支**:只拉取已提交 PR 的分支。 +* **包括所有分支**:拉取源仓库中的所有分支。 + +**发现标签** + +* **启用标签发现**:拥有指定标签的分支将被扫描。 +* **禁用标签发现**:拥有指定标签的分支不会被扫描。 + +**从原仓库发现 PR** + +* **拉取 PR 合并后的代码**:PR 合并到目标分支后,将基于源代码创建并运行流水线。 +* **拉取 PR 提交时的代码**:根据 PR 本身的源代码创建并运行流水线。 +* **分别创建两个流水线**:创建两个流水线,一个流水线使用 PR 与目标分支合并后的源代码版本,另一个使用 PR 本身的源代码版本。 + +**从 Fork 仓库发现 PR** + +拉取策略: + +* **拉取 PR 合并后的代码**:PR 合并到目标分支后,将基于源代码创建并运行流水线。 +* **拉取 PR 提交时的代码**:根据 PR 本身的源代码创建并运行流水线。 +* **分别创建两个流水线**:创建两个流水线,一个流水线使用 PR 与目标分支合并后的源代码版本,另一个使用 PR 本身的源代码版本。 + +受信用户: + +* **贡献者**:对 PR 做出贡献的用户。 +* **所有人**:每个可以访问 PR 的用户。 +* **具有管理员或有编辑权限的用户**:仅限于对 PR 具有管理员或编辑权限的用户。 +* **无**:如果选择此选项,那么无论在**拉取策略**中选择了哪个选项,都不会发现 PR。 +-- + +* 正则过滤 ++ +-- +勾选选框以指定正则表达式来过滤分支、PR 和标签。 +-- + +* 脚本路径 ++ +-- +**脚本路径**参数指定代码仓库中的 Jenkinsfile 路径,它指代仓库的根目录。如果文件位置发生更改,则脚本路径也需要更改。 +-- + +* 扫描触发器 ++ +-- +勾选**定时扫描**,并从下拉列表中设置扫描时间间隔。 +-- + +* 构建触发器 ++ +-- +勾选**通过流水线事件触发**,从**创建流水线时触发**和**删除流水线时触发**的下拉列表中选择一个流水线,以便在创建新的流水线或删除流水线时自动触发指定流水线中的任务。 +-- + +* 克隆设置 ++ +-- +* **启用浅克隆**:如果开启浅克隆,则克隆的代码不会包含标签。 +* **克隆深度**:克隆时需要提取的 commit 数量。 +* **克隆超时时间(min)**:完成克隆过程所需要的时长(以分钟为单位)。 +-- + +* Webhook ++ +-- +**Webhook** 能有效地让流水线发现远程代码仓库中的更改,并自动触发新一轮运行。Webhook 应成为触发 Jenkins 自动扫描 GitHub 和 Git(例如 GitLab)的主要方法。有关更多信息,请参阅link:../06-pipeline-webhook/[使用 Webhook 触发流水线]。 +-- + + +=== 不指定代码仓库 + +如果不指定代码仓库,则可以在**高级设置**页签上自定义以下配置: + +* 构建设置 ++ +-- +**删除过期构建记录**:指定何时删除分支下的构建记录。构建记录包括控制台输出、已归档制品以及与特定构建相关的其他元数据。保留较少的构建可以节省 Jenkins 所使用的磁盘空间。DevOps 提供两个选项来确定何时删除旧的构建: + +* **构建记录保留期限(天)**:超过保留期限的构建记录将被删除。 + +* **构建记录最大数量**:当构建记录数量超过允许的最大数量,最早的构建记录将被删除。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| + +**构建记录保留期限(天)**和**构建记录最大数量**可以同时应用于构建记录。只要某个构建记录满足其中一个字段所设置的条件,则会删除该构建记录。例如,如果您将保留期限和最大数量分别指定为 2 和 3,待某个构建记录的保留天数超过 2 或者最大数量超过 3,则会删除该构建记录。DevOps 默认用 7 和 10 预填充这两个字段。 +|=== + +* **不允许并发构建**:如果勾选此选项,则不能并发运行多个构建。 +-- + +* 构建参数 ++ +-- +参数化的构建过程允许在开始运行流水线时传入一个或多个参数。DevOps 默认提供五种参数类型,包括**字符串**、**多行字符串**、**布尔值**、**选项**以及**密码**。当参数化项目时,构建会被替换为参数化构建,其中将提示用户为每个定义的参数输入值。 +-- + +* 构建触发器 ++ +-- +**定时构建**:允许定期执行构建。输入 CRON 表达式以设置定时计划。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/06-pipeline-webhook.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/06-pipeline-webhook.adoc new file mode 100644 index 000000000..50e1a5609 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/06-pipeline-webhook.adoc @@ -0,0 +1,77 @@ +--- +title: "使用 Webhook 触发流水线" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线" +description: "介绍如何在 GitHub 仓库中用 webhook 触发流水线。" +weight: 06 +--- + + +若要通过远程代码仓库创建基于 Jenkinsfile 的流水线,可以在远程仓库中配置 webhook,以便在远程仓库变更时,自动触发流水线。 + +本文档演示如何在 GitHub 仓库中用 webhook 触发流水线。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已创建一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../../05-devops-settings/02-role-and-member-management[角色和成员管理]。 + +* 已通过远程代码仓库创建一个基于 Jenkinsfile 的流水线。有关更多信息,请参阅link:../02-create-a-pipeline-using-jenkinsfile/[使用 Jenkinsfile 创建流水线]。 + +== 配置 Webhook + +=== 获取 webhook URL + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目。 + +. 在**流水线**页面,点击一个流水线(例如 **jenkins-in-scm**)以查看其详情页面。 + +. 点击**更多操作**,在下拉菜单中选择**编辑设置**。 + +. 在弹出的会话框中,滚动至 **Webhook** 以获得 Webhook push URL。 + +=== 在 GitHub 仓库中设置 webhook + +. 登录您的 GitHub,并进入 **devops-maven-sample** 仓库。 + +. 点击 **Settings** > **Webhooks**,然后点击 **Add webhook**。 + +. 在 **Payload URL** 中输入流水线中的 Webhook push URL,然后点击 **Add webhook**。 +本教程选择默认的 **Just the push event**,请根据实际需要进行配置。有关更多信息,请参阅 link:https://docs.github.com/en/developers/webhooks-and-events/webhooks/creating-webhooks[GitHub 文档]。 + +. 配置好的 webhook 会展示在 **Webhooks** 页面。 + + +== 使用 Webhook 触发流水线 + +=== 提交拉取请求到仓库 + +. 在 devops-maven-sample 仓库的 **Code** 页面,点击 **master** 然后选择 **v4.1.0-sonarqube** 分支。 + +. 转到 **/deploy/dev-ol** 然后点击文件 **devops-sample.yaml**。 + +. 点击image:/images/ks-qkcp/zh/icons/pen-light.svg[pen-light,18,18]编辑文件。 例如,将 **spec.replicas** 的值改变为 **3**。 + +. 点击 **Commit changes**。 + +=== 检查 webhook 交付 + +. 在 devops-maven-sample 仓库的 **Settings** > **Webhooks** 页面,点击创建的 webhook。 + +. 点击 **Recent Deliveries**,然后点击一个具体交付记录查看详情。 + + +== 检查流水线状态 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目。 + +. 在**流水线**页面,点击一个流水线(例如 **jenkins-in-scm**)以查看其详情页面。 + +. 在**运行记录**页签,检查提交到远程仓库 **v4.1.0-sonarqube** 分支的拉取请求是否触发了新的运行。 + +// . 转到 **kubesphere-sample-dev** 项目的 **工作负载 > 容器组** 页面,检查 3 个 Pods 的状态。如果 3 个 Pods 为运行状态,表示流水线运行正常。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/07-jenkins-setting.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/07-jenkins-setting.adoc new file mode 100644 index 000000000..f2cd331eb --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/07-jenkins-setting.adoc @@ -0,0 +1,55 @@ +--- +title: "设置 Jenkins 系统" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线" +description: "介绍如何在 Jenkins 仪表板上设置 Jenkins 并重新加载配置。" +weight: 07 +--- + +DevOps 系统提供基于 Jenkins 的容器化 CI/CD 功能。Jenkins 作为 CI/CD 工作流的事实标准,具备强大而灵活的特性。然而,许多插件要求用户在使用 Jenkins 之前必须进行系统级配置。 + +为了提供可调度的 Jenkins 环境,{ks_product_right}采用了 **Configuration as Code** 的方式进行 Jenkins 系统设置。用户需要登录 Jenkins 仪表板,修改配置后再重新加载。 + +本文档演示如何在 Jenkins 仪表板上设置 Jenkins 并重新加载配置。 + +== 前提条件 + +{ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + + +== Jenkins Configuration as Code + +{ks_product_right}默认安装 Jenkins Configuration as Code 插件,支持通过 YAML 文件定义 Jenkins 的期望状态,便于再现 Jenkins 的配置(包括插件配置)。请参阅link:https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos[该目录]查看具体的 Jenkins 配置和示例 YAML 文件。 + +此外,还可以在 link:https://github.com/kubesphere/ks-jenkins[ks-jenkins] 仓库中找到 **formula.yaml** 文件,查看插件版本并按需自定义这些版本。 + + +== 修改 ConfigMap + +建议通过 Configuration as Code (CasC) 在{ks_product_both}中配置 Jenkins。将内置 Jenkins CasC 文件存储为 ConfigMap。 + +. 以 **platform-admin** 用户登录{ks_product_left} Web 控制台。 + +. 点击**集群管理**,进入一个集群。 + +. 在左侧导航栏中选择**配置**下的**配置字典**。在**配置字典**页面,从下拉列表中选择 **kubesphere-devops-system**,然后点击 **jenkins-casc-config**。 + +. 在详情页面,点击**更多操作**,在下拉列表中选择**编辑 YAML**。 + +. **jenkins-casc-config** 的配置模板是一个 YAML 文件,位于 **data:jenkins_user.yaml:** 部分。在 ConfigMap 的代理 (Kubernetes Jenkins Agent) 中修改容器镜像、标签、资源请求 (Request) 和限制 (Limit) 等内容,或者在 podTemplate 中添加容器。完成操作后,点击**确定**。 + +. 等待 1 ~ 2 分钟,会自动重新加载新的配置。 + + + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +* 有关如何通过 CasC 设置 Jenkins 的更多信息,请参阅 link:https://github.com/jenkinsci/configuration-as-code-plugin[Jenkins 文档]。 + +* 在当前版本中,并非所有插件都支持 CasC 设置。CasC 仅会覆盖通过 CasC 设置的插件配置。 + +|=== + diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/08-jenkins-shared-library.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/08-jenkins-shared-library.adoc new file mode 100644 index 000000000..3b98c65d0 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/08-jenkins-shared-library.adoc @@ -0,0 +1,150 @@ +--- +title: "在流水线中使用 Jenkins 共享库" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线" +description: "介绍如何在流水线中使用 Jenkins 共享库。" +weight: 08 +--- + + + +对于包含相同阶段或步骤的 Jenkins 流水线,可以在 Jenkinsfile 中使用 Jenkins 共享库避免流水线代码重复。 + +本文档演示如何在 DevOps 流水线中使用 Jenkins 共享库。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已创建一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../../05-devops-settings/02-role-and-member-management[角色和成员管理]。 + +* 已有一个可用 Jenkins 共享库。本教程以 link:https://github.com/devops-ws/jenkins-shared-library[GitHub 仓库]中的 Jenkins 共享库为例。 + + +== 步骤 1:在 Jenkins 仪表盘配置共享库 + +. link:../../../04-how-to-integrate/01-sonarqube/[登录 Jenkins 仪表板]并点击左侧导航栏中的**系统管理**。 + +. 向下滚动并点击**系统配置**。 + +. 向下滚动到 **Global Pipeline Libraries**,然后点击**新增**。 + +. 配置字段如下所示。 + +* **Name:** 为共享库设置名称(例如,`demo-shared-library`),以便在 Jenkinsfile 中引用此名称来导入共享库。 + +* **Default version:** 设置共享库所在仓库的一个分支名称,将其作为导入共享库的默认分支。本教程将使用 master。 + +* 在 **Retrieval method** 下,选择 **Modern SCM**。 + +* 在 **Source Code Management** 下,选择 **Git**,并为**项目仓库**输入示例仓库的 URL 。如果您使用自己的仓库且访问此仓库需要凭证,还需要配置**凭证**。 + +. 编辑完成后,点击**应用**。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +您还可以配置link:https://www.jenkins.io/zh/doc/book/pipeline/shared-libraries/#folder-level-shared-libraries[文件夹级别的共享库]。 + +|=== +-- + +== 步骤 2:在流水线中使用共享库 + + +=== 创建流水线 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目,在**流水线**页面点击**创建**。 + +. 在弹出的对话框中,将其命名为 **demo-shared-library**,点击**下一步**。 + +. 在**高级设置**中,直接点击**创建**,使用默认设置创建流水线。 + +=== 编辑流水线 + +. 在流水线列表页面,点击流水线名称进入其详情页面,然后点击**编辑 Jenkinsfile**。 + +. 在弹出的对话框中,添加以下示例 Jenkinsfile。完成编辑后,点击**确定**。 ++ +-- +[,json] +---- + +library identifier: 'devops-ws-demo@master', retriever: modernSCM([ + $class: 'GitSCMSource', + remote: 'https://github.com/devops-ws/jenkins-shared-library', + traits: [[$class: 'jenkins.plugins.git.traits.BranchDiscoveryTrait']] +]) + +pipeline { + agent any + + stages { + stage('Demo') { + steps { + script { + mvn.fake() + } + } + } + } +} +---- + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +根据需要,为 **agent** 指定 **label**。 + +|=== +-- + ++ +或者,使用以 **@Library('<配置好的共享库名称>') _** 开头的 Jenkinsfile。如果使用这种类型的 Jenkinsfile,需要提前在 Jenkins 仪表板上配置共享库。在本教程中,您可以使用以下示例 Jenkinsfile。 ++ +-- +[,json] +---- + +@Library('demo-shared-library') _ + +pipeline { + agent any + + stages { + stage('Demo') { + steps { + script { + mvn.fake() + } + } + } + } +} +---- + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +使用 **@Library('demo-shared-library@<分支名称>') _** 来指定特定的分支。 + +|=== +-- + +== 步骤 3:运行流水线 + +. 在流水线详情页面,点击**运行**运行流水线。 + +. 点击**运行记录**页签下的记录,查看流水线运行详情。点击**运行日志**查看日志详细信息。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/09-jenkins-email.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/09-jenkins-email.adoc new file mode 100644 index 000000000..6deca46bb --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/09-jenkins-email.adoc @@ -0,0 +1,62 @@ +--- +title: "为流水线设置电子邮件服务器" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线" +description: "介绍如何为流水线设置电子邮件服务器。" +weight: 09 +--- + + +内置 Jenkins 无法与{ks_product_both}的通知系统共享相同的电子邮件配置。因此,您需要单独为 DevOps 流水线配置电子邮件服务器。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 您需要在{ks_product_both}平台具有**集群管理**权限。 + + +== 操作步骤 + +. 以具有**集群管理**权限的账户登录{ks_product_left} Web 控制台。 + +. 点击**集群管理**,进入一个集群。 + +. 在左侧导航栏中选择**应用负载**下的**工作负载**,从下拉列表中选择 **kubesphere-devops-system** 项目。点击 **devops-jenkins** 右侧的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],并选择**编辑 YAML**。 + +. 在 YAML 文件中编辑如下所示的字段。完成修改后,点击**确定**。 ++ +-- +//warning +[.admon.warning,cols="a"] +|=== +|警告 + +| +修改电子邮件服务器配置后,**devops-jenkins** 部署 (Deployment) 会重新启动。因此,DevOps 系统将在几分钟内不可用,请在适当的时候修改这些配置。 + +|=== + + +[%header,cols="1a,3a"] +|=== +|环境变量名称 |描述信息 +|EMAIL_SMTP_HOST +|SMTP 服务器地址 + +|EMAIL_SMTP_PORT +|SMTP 服务器端口(如:25) + +|EMAIL_FROM_ADDR +|电子邮件发件人地址 + +|EMAIL_FROM_NAME +|电子邮件发件人姓名 + +|EMAIL_FROM_PASS +|电子邮件发件人密码 + +|EMAIL_USE_SSL +|是否启用 SSL 配置 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/10-choose-jenkins-agent.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/10-choose-jenkins-agent.adoc new file mode 100644 index 000000000..39995d88c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/10-choose-jenkins-agent.adoc @@ -0,0 +1,219 @@ +--- +title: "选择 Jenkins Agent" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线" +description: "介绍如何选择 Jenkins Agent。" +weight: 10 +--- + + +**agent** 部分指定整个流水线或特定阶段 (Stage) 将在 Jenkins 环境中执行的位置,具体取决于该 **agent** 部分的放置位置。该部分必须在 **pipeline** 块的顶层进行定义,但是阶段级别的使用是可选的。有关更多信息,请参阅 link:https://www.jenkins.io/zh/doc/book/pipeline/syntax/#代理[Jenkins 官方文档]。 + + +== 内置 podTemplate + +podTemplate 是一种 Pod 模板,用于创建 Agent。您可以定义在 Kubernetes 插件中使用的 podTemplate。 + +在流水线运行期间,每个 Jenkins Agent Pod 必须具有一个名为 **jnlp** 的容器,以便实现 Jenkins Controller 与 Jenkins Agent 之间的通信。此外,您可以在 podTemplate 中添加容器,以满足个性化需求。可选择使用自定义的 Pod YAML 来灵活控制运行时环境(Runtime),并通过 **container** 命令来切换容器。以下是相关示例。 + +[,json] +---- + +pipeline { + agent { + kubernetes { + //cloud 'kubernetes' + label 'mypod' + yaml """ +apiVersion: v1 +kind: Pod +spec: + containers: + - name: maven + image: maven:3.3.9-jdk-8-alpine + command: ['cat'] + tty: true +""" + } + } + stages { + stage('Run maven') { + steps { + container('maven') { + sh 'mvn -version' + } + } + } + } +} +---- + +在目前版本中,{ks_product_right}内置了 4 种类型的 podTemplate:**base**、**nodejs**、**maven** 和 **go**,并且在 Pod 中提供隔离的 Docker 环境。 + +您可以通过指定 Agent 的标签来使用内置 podTemplate。例如,要使用 nodejs 的 podTemplate,在创建流水线时指定标签为 **nodejs** 即可,具体参阅以下示例。 + +[,json] +---- + +pipeline { + agent { + node { + label 'nodejs' + } + } + + stages { + stage('nodejs hello') { + steps { + container('nodejs') { + sh 'yarn -v' + sh 'node -v' + sh 'docker version' + sh 'docker images' + } + } + } + } +} +---- + + +* podTemplate base ++ +-- +[%header,cols="1a,4a"] +|=== +|名称 |类型/版本 + +|Jenkins Agent 标签 +|base + +|容器名称 +|base + +|操作系统 +|centos-7 + +|Docker +|18.06.0 + +|Helm +|2.11.0 + +|Kubectl +|稳定版 + +|内置工具 +|unzip、which、make、wget、zip、bzip2、git +|=== +-- + +* podTemplate nodejs ++ +-- +[%header,cols="1a,4a"] +|=== +|名称 |类型/版本 + +|Jenkins Agent 标签 +|nodejs + +|容器名称 +|nodejs + +|操作系统 +|centos-7 + +|Node +|9.11.2 + +|Yarn +|1.3.2 + +|Docker +|18.06.0 + +|Helm +|2.11.0 + +|Kubectl +|稳定版 + +|内置工具 +|unzip、which、make、wget、zip、bzip2、git +|=== +-- + +* podTemplate maven ++ +-- +[%header,cols="1a,4a"] +|=== +|名称|类型/版本 + +|Jenkins Agent 标签 +|maven + +|容器名称 +|maven + +|操作系统 +|centos-7 + +|Jdk +|openjdk-1.8.0 + +|Maven +|3.5.3 + +|Docker +|18.06.0 + +|Helm +|2.11.0 + +|Kubectl +|稳定版 + +|内置工具 +|unzip、which、make、wget、zip、bzip2、git +|=== +-- + +* podTemplate go ++ +-- +[%header,cols="1a,4a"] +|=== +|名称|类型/版本 + +|Jenkins Agent 标签 +|go + +|容器名称 +|go + +|操作系统 +|centos-7 + +|Go +|1.11 + +|GOPATH +|/home/jenkins/go + +|GOROOT +|/usr/local/go + +|Docker +|18.06.0 + +|Helm +|2.11.0 + +|Kubectl +|稳定版 + +|内置工具 +|unzip、which、make、wget、zip、bzip2、git +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/11-customize-jenkins-agent.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/11-customize-jenkins-agent.adoc new file mode 100644 index 000000000..6feb44f32 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/11-customize-jenkins-agent.adoc @@ -0,0 +1,85 @@ +--- +title: "自定义 Jenkins Agent" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线" +description: "介绍如何自定义 Jenkins Agent。" +weight: 11 +--- + + +若要使用运行特定环境(例如 JDK 11)的 Jenkins Agent,可以在{ks_product_both}上自定义 Jenkins Agent。 + +本文档描述如何在{ks_product_both}上自定义 Jenkins Agent。 + + +== 前提条件 + +{ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + + +== 自定义 Jenkins Agent + +. 以 **admin** 用户登录{ks_product_left} Web 控制台。 + +. 点击**集群管理**,进入一个集群。 + +. 在左侧导航栏选择**配置**下的**配置字典**。 + +. 在**配置字典**页面的搜索框中输入 **jenkins-casc-config** 并按**回车键**。 + +. 点击 **jenkins-casc-config** 进入其详情页面,点击**更多操作**,选择**编辑 YAML**。 + +. 在弹出的对话框中,搜寻至 **data:jenkins_user.yaml:jenkins:clouds:kubernetes:templates** 下方并输入以下代码,点击**确定**。 ++ +-- +[,yaml] +---- + +- name: "maven-jdk11" # 自定义 Jenkins Agent 的名称。 + label: "maven jdk11" # 自定义 Jenkins Agent 的标签。若要指定多个标签,请用空格来分隔标签。 + inheritFrom: "maven" # 自定义 Jenkins Agent 所继承的现有容器组模板的名称。 + containers: + - name: "maven" # 自定义 Jenkins Agent 所继承的现有容器组模板中指定的容器名称。 + image: "kubespheredev/builder-maven:v3.2.0jdk11" # 此镜像只用于测试。请使用您自己的镜像。 +---- + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +请确保遵守 YAML 文件中的缩进。 + +|=== +-- + +. 等待 1 ~ 2 分钟,会自动重新加载新的配置。 + +. 要使用自定义的 Jenkins Agent,请参考下方的示例 Jenkinsfile,在创建流水线时指定自定义 Jenkins Agent 对应的标签和容器名。 ++ +-- + +[,json] +---- + +pipeline { + agent { + node { + label 'maven && jdk11' + } + } + stages { + stage('Print Maven and JDK version') { + steps { + container('maven') { + sh ''' + mvn -v + java -version + ''' + } + } + } + } +} +---- +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/_index.adoc new file mode 100644 index 000000000..7307599ea --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/02-pipelines/_index.adoc @@ -0,0 +1,9 @@ +--- +title: "流水线" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps, 流水线" +description: "本节介绍如何使用流水线功能。" +weight: 02 +layout: "second" +--- + +本节介绍如何使用流水线功能。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/03-use-gitops-for-continous-deployment.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/03-use-gitops-for-continous-deployment.adoc new file mode 100644 index 000000000..3f5e16f5d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/03-use-gitops-for-continous-deployment.adoc @@ -0,0 +1,255 @@ +--- +title: "使用 GitOps 实现应用持续部署" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps" +description: "介绍如何创建持续部署以实现应用的部署。" +weight: 03 +--- + + +{ks_product_right}引入了一种为云原生应用实现持续部署的理念 – GitOps。GitOps 的核心思想是拥有一个 Git 仓库,并将应用系统的申明式基础架构和应用程序存放在 Git 仓库中进行版本控制。GitOps 结合 Kubernetes 能够利用自动交付流水线将更改应用到指定的任意多个集群中,从而解决跨云部署的一致性问题。 + +本文档演示如何创建持续部署以实现应用的部署。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已有一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../05-devops-settings/02-role-and-member-management[角色和成员管理]。 + + +== 导入代码仓库 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目。 + +. 在左侧导航栏,点击**代码仓库**。 + +. 在右侧的代码仓库页面,点击**添加**。 + +. 在**导入代码仓库**对话框,输入代码仓库名称,如 **open-podcasts**,点击选择代码仓库。您也可以为代码仓库设置别名和添加描述信息。 + + +. 在**选择代码仓库**对话框,点击 **Git**,在**代码仓库地址**区域,输入代码仓库地址,如 link:https://github.com/kubesphere-sigs/open-podcasts[],点击**确定**。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +此处导入的是公共仓库,因此不需要创建凭证。如果您添加的是私有仓库,则需要创建凭证。有关如何添加凭证的更多信息,请参阅link:../05-devops-settings/01-credential-management/[凭证管理]。 + +|=== +-- + + +== 创建持续部署 + +. 在左侧导航栏,点击**持续部署**。 + +. 在右侧的**持续部署**页面,点击**创建**。 + +. 在**基本信息**页签,输入持续部署名称,如 **open-podcasts**。在**部署位置**区域,选择持续部署的部署集群和项目。点击**下一步**。 + +. 在**代码仓库设置**页签,选择上一步创建的代码仓库,设置代码仓库的分支或标签以及 Kustomization 清单文件路径。点击**下一步**。 ++ +-- +[%header, cols="1a,3a"] +|=== +|参数 |描述 + +|修订版本 +|Git 仓库中的 commit ID、分支或标签。例如,**master**, **v1.2.0**, **0a1b2c3** 或 **HEAD**。 + +|清单文件路径 +|设置清单文件路径。例如,**config/default**。 +|=== +-- + +. 在**同步策略**区域,根据需要选择**自动同步**或**手动同步**。 ++ +-- + +* **自动同步**:在检测到 Git 仓库中的清单与部署资源的实时状态之间存在差异时,根据设置的同步选项,自动触发应用程序同步。具体参数如下表所示。 ++ +==== +[%header, cols="1a,3a"] +|=== +|参数 |描述 + +|清理资源 +|如果勾选,自动同步时会删除 Git 仓库中不存在的资源。不勾选时,自动同步触发时不会删除集群中的资源。 + +|自恢复 +|如果勾选,当检测到 Git 仓库中定义的状态与部署资源中有偏差时,将强制应用 Git 仓库中的定义。不勾选时,对部署资源做更改时不会触发自动同步。 +|=== +==== + +* **手动同步**:根据设置的同步选项,手动触发应用程序同步。 + +// 具体参数如下表所示。 +// + +// ==== +// [%header, cols="1a,3a"] +// |=== +// |参数 |描述 + +// |清理资源 +// |如果勾选,同步会删除 Git 仓库中不存在的资源。不勾选时,同步不会删除集群中的资源,而是会显示 **out-of-sync**。 + +// |模拟运行 +// |模拟同步,不影响最终部署资源。 + +// |仅执行 Apply +// |如果勾选,同步应用资源时会跳过 **pre/post** 钩子,仅执行 **kubectl apply**。 + +// |强制 Apply +// |如果勾选,同步时会执行 **kubectl apply --force**。 +// |=== +// ==== + +-- + +. 在**同步设置**区域,根据需要设置同步相关参数。 ++ +-- +[%header, cols="1a,3a"] +|=== +|参数 |描述 + +|跳过规范校验 +|跳过 **kubectl** 验证。执行 **kubectl apply** 时,增加 **--validate=false** 标识。 + +|自动创建项目 +|在项目不存在的情况下自动为应用程序资源创建项目。 + +|最后清理 +|同步操作时,其他资源都完成部署且处于健康状态后,再清理资源。 + +|选择性同步 +|仅同步 **out-of-sync** 状态的资源。 +|=== +-- + + +. 在**依赖清理策略**区域,根据需要选择依赖清理策略。 ++ +-- +[%header, cols="1a,3a"] +|=== +|参数 |描述 + +|foreground +|先删除依赖资源,再删除主资源。 + +|background +|先删除主资源,再删除依赖资源。 + +|orphan +|删除主资源,留下依赖资源成为孤儿。 +|=== +-- + +. 在**替换资源**区域,选择是否需要替换已存在的资源。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| + +如果勾选,将执行 **kubectl replace/create** 命令同步资源。不勾选时,使用 **kubectl apply** 命令同步资源。 +|=== +-- + +. 点击**创建**。资源创建完成后将显示在持续部署列表中。 + + +== 查看已创建的持续部署信息 + +. 在**持续部署**页面上查看到已创建的持续部署信息。具体参数如下表所示。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|持续部署的名称。 + +|健康状态 +|持续部署的健康状态。主要包含以下几种状态: + +* **健康**:资源健康。 +* **已降级**:资源已经被降级。 +* **进行中**:资源正在同步。默认返回该状态。 +* **暂停**:资源已经被暂停并等待恢复。 +* **未知**:资源健康状态未知。 +* **丢失**:资源已缺失。 + +|同步状态 +|持续部署的同步状态。主要包含以下几种状态: + +* **已同步**:资源同步已完成。 +* **未同步**:资源的实际运行状态和期望状态不一致。 +* **未知**:资源同步状态未知。 + +|部署位置 +|资源部署的集群和项目。 + +|更新时间 +|资源更新的时间。 +|=== +-- + +. 点击持续部署右侧的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],您可以执行以下操作: ++ +-- +* **编辑信息**:编辑别名和描述信息。 + +* **编辑 YAML**:编辑持续部署的 YAML 文件。 + +* **同步**:触发资源同步。 + +* **删除**:删除持续部署。 + +//warning +[.admon.warning,cols="a"] +|=== +|警告 + +| + +删除持续部署的同时会删掉和该持续部署关联的资源。请谨慎操作。 +|=== + +-- + +. 点击已创建的持续部署进入详情页面,查看同步状态和同步结果。 + + +== 访问已创建的应用 + +. 进入持续部署所属的项目,在左侧导航栏,点击**应用负载** > **服务**。 + +. 在右侧的**服务**区域,找到已部署的应用,并点击右侧image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],选择**编辑外部访问**。 + +. 在**访问模式**中选择 **NodePort**,点击**确定**。 + +. 在服务列表页面的**外部访问**列,查看暴露的端口,通过 {Node IP}:{NodePort} 访问此应用。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +在访问服务之前,请确保安全组中的端口已打开。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/04-import-code-repositories.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/04-import-code-repositories.adoc new file mode 100644 index 000000000..739e44546 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/04-import-code-repositories.adoc @@ -0,0 +1,100 @@ +--- +title: "导入代码仓库" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps" +description: "介绍如何导入代码仓库。" +weight: 04 +--- + + +{ks_product_right}支持导入 GitHub、GitLab、Bitbucket 或其它基于 Git 的代码仓库,如 Gitee。下面以 Github 仓库为例,展示如何导入代码仓库。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已有一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../05-devops-settings/02-role-and-member-management[角色和成员管理]。 + + +== 操作步骤 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目。 + +. 在左侧导航栏,点击**代码仓库**。 + +. 在右侧的代码仓库页面,点击**添加**。 + +. 在**导入代码仓库**对话框,输入代码仓库名称,点击选择代码仓库。您也可以为代码仓库设置别名和添加描述信息。 ++ +-- +下表列举了支持导入的代码仓库和参数设置项。以下步骤以 GitHub 为例。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|GitHub +|**凭证**:选择访问代码仓库的凭证。 + +|GitLab +| +* **GitLab 服务器地址**:选择 GitLab 服务器地址,默认值为 link:https://gitlab.com[]。 +* **项目组/所有者**:输入 GitLab 账号。 +* **凭证**:选择访问代码仓库的凭证。 +* **代码仓库**:选择代码仓库。 + +|Bitbucket +| +* **Bitbucket 服务器地址**:设置 Bitbucket 服务器地址。 +* **凭证**:选择访问代码仓库的凭证。 + +|Git +| +* **代码仓库地址**:输入代码仓库地址,如 link:https://gitee.com[]。 +* **凭证**:选择访问代码仓库的凭证。 +|=== + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +如需使用 GitLab 私有仓库,请参阅link:../02-pipelines/04-gitlab-multibranch-pipeline/[使用 GitLab 创建多分支流水线]。 + +|=== +-- + +. 在**凭证**区域,点击**创建凭证**。在弹出的**创建凭证**对话框,设置以下参数,点击**确定**。 ++ +-- +* **名称**:输入凭证名称,如 **github-id**。 +* **类型**:取值包括**用户名和密码**、**SSH 密钥**和**访问令牌**。在 DevOps 项目中,建议使用**用户名和密码**。 +// * **类型**:取值包括**用户名和密码**、**SSH 密钥**、**访问令牌**和 **kubeconfig**。在 DevOps 项目中,建议使用**用户名和密码**。 +* **用户名**:此处默认用户名为 **admin**。 +* **密码/令牌**:输入您的 GitHub 令牌。 +* **描述**:添加描述信息。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| + +更多关于如何添加凭证的信息,请参阅link:../05-devops-settings/01-credential-management/[凭证管理]。 +|=== +-- + +. 在**凭证**下拉列表中,选择创建的凭证,点击**确定**。 +. 在弹出的 GitHub 仓库中,选择代码仓库,点击**确定**。 + +. 点击代码仓库右侧的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],可以执行以下操作: ++ +-- +* **编辑**:修改代码仓库别名和描述信息,以及重新选择代码仓库。 +* **编辑 YAML**:编辑代码仓库 YAML 文件。 +* **删除**:删除代码仓库。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/01-credential-management.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/01-credential-management.adoc new file mode 100644 index 000000000..1ade3070e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/01-credential-management.adoc @@ -0,0 +1,184 @@ +--- +title: "凭证管理" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps" +description: "介绍如何管理 DevOps 凭证。" +weight: 01 +--- + + +凭证是包含敏感信息的对象,例如用户名和密码、SSH 密钥和令牌 (Token)。当{ks_product_left} DevOps 流水线运行时,会与外部环境中的对象进行交互,以执行一系列任务,包括拉取代码、推送和拉取镜像以及运行脚本等。此过程中需要提供相应的凭证,而这些凭证不会明文出现在流水线中。 + +具有必要权限的 DevOps 项目用户可以为 Jenkins 流水线配置凭证。用户在 DevOps 项目中添加或配置这些凭证后,便可以在 DevOps 项目中使用这些凭证与第三方应用程序进行交互。 + +目前,您可以在 DevOps 项目中创建以下类型的凭证: + +* **用户名和密码**:用户名和密码,可以作为单独的组件处理,或者作为用冒号分隔的字符串(格式为 **username:password**)处理,例如 GitHub 和 GitLab 账户。 + +* **SSH 密钥**:带有私钥的用户名,SSH 公钥/私钥对。 + +* **访问令牌**:具有访问权限的令牌。 + +* **kubeconfig**:用于配置跨集群认证。 + +本文档演示如何在 DevOps 项目中创建和管理凭证。有关如何使用凭证的更多信息,请参阅link:../../02-pipelines/02-create-a-pipeline-using-jenkinsfile/[使用 Jenkinsfile 创建流水线]和link:../../02-pipelines/01-create-a-pipeline-using-graphical-editing-panel/[使用图形编辑面板创建流水线]。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已有一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../02-role-and-member-management[角色和成员管理]。 + + +== 创建凭证 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目。 + +. 在左侧导航栏,选择 **DevOps 项目设置 > 凭证**。 + +. 在右侧的**凭证**区域,点击**创建**。 + +. 在弹出的**创建凭证**对话框,输入凭证名称,并选择凭证类型。不同的凭证类型需要设置的参数不同,具体请参考以下内容。 ++ +==== +* 创建用户名和密码凭证 ++ +-- +以创建 GitHub 用户凭证为例,您需要设置以下参数: + +[%header,cols="1a,2a"] +|=== +|参数|描述 + +|名称 +|设置凭证名称,如 **github-id**。 + + +|类型 +|选择**用户名和密码**。 + + +|用户名 +|输入您的 GitHub 用户名。 + +|密码/令牌 +|输入您的 GitHub 令牌。 + +|描述 +|凭证的简介。 +|=== + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +* 自 2021 年 8 月起,GitHub 要求使用基于令牌的身份验证,此处需要输入令牌,而非 GitHub 密码。有关如何生成令牌,请参阅link:https://docs.github.com/cn/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token[创建个人访问令牌]。 + +* 如果您的账户或密码中包含任何特殊字符,例如 **@** 和 **$**,可能会因为无法识别而在流水线运行时导致错误。在这种情况下,您需要先在一些第三方网站(例如 link:https://www.urlencoder.org/[urlencoder])上对账户或密码进行编码,然后将输出结果复制粘贴作为您的凭证信息。 + +|=== +-- + +* 创建 SSH 密钥凭证 ++ +-- + +[%header,cols="1a,2a"] +|=== +|参数|描述 + +|名称 +|设置凭证名称。 + + +|类型 +|选择**SSH 密钥**。 + + +|用户名 +|输入您的用户名。 + +|私钥 +|输入您的 SSH 密钥。 + +|密码短语 +|输入密码短语。为了更好保护您的账户安全,建议设置该参数。 + +|描述 +|凭证的简介。 +|=== +-- + +* 创建访问令牌凭证 ++ +-- + +[%header,cols="1a,2a"] +|=== +|参数|描述 + +|名称 +|设置凭证名称。 + +|类型 +|选择**访问令牌**。 + +|令牌 +|输入您的令牌。 + +|描述 +|凭证的简介。 +|=== +-- + +* 创建 kubeconfig 凭证 ++ +-- +[%header,cols="1a,2a"] +|=== +|参数|描述 + +|名称 +|设置凭证名称,例如 **demo-kubeconfig**。 + +|类型 +|选择 **kubeconfig**。 + +|内容 +|系统自动获取当前 Kubernetes 集群的 kubeconfig 文件内容,并自动填充该字段,您无须做任何更改。但是访问其他集群时,您可能需要更改 kubeconfig。 + +|描述 +|凭证的简介。 +|=== + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +用于配置集群访问的文件称为 kubeconfig 文件。这是引用配置文件的通用方法。有关更多信息,请参阅 link:https://kubernetes.io/zh/docs/concepts/configuration/organize-cluster-access-kubeconfig/[Kubernetes 官方文档]。 +|=== +-- +==== + + +== 查看和管理凭证 + +. 点击已创建的凭证,进入其详情页面,查看凭证详情和与此凭证相关的所有事件。 + +. 点击**编辑**修改凭证信息,点击**删除**删除凭证。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +编辑凭证时,{ks_product_right}不会显示现有用户名或密码信息。如果输入新的用户名和密码,则前一个将被覆盖。 +|=== + diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/02-role-and-member-management.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/02-role-and-member-management.adoc new file mode 100644 index 000000000..428f1e6e3 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/02-role-and-member-management.adoc @@ -0,0 +1,118 @@ +--- +title: "角色和成员管理" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps" +description: "介绍如何在 DevOps 项目中管理角色和成员。" +weight: 02 +--- + + +本文档演示如何在 DevOps 项目中管理角色和成员。 + +在 DevOps 项目范围内,您可以向角色授予以下资源的权限: + +* DevOps 项目设置 +* 流水线 +* 凭证 +* 持续部署 +* 代码仓库 +* 访问控制 + + +== 前提条件 + +* 已创建一个 DevOps 项目,例如 **demo-devops**。 + +* 已有一个在 DevOps 项目级别具有 **admin** 角色的用户(例如 **devops-admin**)。 + + +== 内置角色 + +在 **DevOps 项目角色**中,有三个可用的内置角色,如下所示。创建 DevOps 项目时,会自动创建内置角色,并且无法编辑或删除这些角色。 + +[%header,cols="1a,4a"] +|=== +|内置角色|描述信息 + +|viewer +|DevOps 项目观察者,查看 DevOps 项目中的所有资源。 + +|operator +|DevOps 项目普通成员,管理 DevOps 凭证和流水线以及查看 DevOps 项目中的成员和角色。 + +|admin +|DevOps 项目管理员,管理 DevOps 项目中的所有资源。 +|=== + + +== 创建 DevOps 项目角色 + +. 以 **devops-admin** 用户登录 {ks_product_both} Web 控制台。 + +. 前往 **DevOps 项目**页面点击一个 DevOps 项目(例如 **demo-devops**)。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +本文档使用 **devops-admin** 账户作为示例。只要账户被授予的角色包含 DevOps 项目级别**访问控制**中的**成员查看**、**角色管理**和**角色查看**的权限,此账户便可以创建 DevOps 项目角色。 + +|=== +-- + +. 选择 **DevOps 项目设置**中的 **DevOps 项目角色**,点击**创建**。 + +. 设置**名称**。在本示例中,将创建一个名为 **pipeline-creator** 的角色。点击**编辑权限**继续。 + +. 在**流水线**页签,选择您希望授予该角色的权限。例如,为此角色选择**流水线管理**和**流水线查看**。点击**确定**完成操作。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +**依赖于**表示当前授权项依赖所列出的授权项,勾选该权限后系统会自动选上所有依赖权限。 +|=== +-- + +. 新创建的角色将显示在 **DevOps 项目角色**列表中。点击右侧的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18]对其进行编辑。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +**pipeline-creator** 角色仅被授予**流水线管理**和**流水线查看**权限,可能无法满足您的实际需求。本示例仅用于演示,请根据实际需要创建自定义角色。 + +|=== +-- + + +== 邀请 DevOps 项目成员 + +. 在 **DevOps 项目设置**中选择 **DevOps 项目成员**,然后点击**邀请**。 + +. 点击image:/images/ks-qkcp/zh/icons/add-dark.svg[add,18,18]邀请账户加入此 DevOps 项目,并向此账户授予 **pipeline-creator** 角色。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +必须先邀请用户加入 DevOps 项目所在的企业空间。 + +|=== +-- + +. 点击**确定**将用户添加到此 DevOps 项目。在 **DevOps 项目成员**页面,将显示新邀请的成员。 + +. 点击项目成员右侧的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],修改现有成员的角色或从 DevOps 项目中删除该用户。 + diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/03-add-cd-allowlist.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/03-add-cd-allowlist.adoc new file mode 100644 index 000000000..a79b596e9 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/03-add-cd-allowlist.adoc @@ -0,0 +1,31 @@ +--- +title: "添加持续部署白名单" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps" +description: "介绍如何添加持续部署白名单。" +weight: 03 +--- + + +{ks_product_right}支持通过设置白名单,限制资源持续部署的代码仓库和目标位置。 + +本文档介绍如何添加持续部署白名单。 + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已有一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。请参阅link:../02-role-and-member-management[角色和成员管理]。 + +* 已link:../../04-import-code-repositories/[导入代码仓库]。 + +== 操作步骤 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 + +. 点击**企业空间管理**并进入您的 DevOps 项目。 + +. 在左侧导航栏,选择 **DevOps 项目设置 > 基本信息**。 + +. 在右侧**基本信息**下的**持续部署白名单**区域,点击**编辑白名单**。 + +. 在弹出的**编辑白名单**对话框,选择代码仓库、部署集群和项目,点击**确定**。点击**添加**可添加多个代码仓库和部署位置。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/04-set-ci-node.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/04-set-ci-node.adoc new file mode 100644 index 000000000..630709270 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/04-set-ci-node.adoc @@ -0,0 +1,41 @@ +--- +title: "为依赖项缓存设置 CI 节点" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps" +description: "介绍如何为依赖项缓存设置 CI 节点。" +weight: 04 +--- + + +构建应用程序通常需要拉取不同的依赖项。拉取过程中可能会遇到某些问题,例如拉取时间长、网络不稳定,进而导致构建失败。为了提供更可靠和稳定的环境,可以配置节点或节点组,专门用于持续集成 (CI),并通过使用缓存来加快构建过程。 + +本文档演示如何设置 CI 节点,以便{ks_product_both}将流水线的任务调度到这些节点。 +// 本文档演示如何设置 CI 节点,以便{ks_product_both}将流水线的任务以及 S2I/B2I 构建的任务调度到这些节点。 + +== 前提条件 + +您需要在{ks_product_both}平台具有**集群管理**权限。 + +== 标记 CI 节点 + +. 以具有**集群管理**权限的账户登录{ks_product_left} Web 控制台。 + +. 点击**集群管理**,进入一个集群。 + +. 在左侧导航栏中选择**节点**下的**集群节点**,查看当前集群中的现有节点。 + +. 从列表中选择一个节点用来运行 CI 任务。点击节点名称转到其详情页面,点击**更多操作** > **编辑标签**。 + +. 在弹出的对话框中,在键为 **node-role.kubernetes.io/worker** 的后面,输入 **ci** 作为此标签的值,点击**确定**。 + + +== 给 CI 节点添加污点 + +流水线一般会根据link:https://kubernetes.io/zh/docs/concepts/scheduling-eviction/assign-pod-node/#node-affinity[节点亲和性]来确定是否调度任务到某一节点。如果要将节点专用于 CI 任务,即不允许将其他工作负载调度到该节点,可以在该节点上添加link:https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/[污点]。 + +// 流水线和 S2I/B2I 工作流一般会根据link:https://kubernetes.io/zh/docs/concepts/scheduling-eviction/assign-pod-node/#node-affinity[节点亲和性]来确定是否调度任务到某一节点。如果要将节点专用于 CI 任务,即不允许将其他工作负载调度到该节点,可以在该节点上添加link:https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/[污点]。 + +. 点击**更多操作** > **编辑污点**。 + +. 点击**添加**,输入键 **node.kubernetes.io/ci** 而不指定值。根据需要选择**阻止调度**、**尽可能阻止调度**或**阻止调度并驱逐现有容器组** 。 + +. 点击**确定**。{ks_product_right}将根据您设置的污点调度任务。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/_index.adoc new file mode 100644 index 000000000..d36d50033 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/05-devops-settings/_index.adoc @@ -0,0 +1,10 @@ +--- +title: "DevOps 项目设置" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps" +description: "介绍如何管理 DevOps 项目的设置。" +weight: 05 +layout: "second" +--- + + +本节介绍如何管理 DevOps 项目的设置。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/_index.adoc new file mode 100644 index 000000000..c7b0fa457 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/03-how-to-use/_index.adoc @@ -0,0 +1,10 @@ +--- +title: "使用 DevOps" +keywords: "Kubernetes, {ks_product}, DevOps 项目, 使用 DevOps" +description: "介绍如何使用 DevOps 功能。" +weight: 03 +layout: "second" +--- + + +本节介绍如何使用 DevOps 功能。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/01-sonarqube.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/01-sonarqube.adoc new file mode 100644 index 000000000..9346a02be --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/01-sonarqube.adoc @@ -0,0 +1,372 @@ +--- +title: "将 SonarQube 集成到流水线" +keywords: "Kubernetes, {ks_product}, DevOps 项目" +description: "介绍如何将 SonarQube 集成到流水线。" +weight: 01 +--- + + +link:https://www.sonarqube.org/[SonarQube] 是一种主流的代码质量持续检测工具,可用于代码库的静态和动态分析。SonarQube 集成到{ks_product_both}流水线后,如果在运行的流水线中检测到问题,将会在仪表板上直接显示常见代码问题。 + +本文档演示如何将 SonarQube 集成到流水线中。在link:../../03-how-to-use/02-pipelines/02-create-a-pipeline-using-jenkinsfile/[使用 Jenkinsfile 创建流水线]之前,请先阅读本节内容。 + + +== 前提条件 + +{ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + + +== 安装 SonarQube 服务器 + +要将 SonarQube 集成到您的流水线,必须先安装 SonarQube 服务器。 + +. 安装 Helm,以便使用该工具安装 SonarQube。例如,运行以下命令安装 Helm 3: ++ +-- +// Bash +[,bash] +---- +curl https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3|bash +---- + +查看 Helm 版本。 + +// Bash +[,bash] +---- +helm version + +version.BuildInfo{Version:"v3.4.1", GitCommit:"c4e74854886b2efe3321e185578e6db9be0a6e29", GitTreeState:"clean", GoVersion:"go1.14.11"} +---- + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +有关更多信息,请参阅 link:https://helm.sh/zh/docs/intro/install/[Helm 文档]。 +|=== +-- + +. 执行以下命令安装 SonarQube 服务器。 ++ +-- +// Bash +[,bash] +---- + +helm upgrade --install sonarqube sonarqube --repo https://charts.kubesphere.io/main -n \ +kubesphere-devops-system --create-namespace --set service.type=NodePort + +---- + +// Note +[.admon.note,cols="a"] +|=== +|说明 + +| + +请确保使用 Helm 3 安装 SonarQube 服务器。 +|=== +-- + + +== 获取 SonarQube 控制台地址 + +. 执行以下命令获取 SonarQube NodePort。 ++ +-- +// Bash +[,bash] +---- +export NODE_PORT=$(kubectl get --namespace kubesphere-devops-system -o jsonpath="{.spec.ports[0].nodePort}" services sonarqube-sonarqube) + +export NODE_IP=$(kubectl get nodes --namespace kubesphere-devops-system -o jsonpath="{.items[0].status.addresses[0].address}") + +echo http://$NODE_IP:$NODE_PORT +---- +-- + +. 预期输出结果:(您的 NodeIP 和 NodePort 应该不同) ++ +-- +// Bash +[,bash] +---- +http://10.77.1.201:31377 +---- +-- + + +== 配置 SonarQube 服务器 + +=== 步骤 1:访问 SonarQube 控制台 + +. 执行以下命令查看 SonarQube 的状态。注意,只有在 SonarQube 启动并运行后才能访问 SonarQube 控制台。 ++ +-- +// Bash +[,bash] +---- +kubectl get pod -n kubesphere-devops-system +---- +-- + +. 在浏览器中访问 SonarQube 控制台 link:http://NodeIP:NodePort[]。 + +. 点击右上角的 **Log in**,然后使用默认账户 **admin/admin** 登录。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| + +取决于实例的部署位置,您可能需要设置必要的端口转发规则,并在您的安全组中放行该端口,以便访问 SonarQube。 +|=== +-- + +=== 步骤 2:创建 SonarQube 管理员令牌 (Token) + +. 点击右上角字母 **A**,然后从菜单中选择 **My Account** 以转到 **Profile** 页面。 + +. 点击 **Security** 并输入令牌名称,例如 **kubesphere**。 + +. 点击 **Generate** 并复制此令牌。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +如提示所示,您无法再次查看此令牌,因此请确保复制成功。 +|=== +-- + +=== 步骤 3:创建 Webhook 服务器 + +. 执行以下命令获取 SonarQube Webhook 的地址。 ++ +-- +// Bash +[,bash] +---- + +export NODE_PORT=$(kubectl get --namespace kubesphere-devops-system -o jsonpath="{.spec.ports[0].nodePort}" services devops-jenkins) + +export NODE_IP=$(kubectl get nodes --namespace kubesphere-devops-system -o jsonpath="{.items[0].status.addresses[0].address}") + +echo http://$NODE_IP:$NODE_PORT/sonarqube-webhook/ + +---- +-- + +. 预期输出结果: ++ +-- +// Bash +[,bash] +---- + +http://10.77.1.201:30180/sonarqube-webhook/ + +---- +-- + +. 依次点击 **Administration**、**Configuration** 和 **Webhooks** 创建一个 Webhook。 + +. 点击 **Create**。 + +. 在弹出的对话框中输入 **Name** 和 **Jenkins Console URL**(即 SonarQube Webhook 地址)。点击 **Create** 完成操作。 + +=== 步骤 4:将 SonarQube 配置添加到 ks-installer + +. 执行以下命令编辑 **ks-installer**。 ++ +-- +// Bash +[,bash] +---- + +kubectl edit cc -n kubesphere-system ks-installer + +---- +-- + +. 搜寻至 **devops**。添加字段 **sonarqube** 并在其下方指定 **externalSonarUrl** 和 **externalSonarToken**。 ++ +-- +[,yaml] +---- +devops: + enabled: true + jenkinsJavaOpts_MaxRAM: 2g + jenkinsJavaOpts_Xms: 512m + jenkinsJavaOpts_Xmx: 512m + jenkinsMemoryLim: 2Gi + jenkinsMemoryReq: 1500Mi + jenkinsVolumeSize: 8Gi + sonarqube: # Add this field manually. + externalSonarUrl: http://10.77.1.201:31377 # The SonarQube IP address. + externalSonarToken: 00ee4c512fc987d3ec3251fdd7493193cdd3b91d # The SonarQube admin token created above. + +---- +-- + +. 完成操作后保存此文件。 + +=== 步骤 5:将 SonarQube 服务器添加至 Jenkins + +. 执行以下命令获取 Jenkins 的地址。 ++ +-- +// Bash +[,bash] +---- + +export NODE_PORT=$(kubectl get --namespace kubesphere-devops-system -o jsonpath="{.spec.ports[0].nodePort}" services devops-jenkins) + +export NODE_IP=$(kubectl get nodes --namespace kubesphere-devops-system -o jsonpath="{.items[0].status.addresses[0].address}") + +echo http://$NODE_IP:$NODE_PORT + +---- +-- + +. 获取 Jenkins 的端口号。 ++ +-- +// Bash +[,bash] +---- + +http://10.77.1.201:30180 + +---- +-- + +. 使用地址 link:http://NodeIP:30180[] 访问 Jenkins。 ++ +-- +安装 DevOps 时,默认情况下也会安装 Jenkins 仪表板。此外,Jenkins 还配置有{ks_product_left} LDAP,这意味着您可以直接使用{ks_product_both}账户登录 Jenkins。有关配置 Jenkins 的更多信息,请参阅 link:../../03-how-to-use/02-pipelines/07-jenkins-setting/[Jenkins 系统设置]。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +取决于实例的部署位置,您可能需要设置必要的端口转发规则,并在您的安全组中放行端口 **30180**,以便访问 Jenkins。 + +|=== +-- + +. 点击左侧导航栏中的**系统管理**。 + +. 向下滚动并点击**系统配置**。 + +. 搜寻到 **SonarQube servers**,然后点击 **Add SonarQube**。 + +. 输入 **Name** 和 **Server URL** (link:http://NodeIP:NodePort[])。 点击**添加**,选择 **Jenkins**,然后在弹出的对话框中用 SonarQube 管理员令牌创建凭证(如下方第二张截图所示)。创建凭证后,从 **Server authentication token** 旁边的下拉列表中选择该凭证。点击**应用**完成操作。 ++ +-- +image:/images/ks-qkcp/zh/devops-user-guide/tool-integration/integrate-sonarqube-into-pipelines/sonarqube-jenkins-settings.png[,100%] + +image:/images/ks-qkcp/zh/devops-user-guide/tool-integration/integrate-sonarqube-into-pipelines/add-credentials.png[,100%] + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +如果点击**添加**按钮无效,前往**系统管理**下的 **Manage Credentials** 并点击 **Stores scoped to Jenkins** 下的 **Jenkins**,再点击**全局凭据 (unrestricted)**,然后点击左侧导航栏的**添加凭据**,参考上方第二张截图用 SonarQube 管理员令牌添加凭证。添加凭证后,从 **Server authentication token** 旁边的下拉列表中选择该凭证。 + +|=== +-- + +=== 步骤 6:将 sonarqubeURL 添加到{ks_product_both}控制台 + +您需要指定 **sonarqubeURL**,以便可以直接从{ks_product_both} Web 控制台访问 SonarQube。 + +. 执行以下命令: ++ +-- +// Bash +[,bash] +---- + +kubectl editcm -n kubesphere-system ks-console-config + +---- +-- + +. 搜寻到 **data:client:enableKubeConfig**,在下方添加 **devops** 字段并指定 **sonarqubeURL**。 ++ +-- +[,yaml] +---- +client: + enableKubeConfig: true + devops: # 手动添加该字段。 + sonarqubeURL: http://10.77.1.201:31377 # SonarQube IP 地址。 + +---- +-- + +. 保存该文件。 + +=== 步骤 7:重启服务 + +执行以下命令重启服务。 + +// Bash +[,bash] +---- + +kubectl -n kubesphere-devops-system rollout restart deploy devops-apiserver + +---- + +// Bash +[,bash] +---- + +kubectl -n kubesphere-system rollout restart deploy ks-console + +---- + + +== 为新项目创建 SonarQube Token + +创建一个 SonarQube 令牌,以便流水线在运行时可以与 SonarQube 通信。 + +. 在 SonarQube 控制台上,点击 **Create new project**。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/tool-integration/integrate-sonarqube-into-pipelines/sonarqube-create-project.png[,100%] + +. 输入项目密钥,例如 **java-demo**,然后点击 **Set Up**。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/tool-integration/integrate-sonarqube-into-pipelines/jenkins-projet-key.png[,100%] + +. 输入项目名称,例如 **java-sample**,然后点击 **Generate**。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/tool-integration/integrate-sonarqube-into-pipelines/generate-a-token.png[,100%] + +. 创建令牌后,点击 **Continue**。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/tool-integration/integrate-sonarqube-into-pipelines/token-created.png[,100%] + +. 分别选择 **Java** 和 **Maven**,复制下图所示绿色框中的序列号。如果要在流水线中使用,则需要在link:../../03-how-to-use/05-devops-settings/01-credential-management/[凭证]中添加此序列号。 ++ +image:/images/ks-qkcp/zh/devops-user-guide/tool-integration/integrate-sonarqube-into-pipelines/sonarqube-example.png[,100%] + +== 在{ks_product_both}控制台查看结果 + +link:../../03-how-to-use/02-pipelines/02-create-a-pipeline-using-jenkinsfile/[使用 Jenkinsfile 创建流水线]或link:../../03-how-to-use/02-pipelines/01-create-a-pipeline-using-graphical-editing-panel/[使用图形编辑面板创建流水线]之后,即可查看代码质量分析的结果。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/02-harbor.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/02-harbor.adoc new file mode 100644 index 000000000..edfc1d33e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/02-harbor.adoc @@ -0,0 +1,171 @@ +--- +title: "将 Harbor 集成到流水线" +keywords: "Kubernetes, {ks_product}, DevOps 项目" +description: "介绍如何将 Harbor 集成到流水线。" +weight: 02 +--- + +本文档演示如何将 Harbor 集成到{ks_product_both}流水线。 + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **DevOps** 扩展组件。 + +* 已有一个企业空间、一个 DevOps 项目和一个用户 (例如 **project-regular**),并已邀请该用户至 DevOps 项目且授予 **operator** 角色。 + +== 安装 Harbor + +执行以下命令,使用 Helm 3 安装 Harbor。 + +// Bash +[,bash] +---- + +helm repo add harbor https://helm.goharbor.io +# 如需快速安装,您可以通过 NodePort 暴露 Harbor 并禁用 tls。 +# 请将 externalURL 设置为您的一个节点 IP,并确保 Jenkins 能够访问它。 +helm install harbor-release harbor/harbor --set expose.type=nodePort,externalURL=http://$ip:30002,expose.tls.enabled=false + +---- + +== 获取 Harbor 凭证 + +. 安装 Harbor 后,访问 **:30002** 并使用默认账户和密码 (**admin/Harbor12345**) 登录 Web 控制台。 + +. 在左侧导航栏中点击**项目**,然后点击**新建项目**。 + +. 在弹出的对话框中,设置项目名称 **ks-devops-harbor** 并点击**确定**。 + +. 点击刚刚创建的项目,在**机器人账户**页签下点击**添加机器人账户**。 + +. 在弹出的对话框中,为机器人账户设置名称 **robot-test** 并点击**添加**。请确保在**权限**中勾选推送制品的权限选框。 + +. 在弹出的对话框中,点击**导出到文件中**,保存该令牌。 + +== 启用 Insecure Registry + +配置 Docker,使其忽略您 Harbor 仓库的安全性。 + +. 在您的主机上运行 **vim /etc/docker/daemon.json** 命令以编辑 **daemon.json** 文件,输入以下内容并保存更改。 ++ +-- +[,json] +---- +{ + "insecure-registries" : ["103.61.38.55:30002"] +} +---- + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +请将 **103.61.38.55:30002** 替换为您自己的 Harbor 仓库地址。对于 Linux,**daemon.json** 文件的路径为 **/etc/docker/daemon.json**;对于 Windows,该文件的路径为 **C:\ProgramData\docker\config\daemon.json**。 +|=== +-- + +. 运行以下命令重启 Docker,使更改生效。 ++ +-- +[,bash] +---- +sudo systemctl daemon-reload + +sudo systemctl restart docker +---- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +建议您在隔离的测试环境或者严格控制的离线环境中使用该方案。有关更多信息,请参阅 link:https://docs.docker.com/registry/insecure/#deploy-a-plain-http-registry[Deploy a plain HTTP registry]。完成上述操作后,即可在项目中部署工作负载时使用您 Harbor 仓库中的镜像。您需要为自己的 Harbor 仓库创建一个镜像密钥,然后在**容器镜像**页签下的**容器设置**中,选择您的 Harbor 仓库并输入镜像的绝对路径以搜索您的镜像。 + +|=== +-- + +== 创建凭证 + +. 以 **project-regular** 用户登录{ks_product_both} Web 控制台。 +. 点击**企业空间管理**并进入您的 DevOps 项目。 +. 在 **DevOps 项目设置**下的**凭证**页面为 Harbor 创建凭证。 +. 在**创建凭证**页面,设置凭证 ID (**robot-test**),**类型**选择**用户名和密码**,**用户名**字段必须和您刚刚下载的 JSON 文件中 **name** 的值相同,并在**密码/令牌**中输入 Harbor 令牌文件中 **token** 的值。 + +. 点击**确定**以保存。 + +== 创建流水线 + +. 转到**流水线**页面,点击**创建**。 + +. 在**基本信息**页签,输入名称 **demo-pipeline**,然后点击**下一步**。 + +. **高级设置**中使用默认值,点击**创建**。 + +== 编辑 Jenkinsfile + +. 点击该流水线进入其详情页面,然后点击**编辑 Jenkinsfile**。 + +. 将以下内容复制粘贴至 Jenkinsfile。注意,必须将 **REGISTRY**、**HARBOR_NAMESPACE**、**APP_NAME** 和 **HARBOR_CREDENTIAL** 替换为您自己的值。 ++ +-- +[,json] +---- + +pipeline { + agent { + node { + label 'maven' + } + } + + environment { + // 您 Harbor 仓库的地址。 + REGISTRY = '103.61.38.55:30002' + // 项目名称。 + // 请确保您的机器人账户具有足够的项目访问权限。 + HARBOR_NAMESPACE = 'ks-devops-harbor' + // Docker 镜像名称。 + APP_NAME = 'docker-example' + // ‘robot-test’是您在{ks_product_both} Web 控制台上创建的凭证 ID。 + HARBOR_CREDENTIAL = credentials('robot-test') + } + + stages { + stage('docker login') { + steps{ + container ('maven') { + // 请替换 -u 后面的 Docker Hub 用户名,不要忘记加上 ''。您也可以使用 Docker Hub 令牌。 + sh '''echo $HARBOR_CREDENTIAL_PSW|docker login $REGISTRY -u 'robot$robot-test' --password-stdin''' + } + } + } + + stage('build & push') { + steps { + container ('maven') { + sh 'git clone https://github.com/kstaken/dockerfile-examples.git' + sh 'cd dockerfile-examples/rethinkdb && docker build -t $REGISTRY/$HARBOR_NAMESPACE/$APP_NAME:devops-test .' + sh 'docker push$REGISTRY/$HARBOR_NAMESPACE/$APP_NAME:devops-test' + } + } + } + } +} + +---- + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +您可以通过带有环境变量的 Jenkins 凭证来传送参数至 **docker login -u**。但是,每个 Harbor 机器人账户的用户名都包含一个 **$** 字符,当用于环境变量时,Jenkins 会将其转换为 **$$**。(Harbor v2.2以后可以自定义机器人后缀,避免此类问题)link:https://number1.co.za/rancher-cannot-use-harbor-robot-account-imagepullbackoff-pull-access-denied/[了解更多]。 +|=== +-- + +== 运行流水线 + +保存 Jenkinsfile 后,{ks_product_right}会自动在图形编辑面板上创建所有阶段和步骤。点击**运行**来运行该流水线。如果一切运行正常,Jenkins 将推送镜像至您的 Harbor 仓库。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/_index.adoc new file mode 100644 index 000000000..1a4267e4e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/04-how-to-integrate/_index.adoc @@ -0,0 +1,10 @@ +--- +title: "工具集成" +keywords: "Kubernetes, {ks_product}, DevOps 项目" +description: "介绍如何将第三方工具与流水线集成。" +weight: 04 +layout: "second" +--- + + +本节介绍如何将第三方工具与流水线集成。 diff --git a/content/zh/docs/v4.1/11-use-extensions/01-devops/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/01-devops/_index.adoc new file mode 100644 index 000000000..517d277be --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/01-devops/_index.adoc @@ -0,0 +1,16 @@ +--- +title: "DevOps" +keywords: "Kubernetes, {ks_product}, DevOps" +description: "如何在 DevOps 项目中进行管理和操作,包括运行流水线、创建凭证和集成工具等。" +weight: 01 +layout: "second" +--- + + +DevOps 支持在 Kubernetes 集群上部署和管理 CI/CD 任务以及相关的工作负载。安装 DevOps 扩展组件时,会自动部署 Jenkins,支持通过 Jenkinsfile 构建流水线。此外,DevOps 还提供图形编辑面板,将整个流程可视化,直观地呈现流水线在每个阶段的运行状态。 + +安装 DevOps 扩展组件后,企业空间左侧导航栏将显⽰ **DevOps 项⽬**。 + +本节介绍如何管理 DevOps 项目,以及如何在 DevOps 项目中进行管理和操作,包括运行流水线、创建凭证和集成工具等。 + + diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/01-create-an-app-template.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/01-create-an-app-template.adoc new file mode 100644 index 000000000..cad259ebb --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/01-create-an-app-template.adoc @@ -0,0 +1,62 @@ +--- +title: "创建应用模板" +keywords: "Kubernetes, {ks_product}, 企业空间,应用模板, 创建应用模板" +description: "介绍如何创建应用模板。" +weight: 01 +--- + +:ks_permission: **应用/应用版本/应用实例创建** +:ks_navigation: **应用管理 > 应用模板** + +本节介绍如何创建应用模板。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + +* 已准备 .tar.gz 或 .tgz 格式的 Helm Chart 压缩包,或应用的 yaml 文件。您可以link:https://kubesphere.io/files/application-templates/nginx-0.1.0.tgz[下载 Nginx Helm Chart] 用于测试。有关更多信息,请参阅 link:https://helm.sh/zh/docs/topics/charts/[Helm 官方文档]。 + + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**创建应用**对话框,点击**上传 Helm Chart**,选择本地存储的 .tar.gz 或 .tgz 格式的 Helm Chart 压缩包。 ++ +或者点击**创建 yaml 应用**,输入应用名称和版本号,使用 yaml 文件创建应用。 ++ +-- +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +点击image:/images/ks-qkcp/zh/icons/upload-dark-white.svg[upload-dark,18,18]可从本地上传 yaml 文件。 + +点击image:/images/ks-qkcp/zh/icons/download-dark-white.svg[download-dark,18,18]可将 yaml 文件下载到本地。 +|=== +-- + +. 点击**确定**。 ++ +-- +应用模板创建完成后将显示在应用模板列表中。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/02-view-an-app-template-list.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/02-view-an-app-template-list.adoc new file mode 100644 index 000000000..4401f7d8c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/02-view-an-app-template-list.adoc @@ -0,0 +1,63 @@ +--- +title: "查看应用模板列表" +keywords: "Kubernetes, {ks_product}, 企业空间,应用模板, 查看应用模板列表" +description: "介绍如何查看应用模板列表。" +weight: 02 +--- + +:ks_permission: **应用/应用版本/应用实例查看** +:ks_navigation: **应用管理 > 应用模板** + +本节介绍如何查看应用模板列表。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +* 应用模板列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-appTemplateName.adoc[] + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-status_v4.adoc[] + +|企业空间 +|应用模板所属的企业空间。 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-latestVersion_v4.adoc[] + +|应用模板 +|应用模板的类型,如 **helm 应用**或 **yaml 应用**。 + +|更新时间 +|应用模板的更新时间。 +|=== +-- + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-searchForAppTemplates.adoc[] + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/03-view-app-template-details.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/03-view-app-template-details.adoc new file mode 100644 index 000000000..3998f46ba --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/03-view-app-template-details.adoc @@ -0,0 +1,106 @@ +--- +title: "查看应用模板详情" +keywords: "Kubernetes, {ks_product}, 企业空间,应用模板, 查看应用模板详情" +description: "介绍如何查看应用模板详情。" +weight: 03 +--- + + +:ks_permission: **应用/应用版本/应用实例查看** +:ks_navigation: **应用管理 > 应用模板** + + +本节介绍如何查看应用模板详情。 + + +== 前提条件 + + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-viewAttributes.adoc[] ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|应用 ID +|应用名称。 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-status_v4.adoc[] + +|分类 +|应用模板所属的分类,需手动设置。有关更多信息,请参阅link:../04-edit-app-template-information/[编辑应用模板信息]。 + +|类型 +|应用模板的类型,如 **helm 应用**或 **yaml 应用**。 + +|企业空间 +|应用模板所属的企业空间。 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-creationTime.adoc[] +|=== +-- + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-viewVersions.adoc[] ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|状态 +|应用版本当前的状态。 + +* **未提交**:应用版本已上传到企业空间,但未提交给{ks_product_both}平台的应用商店管理员审核。 + +* **已提交**:应用版本已提交给{ks_product_both}平台的应用商店管理员审核。 + +* **已发布**:应用版本已获得{ks_product_both}平台的应用商店管理员的批准,可以上架到应用商店。 + +* **已拒绝**:应用版本未获得{ks_product_both}平台的应用商店管理员的批准,审核不通过。 + +* **未发布**:应用版本发布后被应用商店管理员取消发布,或应用版本上架到{ks_product_both}平台的应用商店后被应用商店管理员下架。 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-version.adoc[] + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-developer.adoc[] + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-versionUpdateTime.adoc[] +|=== +-- + ++ +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-viewAppInformation.adoc[] + ++ + +// include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-viewAppReviewRecords.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-viewAppInstances.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/04-edit-app-template-information.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/04-edit-app-template-information.adoc new file mode 100644 index 000000000..da9277afa --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/04-edit-app-template-information.adoc @@ -0,0 +1,70 @@ +--- +title: "编辑应用模板信息" +keywords: "Kubernetes, {ks_product}, 企业空间,应用模板, 编辑应用模板信息" +description: "介绍如何编辑应用模板信息。" +weight: 04 +--- + +:ks_permission: **应用/应用版本/应用实例管理** +:ks_navigation: **应用管理 > 应用模板** + + +本节介绍如何编辑应用模板信息。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + ++ + +. 在应用模板详情页面左上角点击**编辑**。 + +. 在**编辑信息**对话框设置应用模板的参数,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|别名 +|应用的别名。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|应用的描述信息。描述可包含任意字符,最长 120 个字符。 + +|图标 +|应用的图标。如果未设置应用模板的图标,系统将默认使用应用名称第一个字符大写作为图标。图标格式必须为 .png 或 .jpg,不能超过 96 x 96 像素和 20 KB。 + +|应用分类 +|应用的功能分类。应用模板在上传到应用商店后将被自动划分到此处选择的分类下。 + +|服务商网站 +|服务商的网站地址。从应用商店安装应用的用户可联系服务商获取技术支持。 + +|应用截图 +|应用的介绍图片。最多支持上传 6 张截图,每张截图大小不能超过 2 MB。 + +|应用介绍 +|应用的介绍信息。支持输入 markdown 格式的图文介绍。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/05-install-an-app-by-using-an-app-template.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/05-install-an-app-by-using-an-app-template.adoc new file mode 100644 index 000000000..b1ad2cca2 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/05-install-an-app-by-using-an-app-template.adoc @@ -0,0 +1,82 @@ +--- +title: "使用应用模板安装应用" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用模板, 使用应用模板安装应用" +description: "介绍如何使用应用模板安装应用。" +weight: 05 +--- + +:ks_permission: **应用/应用版本/应用实例管理** +:ks_navigation: **应用管理 > 应用模板** + + +本节介绍如何在企业空间中使用应用模板安装应用。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + ++ + +. 在应用模板详情页面右侧的**版本**页签,点击所需的应用版本,然后在展开的区域中点击**部署**。 + +. 在弹出的**位置**对话框,选择应用的安装位置,然后点击**确定**。 + +. 在**基本信息**页签,设置应用的基本信息,然后点击**下一步**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|用户自定义的应用名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母开头并以小写字母或数字结尾,最长 32 个字符。 + +|版本 +|需要安装的应用版本。 + +|描述 +|应用的描述信息。描述可包含任意字符,最长 256 个字符。 + +|位置 +|应用所属的集群和项目。应用所属的企业空间默认为应用模板所属的企业空间。 +|=== +-- + +. 在**应用设置**页签,根据需要修改应用的参数设置,然后点击**安装**。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +{ks_product_right}的应用模板功能底层基于 Helm Chart 实现。**应用设置**页签的参数设置应符合 Helm Chart 的 Values 文件规范。有关更多信息,请参阅 link:https://helm.sh/zh/docs/chart_template_guide/values_files/[Helm 官方文档]。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] + +ifeval::["{file_output_type}" == "html"] +应用安装完成后,即可在目标项目中查看已安装的应用。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +应用安装完成后,即可在目标项目中查看已安装的应用。有关更多信息,请参阅《{ks_product_right}项目管理指南》的“应用”章节。 +endif::[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/06-upload-an-app-version.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/06-upload-an-app-version.adoc new file mode 100644 index 000000000..8abf2562f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/06-upload-an-app-version.adoc @@ -0,0 +1,47 @@ +--- +title: "上传应用版本" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用模板, 上传应用版本" +description: "介绍如何在应用模板创建后上传应用版本。" +weight: 06 +--- + + +:ks_permission: **应用/应用版本/应用实例管理** +:ks_navigation: **应用管理 > 应用模板** + + +本节介绍如何在应用模板创建后上传应用版本。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + +* 已准备 .tar.gz 或 .tgz 格式的 Helm Chart 压缩包。有关更多信息,请参阅 link:https://helm.sh/zh/docs/topics/charts/[Helm 官方文档]。 + + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + +. 在应用模板详情页面右侧的**版本**页签,点击**上传版本**。 + +. 在弹出的对话框中,点击**上传 Helm Chart**,选择本地存储的 .tar.gz 或 .tgz 格式 Helm Chart 压缩包,然后点击**确定**。 ++ +-- +应用新版本上传完成后将显示在应用模板详情页面的**版本**页签。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/08-delete-an-app-version.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/08-delete-an-app-version.adoc new file mode 100644 index 000000000..40a68d38d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/08-delete-an-app-version.adoc @@ -0,0 +1,50 @@ +--- +title: "删除应用版本" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用模板, 删除应用版本" +description: "介绍如何在应用模板中删除应用版本。" +weight: 08 +--- + +:ks_permission: **应用/应用版本/应用实例删除** +:ks_navigation: **应用管理 > 应用模板** + + +本节介绍如何在应用模板中删除应用版本。 + +// Warning +include::../../../../../../_ks_components/admonitions/warning.adoc[] + +应用版本删除后无法恢复,请谨慎执行此操作。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + +* 如果需要删除的应用版本已上架到应用商店,您需要联系应用商店管理员将应用版本下架。 + + + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + ++ + +. 在应用模板详情页面右侧的**版本**页签,点击需要删除的应用版本,在展开的区域中点击**删除**,然后在弹出的对话框点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/09-download-a-helm-chart-package.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/09-download-a-helm-chart-package.adoc new file mode 100644 index 000000000..174861b72 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/09-download-a-helm-chart-package.adoc @@ -0,0 +1,44 @@ +--- +title: "下载 Helm Chart 压缩包" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用模板, 下载 Helm Chart 压缩包" +description: "介绍如何下载应用版本的 Helm Chart 压缩包。" +weight: 09 +--- + + +:ks_permission: **应用/应用版本/应用实例查看** +:ks_navigation: **应用管理 > 应用模板** + + +本节介绍如何下载应用版本的 Helm Chart 压缩包。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + ++ + +. 在应用模板详情页面右侧的**版本**页签,点击所需的应用版本,然后在展开的区域中点击**下载**。 ++ +-- +应用版本的 Helm Chart 压缩包将通过浏览器下载到本地。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/10-release-an-app-version-to-the-app-store.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/10-release-an-app-version-to-the-app-store.adoc new file mode 100644 index 000000000..9cd19dfa7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/10-release-an-app-version-to-the-app-store.adoc @@ -0,0 +1,53 @@ +--- +title: "将应用版本发布到应用商店" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用模板, 将应用版本发布到应用商店" +description: "介绍如何将应用模板发布到应用商店。" +weight: 10 +--- + +:ks_permission: **应用/应用版本/应用实例管理** +:ks_navigation: **应用管理 > 应用模板** + + +本节介绍如何将应用版本发布到应用商店。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + ++ + +. 在应用模板详情页面右侧的**版本**页签,点击需要发布的应用版本,然后在展开的区域中点击**提交审核**。 + +. 待应用商店管理员审核通过并将其上架后,在页面左上角点击**应用商店**,即可在应用商店中查看已上架的应用版本。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +* 审核通过后,应用版本的状态将变为**已发布**,表示可以被应用商店管理员上架到应用商店。上架后,所有项目成员才可以从应用商店将应用版本安装到项目中。 + +* 有关应用审核和上架的更多信息,请参阅link:../../../03-app-store-management/[应用商店管理]。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/11-delete-an-app-template.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/11-delete-an-app-template.adoc new file mode 100644 index 000000000..f9b062008 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/11-delete-an-app-template.adoc @@ -0,0 +1,47 @@ +--- +title: "删除应用模板" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用模板, 删除应用模板" +description: "介绍如何删除应用模板。" +weight: 11 +--- + + +:ks_permission: **应用/应用版本/应用实例删除** +:ks_navigation: **应用管理 > 应用模板** + + +本节介绍如何删除应用模板。 + +// Warning +include::../../../../../../_ks_components/admonitions/warning.adoc[] + +应用模板删除后无法恢复,请谨慎执行此操作。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + +// * 已删除应用模板中的所有应用版本。有关更多信息,请参阅link:../08-delete-an-app-version/[删除应用版本]。 + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要删除的应用模板右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除应用模板**对话框,输入应用模板的名称,然后点击**确定**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/_index.adoc new file mode 100644 index 000000000..df9122ae0 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/01-app-templates/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "应用模板" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用管理, 应用模板" +description: "介绍如何管理应用模板。" +weight: 01 +layout: "second" +--- + +本节介绍如何管理企业空间的应用模板。 + +每个应用模板可包含一个或多个由 Helm Chart 定义的应用版本。您可以将 Helm Chart 作为应用模板上传到企业空间,从而在企业空间中的所有项目使用该应用模板安装应用。您也可以进一步将应用模板上传到应用商店,从而在{ks_product_both}平台的所有项目安装应用。 diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/_index.adoc new file mode 100644 index 000000000..51844302f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/02-app-management/_index.adoc @@ -0,0 +1,22 @@ +--- +title: "应用管理" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用管理, 应用模板" +description: "介绍如何通过企业空间管理应用模板。" +weight: 02 +layout: "second" +--- + + +在{ks_product_both}平台,应用特指由一个或多个工作负载、服务、应用路由等资源组成的业务程序。{ks_product_right}平台的应用模板功能底层基于 Helm 实现,通过 Helm Chart 定义应用的编排方式。 + +您可以在企业空间中创建包含一个或多个应用版本的应用模板(每个应用版本由一个 Helm Chart 定义),从而在企业空间的项目中安装应用模板中定义的应用。 + +ifeval::["{file_output_type}" == "html"] +有关企业空间中应用仓库的更多信息,请参阅link:../../../08-workspace-management/05-app-management/02-app-repositories/[应用仓库]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +有关企业空间中应用仓库的更多信息,请参阅《{ks_product_right}企业空间管理指南》的“应用仓库”章节。 +endif::[] + +有关 Helm 的更多信息,请参阅 link:https://helm.sh/zh/docs/[Helm 官方文档]。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/01-view-an-app-template-list.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/01-view-an-app-template-list.adoc new file mode 100644 index 000000000..a343aff91 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/01-view-an-app-template-list.adoc @@ -0,0 +1,69 @@ +--- +title: "查看应用模板列表" +keywords: "Kubernetes, {ks_product}, 应用商店管理, 应用, 查看应用模板列表" +description: "介绍如何查看应用模板列表。" +weight: 01 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用** + + +本节介绍如何查看应用商店中的应用模板列表。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +* **应用**页面显示应用商店中的应用模板,并提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-appTemplateName.adoc[] + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-status_v4.adoc[] + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-workspace.adoc[] + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-latestVersion_v4.adoc[] + + +// |分类 +// |应用模板所属的分类。将应用模板分配到一个分类中以便于管理。有关更多信息,请参阅link:../../02-app-categories/[应用分类]。 + +|应用模板 +|应用模板的类型,如 **helm 应用**或 **yaml 应用**。 + +|更新时间 +|应用模板的更新时间。 +|=== +-- + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-searchForAppTemplates.adoc[] + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/02-view-app-template-details.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/02-view-app-template-details.adoc new file mode 100644 index 000000000..97911e66c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/02-view-app-template-details.adoc @@ -0,0 +1,105 @@ +--- +title: "查看应用模板详情" +keywords: "Kubernetes, {ks_product}, 应用商店管理, 应用, 查看应用模板详情" +description: "介绍如何查看应用模板详情。" +weight: 02 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用** + + +本节介绍如何查看应用模板详情。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-viewAttributes.adoc[] ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|应用 ID +|应用名称。 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-status_v4.adoc[] + +|分类 +|应用模板所属的分类。将应用模板分配到一个分类中以便于管理。有关更多信息,请参阅link:../../02-app-categories/[应用分类]。 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-type.adoc[] + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-workspace.adoc[] + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-creationTime.adoc[] +|=== +-- + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-viewVersions.adoc[] ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|状态 +|应用版本当前的状态。 + +* **未提交**:应用版本已上传到企业空间,但未提交给{ks_product_both}平台的应用商店管理员审核。 + +* **已提交**:应用版本已提交给{ks_product_both}平台的应用商店管理员审核。 + +* **已发布**:应用版本已获得{ks_product_both}平台的应用商店管理员的批准,可以上架到应用商店。 + +* **已拒绝**:应用版本未获得{ks_product_both}平台的应用商店管理员的批准,审核不通过。 + +* **未发布**:应用版本发布后被应用商店管理员取消发布,或应用版本上架到{ks_product_both}平台的应用商店后被应用商店管理员下架。 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-version.adoc[] + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-developer.adoc[] + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-versionUpdateTime.adoc[] +|=== +-- + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-viewAppInformation.adoc[] + ++ + +// include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-viewAppReviewRecords.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-viewAppInstances.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/04-edit-an-app-template.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/04-edit-an-app-template.adoc new file mode 100644 index 000000000..74110c01d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/04-edit-an-app-template.adoc @@ -0,0 +1,65 @@ +--- +title: "编辑应用模板" +description: "介绍如何编辑应用商店中的应用模板信息。" +weight: 04 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用** + + +本节介绍如何编辑应用商店中的应用模板信息。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + +. 在需要编辑的应用模板右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑**。 + +. 在**编辑信息**对话框设置应用模板的参数,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|别名 +|应用的别名。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|应用的描述信息。描述可包含任意字符,最长 120 个字符。 + +|图标 +|应用的图标。如果未设置应用模板的图标,系统将默认使用应用名称第一个字符大写作为图标。图标格式必须为 .png 或 .jpg,不能超过 96 x 96 像素和 20 KB。 + +|应用分类 +|应用的功能分类。应用模板在上传到应用商店后将被自动划分到此处选择的分类下。 + +|服务商网站 +|服务商的网站地址。从应用商店安装应用的用户可联系服务商获取技术支持。 + +|应用截图 +|应用的介绍图片。最多支持上传 6 张截图,每张截图大小不能超过 2 MB。 + +|应用介绍 +|应用的介绍信息。支持输入 markdown 格式的图文介绍。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/06-publish-an-app-template.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/06-publish-an-app-template.adoc new file mode 100644 index 000000000..293ec819d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/06-publish-an-app-template.adoc @@ -0,0 +1,48 @@ +--- +title: "上架应用模板" +description: "介绍如何上架应用模板。" +weight: 06 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用** + + +本节介绍如何上架应用模板。 + +[.admon.attention,cols="a"] +|=== +|注意 + +| +在上架应用模板之前,其所包含的应用版本必须至少有一个是**已发布**状态。 +|=== + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + +. 在应用模板详情页面左上角点击**上架**。 ++ +应用成功上架后,可在页面左上角的**应用商店**页面查看该应用。{ks_product_right}平台的所有项目都可以安装该应用。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/08-cancel-release-an-app-version.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/08-cancel-release-an-app-version.adoc new file mode 100644 index 000000000..64354ba03 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/08-cancel-release-an-app-version.adoc @@ -0,0 +1,45 @@ +--- +title: "取消发布应用版本" +description: "介绍如何取消应用版本的发布。" +weight: 08 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用** + + +本节介绍如何取消发布应用版本。 + +应用模板上架后,若取消发布其中的应用版本,该版本将被从应用商店中移除。若应用模板中的应用版本均为**取消发布**状态,该应用模板将自动下架。 + +应用版本取消发布后,应用商店管理员和企业空间成员可以删除该应用版本。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + ++ + +. 在应用模板详情页面右侧的**版本**页签,点击需要操作的应用版本,在展开的区域点击**取消发布**,然后在弹出的对话框中点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/09-delete-an-app-version.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/09-delete-an-app-version.adoc new file mode 100644 index 000000000..6badbc1cc --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/09-delete-an-app-version.adoc @@ -0,0 +1,41 @@ +--- +title: "删除应用版本" +description: "介绍如何删除应用版本。" +weight: 08 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用** + + +本节介绍如何删除应用商店中的应用版本。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + ++ + +. 在应用模板详情页面右侧的**版本**页签,点击需要操作的应用版本,在展开的区域点击**删除**,然后在弹出的对话框中点击**确定**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/10-suspend-an-app-template.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/10-suspend-an-app-template.adoc new file mode 100644 index 000000000..46e20d13e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/10-suspend-an-app-template.adoc @@ -0,0 +1,45 @@ +--- +title: "下架应用模板" +keywords: "Kubernetes, {ks_product}, 应用商店管理, 应用, 下架应用模板" +description: "介绍如何下架应用模板。" +weight: 10 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用** + + + +本节介绍如何下架应用模板。 + +应用模板下架后,应用模板及其中所有的应用版本将被从应用商店移除,同时应用商店管理员和企业空间成员可以删除整个应用模板或其中的某一个应用版本。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-oper-openDetailsPage.adoc[] + ++ + +. 在应用模板详情页面左上角点击**下架**,然后在弹出的对话框中点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/12-delete-an-app-template.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/12-delete-an-app-template.adoc new file mode 100644 index 000000000..0c9efedb4 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/12-delete-an-app-template.adoc @@ -0,0 +1,37 @@ +--- +title: "删除应用模板" +description: "介绍如何删除应用模板。" +weight: 12 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用** + + +本节介绍如何删除应用商店中的应用模板。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + +. 在需要编辑的应用模板右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除应用模板**对话框,输入应用模板的名称,然后点击**确定**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/_index.adoc new file mode 100644 index 000000000..a920e54b8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/01-apps/_index.adoc @@ -0,0 +1,10 @@ +--- +title: "应用" +keywords: "Kubernetes, {ks_product}, 平台管理, 应用商店管理, 应用" +description: "介绍如何管理应用商店中的应用。" +weight: 01 +layout: "second" +--- + + +本节介绍如何管理应用商店中的应用模板。您可以查看、编辑应用的信息,并上架或下架应用。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/01-manage-app-categories.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/01-manage-app-categories.adoc new file mode 100644 index 000000000..98f72b0a8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/01-manage-app-categories.adoc @@ -0,0 +1,56 @@ +--- +title: "管理应用分类" +keywords: "Kubernetes, {ks_product}, 应用商店管理, 应用分类, 管理应用分类" +description: "介绍如何创建、编辑和删除应用分类。" +weight: 01 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用分类** + + +本节介绍如何创建、编辑和删除应用分类。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**应用分类**页面,根据需要创建、编辑或删除应用分类。 ++ +==== +* 在应用分类列表右上角点击image:/images/ks-qkcp/zh/icons/add-light.svg[add,18,18],在弹出的对话框设置应用分类的名称和图标,然后点击**确定**可创建应用分类。 + +* 在已有的应用分类右侧点击image:/images/ks-qkcp/zh/icons/pen-light.svg[pen,18,18],可编辑应用分类名称和图标。 + +* 在已有的应用分类右侧点击image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18],然后在弹出的对话框中点击**确定**可删除应用分类。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +删除应用分类前,您需要先将分类中的应用分配到其他分类或设置为**未分类**。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/02-set-the-category-of-an-app.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/02-set-the-category-of-an-app.adoc new file mode 100644 index 000000000..125229f4d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/02-set-the-category-of-an-app.adoc @@ -0,0 +1,42 @@ +--- +title: "设置应用所属的分类" +keywords: "Kubernetes, {ks_product}, 应用商店管理, 应用分类, 设置应用所属的分类" +description: "介绍如何设置应用的分类。" +weight: 02 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用分类** + + + +本节介绍如何设置应用所属的分类。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在应用模板列表中,选择需要操作的应用模板左侧的复选框,然后在列表上方点击**更改分类**。 + +. 在**更改分类**对话框,设置应用的分类,然后点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/_index.adoc new file mode 100644 index 000000000..7dc1a47cc --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/02-app-categories/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "应用分类" +keywords: "Kubernetes, {ks_product}, 平台管理, 应用商店管理, 应用分类" +description: "介绍如何管理应用分类。" +weight: 02 +layout: "second" +--- + + + +本节介绍如何管理应用分类。 + +您可以根据需要将应用模板分配到一个分类中以便于管理。 diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/01-review-an-app-version.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/01-review-an-app-version.adoc new file mode 100644 index 000000000..a223a1d5f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/01-review-an-app-version.adoc @@ -0,0 +1,53 @@ +--- +title: "审核应用版本" +keywords: "Kubernetes, {ks_product}, 应用商店, 应用审核, 审核应用版本" +description: "介绍如何审核提交到应用商店的应用版本。" +weight: 01 +--- + +:ks_navigation: **应用审核** +:ks_permission: **应用商店管理** + + +本节介绍如何审核提交到应用商店的应用版本。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + +* 企业空间成员已提交应用版本并且应用版本尚未被审核。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**新提交**页签,点击需要审核的应用版本的名称。 + +. 在**应用详情**区域,查看应用的相关信息,然后根据需要点击**拒绝**或**批准**。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +* 如果点击**拒绝**,您需要在**拒绝原因**对话框进一步输入拒绝应用发布的原因,然后点击**确定**。 + +* 应用版本审核通过后,还需要应用商店管理员将其上架,才能将应用版本发布到应用商店。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/02-view-app-review-records.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/02-view-app-review-records.adoc new file mode 100644 index 000000000..d8ebed804 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/02-view-app-review-records.adoc @@ -0,0 +1,76 @@ +--- +title: "查看应用版本审核记录" +keywords: "Kubernetes, {ks_product}, 应用商店, 应用审核, 查看应用版本审核记录" +description: "介绍如何查看应用版本审核记录。" +weight: 02 +--- + +:ks_menu: **平台管理 > 应用商店管理** +:ks_navigation: **应用审核** +:ks_permission: **应用商店管理** + + +本节介绍如何查看应用版本审核记录。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**应用审核**页面,点击**新提交**、**已完成**或**全部**页签,查看应用版本的审核记录。 ++ +==== +* **应用审核**页面提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|应用版本名称、图标、Helm Chart 版本。 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-workspace.adoc[] + +|提交者 +|提交应用版本的用户。 + +|状态 +|应用版本当前的审核状态。 + +* **待审核**:企业空间成员已提交应用版本,应用商店管理员尚未进行审核。 + +* **已发布**:应用商店管理员已批准应用发布。 + +* **已拒绝**:应用商店管理员已拒绝应用发布。 + +include::../../../../../_custom/workspaceManagement/appTemplates/appTemplates-para-versionUpdateTime.adoc[] +|=== +-- + +* 在列表上方点击搜索框并输入关键字,可搜索名称包含特定关键字的应用版本。 + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/_index.adoc new file mode 100644 index 000000000..248ad5272 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/03-app-review/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "应用审核" +keywords: "Kubernetes, {ks_product}, 平台管理, 应用商店管理, 应用审核" +description: "介绍如何审校提交到应用商店的应用版本。" +weight: 03 +layout: "second" +--- + + + +本节介绍如何对企业空间成员提交的应用模板进行审核。 + +企业空间成员可以在创建应用模板后将应用模板提交到应用商店,由平台级别具有**应用管理**权限的用户对应用模板进行审核。应用模板审核通过后可以上架到应用商店。 diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/01-add-an-app-repository.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/01-add-an-app-repository.adoc new file mode 100644 index 000000000..6b2e6c74c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/01-add-an-app-repository.adoc @@ -0,0 +1,48 @@ +--- +title: "添加应用仓库" +keywords: "Kubernetes, {ks_product}, 平台, 应用仓库, 添加应用仓库" +description: "介绍如何添加应用仓库。" +weight: 01 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用仓库** + + +本节介绍如何为{ks_product_both}平台添加应用仓库。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + +* 已提前创建 Helm Chart 仓库。有关如何创建 Helm Chart 仓库,请参阅 link:https://helm.sh/zh/docs/topics/chart_repository/[Helm 官方文档]。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在页面点击**添加**。 + +. 在**添加应用仓库**对话框,设置应用仓库的参数,然后点击**确定**。 ++ +-- +include::../../../../../_custom/workspaceManagement/appRepositories/appRepositories-para-createAppRepository.adoc[] + +应用仓库创建完成后将显示在应用仓库列表中。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/02-view-an-app-repository-list.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/02-view-an-app-repository-list.adoc new file mode 100644 index 000000000..4fa915233 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/02-view-an-app-repository-list.adoc @@ -0,0 +1,69 @@ +--- +title: "查看应用仓库列表" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用仓库, 查看应用仓库列表" +description: "介绍如何查看应用仓库列表。" +weight: 02 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用仓库** + + +本节介绍如何查看应用仓库列表。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +* 应用仓库列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|应用仓库的名称和描述信息。 + +|状态 +|应用仓库当前的状态。 + +* **成功**:应用仓库已添加并同步成功。 + +* **同步中**:应用仓库正在与 Helm Chart 仓库同步中。 + +* **不同步**:同步间隔时间设置为 0 时,应用仓库不与 Helm Chart 仓库同步。 + +* **失败**:应用仓库与 Helm Chart 仓库同步失败。 + +|URL +|Helm Chart 仓库的 URL。 + +|=== +-- + +* 在列表上方点击搜索框并输入关键字,可搜索名称包含特定关键字的应用仓库。 + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/03-edit-an-app-repository.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/03-edit-an-app-repository.adoc new file mode 100644 index 000000000..3fa86a108 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/03-edit-an-app-repository.adoc @@ -0,0 +1,44 @@ +--- +title: "编辑应用仓库" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用仓库, 编辑应用仓库" +description: "介绍如何编辑应用仓库。" +weight: 03 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用仓库** + + +本节介绍如何编辑应用仓库。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要编辑的应用仓库右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑**。 + +. 在**编辑应用仓库**对话框,设置应用仓库的参数,然后点击**确定**。 ++ +-- +include::../../../../../_custom/workspaceManagement/appRepositories/appRepositories-para-createAppRepository.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/05-delete-an-app-repository.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/05-delete-an-app-repository.adoc new file mode 100644 index 000000000..36aff009d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/05-delete-an-app-repository.adoc @@ -0,0 +1,47 @@ +--- +title: "删除应用仓库" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用仓库, 删除应用仓库" +description: "介绍如何删除应用仓库。" +weight: 05 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **应用仓库** + + +本节介绍如何删除应用仓库。 + +// Warning +include::../../../../../../_ks_components/admonitions/warning.adoc[] + +应用仓库删除后,用户将不能从应用仓库安装应用,请谨慎执行此操作。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要删除的应用仓库右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除应用仓库**对话框,输入应用仓库的名称,然后点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/_index.adoc new file mode 100644 index 000000000..b6e91230d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/04-app-repositories/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "应用仓库" +keywords: "Kubernetes, {ks_product}, 企业空间, 应用管理, 应用仓库" +description: "介绍如何添加和管理应用仓库以部署和管理应用。" +weight: 04 +layout: "second" +--- + + + +本节介绍如何管理{ks_product_both}平台的应用仓库。 + +将 Helm Chart 仓库作为应用仓库添加到{ks_product_both}平台,从而在所有项目中安装应用仓库中的应用。有关如何创建 Helm Chart 仓库,请参阅 link:https://helm.sh/zh/docs/topics/chart_repository/[Helm 官方文档]。 diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/01-view-an-app-list.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/01-view-an-app-list.adoc new file mode 100644 index 000000000..9aefa5ab7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/01-view-an-app-list.adoc @@ -0,0 +1,70 @@ +--- +title: "查看应用列表" +description: "介绍如何查看已部署的应用列表。" +weight: 01 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **部署管理** + +本节介绍如何查看已部署的应用列表。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +* 应用列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|应用的名称。 + +include::../../../../../_custom/projectManagement/apps/apps-para-status_v4.adoc[] + +|应用类型 +|应用模板的类型,如 **helm 应用**或 **yaml 应用**。 + +|应用模板 +|创建应用所使用的应用模板。仅对基于模板的应用显示。 + +|版本 +|应用的版本号。 + +* 对于基于模板的应用,显示 Helm Chart 的版本。 + +// * 对于自制应用,显示用户自定义的版本号。 + +|更新时间 +|应用的更新时间。 +|=== +-- + +* 在列表上方点击搜索框并输入关键字,可按名称搜索应用。 + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/02-view-app-instance-details.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/02-view-app-instance-details.adoc new file mode 100644 index 000000000..19084ab4f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/02-view-app-instance-details.adoc @@ -0,0 +1,83 @@ +--- +title: "查看应用详情" +description: "介绍如何查看应用详情。" +weight: 02 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **部署管理** + +本节介绍如何查看已部署应用的详情。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**部署管理**页面,点击一个应用的名称打开其详情页面。 + +. 在应用详情页面左侧的**属性**区域查看应用的资源属性。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|集群 +|应用所属的集群。 + +|项目 +|应用所属的项目。 + +include::../../../../../_custom/projectManagement/apps/apps-para-status_v4.adoc[] + +|应用 +|应用所使用的应用模板。 + +include::../../../../../_custom/projectManagement/apps/apps-para-details2.adoc[] +|=== +-- + ++ + +include::../../../../../_custom/projectManagement/apps/apps-oper-viewResourceStatus_v4.adoc[] + ++ + +. 在应用详情页面右侧点击**应用模板**查看应用模板的信息。 ++ +-- +* 点击**应用描述**可查看应用的介绍信息。 + +* 点击 **Chart 文件**可查看 Helm Chart 压缩包中的文件。在 **Chart 文件**右侧点击下拉列表可选择需要查看的文件。点击image:/images/ks-qkcp/zh/icons/download-dark-white.svg[download,18,18]可将文件下载到本地。 +-- + +. 在应用详情页面右侧点击**应用设置**查看应用的设置信息。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +应用的默认设置保存在 Helm Chart 压缩包中的 **values.yaml** 文件中。**应用设置**页面显示的是用户在安装应用时自定义的设置。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/04-edit-an-app-information.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/04-edit-an-app-information.adoc new file mode 100644 index 000000000..b802c406c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/04-edit-an-app-information.adoc @@ -0,0 +1,39 @@ +--- +title: "编辑应用信息" +description: "介绍如何编辑应用信息。" +weight: 04 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **部署管理** + +本节介绍如何编辑已部署应用的信息。 + +您可以编辑应用的别名和描述。{ks_product_right}不支持编辑已部署应用的名称。 + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要编辑的应用右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑信息**。 + +. 在**编辑信息**对话框设置应用的别名和描述,然后点击**确定**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/06-delete-an-app-instance.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/06-delete-an-app-instance.adoc new file mode 100644 index 000000000..f24537802 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/06-delete-an-app-instance.adoc @@ -0,0 +1,38 @@ +--- +title: "删除应用" +description: "介绍如何删除已部署的应用实例。" +weight: 06 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **部署管理** + +本节介绍如何删除已部署的应用实例。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要删除的应用右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除应用**对话框输入应用名称,然后点击**确定**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/08-deploy-an-app-from-the-app-store.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/08-deploy-an-app-from-the-app-store.adoc new file mode 100644 index 000000000..6f59160cf --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/08-deploy-an-app-from-the-app-store.adoc @@ -0,0 +1,71 @@ +--- +title: "从应用商店部署应用" +description: "介绍如何从应用商店部署应用。" +weight: 08 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **部署管理** + + +本节介绍如何在应用商店管理页面从应用商店部署应用。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + + ++ + +. 在**创建应用**对话框点击**从应用商店**。 + +. 在应用商店中,点击需要使用的应用模板,然后在右上角点击**部署**。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +如果弹出**部署须知**对话框,请仔细阅读相关内容,然后点击**同意**。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +. 在弹出的**位置**对话框,选择应用的安装位置,然后点击**确定**。 + ++ + +include::../../../../../_custom/projectManagement/apps/apps-oper-installApp.adoc[] + ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +应用商店中的应用由具有相关权限的企业空间成员发布或由第三方提供。有关应用功能参数的更多信息,请联系相关企业空间成员或应用的提供方。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] + +应用创建完成后将显示在应用列表中。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/10-deploy-an-app-using-an-app-template.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/10-deploy-an-app-using-an-app-template.adoc new file mode 100644 index 000000000..c4ef75a58 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/10-deploy-an-app-using-an-app-template.adoc @@ -0,0 +1,70 @@ +--- +title: "从应用模板部署应用" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用, 从应用模板安装应用" +description: "介绍如何从应用模板安装应用。" +weight: 10 +--- + +:ks_permission: **应用商店管理** +:ks_navigation: **部署管理** + + +本节介绍如何在应用商店管理页面从应用模板部署应用。 + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用商店管理**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**创建应用**对话框点击**从应用模板**。 + +. 在**应用模板**页面,点击**当前企业空间**下拉列表,选择**当前企业空间**或一个应用仓库。 + +. 点击需要使用的应用模板,然后点击**安装**。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +应用模板由具有相关权限的企业空间成员创建,应用仓库由应用商店管理员创建。 +有关更多信息,请参阅link:../../../02-app-management/01-app-templates/01-create-an-app-template/[创建应用模板]和link:../../../03-app-store-management/04-app-repositories/01-add-an-app-repository/[添加应用仓库]。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + ++ + +include::../../../../../_custom/projectManagement/apps/apps-oper-installApp.adoc[] ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +有关应用功能参数的更多信息,请联系相关企业空间成员或应用的提供方。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] + +应用创建完成后将显示在应用列表中。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/_index.adoc new file mode 100644 index 000000000..d4a8d6802 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/05-app-deployment/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "部署管理" +keywords: "Kubernetes, {ks_product}, 平台管理, 应用, 应用管理, 应用部署" +description: "介绍如何管理所有已部署的应用实例,以及如何直接部署应用到项目。" +weight: 05 +layout: "second" +--- + + + +本节介绍如何管理{ks_product_both}平台中所有已部署的应用实例,以及如何直接部署应用到项目。 diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/_index.adoc new file mode 100644 index 000000000..100f1ab48 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/03-app-store-management/_index.adoc @@ -0,0 +1,17 @@ +--- +title: "应用商店管理" +keywords: "Kubernetes, {ks_product}, 平台管理, 应用商店管理" +description: "介绍如何管理应用商店。" +weight: 03 +layout: "second" +--- + + + +本节介绍如何管理应用商店。 + +应用商店提供了基于 Helm Chart 的应用模板,{ks_product_right}平台所有项目的成员都可以访问应用商店。 + +应用商店管理员可以对应用商店中的应用模板进行分类、审核、上架、下架等操作,管理平台的应用仓库和所有已部署的应用实例,并直接部署应用到项目。 + +安装“KubeSphere 应用商店管理”扩展组件后,在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择**应用商店管理**,进入应用商店的管理页面。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/02-app-store/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/02-app-store/_index.adoc new file mode 100644 index 000000000..b3ce31796 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/02-app-store/_index.adoc @@ -0,0 +1,18 @@ +--- +title: "KubeSphere 应用商店管理" +weight: 02 +layout: "second" +--- + + +本节介绍如何使用“KubeSphere 应用商店管理”扩展组件。 + +安装“KubeSphere 应用商店管理”扩展组件后,企业空间左侧导航栏的**应⽤管理**菜单下将显⽰**应用模板**选项,页面右上角的扩展组件快捷入口中将显⽰**应⽤商店管理**选项。 + +使用该扩展组件: + +- 企业空间管理员可以管理应用模板,提交应用模板中定义的应用到应用商店。待应用商店管理员审批通过并上架后,即可发布应用程序到应用商店,供{ks_product_both}平台的所有项目安装该应用。 + +- 应用商店管理员可以对应用商店中的应用模板进行分类、审核、上架、下架等操作,管理平台的应用仓库和所有已部署的应用实例,并直接部署应用到项目。 + + diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/03-manually-compose-an-app.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/03-manually-compose-an-app.adoc new file mode 100644 index 000000000..c649c57bf --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/03-manually-compose-an-app.adoc @@ -0,0 +1,66 @@ +--- +title: "创建自制应用" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用, 创建自制应用" +description: "介绍如何创建自制应用。" +weight: 03 +--- + +:ks_permission: ** Service Mesh 管理** +:ks_navigation: **服务网格 > 自制应用** + + +本节介绍如何创建自制应用。 + +include::../../../../_custom/projectManagement/apps/apps-compose-description.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + +. 在**基本信息**页签,设置应用的基本信息,然后点击**下一步**。 ++ +-- +include::../../../../_custom/projectManagement/apps/apps-basic-para.adoc[] +-- + +. 在**服务设置**页签,点击**创建服务**,选择**有状态服务**或**无状态服务**为应用创建服务,然后点击**下一步**。 ++ +-- +include::../../../../_custom/clusterManagement/services/services-para-statelessStatefulExternal.adoc[] + +ifeval::["{file_output_type}" == "html"] +有关**有状态服务**和**无状态服务**的参数设置,请参阅link:../../../../09-project-management/03-application-workloads/02-services/01-create-a-service/01-create-a-stateful-or-stateless-service/#_参数描述[创建有状态服务或无状态服务]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +有关**有状态服务**和**无状态服务**的参数设置,请参阅《{ks_product_right}项目管理指南》的“创建有状态服务或无状态服务”章节。 +endif::[] +-- + +. 在**路由设置**页签,点击**添加路由规则**为应用创建路由规则,然后点击**创建**。 ++ +-- +include::../../../../_custom/clusterManagement/routes/routes-para-routingRules.adoc[] + +应用创建完成后将显示在**自制应用**页面。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/04-view-an-app-list.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/04-view-an-app-list.adoc new file mode 100644 index 000000000..c391c9fec --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/04-view-an-app-list.adoc @@ -0,0 +1,68 @@ +--- +title: "查看自制应用列表" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用, 查看应用列表" +description: "介绍如何查看应用列表。" +weight: 04 +--- + +:ks_permission: ** Service Mesh 查看** +:ks_navigation: **服务网格 > 自制应用** + + +本节介绍如何查看自制应用列表。 + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**自制应用**页面,查看应用列表。 ++ +==== +* 应用列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|应用的名称。 + +include::../../../../_custom/projectManagement/apps/apps-para-status_v4.adoc[] + +|版本 +|应用的版本号。 + +// * 对于基于模板的应用,显示 Helm Chart 的版本。 + +* 对于自制应用,显示用户自定义的版本号。 + +|创建时间 +|应用的创建时间。 +|=== +-- + +* 在列表上方点击搜索框并输入关键字,可按名称搜索应用。 + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/05-view-composed-app-details.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/05-view-composed-app-details.adoc new file mode 100644 index 000000000..288817e91 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/05-view-composed-app-details.adoc @@ -0,0 +1,124 @@ +--- +title: "查看自制应用详情" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用, 查看自制应用详情" +description: "介绍如何查看自制应用详情。" +weight: 05 +--- + +:ks_permission: ** Service Mesh 查看** +:ks_navigation: **服务网格 > 自制应用** + + +本节介绍如何查看自制应用详情。 + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**自制应用**页面,点击一个应用的名称打开其详情页面。 + +. 在应用详情页面左侧的**属性**区域查看应用的资源属性。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../_custom/projectManagement/apps/apps-para-details1.adoc[] + +include::../../../../_custom/projectManagement/apps/apps-para-details2.adoc[] + +|应用治理 +|应用是否已启用应用治理。应用治理启用后,您可以使用流量监控、灰度发布和链路追踪功能。 +|=== +-- + ++ + +include::../../../../_custom/projectManagement/apps/apps-oper-viewResourceStatus.adoc[] + ++ + +. 在应用详情页面右侧点击**流量监控**查看应用的流量信息。 ++ +-- +点击图形面板中的服务,在页面右侧,查看服务的流量监控信息、相关的容器组信息,并进行**流量管理**。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|流量策略 > 负载均衡 +|负载均衡算法 + +* **轮询**:将客户端请求轮流发送给各个后端。 +* **最少请求**:随机选择两个健康的后端,并将客户端请求发送给请求数较少的后端。 +* **随机**:将客户端请求发送给一个随机的健康后端。 +* **透传**:将连接直接转发给调用者请求的原始 IP 地址,而不进行任何形式的负载均衡。用于高级配置,请谨慎使用。 + +|流量策略 > 会话保持 +| +根据特定的标识(例如 HTTP header、Cookie、查询参数等)将请求映射到后端服务器,以实现请求的均衡分发和负载分担。 + +* **基于 HTTP Header 哈希**:基于特定的 HTTP header 进行哈希。 +* **基于 HTTP Cookie 哈希**:基于 HTTP cookie 进行哈希。 +* **基于 HTTP 查询参数哈希**:基于特定的 HTTP 查询参数进行哈希。 +* **基于源 IP 地址哈希**:基于源 IP 地址进行哈希。适用于 TCP 和 HTTP 连接。 +* **基于 ring/modulo 哈希**:ring/modulo 哈希负载均衡器使用一致性哈希算法对后端主机进行哈希。 +* **基于 Maglev 哈希**:Maglev 哈希负载均衡器使用一致性哈希算法对后端主机进行哈希。 + +有关更多信息,请参阅link:https://istio.io/v1.16/zh/docs/reference/config/networking/destination-rule/#LoadBalancerSettings-ConsistentHashLB[此文档]。 + +|连接池 +|为应用程序创建固定数量的连接对象, 并将其存储在一个连接池中供重复使用。每次请求都从连接池中获取连接对象,并在使用后将连接对象返还到连接池。 + +启用后,需设置最大连接数、每个连接最大请求数、最大重试次数、连接超时、最大请求数量、最大等待请求数量。 + +|熔断器 +|如果服务无法访问并且符合指定的条件, 熔断器会将服务标记为不可用,并在指定时间范围内直接向返回客户端错误响应。 + +启用后,需设置连续 5XX 错误数量、检查间隔(秒)、最大排除比例(%)、排除时间(秒)。 +|=== + +-- + +. 在应用详情页面右侧点击**灰度发布**查看应用的灰度发布信息。有关更多信息,请参阅link:../../02-grayscale-release/[灰度发布]。 ++ +-- +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +如需使用**流量监控**和**灰度发布**功能,您需要在创建自制应用时启用应用治理功能。有关更多信息,请参阅link:../03-manually-compose-an-app/[创建自制应用]。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +. 在应用详情页面右侧点击**链路追踪**查看应用请求链路信息。 ++ +-- +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +* 如需使用**链路追踪**功能,您需要在创建自制应用时启用应用治理功能。有关更多信息,请参阅link:../03-manually-compose-an-app/[创建自制应用]。 + +* 同时需要启用项目网关,并为项目网关启用**链路追踪**功能。有关更多信息,请参阅link:../../../12-gateway/01-project-gateway/01-enable-a-project-gateway[启用项目网关]。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/06-edit-app-information.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/06-edit-app-information.adoc new file mode 100644 index 000000000..dcaed5391 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/06-edit-app-information.adoc @@ -0,0 +1,38 @@ +--- +title: "编辑自制应用信息" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用, 编辑应用信息" +description: "介绍如何编辑应用信息。" +weight: 06 +--- + +:ks_permission: ** Service Mesh 管理** +:ks_navigation: **服务网格 > 自制应用** + + +本节介绍如何编辑自制应用信息。 + +您可以编辑应用的别名和描述。{ks_product_right}不支持编辑已创建应用的名称。 + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/projectManagement/apps/apps-oper-editAppInformation.adoc[] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/07-add-a-service.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/07-add-a-service.adoc new file mode 100644 index 000000000..49b387704 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/07-add-a-service.adoc @@ -0,0 +1,72 @@ +--- +title: "为自制应用添加服务" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用, 编辑应用设置" +description: "介绍如何为自制应用添加服务。" +weight: 07 +--- + +:ks_permission: ** Service Mesh 管理** +:ks_navigation: **服务网格 > 自制应用** + + +本节介绍如何为自制应用添加有状态或无状态服务。 + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**自制应用**页面,点击一个应用的名称打开其详情页面。 + +. 在应用详情页面左上角选择**更多操作 > 添加服务**。 + +. 在**创建服务**对话框,根据需要选择**有状态服务**或**无状态服务**。 ++ +-- +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +include::../../../../_custom/clusterManagement/services/services-para-statelessStatefulExternal.adoc[] + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + ++ + +include::../../../../_custom/projectManagement/services/services-oper-setBasicInformation.adoc[] + ++ + +. 在**容器组设置**页签,为服务后端工作负载管理的容器组设置副本数量、容器、更新策略、安全上下文、调度规则和元数据,然后点击**下一步**。 + ++ + +include::../../../../_custom/projectManagement/services/services-oper-setStorageAdvanced.adoc[] ++ +-- +ifeval::["{file_output_type}" == "html"] +有关**有状态服务**和**无状态服务**的参数设置,请参阅link:../../../../09-project-management/03-application-workloads/02-services/01-create-a-service/01-create-a-stateful-or-stateless-service/#_参数描述[创建有状态服务或无状态服务]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +有关**有状态服务**和**无状态服务**的参数设置,请参阅《{ks_product_right}项目管理指南》的“创建有状态服务或无状态服务”章节。 +endif::[] +-- + diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/08-add-an-app-route.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/08-add-an-app-route.adoc new file mode 100644 index 000000000..44bbd0526 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/08-add-an-app-route.adoc @@ -0,0 +1,42 @@ +--- +title: "为自制应用添加应用路由" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用, 编辑应用设置" +description: "介绍如何为自制应用添加应用路由。" +weight: 07 +--- + +:ks_permission: ** Service Mesh 管理** +:ks_navigation: **服务网格 > 自制应用** + + +本节介绍如何为自制应用添加应用路由。 + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**自制应用**页面,点击一个应用的名称打开其详情页面。 + +. 在应用详情页面左上角选择**更多操作 > 添加应用路由**。 + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-createARoute.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/10-delete-apps.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/10-delete-apps.adoc new file mode 100644 index 000000000..bb5011f89 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/10-delete-apps.adoc @@ -0,0 +1,61 @@ +--- +title: "删除自制应用" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用, 删除应用" +description: "介绍如何删除应用。" +weight: 10 +--- + +:ks_permission: ** Service Mesh 管理** +:ks_navigation: **服务网格 > 自制应用** + + +本节介绍如何删除自制应用。 + + +== 前提条件 + + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +* {ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 + + +== 删除单个应用 +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ +. 在**自制应用**页面,查看应用列表。 + +. 在需要删除的应用右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除应用**对话框,输入应用的名称,然后点击**确定**。 + + +== 批量删除应用 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**自制应用**页面,查看应用列表。 + +. 选择需要删除的应用左侧的复选框,然后在应用列表上方点击**删除**。 + +. 在**批量删除应用**对话框,输入应用的名称,然后点击**确定**。 ++ +-- +include::../../../../_custom/note-separateNamesByComma.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/_index.adoc new file mode 100644 index 000000000..a3d35cf7a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/01-apps/_index.adoc @@ -0,0 +1,30 @@ +--- +title: "自制应用" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用" +description: "介绍如何管理项目中安装的应用。" +weight: 01 +layout: "second" +--- + + +本节介绍如何管理自制应用。 + +include::../../../../_custom/projectManagement/apps/apps-types.adoc[] + +ifeval::["{file_output_type}" == "html"] +[.admon.note,cols="a"] +|=== +|说明 + +|有关基于模板的应用的更多信息,请参阅link:../../../09-project-management/03-application-workloads/01-apps[应用]。 +|=== +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +[.admon.note,cols="a"] +|=== +|说明 + +|有关基于模板的应用的更多信息,请参阅《{ks_product_right}项目管理指南》的“应用负载 > 应用”章节。 +|=== +endif::[] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/01-create-a-grayscale-release-task.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/01-create-a-grayscale-release-task.adoc new file mode 100644 index 000000000..e9ffd443f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/01-create-a-grayscale-release-task.adoc @@ -0,0 +1,201 @@ +--- +title: "创建灰度发布任务" +keywords: "Kubernetes, {ks_product}, 项目管理, 灰度发布, 创建灰度发布任务" +description: "介绍如何创建灰度发布任务。" +weight: 01 +--- + +:ks_permission: ** Service Mesh 管理** +:ks_navigation: **服务网格 > 灰度发布** + + +本节介绍如何创建灰度发布任务。 + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 + +* 提前准备新版本的容器镜像并上传到容器镜像服务,同时确保存容器镜像服务与{ks_product_both}网络连接正常。 + + +== 操作步骤 + +请参阅link:#_参数描述[参数描述]设置灰度发布任务的参数。 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 根据需要创建灰度发布任务类型,将光标悬停在**蓝绿部署**、**金丝雀发布**或**流量镜像**区域,然后点击**创建**。 + +. 在**基本信息**页签,设置灰度发布任务的名称,然后点击**下一步**。 + +. 在**服务设置**页签,选择需要进行灰度发布的应用和服务,然后点击**下一步**。 + +. 在**新版本设置**页签,设置新版本的服务版本号、容器组副本数量和容器,然后点击**下一步**。 + +. 在**策略设置**页签,设置灰度发布任务的流量转发策略,然后点击**创建**。 ++ +-- +灰度发布任务创建完成后将显示在**灰度发布**页面的**发布任务**页签。 +-- + + +== 参数描述 + +以下介绍如何设置灰度发布任务的参数。 + +* 基本信息 ++ +-- +设置任务的名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母或数字开头和结尾,最长 253 个字符。 +-- + +* 服务设置 ++ +-- +选择需要进行灰度发布的自制应用和服务。 + +* 点击下拉列表选择一个自制应用。 + +* 在需要进行灰度发布的服务右侧点击**选择**。 + +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +灰度发布仅支持自制应用,不支持基于模板的应用。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +* 新版本设置 ++ +-- +设置新版本的服务版本号、容器组副本数量和容器。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|新版本号 +|新版本的服务版本号。新版本号只能包含小写字母和数字, 最长 16 个字符。 + +|副本 +| +新版本的容器组副本数量。点击image:/images/ks-qkcp/zh/icons/chevron-up.svg[chevron-up,18,18]/image:/images/ks-qkcp/zh/icons/chevron-down.svg[chevron-down,18,18]可增加/减少容器组副本的数量。 + +|添加容器 +| +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addContainer.adoc[] + +* 直接在文本框中输入容器镜像的 URL 可替换旧版本的容器镜像,同时保持其他容器设置不变。 +|=== +-- + +* 新版本设置 > 添加容器 > 容器设置 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-setImageNameTypeResource.adoc[] + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerImage.adoc[] + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerName.adoc[] + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerType.adoc[] + +|CPU 预留 +|为容器预留的 CPU 资源,单位为核。 + +|CPU 上限 +|允许容器使用的 CPU 资源上限,单位为核。 + +|内存预留 +|为容器预留的内存资源,单位为 MiB。 + +|内存上限 +|允许容器使用的内存资源上限,单位为 MiB。 +|=== +-- + +* 新版本设置 > 添加容器 > 端口设置 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-Port.adoc[] +-- + +* 新版本设置 > 添加容器 > 镜像拉取策略 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-imagePullPolicy.adoc[] +-- + +* 新版本设置 > 添加容器 > 健康检查 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-healthCheck.adoc[] +-- + +* 新版本设置 > 添加容器 > 健康检查 > 添加探针 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addProbe.adoc[] +-- + +* 新版本设置 > 添加容器 > 生命周期管理 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-lifecycleManagement.adoc[] +-- + +* 新版本设置 > 添加容器 > 生命周期管理 > 添加动作 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addAction.adoc[] +-- + +* 新版本设置 > 添加容器 > 启动命令 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-startCommand.adoc[] +-- + +* 新版本设置 > 添加容器 > 环境变量 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-environmentVariables.adoc[] +-- + +* 新版本设置 > 添加容器 > 容器组安全上下文 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerSecurityContext.adoc[] +-- + +* 新版本设置 > 添加容器 > 同步主机时区 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-syncTimeZone.adoc[] +-- + +* 策略设置 ++ +==== +设置灰度发布任务的业务流量转发策略。 + +include::../../../../_custom/projectManagement/grayscaleRelease/grayscaleRelease-para-strategySettings.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/02-view-a-grayscale-release-task-list.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/02-view-a-grayscale-release-task-list.adoc new file mode 100644 index 000000000..bfe9cc2c1 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/02-view-a-grayscale-release-task-list.adoc @@ -0,0 +1,52 @@ +--- +title: "查看灰度发布任务列表" +keywords: "Kubernetes, {ks_product}, 项目管理, 灰度发布, 查看灰度发布任务列表" +description: "介绍如何查看灰度发布任务列表。" +weight: 02 +--- + +:ks_permission: ** Service Mesh 查看** +:ks_navigation: **服务网格 > 灰度发布** + + +本节介绍如何查看灰度发布任务列表。 + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**灰度发布**页面,点击**发布任务**打开灰度发布任务列表。 ++ +-- +灰度发布任务列表提供以下信息: + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|灰度发布任务的名称、应用、发布模式和服务。 + +|版本 +|新旧版本的版本号和容器组副本数量。 + +include::../../../../_custom/projectManagement/grayscaleRelease/grayscaleRelease-para-trafficSuccessLatency.adoc[] +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/03-view-grayscale-release-task-details.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/03-view-grayscale-release-task-details.adoc new file mode 100644 index 000000000..5300c1e3a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/03-view-grayscale-release-task-details.adoc @@ -0,0 +1,61 @@ +--- +title: "查看灰度发布任务详情" +keywords: "Kubernetes, {ks_product}, 项目管理, 灰度发布, 查看灰度发布任务详情" +description: "介绍如何查看灰度发布任务详情。" +weight: 03 +--- + +:ks_permission: ** Service Mesh 查看** +:ks_navigation: **服务网格 > 灰度发布** + + +本节介绍如何查看灰度发布任务详情。 + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/projectManagement/grayscaleRelease/grayscaleRelease-oper-openDetailsPage.adoc[] ++ +-- +灰度发布任务详情页面提供以下信息: + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|灰度发布任务的名称和发布模式。 + +|版本 +|新旧版本的容器组副本数量、容器组名称、CPU 用量和内存用量。 + +|流量分配 +| +* 对于蓝绿部署,显示当前接收全部流量的服务版本。 + +* 对于金丝雀发布,显示新旧版本的流量接收比例。 + +* 对于流量镜像,显示旧版本接收新版本流量的相同副本。 + +include::../../../../_custom/projectManagement/grayscaleRelease/grayscaleRelease-para-trafficSuccessLatency.adoc[] +|=== +-- + diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/04-switch-versions-blue-green-deployment.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/04-switch-versions-blue-green-deployment.adoc new file mode 100644 index 000000000..777f75aed --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/04-switch-versions-blue-green-deployment.adoc @@ -0,0 +1,38 @@ +--- +title: "切换上线版本(蓝绿部署)" +keywords: "Kubernetes, {ks_product}, 项目管理, 灰度发布, 切换上线版本(蓝绿部署)" +description: "介绍如何为蓝绿部署任务切换上线版本。" +weight: 04 +--- + +:ks_permission: ** Service Mesh 管理** +:ks_navigation: **服务网格 > 灰度发布** + +本节介绍如何为蓝绿部署任务切换上线版本。 + +根据业务需要,您可以一键设置蓝绿部署任务中的新版本或旧版本立即接管全部业务流量。 + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**灰度发布**页面,点击**发布任务**,然后点击一个蓝绿部署任务的名称打开其详情页面。 + +. 在**版本**区域,在一个版本右上角点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**接管**可设置该版本立即接管全部业务流量。 diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/05-adjust-traffic-distribution-ratio-canary-release.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/05-adjust-traffic-distribution-ratio-canary-release.adoc new file mode 100644 index 000000000..1c26d530a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/05-adjust-traffic-distribution-ratio-canary-release.adoc @@ -0,0 +1,40 @@ +--- +title: "调整流量分配比例(金丝雀发布)" +keywords: "Kubernetes, {ks_product}, 项目管理, 灰度发布, 调整流量分配比例(金丝雀发布)" +description: "介绍如何为金丝雀发布任务调整流量分配比例。" +weight: 05 +--- + +:ks_permission: ** Service Mesh 管理** +:ks_navigation: **服务网格 > 灰度发布** + +本节介绍如何为金丝雀发布任务调整流量分配比例。 + +根据业务需要,您可以手动调整金丝雀发布任务中的新版本和旧版本接收业务流量的分配比例。 + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**灰度发布**页面,点击**发布任务**,然后点击一个金丝雀发布任务的名称打开其详情页面。 + +. 在**流量分配**区域,拖动滑块调整新旧版本接收流量的比例,然后在弹出的对话框中点击**确定**。系统将按照设置的比例在新旧版本之间分配业务流量。 + +. (可选)在**版本**区域,在一个版本右上角点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**接管**可设置该版本立即接管全部业务流量。 diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/06-edit-settings-of-a-grayscale-release-task.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/06-edit-settings-of-a-grayscale-release-task.adoc new file mode 100644 index 000000000..ce5400d0f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/06-edit-settings-of-a-grayscale-release-task.adoc @@ -0,0 +1,56 @@ +--- +title: "编辑灰度发布任务设置" +keywords: "Kubernetes, {ks_product}, 项目管理, 灰度发布, 编辑灰度发布任务设置" +description: "介绍如何编辑灰度发布任务设置。" +weight: 06 +--- + +:ks_permission: ** Service Mesh 管理** +:ks_navigation: **服务网格 > 灰度发布** + + +本节介绍如何编辑灰度发布任务设置。 + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/projectManagement/grayscaleRelease/grayscaleRelease-oper-openDetailsPage.adoc[] + ++ + +. 在**版本**区域,在新版本右上角点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑**。 + +. 在**新版本设置**页签,点击image:/images/ks-qkcp/zh/icons/chevron-up.svg[chevron-up,18,18]/image:/images/ks-qkcp/zh/icons/chevron-down.svg[chevron-down,18,18]可增加/减少容器组副本的数量。 ++ +-- +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +灰度发布不支持修改新版本的版本号和容器镜像。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +. 点击**策略设置**页签,设置灰度发布任务的流量转发策略,然后点击**确定**。 ++ +==== +include::../../../../_custom/projectManagement/grayscaleRelease/grayscaleRelease-para-strategySettings.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/07-delete-a-grayscale-release-task.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/07-delete-a-grayscale-release-task.adoc new file mode 100644 index 000000000..7937a5cce --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/07-delete-a-grayscale-release-task.adoc @@ -0,0 +1,52 @@ +--- +title: "删除灰度发布任务" +keywords: "Kubernetes, {ks_product}, 项目管理, 灰度发布, 删除灰度发布任务" +description: "介绍如何删除灰度发布任务。" +weight: 07 +--- + +:ks_permission: ** Service Mesh 管理** +:ks_navigation: **服务网格 > 灰度发布** + + +本节介绍如何删除灰度发布任务。 + +// Warning +include::../../../../../_ks_components/admonitions/warning.adoc[] + +只有在新旧版本之一已接管全部业务流量时才能删除灰度发布任务。灰度发布任务删除后,未接管业务流量的版本(服务、工作负载和容器组)也将被删除。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 + +* 新旧版本之一已接管全部业务流量。有关更多信息,请参阅link:../04-switch-versions-blue-green-deployment/[切换上线版本(蓝绿部署)]和link:../05-adjust-traffic-distribution-ratio-canary-release/[调整流量分配比例(金丝雀发布)]。 + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/projectManagement/grayscaleRelease/grayscaleRelease-oper-openDetailsPage.adoc[] + ++ + +. 在灰度发布详情页面右上角,点击**删除**。 ++ +-- +系统将删除灰度发布任务,同时删除未接管业务流量的版本。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/_index.adoc new file mode 100644 index 000000000..445cc6555 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/02-grayscale-release/_index.adoc @@ -0,0 +1,27 @@ +--- +title: "灰度发布" +keywords: "Kubernetes, {ks_product}, 项目管理, 灰度发布" +description: "介绍如何管理灰度发布任务。" +weight: 02 +layout: "second" +--- + + +本节介绍如何使用灰度发布功能。 + +当容器的版本需要更新时,如果新版本未经充分测试而直接发布到生产环境,可能会给业务带来很大风险。使用灰度发布功能将生产环境的业务流量转发给测试中的新版本,从而在新版本正式发布前充分暴露并及时修复新版本可能存在的问题。 + +{ks_product_right}支持以下灰度发布模式: + +* 蓝绿部署:将业务流量发送给新版本进行测试。如果新版本运行不正常,可立即将业务流量切换给旧版本。 + +* 金丝雀发布:将业务流量按一定比例分配给新版本和旧版本,在测试新版本的同时保证业务连续性。 + +* 流量镜像:将业务流量的副本发送给新版本进行测试,而不实际暴露新版本。 + +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +灰度发布仅支持自制应用,不支持基于模板的应用。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/_index.adoc new file mode 100644 index 000000000..536595ccc --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/03-service-mesh/_index.adoc @@ -0,0 +1,25 @@ +--- +title: "KubeSphere 服务网格" +keywords: "Kubernetes, {ks_product}, 服务网格" +description: "介绍如何使用 KubeSphere 服务网格组件。" +weight: 03 +layout: "second" +--- + +本节介绍如何使用“KubeSphere 服务网格”扩展组件。 + +“KubeSphere 服务网格”扩展组件用于启用{ks_product_both}平台的服务网格功能,基于开源项目 Istio 构建,将微服务治理和流量管理可视化。它拥有强大的工具包,包括熔断机制、蓝绿部署、金丝雀发布、流量镜像、链路追踪、可观测性和流量控制等。 + +// 服务网格支持代码无侵入的微服务治理,帮助开发者快速上手,Istio 的学习曲线也极大降低。其中,灰度发布策略为用户在不影响微服务之间通信的情况下测试和发布新的应用版本发挥了重要作用。 + +安装“KubeSphere 服务网格”扩展组件后,项⽬左侧导航栏将显⽰**服务网格**选项,支持创建自制应用、管理自制应用的灰度发布。 + +// ⾃制应⽤详情⻚⾯将显⽰**流量监控**、**灰度发布**和**链路追踪**⻚签。在创建自制应用时,启用应用治理可使用流量监控、灰度发布和链接追踪功能。 + +[.admon.attention,cols="a"] +|=== +|注意 + +| +安装 KubeSphere 服务网格前,需要在扩展组件配置中设置可用的 Prometheus 服务和 OpenSearch 服务。有关组件配置的更多信息,请参阅扩展中心“KubeSphere 服务网格”扩展组件的详情页说明。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/00-web-console/01-log-in-and-go-to-a-project.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/00-web-console/01-log-in-and-go-to-a-project.adoc new file mode 100644 index 000000000..4116fa9f2 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/00-web-console/01-log-in-and-go-to-a-project.adoc @@ -0,0 +1,40 @@ +--- +title: "登录并进入联邦项目" +keywords: "Kubernetes, {ks_product}, 项目管理, Web 控制台, 联邦项目" +description: "介绍如何登录并进入联邦项目。" +weight: 01 +--- + + + +本节介绍如何登录{ks_product_left} Web 控制台并进入联邦项目。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* 您需要获取联邦项目成员用户名和密码。 + +include::../../../../_custom/workspaceManagement/webConsole/webConsole-prer-logIn.adoc[] + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/webConsole/webConsole-oper-logIn.adoc[] ++ +-- +[.admon.note,cols="a"] +|=== +|说明 + +| +include::../../../../_custom/workspaceManagement/webConsole/webConsole-note-firstLogin.adoc[] +|=== +-- + +. 点击**企业空间管理**,然后点击一个企业空间的名称进入企业空间。 + +. 在左侧导航栏选择**项目**,然后点击**联邦项目**进入联邦项目列表页面。 + +. 在**联邦项目**页面,点击一个联邦项目的名称进入联邦项目。 diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/00-web-console/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/00-web-console/_index.adoc new file mode 100644 index 000000000..94809cb09 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/00-web-console/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "Web 控制台" +keywords: "Kubernetes, {ks_product}, 联邦项目, Web 控制台" +description: "介绍如何进入联邦项目。" +weight: 01 +layout: "second" +--- + + + +本节介绍如何登录{ks_product_left} Web 控制台并进入联邦项目。 diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/01-create-a-project.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/01-create-a-project.adoc new file mode 100644 index 000000000..9d650644f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/01-create-a-project.adoc @@ -0,0 +1,57 @@ +--- +title: "创建联邦项目" +keywords: "Kuberentes, {ks_product}, 企业空间管理, 联邦项目, 创建联邦项目" +description: "介绍如何创建联邦项目。" +weight: 01 +--- + + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目 > 联邦项目** + + +本节介绍如何创建联邦项目。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在弹出的对话框,设置项目的参数,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../_custom/clusterManagement/projects/projects-para-name.adoc[] + +include::../../../../_custom/clusterManagement/projects/projects-para-aliasDescription.adoc[] + +|集群 +|可供项目使用的集群。项目中的资源运行在此处选择的集群中。创建联邦项目时,可点击**添加**选择多个集群从而使项目中的资源运行不同的集群中。 +|=== + +项目创建完成后,您可以邀请用户加入项目并在项目中部署业务。 + +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/02-view-a-project-list.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/02-view-a-project-list.adoc new file mode 100644 index 000000000..85d0a36ef --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/02-view-a-project-list.adoc @@ -0,0 +1,69 @@ +--- +title: "查看联邦项目列表" +keywords: "Kuberentes, {ks_product}, 企业空间管理, 联邦项目, 介绍如何查看项目列表" +description: "介绍如何查看项目列表。" +weight: 02 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **项目 > 联邦项目** + + +include::../../../../_custom/workspaceManagement/projects/projects-desc-viewProjectList.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ +==== +* 项目列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|项目的名称和描述信息。 + +|状态 +|项目当前所处的状态。 + +* **活跃**:项目状态正常。 +* **删除中**:项目正在删除中。 + +|集群 +|可供项目使用的集群。 + +|创建时间 +|项目的创建时间。 +|=== +-- + +include::../../../../_custom/workspaceManagement/projects/projects-oper-searchForProjects.adoc[] + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] + + +* 在列表中点击一个项目的名称可打开项目管理页面。您可以在项目管理页面查看和管理项目中的资源。 + +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/03-edit-project-information.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/03-edit-project-information.adoc new file mode 100644 index 000000000..4766f1e9f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/03-edit-project-information.adoc @@ -0,0 +1,40 @@ +--- +title: "编辑联邦项目信息" +keywords: "Kuberentes, {ks_product}, 企业空间管理, 联邦项目, 编辑项目信息" +description: "介绍如何编辑项目信息。" +weight: 03 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目 > 联邦项目** + + +include::../../../../_custom/clusterManagement/projects/projects-desc-editInformation.adoc[] + +include::../../../../_custom/clusterManagement/projects/projects-note-editInformation.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ +// * 如需编辑联邦项目信息,您需要确保企业空间中存在联邦项目。 + + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/projects/projects-oper-editInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/04-edit-project-annotations.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/04-edit-project-annotations.adoc new file mode 100644 index 000000000..2870d1c16 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/04-edit-project-annotations.adoc @@ -0,0 +1,48 @@ +--- +title: "编辑联邦项目注解" +keywords: "Kuberentes, {ks_product}, 企业空间管理, 联邦项目, 编辑项目注解" +description: "介绍如何编辑项目注解。" +weight: 04 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目 > 联邦项目** + + +本节介绍如何编辑项目注解。 + +项目注解是为项目添加额外的元数据或描述性信息的键值对。 + + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + + +. 在需要操作的项目右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑注解**。 + +. 在**编辑注解**对话框,设置注解键值对,然后点击**确定**。 ++ +-- +* 点击**添加**可设置多条注解。 + +* 在已创建的注解右侧点击image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18]可删除注解。 +-- + diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/05-add-a-cluster.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/05-add-a-cluster.adoc new file mode 100644 index 000000000..b4a180d13 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/05-add-a-cluster.adoc @@ -0,0 +1,59 @@ +--- +title: "为联邦项目添加集群" +keywords: "Kuberentes, {ks_product}, 企业空间管理, 联邦项目, 为联邦项目添加集群" +description: "介绍如何为联邦项目添加集群。" +weight: 05 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目 > 联邦项目** + + +本节介绍如何为联邦项目添加集群。 + +联邦项目是基于多个集群创建的项目。联邦项目中的资源可运行在不同集群上。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +ifeval::["{file_output_type}" == "html"] +若要联邦项目运行在多个集群上,联邦项目所属的企业空间必须获得多个集群的授权。有关更多信息,请参阅link:../../../../08-workspace-management/02-workspaces/01-create-a-workspace[创建企业空间]。 + +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +若要联邦项目运行在多个集群上,联邦项目所属的企业空间必须获得多个集群的授权。有关更多信息,请参阅《{ks_product_right}企业空间管理指南》的“创建企业空间”章节。 + +endif::[] +|=== + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + +. 在需要操作的项目右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**添加集群**。 + +. 在**添加集群**对话框,从下拉列表中选择集群,然后点击**确定**。 ++ +-- +* 点击**添加**可添加多个集群。 + +* 在已添加的集群右侧点击image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18]可取消添加该集群。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/06-delete-projects.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/06-delete-projects.adoc new file mode 100644 index 000000000..a9c564f89 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/06-delete-projects.adoc @@ -0,0 +1,49 @@ +--- +title: "删除联邦项目" +keywords: "Kuberentes, {ks_product}, 企业空间管理, 联邦项目, 删除项目" +description: "介绍如何编辑删除项目。" +weight: 06 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目 > 联邦项目** + + +include::../../../../_custom/clusterManagement/projects/projects-desc-deleteProjects.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + + +== 删除单个项目 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/projects/projects-oper-deleteASingleProject.adoc[] + + +== 批量删除项目 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/projects/projects-oper-deleteMultipleProjects.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/_index.adoc new file mode 100644 index 000000000..b849623b5 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/01-manage-multi-project/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "管理联邦项目" +keywords: "Kuberentes, {ks_product}, 企业空间管理, 联邦项目" +description: "介绍如何查看联邦项目信息以及管理联邦项目。" +weight: 01.5 +layout: "second" +--- + + + +本节介绍如何管理联邦项目。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/02-overview/01-view-project-overall-information.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/02-overview/01-view-project-overall-information.adoc new file mode 100644 index 000000000..4e7dc0570 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/02-overview/01-view-project-overall-information.adoc @@ -0,0 +1,54 @@ +--- +title: "查看联邦项目概览信息" +keywords: "Kubernetes, {ks_product}, 联邦项目, 概览, 查看联邦项目概览信息" +description: "介绍如何查看联邦项目概览信息。" +weight: 01 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **概览** + + +本节介绍如何查看联邦项目概览信息。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] ++ +-- +**概览**页面提供以下信息: + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|企业空间 +|联邦项目所属的企业空间。 + +|创建者 +|创建联邦项目的用户。 + +|资源状态 +|联邦项目中已创建的应用资源和已使用的物理资源。在右上角点击下拉列表可选择联邦项目所在的某一集群和数据的时间范围。 + +* **应用资源**:联邦项目中已创建的部署、有状态副本集、持久卷声明、服务和应用路由的数量。 + +* **物理资源**:联邦项目的 CPU 和内存使用量。 + +|资源用量 Top 5 +|联邦项目中特定资源用量最高的 5 个工作负载。点击下拉列表可选择联邦项目所在的某一集群,并按 CPU、内存、出站流量或入站流量排序。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/02-overview/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/02-overview/_index.adoc new file mode 100644 index 000000000..354a1095d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/02-overview/_index.adoc @@ -0,0 +1,9 @@ +--- +title: "概览" +keywords: "Kubernetes, {ks_product}, 联邦项目, 概览" +description: "介绍如何查看联邦项目概览信息。" +weight: 02 +layout: "second" +--- + + diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/01-compose-an-app.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/01-compose-an-app.adoc new file mode 100644 index 000000000..e25e39b6e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/01-compose-an-app.adoc @@ -0,0 +1,67 @@ +--- +title: "创建自制应用" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用, 创建应用" +description: "介绍如何在联邦项目中创建应用。" +weight: 01 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 自制应用** + + +本节介绍如何在联邦项目中创建自制应用。 + +include::../../../../../_custom/projectManagement/apps/apps-compose-description.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* 如需为应⽤启⽤应⽤治理功能,{ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**应用**页面,点击**创建**。 + +. 在**基本信息**页签,设置应用的基本信息,然后点击**下一步**。 ++ +-- +include::../../../../../_custom/projectManagement/apps/apps-basic-para.adoc[] +-- + +. 在**服务设置**页签,点击**创建服务**,选择**有状态服务**或**无状态服务**为应用创建服务,然后点击**下一步**。 ++ +-- +include::../../../../../_custom/clusterManagement/services/services-para-statelessStatefulExternal.adoc[] + +[.admon.note,cols="a"] +|=== +|说明 + +| +有关更多信息,请参阅link:../../02-services/01-create-a-stateful-or-stateless-service[创建有状态或无状态服务]。 +|=== +-- + +. 在**路由设置**页签,点击**添加路由规则**为应用创建路由规则,然后点击**创建**。 ++ +-- +include::../../../../../_custom/multi-clusterProjectManagement/routes/routes-create-ClusterDiff.adoc[] + +include::../../../../../_custom/clusterManagement/routes/routes-para-routingRules.adoc[] + +应用创建完成后将显示在应用列表页面。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/02-view-an-app-list.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/02-view-an-app-list.adoc new file mode 100644 index 000000000..bf7a97343 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/02-view-an-app-list.adoc @@ -0,0 +1,73 @@ +--- +title: "查看自制应用列表" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用, 查看应用列表" +description: "介绍如何在联邦项目中查看应用列表。" +weight: 02 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **应用负载 > 自制应用** + + +本节介绍如何在联邦项目中查看应用列表。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**应用**页面,查看当前联邦项目中已创建的应用列表。 ++ +==== +* 应用列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|应用的名称。 + +|状态 +|联邦应用当前的状态。 + +* **等待中**:系统正在创建应用。 + +* **运行中**:应用运行正常。 + +* **更新中**:系统正在更新应用版本。 + +* **删除中**:系统正在删除应用。 + +* **失败**:应用创建失败。 + + +|版本 +|应用的版本号。对于自制应用,显示用户自定义的版本号。 + +|创建时间 +|应用的创建时间。 +|=== +-- + +* 在列表上方点击搜索框并输入关键字,可按名称搜索应用。 + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/03-view-app-details.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/03-view-app-details.adoc new file mode 100644 index 000000000..1590f3e59 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/03-view-app-details.adoc @@ -0,0 +1,82 @@ +--- +title: "查看自制应用详情" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用, 查看应用详情" +description: "介绍如何在联邦项目中查看应用详情。" +weight: 03 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **应用负载 > 自制应用** + + +本节介绍如何在联邦项目中查看应用详情。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**应用**页面,点击一个应用的名称打开其详情页面。 + +. 在应用详情页面左侧的**属性**区域查看应用的资源属性。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/multi-clusterProjectManagement/apps/apps-para-details.adoc[] + +|=== +-- + ++ + +include::../../../../../_custom/multi-clusterProjectManagement/apps/apps-oper-viewResourceStatus.adoc[] + ++ + +. 在应用详情页面右侧点击**外部访问**查看应用的外部访问模式。 + +. 在应用详情页面右侧点击**流量管理**查看应用的流量信息。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +* 在**集群**区域,可选择应用所在的某一集群,查看指定集群的应用流量信息。 + +* 如需使用**流量监控**功能,{ks_product_right}平台需要安装并启用 KubeSphere 服务网格扩展组件,同时您需要在创建应用时启用应用治理功能。有关更多信息,请参阅link:../01-compose-an-app/[创建自制应用]。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +. 在应用详情页面右侧点击**链路追踪**查看应用请求链路信息。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +* 在**集群**区域,可选择应用所在的某一集群,查看指定集群的应用请求链路信息。 + +* 如需使用**链路追踪**功能,{ks_product_right}平台需要安装并启用 KubeSphere 服务网格扩展组件,同时您需要进行以下操作: + +** 创建应用时启用应用治理功能。有关更多信息,请参阅link:../01-compose-an-app/[创建自制应用]。 + +** 启用项目网关,并为项目网关启用链路追踪功能。有关更多信息,请参阅link:../../../../12-gateway/01-project-gateway/01-enable-a-project-gateway[启用项目网关]。 +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/04-delete-apps.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/04-delete-apps.adoc new file mode 100644 index 000000000..e73b3d0b3 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/04-delete-apps.adoc @@ -0,0 +1,44 @@ +--- +title: "删除自制应用" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用, 删除应用" +description: "介绍如何从联邦项目中删除应用。" +weight: 04 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 自制应用** + + +本节介绍如何从联邦项目中删除应用。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**应用**页面,找到需要删除的应用,点击右侧的 image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除应用**对话框,输入应用的名称,然后点击**确定**。 ++ +-- +// Warning +include::../../../../../../_ks_components/admonitions/warning.adoc[] + +应用删除后无法恢复,请谨慎执行此操作。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/_index.adoc new file mode 100644 index 000000000..622607b5d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/01-apps/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "自制应用" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用, 管理" +description: "介绍如何管理联邦项目中安装的自制应用。" +weight: 01 +layout: "second" +--- + + + +本节介绍如何管理联邦项目中安装的应用。联邦项目中仅支持创建自制应用,不支持创建基于模板的应用。 + +include::../../../../../_custom/projectManagement/apps/apps-types.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/01-create-a-stateful-or-stateless-service.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/01-create-a-stateful-or-stateless-service.adoc new file mode 100644 index 000000000..670ef0460 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/01-create-a-stateful-or-stateless-service.adoc @@ -0,0 +1,299 @@ +--- +title: "创建有状态或无状态服务" +keywords: "Kubernetes, {ks_product}, 联邦项目, 工作负载, 服务, 创建服务, 创建有状态或无状态服务" +description: "介绍如何创建有状态或无状态服务。" +weight: 01 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 服务** + + +本节介绍如何在联邦项目中创建有状态或无状态服务。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +请参阅link:#_参数描述[参数描述]设置服务的参数。 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**创建服务**对话框,根据需要选择**有状态服务**或**无状态服务**。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +include::../../../../../_custom/clusterManagement/services/services-para-statelessStatefulExternal.adoc[] + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + ++ + +include::../../../../../_custom/projectManagement/services/services-oper-setBasicInformation.adoc[] + ++ + +. 在**容器组设置**页签,为服务后端工作负载管理的容器组设置集群中的副本数量、容器、更新策略、安全上下文、调度规则和元数据,然后点击**下一步**。 + ++ + +include::../../../../../_custom/multi-clusterProjectManagement/services/services-oper-setStorageAdvancedDiff.adoc[] + + +== 参数描述 + +以下介绍如何设置有状态服务和无状态服务的参数。 + +* 基本信息 ++ +-- +include::../../../../../_custom/projectManagement/services/services-para-setServiceInformation.adoc[] + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/clusterManagement/services/services-para-serviceName.adoc[] + +include::../../../../../_custom/clusterManagement/services/services-para-serviceAlias.adoc[] + +include::../../../../../_custom/projectManagement/services/services-para-serviceVersion.adoc[] + +include::../../../../../_custom/clusterManagement/services/services-para-serviceDescription.adoc[] +|=== +-- + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podReplicas.adoc[] + +* 容器组设置 > 添加容器 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addContainer.adoc[] +-- + +* 容器组设置 > 添加容器 > 容器设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-setImageNameTypeResource.adoc[] + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerImage.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerName.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerType.adoc[] + +include::../../../../../_custom/clusterManagement/projects/projects-para-containerQuotas.adoc[] +|=== +-- + +* 容器组设置 > 添加容器 > 端口设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-Port.adoc[] +-- + +* 容器组设置 > 添加容器 > 镜像拉取策略 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-imagePullPolicy.adoc[] +-- + +* 容器组设置 > 添加容器 > 健康检查 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-healthCheck.adoc[] +-- + +* 容器组设置 > 添加容器 > 健康检查 > 添加探针 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addProbe.adoc[] +-- + +* 容器组设置 > 添加容器 > 生命周期管理 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-lifecycleManagement.adoc[] +-- + +* 容器组设置 > 添加容器 > 生命周期管理 > 添加动作 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addAction.adoc[] +-- + +* 容器组设置 > 添加容器 > 启动命令 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-startCommand.adoc[] +-- + +* 容器组设置 > 添加容器 > 环境变量 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-environmentVariables.adoc[] +-- + +* 容器组设置 > 添加容器 > 容器组安全上下文 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerSecurityContext.adoc[] +-- + +* 容器组设置 > 添加容器 > 同步主机时区 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-syncTimeZone.adoc[] +-- + +* 容器组设置 > 更新策略 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-updatePolicy.adoc[] +-- + +* 容器组设置 > 更新策略 > 滚动更新设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-rollingUpdate.adoc[] +-- + +* 容器组设置 > 容器组安全上下文 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podSecurityContext.adoc[] +-- + +* 容器组设置 > 容器组调度规则 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podSchedulingRules.adoc[] +-- + +* 容器组设置 > 容器组调度规则 > 自定义规则 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-customRules.adoc[] +-- + +* 容器组设置 > 容器组优雅终止 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-PodGracePeriod.adoc[] +-- + +* 容器组设置 > 添加元数据 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-PodMetadata.adoc[] +-- + +* 存储设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-mountVolume.adoc[] + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +// include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-collectLogsOnVolume.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addPVCTemplate.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountVolume.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountSecretOrConfigmap.adoc[] +|=== + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-oper-editDeleteVolume.adoc[] +-- + +* 存储设置 > 添加持久卷声明模板 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-volumeTemplate.adoc[] +-- + +* 存储设置 > 挂载卷 > 持久卷 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-persistentVolume.adoc[] +-- + +* 存储设置 > 挂载卷 > 临时卷 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-temporaryVolume.adoc[] +-- + +* 存储设置 > 挂载卷 > HostPath 卷 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-hostpathVolume.adoc[] +-- + +* 存储设置 > 挂载配置字典或保密字典 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountConfigmapSecret.adoc[] +-- + +* 高级设置 ++ +-- +// include::../../../../../_custom/projectManagement/services/services-desc-setLabelsAnnotations.adoc[] + +为服务后端工作负载管理的容器组指定节点,设置服务的外部访问模式、会话保持设置和元数据。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +// include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podIpPool.adoc[] + +include::../../../../../_custom/clusterManagement/services/services-para-externalAccess.adoc[] + +include::../../../../../_custom/clusterManagement/services/services-para-sessionPersistence.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-selectNode.adoc[] + +|添加元数据 +| +include::../../../../../_custom/projectManagement/services/services-desc-setServiceLabelWorkloadAnnotation.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-Metadata.adoc[] +|=== +-- + +* 集群差异设置 ++ +-- +为不同集群中的服务基于容器、端口和环境变量进行差异化设置。 + +include::../../../../../_custom/multi-clusterProjectManagement/services/services-oper-setClusterDiff.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/02-view-a-service-list.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/02-view-a-service-list.adoc new file mode 100644 index 000000000..60e3a54d5 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/02-view-a-service-list.adoc @@ -0,0 +1,74 @@ +--- +title: "查看服务列表" +keywords: "Kubernetes, {ks_product}, 项目管理, 工作负载, 服务, 查看服务列表" +description: "介绍如何查看服务列表。" +weight: 02 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **应用负载 > 服务** + + +include::../../../../../_custom/clusterManagement/services/services-desc-viewServiceList.adoc[] + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +* 服务列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/clusterManagement/services/services-para-name.adoc[] + +|状态 +|服务的状态,**运行中**或**删除中**。 + +|服务类型 +|服务的类型。取决于服务的创建方式,{ks_product_right}将服务划分为以下类型: + +include::../../../../../_custom/clusterManagement/services/services-para-statelessStatefulExternal.adoc[] + +// * **外部服务**:服务将业务流量转发给集群外部的其他服务。系统不为服务分配虚拟 IP 地址,可通过 .**.svc.cluster.local** 格式的域名从集群内部访问。 + +// * **自定义服务**:用户通过自定义服务的内部访问模式和后端工作负载创建的服务。 + +|应用 +|服务所属的应用。 + +// |内部访问 +// | +// include::../../../../../_custom/clusterManagement/services/services-para-internalAccess.adoc[] + +// include::../../../../../_custom/clusterManagement/services/services-para-virtualip-headless.adoc[] + +// include::../../../../../_custom/clusterManagement/services/services-para-externalName.adoc[] + +// include::../../../../../_custom/clusterManagement/services/services-para-externalAccess.adoc[] + +include::../../../../../_custom/clusterManagement/services/services-para-creationTime.adoc[] +|=== +-- + +include::../../../../../_custom/clusterManagement/services/services-oper-searchForServices.adoc[] + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/03-view-service-details.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/03-view-service-details.adoc new file mode 100644 index 000000000..eeff71bc7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/03-view-service-details.adoc @@ -0,0 +1,37 @@ +--- +title: "查看服务详情" +keywords: "Kubernetes, {ks_product}, 项目管理, 工作负载, 服务, 查看服务详情" +description: "介绍如何查看服务详情。" +weight: 03 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **应用负载 > 服务** + + +include::../../../../../_custom/clusterManagement/services/services-desc-viewServiceDetails.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/services/services-oper-openDetailsPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/services/services-oper-viewServiceDetails-for-kubefed.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/04-edit-service-information.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/04-edit-service-information.adoc new file mode 100644 index 000000000..d061f4d1d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/04-edit-service-information.adoc @@ -0,0 +1,33 @@ +--- +title: "编辑服务信息" +keywords: "Kubernetes, {ks_product}, 项目管理, 工作负载, 服务, 编辑服务信息" +description: "介绍如何编辑服务信息。" +weight: 04 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 服务** + + +include::../../../../../_custom/clusterManagement/services/services-desc-editServiceInformation.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/services/services-oper-editServiceInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/05-edit-service-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/05-edit-service-settings.adoc new file mode 100644 index 000000000..9ac141774 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/05-edit-service-settings.adoc @@ -0,0 +1,33 @@ +--- +title: "编辑服务设置" +keywords: "Kubernetes, {ks_product}, 项目管理, 工作负载, 服务, 编辑服务设置" +description: "介绍如何编辑服务设置。" +weight: 05 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 服务** + + +include::../../../../../_custom/clusterManagement/services/services-desc-editServiceSettings.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/services/services-oper-editServiceSettings-for-kubefed.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/06-edit-service-external-access-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/06-edit-service-external-access-settings.adoc new file mode 100644 index 000000000..d749d3c83 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/06-edit-service-external-access-settings.adoc @@ -0,0 +1,41 @@ +--- +title: "编辑服务外部访问设置" +keywords: "Kubernetes, {ks_product}, 项目管理, 工作负载, 服务, 编辑服务外部访问设置" +description: "介绍如何编辑服务外部访问设置。" +weight: 06 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 服务** + + +include::../../../../../_custom/clusterManagement/services/services-desc-editServiceExternalAccessSettings.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/services/services-oper-openDetailsPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/services/services-oper-openServiceExternalAccessSettings.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/services/services-oper-editServiceExternalAccessSettings.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/07-delete-services.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/07-delete-services.adoc new file mode 100644 index 000000000..0978b10ad --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/07-delete-services.adoc @@ -0,0 +1,50 @@ +--- +title: "删除服务" +keywords: "Kubernetes, {ks_product}, 项目管理, 工作负载, 服务, 删除服务" +description: "介绍如何编辑服务外部访问设置。" +weight: 07 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 服务** + + +include::../../../../../_custom/clusterManagement/services/services-desc-deleteServices.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 删除单个服务 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/services/services-oper-deleteASingleService.adoc[] + ++ + +. 在**删除服务**对话框,选择需要同时删除的工作负载,然后点击**确定**。 + + +== 批量删除服务 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/services/services-oper-deleteMultipleServices.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/_index.adoc new file mode 100644 index 000000000..b1b5d9f13 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/02-services/_index.adoc @@ -0,0 +1,10 @@ +--- +title: "服务" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 服务" +description: "介绍如何管理联邦项目中的服务。" +weight: 02 +layout: "second" +--- + + +include::../../../../../_custom/clusterManagement/services/services-desc-services.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/01-create-a-workload.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/01-create-a-workload.adoc new file mode 100644 index 000000000..be52f122e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/01-create-a-workload.adoc @@ -0,0 +1,290 @@ +--- +title: "创建工作负载" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 工作负载, 创建工作负载" +description: "介绍如何创建工作负载。" +weight: 01 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 工作负载** + +:kubefed: + +include::../../../../../_custom/clusterManagement/workloads/workloads-desc-createAWorkload.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +请参阅link:#_参数描述[参数描述]设置工作负载的参数。 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-openListPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-createAWorkload-ClusterDiff.adoc[] + + +== 参数描述 + +以下介绍如何设置工作负载的参数。 + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-basicInformation.adoc[] + + +* 容器组设置 > 副本调度模式 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|指定副本数量 +|手动设置每个集群的容器组副本数。 + +点击image:/images/ks-qkcp/zh/icons/add-light.svg[add,18,18]/image:/images/ks-qkcp/zh/icons/substract-light.svg[subtract,18,18]增加/减少容器组副本的数量,最小值为 **1**。 + +|指定权重 +|设置容器组副本总数和每个集群的权重。容器组副本将根据权重比例调度到每个集群。 + +点击image:/images/ks-qkcp/zh/icons/add-light.svg[add,18,18]/image:/images/ks-qkcp/zh/icons/substract-light.svg[subtract,18,18]增加/减少集群的权重,最小值为 **1**。 + +例如:如果容器组副本总数是 10,host 和 member 集群的权重分别为 3 和 2,那么 host 集群的容器组副本数为 6,member 集群的容器组副本数为 4。 +|=== +-- + +// include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podReplicas.adoc[] + +* 容器组设置 > 添加容器 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addContainer.adoc[] +-- + +* 容器组设置 > 添加容器 > 容器设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-setImageNameTypeResource.adoc[] + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerImage.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerName.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerType.adoc[] + +include::../../../../../_custom/clusterManagement/projects/projects-para-containerQuotas.adoc[] +|=== +-- + +* 容器组设置 > 添加容器 > 端口设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-Port.adoc[] +-- + +* 容器组设置 > 添加容器 > 镜像拉取策略 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-imagePullPolicy.adoc[] +-- + +* 容器组设置 > 添加容器 > 健康检查 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-healthCheck.adoc[] +-- + +* 容器组设置 > 添加容器 > 健康检查 > 添加探针 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addProbe.adoc[] +-- + +* 容器组设置 > 添加容器 > 生命周期管理 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-lifecycleManagement.adoc[] +-- + +* 容器组设置 > 添加容器 > 生命周期管理 > 添加动作 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addAction.adoc[] +-- + +* 容器组设置 > 添加容器 > 启动命令 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-startCommand.adoc[] +-- + +* 容器组设置 > 添加容器 > 环境变量 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-environmentVariables.adoc[] +-- + +* 容器组设置 > 添加容器 > 容器组安全上下文 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerSecurityContext.adoc[] +-- + +* 容器组设置 > 添加容器 > 同步主机时区 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-syncTimeZone.adoc[] +-- + +* 容器组设置 > 更新策略 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-updatePolicy.adoc[] +-- + +* 容器组设置 > 更新策略 > 滚动更新设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-rollingUpdate.adoc[] +-- + +* 容器组设置 > 容器组安全上下文 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podSecurityContext.adoc[] +-- + +* 容器组设置 > 容器组调度规则 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podSchedulingRules.adoc[] +-- + +* 容器组设置 > 容器组调度规则 > 自定义规则 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-customRules.adoc[] +-- + +* 容器组设置 > 容器组优雅终止 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-PodGracePeriod.adoc[] +-- + +* 容器组设置 > 添加元数据 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-PodMetadata.adoc[] +-- + +* 存储设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-mountVolume.adoc[] + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +// include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-collectLogsOnVolume.adoc[] + +// include::../../../../../_custom/projectManagement/workloads/workloads-desc-enableLogCollectionProject.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addPVCTemplate.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountVolume.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountSecretOrConfigmap.adoc[] +|=== + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-oper-editDeleteVolume.adoc[] +-- + +* 存储设置 > 添加持久卷声明模板 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-volumeTemplate.adoc[] +-- + +* 存储设置 > 挂载卷 > 持久卷 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-persistentVolume.adoc[] +-- + +* 存储设置 > 挂载卷 > 临时卷 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-temporaryVolume.adoc[] +-- + +* 存储设置 > 挂载卷 > HostPath 卷 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-hostpathVolume.adoc[] +-- + +* 存储设置 > 挂载配置字典或保密字典 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountConfigmapSecret.adoc[] +-- + +* 高级设置 ++ +-- +为工作负载管理的容器组指定节点,并设置工作负载的元数据。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +// include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podIpPool.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-selectNode.adoc[] + +|添加元数据 +| +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-setWorkloadMetadata.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-Metadata.adoc[] +|=== +-- + +* 集群差异设置 ++ +-- +为不同集群中的工作负载基于容器、端口和环境变量进行差异化设置。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/multi-clusterProjectManagement/workloads/workloads-oper-setClusterDiff.adoc[] + +|=== +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/02-view-a-workload-list.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/02-view-a-workload-list.adoc new file mode 100644 index 000000000..f6653fc37 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/02-view-a-workload-list.adoc @@ -0,0 +1,43 @@ +--- +title: "查看工作负载列表" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 工作负载, 查看工作负载列表" +description: "介绍如何查看工作负载列表。" +weight: 02 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **应用负载 > 工作负载** + + +include::../../../../../_custom/clusterManagement/workloads/workloads-desc-viewAWorkloadList.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-openListPage.adoc[] ++ +==== +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-multi-project-para-workloadList.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-searchForWorkloads.adoc[] + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/03-view-workload-details.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/03-view-workload-details.adoc new file mode 100644 index 000000000..2f44a29e8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/03-view-workload-details.adoc @@ -0,0 +1,41 @@ +--- +title: "查看工作负载详情" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 工作负载, 查看工作负载详情" +description: "介绍如何查看工作负载详情。" +weight: 03 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **应用负载 > 工作负载** + + +include::../../../../../_custom/clusterManagement/workloads/workloads-desc-viewWorkloadDetails.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/multi-clusterProjectManagement/workloads/workloads-oper-openDetailsPage.adoc[] + ++ + +include::../../../../../_custom/multi-clusterProjectManagement/workloads/workloads-oper-viewWorkloadDetails_v4.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/04-edit-workload-information.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/04-edit-workload-information.adoc new file mode 100644 index 000000000..a0aed4b95 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/04-edit-workload-information.adoc @@ -0,0 +1,37 @@ +--- +title: "编辑工作负载信息" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 工作负载, 编辑工作负载信息" +description: "介绍如何编辑工作负载信息。" +weight: 04 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 工作负载** + + +include::../../../../../_custom/clusterManagement/workloads/workloads-desc-editWorkloadInformation.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-oper-editWorkloadInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/05-adjust-the-number-of-pod-replicas.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/05-adjust-the-number-of-pod-replicas.adoc new file mode 100644 index 000000000..826ea548a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/05-adjust-the-number-of-pod-replicas.adoc @@ -0,0 +1,40 @@ +--- +title: "调整容器组副本数量" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 工作负载, 调整容器组副本数量" +description: "介绍如何调整容器组副本数量。" +weight: 05 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 工作负载** + + +include::../../../../../_custom/clusterManagement/workloads/workloads-desc-adjustTheNumberOfPodReplicas.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/multi-clusterProjectManagement/workloads/workloads-oper-openDetailsPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-oper-adjustTheNumberOfPodReplicas.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/06-stop-workloads.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/06-stop-workloads.adoc new file mode 100644 index 000000000..89292a8d1 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/06-stop-workloads.adoc @@ -0,0 +1,37 @@ +--- +title: "停止工作负载" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 工作负载, 停止工作负载" +description: "介绍如何停止工作负载。" +weight: 06 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 工作负载** + + +include::../../../../../_custom/clusterManagement/workloads/workloads-desc-stopWorkloads.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-oper-stopWorkloads.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/07-edit-workload-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/07-edit-workload-settings.adoc new file mode 100644 index 000000000..8a4c0545b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/07-edit-workload-settings.adoc @@ -0,0 +1,225 @@ +--- +title: "编辑工作负载设置" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 工作负载, 编辑工作负载设置" +description: "介绍如何编辑工作负载设置。" +weight: 07 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 工作负载** + + +include::../../../../../_custom/clusterManagement/workloads/workloads-desc-editWorkloadSettings.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/multi-clusterProjectManagement/workloads/workloads-oper-openDetailsPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-oper-editWorkloadSettings.adoc[] + ++ + +. 在**编辑设置**对话框,分别设置工作负载的更新策略、容器、存储、容器组调度规则(仅对部署可用)、容器组优雅终止、以及集群差异设置,然后点击**确定**。有关具体的参数设置方法,请参阅link:#_参数描述[参数描述]。 + +== 参数描述 + +* 更新策略 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-updatePolicy.adoc[] +-- + +* 更新策略 > 滚动更新设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-rollingUpdate.adoc[] +-- + +* 容器 > 添加容器 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addContainer.adoc[] +-- + +* 容器 > 添加容器 > 容器设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-setImageNameTypeResource.adoc[] + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerImage.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerName.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerType.adoc[] + +include::../../../../../_custom/clusterManagement/projects/projects-para-containerQuotas.adoc[] +|=== +-- + +* 容器 > 添加容器 > 端口设置 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-Port.adoc[] +-- + +* 容器 > 添加容器 > 镜像拉取策略 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-imagePullPolicy.adoc[] +-- + +* 容器 > 添加容器 > 健康检查 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-healthCheck.adoc[] +-- + +* 容器 > 添加容器 > 生命周期管理 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-lifecycleManagement.adoc[] +-- +* 容器 > 添加容器 > 生命周期管理 > 添加动作 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addAction.adoc[] +-- +* 容器 > 添加容器 > 启动命令 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-startCommand.adoc[] +-- + +* 容器 > 添加容器 > 环境变量 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-environmentVariables.adoc[] +-- + +* 容器 > 添加容器 > 容器安全上下文 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerSecurityContext.adoc[] +-- + +* 容器 > 添加容器 > 同步主机时区 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-syncTimeZone.adoc[] +-- + +* 存储 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-mountVolume.adoc[] + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +// include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-collectLogsOnVolume.adoc[] + + +// :relfileprefix: ../../../../../ + +// include::../../../../../_custom/projectManagement/workloads/workloads-desc-enableLogCollectionProject.adoc[] + +// :relfileprefix: ./ + + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountVolume.adoc[] + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountSecretOrConfigmap.adoc[] +|=== + +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-oper-editDeleteVolume_new.adoc[] +-- + +* 存储 > 挂载卷 > 持久卷 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-persistentVolume.adoc[] +-- + +* 存储 > 挂载卷 > 临时卷 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-temporaryVolume.adoc[] +-- + +* 存储 > 挂载卷 > HostPath 卷 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-hostpathVolume.adoc[] +-- + +* 存储 > 挂载配置字典或保密字典 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountConfigmapSecret.adoc[] +-- + +* 容器组调度规则(仅对部署可用) ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podSchedulingRules.adoc[] +-- + +* 容器组调度规则 > 自定义规则 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-customRules.adoc[] +-- + +* 容器组优雅终止 ++ +-- +include::../../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-PodGracePeriod.adoc[] +-- + +// * 容器组 IP 池 +// + +// -- +// 选择后将为容器组分配 IP 地址。 +// -- + +* 集群差异设置 ++ +-- +在**集群**区域,勾选项目所在的一个或多个集群,为指定集群中的工作负载基于容器、端口和环境变量进行差异化设置。 + +[%header, cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/multi-clusterProjectManagement/workloads/workloads-oper-setClusterDiff.adoc[] + +|=== +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/08-delete-workloads.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/08-delete-workloads.adoc new file mode 100644 index 000000000..15f54224a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/08-delete-workloads.adoc @@ -0,0 +1,59 @@ +--- +title: "删除工作负载" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 工作负载, 删除工作负载" +description: "介绍如何删除工作负载。" +weight: 08 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 工作负载** + + +include::../../../../../_custom/clusterManagement/workloads/workloads-desc-deleteWorkloads.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 删除单个工作负载 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-oper-deleteASingleWorkload.adoc[] + ++ + +. 在**删除工作负载**对话框,选择需要同时删除的相关资源,然后点击**确定**。 + + + +== 批量删除工作负载 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-multi-project-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/workloads/workloads-oper-deleteMultipleWorkloads.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/_index.adoc new file mode 100644 index 000000000..640b996eb --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/03-workloads/_index.adoc @@ -0,0 +1,27 @@ +--- +title: "工作负载" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 工作负载" +description: "介绍如何管理联邦项目中的工作负载。" +weight: 03 +layout: "second" +--- + +// include::../../../../../_custom/clusterManagement/workloads/workloads-desc-workloads.adoc[] + +本节介绍如何管理工作负载。 + +在{ks_product_both}平台,应用程序运行在容器组中。为确保单个容器组出现故障时业务不会中断,通常需要为一个应用程序创建多个容器组副本。工作负载是用于管理容器组副本的资源,负责对一个应用程序的多个容器组副本进行管理,主要提供以下功能: + +* 根据用户设定的条件自动扩缩容器组副本数量。 + +* 根据用户指定的更新策略自动更新容器组。 + +* 将容器组回滚到以前的版本。 + +联邦项目支持以下工作负载类型: + +* 部署:用于管理无状态应用。部署管理的多个容器组副本共用一个卷。当容器组副本重新创建时,新容器组副本和旧容器组副本的名称不同。 + +* 有状态副本集:用于管理有状态应用。有状态副本集管理的多个容器副本可以分别使用独立的卷。每个容器组副本的名称具有固定的序号,当容器组副本重新创建时,新容器组副本和旧容器组副本名称相同。 + +// * 守护进程集:用于管理守护进程。守护进程集确保所有或特定的节点都运行一个容器组副本。当新节点添加到集群时,如果新节点符合容器组调度规则,守护进程集会自动在新节点上创建一个容器组副本。 diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/01-create-a-route.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/01-create-a-route.adoc new file mode 100644 index 000000000..0b3dc1670 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/01-create-a-route.adoc @@ -0,0 +1,41 @@ +--- +title: "创建应用路由" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 应用路由, 创建应用路由" +description: "介绍如何创建应用路由。" +weight: 01 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../../_custom/clusterManagement/routes/routes-desc-createARoute.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + +* 如需创建支持 HTTPS 协议的应用路由,您需要创建 **TLS 信息**类型的保密字典,保密字典中必须包含 Base64 编码的证书和私钥。有关更多信息,请参阅link:../../../05-configuration/01-secrets/01-create-a-secret/[创建保密字典]。 + +* 应用路由所属的项目中存在至少一个服务。有关更多信息,请参阅link:../../02-services/01-create-a-stateful-or-stateless-service/[创建有状态或无状态服务]。 + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/routes/routes-oper-createARoute.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/02-view-a-route-list.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/02-view-a-route-list.adoc new file mode 100644 index 000000000..c777075a8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/02-view-a-route-list.adoc @@ -0,0 +1,39 @@ +--- +title: "查看应用路由列表" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 应用路由, 查看应用路由列表" +description: "介绍如何查看应用路由列表。" +weight: 02 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../../_custom/clusterManagement/routes/routes-desc-viewARouteList.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +include::../../../../../_custom/multi-clusterProjectManagement/routes/routes-para-routeList.adoc[] + +include::../../../../../_custom/clusterManagement/routes/routes-oper-searchForRoutes.adoc[] + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/03-view-route-details.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/03-view-route-details.adoc new file mode 100644 index 000000000..f91904592 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/03-view-route-details.adoc @@ -0,0 +1,37 @@ +--- +title: "查看应用路由详情" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 应用路由, 查看应用路由详情" +description: "介绍如何查看应用路由详情。" +weight: 03 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../../_custom/clusterManagement/routes/routes-desc-viewRouteDetails.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/routes/routes-oper-openDetailsPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/routes/routes-oper-viewRouteDetails-for-kubefed.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/04-edit-route-information.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/04-edit-route-information.adoc new file mode 100644 index 000000000..2fb3114b6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/04-edit-route-information.adoc @@ -0,0 +1,33 @@ +--- +title: "编辑应用路由信息" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 应用路由, 编辑应用路由信息" +description: "介绍如何编辑应用路由信息。" +weight: 04 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../../_custom/clusterManagement/routes/routes-desc-editRouteInformation.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/routes/routes-oper-editRouteInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/05-edit-routing-rules.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/05-edit-routing-rules.adoc new file mode 100644 index 000000000..3ef297850 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/05-edit-routing-rules.adoc @@ -0,0 +1,32 @@ +--- +title: "编辑路由规则" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 应用路由, 编辑路由规则" +description: "介绍如何编辑路由规则。" +weight: 05 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../../_custom/clusterManagement/routes/routes-desc-editingRutingRules.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/routes/routes-oper-editRoutingRules.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/06-edit-route-annotations.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/06-edit-route-annotations.adoc new file mode 100644 index 000000000..e15829f4e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/06-edit-route-annotations.adoc @@ -0,0 +1,33 @@ +--- +title: "编辑应用路由注解" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 应用路由, 编辑应用路由注解" +description: "介绍如何应用路由注解。" +weight: 06 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../../_custom/clusterManagement/routes/routes-desc-editRouteAnnotations.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/routes/routes-oper-editRouteAnnotations.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/07-delete-routes.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/07-delete-routes.adoc new file mode 100644 index 000000000..2c71b6f85 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/07-delete-routes.adoc @@ -0,0 +1,45 @@ +--- +title: "删除应用路由" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 应用路由, 删除应用路由" +description: "介绍如何删除应用路由。" +weight: 07 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../../_custom/clusterManagement/routes/routes-desc-deleteMultipleRoutes.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + +== 删除单个应用路由 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/routes/routes-oper-deleteASingleRoute.adoc[] + + +== 批量删除应用路由 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/routes/routes-oper-deleteRoutes.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/_index.adoc new file mode 100644 index 000000000..a8edc4e05 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/04-routes/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "应用路由" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载, 应用路由" +description: "介绍如何管理联邦项目中的应用路由。" +weight: 04 +layout: "second" +--- + + + +include::../../../../../_custom/clusterManagement/routes/routes-desc-routes.adoc[] + +有关集群网关和项目网关的更多信息,请参阅 link:../../../12-gateway/[KubeSphere 网关]。 diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/_index.adoc new file mode 100644 index 000000000..981692917 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/03-application-workloads/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "应用负载" +keywords: "Kubernetes, {ks_product}, 联邦项目, 应用负载" +description: "介绍如何管理联邦项目中的应用负载。" +weight: 03 +layout: "second" +--- + + + +本节介绍如何管理联邦项目中的应用、服务、工作负载和应用路由。 diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/01-create-a-persistent-volume-claim.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/01-create-a-persistent-volume-claim.adoc new file mode 100644 index 000000000..afd91fc97 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/01-create-a-persistent-volume-claim.adoc @@ -0,0 +1,37 @@ +--- +title: "创建持久卷声明" +keywords: "Kubernetes, {ks_product}, 联邦项目, 存储, 持久卷声明, 创建持久卷声明" +description: "介绍如何创建持久卷声明。" +weight: 01 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **持久卷声明** + + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-desc-createAPersistentVolumeClaim.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-oper-createAPersistentVolumeClaim-for-kubefed.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/02-view-a-persistent-volume-claim-list.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/02-view-a-persistent-volume-claim-list.adoc new file mode 100644 index 000000000..93bb188b3 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/02-view-a-persistent-volume-claim-list.adoc @@ -0,0 +1,39 @@ +--- +title: "查看持久卷声明列表" +keywords: "Kubernetes, {ks_product}, 联邦项目, 存储, 持久卷声明, 查看持久卷声明列表" +description: "介绍如何查看持久卷声明列表。" +weight: 02 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **持久卷声明** +:kubefed: + +include::../../../../_custom/clusterManagement/pods/pods-desc-viewAPersistentVolumeList.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-para-persistentVolumeClaimList.adoc[] + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-oper-searchForPersistentVolumeClaims.adoc[] + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] +==== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/03-view-persistent-volume-claim-details.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/03-view-persistent-volume-claim-details.adoc new file mode 100644 index 000000000..1c39a9a6e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/03-view-persistent-volume-claim-details.adoc @@ -0,0 +1,38 @@ +--- +title: "查看持久卷声明详情" +keywords: "Kubernetes, {ks_product}, 联邦项目, 存储, 持久卷声明, 查看持久卷声明详情" +description: "介绍如何查看持久卷声明详情。" +weight: 03 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **持久卷声明** + + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-desc-viewPersistentVolumeClaimDetails.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-oper-openDetailsPage.adoc[] + ++ + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-oper-viewPersistentVolumeClaimDetails-for-kubefed.adoc[] + diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/04-edit-persistent-volume-claim-information.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/04-edit-persistent-volume-claim-information.adoc new file mode 100644 index 000000000..4e369aeae --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/04-edit-persistent-volume-claim-information.adoc @@ -0,0 +1,33 @@ +--- +title: "编辑持久卷声明信息" +keywords: "Kubernetes, {ks_product}, 联邦项目, 存储, 持久卷声明, 编辑持久卷声明信息" +description: "介绍如何编辑持久卷声明信息。" +weight: 04 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **持久卷声明** + + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-desc-editPersistentVolumeClaimInformation.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-oper-editPersistentVolumeClaimInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/05-delete-persistent-volume-claims.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/05-delete-persistent-volume-claims.adoc new file mode 100644 index 000000000..0575240da --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/05-delete-persistent-volume-claims.adoc @@ -0,0 +1,48 @@ +--- +title: "删除持久卷声明" +keywords: "Kubernetes, {ks_product}, 联邦项目, 存储, 持久卷声明, 删除持久卷声明" +description: "介绍如何删除持久卷声明。" +weight: 05 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **持久卷声明** + + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-desc-deletePersistentVolumeClaims.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-prer-backData.adoc[] + + +== 删除单个持久卷声明 + +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-oper-deleteASinglePersistentVolumeClaim.adoc[] + + +== 批量删除持久卷声明 + +include::../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-oper-deleteMultiplePersistentVolumeClaims.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/_index.adoc new file mode 100644 index 000000000..f9f6f3abf --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/04-peristent-volume-claims/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "持久卷声明" +keywords: "Kubernetes, {ks_product}, 联邦项目, 存储, 持久卷声明" +description: "介绍如何管理联邦项目中的持久卷声明。" +weight: 04 +layout: "second" +--- + + + +本节介绍如何管理持久卷声明。 + +系统根据持久卷声明中的参数,在后端存储系统中创建可供容器使用的存储区域,每个存储区域与{ks_product_both}平台上的一个持久卷对应。 diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/01-create-a-secret.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/01-create-a-secret.adoc new file mode 100644 index 000000000..9f8a7a91b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/01-create-a-secret.adoc @@ -0,0 +1,37 @@ +--- +title: "创建保密字典" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 保密字典, 创建保密字典" +description: "介绍如何创建保密字典。" +weight: 01 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **配置 > 保密字典** + + +include::../../../../../_custom/clusterManagement/secrets/secrets-desc-createASecret.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/secrets/secrets-oper-createASecret.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/02-view-a-secret-list.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/02-view-a-secret-list.adoc new file mode 100644 index 000000000..195cc3023 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/02-view-a-secret-list.adoc @@ -0,0 +1,39 @@ +--- +title: "查看保密字典列表" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 保密字典, 查看保密字典列表" +description: "介绍如何查看保密字典列表。" +weight: 02 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **配置 > 保密字典** +:kubefed: + +include::../../../../../_custom/clusterManagement/secrets/secrets-desc-viewASecretList.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +include::../../../../../_custom/clusterManagement/secrets/secrets-para-secretList.adoc[] + +include::../../../../../_custom/clusterManagement/secrets/secrets-oper-searchForSecrets.adoc[] + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/03-view-secret-details.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/03-view-secret-details.adoc new file mode 100644 index 000000000..7816abee9 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/03-view-secret-details.adoc @@ -0,0 +1,37 @@ +--- +title: "查看保密字典详情" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 保密字典, 查看保密字典详情" +description: "介绍如何查看保密字典详情。" +weight: 03 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **配置 > 保密字典** + + +include::../../../../../_custom/clusterManagement/secrets/secrets-desc-viewSecretDetails.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/secrets/secrets-oper-openSecretDetailsPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/secrets/secrets-oper-viewSecretDetails-for-kubefed.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/04-edit-secret-information.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/04-edit-secret-information.adoc new file mode 100644 index 000000000..39ecaa1b7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/04-edit-secret-information.adoc @@ -0,0 +1,33 @@ +--- +title: "编辑保密字典信息" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 保密字典, 编辑保密字典信息" +description: "介绍如何编辑保密字典的键值对数据。" +weight: 04 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **配置 > 保密字典** + + +include::../../../../../_custom/clusterManagement/secrets/secrets-desc-editSecretInformation.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/secrets/secrets-oper-editSecretInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/05-edit-secret-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/05-edit-secret-settings.adoc new file mode 100644 index 000000000..bbb389e63 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/05-edit-secret-settings.adoc @@ -0,0 +1,33 @@ +--- +title: "编辑保密字典设置" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 保密字典, 编辑保密字典设置" +description: "介绍如何编辑保密字典的设置。" +weight: 05 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **配置 > 保密字典** + + +include::../../../../../_custom/clusterManagement/secrets/secrets-desc-editSecretSettings.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/secrets/secrets-oper-editSecretSettings.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/06-delete-secrets.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/06-delete-secrets.adoc new file mode 100644 index 000000000..f334e63bd --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/06-delete-secrets.adoc @@ -0,0 +1,46 @@ +--- +title: "删除保密字典" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 保密字典, 删除保密字典" +description: "介绍如何删除保密字典。" +weight: 06 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **配置 > 保密字典** + + +include::../../../../../_custom/clusterManagement/secrets/secrets-desc-deleteSecrets.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 删除单个保密字典 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/secrets/secrets-oper-deleteASingleSecret.adoc[] + + +== 批量删除保密字典 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/secrets/secrets-oper-deleteMultipleSecrets.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/_index.adoc new file mode 100644 index 000000000..2953894ea --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/01-secrets/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "保密字典" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 保密字典" +description: "介绍如何管理联邦项目中的保密字典。" +weight: 01 +layout: "second" +--- + + + +include::../../../../../_custom/clusterManagement/secrets/secrets-desc-secrets.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/01-create-a-configmap.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/01-create-a-configmap.adoc new file mode 100644 index 000000000..3b7680584 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/01-create-a-configmap.adoc @@ -0,0 +1,37 @@ +--- +title: "创建配置字典" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 配置字典, 创建配置字典" +description: "介绍如何创建配置字典。" +weight: 01 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **配置 > 配置字典** + + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-desc-createAConfigmap.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-oper-createAConfigmap.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/02-view-a-configmap-list.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/02-view-a-configmap-list.adoc new file mode 100644 index 000000000..1cb173053 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/02-view-a-configmap-list.adoc @@ -0,0 +1,39 @@ +--- +title: "查看配置字典列表" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 配置字典, 查看配置字典列表" +description: "介绍如何查看配置字典列表。" +weight: 02 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **配置 > 配置字典** + + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-desc-viewAConfigmapList.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +include::../../../../../_custom/multi-clusterProjectManagement/configmaps/configmaps-para-configmapList.adoc[] + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-oper-searchForConfigmaps.adoc[] + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/03-view-configmap-details.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/03-view-configmap-details.adoc new file mode 100644 index 000000000..99b1d028f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/03-view-configmap-details.adoc @@ -0,0 +1,37 @@ +--- +title: "查看配置字典详情" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 配置字典, 查看配置字典详情" +description: "介绍如何查看配置字典详情。" +weight: 03 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **配置 > 配置字典** + + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-desc-viewConfigmapDetails.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-oper-openDetailsPage.adoc[] + ++ + +include::../../../../../_custom/multi-clusterProjectManagement/configmaps/configmaps-oper-viewConfigmapDetails.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/04-edit-configmap-information.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/04-edit-configmap-information.adoc new file mode 100644 index 000000000..d807929e7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/04-edit-configmap-information.adoc @@ -0,0 +1,33 @@ +--- +title: "编辑配置字典信息" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 配置字典, 编辑配置字典信息" +description: "介绍如何编辑配置字典信息。" +weight: 04 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **配置 > 配置字典** + + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-desc-editConfigmapInformation.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-oper-editConfigmapInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/05-edit-configmap-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/05-edit-configmap-settings.adoc new file mode 100644 index 000000000..3ecf08e88 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/05-edit-configmap-settings.adoc @@ -0,0 +1,33 @@ +--- +title: "编辑配置字典设置" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 配置字典, 编辑配置字典设置" +description: "介绍如何编辑配置字典设置。" +weight: 05 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **配置 > 配置字典** + + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-desc-editConfigmapSettings.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-oper-editConfigmapSettings.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/06-delete-configmaps.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/06-delete-configmaps.adoc new file mode 100644 index 000000000..93bad0065 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/06-delete-configmaps.adoc @@ -0,0 +1,46 @@ +--- +title: "删除配置字典" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 配置字典, 删除配置字典" +description: "介绍如何删除配置字典。" +weight: 06 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **配置 > 配置字典** + + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-desc-deleteConfigmaps.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 删除单个配置字典 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-oper-deleteASingleConfigmap.adoc[] + + +== 批量删除配置字典 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-oper-deleteMultipleConfigmaps.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/_index.adoc new file mode 100644 index 000000000..d90ab32d5 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/02-configmaps/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "配置字典" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置, 配置字典" +description: "介绍如何管理联邦项目中的配置字典。" +weight: 02 +layout: "second" +--- + + + +include::../../../../../_custom/clusterManagement/configmaps/configmaps-desc-configmaps.adoc[] + +配置字典仅用于存储非保密数据。如需存储保密数据,请使用link:../01-secrets/[保密字典]。 diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/_index.adoc new file mode 100644 index 000000000..602d47058 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/05-configuration/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "配置" +keywords: "Kubernetes, {ks_product}, 联邦项目, 配置" +description: "介绍如何管理保密字典、配置字典和服务帐户。" +weight: 05 +layout: "second" +--- + + + +include::../../../../_custom/multi-clusterProjectManagement/configmaps/config-desc.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/01-view-project-basic-information.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/01-view-project-basic-information.adoc new file mode 100644 index 000000000..4dd3ce275 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/01-view-project-basic-information.adoc @@ -0,0 +1,45 @@ +--- +title: "查看项目基本信息" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置, 基本信息, 查看项目基本信息" +description: "介绍如何查看项目基本信息。" +weight: 01 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **项目设置 > 基本信息** + + +本节介绍如何查看项目基本信息。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +-- +**基本信息**页面提供以下信息: + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|项目信息 +|当前项目的信息,包括项目名称、所属企业空间、创建者和创建时间。 + +include::../../../../../_custom/clusterManagement/projects/projects-para-defaultContainerQuotas.adoc[] + +// include::../../../../../_custom/clusterManagement/projects/projects-para-projectQuotas.adoc[] +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/02-edit-project-information.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/02-edit-project-information.adoc new file mode 100644 index 000000000..bcc5538a0 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/02-edit-project-information.adoc @@ -0,0 +1,46 @@ +--- +title: "编辑项目信息" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置, 基本信息, 编辑项目信息" +description: "介绍如何编辑项目信息。" +weight: 02 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目设置 > 基本信息** + + +本节介绍如何编辑项目基本信息。 + +您可以编辑项目的别名和描述。{ks_product_right}不支持编辑已创建项目的名称。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**基本信息**页面,点击**管理**,然后在下拉列表中选择**编辑信息**。 + +. 在**编辑信息**对话框,设置项目的别名和描述,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/clusterManagement/projects/projects-para-aliasDescription.adoc[] +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/03-edit-annotation.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/03-edit-annotation.adoc new file mode 100644 index 000000000..2c85f610c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/03-edit-annotation.adoc @@ -0,0 +1,41 @@ +--- +title: "编辑项目注解" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置, 基本信息,添加项目集群" +description: "介绍如何编辑项目注解。" +weight: 03 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目设置 > 基本信息** + + +本节介绍如何编辑项目注解。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**基本信息**页面,点击**管理**,然后在下拉列表中选择**编辑注解**。 + +. 在弹出的对话框中,设置注解的键值对,然后点击**确定**。注解添加完成后将显示在项目基本信息页面。 ++ +-- +* 点击**添加**可以为当前项目添加一个或多个注解。 + +* 点击 image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18] 可删除当前待添加的注解。 +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/04-add-cluster.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/04-add-cluster.adoc new file mode 100644 index 000000000..1b83b73ce --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/04-add-cluster.adoc @@ -0,0 +1,41 @@ +--- +title: "添加项目集群" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置, 基本信息,添加项目集群" +description: "介绍如何添加项目集群。" +weight: 04 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目设置 > 基本信息** + + +本节介绍如何添加项目到其他集群。添加后将自动在对应集群创建当前项目。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**基本信息**页面,点击**管理**,然后在下拉列表中选择**添加集群**。 + +. 在弹出的对话框中,从下拉列表中选择想要添加当前项目的集群,然后点击**确定**。集群添加后将自动在对应集群创建当前项目。 ++ +-- +* 点击**添加集群**可以将当前项目添加到一个或多个集群。 + +* 点击 image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18] 可删除当前待添加的集群。 +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/05-edit-default-container-quotas.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/05-edit-default-container-quotas.adoc new file mode 100644 index 000000000..29c9921fc --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/05-edit-default-container-quotas.adoc @@ -0,0 +1,37 @@ +--- +title: "编辑默认容器配额" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置, 基本信息, 编辑默认容器配额" +description: "介绍如何编辑默认容器配额。" +weight: 05 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目设置 > 基本信息** + + +include::../../../../../_custom/clusterManagement/projects/projects-desc-editDefaultContainerQuotas.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**基本信息**页面,点击**管理**,然后在下拉列表中选择**编辑默认容器配额**。 + ++ + +include::../../../../../_custom/clusterManagement/projects/projects-oper-editDefaultContainerQuotas.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/06-delete-a-project.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/06-delete-a-project.adoc new file mode 100644 index 000000000..1bdc8e39c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/06-delete-a-project.adoc @@ -0,0 +1,38 @@ +--- +title: "删除项目" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置, 基本信息, 删除项目" +description: "介绍如何删除项目。" +weight: 06 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目设置 > 基本信息** + + +include::../../../../../_custom/clusterManagement/projects/projects-desc-deleteProjects.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**基本信息**页面,点击**管理**,然后在下拉列表中选择**删除项目**。 + ++ + +include::../../../../../_custom/clusterManagement/projects/projects-oper-deleteASingleProject.adoc[] + diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/_index.adoc new file mode 100644 index 000000000..702e364d7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/01-basic-information/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "基本信息" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置, 基本信息" +description: "介绍如何查看和管理联邦项目的基本信息。" +weight: 01 +layout: "second" +--- + + + +本节介绍如何查看和管理联邦项目的基本信息。 diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/01-view-project-quotas.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/01-view-project-quotas.adoc new file mode 100644 index 000000000..622c318ac --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/01-view-project-quotas.adoc @@ -0,0 +1,35 @@ +--- +title: "查看项目配额" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置, 项目配额, 查看项目配额" +description: "介绍如何查看项目配额。" +weight: 01 +--- + +:ks_permission: **联邦项目查看** +:ks_navigation: **项目设置 > 项目配额** + + +本节介绍如何查看项目配额。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +-- +**项目配额**页面提供以下资源信息: + +include::../../../../../_custom/multi-clusterProjectManagement/project-config/project-quota-para_v4.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/02-edit-project-quotas.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/02-edit-project-quotas.adoc new file mode 100644 index 000000000..658c0ecf5 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/02-edit-project-quotas.adoc @@ -0,0 +1,35 @@ +--- +title: "编辑项目配额" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置, 项目配额, 编辑项目配额" +description: "介绍如何编辑项目配额。" +weight: 02 +--- + +:ks_permission: **联邦项目管理** +:ks_navigation: **项目设置 > 项目配额** + + +本节介绍如何编辑项目配额。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用**联邦集群应用管理**扩展组件。 + +* {empty} +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-prer-requiredPermission_v4.adoc[] + + +== 操作步骤 + +include::../../../../../_custom/multi-clusterProjectManagement/projectManagement-oper-openProjectPage_v4.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + +. 在**项目配额**页面,点击右上角的**编辑配额**,进入配额编辑页面。 + ++ + +include::../../../../../_custom/clusterManagement/projects/projects-oper-editProjectQuotas-for-kubefed.adoc[] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/_index.adoc new file mode 100644 index 000000000..cf21d5ad8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/02-project-quotas/_index.adoc @@ -0,0 +1,10 @@ +--- +title: "项目配额" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置, 项目配额" +description: "介绍如何查看和管理联邦项目的配额。" +weight: 02 +layout: "second" +--- + + +本节介绍如何查看和管理联邦项目的配额。 diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/_index.adoc new file mode 100644 index 000000000..21b5b59cc --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/06-project-settings/_index.adoc @@ -0,0 +1,8 @@ +--- +title: "项目设置" +keywords: "Kubernetes, {ks_product}, 联邦项目, 项目设置" +description: "介绍如何管理项目设置。" +weight: 06 +layout: "second" +--- + diff --git a/content/zh/docs/v4.1/11-use-extensions/04-kubefed/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/_index.adoc new file mode 100644 index 000000000..ab7b5e750 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/04-kubefed/_index.adoc @@ -0,0 +1,16 @@ +--- +title: "联邦集群应用管理" +keywords: "Kubernetes, {ks_product}, 联邦项目" +description: "介绍如何管理联邦项目,以及如何在联邦项目中管理应用负载、卷、配置资源和项目设置。" +weight: 04 +layout: "second" +--- + + +本节介绍如何使用“联邦集群应用管理”扩展组件来管理联邦项目,以及如何在联邦项目中管理应用负载、持久卷声明、配置资源和项目设置。 + +联邦项目是基于多个集群创建的项目。联邦项目中的资源可运行在不同集群上。 + +联邦集群应用管理是一个旨在简化跨多个联邦 Kubernetes 集群管理应用程序的扩展组件,用户可以轻松地在多个联邦集群中部署、更新和管理应用程序,同时提供灵活的配置选项以满足不同需求。 + +安装“联邦集群应用管理”扩展组件后,企业空间左侧导航栏的**项目**菜单下将显⽰**联邦项目**选项。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-platform-services/01-intro.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-platform-services/01-intro.adoc new file mode 100644 index 000000000..39afea9f1 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-platform-services/01-intro.adoc @@ -0,0 +1,125 @@ +--- +title: "配置 WhizardTelemetry 平台服务" +description: "介绍如何配置 WhizardTelemetry 平台服务。" +weight: 01 +--- + +WhizardTelemetry 平台服务是 WhizardTelemetry 可观测平台中各扩展组件的公共服务。它是各个可观测性扩展组件通用的 APIServer,为所有可观测性扩展组件提供公共的后端平台服务。 + +**配置说明:** + +* 修改 WhizardTelemetry 平台服务的扩展组件配置,可配合 WhizardTelemetry 监控扩展组件,启用 Whizard 可观测中心。有关更多信息,请参阅 link:../07-whizard/01-enable-whizard/[Whizard 可观测中心]。 + +* 为 WhizardTelemetry 日志、WhizardTelemetry 审计、WhizardTelemetry 事件、以及通知历史配置 OpenSearch 日志接收器时,如果需要使用多个 OpenSearch 数据库,可以按如下配置。 +// 有关组件配置的更多信息,请参阅扩展中心“WhizardTelemetry 平台服务”扩展组件的详情页说明。 ++ +[,yaml] +---- +whizard-telemetry: + config: + monitoring: + enabled: true + kind: 0 + endpoint: http://prometheus-k8s.kubesphere-monitoring-system.svc:9090 + observability: + enabled: false + endpoint: "http://query-frontend-whizard-operated.kubesphere-monitoring-system.svc:10902" + notification: + endpoint: http://notification-manager-svc.kubesphere-monitoring-system.svc:19093 + history: + enable: true + server: + elasticsearch: + endpoints: + - https://: + version: opensearchv2 + indexPrefix: notification-history + basicAuth: true + username: admin + password: admin + auditing: + enable: true + servers: + - elasticsearch: + cluster: + - cluster1 + - cluster2 + endpoints: + - https://: + version: opensearchv2 + indexPrefix: auditing + basicAuth: true + username: admin + password: admin + - elasticsearch: + cluster: + - cluster3 + - cluster4 + endpoints: + - https://: + version: opensearchv2 + indexPrefix: auditing + basicAuth: true + username: admin + password: admin + events: + enable: true + servers: + - elasticsearch: + cluster: + - cluster1 + - cluster2 + endpoints: + - https://opensearch-cluster-data.kubesphere-logging-system:9200 + version: opensearchv2 + indexPrefix: events + basicAuth: true + username: admin + password: admin + - elasticsearch: + cluster: + - cluster3 + - cluster4 + endpoints: + - https://opensearch-cluster-data.kubesphere-logging-system:9200 + version: opensearchv2 + indexPrefix: events + basicAuth: true + username: admin + password: admin + logging: + enable: true + servers: + - elasticsearch: + cluster: + - cluster1 + - cluster2 + endpoints: + - https://: + version: opensearchv2 + indexPrefix: logs + basicAuth: true + username: admin + password: admin + - elasticsearch: + cluster: + - cluster3 + - cluster4 + endpoints: + - https://: + version: opensearchv2 + indexPrefix: logs + basicAuth: true + username: admin + password: admin +---- + + +// //note +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 修改 WhizardTelemetry 平台服务的扩展组件配置,可配合 WhizardTelemetry 监控扩展组件,启用 Whizard 可观测中心。有关更多信息,请参阅 link:../07-whizard/01-enable-whizard/[Whizard 可观测中心]。 +// |=== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-platform-services/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-platform-services/_index.adoc new file mode 100644 index 000000000..eec972341 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-platform-services/_index.adoc @@ -0,0 +1,6 @@ +--- +title: "WhizardTelemetry 平台服务" +description: "介绍 WhizardTelemetry 平台服务。" +weight: 01 +layout: "second" +--- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/01-write-data-to-kafka.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/01-write-data-to-kafka.adoc new file mode 100644 index 000000000..64331aa3f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/01-write-data-to-kafka.adoc @@ -0,0 +1,293 @@ +--- +title: "步骤 1:使用 Vector 将数据写入 Kafka" +weight: 01 +--- + + +== 部署 KSE 并安装日志相关组件 + +{ks_product_right}中需要安装的扩展组件: + +- RadonDB DMP +- OpenSearch 分布式检索与分析引擎 +- WhizardTelemetry 平台服务 +- WhizardTelemetry 数据流水线 +- WhizardTelemetry 日志 +- WhizardTelemetry 审计 +- WhizardTelemetry 通知 +- WhizardTelemetry 事件 + +=== 禁用 OpenSearch Sink + +在安装部署 WhizardTelemetry 日志、WhizardTelemetry 审计、WhizardTelemetry 事件以及 WhizardTelemetry 通知前,需要禁用这些扩展组件配置中 opensearch 的 sink。 + +以安装 WhizardTelemetry 审计扩展组件为例,将 sinks.opensearch.enabled 设置为 false。 + +image:/images/ks-qkcp/zh/v4.1/disable-opensearch.png[vector,100%] + +== 配置 Kafka + +在{ks_product_both}中,安装 **RadonDB DMP** 扩展组件后,点击顶部导航栏上的image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,然后点击 RadonDB DMP 进入数据库管理平台,创建 Kafka 集群以用于收集日志。 + +image:/images/ks-qkcp/zh/v4.1/dmp.png[vector,100%] + +image:/images/ks-qkcp/zh/v4.1/kafka.png[vector,100%] + +=== 启用自动创建 topic + +点击 Kafka 集群名称,进入**参数管理**页签,启用自动创建 topic 的功能。 + +image:/images/ks-qkcp/zh/v4.1/parameter.png[vector,100%] + +image:/images/ks-qkcp/zh/v4.1/enable-topic.png[vector,100%] + +[.admon.note,cols="a"] +|=== +|说明 + +| +在 Kafka 集群的详情页左侧可获取 Kafka 的读写地址。 +|=== + + +=== 创建 Kafka 用户 + +. 在 Kafka 集群的详情页面,进入 **Kafka 用户**页签,点击**创建**开始创建 Kafka 用户。 ++ +image:/images/ks-qkcp/zh/v4.1/kafka-user.png[vector,100%] + +. 按下图所示设置用户权限。 ++ +image:/images/ks-qkcp/zh/v4.1/user-permission.png[vector, 70%] + + +=== 获取证书 + +==== 查看证书相关信息 + +为了与 Kafka 通信,需要配置相关的证书及文件,具体为 -cluster-ca-cert,以及上一个步骤中创建的用户的 user.p12 字段及密码,详细信息可在{ks_product_left} Web 控制台界面上查询,如下所示。 + + +. 点击页面上方的**工作台 > 集群管理**,进入 host 集群。 +. 在左侧导航栏选择**配置 > 保密字典**。 +. 在**保密字典**页面,搜索 `cluster-ca-cert`,点击 Kafka 集群对应的保密字典进入详情页面,查看 **ca-crt** 字段的信息。 ++ +image:/images/ks-qkcp/zh/v4.1/ca-crt.png[vector,100%] ++ +. 在**保密字典**页面,搜索已创建的 Kafka 用户的名称,点击其对应的保密字典进入详情页面,查看 **user.p12** 及 **user.password** 字段的信息。 ++ +image:/images/ks-qkcp/zh/v4.1/user-password.png[vector,100%] + +==== 生成证书 + +. 在 Kafka 所在集群的节点上,执行以下命令。 ++ +==== +[.admon.note,cols="a"] +|=== +|说明 + +| +**kafka cluster** 为 Kafka 集群的名称,**kafka namespace** 为 Kafka 所在的 namespace,**kafka user** 为之前创建的 Kafka 用户。 +|=== + +[,bash] +---- +export kafka_cluster=< kafka cluster > +export kafka_namespace=< kafka namespace > +export kafka_user=< kafka user > +echo -e "apiVersion: v1\ndata:" > kafka-ca.yaml +echo " ca.crt: $(kubectl get secret -n $kafka_namespace ${kafka_cluster}-cluster-ca-cert \ +-o jsonpath='{.data.ca\.crt}')" >> kafka-ca.yaml +echo -e "kind: Secret\nmetadata:\n name: kafka-agent-cluster-ca\n labels:\n logging.whizard.io/certification: 'true'\n logging.whizard.io/vector-role: Agent\n \ +namespace: kubesphere-logging-system\ntype: Opaque" >> kafka-ca.yaml +echo "---" >> kafka-ca.yaml +echo -e "apiVersion: v1\ndata:" >> kafka-ca.yaml +echo " user.p12: $(kubectl get secret -n $kafka_namespace ${kafka_user} \ +-o jsonpath='{.data.user\.p12}')" >> kafka-ca.yaml +echo -e "kind: Secret\nmetadata:\n name: kafka-agent-user-ca\n labels:\n logging.whizard.io/certification: 'true'\n logging.whizard.io/vector-role: Agent\n \ +namespace: kubesphere-logging-system\ntype: Opaque" >> kafka-ca.yaml +---- + +此命令会生成 **kafka-ca.yaml** 文件,包含 **kafka-agent-cluster-ca** 以及 **kafka-agent-user-ca** 两个 secret 文件,分别含有上一个步骤中的 ca.crt 以及 user.p12 信息。示例如下: + +[,yaml] +---- +apiVersion: v1 +data: + ca.crt: xxx +kind: Secret +metadata: + name: kafka-agent-cluster-ca + labels: + logging.whizard.io/certification: 'true' + logging.whizard.io/vector-role: Agent + namespace: kubesphere-logging-system +type: Opaque +--- +apiVersion: v1 +data: + user.p12: xxxx +kind: Secret +metadata: + name: kafka-agent-user-ca + labels: + logging.whizard.io/certification: 'true' + logging.whizard.io/vector-role: Agent + namespace: kubesphere-logging-system +---- +==== + +. 将 **kafka-ca.yaml** 文件复制到需要收集日志数据的集群节点上,执行以下命令。 ++ +-- +[,bash] +---- +kubectl apply -f kafka-ca.yaml +---- + +此命令会在 **kubesphere-logging-system** 项目下创建 **kafka-agent-cluster-ca** 以及 **kafka-agent-user-ca** 两个 secret 文件。vector-config 会自动加载这两个 secret,并且在 vector 中配置相关证书。 +-- + +== 创建 Kafka 日志接收器 + +[,bash] +---- +cat <- + sinks: + kafka_auditing: + type: "kafka" + topic: "vector-{{ .cluster }}-auditing" + # 逗号分隔的 Kafka bootstrap servers 如:"10.14.22.123:9092,10.14.23.332:9092" + bootstrap_servers: "172.31.73.214:32239" + librdkafka_options: + security.protocol: "ssl" + ssl.endpoint.identification.algorithm: "none" + ssl.ca.location: "/etc/vector/custom/certification/ca.crt" + ssl.keystore.location: "/etc/vector/custom/certification/user.p12" + ssl.keystore.password: "yj5nwJLVqyII1ZHZCW2RQwJcyjKo3B9o" + encoding: + codec: "json" + inputs: + - auditing_remapped + batch: + max_events: 100 + timeout_secs: 10 +type: Opaque + +--- +kind: Secret +apiVersion: v1 +metadata: + name: vector-agent-events-sink-kafka + namespace: kubesphere-logging-system + labels: + logging.whizard.io/component: events + logging.whizard.io/enable: 'true' + logging.whizard.io/vector-role: Agent + annotations: + kubesphere.io/creator: admin +stringData: + sink.yaml: >- + sinks: + kafka_events: + type: "kafka" + topic: "vector-{{ .cluster }}-events" + bootstrap_servers: "172.31.73.214:32239" + librdkafka_options: + security.protocol: "ssl" + ssl.endpoint.identification.algorithm: "none" + ssl.ca.location: "/etc/vector/custom/certification/ca.crt" + ssl.keystore.location: "/etc/vector/custom/certification/user.p12" + ssl.keystore.password: "yj5nwJLVqyII1ZHZCW2RQwJcyjKo3B9o" + encoding: + codec: "json" + inputs: + - kube_events_remapped + batch: + max_events: 100 + timeout_secs: 10 +type: Opaque + +--- +kind: Secret +apiVersion: v1 +metadata: + name: vector-agent-logs-sink-kafka + namespace: kubesphere-logging-system + labels: + logging.whizard.io/component: logs + logging.whizard.io/enable: 'true' + logging.whizard.io/vector-role: Agent + annotations: + kubesphere.io/creator: admin +stringData: + sink.yaml: >- + sinks: + kafka_logs: + type: "kafka" + topic: "vector-{{ .cluster }}-logs" + bootstrap_servers: "172.31.73.214:32239" + librdkafka_options: + security.protocol: "ssl" + ssl.endpoint.identification.algorithm: "none" + ssl.ca.location: "/etc/vector/custom/certification/ca.crt" + ssl.keystore.location: "/etc/vector/custom/certification/user.p12" + ssl.keystore.password: "yj5nwJLVqyII1ZHZCW2RQwJcyjKo3B9o" + encoding: + codec: "json" + inputs: + - kube_logs_remapped + - systemd_logs_remapped + batch: + max_events: 100 + timeout_secs: 10 +type: Opaque + +--- +apiVersion: v1 +kind: Secret +metadata: + name: vector-aggregator-notification-history-sink-kafka + namespace: kubesphere-logging-system + labels: + logging.whizard.io/component: "notification-history" + logging.whizard.io/vector-role: Aggregator + logging.whizard.io/enable: "true" +stringData: + sink.yaml: >- + sinks: + kafka_notification_history: + type: "kafka" + topic: "vector-{{ .cluster }}-notification-history" + bootstrap_servers: "172.31.73.214:32239" + librdkafka_options: + security.protocol: "ssl" + ssl.endpoint.identification.algorithm: "none" + ssl.ca.location: "/etc/vector/custom/certification/ca.crt" + ssl.keystore.location: "/etc/vector/custom/certification/user.p12" + ssl.keystore.password: "yj5nwJLVqyII1ZHZCW2RQwJcyjKo3B9o" + encoding: + codec: "json" + inputs: + - notification_history_remapped + batch: + max_events: 100 + timeout_secs: 10 +type: Opaque +EOF +---- + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/02-read-data-from-kafka.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/02-read-data-from-kafka.adoc new file mode 100644 index 000000000..6d0e9dbb2 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/02-read-data-from-kafka.adoc @@ -0,0 +1,171 @@ +--- +title: "步骤 2:使用 Vector 从 Kafka 读取数据" +weight: 02 +--- + +== 部署 vector aggregator + +在 Kafka 所在集群,执行以下命令创建 vector namespace,并在该 namespace 下部署 vector-aggregator。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +* 请勿将 vector aggregator 部署到 kubesphere-logging-system namespace, 以免与{ks_product_both}内置的 vector aggregator 冲突。 + +* 请联系{ks_product_both}交付服务专家获取 vector aggregator 的 helm 包。 +|=== + +[,bash] +---- +helm install vector-aggregator aggregator-0.30.0.tgz -n vector --create-namespace --set vectorConfig.image.tag=v0.2.1 --set image.tag=0.36.0-debian +---- + +所需镜像: + +[,bash] +---- +docker.io/timberio/vector:0.36.0-debian +docker.io/kubesphere/kubectl:v1.26.13 +docker.io/kubesphere/vector-config:v0.2.1 +---- + +== 获取证书 + +. 在 Kafka 所在集群的节点上,执行以下命令。 ++ +==== +[.admon.note,cols="a"] +|=== +|说明 + +| +**kafka cluster** 为 Kafka 集群的名称,**kafka namespace** 为 Kafka 所在的 namespace,**kafka user** 为之前创建的 Kafka 用户。 +|=== + +[,bash] +---- +export kafka_cluster=< kafka cluster > +export kafka_namespace=< kafka namespace > +export kafka_user=< kafka user > +echo -e "apiVersion: v1\ndata:" > kafka-aggregator-ca.yaml +echo " ca.crt: $(kubectl get secret -n $kafka_namespace ${kafka_cluster}-cluster-ca-cert \ +-o jsonpath='{.data.ca\.crt}')" >> kafka-aggregator-ca.yaml +echo -e "kind: Secret\nmetadata:\n name: kafka-aggregator-cluster-ca\n labels:\n logging.whizard.io/certification: 'true'\n logging.whizard.io/vector-role: Aggregator\n \ +namespace: vector\ntype: Opaque" >> kafka-aggregator-ca.yaml +echo "---" >> kafka-aggregator-ca.yaml +echo -e "apiVersion: v1\ndata:" >> kafka-aggregator-ca.yaml +echo " user.p12: $(kubectl get secret -n $kafka_namespace ${kafka_user} \ +-o jsonpath='{.data.user\.p12}')" >> kafka-aggregator-ca.yaml +echo -e "kind: Secret\nmetadata:\n name: kafka-aggregator-user-ca\n labels:\n logging.whizard.io/certification: 'true'\n logging.whizard.io/vector-role: Aggregator\n \ +namespace: vector\ntype: Opaque" >> kafka-aggregator-ca.yaml +---- + +此命令会生成 **kafka-aggregator-ca.yaml** 文件,包含 **kafka-aggregator-cluster-ca** 以及 **kafka-aggregator-user-ca** 两个 secret 文件,分别含有上一个步骤中的 ca.crt 以及 user.p12 信息。 +示例如下: + +[,yaml] +---- +apiVersion: v1 +data: + ca.crt: xxx +kind: Secret +metadata: + name: kafka-aggregator-cluster-ca + labels: + logging.whizard.io/certification: 'true' + logging.whizard.io/vector-role: Aggregator + namespace: vector +type: Opaque +--- +apiVersion: v1 +data: + user.p12: xxx +kind: Secret +metadata: + name: kafka-aggregator-user-ca + labels: + logging.whizard.io/certification: 'true' + logging.whizard.io/vector-role: Aggregator + namespace: vector +type: Opaque +---- + +==== + +== 配置 vector-aggregator,将消息发送至 OpenSearch + +创建 vector 配置,在 bootstrap_servers 填入相应的 Kafka 集群地址,在 sink:kafka_to_opensearch:endpoints 填入相应的 OpenSearch 地址。 + +[,bash] +---- +cat <- + sources: + kafka_source: + type: "kafka" + group_id: "ks" + topics: [ "^(vector)-.+" ] + bootstrap_servers: "172.31.53.102:32476" + librdkafka_options: + security.protocol: "ssl" + ssl.endpoint.identification.algorithm: "none" + ssl.ca.location: "/etc/vector/custom/certification/ca.crt" + ssl.keystore.location: "/etc/vector/custom/certification/user.p12" + ssl.keystore.password: "yj5nwJLVqyII1ZHZCW2RQwJcyjKo3B9o" + max.poll.interval.ms: "600000" + partition.assignment.strategy: roundrobin + decoding: + codec: json + session_timeout_ms: 20000 + socket_timeout_ms: 90000 + transforms: + kafka_remapped: + inputs: + - kafka_source + source: |- + .event.original = encode_json(.) + ts = parse_timestamp!(.timestamp, format: "%+") + .timestamp = format_timestamp!(ts, format: "%+", timezone: "local") + .topictime = to_unix_timestamp(ts, unit: "milliseconds") + .logstamp = from_unix_timestamp!(.topictime, unit: "milliseconds") + .logdate = .timestamp + .idxdate = format_timestamp!(ts, format: "%Y.%m.%d", timezone: "local") + tmp = split!(.topic, "-") + .index = join!(remove!(tmp, [0]), "-") + type: remap + sinks: + kafka_to_opensearch: + api_version: v8 + auth: + password: admin + strategy: basic + user: admin + batch: + timeout_secs: 5 + buffer: + max_events: 10000 + endpoints: + - https://: + tls: + verify_certificate: false + type: elasticsearch + inputs: + - kafka_remapped + bulk: + index: "{{ .index }}-%Y.%m.%d" + request: + timeout_sec: 180 +type: Opaque +EOF +---- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/03-configure-platform-service.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/03-configure-platform-service.adoc new file mode 100644 index 000000000..0c4acc54e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/03-configure-platform-service.adoc @@ -0,0 +1,24 @@ +--- +title: "步骤 3:配置 WhizardTelemetry 平台服务" +weight: 03 +--- + +== 修改 whizard-telemetry-config + +如果使用外置 OpenSearch 数据库,需要修改配置文件 whizard-telemetry-config。 + +. 在集群左侧导航栏选择**配置 > 配置字典**。 + +. 在**配置字典**页面,查找 **whizard-telemetry-config**,点击右侧的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑 yaml**。 ++ +image:/images/ks-qkcp/zh/v4.1/whizard-telemetry-config.png[vector,100%] + +. 修改 `notification:history:endpoints`、`logging:endpoints`、`auditing:endpoints` 和 `events:endpoints` 为 OpenSearch 地址,点击**确定**。 ++ +image:/images/ks-qkcp/zh/v4.1/edit-endpoint.png[vector,100%] + +== 在 KSE 界面查询日志 + +部署完成后,可以从 OpenSearch 查询到日志,如图所示。 + +image:/images/ks-qkcp/zh/v4.1/log.png[vector,100%] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/_index.adoc new file mode 100644 index 000000000..ab4be8eee --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/02-etl-solution/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "Vector 日志 ETL 方案 - 从 Kafka 到 OpenSearch" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理" +description: "介绍 Vector 日志 ETL 方案。" +weight: 13 +layout: "second" +--- + +== 总体方案 + +image:/images/ks-qkcp/zh/v4.1/vector-solution.png[vector, 100%] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/_index.adoc new file mode 100644 index 000000000..5ae2c8f6e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/01-vector/_index.adoc @@ -0,0 +1,30 @@ +--- +title: "WhizardTelemetry 数据流水线" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理" +description: "介绍如何使用 WhizardTelemetry 数据流水线。" +weight: 1.5 +layout: "second" +--- + + +WhizardTelemetry 数据流水线是 WhizardTelemetry 可观测平台中提供可观测性数据的收集、转换和路由能力的扩展组件。 + + +//attention +[.admon.attention,cols="a"] +|=== +| 注意 + +| +* WhizardTelemetry 数据流水线是 WhizardTelemetry 日志、WhizardTelemetry 事件、WhizardTelemetry 审计、WhizardTelemetry 通知等共同依赖的扩展组件,因此在安装上述几个扩展组件之前必须先安装 WhizardTelemetry 数据流水线扩展组件,否则日志、通知、审计、事件等功能无法正常使用! + +* WhizardTelemetry 可观测平台支持从 OpenSearch 查询日志、审计、事件、通知历史等数据,因此需要在 WhizardTelemetry 数据流水线扩展组件里统一配置接收日志、审计、事件、通知历史等数据的 OpenSearch 服务的信息,可以是用户自行搭建的 OpenSearch 服务,也可以是通过 OpenSearch 分布式检索与分析引擎这个扩展组件安装的 OpenSearch 服务。 +|=== + +[.admon.note,cols="a"] +|=== +|说明 + +| +有关组件配置的更多信息,请参阅扩展中心“WhizardTelemetry 数据流水线”扩展组件的详情页说明。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/01-config.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/01-config.adoc new file mode 100644 index 000000000..f286789c2 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/01-config.adoc @@ -0,0 +1,76 @@ +--- +title: "配置日志管理" +keywords: "Kubernetes, {ks_product}, 日志" +description: "介绍如何配置“WhizardTelemetry 日志”扩展组件。" +weight: 01 +--- + +WhizardTelemetry 日志支持通过配置扩展组件实现收集指定日志、按项目创建日志索引等功能。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +更多配置信息,请参阅扩展中心 “WhizardTelemetry 日志”扩展组件的详情页说明。 +|=== + +== 收集指定日志 + +WhizardTelemetry 日志支持设置过滤条件,以收集包含或排除指定 namespace 的日志,可减少日志数量。 + +在 WhizardTelemetry 日志的扩展组件配置中,编辑如下参数: + +[,yaml] +---- +vector-logging: + filter: + extraLabelSelector: "app.kubernetes.io/name!=kube-events-exporter" + extraNamespaceLabelSelector: "" + # When includeNamespaces and excludeNamespaces are set at the same time, only excludeNamespaces will take effect. + includeNamespaces: [] + excludeNamespaces: [] +---- + +* extraLabelSelector:只收集带此标签的 pod 的日志。 +* extraNamespaceLabelSelector:只收集带此标签的 namespace 下的 pod 日志。 +* includeNamespaces:只收集指定 namespace 下的 pod 日志。 +* excludeNamespaces:不收集指定 namespace 下的 pod 日志。 + +== 按照 namespace 创建日志索引 + +WhizardTelemetry 日志支持为每个项目(namespace)创建一个索引,既可确定某个 namespace 的日志占用空间,方便整改业务,又便于进行日志分析。 + +=== 前提条件 + +版本要求:WhizardTelemetry 日志 >= 1.2.0,WhizardTelemetry 平台服务 >= 1.1.0。 + +=== 操作步骤 + +. 修改 WhizardTelemetry 日志扩展组件配置。无需修改 prefix 中的参数。 ++ +[,yaml] +---- +vector-logging: + sinks: + opensearch: + index: + prefix: "{{ .cluster }}-{{ .kubernetes.namespace_name }}-logs" + timestring: "%Y.%m.%d" +---- + +. 修改 WhizardTelemetry 平台服务扩展组件配置。无需修改 indexPrefix 中的参数。 ++ +[,yaml] +---- +whizard-telemetry: + config: + logging: + enable: true + servers: + - elasticsearch: + endpoints: + - https://opensearch-cluster-data.kubesphere-logging-system:9200 + indexPrefix: "{{ .cluster }}-{{ .kubernetes.namespace_name }}-logs" + timestring: "%Y.%m.%d" +---- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/03-use-log-query-tools.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/03-use-log-query-tools.adoc new file mode 100644 index 000000000..562191035 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/03-use-log-query-tools.adoc @@ -0,0 +1,52 @@ +--- +title: "使用容器日志查询工具" +keywords: "Kubernetes, {ks_product}, 集群管理, 工具箱, 查询容器日志" +description: "介绍如何使用容器日志查询工具。" +weight: 01 +--- + +本节介绍如何查询容器日志。 + +容器日志:从容器标准输出获取的日志。容器日志的内容由容器中运行的应用程序决定。 + + +== 前提条件 + +* 您需要获得平台、集群、企业空间或项目的资源查看权限,以查看特定范围的日志。 +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 日志**扩展组件。 + +== 操作步骤 + +. 以具有相关资源查看权限的用户登录{ks_product_left} Web 控制台。 + +. 将光标悬停在页面右下角的image:/images/ks-qkcp/zh/icons/hammer.svg[hammer,18,18]图标,然后在菜单中选择**容器日志查询**。 + +. 在弹出的对话框,设置搜索条件查询日志。 ++ +-- +* 如果有多个集群,点击**集群**下拉列表可查询特定集群中的日志。 + +* 点击搜索框,设置搜索条件,然后按 **Enter** 可查看符合特定条件的日志。您可以同时设置多个搜索条件。 + +* 在查询结果页面可查看日志的时间分布图,点击柱状图,切换到该时间段的日志列表。点击image:/images/ks-qkcp/zh/icons/start-dark.svg[start-dark,18,18]/image:/images/ks-qkcp/zh/icons/stop-dark-white.svg[stop-dark-white,18,18]可开启/停止实时数据刷新,点击**日志导出**下拉列表可选择正序或倒序导出容器日志,点击**刷新频率**的时间可选择数据的刷新频率。 + +* 在查询结果列表右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]可定制列表中显示的信息。 + +* 点击查询结果中的日志条目,查看日志的详细信息。 +-- + +== 查询 Calico 日志 + +“WhizardTelemetry 日志”扩展组件默认收集 Calico 的日志,包含 Calico pod ip 的分配和释放信息,可限定查询条件查询 Calico 日志。 + +. 将光标悬停在页面右下角的image:/images/ks-qkcp/zh/icons/hammer.svg[hammer,18,18]图标,然后在菜单中选择**容器日志查询**。 + +. 在弹出的对话框,设置搜索条件查询 Calico 日志。 ++ +-- +namespace: kube-system + +pod: + +container: calico-cni +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/01-enable-logsidecar.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/01-enable-logsidecar.adoc new file mode 100644 index 000000000..a20cdd962 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/01-enable-logsidecar.adoc @@ -0,0 +1,48 @@ +--- +title: "启用日志收集" +description: "介绍如何修改扩展组件的配置,以启用日志收集功能。" +weight: 01 +--- + +本节介绍如何修改“WhizardTelemetry 日志”扩展组件的配置,以启用日志收集功能。 +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +启用后,项目左侧导航栏的**项目设置**菜单下将显⽰**日志收集**选项。 +|=== + + +== 前提条件 + +* 您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 日志**扩展组件。 + +== 操作步骤 + +. 以具有 **platform-admin** 角色的用户登录{ks_product_left} Web 控制台。 +. 点击**扩展中心**。 +. 点击已安装的 **WhizardTelemetry 日志**扩展组件,进入组件详情页,点击**管理**。 +. 点击组件图标下的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],选择**扩展组件配置**。 +. 在扩展组件配置文件中,将 **logsidecar-injector.enabled** 参数设置为 **true**,然后保存文件。 ++ +-- +[,yaml] +---- +logsidecar-injector: + enabled: true +---- + +[.admon.note,cols="a"] +|=== +|说明 + +| +由于控制此参数更新的 job 只会在 host 集群运行,因此如果想仅开启或关闭某些 member 集群的落盘日志收集功能,只设置 member 集群的 logsidecar-injector.enabled 不会生效。每次修改此参数都需要同时修改 host 集群的参数,以此来触发参数更新。 + +例如,当需要将某个 member 集群的日志收集功能关闭,只需要在该 member 集群的配置中设置 logsidecar-injector.enabled: false,然后在 host 集群的配置中设置 logsidecar-injector.updateVersion: 1。后续再进行同样操作只需要更新 logsidecar-injector.updateVersion,即可触发更新。 +|=== +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/02-enable-project-log-collection.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/02-enable-project-log-collection.adoc new file mode 100644 index 000000000..8082e6e23 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/02-enable-project-log-collection.adoc @@ -0,0 +1,58 @@ +--- +title: "在项目中启用日志收集" +keywords: "Kubernetes, {ks_product}, 项目管理, 项目设置, 日志收集, 启用日志收集" +description: "介绍如何启用日志收集。" +weight: 02 +--- + + +:ks_permission: **项目设置管理** +:ks_navigation: **项目设置 > 日志收集** + + +本节介绍如何在项目中启用日志收集。 +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +启用后,在项目中创建工作负载和任务时,**存储设置**页签的**收集卷上日志**功能将可用。 +|=== + + +== 前提条件 + + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 日志**扩展组件,并已link:../01-enable-logsidecar/[启用日志收集]。 + +== 操作步骤 + +include::../../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**收集卷上日志**区域,点击切换开关将功能状态设置为**已启用**。 + +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +ifeval::["{file_output_type}" == "html"] +启用日志收集后,您需要重启容器组才能对现有的容器组生效。有关更多信息,请参阅link:../../../../../09-project-management/03-application-workloads/03-workloads/05-re-create-a-workload/[重新创建工作负载]、link:../../../../../09-project-management/03-application-workloads/04-jobs/05-rerun-a-job/[重新运行任务]或link:../../../../../09-project-management/03-application-workloads/06-pods/05-delete-pods/[删除容器组]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +启用日志收集后,您需要重启容器组才能对现有的容器组生效。有关更多信息,请参阅《{ks_product_right}项目管理指南》的“应用负载”章节,重新创建工作负载、重新运行任务或删除容器组。 +endif::[] + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/03-enable-collect-volume-logs.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/03-enable-collect-volume-logs.adoc new file mode 100644 index 000000000..7fdb3463a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/03-enable-collect-volume-logs.adoc @@ -0,0 +1,49 @@ +--- +title: "启用收集卷上日志" +keywords: "Kubernetes, {ks_product}, 项目管理, 项目设置, 日志收集, 收集卷上的日志" +description: "介绍如何启用收集卷上日志。" +weight: 03 +--- + + +:ks_permission: **应用负载管理** + +ifeval::["{file_output_type}" == "html"] +本节介绍如何在创建工作负载、服务或任务时启用收集卷上的日志。有关更多信息,请参阅link:../../../../../09-project-management/03-application-workloads/03-workloads/01-create-a-workload/[创建工作负载]或link:../../../../../09-project-management/03-application-workloads/04-jobs/01-create-a-job/[创建任务]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +本节介绍如何在创建工作负载、服务或任务时启用收集卷上的日志。有关更多信息,请参阅《{ks_product_right}项目管理指南》的“应用负载”章节,创建工作负载或创建任务。 +endif::[] + + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 日志**扩展组件,并已link:../02-enable-project-log-collection/[在项目中启用日志收集]。 + +== 操作步骤 + +include::../../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +. 在左侧导航栏选择**应用负载 > 工作负载**或**应用负载 > 任务**。 + +. 在工作负载页面,点击**部署**、**有状态副本集**或**守护进程集**打开工作负载列表,或在任务页面,点击**任务**或**定时任务**打开任务列表。 + +. 在页面点击**创建**。 + +. 在**存储设置**页签,点击**收集卷上日志**开关启用该功能。 + +. 点击**挂载卷**,为容器挂载**读写**模式的持久卷或临时卷,并设置**容器日志路径**。 + +. 设置容器中的应用程序,将日志导出到卷挂载目录下的容器日志路径。 ++ +日志收集完成后将打印到容器的标准输出,您可以在{ks_product_both}提供的工具箱对容器日志进行查询。有关更多信息,请参阅link:../../03-use-log-query-tools/[使用容器日志查询工具]。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/_index.adoc new file mode 100644 index 000000000..3eb1813cc --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/05-log-collection/_index.adoc @@ -0,0 +1,23 @@ +--- +title: "日志收集" +keywords: "Kubernetes, {ks_product}, 项目管理, 项目设置, 日志收集" +description: "介绍如何启用和禁用日志收集功能。" +weight: 02 +layout: "second" +--- + +本节介绍如何使用日志收集功能。 + +日志收集功能启用后,{ks_product_right}将读取容器保存在卷上的日志文件,然后将日志文件的内容打印到容器的标准输出。使用日志收集功能需要进行以下步骤: + +. 安装并启用“WhizardTelemetry 日志”扩展组件。 + +. 在“WhizardTelemetry 日志”扩展组件的配置中启用 `logsidecar-injector`。有关更多信息,请参阅link:01-enable-logsidecar/[启用日志收集]。 + +. 在项目中启用日志收集。 + +. 设置容器,将运行日志文件输出到容器中的路径下。有关更多信息,请联系容器镜像的开发者。 + +. 创建工作负载、服务或任务时启用**收集卷上的日志**,为容器挂载一个可读写的卷,并设置日志文件的路径。 + +. 使用{ks_product_both}提供的工具箱对容器日志进行查询。有关更多信息,请参阅link:../03-use-log-query-tools/[使用容器日志查询工具]。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/01-config-opensearch.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/01-config-opensearch.adoc new file mode 100644 index 000000000..fed719cee --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/01-config-opensearch.adoc @@ -0,0 +1,151 @@ +--- +title: "配置 OpenSearch 日志接收器" +description: "介绍如何配置 OpenSearch 日志接收器。" +weight: 01 +--- + +本节介绍如何配置 OpenSearch 日志接收器,以便将日志数据发送到指定的 OpenSearch 数据库。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +在扩展组件安装时或安装完成后均可以修改扩展组件配置,以配置日志接收器。下文仅介绍扩展组件已安装的情况下,如何配置 OpenSearch 日志接收器。 +|=== + + +== 前提条件 + +* 您需要在{ks_product_both}平台具有 **platform-admin** 角色。 +* 已获取 OpenSearch 的服务地址和服务端口。 + +== 配置步骤 + +. 以具有 **platform-admin** 角色的用户登录{ks_product_left} Web 控制台。 +. 点击**扩展中心**。 +. 点击扩展组件的名称,进入组件详情页。 +. 点击组件图标下的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],选择**扩展组件配置**。 + +. 编辑 **WhizardTelemetry 日志**的扩展组件配置,修改 `vector-logging` 下 opensearch 的相关配置。 ++ +[,yaml] +---- +vector-logging: + sinks: + opensearch: + # Create opensearch sink or not + enabled: true + # Configurations for the opensearch sink, more info for https://vector.dev/docs/reference/configuration/sinks/elasticsearch/ + # Usually users needn't change the following OpenSearch sink config, and the default sinks in secret "kubesphere-logging-system/vector-sinks" created by the WhizardTelemetry Data Pipeline extension will be used. + metadata: + api_version: v8 + auth: + strategy: basic + user: admin + password: admin + batch: + timeout_secs: 5 + buffer: + max_events: 10000 + endpoints: + - https://: + tls: + verify_certificate: false +---- + +. 编辑 **WhizardTelemetry 审计**的扩展组件配置,修改 `kube-auditing` 下 opensearch 的相关配置。 ++ +-- +[.admon.note,cols="a"] +|=== +|说明 + +| +另外,还需要启用 KubeSphere 和 Kubernetes 审计。有关更多信息,请参阅扩展中心“WhizardTelemetry 审计”扩展组件的详情页说明。 +|=== + +[,yaml] +---- +kube-auditing: + sinks: + opensearch: + # Create opensearch sink or not + enabled: true + # Configurations for the opensearch sink, more info for https://vector.dev/docs/reference/configuration/sinks/elasticsearch/ + # Usually users needn't change the following OpenSearch sink config, and the default sinks in secret "kubesphere-logging-system/vector-sinks" created by the WhizardTelemetry Data Pipeline extension will be used. + # metadata: + # api_version: v8 + # auth: + # strategy: basic + # user: admin + # password: admin + # batch: + # timeout_secs: 5 + # buffer: + # max_events: 10000 + # endpoints: + # - https://: + # tls: + # verify_certificate: false +---- + +-- + +. 编辑 **WhizardTelemetry 事件**的扩展组件配置,修改 `kube-events-exporter` 下 opensearch 的相关配置。 ++ +[,yaml] +---- +kube-events-exporter: + sinks: + opensearch: + # Create opensearch sink or not + enabled: true + # Configurations for the opensearch sink, more info for https://vector.dev/docs/reference/configuration/sinks/elasticsearch/ + # Usually users needn't change the following OpenSearch sink config, and the default sinks in secret "kubesphere-logging-system/vector-sinks" created by the WhizardTelemetry Data Pipeline extension will be used. + # metadata: + # api_version: v8 + # auth: + # strategy: basic + # user: admin + # password: admin + # batch: + # timeout_secs: 5 + # buffer: + # max_events: 10000 + # endpoints: + # - https://: + # tls: + # verify_certificate: false +---- + +. 编辑 **WhizardTelemetry 通知**的扩展组件配置,修改 `notification-history` 下 opensearch 的相关配置。 ++ +[,yaml] +---- +notification-history: + sinks: + opensearch: + # Create opensearch sink or not + enabled: true + # Configurations for the opensearch sink, more info for https://vector.dev/docs/reference/configuration/sinks/elasticsearch/ + # Usually users needn't change the following OpenSearch sink config, and the default sinks in secret "kubesphere-logging-system/vector-sinks" created by the WhizardTelemetry Data Pipeline extension will be used. + # metadata: + # api_version: v8 + # auth: + # strategy: basic + # user: admin + # password: admin + # batch: + # timeout_secs: 5 + # buffer: + # max_events: 10000 + # endpoints: + # - https://: + # tls: + # verify_certificate: false +---- + +. 编辑 **WhizardTelemetry 平台服务**的扩展组件配置,确保其中各组件配置下的 `endpoints` 与以上各个扩展组件的 `endpoints` 配置一致,以便{ks_product_both}平台能够正确查询日志数据。有关更多信息,请参阅扩展中心“WhizardTelemetry 平台服务”扩展组件的详情页说明。 ++ +至此,OpenSearch 日志接收器配置完成。在**集群设置 > 日志接收器**页面,可以看到 OpenSearch 已被配置为容器日志、资源事件、审计日志和通知历史的日志接收器。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/01-add-a-log-receiver.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/01-add-a-log-receiver.adoc new file mode 100644 index 000000000..351621992 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/01-add-a-log-receiver.adoc @@ -0,0 +1,54 @@ +--- +title: "添加日志接收器" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 日志接收器, 添加日志接收器" +description: "介绍如何添加日志接收器。" +weight: 01 +--- + +:ks_permission: **集群设置管理** +:ks_navigation: **集群设置 > 日志接收器** + + +本节介绍如何添加日志接收器。 + +{ks_product_right}支持使用 Elasticsearch、OpenSearch 和 Kafka 作为日志接收器。 + +* 每种类型的日志接收器只能添加一个。 + +* {ks_product_right}默认使用 OpenSearch 并提供日志分析工具,您可以在{ks_product_left} Web 控制台的工具箱中使用日志分析工具查询 OpenSearch 收集的日志。 + +* {ks_product_right}默认未安装 Kafka,并且目前未提供针对 Kafka 的日志分析工具。{ks_product_right}仅提供与 Kafka 对接的功能。如需使用 Kafka 作为日志接收器,您需要参阅 link:https://kafka.apache.org/documentation/[Kafka 官方文档]安装 Kafka。 + + +== 前提条件 + +:relfileprefix: ../../../../../../ + +* {empty} +include::../../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 日志**、**WhizardTelemetry 事件**、**WhizardTelemetry 审计**、或 **WhizardTelemetry 通知**扩展组件。 + + +== 操作步骤 + +include::../../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ +. 在**日志接收器**页面,点击**容器日志**、**资源事件**、**审计日志**或**通知历史**打开日志接收器列表。 + +. 在页面右侧点击**添加日志接收器**。 + +. 在**添加日志接收器**对话框,选择 **Elasticsearch**、 **OpenSearch** 或 **Kafka**。 + +. 设置日志接收器的参数,然后点击**确定**。 ++ +-- +include::../../../../../../_custom/clusterManagement/logReceivers/logReceivers-para-addLogReceiver.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/02-view-a-log-receiver-list.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/02-view-a-log-receiver-list.adoc new file mode 100644 index 000000000..8e93a73c4 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/02-view-a-log-receiver-list.adoc @@ -0,0 +1,67 @@ +--- +title: "查看日志接收器列表" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 日志接收器, 查看日志接收器列表" +description: "介绍如何查看日志接收器列表。" +weight: 02 +--- + +:ks_permission: **集群设置查看** +:ks_navigation: **集群设置 > 日志接收器** + + +本节介绍如何查看日志接收器列表。 + + +== 前提条件 + +:relfileprefix: ../../../../../../ + +* {empty} +include::../../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* 已添加一个日志接收器。 + + +== 操作步骤 + +include::../../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**日志接收器**页面,点击**容器日志**、**资源事件**、**审计日志**或**通知历史**打开日志接收器列表。 + ++ +==== +* 日志接收器列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|日志接收器的名称。{ks_product_right}支持 Elasticsearch、 OpenSearch、Kafka 日志接收器。 + +|地址 +| +include::../../../../../../_custom/clusterManagement/logReceivers/logReceivers-para-address.adoc[] + +|状态 +|日志接收器是否已启用,取值为**已启用**或**已禁用**。 + +|类型 +|日志接收器的类型,可以为**日志**、**事件**、**审计日志**或**通知历史**。 + +|创建时间 +|日志接收器的创建时间。 +|=== +-- + +include::../../../../../../../_ks_components/oper-refreshListData.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/03-view-log-receiver-details.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/03-view-log-receiver-details.adoc new file mode 100644 index 000000000..89706f8bf --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/03-view-log-receiver-details.adoc @@ -0,0 +1,47 @@ +--- +title: "查看日志接收器详情" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 日志接收器, 查看日志接收器详情" +description: "介绍如何查看日志接收器详情。" +weight: 03 +--- + +:ks_permission: **集群设置查看** +:ks_navigation: **集群设置 > 日志接收器** + + +本节介绍如何查看日志接收器详情。 + + +== 前提条件 + +:relfileprefix: ../../../../../../ + +* {empty} +include::../../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* 已添加一个日志接收器。 + + +== 操作步骤 + +include::../../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**日志接收器**页面,点击**容器日志**、**资源事件**、**审计日志**或**通知历史**,然后在列表中点击一个日志接收器的名称打开其详情页面。 + ++ + +. 在日志接收器详情页面左侧的**属性**区域查看日志接收器是否已启用。 + +. 在日志接收器详情页面右侧的**资源状态**页签查看日志接收器的设置。 ++ +-- +include::../../../../../../_custom/clusterManagement/logReceivers/logReceivers-para-addLogReceiver.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/04-edit-log-receiver-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/04-edit-log-receiver-settings.adoc new file mode 100644 index 000000000..ca5c3c2ee --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/04-edit-log-receiver-settings.adoc @@ -0,0 +1,56 @@ +--- +title: "编辑日志接收器设置" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 日志接收器, 编辑日志接收器设置" +description: "介绍如何编辑日志接收器设置。" +weight: 04 +--- + +:ks_permission: **集群设置管理** +:ks_navigation: **集群设置 > 日志接收器** + + +本节介绍如何编辑日志接收器设置。 + + +== 前提条件 + +:relfileprefix: ../../../../../../ + +* {empty} +include::../../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* 已添加一个日志接收器。 + + +== 操作步骤 + +include::../../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**日志接收器**页面,点击**容器日志**、**资源事件**、**审计日志**或**通知历史**,然后在列表中点击一个日志接收器的名称打开其详情页面。 + ++ + +. 在日志接收器详情页面左上角点击**编辑**。 + +. 在弹出的对话框修改日志接收器的设置,然后点击**确定**。 ++ +-- +include::../../../../../../_custom/clusterManagement/logReceivers/logReceivers-para-addLogReceiver.adoc[] + +[.admon.attention,cols="a"] +|=== +|注意 + +| +修改完成后,需确保 **WhizardTelemetry 平台服务**的扩展组件配置中,各组件配置下的 `endpoints` 与修改的服务地址一致,以便{ks_product_both}平台能够正确查询日志数据。有关更多信息,请参阅扩展中心“WhizardTelemetry 平台服务”扩展组件的详情页说明。 + +|=== +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/05-enable-and-disable-log-receiver.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/05-enable-and-disable-log-receiver.adoc new file mode 100644 index 000000000..3f9d30ee6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/05-enable-and-disable-log-receiver.adoc @@ -0,0 +1,43 @@ +--- +title: "启用和禁用日志接收器" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 日志接收器, 启用, 禁用" +description: "介绍如何启用和禁用日志接收器。" +weight: 05 +--- + +:ks_permission: **集群设置管理** +:ks_navigation: **集群设置 > 日志接收器** + + +本节介绍如何启用和禁用日志接收器。 + + +== 前提条件 + +:relfileprefix: ../../../../../../ + +* {empty} +include::../../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* 已添加一个日志接收器。 + + +== 操作步骤 + +include::../../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**日志接收器**页面,点击**容器日志**、**资源事件**、**审计日志**或**通知历史**,然后在列表中点击一个日志接收器的名称打开其详情页面。 + ++ + +. 在日志接收器详情页面左上角点击**更多操作 > 更改状态**。 + +. 在弹出的对话框中选择**启用**或**禁用**,然后点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/06-delete-a-log-receiver.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/06-delete-a-log-receiver.adoc new file mode 100644 index 000000000..ef732ef88 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/06-delete-a-log-receiver.adoc @@ -0,0 +1,43 @@ +--- +title: "删除日志接收器" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 日志接收器, 启用, 禁用" +description: "介绍如何删除日志接收器。" +weight: 06 +--- + +:ks_permission: **集群设置管理** +:ks_navigation: **集群设置 > 日志接收器** + + +本节介绍如何删除日志接收器。 + + +== 前提条件 + +:relfileprefix: ../../../../../../ + +* {empty} +include::../../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* 已添加一个日志接收器。 + + +== 操作步骤 + +include::../../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**日志接收器**页面,点击**容器日志**、**资源事件**、**审计日志**或**通知历史**,然后在列表中点击一个日志接收器的名称打开其详情页面。 + ++ + +. 在日志接收器详情页面左上角点击**更多操作 > 删除**。 + +. 在弹出的对话框中输入日志接收器的名称,然后点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/_index.adoc new file mode 100644 index 000000000..c60e67cf1 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/03-manage-log-receivers/_index.adoc @@ -0,0 +1,20 @@ +--- +title: "管理日志接收器" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 日志接收器" +description: "介绍如何添加和管理日志接收器。" +weight: 03 +layout: "second" +--- + + +本节介绍如何管理日志接收器。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +安装并启用 WhizardTelemetry 日志、WhizardTelemetry 事件、WhizardTelemetry 审计、WhizardTelemetry 通知这四个扩展组件中的任意一个,集群左侧导航栏的**集群设置**菜单下都会显示**日志接收器**选项,**日志接收器**页面则会显示对应的页签。 + +|=== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/_index.adoc new file mode 100644 index 000000000..ab4c5922b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/06-log-receivers/_index.adoc @@ -0,0 +1,19 @@ +--- +title: "日志接收器" +description: "介绍如何配置或添加日志接收器。" +weight: 03 +layout: "second" +--- + + +日志接收器用于收集系统的各类日志,配置或添加日志接收器,以便将 WhizardTelemetry 日志、WhizardTelemetry 审计、WhizardTelemetry 事件、以及通知历史的日志数据发送到外部日志接收器中。 + +{ks_product_right}支持收集以下类型的日志: + +* 容器日志:从容器标准输出获取的日志。容器日志的内容由容器中运行的应用程序决定。 + +* 资源事件:工作负载、任务、容器组、服务、应用路由等各类资源的事件。 + +* 审计日志:{ks_product} API 服务器接收请求的记录。 + +* 通知历史:{ks_product_right}平台向用户发送的告警通知的记录。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/_index.adoc new file mode 100644 index 000000000..09c227c86 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/02-logging/_index.adoc @@ -0,0 +1,28 @@ +--- +title: "WhizardTelemetry 日志" +keywords: "Kubernetes, {ks_product}, 日志" +description: "介绍如何使用“WhizardTelemetry 日志”扩展组件。" +weight: 02 +layout: "second" +--- + + +本节介绍如何使用“WhizardTelemetry 日志”扩展组件。 + +该组件提供多租户视角的云原生应用实时及历史日志收集、查询、导出、存储等功能,可对接如 ElasticSearch、OpenSearch、Kafka 等日志接收器。它默认收集 Calico 的日志,包含 Calico pod IP 地址的分配和释放信息。 + +安装“WhizardTelemetry 日志”扩展组件后, + +* 页面右下角的⼯具箱中将显⽰**容器⽇志查询**选项,支持用户查询自身权限范围内的容器日志。 +* 集群左侧导航栏的**集群设置**菜单下将显示**日志接收器**选项,**日志接收器**页面将显示**容器日志**页签,支持添加多种类型的日志接收器。 + +//attention +[.admon.attention,cols="a"] +|=== +| 注意 + +| +- WhizardTelemetry 日志依赖 WhizardTelemetry 平台服务和 WhizardTelemetry 数据流水线,因此在安装 WhizardTelemetry 日志之前必须先安装并配置好 WhizardTelemetry 平台服务和 WhizardTelemetry 数据流水线两个扩展组件,否则日志相关功能无法正常使用! + +- 若未收集到日志,请确保 Docker 的根目录在 /var/lib 下,否则需要修改 WhizardTelemetry 数据流水线中 agent 的挂载配置。有关更多信息,请参阅扩展中心 “WhizardTelemetry 数据流水线”扩展组件的详情页说明。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/03-events/01-use-event-query-tools.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/03-events/01-use-event-query-tools.adoc new file mode 100644 index 000000000..dc6e2582d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/03-events/01-use-event-query-tools.adoc @@ -0,0 +1,36 @@ +--- +title: "使用资源事件查询工具" +keywords: "Kubernetes, {ks_product}, 集群管理, 工具箱, 查询资源事件" +description: "介绍如何使用资源事件查询工具。" +weight: 02 +--- + +本节介绍如何查询资源事件。 + +资源事件:工作负载、任务、容器组、服务、应用路由等各类资源的事件。 + + +== 前提条件 + +* 您需要获得平台、集群、企业空间或项目的资源查看权限,以查看特定范围的事件。 +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 资源事件**扩展组件。 + +== 操作步骤 + +. 以具有相关资源查看权限的用户登录{ks_product_left} Web 控制台。 + +. 将光标悬停在页面右下角的image:/images/ks-qkcp/zh/icons/hammer.svg[hammer,18,18]图标,然后在菜单中选择**资源事件查询**。 + +. 在弹出的对话框,设置搜索条件查询事件。 ++ +-- +* 如果有多个集群,点击**集群**下拉列表可查询特定集群中的事件。 + +* 点击搜索框,设置搜索条件,然后按 **Enter** 可查看符合特定条件的事件。您可以同时设置多个搜索条件。 + +* 在查询结果页面可查看事件的时间分布图,点击柱状图,切换到该时间段的事件列表。点击image:/images/ks-qkcp/zh/icons/start-dark.svg[start-dark,18,18]/image:/images/ks-qkcp/zh/icons/stop-dark-white.svg[stop-dark-white,18,18]可开启/停止实时数据刷新,点击**刷新频率**的时间可选择数据的刷新频率。 + +* 在查询结果列表右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]可定制列表中显示的信息。 + +* 点击查询结果中的事件条目,查看事件的详细信息。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/03-events/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/03-events/_index.adoc new file mode 100644 index 000000000..16b71a175 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/03-events/_index.adoc @@ -0,0 +1,27 @@ +--- +title: "WhizardTelemetry 事件" +keywords: "Kubernetes, {ks_product}, 事件" +description: "介绍如何使用“WhizardTelemetry 事件”扩展组件。" +weight: 03 +layout: "second" +--- + + +本节介绍如何使用“WhizardTelemetry 事件”扩展组件。 + +该组件可长期保存工作负载、任务、容器组、服务、应用路由等资源的事件,并提供多租户视角的事件检索和查看功能。 + +安装“WhizardTelemetry 事件”扩展组件后, + +* 页面右下角的⼯具箱中将显⽰**资源事件查询**选项,支持用户查询自身权限范围内的资源事件。 +* 集群左侧导航栏的**集群设置**菜单下将显示**日志接收器**选项,**日志接收器**页面将显示**资源事件**页签,支持添加多种类型的日志接收器。有关更多信息,请参阅link:../02-logging/06-log-receivers/[日志接收器]。 + +//attention +[.admon.attention,cols="a"] +|=== +| 注意 + +| +WhizardTelemetry 事件依赖 WhizardTelemetry 平台服务和 WhizardTelemetry 数据流水线,因此在安装 WhizardTelemetry 事件之前必须先安装并配置好 WhizardTelemetry 平台服务和 WhizardTelemetry 数据流水线两个扩展组件,否则事件相关功能无法正常使用! + +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/04-auditing/01-use-audit-query-tools.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/04-auditing/01-use-audit-query-tools.adoc new file mode 100644 index 000000000..3dbe9c8d2 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/04-auditing/01-use-audit-query-tools.adoc @@ -0,0 +1,117 @@ +--- +title: "使用审计日志查询工具" +keywords: "Kubernetes, {ks_product}, 集群管理, 工具箱, 查询审计日志" +description: "介绍如何使用审计日志查询工具。" +weight: 01 +--- + +本节介绍如何查询审计日志。 + +审计日志:{ks_product_right} API 服务器接收请求的记录,即{ks_product_both}平台上用户的操作行为。 + +== 前提条件 + +* 您需要获得平台、集群、企业空间或项目的资源查看权限,以查看特定范围的日志。 +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 审计**扩展组件。 + +== 启用审计 + +为获取审计日志数据,您需要启用 Kubernetes 和 KubeSphere 审计,即启用审计日志收集。 + +=== 启用 Kubernetes 审计 + +. 在集群的 master 节点上创建审计目录。 ++ +[,bash] +---- +mkdir /etc/kubernetes/audit +---- + +. 创建 policy 文件。 ++ +-- +[,bash] +---- +vi /etc/kubernetes/audit/audit-policy.yaml +---- + +[,yaml] +---- +apiVersion: audit.k8s.io/v1 +kind: Policy +rules: +- level: Metadata +---- +-- + +. 编辑 kube-apiserver.yaml 文件,添加以下内容。 ++ +-- +[,bash] +---- +vi /etc/kubernetes/manifests/kube-apiserver.yaml +---- + +[,yaml] +---- + spec: + containers: + - command: + - kube-apiserver + - --audit-policy-file=/etc/kubernetes/audit/audit-policy.yaml + - --audit-log-path=/etc/kubernetes/audit/audit.log + - --audit-log-maxbackup=10 + - --audit-log-maxsize=100 + volumeMounts: + - mountPath: /etc/kubernetes/audit + name: audit + volumes: + - hostPath: + path: /etc/kubernetes/audit + type: DirectoryOrCreate + name: audit +---- +-- + +=== 启用 KubeSphere 审计 + +编辑 KubeSphere Core (ks-core) chart 包中的 values.yaml 文件。 + +[,yaml] +---- +auditing: + enable: true + auditLevel: Metadata + logOptions: + path: /etc/audit/audit.log + +apiserver: + extraVolumeMounts: + - mountPath: /etc/audit + name: audit + extraVolumes: + - hostPath: + path: /etc/kubesphere/audit + type: DirectoryOrCreate + name: audit +---- + +== 查询审计日志 + +. 以具有相关资源查看权限的用户登录{ks_product_left} Web 控制台。 + +. 将光标悬停在页面右下角的image:/images/ks-qkcp/zh/icons/hammer.svg[hammer,18,18]图标,然后在菜单中选择**审计日志查询**。 + +. 在弹出的对话框,设置搜索条件查询日志。 ++ +-- +* 如果有多个集群,点击**集群**下拉列表可查询特定集群中的日志。 + +* 点击搜索框,设置搜索条件,然后按 **Enter** 可查看符合特定条件的日志。您可以同时设置多个搜索条件。 + +* 在查询结果页面可查看日志的时间分布图,点击柱状图,切换到该时间段的日志列表。点击image:/images/ks-qkcp/zh/icons/start-dark.svg[start-dark,18,18]/image:/images/ks-qkcp/zh/icons/stop-dark-white.svg[stop-dark-white,18,18]可开启/停止实时数据刷新,点击**刷新频率**的时间可选择数据的刷新频率。 + +* 在查询结果列表右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]可定制列表中显示的信息。 + +* 点击查询结果中的日志条目,查看日志的详细信息。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/04-auditing/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/04-auditing/_index.adoc new file mode 100644 index 000000000..b12a6c6f6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/04-auditing/_index.adoc @@ -0,0 +1,29 @@ +--- +title: "WhizardTelemetry 审计" +keywords: "Kubernetes, {ks_product}, 审计" +description: "介绍如何使用“WhizardTelemetry 审计”扩展组件。" +weight: 04 +layout: "second" +draft: true +--- + + +本节介绍如何使用“WhizardTelemetry 审计”扩展组件。 + +该组件实时记录在{ks_product_both}平台上的用户相关操作行为,并提供多租户视角的审计历史的检索及查看功能,可快速回溯相关用户的操作行为。 + +安装“WhizardTelemetry 审计”扩展组件后, + +* 页面右下角的⼯具箱中将显⽰**审计日志查询**选项,支持用户查询自身权限范围内的审计日志。 +* 集群左侧导航栏的**集群设置**菜单下将显示**日志接收器**选项,**日志接收器**页面将显示**审计日志**页签,支持添加多种类型的日志接收器。有关更多信息,请参阅link:../02-logging/06-log-receivers/_index/[日志接收器]。 + + +//attention +[.admon.attention,cols="a"] +|=== +| 注意 + +| +WhizardTelemetry 审计依赖 WhizardTelemetry 平台服务和 WhizardTelemetry 数据流水线,因此在安装 WhizardTelemetry 审计之前必须先安装并配置好 WhizardTelemetry 平台服务和 WhizardTelemetry 数据流水线两个扩展组件,否则审计功能无法正常使用! + +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/01-cluster-monitoring-overview.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/01-cluster-monitoring-overview.adoc new file mode 100644 index 000000000..dc6539743 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/01-cluster-monitoring-overview.adoc @@ -0,0 +1,80 @@ +--- +title: "查看集群监控概览" +description: "介绍如何查看集群概览页面的监控信息。" +weight: 01 +--- + +:ks_permission: **监控查看** +:ks_navigation: **概览** + + +本节介绍如何查看集群概览页面的监控信息。 + +ifeval::["{file_output_type}" == "html"] +有关集群概览页面的其他信息,请参阅link:../../../../../07-cluster-management/02-overview/01-view-cluster-overall-information/[查看集群概览信息]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +有关集群概览页面的其他信息,请参阅《{ks_product_right}集群管理指南》的“概览”章节。 +endif::[] + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + +== 操作步骤 + +include::../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ +-- +**概览**页面提供以下监控信息: + +[%header,cols="1a,4a"] +|=== +|功能区 |描述 + +|集群配额统计 +|当前集群中容器和项目的 CPU 配额和内存配额,包含预留数量、上限数量和总量。 + +|节点资源用量 +|所有节点的 CPU、内存、磁盘的总量和实时用量,以及集群允许创建的容器组总数和已创建的容器组数量。默认情况下每个节点最多允许创建 110 个容器组。 + +|容器组 +|当前集群的各种类型容器组的数量。 + +容器组状态类型包括: + +include::../../../../../_custom/clusterManagement/pods/pods-para-podStatus_overview.adoc[] + +容器组 QoS(服务质量)类型包括: + +include::../../../../../_custom/clusterManagement/pods/pods-para-qosTypes.adoc[] + +|Kubernetes 状态 +|当前集群的每秒 API 请求次数、API 请求延迟、容器组调度次数和容器组调度失败次数。 + +// |系统组件 +// |当前集群中的系统组件。系统组件是运行在{ks_product_both}平台中用于实现平台功能的工作负载。 + +|资源用量排行 +|当前集群中特定资源用量最高的 5 个节点、容器组和项目。 + +* 在左侧下拉列表中选择节点、容器组或项目,在右侧下拉列表中选择不同的排序依据。 + +* 在列表上方点击image:/images/ks-qkcp/zh/icons/sort-ascending.svg[sort-ascending,18,18]/image:/images/ks-qkcp/zh/icons/sort-descending.svg[sort-descending,18,18] 可按升序/降序排序。 + +* 点击下方的**查看更多**,查看节点、容器组和项目的资源用量详情。 +|=== +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/02-workspace-monitoring-overview.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/02-workspace-monitoring-overview.adoc new file mode 100644 index 000000000..979cddedd --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/02-workspace-monitoring-overview.adoc @@ -0,0 +1,76 @@ +--- +title: "查看企业空间监控概览" +description: "介绍如何查看企业空间概览页面的监控信息。" +weight: 02 +--- + +:ks_permission: **监控查看** +:ks_navigation: **概览** + +本节介绍如何查看企业空间概览页面的监控信息。 + + +== 前提条件 + + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +-- +**概览**页面的**资源用量**页签提供以下信息: + +[%header,cols="1a,4a"] +|=== +|功能区 |描述 + +|物理资源 +|企业空间在指定集群中的 CPU 和内存使用情况。 + +|应用资源 +|企业空间在指定集群中创建的部署、有状态副本集、守护进程集、任务、定时任务、持久卷声明等的数量。 +|=== + +include::../../../../../../_ks_components/oper-selectTimeRange.adoc[] + +include::../../../../../../_ks_components/oper-Autorefresh.adoc[] + +include::../../../../../../_ks_components/oper-refreshData.adoc[] + +* 在右上角点击**集群**下拉列表可查看特定集群中的数据。 +-- + +. 在**概览**页面点击**用量排行**页签查看企业空间中的项目的资源使用情况。 ++ +-- +* 在列表左上角点击**集群**下拉列表可查看特定集群中的数据。 + +* 在列表上方点击下拉列表可选择按照 CPU 用量、内存用量、容器组数量、出站流量或入站流量对项目进行排序。 + +* 在列表上方点击image:/images/ks-qkcp/zh/icons/sort-ascending.svg[sort-ascending,18,18]/image:/images/ks-qkcp/zh/icons/sort-descending.svg[sort-descending,18,18] 可按升序/降序排序。 + +include::../../../../../_custom/clusterManagement/clusterStatus/clusterStatus-oper-exportJsonData.adoc[] +-- + +. 在**概览**页面点击**集群信息**页签查看授权给企业空间的集群的 CPU、内存、磁盘的总量和已使用量,以及集群上可创建容器组的总数和已创建容器组的数量。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +默认情况下每个集群节点最多可以创建 110 个容器组。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/03-project-monitoring-overview.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/03-project-monitoring-overview.adoc new file mode 100644 index 000000000..bcb4ba68f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/03-project-monitoring-overview.adoc @@ -0,0 +1,69 @@ +--- +title: "查看项目监控概览" +description: "介绍如何查看项目概览页面的监控信息。" +weight: 03 +--- + +:ks_permission: **监控查看** +:ks_navigation: **概览** + +本节介绍如何查看项目概览页面的监控信息。 + +ifeval::["{file_output_type}" == "html"] +有关项目概览页面的其他信息,请参阅link:../../../../../09-project-management/02-overview/01-view-project-overall-information/[查看项目概览信息]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +有关项目概览页面的其他信息,请参阅《{ks_product_right}项目管理指南》的“概览”章节。 +endif::[] + + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + +== 操作步骤 + + +include::../../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] ++ +-- +**概览**页面提供以下监控信息: + +[%header,cols="1a,4a"] +|=== +|功能区 |描述 + +|资源用量 +|当前项目的CPU、内存、磁盘的总量和实时用量。 + +|容器组 +|当前项目的各种类型容器组的数量。 + +容器组状态类型包括: + +include::../../../../../_custom/clusterManagement/pods/pods-para-podStatus_overview.adoc[] + +容器组 QoS(服务质量)类型包括: + +include::../../../../../_custom/clusterManagement/pods/pods-para-qosTypes.adoc[] + +|资源用量排行 +|当前项目中特定资源用量最高的 5 个工作负载。点击下拉列表可选择按 CPU、内存、出站流量或入站流量排序。 + +* 在列表上方点击image:/images/ks-qkcp/zh/icons/sort-ascending.svg[sort-ascending,18,18]/image:/images/ks-qkcp/zh/icons/sort-descending.svg[sort-descending,18,18] 可按升序/降序排序。 + +* 点击下方的**查看更多**,查看工作负载的资源用量详情。 +|=== +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/_index.adoc new file mode 100644 index 000000000..3d9276e9b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/01-overview/_index.adoc @@ -0,0 +1,8 @@ +--- +title: "概览" +description: "介绍如何查看集群、企业空间、项目概览页面的监控信息。" +weight: 01 +layout: "second" +--- + +本节介绍安装“WhizardTelemetry 监控”扩展组件后,如何查看集群、企业空间、项目概览页面的监控信息。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/01-view-cluster-status-overview.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/01-view-cluster-status-overview.adoc new file mode 100644 index 000000000..d07227c79 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/01-view-cluster-status-overview.adoc @@ -0,0 +1,64 @@ +--- +title: "查看集群状态概览" +keywords: "Kubernetes, {ks_product}, 监控告警, 集群状态,概览" +description: "介绍如何查看集群状态概览。" +weight: 01 +--- + +:ks_permission: **监控查看** +:ks_navigation: **监控告警 > 集群状态** + + +本节介绍如何查看集群状态概览。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + +== 操作步骤 + +include::../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**集群状态**页面的**概览**区域查看集群节点、集群资源、etcd 和服务组件的状态。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|集群节点状态 +|集群的节点总数和正常节点数量。 + +|集群资源用量 +|集群的 CPU、内存、磁盘资源的总数和已使用量,以及集群可创建容器组总数和已创建容器组数量。默认情况下每个正常集群节点最多可创建 110 个容器组。 + +|etcd 监控 +|etcd 数据库的服务状态、Raft 提议数量、数据库大小和客户端流量。 + +* **服务状态**:显示 etcd 集群的 Leader 节点、每个节点的 IP 地址和 1 小时内 Leader 变更次数。 + +* **Raft 提议**:显示 Raft 提议的每秒提交次数、应用次数、失败次数和排队提议数量。 + +* **数据库大小**:etcd 数据库大小随时间的变化。 + +* **客户端流量**:发送给 gRPC 客户端和从 gRPC 客户端接收的数据流量。 + +查看 etcd 监控信息需要提前启用 etcd 监控。有关更多信息,请参阅扩展中心 **WhizardTelemetry 监控**扩展组件的详情页说明。 + +|服务组件监控 +|Kubernetes API 服务器的请求延迟和每秒请求次数,以及调度器的累计调度次数和每秒调度次数。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/02-view-physical-resource-status.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/02-view-physical-resource-status.adoc new file mode 100644 index 000000000..8b0559e6d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/02-view-physical-resource-status.adoc @@ -0,0 +1,81 @@ +--- +title: "查看物理资源状态" +keywords: "Kubernetes, {ks_product}, 监控告警, 集群状态,物理资源状态" +description: "介绍如何查看物理资源状态。" +weight: 02 +--- + +:ks_permission: **监控查看** +:ks_navigation: **监控告警 > 集群状态** + + +本节介绍如何查看物理资源状态。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + + + +== 操作步骤 + +include::../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**集群状态**页面,点击**物理资源监控**查看集群物理资源的使用情况。 ++ +==== +* **物理资源监控**页签提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|CPU 用量 +|显示指定时间范围内的集群 CPU 使用量百分比。 + +|CPU 平均负载 +|显示指定时间范围内的集群 CPU 平均负载。CPU 平均负载是一个无量纲值,表示单位时间内 CPU 的平均活跃进程数。 + +|内存用量 +|显示指定时间范围内的集群内存使用量百分比。 + +|磁盘用量 +|显示指定时间范围的内集群磁盘使用量。 + +|Inode 用量 +|显示指定时间范围内的集群 Inode 使用量百分比。 + +|磁盘吞吐 +|显示指定时间范围内的集群磁盘读写速率。 + +|IOPS +|显示指定时间范围内的集群磁盘每秒读写操作数。 + +|网络流量 +|显示指定时间范围内集群网络出入速率。 + +|容器组状态 +|显示指定时间范围内集群运行中、已完成和异常容器组的数。 +|=== +-- + +include::../../../../../../_ks_components/oper-selectTimeRange.adoc[] + +include::../../../../../../_ks_components/oper-Autorefresh.adoc[] + +include::../../../../../../_ks_components/oper-refreshData.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/03-view-etcd-status.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/03-view-etcd-status.adoc new file mode 100644 index 000000000..301e4f70f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/03-view-etcd-status.adoc @@ -0,0 +1,92 @@ +--- +title: "查看 etcd 数据库状态" +keywords: "Kubernetes, {ks_product}, 监控告警, 集群状态,etcd 状态" +description: "介绍如何查看 etcd 数据库状态。" +weight: 03 +--- + +:ks_permission: **监控查看** +:ks_navigation: **监控告警 > 集群状态** + + +本节介绍如何查看 etcd 数据库状态。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +查看 etcd 监控信息需要提前启用 etcd 监控。有关更多信息,请参阅扩展中心 **WhizardTelemetry 监控**扩展组件的详情页说明。 +|=== + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**集群状态**页面,点击 **etcd 监控**页签查看 etcd 数据库的运行状态。 ++ +==== +* **etcd 监控**页签提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|服务状态 +|显示 etcd 集群的 Leader 节点、每个节点的 IP 地址和 1 小时内 Leader 变更次数。 + +|数据库大小 +|指定时间范围内 etcd 数据库的大小。 + +|客户端流量 +|显示发送给 gRPC 客户端和从 gRPC 客户端接收的数据流量。 + +|gRPC 流式消息 +|显示服务端的 gRPC 流式消息每秒接收次数和发送次数。 + +|WAL 日志同步时间 +|显示 WAL 调用 fsync 的延迟。在应用日志条目之前,etcd 会在持久化日志条目到磁盘时调用 **wal_fsync**。 + +|数据库同步时间 +|显示后端调用提交延迟的分布。当 etcd 将其最新的增量快照提交到磁盘时,会调用 **backend_commit**。磁盘操作延迟较大(WAL 日志同步时间或库同步时间较长)通常表示磁盘存在问题,这可能会导致请求延迟过高或集群不稳定。 + +|Raft 提议 +| +显示当前 etcd 每秒的 Raft 提议次数。将鼠标悬停在折线图上即可查看具体某个时间点的提议数据。 + +* **提议提交速率**:协商一致提议的提交速率。如果集群运行状况良好,则该指标应随着时间的推移而增加。etcd 集群的几个健康成员可以同时具有不同的一般提议。单个成员与其 Leader 之间的持续较大滞后表示该成员缓慢或不健康。 + +* **提议应用速率**:协商一致提议的总应用率。etcd 服务器异步地应用每个提交的提议。提议提交速率和提议应用速率的差异应该很小(即使在高负载下也只有几千)。如果它们之间的差异持续增大,则表明 etcd 服务器过载。当使用大范围查询或大量 txn 操作等大规模查询时,可能会出现这种情况。 + +* **提议失败速率**:提议失败的总速率。该值受两个因素影响:与 Leader 选举相关的临时失败;集群成员数目达不到规定数目而导致长时间停机。 + +* **排队提议数**:当前待处理提议的数量。待处理提议的增加表明客户端负载较高或成员无法提交提议。 +|=== + +有关 etcd 数据库参数的更多信息,请参阅 link:https://etcd.io/docs/v3.5/metrics/[etcd 官方文档]。 +-- + +include::../../../../../../_ks_components/oper-selectTimeRange.adoc[] + +include::../../../../../../_ks_components/oper-Autorefresh.adoc[] + +include::../../../../../../_ks_components/oper-refreshData.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/04-view-api-server-status.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/04-view-api-server-status.adoc new file mode 100644 index 000000000..7a44a0890 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/04-view-api-server-status.adoc @@ -0,0 +1,60 @@ +--- +title: "查看 Kubernetes API 服务器状态" +keywords: "Kubernetes, {ks_product}, 监控告警, 集群状态,API 服务器状态" +description: "介绍如何查看 Kubernetes API 服务器监控数据。" +weight: 04 +--- + +:ks_permission: **监控查看** +:ks_navigation: **监控告警 > 集群状态** + + +本节介绍如何查看 Kubernetes API 服务器状态。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + + + +== 操作步骤 + +include::../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**集群状态**页面,点击 **API Server 监控**页签查看 API 服务器的运行状态。 ++ +==== +* **API Server 监控**页签提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|指标 |描述 + +|请求延迟 +|指定时间范围内 API 服务器的请求延迟。 + +|每秒请求次数 +|指定时间范围内 API 服务器每秒接受的请求数。 +|=== +-- + +include::../../../../../../_ks_components/oper-selectTimeRange.adoc[] + +include::../../../../../../_ks_components/oper-Autorefresh.adoc[] + +include::../../../../../../_ks_components/oper-refreshData.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/05-view-scheduler-monitoring-data.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/05-view-scheduler-monitoring-data.adoc new file mode 100644 index 000000000..3474707b3 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/05-view-scheduler-monitoring-data.adoc @@ -0,0 +1,63 @@ +--- +title: "查看调度器状态" +keywords: "Kubernetes, {ks_product}, 监控告警, 集群状态,调度器状态" +description: "介绍如何查看调度器状态。" +weight: 05 +--- + +:ks_permission: **监控查看** +:ks_navigation: **监控告警 > 集群状态** + + +本节介绍如何查看调度器状态。调度器根据容器组的资源需求、节点可用资源和其他约束条件决定容器组运行在哪些节点上。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + + + +== 操作步骤 + +include::../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**集群状态**页面,点击**调度器监控**页签查看调度器的运行状态。 ++ +==== +* **调度器监控**页签提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|指标 |描述 + +|调度次数 +|指定时间范围内的容器组调度成功、错误和失败累计次数。 + +|调度速率 +|指定时间范围内的容器组每秒调度成功、错误和失败次数。 + +|调度延迟 +|指定时间范围内容器组调度延迟的 99% 分位数、90% 分位数、中位数和平均值。 +|=== +-- + +include::../../../../../../_ks_components/oper-selectTimeRange.adoc[] + +include::../../../../../../_ks_components/oper-Autorefresh.adoc[] + +include::../../../../../../_ks_components/oper-refreshData.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/06-view-nodes-ranked-by-resource-usage.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/06-view-nodes-ranked-by-resource-usage.adoc new file mode 100644 index 000000000..108349f42 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/06-view-nodes-ranked-by-resource-usage.adoc @@ -0,0 +1,45 @@ +--- +title: "查看节点资源用量排行" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 集群状态, 资源用量" +description: "介绍如何按照特定资源的用量对节点进行排序。" +weight: 06 +--- + +:ks_permission: **监控查看** +:ks_navigation: **监控告警 > 集群状态** + + +本节介绍如何按照特定资源的用量对节点进行排序。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + + + +== 操作步骤 + +include::../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**集群状态**页面,点击**资源用量排行**页签查看各节点的资源使用情况。 ++ +-- +* 在左上角点击下拉列表可选择按照 CPU 用量、CPU 平均负载、内存用量、磁盘用量、Inode 用量或容器组用量对节点进行排序。 + +include::../../../../../_custom/clusterManagement/clusterStatus/clusterStatus-oper-sortAscendingDescending.adoc[] + +include::../../../../../_custom/clusterManagement/clusterStatus/clusterStatus-oper-exportJsonData.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/_index.adoc new file mode 100644 index 000000000..c383597bd --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/03-cluster-status/_index.adoc @@ -0,0 +1,10 @@ +--- +title: "集群状态" +keywords: "Kubernetes, {ks_product}, 监控告警, 集群状态" +description: "介绍如何查看集群状态。" +weight: 03 +layout: "second" +--- + + +本节介绍如何查看集群状态。集群状态展示集群资源的监控数据和用量排行情况。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/01-view-resource-usage.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/01-view-resource-usage.adoc new file mode 100644 index 000000000..5941e9076 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/01-view-resource-usage.adoc @@ -0,0 +1,62 @@ +--- +title: "查看应用资源用量" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 资源用量" +description: "介绍如何查看应用资源用量的监控数据。" +weight: 01 +--- + +:ks_permission: **监控查看** +:ks_navigation: **监控告警 > 应用资源** + + +本节介绍如何查看应用资源用量。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + + + +== 操作步骤 + +include::../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**应用资源**页面,点击**资源用量**页签查看集群资源用量、应用资源用量和项目数量。 ++ +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|集群资源用量 +|当前集群已使用的 CPU 和内存资源数量。 + +|应用资源用量 +|当前集群中已创建的部署、有状态副本集、守护进程集、任务、定时任务、持久卷声明、服务、应用路由、容器组的数量。 + +|项目数量 +|当前集群中的项目数量。 +|=== + ++ +-- +* 点击**集群资源用量**和**应用资源用量**中的折线图,查看资源用量随时间变化的详细信息。 + +include::../../../../../../_ks_components/oper-selectTimeRange.adoc[] + +include::../../../../../../_ks_components/oper-Autorefresh.adoc[] + +include::../../../../../../_ks_components/oper-refreshData.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/02-view-projects-ranked-by-resource-usage.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/02-view-projects-ranked-by-resource-usage.adoc new file mode 100644 index 000000000..58b9b2d61 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/02-view-projects-ranked-by-resource-usage.adoc @@ -0,0 +1,45 @@ +--- +title: "查看项目资源用量排行" +keywords: "Kubernetes, {ks_product}, 集群管理, 应用资源,用量排行" +description: "介绍如何查看项目资源用量排行。" +weight: 02 +--- + +:ks_permission: **监控查看** +:ks_navigation: **监控告警 > 应用资源** + + +本节介绍如何查看项目资源用量排行。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 + + + +== 查看用量排行 + +include::../../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**应用资源**页面,点击**用量排行**页签查看各项目的资源使用情况。 ++ +-- +* 在列表左上角点击下拉列表可选择按照 CPU 用量、内存用量、容器组数量、出站流量或入站流量对项目进行排序。 + +include::../../../../../_custom/clusterManagement/clusterStatus/clusterStatus-oper-sortAscendingDescending.adoc[] + +include::../../../../../_custom/clusterManagement/clusterStatus/clusterStatus-oper-exportJsonData.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/_index.adoc new file mode 100644 index 000000000..67a96ccd6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/04-application-resources/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "应用资源" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 应用资源" +description: "介绍如何查看应用资源数据。" +weight: 04 +layout: "second" +--- + + + +本节介绍如何查看应用资源数据。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/01-create-a-custom-monitoring-dashboard.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/01-create-a-custom-monitoring-dashboard.adoc new file mode 100644 index 000000000..5b6bdee90 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/01-create-a-custom-monitoring-dashboard.adoc @@ -0,0 +1,41 @@ +--- +title: "创建自定义监控面板" +keywords: "Kubernetes, {ks_product}, 集群管理, 自定义监控面板, 创建自定义监控面板" +description: "介绍如何创建自定义监控面板。" +weight: 01 +--- + +:ks_permission: **监控管理** +:ks_navigation: **监控告警 > 自定义监控** + + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-desc-createACustomMonitoringDashboard.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../../ + +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-prer-exposeMetrics.adoc[] + +* 您需要在用于暴露工作负载的服务上设置监控导出器以声明提供应用程序监控指标的路径。{ks_product_right}将根据监控导出器的相关参数获取应用程序的监控指标。有关更多信息,请参阅link:../../08-edit-a-metrics-exporter/[编辑监控导出器]。 + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-oper-createACustomMonitoringDashboard.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/02-view-a-custom-monitoring-dashboard.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/02-view-a-custom-monitoring-dashboard.adoc new file mode 100644 index 000000000..9e2c398cf --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/02-view-a-custom-monitoring-dashboard.adoc @@ -0,0 +1,32 @@ +--- +title: "查看自定义监控面板" +keywords: "Kubernetes, {ks_product}, 集群管理, 自定义监控面板, 查看自定义监控面板" +description: "介绍如何查看自定义监控面板。" +weight: 02 +--- + +:ks_permission: **监控查看** +:ks_navigation: **监控告警 > 自定义监控** + + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-desc-viewACustomMonitoringDashboard.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../../ + +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-oper-viewACustomMonitoringDashboard.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/03-edit-custom-monitoring-dashboard-information.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/03-edit-custom-monitoring-dashboard-information.adoc new file mode 100644 index 000000000..a0c379dc4 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/03-edit-custom-monitoring-dashboard-information.adoc @@ -0,0 +1,33 @@ +--- +title: "编辑自定义监控面板信息" +keywords: "Kubernetes, {ks_product}, 集群管理, 自定义监控面板, 编辑自定义监控面板信息" +description: "介绍如何编辑自定义监控面板的信息。" +weight: 03 +--- + +:ks_permission: **监控管理** +:ks_navigation: **监控告警 > 自定义监控** + + +本节介绍如何编辑自定义监控面板的信息。 + +您可以编辑自定义监控面板的别名和描述。{ks_product_right}不支持编辑自定义监控面板的名称。 + +== 前提条件 + +:relfileprefix: ../../../../../ + +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-oper-editCustomMonitoringDashboardInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/04-edit-a-custom-monitoring-dashboard.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/04-edit-a-custom-monitoring-dashboard.adoc new file mode 100644 index 000000000..9016941bf --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/04-edit-a-custom-monitoring-dashboard.adoc @@ -0,0 +1,32 @@ +--- +title: "编辑自定义监控面板" +keywords: "Kubernetes, {ks_product}, 集群管理, 自定义监控面板, 编辑自定义监控面板" +description: "介绍如何编辑自定义监控面板。" +weight: 04 +--- + +:ks_permission: **监控管理** +:ks_navigation: **监控告警 > 自定义监控** + + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-desc-editACustomMonitoringDashboard.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../../ + +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-oper-editACustomMonitoringDashboard.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/05-delete-custom-monitoring-dashboards.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/05-delete-custom-monitoring-dashboards.adoc new file mode 100644 index 000000000..a7fdd8732 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/05-delete-custom-monitoring-dashboards.adoc @@ -0,0 +1,44 @@ +--- +title: "删除自定义监控面板" +keywords: "Kubernetes, {ks_product}, 集群管理, 自定义监控面板, 删除自定义监控面板" +description: "介绍如何删除自定义监控面板。" +weight: 05 +--- + +:ks_permission: **监控管理** +:ks_navigation: **监控告警 > 自定义监控** + + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-desc-deleteCustomMonitoringDashboards.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../../ + +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +== 删除单个自定义监控面板 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-oper-deleteASingleCustomMonitoringDashboard.adoc[] + + +== 批量删除自定义监控面板 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-oper-deleteMultipleCustomMonitoringDashboards.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/_index.adoc new file mode 100644 index 000000000..4cb6e8ed6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/05-custom-monitoring/_index.adoc @@ -0,0 +1,19 @@ +--- +title: "自定义监控" +keywords: "Kubernetes, {ks_product}, 集群管理, 自定义监控面板" +description: "介绍如何使用自定义监控面板。" +weight: 05 +layout: "second" +--- + + + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-desc-customMonitoringDashboards.adoc[] + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-desc-howToUse.adoc[] + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-desc-exposeMetrics.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-oper-useCustomMonitoringDashboard.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/08-edit-a-metrics-exporter.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/08-edit-a-metrics-exporter.adoc new file mode 100644 index 000000000..654cb901e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/08-edit-a-metrics-exporter.adoc @@ -0,0 +1,46 @@ +--- +title: "编辑监控导出器" +keywords: "Kubernetes, {ks_product}, 项目管理, 工作负载, 服务, 编辑监控导出器" +description: "介绍如何编辑监控导出器。" +weight: 08 +--- + +:ks_permission: **应用负载管理** +:ks_navigation: **应用负载 > 服务** + + +include::../../../../_custom/clusterManagement/services/services-desc-editAMetricsExporter.adoc[] + +include::../../../../_custom/clusterManagement/customMonitoringDashboards/customMonitoringDashboards-desc-exposeMetrics.adoc[] + ++ + +include::../../../../_custom/clusterManagement/services/services-oper-exposeMetrics.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +include::../../../../_custom/clusterManagement/services/services-prer-exposeMetrics.adoc[] + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/services/services-oper-openDetailsPage.adoc[] + ++ + +include::../../../../_custom/clusterManagement/services/services-oper-editAMetricsExporter.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/_index.adoc new file mode 100644 index 000000000..c6df2b9fb --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/05-monitoring/_index.adoc @@ -0,0 +1,47 @@ +--- +title: "WhizardTelemetry 监控" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心" +description: "介绍如何使用“WhizardTelemetry 监控”扩展组件。" +weight: 05 +layout: "second" +--- + + +本节介绍如何使用“WhizardTelemetry 监控”扩展组件。 + +WhizardTelemetry 监控是 WhizardTelemetry 可观测平台中提供监控功能的扩展组件,其中包含了 Whizard 可观测中心。可提供多租户视角的云原生资源监控能力, 包括针对多集群、节点、工作负载、GPU、K8s 控制面等对象的核心监控指标实时和历史数据展示等功能。 + +本节仅介绍单集群环境下的监控功能。有关单集群的告警功能,请参阅 link:../06-alerting[WhizardTelemetry 告警]。有关多集群的监控和告警功能,请参阅 link:../07-whizard[Whizard 可观测中心]。 + +安装“WhizardTelemetry 监控”扩展组件后,集群和项目的左侧导航栏将显示**监控告警**选项,集群和项目中应用负载下的服务将支持**编辑监控导出器**,以下页面也将显示相关监控指标的数据: + +[%header,cols="1a,3a"] +|=== +|模块 +|页面 + +|集群管理 +| +* 概览页面; +* 集群节点、项目的列表和详情页; +* 工作负载、任务、容器组、服务、容器组 IP 池、持久卷声明的详情页; +* 集群设置的基本信息页面。 + +|企业空间管理 +| +* 概览页面; +* 项目列表。 + +|项目管理 +| +* 概览页面; +* 工作负载、任务、容器组、服务、持久卷声明的详情页。 +|=== + +[.admon.note,cols="a"] +|=== +|说明 + +| +有关组件配置的更多信息,请参阅扩展中心“WhizardTelemetry 监控”扩展组件的详情页说明。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/01-create-a-rule-group.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/01-create-a-rule-group.adoc new file mode 100644 index 000000000..a09952031 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/01-create-a-rule-group.adoc @@ -0,0 +1,100 @@ +--- +title: "创建规则组" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 规则组, 创建规则组" +description: "介绍如何创建告警规则组。" +weight: 01 +--- + + +:ks_permission: **规则组管理** +:ks_navigation: **监控告警 > 规则组** + + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-createAnAlertingPolicy.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 告警**扩展组件。 + +:relfileprefix: ../../../../../ + +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +// :relfileprefix: ../../../../../ + +// include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-prer-exposeMetrics.adoc[] + +// :relfileprefix: ./ + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openListPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-setBasicInfo.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-addAlertRule.adoc[] ++ +==== +include::../../../../../_custom/platformManagement/observabilityCenter/ruleGroups/ruleGroups-para-commonParameters_new.adoc[] + +* 规则模板 ++ +-- +通过下拉列表选择监控目标和触发条件。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|资源类型 +|需要监控的工作负载的类型,如部署、有状态副本集、守护进程集。仅显示在项目的告警规则设置中。 + +|监控目标 +|需要监控的目标,如集群节点、工作负载等。 + +include::../../../../../_custom/platformManagement/observabilityCenter/ruleGroups/ruleGroups-para-triggerCondition.adoc[] +|=== +-- + +* 自定义规则 ++ +-- +通过 PromQL 表达式指定监控目标和触发条件。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/platformManagement/observabilityCenter/ruleGroups/ruleGroups-para-duration.adoc[] + +|告警级别 +| +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-para-alertLevel.adoc[] + +include::../../../../../_custom/platformManagement/observabilityCenter/ruleGroups/ruleGroups-para-ruleExpression.adoc[] +|=== +-- +==== + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-clickOK.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/02-view-a-rule-group-list.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/02-view-a-rule-group-list.adoc new file mode 100644 index 000000000..2ab199265 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/02-view-a-rule-group-list.adoc @@ -0,0 +1,46 @@ +--- +title: "查看规则组列表" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 规则组, 查看规则组列表" +description: "介绍如何查看告警规则组列表。" +weight: 02 +--- + +:ks_permission: **规则组查看** +:ks_navigation: **监控告警 > 规则组** + + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-viewAnAlertingPolicyList.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 告警**扩展组件。 + + +:relfileprefix: ../../../../../ + +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openListPage.adoc[] ++ +==== +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-para-alertingPolicyList.adoc[] + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-searchForAlertingPolicies.adoc[] + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/03-view-rule-group-details.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/03-view-rule-group-details.adoc new file mode 100644 index 000000000..f53471088 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/03-view-rule-group-details.adoc @@ -0,0 +1,39 @@ +--- +title: "查看规则组详情" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 规则组, 查看规则组详情" +description: "介绍如何查看规则组详情。" +weight: 03 +--- + +:ks_permission: **规则组查看** +:ks_navigation: **监控告警 > 规则组** + + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-viewAlertingPolicyDetails.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 告警**扩展组件。 + +:relfileprefix: ../../../../../ + +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openDetailsPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-viewAlertingPolicyDetails.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/04-edit-rule-group-information.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/04-edit-rule-group-information.adoc new file mode 100644 index 000000000..84e1a3866 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/04-edit-rule-group-information.adoc @@ -0,0 +1,43 @@ +--- +title: "编辑规则组信息" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 规则组, 编辑规则组信息" +description: "介绍如何编辑规则组信息。" +weight: 04 +--- + +:ks_permission: **规则组管理** +:ks_navigation: **监控告警 > 规则组** + + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-editRuleGroupInformation.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 告警**扩展组件。 + +:relfileprefix: ../../../../../ + +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-clickEditInformation.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-editRuleGroupInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/05-edit-alert-rules.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/05-edit-alert-rules.adoc new file mode 100644 index 000000000..5bbb1f583 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/05-edit-alert-rules.adoc @@ -0,0 +1,43 @@ +--- +title: "编辑告警规则" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 规则组, 编辑告警规则" +description: "介绍如何编辑规则组中的告警规则。" +weight: 05 +--- + +:ks_permission: **规则组管理** +:ks_navigation: **监控告警 > 规则组** + + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-editAnAlertingPolicy.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 告警**扩展组件。 + +:relfileprefix: ../../../../../ + +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-editAnAlertingPolicy.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-editAlertRules.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/06-disable-and-enable-rule-groups.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/06-disable-and-enable-rule-groups.adoc new file mode 100644 index 000000000..753330028 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/06-disable-and-enable-rule-groups.adoc @@ -0,0 +1,55 @@ +--- +title: "禁用和启用规则组" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 规则组, 禁用和启用规则组" +description: "介绍如何禁用和启用告警规则组。" +weight: 06 +--- + +:ks_permission: **规则组管理** +:ks_navigation: **监控告警 > 规则组** + + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-disableAndEnablerRuleGroups.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 告警**扩展组件。 + +:relfileprefix: ../../../../../ + +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +== 禁用和启用单个规则组 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-disableAndEnableASingleRuleGroup.adoc[] + + +== 批量禁用和启用规则组 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openListPage.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-disableAndEnableMultipleRuleGroups.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/07-delete-rule-groups.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/07-delete-rule-groups.adoc new file mode 100644 index 000000000..3d9391a72 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/07-delete-rule-groups.adoc @@ -0,0 +1,47 @@ +--- +title: "删除规则组" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 规则组, 编辑规则组" +description: "介绍如何删除规则组。" +weight: 07 +--- + +:ks_permission: **规则组管理** +:ks_navigation: **监控告警 > 规则组** + + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-deleteAlertingPolicies.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 告警**扩展组件。 + +:relfileprefix: ../../../../../ + +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +== 删除单个规则组 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-deleteASingleAlertingPolicy.adoc[] + + +== 批量删除规则组 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-deleteMultipleAlertingPolicies.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/08-reset-built-in-rule-groups.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/08-reset-built-in-rule-groups.adoc new file mode 100644 index 000000000..2af5dfc16 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/08-reset-built-in-rule-groups.adoc @@ -0,0 +1,61 @@ +--- +title: "重置内置规则组" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 告警管理, 规则组, 删除规则组" +description: "介绍如何重置内置规则组。" +weight: 08 +--- + +:ks_permission: **规则组管理** +:ks_navigation: **监控告警 > 规则组** + + +本节介绍如何重置内置规则组。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +* {ks_product_right}仅支持重置内置规则组,不支持重置自定义规则组。 +* 项目中没有内置规则组。 +|=== + +[.admon.warning,cols="a"] +|=== +|警告 + +| +规则组重置后不能恢复,请谨慎执行此操作。 +|=== + + + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 告警**扩展组件。 + +:relfileprefix: ../../../../../ + +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**规则组**页面,点击**内置规则组**打开规则组列表。 + +. 在需要重置的规则组右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**重置**。 + +. 在**重置规则组**对话框,点击**确定**。 + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/_index.adoc new file mode 100644 index 000000000..1bd79efbe --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/03-rule-groups/_index.adoc @@ -0,0 +1,24 @@ +--- +title: "规则组" +keywords: "Kubernetes, {ks_product}, 集群管理, 规则组" +description: "介绍如何创建、编辑和查看告警规则组。" +weight: 03 +layout: "second" +--- + +本节介绍如何在集群和项目中创建、编辑、启用、禁用和查看告警规则组。 + +创建规则组后,系统可在特定监控指标满足预设条件和持续时间时生成告警。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +- {ks_product_right}为集群提供了内置规则组,同时也支持自定义规则组。若已启用 Whizard 可观测中心,内置规则组只能在 Whizard 可观测中心中进行管理。有关更多信息,请参阅 link:../../07-whizard/05-alert-management/01-rule-groups/[Whizard 规则组]。 + +- 在项目中,只支持自定义规则组。 +|=== + + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/04-alerts/01-view-an-alert-list.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/04-alerts/01-view-an-alert-list.adoc new file mode 100644 index 000000000..caef8cfb2 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/04-alerts/01-view-an-alert-list.adoc @@ -0,0 +1,46 @@ +--- +title: "查看告警列表" +keywords: "Kubernetes, {ks_product}, 集群管理, 告警, 查看告警列表" +description: "介绍如何查看告警列表。" +weight: 01 +--- + +:ks_permission: **告警查看** +:ks_navigation: **监控告警 > 告警** + + +include::../../../../../_custom/clusterManagement/alerts/alerts-desc-viewAnAlertingMessageList.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 告警**扩展组件。 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../..//_custom/clusterManagement/alerts/alerts-oper-openListPage.adoc[] + ++ +==== +include::../../../../../_custom/clusterManagement/alerts/alerts-para-alertingMessageList.adoc[] + +include::../../../../../_custom/clusterManagement/alerts/alerts-oper-searchForAlertingMessages_new.adoc[] + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/04-alerts/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/04-alerts/_index.adoc new file mode 100644 index 000000000..1ede1ca08 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/04-alerts/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "告警" +keywords: "Kubernetes, {ks_product}, 集群管理, 告警" +description: "介绍如何使用告警功能。" +weight: 04 +layout: "second" +--- + + + +本节介绍如何使用告警功能。 + +告警由系统根据告警规则组生成。当告警规则组中设置的指标满足预设的条件和持续时间时,系统将生成告警。当指标不再满足预设的条件时,告警将被系统自动清除。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/_index.adoc new file mode 100644 index 000000000..5fdd2d9aa --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/06-alerting/_index.adoc @@ -0,0 +1,93 @@ +--- +title: "WhizardTelemetry 告警" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警" +description: "介绍如何使用“WhizardTelemetry 告警”扩展组件。" +weight: 06 +layout: "second" +--- + +本节介绍如何使用“WhizardTelemetry 告警”扩展组件。 + +WhizardTelemetry 告警基于 KubeSphere 采集的监控数据,可针对不同资源类型和监控指标,提供平台、集群及项目视角的告警及告警规则管理功能。 + +安装“WhizardTelemetry 告警”扩展组件后,集群和项目左侧导航栏的**监控告警**菜单下将显⽰**告警**和**规则组**选项。 + +//attention +[.admon.attention,cols="a"] +|=== +| 注意 + +| +- WhizardTelemetry 告警依赖 WhizardTelemetry 平台服务和 WhizardTelemetry 监控,因此在安装 WhizardTelemetry 告警之前必须先安装 WhizardTelemetry 平台服务和 WhizardTelemetry 监控两个扩展组件,否则告警相关功能无法正常使用! + +- 为了及时收到系统告警消息,建议同时安装 WhizardTelemetry 通知扩展组件。 +|=== + +**配置说明:** + +[.admon.attention,cols="a"] +|=== +|注意 + +| +如果在安装 WhizardTelemetry 告警之后,对 WhizardTelemetry 监控是否启用 Whizard 可观测中心进行了变更,请按以下说明更新WhizardTelemetry 告警的配置。 +|=== + +* 当 **WhizardTelemetry 监控**扩展组件未启用 Whizard 可观测中心时: + +. 安装 **WhizardTelemetry 告警**扩展组件时,设置 `global.rules.distributionMode` 为 Member。 + +. 配置 `agent.ruler.alertmanagersUrl` 为 alertmanager-proxy 服务地址(该服务由 WhizardTelemetry 通知提供,安装在 host 集群,默认可在 http://:31093 访问)。 ++ +-- +[,yaml] +---- +global: + rules: + distributionMode: Member + +agent: + ruler: + alertmanagersUrl: + - 'http://:31093' +---- + +[.admon.note,cols="a"] +|=== +|说明 + +| +如果未启用 WhizardTelemetry 通知,希望将告警发送到外部 alertmanager 时,请将 `agent.ruler.alertmanagersUrl` 配置为外部服务地址。 +|=== +-- + +* 当 **WhizardTelemetry 监控**扩展组件已启用 Whizard 可观测中心时: ++ +==== +安装 **WhizardTelemetry 告警**扩展组件时,保持 `global.rules.distributionMode` 为 None。 + +[,yaml] +---- +global: + rules: + distributionMode: None +---- + +在该场景下,告警默认直接推送到 alertmanager 服务(该服务由 WhizardTelemetry 通知提供,安装在 host 集群)。保持如下默认配置即可。 + +[,yaml] +---- +extension: + ruler: + alertmanagersUrl: + - 'dnssrv+http://whizard-notification-alertmanager-headless.kubesphere-monitoring-system.svc:9093' +---- + +[.admon.note,cols="a"] +|=== +|说明 + +| +如果未启用 WhizardTelemetry 通知,希望将告警发送到外部 alertmanager 时,请将 `extension.ruler.alertmanagersUrl` 配置为外部服务地址。 +|=== +==== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/01-enable-whizard.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/01-enable-whizard.adoc new file mode 100644 index 000000000..1501bcd89 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/01-enable-whizard.adoc @@ -0,0 +1,89 @@ +--- +title: "启用 Whizard 可观测中心" +description: "介绍如何启用 Whizard 可观测中心。" +weight: 01 +--- + +本节介绍如何配置相关扩展组件,以启用 Whizard 可观测中心。 + +为了使用 Whizard 可观测中心的完整功能,您需要安装并启用 WhizardTelemetry 平台服务、 WhizardTelemetry 监控以及 WhizardTelemetry 告警扩展组件,并进行以下配置。 + +== 前提条件 + +* 您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../05-users-and-roles/01-users/[用户]和link:../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + +* 已安装 **WhizardTelemetry 平台服务**、 **WhizardTelemetry 监控**以及 **WhizardTelemetry 告警**扩展组件。 + +* 已在**平台设置 > 许可证**页面导入分布式云可观测中心的 license,否则,无法看到 Whizard 可观测中心的入口。 + +== 操作步骤 + +. 以具有 **platform-admin** 角色的用户登录{ks_product_left} Web 控制台。 +. 点击**扩展中心**。 +. 点击已安装的组件名称,进入组件详情页。 +. 点击组件图标下的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],选择**扩展组件配置**。 ++ +-- +**WhizardTelemetry 平台服务** + +将配置文件中的 `whizard-telemetry.config.observability.enabled` 参数设置为 true,然后点击**确定**。 + +[,yaml] +---- +whizard-telemetry: + config: + observability: + enabled: true + endpoint: "http://query-frontend-whizard-operated.kubesphere-monitoring-system.svc:10902" +---- +**WhizardTelemetry 监控** + +修改配置文件的以下部分,然后点击**确定**。 + +[,yaml] +---- +whizard-monitoring-helper: + whizardHelper: + enabled: true ## set true to enable whizard + +whizard: + enabled: true + +frontend: + enabled: true + +whizardAgentProxy: + enabled: true + +whizard-agent-proxy: + config: + gatewayUrl: "http://172.31.73.206:30990" ## set whizard gateway url,default is http://{host_cluster_node_ip}:30990 + +kube-prometheus-stack: + prometheus: + agentMode: true # agentMode need to be set to true when enable whizard +---- + +**WhizardTelemetry 告警** + +确保 `global.rules.distributionMode` 为 None。 + +[,yaml] +---- +global: + rules: + distributionMode: None +---- + +-- +. 编辑完成后,点击顶部导航栏上的image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,即可发现 **Whizard 可观测中心**图标。 ++ +-- +[.admon.note,cols="a"] +|=== +|说明 + +| +启用过程可能需要一定时间,请等待启用完成。 +|=== +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/01-view-monitoring-data-of-multiple-clusters.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/01-view-monitoring-data-of-multiple-clusters.adoc new file mode 100644 index 000000000..56548669e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/01-view-monitoring-data-of-multiple-clusters.adoc @@ -0,0 +1,86 @@ +--- +title: "查看多集群监控数据" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心, 查看多集群监控数据" +description: "介绍如何查看多集群监控数据。" +weight: 01 +--- + + +本节介绍如何查看多集群的监控数据。 + + +== 前提条件 + +* 您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + +* host 集群和需要监控的成员集群需要启用 Whizard 可观测中心。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +如果成员集群未启用 Whizard 可观测中心,Whizard 可观测中心将无法获取成员集群的数据。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ +-- +Whizard 可观测中心的**概览**页面显示所有集群的监控信息。 + +[%header,cols="1a,4a"] +|=== +|功能区 |描述 + +|已创建资源数量 +|显示被监控的所有集群、节点、项目、容器组、部署、有状态副本集、守护进程集、任务、定时任务、卷、服务、应用路由的数量。 + +|资源使用情况 +|显示被监控的所有集群的所有节点的 CPU、内存、磁盘使用情况,以及可已创建容器组数量占可创建容器组最大数量的百分比。默认情况下每个节点最多可以创建 110 个容器组。 + +对于 CPU 和内存,将光标悬停在image:/images/ks-qkcp/zh/icons/eye.svg[eye,18,18]可查看已分配给容器和项目的资源预留和上限数量。 + +// |集群成员和集群角色 +// |显示被监控的所有集群的集群成员和集群角色数量。 + +|全局告警 +|显示全局告警规则组产生的告警数量及最近的告警消息。此处显示的告警不包括集群和项目告警规则组产生的告警。全局告警规则组由平台管理员在 Whizard 可观测中心管理。 + +告警级别的类型包括**提醒、警告、重要和紧急**。 + +告警状态的类型包括: + +include::../../../../../_custom/clusterManagement/alerts/alerts-para-alertingStatus.adoc[] + +|容器组 +|显示被监控的所有集群的各种类型容器组的数量。 + +容器组状态类型包括: + +include::../../../../../_custom/clusterManagement/pods/pods-para-podStatus_overview.adoc[] + +容器组 QoS(服务质量)类型包括: + +include::../../../../../_custom/clusterManagement/pods/pods-para-qosTypes.adoc[] +|=== +-- + +. 在页面右上角,点击**选择集群**,选择需要监控的集群。概览页面将展示选中集群的监控信息。 + +. 点击**收起集群列表/展开集群列表**,隐藏或展示右侧的集群列表。 ++ +-- +* 点击集群列表中的集群名称,进入该集群的概览页面。 + +* 点击image:/images/ks-qkcp/zh/icons/row.svg[row,18,18]和image:/images/ks-qkcp/zh/icons/list_view.svg[list_view,18,18]以列表或缩略图形式查看集群信息。 +-- + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/03-resource-ranking.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/03-resource-ranking.adoc new file mode 100644 index 000000000..149779c66 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/03-resource-ranking.adoc @@ -0,0 +1,51 @@ +--- +title: "查看资源用量排行" +keywords: "Kubernetes, {ks_product}, 多集群, Whizard 可观测中心, 资源用量排行" +description: "介绍如何查看资源用量排行。" +weight: 03 +--- + +:ks_navigation: **资源监控 > 资源统计排行** + + +本节介绍如何查看资源用量排行,即当前资源用量最多的集群、节点、项目和容器组。 + + +== 前提条件 + +* 您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + +* host 集群和需要监控的成员集群需要启用 Whizard 可观测中心。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +如果成员集群未启用 Whizard 可观测中心,Whizard 可观测中心将无法获取成员集群的数据。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + + +. 在**集群**、**节点**、**项目**和**容器组**页签,查看资源用量详情。 ++ +-- +* 点击**选择集群**,选择需要监控的集群。 + +* 点击下拉列表可选择对象类型和排序依据。 + +include::../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/_index.adoc new file mode 100644 index 000000000..29d84fa19 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/03-resource-monitoring/_index.adoc @@ -0,0 +1,7 @@ +--- +title: "资源监控" +keywords: "Kubernetes, {ks_product}, 多集群, Whizard 可观测中心, 资源监控" +description: "介绍如何查看多集群的资源监控数据。" +weight: 03 +layout: "second" +--- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/01-create-a-rule-group.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/01-create-a-rule-group.adoc new file mode 100644 index 000000000..c10206673 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/01-create-a-rule-group.adoc @@ -0,0 +1,157 @@ +--- +title: "创建规则组" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 告警管理, 规则组, 创建规则组" +description: "介绍如何创建告警规则组。" +weight: 01 +--- + +// :ks_permission: **规则组管理** +:ks_navigation: **全局告警 > 自定义规则组** + + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-createAnAlertingPolicy.adoc[] + +[.admon.note,cols="a"] +|=== +|说明 + +| +{ks_product_right}仅支持创建自定义规则组,不支持创建内置规则组。 +|=== + +== 前提条件 + +* 您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + +* 如需对应用程序的指标进行监控,您需要配置运行在容器中的应用程序,将符合 link:https://prometheus.io/docs/instrumenting/clientlibs/[Prometheus 规范]的监控指标暴露在某个服务端路径下,并在用于暴露工作负载的服务上设置监控导出器,以声明提供应用程序监控指标的路径。有关更多信息,请参阅link:../../../../05-monitoring/08-edit-a-metrics-exporter/[编辑监控导出器]。 + + +== 操作步骤 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-setBasicInfo.adoc[] + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-addAlertRule.adoc[] ++ +include::../../../../../../_custom/platformManagement/observabilityCenter/ruleGroups/ruleGroups-para-commonParameters_new.adoc[] + +* 规则模板 ++ +-- +通过下拉列表选择监控目标和触发条件。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|监控目标 +|需要监控的集群节点或工作负载。 + +include::../../../../../../_custom/platformManagement/observabilityCenter/ruleGroups/ruleGroups-para-triggerCondition.adoc[] +|=== +-- + +* 自定义规则 ++ +-- +通过 PromQL 表达式指定监控目标和触发条件。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|集群设置 +|选择需要监控的资源所在的集群。 + +include::../../../../../../_custom/platformManagement/observabilityCenter/ruleGroups/ruleGroups-para-duration.adoc[] + +|告警级别 +| +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-para-alertLevel.adoc[] + +include::../../../../../../_custom/platformManagement/observabilityCenter/ruleGroups/ruleGroups-para-ruleExpression.adoc[] +|=== +-- + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-clickOK.adoc[] + +// == 创建规则组示例 +// 创建一个 Process Exporter 全局告警规则,以监控集群节点上的僵尸进程。当节点上有僵尸进程的时候,就会触发告警。 + +// 创建 Process Exporter 告警规则需要启⽤ Process Exporter 扩展组件。 + +// === 启用 Process Exporter 扩展组件 + +// . 以具有 **platform-admin** 角色的用户登录{ks_product_left} Web 控制台。 + +// . 将光标悬停在页面右下角的image:/images/ks-qkcp/zh/icons/hammer.svg[hammer,18,18]图标,然后在菜单中选择 **kubectl**。 + +// . 在 **kubectl** 对话框,执行以下命令编辑集群配置文件: +// + +// -- +// // bash +// [,bash] +// ---- +// kubectl edit cc ks-installer -n kubesphere-system +// ---- +// -- + +// . 在集群配置文件中,将 **spec.monitoring.process_exporter.enabled** 参数设置为 **true**,然后保存文件。## 此处未找到,其他部分已确认 ok +// + +// -- +// // YAML +// [,yaml] +// ---- +// spec: +// monitoring: +// process_exporter: +// enabled: true +// ---- + +// // Note +// include::../../../../../../../_ks_components/admonitions/note.adoc[] + +// include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-desc-waitForExtensionEnabled.adoc[] + +// include::../../../../../../../_ks_components/admonitions/admonEnd.adoc[] +// -- + +// === 创建 Process Exporter 规则组 + +// . 以具有 **platform-admin** 角色的用户登录{ks_product_left} Web 控制台。 +// . 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 +// . 在左侧导航栏选择**监控告警 > 规则组**。 +// . 在**规则组**页面,点击**自定义规则组**打开规则组列表。 +// . 在页面点击**创建**。 +// . 在**基本信息**页签,设置规则组的基本信息,然后点击**下一步**。 +// . 在**告警规则**页签,点击**添加告警规则**,选择**自定义规则**。 +// . 配置**集群设置**、**规则名称**、**告警级别**、**概要**。 +// . 在**告警规则表达式**下填写此表达式: +// + +// -- +// // bash +// [,bash] +// ---- +// sum by (cluster, job, instance, groupname)(namedprocess_namegroup_states{state="Zombie"}) > 0 +// ---- +// -- +// include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-clickOK.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/02-view-a-rule-group-list.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/02-view-a-rule-group-list.adoc new file mode 100644 index 000000000..90998d392 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/02-view-a-rule-group-list.adoc @@ -0,0 +1,56 @@ +--- +title: "查看规则组列表" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心, 告警管理, 规则组, 查看规则组列表" +description: "介绍如何查看告警规则组列表。" +weight: 02 +--- + +// :ks_permission: **规则组查看** +:ks_navigation: **全局告警 > 内置规则组/自定义规则组** + + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-viewAnAlertingPolicyList.adoc[] + + +== 前提条件 + +您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + + +== 操作步骤 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +// include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openListPage.adoc[] ++ +==== +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-para-alertingPolicyList_whizard.adoc[] + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-searchForAlertingPolicies.adoc[] + +include::../../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +* 当添加或移除集群时,规则组列表的集群列信息不会同步更新。 + +* 移除集群时,也不会将仅适用该集群的规则组自动删除。 + +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/03-view-rule-group-details.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/03-view-rule-group-details.adoc new file mode 100644 index 000000000..b958ca493 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/03-view-rule-group-details.adoc @@ -0,0 +1,40 @@ +--- +title: "查看规则组详情" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心, 告警管理, 规则组, 查看规则组详情" +description: "介绍如何查看规则组详情。" +weight: 03 +--- + +// :ks_permission: **规则组查看** +// :ks_menu: **平台管理 > Whizard 可观测中心** +:ks_navigation: **全局告警 > 内置规则组/自定义规则组** + + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-viewAlertingPolicyDetails.adoc[] + + +== 前提条件 + +您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + + +== 操作步骤 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +// include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openDetailsPage.adoc[] +. 在列表中点击一个规则组的名称打开其详情页面。 + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-viewAlertingPolicyDetails.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/04-edit-rule-group-information.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/04-edit-rule-group-information.adoc new file mode 100644 index 000000000..2922bdaf9 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/04-edit-rule-group-information.adoc @@ -0,0 +1,43 @@ +--- +title: "编辑规则组信息" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard , 告警管理, 规则组, 编辑告警规则" +description: "介绍如何编辑告警规则组的信息。" +weight: 04 +--- + + +// :ks_permission: **规则组管理** +:ks_navigation: **全局告警 > 内置规则组/自定义规则组** + + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-editRuleGroupInformation.adoc[] + + +== 前提条件 + +您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + + +== 操作步骤 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +// include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openListPage.adoc[] + ++ + +. 在需要编辑的规则组右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑信息**。 + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-editRuleGroupInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/05-edit-alert-rules.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/05-edit-alert-rules.adoc new file mode 100644 index 000000000..016133f25 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/05-edit-alert-rules.adoc @@ -0,0 +1,48 @@ +--- +title: "编辑告警规则" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心, 告警管理, 规则组, 编辑告警规则" +description: "介绍如何编辑告警规则组中的告警规则。" +weight: 05 +--- + +// :ks_permission: **规则组管理** +// :ks_menu: **平台管理 > Whizard 可观测中心** +:ks_navigation: **全局告警 > 内置规则组/自定义规则组** + + +本节介绍如何编辑规则组中的告警规则。 + + +== 前提条件 + +您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + + +== 操作步骤 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-editAnAlertingPolicy.adoc[] + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-editAlertRules.adoc[] + ++ + +[.admon.note,cols="a"] +|=== +|说明 + +|对于内置规则组,不支持删除和添加告警规则,只能编辑已有的告警规则。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/06-disable-and-enable-rule-groups.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/06-disable-and-enable-rule-groups.adoc new file mode 100644 index 000000000..f7ec8fd4c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/06-disable-and-enable-rule-groups.adoc @@ -0,0 +1,62 @@ +--- +title: "禁用和启用规则组" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 规则组, 禁用和启用规则组" +description: "介绍如何禁用和启用告警规则组。" +weight: 06 +--- + + +// :ks_permission: **规则组管理** +// :ks_menu: **平台管理 > Whizard 可观测中心** +:ks_navigation: **全局告警 > 内置规则组/自定义规则组** + + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-desc-disableAndEnablerRuleGroups.adoc[] + + +== 前提条件 + +您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + + + +== 禁用和启用单个规则组 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +// include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openListPage.adoc[] + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-disableAndEnableASingleRuleGroup.adoc[] + + +== 批量禁用和启用规则组 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +// include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-openListPage.adoc[] + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-disableAndEnableMultipleRuleGroups.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/07-delete-rule-groups.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/07-delete-rule-groups.adoc new file mode 100644 index 000000000..571f7baa2 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/07-delete-rule-groups.adoc @@ -0,0 +1,68 @@ +--- +title: "删除自定义规则组" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 告警管理, 规则组, 删除规则组" +description: "介绍如何删除告警规则组。" +weight: 07 +--- + +// :ks_permission: **规则组管理** +// :ks_menu: **平台管理 > Whizard 可观测中心** +:ks_navigation: **全局告警 > 自定义规则组** + + +本节介绍如何删除告警规则组。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +{ks_product_right}仅支持删除自定义规则组,不支持删除内置规则组。您可以重置内置规则组。 +|=== + +[.admon.warning,cols="a"] +|=== +|警告 + +| +规则组删除后不能恢复,请谨慎执行此操作。 +|=== + + +== 前提条件 + +您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + + +== 删除单个规则组 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-deleteASingleAlertingPolicy.adoc[] + + +== 批量删除规则组 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-oper-deleteMultipleAlertingPolicies.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/08-reset-built-in-rule-groups.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/08-reset-built-in-rule-groups.adoc new file mode 100644 index 000000000..e6e6a49c3 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/08-reset-built-in-rule-groups.adoc @@ -0,0 +1,54 @@ +--- +title: "重置内置规则组" +keywords: "Kubernetes, {ks_product}, 集群管理, 监控告警, 告警管理, 规则组, 删除规则组" +description: "介绍如何重置内置规则组。" +weight: 08 +--- + +// :ks_permission: **规则组管理** +// :ks_menu: **平台管理 > Whizard 可观测中心** +:ks_navigation: **全局告警 > 内置规则组** + + +本节介绍如何重置内置规则组。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +{ks_product_right}仅支持重置内置规则组,不支持重置自定义规则组。 +|=== + +[.admon.warning,cols="a"] +|=== +|警告 + +| +规则组重置后不能恢复,请谨慎执行此操作。 +|=== + + + + +== 前提条件 + +您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + + +== 操作步骤 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + +. 在需要重置的规则组右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**重置**。 + +. 在**重置规则组**对话框,点击**确定**。 + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/_index.adoc new file mode 100644 index 000000000..9bf75f9cd --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/01-rule-groups/_index.adoc @@ -0,0 +1,12 @@ +--- +title: "规则组" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心, 告警管理, 规则组" +description: "介绍如何在 Whizard 可观测中心使用告警规则组功能。" +weight: 01 +layout: "second" +--- + + +本节介绍如何在 Whizard 可观测中心创建、编辑、启用、禁用和查看全局告警规则组。 + +您可以在 Whizard 可观测中心的规则组页面创建全局告警规则组。区别于用户在集群和项目中创建的规则组,全局规则可用于监控平台管理的所有集群的资源。Whizard 可观测中心的**内置规则组**页面提供内置的规则组,**自定义规则组**页面支持创建规则组。通过规则组使系统在特定监控指标满足预设条件和持续时间时生成告警。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/02-alerts/01-view-an-alert-list.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/02-alerts/01-view-an-alert-list.adoc new file mode 100644 index 000000000..d0f17325b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/02-alerts/01-view-an-alert-list.adoc @@ -0,0 +1,45 @@ +--- +title: "查看告警列表" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心, 告警管理, 告警, 查看告警列表" +description: "介绍如何在 Whizard 可观测中心查看全局告警列表。" +weight: 01 +--- + +// :ks_permission: **告警查看** +:ks_navigation: **全局告警 > 内置告警/自定义告警** + + +本节介绍如何在 Whizard 可观测中心查看全局告警列表。 + +Whizard 可观测中心的**内置告警**和**自定义告警**页面显示系统根据全局告警规则组生成的告警,不包括系统根据集群和项目告警规则组生成的告警。 + + +== 前提条件 + +您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + +== 操作步骤 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +// include::../../../../../../_custom/clusterManagement/alerts/alerts-oper-openListPage.adoc[] ++ +==== +include::../../../../../../_custom/clusterManagement/alerts/alerts-para-alertingMessageList.adoc[] + +include::../../../../../../_custom/clusterManagement/alerts/alerts-oper-searchForAlertingMessages_new.adoc[] + +include::../../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../../_ks_components/oper-customizeColumns.adoc[] +==== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/02-alerts/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/02-alerts/_index.adoc new file mode 100644 index 000000000..f375c3ddb --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/02-alerts/_index.adoc @@ -0,0 +1,14 @@ +--- +title: "告警" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心, 告警管理, 告警" +description: "介绍如何在 Whizard 可观测中心使用告警功能。" +weight: 02 +layout: "second" +--- + + + +本节介绍如何在 Whizard 可观测中心使用告警功能。 + +Whizard 可观测中心的**内置告警**和**自定义告警**页面显示系统根据全局**内置规则组**和全局**自定义规则组**生成的全局告警。当全局告警规则组中设置的指标满足预设的条件和持续时间时,系统将生成告警。当指标不再满足预设的条件时,告警将被系统自动清除。 + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/_index.adoc new file mode 100644 index 000000000..a37696a12 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/05-alert-management/_index.adoc @@ -0,0 +1,10 @@ +--- +title: "全局告警" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心, 全局告警" +description: "介绍如何在 Whizard 可观测中心管理全局告警和全局规则组。" +weight: 05 +layout: "second" +--- + + +本节介绍如何在 Whizard 可观测中心管理全局告警和全局规则组。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/01-pod/01-query-pod.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/01-pod/01-query-pod.adoc new file mode 100644 index 000000000..811d5627f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/01-pod/01-query-pod.adoc @@ -0,0 +1,63 @@ +--- +title: "跨集群查询容器组" +keywords: "Kubernetes, {ks_product}, Whizard 可观测中心, 容器组, 查询, 跨集群" +description: "介绍如何在 Whizard 可观测中心跨集群查询 pod。" +weight: 01 +--- + +// :ks_permission: **告警查看** +:ks_navigation: **资源查询 > 容器组** + + +本节介绍如何在 Whizard 可观测中心跨集群查询容器组。 + +对于单个集群,可在集群的容器组页面根据容器组名称和容器组 IP 地址查询容器组。 + +对于多集群环境,可在 Whizard 可观测中心根据容器组名称或容器组 IP 地址跨集群查询特定容器组的信息。 + + +== 前提条件 + +* 您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../../../05-users-and-roles/01-users/[用户]和link:../../../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + +* host 集群和需要监控的成员集群需要启用 Whizard 可观测中心。 ++ +-- +// Note +include::../../../../../../../_ks_components/admonitions/note.adoc[] + +如果成员集群未启用 Whizard 可观测中心,Whizard 可观测中心将无法获取成员集群的数据。 + +include::../../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + + +== 操作步骤 + +include::../../../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +include::../../../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +include::../../../../../../_custom/clusterManagement/pods/pods-para-podList_whizard.adoc[] + +* 在列表左上角的下拉列表中选择一个集群,可以查看特定集群中的容器组。 + +// include::../../../../../../_custom/clusterManagement/pods/pods-oper-searchForPods.adoc[] +* 在列表上方点击搜索框并设置搜索条件,可按名称、状态、节点、项目或容器组 IP 地址搜索容器组。 + +include::../../../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../../../_ks_components/oper-customizeColumns.adoc[] + +* 点击容器组名称,可进入容器组详情页面。 + +* 点击节点名称,可进入节点详情页面。 + +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/01-pod/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/01-pod/_index.adoc new file mode 100644 index 000000000..9aaa0d358 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/01-pod/_index.adoc @@ -0,0 +1,6 @@ +--- +title: "容器组" +description: "介绍如何跨集群查询容器组。" +weight: 01 +layout: "second" +--- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/_index.adoc new file mode 100644 index 000000000..346a2457a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/07-resource-query/_index.adoc @@ -0,0 +1,7 @@ +--- +title: "资源查询" +keywords: "Kubernetes, {ks_product}, Whizard 可观测中心, 查询资源" +description: "介绍如何跨集群查询资源信息。" +weight: 07 +layout: "second" +--- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/11-set-alert-components.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/11-set-alert-components.adoc new file mode 100644 index 000000000..526fb0254 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/11-set-alert-components.adoc @@ -0,0 +1,148 @@ +--- +title: "设置组件" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心, 设置组件" +description: "介绍如何设置 Whizard 组件。" +weight: 11 +--- + +:ks_menu: **平台管理 > Whizard 可观测中心** + + +本节介绍如何设置 Whizard 可观测中心的组件。 + + +== 前提条件 + +您需要在{ks_product_both}平台具有 **platform-admin** 角色。有关更多信息,请参阅link:../../../../05-users-and-roles/01-users/[用户]和link:../../../../05-users-and-roles/02-platform-roles/[平台角色]。 + + +== 操作步骤 + +include::../../../../_custom/platformManagement/extensionManagement/extensionManagement-oper-logInAsPlatformAdmin.adoc[] + ++ + +. 在页面右上角点击image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,选择 **Whizard 可观测中心**。 + ++ + +. 在**多集群监控**页面右侧,点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**组件设置**页面。 + + +. 在**数据接入**页签,设置以下参数。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|网关设置 +| + +* 组件副本数量: 设置存储网关组件的副本数量,默认值为 2。 + +* 容器配额: 设置 CPU 预留和限制以及内存预留和上限。 + +|数据路由 +| + +* 数据保留副本数量: 设置数据保留组件的副本数量,默认值为 1。 + +* 组件副本数量: 设置数据路由组件的副本数量,默认值为 2。 + +* 容器配额: 设置 CPU 预留和限制以及内存预留和上限。 + +|本地存储 +| + +* 本地数据存储时间: 设置本地数据的存储时间,最小时间至少 3 天,默认为 7 天。 + +* 组件副本数量: 设置本地存储组件的副本数量,默认值为 2。 + +* 容器配额: 设置 CPU 预留和限制以及内存预留和上限。 +|=== +-- + +. 在**数据查询**页签,设置以下参数。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|基础设置 +| + +* 组件副本数量: 设置 Query 组件的副本数量,默认值为 2。 + +* 容器配额: 设置 CPU 预留和限制以及内存预留和上限。 + +|缓存设置 +| + +* 组件副本数量: 设置 Cache 组件的副本数量,默认值为 2。 + +* 容器配额: 设置 CPU 预留和限制以及内存预留和上限。 + +|=== +-- + +. 在**长期存储**页签,点击**启用**启用长期存储组件。启用后,您可以配置对象存储、网关、保留周期与降采样的组件参数。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|对象存储 +| + +* Bucket 名称:S3 对象存储桶的名称。 + +* 区域:您创建 Bucket 的地理区域。 + +* 端点:要连接的 AWS S3 对象存储地址。 + +* Access Key:与 AWS 访问密钥 ID 相关联的密钥。 + +* Secret Key:与 AWS Access Key ID 关联的密钥。 + +**高级设置** + +* HTTP 协议:决定是否开启不安全的 HTTP 协议。 + +* 添加存储类:为对象存储添加用户元数据。开启后需要为对象存储参数添加键值。 + +* HTTP 配置:配置接收方用于与基于 HTTP 的 API 服务通信的 HTTP 客户端。 + +** TLS 证书:开启是否通过提交数字证书证明您的身份或表明您有权访问在线服务。 + +** TLS 连接 + +*** CA 证书:用于验证服务器证书的 CA 文件。 + +*** Cert 文件:用于向服务器进行客户端证书身份验证的证书文件。 + +*** 密钥:用于向服务器进行客户端证书身份验证的密钥文件。 + +*** 服务器名称:ServerName 扩展以指示服务器的名称。 + +*** 服务器证书验证:是否通过提交数字证书证明您的身份或表明您有权访问在线服务。 + +|存储网关 +|设置 CPU 预留和限制以及内存预留和上限。 + +|压缩及降采样 +| + +* 原始数据存储时间:原始数据存储时间,超过此时间将删除原始数据。 + +* 5m 降采样数据存储时间:指定降采样到数据点 5 分钟间隔的数据存储时间。 + +* 1h 降采样数据存储时间:指定降采样到数据点 5 分钟间隔的数据存储时间。 + +* 容器配额:设置 CPU 预留和限制以及内存预留和上限。 +|=== +-- + +. 在**规则计算**页签,设置容器配额。设置完成后,点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/_index.adoc new file mode 100644 index 000000000..fd9dd6b7f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/07-whizard/_index.adoc @@ -0,0 +1,16 @@ +--- +title: "Whizard 可观测中心" +keywords: "Kubernetes, {ks_product}, 平台管理, Whizard 可观测中心" +description: "介绍如何使用 Whizard 可观测中心功能。" +weight: 07 +layout: "second" +--- + + +本节介绍如何使用 Whizard 可观测中心。 + +Whizard 可观测中心功能提供了跨集群的资源监控和告警信息。您可以在 Whizard 可观测中心查看所有集群的汇总监控数据和每个集群的具体监控数据,同时可以在平台层级创建全局告警规则组并查看系统生成的全局告警。 + +link:01-enable-whizard/[启用 Whizard 可观测中心]后,点击{ks_product_both}平台顶部导航栏上的image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,点击 **Whizard 可观测中心**,进入该组件的概览页面。 + + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/01-create-rules-for-auditing.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/01-create-rules-for-auditing.adoc new file mode 100644 index 000000000..089e74a28 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/01-create-rules-for-auditing.adoc @@ -0,0 +1,80 @@ +--- +title: "创建事件/审计的告警规则" +description: "介绍如何为事件和审计创建告警规则。" +weight: 01 +--- + +本节介绍如何为 Kubernetes 原生事件和 Kubernetes/KubeSphere 审计事件定义告警规则。 + + +== 前提条件 + +* 您需要在{ks_product_both}平台具有 **platform-admin** 角色。 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 事件告警**扩展组件。 + + +== 操作步骤 + +. 在任意集群节点上,创建一个 yaml 文件,为该集群定义事件和审计的告警规则。 ++ +-- +点击link:../02-example-rules-for-auditing[此处]查看完整的告警规则示例。请参阅link:../02-example-rules-for-auditing/#_告警规则参数描述[参数描述]设置告警规则的参数。 + +简单示例如下: + +[,yaml] +---- +apiVersion: logging.whizard.io/v1alpha1 +kind: ClusterRuleGroup +metadata: + name: example-auditing-rule + namespace: kubesphere-logging-system +spec: + type: auditing + rules: + - desc: all action not need to be audit + expr: + kind: list + list: + - get + - list + - watch + name: ignore-action + - desc: all operator need to be audit + expr: + kind: list + list: + - create + - delete + - update + - patch + name: action + - desc: pod + expr: + kind: macro + macro: ObjectRef.Resource="pods" + name: pod + - desc: service + expr: + kind: macro + macro: ObjectRef.Resource="services" + name: service + - desc: the alias of the user related to audit event + expr: + alias: User.username + kind: alias + name: user +---- +-- + +. 执行以下命令,创建 CRD(定制资源定义)。 ++ +[,bash] +---- +kubectl apply -f xxx.yaml # 注意替换 yaml 文件的名称 +---- + +. 运行成功后,在**集群管理 > 定制资源定义**页面搜索 **ClusterRuleGroup**。 + +. 点击 **ClusterRuleGroup** 进入详情页,在右侧页面查看、编辑或删除告警规则。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/02-example-rules-for-auditing.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/02-example-rules-for-auditing.adoc new file mode 100644 index 000000000..e4a222cb8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/02-example-rules-for-auditing.adoc @@ -0,0 +1,1227 @@ +--- +title: "事件/审计的告警规则示例" +description: "介绍事件和审计的告警规则示例。" +weight: 02 +--- + +您可参照示例和参数描述,自定义事件和审计的告警规则,然后link:../01-create-rules-for-auditing[创建告警规则]。 + +== 事件告警规则示例 + +[,yaml] +---- +apiVersion: logging.whizard.io/v1alpha1 +kind: ClusterRuleGroup +metadata: + name: events-rules +spec: + type: events + rules: + - name: ContainerCreated + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Pod" and reason="Created" and involvedObject.fieldPath != "" + desc: create new container + enable: true + alerts: + severity: info + - name: ContainerStarted + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Pod" and reason="Started" and involvedObject.fieldPath != "" + desc: start new pod + alerts: + severity: warning + annotations: + summary: start new pod + summaryCn: 创建新容器 + enable: true + - name: ContainerFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="Failed" and involvedObject.fieldPath != "" + desc: Create container failed + enable: true + alerts: + severity: warning + annotations: + summary: Container failed + summaryCn: 容器失败 + - name: ContainerKilling + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Pod" and reason="Killing" and involvedObject.fieldPath != "" + desc: container kill + enable: true + alerts: + severity: warning + annotations: + summary: container killing + summaryCn: 容器停止 + - name: ContainerPreempting + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="Preempting" + desc: container is preempting + alerts: + severity: warning + annotations: + summary: Container is preemting + summaryCn: 容器抢占中 + enable: true + - name: ContainerBackoff + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="BackOff" and involvedObject.fieldPath != "" and count>3 + desc: container back off + enable: true + alerts: + severity: warning + annotations: + summary: Container back-off + summaryCn: 容器回退 + - name: ContainerUnhealthy + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="Unhealthy" and count>3 + desc: container is unhealthy + alerts: + severity: warning + annotations: + summary: Container is unhealthy + summaryCn: 容器状态不良 + enable: true + - name: ContainerProbeWarning + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="ProbeWarning" and count>3 + desc: Warning to perform a probe to the container + alerts: + severity: warning + annotations: + summary: Warning to perform a probe to the container + summaryCn: 容器探测警告 + enable: true + - name: PodKillingExceededGracePeriod + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="ExceededGracePeriod" + desc: Pod killing exceeded specified grace period + enable: true + alerts: + severity: warning + annotations: + summary: Pod killing exceeded specified grace period + summaryCn: pod终止超时 + - name: PodKillFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedKillPod" + desc: Warning to perform a probe to the container + enable: true + alerts: + severity: warning + annotations: + summary: Failed to kill pod + summaryCn: pod终止失败 + - name: PodContainerCreateFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedCreatePodContainer" + desc: Failed to create pod container + enable: true + alerts: + severity: warning + annotations: + summary: Failed to create pod container + summaryCn: pod容器创建失败 + - name: PodFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="Failed" and involvedObject.fieldPath="" + desc: Pod failed + enable: true + alerts: + severity: warning + annotations: + summary: Pod failed + summaryCn: pod失败 + - name: PodNetworkNotReady + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="NetworkNotReady" + desc: Pod network is not ready + enable: true + alerts: + severity: warning + annotations: + summary: Pod network is not ready + summaryCn: Pod网络异常 + - name: ImagePulling + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Pod" and reason="Pulling" + desc: pull images + enable: true + alerts: + severity: warning + - name: ImagePulled + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Pod" and reason="Pulled" + desc: images pulled + enable: true + alerts: + severity: warning + - name: ImagePullPolicyError + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="ErrImageNeverPull" + desc: Wrong image pull policy + enable: true + alerts: + severity: warning + annotations: + summary: Wrong image pull policy + summaryCn: 镜像拉取策略错误 + - name: ImageInspectFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="InspectFailed" + desc: Failed to inspect image + enable: true + alerts: + severity: warning + annotations: + summary: Failed to inspect image + summaryCn: 镜像检查失败 + - name: NodeReady + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Node" and reason="NodeReady" + desc: Pod network is not ready + enable: true + alerts: + severity: warning + - name: NodeSchedulable + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Node" and reason="NodeSchedulable" + desc: node is schedulable + enable: true + alerts: + severity: warning + - name: NodeNotSchedulable + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Node" and reason="NodeNotSchedulable" + desc: node is not schedulable + enable: true + alerts: + severity: warning + - name: KubeletStarting + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Node" and reason="Starting" + desc: kubelet is starting + enable: true + alerts: + severity: warning + - name: KubeletSetupFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Node" and reason="KubeletSetupFailed" + desc: Failed to setup kubelet + enable: true + alerts: + severity: warning + annotations: + summary: Failed to setup kubelet + summaryCn: kubelet安装失败 + - name: VolumeAttachFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedAttachVolume" + desc: Failed to attach volume + enable: true + alerts: + severity: warning + annotations: + summary: Failed to attach volume + summaryCn: 存储卷装载失败 + - name: VolumeMountFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedMount" + desc: Failed to mount volume + enable: true + alerts: + severity: warning + annotations: + summary: Failed to mount volume + summaryCn: 存储卷挂载失败 + - name: VolumeResizeFailed + expr: + kind: rule + condition: type="Warning" and reason="VolumeResizeFailed" + desc: Failed to expand/reduce volume + enable: true + alerts: + severity: warning + annotations: + summary: Failed to expand/reduce volume + summaryCn: 存储卷扩缩容失败 + - name: VolumeResizeSuccess + expr: + kind: rule + condition: type="Normal" and reason="VolumeResizeSuccessful" + desc: volume resize success + enable: true + alerts: + severity: warning + - name: FileSystemResizeFailed + expr: + kind: rule + condition: type="Warning" and reason="FileSystemResizeFailed" + desc: failed to expand/reduce file system + enable: true + alerts: + severity: warning + annotations: + summary: Failed to expand/reduce file system + summaryCn: 文件系统扩缩容失败 + - name: FileSystemResized + expr: + kind: rule + condition: type="Normal" and reason="FileSystemResizeSuccessful" + desc: File system resize success + enable: true + alerts: + severity: warning + - name: VolumeMapFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedMapVolume" + desc: Failed to map volume + enable: true + alerts: + severity: warning + annotations: + summary: Failed to map volume + summaryCn: 存储卷映射失败 + - name: VolumeAlreadyMounted + expr: + kind: rule + condition: type="Warning" and reason="AlreadyMountedVolume" + desc: Volume is already mounted + enable: true + alerts: + severity: warning + annotations: + summary: Volume is already mounted + summaryCn: 存储卷已被挂载 + - name: VolumeAttached + expr: + kind: rule + condition: type="Normal" and reason="SuccessfulAttachVolume" + desc: Volume is attached + enable: true + alerts: + severity: warning + - name: VolumeMounted + expr: + kind: rule + condition: type="Normal" and reason="SuccessfulMountVolume" + desc: volume is mounted + enable: true + alerts: + severity: warning + - name: NodeRebooted + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Node" and reason="Rebooted" + desc: Node Rebooted + enable: true + alerts: + severity: warning + annotations: + summary: Node Rebooted + summaryCn: 节点重启 + - name: ContainerGCFailed + expr: + kind: rule + condition: type="Warning" and reason="ContainerGCFailed" + desc: Container GC failed + enable: true + alerts: + severity: warning + annotations: + summary: Container GC failed + summaryCn: 容器GC失败 + - name: ImageGCFailed + expr: + kind: rule + condition: type="Warning" and reason="ImageGCFailed" + desc: Image GC failed + enable: true + alerts: + severity: warning + annotations: + summary: Image GC failed + summaryCn: 镜像GC失败 + - name: NodeAllocatableEnforcementFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedNodeAllocatableEnforcement" + desc: Node allocatable enforcement failed + enable: true + alerts: + severity: warning + annotations: + summary: Node allocatable enforcement failed + summaryCn: 节点可分配资源更新失败 + - name: NodeAllocatableEnforcedSuccess + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Node" and reason="NodeAllocatableEnforced" + desc: Node allocatable enforcement success + enable: true + alerts: + severity: warning + - name: SandboxChanged + expr: + kind: rule + condition: type="Normal" and reason="SandboxChanged" + desc: Sandbox changed + enable: true + alerts: + severity: warning + - name: SandboxCreateFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedCreatePodSandBox" + desc: Failed to create sandbox + enable: true + alerts: + severity: warning + annotations: + summary: Failed to create sandbox + summaryCn: Sandbox创建失败 + - name: SandboxStatusFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedPodSandBoxStatus" + desc: Failed to get sandbox status + enable: true + alerts: + severity: warning + annotations: + summary: Failed to get sandbox status + summaryCn: 获取Sandbox状态错误 + - name: DiskCapacityInvalid + expr: + kind: rule + condition: type="Warning" and reason="InvalidDiskCapacity" + desc: Invalid disk capacity + enable: true + alerts: + severity: warning + annotations: + summary: Invalid disk capacity + summaryCn: 磁盘容量配置不合法 + - name: DiskSpaceFreeFailed + expr: + kind: rule + condition: type="Warning" and reason="FreeDiskSpaceFailed" + desc: Failed to free disk space + enable: true + alerts: + severity: warning + annotations: + summary: Failed to free disk space + summaryCn: 磁盘空间释放失败 + - name: PodStatusSyncFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="FailedSync" + desc: Failed To Sync Pod Status + enable: true + alerts: + severity: warning + annotations: + summary: Failed To Sync Pod Status + summaryCn: Pod状态同步失败 + - name: ConfigurationValidationFaile + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="FailedValidation" + desc: Configuration Validation Failed + enable: true + alerts: + severity: warning + annotations: + summary: Configuration Validation Failed + summaryCn: 配置验证失败 + - name: LifecycleHookPostStartFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedPostStartHook" + desc: Failed to postStart LifecycleHook + enable: true + alerts: + severity: warning + annotations: + summary: Failed to postStart LifecycleHook + summaryCn: 容器启动后的生命周期钩子运行失败 + - name: LifecycleHookPreStopFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedPreStopHook" + desc: Failed to preStop LifecycleHook + enable: true + alerts: + severity: warning + annotations: + summary: Failed to preStop LifecycleHook + summaryCn: 容器停止前的生命周期钩子运行失败 + - name: HPASelectorError + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="HorizontalPodAutoscaler" and reason in ("SelectorRequired","InvalidSelector") + desc: HPA selector error + enable: true + alerts: + severity: warning + annotations: + summary: HPA selector error + summaryCn: HPA选择器错误 + - name: HPAMetricError + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="HorizontalPodAutoscaler" and reason in ("FailedGetObjectMetric","InvalidMetricSourceType") + desc: Node allocatable enforcement failed + enable: true + alerts: + severity: warning + annotations: + summary: HPA metric error + summaryCn: HPA对象指标错误 + - name: HPAConvertFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="HorizontalPodAutoscaler" and reason="FailedConvertHPA" + desc: Failed to convert HPA + enable: true + alerts: + severity: warning + annotations: + summary: Failed to convert HPA + summaryCn: HPA转换失败 + - name: HPAGetScaleFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="HorizontalPodAutoscaler" and reason="FailedGetScale" + desc: Failed to get HPA scale + enable: true + alerts: + severity: warning + annotations: + summary: Failed to get HPA scale + summaryCn: HPA规模获取失败 + - name: HPAComputeReplicasFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="HorizontalPodAutoscaler" and reason="FailedComputeMetricsReplicas" + desc: Failed to compute HPA replicas + enable: true + alerts: + severity: warning + annotations: + summary: Failed to compute HPA replicas + summaryCn: HPA副本计算失败 + - name: HPARescaleFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="HorizontalPodAutoscaler" and reason="FailedRescale" + desc: Failed to rescale HPA size + enable: true + alerts: + severity: warning + annotations: + summary: Failed to rescale HPA size + summaryCn: HPA规模调整失败 + - name: HPARescaleSuccess + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="HorizontalPodAutoscaler" and reason="SuccessfulRescale" + desc: Rescaled HPA size + enable: true + alerts: + severity: warning + - name: NodeSystemOOM + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Node" and reason="SystemOOM" + desc: Node system OOM encountered + enable: true + alerts: + severity: warning + annotations: + summary: Node system OOM encountered + summaryCn: 节点内存溢出 + - name: VolumeBindingFailed + expr: + kind: rule + condition: type="Warning" and reason="FailedBinding" + desc: Volume binding failed + enable: true + alerts: + severity: warning + annotations: + summary: Volume binding failed + summaryCn: 存储卷绑定失败 + - name: VolumeMismatch + expr: + kind: rule + condition: type="Warning" and reason="VolumeMismatch" + desc: Volume Mismatch + enable: true + alerts: + severity: warning + annotations: + summary: Volume Mismatch + summaryCn: 存储卷不匹配 + - name: VolumeRecycleFailed + expr: + kind: rule + condition: type="Warning" and reason="VolumeFailedRecycle" + desc: Failed to recycle volume + enable: true + alerts: + severity: warning + annotations: + summary: Failed to recycle volume + summaryCn: 存储卷回收失败 + - name: VolumeRecycled + expr: + kind: rule + condition: type="Normal" and reason="VolumeRecycled" + desc: Volume Recycled + enable: true + alerts: + severity: warning + - name: VolumeRecyclerPodError + expr: + kind: rule + condition: type="Warning" and reason="RecyclerPod" + desc: Volume Recycler pod error + enable: true + alerts: + severity: warning + annotations: + summary: Volume Recycler pod error + summaryCn: 存储卷回收器错误 + - name: VolumeDeleted + expr: + kind: rule + condition: type="Normal" and reason="VolumeDelete" + desc: Volume Deleted + enable: true + alerts: + severity: warning + - name: VolumeDeleteFailed + expr: + kind: rule + condition: type="Warning" and reason="VolumeFailedDelete" + desc: Failed to delete volume + enable: true + alerts: + severity: warning + annotations: + summary: Failed to delete volume + summaryCn: 存储卷删除失败 + - name: VolumeProvisionFailed + expr: + kind: rule + condition: type="Warning" and reason="ProvisioningFailed" + desc: Failed to provision volume + enable: true + alerts: + severity: warning + annotations: + summary: Failed to provision volume + summaryCn: 存储申请失败 + - name: VolumeProvisioned + expr: + kind: rule + condition: type="Normal" and reason="ProvisioningSucceeded" + desc: Volume provisioned + enable: true + alerts: + severity: warning + - name: VolumeProvisionCleanupFailed + expr: + kind: rule + condition: type="Warning" and reason="ProvisioningCleanupFailed" + desc: Failed to clean up provision volume + enable: true + alerts: + severity: warning + annotations: + summary: Failed to clean up provision volume + summaryCn: 清理存储失败 + - name: VolumeExternalExpandingError + expr: + kind: rule + condition: type="Warning" and reason="ExternalExpanding" + desc: Error for volume external expanding + enable: true + alerts: + severity: warning + annotations: + summary: Error for volume external expanding + summaryCn: 存储外部扩展错误 + - name: PodScheduleFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Pod" and reason="FailedScheduling" + desc: Failed to schedule pod + enable: true + alerts: + severity: warning + annotations: + summary: Failed to schedule pod + summaryCn: pod调度失败 + - name: PodSchedulePreempted + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Pod" and reason="Preempted" + desc: Pod preempted + enable: true + alerts: + severity: warning + - name: PodScheduled + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="Pod" and reason="Scheduled" + desc: Pod scheduled + enable: true + alerts: + severity: warning + - name: PodCreateFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind in ("Pod","ReplicaSet","DaemonSet","StatefulSet","Job") and reason="FailedCreate" + desc: Failed to create pod + enable: true + alerts: + severity: warning + annotations: + summary: Failed to create pod + summaryCn: pod创建失败 + - name: PodCreated + expr: + kind: rule + condition: type="Normal" and involvedObject.kind in ("Pod","ReplicaSet","DaemonSet","StatefulSet","Job") and reason="SuccessfulCreate" + desc: pod created + enable: true + alerts: + severity: warning + - name: PodDeleteFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind in ("Pod","ReplicaSet","DaemonSet","StatefulSet","Job") and reason="FailedDelete" + desc: Failed to delete pod + enable: true + alerts: + severity: warning + annotations: + summary: Failed to delete pod + summaryCn: pod删除失败 + - name: PodDeleted + expr: + kind: rule + condition: type="Normal" and involvedObject.kind in ("Pod","ReplicaSet","DaemonSet","StatefulSet","Job") and reason="SuccessfulDelete" + desc: pod deleted + enable: true + alerts: + severity: warning + - name: ReplicaSetCreateError + expr: + kind: rule + condition: type="Warning" and reason="ReplicaSetCreateError" + desc: Error to create replica set for deployment + enable: true + alerts: + severity: warning + annotations: + summary: Error to create replica set for deployment + summaryCn: 副本集创建错误 + - name: DeploymentRollbackFailed + expr: + kind: rule + condition: type="Warning" and reason in("DeploymentRollbackRevisionNotFound","DeploymentRollbackTemplateUnchanged") + desc: Failed to rollback deployment + enable: true + alerts: + severity: warning + annotations: + summary: Failed to rollback deployment + summaryCn: 部署回滚失败 + - name: DeploySelectorAll + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="Deployment" and reason="SelectingAll" + desc: The deploy is selecting all pods + enable: true + alerts: + severity: warning + annotations: + summary: The deploy is selecting all pods + summaryCn: deploy选择了所有pod + - name: DaemonSelectorAll + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="DaemonSet" and reason="SelectingAll" + desc: The daemon set is selecting all pods + enable: true + alerts: + severity: warning + annotations: + summary: The daemon set is selecting all pods + summaryCn: daemonset选择了所有pod + - name: DaemonPodFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="DaemonSet" and reason in ("FailedDaemonPod","FailedPlacement") + desc: Failed daemon pod + enable: true + alerts: + severity: warning + annotations: + summary: Failed daemon pod + summaryCn: daemonset的pod失败 + - name: LoadBalancerSyncFailed + expr: + kind: rule + condition: type="Warning" and reason="SyncLoadBalancerFailed" + desc: Error syncing load balancer + enable: true + alerts: + severity: warning + annotations: + summary: Error syncing load balancer + summaryCn: 负载据衡器不可用 + - name: LoadBalancerDeleting + expr: + kind: rule + condition: type="Normal" and reason="DeletingLoadBalancer" + desc: LoadBalancer is deleting + enable: true + alerts: + severity: warning + - name: LoadBalancerEnsuring + expr: + kind: rule + condition: type="Normal" and reason="EnsuringLoadBalancer" + desc: LoadBalancer is ensuring + enable: true + alerts: + severity: warning + - name: LoadBalancerEnsured + expr: + kind: rule + condition: type="Normal" and reason="EnsuredLoadBalancer" + desc: LoadBalancer is ensured + enable: true + alerts: + severity: warning + - name: LoadBalancerUnAvailable + expr: + kind: rule + condition: type="Warning" and reason="UnAvailableLoadBalancer" + desc: Load balancer is not available + enable: true + alerts: + severity: warning + annotations: + summary: Load balancer is not available + summaryCn: 负载据衡器不可用 + - name: LoadBalancerUpdated + expr: + kind: rule + condition: type="Normal" and reason="UpdatedLoadBalancer" + desc: LoadBalancer is updated + enable: true + alerts: + severity: warning + - name: LoadBalancerUpdateFailed + expr: + kind: rule + condition: type="Warning" and reason="UpdateLoadBalancerFailed" + desc: Failed to update load balancer + enable: true + alerts: + severity: warning + annotations: + summary: Failed to update load balancer + summaryCn: 更新负载据衡器失败 + - name: LoadBalancerDeleting + expr: + kind: rule + condition: type="Normal" and reason="DeletingLoadBalancer" + desc: Failed To Sync Pod Status + enable: true + alerts: + severity: warning + - name: LoadBalancerDeleted + expr: + kind: rule + condition: type="Normal" and reason="DeletedLoadBalancer" + desc: LoadBalancer is deleted + enable: true + alerts: + severity: warning + - name: VolumeDeleted + expr: + kind: rule + condition: type="Normal" and reason="VolumeDelete" + desc: Volume is deleted + enable: true + alerts: + severity: warning + - name: LoadBalancerDeleteFailed + expr: + kind: rule + condition: type="Warning" and reason="DeleteLoadBalancerFailed" + desc: Failed to delete load balancer + enable: true + alerts: + severity: warning + annotations: + summary: Failed to delete load balancer + summaryCn: 负载据衡器删除失败 + - name: JobGetFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="CronJob" and reason="FailedGet" + desc: Failed to get job + enable: true + alerts: + severity: warning + annotations: + summary: Failed to get job + summaryCn: 任务获取失败 + - name: JobCreated + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="CronJob" and reason="SuccessfulCreate" + desc: job is created + enable: true + alerts: + severity: warning + - name: JobCreateFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="CronJob" and reason="FailedCreate" + desc: Failed to create job + enable: true + alerts: + severity: warning + annotations: + summary: Failed to create job + summaryCn: 任务创建失败 + - name: JobDeleted + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="CronJob" and reason="SuccessfulDelete" + desc: job is deleted + enable: true + alerts: + severity: warning + - name: JobDeleteFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="CronJob" and reason="FailedDelete" + desc: Failed to delete job + enable: true + alerts: + severity: warning + annotations: + summary: Failed to delete job + summaryCn: 任务删除失败 + - name: JobCompleted + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="CronJob" and reason="SawCompletedJob" + desc: job is completed + enable: true + alerts: + severity: warning + - name: JobUnexpected + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="CronJob" and reason="UnexpectedJob" + desc: CronJob saw unexpected job + enable: true + alerts: + severity: warning + annotations: + summary: CronJob saw unexpected job + summaryCn: 任务非预期 + - name: JobMissing + expr: + kind: rule + condition: type="Normal" and involvedObject.kind="CronJob" and reason="MissingJob" + desc: CronJob missed expected job + enable: true + alerts: + severity: warning + - name: JobScheduleFailed + expr: + kind: rule + condition: type="Warning" and involvedObject.kind="CronJob" and reason in ("MissSchedule","FailedNeedsStart") + desc: CronJob failed to schedule job + enable: true + alerts: + severity: warning + annotations: + summary: CronJob failed to schedule job + summaryCn: 任务调度失败 +---- + +== 审计告警规则示例 + + +[,yaml] +---- +apiVersion: logging.whizard.io/v1alpha1 +kind: ClusterRuleGroup +metadata: + name: auditing-rules +spec: + type: auditing + rules: + - name: ignore-action + expr: + kind: list + list: + - get + - list + - watch + desc: all action not need to be audit + - name: action + expr: + kind: list + list: + - create + - delete + - update + - patch + desc: all operator need to be audit + - name: pod + expr: + kind: macro + macro: ObjectRef.Resource="pods" + desc: pod + - name: service + expr: + kind: macro + macro: ObjectRef.Resource="services" + desc: service + - name: user + expr: + kind: alias + alias: User.username + desc: the alias of the user related to audit event + - name: name + expr: + kind: alias + alias: ObjectRef.Name + desc: the alias of the resource name + - name: namespace + expr: + kind: alias + alias: ObjectRef.Namespace + desc: the alias of the resource namespace + - name: create + expr: + kind: macro + macro: Verb = "create" + desc: create operator + - name: ResourceChange + expr: + kind: rule + condition: Verb in ${action} + desc: audit the change of resource + enable: true + alerts: + severity: info + - name: CreateHostNetworkPod + expr: + kind: rule + condition: ${pod} and ${create} and RequestObject.spec.hostNetwork = true + desc: Detect an attempt to start a pod using the host network + alerts: + severity: warning + annotations: + summary: creat hostNetwork pod + summaryCn: 创建 hostNetwork 容器 + message: ${user} ${Verb} HostNetwork Pod ${name} in Namespace ${namespace}. + enable: true + - name: CreateHostportPod + expr: + kind: rule + condition: ${pod} and ${create} and (RequestObject.spec.containers[*].ports[*].hostPort > 0 or RequestObject.spec.initContainers[*].ports[*].hostPort > 0) + desc: Detect an attempt to start a pod mount to a host port + enable: true + alerts: + severity: warning + annotations: + summary: creat hostport pod + summaryCn: 创建 hostport 容器 + message: ${user} ${Verb} HostPort Pod ${name} in Namespace ${namespace}. + - name: CreateNodePortService + expr: + kind: rule + condition: ${service} and ${create} and RequestObject.spec.type = "NodePort" + desc: Detect an attempt to start a service with a NodePort service type + enable: true + alerts: + severity: warning + annotations: + summary: creat NodePort service + summaryCn: 创建 NodePort 服务 + message: ${user} ${Verb} NodePort Service ${name} in Namespace ${namespace}. + - name: AttachOrExecPod + expr: + kind: rule + condition: ${pod} and ${create} and ObjectRef.Subresource in ("exec", "attach") + desc: Detect any attempt to attach/exec to a pod + alerts: + severity: warning + annotations: + summary: attach or exec pod + summaryCn: 进入容器 + message: ${user} ${ObjectRef.Subresource} Pod ${name} in Namespace ${namespace}. +---- + +== 告警规则参数描述 + +告警规则目前支持三种类型:审计、事件和日志。在 `spec.type` 下配置不同类型的告警规则,如 `type: auditing`,`type: events` 或 `type: logs` 。 + +告警规则 `spec.rules` 的设置项如下: +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|`name` +| 规则名称。 + +|`desc` +| 规则描述。 + +|`expr.kind` +|规则类型,取值可以为 `rule`, `macro`, `list`, 或 `alias`。 + +|`expr.condition` +|日志的过滤表达式,以检查日志是否与规则匹配。可使用比较运算符(=,!=,<,<=,>,>=,contains,in,like,regexp)、布尔运算符(and,or 和 not)以及括号进行组合。 + +|`expr.macro` +| macro 的条件。 + +|`expr.list` +| list 的值。 + +|`expr.alias` +| alias 的值。 + +|`enable` +| 如果为 false,规则将不生效。 + +|`alerts.output` +| 指定在匹配事件发生时输出的消息。 + +|`alerts.annotations` +| 规则的注解,包含在匹配事件发生时输出的告警消息。 + +|`alerts.annotations.summary` +| 指定在匹配事件发生时输出的摘要消息。 + +|`alerts.annotations.summaryCn` +| 指定在匹配事件发生时输出的中文摘要消息。 + +|`alerts.severity` +| 规则的告警级别,取值可以为 INFO、WARNING、ERROR、或 CRITICAL。 +|=== + +**Macro** + +宏(Macro)是规则条件片段,可以在规则内部甚至其他宏中重复使用。宏提供了一种命名常见模式和消除规则冗余的方法。以下是一个宏的示例: + +[,yaml] +---- +apiVersion: logging.whizard.io/v1alpha1 +kind: ClusterRuleGroup +metadata: + name: macro-rule +spec: + type: auditing + rules: + - desc: pod + expr: + kind: macro + macro: ObjectRef.Resource="pods" + name: pod +---- + +[.admon.note,cols="a"] +|=== +|说明 + +| +宏可以在规则或其他宏中使用,例如 `${pod}` 或 `${alerting-rule.pod}` 。这两种方法的区别在于 `${pod}` 只能用于 `alerting-rule`,而 `${alerting-rule.pod}` 可以用于所有实例。宏也可用于 list 和 alias。 +|=== + +**List** + +列表(List)是可以包含在规则、宏或其他列表中的项目集合。与规则和宏不同,列表不能被解析为过滤表达式。以下是一个列表的示例: + +[,yaml] +---- +apiVersion: logging.whizard.io/v1alpha1 +kind: ClusterRuleGroup +metadata: + name: list-rule +spec: + type: alerting + rules: + - desc: all action not need to be audit + expr: + kind: list + list: + - get + - list + - watch + name: ignore-action +---- + +**Alias** + +别名(Alias)是过滤字段的缩写名称,它可以包含在规则、宏、列表和输出字符串中。以下是一个别名的示例: + +[,yaml] +---- +apiVersion: logging.whizard.io/v1alpha1 +kind: ClusterRuleGroup +metadata: + name: alias-rule +spec: + type: alerting + rules: + - desc: the alias of the user related to audit event + expr: + alias: User.username + kind: alias + name: user +---- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/03-create-rules-for-logs.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/03-create-rules-for-logs.adoc new file mode 100644 index 000000000..4da16f8b8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/03-create-rules-for-logs.adoc @@ -0,0 +1,105 @@ +--- +title: "创建日志告警规则" +description: "介绍如何为 Kubernetes 日志定义告警规则。" +weight: 03 +--- + +本节介绍如何为 Kubernetes 日志定义告警规则。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +WhizardTelemetry 事件告警默认接收 Kubernetes 集群的日志。如果想要接收其他日志,需要修改 WhizardTelemetry 数据流水线的配置,或新建保密字典进行配置,请参阅 link:https://vector.dev/docs/reference/configuration/[Vector 官方文档]进行配置。 +|=== + +== 前提条件 + +* 您需要在{ks_product_both}平台具有 **platform-admin** 角色。 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 事件告警**扩展组件。 + +* 已在 WhizardTelemetry 事件告警的扩展组件配置中,启用日志告警,即设置 `loggingAlerting.enabled` 为 true。 + + +== 操作步骤 + +. 在任意集群节点上,创建一个 yaml 文件,为该集群定义日志的告警规则。有关参数配置的更多信息,请参阅link:../02-example-rules-for-auditing/#_告警规则参数描述[参数描述]。 ++ +==== + +* 基于关键字的告警 ++ +-- +例如,下面的配置表示,在测试日志中包含 [ERROR] 并且 pod 名称包含 pod_name 时触发告警。 + +[,yaml] +---- +apiVersion: logging.whizard.io/v1alpha1 +kind: ClusterRuleGroup +metadata: + name: logging-rules +spec: + type: logs + rules: + - name: log-test + expr: + kind: rule + condition: log contains "[ERROR]" and kubernetes.pod_name contains "pod_name" + desc: 'test logging' + enable: true + alerts: + severity: warning +---- +-- + + +* 滑动窗口告警 ++ +-- +和基于关键字告警的配置基本相同,唯一不同的是需要增加 slidingWindow 的配置。 + +例如,下面的配置表示,一个 20s 的窗口,每 10s 触发一次,当窗口中的日志存在 [INFO] 并且 cluster 中包含 gcp-prod-cluster 并且数量大于等于 20 条时触发告警。 + +[,yaml] +---- +apiVersion: logging.whizard.io/v1alpha1 +kind: ClusterRuleGroup +metadata: + name: logging-rules +spec: + type: logs + rules: + - name: TestLoggingRuleWindow-02 + expr: + kind: rule + condition: log contains "[INFO]" and cluster contains "gcp-prod-cluster" + desc: stream test 2 + enable: true + alerts: + severity: info + annotations: + summary: for test + summaryCn: 测试TestLoggingRuleWindow-02 + message: 告警测试TestLoggingRuleWindow-02 + slidingWindow: + windowSize: 20s + slidingInterval: 10s + count: 20 +---- +-- + +==== + +. 执行以下命令,创建 CRD(定制资源定义)。 ++ +[,bash] +---- +kubectl apply -f xxx.yaml # 注意替换 yaml 文件的名称 +---- + +. 运行成功后,在**集群管理 > 定制资源定义**页面搜索 **ClusterRuleGroup**。 + +. 点击 **ClusterRuleGroup** 进入详情页,在右侧页面查看、编辑或删除告警规则。 + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/_index.adoc new file mode 100644 index 000000000..0df8a25f3 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/09-events-altering/_index.adoc @@ -0,0 +1,38 @@ +--- +title: "WhizardTelemetry 事件告警" +keywords: "Kubernetes, {ks_product}, 事件, 审计, 告警" +description: "介绍如何使用“WhizardTelemetry 事件告警”扩展组件。" +weight: 09 +layout: "second" +draft: true +--- + +本节介绍如何使用“WhizardTelemetry 事件告警”扩展组件。 + +WhizardTelemetry 事件告警支持审计告警、事件告警和日志告警功能。它支持为 Kubernetes/KubeSphere 审计事件、Kubernetes 原生事件、以及 Kubernetes 日志定义告警规则,对传入的事件数据和日志数据进行评估,并将告警发送到指定的接收器如 HTTP 端点等。 + +其中,日志告警支持日志关键字触发告警和滑动窗口触发告警。 + +- 基于关键字的告警:当日志中出现特定关键字时触发告警。 + +- 滑动窗口告警:在滑动时间窗口内,当符合条件的日志数据量达到用户指定数量时触发告警。 + + +[.admon.attention,cols="a"] +|=== +|注意 + +| +- WhizardTelemetry 事件告警依赖于 WhizardTelemetry 数据流水线扩展组件发送过来的事件、审计和日志数据。在使用前,请确保已安装并配置好该扩展组件。 +- 审计告警和事件告警功能默认启用,请确保已安装并配置好 WhizardTelemetry 事件和 WhizardTelemetry 审计扩展组件。 +- 日志告警功能默认禁用,可修改“扩展组件配置”启用该功能。 +|=== + +[.admon.note,cols="a"] +|=== +|说明 + +| +有关组件配置的更多信息,请参阅扩展中心“WhizardTelemetry 事件告警”扩展组件的详情页说明。 +|=== + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/01-set-email-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/01-set-email-notification.adoc new file mode 100644 index 000000000..55325b43c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/01-set-email-notification.adoc @@ -0,0 +1,63 @@ +--- +title: "设置邮件通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置邮件通知" +description: "介绍如何设置邮件通知。" +weight: 01 +--- + +// :ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知渠道** +:ks_permission: **平台设置管理** + + +本节介绍如何设置邮件通知。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**通知渠道**页面,点击**邮箱**页签,设置邮箱通知参数,然后点击**确定**。 ++ +-- +* 服务器设置 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|SMTP 服务器地址 +|SMTP 服务器的地址和端口号。 + +|使用 SSL 安全连接 +|是否启用 SSL 安全连接。 + +|SMTP 用户名 +|SMTP 服务器的登录用户名。 + +|SMTP 密码 +|SMTP 服务器的登录密码。 + +|发件人邮箱 +|用于发送通知的邮箱地址。 +|=== + +邮件的接收人设置可前往**通知订阅**页面进行设置。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/02-set-feishu-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/02-set-feishu-notification.adoc new file mode 100644 index 000000000..d1634aee3 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/02-set-feishu-notification.adoc @@ -0,0 +1,74 @@ +--- +title: "设置飞书通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置飞书通知" +description: "介绍如何设置飞书通知。" +weight: 02 +--- + +// :ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知渠道** +:ks_permission: **平台设置管理** + + +本节介绍如何设置飞书通知。 + +飞书通知功能支持通过以下两种方式向用户发送通知: + +* **会话设置**:使用飞书应用向特定用户或部门发送通知。 + +* **群机器人设置**:使用飞书机器人向特定群聊发送通知。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +* 您需要提前从飞书平台获取应用或群机器人的访问参数。有关更多信息,请参阅link:https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM[飞书开发者文档]。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**通知渠道**页面,点击**飞书**页签,设置飞书通知参数,然后点击**确定**。 ++ +==== +* 会话设置 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|App ID +|飞书应用的 App ID。 + +|App Secret +|飞书应用的 App Secret。 + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sessionId.adoc[] +|=== +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-groupChatBotSettings.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + +. 在**飞书**页签右上角,点击切换开关将飞书通知功能设置为**已启用**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/03-set-dingtalk-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/03-set-dingtalk-notification.adoc new file mode 100644 index 000000000..49c7ca843 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/03-set-dingtalk-notification.adoc @@ -0,0 +1,76 @@ +--- +title: "设置钉钉通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置钉钉通知" +description: "介绍如何设置钉钉通知。" +weight: 03 +--- + +// :ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知渠道** +:ks_permission: **平台设置管理** + + +本节介绍如何设置钉钉通知。 + +钉钉通知功能支持通过以下两种方式向用户发送通知: + +* **会话设置**:使用钉钉应用向特定用户或部门发送通知。 + +* **群机器人设置**:使用钉钉机器人向特定群聊发送通知。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +* 您需要提前从钉钉平台获取应用或群机器人的访问参数。有关更多信息,请参阅link:https://open.dingtalk.com/document/orgapp-server/how-to-call-apis[钉钉开发者文档]。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**通知渠道**页面,点击**钉钉**页签,设置钉钉通知参数,然后点击**确定**。 ++ +==== +* 会话设置 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|App Key +|钉钉应用的 AppKey。 + +|App Secret +|钉钉应用 App Secret。 + +|Chat ID +|接收通知的 Chat ID。点击**添加**可设置多个 Chat ID。 +|=== +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-groupChatBotSettings.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + + +. 在**钉钉**页签右上角,点击切换开关将钉钉通知功能设置为**已启用**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/04-set-wecom-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/04-set-wecom-notification.adoc new file mode 100644 index 000000000..7d9373c5a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/04-set-wecom-notification.adoc @@ -0,0 +1,87 @@ +--- +title: "设置企业微信通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置企业微信通知" +description: "介绍如何设置企业微信通知。" +weight: 04 +--- + + +// :ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知渠道** +:ks_permission: **平台设置管理** + + +本节介绍如何设置企业微信通知。配置后,可通过企业微信会话或群机器人接收通知消息。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +* 您需要提前从企业微信平台获取应用访问参数。有关更多信息,请参阅link:https://developer.work.weixin.qq.com/document/path/90664[企业微信开发者文档]。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**通知渠道**页面,点击**企业微信**页签,设置企业微信通知参数,然后点击**确定**。 ++ +==== +* 会话设置 > 服务器设置 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|Corp ID +|您的企业在企业微信上的 Corp ID。 + +|Agent ID +|企业微信应用的 Agent ID。 + +|Secret +|企业微信应用的 Secret。 +|=== +-- + +* 会话设置 > 接收设置 ++ +-- +设置接收通知的 User ID、Department ID 或 Tag ID。点击**添加**可设置多个 ID。 +-- + +* 群机器人设置 > 群机器人设置 ++ +-- +Webhook URL: 企业微信群机器人的 webhook 地址。 +-- + +* 群机器人设置 > 接收设置 ++ +-- +设置接收通知的 User ID 或 用户手机号。点击**添加**可设置多个 ID 和手机号。 +-- + + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + +. 在**企业微信**页签右上角,点击切换开关将企业微信通知功能设置为**已启用**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/05-set-slack-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/05-set-slack-notification.adoc new file mode 100644 index 000000000..135555468 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/05-set-slack-notification.adoc @@ -0,0 +1,62 @@ +--- +title: "设置 Slack 通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置 Slack 通知" +description: "介绍如何设置 Slack 通知。" +weight: 05 +--- + + +// :ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知渠道** +:ks_permission: **平台设置管理** + + +本节介绍如何设置 Slack 通知。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +* 您需要提前从 Slack 平台获取应用访问参数。有关更多信息,请参阅 link:https://api.slack.com/messaging/webhooks#create_a_webhook[Slack 开发者文档]。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**通知渠道**页面,点击 **Slack** 页签,设置 Slack 通知参数,然后点击**确定**。 ++ +==== +* 服务器设置 ++ +-- +设置用于访问 Slack 应用的令牌。 +-- + +* Slack 频道设置 ++ +-- +设置接收通知的 Slack 频道。点击**添加**可设置多个 Slack 频道。 +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + +. 在 **Slack** 页签右上角,点击切换开关将 Slack 通知功能设置为**已启用**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/06-set-webhook-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/06-set-webhook-notification.adoc new file mode 100644 index 000000000..f01aaea22 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/06-set-webhook-notification.adoc @@ -0,0 +1,73 @@ +--- +title: "设置 Webhook 通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置 Webhook 通知" +description: "介绍如何设置 Webhook 通知。" +weight: 06 +--- + +// :ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知渠道** +:ks_permission: **平台设置管理** + + +本节介绍如何设置 Webhook 通知。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +* 您需要提前获取 Webhook 的访问参数。有关更多信息,请联系您的 Webhook 管理员。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**通知渠道**页面,点击 **Webhook** 页签,设置 Webhook 通知参数,然后点击**确定**。 ++ +==== +* 服务器设置 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|Webhook URL +|Webhook 的访问 URL。 + +|认证类型 +|Webhook 的认证类型。 + +* **无需认证**:不需要进行认证。 + +* **Bearer 令牌**:使用 URL Bearer 令牌进行认证。如果选择此类型,您需要进一步设置用于认证的令牌。 + +* **基础认证**:使用用户名和密码进行认证。如果选择此类型,您需要进一步设置用于认证的用户名和密码。 + +|跳过 TLS 验证(不安全) +|调用 Webhook 时是否跳过 TLS 验证。 +|=== +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + +. 在 **Webhook** 页签右上角,点击切换开关将 Webhook 通知功能设置为**已启用**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/_index.adoc new file mode 100644 index 000000000..c68996acc --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/01-notification-channels/_index.adoc @@ -0,0 +1,12 @@ +--- +title: "通知渠道" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知渠道" +description: "介绍如何设置通知渠道。" +weight: 01 +layout: "second" +--- + + +本节介绍如何设置平台级别的通知渠道。 + +根据您的需要,您可以通过邮件、飞书、钉钉、企业微信、Slack 或 Webhook 向用户发送通知。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/01-set-subscription.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/01-set-subscription.adoc new file mode 100644 index 000000000..63c5285dd --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/01-set-subscription.adoc @@ -0,0 +1,75 @@ +--- +title: "创建通知订阅" +description: "介绍如何创建通知订阅。" +weight: 01 +--- + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知订阅** +:ks_permission: **平台设置管理** + + +本节介绍如何创建通知订阅。 + +include::../../../../../../_ks_components/admonitions/note.adoc[] + +目前仅支持为邮箱配置多个通知订阅。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台。 +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 +. 在左侧导航栏选择pass:a,q[{ks_navigation}]。 +. 在**通知订阅**页面的**邮箱**页签,点击**创建**。 ++ +==== +* 基本信息 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|通知订阅的名称。 + +名称只能包含小写字母、数字和连字符(-),必须以小写字母或数字开头和结尾,最长 63 个字符。 + +|别名 +|通知订阅的别名。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|通知订阅的描述信息。描述可包含任意字符,最长 256 个字符。 + +|=== +-- + +* 接收设置 ++ +-- +设置接收通知的邮箱地址。点击**添加**可设置多个地址。 +-- + +* 通知接收 ++ +-- +点击切换开关,将通知功能设置为**已启用**。 +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] + +==== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/02-view-subscription.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/02-view-subscription.adoc new file mode 100644 index 000000000..3fb23337c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/02-view-subscription.adoc @@ -0,0 +1,58 @@ +--- +title: "查看通知订阅" +description: "介绍如何查看通知订阅。" +weight: 02 +--- + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知订阅** +:ks_permission: **平台设置管理** + + + +本节介绍如何查看通知订阅。 + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台。 +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 +. 在左侧导航栏选择pass:a,q[{ks_navigation}]。 +. 在**通知订阅**页面的**邮箱**页签,查看已创建的通知订阅列表。 ++ +-- +通知订阅列表提供以下信息: +[%header,cols="1a,4a"] +|=== +|参数|描述 + +|名称 +|通知订阅的名称。 + +|通知接收状态 +|通知订阅是否被启用。 + +|通知订阅账号数量 +|接收通知的账号数量。 + +|创建时间 +|通知订阅的创建时间。 +|=== + +* 在列表上方点击搜索框并设置搜索条件,可按名称搜索通知订阅。 + +* 在列表右上角点击image:/images/ks-qkcp/zh/icons/refresh-light.svg[refresh,18,18]可刷新列表信息。 + +* 在列表右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]可定制列表中显示的信息。 +-- +. 点击通知订阅的名称,可查看详细信息,如订阅账号、过滤条件等。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/03-edit-subscription.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/03-edit-subscription.adoc new file mode 100644 index 000000000..a3ea4c5a5 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/03-edit-subscription.adoc @@ -0,0 +1,67 @@ +--- +title: "编辑通知订阅" +description: "介绍如何编辑通知订阅。" +weight: 03 +--- + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知订阅** +:ks_permission: **平台设置管理** + + +本节介绍如何编辑通知订阅。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台。 +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 +. 在左侧导航栏选择pass:a,q[{ks_navigation}]。 +. 在**通知订阅**页面的**邮箱**页签,查看已创建的通知订阅列表。 +. 在需要操作的通知订阅右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑**。 +. 在**编辑通知订阅**页面,编辑信息后,点击**确定**。 ++ +==== +* 基本信息 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|别名 +|通知订阅的别名。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|通知订阅的描述信息。描述可包含任意字符,最长 256 个字符。 + +|=== +-- + +* 接收设置 ++ +-- +设置接收通知的邮箱地址。点击**添加**可设置多个地址。 +-- + +* 通知接收 ++ +-- +点击切换开关,启用或禁用通知订阅。 +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] + +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/04-delete-subscription.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/04-delete-subscription.adoc new file mode 100644 index 000000000..8abe87ff6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/04-delete-subscription.adoc @@ -0,0 +1,50 @@ +--- +title: "删除通知订阅" +description: "介绍如何删除通知订阅。" +weight: 04 +--- + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知订阅** +:ks_permission: **平台设置管理** + + +本节介绍如何删除通知订阅。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + + +== 删除单个通知订阅 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台。 +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 +. 在左侧导航栏选择pass:a,q[{ks_navigation}]。 +. 在**通知订阅**页面的**邮箱**页签,查看已创建的通知订阅列表。 +. 在需要操作的通知订阅右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 +. 在**删除通知订阅**对话框,输⼊通知订阅的名称,然后点击**确定**。 + +== 批量删除通知订阅 +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台。 +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 +. 在左侧导航栏选择pass:a,q[{ks_navigation}]。 +. 在**通知订阅**页面的**邮箱**页签,查看已创建的通知订阅列表。 +. 勾选需要删除的通知订阅左侧的复选框,然后在列表上⽅点击**删除**。 +. 在**批量删除通知订阅**对话框,输⼊通知订阅的名称,然后点击**确定**。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +请使用半角逗号(,)和空格分隔多个名称。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/_index.adoc new file mode 100644 index 000000000..1d21aff05 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/02-notification-subscription/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "通知订阅" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知订阅" +description: "介绍如何管理通知订阅。" +weight: 02 +layout: "second" +--- + +本节介绍如何管理通知订阅。 + +通过通知订阅,您可以在同一通知渠道下,配置多个不同的过滤条件以发送通知给相应的接收者。 + + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/01-create-a-silence-policy.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/01-create-a-silence-policy.adoc new file mode 100644 index 000000000..7636eec3b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/01-create-a-silence-policy.adoc @@ -0,0 +1,67 @@ +--- +title: "创建静默策略" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 静默策略, 创建静默策略" +description: "本节介绍如何创建静默策略。" +weight: 01 +--- + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知设置** +:ks_permission: **平台设置管理** + + +本节介绍如何创建静默策略。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**基本信息**页签,设置静默策略的基本信息,然后点击**下一步**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|静默策略的名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母开头并以小写字母或数字结尾,最长 63 个字符。 + +include::../../../../../_custom/platformManagement/platformSettings/platformSettings/platformSettings-para-aliasDescription.adoc[] +|=== +-- + +. 在**静默条件**页签,根据需要选择**对所有通知静默**或**自定义静默条件**并设置相关参数,然后点击**下一步**。 ++ +==== +include::../../../../../_custom/platformManagement/platformSettings/platformSettings/platformSettings-para-silenceConditions_new.adoc[] +==== + +. 在**静默时间**页签,选择静默时间类型并设置相关参数,然后点击**创建**。 ++ +-- +include::../../../../../_custom/platformManagement/platformSettings/platformSettings/platformSettings-para-silenceTime.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/02-edit-silence-policy-information.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/02-edit-silence-policy-information.adoc new file mode 100644 index 000000000..b8c57eda3 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/02-edit-silence-policy-information.adoc @@ -0,0 +1,53 @@ +--- +title: "编辑静默策略信息" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 静默策略, 编辑静默策略信息" +description: "本节介绍如何编辑静默策略信息。" +weight: 02 +--- + + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知设置** +:ks_permission: **平台设置管理** + + +本节介绍如何编辑静默策略信息。 + +您可以编辑静默策略的别名和描述。{ks_product_right}不支持编辑已创建静默策略的名称。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的静默策略右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑信息**。 + +. 在**编辑信息**对话框,设置静默策略的别名和描述,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../../_custom/platformManagement/platformSettings/platformSettings/platformSettings-para-aliasDescription.adoc[] +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/03-edit-silence-conditions.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/03-edit-silence-conditions.adoc new file mode 100644 index 000000000..0cf76f77c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/03-edit-silence-conditions.adoc @@ -0,0 +1,47 @@ +--- +title: "编辑静默条件" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 静默策略, 编辑静默条件" +description: "本节介绍如何编辑通知静默条件。" +weight: 03 +--- + + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知设置** +:ks_permission: **平台设置管理** + + +本节介绍如何编辑通知静默条件。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的静默策略右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑静默条件**。 + +. 在**编辑静默条件**对话框,设置静默条件,然后点击**确定**。 ++ +==== +include::../../../../../_custom/platformManagement/platformSettings/platformSettings/platformSettings-para-silenceConditions_new.adoc[] +==== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/04-edit-silence-time.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/04-edit-silence-time.adoc new file mode 100644 index 000000000..551ba1ea4 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/04-edit-silence-time.adoc @@ -0,0 +1,59 @@ +--- +title: "编辑静默时间" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 静默策略, 编辑静默时间" +description: "本节介绍如何编辑通知静默时间。" +weight: 04 +--- + + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知设置** +:ks_permission: **平台设置管理** + + +本节介绍如何编辑通知静默时间。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的静默策略右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑静默时间**。 + +. 在**编辑静默时间**对话框,选择静默时间类型并设置相关参数,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|持续静默 +|满足静默条件的通知在所有时间静默。 + +|在特定时间范围内静默 +|满足静默条件的通知在指定的时间范围内静默。您需要选择静默的开始时间和结束时间。 + +|周期性静默 +|满足静默条件的通知每日、每周或每月在指定的时间范围内静默。您需要选择静默的日期、开始时间和结束时间。 +|=== +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/05-delete-silence-policies.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/05-delete-silence-policies.adoc new file mode 100644 index 000000000..c524b307a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/05-delete-silence-policies.adoc @@ -0,0 +1,63 @@ +--- +title: "删除静默策略" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 静默策略, 删除静默策略" +description: "本节介绍如何删除静默策略。" +weight: 05 +--- + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知设置** +:ks_permission: **平台设置管理** + + +本节介绍如何删除静默策略。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + + + +== 删除单个静默策略 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要删除的静默策略右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除静默策略**对话框,输入静默策略的名称,然后点击**确定**。 + + +== 批量删除静默策略 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 选择需要删除的静默策略左侧的复选框,然后在列表上方点击**删除**。 + +. 在**批量删除静默策略**对话框,输入静默策略的名称,然后点击**确定**。 ++ +-- +include::../../../../../_custom/note-separateNamesByComma.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/06-change-the-notification-language.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/06-change-the-notification-language.adoc new file mode 100644 index 000000000..6de1d1d3d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/06-change-the-notification-language.adoc @@ -0,0 +1,41 @@ +--- +title: "修改通知语言" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 静默策略, 修改通知语言" +description: "本节介绍如何修改通知语言。" +weight: 06 +--- + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知设置** +:ks_permission: **平台设置管理** + + +本节介绍如何修改通知语言。 + +发送给用户的通知包含键值对信息,您可以设置通知的键的语言。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**通知设置**页面,点击**通知语言**页签,然后在下拉列表中选择通知语言。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/_index.adoc new file mode 100644 index 000000000..249839fb9 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/03-notification-settings/_index.adoc @@ -0,0 +1,12 @@ +--- +title: "通知设置" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置" +description: "本节介绍如何管理静默策略和通知语言。" +weight: 03 +layout: "second" +--- + + +本节介绍如何管理静默策略和通知语言。 + +使用静默策略设置系统在特定条件和特定时间下不发送通知。通知以键值对的形式呈现,您可以指定通知的键的语言。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/04-notification-history/03-view-notification-history.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/04-notification-history/03-view-notification-history.adoc new file mode 100644 index 000000000..7c5035b78 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/04-notification-history/03-view-notification-history.adoc @@ -0,0 +1,94 @@ +--- +title: "查看通知历史" +keywords: "Kubernetes, {ks_product}, 平台设置" +description: "介绍如何查看通知历史记录。" +weight: 03 +--- + +:ks_menu: **平台管理 > 平台设置** +:ks_navigation: **通知管理 > 通知历史** +:ks_permission: **平台设置管理** + + +本节介绍如何查看通知历史记录。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/platformManagement/platformManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + + +== 操作步骤 + +include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 在{ks_product_left} Web 控制台右上角点击image:/images/ks-qkcp/zh/icons/cogwheel.svg[cogwheel,18,18]进入**平台设置**页面。 + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + +* **通知历史**页面提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|告警名称 +|作为通知发送给用户的告警的名称。 + +|告警类型 +|告警提示的系统事件类型。 + +* **指标告警**:资源指标满足告警触发条件。 + +* **审计告警**:系统审计事件,例如 API 调用。 + +* **事件告警**:系统资源事件,例如资源创建、删除、修改等。 + +|告警级别 +| +include::../../../../../_custom/clusterManagement/ruleGroups/ruleGroups-para-alertLevel.adoc[] + +|消息 +|告警消息的内容。 + +|状态 +|告警的状态:触发中/已解决。 + +**触发中**:已触发的告警会产生触发中的通知。 + +**已解决**:当一段时间(默认5分钟)后,如果不再收到同样的告警,状态就会变为已解决。 + +|项目 +|触发告警的资源所在的项目。 + +|服务 +|触发告警的服务。 + +|容器组 +|触发告警的容器组。 + +|容器 +|触发告警的容器。 + +|通知时间 +|通知发送的时间。 +|=== +-- + +* 在列表左上角的下拉列表中选择一个集群,查看特定集群中的通知历史。 + +* 在列表上方点击搜索框并输入关键字,可按告警名称、告警级别、消息、状态、项目和时间范围搜索通知历史记录。 ++ +include::../../../../../../_ks_components/oper-refreshListData.adoc[] ++ +include::../../../../../../_ks_components/oper-customizeColumns.adoc[] + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/04-notification-history/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/04-notification-history/_index.adoc new file mode 100644 index 000000000..f3074a13b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/04-notification-history/_index.adoc @@ -0,0 +1,7 @@ +--- +title: "通知历史" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知历史" +description: "介绍如何查看通知历史记录。" +weight: 04 +layout: "second" +--- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/01-set-email-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/01-set-email-notification.adoc new file mode 100644 index 000000000..86576dece --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/01-set-email-notification.adoc @@ -0,0 +1,45 @@ +--- +title: "设置邮件通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置邮件通知" +description: "介绍如何设置邮件通知。" +weight: 01 +--- + +// // :ks_menu: **平台管理 > 平台设置** +// :ks_navigation: **通知管理 > 通知渠道** + + +本节介绍如何设置邮件通知。 + + +== 前提条件 + +// :relfileprefix: ../../../../../ +// * {empty} +// include::../../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +// :relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +== 操作步骤 + +// include::../../../../../_custom/platformManagement/platformManagement-oper-logIn.adoc[] + +. 登录{ks_product_left} Web 控制台。 + +. 在页面右上角点击当前用户名,然后在下拉列表中选择**通知设置**。 + +. 在**通知设置**页面的**邮箱**页签,设置邮件通知参数,然后点击**确定**。 ++ +==== +* 接收设置 ++ +输入邮箱地址,点击**添加**可设置多个通知接收人。 + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + +. 点击上方的**通知已禁用**开关,启用邮箱通知。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/02-set-feishu-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/02-set-feishu-notification.adoc new file mode 100644 index 000000000..84f67330f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/02-set-feishu-notification.adoc @@ -0,0 +1,62 @@ +--- +title: "设置飞书通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置飞书通知" +description: "介绍如何设置飞书通知。" +weight: 02 +--- + +// :ks_menu: **平台管理 > 平台设置** +// :ks_navigation: **通知管理 > 通知渠道** + + +本节介绍如何设置飞书通知。 + +飞书通知功能支持通过以下两种方式向用户发送通知: + +* **会话设置**:使用飞书应用向特定用户或部门发送通知。 + +* **群机器人设置**:使用飞书机器人向特定群聊发送通知。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +* 您需要提前从飞书平台获取应用或群机器人的访问参数。有关更多信息,请参阅link:https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM[飞书开发者文档]。 + + +== 操作步骤 + +. 登录{ks_product_left} Web 控制台。 + +. 在页面右上角点击当前用户名,然后在下拉列表中选择**通知设置**。 + +. 在**通知设置**页面的**飞书**页签,设置飞书通知参数,然后点击**确定**。 + ++ +==== +* 会话设置 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +// |App ID +// |飞书应用的 App ID。 + +// |App Secret +// |飞书应用的 App Secret。 + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sessionId.adoc[] +|=== +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-groupChatBotSettings.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + +. 点击上方的**通知已禁用**开关,启用飞书通知。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/03-set-dingtalk-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/03-set-dingtalk-notification.adoc new file mode 100644 index 000000000..7fd424b51 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/03-set-dingtalk-notification.adoc @@ -0,0 +1,64 @@ +--- +title: "设置钉钉通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置钉钉通知" +description: "介绍如何设置钉钉通知。" +weight: 03 +--- + +// :ks_menu: **平台管理 > 平台设置** +// :ks_navigation: **通知管理 > 通知渠道** + + +本节介绍如何设置钉钉通知。 + +钉钉通知功能支持通过以下两种方式向用户发送通知: + +* **会话设置**:使用钉钉应用向特定用户或部门发送通知。 + +* **群机器人设置**:使用钉钉机器人向特定群聊发送通知。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +* 您需要提前从钉钉平台获取应用或群机器人的访问参数。有关更多信息,请参阅link:https://open.dingtalk.com/document/orgapp-server/how-to-call-apis[钉钉开发者文档]。 + + +== 操作步骤 + +. 登录{ks_product_left} Web 控制台。 + +. 在页面右上角点击当前用户名,然后在下拉列表中选择**通知设置**。 + +. 在**通知设置**页面的**钉钉**页签,设置钉钉通知参数,然后点击**确定**。 + ++ +==== +* 会话设置 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +// |App Key +// |钉钉应用的 AppKey。 + +// |App Secret +// |钉钉应用 App Secret。 + +|Chat ID +|接收通知的 Chat ID。点击**添加**可设置多个 Chat ID。 +|=== +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-groupChatBotSettings.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + + +. 点击上方的**通知已禁用**开关,启用钉钉通知。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/04-set-wecom-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/04-set-wecom-notification.adoc new file mode 100644 index 000000000..2ba29c589 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/04-set-wecom-notification.adoc @@ -0,0 +1,75 @@ +--- +title: "设置企业微信通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置企业微信通知" +description: "介绍如何设置企业微信通知。" +weight: 04 +--- + + +// :ks_menu: **平台管理 > 平台设置** +// :ks_navigation: **通知管理 > 通知渠道** + + +本节介绍如何设置企业微信通知。配置后,可通过企业微信会话或群机器人接收通知消息。 + + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +* 您需要提前从企业微信平台获取应用访问参数。有关更多信息,请参阅link:https://developer.work.weixin.qq.com/document/path/90664[企业微信开发者文档]。 + + +== 操作步骤 + +. 登录{ks_product_left} Web 控制台。 + +. 在页面右上角点击当前用户名,然后在下拉列表中选择**通知设置**。 + +. 在**通知设置**页面的**企业微信**页签,设置企业微信通知参数,然后点击**确定**。 + ++ +==== +// * 服务器设置 +// + +// -- +// [%header,cols="1a,4a"] +// |=== +// |参数 |描述 + +// |Corp ID +// |您的企业在企业微信上的 Corp ID。 + +// |Agent ID +// |企业微信应用的 Agent ID。 + +// |Secret +// |企业微信应用的 Secret。 +// |=== +// -- + +* 会话设置 > 接收设置 ++ +-- +设置接收通知的 User ID、Department ID 或 Tag ID。点击**添加**可设置多个 ID。 +-- + +* 群机器人设置 > 群机器人设置 ++ +-- +Webhook URL: 企业微信群机器人的 webhook 地址。 +-- + +* 群机器人设置 > 接收设置 ++ +-- +设置接收通知的 User ID 或 用户手机号。点击**添加**可设置多个 ID 和手机号。 +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + +. 点击上方的**通知已禁用**开关,启用企业微信通知。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/05-set-slack-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/05-set-slack-notification.adoc new file mode 100644 index 000000000..76428cc5c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/05-set-slack-notification.adoc @@ -0,0 +1,50 @@ +--- +title: "设置 Slack 通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置 Slack 通知" +description: "介绍如何设置 Slack 通知。" +weight: 05 +--- + + +// :ks_menu: **平台管理 > 平台设置** +// :ks_navigation: **通知管理 > 通知渠道** + + +本节介绍如何设置 Slack 通知。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +* 您需要提前从 Slack 平台获取应用访问参数。有关更多信息,请参阅 link:https://api.slack.com/messaging/webhooks#create_a_webhook[Slack 开发者文档]。 + + +== 操作步骤 + +. 登录{ks_product_left} Web 控制台。 + +. 在页面右上角点击当前用户名,然后在下拉列表中选择**通知设置**。 + +. 在**通知设置**页面的 **Slack** 页签,设置 Slack 通知参数,然后点击**确定**。 + ++ +==== +// * 服务器设置 +// + +// -- +// 设置用于访问 Slack 应用的令牌。 +// -- + +* Slack 频道设置 ++ +-- +设置接收通知的 Slack 频道。点击**添加**可设置多个 Slack 频道。 +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + +. 点击上方的**通知已禁用**开关,启用 Slack 通知。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/06-set-webhook-notification.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/06-set-webhook-notification.adoc new file mode 100644 index 000000000..e620cb1af --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/06-set-webhook-notification.adoc @@ -0,0 +1,61 @@ +--- +title: "设置 Webhook 通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知设置, 设置 Webhook 通知" +description: "介绍如何设置 Webhook 通知。" +weight: 06 +--- + +// :ks_menu: **平台管理 > 平台设置** +// :ks_navigation: **通知管理 > 通知渠道** + + +本节介绍如何设置 Webhook 通知。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 通知**扩展组件。 + +* 您需要提前获取 Webhook 的访问参数。有关更多信息,请联系您的 Webhook 管理员。 + + +== 操作步骤 + +. 登录{ks_product_left} Web 控制台。 + +. 在页面右上角点击当前用户名,然后在下拉列表中选择**通知设置**。 + +. 在**通知设置**页面的 **Webhook** 页签,设置 Webhook 通知参数,然后点击**确定**。 + ++ +==== +* 服务器设置 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|Webhook URL +|Webhook 的访问 URL。 + +|认证类型 +|Webhook 的认证类型。 + +* **无需认证**:不需要进行认证。 + +* **Bearer 令牌**:使用 URL Bearer 令牌进行认证。如果选择此类型,您需要进一步设置用于认证的令牌。 + +* **基础认证**:使用用户名和密码进行认证。如果选择此类型,您需要进一步设置用于认证的用户名和密码。 + +|跳过 TLS 验证(不安全) +|调用 Webhook 时是否跳过 TLS 验证。 +|=== +-- + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-notificationConditions_new.adoc[] + +include::../../../../../_custom/platformManagement/platformSettings/notificationChannels/notificationChannels-para-sendTestInformation.adoc[] +==== + +. 点击上方的**通知已禁用**开关,启用 Webhook 通知。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/_index.adoc new file mode 100644 index 000000000..ca5f95a3c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/05-users-notification/_index.adoc @@ -0,0 +1,19 @@ +--- +title: "用户通知设置" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理, 通知渠道" +description: "介绍如何设置用户的通知渠道。" +weight: 05 +layout: "second" +--- + +:ks_permission: **接收通知** + +本节介绍如何设置当前用户的通知渠道,用于接收其所在项目的告警消息。 + +[.admon.note,cols="a"] +|=== +|说明 + +|用户必须在所在项目中具有pass:a,q[{ks_permission}]权限,才能接收该项目的告警消息。 + +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/07-message-config/01-wechat-template.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/07-message-config/01-wechat-template.adoc new file mode 100644 index 000000000..34ae83c98 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/07-message-config/01-wechat-template.adoc @@ -0,0 +1,102 @@ +--- +title: "配置企业微信的通知消息模板" +description: "介绍如何配置企业微信的通知消息。" +weight: 01 +--- + +. 登录集群节点,创建一个 markdown 模板。 ++ +-- +[,bash] +---- +vi +---- + +内容如下: +[,yaml] +---- +apiVersion: v1 +data: + template: | + {{- define "nm.default.markdown.test" }} + {{- range .Alerts }} + {{- $rawStatus := .Status }} + {{- if eq $rawStatus "firing" }} + ### {{ template "nm.default.message" . }} + {{- else }} + ### {{ template "nm.default.message" . }} + {{- end }} + {{- range .Labels.SortedPairs }} + {{- if eq .Name "severity" }} + {{- $color := "" }} + {{- if eq .Value "critical" }} + {{- $color = "red" }} + {{- else if eq .Value "error" }} + {{- $color = "orange" }} + {{- else if eq .Value "warning" }} + {{- $color = "yellow" }} + {{- else if eq .Value "info" }} + {{- $color = "blue" }} + {{- end }} + > **{{ .Name | translate }}: {{ .Value }}** + {{- else }} + > **{{ .Name | translate }}**: {{ .Value }} + {{- end }} + {{- end }} + {{ range .Annotations.SortedPairs.Filter "runbook_url" "message" "summary" "summary_cn" }} + > **{{ .Name | translate }}**: {{ .Value }} + {{- end }} + {{ end }} + {{- end }} + +kind: ConfigMap +metadata: + name: notification-manager-template-test + namespace: kubesphere-monitoring-system +---- +-- + +. 执行以下命令创建名为 `notification-manager-template-test` 的 ConfigMap。 ++ +[,bash] +---- +kubectl apply -f +---- + +. 在link:../../01-notification-channels/04-set-wecom-notification/[通知渠道]或link:../../05-users-notification/04-set-wecom-notification/[用户通知设置]中配置企业微信,以便在企业微信会话或企业微信群中接收通知消息。 + +. 查看 wechat receiver. ++ +-- +[,bash] +---- +kubectl -n kubesphere-monitoring-system get receiver +---- + +* 以 global 开头的 receiver,如 global-wechat-receiver,为全局配置的 wechat receiver。 +* 以用户名称开头的 receiver,如 admin-wechat-receiver,为租户级别配置的 wechat receiver。 +-- + +. 编辑对应的 wechat receiver,以便在通知消息中使用 markdown 模板。 ++ +-- +[,bash] +---- +kubectl -n kubesphere-monitoring-system edit receiver +---- + + +[,yaml] +---- +spec: + wechat: + enabled: true + template: nm.default.markdown.test + tmplText: + name: notification-manager-template-test + namespace: kubesphere-monitoring-system + tmplType: markdown +---- + +企业微信的通知消息将使用此 markdown 模板显示。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/07-message-config/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/07-message-config/_index.adoc new file mode 100644 index 000000000..7e2202e17 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/07-message-config/_index.adoc @@ -0,0 +1,6 @@ +--- +title: "通知消息配置" +description: "介绍如何配置通知消息。" +weight: 07 +layout: "second" +--- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/_index.adoc new file mode 100644 index 000000000..e3a56a749 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/11-notifications/_index.adoc @@ -0,0 +1,31 @@ +--- +title: "WhizardTelemetry 通知" +keywords: "Kubernetes, {ks_product}, 平台设置, 通知管理" +description: "介绍如何使用“WhizardTelemetry 通知”扩展组件。" +weight: 10 +layout: "second" +--- + + +本节介绍如何使用“WhizardTelemetry 通知”扩展组件。 + +// 在集群或项目中创建告警规则组会对资源状态进行监控。当资源状态满足预设的条件并且满足预设的持续时间时,系统将产生告警,并通过在平台级别设置的通知渠道向用户发送。有关告警规则组和告警的更多信息,请参阅 link:../06-alerting[WhizardTelemetry 告警]。 + +该扩展组件用于管理多租户 Kubernetes 环境中的通知。它能够接收来自不同发送者的告警、云事件以及其他类型的事件(例如审计和 Kubernetes 事件),并根据租户标签(如命名空间或用户)将通知发送给相应的租户接收器。支持邮件、飞书、钉钉、企业微信、Slack、Webhook 等多种通知渠道。 + + +安装“WhizardTelemetry 通知”扩展组件后, + +* 平台设置左侧导航栏下将显⽰**通知管理**选项。 +* 集群左侧导航栏的**集群设置**菜单下将显示**日志接收器**选项,**日志接收器**页面将显示**通知历史**页签,支持添加多种类型的日志接收器。有关更多信息,请参阅link:../02-logging/06-log-receivers/[日志接收器]。 + +//attention +[.admon.attention,cols="a"] +|=== +| 注意 + +| +- WhizardTelemetry 通知由每个集群部署改为只需在 host 集群部署。在 host 集群添加了 `alertmanager proxy`,并且以 NodePort 形式(默认 31093)暴露。配置 WhizardTelemetry 告警和 WhizardTelemetry 事件告警时,若使用 WhizardTelemetry 通知扩展组件发送告警消息,需要进行相应配置。有关更多信息,请参阅 link:../06-alerting[WhizardTelemetry 告警]和 link:../09-events-altering[WhizardTelemetry 事件告警]。 + +- WhizardTelemetry 通知依赖 WhizardTelemetry 平台服务和 WhizardTelemetry 数据流水线,因此在安装 WhizardTelemetry 通知之前必须先安装并配置好 WhizardTelemetry 平台服务和 WhizardTelemetry 数据流水线这两个扩展组件,否则通知相关功能无法正常使用! +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/15-opensearch/01-intro.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/15-opensearch/01-intro.adoc new file mode 100644 index 000000000..ea6bed70f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/15-opensearch/01-intro.adoc @@ -0,0 +1,23 @@ +--- +title: "概述" +keywords: "Kubernetes, {ks_product}, opensearch, 日志, 可观测" +description: "介绍 “OpenSearch 分布式检索与分析引擎”扩展组件。" +weight: 01 +--- + +“OpenSearch 分布式检索与分析引擎”扩展组件是 KubeSphere 内置的日志存储扩展组件,用于存储日志、审计、事件、通知历史等可观测数据。 + +除支持部署 OpenSearch 外,该扩展组件还支持部署 OpenSearch Dashboard 和 OpenSearch Curator。 + +* **OpenSearch Dashboard** 用于可视化 OpenSearch 数据以及管理 OpenSearch 集群的用户界面。部署后默认禁用,若要启用,将 `opensearch-dashboards.enabled` 字段设置为 true。 + +* **OpenSearch Curator** 是一个定时任务,定期清理超过配置日期(默认为 7 天)的 Kubernetes 事件日志、Kubernetes 审计日志、Kubernetes 应用程序日志以及通知历史日志。部署后默认启用,若要禁用,将 `opensearch-curator.enabled` 字段设置为 false。 + + +[.admon.note,cols="a"] +|=== +|说明 + +| +有关组件配置的更多信息,请参阅扩展中心“WhizardTelemetry 数据流水线”和“OpenSearch 分布式检索与分析引擎”扩展组件的详情页说明。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/15-opensearch/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/15-opensearch/_index.adoc new file mode 100644 index 000000000..4ffb9d428 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/15-opensearch/_index.adoc @@ -0,0 +1,24 @@ +--- +title: "OpenSearch 分布式检索与分析引擎" +keywords: "Kubernetes, {ks_product}, opensearch, 日志, 可观测" +description: "介绍“OpenSearch 分布式检索与分析引擎”扩展组件。" +weight: 15 +layout: "second" +--- + +“OpenSearch 分布式检索与分析引擎”扩展组件是 KubeSphere 内置的日志存储扩展组件,用于存储日志、审计、事件、通知历史等可观测数据。 + +除支持部署 OpenSearch 外,该扩展组件还支持部署 OpenSearch Dashboard 和 OpenSearch Curator。 + +* **OpenSearch Dashboard** 用于可视化 OpenSearch 数据以及管理 OpenSearch 集群的用户界面。部署后默认禁用,若要启用,将 `opensearch-dashboards.enabled` 字段设置为 true。 + +* **OpenSearch Curator** 是一个定时任务,定期清理超过配置日期(默认为 7 天)的 Kubernetes 事件日志、Kubernetes 审计日志、Kubernetes 应用程序日志以及通知历史日志。部署后默认启用,若要禁用,将 `opensearch-curator.enabled` 字段设置为 false。 + + +[.admon.note,cols="a"] +|=== +|说明 + +| +有关组件配置的更多信息,请参阅扩展中心“WhizardTelemetry 数据流水线”和“OpenSearch 分布式检索与分析引擎”扩展组件的详情页说明。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/01-built-in-dashboards.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/01-built-in-dashboards.adoc new file mode 100644 index 000000000..4e1e22fb8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/01-built-in-dashboards.adoc @@ -0,0 +1,67 @@ +--- +title: "查看内置 Dashboard" +keywords: "Kubernetes, {ks_product}, Grafana, 监控, 内置 dashboard, 可观测" +description: "介绍如何查看扩展组件提供的内置 Dashboard。" +weight: 01 +--- + +Grafana for WhizardTelemetry 扩展组件内置了多个 Grafana Dashboard 模板,可供直接查询 Kubernetes 和{ks_product_both}的监控数据,而无需自行配置 Grafana Dashboard。 + +== 操作步骤 + +. 登录 Grafana 控制台后,点击左侧导航栏的 **Dashboards**,查看所有内置的 Dashboard 模板。包含 aicp, kube-prometheus-stack, whizard-loki, whizard-monitoring 4 个目录。 ++ +-- +image:/images/ks-qkcp/zh/v4.1.2/grafana/dashboard-list.png[dashboard-list] + +[%header,cols="1a,3a"] +|=== +|目录 |模板介绍 + +|aicp +|用于青云 AI 智算运维管理端,需在“AI 智算管理”平台中查看监控面板。 + +|kube-prometheus-stack +|可视化 Kubernetes 的监控数据。 + +|whizard-loki +|可视化存储到 Loki 的{ks_product_both}的日志、审计、事件及通知历史。 + +|whizard-monitoring +|适配 Whizard 与 KubeSphere 后的多集群监控。 +|=== + +[.admon.attention,cols="a"] +|=== +|注意 + +| +* 安装 **WhizardTelemetry 监控**扩展组件后,**kube-prometheus-stack** 和 **whizard-monitoring** 中的 Dashboard 才会显示监控数据。 +* 若要 **whizard-loki** 中的 Dashboard 显示监控数据,请参阅link:../../17-loki/01-display-loki-data[ +Grafana Loki for WhizardTelemetry]。 +|=== +-- + +. 点击目录中的 Dashboard 模板,查看对应指标的监控数据。 ++ +下面以 **whizard-monitoring** 中的 **KubeSphere Nodes** 模板为例,介绍 Dashboard 页面。 + + +. **KubeSphere Nodes** 看板展示了每个节点的 CPU、内存、磁盘和 pod 的资源利用率、磁盘 IOPS、磁盘吞吐量、网络带宽等监控信息。 ++ +image:/images/ks-qkcp/zh/v4.1.2/grafana/node-dashboard.png[node-dashboard] + +. 点击上方的 **data source**、**cluster**、**node**,可选择查看指定数据源、集群和节点的相关数据。 +. 点击右上角的image:/images/ks-qkcp/zh/icons/time-light.png[time-light,18,18],设置数据展示的时间范围,支持自定义时间段。 +. 点击右上角的image:/images/ks-qkcp/zh/icons/refresh-light.png[refresh-light,18,18],刷新看板上的数据。点击image:/images/ks-qkcp/zh/icons/chevron-down.svg[chevron-down,18,18]设置数据自动刷新的时间间隔。 +. 点击每个 Panel 右上角的image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],可对指定 Panel 进行独立查看、编辑、分享、检查、删除等操作。 ++ +[.admon.note,cols="a"] +|=== +|说明 + +|有关 Dashboard 的更多信息,请参阅 link:https://grafana.com/docs/grafana/latest/dashboards/[Grafana 官方文档]。 + +|=== + + diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/05-add-data-source.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/05-add-data-source.adoc new file mode 100644 index 000000000..a4fcb09bf --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/05-add-data-source.adoc @@ -0,0 +1,45 @@ +--- +title: "添加数据源" +keywords: "Kubernetes, {ks_product}, Grafana, 添加数据源, 可观测" +description: "介绍如何添加 grafana 数据源。" +weight: 05 +--- + +本节简要介绍如何添加、配置和查询数据源。有关更多信息,请参阅 link:https://grafana.com/docs/grafana/latest/datasources/[Grafana data sources]。 + +创建 Dashboard 前,必须先添加数据源。Grafana for WhizardTelemetry 扩展组件默认添加了 Prometheus 的服务器地址为数据源。您也可以自行添加数据源,如 Loki、Elasticsearch、InfluxDB、PostgreSQL、MySQL 等。 + +添加数据源后,您可以: + +- 使用 Explore 查询数据。 +- 在面板中将数据可视化。 +- 创建告警规则。 + +== 前提条件 + +只有在 Grafana 控制台具有 admin 角色的用户才能添加或删除数据源。 + +== 添加数据源 + +. 登录 Grafana 控制台后,点击左侧导航栏的 **Connections**。 +. 搜索数据源,如 loki。 +. 点击数据源名称,进入数据源概览页面。 +. 点击右上角的 **Add new data source**,进入数据源配置页面。 +. 输入数据源的服务器地址,点击最下方的 **Save & test**,完成数据源的添加和配置。 ++ +image:/images/ks-qkcp/zh/v4.1.2/grafana/loki-data-source.png[loki-data-source] + +== 查询数据源数据 + +设置查询条件,查询数据源中特定指标一段时间范围内的数据。 + +. 点击左侧导航栏的 **Explore**,在上方选择数据源。 +. 在查询编辑器中输入或选择 **Metric**,设置 **Label filters**,然后点击右上角的 **Run query**。 ++ +image:/images/ks-qkcp/zh/v4.1.2/grafana/explore.png[explore] + +== 删除数据源 + +. 点击左侧导航栏的 **Connections > Data sources**。 +. 点击需要删除的数据源名称,进入数据源配置页面。 +. 点击最下方的 **Delete**, 删除数据源。 diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/07-create-dashboards.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/07-create-dashboards.adoc new file mode 100644 index 000000000..155b3297d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/07-create-dashboards.adoc @@ -0,0 +1,41 @@ +--- +title: "创建 Dashboard" +keywords: "Kubernetes, {ks_product}, Grafana, 创建 Dashboard, 可观测" +description: "介绍如何创建 Dashboard。" +weight: 07 +--- + +添加数据源后,创建 Dashboard, 以便将数据源中的数据可视化。 + +Dashboard 由一个或多个 Panel(面板)组成,按行组织和排列。Panel 显示可视化内容并提供各种控制选项。 + +本节简要介绍如何创建 Dashboard。有关更多信息,请参阅 link:https://grafana.com/docs/grafana/latest/dashboards/[Grafana dashboards]。 + +== 操作步骤 + +. 点击 Grafana 控制台左侧导航栏的 **Dashboards**。 +. 点击 **New > New Dashboard**。 +. 在空白 Dashboard 页面,点击 **+ Add visualization**。 +. 在弹出的对话框中,选择已添加的数据源,将自动打开 Panel 编辑页面。 ++ +image:/images/ks-qkcp/zh/v4.1.2/grafana/edit-panel.png[edit-panel] + +.. 使用数据源的查询语言设置查询条件。 + +.. 点击image:/images/ks-qkcp/zh/icons/refresh-light.png[refresh-light,18,18]查询数据。 + +.. 点击右侧的图表类型(如 Time series),选择一个图表样式。数据将以该样式展示。 + +.. 在 **Panel options** 区域,设置 Panel 的名称,描述等。 + +.. 编辑完成后,点击 **Apply** 保存 Panel,点击 **Save** 保存 Dashboard。 ++ +保存 Dashboard 时,可设置 Dashboard 的名称、描述和所在目录。 + +. 在新建的 Dashboard 页面,点击上方的 **Add**,选择 **Visualization**,可继续添加 Panel。 + +. 退出 Panel 编辑页面后,可拖拽 Panel 标题将其移动到任意位置;在 Panel 右下角拖动光标,可调整 Dashboard 中 Panel 的大小。 + +. 点击 Dashboard 页面上方的保存按钮,再次保存 Dashboard。 ++ +至此,一个含有多个 Panel 的 Dashboard 创建完成。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/_index.adoc new file mode 100644 index 000000000..51f614527 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/16-grafana/_index.adoc @@ -0,0 +1,58 @@ +--- +title: "Grafana for WhizardTelemetry" +keywords: "Kubernetes, {ks_product}, Grafana, 监控, dashboard, 可观测" +description: "介绍如何使用 Grafana for WhizardTelemetry 扩展组件。" +weight: 16 +layout: "second" +--- + +本节介绍如何使用 Grafana for WhizardTelemetry 扩展组件。 + +该扩展组件提供一个开放且可组合的数据可视化和监控分析平台,内置众多仪表盘(Dashboard)来增强 WhizardTelemetry 可观测平台的可视化能力。它提供了丰富的数据展示和分析功能,使用户能够以直观和交互式的方式探索、查询和可视化各种数据源(如 Prometheus、Loki、Elasticsearch、InfluxDB、PostgreSQL 等)的指标、日志和跟踪数据。 + +**配置说明:** + +安装 Grafana for WhizardTelemetry 扩展组件后,需修改扩展组件配置以暴露 Grafana 服务,才能访问 Grafana 控制台。 + +[,yaml] +---- + service: + enabled: true + type: ClusterIP + loadBalancerIP: "" + loadBalancerClass: "" + loadBalancerSourceRanges: [] + port: 80 + targetPort: 3000 + # nodePort: 32000 +---- + +[%header,cols="1a,4a"] +|=== +|参数 |描述 +|type: ClusterIP |默认安装方式,只能在集群内部通过虚拟 IP 地址访问 Grafana 服务。 + +|type: NodePort |使用 NodePort 方式暴露服务,可通过 `nodePort` 参数指定端口。如未指定,则在 30000 到 32767 的空闲端口中随机选择一个端口来使用。 + +配置后,可通过 : 访问 Grafana 控制台。 + +|type: LoadBalancer |使用云服务商提供的负载均衡器向外部暴露 Grafana 服务。为实现上述功能,LoadBalancer 类型的服务需要负载均衡器插件和基础设施环境提供支持,并且需要设置相关注解。有关更多信息,请联系您的基础设施环境提供商。 +|=== + +// include::../../../../_custom/clusterManagement/services/services-oper-editServiceExternalAccessSettings.adoc[] + +// [.admon.note,cols="a"] +// |=== +// |说明 + +// | +// 有关各种服务类型的配置方法,请参阅link:https://kubernetes.io/zh-cn/docs/concepts/services-networking/service/#publishing-services-service-types[服务类型]。 +// |=== + +[.admon.tip,cols="a"] +|=== +|提示 + +| +成功访问 Grafana 控制台后,可使用默认帐户和密码 (**admin/admin**) 登录。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/17-loki/01-display-loki-data.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/17-loki/01-display-loki-data.adoc new file mode 100644 index 000000000..adbe0f9ef --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/17-loki/01-display-loki-data.adoc @@ -0,0 +1,72 @@ +--- +title: "可视化 Loki 中的数据" +keywords: "Kubernetes, {ks_product}, Grafana, loki, dashboard, 可观测" +description: "介绍如何在 Grafana 可视化 loki 中的日志、审计、事件及通知历史数据。" +weight: 01 +--- + + +本节介绍如何在 Grafana 控制台可视化存储到 Loki 的{ks_product_both}的日志、审计、事件及通知历史数据。 + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **WhizardTelemetry 平台服务**扩展组件。 +* 已通过 Grafana for WhizardTelemetry 扩展组件或其他方法部署一个 Grafana 控制台。 + +== 操作步骤 + +. 安装 Grafana Loki for WhizardTelemetry 扩展组件。 + + +. 在集群的**应用负载 > 服务**页面,查找 `loki-agent-gateway`,**编辑外部访问**,开启 NodePort。 ++ +[.admon.note,cols="a"] +|=== +|说明 + +| +取决于您的网络环境,您可能需要配置流量转发规则并在防火墙中放行该 NodePort 端口。 +|=== + +. 安装 WhizardTelemetry 数据流水线,并配置 Loki 信息。 ++ +-- +[,yaml] +---- + sinks: + loki: + endpoint: http://: +---- + +示例如下: + +[,yaml] +---- + sinks: + loki: + endpoint: http://172.31.19.250:30858 +---- +-- + +. 安装 WhizardTelemetry 日志、审计、事件、通知(按需安装),修改扩展组件配置,启用 Loki。 ++ +-- +[,yaml] +---- + sinks: + loki: + enabled: true +---- +-- + +. 在 Grafana 控制台中配置 Loki 数据源。 ++ +-- +* 若 Grafana 控制台为 Grafana for WhizardTelemetry 扩展组件所部署,Grafana Loki for WhizardTelemetry 安装完成后,会自动在 Grafana 控制台为日志、审计、事件及通知历史添加 Loki 数据源。有关如何访问 Grafana 控制台,请参阅 link:../../16-grafana/[Grafana for WhizardTelemetry]。 + +* 若 Grafana 控制台使用其他方法部署,您需要在 Grafana 控制台手动添加 loki 数据源。更多信息,请参阅扩展中心 Grafana Loki for WhizardTelemetry 扩展组件的详情页说明。 +-- + +. 访问 Grafana 控制台,即可在 Dashboards 下查看{ks_product_both}日志、审计、事件、通知历史的数据面板。 ++ +image:/images/ks-qkcp/zh/v4.1.2/loki-data.png[] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/17-loki/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/17-loki/_index.adoc new file mode 100644 index 000000000..4f2e75ebd --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/17-loki/_index.adoc @@ -0,0 +1,22 @@ +--- +title: "Grafana Loki for WhizardTelemetry" +keywords: "Kubernetes, {ks_product}, Grafana, loki, 对象存储, 监控, dashboard, 可观测" +description: "介绍如何使用 Grafana Loki for WhizardTelemetry 扩展组件。" +weight: 17 +layout: "second" +--- + + +Loki 是一个受 Prometheus 启发的水平可扩展、高可用、多租户日志聚合系统。通过采集、索引和存储日志数据,使用户能够轻松地搜索、查询和可视化日志信息。Loki 支持将日志存到对象存储,并从中查询日志,是低成本存储海量日志的较好选择。 + +// Loki 不索引日志的内容,而是为每个日志流建立一组标签。这些标签由键值对组成,对于高效组织、过滤和搜索日志数据至关重要。 + +Grafana Loki for WhizardTelemetry 扩展组件支持在 Grafana 控制台查看存储到 Loki 的{ks_product_both}的日志、审计、事件及通知历史数据。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +Grafana Loki for WhizardTelemetry 扩展组件只需安装到一个集群即可。 +|=== diff --git a/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/_index.adoc new file mode 100644 index 000000000..be95f7a3b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/05-observability-platform/_index.adoc @@ -0,0 +1,36 @@ +--- +title: "WhizardTelemetry 可观测平台" +keywords: "Kubernetes, {ks_product}, 可观测中心, 监控, 告警, 事件, 通知, 日志, 审计, 事件, 数据流水线, OpenSearch" +description: "介绍如何使用 WhizardTelemetry 可观测平台。" +weight: 05 +layout: "second" +--- + +WhizardTelemetry 可观测平台是一款企业级多集群监控告警产品,专注于提供一体化的云原生可观测性服务。该平台提供了从基础设施到应用的多层级、多维度、多租户的指标监控和告警功能。同时,通过可插拔的 Whizard 可观测中心实现了监控告警的多集群统一纳管能力,以及成员集群和边缘集群的轻量化支持。 + +WhizardTelemetry 可观测平台由以下扩展组件构成: + +- **WhizardTelemetry 平台服务**:是 WhizardTelemetry 可观测平台各扩展组件的公共服务。它是各个可观测性扩展组件通用的 APIServer,为所有可观测性扩展组件提供公共的后端平台服务。 + +- **WhizardTelemetry 日志**:提供多租户视角的云原生应用实时及历史日志收集、查询、导出、存储等功能,可对接如 ElasticSearch、OpenSearch、Kafka 等日志接收器。 + +- **WhizardTelemetry 事件**:可长期保存 Kubernetes 相关对象产生的事件,并提供多租户视角的事件检索和查看功能。 + +- **WhizardTelemetry 审计**:实时记录在{ks_product_both}平台上的用户相关操作行为,并提供多租户视角的审计历史的检索及查看功能,可快速回溯相关用户的操作行为。 + +- **WhizardTelemetry 监控**:提供多租户视角的云原生资源监控能力,包括针对集群,节点,工作负载、GPU、K8s 控制面等对象的核心监控指标进行实时和历史数据展示等功能。 + +- **WhizardTelemetry 告警**:基于 KubeSphere 采集的监控数据,可针对不同资源类型和监控指标,提供平台及租户视角的告警及告警规则管理功能。 + +- **WhizardTelemetry 事件告警**:为 Kubernetes 原生事件和 Kubernetes/KubeSphere 审计事件定义告警规则,对传入的事件数据进行评估,并将告警发送到指定的接收器如 HTTP 端点等。 + +- **WhizardTelemetry 通知**:管理多租户 Kubernetes 环境中的通知。它能够接收来自不同发送者的告警、云事件以及其他类型的事件(例如审计和 Kubernetes 事件),并根据租户标签(如命名空间或用户)将通知发送给相应的租户接收器。支持邮件、飞书、钉钉、企业微信、Slack、Webhook 等多种通知渠道。 + +- **WhizardTelemetry 数据流水线**:提供可观测性数据的收集、转换和路由能力。 + +- **OpenSearch 分布式检索与分析引擎**:支持使用外置或内置的 OpenSearch 集群来存储、检索与分析日志、审计、事件、通知历史等可观测数据。 + +- **Grafana for WhizardTelemetry**:一个开放且可组合的数据可视化和监控分析平台,内置众多仪表盘(Dashboard)来增强 WhizardTelemetry 可观测平台的可视化能力。 + +- **Grafana Loki for WhizardTelemetry**:支持在 Grafana 控制台查看存储到 Loki 的 KubeSphere 日志、审计、事件及通知历史数据。 + diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/01-create-a-network-policy.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/01-create-a-network-policy.adoc new file mode 100644 index 000000000..32f31c9b0 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/01-create-a-network-policy.adoc @@ -0,0 +1,56 @@ +--- +title: "创建网络策略" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 网络策略, 创建网络策略" +description: "介绍如何创建网络策略。" +weight: 01 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 网络策略** + + +本节介绍如何创建网络策略。 + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**创建网络策略**对话框,设置网络策略的配置文件,然后点击**确定**。 ++ +-- +* 在右上角点击image:/images/ks-qkcp/zh/icons/upload-dark-white.svg[upload-dark-white,18,18] 可上传配置文件。 + +* 在右上角点击image:/images/ks-qkcp/zh/icons/download-dark-white.svg[download-dark-white,18,18] 可下载配置文件。 + +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +{ks_product_right}目前不支持以图形化的方式创建网络策略。有关网络策略配置文件的具体参数,请参阅 link:https://kubernetes.io/zh/docs/concepts/services-networking/network-policies/[Kubernetes 官方文档]。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + +网络策略创建完成后将显示在网络策略列表中。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/02-view-a-network-policy-list.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/02-view-a-network-policy-list.adoc new file mode 100644 index 000000000..08cb136ff --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/02-view-a-network-policy-list.adoc @@ -0,0 +1,54 @@ +--- +title: "查看网络策略列表" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 网络策略, 查看网络策略列表" +description: "介绍如何查看网络策略列表。" +weight: 02 +--- + +:ks_permission: **集群网络资源查看** +:ks_navigation: **网络 > 网络策略** + + +本节介绍如何查看网络策略列表。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ +==== +* 网络策略列表提供以下信息: ++ +-- +[options="header",cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../_custom/clusterManagement/networkPolicies/networkPolicies-para-information.adoc[] +|=== +-- + +* 在列表左上角的下拉列表中选择一个项目,可以查看特定项目中的网络策略。 + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/03-view-network-policy-details.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/03-view-network-policy-details.adoc new file mode 100644 index 000000000..94b18de14 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/03-view-network-policy-details.adoc @@ -0,0 +1,111 @@ +--- +title: "查看网络策略详情" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 网络策略, 查看网络策略详情" +description: "介绍如何查看网络策略详情。" +weight: 03 +--- + +:ks_permission: **集群网络资源查看** +:ks_navigation: **网络 > 网络策略** + + +本节介绍如何查看网络策略详情。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在网络策略列表中点击一个网络策略的名称打开其详情页面。 + +. 在网络策略详情页面左侧的**属性**区域查看网络策略的资源属性。 ++ +-- +[options="header",cols="1a,4a"] +|=== +|参数 |描述 + +|集群 +|网络策略所属的集群。 + +|项目 +|网络策略所属的项目。 + +|创建时间 +|网络策略的创建时间。 + +|创建者 +|创建网络策略的用户。 +|=== +-- + +. 在网络策略详情页面右侧点击**出站规则**页签查看网络策略的出站规则。 ++ +-- +出站规则用于限制容器组只能访问特定的其他容器组或网段。 + +[%header,cols="1a,4a"] +|=== + +|参数 +|描述 + +|目标 +|规则适用的容器组的信息。 + +* **项目**:规则所属的项目。网络策略中的规则仅适用于网络策略所属项目中的容器组。 + +* **标签**:规则适用的容器组所具有的标签。如果未设置标签,则规则适用于网络策略所属的项目中的所有容器组。 + + +|目的地 +|目标容器组可以访问的其他容器组或网段的信息。 + +* **项目**:目标容器组可以访问的其他容器组所属的项目。 +* **标签**:目标容器组可以访问的其他容器组所具有的标签。如果未设置标签,则目标容器组可以访问项目中的所有容器组。 +* **CIDR**:目标容器组可以访问的网段。 +* **端口**:目标容器组可以访问的其他容器组或网段的端口。如果未设置端口,则目标容器组可以访问其他容器组或网段的所有端口。 +|=== +-- + +. 在网络策略详情页面右侧点击**入站规则**页签查看网络策略的入站规则。 ++ +-- +入站规则用于限制容器组只能被特定的其他容器组或网段访问。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|目标 +| +include::../../../../_custom/clusterManagement/networkPolicies/networkPolicies-para-target.adoc[] + +|目的地 +|可以访问目标容器组的其他容器组或网段的信息。 + +* **项目**:可以访问目标容器组的其他容器组所属的项目。 +* **标签**:可以访问目标容器组的其他容器组所具有的标签。如果未设置标签,则项目中的所有容器组都可访问目标容器组。 +* **CIDR**:可以访问目标容器组的网段。 +* **端口**:其他容器组或网段可以访问的目标容器组的端口。如果未设置端口,则其他容器组或网段可以访问的目标容器组的所有端口。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/04-edit-network-policy-information.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/04-edit-network-policy-information.adoc new file mode 100644 index 000000000..ef2ab3668 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/04-edit-network-policy-information.adoc @@ -0,0 +1,55 @@ +--- +title: "编辑网络策略信息" +keywords: "Kubernetes, {ks_product}, 集群管理, 项目, 编辑网络策略信息" +description: "介绍如何编辑网络策略信息。" +weight: 04 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 网络策略** + + +本节介绍如何编辑网络策略信息。 + +您可以编辑网络策略的别名和描述。{ks_product_right}不支持编辑已创建网络策略的名称。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的网络策略右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑信息**。 + +. 在**编辑信息**对话框,设置网络策略的别名和描述,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|别名 +|网络策略的别名。不同项目的网络策略可以相同。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|网络策略的描述信息。描述可包含任意字符,最多包含 256 个字符。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/05-edit-network-policy-yaml.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/05-edit-network-policy-yaml.adoc new file mode 100644 index 000000000..5818a156e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/05-edit-network-policy-yaml.adoc @@ -0,0 +1,44 @@ +--- +title: "编辑网络策略配置" +keywords: "Kubernetes, {ks_product}, 集群管理, 项目, 编辑网络策略配置, yaml" +description: "介绍如何编辑网络策略配置。" +weight: 05 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 网络策略** + + +本节介绍如何编辑网络策略的配置。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的网络策略右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑 YAML**。 + +. 在**编辑 YAML**对话框,修改网络策略的配置,然后点击**确定**。 ++ +-- +有关网络策略配置文件的具体参数,请参阅 link:https://kubernetes.io/zh/docs/concepts/services-networking/network-policies/[Kubernetes 官方文档]。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/06-delete-network-policies.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/06-delete-network-policies.adoc new file mode 100644 index 000000000..dfac45146 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/06-delete-network-policies.adoc @@ -0,0 +1,64 @@ +--- +title: "删除网络策略" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 网络策略, 删除网络策略" +description: "介绍如何删除网络策略。" +weight: 06 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 网络策略** + + +本节介绍如何删除网络策略。 + +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +网络策略删除后无法恢复,请谨慎执行此操作。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + +== 删除单个网络策略 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + +. 在需要删除的网络策略右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除网络策略**对话框,输入网络策略的名称,然后点击**确定**。 + + +== 批量删除网络策略 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 选择需要删除的网络策略左侧的复选框,然后在网络策略列表上方点击**删除**。 + +. 在**批量删除网络策略**对话框,输入网络策略的名称,然后点击**确定**。 ++ +-- +include::../../../../_custom/note-separateNamesByComma.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/01-workspace-network-isolation.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/01-workspace-network-isolation.adoc new file mode 100644 index 000000000..5b703eb53 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/01-workspace-network-isolation.adoc @@ -0,0 +1,36 @@ +--- +title: "启用企业空间网络隔离" +keywords: "Kubernetes, {ks_product}, 企业空间, 企业空间设置, 基本信息, 启用和禁用网络隔离" +description: "介绍如何启用和禁用企业空间网络隔离。" +weight: 01 +--- + +:ks_permission: **企业空间网络隔离管理** +:ks_navigation: **企业空间设置 > 基本信息** + + +本节介绍如何为授权给企业空间的集群启用和禁用网络隔离。 + +当授权给企业空间的集群启用网络隔离后,属于该企业空间且运行在该集群中的容器组将不能被企业空间外部的客户端访问,也不能被集群外部的客户端访问。属于该企业空间且运行在该集群中的容器组的出站流量不受限制。 + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + +== 操作步骤 + +include::../../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**网络隔离**区域,点击集群右侧的开关为集群启用或禁用网络隔离。 diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/02-project-network-isolation.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/02-project-network-isolation.adoc new file mode 100644 index 000000000..d6b9a1020 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/02-project-network-isolation.adoc @@ -0,0 +1,148 @@ +--- +title: "启用项目网络隔离" +keywords: "Kubernetes, {ks_product}, 项目管理, 项目设置, 网络隔离, 启用网络隔离" +description: "介绍如何启用项目网络隔离。" +weight: 02 +--- + +:ks_permission: **项目网络隔离管理** +:ks_navigation: **项目设置 > 网络隔离** + + +本节介绍如何启用项目网络隔离,以及添加和删除隔离白名单。 + + +== 前提条件 + +:relfileprefix: ../../../../../ +* {empty} +include::../../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + +== 操作步骤 + +=== 启用网络隔离 + +include::../../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**网络隔离**页面,点击**启用**。 ++ +-- +// Note +include::../../../../../../_ks_components/admonitions/note.adoc[] + +启用网络隔离后,其他项目的容器组、其他节点主机环境以及集群外部的所有网段将无法访问当前项目中的容器组。默认对出站没有限制,即在未设置白名单条目的情况下,当前项目中的容器组可以与其他项目的容器组、其他节点主机环境以及集群外部的所有网段通信。添加白名单条目后,仅允许当前项目中的容器组与特定项目中的容器组、其他节点主机环境和集群外部网段通信。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +=== 添加白名单 + +. 启用网络隔离后,点击**内部白名单**或**外部白名单**页签。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|内部白名单 +|允许当前项目中的容器组与当前企业空间其他项目中的容器组通信。 + +|外部白名单 +|允许当前项目中的容器组与企业空间外部的特定网段和端口通信。 +|=== +-- + +. 在**内部白名单**或**外部白名单**页签,点击**添加白名单条目**。 + +. 在**添加白名单条目**对话框,设置白名单条目的参数,然后点击**确定**。 ++ +==== +* 对于内部白名单条目,请设置以下参数: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|流量方向 +|白名单条目放行的流量方向。 + +* **出站**:从当前项目到其他项目的方向。 + +* **入站**:从其他项目到当前项目的方向。 + +|类型 +|白名单条目匹配其他项目容器组的方式。 + +* **项目**:当前项目中的容器组可以与指定项目中的所有容器组通信。 + +* **服务**:当前项目中的容器组可以与指定服务的后端容器组通信。 +|=== +-- + +* 对于外部白名单条目,请设置以下参数: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|白名单条目的名称。 + +|流量方向 +|白名单条目放行的流量方向。 + +* **出站**:从当前项目到企业空间外的方向。 + +* **入站**:从企业空间外到当前项目的方向。 + +|网段 +|企业空间外部的网络地址和子网掩码。支持无类别域间路由(CIDR)。 + +* 在已添加的网段右侧点击image:/images/ks-qkcp/zh/icons/copy-light.svg[copy-light,18,18]可创建网段副本。 +* 在已添加的网段右侧点击image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18]可删除网段。 +* 点击**添加新网段**可设置多个网段。 + +|端口 +|白名单条目放行的端口号。 + +* 对于出站白名单条目,此处的端口为企业空间外部地址的端口。 + +* 对于入站白名单条目,此处的端口为当前项目容器组的端口。 + +* 在已添加的端口右侧点击image:/images/ks-qkcp/zh/icons/copy-light.svg[copy-light,18,18]可创建端口副本。 +* 在已添加的端口右侧点击image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18]可删除端口。 +* 点击**添加新端口范围**可设置多个端口范围,点击**添加新端口**可设置多个端口。 +|=== +-- + +白名单条目创建完成后将显示在内部白名单或外部白名单列表中。 +==== + +. 在**外部白名单**列表中,点击条目名称可查看条目详情,在条目右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18] > **编辑**,编辑白名单条目详情。 + +=== 删除白名单 + +// Warning +include::../../../../../../_ks_components/admonitions/warning.adoc[] + +删除白名单条目可能会导致当前项目中的容器组网络连接中断,请谨慎执行此操作。 + +include::../../../../../../_ks_components/admonitions/admonEnd.adoc[] + +. 在**网络隔离**页面,点击**内部白名单**或**外部白名单**页签。 + +. 在需要删除的内部白名单条目右侧点击image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18];在需要删除的外部白名单条目右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除白名单条目**对话框,输入白名单条目的名称,然后点击**确定**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/_index.adoc new file mode 100644 index 000000000..8338eff08 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/07-network-isolation/_index.adoc @@ -0,0 +1,27 @@ +--- +title: "网络隔离" +keywords: "Kubernetes, {ks_product}, 企业空间, 网络策略, 项目设置, 网络隔离" +description: "介绍如何为企业空间和项目启用网络隔离。" +weight: 07 +layout: "second" +--- + + +本节介绍如何为企业空间和项目启用网络隔离。 + +网络隔离功能用于控制企业空间和项目中容器组的出站和入站流量。您可以使用网络隔离功能实现以下目的: + +* 只允许当前企业空间和项目的容器组访问特定的其他容器组或网段。 + +* 只允许当前企业空间和项目的容器组被特定的其他容器组或网段访问。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +启用企业空间网络隔离会自动在相应集群中为该企业空间下的所有项目创建网络策略。若企业空间有新增项目,会自动为该项目创建网络策略。若从企业空间移除项目,该项目的网络策略也会自动移除。 + +启用项目网络隔离会自动在相应集群中为该项目创建网络策略。 +|=== diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/_index.adoc new file mode 100644 index 000000000..a1995f722 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/01-network-policies/_index.adoc @@ -0,0 +1,16 @@ +--- +title: "网络策略" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络策略" +description: "介绍如何管理集群网络策略。" +weight: 01 +layout: "second" +--- + + +本节介绍如何管理网络策略。 + +网络策略用于控制集群中容器组的访问和被访问权限,允许在同个集群内实现网络的隔离。您可以使用网络策略实现以下目的: + +* 只允许容器组访问特定的其他容器组或网段。 + +* 只允许容器组被特定的其他容器组或网段访问。 diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/01-create-a-pod-ip-pool.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/01-create-a-pod-ip-pool.adoc new file mode 100644 index 000000000..597e7c28e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/01-create-a-pod-ip-pool.adoc @@ -0,0 +1,153 @@ +--- +title: "创建容器组 IP 池" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 容器组 IP 池, 创建容器组 IP 池" +description: "介绍如何创建容器组 IP 池。" +weight: 01 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 容器组 IP 池** + + +本节介绍如何创建容器组 IP 池。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**创建容器组 IP 池**对话框,设置容器组 IP 池的参数,然后点击**下一步**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|IP 地址 +|容器组 IP 池对应网段的网络地址。 + +|掩码 +|容器组 IP 池对应网段的掩码位数。 + +|数量 +|创建容器组 IP 池的数量。最多可同时创建 10 个容器组 IP 池。如果创建数量大于或等于 2,系统将根据自动填充其他 IP 池的网络地址。您也可以根据需要自定义其他 IP 池的网络地址。 +|=== +-- + +. 在**容器组 IP 池**对话框,点击image:/images/ks-qkcp/zh/icons/pen-light.svg[pen,18,18],在弹出的**编辑容器组 IP 池**区域,设置以下参数,然后点击**创建**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|网段 +|容器组 IP 池的 IP 范围。 + +|名称 +|容器组 IP 池名称。您可以修改系统默认生成的名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母或数字开头或结尾,最长 63 个字符。 + +|IP 池块大小 +|IP 池用于分配 IP 的 block 的 CIDR 大小。 + +|NAT outgoing +|是否允许通过 NAT 方式跨 IP 池通信。 + +启用此功能后,来自此 IP 池中的 Calico 网络容器发送到任何 Calico IP 池之外的目的地的数据包将被伪装。 + +若启用 IPIP 或 VXLAN 模式,建议开启 NAT outgoing,否则运行 Calico 的工作负载和主机之间的路由是非对称的,并且可能由于 RPF 检查失败而导致流量被过滤。 + +|别名 +|容器组 IP 池的别名。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|容器组 IP 池的描述信息。描述可包含任意字符,最多包含 256 个字符。 + +|选择节点 +|使用标签选择器为 IP 池匹配合适的节点。 + +* **节点范围** + +** 全部:匹配标签选择范围内的所有节点。 +** 全部禁止:禁止自动分配 IP 池的 IP 地址到任一节点的容器组。 + +* **标签选择** + +ifeval::["{file_output_type}" == "html"] +** 键:节点标签的键。点击输入自定义的键。有关节点标签的更多信息,请参阅link:../../../../07-cluster-management/03-nodes/06-edit-node-labels.adoc[编辑节点标签]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +** 键:节点标签的键。点击输入自定义的键。有关节点标签的更多信息,请参阅《{ks_product_right}集群管理指南》的“节点”章节。 +endif::[] + +** 操作符:筛选条件的操作符。 + +*** 包含:键对应的值包含特定的字符串。 + +*** 不包含:键对应的值不包含特定的字符串。 + +*** 存在:节点标签中存在特定的键。 + +*** 不存在:节点标签中不存在特定的键。 + +** 值: 键对应的值必须包含的字符串。按 **Enter** 可设置多个字符串,键对应的值包含其中一个字条串即满足条件。 + +** 点击**添加**可同时创建多个标签。 + +** 在已添加的标签右侧点击image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18] 可删除标签。 + +* **自定义** + +通过自定义表达式来筛选符合条件的节点。有关表达式的更多信息,请参阅link:https://docs.tigera.io/calico/latest/reference/resources/ippool#node-selector[节点选择器]。 + +|IPIP 模式 + +|IPIP 模式属于 Overlay 模式之一,不能与 VXLAN 模式同时设置。若两者都设置为 Never,则使用 BGP 模式。 + +IPIP 模式: 在每个节点上创建一个 IP in IP 隧道来实现容器之间的通信。取值如下: + +** Always: 永远进行 IPIP 封装(默认)。 + +** CrossSubnet: 只在跨网段时才进行 IPIP 封装。 + +** Never: 从不进行 IPIP 封装。 + + +|VXLAN 模式 + +|VXLAN 模式属于 Overlay 模式之一,不能与 IPIP 模式同时设置。若两者都设置为 Never,则使用 BGP 模式。 + +VXLAN 模式:在每个节点上创建一个 VXLAN 隧道来实现容器之间的通信。取值如下: + +** Always: 永远进行 VXLAN 封装。 + +** CrossSubnet: 只在跨网段时才进行 VXLAN 封装。 + +** Never: 从不进行 VXLAN 封装。 +|=== + +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/02-view-a-pod-ip-pool-list.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/02-view-a-pod-ip-pool-list.adoc new file mode 100644 index 000000000..53b9f9b0c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/02-view-a-pod-ip-pool-list.adoc @@ -0,0 +1,77 @@ +--- +title: "查看容器组 IP 池列表" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 容器组 IP 池, 查看容器组 IP 池列表" +description: "介绍如何查看容器组 IP 池列表。" +weight: 02 +--- + +:ks_permission: **集群网络资源查看** +:ks_navigation: **网络 > 容器组 IP 池** + + +本节介绍如何查看容器组 IP 池列表。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +* 容器组 IP 池列表提供以下信息: ++ +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|容器组 IP 池的名称。 + +|状态 +|容器组 IP 池的状态。 + +|网段 +|容器组 IP 池包含的网段。 + +|已用 IP 地址 +|容器组 IP 池中已经使用的 IP 地址数量和 IP 地址总数。 + +|IP 池块大小 +|IP 池用于分配 IP 的 block 的 CIDR 大小。 + +|Overlay 模式 +|容器之间的通信模式。支持 IPIP 模式和 VXLAN 模式。如果未设置,则使用 BGP 模式。 + +|NAT outgoing +|是否允许通过 NAT 方式跨 IP 池通信。 +|=== ++ +include::../../../../../_ks_components/admonitions/note.adoc[] + +{ks_product_right}安装完成后系统会自动创建容器组 IP 池 **default-ipv4-ippool**。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + ++ +* 在列表上方点击搜索框并输入关键字,可搜索名称包含特定关键字的容器组 IP 池。 ++ +include::../../../../../_ks_components/oper-refreshListData.adoc[] ++ +include::../../../../../_ks_components/oper-customizeColumns.adoc[] + diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/03-view-pod-ip-pool-details.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/03-view-pod-ip-pool-details.adoc new file mode 100644 index 000000000..fbe71653f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/03-view-pod-ip-pool-details.adoc @@ -0,0 +1,89 @@ +--- +title: "查看容器组 IP 池详情" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 容器组 IP 池, 查看容器组 IP 池详情" +description: "介绍如何查看容器组 IP 池详情。" +weight: 03 +--- + +:ks_permission: **集群网络资源查看** +:ks_navigation: **网络 > 容器组 IP 池** + + +本节介绍如何查看容器组 IP 池详情。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在容器组 IP 池列表中点击一个容器组 IP 池的名称打开其详情页面。 + +. 在容器组 IP 池详情页面左侧的**属性**区域查看容器组 IP 池的基本信息。 ++ +-- + +[%header,cols="2,5"] +|=== +|参数 |描述 + +|状态 +|容器组 IP 池的状态。 + +|网段 +|容器组 IP 池包含的网段。 + +|已用 IP 地址 +|已使用的 IP 地址数量。 + +|IP 池块大小 +|IP 池用于分配 IP 的 block 的 CIDR 大小。 + +|NAT outgoing +|是否允许通过 NAT 方式跨 IP 池通信。 + +|Overlay 模式 +|容器之间的通信模式。支持 IPIP 模式和 VXLAN 模式。 + +|掩码 +|容器组 IP 池对应网段的掩码位数。 + +|网络 +|容器组 IP 池对应网络的 IP 地址。 + +|起始 IP 地址/结束 IP 地址 +|容器组 IP 池包含的 IP 地址范围。 + +|创建时间 +|容器组 IP 池的创建时间。 + +|创建者 +|创建容器组 IP 池的用户。 +|=== +-- + +. 在容器组 IP 池详情页面右侧的**项目**页签,查看可以使用容器组 IP 池的项目名称、已使用 IP 地址数量和项目管理员。 + +. 在容器组 IP 池右侧的**容器组**页签,查看使用容器组 IP 池的全部容器组。 ++ +-- +include::../../../../_custom/clusterManagement/nodes/nodes-para-podList.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/04-assign-a-project-to-a-ip-pool.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/04-assign-a-project-to-a-ip-pool.adoc new file mode 100644 index 000000000..120dc8986 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/04-assign-a-project-to-a-ip-pool.adoc @@ -0,0 +1,47 @@ +--- +title: "将容器组 IP 池分配到项目" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 容器组 IP 池, 禁止自动分配" +description: "介绍如何将容器组 IP 池分配到项目。" +weight: 04 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 容器组 IP 池** + + +本节介绍如何将容器组 IP 池分配到项目。 + +若项目被分配到容器组 IP 池,在该项目中创建工作负载和任务时,若不指定容器组 IP 池,项目中的容器组会默认分配到该容器组 IP 池。 + +若项目未分配到容器组 IP 池,即项目未与任何容器组 IP 池绑定,在该项目中创建工作负载和任务时,若不指定容器组 IP 池,项目中的容器组将被分配到任一可用的容器组 IP 池。 + +一个 IP 池可以分配给多个项目,一个项目可以绑定多个 IP 池。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + +. 在容器组 IP 池列表中点击一个容器组 IP 池的名称打开其详情页面。 + +. 在**项目**页签下点击**新增项目**,在下拉列表中选择一个项目,然后点击**确定**。 + +. 点击项目右侧的image:/images/ks-qkcp/zh/icons/trash-light.svg[trash,18,18],解除容器组 IP 池和该项目的绑定。点击右上角的**移除全部**,解除容器组 IP 池和所有已分配项目的绑定。 ++ +移除项目后,项目将不再受该 IP 池的资源分配限制,已经分配 IP 地址的项目容器组不受影响。 diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/05-edit-pod-ip-pool-information.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/05-edit-pod-ip-pool-information.adoc new file mode 100644 index 000000000..88f2cb769 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/05-edit-pod-ip-pool-information.adoc @@ -0,0 +1,55 @@ +--- +title: "编辑容器组 IP 池信息" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 容器组 IP 池, 编辑容器组 IP 池信息" +description: "介绍如何编辑容器组 IP 池信息。" +weight: 05 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 容器组 IP 池** + + +本节介绍如何编辑容器组 IP 池信息。 + +您可以编辑容器组 IP 池的别名和描述。{ks_product_right}不支持编辑容器组 IP 池的名称。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的容器组 IP 池右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑信息**。 + +. 在**编辑信息**对话框,设置容器组 IP 池的别名和描述,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|别名 +|容器组 IP 池的别名。不同容器组 IP 池的别名可以相同。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|容器组 IP 池的描述信息。描述可包含任意字符,最多包含 256 个字符。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/06-edit-overlay-mode.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/06-edit-overlay-mode.adoc new file mode 100644 index 000000000..93070f65c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/06-edit-overlay-mode.adoc @@ -0,0 +1,72 @@ +--- +title: "编辑 Overlay 模式" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 容器组 IP 池, 编辑 Overlay 模式" +description: "介绍如何编辑 Overlay 模式。" +weight: 06 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 容器组 IP 池** + + +本节介绍如何编辑 Overlay 模式。 + +Overlay 模式可以实现容器的跨主机互相通信,而无需对宿主机的物理网络进行改动。 + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的容器组 IP 池右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑 Overlay 模式**。 + +. 在**编辑 Overlay 模式**对话框,选择 IPIP 模式或 VXLAN 模式,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|模式 |描述 + +|IPIP 模式 +|在每个节点上创建一个 IP in IP 隧道来实现容器之间的通信。取值如下: + +** **Always**: 永远进行 IPIP 封装(默认)。 + +** **CrossSubnet**: 只在跨网段时才进行 IPIP 封装。 + +** **Never**: 从不进行 IPIP 封装。 + +|VXLAN 模式 +|在每个节点上创建一个 VXLAN 隧道来实现容器之间的通信。取值如下: + +** **Always**: 永远进行 VXLAN 封装。 + +** **CrossSubnet**: 只在跨网段时才进行 VXLAN 封装。 + +** **Never**: 从不进行 VXLAN 封装。 +|=== +-- + +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +若两者都设置为 Never,则使用 BGP 模式。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/07-edit-yaml-for-a-pod-ip-pool.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/07-edit-yaml-for-a-pod-ip-pool.adoc new file mode 100644 index 000000000..e92f29cac --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/07-edit-yaml-for-a-pod-ip-pool.adoc @@ -0,0 +1,51 @@ +--- +title: "编辑节点选择" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 容器组 IP 池, 禁止自动分配" +description: "介绍如何设置容器组 IP 池的自动分配节点。" +weight: 07 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 容器组 IP 池** + + +本节介绍如何编辑容器组 IP 池的自动分配节点,以便为容器组 IP 池自动匹配合适的节点。 + +创建容器组 IP 池时,默认其 IP 地址可分配给所有节点的容器组。您可以设置节点选择器,以限制符合特定条件的节点上的容器组才能使用该 IP 池的 IP 地址。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的容器组 IP 池右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑 yaml**。 + +. 在 **spec.nodeSelector** 参数下输入表达式,通过自定义表达式来筛选符合条件的节点。有关表达式的更多信息,请参阅link:https://docs.tigera.io/calico/latest/reference/resources/ippool#node-selector[节点选择器]。 + + +[.admon.attention,cols="a"] +|=== +|注意 + +| +* 容器组 IP 池的 CIDR 不得与节点的 CIDR 以及服务的 CIDR 重复。 +* 修改相关字段时,您必须明确操作后带来的影响,请谨慎操作。 +|=== diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/08-disable-and-enable-pod-ip-pool.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/08-disable-and-enable-pod-ip-pool.adoc new file mode 100644 index 000000000..2bc3dd03f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/08-disable-and-enable-pod-ip-pool.adoc @@ -0,0 +1,56 @@ +--- +title: "禁用和启用容器组 IP 池" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 容器组 IP 池, 禁用和启用容器组 IP 池" +description: "介绍如何禁用和启用容器组 IP 池。" +weight: 08 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 容器组 IP 池** + + +本节介绍如何禁用和启用容器组 IP 池。 + +容器组 IP 池禁用后将不会继续 IP 地址的分配,也不会影响已经分配 IP 地址的容器组的网络,但禁用容器组 IP 池会自动解除其绑定的项目。迁移容器组 IP 池时,新 IP 池可用地址数量不能少于当前 IP 池使用的 IP 地址。 + +//warning +[.admon.warning,cols="a"] +|=== +|警告 + +| +迁移完成后,将重启工作负载。请谨慎执行此操作。 + +|=== + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ +. 在需要操作的容器组 IP 池右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**禁用**。 + +. 在**禁用容器组 IP 池**对话框,点击**确定**。 + +. 在已禁用的容器组 IP 池右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**启用**可启用容器组 IP 池。 + ++ +-- +若被禁用的容器组 IP 池中有已分配的 IP,勾选**迁移容器组 IP 池**,可将已经分配 IP 地址的容器组迁移至新的容器组 IP 池。 +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/09-delete-pod-ip-pools.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/09-delete-pod-ip-pools.adoc new file mode 100644 index 000000000..6c17d0abf --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/09-delete-pod-ip-pools.adoc @@ -0,0 +1,68 @@ +--- +title: "删除容器组 IP 池" +keywords: "Kubernetes, {ks_product}, 集群管理, 网络, 容器组 IP 池, 删除容器组 IP 池信息" +description: "介绍如何删除容器组 IP 池。" +weight: 09 +--- + +:ks_permission: **集群网络资源管理** +:ks_navigation: **网络 > 容器组 IP 池** + + +本节介绍如何删除容器组 IP 池。 + +// Warning +include::../../../../../_ks_components/admonitions/warning.adoc[] + +容器组 IP 池删除后不能恢复,请谨慎执行此操作。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网络**扩展组件。 + + +include::../../../../_custom/clusterManagement/podIpPools/podIpPools-prer-notUsed.adoc[] + + +== 删除单个容器组 IP 池 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要删除的容器组 IP 池右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除容器组 IP 池**对话框,输入容器组 IP 池的名称,然后点击**确定**。 + + +== 批量删除容器组 IP 池 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 选择需要删除的容器组 IP 池左侧的复选框,然后在容器组 IP 池列表上方点击**删除**。 + +. 在**批量删除容器组 IP 池**对话框,输入容器组 IP 池的名称,然后点击**确定**。 ++ +-- +include::../../../../_custom/note-separateNamesByComma.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/_index.adoc new file mode 100644 index 000000000..13b1c7537 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/02-pod-ip-pools/_index.adoc @@ -0,0 +1,12 @@ +--- +title: "容器组 IP 池" +keywords: "Kubernetes, {ks_product}, 集群管理, 容器组 IP 池" +description: "介绍如何管理集群容器组 IP 池。" +weight: 02 +layout: "second" +--- + + +本节介绍如何管理集群的容器组 IP 池。 + +容器组 IP 池用于为容器组分配 IP 地址。每个容器组 IP 池包含一个可在集群内部访问的私网 IP 网段,您可以在创建工作负载或任务时指定容器组 IP 池。 diff --git a/content/zh/docs/v4.1/11-use-extensions/11-network/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/11-network/_index.adoc new file mode 100644 index 000000000..2182ae336 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/11-network/_index.adoc @@ -0,0 +1,19 @@ +--- +title: "KubeSphere 网络" +keywords: "Kubernetes, {ks_product}, 集群管理, 项目管理, 网络, 网络策略, 容器组 IP 池, 网络隔离" +description: "介绍如何管理网络策略和容器组 IP 池。" +weight: 11 +layout: "second" +--- + + +本节介绍如何使用“KubeSphere 网络”扩展组件来管理集群的网络策略和容器组 IP 池,以及企业空间和项目的网络隔离配置。 + +“KubeSphere 网络”扩展组件包含网络策略和容器组 IP 池两个组件。使用该扩展组件,您可以控制集群和项目中容器组的访问和被访问权限;当创建工作负载或任务时,通过选择**容器组 IP 池**,为容器组分配 IP 地址,确保每个容器组都有一个唯一的 IP 地址。 + +安装“KubeSphere 网络”扩展组件后, + +- 集群左侧导航栏的**网络**菜单下将显⽰**网络策略**和**容器组 IP 池**选项; +- 企业空间左侧导航栏的**基本信息**页面将支持启用企业空间网络隔离; +- 项目左侧导航栏的**项目设置**菜单下将显⽰**网络隔离**选项; +- 创建工作负载或任务时,**高级设置**页签将显示**容器组 IP 池**选项。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/01-enable-a-project-gateway.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/01-enable-a-project-gateway.adoc new file mode 100644 index 000000000..2fb571699 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/01-enable-a-project-gateway.adoc @@ -0,0 +1,44 @@ +--- +title: "启用项目网关" +keywords: "Kubernetes, {ks_product}, 项目管理, 项目设置, 网关设置, 启用项目网关" +description: "介绍如何启用项目网关。" +weight: 01 +--- + + +:ks_permission: **项目网关管理** +:ks_navigation: **项目设置 > 网关设置** + + +本节介绍如何启用项目网关。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在页面右侧点击**启用网关**。 + +. 在弹出的对话框,设置网关的参数,然后点击**确定**。 ++ +-- +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-para-enableGateway_v4.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/02-view-project-gateway-information.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/02-view-project-gateway-information.adoc new file mode 100644 index 000000000..9be95e282 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/02-view-project-gateway-information.adoc @@ -0,0 +1,38 @@ +--- +title: "查看项目网关信息" +keywords: "Kubernetes, {ks_product}, 项目管理, 项目设置, 网关设置, 查看项目网关信息" +description: "介绍如何查看项目网关信息。" +weight: 02 +--- + +:ks_permission: **项目网关查看** +:ks_navigation: **项目设置 > 网关设置** + + +本节介绍如何查看项目网关信息。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] ++ +-- +**网关设置**页面提供以下信息: + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-para-gatewayCard.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/03-view-project-gateway-details.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/03-view-project-gateway-details.adoc new file mode 100644 index 000000000..36847c84b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/03-view-project-gateway-details.adoc @@ -0,0 +1,37 @@ +--- +title: "查看项目网关详情" +keywords: "Kubernetes, {ks_product}, 项目管理, 项目设置, 网关设置, 查看项目网关详情" +description: "介绍如何查看项目网关详情。" +weight: 03 +--- + + +:ks_permission: **项目网关查看** +:ks_navigation: **项目设置 > 网关设置** + + +本节介绍如何查看项目网关详情。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-oper-viewGatewayDetails.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/04-edit-project-gateway-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/04-edit-project-gateway-settings.adoc new file mode 100644 index 000000000..6e09381c9 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/04-edit-project-gateway-settings.adoc @@ -0,0 +1,37 @@ +--- +title: "编辑项目网关设置" +keywords: "Kubernetes, {ks_product}, 项目管理, 项目设置, 网关设置, 编辑项目网关设置" +description: "介绍如何编辑项目网关设置。" +weight: 04 +--- + + +:ks_permission: **项目网关管理** +:ks_navigation: **项目设置 > 网关设置** + + +本节介绍如何编辑项目网关设置。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-oper-editGatewaySettings_v4.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/05-disable-a-project-gateway.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/05-disable-a-project-gateway.adoc new file mode 100644 index 000000000..32123bf95 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/05-disable-a-project-gateway.adoc @@ -0,0 +1,38 @@ +--- +title: "禁用项目网关" +keywords: "Kubernetes, {ks_product}, 项目管理, 项目设置, 网关设置, 禁用项目网关" +description: "介绍如何禁用项目网关。" +weight: 05 +--- + +:ks_permission: **项目网关管理** +:ks_navigation: **项目设置 > 网关设置** + + +本节介绍如何禁用项目网关。 + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-warn-disableGateway.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-oper-disableGateway.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/_index.adoc new file mode 100644 index 000000000..2bb4fd936 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/01-project-gateway/_index.adoc @@ -0,0 +1,23 @@ +--- +title: "项目网关" +keywords: "Kubernetes, {ks_product}, 项目管理, 项目设置, 网关设置" +description: "介绍如何管理项目网关。" +weight: 01 +layout: "second" +--- + + + +本节介绍如何管理项目网关。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +项目网关启用后,除了在项目网关设置页面对其进行管理,还可以在集群和企业空间的网关设置页面查看、编辑和禁用项目网关。 +|=== + + + diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/01-enable-workspace-gateway.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/01-enable-workspace-gateway.adoc new file mode 100644 index 000000000..6516c14c6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/01-enable-workspace-gateway.adoc @@ -0,0 +1,52 @@ +--- +title: "启用企业空间网关" +keywords: "Kubernetes, {ks_product}, 企业空间管理, 企业空间设置,启用企业空间网关" +description: "介绍如何启用企业空间网关。" +weight: 01 +--- + +:ks_permission: **企业空间网关管理** +:ks_navigation: **企业空间设置 > 网关设置** + + +本节介绍如何启用企业空间网关。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在页面右侧的**网关设置**页面,点击**启用网关**。 ++ +-- +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +不支持在企业空间的**网关设置**页面启用项目网关。如果您需要启用项目网关,请前往对应的项目。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +. 在弹出的**启用网关**对话框,设置网关的参数,然后点击**确定**。 ++ +-- +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-para-enableGateway_v4.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/02-view-workspace-gateway-info.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/02-view-workspace-gateway-info.adoc new file mode 100644 index 000000000..f72c048c9 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/02-view-workspace-gateway-info.adoc @@ -0,0 +1,47 @@ +--- +title: "查看企业空间网关信息" +keywords: "Kubernetes, {ks_product}, 企业空间管理, 企业空间设置, 网关设置, 查看企业空间网关信息" +description: "介绍如何查看企业空间网关信息。" +weight: 02 +--- + + +:ks_permission: **企业空间网关查看** +:ks_navigation: **企业空间设置 > 网关设置** + + +本节介绍如何查看企业空间网关信息。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +如果已启用集群网关,在企业空间的网关设置页面也可以查看集群网关的信息。 +|=== + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] ++ +-- +**网关设置**页面提供以下信息: + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-para-gatewayCard.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/03-view-workspace-gateway-details.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/03-view-workspace-gateway-details.adoc new file mode 100644 index 000000000..ec2bb298e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/03-view-workspace-gateway-details.adoc @@ -0,0 +1,37 @@ +--- +title: "查看企业空间网关详情" +keywords: "Kubernetes, {ks_product}, 企业空间管理, 企业空间设置, 网关设置, 查看企业空间网关详情" +description: "介绍如何查看企业空间网关详情。" +weight: 03 +--- + + +:ks_permission: **企业空间网关查看** +:ks_navigation: **企业空间设置 > 网关设置** + + +本节介绍如何查看企业空间网关详情。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-oper-viewGatewayDetails_v4.adoc[] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/04-edit-workspace-gateway-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/04-edit-workspace-gateway-settings.adoc new file mode 100644 index 000000000..b3aed5e67 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/04-edit-workspace-gateway-settings.adoc @@ -0,0 +1,37 @@ +--- +title: "编辑企业空间网关设置" +keywords: "Kubernetes, {ks_product}, 企业空间管理, 企业空间设置, 网关设置,编辑企业空间网关设置" +description: "介绍如何编辑企业空间网关设置。" +weight: 04 +--- + +:ks_permission: **企业空间网关管理** +:ks_navigation: **企业空间设置 > 网关设置** + + +本节介绍如何编辑企业空间网关设置。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-oper-editGatewaySettings_v4.adoc[] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/05-disable-workspace-gateway.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/05-disable-workspace-gateway.adoc new file mode 100644 index 000000000..1b771d595 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/05-disable-workspace-gateway.adoc @@ -0,0 +1,39 @@ +--- +title: "禁用企业空间网关" +keywords: "Kubernetes, {ks_product}, 企业空间管理, 企业空间设置, 网关设置,禁用企业空间网关" +description: "介绍如何禁用企业空间网关。" +weight: 05 +--- + +:ks_permission: **企业空间网关管理** +:ks_navigation: **企业空间设置 > 网关设置** + + +本节介绍如何禁用企业空间网关。 + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-warn-disableGateway.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/workspaceManagement/workspaceManagement-prer-requiredPermission_v4.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/workspaceManagement/workspaceManagement-oper-openWorkspacePage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-oper-disableGateway.adoc[] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/_index.adoc new file mode 100644 index 000000000..a1ad07f72 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/02-workspace-gateway/_index.adoc @@ -0,0 +1,20 @@ +--- +title: "企业空间网关" +keywords: "Kubernetes, {ks_product}, 网关设置, 企业空间,网关设置" +description: "介绍本节介绍如何设置企业空间网关。" +weight: 02 +layout: "second" +--- + + + +本节介绍如何管理企业空间网关。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +企业空间网关启用后,除了在企业空间网关设置页面对其进行管理,还可以在集群网关设置页面查看、编辑和禁用企业空间网关。 +|=== diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/01-enable-a-cluster-gateway.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/01-enable-a-cluster-gateway.adoc new file mode 100644 index 000000000..969210698 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/01-enable-a-cluster-gateway.adoc @@ -0,0 +1,52 @@ +--- +title: "启用集群网关" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 网关设置, 启用集群网关" +description: "介绍如何启用集群网关。" +weight: 01 +--- + +// :ks_permission: **集群设置管理** +:ks_navigation: **集群设置 > 网关设置** + + +本节介绍如何启用集群网关。 + +[.admon.attention,cols="a"] +|=== +|注意 + +| +若未启用企业空间网关或项目网关,启用集群网关后,将不能再启用企业空间网关和项目网关。 +|=== + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +// :relfileprefix: ../../../../ +// * {empty} +// include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +// :relfileprefix: ./ + +* 您需要加入一个集群并在集群中具有 **cluster-admin** 角色。有关更多信息,请参阅link:../../../../07-cluster-management/09-cluster-settings/03-cluster-members/[集群成员]和link:../../../../07-cluster-management/09-cluster-settings/04-cluster-roles/[集群角色]。 + + +== 操作步骤 + +// include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + +. 以具有 **cluster-admin** 角色的用户登录{ks_product_left} Web 控制台。 ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在页面右侧点击**启用网关**。 + +. 在弹出的对话框,设置网关的参数,然后点击**确定**。 ++ +-- +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-para-enableGateway_v4.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/02-view-gateway-information.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/02-view-gateway-information.adoc new file mode 100644 index 000000000..d3ce94ff1 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/02-view-gateway-information.adoc @@ -0,0 +1,44 @@ +--- +title: "查看网关信息" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 网关设置, 查看网关信息" +description: "介绍如何查看网关信息。" +weight: 02 +--- + +// :ks_permission: **集群设置查看** +:ks_navigation: **集群设置 > 网关设置** + + +本节介绍如何查看网关信息。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +// :relfileprefix: ../../../../ +// * {empty} +// include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +// :relfileprefix: ./ + +* 您需要加入一个集群并在集群中具有 **cluster-admin** 角色。有关更多信息,请参阅link:../../../../07-cluster-management/09-cluster-settings/03-cluster-members/[集群成员]和link:../../../../07-cluster-management/09-cluster-settings/04-cluster-roles/[集群角色]。 + + +== 操作步骤 + +// include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + +. 以具有 **cluster-admin** 角色的用户登录{ks_product_left} Web 控制台。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**网关设置**页面,点击**集群网关**,查看集群网关的信息。 ++ +-- +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-para-gatewayCard.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/03-view-cluster-gateway-details.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/03-view-cluster-gateway-details.adoc new file mode 100644 index 000000000..1f1fe57d0 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/03-view-cluster-gateway-details.adoc @@ -0,0 +1,40 @@ +--- +title: "查看集群网关详情" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 网关设置, 查看集群网关详情" +description: "介绍如何查看网关信息。" +weight: 03 +--- + +:ks_permission: **集群设置查看** +:ks_navigation: **集群设置 > 网关设置** + + +本节介绍如何查看集群网关详情。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +// :relfileprefix: ../../../../ +// * {empty} +// include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +// :relfileprefix: ./ + +* 您需要加入一个集群并在集群中具有 **cluster-admin** 角色。有关更多信息,请参阅link:../../../../07-cluster-management/09-cluster-settings/03-cluster-members/[集群成员]和link:../../../../07-cluster-management/09-cluster-settings/04-cluster-roles/[集群角色]。 + + +== 操作步骤 + +// include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + +. 以具有 **cluster-admin** 角色的用户登录{ks_product_left} Web 控制台。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-oper-viewGatewayDetails_v4.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/04-edit-cluster-gateway-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/04-edit-cluster-gateway-settings.adoc new file mode 100644 index 000000000..0cd9fe12f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/04-edit-cluster-gateway-settings.adoc @@ -0,0 +1,39 @@ +--- +title: "编辑集群网关设置" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 网关设置, 编辑集群网关设置" +description: "介绍如何编辑集群网关设置。" +weight: 04 +--- + +// :ks_permission: **集群设置管理** +:ks_navigation: **集群设置 > 网关设置** + + +本节介绍如何编辑集群网关设置。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +// :relfileprefix: ../../../../ +// * {empty} +// include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +// :relfileprefix: ./ + +* 您需要加入一个集群并在集群中具有 **cluster-admin** 角色。有关更多信息,请参阅link:../../../../07-cluster-management/09-cluster-settings/03-cluster-members/[集群成员]和link:../../../../07-cluster-management/09-cluster-settings/04-cluster-roles/[集群角色]。 + + +== 操作步骤 + +// include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] +. 以具有 **cluster-admin** 角色的用户登录{ks_product_left} Web 控制台。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-oper-editGatewaySettings_v4.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/05-disable-a-cluster-gateway.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/05-disable-a-cluster-gateway.adoc new file mode 100644 index 000000000..a91574c8e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/05-disable-a-cluster-gateway.adoc @@ -0,0 +1,42 @@ +--- +title: "禁用集群网关" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 网关设置, 禁用集群网关" +description: "介绍如何禁用集群网关。" +weight: 05 +--- + + +// :ks_permission: **集群设置管理** +:ks_navigation: **集群设置 > 网关设置** + + +本节介绍如何禁用集群网关。 + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-warn-disableGateway.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件。 + +// :relfileprefix: ../../../../ +// * {empty} +// include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +// :relfileprefix: ./ + +* 您需要加入一个集群并在集群中具有 **cluster-admin** 角色。有关更多信息,请参阅link:../../../../07-cluster-management/09-cluster-settings/03-cluster-members/[集群成员]和link:../../../../07-cluster-management/09-cluster-settings/04-cluster-roles/[集群角色]。 + + +== 操作步骤 + +// include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] +. 以具有 **cluster-admin** 角色的用户登录{ks_product_left} Web 控制台。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-oper-disableGateway.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/07-issue-no-gateway-log-in-member.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/07-issue-no-gateway-log-in-member.adoc new file mode 100644 index 000000000..5e27a7cef --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/07-issue-no-gateway-log-in-member.adoc @@ -0,0 +1,46 @@ +--- +title: "附录:member 集群网关日志无数据的解决办法" +description: "介绍如何处理 member 集群的网关日志无数据的问题。" +weight: 07 +--- + +若 member 集群的“集群网关”详情页中,“网关日志”页签不显示数据,可采用以下方法解决。 + +. 启用 host 集群上 whizard-telemetry-apiserver 服务的 NodePort 访问模式。 + +.. 在 host 集群的**应用负载**菜单下,点击**服务**进入服务页面。 + +.. 搜索服务 `whizard-telemetry-apiserver`,点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18] > **编辑外部访问**。 + +.. 在**编辑外部访问**对话框,选择 NodePort,然后点击**确定**。 + +. 修改 KubeSphere 网关的扩展组件配置,将 `backend.config.gateway.logSearchEndpoint` 设置为 host 集群上 whizard-telemetry-apiserver 服务的访问地址。 ++ +[,yaml] +---- +backend: + enabled: true + config: + gateway: + namespace: kubesphere-controls-system + valuesOverride: + controller: + image: + registry: "" + image: kubesphereio/nginx-ingress-controller + tag: "v1.4.0" + pullPolicy: IfNotPresent + digest: "" + exposeNodeLabelKey: "node-role.kubernetes.io/control-plane" + versionConstraint: ">= 4.3.0, < 4.5.0" + logSearchEndpoint: "http://whizard-telemetry-apiserver.extension-whizard-telemetry.svc:9090" # 替换为 http://: +---- + +. 在 member 集群上,重启网关 `gateway-agent-backend-apiserver`。 ++ +[,bash] +---- +kubectl -n extension-gateway rollout restart deploy gateway-agent-backend-apiserver +---- + +. 刷新 member 集群的**网关日志**页签,即可看到网关日志数据。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/_index.adoc new file mode 100644 index 000000000..d1078c90a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/03-cluster-gateway/_index.adoc @@ -0,0 +1,21 @@ +--- +title: "集群网关" +keywords: "Kubernetes, {ks_product}, 集群管理, 集群设置, 网关设置" +description: "介绍如何管理集群网关。" +weight: 03 +layout: "second" +--- + + + +本节介绍如何管理集群网关。 + +//note +[.admon.note,cols="a"] +|=== +|说明 + +| +若已启用企业空间网关或项目网关,可在集群的网关设置页面查看、编辑和禁用企业空间网关或项目网关。 +|=== + diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/01-create-a-route.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/01-create-a-route.adoc new file mode 100644 index 000000000..295e91ec9 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/01-create-a-route.adoc @@ -0,0 +1,42 @@ +--- +title: "创建应用路由" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用路由, 创建应用路由" +description: "介绍如何创建应用路由。" +weight: 01 +--- + +:ks_permission: **应用负载管理** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../_custom/clusterManagement/routes/routes-desc-createARoute.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +* 如需创建支持 HTTPS 协议的应用路由,您需要创建 **TLS 信息**类型的保密字典,保密字典中必须包含 Base64 编码的证书和私钥。 + +* 应用路由所属的项目中存在至少一个服务。 + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-createARoute_v4.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/02-view-a-route-list.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/02-view-a-route-list.adoc new file mode 100644 index 000000000..e832acff8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/02-view-a-route-list.adoc @@ -0,0 +1,42 @@ +--- +title: "查看应用路由列表" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用路由, 查看应用路由列表" +description: "介绍如何查看应用路由列表。" +weight: 02 +--- + +:ks_permission: **应用负载查看** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../_custom/clusterManagement/routes/routes-desc-viewARouteList.adoc[] + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +include::../../../../_custom/clusterManagement/routes/routes-para-routeList.adoc[] + +include::../../../../_custom/clusterManagement/routes/routes-oper-searchForRoutes.adoc[] + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/03-view-route-details.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/03-view-route-details.adoc new file mode 100644 index 000000000..c4ab5cf13 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/03-view-route-details.adoc @@ -0,0 +1,40 @@ +--- +title: "查看应用路由详情" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用路由, 查看应用路由详情" +description: "介绍如何查看应用路由详情。" +weight: 03 +--- + +:ks_permission: **应用负载查看** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../_custom/clusterManagement/routes/routes-desc-viewRouteDetails.adoc[] + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-openDetailsPage.adoc[] + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-viewRouteDetails.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/04-access-a-backend-service-of-a-route.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/04-access-a-backend-service-of-a-route.adoc new file mode 100644 index 000000000..acf9c1847 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/04-access-a-backend-service-of-a-route.adoc @@ -0,0 +1,42 @@ +--- +title: "访问应用路由的后端服务" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用路由, 访问应用路由的后端服务" +description: "介绍如何访问应用路由的后端服务。" +weight: 04 +--- + +:ks_permission: **应用负载查看** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../_custom/clusterManagement/routes/routes-desc-accessABackendServiceOfARoute.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeSphere 网关**扩展组件,然后启用集群网关或项目网关。有关更多信息,请参阅 link:../../../../11-use-extensions/12-gateway[KubeSphere 网关]。 + +include::../../../../_custom/clusterManagement/routes/routes-prer-accessABackendServiceOfARoute.adoc[] + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-openDetailsPage.adoc[] + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-accessABackendServiceOfARoute.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/05-edit-route-information.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/05-edit-route-information.adoc new file mode 100644 index 000000000..f32ca9acf --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/05-edit-route-information.adoc @@ -0,0 +1,36 @@ +--- +title: "编辑应用路由信息" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用路由, 编辑应用路由信息" +description: "介绍如何编辑应用路由信息。" +weight: 05 +--- + +:ks_permission: **应用负载管理** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../_custom/clusterManagement/routes/routes-desc-editRouteInformation.adoc[] + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-editRouteInformation.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/06-edit-routing-rules.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/06-edit-routing-rules.adoc new file mode 100644 index 000000000..3d3361bb7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/06-edit-routing-rules.adoc @@ -0,0 +1,36 @@ +--- +title: "编辑路由规则" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用路由, 编辑路由规则" +description: "介绍如何编辑路由规则。" +weight: 06 +--- + +:ks_permission: **应用负载管理** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../_custom/clusterManagement/routes/routes-desc-editingRutingRules.adoc[] + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-editRoutingRules.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/07-edit-route-annotations.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/07-edit-route-annotations.adoc new file mode 100644 index 000000000..0952beae7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/07-edit-route-annotations.adoc @@ -0,0 +1,36 @@ +--- +title: "编辑应用路由注解" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用路由, 编辑应用路由注解" +description: "介绍如何应用路由注解。" +weight: 07 +--- + +:ks_permission: **应用负载管理** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../_custom/clusterManagement/routes/routes-desc-editRouteAnnotations.adoc[] + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-editRouteAnnotations.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/08-delete-routes.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/08-delete-routes.adoc new file mode 100644 index 000000000..ead57b6b2 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/08-delete-routes.adoc @@ -0,0 +1,49 @@ +--- +title: "删除应用路由" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用路由, 删除应用路由" +description: "介绍如何删除应用路由。" +weight: 08 +--- + +:ks_permission: **应用负载管理** +:ks_navigation: **应用负载 > 应用路由** + + +include::../../../../_custom/clusterManagement/routes/routes-desc-deleteMultipleRoutes.adoc[] + + +== 前提条件 + + +:relfileprefix: ../../../../ + +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + + +== 删除单个应用路由 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-deleteASingleRoute.adoc[] + + +== 批量删除应用路由 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/routes/routes-oper-deleteRoutes.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/_index.adoc new file mode 100644 index 000000000..440eb45eb --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/05-routes/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "应用路由" +keywords: "Kubernetes, {ks_product}, 项目管理, 应用负载, 应用路由" +description: "介绍如何管理应用路由。" +weight: 05 +layout: "second" +--- + + + +include::../../../../_custom/clusterManagement/routes/routes-desc-routes.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/12-gateway/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/12-gateway/_index.adoc new file mode 100644 index 000000000..d3aed9460 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/12-gateway/_index.adoc @@ -0,0 +1,38 @@ +--- +title: "KubeSphere 网关" +description: "介绍如何使用“KubeSphere 网关”扩展组件。" +weight: 12 +layout: "second" +--- + +本节介绍如何使用“KubeSphere 网关”扩展组件,启用和管理集群、企业空间和项目的网关,以及管理集群和项目的应用路由。 + +include::../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-desc-gateway.adoc[] + +{ks_product_right}对每个集群提供一个集群网关,对集群中每个企业空间提供一个企业空间网关,并且对企业空间中每个项目提供一个项目网关,分别用于为整个集群、单个企业空间和单个项目中的服务提供反向代理。 + +安装“KubeSphere 网关”组件后, + +* 集群左侧导航栏的**集群设置**菜单下将显⽰**网关设置**选项; +* 企业空间左侧导航栏的**企业空间设置**菜单下将显⽰**网关设置**选项; +* 项目左侧导航栏的**项目设置**菜单下将显⽰**网关设置**选项。 +* 集群和项目下才能创建和管理应用路由。 + +[.admon.tip,cols="a"] +|=== +|提示 + +| +启用集群网关、企业空间网关、或项目网关后,在集群或项目的**应用负载 > 应用路由**菜单下创建应用路由时,可在**高级设置**页签选择对应网关的 IngressClassName。 +|=== + + +[.admon.note,cols="a"] +|=== +|说明 + +| +* 如需使用链路追踪功能,{ks_product_right}平台需要安装并启用 **KubeSphere 服务网格**扩展组件。 +* 如需使用网关监控功能,{ks_product_right}平台需要安装并启用 **WhizardTelemetry 监控**扩展组件。 +* 如需使用网关日志搜索功能,{ks_product_right}平台需要安装并启用 **WhizardTelemetry 日志**扩展组件。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/01-add-a-domain.adoc b/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/01-add-a-domain.adoc new file mode 100644 index 000000000..4948349fe --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/01-add-a-domain.adoc @@ -0,0 +1,64 @@ +--- +title: "添加域名重用校验" +description: "介绍如何添加域名重用校验。" +weight: 01 +--- + +:ks_navigation: **应用负载 > 应用路由工具** + + +本节介绍如何在应用路由工具页面添加域名,以便在创建或编辑应用路由时对域名进行唯一性校验,确保该域名没有被其他项目使用。 + +// 在{ks_product_both}平台上进行以下操作时,支持域名唯一性校验: + +// * 集群 >应用负载 >应用路由 > 创建/编辑路由规则 +// * 项目 > 应用负载 >应用路由 > 创建/编辑路由规则 +// * 项目 > 服务网格 > 自制应用 > 添加应用路由 > 创建/编辑路由规则 +// * 联邦项目 > 应用负载 >应用路由 > 创建/编辑路由规则 +// * 联邦项目 >应用负载 >自制应用 > 创建自制应用 > 创建/编辑路由规则 + +[.admon.note,cols="a"] +|=== +|说明 + +|“域名重用校验”仅对当前集群生效,且不作用于之前已存在的应用路由。 +|=== + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用路由工具**扩展组件。 + +* 您需要在{ks_product_both}平台具有 **cluster-admin** 角色。 + + +== 操作步骤 + +. 以具有 **cluster-admin** 角色的用户登录{ks_product_left} Web 控制台并进入您的集群。 + ++ + +include::../../../../_ks_components/oper-navigate.adoc[] + +. 在页面点击**添加域名**。 + +. 在**添加域名**对话框,设置域名信息。 ++ +-- + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|域名的名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母或数字开头和结尾,最长 63 个字符。 + +|域名 +|域名地址,支持使用通配符进行匹配。 + +通配符 * 标识匹配所有,但只匹配一个层级的子域名。即:*.qingcloud.com 标识匹配后缀为 .qingcloud.com 的所有域名,但不匹配 *.xxx.qingcloud.com。 + +|描述 +|域名的描述。描述可包含任意字符,最长 256 个字符。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/02-view-a-domain-list.adoc b/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/02-view-a-domain-list.adoc new file mode 100644 index 000000000..e82ac9c8c --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/02-view-a-domain-list.adoc @@ -0,0 +1,52 @@ +--- +title: "查看域名列表" +description: "介绍如何查看域名列表。" +weight: 02 +--- + +:ks_navigation: **应用负载 > 应用路由工具** + + +本节介绍如何查看已启用“域名重用校验”的域名列表。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用路由工具**扩展组件。 + +* 您需要在{ks_product_both}平台具有 **cluster-viewer** 角色。 + +== 操作步骤 + +. 登录{ks_product_left} Web 控制台并进入您的集群。 + ++ + +include::../../../../_ks_components/oper-navigate.adoc[] + ++ +==== +* 域名列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|域名的名称和描述。 + +|域名 +|域名地址,支持使用通配符进行匹配。 +|=== +-- + +* 在列表上方点击搜索框并设置搜索条件,可按名称或域名搜索。名称支持模糊查询,域名仅支持等值查询,不支持模糊查询。 + +include::../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../_ks_components/oper-customizeColumns.adoc[] +==== + + + diff --git a/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/03-edit-domain-information.adoc b/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/03-edit-domain-information.adoc new file mode 100644 index 000000000..e136e66b6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/03-edit-domain-information.adoc @@ -0,0 +1,32 @@ +--- +title: "编辑域名信息" +description: "介绍如何编辑域名信息。" +weight: 03 +--- + +:ks_navigation: **应用负载 > 应用路由工具** + + +本节介绍如何编辑域名信息。 + +您可以编辑域名的描述。{ks_product_right}不支持编辑已添加域名的名称和域名。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用路由工具**扩展组件。 + +* 您需要在{ks_product_both}平台具有 **cluster-admin** 角色。 + + +== 操作步骤 + +. 以具有 **cluster-admin** 角色的用户登录{ks_product_left} Web 控制台并进入您的集群。 + ++ + +include::../../../../_ks_components/oper-navigate.adoc[] + +. 在需要操作的域名右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑信息**。 + +. 在**编辑信息**对话框,设置域名的描述,然后点击**确定**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/06-delete-domains.adoc b/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/06-delete-domains.adoc new file mode 100644 index 000000000..de66f8509 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/06-delete-domains.adoc @@ -0,0 +1,47 @@ +--- +title: "删除域名重用校验" +description: "介绍如何删除域名重用校验。" +weight: 04 +--- + +:ks_navigation: **应用负载 > 应用路由工具** + + +本节介绍如何删除域名,以停止对域名进行重用校验。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 应用路由工具**扩展组件。 + +* 您需要在{ks_product_both}平台具有 **cluster-admin** 角色。 + + +== 删除单个域名 + +. 以具有 **cluster-admin** 角色的用户登录{ks_product_left} Web 控制台并进入您的集群。 + ++ + +include::../../../../_ks_components/oper-navigate.adoc[] + +. 在需要删除的域名右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除域名**对话框,输入域名的名称,然后点击**确定**。 + + +== 批量删除域名 + +. 以具有 **cluster-admin** 角色的用户登录{ks_product_left} Web 控制台并进入您的集群。 + ++ + +include::../../../../_ks_components/oper-navigate.adoc[] + +. 选择需要删除的域名左侧的复选框,然后在域名列表上方点击**删除**。 + +. 在**批量删除域名**对话框,输入域名的名称,然后点击**确定**。 ++ +-- +include::../../../_custom/note-separateNamesByComma.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/_index.adoc new file mode 100644 index 000000000..c014ace85 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/13-ingress-utils/_index.adoc @@ -0,0 +1,19 @@ +--- +title: "KubeSphere 应用路由工具" +keywords: "Kubernetes, {ks_product}, 应用路由" +description: "介绍如何使用 KubeSphere 应用路由工具。" +weight: 13 +layout: "second" +draft: true +--- + + +本节介绍如何使用“KubeSphere 应用路由工具”扩展组件。安装后,仅{ks_product_both}平台管理员和已安装该组件的集群的管理员可以使用该扩展组件。 + +“KubeSphere 应用路由工具”为应用路由提供多项实用扩展能力,如域名重用校验,旨在增强企业对应用路由的全局管理能力。 + +添加需要被限制重用的域名后,企业空间用户将无法在不同项目中使用相同的域名来创建应用路由,以避免应用路由间的相互影响,从而防止生产业务出现错误。 + +安装“KubeSphere 应用路由工具”扩展组件前,必须先安装"KubeSphere 网关"扩展组件。 + +安装“KubeSphere 应用路由工具”扩展组件后,集群左侧导航栏的**应用负载**菜单下将显⽰**应用路由工具**选项。 diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/01-create-a-volume-snapshot.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/01-create-a-volume-snapshot.adoc new file mode 100644 index 000000000..4931abdbb --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/01-create-a-volume-snapshot.adoc @@ -0,0 +1,66 @@ +--- +title: "创建卷快照" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照, 创建卷快照" +description: "介绍如何创建卷快照。" +weight: 01 +--- + +:ks_permission: **卷快照管理** +:ks_navigation: **存储 > 卷快照** + + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-desc-createAVolumeSnapshot.adoc[] + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-para-volumeSnapshot.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-prer-persistentVolumeCreated.adoc[] + +// :relfileprefix: ../../../../ +// * 请确保后端存储系统支持卷快照功能,并已在持久卷声明对应的存储类上启用卷快照功能。有关更多信息,请参阅xref:07-cluster-management/08-storage/02-storage-classes/05-enable-and-disable-volume-operations.adoc[启用和禁用卷操作]。 + +// :relfileprefix: ./ + +* 请确保后端存储系统支持卷快照功能,并已在持久卷声明对应的存储类上启用卷快照功能。操作方法:存储类 > 更多操作 > 设置卷操作 > 启用卷快照创建。 + +== 方法 1:卷快照 > 创建卷快照 + +在集群中,可在**卷快照**菜单下直接为持久卷声明创建卷快照。 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-oper-createAVolumeSnapshot.adoc[] + +== 方法 2:持久卷声明 > 创建卷快照 + +在集群或项目中,可在**持久卷声明**菜单下为持久卷声明创建卷快照。 + +. 以具有**持久卷声明管理**权限以及pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + +. 在左侧导航栏选择**存储 > 持久卷声明**。 + +. 在持久卷声明列表中点击一个持久卷声明的名称打开其详情页面。 ++ +include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-oper-createAVolumeSnapshot.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/02-view-a-volume-snapshot-list.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/02-view-a-volume-snapshot-list.adoc new file mode 100644 index 000000000..c241a3f4b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/02-view-a-volume-snapshot-list.adoc @@ -0,0 +1,45 @@ +--- +title: "查看卷快照列表" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照, 查看卷快照列表" +description: "介绍如何查看卷快照。" +weight: 02 +--- + + +:ks_permission: **卷快照查看** +:ks_navigation: **存储 > 卷快照** + + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-desc-viewAVolumeSnapshotList.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-para-volumeSnapshotList_v4.adoc[] + +* 在列表左上角的下拉列表中选择一个项目,可查看特定项目中的卷快照。 + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-oper-searchForVolumeSnapshots.adoc[] + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/03-view-volume-snapshot-details.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/03-view-volume-snapshot-details.adoc new file mode 100644 index 000000000..4a4b7cd82 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/03-view-volume-snapshot-details.adoc @@ -0,0 +1,41 @@ +--- +title: "查看卷快照详情" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照, 查看卷快照详情" +description: "介绍如何查看卷快照的详情。" +weight: 03 +--- + + +:ks_permission: **卷快照查看** +:ks_navigation: **存储 > 卷快照** + + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-desc-viewVolumeSnapshotDetails.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-oper-openDetailsPage.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-oper-viewVolumeSnapshotDetails_v4.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/04-create-a-persistent-volume-from-a-volume-snapshot.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/04-create-a-persistent-volume-from-a-volume-snapshot.adoc new file mode 100644 index 000000000..436960ab3 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/04-create-a-persistent-volume-from-a-volume-snapshot.adoc @@ -0,0 +1,41 @@ +--- +title: "使用卷快照创建持久卷" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照, 创建持久卷声明" +description: "介绍如何使用卷快照创建持久卷。" +weight: 04 +--- + + +:ks_permission: **卷快照管理** +:ks_navigation: **存储 > 卷快照** + + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-desc-createAPersistentVolumeFromAVolumeSnapshot.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-oper-openDetailsPage.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-oper-createAPersistentVolumeFromAVolumeSnapshot.adoc[] \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/05-delete-volume-snapshots.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/05-delete-volume-snapshots.adoc new file mode 100644 index 000000000..2359be770 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/05-delete-volume-snapshots.adoc @@ -0,0 +1,51 @@ +--- +title: "删除卷快照" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照, 删除卷快照" +description: "介绍如何删除卷快照。" +weight: 05 +--- + + +:ks_permission: **卷快照管理** +:ks_navigation: **存储 > 卷快照** + + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-desc-deleteVolumeSnapshots.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_clusterandproject.adoc[] + +:relfileprefix: ./ + + + +== 删除单个卷快照 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-oper-deleteASingleVolumeSnapshot.adoc[] + + +== 批量删除卷快照 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-oper-deleteMultipleVolumeSnapshots.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/06-view-a-volume-snapshot-content-list.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/06-view-a-volume-snapshot-content-list.adoc new file mode 100644 index 000000000..327cc8ab8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/06-view-a-volume-snapshot-content-list.adoc @@ -0,0 +1,80 @@ +--- +title: "查看卷快照内容列表" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照, 查看卷快照列表" +description: "介绍如何查看卷快照内容列表。" +weight: 06 +--- + + +:ks_permission: **卷快照内容查看** +:ks_navigation: **存储 > 卷快照** + + +本节介绍如何查看卷快照内容列表。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-oper-openListPage.adoc[] + ++ +==== +* 卷快照列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|卷快照内容的名称。 + +|状态 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-status.adoc[] + +|容量 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-capacity.adoc[] + +|卷快照类 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-volumeSnapshotClass.adoc[] + +|删除策略 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-deletionPolicy.adoc[] + +|创建时间 +|卷快照内容的创建时间。 +|=== +-- + +* 在列表左上角的下拉列表中选择一个项目,可查看特定项目中的卷快照。 + +* 在列表上方点击搜索框并设置搜索条件,可按名称或状态搜索卷快照内容。 + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/07-view-volume-snapshot-content-details.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/07-view-volume-snapshot-content-details.adoc new file mode 100644 index 000000000..4041b7d6d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/07-view-volume-snapshot-content-details.adoc @@ -0,0 +1,84 @@ +--- +title: "查看卷快照内容详情" +keywords: "Kubernetes, {ks_product}, 集群管理, 卷快照内容, 查看卷快照内容详情" +description: "介绍如何查看卷快照内容详情。" +weight: 07 +--- + +:ks_permission: **卷快照内容查看** +:ks_navigation: **存储 > 卷快照** + + +本节介绍如何查看卷快照内容详情。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在**卷快照**页面点击**卷快照内容**,然后点击一个卷快照内容的名称打开其详情页面。 + +. 在卷快照内容详情页面左侧的**属性**区域查看卷快照的资源属性。 ++ +-- + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|状态 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-status.adoc[] + +|容量 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-capacity.adoc[] + +|卷快照类 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-volumeSnapshotClass.adoc[] + +|快照句柄 +|卷快照内容在后端存储系统的唯一标识符。 + +|供应者 +|卷快照类对应的存储插件。 + +|删除策略 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-deletionPolicy.adoc[] + +|创建时间 +|卷快照内容的创建时间。 + +|创建者 +|创建卷快照内容的用户。 +|=== +-- + +. 在持久卷详情页面右侧的**资源状态**页签查看卷快照内容对应的卷快照名称和卷快照类。 + +. 在持久卷详情页面右侧点击**元数据**页签查看卷快照内容的标签和注解。 + +. 在持久卷详情页面右侧点击**事件**页签查看卷快照内容的事件。 ++ +-- +include::../../../../_custom/clusterManagement/clusterManagement-para-eventsTab.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/08-edit-volume-snapshot-content-information.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/08-edit-volume-snapshot-content-information.adoc new file mode 100644 index 000000000..bdd324c80 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/08-edit-volume-snapshot-content-information.adoc @@ -0,0 +1,57 @@ +--- +title: "编辑卷快照内容信息" +keywords: "Kubernetes, {ks_product}, 集群管理, 卷快照内容" +description: "介绍如何编辑卷快照内容的信息。" +weight: 08 +--- + +:ks_permission: **卷快照内容管理** +:ks_navigation: **存储 > 卷快照** + + +本节介绍如何编辑卷快照内容的信息。 + +您可以编辑卷快照内容的别名和描述。{ks_product_right}不支持编辑卷快照内容的名称。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-oper-openListPage.adoc[] + ++ + +. 在需要操作的卷快照内容右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑信息**。 + +. 在**编辑信息**对话框,设置卷快照内容的别名和描述,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|别名 +|卷快照内容的别名。不同卷快照内容的别名可以相同。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|卷快照内容的描述信息。描述可包含任意字符,最多包含 256 个字符。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/09-delete-a-volume-snapshot-content.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/09-delete-a-volume-snapshot-content.adoc new file mode 100644 index 000000000..ffc4624cd --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/09-delete-a-volume-snapshot-content.adoc @@ -0,0 +1,82 @@ +--- +title: "删除卷快照内容" +keywords: "Kubernetes, {ks_product}, 集群管理, 卷快照内容, 删除卷快照内容" +description: "介绍如何删除卷快照内容。" +weight: 09 +--- + + +:ks_permission: **卷快照内容管理** +:ks_navigation: **存储 > 卷快照** + + +本节介绍如何删除卷快照内容。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +当卷快照和卷快照内容绑定的时候,卷快照内容不允许删除。若要删除卷快照内容,必须首先删除卷快照。卷快照被删除后,系统将根据卷快照内容的删除策略,决定是否自动删除卷快照内容。 +|=== + +// Warning +include::../../../../../_ks_components/admonitions/warning.adoc[] + +卷快照内容删除后无法恢复,并且后端存储系统中保存的快照数据也将被删除,请谨慎执行此操作以避免快照数据丢失。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 删除单个卷快照内容 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-oper-openListPage.adoc[] + ++ + +. 在需要删除的卷快照内容右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除卷快照内容**对话框,输入卷快照内容的名称,然后点击**确定**。 + + +== 批量删除卷快照内容 + +. 以具有pass:a,q[{ks_permission}]权限的用户登录{ks_product_left} Web 控制台并进入您的集群或项目。 + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-oper-openListPage.adoc[] + ++ + +. 选择需要删除的卷快照内容左侧的复选框,然后在列表上方点击**删除**。 + +. 在**批量删除卷快照内容**对话框,输入卷快照的名称,然后点击**确定**。 ++ +-- +include::../../../../_custom/note-separateNamesByComma.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/_index.adoc new file mode 100644 index 000000000..1052c98e1 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/03-volume-snapshots/_index.adoc @@ -0,0 +1,18 @@ +--- +title: "卷快照" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照" +description: "介绍如何管理卷快照。" +weight: 03 +layout: "second" +--- + + +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-desc-volumeSnapshots.adoc[] + +[.admon.note,cols="a"] +|=== +|说明 + +| +如果您在安装{ks_product_both}时未指定外部持久化存储系统,{ks_product_right}将使用集群节点的本地存储系统作为持久化存储系统。通常情况下,集群节点的本地存储系统不支持卷快照功能。创建卷快照前,您需要为{ks_product_both}集群安装存储插件,确保后端存储系统支持卷快照功能,并创建link:../04-volume-snapshot-classes/01-create-a-volume-snapshot-class[卷快照类]。 +|=== diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/01-create-a-volume-snapshot-class.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/01-create-a-volume-snapshot-class.adoc new file mode 100644 index 000000000..2a8492769 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/01-create-a-volume-snapshot-class.adoc @@ -0,0 +1,81 @@ + +--- +title: "创建卷快照类" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照, 创建卷快照类" +description: "介绍如何创建卷快照。" +weight: 01 +--- + + +:ks_permission: **卷快照类管理** +:ks_navigation: **存储 > 卷快照类** + + +本节介绍如何创建卷快照类。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* 为使卷快照类可以正常提供存储资源,您需要提前配置存储系统并安装与存储系统对应的存储插件。有关更多信息,请联系您的存储系统提供商。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**基本信息**页签,设置卷快照类的基本信息,然后点击**下一步**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|卷快照类的名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母或数字开头和结尾,最长 63 个字符。 + +|存储类型 +|块存储、对象存储或文件存储。 + +|别名 +|卷快照类的别名。不同卷快照类的别名可以相同。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|卷快照类的描述信息。描述可包含任意字符,最长 256 个字符。 +|=== +-- + +. 在**卷快照类设置**页签,设置卷快照类的供应者和删除策略,然后点击**创建**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|供应者 +|卷快照类使用的存储插件。 + +|删除策略 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-deletionPolicy.adoc[] +|=== + +卷快照类创建完成后将显示在卷快照类列表中。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/02-view-a-volume-snapshot-class-list.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/02-view-a-volume-snapshot-class-list.adoc new file mode 100644 index 000000000..3cb6b40c6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/02-view-a-volume-snapshot-class-list.adoc @@ -0,0 +1,69 @@ +--- +title: "查看卷快照类列表" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照类, 查看卷快照类列表" +description: "介绍如何查看卷快照类列表。" +weight: 02 +--- + + +:ks_permission: **卷快照类查看** +:ks_navigation: **存储 > 卷快照类** + + +本节介绍如何查看卷快照类列表。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ +==== +* 卷快照类列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|卷快照类的名称、别名和描述信息。 + +|卷快照 +|通过卷快照类创建的卷快照数量。 + +|供应者 +|卷快照类使⽤的存储插件。 + +|删除策略 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-deletionPolicy.adoc[] + +|创建时间 +|卷快照类的创建时间。 +|=== + +-- + +* 在列表上方点击搜索框并设置搜索条件,可搜索名称搜索卷快照类。 + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/03-view-volume-snapshot-class-details.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/03-view-volume-snapshot-class-details.adoc new file mode 100644 index 000000000..43086c33a --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/03-view-volume-snapshot-class-details.adoc @@ -0,0 +1,83 @@ +--- +title: "查看卷快照类详情" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照类, 查看卷快照类详情" +description: "介绍如何查看卷快照类详情。" +weight: 03 +--- + +:ks_permission: **卷快照类查看** +:ks_navigation: **存储 > 卷快照类** + + +本节介绍如何查看卷快照类详情。 + + +== 前提条件 + + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在卷快照类列表中点击一个卷快照类的名称打开卷快照类详情页面。 + +. 在卷快照类详情页面左侧的**属性**区域查看卷快照类的资源属性。 ++ +-- + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|供应者 +| +卷快照类对应的存储插件。 + +|删除策略 +| +include::../../../../_custom/clusterManagement/volumeSnapshotContents/volumeSnapshotContents-para-deletionPolicy.adoc[] + +|创建时间 +|卷快照类的创建时间。 +|=== +-- + +. 在卷快照类详情页面右侧的**卷快照**区域查看使用卷快照类创建的卷快照。 ++ +-- + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|卷快照的名称。 + +|状态 +| +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-para-volumeSnapshotStatus_v4.adoc[] + +|容量 +| +include::../../../../_custom/clusterManagement/volumeSnapshots/volumeSnapshots-para-capacity.adoc[] + +|创建时间 +|卷快照的创建时间。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/04-edit-volume-snapshot-class-information.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/04-edit-volume-snapshot-class-information.adoc new file mode 100644 index 000000000..11b38fd08 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/04-edit-volume-snapshot-class-information.adoc @@ -0,0 +1,55 @@ +--- +title: "编辑卷快照类信息" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照类, 编辑卷快照类信息" +description: "介绍如何编辑卷快照类的信息。" +weight: 04 +--- + + +:ks_permission: **卷快照类管理** +:ks_navigation: **存储 > 卷快照类** + + +本节介绍如何编辑卷快照类的信息。 + +您可以编辑卷快照类的别名和描述。{ks_product_right}不支持编辑卷快照类的名称。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的卷快照类右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑信息**。 + +. 在**编辑信息**对话框,设置卷快照类的别名和描述,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|别名 +|卷快照类的别名。不同卷快照类的别名可以相同。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|卷快照类的描述信息。描述可包含任意字符,最多包含 256 个字符。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/05-delete-volume-snapshot-classes.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/05-delete-volume-snapshot-classes.adoc new file mode 100644 index 000000000..b31e2623e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/05-delete-volume-snapshot-classes.adoc @@ -0,0 +1,65 @@ +--- +title: "删除卷快照类" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照类, 删除卷快照类" +description: "介绍如何删除卷快照类。" +weight: 05 +--- + +:ks_permission: **卷快照类管理** +:ks_navigation: **存储 > 卷快照类** + + +本节介绍如何删除卷快照类。 + +// Warning +include::../../../../../_ks_components/admonitions/warning.adoc[] + +卷快照类删除后,基于卷快照类创建的卷快照和卷快照内容不会被删除,但用户将无法再通过该卷快照类将快照数据保存到后端存储系统。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + + +== 删除单个卷快照类 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要删除的卷快照类右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除卷快照类**对话框,输入卷快照类的名称,然后点击**确定**。 + + +== 批量删除卷快照类 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 选择需要删除的卷快照类左侧的复选框,然后在列表上方点击**删除**。 + +. 在**批量删除卷快照类**对话框,输入卷快照的名称,然后点击**确定**。 ++ +-- +include::../../../../_custom/note-separateNamesByComma.adoc[] +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/_index.adoc new file mode 100644 index 000000000..7a4d83095 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/04-volume-snapshot-classes/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "卷快照类" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 卷快照类" +description: "介绍如何管理卷快照类。" +weight: 04 +layout: "second" +--- + + + +本节介绍如何管理卷快照类。 + +卷快照类定义了可供容器使用的一类卷快照。创建卷快照类前,请为{ks_product_both}集群安装存储插件,并确保后端存储系统支持卷快照功能。有关更多信息,请联系您的存储系统提供商。 diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/01-set-authorization-rules.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/01-set-authorization-rules.adoc new file mode 100644 index 000000000..6abefe1ea --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/01-set-authorization-rules.adoc @@ -0,0 +1,57 @@ +--- +title: "设置授权规则" +description: "介绍如何如何为存储类设置授权规则。" +weight: 01 +--- + +:ks_permission: **存储类访问规则管理** +:ks_navigation: **存储 > 存储类** + + +本节介绍如何为存储类设置授权规则。 + +设置并启用授权规则后,用户只能在特定项目和企业空间使用存储类。 + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/storageClasses/systemClasses-oper-openDetailsPage.adoc[] + ++ + +. 在存储类详情页面的左上角,选择**更多操作 > 设置授权规则**。 + +. 在**设置授权规则**对话框,点击页面右侧的**已禁用**按钮启用授权规则。 ++ +-- +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +若要禁用授权规则,在页面右侧点击**已启用**。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +. 在**授权规则**设置区域,设置在特定的项目和企业空间使用该存储类。 ++ +image:/images/ks-qkcp/zh/v4.1/storage1.png[ rule,100%] + +. 设置完成后,点击**确定**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/02-set-auto-expansion.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/02-set-auto-expansion.adoc new file mode 100644 index 000000000..5c5985b77 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/02-set-auto-expansion.adoc @@ -0,0 +1,71 @@ +--- +title: "设置存储卷自动扩展" +keywords: "Kubernetes, {ks_product}, 集群管理, 存储, 持久卷声明, 持久卷,自动扩展" +description: "介绍如何设置存储卷自动扩展。" +weight: 02 +--- + +:ks_permission: **存储类管理** +:ks_navigation: **存储 > 存储类** + + +本节介绍如何设置存储卷自动扩展。 + +卷容量自动扩展指系统在卷剩余空间低于阈值时自动扩展卷容量。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 存储**扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +// include::../../../../_custom/clusterManagement/persistentVolumeClaims/persistentVolumeClaims-prer-persistentVolumeCreated.adoc[] + +ifeval::["{file_output_type}" == "html"] +* 请确保后端存储系统支持卷扩展功能,且存储类已启用卷扩展功能。有关更多信息,请参阅link:../../../../07-cluster-management/08-storage/02-storage-classes/05-enable-and-disable-volume-operations[启用和禁用卷操作]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +* 请确保后端存储系统支持卷扩展功能,且存储类已启用卷扩展功能。有关更多信息,请参阅《{ks_product_right}集群管理指南》的“存储类 > 启用和禁用卷操作”章节。 +endif::[] + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/clusterManagement/storageClasses/systemClasses-oper-openDetailsPage.adoc[] + ++ + +. 在存储类详情页面的左上角,选择**更多操作 > 设置自动扩展**。 + +. 在**设置自动扩展**对话框,点击页面右侧的**已禁用**按钮启用自动扩展功能。 ++ +-- +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +如果您需要禁用自动扩展功能,在页面右侧点击**已启用**。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +. 在**自动扩展**设置区域,设置扩展的最大容量、阈值、以及增量。 ++ +image:/images/ks-qkcp/zh/v4.1/storage2.png[ scale,100%] + +. (可选)如果您需要系统自动检查卷状态并重启工作负载,请勾选**自动重启工作负载**。 + +. 设置完成后,点击**确定**。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/_index.adoc new file mode 100644 index 000000000..8f453c182 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/05-storage-classes/_index.adoc @@ -0,0 +1,14 @@ +--- +title: "存储类" +description: "介绍如何如何为存储类设置授权规则和自动扩展。" +weight: 05 +layout: "second" +--- + + +本节介绍如何为存储类设置授权规则和自动扩展。 + +安装“KubeSphere 存储”扩展组件后,集群左侧导航栏的**存储**菜单下的**存储类**会显示**设置授权规则**和**设置自动扩展**操作项。 + +* 设置授权规则:用户只能在特定项目和企业空间使用存储类。 +* 设置自动扩展:系统在卷剩余空间低于阈值时自动扩展卷容量。 diff --git a/content/zh/docs/v4.1/11-use-extensions/15-storage/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/15-storage/_index.adoc new file mode 100644 index 000000000..695dd9577 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/15-storage/_index.adoc @@ -0,0 +1,35 @@ +--- +title: "KubeSphere 存储" +keywords: "Kubernetes, {ks_product}, 存储, 卷快照" +description: "介绍如何使用“KubeSphere 存储”扩展组件。" +weight: 15 +layout: "second" +--- + + +本节介绍如何使用“KubeSphere 存储”扩展组件。 + +该扩展组件包含多个存储相关的实用工具: + +* snapshot-controller: 用于为 PVC 创建快照。 +* snapshotclass-controller: 用于为快照计数。 +* pvc-auto-resizer: 用于为 PVC 在容量不足的情况下实现自动扩容。 +* storageclass-accessor: 提供准入控制器,用来验证是否准许在某个命名空间或企业空间创建 PVC。 + + +安装“KubeSphere 存储”扩展组件后, + +* 集群左侧导航栏的**存储**菜单下将显⽰**卷快照**和**卷快照类**选项,**存储**菜单下的**存储类**将显示**设置授权规则**和**设置自动扩展**操作项。 +* 项目左侧导航栏的**存储**菜单下将显⽰**卷快照**选项。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +* 存储类的自动扩展功能支持在 PVC 容量不足的情况下实现自动扩容。仅控制是否允许用户在{ks_product_left} Web 控制台使用相关操作,存储类是否实际支持这些操作取决于后端存储系统。 +* 设置自动扩展需要连接 prometheus 服务才能工作。有关更多信息,请参阅扩展中心“KubeSphere 存储”扩展组件的详情页说明。 +|=== + + + diff --git a/content/zh/docs/v4.1/11-use-extensions/16-dmp/01-intro.adoc b/content/zh/docs/v4.1/11-use-extensions/16-dmp/01-intro.adoc new file mode 100644 index 000000000..4f7413b07 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/16-dmp/01-intro.adoc @@ -0,0 +1,11 @@ +--- +title: "简介" +description: "介绍 RadonDB DMP 数据库管理平台。" +weight: 01 +--- + +RadonDB DMP 是青云科技全新发布的企业级云原生数据库管理平台。在 KubeSphere LuBan 云原生可扩展开放架构之上,RadonDB DMP 能轻松实现多类型主流数据库的跨云部署、多云管理、智能观测与统一运维等,并完整构建围绕高性能、高可用、业务追踪、数据流转等场景下的生态闭环,助力客户真正实现数据库即服务。 + +安装 RadonDB DMP 扩展组件后,点击顶部导航栏上的image:/images/ks-qkcp/zh/icons/grid.svg[grid,18,18]图标,点击 RadonDB DMP,进入数据库管理平台。 + +有关如何使用 RadonDB DMP 数据库管理平台,请参阅 link:https://radondb-docs.kubesphere.com.cn/[RadonDB DMP 使用指南]。 diff --git a/content/zh/docs/v4.1/11-use-extensions/16-dmp/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/16-dmp/_index.adoc new file mode 100644 index 000000000..96de2b605 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/16-dmp/_index.adoc @@ -0,0 +1,7 @@ +--- +title: "RadonDB DMP" +description: "介绍 RadonDB DMP 数据库管理平台。" +weight: 16 +layout: "second" +draft: true +--- diff --git a/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/01-add-an-edge-node.adoc b/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/01-add-an-edge-node.adoc new file mode 100644 index 000000000..44f861ff7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/01-add-an-edge-node.adoc @@ -0,0 +1,138 @@ +--- +title: "添加边缘节点" +keywords: "Kubernetes, {ks_product}, 集群管理, 节点, 添加边缘节点" +description: "介绍如何添加边缘节点。" +weight: 01 +--- + +:ks_permission: **节点管理** +:ks_navigation: **节点 > 边缘节点** + +本节介绍如何添加边缘节点。 + + +== 前提条件 + +:relfileprefix: ../../../ +* {empty} +include::../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeEdge** 扩展组件。 + +* 待添加的边缘节点需要能够访问{ks_product_both}集群主节点的 **30000**、**30001**、**30002**、**30004** 端口。 + +* 待添加的边缘节点已安装 Docker、containerd、CRI-O 或 Virtlet 作为容器运行时。KubeEdge 边缘节点默认使用 containerd 作为运行时。有关更多信息,请参阅 link:https://docs.kubeedge.io/zh/docs/advanced/cri/[KubeEdge 官方文档]。 + +* 已获取待添加的边缘节点的 SSH 登录信息。 + + +== 配置边缘节点 + +执行以下步骤在边缘节点上配置 link:https://kubeedge.io/zh/docs/advanced/edgemesh/[EdgeMesh]。 + +. 执行以下命令编辑 **/etc/nsswitch.conf** 文件: ++ +-- +// Bash +[,bash] +---- +vi /etc/nsswitch.conf +---- +-- + +. 在 **/etc/nsswitch.conf** 文件中添加以下内容,然后保存文件: ++ +-- +// Bash +[,bash] +---- +hosts:          dns files mdns4_minimal [NOTFOUND=return] +---- +-- + +. 执行以下命令在边缘节点上启用 IP 转发: ++ +-- +// Bash +[,bash] +---- +sudo echo "net.ipv4.ip_forward = 1" >> /etc/sysctl.conf +---- +-- + +. 执行以下命令验证配置结果: ++ +-- +// Bash +[,bash] +---- +sudo sysctl -p | grep ip_forward +---- + +如果显示以下信息,则表明配置成功: + +// Bash +[,bash] +---- +net.ipv4.ip_forward = 1 +---- +-- + + +== 添加边缘节点 + +include::../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在页面右侧点击**添加**。 + +. 在**添加边缘节点**对话框,设置边缘节点的参数。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|边缘节点的名称。系统会自动为边缘节点生成名称,您也可以手动设置边缘节点的名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母或数字开头和结尾,最长 63 个字符。 + +// |内部 IP 地址 +// |边缘节点在{ks_product_both}集群内部的 IP 地址。边缘节点的内部 IP 地址不能与{ks_product_both}集群现有节点的内部 IP 地址相同。 + +|添加默认污点 +|是否为边缘节点添加污点以阻止容器组调度到边缘节点上。 +|=== +-- + +. 点击**验证**生成边缘节点配置命令。 + +. 点击**复制**将边缘节点配置命令复制到剪贴板,然后进行以下修改。 ++ +将边缘节点配置命令中的 10000,10001,10002,10004 端口修改为 cloudcore 服务暴露出来的端口 30000,30001,30002,30004。 ++ +image:/images/ks-qkcp/zh/v4.1/kubeedge-port.png[ port,100%] + + +. 登录边缘节点并执行已修改的命令。 ++ +-- +// Note +include::../../../../_ks_components/admonitions/note.adoc[] + +* 请确保边缘节点能够通过 **--cloudcore-ipport** 参数指定的 IP 地址访问{ks_product_both}集群主节点。 + +* 请确保边缘节点能够通过 **--cloudcore-ipport**、**--quicport**、**--certport**、**--tunnelport** 参数指定的端口号分别访问{ks_product_both}集群主节点的 **30000**、**30001**、**30002**、**30004** 端口。 + +* 取决于您的网络环境,您可能需要设置防火墙和流量转发规则。 + +include::../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +. 刷新{ks_product_left} Web 控制台的**边缘节点**页面。如果添加成功,边缘节点将显示在边缘节点列表。 diff --git a/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/02-view-an-edge-node-list.adoc b/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/02-view-an-edge-node-list.adoc new file mode 100644 index 000000000..97242d36f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/02-view-an-edge-node-list.adoc @@ -0,0 +1,68 @@ +--- +title: "查看边缘节点列表" +keywords: "Kubernetes, {ks_product}, 集群管理, 边缘节点, 查看边缘节点列表" +description: "介绍如何查看边缘节点列表。" +weight: 02 +--- + +:ks_permission: **节点查看** + + +本节介绍如何查看边缘节点列表。 + + +== 前提条件 + +:relfileprefix: ../../../ +* {empty} +include::../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeEdge** 扩展组件。 + +== 操作步骤 + +include::../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + +. 在左侧导航栏选择**节点 > 边缘节点**打开节点列表。 + ++ + +==== +* 节点列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|各节点的主机名称和在子网内部的 IP 地址。 +// 各节点的主机名称由用户安装集群时在安装配置文件 **config-sample.yaml** 中设置。 + +|状态 +| +include::../../../_custom/clusterManagement/nodes/nodes-para-nodeStatus_new.adoc[] + +ifeval::["{file_output_type}" == "html"] +如果节点上存在污点,**状态**列还将显示节点上污点的数量。将光标悬停在污点数字上查看污点的具体信息。有关更多信息,请参阅link:../../../07-cluster-management/03-nodes/05-edit-node-taints/[设置节点污点]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +如果节点上存在污点,**状态**列还将显示节点上污点的数量。将光标悬停在污点数字上查看污点的具体信息。有关更多信息,请参阅《{ks_product_right}集群管理指南》的“节点”章节。 +endif::[] + +|角色 +| +各节点在集群中的角色,取值为**代理/边缘节点**。 + +|=== +-- + +* 在列表上方点击搜索框并设置搜索条件,可按名称、状态或角色搜索节点。 + +include::../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/03-delete-an-edge-node.adoc b/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/03-delete-an-edge-node.adoc new file mode 100644 index 000000000..c62dc71a5 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/03-delete-an-edge-node.adoc @@ -0,0 +1,71 @@ +--- +title: "删除边缘节点" +keywords: "Kubernetes, {ks_product}, 集群管理, 节点, 删除边缘节点" +description: "介绍如何删除边缘节点。" +weight: 03 +--- + +:ks_permission: **节点管理** +:ks_menu: **节点 > 边缘节点** + +本节介绍如何删除边缘节点。 + + +== 前提条件 + +:relfileprefix: ../../../ +* {empty} +include::../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **KubeEdge** 扩展组件。 + +* 已获取{ks_product_both}集群主节点和边缘节点的 SSH 登录信息。 + + +== 操作步骤 + +. 登录边缘节点并执行以下命令删除边缘节点中的配置: ++ +-- +// Bash +[,bash] +---- + ./keadm reset +---- + +// Bash +[,bash] +---- +apt remove mosquitto +---- + +// Bash +[,bash] +---- +rm -rf /var/lib/kubeedge /var/lib/edged /etc/kubeedge/ca /etc/kubeedge/certs +---- +-- + +. 登录{ks_product_both}集群主节点并执行以下命令删除边缘节点。 ++ +-- +// Bash +[,bash] +---- +kubectl delete node +---- +-- + +. 在{ks_product_both}集群主节点执行以下命令检查当前的节点: ++ +-- +// Bash +[,bash] +---- +kubectl get node +---- + +如果命令回显中没有显示需要删除的边缘节点,则表明边缘节点删除成功。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/_index.adoc new file mode 100644 index 000000000..cf07fd98d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/17-kubeedge/_index.adoc @@ -0,0 +1,29 @@ +--- +title: "KubeEdge" +keywords: "Kubernetes, {ks_product}, 集群管理, 边缘节点" +description: "介绍如何使用 KubeEdge 管理集群的边缘节点。" +weight: 17 +layout: "second" +draft: true +--- + + +本节介绍如何使用 KubeEdge 扩展组件管理集群的边缘节点。 + +KubeEdge 包含云端和边缘端两部分,可将本机容器化应用编排和管理扩展到边缘端设备。它基于 Kubernetes 构建,为网络和应用程序提供核心基础架构支持,并在云端和边缘端部署应用、同步元数据。使用 KubeEdge,可以很容易地将应用程序部署到边缘端并进行使用。通过在边缘端处理数据,响应速度会显著提高,数据隐私也可以得到更好地保护。 + +安装 KubeEdge 扩展组件后,集群左侧导航栏的**节点**菜单下将显⽰**边缘节点**选项。 + +{ks_product_right}平台支持两类节点: + +* 集群节点:{ks_product_right}集群本地的节点,通常所有集群节点都属于同一个私有网络。 + +* 边缘节点:部署在边缘环境中受{ks_product_both}管理的节点。通常边缘节点相较集群节点更为轻量,与普通节点属于不同的私有网络。 + +ifeval::["{file_output_type}" == "html"] +边缘节点和集群节点的部分操作相同,如查看节点详情、阻⽌和允许容器组调度、编辑节点污点和标签。有关更多信息,请参阅link:../../07-cluster-management/03-nodes[节点管理]。 +endif::[] + +ifeval::["{file_output_type}" == "pdf"] +边缘节点和集群节点的部分操作相同,如查看节点详情、阻⽌和允许容器组调度、编辑节点污点和标签。有关更多信息,请参阅《{ks_product_right}集群管理指南》的“节点”章节。 +endif::[] diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/01-create-a-deployment-and-register-the-deployment-as-a-microservice.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/01-create-a-deployment-and-register-the-deployment-as-a-microservice.adoc new file mode 100644 index 000000000..776d0799e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/01-create-a-deployment-and-register-the-deployment-as-a-microservice.adoc @@ -0,0 +1,300 @@ +--- +title: "创建部署并注册为微服务" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 创建部署并注册为微服务" +description: "介绍如何创建部署并将部署注册为微服务。" +weight: 01 +--- + + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务** + + +本节介绍如何创建部署并将部署注册为微服务。 + +Spring Cloud 微服务实例通过 Kubernetes 部署管理,部署的容器组副本即微服务的实例。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* 创建部署所使用的容器镜像中的应用程序需要符合 Nacos 规范。有关更多信息,请参阅 link:https://nacos.io[Nacos 官方文档]。 + + +== 操作步骤 + +请参阅link:#_参数描述[参数描述]设置部署的参数。 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 点击**启用 Spring Cloud**。 + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**基本信息**页签,设置**部署**的基本信息,然后点击**下一步**。 + +. 在**容器组设置**页签,为**部署**管理的容器组设置副本数量、容器、更新策略、安全上下文、调度规则和元数据,然后点击**下一步**。 + +. 在**存储设置**页签,为部署管理的容器挂载卷,然后点击**下一步**。 + +. 在**高级设置**页签,为部署管理的容器组指定节点,并设置部署的元数据,然后点击**创建**。 ++ +-- +部署创建完成后将被注册为微服务,并显示在微服务列表中。 + +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +在 **Spring Cloud > 微服务**页面创建的部署将被自动注册为微服务。如需对微服务实例进行操作(例如调整实例数量),您需要前往**工作负载 > 部署**页面对微服务对应的部署进行操作。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + + +== 参数描述 + +* 基本信息 ++ +-- +设置部署的基本信息。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|部署的名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母或数字开头和结尾,最长 253 个字符。 + +|别名 +|部署的别名。不同部署的别名可以相同。别名只能包含中文、字母、数字和连字符(-),不得以连字符(-)开头或结尾,最长 63 个字符。 + +|描述 +|部署的描述信息。描述可包含任意字符,最长 256 个字符。 +|=== +-- + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podReplicas.adoc[] + +* 容器组设置 > 添加容器 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addContainer.adoc[] +-- + +* 容器组设置 > 添加容器 > 容器设置 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-setImageNameTypeResource.adoc[] + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerImage.adoc[] + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerName.adoc[] + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerType.adoc[] + +include::../../../../_custom/clusterManagement/projects/projects-para-containerQuotas.adoc[] +|=== +-- + +* 容器组设置 > 添加容器 > 端口设置 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-Port.adoc[] +-- + +* 容器组设置 > 添加容器 > 镜像拉取策略 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-imagePullPolicy.adoc[] +-- + +* 容器组设置 > 添加容器 > 健康检查 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-healthCheck.adoc[] +-- + +* 容器组设置 > 添加容器 > 健康检查 > 添加探针 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addProbe.adoc[] +-- + +* 容器组设置 > 添加容器 > 生命周期管理 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-lifecycleManagement.adoc[] +-- + +* 容器组设置 > 添加容器 > 生命周期管理 > 添加动作 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addAction.adoc[] +-- + +* 容器组设置 > 添加容器 > 启动命令 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-startCommand.adoc[] +-- + +* 容器组设置 > 添加容器 > 环境变量 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-environmentVariables.adoc[] +-- + +* 容器组设置 > 添加容器 > 容器组安全上下文 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-containerSecurityContext.adoc[] +-- + +* 容器组设置 > 添加容器 > 同步主机时区 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-syncTimeZone.adoc[] +-- + +* 容器组设置 > 更新策略 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-updatePolicy.adoc[] +-- + +* 容器组设置 > 更新策略 > 滚动更新设置 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-rollingUpdate.adoc[] +-- + +* 容器组设置 > 容器组安全上下文 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podSecurityContext.adoc[] +-- + +* 容器组设置 > 容器组调度规则 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-podSchedulingRules.adoc[] +-- + +* 容器组设置 > 容器组调度规则 > 自定义规则 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-customRules.adoc[] +-- + +* 容器组设置 > 容器组优雅终止 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-PodGracePeriod.adoc[] +-- + +* 容器组设置 > 添加元数据 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-PodMetadata.adoc[] +-- + +* 存储设置 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-mountVolume.adoc[] + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +// include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-collectLogsOnVolume.adoc[] + +// include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-desc-enableLogCollectionCluster.adoc[] + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-addPVCTemplate.adoc[] + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountVolume.adoc[] + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountSecretOrConfigmap.adoc[] +|=== + +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-oper-editDeleteVolume.adoc[] +-- + +* 存储设置 > 添加持久卷声明模板 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-volumeTemplate.adoc[] +-- + +* 存储设置 > 挂载卷 > 持久卷 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-persistentVolume.adoc[] +-- + +* 存储设置 > 挂载卷 > 临时卷 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-temporaryVolume.adoc[] +-- + +* 存储设置 > 挂载卷 > HostPath 卷 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-hostpathVolume.adoc[] +-- + +* 存储设置 > 挂载配置字典或保密字典 ++ +-- +include::../../../../_custom/clusterManagement/workloads/createWorkload/workloads-para-mountConfigmapSecret.adoc[] +-- + +* 高级设置 ++ +-- +为部署管理的容器组指定节点,并设置部署的元数据。 + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +// |容器组 IP 池 +// |选择用于为容器组副本分配虚拟 IP 地址的 IP 池。 + +|选择节点 +|将容器组副本调度到具有指定标签的节点上。 + +* 您可以手动输入目标节点的标签键值对,也可以点击**指定节点**选择一个节点。 +* 点击**添加节点选择器**可设置多个标签,容器组副本将被调度具有所有指定标签的节点上。 +* 在已创建的标签右侧点击image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18]可删除标签。 + +|添加元数据 +|设置部署的标签和注解。 + +* 点击添加可设置多条标签或注解。 +* 在已创建的标签或注解右侧点击image:/images/ks-qkcp/zh/icons/trash-light.svg[trash-light,18,18]可删除标签或注解。 +|=== +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/02-view-a-microservice-list.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/02-view-a-microservice-list.adoc new file mode 100644 index 000000000..f4a71046b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/02-view-a-microservice-list.adoc @@ -0,0 +1,62 @@ +--- +title: "查看微服务列表" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 查看微服务列表" +description: "介绍如何查看微服务列表。" +weight: 02 +--- + + +:ks_permission: ** Spring Cloud 微服务查看** +:ks_navigation:  **Spring Cloud > 微服务** + + +本节介绍如何查看微服务列表。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +* 服务注册中心显示服务注册中心的地址、微服务的数量、微服务实例的数量和健康实例的数量。 + +* 微服务列表显示每个微服务的实例数量、健康实例数量和当前微服务是否已触发健康保护机制。 ++ +-- +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +* 为了防止因过多实例不健康导致流量全部流向健康实例,继而造成流量压力把健康实例压垮并形成雪崩效应,Nacos 支持设置健康保护阈值。当健康实例数量占微服务总实例数的比例小于该值时,无论实例是否健康,都会将这个实例返回给客户端。 + +* {ks_product_right}的默认健康保护阈值为 0,即默认不使用健康保护机制。您可以参阅 link:https://nacos.io[Nacos 官方文档]设置 Nacos 的健康保护阈值。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] +-- + +* 在列表上方点击搜索框并输入关键字,可搜索名称包含特定关键字的微服务。 + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] +==== + +. 在微服务右侧点击image:/images/ks-qkcp/zh/icons/plus-square.svg[plus-square,18,18]查看微服务的所有实例。 ++ +-- +include::../../../../_custom/projectManagement/microservices/microservices-para-instances.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/03-edit-the-weight-of-a-microservice.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/03-edit-the-weight-of-a-microservice.adoc new file mode 100644 index 000000000..d43b0afb8 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/03-edit-the-weight-of-a-microservice.adoc @@ -0,0 +1,45 @@ +--- +title: "编辑微服务实例权重" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 编辑微服务实例权重" +description: "介绍编辑微服务实例权重。" +weight: 03 +--- + + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务** + + +本节介绍如何编辑微服务实例权重。 + +微服务实例的权重用于决定微服务实例的流量分配,发送给微服务的流量将根据微服务实例的权重分配给微服务实例。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/projectManagement/microservices/microservices-oper-openInstanceList.adoc[] + ++ + +. 在需要操作的微服务实例右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑权重**。 + +. 在**编辑权重**对话框,设置微服务实例的权重,然后点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/04-take-a-microservice-instance-offline-and-online.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/04-take-a-microservice-instance-offline-and-online.adoc new file mode 100644 index 000000000..0480ae590 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/04-take-a-microservice-instance-offline-and-online.adoc @@ -0,0 +1,43 @@ +--- +title: "下线和上线微服务实例" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 下线微服务实例" +description: "介绍如何下线和上线微服务实例。" +weight: 04 +--- + + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务** + + +本节介绍如何下线和上线微服务实例。微服务实例下线后将不再接收业务流量。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/projectManagement/microservices/microservices-oper-openInstanceList.adoc[] + ++ + +. 在需要操作的微服务实例右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**下线**可下线微服务。 + +. 在已下线的微服务实例右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**上线**可重新上线微服务。 diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/_index.adoc new file mode 100644 index 000000000..8b9b73644 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/01-microservices/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "微服务" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 微服务" +description: "介绍如何管理微服务。" +weight: 01 +layout: "second" +--- + + + +本节介绍如何管理微服务。 diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/01-create-a-microservice-configuration.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/01-create-a-microservice-configuration.adoc new file mode 100644 index 000000000..3a5e34fc4 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/01-create-a-microservice-configuration.adoc @@ -0,0 +1,53 @@ +--- +title: "创建微服务配置" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 创建微服务路由" +description: "介绍如何创建微服务路由。" +weight: 01 +--- + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务配置** + + +本节介绍如何创建微服务配置。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**创建微服务配置**对话框,设置微服务配置的参数,然后点击**创建**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|微服务配置的名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母或数字开头和结尾,最长 63 个字符。 + +|数据 +|微服务配置数据。点击下拉列表可选择数据的格式。有关微服务配置数据的更多信息,请参阅 link:https://nacos.io[Nacos 官方文档]。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/02-view-a-microservice-configuration-list.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/02-view-a-microservice-configuration-list.adoc new file mode 100644 index 000000000..bcd385b12 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/02-view-a-microservice-configuration-list.adoc @@ -0,0 +1,65 @@ +--- +title: "查看微服务配置列表" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 查看微服务配置列表" +description: "介绍如何查看微服务配置列表。" +weight: 02 +--- + +:ks_permission: ** Spring Cloud 微服务查看** +:ks_navigation:  **Spring Cloud > 微服务配置** + + +本节介绍如何查看微服务配置列表。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] ++ +==== +* 微服务配置列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|微服务配置的名称。 + +|状态 +|微服务配置的状态。 + +* **已发布**:微服务配置创建成功并且可供微服务使用。 + +* **失败**:微服务配置创建过程中出现系统错误导致创建失败。 + +|数据 ID +|微服务配置的全局唯一标识符,由 <微服务配置名称>.<格式> 组成。 + +|创建时间 +|微服务配置的创建时间。 +|=== +-- + +* 在列表上方点击搜索框并输入关键字,可按名称和状态搜索微服务配置。 + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/03-view-microservice-configuration-details.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/03-view-microservice-configuration-details.adoc new file mode 100644 index 000000000..948872c29 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/03-view-microservice-configuration-details.adoc @@ -0,0 +1,56 @@ +--- +title: "查看微服务配置详情" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 查看微服务配置详情" +description: "介绍如何查看微服务配置详情。" +weight: 03 +--- + +:ks_permission: ** Spring Cloud 微服务查看** +:ks_navigation:  **Spring Cloud > 微服务配置** + + +本节介绍如何查看微服务配置详情。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/projectManagement/microserviceConfiguration/microserviceConfiguration-oper-openDetailsPage.adoc[] ++ +-- +* 微服务配置详情页面左侧的**属性**区域显示微服务配置所属的项目、集群和创建时间。 + +* 微服务配置详情页面右侧的**数据**页签显示微服务配置所包含的数据。 +-- + +. 在微服务详情页面右侧点击**历史版本**页签查看微服务配置的修改记录。 ++ +-- +* 每次编辑微服务配置都会生成修改记录,可用于回退微服务配置。 + +* 点击修改记录可查看微服务配置的数据内容。 +-- + +. 在微服务配置详情页面右侧点击**事件**页签查看微服务配置的事件。 ++ +-- +include::../../../../_custom/clusterManagement/clusterManagement-para-eventsTab.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/04-edit-a-microservice-configuration.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/04-edit-a-microservice-configuration.adoc new file mode 100644 index 000000000..df0f03892 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/04-edit-a-microservice-configuration.adoc @@ -0,0 +1,39 @@ +--- +title: "编辑微服务配置" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 编辑微服务配置" +description: "介绍如何编辑微服务配置。" +weight: 04 +--- + + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务配置** + + +本节介绍如何编辑微服务配置。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的微服务配置右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑**。 + +. 在**编辑微服务配置**对话框,设置微服务配置的新数据,然后点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/05-replicate-a-microservice-configuration.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/05-replicate-a-microservice-configuration.adoc new file mode 100644 index 000000000..3dcfab2d6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/05-replicate-a-microservice-configuration.adoc @@ -0,0 +1,51 @@ +--- +title: "复制微服务配置" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 复制微服务配置" +description: "介绍如何复制微服务配置。" +weight: 05 +--- + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务配置** + + +本节介绍如何复制微服务配置。 + +您可以使用已有的微服务配置创建一个名称不同但数据完全相同的微服务配置。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要操作的微服务配置右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**复制**。 + +. 在**复制微服务配置**对话框,设置新微服务配置的名称,然后点击**确定**。 ++ +-- +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +根据需要,您也可以修改配置数据。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + +复制完成后,复制生成的微服务配置将显示在列表中。 +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/06-roll-back-a-microservice-configuration.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/06-roll-back-a-microservice-configuration.adoc new file mode 100644 index 000000000..c57896fb4 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/06-roll-back-a-microservice-configuration.adoc @@ -0,0 +1,44 @@ +--- +title: "回退微服务配置" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 回退微服务配置" +description: "介绍如何回退微服务配置。" +weight: 06 +--- + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务配置** + + +本节介绍如何回退微服务配置。 + +每次编辑微服务配置都会生成修改记录,您可以使用修改记录将微服务配置回退到历史版本。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../_custom/projectManagement/microserviceConfiguration/microserviceConfiguration-oper-openDetailsPage.adoc[] + ++ + +. 在微服务配置详情页面左上角,选择**更多操作 > 回退**。 + +. 在**回退**对话框,选择目标修改记录,然后点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/07-delete-microservice-configurations.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/07-delete-microservice-configurations.adoc new file mode 100644 index 000000000..bb3155179 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/07-delete-microservice-configurations.adoc @@ -0,0 +1,57 @@ +--- +title: "删除微服务配置" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 删除微服务配置" +description: "介绍如何删除微服务配置。" +weight: 07 +--- + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务配置** + + +本节介绍如何删除微服务配置。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 删除单个微服务配置 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要删除的微服务配置右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除微服务配置**对话框,输入微服务配置的名称,然后点击**确定**。 + + +== 批量删除微服务配置 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 选择需要删除的微服务配置左侧的复选框,然后在列表上方点击**删除**。 + +. 在**批量删除微服务配置**对话框,输入微服务配置的名称,然后点击**确定**。 ++ +-- +include::../../../../_custom/note-separateNamesByComma.adoc[] +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/_index.adoc new file mode 100644 index 000000000..ed73769e4 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/02-microservice-configurations/_index.adoc @@ -0,0 +1,20 @@ +--- +title: "微服务配置" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 微服务配置" +description: "介绍如何管理微服务配置。" +weight: 02 +layout: "second" +--- + + + +本节介绍如何管理微服务配置。 + +微服务配置中存储供微服务使用的键值数据,可用于分离微服务及其配置数据。 + +// Note +include::../../../../../_ks_components/admonitions/note.adoc[] + +本节仅介绍如何管理微服务配置。有关应用程序如何获取配置数据,请参阅 link:https://nacos.io[Nacos 官方文档]。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/01-create-a-microservice-gateway.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/01-create-a-microservice-gateway.adoc new file mode 100644 index 000000000..06396b11b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/01-create-a-microservice-gateway.adoc @@ -0,0 +1,53 @@ +--- +title: "创建微服务网关" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 创建微服务网关" +description: "介绍如何创建微服务网关。" +weight: 01 +--- + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务网关** + + +本节介绍如何创建微服务网关。 + +创建微服务网关过程中实际上创建了一个运行 Spring Cloud Gateway 的部署。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* 您需要提前准备 Spring Cloud Gateway 容器镜像。有关更多信息,请参阅 link:https://spring.io/projects/spring-cloud-gateway#overview[Spring Cloud Gateway] 官方文档。本节使用 registry.cn-beijing.aliyuncs.com/kse/spring-cloud-gateway:latest 容器镜像作为示例,您也可以根据需要自行构建容器镜像。 + + +== 操作步骤 + +请参阅link:#_参数描述[参数描述]设置微服务网关的参数。 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**网关设置**页签,设置微服务网关的参数,然后点击**下一步**。 + +. 在**高级设置**页签,选择是否启用外部访问和外部访问模式,然后点击**创建**。 + + +== 参数描述 + +include::../../../../_custom/projectManagement/microserviceGateway/microserviceGateway-para-microserviceGatewaySettings.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/02-view-microservice-gateway-information.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/02-view-microservice-gateway-information.adoc new file mode 100644 index 000000000..c18b64fb5 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/02-view-microservice-gateway-information.adoc @@ -0,0 +1,78 @@ +--- +title: "查看微服务网关信息" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 查看微服务网关信息" +description: "介绍如何查看微服务网关信息。" +weight: 02 +--- + +:ks_permission: ** Spring Cloud 微服务查看** +:ks_navigation:  **Spring Cloud > 微服务网关** + + +本节介绍如何查看微服务网关信息。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] ++ +-- +**微服务网关**页面提供以下信息: + +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|类型 +|网关的类型。对于微服务网关参数值为**微服务网关**。 + +|状态 +|网关当前的状态。 + +* **运行中**:微服务网关运行正常。 + +* **更新中**:微服务网关正在创建中或正在更新设置。 + +|创建者 +|创建网关的用户。 + +|创建时间 +|网关的创建时间。 + +|访问模式 +|网关的访问模式。 + +include::../../../../_custom/clusterManagement/services/services-para-externalAccess.adoc[tag=bullets] + +* **ClusterIP**:网关不能从 KubeSphere 集群外部访问,只能在 KubeSphere 集群内部通过虚拟 IP 地址访问。 + +|网关地址 +| +网关的访问地址。 + +include::../../../../_custom/clusterManagement/gatewaySettings/gatewaySettings-para-address.adoc[tag=bullets] + +* 如果网关的访问模式为 ClusterIP,网关不能从集群外部访问,**网关地址**为网关在 KubeSphere 集群内部的虚拟 IP 地址。 + +|节点端口 +|网关服务的 HTTP 和 HTTPS 节点端口。仅在网关的外部访问模式为 NodePort 时显示。 + +|副本 +|网关工作负载的容器组副本数量。 +|=== +-- diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/03-view-microservice-gateway-details.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/03-view-microservice-gateway-details.adoc new file mode 100644 index 000000000..007d19be1 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/03-view-microservice-gateway-details.adoc @@ -0,0 +1,73 @@ +--- +title: "查看微服务网关详情" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 查看微服务网关详情" +description: "介绍如何查看微服务网关详情。" +weight: 03 +--- + +:ks_permission: ** Spring Cloud 微服务查看** +:ks_navigation:  **Spring Cloud > 微服务网关** + + +本节介绍如何查看微服务网关详情。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在页面右侧选择**管理 > 查看详情**打开网关详情页面。 + +. 在网关详情页面左侧的**属性**区域查看网关的资源属性。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|集群 +|网关所属的集群。 + +|创建时间 +|网关的创建时间。 + +|更新时间 +|网关的更新时间 + +|创建者 +|启用网关的用户。 +|=== +-- + +. 在网关详情页面右侧是的**资源状态**页签查看网关的容器组副本数量、容器端口和容器组。 ++ +==== +* **副本**区域显示网关的期望容器组副本数量和当前容器组副本数量。 + +* **端口**区域显示网关的容器端口名称、协议和端口号。 + +* **容器组**区域显示网关的所有容器组副本。 ++ +-- +include::../../../../_custom/clusterManagement/nodes/nodes-para-podList.adoc[] +-- +==== + +. 在网关详情页面右侧点击**元数据**页签查看网关的标签和注解。 diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/04-edit-microservice-gateway-settings.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/04-edit-microservice-gateway-settings.adoc new file mode 100644 index 000000000..5bb5298d2 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/04-edit-microservice-gateway-settings.adoc @@ -0,0 +1,47 @@ +--- +title: "编辑微服务网关" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 编辑微服务网关" +description: "介绍如何编辑微服务网关。" +weight: 04 +--- + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务网关** + + +本节介绍如何编辑微服务网关。 + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在页面右侧选择**管理 > 编辑**。 + +. 在**编辑微服务网关**对话框,修改微服务网关的参数,然后点击**确定**。 ++ +-- +有关微服务网关参数的更多信息,请参阅link:#_参数描述[参数描述]。 +-- + + +== 参数描述 + +include::../../../../_custom/projectManagement/microserviceGateway/microserviceGateway-para-microserviceGatewaySettings.adoc[] diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/05-delete-a-microservice-gateway.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/05-delete-a-microservice-gateway.adoc new file mode 100644 index 000000000..4ae0abbd6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/05-delete-a-microservice-gateway.adoc @@ -0,0 +1,45 @@ +--- +title: "删除微服务网关" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 删除微服务网关" +description: "介绍如何删除微服务网关。" +weight: 05 +--- + +:ks_permission: ** Spring Cloud 微服务管理** +:ks_navigation:  **Spring Cloud > 微服务网关** + + +本节介绍如何删除微服务网关。 + +// Warning +include::../../../../../_ks_components/admonitions/warning.adoc[] + +删除微服务网关将导致微服务的业务中断,请谨慎执行此操作。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +* {ks_product_right}平台需要安装并启用 **KubeSphere Spring Cloud** 扩展组件。 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/projectManagement/projectManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + + +== 操作步骤 + +include::../../../../_custom/projectManagement/projectManagement-oper-openProjectPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在页面右侧选择**管理 > 删除**。 + +. 在**删除**对话框,输入微服务网关的名称,然后点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/_index.adoc new file mode 100644 index 000000000..b2b1d2be7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/03-microservice-gateway/_index.adoc @@ -0,0 +1,13 @@ +--- +title: "微服务网关" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud, 微服务网关" +description: "介绍如何管理微服务网关。" +weight: 03 +layout: "second" +--- + + + +本节介绍如何管理微服务网关。 + +微服务网关是微服务的反向代理。来自客户端的请求先发送给微服务网关,再由微服务网关根据微服务路由转发给微服务。 diff --git a/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/_index.adoc new file mode 100644 index 000000000..4812ffd65 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/18-spring-cloud/_index.adoc @@ -0,0 +1,15 @@ +--- +title: "KubeSphere Spring Cloud" +keywords: "Kubernetes, {ks_product}, 项目管理, Spring Cloud" +description: "介绍如何使用 Spring Cloud 功能。" +weight: 18 +layout: "second" +draft: true +--- + + +本节介绍如何使用 KubeSphere Spring Cloud 扩展组件。 + +KubeSphere Spring Cloud 扩展组件提供了微服务、微服务配置和微服务网关功能。微服务注册和配置功能基于 link:https://nacos.io[Nacos] 实现,微服务网关基于 Spring Cloud Gateway 实现。如果您原有的应用程序符合 Nacos 规范,KubeSphere Spring Cloud 功能可以帮助您在保持原有框架不变的同时获得容器化应用的运维效率。 + +安装 KubeSphere Spring Cloud 扩展组件后,项⽬左侧导航栏将显⽰ **Spring Cloud** 选项。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/19-tower/02-add-a-member-cluster-using-proxy-connection.adoc b/content/zh/docs/v4.1/11-use-extensions/19-tower/02-add-a-member-cluster-using-proxy-connection.adoc new file mode 100644 index 000000000..c398dea2b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/19-tower/02-add-a-member-cluster-using-proxy-connection.adoc @@ -0,0 +1,110 @@ +--- +title: "通过代理连接添加成员集群" +keywords: "Kubernetes, {ks_product}, 多集群管理, 集群, 添加成员集群, 通过代理连接添加成员集群" +description: "介绍如何通过代理连接添加成员集群。" +weight: 02 +--- + + +本节介绍如何通过代理连接添加成员集群。 + +如果主集群无法访问成员集群的 Kubernetes API 服务,您可以设置成员集群连接到主集群对外暴露的 **tower** 服务从而添加成员集群。 + + +== 前提条件 + +* 您需要在主集群中具有 **platform-admin** 角色。 + +* {ks_product_right}平台需要安装并启用 **KubeSphere 多集群代理连接**扩展组件。 + +* 成员集群所有节点必须能访问主集群 **tower** 服务的外部访问地址。取决于您的网络环境,您可能需要配置防火墙和流量转发规则。 + +== 设置代理服务地址 + +在主集群安装“KubeSphere 多集群代理连接”扩展组件后,将在系统项目 kubesphere-system 中自动创建一个名为 tower 的服务。 + + +=== 集群中有可用的 LoadBalancer + +如果主集群中有可用的 LoadBalancer 插件,在主集群节点执行以下命令,可以看到 tower 服务有相应的 `EXTERNAL-IP` 地址。该地址将由 KubeSphere 自动获取并配置代理服务地址,这意味着您可以跳过设置代理服务地址这一步。 + +执行以下命令确认是否有 LoadBalancer 插件。 + +[,bash] +---- +kubectl -n kubesphere-system get svc +---- + +命令输出结果可能如下所示: + +[,bash] +---- +NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE +tower LoadBalancer 10.233.63.191 139.198.110.23 8080:30721/TCP 16h +---- + +[.admon.note,cols="a"] +|=== +|说明 + +| +主流公有云厂商一般会提供 LoadBalancer 解决方案,并且负载均衡器可以自动分配外部 IP。如果您的集群运行在本地环境中,尤其是在裸机环境中,可以使用 link:https://github.com/kubesphere/openelb[OpenELB] 作为负载均衡器解决方案。 +|=== + +=== 集群中没有可用的 LoadBalancer + +若主集群中没有可用的 LoadBalancer,执行 `kubectl -n kubesphere-system get svc` 命令后,输出结果可能如下所示。 + +[,bash] +---- +NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE +tower LoadBalancer 10.233.63.191 8080:30721/TCP 16h +---- + +由于 `EXTERNAL-IP` 处于 `pending` 状态,您需要手动设置代理地址,将 proxyPublishAddress 的值添加到 `kubesphere-config` ConfigMap 中。 + +. 在主集群节点,执行以下命令打开 kubesphere-config 配置字典。 ++ +[,bash] +---- +kubectl -n kubesphere-system edit cm kubesphere-config +---- + +. 搜索 `multicluster` 并添加新行,输入 `proxyPublishAddress` 来定义 tower 服务的外部 IP 地址,以便访问 Tower。 ++ +-- +[,bash] +---- +multicluster: + clusterRole: host + proxyPublishAddress: {公有 IP 地址}:{Port} # Add this line to set the address to access tower +---- + +[.admon.note,cols="a"] +|=== +|说明 + +| +您可能需要配置端口转发规则,例如,将公有 IP:Port 转发到 NodeIP:NodePort。 +|=== +-- + +== 添加成员集群 + +include::../../../_custom/platformManagement/multiclusterManagement/clusters/clusters-oper-logInToHost.adoc[] + ++ + +. 点击**集群管理**。 ++ +include::../../../_custom/platformManagement/multiclusterManagement/clusters/clusters-oper-addClusterBasicInfo.adoc[] ++ +在**高级设置**下,设置集群的用途标识。 + +. 在**连接设置**页签,将**连接方式**设置为**代理连接**,点击**下一步**。 + +. 在**集群配置**页签,设置集群配置,然后点击**创建**。 ++ +-- +成员集群添加完成后将显示在**集群管理**页面的集群列表中。 +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/19-tower/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/19-tower/_index.adoc new file mode 100644 index 000000000..3c62e8af6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/19-tower/_index.adoc @@ -0,0 +1,20 @@ +--- +title: "KubeSphere 多集群代理连接" +description: "介绍如何使用“KubeSphere 多集群代理连接”扩展组件进行集群间的代理连接。" +weight: 19 +layout: "second" +--- + +本节介绍如何使用“KubeSphere 多集群代理连接”扩展组件进行集群间的代理连接。 + +KubeSphere 的组件 Tower 用于代理连接。Tower 是一种通过代理在集群间建立网络连接的工具。如果主集群无法直接访问成员集群,您可以暴露主集群的代理服务地址,这样可以让成员集群通过代理连接到主集群。当成员集群部署在私有环境(例如 IDC)并且主集群可以暴露代理服务时,适用此连接方法。当您的集群分布部署在不同的云厂商上时,同样适用代理连接的方法。 + +在主集群安装“KubeSphere 多集群代理连接”扩展组件后,将在系统项目 kubesphere-system 中自动创建一个名为 tower 的服务。通过此服务,可以通过代理连接添加成员集群。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +有关组件配置的更多信息,请参阅扩展中心“KubeSphere 多集群代理连接”扩展组件的详情页说明。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/01-create-a-constraint-template.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/01-create-a-constraint-template.adoc new file mode 100644 index 000000000..39454a9cd --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/01-create-a-constraint-template.adoc @@ -0,0 +1,57 @@ +--- +title: "创建约束模板" +description: "介绍如何创建约束模板。" +weight: 01 +--- + +:ks_permission: ** cluster-admin ** +:ks_navigation: ** Gatekeeper > 约束模板** + + +本节介绍如何创建约束模板。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **Gatekeeper** 扩展组件。 + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**创建约束模板**对话框,设置约束模板的名称和目标(Targets),然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +| CRD 名称 +|约束模板对应的 CRD 名称。 + +|Targets +|Targets 是约束的目标对象,即需要应用约束规则的资源对象。Targets 可以是 Kubernetes 集群中的各种资源,如 Pod、Deployment、Namespace 等。约束将被应用于这些目标对象,以确保它们满足约束规则的要求。 + +|=== + +您将在**约束模板**页面查看已创建的约束模板。 +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/03-view-constraint-template-details.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/03-view-constraint-template-details.adoc new file mode 100644 index 000000000..c4d10c14b --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/03-view-constraint-template-details.adoc @@ -0,0 +1,62 @@ +--- +title: "查看约束模板详情" +description: "介绍如何查看约束模板详情。" +weight: 03 +--- + +:ks_permission: ** cluster-admin ** +:ks_navigation: ** Gatekeeper > 约束模板** + + +本节介绍如何查看约束模板详情。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **Gatekeeper** 扩展组件。 + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在约束模板列表中点击一个约束模板的名称打开其详情页面。 + +. 在约束模板详情页面左侧的**属性**区域,查看约束模板的基本信息。 ++ +-- + +[%header,cols="2,5"] +|=== +|参数 |描述 + +|集群 +|约束模板所属的集群。 + +|创建时间 +|约束模板的创建时间。 + +|CRD +|约束模板对应的 CRD 名称。 +|=== +-- + +. 在约束模板详情页面右侧的**目标**页签,查看约束模板的约束对象。 + +. 在约束模板详情页面右侧点击**状态**页签,查看约束模板的标签和注解。 + +. 在约束模板详情页面右侧点击**约束**页签,查看使用约束模板创建的约束条件。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/04-edit-constraint-template-yaml.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/04-edit-constraint-template-yaml.adoc new file mode 100644 index 000000000..a1c57b4d6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/04-edit-constraint-template-yaml.adoc @@ -0,0 +1,37 @@ +--- +title: "编辑约束模板配置" +description: "介绍如何编辑约束模板配置。" +weight: 04 +--- + +:ks_permission: ** cluster-admin ** +:ks_navigation: ** Gatekeeper > 约束模板** + + +本节介绍如何编辑约束模板配置。 + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **Gatekeeper** 扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要编辑的约束模板右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑 YAML**。 + +. 在**编辑 YAML**对话框,修改相关配置,然后点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/07-delete-constraint-templates.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/07-delete-constraint-templates.adoc new file mode 100644 index 000000000..d591b6196 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/07-delete-constraint-templates.adoc @@ -0,0 +1,46 @@ +--- +title: "删除约束模板" +description: "介绍如何删除约束模板。" +weight: 07 +--- + +:ks_permission: ** cluster-admin ** +:ks_navigation: ** Gatekeeper > 约束模板** + + +本节介绍如何删除约束模板。 + +// Warning +include::../../../../../_ks_components/admonitions/warning.adoc[] + +约束模板删除后不能恢复,请谨慎执行此操作。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **Gatekeeper** 扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要删除的约束模板右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除约束模板**对话框,输入约束模板的名称,然后点击**确定**。 + + diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/_index.adoc new file mode 100644 index 000000000..e767d0ada --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/01-constraint-templates/_index.adoc @@ -0,0 +1,11 @@ +--- +title: "约束模板" +description: "介绍如何管理约束模板。" +weight: 01 +layout: "second" +--- + + +约束模板(ConstraintTemplates)是定义和管理约束的模板,用于验证 Gatekeeper 的 Kubernetes 准入控制器中的某些 Kubernetes 对象集。 + +约束模板可以被应用于集群,用于创建实际的约束实例。有关约束模板的更多信息,请参阅 link:https://open-policy-agent.github.io/gatekeeper/website/docs/howto/#constraint-templates[ConstraintTemplates]。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/01-create-a-constraint.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/01-create-a-constraint.adoc new file mode 100644 index 000000000..789afc30d --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/01-create-a-constraint.adoc @@ -0,0 +1,72 @@ +--- +title: "创建约束" +description: "介绍如何创建约束。" +weight: 01 +--- + +:ks_permission: ** cluster-admin ** +:ks_navigation: ** Gatekeeper > 约束** + + +本节介绍如何创建约束。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **Gatekeeper** 扩展组件。 + +* 已创建一个约束模板。 + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +include::../../../../../_ks_components/oper-clickCreate.adoc[] + ++ + +. 在**创建约束条件**对话框,设置以下参数,然后点击**确定**。 ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|约束条件名称 +|约束条件的名称。 + +|约束条件类型 +|约束条件使用的约束模板。 + +|enforcementAction +|`enforcementAction` 字段定义了处理约束违规的操作。默认设置为 `deny`,即默认拒绝任何违规的准入请求。有关更多信息,请参阅link:https://open-policy-agent.github.io/gatekeeper/website/docs/violations/[约束违规处理]。 + +|Match Kinds +|`match` 字段定义了约束适用的资源。有关更多信息,请参阅 link:https://open-policy-agent.github.io/gatekeeper/website/docs/howto/#the-match-field[match]。 + +`kinds` 接受包含 `apiGroups` 和 `kinds` 字段的对象列表,这些字段列出了约束适用对象的 groups/kinds。如果指定了多个 groups/kinds 对象,只需匹配其中一个对象,资源就会在约束的适用范围内。 + +|命名空间标签 +|针对对象所在的命名空间或对象本身(如果对象是一个命名空间)设置的可标识的键值对。 + +|参数 +|用于描述约束的意图。有关更多信息,请参阅 link:https://open-policy-agent.github.io/gatekeeper/website/docs/howto/#the-parameters-field[parameters]。 +|=== + +您将在**约束**页面查看已创建的约束。 +-- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/02-view-a-constraint-list.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/02-view-a-constraint-list.adoc new file mode 100644 index 000000000..4668f2b43 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/02-view-a-constraint-list.adoc @@ -0,0 +1,57 @@ +--- +title: "查看约束列表" +description: "介绍如何查看约束列表。" +weight: 02 +--- + +:ks_permission: ** cluster-admin ** +:ks_navigation: ** Gatekeeper > 约束** + + +本节介绍如何查看约束列表。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **Gatekeeper** 扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ +==== + +* 约束列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|约束的名称。 + +|Kind +|约束使用的约束模板。 +|=== +-- + +* 在列表上方点击搜索框并输入关键字,可搜索名称包含特定关键字的约束。 + +include::../../../../../_ks_components/oper-refreshListData.adoc[] + +include::../../../../../_ks_components/oper-customizeColumns.adoc[] +==== diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/03-view-constraint-details.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/03-view-constraint-details.adoc new file mode 100644 index 000000000..7d3548256 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/03-view-constraint-details.adoc @@ -0,0 +1,56 @@ +--- +title: "查看约束详情" +description: "介绍如何查看约束详情。" +weight: 03 +--- + +:ks_permission: ** cluster-admin ** +:ks_navigation: ** Gatekeeper > 约束** + + +本节介绍如何查看约束详情。 + + +== 前提条件 + +:relfileprefix: ../../../../ + +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **Gatekeeper** 扩展组件。 + + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在约束列表中点击一个约束的名称打开其详情页面。 + +. 在约束详情页面左侧的**属性**区域,查看约束的基本信息。 ++ +-- + +[%header,cols="2,5"] +|=== +|参数 |描述 + +|集群 +|约束所属的集群。 + +|创建时间 +|约束的创建时间。 + +|=== +-- + +. 在约束详情页面右侧的**Violations**页签,查看违规信息。 diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/04-edit-constraint-yaml.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/04-edit-constraint-yaml.adoc new file mode 100644 index 000000000..b66139855 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/04-edit-constraint-yaml.adoc @@ -0,0 +1,37 @@ +--- +title: "编辑约束配置" +description: "介绍如何编辑约束配置。" +weight: 04 +--- + +:ks_permission: ** cluster-admin ** +:ks_navigation: ** Gatekeeper > 约束** + + +本节介绍如何编辑约束的配置。 + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **Gatekeeper** 扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要编辑的约束右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**编辑 YAML**。 + +. 在**编辑 YAML**对话框,修改相关配置,然后点击**确定**。 diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/07-delete-constraints.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/07-delete-constraints.adoc new file mode 100644 index 000000000..a303744e6 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/07-delete-constraints.adoc @@ -0,0 +1,45 @@ +--- +title: "删除约束" +description: "介绍如何删除约束。" +weight: 07 +--- + +:ks_permission: ** cluster-admin ** +:ks_navigation: ** Gatekeeper > 约束** + + +本节介绍如何删除约束。 + +// Warning +include::../../../../../_ks_components/admonitions/warning.adoc[] + +约束删除后不能恢复,请谨慎执行此操作。 + +include::../../../../../_ks_components/admonitions/admonEnd.adoc[] + + +== 前提条件 + +:relfileprefix: ../../../../ +* {empty} +include::../../../../_custom/clusterManagement/clusterManagement-prer-requiredPermission_new.adoc[] + +:relfileprefix: ./ + +* {ks_product_right}平台需要安装并启用 **Gatekeeper** 扩展组件。 + + +== 操作步骤 + +include::../../../../_custom/clusterManagement/clusterManagement-oper-openClusterPage.adoc[] + ++ + +include::../../../../../_ks_components/oper-navigate.adoc[] + ++ + +. 在需要删除的约束右侧点击image:/images/ks-qkcp/zh/icons/more.svg[more,18,18],然后在下拉列表中选择**删除**。 + +. 在**删除约束**对话框,输入约束的名称,然后点击**确定**。 + diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/_index.adoc new file mode 100644 index 000000000..ca62e3edc --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/02-constraints/_index.adoc @@ -0,0 +1,10 @@ +--- +title: "约束" +description: "介绍如何管理约束。" +weight: 02 +layout: "second" +--- + +约束(Constraints)是指用于定义和实施集群策略的规则或条件,用于声明需要强制执行的 Gatekeeper 约束模板,是约束模板的实例。 + +有关约束的更多信息,请参阅 link:https://open-policy-agent.github.io/gatekeeper/website/docs/howto/#constraints[Constraints]。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/_index.adoc new file mode 100644 index 000000000..7d8c5d9f7 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/20-gatekeeper/_index.adoc @@ -0,0 +1,23 @@ +--- +title: "Gatekeeper" +description: "介绍如何使用 Gatekeeper。" +weight: 20 +layout: "second" +--- + +link:https://github.com/open-policy-agent/gatekeeper[Gatekeeper] 是一个用于 Kubernetes 可灵活配置策略的准入控制器,利用 link:https://www.openpolicyagent.org/[Open Policy Agent (OPA)] 验证在 Kubernetes 集群上创建和更新资源的请求。 + +// Gatekeeper 可以根据 Gatekeeper 验证策略对集群中的资源进行验证。参阅:https://open-policy-agent.github.io/gatekeeper-library/website/ + +link:https://open-policy-agent.github.io/gatekeeper-library/website/[OPA Gatekeeper Library] 提供了一些常用的安全准入策略,其中包含一系列可在 Gatekeeper 使用的约束模板(ConstraintTemplates)和约束(Constraints)。约束模板可直接应用于集群,约束可用于定制策略,以满足您的特定需求。 + +借助 Gatekeeper 灵活地定义准入策略,在集群层面强制执行安全准入审查,从而确保 Kubernetes 集群的稳定性和安全合规。 + +Gatekeeper 的主要特性包括: + +* **灵活**: Gatekeeper 允许用户声明式的定义准入策略,作用于选定的 namespace 与选定的资源类型。 +* **可编程**: Gatekeeper 使用 Open Policy Agent(OPA)作为决策引擎,可借助 Rego 实现复杂的安全策略定义。 +* **滚动发布**: 支持以循序渐进的方式逐步执行准入策略,从而规避中断工作负载的风险。 +* **预发布机制**: Gatekeeper 提供在强制执行之前测试安全策略影响和范围的机制。 + + diff --git a/content/zh/docs/v4.1/11-use-extensions/21-oauth2-proxy/01-config-oauth2-proxy.adoc b/content/zh/docs/v4.1/11-use-extensions/21-oauth2-proxy/01-config-oauth2-proxy.adoc new file mode 100644 index 000000000..3a322574e --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/21-oauth2-proxy/01-config-oauth2-proxy.adoc @@ -0,0 +1,259 @@ +--- +title: "配置并访问服务" +keywords: "Kubernetes, {ks_product}, OAuth2-Proxy, alertmanager" +description: "介绍如何配置 OAuth2-Proxy 扩展组件以访问服务。" +weight: 01 +--- + +OAuth2-Proxy 支持多种 link:https://oauth2-proxy.github.io/oauth2-proxy/configuration/providers/[OAuth Providers]。本节介绍如何配置该扩展组件将 KubeSphere 作为 OAuth Provider,以便通过 KubeSphere 认证登录后,直接访问各种服务。 + +// 在 Ingress 场景下借助 Oauth2-Proxy 扩展组件,为应用提供基于 KubeSphere 用户的身份认证 +// 在 NodePort 场景下借助 Oauth2-Proxy 扩展组件及自定义路由,为应用提供基于 KubeSphere 用户的身份认证 + +== 配置 OAuth2-Proxy + +OAuth2-Proxy 扩展组件提供 NodePort 和 Ingress 两种方式,为应用提供基于 KubeSphere 用户的统一身份认证。不同方式下,配置 OAuth2-Proxy 的方法不同。 + +=== NodePort 方式 + +通过将扩展组件中的 OpenResty NodePort 对外暴露,为代理应用提供统一访问入口。 + +在扩展组件配置中,修改 `global.host`,并确认 `openresty.service.nodePort`,完成扩展组件的部署。 + +[,yaml] +---- +global: + # OAuth2-Proxy service external access address + # For example, using NodePort, the address is http://172.31.19.4:32080, + # using Ingress, the host is http://172.31.19.4.nip.io:80 + host: "http://" + + # Kubesphere portal address. For example, http://172.31.19.4:30880 + # No need to set this explicitly, KubeSphere's portal address will be auto-injected. + portal.url: "http://" + +openresty: + enabled: true + + service: + type: NodePort + portNumber: 80 + nodePort: 32080 + annotations: {} + +oauth2-proxy: + extraArgs: + provider: oidc + provider-display-name: "kubesphere" + # Issuer address + # The KubeSphere portal URL is filled by default, but if you use another OAuth Provider, change it + oidc-issuer-url: "{{ .Values.global.portal.url }}" +---- + +=== Ingress 方式 + +OAuth2-Proxy 支持通过 Ingress 方式为应用配置统一认证,在这种场景下,Ingress 将替代 OpenResty 提供统一的服务入口和反向代理功能。 + +. 在扩展组件配置中,将 `openresty.enabled` 改为 false,`ingress.enabled` 改为 true,并修改 `global.host`,即可完成扩展组件的部署。 ++ +-- +[,yaml] +---- +global: + # OAuth2-Proxy service external access address + # For example, using NodePort, the address is http://172.31.19.4:32080, + # using Ingress, the host is http://172.31.19.4.nip.io:80 + host: "http://" + + # Kubesphere portal address. For example, http://172.31.19.4:30880 + # No need to set this explicitly, KubeSphere's portal address will be auto-injected. + portal.url: "http://" + +openresty: + enabled: false + +oauth2-proxy: + extraArgs: + provider: oidc + provider-display-name: "kubesphere" + # Issuer address + # The KubeSphere portal URL is filled by default, but if you use another OAuth Provider, change it + oidc-issuer-url: "{{ .Values.global.portal.url }}" + + ingress: + enabled: true + className: nginx +---- +-- + +. 在应用的 Ingress 字段中添加相关注解,请参考 link:https://kubernetes.github.io/ingress-nginx/examples/auth/oauth-external-auth/[ingress-nginx/External OAUTH Authentication] 示例。 ++ +[,yaml] +---- +... +metadata: + name: application + annotations: + nginx.ingress.kubernetes.io/auth-url: "https://$host/oauth2/auth" + nginx.ingress.kubernetes.io/auth-signin: "https://$host/oauth2/start?rd=$escaped_request_uri" +... +---- + + +=== 注意事项 + +如果您使用 KubeSphere 4.x 作为 OAuth Provider,请确保 KubeSphere Console 的外部访问地址与 configmap `kubesphere-config` 中的 `issuer.url` 一致。如不一致,需按照以下步骤进行更新。 + +[,yaml] +---- +apiVersion: v1 +kind: ConfigMap +metadata: + name: kubesphere-config + namespace: kubesphere-system +data: + kubesphere.yaml: | + authentication: + issuer: + url: "http://172.31.19.4:30880" # 确认 issuer 地址 +---- + +. 复制 ks-core 的 values.yaml 文件,新建为 `custom-kscore-values.yaml`。 ++ +[,bash] +---- +cp ks-core/values.yaml custom-kscore-values.yaml +---- + +. 修改 `portal.hostname`,配置为实际地址。 ++ +[,yaml] +---- +portal: + ## The IP address or hostname to access ks-console service. + ## DO NOT use IP address if ingress is enabled. + hostname: "172.31.19.4" + http: + port: 30880 +---- + +. 更新 ks-core。 ++ +-- +[,bash] +---- +helm upgrade --install -n kubesphere-system --create-namespace ks-core ${kscore_chart_path} -f ./custom-kscore-values.yaml --debug --wait +---- +-- + +== 示例 1:通过 NodePort 访问 AlertManager 服务 + +. 在扩展组件配置中,修改 `global.host`,并确认 `openresty.service.nodePort`。 + +. 然后修改 `openresty.configs` 配置如下。 ++ +[,yaml] +---- +openresty: + configs: + - name: alertmanager + description: KubeSphere 监控栈内部 Alertmanager 端点 + subPath: /alertmanager/ + endpoint: http://whizard-notification-alertmanager.kubesphere-monitoring-system.svc:9093/ +---- + +. 配置完成后,访问 OAuth2-Proxy 的外部地址,如 http://172.31.19.4:32080,通过 KubeSphere 认证登录后,即可在首页看到 Alertmanager 服务的入口,点击即可访问。 + +== 示例 2:通过 Ingress 访问 AlertManager 服务 + +. 在扩展组件配置中,将 `openresty.enabled` 改为 false,`ingress.enabled` 改为 true,并修改 `global.host`。 + +. 安装 ingress-nginx controller。 ++ +[,bash] +---- +helm upgrade --install ingress-nginx ingress-nginx \ + --repo https://kubernetes.github.io/ingress-nginx \ + --namespace ingress-nginx --create-namespace +---- + +. 修改名为 ingress-nginx-controller 的 deployment。设置 ingress 对外访问方式,当前link:https://kubernetes.github.io/ingress-nginx/deploy/baremetal/#via-the-host-network[以hostnetwork 方式暴露]。 ++ +[,yaml] +---- +spec: + nodeName: # 替换为实际节点名称 + hostNetwork: true +---- + +. 创建 alertmanager 自定义资源、服务和 ingress。 ++ +-- +[,bash] +---- +vim alertmanager.yaml +---- + +[,yaml] +---- +apiVersion: monitoring.coreos.com/v1 +kind: Alertmanager +metadata: + name: main + namespace: extension-oauth2-proxy +spec: + externalUrl: http://172.31.19.4.nip.io/alertmanager # 替换为实际地址 + portName: web + replicas: 1 + resources: + requests: + memory: 400Mi +--- +apiVersion: v1 +kind: Service +metadata: + name: alertmanager-main + namespace: extension-oauth2-proxy +spec: + type: ClusterIP + ports: + - name: web + port: 9093 + protocol: TCP + targetPort: web + selector: + alertmanager: main +--- +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + annotations: + nginx.ingress.kubernetes.io/auth-signin: https://$host/oauth2/start?rd=$escaped_request_uri + nginx.ingress.kubernetes.io/auth-url: https://$host/oauth2/auth + nginx.ingress.kubernetes.io/rewrite-target: /$2 + name: alertmanager-ingress + namespace: extension-oauth2-proxy +spec: + ingressClassName: nginx + rules: + - host: 172.31.19.4.nip.io # 替换为实际地址 + http: + paths: + - backend: # 应用配置部分 + service: + name: alertmanager-main + port: + number: 9093 + path: /alertmanager(/|$)(.*) + pathType: ImplementationSpecific +---- +-- + +. 部署 Alertmanager 服务。 ++ +[,bash] +---- +kubectl apply -f alertmanager.yaml +---- + +. 在浏览器中访问 `.nip.io/alertmanager`,如 172.31.19.4.nip.io/alertmanager,即可访问 Alertmanager 的用户界面。 diff --git a/content/zh/docs/v4.1/11-use-extensions/21-oauth2-proxy/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/21-oauth2-proxy/_index.adoc new file mode 100644 index 000000000..3109bc6c3 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/21-oauth2-proxy/_index.adoc @@ -0,0 +1,18 @@ +--- +title: "OAuth2-Proxy" +keywords: "Kubernetes, {ks_product}, OAuth2-Proxy, alertmanager" +description: "介绍如何使用 OAuth2-Proxy 扩展组件。" +weight: 21 +layout: "second" +draft: true +--- + + +OAuth2-Proxy 扩展组件旨在保护后端应用并提供统一的认证服务。通过处理 OAuth2 协议的认证流程,允许用户通过第三方认证服务(如 Google、GitHub、KubeSphere)进行登录,并生成用户会话。link:https://openresty.org/[OpenResty] 作为反向代理服务器,接收 HTTP 请求并转发给后端应用。 + +OAuth2-Proxy 提供统一认证接口确保所有应用通过相同流程保护,简化多应用环境下的身份验证管理,提高安全性和用户体验,适用于需要对多个后端应用进行统一认证管理的企业环境,以及需要通过第三方认证服务进行用户身份验证的应用。 + +// 扩展组件配置后,可通过{ks_product_both}平台鉴权后访问多种服务,如 AlertManager、Prometheus、Whizard 等。 + + + diff --git a/content/zh/docs/v4.1/11-use-extensions/22-nvidia-gpu-operator/01-intro.adoc b/content/zh/docs/v4.1/11-use-extensions/22-nvidia-gpu-operator/01-intro.adoc new file mode 100644 index 000000000..bf5758aa0 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/22-nvidia-gpu-operator/01-intro.adoc @@ -0,0 +1,20 @@ +--- +title: "概述" +keywords: "Kubernetes, {ks_product}, GPU Operator, NVIDIA" +description: "介绍 NVIDIA GPU Operator 扩展组件。" +weight: 01 +--- + +NVIDIA GPU Operator 是一个基于 link:https://github.com/NVIDIA/gpu-operator[GPU Operator] 改造的扩展组件,旨在适配 KubeSphere LuBan 可插拔架构,支持在 Kubernetes 上创建、配置和管理 GPU。 + +Kubernetes 借助 link:https://kubernetes.io/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins/[device plugin framework] 提供对 NVIDIA GPU、NIC、Infiniband 适配器等特殊硬件资源的访问。然而,配置和管理这些硬件资源节点需要配置多个软件组件,如驱动程序、容器运行时或其他库,这些过程既复杂又容易出错。NVIDIA GPU Operator 在 Kubernetes 中使用 link:https://cloud.redhat.com/blog/introducing-the-operator-framework[operator framework] 自动管理 GPU 所需的所有 NVIDIA 软件组件,包括用于启用 CUDA 的 NVIDIA 驱动程序、用于 GPU 的 Kubernetes 设备插件、NVIDIA 容器运行时、自动节点标记、基于 link:https://developer.nvidia.com/dcgm[DCGM] 的监控等。 + +== 受众和使用场景 + +GPU Operator 允许 Kubernetes 集群管理员像管理集群 CPU 节点一样管理 GPU 节点。管理员不需要为 GPU 节点指定操作系统镜像,而是可以依赖于 CPU 和 GPU 节点的标准操作系统镜像,然后依赖 GPU Operator 为 GPU 提供所需的软件组件。 + +需要注意的是,GPU Operator 特别适用于 Kubernetes 集群需要快速扩展的场景,例如在云端或本地增加 GPU 节点并管理底层软件组件的生命周期。由于 GPU Operator 将所有内容都作为容器运行,包括 NVIDIA 驱动程序,管理员可以轻松更换各种组件——只需启动或停止容器即可。 + +== 产品文档 + +有关平台支持和入门信息,请访问link:https://docs.nvidia.com/datacenter/cloud-native/gpu-operator/overview.html[官方文档]。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/22-nvidia-gpu-operator/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/22-nvidia-gpu-operator/_index.adoc new file mode 100644 index 000000000..d718ba821 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/22-nvidia-gpu-operator/_index.adoc @@ -0,0 +1,8 @@ +--- +title: "NVIDIA GPU Operator" +keywords: "Kubernetes, {ks_product}, GPU Operator, NVIDIA" +description: "介绍 NVIDIA GPU Operator 扩展组件。" +weight: 22 +layout: "second" +draft: true +--- diff --git a/content/zh/docs/v4.1/11-use-extensions/23-cert-manager/01-intro.adoc b/content/zh/docs/v4.1/11-use-extensions/23-cert-manager/01-intro.adoc new file mode 100644 index 000000000..317a59c63 --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/23-cert-manager/01-intro.adoc @@ -0,0 +1,20 @@ +--- +title: "概述" +keywords: "Kubernetes, {ks_product}, 证书管理, 更新证书" +description: "介绍证书管理扩展组件。" +weight: 01 +--- + +Cert Manager (证书管理) 为 Kubernetes 中的工作负载创建 TLS 证书,并在证书过期前续订。 + +Cert Manager 可以从各种证书颁发机构获取证书,包括:Let’s Encrypt、HashiCorp Vault、Venafi 和私有 PKI。 + +安装扩展组件时,在扩展组件配置下,开启 `defaultIssuer` 字段下的参数,会生成一个 ClusterIssuer, 名为 `default-issuer`。 默认的 ClusterIssuer 可用来给其他组件颁发证书。例如,使用 KubeSphere 网关时,可为路由自动生成和更新证书。 + +[.admon.note,cols="a"] +|=== +|说明 + +| +有关组件配置的更多信息,请参阅扩展中心“证书管理”扩展组件的详情页说明。 +|=== \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/23-cert-manager/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/23-cert-manager/_index.adoc new file mode 100644 index 000000000..ae2ebbcad --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/23-cert-manager/_index.adoc @@ -0,0 +1,8 @@ +--- +title: "证书管理" +keywords: "Kubernetes, {ks_product}, 证书管理, 更新证书" +description: "介绍证书管理扩展组件。" +weight: 23 +layout: "second" +draft: true +--- \ No newline at end of file diff --git a/content/zh/docs/v4.1/11-use-extensions/_index.adoc b/content/zh/docs/v4.1/11-use-extensions/_index.adoc new file mode 100644 index 000000000..a0750228f --- /dev/null +++ b/content/zh/docs/v4.1/11-use-extensions/_index.adoc @@ -0,0 +1,10 @@ +--- +title: "扩展组件使用" +keywords: "Kubernetes, {ks_product}, 扩展组件, 使用指南, DevOps, DMP, whizard, 可观测组件" +description: "介绍如何使用各个扩展组件。" +weight: 11 +layout: "second" +icon: "/images/docs/common/docs.svg" +--- + +本节介绍如何使用{ks_product_both}的各个扩展组件。使用前,请先link:../06-extension-user-guide/01-install-components-pdf/[安装扩展组件]。 \ No newline at end of file diff --git a/content/zh/docs/v4.1/25-reference/_index.adoc b/content/zh/docs/v4.1/25-reference/_index.adoc index 7338d638e..e661683d8 100644 --- a/content/zh/docs/v4.1/25-reference/_index.adoc +++ b/content/zh/docs/v4.1/25-reference/_index.adoc @@ -4,7 +4,6 @@ linkTitle: "参考" weight: 25 keywords: 'Kubernetes, KubeSphere, 术语表, 词汇表' description: '了解 KubeSphere 中的常用词汇表和相关信息。' -draft: true layout: "second" icon: "/images/docs/common/docs.svg" --- From 075ee3b9c10e138254c57221a3431785dfeda6e4 Mon Sep 17 00:00:00 2001 From: zhuxiujuan28 <562873187@qq.com> Date: Mon, 14 Oct 2024 16:33:38 +0800 Subject: [PATCH 2/2] add new files in _custom Signed-off-by: zhuxiujuan28 <562873187@qq.com> --- .../pods/pods-para-podList_whizard.adoc | 35 +++++++++++++++++++ .../pods/pods-para-podStatus_overview.adoc | 13 +++++++ 2 files changed, 48 insertions(+) create mode 100644 content/zh/docs/_custom/clusterManagement/pods/pods-para-podList_whizard.adoc create mode 100644 content/zh/docs/_custom/clusterManagement/pods/pods-para-podStatus_overview.adoc diff --git a/content/zh/docs/_custom/clusterManagement/pods/pods-para-podList_whizard.adoc b/content/zh/docs/_custom/clusterManagement/pods/pods-para-podList_whizard.adoc new file mode 100644 index 000000000..ae41dd9fb --- /dev/null +++ b/content/zh/docs/_custom/clusterManagement/pods/pods-para-podList_whizard.adoc @@ -0,0 +1,35 @@ +// :ks_include_id: 9b12ede280884331985685925cf5dfc4 +* 容器组列表提供以下信息: ++ +-- +[%header,cols="1a,4a"] +|=== +|参数 |描述 + +|名称 +|容器组的名称。 + +|状态 +|容器组的状态。 + +include::pods-para-podStatus_overview.adoc[] +// pod 状态不一样 + +|节点 +|容器组所在的节点和节点的 IP 地址。 + +include::pods-para-podIpPool.adoc[] + +// |应用 +// |容器组所属的应用。 + +|项目 +|容器组所属的项目。 + +|集群 +|容器组所属的集群。 + +|更新时间 +|容器组的更新时间。 +|=== +-- diff --git a/content/zh/docs/_custom/clusterManagement/pods/pods-para-podStatus_overview.adoc b/content/zh/docs/_custom/clusterManagement/pods/pods-para-podStatus_overview.adoc new file mode 100644 index 000000000..12593cfc4 --- /dev/null +++ b/content/zh/docs/_custom/clusterManagement/pods/pods-para-podStatus_overview.adoc @@ -0,0 +1,13 @@ +// :ks_include_id: 8cc83a9c58b8460cbcf369b1a07288b1 + +* **运行中**:容器组已分配给某个节点,容器组中的所有容器都已被创建,至少有一个容器正在运行、启动或重启。 + +* **等待中**:容组器已被系统接受,但有至少一个容器尚未创建也未运行。此状态下,容器组可能正在等待调度,或等待容器镜像下载完成。 + +* **成功完成**:容器组中的所有容器都成功终止(以 0 退出码终止),并且不再重启。 + +* **失败**:容器组中的所有容器都已终止,并且至少有一个容器以非 0 退出码终止。 + +* **未知**:系统无法获取容器组状态。出现这种状态通常是由于系统与容器组所在的主机通信失败。 + +// 已完成 vs 成功完成:https://github.com/kubesphere/project/issues/3983#issuecomment-2246982909 \ No newline at end of file