NoSQL 与搜索 / 系统课时
Docker 启动单节点环境
Docker 启动单节点环境
本课使用 Docker Compose 启动一个可重复创建的 Elasticsearch 单节点环境,配置固定镜像版本、持久化数据卷、容器内存上限和本地开发安全选项,并通过集群健康接口完成验收。
学习目标
- 编写可直接运行的单节点 Compose 配置
- 理解数据卷、内存限制和安全开关的作用
- 启动容器并验证 Elasticsearch HTTP 服务
完成前置检查
确认 Docker 正常运行,并检查本机 9200 端口没有被其他服务占用。
docker info --format '{{.ServerVersion}}'
docker ps --filter publish=9200预期输出
<DOCKER_VERSION>
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES第二条命令只有表头表示当前没有运行中的容器占用映射端口。若已有 Elasticsearch 容器,应先停止旧容器,或在本课配置中改用其他宿主机端口。
编写 Compose 配置
新建空目录,在其中创建 compose.yaml。下面的配置只用于本地学习:它关闭身份认证和 TLS,不得直接作为公网或生产环境配置。
services:
elasticsearch:
image: docker.elastic.co/elasticsearch/elasticsearch:9.4.4
container_name: es01
environment:
- discovery.type=single-node
- xpack.security.enabled=false
ports:
- "9200:9200"
volumes:
- esdata:/usr/share/elasticsearch/data
mem_limit: 2g
restart: unless-stopped
volumes:
esdata:生效行为与验证方法:discovery.type=single-node 跳过多节点发现;命名卷 esdata 保存索引数据;mem_limit 将容器内存限制为 2 GB,Elasticsearch 会根据可用资源自动计算 JVM 堆大小,官方通常建议保留自动 sizing。:contentReference[oaicite:5]{index=5}
xpack.security.enabled=false 让本地请求无需账号、密码和证书。它便于课程跟做,但会失去访问控制与传输保护;生产环境必须重新启用安全能力。
启动并观察日志
在 compose.yaml 所在目录执行启动命令,然后查看容器状态。
docker compose up -d
docker compose ps
docker compose logs --tail=50 elasticsearch预期输出
[+] Running 2/2
✔ Volume "<PROJECT>_esdata" Created
✔ Container es01 Started
NAME IMAGE STATUS
es01 docker.elastic.co/elasticsearch/elasticsearch:9.4.4 Up <TIME>
...
"message":"started"项目名、时间和日志前缀会因目录及 Docker 版本不同而变化。只要容器保持 Up,日志中没有持续重启或致命异常,就可以继续验证接口。
验证节点和集群健康
先查询根接口确认版本,再查询集群健康状态。
curl http://localhost:9200
curl "http://localhost:9200/_cluster/health?pretty"预期输出
{
"name": "es01",
"cluster_name": "docker-cluster",
"version": {
"number": "9.4.4"
},
"tagline": "You Know, for Search"
}
{
"cluster_name": "docker-cluster",
"status": "green",
"number_of_nodes": 1,
"number_of_data_nodes": 1
}响应还会包含构建信息、分片统计等字段,这里只保留验收所需字段。单节点且尚未创建业务索引时通常为 green;后续索引若保留副本,也可能出现 yellow,需要结合分片信息判断。
处理典型启动失败
若日志出现 vm.max_map_count 过低,Linux 主机可先查看当前值,再临时调整为 1048576。Elasticsearch 使用内存映射文件,值过低可能导致节点启动失败或内存异常。:contentReference[oaicite:6]{index=6}
sysctl vm.max_map_count
sudo sysctl -w vm.max_map_count=1048576
docker compose restart elasticsearch预期输出
vm.max_map_count = <CURRENT_VALUE>
vm.max_map_count = 1048576
[+] Restarting 1/1
✔ Container es01 Started若容器因内存不足被终止,应提高 Docker Desktop 的可用内存,或关闭其他占用较大的容器。不要仅通过无限增大 JVM 堆解决问题,因为 Elasticsearch 还需要堆外内存和文件系统缓存。
停止与清理
普通停止会保留命名卷,再次启动后数据仍在;添加 -v 才会同时删除数据卷。
docker compose down
docker compose up -d预期输出
[+] Running 1/1
✔ Container es01 Removed
[+] Running 1/1
✔ Container es01 Started需要彻底重置实验数据时再执行 docker compose down -v。该操作不可恢复,因此不要在仍需保留索引时使用。
本课总结
- 固定版本镜像、单节点发现和命名卷组成了可重复使用的本地环境
- 2 GB 容器限制适合基础练习,安全关闭仅限本机学习
- 通过容器状态、启动日志、根接口和集群健康接口可完成四层验证
下一课预告
下一课将通过 REST API 创建索引、写入文档并执行第一次查询,建立 Elasticsearch 基础操作闭环。