Add air-gapped/GHE configurability to `install.ps1` (Windows parity)

[sergio-sisternes-epam]

Summary

PR #660 adds configurable env vars to install.sh for air-gapped and GHE environments (APM_INSTALL_DIR, GITHUB_URL, APM_REPO, VERSION). The Windows installer (install.ps1) should support the same configurability so Windows users get an equivalent experience.

Proposed solution

Add the same environment variable support to install.ps1:

Variable	Default	Description
APM_INSTALL_DIR	Platform-appropriate default	Directory for the apm binary
GITHUB_URL	https://github.com	Base URL for downloads (mirrors, GHE)
APM_REPO	microsoft/apm	GitHub repository
VERSION	(latest)	Pin a specific release (skips GitHub API)

Key behaviors to match:

• When VERSION is set, skip the GitHub API and construct the download URL directly
• Derive the API URL from GITHUB_URL for GHE compatibility
• Support version pinning via parameter: irm https://aka.ms/apm-windows | iex -Args @v1.2.3 (or equivalent PowerShell pattern)
• Auth token resolution (GITHUB_APM_PAT, GITHUB_TOKEN) should work with both API and direct download paths

Acceptance criteria

• install.ps1 supports APM_INSTALL_DIR, GITHUB_URL, APM_REPO, VERSION env vars
• Version pinning skips GitHub API
• GHE API URL derived correctly from GITHUB_URL
• Documentation updated (installation page, apm-guide skill)
• CHANGELOG entry added

Related

• feat: make install.sh configurable for air-gapped environments #660 -- Unix installer configurability (this is the Windows counterpart)

[github-actions]

Triage decision

accept

Proposed labels

theme/portability
area/distribution
area/docs-site
type/feature
status/accepted
priority/low
good first issue
status/triaged

Milestone

0.9.4

Suggested next action

Implement the four env vars (APM_INSTALL_DIR, GITHUB_URL, APM_REPO, VERSION) in install.ps1 mirroring the logic in install.sh from PR #660, and update the installation docs to document them.

Suggested issue comment

Thanks for filing this -- Windows parity for install.ps1 is the right call, and the env var table maps cleanly to what install.sh already ships in #660.

The scope is well-bounded: add APM_INSTALL_DIR, GITHUB_URL, APM_REPO, and VERSION to install.ps1 with the same semantics (skip GitHub API when VERSION is set, construct the download URL directly, etc.). The install docs page in docs/src/content/docs/ should also be updated to document the new env vars.

Marking this accepted for 0.9.4. If you'd like to take it, a PR that mirrors install.sh as closely as possible and includes a docs update is the fastest path to merge. See CONTRIBUTING.md for the dev setup.

Per-lens notes (collapsed)

DevX UX Expert -- User-Need Reviewer

The request maps directly to a concrete parity gap: install.sh gained air-gapped/GHE env var support in #660, but install.ps1 did not. Windows users in air-gapped or GHE environments cannot install APM without manual workarounds. The env var API is a well-established mental model (matches GitHub Actions, Docker, npm config). Scope is clear and bounded: four env vars with documented defaults.

Supply Chain Security Expert -- Risk-Surface Reviewer

GITHUB_URL override allows pointing downloads at alternative sources -- the same trust surface already accepted for install.sh in #660. No new attack vector beyond what was already introduced. The install docs should note that GITHUB_URL should point to a trusted mirror. No theme/security label required; area/distribution covers the risk surface adequately.

OSS Growth Hacker -- Contributor-Tone Reviewer

Not activated -- sergio-sisternes-epam is a COLLABORATOR with known prior contributions; tone tuning for a first-time contributor is not needed here.

Python Architect -- Architecture Reviewer

Not activated -- install.ps1 is a standalone PowerShell script with no Python module changes. No cross-cutting design decision required; the implementation is a direct port of existing logic from install.sh.

Doc Writer -- Documentation Reviewer

Activated. The implementing PR must update the installation docs page (docs/src/content/docs/getting-started/ or equivalent) to document the four env vars and their semantics. area/docs-site added as a secondary area label so the PR reminder is built into the label set.

APM CEO -- Triage Arbiter

Clean parity request with an already-accepted pattern (install.sh #660). Windows portability is a published goal (Windows Native Support epic #244). Accept for 0.9.4 as a low-priority patch item. Marking as good first issue because the scope is fully specified and the expected output is a close mirror of existing code.

{
  "decision": "accept",
  "decision_detail": "",
  "theme": "theme/portability",
  "areas": ["area/distribution", "area/docs-site"],
  "type": "type/feature",
  "status": "status/accepted",
  "priority": "priority/low",
  "preserved_labels": ["good first issue"],
  "milestone": "0.9.4",
  "next_action": "Implement env vars in install.ps1 mirroring install.sh and update the installation docs page.",
  "comment_markdown": "Thanks for filing this -- Windows parity for install.ps1 is the right call. A PR that mirrors install.sh + a docs update is the fastest path to merge."
}

---

Triage status: agentic proposal pending human ratification.
Silence is approval. Maintainers can:

• Override any label or milestone above by editing it directly --
  human edits are authoritative and will not be reverted on
  subsequent runs.
• Re-trigger triage by applying the status/needs-triage label, or
  by removing status/triaged to enroll the issue in the next
  daily sweep.

Posted by the Triage Panel workflow. See .apm/skills/apm-triage-panel for the panel skill.

Generated by Triage Panel · ● 3.3M · ◷