flyio/flyctl

Fly.io CLI 镜像

镜像概述

Fly.io CLI 镜像是 Fly.io 官方提供的命令行工具（CLI）容器化版本，用于在 Fly.io 平台上管理和部署应用程序。该镜像封装了 Fly.io 平台的核心操作能力，支持通过命令行界面完成应用生命周期管理、部署配置、资源调整等操作，为开发者提供便捷的容器化工具链。

核心功能和特性

• 官方工具支持：由 Fly.io 官方维护，确保与平台功能同步更新
• 应用管理：支持创建、删除、列出 Fly.io 应用，管理应用配置
• 部署能力：提供应用部署命令，支持代码推送、镜像部署等部署方式
• 命令行交互：通过标准化命令行接口执行各类操作，支持自动化脚本集成

使用场景和适用范围

• 应用部署：开发者在 Fly.io 平台部署应用时，作为核心命令行工具使用
• 开发流程集成：嵌入 CI/CD 流程，实现自动化部署和应用管理
• 平台操作：日常管理 Fly.io 应用资源、查看应用状态、调整配置等场景
• 多环境适配：适用于开发、测试、生产等不同环境的应用部署需求

使用方法和配置说明

基本使用方式

通过 docker run 命令直接运行 Fly.io CLI 命令，示例：

bash
# 查看 CLI 版本
docker run --rm flyio/cli version

# 登录 Fly.io 账户（需交互式输入凭证）
docker run --rm -it flyio/cli auth login

# 部署当前目录应用（挂载本地代码目录）
docker run --rm -v $(pwd):/app -w /app flyio/cli deploy

持久化配置

为保留认证状态和配置信息，可挂载本地配置目录（默认路径 ~/.fly）：

bash
# 挂载配置目录并执行命令
docker run --rm -v ~/.fly:/root/.fly -v $(pwd):/app -w /app flyio/cli apps list

常用命令示例

• 列出所有应用：docker run --rm -v ~/.fly:/root/.fly flyio/cli apps list
• 查看应用状态：docker run --rm -v ~/.fly:/root/.fly flyio/cli status <app-name>
• 扩展应用资源：docker run --rm -v ~/.fly:/root/.fly flyio/cli scale vm <size> -a <app-name>

配置说明

• 认证配置：通过 auth login 命令完成账户认证，凭证存储在挂载的 ~/.fly 目录中
• 应用配置：支持通过项目根目录的 fly.toml 文件定义应用配置，部署时需挂载该文件至容器内应用目录
• 命令行参数：所有操作通过 CLI 命令行参数指定，具体可通过 docker run --rm flyio/cli help 查看完整命令列表

注意事项

• 交互式命令（如 auth login）需添加 -it 参数以支持终端交互
• 本地文件操作（如部署代码）需通过 -v 参数挂载本地目录至容器内
• 确保 Docker 环境网络通畅，以正常连接 Fly.io 平台 API