launchdarkly/ldcli

镜像概述

该Docker镜像是LaunchDarkly提供的官方命令行界面（CLI）工具，用于管理LaunchDarkly功能标志。LaunchDarkly是一款功能管理平台，允许团队通过功能标志（Feature Flags）动态控制应用功能的发布与下线。本镜像将CLI工具容器化，使用户无需在本地系统安装依赖，即可在容器环境中便捷地与LaunchDarkly平台交互，实现功能标志的全生命周期管理。

核心功能和特性

• 功能标志管理：支持创建、查看、更新、删除功能标志，配置标志状态（启用/禁用）、默认规则及用户细分。
• 环境与项目管理：管理LaunchDarkly项目及环境，包括环境变量配置、访问权限设置等。
• 用户细分管理：配置用户群体细分规则，实现功能的定向发布与灰度测试。
• 数据导出与报告：支持导出功能标志使用数据及性能指标，生成管理报告。
• 官方兼容性：与LaunchDarkly API完全兼容，支持平台最新功能，确保工具与服务同步更新。
• 容器化优势：无需本地安装依赖，支持跨环境版本一致性，便于集成到容器化工作流。

使用场景和适用范围

• 容器化开发环境：开发人员在Docker/Kubernetes环境中管理功能标志，避免本地工具版本冲突。
• CI/CD流程集成：在自动化部署流程（如GitHub Actions、Jenkins）中集成，实现功能标志的自动控制。
• 多环境统一管理：在开发、测试、生产等环境中使用统一工具，确保功能标志配置一致性。
• 批量操作与自动化：通过脚本调用CLI执行批量功能标志更新、环境配置同步等操作。
• 安全权限控制：通过容器环境变量注入API令牌，避免敏感信息本地存储。

使用方法和配置说明

前提条件

• 拥有有效的LaunchDarkly账户及API令牌（需具备write或admin权限）。
• 已安装Docker引擎。

拉取镜像

从Docker Hub拉取最新版本：

bash
docker pull launchdarkly/cli:latest

指定版本（如v1.2.3）：

bash
docker pull launchdarkly/cli:v1.2.3

基本使用命令

通过环境变量传入API令牌并执行操作，基本格式：

bash
docker run --rm -e LD_API_TOKEN=<your-api-token> launchdarkly/cli <command> [arguments]

• --rm：容器退出后自动删除
• <your-api-token>：替换为实际API令牌（在LaunchDarkly控制台“账户设置 > 授权”中获取）
• <command>：CLI命令（如flag、env、segment等）

常用命令示例

列出功能标志

bash
docker run --rm -e LD_API_TOKEN=your-token launchdarkly/cli flag list --env=production

创建功能标志

bash
docker run --rm -e LD_API_TOKEN=your-token launchdarkly/cli flag create \
  --project=my-project \
  --env=development \
  --key=checkout-v2 \
  --name="Checkout V2" \
  --description="New checkout flow" \
  --type=boolean \
  --default=false

更新功能标志状态

bash
docker run --rm -e LD_API_TOKEN=your-token launchdarkly/cli flag update \
  --project=my-project \
  --env=production \
  --key=checkout-v2 \
  --on=true

环境变量说明

注意事项

• API令牌需通过容器编排工具（如Kubernetes Secrets）安全注入，避免明文暴露。
• 敏感操作前建议备份配置，或在非生产环境测试。
• 如需持久化配置，可挂载本地目录到容器/root/.launchdarkly路径：

bash
docker run --rm -e LD_API_TOKEN=your-token -v ~/.launchdarkly:/root/.launchdarkly launchdarkly/cli config set default-project my-project