diff --git a/.vuepress/config.js b/.vuepress/config.js index ef9f0df..dc5c228 100644 --- a/.vuepress/config.js +++ b/.vuepress/config.js @@ -362,6 +362,8 @@ module.exports = { 'k8s-practice/ocp/user-center', 'k8s-practice/ocp/api-gateway', 'k8s-practice/ocp/back-center', + 'k8s-practice/ocp/review', + 'k8s-practice/ocp/export', ] }, ] diff --git a/README.md b/README.md index 87e7b00..b57b53c 100644 --- a/README.md +++ b/README.md @@ -95,9 +95,9 @@ Kubernetes教程的主要依据是：Kubernetes 官网文档，以及使用 Kubo * [在K8S上部署redis](https://kuboard.cn/learning/k8s-practice/ocp/redis.html) * [在K8S上部署auth-server](https://kuboard.cn/learning/k8s-practice/ocp/auth-server.html) * [在K8S上部署user-center](https://kuboard.cn/learning/k8s-practice/ocp/user-center.html) -* [在K8S上部署api-gateway] -* [在K8S上部署back-center] -* [重新审视配置信息] +* [在K8S上部署api-gateway](https://kuboard.cn/learning/k8s-practice/ocp/api-gateway.html) +* [在K8S上部署back-center](https://kuboard.cn/learning/k8s-practice/ocp/back-center.html) +* [重新审视配置信息](https://kuboard.cn/learning/k8s-practice/ocp/review.html) * [导出部署配置] * [在新的名称空间导入部署配置] diff --git a/learning/README.md b/learning/README.md index 324823e..7bc101d 100644 --- a/learning/README.md +++ b/learning/README.md @@ -93,8 +93,8 @@ description: Kubernetes免费中文教程目录 * [在K8S上部署redis](/learning/k8s-practice/ocp/redis.html) * [在K8S上部署auth-center](/learning/k8s-practice/ocp/auth-server.html) * [在K8S上部署user-center](/learning/k8s-practice/ocp/user-center.html) -* [在K8S上部署api-gateway] -* [在K8S上部署back-center] -* [重新审视配置信息] +* [在K8S上部署api-gateway](/learning/k8s-practice/ocp/api-gateway.html) +* [在K8S上部署back-center](/learning/k8s-practice/ocp/back-center.html) +* [重新审视配置信息](/learning/k8s-practice/ocp/review.html) * [导出部署配置] * [在新的名称空间导入部署配置] diff --git a/learning/k8s-practice/ocp/export.assets/image-20191001123231022.png b/learning/k8s-practice/ocp/export.assets/image-20191001123231022.png new file mode 100644 index 0000000..78b189a Binary files /dev/null and b/learning/k8s-practice/ocp/export.assets/image-20191001123231022.png differ diff --git a/learning/k8s-practice/ocp/export.md b/learning/k8s-practice/ocp/export.md new file mode 100644 index 0000000..a4277e3 --- /dev/null +++ b/learning/k8s-practice/ocp/export.md @@ -0,0 +1,17 @@ +--- +vssueId: 104 +titlePrefix: 部署SpringCloud_OCP +layout: LearningLayout +description: Kubernetes教程_使用Kuboard在Kubernetes上部署Spring_Cloud微服务平台OCP_open_capacity_platform微服务能力开放平台_导出部署配置 +meta: + - name: keywords + content: Kubernetes部署SpringCloud,Kubernetes部署OCP,Kuboard部署OCP +--- + +# 导出部署配置 + + + + + +![Kubernetes教程_部署SpringCloud_OCP_导出部署配置_配置内容](./export.assets/image-20191001123231022.png) diff --git a/learning/k8s-practice/ocp/index.md b/learning/k8s-practice/ocp/index.md index cba2bd6..5a41de1 100644 --- a/learning/k8s-practice/ocp/index.md +++ b/learning/k8s-practice/ocp/index.md @@ -24,11 +24,11 @@ Kuboard 网站将陆续 **连载** 如何使用 Kuboard 在 Kubernetes 上部署 * [在K8S上部署mysql](/learning/k8s-practice/ocp/mysql.html) * [在K8S上部署redis](/learning/k8s-practice/ocp/redis.html) * [在K8S上部署auth-server](/learning/k8s-practice/ocp/auth-server.html) -* [在K8S上部署user-center] -* [在K8S上部署api-gateway] -* [在K8S上部署back-center] -* [重新审视配置信息] -* [导出部署配置] +* [在K8S上部署user-center](/learning/k8s-practice/ocp/user-server.html) +* [在K8S上部署api-gateway](/learning/k8s-practice/ocp/api-gateway.html) +* [在K8S上部署back-center](/learning/k8s-practice/ocp/back-center.html) +* [重新审视配置信息](/learning/k8s-practice/ocp/review.html) +* [导出部署配置](/learning/k8s-practice/ocp/export.html) * [在新的名称空间导入部署配置] ::: tip OCP答疑 diff --git a/learning/k8s-practice/ocp/review.assets/image-20191001090827800.png b/learning/k8s-practice/ocp/review.assets/image-20191001090827800.png new file mode 100644 index 0000000..c1b7180 Binary files /dev/null and b/learning/k8s-practice/ocp/review.assets/image-20191001090827800.png differ diff --git a/learning/k8s-practice/ocp/review.assets/image-20191001101121469.png b/learning/k8s-practice/ocp/review.assets/image-20191001101121469.png new file mode 100644 index 0000000..56d0694 Binary files /dev/null and b/learning/k8s-practice/ocp/review.assets/image-20191001101121469.png differ diff --git a/learning/k8s-practice/ocp/review.md b/learning/k8s-practice/ocp/review.md new file mode 100644 index 0000000..6597462 --- /dev/null +++ b/learning/k8s-practice/ocp/review.md @@ -0,0 +1,183 @@ +--- +vssueId: 103 +titlePrefix: 部署SpringCloud_OCP +layout: LearningLayout +description: Kubernetes教程_使用Kuboard在Kubernetes上部署Spring_Cloud微服务平台OCP_open_capacity_platform微服务能力开放平台_重新审视配置信息 +meta: + - name: keywords + content: Kubernetes部署SpringCloud,Kubernetes部署OCP,Kuboard部署OCP +--- + +# 重新审视配置信息 + +在本系列文章的前面部分，我们已经完成了在 Kubernetes 上部署 Spring Cloud OCP 的主要组件：eureka-server、auth-server、user-cetner、api-gateway、back-center。 + +## 提取相同的参数 + +### 各模块中的环境变量 +部署过程中，主要使用环境变量向容器内注入具体环境相关的信息，以便容器内应用程序可以使用特定于环境的配置。具体来说，主要有如下信息通过环境变量替换： + +* eureka-server + * 使用环境变量覆盖 `eureka.client.service-url.defaultZone` 取值，将其设置为： + ``` + http://cloud-eureka-0.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-1.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-2.cloud-eureka.ocp.svc.cluster.local:1111/eureka + ``` +* 使用环境变量覆盖 `eureka.instance.prefer-ip-address` 取值，将其设置为：`false` + +* auth-server + + 部署auth-server时，通过环境变量覆盖了如下参数： + + * eureka.client.serviceUrl.defaultZone 覆盖为 + + ``` + http://cloud-eureka-0.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-1.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-2.cloud-eureka.ocp.svc.cluster.local:1111/eureka + ``` + * spring.datasource.druid.core.url 覆盖为 + + ``` + jdbc:mysql://db-auth-center:3306/oauth-center?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false + ``` + * spring.datasource.druid.log.url 覆盖为 + + ``` + jdbc:mysql://db-log-center:3306/log-center?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false + ``` + * spring.redis.host 覆盖为 `cloud-redis` + +* user-center + + 部署user-center时，通过环境变量覆盖了如下参数： + + * eureka.client.serviceUrl.defaultZone 覆盖为 + + ``` + http://cloud-eureka-0.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-1.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-2.cloud-eureka.ocp.svc.cluster.local:1111/eureka + ``` + * spring.datasource.druid.core.url 覆盖为 + + ``` + jdbc:mysql://db-user-center:3306/user-center?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false + ``` + * spring.datasource.druid.log.url 覆盖为 + + ``` + jdbc:mysql://db-log-center:3306/log-center?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false + ``` + * spring.redis.host 覆盖为 `cloud-redis` + +* api-gateway + + 部署api-gateway时，通过环境变量覆盖了如下参数： + + * eureka.client.serviceUrl.defaultZone 覆盖为 + + ``` + http://cloud-eureka-0.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-1.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-2.cloud-eureka.ocp.svc.cluster.local:1111/eureka + ``` + * spring.datasource.druid.core.url 覆盖为 + + ``` + jdbc:mysql://db-auth-center:3306/oauth-center?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false + ``` + * spring.datasource.druid.log.url 覆盖为 + + ``` + jdbc:mysql://db-log-center:3306/log-center?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false + ``` + * spring.redis.host 覆盖为 `cloud-redis` + +* back-center + + 部署back-center时，通过环境变量覆盖了如下参数： + * GATEWAY_API_URL + * CLOUD_EUREKA_URL + +### 相同的参数 +回顾一下，可以发现如下相同的参数： +* eureka.client.service-url.defaultZone + + 使用到此参数，且取值相同的模块有： + * eureka-server + * auth-server + * user-center + * api-gateway +* spring.datasource.druid.core.url + + 使用到此参数的模块有，（但是他们的参数值不同） + * auth-server + * user-center +* spring.datasource.druid.log.url + + 使用到此参数，且取值相同的模块有： + * auth-server + * user-center + * api-gateway + +* spring.redis.host + + 使用到此参数，且取值相同的模块有： + * auth-server + * user-center + * api-gateway + +### 提取参数到ConfigMap + +可参考文档 [使用ConfigMap配置您的应用程序](/learning/k8s-intermediate/config/config-map.html#configmap-%E5%AE%B9%E5%99%A8%E7%9A%84%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%EF%BC%88configmap%E7%9A%84%E6%89%80%E6%9C%89%E5%90%8D%E5%80%BC%E5%AF%B9%EF%BC%89) + +* 在 Kuboard 界面中进入 `ocp` 名称空间 +* 创建ConfigMap，并填入三个名值对： + + * eureka.client.serviceUrl.defaultZone = `http://cloud-eureka-0.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-1.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-2.cloud-eureka.ocp.svc.cluster.local:1111/eureka` + * spring.datasource.druid.log.url = `jdbc:mysql://db-log-center:3306/log-center?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false` + * spring.redis.host = `cloud-redis` + + ![Kubernetes教程：部署SpringCloud_创建ConfigMap](./review.assets/image-20191001090827800.png) + +* 修改 eureka-server、auth-server、user-center、api-gateway 的部署信息，将上面创建的 ConfigMap 中所有名值对注入到容器的环境变量，并去除已经在 ConfigMap 中包含的环境变量。 + + 以 eureka-server 为例，编辑该工作负载的界面截图如下所示： + + ![Kubernetes教程_部署SpringCloud_OCP_ConfigMap](./review.assets/image-20191001101121469.png) + +::: tip +将相同的参数提炼到 ConfigMap 可以使配置更简洁。 +::: + +## 为谁定义变量 + +在本教程中，为了避免对 OCP 已有代码的修改，因此以直接注入 `spring.datasource.druid.log.url` 类似的环境变量的方式，使docker镜像适应不同的环境（开发环境、测试环境、生产环境等）。这种做法就会碰到一个比较尴尬的情况，例如，对于参数 `spring.datasource.druid.core.url` 键值相同，而不同模块中（auth-server、user-center、api-gateway）取值却不同。这是从参数使用者视角来看不可避免的现象。 + +一个建议的方式是，从参数提供者的视角来定义环境变量参数，并由参数使用者引用。例如，我们定义如下几个ConfigMap属性： +* EUREKA_URLS=http://cloud-eureka-0.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-1.cloud-eureka.ocp.svc.cluster.local:1111/eureka,http://cloud-eureka-2.cloud-eureka.ocp.svc.cluster.local:1111/eureka +* DB_AUTH_CENTER_URL=jdbc:mysql://db-auth-center:3306/auth-center?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false +* DB_USER_CENTER_URL=jdbc:mysql://db-user-center:3306/user-center?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false +* DB_LOG_CENTER_URL=jdbc:mysql://db-log-center:3306/log-center?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false +* REDIS_HOST=cloud-redis + +然后在参数使用者的 `application.xml` 中引用这些环境变量参数，以 auth-center 的 `application.xml` 为例： + +```yaml {10,15,20} +spring: + session: + store-type: redis + datasource: + dynamic: + enable: true + druid: + # JDBC 配置(驱动类自动从url的mysql识别,数据源类型自动识别) + core: + url: ${DB_AUTH_CENTER_URL} + username: root + password: root + driver-class-name: com.mysql.jdbc.Driver + log: + url: ${DB_LOG_CENTER_URL} + username: root + password: root + + redis: + host: ${REDIS_HOST} + port: 6379 + timeout: 6000 +``` diff --git a/overview/README.md b/overview/README.md index 6e91234..8742087 100644 --- a/overview/README.md +++ b/overview/README.md @@ -187,7 +187,7 @@ Kuboard 为 Kubernetes 初学者设计了如下学习路径： * [在K8S上部署user-center](/learning/k8s-practice/ocp/user-center.html) * [在K8S上部署api-gateway](/learning/k8s-practice/ocp/api-gateway.html) * [在K8S上部署back-center](/learning/k8s-practice/ocp/back-center.html) -* [重新审视配置信息] +* [重新审视配置信息](/learning/k8s-practice/ocp/review.html) * [导出部署配置] * [在新的名称空间导入部署配置]