amdatu/amdatu-kubernetes-deployer

镜像概述

Amdatu Kubernetes Deployer是基于Kubernetes API构建的部署编排组件，提供REST API管理部署描述符与流程、WebSocket API流式传输部署日志。它可与Amdatu Kubernetes Deploymentctl UI配合使用，或作为构建流水线的一部分，已在多个生产环境中应用并持续维护。

核心功能

• 蓝绿部署策略
• 外部负载均衡配置
• 部署描述符管理
• 实际部署流程管理
• 部署期间健康检查
• 向Pod注入环境变量

使用场景

1. 与可视化UI配合管理K8s部署
2. 集成到CI/CD流水线实现自动化部署
3. 生产环境中管理应用的蓝绿部署、健康检查与负载均衡

配置说明

运行方式

通过Docker容器启动：

docker run amdatu/amdatu-kubernetes-deployer:production -kubernetes http://[kubernetes-api-server]:8080 -etcd http://[etcd-server]:2379
docker run amdatu/haproxy-confd:prod ...

部署描述符

定义应用部署方式的JSON文件，包含命名空间、应用名称、版本、副本数等配置。示例schema：

json
{
    "id": "<唯一ID>",
    "created": "2017-01-15T02:02:14Z",
    "lastModified": "2017-02-08T08:54:01Z",
    "deploymentType": "blue-green",
    "namespace": "default",
    "appName": "my-app",
    "newVersion": "#",
    "imagePullSecrets": [{"name": "secretName"}],
    "replicas": 2,
    "frontend": "example.com",
    "redirectWww": "false",
    "useCompression": "false",
    "additionHttpHeaders": [{"Header": "X-TEST", "Value": "some http header test"}],
    "useHealthCheck": true,
    "healthCheckPort": 9999,
    "healthCheckPath": "health",
    "healthCheckType": "probe|simple",
    "ignoreHealthCheck": true,
    "webhooks": [{"key": "<唯一ID>", "description": "..."}],
    "podspec": {...}
}

健康检查

支持两种类型：

1. probe：端点返回{"healthy": true|false}JSON
2. simple：端点返回2xx状态码表示健康

REST API管理

描述符管理

• POST /descriptors/?namespace={namespace}：创建描述符
• GET /descriptors/?namespace={namespace}[&appname={appname}]：获取描述符列表
• GET/PUT/DELETE /descriptors/{id}/?namespace={namespace}：查询/更新/删除指定描述符

部署管理

• POST /deployments/?namespace={namespace}&descriptorId={descriptorId}：触发部署
• GET /deployments/?namespace={namespace}[&appname={appname}]：获取部署列表
• GET /deployments/{id}/logs?namespace={namespace}：获取部署日志
• PUT /deployments/{id}/?namespace={namespace}：重新部署
• DELETE /deployments/{id}/?namespace={namespace}：卸载或删除部署

环境变量注入

通过etcd键/deployer/environment/[mykey]注入变量，键名=变量名，键值=变量值。

认证授权

• K8s API支持基本认证，需通过参数提供凭据
• REST API认证授权待实现（将基于JWT）