Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[workshop-sync] side-quest-24-01-runner-infrastructure.md: ephemeral/JIT runner and proxy-env-var guidance unsupported by self-hosted-runners re

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,449 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
78/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
javascript
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với workshop/side-quest-24-01-runner-infrastructure.md và đối chiếu hướng dẫn về runner và mạng với tài liệu tham khảo self-hosted-runners được liên kết. Cập nhật các phần ephemeral/JIT và proxy để phù hợp với cấu hình runner và cách ly mạng đã được ghi lại, đồng thời điều chỉnh phần giải thích về máy chủ MCP cho khớp với network.allowed. Hoàn thành khi các nhận định không chính xác được sửa và các ví dụ chính xác được liệt kê trong issue vẫn được giữ nguyên.

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

Mô tả

documentation

Workshop file reviewed

workshop/side-quest-24-01-runner-infrastructure.md

Problem

  1. The "Ephemeral and JIT runners" section states:

Ephemeral runners are destroyed after a single job ... Register one using the ephemeral flag ... Just-in-time (JIT) runners are provisioned on demand and deregistered immediately after use. They require a registration token scoped to your organisation or repository and are typically managed by a runner controller such as actions-runner-controller.

This section links to https://github.github.com/gh-aw/reference/self-hosted-runners/, but that page contains no mention of ephemeral runners, JIT runners, registration tokens, or actions-runner-controller registration flags.

  1. The "Proxy and network requirements" section instructs learners to set host-level proxy environment variables:
HTTPS_PROXY=(proxy.example.com/redacted)
HTTP_PROXY=(proxy.example.com/redacted)
NO_PROXY=localhost,127.0.0.1,github.example.com

This is not documented anywhere in the gh-aw reference docs as the mechanism for self-hosted runner network configuration.

  1. The "Network isolation" section frames "MCP tool servers" as independently-reachable endpoints, separate from network.allowed.

Current correct behaviour

The actual reference/self-hosted-runners/ page documents:

  • The runs-on frontmatter field (string/array/object forms) to target self-hosted runners.
  • require_self_hosted_runners in .github/workflows/aw.json (or --require-self-hosted-runners CLI flag) to enforce self-hosted runners on all generated jobs.
  • ARC Docker-in-Docker topology via runner.topology: arc-dind, including GH_AW_DOCKER_SOCK_PATH/GH_AW_DOCKER_SOCK_GID env var overrides for split-daemon setups.
  • Network isolation is enforced via AWF's own internal Docker network topology (an internal awf-net bridge with no internet route) and a dual-homed Squid proxy inside the Docker daemon's domain — not via host-level HTTPS_PROXY/HTTP_PROXY/NO_PROXY env vars on the runner machine.
  • Documented outbound network requirements: api.githubcopilot.com (or enterprise Copilot endpoint), github.com (or GHES instance), ghcr.io (to pull the MCP gateway image), and any domains in network.allowed.

Suggested fix

  • Remove or rewrite the "Ephemeral and JIT runners" section to cover gh-aw-documented self-hosted runner configuration instead: runs-on, require_self_hosted_runners, and runner.topology: arc-dind for ARC DinD setups.
  • Replace the HTTPS_PROXY/HTTP_PROXY/NO_PROXY guidance with an explanation of AWF's internal Squid-proxy network isolation and the documented outbound endpoint list (Copilot/model endpoint, GitHub/GHES, ghcr.io, plus network.allowed domains).
  • Reframe "MCP tool servers" access as governed by the network.allowed frontmatter field rather than a separately reachable endpoint category.
  • The network.allowed example and firewall.md artifact mention in this file are accurate and do not need changes.

Reference: https://github.github.com/gh-aw/reference/self-hosted-runners/ (confirmed reachable, HTTP 200; verified no "ephemeral"/"JIT"/proxy-env-var content present)

Generated by 🔍 Workshop Sync Check · copilot · auto · 239.5 AIC · ⌖ 8.28 AIC · ⊞ 9.2K · ◷

  • expires on Oct 12, 2026, 5:49 AM UTC
Ngôn ngữ chính
JavaScript
Star
53
Fork
35
Merge trung bình
13 giờ 50 phút
Pull request đã merge (30 ngày)
14

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.

  • Không có Dockerfile hay tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

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 githubnext/gh-aw-workshop

Tất cả issue của githubnext/gh-aw-workshop

Issue tương tự

Thêm issue về JavaScript

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.