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

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管理功能将会陆续推出，进一步提升用户体验。