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-06-01-install-troubleshooting.md: GHES install command uses invalid `--hostname` flag

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,568 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ó
1/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
85/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ệ
bash, github
Lĩnh vực
documentation

Hướng nghiên cứu

Vấn đề nằm ở workshop/side-quest-06-01-install-troubleshooting.md, trong phần GitHub Enterprise Server, ở dòng gh extension install đang truyền --hostname. Hãy kiểm tra trong tài liệu gh_extension_install để xác nhận dạng URL mà issue mô tả, sau đó chỉ sửa dòng đó để máy chủ GHES được chỉ định như một phần của URL kho lưu trữ. Hoàn thành khi dòng đó không còn dùng --hostname, phần còn lại của khối GHES giữ nguyên, và ví dụ tùy chọn gh aw --version được cập nhật để khớp với bản phát hành hiện tại.

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-06-01-install-troubleshooting.md

Problem

The "GitHub Enterprise Server (GHE/GHES) endpoint" section instructs learners to run:

gh extension install github/gh-aw --hostname ghes.example.com

gh extension install does not support a --hostname flag. Per the official gh CLI manual (gh_extension_install), the only flags are --force and --pin. GHES installs are done by passing the repository as a full URL instead of OWNER/REPO:

"For GitHub repositories, the repository argument can be specified in OWNER/REPO format or as a full repository URL. The URL format is useful when the repository is not hosted on github.com."

Example from the manual: `gh extension install (my.ghes.com/redacted)

As written, the documented command will fail with an "unknown flag" error for anyone following the GHES troubleshooting path.

Current correct syntax

gh config set git_protocol https --host ghes.example.com
gh auth login --hostname ghes.example.com --scopes "repo,read:org,workflow"
gh extension install (ghes.example.com/redacted)
gh auth status --hostname ghes.example.com

Suggested fix

Replace the line:

gh extension install github/gh-aw --hostname ghes.example.com

with:

gh extension install (ghes.example.com/redacted)

Minor secondary note

The checkpoint line "gh aw --version prints a version number (for example, gh-aw 1.x.x)" shows an example format (1.x.x) that doesn't match the project's current pre-1.0 versioning (latest release is v0.89.21) or the output format shown elsewhere in the workshop (e.g. gh-aw version 0.81.6). Consider updating the example to something like gh-aw version 0.89.21 for consistency, though this is lower priority than the --hostname flag fix above.

Reference

Official gh CLI manual: https://cli.github.com/manual/gh_extension_install

Generated by 🔍 Workshop Sync Check · copilot · auto · 173.7 AIC · ⌖ 0.605 AIC · ⊞ 9.2K · ◷

  • expires on Oct 15, 2026, 4:57 AM UTC
Ngôn ngữ chính
JavaScript
Star
53
Fork
35
Merge trung bình
1 ngày 5 giờ
Pull request đã merge (30 ngày)
16

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.