Skip to content

Commit 4c64188

Browse files
kristopherjturnerclaude
kristopherjturner
and
claude
committed
feat(beacon): v1.0.0-pre — interactive split menu, Dell AX NIC drivers, MkDocs docs site
- Add Start-AzlBeacon.ps1: boot orchestrator with AD/Local Identity/Networking split menu - Add Start-NetworkBootstrap.ps1: DHCP-detect or static-IP prompt + connectivity verify - Update startnet.cmd: launch Start-AzlBeacon.ps1 (PS7 with PS5.1 fallback) - Update Build-WinPEImage.ps1: default Dell AX driver path, INF/DriverVer build log - Commit Dell AX 16G NIC drivers from SBE 5.0.2603.1641 (Broadcom/Mellanox/Intel) - Add mkdocs.yml with Material theme, AzureLocal branding, full nav - Add docs site: index, getting-started, validation (AD/LocalId/Networking), drivers, reference - Add GitHub Actions workflows: mkdocs-deploy.yml, validate.yml (PSScriptAnalyzer + markdownlint) - Add governance files: SECURITY.md, STANDARDS.md, .azurelocal-platform.yml, release-please config - Add lint configs: .editorconfig, .markdownlint.json, .yamllint.yml - Add CHANGELOG.md v1.0.0-pre entry - Update CLAUDE.md: ADO project Azure Local Beacon, full repo structure Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013AZySkzowyq4Ne2hrSRRAL
1 parent 0540bd5 commit 4c64188

54 files changed

Lines changed: 51066 additions & 146 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.azurelocal-platform.yml‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
schema_version: "1.0"
2+
repo:
3+
name: azurelocal-beacon
4+
org: AzureLocal
5+
platform: github
6+
default_branch: main
7+
type: tool
8+
validation_profile: powershell
9+
ado_project: Azure Local Beacon
10+
ado_area_path: Azure Local Beacon
11+
docs:
12+
engine: mkdocs-material
13+
site_url: https://azurelocal.github.io/azurelocal-beacon/
14+
standards:
15+
platform_ref: https://github.com/AzureLocal/platform/tree/main/docs/standards
16+
governance: true
17+
scripting: true
18+
documentation: true
19+
owner: kris@hybridsolutions.cloud

‎.editorconfig‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
root = true
2+
3+
[*]
4+
charset = utf-8
5+
end_of_line = crlf
6+
insert_final_newline = true
7+
trim_trailing_whitespace = true
8+
9+
[*.md]
10+
trim_trailing_whitespace = false
11+
12+
[*.yml]
13+
end_of_line = lf
14+
indent_style = space
15+
indent_size = 2
16+
17+
[*.yaml]
18+
end_of_line = lf
19+
indent_style = space
20+
indent_size = 2
21+
22+
[*.json]
23+
indent_style = space
24+
indent_size = 2
25+
26+
[*.ps1]
27+
indent_style = space
28+
indent_size = 4
29+
30+
[*.cmd]
31+
end_of_line = crlf

‎.github/workflows/mkdocs-deploy.yml‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
name: Deploy MkDocs Site
2+
3+
on:
4+
push:
5+
branches:
6+
- main
7+
paths:
8+
- 'docs/**'
9+
- 'mkdocs.yml'
10+
- 'requirements-docs.txt'
11+
workflow_dispatch:
12+
13+
permissions:
14+
contents: write
15+
16+
jobs:
17+
deploy:
18+
name: Build and deploy MkDocs
19+
runs-on: ubuntu-latest
20+
21+
steps:
22+
- name: Checkout repository
23+
uses: actions/checkout@v4
24+
with:
25+
fetch-depth: 0
26+
27+
- name: Set up Python
28+
uses: actions/setup-python@v5
29+
with:
30+
python-version: '3.12'
31+
cache: 'pip'
32+
33+
- name: Install MkDocs dependencies
34+
run: pip install -r requirements-docs.txt
35+
36+
- name: Build and deploy docs
37+
run: mkdocs gh-deploy --force
38+
env:
39+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

‎.github/workflows/validate.yml‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
name: Validate
2+
3+
on:
4+
push:
5+
branches: [main]
6+
pull_request:
7+
branches: [main]
8+
9+
jobs:
10+
powershell-lint:
11+
name: PSScriptAnalyzer
12+
runs-on: windows-latest
13+
14+
steps:
15+
- name: Checkout repository
16+
uses: actions/checkout@v4
17+
18+
- name: Install PSScriptAnalyzer
19+
shell: pwsh
20+
run: Install-Module -Name PSScriptAnalyzer -Force -Scope CurrentUser
21+
22+
- name: Run PSScriptAnalyzer
23+
shell: pwsh
24+
run: |
25+
$results = Invoke-ScriptAnalyzer -Path . -Recurse -Severity Warning,Error `
26+
-ExcludeRule PSAvoidUsingWriteHost
27+
if ($results) {
28+
$results | Format-Table -AutoSize
29+
Write-Error "PSScriptAnalyzer found $($results.Count) issue(s)"
30+
exit 1
31+
} else {
32+
Write-Host "PSScriptAnalyzer: No issues found" -ForegroundColor Green
33+
}
34+
35+
markdownlint:
36+
name: markdownlint
37+
runs-on: ubuntu-latest
38+
39+
steps:
40+
- name: Checkout repository
41+
uses: actions/checkout@v4
42+
43+
- name: Run markdownlint
44+
uses: DavidAnson/markdownlint-cli2-action@v16
45+
with:
46+
globs: '**/*.md'
47+
config: .markdownlint.json
48+
49+
yaml-lint:
50+
name: yamllint
51+
runs-on: ubuntu-latest
52+
53+
steps:
54+
- name: Checkout repository
55+
uses: actions/checkout@v4
56+
57+
- name: Run yamllint
58+
uses: ibiqlik/action-yamllint@v3
59+
with:
60+
config_file: .yamllint.yml

‎.markdownlint.json‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"default": true,
3+
"MD013": false,
4+
"MD033": false,
5+
"MD041": false,
6+
"MD024": { "siblings_only": true }
7+
}

‎.release-please-manifest.json‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
{
2+
".": "1.0.0-pre"
3+
}

‎.yamllint.yml‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
extends: default
2+
3+
rules:
4+
line-length:
5+
max: 140
6+
level: warning
7+
truthy:
8+
allowed-values: ['true', 'false']
9+
check-keys: false
10+
comments:
11+
min-spaces-from-content: 1
12+
document-start: disable

‎CHANGELOG.md‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Changelog
2+
3+
All notable changes to this project will be documented in this file.
4+
5+
This file is maintained by [release-please](https://github.com/googleapis/release-please).
6+
Do not edit this file manually.
7+
8+
<!-- markdownlint-disable MD024 -->
9+
10+
## [1.0.0-pre] - 2026-06-19
11+
12+
### Features
13+
14+
- Interactive split menu orchestrator (`Start-AzlBeacon.ps1`) — Active Directory, Local Identity, and Networking/Firewall validation paths
15+
- Network bootstrap (`Start-NetworkBootstrap.ps1`) — DHCP detection + prompted static IP fallback with connectivity verification
16+
- Dell AX 16G NIC drivers bundled from SBE 5.0.2603.1641 — Broadcom bnxt (236.1.152.0), Broadcom 5720 (221.0.8.0), Intel E810 icea (1.17.73.0), Intel E823 scea (1.16.58.0), Mellanox ConnectX mlx5 (24.4.26429.0)
17+
- MkDocs Material documentation site with AzureLocal branding, GitHub Pages deploy workflow
18+
- Local Identity (AD-less) validation path with Azure Key Vault endpoint check
19+
- Optional Arc integration validation with device-code sign-in
20+
21+
### Initial scaffold (2026-06-10)
22+
23+
- WinPE validation engine (`Start-AzlValidation.ps1`) with 12 validation categories
24+
- Endpoint list (`endpoints.json`) with 121 Azure Local, Arc, and Dell OEM endpoints
25+
- `Build-WinPEImage.ps1` to assemble the bootable WinPE ISO

‎CLAUDE.md‎

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,9 @@ Key rules:
2727
|---|---|
2828
| Primary language | PowerShell + JSON |
2929
| GitHub org | AzureLocal |
30+
| ADO org | https://dev.azure.com/hybridcloudsolutions |
31+
| ADO project | Azure Local Beacon |
32+
| ADO area path | Azure Local Beacon |
3033
| In-image scripts | Must be PS 5.1 compatible (WinPE runs PS 5.1 subset) |
3134
| Build scripts | PS 7.4+ (runs on the build machine, not in WinPE) |
3235

@@ -37,19 +40,32 @@ Key rules:
3740
```
3841
src/
3942
Build-WinPEImage.ps1 # Builds the ISO (PS 7.4+, run on build machine as Administrator)
43+
Start-AzlBeacon.ps1 # Boot orchestrator — split menu (PS 5.1 compatible)
44+
Start-NetworkBootstrap.ps1 # DHCP detect / static IP prompt + connectivity verify (PS 5.1)
4045
Start-AzlValidation.ps1 # Validation engine bundled in the image (PS 5.1 compatible)
4146
Convert-EndpointsToJson.ps1 # Regenerates endpoints.json from markdown source files
42-
startnet.cmd # WinPE boot entry point
47+
startnet.cmd # WinPE boot entry point → launches Start-AzlBeacon.ps1
4348
config/
4449
validation-config.example.json # Template — copy to validation-config.json and populate
4550
endpoints.json # Pre-built Azure endpoint list
51+
drivers/
52+
dell-ax/ # Signed NIC drivers for Dell AX 16G nodes (from SBE 5.0.2603.1641)
53+
broadcom-5720/ # b57nd60a.inf — 1GbE LOM, 221.0.8.0
54+
broadcom-bnxt/ # bnxtnd.inf — 10/25/100GbE, 236.1.152.0
55+
intel-e810/ # icea.inf — 100GbE, 1.17.73.0
56+
intel-e823/ # scea.inf — 1.16.58.0
57+
mellanox-cx/ # mlx5.inf — ConnectX, 24.4.26429.0
4658
config/
4759
endpoints/ # Endpoint markdown source files (inputs to Convert-*)
4860
azurelocal-endpoints.md
4961
arc-endpoints.md
5062
dell-endpoints.md
51-
docs/
52-
index.md # Validation lifecycle and coverage matrix
63+
docs/ # MkDocs Material docs site
64+
index.md
65+
getting-started/
66+
validation/
67+
drivers/
68+
reference/
5369
```
5470

5571
---

‎SECURITY.md‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Security Policy
2+
3+
## Supported versions
4+
5+
| Version | Supported |
6+
|---|---|
7+
| v1.0.x | ✅ |
8+
| pre-release | ⚠️ Best effort |
9+
10+
## Reporting a vulnerability
11+
12+
Report security vulnerabilities to **kris@hybridsolutions.cloud**.
13+
14+
Do **not** open a public GitHub issue for security vulnerabilities.
15+
16+
We aim to acknowledge reports within **2 business days** and provide a resolution or mitigation within **14 days**.
17+
18+
## Scope
19+
20+
- WinPE image build scripts
21+
- Endpoint sweep logic and endpoints.json
22+
- NIC driver injection
23+
- Validation configuration handling
24+
25+
## Out of scope
26+
27+
- Third-party Microsoft modules (`AzStackHci.EnvironmentChecker`, `Az.Accounts`)
28+
- Dell driver binaries — report driver vulnerabilities to Dell via [Dell Security Advisories](https://www.dell.com/support/kbdoc/en-us/000124654/dell-security-advisories-and-notices)

0 commit comments

Comments
 (0)