ansibleplaybookbundle/es-apb

Elasticsearch APB

此Ansible Playbook Bundle（APB）用于部署Elasticsearch集群，并集成elasticsearch-cloud-kubernetes插件实现服务发现，部署方式基于StatefulSet。

核心功能

• 支持两种部署计划：
  • 临时计划：无持久化存储，重启后Elasticsearch数据将丢失
  • 持久化计划：为每个Elasticsearch实例创建持久卷声明（PVC）
• 可配置集群参数，如集群大小、内存限制、PVC大小等
• 自动创建所需的ServiceAccount和RoleBinding，满足插件的权限需求

使用场景

适用于Kubernetes环境下需要部署Elasticsearch集群的场景，例如：

• 日志存储与分析系统
• 全文搜索服务
• 数据索引与检索平台

配置说明

以下是主要配置参数：

• cluster_size：部署的Elasticsearch实例数量，默认值为1
• application_name：Elasticsearch集群名称，将作为所有部署对象的前缀，默认值为"elasticsearch"
• es_memory_limit：Elasticsearch容器的内存限制，其中一半将分配给Elasticsearch堆内存，默认值为512Mi
• es_pvc_size：每个持久卷声明的大小（仅适用于持久化计划），默认值为1Gi
• es_version：下拉选择要部署的Elasticsearch版本

Ansible Service Broker 要求

elasticsearch-cloud-kubernetes插件需要具备查看项目endpoints的权限，APB在provisioning过程中会创建对应的ServiceAccount和RoleBinding。为使APB使用的ServiceAccount能够创建RoleBinding，Ansible Service Broker需配置sandbox_role: "admin"，示例配置如下：

openshift:
  host: ""
  ca_file: ""
  bearer_token_file: ""
  image_pull_policy: "IfNotPresent"
  sandbox_role: "admin"
  namespace: ansible-service-broker

主机要求

需设置系统参数vm.max_map_count：

bash
sudo sysctl -w vm.max_map_count=262144

部署示例

使用APB工具部署持久化计划的Elasticsearch集群（需提前安装ansible-playbook-bundle工具）：

bash
apb run ansibleplaybookbundle/es-apb --plan persistent --params '{"cluster_size":3, "es_memory_limit":"2Gi", "es_pvc_size":"5Gi"}'