checkpoint/cp-nano-k8s-artifacts-server

Nano代理容器

镜像概述

Nano代理容器是一款轻量级的本地制品提供工具，主要功能是在本地环境中分发、缓存或直接提供所需的各类制品（如依赖包、配置文件、二进制文件等）。该容器设计为"纳米级"轻量形态，旨在解决开发、测试或部署过程中对远程制品仓库的依赖问题，通过本地提供制品提升资源获取效率、降低网络依赖，并简化环境配置流程。

核心功能与特性

• 轻量级设计：采用极简架构，镜像体积小，启动速度快，资源占用低，适合在资源受限环境中部署。
• 本地制品管理：支持在本地存储、组织和提供各类制品，无需依赖远程仓库，确保离线或弱网络环境下的可用性。
• 制品缓存能力：可缓存常用制品，避免重复下载，加速开发或构建流程。
• 简化依赖管理：统一管理本地所需制品，减少因远程依赖变更或不可用导致的环境问题。
• 跨平台兼容：支持主流操作系统架构（如x86_64、ARM），可在Docker支持的各类环境中运行。

使用场景与适用范围

• 开发环境依赖管理：在本地开发过程中，为项目提供所需的依赖制品，避免频繁访问远程仓库。
• CI/CD流水线加速：在CI/CD流程中作为本地制品缓存节点，加速构建、测试环节的制品获取速度。
• 网络受限环境部署：在无网络或网络带宽有限的环境中，确保应用部署所需的制品可本地获取。
• 离线测试环境搭建：为离线测试环境提供必要的测试制品或配置文件，保障测试流程独立运行。

使用方法与配置说明

基本部署示例

Docker Run 命令

bash
docker run -d \
  --name nano-agent \
  -v /path/to/local/artifacts:/app/artifacts \  # 挂载本地目录作为制品存储路径
  -p 8080:8080 \  # 映射服务端口（若需通过HTTP访问制品）
  -e ARTIFACT_ROOT=/app/artifacts \  # 指定容器内制品根目录
  -e LOG_LEVEL=info \  # 设置日志级别（debug/info/warn/error）
  your-registry/nano-agent:latest

参数说明

基本使用流程

1. 准备本地制品目录：在宿主机创建本地制品目录（如/path/to/local/artifacts），并将所需制品放入该目录。
2. 启动容器：使用上述docker run命令启动容器，确保本地目录正确挂载。
3. 访问制品：根据配置的端口和路径，通过本地网络或容器内路径访问制品。例如，若挂载了/path/to/local/artifacts且包含demo.jar，则可通过http://localhost:8080/demo.jar（若启用HTTP服务）或容器内路径/app/artifacts/demo.jar访问。

高级配置（可选）

启用HTTP服务

若需通过HTTP协议对外提供制品访问，可添加环境变量ENABLE_HTTP=true：

bash
docker run -d \
  --name nano-agent \
  -v /path/to/local/artifacts:/app/artifacts \
  -p 8080:8080 \
  -e ARTIFACT_ROOT=/app/artifacts \
  -e ENABLE_HTTP=true \
  your-registry/nano-agent:latest

自定义缓存策略

通过CACHE_POLICY环境变量设置缓存策略（如overwrite覆盖旧制品、skip跳过已存在制品）：

bash
-e CACHE_POLICY=overwrite

注意事项

• 本地制品目录需确保有足够的读写权限，避免容器访问权限问题。
• 若需持久化存储制品，务必通过-v参数挂载宿主机目录，避免容器重启后制品丢失。
• 在生产环境中，建议配合容器编排工具（如Docker Compose、Kubernetes）进行部署，以提高可用性和可维护性。