Document whether timeout-minutes includes runner queue time, and the "not acquired" cancellation

Đang mở
  • Có gì không ổn?
#46,930 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
57/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
github-actions, typescript
Lĩnh vực
documentation

Hướng nghiên cứu

Start with the linked timeout-minutes section in the workflow syntax article and check the cited workflow runs and community reports for evidence about queue time and the “not acquired” cancellation. Confirm the behavior with the relevant documentation or source available in the repository before editing. Done means the section clearly explains whether hosted runner queue time counts, describes this cancellation and its remedy, and distinguishes it from the configured timeout.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

triage
Code of Conduct
What article on docs.github.com is affected?

https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idtimeout-minutes

What part(s) of the article would you like to see updated?

The section says timeout-minutes is "the maximum number of minutes to let a job run before GitHub automatically cancels it." It doesn't say whether time spent queued for a GitHub-hosted runner counts toward that limit.

It also doesn't mention that GitHub can cancel a hosted job that never gets a runner. I hit both on 2026-11-12 and couldn't tell from the docs which one cancelled my job.

My macos-latest job had timeout-minutes: 15 and was cancelled twice, exactly 15m01s after it was created, with no runner assigned and no steps run:

Both carry the annotations "The job was not acquired by Runner of type hosted even after multiple attempts" and "Due to capacity constraints, jobs targeting macOS arm64 runners may experience longer queue times." The 15-minute match made it look like my timeout fired, so I first planned to move the limit to step level. jm2/kisakcod#838 shows a job with a 90-minute timeout cancelled the same way after about 28 minutes, which suggests the timeout wasn't the cause.

Could the section state:

  1. whether queue time counts toward timeout-minutes on GitHub-hosted runners, and
  2. that a hosted job can be cancelled with the "not acquired" annotation when no runner is available, regardless of timeout-minutes, and that re-running it is the remedy?
Additional information

Other repositories report the same pattern for macOS arm64 jobs, for example https://github.com/orgs/community/discussions/211885 and https://github.com/orgs/community/discussions/212069. If the cancellation follows a fixed acquisition limit, putting that number in the docs would help people tell it apart from their own timeout.

Ngôn ngữ chính
TypeScript
Star
21.4k
Fork
69.5k
Merge trung bình
14 giờ 31 phút
Pull request đã merge (30 ngày)
90

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của github/docs

Tất cả issue của github/docs

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.