astronomerinc/ap-cli-install

Astronomer CLI 安装引导工具镜像

镜像概述

Astronomer CLI 安装引导工具镜像是一个实用服务镜像，主要功能是简化Astronomer CLI的安装与初始化流程。Astronomer CLI是管理Astronomer工作流平台（如Apache Airflow部署、数据管道编排等）的核心命令行工具，本镜像通过自动化流程帮助用户快速配置可用的Astronomer CLI环境。

核心功能与特性

• 自动化安装流程：一键完成Astronomer CLI的下载、校验及系统路径配置，无需手动执行复杂安装步骤
• 版本控制支持：可指定Astronomer CLI版本，确保与目标环境版本兼容
• 环境初始化引导：自动完成CLI配置初始化，包括工作空间设置、认证配置等基础环境参数
• 轻量级设计：基于精简基础镜像构建，资源占用低，适合开发环境与自动化流程集成

使用场景与适用范围

适用场景

• 开发环境快速搭建：开发者无需手动下载安装包，通过镜像快速部署可用的Astronomer CLI环境
• CI/CD流程集成：在自动化部署流水线中作为前置步骤，标准化Astronomer CLI的安装过程
• 多环境一致性保障：在开发、测试、生产环境中确保使用统一版本的Astronomer CLI

适用范围

• 需要使用Astronomer平台进行工作流管理的开发人员
• 构建Astronomer相关自动化部署流程的DevOps工程师
• 需在容器化环境中标准化工具链的运维团队

使用方法与配置说明

基本使用（docker run）

默认安装最新版本

bash
docker run --rm astronomer/cli-bootstrap

指定CLI版本

通过VERSION环境变量指定安装特定版本：

bash
docker run --rm -e VERSION=1.28.0 astronomer/cli-bootstrap

挂载本地目录输出

将安装的CLI二进制文件输出到宿主机指定目录（如/usr/local/bin）：

bash
docker run --rm -v /usr/local/bin:/target -e TARGET_DIR=/target astronomer/cli-bootstrap

配置参数说明

验证安装结果

安装完成后，可通过以下命令验证CLI是否正常工作：

bash
astro version

注意事项

• 运行容器时需确保网络通畅，以便正常下载Astronomer CLI安装包
• 挂载宿主机目录时，需保证目标目录具有写入权限
• 部分系统环境可能需要root权限运行容器以完成系统目录写入操作（如/usr/local/bin）