Argus Repository 镜像文档

镜像概述

Argus Repository镜像是专为Argus项目设计的仓库组件，旨在提供标准化的存储解决方案，用于集中管理Argus系统运行所需的配置文件、数据资源、插件及依赖组件。通过该镜像，可确保Argus在不同环境中部署时的资源一致性，简化配置管理流程，提升系统部署效率。

核心功能与特性

• 集中化资源存储：统一管理Argus的配置文件（如argus.conf）、数据模板及插件包，避免分散存储导致的版本混乱。
• 环境一致性保障：通过镜像固化资源版本，确保开发、测试、生产环境使用相同的基础资源，减少"环境不一致"问题。
• 轻量级设计：基于Alpine Linux构建，镜像体积小，启动速度快，资源占用低。
• 易于集成：支持与Argus主程序容器通过Docker网络或卷挂载方式联动，无缝对接Argus系统工作流。

使用场景

• Argus系统部署：作为Argus部署架构的基础组件，提供必备资源支持。
• 开发环境搭建：供开发人员快速获取标准化的Argus资源，统一开发配置。
• 多环境同步：在测试、预发、生产环境间同步Argus资源，确保功能验证一致性。
• 资源版本控制：通过镜像标签管理不同版本的资源集合，支持版本回滚与升级。

使用方法

基本运行命令

通过docker run启动仓库容器，默认将资源存储于容器内/argus/repo目录：

bash
docker run -d --name argus-repo -p 8080:8080 argus/repository:latest

数据持久化配置

为避免容器重启导致资源丢失，建议通过卷挂载将资源目录映射至宿主机：

bash
docker run -d --name argus-repo \
  -p 8080:8080 \
  -v /host/path/to/argus-repo:/argus/repo \
  argus/repository:latest

说明：/host/path/to/argus-repo为宿主机本地目录，需提前创建并赋予读写权限。

自定义配置

通过环境变量调整仓库行为，常用参数如下：

示例：启用只读模式并修改服务端口

bash
docker run -d --name argus-repo \
  -e REPO_PORT=9000 \
  -e READ_ONLY=true \
  -p 9000:9000 \
  -v /host/path/to/argus-repo:/argus/repo \
  argus/repository:latest

配置说明

目录结构

容器内默认资源目录结构如下：

/argus/repo/
├── configs/       # Argus配置文件目录
├── plugins/       # 插件存放目录
├── templates/     # 数据模板目录
└── versions/      # 资源版本记录文件

可通过宿主机挂载目录自定义该结构，或在启动后通过docker exec命令调整。

访问仓库资源

启动容器后，可通过以下方式访问资源：

• 本地访问：通过容器内路径/argus/repo直接读取（适用于联动容器）。
• 网络访问：通过http://<容器IP>:<REPO_PORT>访问资源列表（需确保端口映射正确）。

注意事项

• 宿主机挂载目录需确保权限充足（建议设置权限为755，属主root）。
• 生产环境建议通过docker-compose或Kubernetes编排，配合持久化存储（如PVC）使用。
• 资源更新后需重启容器或通过仓库API触发缓存刷新（若启用缓存）。