Kubernetes官方java客戶端之一：準備

時間 2020-12-31

標籤 java git 程序員 github spring shell 數據庫 apache api springboot 欄目 Java 简体版

原文原文鏈接

歡迎訪問個人GitHub

https://github.com/zq2599/blog_demosjava

內容：全部原創文章分類彙總及配套源碼，涉及Java、Docker、Kubernetes、DevOPS等；git

關於Kubernetes官方java客戶端

Kubernetes官方java客戶端全稱是Kubernetes Java Client，是K8S官方推出的java庫，以8.0.2版本爲例，其maven座標以下：

<dependency>
    <groupId>io.kubernetes</groupId>
    <artifactId>client-java</artifactId>
    <version>8.0.2</version>
    <scope>compile</scope>
</dependency>

本文是《Kubernetes官方java客戶端》系列的第一篇，主要內容是瞭解概念，再爲後續章節的作好準備工做；程序員
回想我們一般是如何操做K8S環境的，例如部署deployment，能夠在dashboard頁面上傳yaml文件，也能在SSH終端執行kubectl命令，這些操做的去向都是K8S的API Server，以下圖：
github
從上圖可見，若是能把請求發送到API Server，就能夠像kubectl命令那樣操做K8S了，K8S官方java客戶端（Kubernetes Java Client）就是擁有這樣能力的SDK，使得java應用擁有kubectl那樣的能力，以下圖所示，加載了K8S官方java客戶端庫的SpringBoot應用，能夠直接將請求發送到K8S環境：
spring

須要準備什麼

《Kubernetes官方java客戶端》是以實戰爲主的系列文章，爲了後面實戰順利進行，會在本章進行準備工做，包括硬件、軟件、配置等方面，接下來會逐一列出；shell

開發環境

我這邊用來編碼的環境以下：數據庫

操做系統：macOS Catalina 10.15.5
JDK：1.8.0_121
Maven：33.3.9
開發工具：IntelliJ IDEA 2019.3.2 (Ultimate Edition)

運行環境

編碼完成後要運行在K8S環境，該環境只有一臺CentoOS電腦，信息以下：apache

操做系統：CentOS Linux release 7.8.2003
K8S：1.15.3

選定client-java版本

K8S有多個版本，java客戶端也有多個版本，用的時候如何選擇呢？請參考官方給出的兼容性列表：
如上圖，橫向是K8S版本，縱向是java客戶端版本，表格中有三種符號，含義以下：

✓ 表示從特性到API，客戶端和K8S環境都匹配；
+ 表示客戶端有些特性和API與K8S環境沒法匹配，可是他們共有的特性和API都能正常運行；
- 表示當前K8S環境上有些特性和API是客戶端沒法提供的；
個人K8S版本是1.15，可見7.0.0版本的客戶端是最合適的，後續的實戰中也就選用該版本了，請您根據本身K8S的狀況選擇對應版本；

SpringBoot應用操做權限

後面的實戰中，我們的SpringBoot應用會以Pod的形式運行在K8S環境，經過client-java的API操做K8S，而K8S天然不會容許Pod隨意對環境中的pod、deployment這些資源進行操做，所以咱們要遵守K8S的規範進行RBAC相關的操做；
K8S的角色設置能夠很是詳細，但也會更復雜，我們仍是不要花太多時間在這上面吧，這裏我選擇了使用K8S自帶的最高權限的角色：cluster-admin，您能夠按照本身的實際狀況定製角色，下面是具體操做；
SSH登陸K8S，建立namespace：

kubectl create namespace kubernetesclient

建立文件rbac.yaml，內容以下：

apiVersion: v1
kind: ServiceAccount
metadata:
  name: kubernates-client-service-account
  namespace: kubernetesclient
---
kind: ClusterRoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: kubernates-client-cluster-role-binding
subjects:
  - kind: ServiceAccount
    name: kubernates-client-service-account
    namespace: kubernetesclient
roleRef:
  kind: ClusterRole
  name: cluster-admin
  apiGroup: rbac.authorization.k8s.io

從此的實戰中，SpringBoot應用都會部署在名爲kubernetesclient的namespace之下，使用名爲kubernates-client-service-account的Service Account；

IEDA安裝插件

由於項目中用到了Slf4j註解，請在IEDA上安裝lombok插件，不然編寫log相關代碼的時候會有紅叉：
api

建立全部java應用的父工程

後面的實戰要建立多個SpringBoot應用，有必要提早建立一個父maven工程，將依賴庫的定義和版本都放在在此；
建立名爲kubernetesclient的maven工程，pom.xml以下：

<?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.3.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <groupId>com.bolingcavalry</groupId>
    <artifactId>kubernetesclient</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>helloworld</module>
        <module>outsidecluster</module>
    </modules>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <dependencyManagement>

        <dependencies>
            <dependency>
                <groupId>io.kubernetes</groupId>
                <artifactId>client-java</artifactId>
                <version>7.0.0</version>
                <scope>compile</scope>
            </dependency>
        </dependencies>

    </dependencyManagement>
</project>

因爲這是個父工程，所以目前除了pom.xml暫時沒有其餘內容，後面的實戰會往裏面添加子工程；springboot

全系列源碼下載

本次實戰用到了一個普通的SpringBoot工程，源碼可在GitHub下載到，地址和連接信息以下表所示(https://github.com/zq2599/blog_demos)：

名稱	連接	備註
項目主頁	https://github.com/zq2599/blog_demos	該項目在GitHub上的主頁
git倉庫地址(https)	https://github.com/zq2599/blog_demos.git	該項目源碼的倉庫地址，https協議
git倉庫地址(ssh)	git@github.com:zq2599/blog_demos.git	該項目源碼的倉庫地址，ssh協議