跳到主要内容
版本:1.8.7

Kubernetes

系统需求

  • Kubernetes version: 1.9+

  • 客户端已经安装 Kubectl

  • 具备以下操作的授权,可以使用 kubectl auth can-i 验证:

    • create secrets

    • create deployments

    • create configmaps

    • create namespaces

    • create StatefulSet

    • create Service

Helm 部署

「Helm 部署」部分内置了demo数据库用于快速体验,升级版本的时候会出现数据丢失,生产环境请使用自维护的稳定数据库!

tip

安装之前请确保已经安装 Helm。安装指南:Helm

部署

⚠️ 部署前,请添加 存储类名称values.yaml 样例

参考资料:K8S 储存类概念

需要准备一个 storageclass, 或者一个可公共写的 pvc

--set storage.storageClassName=storageclass
or
--set storage.persistentVolumeClaim=pvc
# 克隆存储库
git clone https://github.com/HXSecurity/DongTai.git
cd deploy/kubernetes/helm

# 添加、更新仓库
helm repo add dongtai https://charts.dongtai.io/iast
helm repo update

# 部署示例
helm install project --create-namespace -n dongtai dongtai/dongtai-iast \
--set storage.persistentVolumeClaim=pvc

这个命令将会在 dongtai 命名空间部署 Dongtai IAST Server , 并且使用 ClusterIP 方式暴露服务。

自定义配置

配置
/tmp/my-values.yml
mysql:
host: my-dongtai-mysql
port: 3306
name: my-dongtai_webapi
user: root
password: my-dongtai-iast

redis:
host: my-dongtai-redis
port: 6379
password: 123456
db: 0
helm install project --create-namespace -n dongtai dongtai/dongtai-iast \
--values /tmp/my-values.yaml
  • 也可以使用 --set 来覆盖单个值, 你可以使用 --set 将 ClusterIP 切换成 NodePort:
helm install project --create-namespace -n dongtai dongtai/dongtai-iast \
--set storage.persistentVolumeClaim=pvc \
--set accessType=NodePort --set NodePort=30080
  • 如果你需要修改 somaxconn (128)
helm install project --create-namespace -n dongtai dongtai/dongtai-iast \
--set storage.persistentVolumeClaim=pvc \
--set somaxconn=1024
  • Avaliable values:

    • skipMysql: false (默认值), skipRedis: false (默认值)

    • accessType: ClusterIP(默认值), 可选项: ClusterIP, NodePort, LoadBalancer

    • imageVersion: latest (默认值)

部署后

环境启动成功后,通过部署过程中指定的 web service port 访问即可。

  • 默认账号及密码: admin / admin;

  • 首次登入 必须 修改密码。

    • 系统配置 > 密码修改 修改密码后再重新登入。

卸载

helm uninstall project -n dongtai

扩容

kubectl scale deployments ${deployment-names} --replicas=${number} -n ${your-namespace}

#举例扩容 5 个 dongtai-worker-task:
kubectl scale deployments dongtai-worker-task --replicas=5 -n your-namespace

也可配置自动水平扩容,指南:Pod 水平自动扩缩

kubectl autoscale deployments ${deployment-names} -n ${your-namespace} --cpu-percent=80 --min=${number} --max=${number}
域名访问

需要使用 HTTPS 域名访问的用户, 可通过修改 4.deploy-iast-server.yml 文件,增加如下配置,实现 CSRF 信任域名的配置,如:https://xxx.example.com,配置如下:

[security]
csrf_trust_origins = .example.com
  • 若有多个 HTTPS 域名进行绑定,域名间通过 "," 连接,如:.example.com, .iast.io, .dongtai.io

升级

文件内容{{}}是需要修改的部分

v1.3.1 以前版本升级请参照此升级方式

  1. 备份数据库。

    kubectl exec -n {{namespace}} {{mysql-pod}} -- sh -c 'exec mysqldump --all-databases -uroot -p"dongtai-iast"' > dongtai-mysql-bak-$(date '+%Y-%m-%d').sql
  2. 下载和导入数据库资料,数据库资料可参阅自定义数据库

    只需执行部分增量的 sql 文件,比如:v1.4.0v1.5.0,需导入 v1.4.0 ~ v1.5.0 的 sql 文件。

    kubectl exec -i -n {{namespace}} {{mysql-pod}} -- mysql  -uroot -p"dongtai-iast" dongtai_webapi < *.sql
  3. 仓库拉取最新代码,编辑各个 deployments 组件的镜像版本号。

    a. 使用 DongTai/deploy/latest_image.sh 检查每个组件的镜像最新版本号。

    b. 编辑及执行各个 deployments 组件的镜像版本号:

    kubectl set image deploy dongtai-server       dongtai-server-container=registry.cn-beijing.aliyuncs.com/huoxian_pub/dongtai-server:{{ChangeThisVersion}} -n {{namespace}}
    kubectl set image deploy dongtai-web dongtai-web-container=registry.cn-beijing.aliyuncs.com/huoxian_pub/dongtai-web:{{ChangeThisVersion}} -n {{namespace}}
    kubectl set image deploy dongtai-worker-task dongtai-worker-task-container=registry.cn-beijing.aliyuncs.com/huoxian_pub/dongtai-server:{{ChangeThisVersion}} -n {{namespace}}
    kubectl set image deploy dongtai-worker-beat dongtai-worker-beat-container=registry.cn-beijing.aliyuncs.com/huoxian_pub/dongtai-server:{{ChangeThisVersion}} -n {{namespace}}
    kubectl set image deploy dongtai-worker-other dongtai-worker-other-container=registry.cn-beijing.aliyuncs.com/huoxian_pub/dongtai-server:{{ChangeThisVersion}} -n {{namespace}}
    kubectl set image deploy dongtai-worker-high-freq dongtai-worker-high-freq-container=registry.cn-beijing.aliyuncs.com/huoxian_pub/dongtai-server:{{ChangeThisVersion}} -n {{namespace}}
    kubectl set image deploy dongtai-logrotate dongtai-logrotate-container=registry.cn-beijing.aliyuncs.com/huoxian_pub/dongtai-logrotate:{{ChangeThisVersion}} -n {{namespace}}
    kubectl set image deploy dongtai-logstash dongtai-logstash-container=registry.cn-beijing.aliyuncs.com/huoxian_pub/dongtai-logstash:{{ChangeThisVersion}} -n {{namespace}}