NoSQL 与搜索 / 系统课时

Docker 启动单节点环境

Docker 启动单节点环境

本课使用 Docker Compose 启动一个可重复创建的 Elasticsearch 单节点环境,配置固定镜像版本、持久化数据卷、容器内存上限和本地开发安全选项,并通过集群健康接口完成验收。

学习目标

  • 编写可直接运行的单节点 Compose 配置
  • 理解数据卷、内存限制和安全开关的作用
  • 启动容器并验证 Elasticsearch HTTP 服务

完成前置检查

确认 Docker 正常运行,并检查本机 9200 端口没有被其他服务占用。

bash
docker info --format '{{.ServerVersion}}'
docker ps --filter publish=9200

预期输出

text
<DOCKER_VERSION>
CONTAINER ID   IMAGE   COMMAND   CREATED   STATUS   PORTS   NAMES

第二条命令只有表头表示当前没有运行中的容器占用映射端口。若已有 Elasticsearch 容器,应先停止旧容器,或在本课配置中改用其他宿主机端口。

编写 Compose 配置

新建空目录,在其中创建 compose.yaml。下面的配置只用于本地学习:它关闭身份认证和 TLS,不得直接作为公网或生产环境配置。

yaml
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 所在目录执行启动命令,然后查看容器状态。

bash
docker compose up -d
docker compose ps
docker compose logs --tail=50 elasticsearch

预期输出

text
[+] 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,日志中没有持续重启或致命异常,就可以继续验证接口。

验证节点和集群健康

先查询根接口确认版本,再查询集群健康状态。

bash
curl http://localhost:9200
curl "http://localhost:9200/_cluster/health?pretty"

预期输出

json
{
  "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}

bash
sysctl vm.max_map_count
sudo sysctl -w vm.max_map_count=1048576
docker compose restart elasticsearch

预期输出

text
vm.max_map_count = <CURRENT_VALUE>
vm.max_map_count = 1048576
[+] Restarting 1/1
 ✔ Container es01  Started

若容器因内存不足被终止,应提高 Docker Desktop 的可用内存,或关闭其他占用较大的容器。不要仅通过无限增大 JVM 堆解决问题,因为 Elasticsearch 还需要堆外内存和文件系统缓存。

停止与清理

普通停止会保留命名卷,再次启动后数据仍在;添加 -v 才会同时删除数据卷。

bash
docker compose down
docker compose up -d

预期输出

text
[+] Running 1/1
 ✔ Container es01  Removed
[+] Running 1/1
 ✔ Container es01  Started

需要彻底重置实验数据时再执行 docker compose down -v。该操作不可恢复,因此不要在仍需保留索引时使用。

本课总结

  • 固定版本镜像、单节点发现和命名卷组成了可重复使用的本地环境
  • 2 GB 容器限制适合基础练习,安全关闭仅限本机学习
  • 通过容器状态、启动日志、根接口和集群健康接口可完成四层验证

下一课预告

下一课将通过 REST API 创建索引、写入文档并执行第一次查询,建立 Elasticsearch 基础操作闭环。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Docker 启动单节点环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通