vcwc/bash.wrapper

vcwc/bash.wrapper 镜像

镜像概述

vcwc/bash.wrapper是vcwc生态系统下的Bash镜像，集成包装器功能模块，提供命令行标志处理、JSON输出转换、标准化日志记录等工具库，支持API调度和辅助方法，助力脚本开发与执行场景。

核心功能

1. wrapper库
   位置：/vcwc/bin/bash/wrapper
   负责容器初始化，实现命令行标志处理，暴露两个钩子：

   • VCW_PREENTRYPOINT：在entrypoint主逻辑前执行的脚本路径
   • output-to-JSON：将标准输出/错误转换为vcwc包装器JSON格式

2. executionplane库
   位置：/vcwc/bin/bash/executionplane
   为Bash脚本提供JSON格式日志记录功能，日志来源标记为executionplane。

3. .invoke API入口点
   通用API调度入口，将执行请求分发到基础镜像中的API方法脚本，内部实现不可直接通过命令行访问。

4. 辅助方法
   位置：/vcwc/bin/bash
   提供可直接从命令行调用的辅助工具方法。

5. 统一文件夹结构
   所有vcwc相关资产遵循统一目录结构，镜像包含构建仓库作为结构的一部分。

使用场景

• vcwc生态系统内的Bash脚本开发与调试
• 需要标准化JSON日志输出的脚本执行场景
• 命令行工具的包装与API调度需求

配置说明

• 环境变量：VCW_PREENTRYPOINT：指定在entrypoint主逻辑前执行的脚本路径
• 命令行参数：支持wrapper库定义的命令行标志（详见镜像文档）

部署示例

Docker Run

执行辅助方法：

bash
docker run --rm vcwc/bash.wrapper [辅助方法名称]

调用API入口：

bash
docker run --rm vcwc/bash.wrapper .invoke [API方法]

Docker Compose

yaml
version: '3'
services:
  bash-wrapper:
    image: vcwc/bash.wrapper
    command: [".invoke", "目标API方法"]
    environment:
      - VCW_PREENTRYPOINT=/path/to/pre-entrypoint.sh