Skip to content

fix: 修正 HA builder action 的 tag 引用(7.2.0 -> 2026.09.0) - #3

Merged
C3H3-AI merged 1 commit into
masterfrom
fix/builder-action-tag
Sep 15, 2026
Merged

C3H3-AI merged 1 commit into
masterfrom
fix/builder-action-tag

Conversation

@C3H3-AI

@C3H3-AI C3H3-AI commented Sep 15, 2026

Copy link
Copy Markdown
Owner

Description / 变更描述

修复 Build Add-on Image 在 PR #2 合并后首次运行即失败的问题。

失败现象

##[error]Can't find 'action.yml', 'action.yaml' or 'Dockerfile'
for action 'home-assistant/builder/actions/prepare-multi-arch-matrix@7.2.0'.

失败发生在 Set up job 阶段 —— 即 job 还没开始跑就挂了,后续三个 job 全部 skipped。

根因

home-assistant/builder 存在两条版本线,我此前取错了:

tag 线 内容 actions/ 子 action?
7.x(7.0 / 7.1 / 7.2.0 azure-pipelines.yml builder.sh build.json Dockerfile 没有 actions/ 目录
2026.x2026.09.0 等) actions/ action.yml AI_POLICY.md ✅ 4 个子 action 齐全

实测对比(两个 tag 分别 clone 后 ls):

tag 7.2.0      → azure-pipelines.yml builder.sh build.json Dockerfile LICENSE README.md
                 actions/ 不存在
tag 2026.09.0  → actions/ action.yml AI_POLICY.md LICENSE README.md
                 actions/ = build-image cosign-verify
                            prepare-multi-arch-matrix publish-multi-arch-manifest

官方 README 示例里的 @[version] 指的是 releases 页面上的 tag,即日历版本
2026.09.0),而非 7.x 那条旧线。此前取了 7.2.0 属实误判。

改动

三个 action 引用统一改为 @2026.09.0

  • actions/prepare-multi-arch-matrix@2026.09.0
  • actions/build-image@2026.09.0
  • actions/publish-multi-arch-manifest@2026.09.0

改动仅 3 行,不涉及其他逻辑。

⚠️ 注:这次修复本身也只能靠 push 到 master 后由真机验证——
Build Add-on Image 的触发条件不含 PR(只在 push 到 main/master 时跑)。
合并后我会立刻盯 Actions 结果。

Type of change / 变更类型

  • bugfix: Bug fix / 问题修复
  • new feature: New feature / 新功能
  • refactor: Code refactoring and optimization / 重构与优化
  • breaking: Breaking change / 破坏性变更
  • docs: Documentation / 文档更新

Testing / 测试

  • HA Version / HA版本: 2024.1.0+
  • Add-on Version / 加载项版本: 1.1.0b13
  • Test Result / 测试结果: 两个 tag 各自 clone 后对比目录结构确认根因;
    action 路径修正后待真机验证(PR 不触发该 workflow)

Checklist / 自检清单

  • Code follows project standards / 代码符合项目规范
  • No debug code or unrelated files / 无调试代码或无关文件

@github-actions github-actions Bot added the 🐛 Bug Fix Bug fix / 问题修复 label Sep 15, 2026
Build Add-on Image 在合并后首次运行即失败:

  ##[error]Can't find 'action.yml', 'action.yaml' or 'Dockerfile'
  for action 'home-assistant/builder/actions/prepare-multi-arch-matrix@7.2.0'.

根因:home-assistant/builder 存在两条版本线。
- 7.x(7.0 / 7.1 / 7.2.0):旧版 builder,**仓库内没有 actions/ 目录**
- 2026.x(2026.09.0 等):新版,含 actions/{build-image,
  prepare-multi-arch-matrix,publish-multi-arch-manifest,cosign-verify}

实测对比(两个 tag 各自的 clone):
  tag 7.2.0      → azure-pipelines.yml builder.sh build.json Dockerfile ...
                   actions/ 不存在
  tag 2026.09.0  → actions/ action.yml ...(4 个子 action 齐全)

官方 README 示例中的 @[version] 指的是 releases 页面上的 tag,
即日历版本(2026.09.0),而非 7.x 那条线。此前取了 7.2.0 属实误判。
@C3H3-AI
C3H3-AI force-pushed the fix/builder-action-tag branch from 3dc52cc to 513f794 Compare September 15, 2026 05:56
@C3H3-AI
C3H3-AI merged commit ccae2e0 into master Sep 15, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🐛 Bug Fix Bug fix / 问题修复

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant