1. 程式人生 > >簡單開發k8s多集群後臺

簡單開發k8s多集群後臺

return ivr divide ear ots ole plugins box jquer

詳細的說明如何利用kubernetes api創建一個支持多集群的k8s後臺,這裏主要實現調用kubernetes api獲取查看service服務,pod服務。下一篇再說明如果操作一個service,以及註入容器console

  1. 相關的組件
    • Django (2.0.7)
    • kubernetes (6.0.0)
    • Django Rest Framework (3.8.2)
    • Bootstrap 3.3.7
    • Jquery 2.1.1
    • pace 頁面異步加載插件

技術分享圖片

技術分享圖片


  1. 新建一個基於django的k8s項目,命名為k8s_web_console

技術分享圖片


  1. 增加一個cluster應用
python manage.py startapp cluster

  1. 添加 Django Rest Framework
    • 使用rest框架是方便做前後端分離,如果你是個全棧工程師,建議做前後端分離,這樣方便維護。但這裏為了入門快速方便,如果還要加一個node.js開發,比較麻煩,所以暫時保留這種可能,但還是用django的template方式開發。
pip install djangorestframework
  • 在setting.py中加入rest框架
INSTALLED_APPS = [
    ‘django.contrib.admin‘,
    ‘django.contrib.auth‘,
    ‘django.contrib.contenttypes‘,
    ‘django.contrib.sessions‘,
    ‘django.contrib.messages‘,
    ‘django.contrib.staticfiles‘,
    ‘rest_framework‘,
        ‘cluster‘,
]
  • 創建數據庫以及數據表
python manage.py makemigrations
python manage.py migrate
  1. 打開cluster應用下的models.py添加一個k8s集群信息的model

    class Cluster(models.Model):
    name = models.TextField()
    api = models.TextField()
    token = models.TextField()
    
    class Meta :
        db_table = "cluster"
    
    def __str__(self):
        return self.name

    這裏是k8s的連接通過api+token的方式進行連接,當然也可以用證書認證的方式

    • name : 集群的名稱
    • api : k8s集群的api 鏈接
    • token : k8s集群擁有admin權限的token

  1. cluster應用添加一個serializers.py文件
from rest_framework import serializers
from cluster.models import Cluster

class ClusterSerializer( serializers.ModelSerializer ):
    class Meta:
        model = Cluster
        fields = ‘__all__‘
  • rest 框架根據這裏的配置對Cluster對象自動做序列化

  1. cluster 的view文件添加cluster的viewset
# /api/cluster/
class ClusterViewSet( viewsets.ModelViewSet ):
    queryset = Cluster.objects.all()
    serializer_class = ClusterSerializer
    # permission_classes = (IsAuthenticated,)
    parser_classes = (JSONParser,)
  • rest 框架的parser有多種,這裏用的是jsonparser,需要再settings.py 中添加如下配置
    REST_FRAMEWORK = {
    ‘DEFAULT_PARSER_CLASSES‘: (
        ‘rest_framework.parsers.JSONParser‘,
    )
}

  1. 編輯admin.py,將cluster註冊到Django Admin後臺
from django.contrib import admin
from .models import Cluster

admin.site.register(Cluster)

  1. urls.py 中設置下路由
from cluster import views as cluster_views
router = DefaultRouter()
router.register(r‘cluster‘, cluster_views.ClusterViewSet)

urlpatterns = [
    path( ‘admin/‘, admin.site.urls ), 
    path( ‘api/‘, include( router.urls ) ),
    path(‘api-auth/‘, include(‘rest_framework.urls‘, namespace=‘rest_framework‘)),
]

  1. 測試下cluster的crud,以及rest api方式

    • 運行django後,打開 http://127.0.0.1:8000/admin/cluster/cluster/
    • 添加集群的信息

    技術分享圖片

技術分享圖片

  • 如果用rest 框架來看,就打開 http://127.0.0.1:8000/api/cluster/

技術分享圖片


  1. 加入kubernetes api,開始調試kubernetes

    pip install kubernetes
    
    • cluster應用的view修改如下
from pprint import pprint
from django.shortcuts import get_object_or_404
from django.shortcuts import render
from kubernetes.client import Configuration, ApiClient, CoreV1Api
from rest_framework import viewsets
from rest_framework.decorators import action
from rest_framework.parsers import JSONParser

from cluster.models import Cluster
from .serializers import ClusterSerializer

def get_config(cluster):
    ‘‘‘
    :param cluster:  k8s集群的配置對象
    :return:   返回一個config對象
    ‘‘‘
    configuration = Configuration()
    configuration.verify_ssl = False
    configuration.host = cluster.api
    configuration.api_key[‘authorization‘] = cluster.token
    configuration.api_key_prefix[‘authorization‘] = ‘Bearer‘
    return configuration

def get_clients(cluster):
    ‘‘‘
    :param cluster: k8s集群對象
    :return:  一個apiclient對象,一個coreV1Api對象
    ‘‘‘
    api_client = ApiClient( get_config( cluster ) )
    return api_client, CoreV1Api( api_client )

# /api/cluster/
class ClusterViewSet( viewsets.ModelViewSet ):
    queryset = Cluster.objects.all()
    serializer_class = ClusterSerializer
    # permission_classes = (IsAuthenticated,)
    parser_classes = (JSONParser,)

    # /api/cluster/[pk]/list_service/
    @action( detail=True, methods=[‘get‘] )
    def list_service(self, request, pk=None):
        cluster = get_object_or_404( Cluster, pk=pk )
        api_client, core_v1_api = get_clients( cluster )
        v1_service_list = core_v1_api.list_service_for_all_namespaces()
        # pprint(v1_service_list)
        result = {}
        items = []
        headers = [‘NAMESPACE‘, ‘NAME‘, ‘TYPE‘, ‘CLUSTER-IP‘, ‘SELF LINK‘]

        for item in v1_service_list.items:
            items.append( [item.metadata.namespace,
                           item.metadata.name,
                           item.spec.cluster_ip, item.spec.type, item.metadata.self_link
                           ] )

        result[‘items‘] = items
        result[‘headers‘] = headers
        result[‘caption‘] = "Services"
        return render( request, "table.html", {‘result‘: result} )

    # /api/cluster/[pk]/list_pod/
    @action( detail=True, methods=[‘get‘] )
    def list_pod(self, request, pk=None):
        cluster = get_object_or_404( Cluster, pk=pk )
        api_client, core_v1_api = get_clients( cluster )
        v1_service_list = core_v1_api.list_pod_for_all_namespaces()
        # pprint(v1_service_list)
        result = {}
        items = []
        headers = [‘NAMESPACE‘, ‘NAME‘, ‘IP‘, ‘NODE‘]

        for item in v1_service_list.items:
            items.append( [
                item.metadata.namespace,
                item.metadata.name,
                item.status.host_ip,
                item.status.pod_ip,
            ] )

        result[‘items‘] = items
        result[‘headers‘] = headers
        result[‘caption‘] = "Pods"
        return render( request, "table.html", {‘result‘: result} )
因為這裏僅作了一個cluster測試,所以這裏將對k8s的連接也放在這裏,當如果正式的項目,應該放在一個獨立的文件,創建成連接池管理,再通過引用提供到這裏使用
  • 再次聲明,如果是這裏為了簡單,仍然用了django的template模式,當如果前後端分離開發,返回應該是序列化後的json

上面的list用到一個table.html模板,內容如下

<table class="table table-hover " id="service-table">
    <caption>{{ result.caption }}</caption>
    <thead>
    <tr>
        {% for item in result.headers %}
            <th>{{ item }}</th>
        {% endfor %}
    </tr>
    </thead>
    <tbody>
    {% for item in result.items %}
        <tr>
            {% for eny in item %}
                <td>{{ eny }}</td>
            {% endfor %}
        </tr>
    {% endfor %}
    </tbody>
    <tfoot>
    <tr>
        {% for item in result.headers %}
            <th>{{ item }}</th>
        {% endfor %}
    </tr>
    </tfoot>
</table>


  1. 項目中添加一個dashboard目錄,目錄下添加init.py,views.py文件

    技術分享圖片

    • 為了做當前頁面刷新,方便管理,所以多了一個dashboard來管理,views.py的內容如下
from django.shortcuts import render
from cluster.models import Cluster

def cluster_main(request):
    result = {}
    result[‘clusters‘] = Cluster.objects.all()
    return render(request,‘main.html‘,{‘result‘:result})
  • 在urls.py 中添加一條路由,最終內容如下

from django.contrib import admin
from django.urls import path
from django.conf.urls import include
from rest_framework.routers import DefaultRouter
from cluster import views as cluster_views
from dashboard import views as dashboard_views

router = DefaultRouter()
router.register(r‘cluster‘, cluster_views.ClusterViewSet)

urlpatterns = [
    path( ‘admin/‘, admin.site.urls ),
    path(‘dash/cluster‘,dashboard_views.cluster_main),
    path( ‘api/‘, include( router.urls ) ),
    path(‘api-auth/‘, include(‘rest_framework.urls‘, namespace=‘rest_framework‘)),
]

dashboard 中用了一個main.html模板,使用的是bootstrap+jquery+pace,實現當前頁面刷新:

{% load static %}
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>K8s 多集群管理測試</title>
    <link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css">
    <link rel="stylesheet"
          href="https://cdn.jsdelivr.net/npm/[email protected]/src/messagebox.css">
    <link rel="stylesheet" href="{% static ‘plugins/pace/pace.min.css‘ %}">
    <script src="https://cdn.bootcss.com/jquery/2.1.1/jquery.min.js"></script>
    <script src="https://cdn.bootcss.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
    <script src="http://mindmup.github.io/editable-table/mindmup-editabletable.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/src/messagebox.min.js"></script>
    <script src="{% static ‘plugins/pace/pace.min.js‘ %}"></script>
</head>
<body>
<div class="container">
    <nav class="navbar navbar-default" role="navigation">
        <div class="container-fluid">
            <div class="navbar-header">
                <a class="navbar-brand" href="#">K8S Dashboard</a>
            </div>
            <form class="navbar-form navbar-left pull-right" role="search">
                <div class="form-group">
                    <label for="k8s-api"></label>
                    <select class=" form-control" id="k8s-api">
                        <option value="#">選擇集群</option>
                        {% for cluster in result.clusters %}
                            <option value="{{ cluster.id }}">{{ cluster.name }}</option>
                        {% endfor %}
                    </select>
                </div>
            </form>
            <ul class="nav navbar-nav navbar-right">
                <li class="dropdown">
                    <a href="#" class="dropdown-toggle" data-toggle="dropdown">
                        選擇類型 <b class="caret"></b>
                    </a>
                    <ul class="dropdown-menu">
                        <li><a href="javascript:void(0);" onclick="load_table(‘/list_pod/‘)">Pod</a></li>
                        <li class="divider"></li>
                        <li><a href="javascript:void(0);" onclick="load_table(‘/list_service/‘)">Service</a></li>
                    </ul>
                </li>
            </ul>
        </div>
    </nav>
    <div id="table-div"></div>
</div>

<script type="application/javascript">
    $(document).ajaxStart(function () {
        Pace.restart()
    });

    function load_table(url_method) {

        console.log(url_method);

        k8s_select = $("#k8s-api");

        k8s_id = k8s_select.val();
        if (k8s_id === "#") {
            $.MessageBox({
                buttonDone: "OK",
                message: "<center>先選擇一個集群</center>",
                queue: true,
                speed: 200  ,
                top: "25%"   ,
            });
            return null;
        }
        url = ‘/api/cluster/‘ + k8s_id + url_method;
        $.ajax({
            url: url,
            success: function (ex) {
                console.log("success");
                $(‘#table-div‘).html(ex);
            },
            error: function (ex) {
                console.log(ex);
            }
        })

    }
</script>
</body>
</html>

  1. 好了,完成這些後,終於做完了,現在可以測試下,完成的頁面就是上面的顯示圖片,下面來講講kubernetes api的使用

    • k8s api 的主頁 https://github.com/kubernetes-client/python
    • 主要的操作接口 : https://github.com/kubernetes-client/python/blob/master/kubernetes/docs/CoreV1Api.md

    如果想要連接k8s接口並操作,需要的步驟

    • 創建一個Configuration,這是k8s的連接配置信息,這裏提供api接口跟token進行連接
    
    configuration = Configuration()
    configuration.verify_ssl = False
    configuration.host = cluster.api
    configuration.api_key[‘authorization‘] = cluster.token
    configuration.api_key_prefix[‘authorization‘] = ‘Bearer‘
    • 根據config創建一個CoreV1Api,這個類下包含多個操作k8s的接口方法
      api_client = ApiClient( configuration )

    • 如果想要查看所有的service,利用接口list_service_for_all_namespaces

技術分享圖片


本文的源碼下載目錄:http://down.51cto.com/data/2450296

簡單開發k8s多集群後臺