hashicorp/vault-secrets-gateway

HCP本地执行工具镜像文档

镜像概述

该Docker镜像提供了一个客户运行工具，主要功能是允许HCP（HashiCorp Cloud Platform）发送请求并在本地环境中执行这些请求，实现HCP与本地环境的请求交互和任务处理。

核心功能与特性

• HCP请求接收：支持接收来自HCP的任务请求和指令
• 本地执行能力：将HCP发送的请求在本地环境中执行
• 通信机制：与HCP建立安全通信通道，确保请求可靠传输
• 容器化部署：通过Docker容器化封装，简化安装配置流程，提高环境一致性

使用场景与适用范围

• 本地开发测试：在本地开发或测试环境中接收并执行HCP下发的开发任务
• HCP本地集成：需将HCP云服务与本地基础设施进行交互的场景
• 本地任务处理：需要在本地环境执行HCP发送的特定命令或操作的客户场景

使用方法与配置说明

基本启动命令

bash
docker run -d --name hcp-local-exec [镜像名称]

环境变量配置

带环境变量的启动示例

bash
docker run -d --name hcp-local-exec \
  -e HCP_ENDPOINT="https://hcp.example.com" \
  -e LOCAL_EXEC_PATH="/data/exec-tasks" \
  -e LOG_LEVEL="debug" \
  -e REQUEST_TIMEOUT="60" \
  [镜像名称]

数据卷挂载

挂载本地目录以持久化执行结果：

bash
docker run -d --name hcp-local-exec \
  -v /host/path/to/exec:/data/exec-tasks \
  [镜像名称]

Docker Compose配置示例

yaml
version: '3.8'
services:
  hcp-local-exec:
    image: docker.xuanyuan.run/[镜像名称]
    container_name: hcp-local-exec
    restart: unless-stopped
    environment:
      - HCP_ENDPOINT=https://hcp.example.com
      - LOCAL_EXEC_PATH=/data/exec-tasks
      - LOG_LEVEL=info
    volumes:
      - ./local-exec:/data/exec-tasks
    networks:
      - hcp-network

networks:
  hcp-network:
    driver: bridge

注意事项

1. 确保本地环境已配置HCP访问权限（如API密钥、证书等）
2. 本地执行目录需具备适当的读写权限
3. 根据实际需求调整请求超时时间，避免长时间任务被中断