replicated/vendor-cli

Replicated CLI Docker镜像文档

镜像概述

本镜像包含Replicated CLI工具，源自https://github.com/replicatedhq/replicated%E9%A1%B9%E7%9B%AE%E3%80%82Replicated CLI是用于管理Replicated应用分发的命令行工具，支持应用打包、版本控制、分发渠道配置等核心功能，适用于容器化环境中快速集成Replicated工具链。

核心功能与特性

• 内置Replicated CLI：无需本地安装，直接通过Docker容器使用完整的Replicated CLI命令集
• 应用生命周期管理：支持创建应用、管理版本、打包应用规范（YAML/JSON格式）
• 分发渠道配置：提供渠道创建、版本推送、用户授权等分发管理功能
• 轻量级设计：基于精简基础镜像，减少资源占用，快速启动执行命令

使用场景

• 开发环境集成：开发人员在本地Docker环境中使用Replicated CLI，避免系统依赖冲突
• CI/CD流水线：在自动化流程中嵌入CLI命令，实现应用版本自动打包与推送
• 运维管理：运维人员通过容器化方式临时执行Replicated平台操作，无需持久化安装

使用方法与配置说明

基本使用

通过docker run命令直接执行Replicated CLI命令，基础语法：

bash
docker run --rm [OPTIONS] replicated-cli:latest replicated [COMMAND] [ARG...]

示例：

bash
# 查看CLI版本信息
docker run --rm replicated-cli:latest replicated --version

# 获取命令帮助
docker run --rm replicated-cli:latest replicated --help

持久化配置

Replicated CLI配置（如认证信息、默认应用设置）默认存储在/root/.replicated目录。如需持久化配置，可通过挂载本地目录实现：

bash
# 登录Replicated平台并保存认证信息至本地
docker run --rm -v ~/.replicated:/root/.replicated replicated-cli:latest replicated login

# 使用持久化配置执行后续命令（无需重复登录）
docker run --rm -v ~/.replicated:/root/.replicated replicated-cli:latest replicated app list

与Replicated平台交互

执行需要访问Replicated平台的命令时，需通过API令牌认证。可通过环境变量或配置文件传递：

bash
# 通过环境变量设置API令牌
docker run --rm -e REPLICATED_API_TOKEN=<your-api-token> replicated-cli:latest replicated app create my-application

# 通过挂载配置文件使用令牌（配置文件路径：/root/.replicated/config.yaml）
docker run --rm -v ~/.replicated:/root/.replicated replicated-cli:latest replicated release create --app my-app-slug --yaml ./app.yaml

常用命令示例

• 创建应用：

  bash
  docker run --rm -e REPLICATED_API_TOKEN=<token> replicated-cli:latest replicated app create "My Application"
  

• 上传应用版本：

  bash
  docker run --rm -v $(pwd):/workspace -e REPLICATED_API_TOKEN=<token> replicated-cli:latest replicated release create --app my-app-slug --yaml /workspace/app-v1.yaml
  

• 管理分发渠道：

  bash
  docker run --rm -e REPLICATED_API_TOKEN=<token> replicated-cli:latest replicated channel create "Beta Channel" --app my-app-slug
  

注意事项

• 版本兼容性：需确保镜像中Replicated CLI版本与目标Replicated平台版本匹配（可通过replicated version命令验证）
• 敏感信息安全：API令牌等敏感数据建议通过环境变量或安全挂载传递，避免直接嵌入命令行
• 文件权限：挂载本地目录时需确保容器对挂载目录有读写权限（可通过-u $(id -u):$(id -g)指定用户ID）