spring-cloud-kubernetes與k8s的configmap
本文是《spring-cloud-kubernetes實戰系列》的第六篇，主要內容是在kubernetes上部署一個java web應用，該應用使用了spring-cloud-kubernetes框架，可使用kubernetes的configmap；java
系列文章列表
- 《spring-cloud-kubernetes官方demo運行實戰》
- 《你好spring-cloud-kubernetes》
- 《spring-cloud-kubernetes背後的三個關鍵知識點》
- 《spring-cloud-kubernetes的服務發現和輪詢實戰(含熔斷)》
- 《spring-cloud-kubernetes與SpringCloud Gateway》
- 《spring-cloud-kubernetes與k8s的configmap》
- 《spring-cloud-kubernetes自動同步k8s的configmap更新》
關於SpringCloud Config
若是您開發過SpringCloud應用，相信您對SpringCloud Config不會陌生，在微服務環境中，業務應用能夠從config server獲取所需的配置信息，以下圖所示：
git
關於kubernetes的configmap
這是kubernetes提供的基本服務之一，建立一個configmap資源，對應着一份配置文件，能夠將該資源經過數據卷的形式映射到Pod上，這樣Pod就能用上這個配置文件了，以下圖：程序員
spring-cloud-kubernetes帶來的禮物
spring-cloud-starter-kubernetes-config是spring-cloud-starter-kubernetes框架下的一個庫，做用是將kubernetes的configmap與SpringCloud Config結合起來，經過spring-cloud-starter-kubernetes-config，咱們的應用就像在經過SpringCloud Config取得配置信息，只不過這裏的配置信息來自kubernetes的configmap，而不是SpringCloud Config server，以下圖所示：web
理論上的準備工做已經差很少了，接下來經過實戰來展現spring-cloud-starter-kubernetes-config的神奇之處；spring
源碼下載
若是您不打算寫代碼，也能夠從GitHub上下載本次實戰的源碼，地址和連接信息以下表所示：apache
這個git項目中有多個文件夾，本章的應用在springcloudk8sconfigdemo文件夾下，以下圖所示：json
環境信息
本次實戰的環境和版本信息以下：bootstrap
- 操做系統：CentOS Linux release 7.6.1810
- minikube：1.1.1
- Java：1.8.0_191
- Maven：3.6.0
- fabric8-maven-plugin插件：3.5.37
- spring-cloud-kubernetes：1.0.1.RELEASE
- springboot：2.1.6.RELEASE
準備完畢，能夠開始實戰啦！api
編碼
- 經過maven建立名爲springcloudk8sconfigdemo的springboot工程，pom.xml內容以下，要注意的是新增了依賴spring-cloud-starter-kubernetes-config，這是本次實戰的重點：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.6.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.bolingcavalry</groupId>
<artifactId>springcloudk8sconfigdemo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>springcloudk8sconfigdemo</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
<spring-boot.version>2.1.6.RELEASE</spring-boot.version>
<maven-checkstyle-plugin.failsOnError>false</maven-checkstyle-plugin.failsOnError>
<maven-checkstyle-plugin.failsOnViolation>false</maven-checkstyle-plugin.failsOnViolation>
<maven-checkstyle-plugin.includeTestSourceDirectory>false</maven-checkstyle-plugin.includeTestSourceDirectory>
<maven-compiler-plugin.version>3.5</maven-compiler-plugin.version>
<maven-deploy-plugin.version>2.8.2</maven-deploy-plugin.version>
<maven-failsafe-plugin.version>2.18.1</maven-failsafe-plugin.version>
<maven-surefire-plugin.version>2.21.0</maven-surefire-plugin.version>
<fabric8.maven.plugin.version>3.5.37</fabric8.maven.plugin.version>
<springcloud.kubernetes.version>1.0.1.RELEASE</springcloud.kubernetes.version>
<spring-cloud.version>Greenwich.SR2</spring-cloud.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-kubernetes-config</artifactId>
<version>${springcloud.kubernetes.version}</version>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${spring-boot.version}</version>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<!--skip deploy -->
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-deploy-plugin</artifactId>
<version>${maven-deploy-plugin.version}</version>
<configuration>
<skip>true</skip>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>${maven-surefire-plugin.version}</version>
<configuration>
<skipTests>true</skipTests>
<!-- Workaround for https://issues.apache.org/jira/browse/SUREFIRE-1588 -->
<useSystemClassLoader>false</useSystemClassLoader>
</configuration>
</plugin>
<plugin>
<groupId>io.fabric8</groupId>
<artifactId>fabric8-maven-plugin</artifactId>
<version>${fabric8.maven.plugin.version}</version>
<executions>
<execution>
<id>fmp</id>
<goals>
<goal>resource</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
<profiles>
<profile>
<id>kubernetes</id>
<build>
<plugins>
<plugin>
<groupId>io.fabric8</groupId>
<artifactId>fabric8-maven-plugin</artifactId>
<version>${fabric8.maven.plugin.version}</version>
<executions>
<execution>
<id>fmp</id>
<goals>
<goal>resource</goal>
<goal>build</goal>
</goals>
</execution>
</executions>
<configuration>
<enricher>
<config>
<fmp-service>
<type>NodePort</type>
</fmp-service>
</config>
</enricher>
</configuration>
</plugin>
</plugins>
</build>
</profile>
</profiles>
</project>複製代碼
- 項目的srcmainresources路徑下不要建立application.yml文件，只建立名爲bootstrap.yml的文件，內容以下：
spring:
application:
name: springcloudk8sconfigdemo
cloud:
kubernetes:
config:
sources:
- name: ${spring.application.name}
namespace: default複製代碼
可見新增了配置項spring.cloud.kubernetes.config.source.name和spring.cloud.kubernetes.config.source.namespace，用於配置信息來源於kubernetes的哪一個namespace下的哪一個configmap；瀏覽器
- 增長一個配置類DummyConfig.java，註解ConfigurationProperties的prefix="greeting"表示該類用到的配置項都是名爲"greeting"的配置項的子內容 ：
package com.bolingcavalry.springcloudk8sconfigdemo;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
@Configuration
@ConfigurationProperties(prefix = "greeting")
public class DummyConfig {
private String message = "This is a dummy message";
public String getMessage() {
return this.message;
}
public void setMessage(String message) {
this.message = message;
}
}複製代碼
- 啓動類Springcloudk8sconfigdemoApplication.java，簡單起見，將用於驗證配置項是否生效的web接口也寫在了這裏面，即hello方法 ：
package com.bolingcavalry.springcloudk8sconfigdemo;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.text.SimpleDateFormat;
import java.util.Date;
@SpringBootApplication
@RestController
@EnableConfigurationProperties(DummyConfig.class)
public class Springcloudk8sconfigdemoApplication {
@Autowired
private DummyConfig dummyConfig;
@GetMapping("/hello")
public String hello() {
return dummyConfig.getMessage()
+ " ["
+ new SimpleDateFormat().format(new Date())
+ "]";
}
public static void main(String[] args) {
SpringApplication.run(Springcloudk8sconfigdemoApplication.class, args);
}
}複製代碼
以上就是實戰工程的全部代碼了，僅僅只是引入了spring-cloud-kubernetes-config的依賴，以及在啓動配置文件中指定了configmap的信息，即完成了獲取配置文件的全部操做，至於代碼中用到配置文件的地方，和使用SpringCloud Config並沒有差異。
解決權限問題
我這裏的是minikube，在部署了應用以後，默認的serviceaccount是沒有權限訪問K8S的API Server資源的，執行如下命令能夠提高權限：
kubectl create clusterrolebinding permissive-binding \
--clusterrole=cluster-admin \
--user=admin \
--user=kubelet \
--group=system:serviceaccounts複製代碼
注意：以上辦法只能用於開發和測試環境，不要用在生產環境，生產環境應參考Kubernetes的RBAC受權相關設置來處理，步驟以下：
- 建立role：
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
namespace: default
name: pod-reader
rules:
- apiGroups: [""]
resources: ["pods","configmaps"]
verbs: ["get", "watch", "list"]複製代碼
- 建立ServiceAccount：
apiVersion: v1
kind: ServiceAccount
metadata:
name: config-reader
namespace: default複製代碼
- 綁定Role和ServiceAccount：
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
name: pod-reader
namespace: default
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: Role
name: pod-reader
subjects:
- kind: ServiceAccount
name: config-reader
namespace: default複製代碼
- 在deployment中指定上面的ServiceAccount；
驗證
接下來咱們在kubernetes環境建立configmap，再將springcloudk8sconfigdemo在kubernetes部署和啓動，經過springcloudk8sconfigdemo提供的http接口驗證應用是否已經從configmap中取得指定的配置；
- 在kubernetes環境新建名爲springcloudk8sconfigdemo.yml的文件，內容以下：
kind: ConfigMap
apiVersion: v1
metadata:
name: springcloudk8sconfigdemo
data:
application.yml: |-
greeting:
message: Say Hello to the World
farewell:
message: Say Goodbye
---
spring:
profiles: development
greeting:
message: Say Hello to the Developers
farewell:
message: Say Goodbye to the Developers
---
spring:
profiles: production
greeting:
message: Say Hello to the Ops複製代碼
- 在springcloudk8sconfigdemo.yml文件所在目錄執行如下命令，便可在kubernetes建立名爲的configmap的資源：
kubectl apply -f springcloudk8sconfigdemo.yml複製代碼
- 在springcloudk8sconfigdemo項目的pom.xml文件所在目錄，執行如下命令，便可編譯構建部署所有完成：
mvn clean install fabric8:deploy -Dfabric8.generator.from=fabric8/java-jboss-openjdk8-jdk -Pkubernetes複製代碼
操做成功後的控制檯信息以下：
[INFO] Installing /usr/local/work/k8s/springcloudk8sconfigdemo/target/classes/META-INF/fabric8/kubernetes.json to /root/.m2/repository/com/bolingcavalry/springcloudk8sconfigdemo/0.0.1-SNAPSHOT/springcloudk8sconfigdemo-0.0.1-SNAPSHOT-kubernetes.json
[INFO]
[INFO] <<< fabric8-maven-plugin:3.5.37:deploy (default-cli) < install @ springcloudk8sconfigdemo <<<
[INFO]
[INFO]
[INFO] --- fabric8-maven-plugin:3.5.37:deploy (default-cli) @ springcloudk8sconfigdemo ---
[INFO] F8: Using Kubernetes at https://192.168.121.133:8443/ in namespace default with manifest /usr/local/work/k8s/springcloudk8sconfigdemo/target/classes/META-INF/fabric8/kubernetes.yml
[INFO] Using namespace: default
[INFO] Updating a Service from kubernetes.yml
[INFO] Updated Service: target/fabric8/applyJson/default/service-springcloudk8sconfigdemo.json
[INFO] Using namespace: default
[INFO] Updating Deployment from kubernetes.yml
[INFO] Updated Deployment: target/fabric8/applyJson/default/deployment-springcloudk8sconfigdemo.json
[INFO] F8: HINT: Use the command `kubectl get pods -w` to watch your pods start up
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 13.538 s
[INFO] Finished at: 2019-07-14T17:06:25+08:00
[INFO] ------------------------------------------------------------------------複製代碼
- 若是您的環境也是minikube，能夠執行如下命令查看服務地址：
minikube service springcloudk8sconfigdemo --url複製代碼
獲得服務地址是：http://192.168.121.133:31646
- 瀏覽器訪問地址：http://192.168.121.133:31646/hello ，獲得響應以下圖，可見已經從configmap取得了配置文件，而且加載成功：
修改profile
前面的實戰沒有指定springboot工程的profile，接下來指定profile爲development，看可否加載到配置文件中指定的配置，以下圖紅框所示：
- 修改項目的srcmainresources路徑下的bootstrap.yml文件，增長配置項spring.profiles.active，修改後的完整內容以下：
spring:
application:
name: springcloudk8sconfigdemo
profiles:
active: development
cloud:
kubernetes:
config:
sources:
- name: ${spring.application.name}
namespace: default複製代碼
- 在springcloudk8sconfigdemo項目的pom.xml文件所在目錄，執行如下命令，便可編譯構建部署所有完成：
mvn clean install fabric8:deploy -Dfabric8.generator.from=fabric8/java-jboss-openjdk8-jdk -Pkubernetes複製代碼
- 若是您的環境也是minikube，能夠執行如下命令查看服務地址：
minikube service springcloudk8sconfigdemo --url複製代碼
獲得服務地址是：http://192.168.121.133:30659
- 瀏覽器訪問地址：http://192.168.121.133:30659/hello ，獲得響應以下圖，可見已經從configmap取得了指定profile的配置文件，而且加載成功：
至此，spring-cloud-kubernetes與k8s的configmap的實戰就完成了，咱們能夠發現藉助spring-cloud-kubernetes-config的神奇能力，曾經使用SpringCloud Config來配置的應用幾乎不用修改代碼，僅僅調整了配置和依賴，就能順利遷移到kubernetes之上，直接使用原生的配置服務，而且SpringCloud Config Server也能夠不用在kubernetes上部署了，再次感覺到SpringCloud設計的前瞻性。
一點遺憾
雖然咱們的應用已經成功從configmap取得配置信息，但遺憾的是，configmap的配置信息被修改後，這些修改是沒法實時同步到咱們的應用的，只能重啓應用來重現獲取配置，爲了解決這個問題，請參考本系列的下一篇 《spring-cloud-kubernetes自動同步k8s的configmap更新》
歡迎關注個人公衆號：程序員欣宸
相關文章
- 1. spring-cloud-kubernetes與k8s的configmap
- 2. k8s與configmap--安利configmap-reload組件
- 3. k8s-configmap
- 4. k8s之configmap、secret
- 5. 【K8S】初識ConfigMap
- 6. k8s之configmap和secret
- 7. k8s學習筆記之configmap
- 8. 八. k8s--configmap學習筆記
- 9. k8s ConfigMap報錯信息
- 10. k8s數據持久化之Secret和configMap
- 更多相關文章...
- • Hibernate的級聯與反轉 - Hibernate教程
- • MyBatis與Spring的整合實例 - MyBatis教程
- • Docker容器實戰(六) - 容器的隔離與限制
- • Composer 安裝與使用
相關標籤/搜索
每日一句
-
每一个你不满意的现在，都有一个你没有努力的曾经。
歡迎關注本站公眾號,獲取更多信息
