利用 Github Actions 同步佳明国区数据到国际区

💡 原文中文,约2300字,阅读约需6分钟。
📝

内容提要

本文介绍了如何将佳明国内区的数据同步到国际区,以便使用runalyze和Strava等跑步分析工具。首先需要在佳明国内区和国际区分别注册账号,并进行相应的配置。然后使用开源代码库DailySync进行同步。具体步骤包括账号设置、Strava配置和Github配置。最后通过配置Github Actions实现自动同步和定时同步。

🔎

延伸解读

迁移与同步:两个工作流的分工

文章将数据转移分为“迁移”和“同步”两个独立工作流。Migrate 用于一次性搬运历史活动,需手动触发并设置迁移数量与起始位置;Sync 则负责后续新数据的自动同步,默认每6小时运行一次。这种设计让用户能先小批量测试迁移,再逐步补全历史数据,最后依靠自动同步保持国际区账号更新。

迁移参数:数量与起始索引的配合

环境变量 GARMIN_MIGRATE_NUM 和 GARMIN_MIGRATE_START 控制每次迁移的活动条数和起始位置。文章建议初次将数量设为1、起始设为0进行测试,确认成功后改为从位置1开始迁移100条。需注意起始索引按活动时间从最新到最旧排列,且迁移条数越多等待时间越长,因此分批执行更稳妥。

代码来源:GitHub 与 GitLab 的版本差异

作者实际验证发现,GitHub 上 DailySync 项目的代码可能不是最新版本,而作者将最新代码放在 GitLab 上。因此文章建议从 GitLab 下载代码后上传到自己的 GitHub 账号,再配置 Actions。这一细节提醒读者,直接 Fork GitHub 仓库可能遇到功能缺失或配置不一致的问题,需留意代码来源的时效性。

自动同步频率:按跑步习惯调整

Sync 工作流默认每6小时同步一次,但用户可根据自身跑步时间修改 yml 文件中的 cron 表达式。文章作者通常早上7点前跑完,因此将同步设为每天7点执行(00 7 * * *)。这说明同步频率并非固定,读者可结合自己的运动习惯设置,让国际区数据更及时地反映最新活动。

❓

Q&A

佳明国内区和国际区的数据为什么不互通?

佳明分为国内区和国际区,两个区的账号是独立的,数据不互通。

如何将佳明国内区的数据同步到国际区?

使用开源代码库DailySync进行同步。步骤包括:注册佳明国内区和国际区账号(国际区选择美国区域),配置Strava数据权限,注册Github账号并Fork或上传DailySync项目,配置Github Actions环境变量,手动触发迁移工作流,修改环境变量以同步更多数据,并设置自动同步频率。

同步佳明数据到国际区需要哪些环境变量?

需要设置以下环境变量:GARMIN_USERNAME(中国区账号)、GARMIN_PASSWORD(中国区密码)、GARMIN_GLOBAL_USERNAME(国际区账号)、GARMIN_GLOBAL_PASSWORD(国际区密码)、GARMIN_MIGRATE_NUM(每次迁移数量,建议先填1测试)、GARMIN_MIGRATE_START(从第几条活动开始,可设为0)。

如何手动触发佳明数据迁移?

在Github Actions中,进入“Migrate Garmin CN to Garmin Global”工作流,如果看不到手动触发按钮,需编辑yml文件取消相关注释,然后点击“Run workflow”按钮手动执行。

自动同步佳明数据的频率如何修改?

自动同步使用“Sync Garmin CN to Garmin Global”工作流,默认每6小时同步一次。要修改频率,编辑对应的yml文件,修改cron表达式,例如设置为每天早上7点执行:00 7 * * *。

同步后如何在Strava中查看数据?

在Strava中设置数据权限允许访问“社交关系”下的佳明连接,同步完成后登录Strava即可看到从佳明国际区同步过来的数据。

🏷️

标签

➡️

继续阅读