分布式微服务系统架构第128集：elastic-search安装部署

加群联系作者vx：xiaoda0423

仓库地址：https://webvueblog.github.io/JavaPlusDoc/

https://1024bat.cn/

✅ 一、环境准备

• 操作系统：Linux（Ubuntu 20+/CentOS 7+/Rocky）或 macOS

• 内存要求：建议 4GB+（最小 2GB）

• Java：Elasticsearch 7.x+ 内置了 OpenJDK，不需额外安装

• 版本推荐：ES 7.17.x（稳定）或 ES 8.x（安全增强）

✅ 二、单机安装（适合开发）

📦 1. 下载并解压 Elasticsearch

# 官方源下载
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.14-linux-x86_64.tar.gz
tar -zxvf elasticsearch-7.17.14-linux-x86_64.tar.gz
cd elasticsearch-7.17.14

🛠 2. 修改配置文件（config/elasticsearch.yml）

cluster.name: my-es-cluster
node.name: node-1
network.host: 0.0.0.0
http.port: 9200
discovery.seed_hosts: ["127.0.0.1"]
cluster.initial_master_nodes: ["node-1"]

🔧 3. 配置 JVM 内存（可选：config/jvm.options）

-Xms1g
-Xmx1g

设置为系统可用内存一半或略小（避免 OOM）

🚀 4. 启动 Elasticsearch

# 建议用非 root 用户
./bin/elasticsearch

另起窗口测试：

curl http://localhost:9200

✅ 三、集群部署（2~3 节点生产环境）

假设部署两台节点：

• node-1：192.168.1.101

• node-2：192.168.1.102

🧩 配置文件（每台机器修改 config/elasticsearch.yml）

📍 node-1:

cluster.name: my-es-cluster
node.name: node-1
network.host: 192.168.1.101
http.port: 9200
discovery.seed_hosts: ["192.168.1.101", "192.168.1.102"]
cluster.initial_master_nodes: ["node-1", "node-2"]

📍 node-2:

cluster.name: my-es-cluster
node.name: node-2
network.host: 192.168.1.102
http.port: 9200
discovery.seed_hosts: ["192.168.1.101", "192.168.1.102"]
cluster.initial_master_nodes: ["node-1", "node-2"]

🚀 启动两台节点，并验证集群：

curl http://192.168.1.101:9200/_cluster/health?pretty
curl http://192.168.1.101:9200/_cat/nodes?v

返回包含两个节点，则说明集群 OK。

✅ 四、可选增强：安装 Kibana（可视化控制台）

wget https://artifacts.elastic.co/downloads/kibana/kibana-7.17.14-linux-x86_64.tar.gz
tar -zxvf kibana-7.17.14-linux-x86_64.tar.gz
cd kibana-7.17.14/config

# 修改 kibana.yml
server.port: 5601
server.host: "0.0.0.0"
elasticsearch.hosts: ["http://192.168.1.101:9200"]

启动 Kibana：

./bin/kibana

访问地址：http://localhost:5601

✅ 五、常用 Elasticsearch 命令

✅ 六、常见问题

✅ 七、优化建议（生产）

• 设置专用的数据节点、主节点

• 关闭自动索引创建（action.auto_create_index: false）

• 使用 HTTPS 和账号密码（ES 8+ 默认开启安全）

• 配置慢查询日志 + 索引模板

• 安装 IK 分词器 / Pinyin 分词器（中文搜索）

Elasticsearch 安装与部署指南（2025 年版）

适用人群：需要在生产环境（4 核 / 16 GB RAM 以上）构建高可用、可观测的 Elasticsearch 集群的 DevOps / 后端工程师。

1. 版本选择

新集群 建议直接使用 8.x 分支；若与旧版兼容或 Logstash/Beats 仍停留在 7.x，可暂用 7.17 并规划升级。

2. 基础环境要求

系统调优：

# /etc/sysctl.d/99-es.conf
vm.swappiness = 1
vm.max_map_count = 262144
fs.file-max = 2097152
# 生效
sysctl -p /etc/sysctl.d/99-es.conf

# ulimit
* soft nofile 65536
* hard nofile 65536

3. 安装方式对比

生产建议：物理机 / VM 优选 tar.gz + systemd；云原生可使用 Elastic Cloud on K8s (ECK) 。

4. 单节点快速安装（tar.gz）

# 4.1 下载 (以 8.13.2 为例)
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.13.2-linux-x86_64.tar.gz

# 4.2 创建用户与目录
useradd --system --no-create-home --shell /sbin/nologin elasticsearch
mkdir -p /opt/elastic/{data,logs}

# 4.3 解压并软链
tar -xzf elasticsearch-8.13.2-linux-x86_64.tar.gz -C /opt/elastic
ln -s /opt/elastic/elasticsearch-8.13.2 /opt/elastic/current
chown -R elasticsearch:elasticsearch /opt/elastic

# 4.4 修改 elasticsearch.yml
vim /opt/elastic/current/config/elasticsearch.yml
# 关键字段示例
cluster.name: demo-cluster
node.name: node-1
path.data: /opt/elastic/data
path.logs: /opt/elastic/logs
network.host: 0.0.0.0
http.port: 9200
xpack.security.enabled: true
xpack.security.http.ssl:
  enabled: true
  keystore.path: certs/http.p12    # 8.x 安装时会自动生成自签证书 (elastic-certificates.p12)
# 如需关闭 TLS 仅测试：
# xpack.security.transport.ssl.enabled: false

# 4.5 初始化密码（仅 8.x 首次启动）
/opt/elastic/current/bin/elasticsearch-reset-password -u elastic -b

# 4.6 创建 systemd
cat >/etc/systemd/system/elasticsearch.service <<'EOF'
[Unit]
Description=Elasticsearch
Wants=network-online.target
After=network-online.target
LimitNOFILE=65536

[Service]
Type=simple
User=elasticsearch
Group=elasticsearch
ExecStart=/opt/elastic/current/bin/elasticsearch -p /var/run/elasticsearch.pid
Restart=on-failure
TimeoutStopSec=300

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable --now elasticsearch

# 4.7 验证
curl --cacert /opt/elastic/current/config/certs/http_ca.crt -u elastic:＜密码＞ https://localhost:9200

5. 三节点高可用集群部署

5.1 架构规划

• 3 个 master/data 热节点，副本因子 1 (总 2 份数据)

• 需要更多层次可引入 warm/cold/node roles: data_hot, data_warm, data_cold, data_frozen。

5.2 配置示例（node-1）

cluster.name: prod-cluster
node.name: node-1
node.roles: [ master, data_hot ]
network.host: 192.168.10.11
seed_hosts: ["192.168.10.11","192.168.10.12","192.168.10.13"]
cluster.initial_master_nodes: ["node-1","node-2","node-3"]
path.data: /data/es
xpack.security.enabled: true

其余节点修改 node.name 与 network.host 即可。

5.3 TLS 与认证

• bin/elasticsearch-certutil cert --pem --in instance.yml --out certs.zip

• 将生成的 cert 分发到每节点 config/certs，yml 指向对应 p12/PEM。

• 使用 elasticsearch-users 或 Kibana Stack Management → Users/Roles 管理权限。

6. 系统与 JVM 调优

7. 监控与告警

• Elastic Stack：Metricbeat + Filebeat + Kibana Stack Monitoring。

• Prometheus Exporter：prometheus/elasticsearch_exporter → Grafana。

• 关键指标：CPU load, Heap Usage, JVMMemoryPressure, Search/Index Latency, Disk I/O, Segment Count, ClusterHealth。

8. 备份（快照）与恢复

# 创建 S3 仓库示例
PUT _snapshot/s3_repo
{
  "type": "s3",
  "settings": {
    "bucket": "es-backup-prod",
    "endpoint": "s3.ap-southeast-1.amazonaws.com",
    "region": "ap-southeast-1"
  }
}

# 触发每日快照
PUT _snapshot/s3_repo/daily-<date>

恢复：POST _snapshot/s3_repo/snap-2025.05.10/_restore，可指定 index。

9. 常见问题排查

10. 升级路径

• 7.17 → 8.x：滚动升级需启用安全，先升级 Kibana, Logstash，最后 Beats。

• 重大版本前务必全量快照，阅读 Upgrade Guide。

完成！ 如需 ECK Operator、Terraform 自动化部署或具体 ILM/安全脚本示例，请另行告知，我可以继续补充。