Aeternity Docker镜像文档

1. 镜像概述

Aeternity Docker镜像是一个预配置的运行环境，集成了Aeternity基础设施所需的工具链，旨在简化基础设施命令的执行流程。该镜像通过预构建工具链确保环境一致性，减少依赖配置复杂度，支持快速部署和运行Aeternity相关基础设施操作。

2. 核心功能与特性

• 预构建工具链：集成Aeternity基础设施管理所需的核心工具（如节点管理工具、网络配置工具、数据同步工具等），无需手动安装依赖。
• 环境一致性：标准化运行环境，避免因系统差异导致的工具版本冲突或配置错误。
• 轻量级设计：基于精简基础镜像构建，最小化镜像体积，提升部署效率。
• 灵活可扩展：支持通过环境变量、挂载卷等方式自定义配置，适应不同场景需求。

3. 使用场景与适用范围

• 开发环境：供开发人员本地执行Aeternity基础设施相关命令（如节点启动、配置验证等），无需手动搭建工具链。
• 测试环境：在自动化测试流程中快速部署临时基础设施，验证命令执行结果或配置有效性。
• CI/CD流程：集成到持续集成/部署管道，自动执行基础设施部署、更新或验证命令。
• 生产环境辅助：作为生产环境基础设施运维的辅助工具，执行配置检查、数据备份等非核心命令（需结合安全策略使用）。

4. 使用方法与配置说明

4.1 前提条件

• 已安装Docker Engine（推荐版本20.10+），并确保Docker服务正常运行。
• 若需持久化数据或挂载配置文件，需提前准备本地目录（如./config、./data）。

4.2 获取镜像

通过Docker Hub或私有仓库拉取镜像（假设镜像名为aeternity/infrastructure-toolchain，具体以实际仓库为准）：

docker pull aeternity/infrastructure-toolchain:latest

如需指定版本，将:latest替换为具体版本标签（如:v1.0.0）。

4.3 基本运行命令

4.3.1 执行基础设施命令

通过docker run命令启动容器并直接执行基础设施命令，格式如下：

docker run --rm aeternity/infrastructure-toolchain:latest [基础设施命令] [命令参数]

示例：执行节点状态检查命令

docker run --rm aeternity/infrastructure-toolchain:latest aeternity-node check-status --network testnet

4.3.2 交互式运行

如需进入容器交互式环境（如调试或手动执行多步命令），可添加-it参数：

docker run -it --rm aeternity/infrastructure-toolchain:latest /bin/bash

4.4 环境变量配置

通过-e参数传递环境变量，自定义工具链行为。常用环境变量说明如下：

示例：指定主网环境并开启调试日志

docker run --rm -e AE_NETWORK=mainnet -e AE_LOG_LEVEL=debug aeternity/infrastructure-toolchain:latest aeternity-node start

4.5 数据持久化与文件挂载

如需读取本地配置文件或持久化命令执行结果，可通过-v参数挂载本地目录到容器内指定路径：

4.5.1 挂载配置文件

将本地配置目录（如./local-config）挂载到容器默认配置路径/etc/aeternity：

docker run --rm -v $(pwd)/local-config:/etc/aeternity aeternity/infrastructure-toolchain:latest aeternity-node apply-config

4.5.2 持久化命令输出

将容器内命令输出目录（如/output）挂载到本地./results，保存执行结果：

docker run --rm -v $(pwd)/results:/output aeternity/infrastructure-toolchain:latest aeternity-node export-data --output /output/data.json

4.6 Docker Compose配置示例

如需管理多容器依赖或固定配置，可使用docker-compose.yml定义服务。以下为基础示例：

version: "3.8"
services:
  aeternity-tool:
    image: aeternity/infrastructure-toolchain:latest
    environment:
      - AE_NETWORK=testnet
      - AE_LOG_LEVEL=info
    volumes:
      - ./local-config:/etc/aeternity  # 挂载本地配置
      - ./results:/output             # 持久化输出结果
    command: ["aeternity-node", "start", "--config", "/etc/aeternity/node.toml"]

启动服务：

docker-compose up

5. 注意事项

• 权限控制：容器默认以非root用户运行，挂载本地目录时需确保本地目录权限允许容器用户访问（可通过-u参数指定用户ID）。
• 版本选择：生产环境建议使用固定版本标签（如:v1.0.0），避免latest标签自动更新导致兼容性问题。
• 网络配置：若命令需访问外部网络（如节点同步），无需额外配置（容器默认使用桥接网络）；如需指定网络，可通过--network参数绑定自定义Docker网络。
• 命令文档：具体基础设施命令及参数说明，可通过容器内--help选项查看（如docker run --rm aeternity/infrastructure-toolchain:latest aeternity-node --help）。