aaronlee/flyctl Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

docker-flyctl镜像文档

镜像概述和主要用途

docker-flyctl是一个封装了flyctl工具的Docker镜像，旨在提供隔离、一致的环境运行Fly.io官方命令行工具（flyctl）。flyctl用于在Fly.io平台部署、管理和扩展应用，支持应用部署、日志查看、资源配置等核心操作。该镜像消除了主机系统安装flyctl的依赖，适用于各类容器化环境。

项目GitHub仓库：docker-flyctl
详细使用指南：在容器中运行flyctl

核心功能和特性

• 官方工具集成：内置最新稳定版flyctl，与Fly.io平台功能完全同步
• 轻量级设计：基于Alpine Linux构建，镜像体积小，启动速度快
• 环境隔离：容器化运行避免主机系统依赖冲突，保持环境一致性
• 灵活配置：支持通过环境变量或挂载文件进行认证和参数设置
• CI/CD友好：可直接集成到GitHub Actions、GitLab CI等自动化流程

使用场景和适用范围

• 自动化部署：在CI/CD管道中执行flyctl命令，实现应用自动部署、版本更新
• 本地开发：无需在主机安装flyctl，通过容器临时或持久化管理Fly.io应用
• 多环境统一：确保开发、测试、生产环境使用相同版本的flyctl，避免版本差异问题
• 隔离测试：在容器内测试不同flyctl版本或应用配置，不影响主机环境

使用方法

基础命令执行

获取flyctl版本信息：

bash
docker run --rm aaro-n/flyctl flyctl version

查看命令帮助文档：

bash
docker run --rm aaro-n/flyctl flyctl help deploy

应用部署示例

部署当前目录下的应用（需提供API令牌并挂载应用代码）：

bash
docker run --rm \
  -v $(pwd):/app \                  # 挂载主机应用代码到容器内/app目录
  -e FLY_API_TOKEN=your_api_token \ # 设置Fly.io API令牌（从Fly.io控制台获取）
  aaro-n/flyctl \
  flyctl deploy /app                # 部署/app目录下的应用

持久化认证配置

通过挂载主机配置目录，持久化保存flyctl认证信息：

bash
docker run --rm \
  -v ~/.fly:/root/.fly \            # 挂载主机fly配置目录到容器内
  aaro-n/flyctl \
  flyctl auth login                 # 登录Fly.io，配置将保存在主机~/.fly目录

配置说明

环境变量配置

常用挂载点

注意事项

1. 建议使用具体版本标签（如aaro-n/flyctl:v0.1.0）而非latest，确保环境一致性
2. API令牌需通过安全方式传递（如CI/CD密钥管理），避免明文暴露
3. 部署前确认容器内应用目录结构与本地一致，避免因路径问题导致部署失败
4. 如需使用自定义fly.toml，需通过挂载或环境变量指定文件路径