使用 Docker Compose 简化 INFINI Console 与 Easysearch 环境搭建

前言回顾

在上一篇文章《搭建持久化的 INFINI Console 与 Easysearch 容器环境》中，我们详细介绍了如何使用基础的 docker run 命令，手动启动和配置 INFINI Console (1.29.6) 和 INFINI Easysearch (1.13.0) 容器，并实现了关键数据的持久化，解决了重启后配置丢失的问题。

手动操作虽然能让我们深入理解 Docker 的核心机制，但在管理多个容器、网络和卷时，命令会变得冗长且容易出错。这时，Docker Compose 就派上了用场。它允许我们使用一个 YAML 文件来定义和运行多容器 Docker 应用程序。

本篇文章将演示如何将上一篇的手动步骤转换为使用 Docker Compose，让你更轻松地管理和维护这套本地开发测试环境。

Docker Compose 的优势

使用 Docker Compose 带来了诸多好处：

• 声明式配置：在一个 docker-compose.yml 文件中定义所有服务、网络和卷，清晰明了。

• 一键式管理：使用简单的命令（如 docker compose up, docker compose down）即可启动、停止和重建整个应用环境。

• 简化网络和服务连接：Compose 会自动处理服务间的网络设置和依赖关系。

• 易于共享和版本控制：docker-compose.yml 文件可以轻松地与团队共享并通过版本控制系统（如 Git）进行管理。

准备工作

与上一篇类似，你需要：

• 操作系统: macOS (本文示例)

• Docker 环境: OrbStack (https://orbstack.dev/) 或 Docker Desktop for Mac。

• 确保 Docker Compose V2 (docker compose) 或 V1 (docker-compose) 已安装并可用。

查看 docker compose 版本

docker compose versionDocker Compose version v2.24.5

步骤一：项目目录结构

我们将继续使用上一篇文章中创建的目录结构。如果你还没有创建，或者想重新开始，可以在你的项目根目录（例如 ~/infini_compose_lab）下创建如下结构：

# 1. 创建项目根目录mkdir -p ~/infini_compose_labcd ~/infini_compose_lab
# 2. 为 Console 和 Easysearch 创建持久化子目录# 这些目录将用于存储配置、数据和日志mkdir -p console/config console/data console/logsmkdir -p easysearch/config easysearch/data easysearch/logs

步骤二：提取初始配置文件

这一步与上一篇完全相同。你在首次启动时使用从镜像中提取的默认配置，请执行以下操作。如果这些目录中已存在配置文件（例如从上一篇博客的操作中保留下来的），Docker Compose 在挂载时会直接使用它们。

1. INFINI Console (1.29.6) 初始配置(容器内配置路径: /config)

# 确保在 ~/infini_compose_lab 目录下docker pull infinilabs/console:1.29.6docker run --rm \-v $PWD/console/config:/temp_host_config \infinilabs/console:1.29.6 \sh -c "cp -a /config/. /temp_host_config/ && chmod -R ugo+rw /temp_host_config/"

2. INFINI Easysearch (1.13.0) 初始配置(容器内配置路径: /app/easysearch/config，初始密码: INFINILabs01)

重要提示：请务必为 Easysearch 设置安全的密码。

# 确保在 ~/infini_compose_lab 目录下docker pull infinilabs/easysearch:1.13.0docker run --rm \-e EASYSEARCH_INITIAL_ADMIN_PASSWORD="INFINILabs01" \-v $PWD/easysearch/config:/temp_host_config \infinilabs/easysearch:1.13.0 \sh -c "cp -a /app/easysearch/config/. /temp_host_config/ && chmod -R ugo+rw /temp_host_config/"

步骤三：创建 docker-compose.yml 文件

这是核心步骤。在你的项目根目录 ~/infini_compose_lab 下，创建一个名为 docker-compose.yml 的文件，并填入以下内容。这个文件定义了我们的服务、它们如何运行以及它们如何交互。

cat <<EOF > docker-compose.ymlservices:  easysearch:    image: infinilabs/easysearch:1.13.0    container_name: infini-easysearch    environment:      - cluster.name=infini_compose_cluster      - node.name=node-01      - cluster.initial_master_nodes=node-01      - "ES_JAVA_OPTS=-Xms1g -Xmx1g"      - EASYSEARCH_INITIAL_ADMIN_PASSWORD=INFINILabs01    ports:      - "9200:9200"      - "9300:9300"    volumes:      - ./easysearch/config:/app/easysearch/config      - ./easysearch/data:/app/easysearch/data      - ./easysearch/logs:/app/easysearch/logs    ulimits:      memlock: {soft: -1, hard: -1}      nofile: {soft: 65536, hard: 65536}    networks:      - infini_app_net
  console:    image: infinilabs/console:1.29.6    container_name: infini-console    ports:      - "9000:9000"    volumes:      - ./console/config:/config      - ./console/data:/data      - ./console/logs:/log    networks:      - infini_app_net
networks:  infini_app_net:    driver: bridgeEOF

docker-compose.yml 文件关键点：

• services: 定义了 easysearch 和 console 两个服务。

• image: 指定了每个服务使用的 Docker 镜像和版本。

• container_name: 为容器指定一个易于识别的名称。

• environment: 设置容器的环境变量。

• Easysearch 单节点配置: 注意 cluster.initial_master_nodes 设置为节点自身的名称。

• ports: 将容器的端口映射到宿主机的端口。

• volumes: 实现持久化的核心。将宿主机当前目录 (./) 下的 console/* 和 easysearch/* 子目录分别映射到容器内对应的路径。

• networks: 将两个服务都连接到我们定义的 infini_app_net 网络。这使得 console 服务可以通过服务名 easysearch (例如 https://easysearch:9200) 来访问 easysearch 服务。

步骤四：使用 Docker Compose 启动环境

现在，所有配置都在 docker-compose.yml 文件中了。启动整个环境只需要一条命令。在 ~/infini_compose_lab 目录下（包含 docker-compose.yml 文件），执行：

docker compose up -d

• docker compose (V2) 或 docker-compose (V1)。

• up: 创建并启动在 docker-compose.yml 中定义的所有服务。

• -d: 后台模式运行。

首次运行时，如果本地没有对应的镜像，Docker Compose 会自动拉取。

常用 Docker Compose 命令：

• 查看服务状态：

docker compose ps

• 查看所有服务的实时日志：

docker compose logs -f

• 查看特定服务的日志：

docker compose logs -f consoledocker compose logs -f easysearch

• 停止所有服务（保留数据）：

docker compose stop

• 停止并移除所有容器、网络和匿名卷（保留通过 volumes 映射的本地数据）：

docker compose down

步骤五：验证和使用

1. 访问 Console: 浏览器打开 http://localhost:9000。

2. 进行配置: 在 Console 中连接 Easysearch (https://easysearch:9200，因为它们在同一个 Docker 网络中，可以直接使用服务名)，创建用户，查看监控等。

3. 测试持久化:

docker compose down # 停止并移除容器# 稍等片刻docker compose up -d # 重新启动

再次访问 http://localhost:9000，你会发现之前的配置都还在！

操作截图

彻底清理，包括删除命名卷（如果使用了的话）和本地数据(可选)

# -v 移除命名卷docker compose down -v# 然后手动删除本地持久化目录rm -rf ~/infini_compose_lab/consolerm -rf ~/infini_compose_lab/easysearch

总结

通过 Docker Compose，我们用一个简洁的 docker-compose.yml 文件取代了之前冗长的 docker run 命令，极大地简化了 INFINI Console 和 Easysearch 本地环境的搭建和管理过程。同时，通过正确的卷挂载配置，我们依然确保了数据的持久化，解决了重启后配置丢失的问题。

对于开发、测试和快速原型验证，Docker Compose 无疑是一个强大而高效的工具。希望本教程能帮助你更轻松地使用 INFINI Console 进行本地实验和开发！