betomorrow/ci-flutter Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务
betomorrow/ci-flutterbetomorrow
适用于Gitlab CI/CD流水线的便捷镜像
下载次数: 0状态：社区镜像维护者：betomorrow仓库类型：镜像最近更新：7 个月前
ci-flutter 镜像文档
镜像概述和主要用途
ci-flutter 是一个为 Gitlab CI/CD 流水线设计的便捷镜像，集成了多种开发、部署工具及云服务客户端，旨在简化 CI/CD 流程中的环境配置、代码拉取、依赖管理和应用部署等环节。
最新标签
v17
核心功能和特性
内置工具集
- 基础工具：Bash、Curl、OpenSSH、jq、zip、git、python3
- 云服务 CLI：AWS CLI、Google Cloud CLI、Azure CLI
- CI/CD 辅助工具：SSH 密钥管理、Git 配置工具、预览部署命令、Dependency Track 集成
核心特性
- 预置 Gitlab/GitHub SSH 主机密钥，简化代码拉取认证
- 支持 SSH 密钥自动注入与管理，集成 ssh-agent
- 云服务自动登录（AWS ECR、Google Artifact Registry）
- 提供 Web/移动应用预览部署命令，支持 Slack 通知
- 集成 Dependency Track 漏洞扫描报告上传功能
- 可通过环境变量启用调试模式，便于问题排查
使用场景和适用范围
适用场景
- Gitlab CI/CD 流水线中的构建、测试、部署阶段
- 多平台应用（Web/移动）的自动化构建与预览
- 云服务（AWS/GCP/Azure）资源的 CI/CD 管理
- 依赖项安全扫描报告上传（Dependency Track 集成）
适用范围
- 需要集成多工具链的复杂 CI/CD 流程
- 涉及跨云服务部署的项目
- 需自动化管理 SSH 密钥、Git 配置的场景
- 需快速部署预览版本并通知团队的开发流程
详细使用方法和配置说明
Shell 环境
镜像默认提供 Bash shell，内置以下工具，可直接用于脚本执行：
curl、OpenSSH、jq、zip、git、python3、AWS CLI、Google Cloud CLI
SSH 配置
预置主机密钥
镜像已预置 gitlab.com 和 github.com 的 SSH 主机密钥（详见文件），无需手动配置 StrictHostKeyChecking。
环境变量
| 变量名 | 描述 |
|---|---|
CIBTO_SSH_KEY_[...] | 前缀为该值的变量会被写入磁盘，同时生成 CIBTO_SSH_KEY_[...]_PATH 变量存储文件路径，密钥会自动添加到 ssh-agent |
CIBTO_SSH_KNOWN_HOST_[...] | 前缀为该值的变量会被添加到 sshd 已知主机列表 |
Git 配置
环境变量
| 变量名 | 描述 |
|---|---|
CIBTO_GIT_USER_EMAIL | 设置 Git 全局用户*** |
CIBTO_GIT_USER_NAME | 设置 Git 全局用户名 |
命令
| 命令格式 | 描述 |
|---|---|
git-set-key <key_path> | 配置 Git 使用指定路径的 SSH 密钥，并禁用 StrictHostKeyChecking |
Amazon Web Service (AWS) CLI
默认区域：eu-west-1
环境变量
| 变量名 | 描述 |
|---|---|
CIBTO_AWS_ECR_AUTO_LOGIN | 启用 ECR 自动登录（默认：0，不启用） |
CIBTO_AWS_S3_ENDPOINT | 设置 S3 端点（例如 [***]） |
命令
| 命令格式 | 描述 |
|---|---|
aws-ecr-login <region> | 登录指定区域的 AWS ECR 仓库 |
Azure CLI
无特定环境变量或命令，可直接使用原生 az 命令。
Google Cloud CLI
环境变量
| 变量名 | 描述 |
|---|---|
CIBTO_GCLOUD_AR_AUTO_LOGIN | 启用 Artifact Registry 自动登录（默认：0，不启用） |
CIBTO_AZURE_RM_SUBSCRIPTION_ID | 设置 Azure 订阅 ID（注：该变量实际为 Azure 配置，此处按原文档保留） |
CIBTO_AZURE_RM_TENANT_ID | 设置 Azure 订阅租户 ID（注：同上） |
CIBTO_AZURE_RM_CLIENT_ID | 设置 Azure 服务主体应用 ID（注：同上） |
CIBTO_AZURE_RM_CLIENT_SECRET | 设置 Azure 服务主体密钥（注：同上） |
预览部署
提供 Web 和移动应用的预览部署功能，支持通知集成。
环境变量
| 变量名 | 描述 |
|---|---|
CIBTO_PREVIEWS_SERVER_URL | 预览服务器 URL（例如 [***]） |
CIBTO_PREVIEWS_TOKEN | 预览服务器认证 JWT 令牌 |
CIBTO_PREVIEWS_SLACK_HOOK_URL | （可选）Slack 通知 Webhook URL，用于推送部署通知 |
命令
| 命令格式 | 描述 |
|---|---|
push_web_preview <src_path|docker_tag> <app_name> | 部署 Web 预览： - 若为静态网站（SSG），传入静态文件目录路径（通常含 index.html）； - 若为 Docker 镜像，传入镜像标签（镜像需监听 8080 端口）； app_name 为自定义名称（如 backend/frontend、storybook） |
push_mobile_preview <filename> <filepath> <app_name> | 部署移动应用预览：filename 为下载时显示的文件名；filepath 为构建产物的系统路径；app_name 为自定义名称（如 android/ios） |
Dependency Track 集成
用于上传软件物料清单（BOM）至 Dependency Track 进行漏洞扫描。
环境变量
| 变量名 | 描述 |
|---|---|
CIBTO_DTRACK_HOST | 设置 Dependency Track 主机地址 |
CIBTO_DTRACK_API_KEY | 设置 Dependency Track API 密钥 |
命令
| 命令格式 | 描述 |
|---|---|
dtrack-upload -g <组名> -p <项目名> -b <BOM.json> | 上传 BOM 文件至 Dependency Track，需指定组名、项目名和 BOM 文件路径 |
调试
| 变量名 | 描述 |
|---|---|
CIBTO_DEBUG | 设置任意值可启用镜像内置脚本的调试信息输出 |
部署方案示例
示例 1：Gitlab CI/CD 配置（.gitlab-ci.yml）
yamlstages: - build - deploy-preview variables: CIBTO_GIT_USER_NAME: "CI Bot" CIBTO_GIT_USER_*** "***" CIBTO_SSH_KEY_MY_REPO: "$SSH_PRIVATE_KEY" # 注入 SSH 密钥 CIBTO_PREVIEWS_SERVER_URL: "[***]" CIBTO_PREVIEWS_TOKEN: "$PREVIEWS_JWT_TOKEN" CIBTO_PREVIEWS_SLACK_HOOK_URL: "$SLACK_HOOK" build_web: stage: build image: ci-flutter:v17 script: - git-set-key "$CIBTO_SSH_KEY_MY_REPO_PATH" # 使用注入的 SSH 密钥配置 Git - git clone ***:example/project.git # 拉取代码 - cd project && npm install && npm run build # 构建静态 Web 应用 - push_web_preview ./dist frontend # 部署 Web 预览 deploy_mobile_preview: stage: deploy-preview image: ci-flutter:v17 script: - flutter build appbundle # 构建 Flutter 应用 - push_mobile_preview "app-debug.aab" "build/app/outputs/bundle/debug/app-debug.aab" android # 部署移动预览
示例 2：本地测试（docker run）
bash# 启动容器并挂载本地 SSH 密钥、设置调试模式 docker run -it --rm \ -e CIBTO_DEBUG=1 \ -e CIBTO_SSH_KEY_TEST="$HOME/.ssh/id_rsa" \ -e CIBTO_GIT_USER_NAME="Local Test" \ -e CIBTO_GIT_USER_EMAIL="***" \ ci-flutter:v17 /bin/bash # 在容器内执行命令 git-set-key "$CIBTO_SSH_KEY_TEST_PATH" # 配置 Git SSH git clone ***:example/repo.git # 测试代码拉取
示例 3：AWS ECR 登录并推送镜像
bashdocker run -it --rm \ -e CIBTO_AWS_ECR_AUTO_LOGIN=1 \ -e AWS_ACCESS_KEY_ID="$AWS_ACCESS_KEY" \ -e AWS_SECRET_ACCESS_KEY="$AWS_SECRET_KEY" \ ci-flutter:v17 \ sh -c "aws-ecr-login us-east-1 && docker push ***.dkr.ecr.us-east-1.amazonaws.com/my-app:latest"
fischerscode/flutter
fischerscode
一个自动构建的包含Flutter SDK的Docker镜像，基于Ubuntu系统，提供推荐版和支持sudo的版本，适用于Flutter应用开发与构建。
38 次收藏100万+ 次下载
1 年前更新
fischerscode/flutter-sudo
fischerscode
一个自动构建的包含Flutter SDK的Docker镜像，基于Ubuntu系统，提供Flutter可执行文件，适用于Flutter应用开发与构建。
2 次收藏50万+ 次下载
1 年前更新
instrumentisto/flutter
instrumentisto
包含构建Flutter应用所需工具包的Docker镜像，支持Android、Linux、Web平台，基于Android SDK，可便捷运行flutter命令构建跨平台应用。
26 次收藏10万+ 次下载
21 天前更新
openruntimes/flutter
openruntimes
暂无描述
10万+ 次下载
17 天前更新
nyaaneet/flutter
nyaaneet
暂无描述
10万+ 次下载
1 个月前更新
lekhrajpretlist/flutter-img
lekhrajpretlist
its for flutter version 3.16.0
10万+ 次下载
1 个月前更新
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"