首页
/ Earthly云平台使用指南:解决构建历史不可见问题

Earthly云平台使用指南:解决构建历史不可见问题

2025-05-19 10:30:56作者:殷蕙予

Earthly是一款强大的构建工具,其云平台为开发者提供了便捷的远程构建能力。在使用过程中,部分用户可能会遇到构建历史不可见的问题,本文将深入分析这一现象并提供解决方案。

问题现象分析

当用户首次使用Earthly云平台时,可能会发现以下情况:

  1. 虽然构建任务能够成功执行并生成结果链接
  2. 但在云平台仪表盘中却显示"无构建记录"
  3. 无法通过Web界面管理项目和密钥

根本原因

经过技术分析,这一问题主要由两个因素导致:

  1. Earthfile版本不兼容:用户可能使用了较旧版本的Earthfile格式(如VERSION 7),而云平台需要更新版本的格式支持(VERSION 8)

  2. 项目定义缺失:构建任务没有明确关联到特定项目,导致构建记录无法正确归类显示

解决方案

1. 升级Earthfile配置

在Earthfile的开头部分,确保使用正确的版本声明:

VERSION 8
PROJECT <组织名称>/<项目名称>

2. 创建并关联项目

通过命令行工具创建项目并关联构建任务:

earthly project create <项目名称>

3. 设置环境变量

在构建前,可以通过环境变量指定项目:

export EARTHLY_PROJECT="my-project"
earthly --push +target

功能限制说明

目前Earthly云平台的Web界面功能仍在完善中,以下管理操作需要通过CLI工具完成:

  • 密钥管理:使用earthly secrets命令系列
  • 卫星节点管理:主要通过命令行操作

最佳实践建议

  1. 始终使用最新版本的Earthly CLI工具(当前推荐v0.8.5+)
  2. 为每个独立代码库创建单独的项目
  3. 在Earthfile中显式声明PROJECT信息
  4. 定期检查构建历史,确认记录正确同步

通过以上调整,用户可以充分利用Earthly云平台的6000分钟免费构建时长,享受高效的云端构建体验。随着产品迭代,更多Web管理功能将会陆续推出,进一步提升用户体验。

登录后查看全文
热门项目推荐